Files
road-compiler/.trellis/tasks/09-08-complex-junction-editing/design.md
T

33 lines
3.6 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.
# 技术设计
## 架构
从复杂几何生成器提取共用的 cluster 外部拓扑解析,输出显式 JunctionRef、道路臂、组成车行道、相邻角部、设施及来源映射。正式编译、编辑 manifest 和结构投影消费同一份拓扑,前端只做显示与选择。
流程:cluster 配置 + baseline model → 外部拓扑 → v2 约束解析 → effective cluster plan → complex geometry → structure / manifest / diagnostics → EditSession。预览与保存复用候选求值;保存成功后沿用显式重新编译并刷新状态的流程。
## 对象与约束
- 引用使用 `{type: 'node'|'cluster', id}`。兼容既有 node 请求,新增显式 cluster 选择,禁止猜测无类型 ID;同时传多个选择应拒绝。
- Arm 身份来自 cluster ID 与稳定来源成员集合,不能来自数组下标、地图编号或浮点 heading;一臂可含多条有方向的车行道。车行道保留 node/segment/road 来源,目标宽度不包含中央分隔或人行道。
- Corner 身份由有序相邻臂对定义,来自环向几何排序;同一源拓扑下输入排序变化不改变 ID。拓扑指纹区分重排和真正成员变化。
- 设施采用语义对象标识;一组条纹对应一个 crossing 对象,停止线关联到对应来向 crossing,信号关联使用显式来源,不用字符串包含推断。
- 拟新增 cluster 专用 anchor(junctionRef + object kind/key + 必要车行道来源),扩展 v2 validator、客户端联合类型、replay 和 resolver。旧 node anchor 继续原样读取,不能复用 nodeId 字段塞入 cluster ID。
- 约束优先级:对象局部覆盖 > cluster 该参数默认值 > 编译基线。恢复继承禁用局部约束并记录操作;不删除仍被历史引用的约束。默认宽度作用于各外部车行道;道路臂批量操作明确列出组成车行道与影响范围,不把多个分离车行道的总宽当作单条路宽。
## 几何消费与校验
cluster effective plan 是复杂生成器的显式输入,不回写所有成员 node plan。宽度影响道路边界及必要连接;收口沿对应外部车行道中心线计距;角部圆角只作用于对应相邻边界。复杂核心、过街、人行道和连接面的联动由生成器统一生成。
候选求值先验证文档,再用相同 cluster 配置解析、编译并收集诊断。保存必须在任何候选写入之前拒绝 solver 或 compiled geometry error;warning 允许保存。不存在对象、越界、自交、过街越出可用路幅及断开的必要连接应给出对象级诊断,不能静默钳制输入或回退成看似成功的普通路口。
## 会话与兼容
App 继续负责跨域保存与重编译,组件不直接调 API。复用现有 EditSession、PreviewRequester 和手柄系统。请求带有作用域身份及序列校验,切换作用域放弃正在进行的手势并使旧响应失效;保持全局文档中其他对象的约束。地图实例不能因右栏或路口切换重建。
旧 node 文档几何保持一致。复杂编辑能力按参数发布,只有 anchor、求解、geometry、manifest、保存和 UI 都通过验收后才标记可编辑。高级设施没有实现的自由编辑能力保持只读。
## 风险与回滚
现有角度聚类和内部连线排除规则需要真实样本验证;歧义对象不开放编辑。几何校验会增加保存成本,应记录耗时及预览 degraded 状态。参考几何继续只读,不作为编辑真值。每个子任务独立提交;回滚先关闭对应能力入口,保留已保存约束的可读性及显式 unsupported 诊断,禁止静默丢弃文档。