Files
road-compiler/.trellis/tasks/09-04-complex-junction-shapes/prd.md
T

4.8 KiB
Raw Blame History

复杂路口形态与参数编辑规划

Goal

让复杂路口渲染适配真实路口形态,而不是把所有候选都按 2×2 十字路口处理。用户需要在独立 JunctionTools 页面中看到与实际拓扑一致的道路面、斑马线、停止线、中央区域、角部圆角和人行道转角,覆盖 2×2、2×1、T 字和必要的非规则三臂/多臂路口。

Confirmed Technical Facts

  • src/compile/complex-junction.js 当前按方向将进口分组为 arms,并生成道路面、斑马线、停止线、角部岛、圆角填充和人行道转角。
  • 当前实现要求至少 3 个外部进口,但圆角、角部设施和中心区域的几何仍带有四臂/对称路口假设。
  • 2×1 的问题不只是车道数少,还涉及是否存在相向车道、中央分隔带和对应的角部设施。
  • T 字路口只有三个有效外部进口,不应闭合生成不存在的第四个角部或第四组穿行设施。
  • 复杂路口当前参数编辑尚未开放,JunctionTools 中复杂模式仍是只读。

Proposed First Phase

  1. 根据有效进口臂数量、每臂车道/车行道成员、相邻夹角和道路方向,识别十字、偏置十字、T 字、三臂非规则和不支持形态。
  2. 将几何生成拆成“臂级元素”和“角级元素”:只为真实存在的臂生成进口、停止线和对应斑马线,只为真实相邻角生成角部岛、圆角和人行道转角。
  3. 对单车道/单向臂关闭不适用的中央分隔逻辑,避免 2×1 被套用 2×2 的双向中央结构。
  4. 对无法可靠识别或几何质量不足的形态保留普通路口回退,并给出可理解的诊断。
  5. 第一阶段复杂路口参数继续只读;待形态识别和渲染稳定后,再开放按形态约束的参数编辑。

Domain Model For Follow-Up Design

复杂路口需要先建立结构模型,再生成几何,避免把几何参数当成形态判断:

  1. 拓扑层:有效进口臂数量、进口臂之间的夹角、是否为 T 字/十字/偏置十字/非规则三臂。
  2. 车行结构层:每条臂的单向/双向状态、每方向车道数、道路宽度、中央分隔或导流结构。
  3. 交通组织层:每条进口臂对应的停止线、斑马线、转向车道、导流岛和行人过街关系。
  4. 几何表现层:道路面、核心冲突区、角部圆角、人行道转角和车道线;这些元素必须由前面三层推导,而不是固定套用四臂模板。

JunctionTools 后续应在页面顶部显示可理解的结构摘要,例如“3 臂 T 字 · 2 个方向 × 每方向 1 车道 + 1 条单向支路”,让用户先确认系统对路口的理解,再编辑参数。

Terminology Constraint

“2×2”和“2×1”描述的是组成复杂路口的原始节点布局或合并结构,不是车道数,也不能直接决定最终路口外观。2×1 可以形成 T 字,也可以形成十字或偏置十字。

实现必须将两个概念分开:

  1. 节点布局:候选 cluster 内的节点数量、相对排布和短连接关系;仅用于候选选择与几何推导。
  2. 最终路口形态:由 cluster 边界向外延伸的有效道路臂、方向、夹角和连接关系判定为十字、T 字、偏置十字或非规则形态;这是 UI 文案和生成规则的依据。

产品不得用“2×1”直接给用户解释为 T 字。应使用“4 臂十字路口”“3 臂 T 字路口”等最终形态文案;必要时才在高级信息中展示节点布局。

Out of Scope For First Phase

  • 不同时开放复杂路口的核心半径、进口宽度、圆角等自由拖拽编辑。
  • 不修改 OSM 拓扑,不自动创建或删除道路、设施或节点。
  • 不要求一次覆盖所有任意角度和多层立交形态;超出识别范围的路口必须安全回退。

Acceptance Criteria

  • 2×2 路口保持现有视觉质量,且只生成真实存在的臂和角部元素。
  • 2×1 路口不再出现双向四车道专属的多余中央/角部结构。
  • T 字路口不生成不存在的第四臂、第四组斑马线或闭合角部设施。
  • 至少有一个真实 OSM 样例覆盖每种形态,并有几何/诊断回归测试。
  • 不支持或识别不确定的形态回退为普通路口,并给出可理解原因。
  • 复杂路口现有选择、刷新保持、普通路口编辑和地图编号功能不回归。

Open Product Decision

无。节点布局与最终形态必须独立判断;下一步设计将以真实 OSM 样例验证这组分类规则。

Final Planning Boundary

本任务第一阶段只解决“理解并正确渲染复杂路口”,不开放自由几何编辑。分类依据必须来自 cluster 外边界的有效道路臂和连接关系;cluster 内部节点布局只用于确定合并范围和中心,不作为形态名称。