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

67 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 复杂路口形态与参数编辑规划
## 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 内部节点布局只用于确定合并范围和中心,不作为形态名称。