# 复杂路口形态与参数编辑规划 ## 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 内部节点布局只用于确定合并范围和中心,不作为形态名称。