Files
road-compiler/.trellis/tasks/09-08-junction-reference-fidelity/validation-report.md
T

40 lines
3.1 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.
# Junction Reference Fidelity Validation
日期:2026-09-11
任务:`09-08-junction-reference-fidelity`
## 结论
首期支持边界内的通用构建、局部校正和保存闭环已通过自动质量门。真实 OSM 外部验证使用未参与调参的 `test/fixtures/fengshu-er-road.osm`;其 5 臂、9 车行道分隔结构被识别并保留独立来源身份。由于该数据包含无法确认中心通行关系的并行车行道,中心核心面按契约拒绝闭合,保留各进口道路面并发布对象级诊断。这是支持矩阵中的明确拒绝,不计作完整核心区域通过。
## A1-A8 证据
| 项 | 结果 | 证据 |
| --- | --- | --- |
| A1 | 通过(支持矩阵) | `test/junction-build-plan-counterexamples.js` 覆盖 3/4/5/6 臂、T/十字、偏置和分隔组合;无样本 ID 分支。 |
| A2 | 通过 | 拓扑测试覆盖输入重排、平移、旋转及跨 0°;`test/junction-projection.js` 验证稳定键和 fingerprint。 |
| A3 | 通过(可行结构);分隔核心按规则拒绝 | 入口环有限、闭合、正面积、无自交;必要连接、孔洞和排除区回归;共享接缝实测误差 ≤1 cm,并覆盖人为 2 m 损坏检测。 |
| A4 | 通过 | `test/e2e/workbench.spec.ts` 的 12 项浏览器回归覆盖三臂结构和真实五臂工作台的位姿、方向、左右边界、过渡长度、撤销、保存、重编译、刷新。 |
| A5 | 通过 | solver/manifest 共用可行域;越界、来源长度不足、拓扑变化和 409 均返回明确诊断或重检状态,不静默截断。 |
| A6 | 通过 | 复杂路口仅在匹配的 OSM crossing 节点提供来源证据时生成斑马线,并保留来源 provenance;无来源时省略复杂斑马线,停止线独立保留并标记 `unknown-no-crossing-source`。简单路口继续使用原有设施路径。已知排除区和步行连接保留 provenance。 |
| A7 | 通过 | 工作台 API/E2E 验证预览、保存、409 重试、撤销重做、刷新回放和版本保护。 |
| A8 | 部分通过,待用户视觉确认 | 未调参真实 OSM 的纯效果和调试效果已刷新;原始三组图片只作定性观察,未配准不作为几何真值。 |
## 真实 OSM 产物
- 输入:`test/fixtures/fengshu-er-road.osm`
- cluster:`cluster-8005332807`
- 结构:5 臂,9 条独立车行道
- 控件:宽度 9、过渡长度 9、收口 9、位置 9、方向 9、左右边界 18、角部半径 5、停止线偏移 5
- 纯效果:[references/current-pure.png](references/current-pure.png)
- 调试效果:[references/current-debug.png](references/current-debug.png)
- 指标与诊断:[references/current-metrics.json](references/current-metrics.json)
## 明确限制
当前不承诺无法从来源确认通行关系的多区域核心自动重求解、任意曲线的全局切向优化、导流岛自由编辑或独立右转通道创建。此类输入保留可验证的进口结构,输出对象级拒绝原因。
## 验证命令
`npm test`、`npm run test:client`、`npm run test:client:unit`(191 tests)、`npm run test:e2e`(12 tests)、`npm run format:check`、`git diff --check`。