Files
road-compiler/.trellis/tasks/09-08-cj-01-identity/design.md
T

1.4 KiB

权威结构与稳定对象标识设计

边界与数据流

遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。

  1. 提取 complex-junction.js 中外部臂解析与形态分类所需的共用拓扑;geometry 与 projection 消费同一个结果。
  2. 定义 JunctionRef、稳定 arm/carriageway/corner/facility key、source 映射与 topology fingerprint;标签编号与身份分离。
  3. 修复 junction-structure normalizer 保留新增字段;projection 不再取首个 core 或按 road 数组凑角部。
  4. 补齐 server selection 与客户端类型,保留旧 junction=node 请求;复杂参数能力暂为只读。

影响文件

  • src/compile/complex-junction.js
  • src/compile/junction-projection.js
  • src/compile/junction-structure.js
  • workbench/server.js
  • workbench/client/src/junction/hotspots.ts
  • workbench/client/src/edit/types.ts

兼容与失败行为

保留 node 路口现有文档与操作语义;新字段必须经过 validator、序列化、API 和客户端类型的完整往返。缺失或歧义来源显式只读/失效,不能通过数组下标修复引用。preview 不落盘,保存沿用版本冲突保护。

回滚

按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。