Files
road-compiler/.trellis/tasks/09-08-junction-reference-fidelity/design.md
T

6.0 KiB

技术设计:共享结构驱动的复杂路口构建

核心选择

采用“来源拓扑 → 有效结构与接入断面 → 共享边界 → 道路区域 → 设施与连接”的分层管线。不增加按 T/十字等标签分派的独立绘图模板,也不首期引入不可解释的全局非线性自动优化器。

自动推断提供初稿,显式结构校正与几何校正处理源数据不足。支持范围有限且可检测;无法求解时输出对象级原因,不制造假连通。

模型与边界

新增内部纯数据 JunctionBuildPlan(内部版本独立于展示结构):

  • SourceTopology:有向车行道及来源 ID、外部接入/内部连接、道路臂归组、已知分隔关系、允许通行关系和推断来源。臂不是一个实心总宽矩形。
  • EntrySection:所属 carriageway、接入中心/方向、左右边界端点、远端固定截面、可用过渡范围。边界按朝路口外侧的局部坐标定义,与 forward/backward 显式换算。
  • BoundaryGraph:接入边、路缘曲线、共享接缝、闭合环、已知排除区域;每条共享边只有一个几何所有者,由相邻面引用。内部允许凹形区域、孔洞及多个通行区域,不能用“全部端点凸包”抹去分隔关系。
  • Dependency:参数到接入断面、边界、面、设施的依赖。修改局部只重新求值必要对象;不承诺相邻角部完全不变,但必须保持约束外的固定锚点和不相关路口不变。

junction-structure/v1 保持前端投影,按需扩展展示字段;不在客户端生成第二份几何模型。稳定键由来源和显式关系决定,不随坐标调整或角度排序变化。归组改变属于拓扑编辑,改变 fingerprint 并触发受影响约束重检。

构建步骤

  1. 服务层预加载参考配置,纯拓扑解析统一 compiler 与 resolver 当前重复逻辑。先区分进出车行道、分隔关系与内部通路,再形成道路臂;方向相近只作候选依据。
  2. 按各车行道真实中心线和可用长度定义固定远端与可编辑接入断面。不能将“沿线距离”与“到平均中心的半径”混用。允许偏移/方向/左右展宽通过过渡接回固定远端。
  3. 邻接边界先求交和安全连接,局部选择直线/受约束曲线。圆角切点限制来自两侧可用边界;不可行则拒绝该编辑或给出明确降级,不用孤立补面遮盖。
  4. 从闭合边界图构造铺装区域,保留已知不可通行区域;验证连通、相交与孔洞。几何布尔运算只是实现工具,不能决定哪个区域“应当是岛”。共享语义键不依赖布尔运算输出顺序。
  5. 所有道路面、路缘/步行带、边线和车道标线使用同一有效接入与裁切计划。设施定位消费最终可行区域;交通连接是有向运动关系,与平面面邻接分开。允许机动车路径相交,不将其误判成边界自交。
  6. 编译几何验证与 solver 诊断合并,经同一 compileEditCandidate 供预览与保存使用。

编辑协议

复用 native-road-edits/v2 约束与操作历史。新增语义约束建议为 carriageway 接入位姿、左右横向边界与过渡长度;schema 的名称及单位在阶段 1 契约落地时固定。位姿以源断面为基准的局部米制偏移/角度定义,避免绝对坐标缺乏来源;分量标量输入也必须落到完整同一约束。归组覆盖使用稳定源 carriageway 集合,禁止保存界面序号。

优先级:显式局部覆盖 > 已保存路口默认 > 自动基线;批量操作先确定目标集合,再合成约束,不能把后一次草稿的基线覆盖前一次修改。重置沿现有禁用约束语义,保存版本冲突遵循 409 合约。

数据不足和设施范围

仅根据夹角不能证明存在导流岛或独立右转道路。已知设施使用显式来源/区域;推断对象标明推断原因,缺少通行区域或步行端点证据时不输出伪造有效设施。未知与不存在分开表达。本期不提供岛体自由编辑器,但 BoundaryGraph 可表达其排除区域与相邻通道,避免下一期推翻基础模型。

设施语义契约

复杂路口中的行人安全岛不是独立的固定角部多边形。它是三组过街连接之间的不可通行区域:一条进口斑马线和相邻两个角部斑马线共同限定其边界。CrosswalkConnection 必须连接两个有效步行边界;其内侧端点吸附到 PedestrianIsland 或路缘边界,不能悬空或穿过岛体。

  • PedestrianIsland:独立的不可通行区域,有连续路缘边界,可作为分阶段过街等待空间。
  • CrosswalkConnection:连接人行道、路缘或安全岛的过街区域;斑马线不是道路装饰层。
  • CurbBoundary:机动车通行区与步行区域的共享边界,安全岛和斑马线都消费同一边界。
  • CurbExtension 与 PedestrianIsland 分开建模;前者是人行道向车行道的扩展,后者位于机动车流之间。
  • 复杂路口设施的求解顺序为:机动车区域 → 步行边界 → 三组过街连接 → 安全岛可行区域 → 端点吸附和冲突验证。

兼容、性能与风险

  • 新管线先在显式 geometry version 下验证;旧复杂文档不能直接换默认值或静默裁剪。缺省构建应确定性;迁移报告逐约束列出可重放、需重检、失效及原因。普通路口输出回归保持不变。
  • 半径和收口既有语义不等同于新接入位姿,不能凭名称强行映射;保留兼容适配,冲突显式处理。
  • 不为性能让浏览器复制几何算法。记录相同输入的冷/热预览耗时与 payload;300 ms 是既有预算提示,不是无需实测的完成承诺。pending 从排队到最新结果完成持续有效。
  • 局部米制计算与 GeoJSON 经纬度输出分离;方向绕回、曲线进口、短路段、多区域、来源不完整均为失败风险。
  • 回滚按管线/能力关闭;保留新文档的可读性和不支持诊断,禁止旧管线忽略新约束却显示成功。