Files
road-compiler/.trellis/tasks/09-01-lane-maneuver-position-drag/prd.md
T

2.6 KiB

车道转向箭头位置拖曳

Goal

TBD.

Requirements

  • TBD

Acceptance Criteria

  • TBD

Notes

  • Keep prd.md focused on requirements, constraints, and acceptance criteria.
  • Lightweight tasks can remain PRD-only.
  • For complex tasks, add design.md for technical design and implement.md for execution planning before task.py start.

车道转向箭头位置拖曳

目标

让用户可以把一个完整的路口转向箭头沿所属车道拖到新的位置。箭头的 polygon part 必须整体平移,内部形状、part 顺序和 maneuver 不变;旋转和箭头内容修改 不属于本任务。

已确认事实

  • 一个视觉箭头由同一 lane_id + maneuver 下的 3 或 5 个 polygon part 组成,点击 任一 part 已能选中整组。
  • 编译器目前以 placement_distance_meters 记录箭头距路口端的距离,并在 6/10/14/18/22m 候选位置中避开斑马线和停止线。该字段目前是输出值,还没有 override 合同。
  • 车道中心线已作为无箭头车道的选择入口;位置拖曳必须同时适用于已有箭头和刚新增的箭头。
  • 现有 v2 拖曳链路按车道轴投影、以服务端预览为准;箭头位置属于新的离散/连续混合 override,不能伪装成道路宽度或路口偏移 constraint。

范围

  1. 拖曳完整 lane_id + maneuver 箭头组,保持 part 相对几何不变。
  2. 将拖曳位置保存为 lane-maneuver.placementDistanceMeters(从车道驶入路口端量起的米数), 并在保存/重新生成后由编译器读取。
  3. 位置必须沿车道中心线投影,不能改变横向位置;不能越过车道有效端点或与斑马线、停止线重叠。
  4. 已有的 maneuver 下拉框继续有效;旋转手柄、角度字段和沿路 directionArrows 不在范围内。

验收标准

  • 拖曳任一箭头 part 会整体移动同组所有 part,不拆散、不改变形状和旋转。
  • 拖曳释放时位置按车道轴投影并受有效范围约束;服务端正式编译输出的 placement_distance_meters 反映新位置。
  • 新增箭头后也能拖曳其位置;刷新或重新编译不会回到旧位置。
  • 箭头不能落在斑马线/停止线范围内,也不能超出车道安全端点。
  • 未设置位置覆盖时,输出与现有编译结果字节一致。
  • 旋转、沿路重复方向箭头和既有 v2 控件行为不回归。

关键决策

当用户把箭头拖向无效区域(控制设施或安全端点)时,连续夹紧到最近合法位置, 并在拖动过程中让完整箭头组停在该位置。这个行为与现有 v2 数值拖曳一致。