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

2.5 KiB
Raw Blame History

第 1 阶段验收记录

日期:2026-09-08。范围:复杂路口权威只读结构、稳定身份、作用域与地图选择。参数编辑属于第 2 阶段,未开放。

结果映射

  • A1:test/junction-projection.js 验证两份 cluster 编译结果不串用;test/workbench-edit-api.js 验证复杂与独立普通 node 的 scoped 结构;新增浏览器用真实候选开启复杂路口,验证列表→地图高亮与页面重载。
  • A2:真实五臂样本重排 node/road 输入后,语义 ID、指纹和实际几何坐标一致;删除来源改变身份;重复来源显式只读。
  • A3:合成 3/4/6 臂与 offset-cross 拓扑测试,以及真实五臂编译测试;内部连线不进入外部臂结构。偏置十字本阶段验证结构与分类,不宣称已完成真实偏置几何编辑验收。
  • A4:新增 provenance/capability 的 JSON/normalizer 往返;旧 node 文档与编辑接口回归通过。信号通过明确成员节点关联并保留原始 UID,未改写信号存储。

验证命令

  • npm test:通过,含 package、structure、projection、v2 document、revision、solver、API、import/compile 和 fixtures。首次因沙箱禁止本机端口失败,沙箱外重跑通过。
  • npm run test:client:通过。
  • npm run test:client:unit:15 文件、180 测试通过。
  • npm run build:通过;已有超过 500 kB 的 bundle 提示仍存在。
  • npm run test:e2e:11 测试通过,含新增复杂路口与既有简单路口回归。
  • npm run format:check、git diff --check:通过。
  • 复核修正信号投影、来源缺失诊断、provenance 校验、空结构过滤、浏览规范诊断汇总后,补跑 test/junction-projection.js、test/junction-structure.js、test/workbench-edit-api.js,全部通过。

实际设计与边界

编译器的 resolveComplexJunctionTopology 统一几何和结构身份。结构保存在 complex core/approach 的 junction_structure,API 投影从持久化结果读取;没有另建第二套客户端拓扑。新 metadata 不改变既有 v2 anchor。只读能力覆盖道路臂、角部、过街/停止线/岛/人行道转角及已有信号。

浏览状态 junctionStructures 只包含可用条目;没有复杂生成结果时不给出虚构结构,编辑 manifest 返回空。前端地图/列表用稳定 key 与明确 provenance 匹配,选择覆盖层只读且不重建地图。

下一步:09-08-cj-02-width,在这些稳定对象上实现宽度输入/拖拽、真正的复杂几何消费、预览/保存/重编译闭环。