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

29 lines
2.5 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.
# 第 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,在这些稳定对象上实现宽度输入/拖拽、真正的复杂几何消费、预览/保存/重编译闭环。