docs(task): record complex junction editing roadmap

This commit is contained in:
que01 committed 2026-09-08 11:25:05 +08:00
1 parent bba3ebe4b0
commit bd8b55e58b
44 files changed
+955

No files matched your search

@@ -0,0 +1,32 @@
# 技术设计
## 架构
从复杂几何生成器提取共用的 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 诊断,禁止静默丢弃文档。