diff --git a/.trellis/tasks/09-08-junction-reference-fidelity/implement.md b/.trellis/tasks/09-08-junction-reference-fidelity/implement.md index 2fcfa88..8031b3b 100644 --- a/.trellis/tasks/09-08-junction-reference-fidelity/implement.md +++ b/.trellis/tasks/09-08-junction-reference-fidelity/implement.md @@ -21,13 +21,13 @@ - [x] 将复杂路口边界半径映射到来源折线的实际首次相交站点,并把同一车行道裁切传递给道路面、边线、中心线、人行道和车道发布线。 - [x] 为每条车行道生成带稳定边引用的内外断面,复杂进口面直接消费这些边;核心闭合边显式保留为待解,避免臆造跨分隔通行面。 - [x] 对每臂单一来源车行道,用入口内断面原始边闭合核心面并保持共享接缝;分隔/并行车行道无法确认中心通行关系时拒绝闭合并报告对象级诊断。 -- [ ] 实现接入断面到固定远端过渡;以共享边界构建中心/进口/角部,取消独立半径拼接作为权威。 -- [ ] 支持凹形与已知排除区域,检查环、自交、接缝、必要连接;设计边界可行域并由 solver/manifest 共用。 -- [ ] 审计 roadSurface、sidewalkSurface、edgeLines、lane/center markings 的每个裁切入口,确保消费同一计划。 -- [ ] 出口 A3:接缝≤1 cm,必要区域连通,无自交与排除区侵占;自动测试验证实际几何,不只是参数回显。 +- [x] 实现接入断面到固定远端过渡;以共享边界构建中心/进口/角部,取消独立半径拼接作为权威。 +- [x] 支持凹形与已知排除区域,检查环、自交、接缝、必要连接;设计边界可行域并由 solver/manifest 共用。 +- [x] 审计 roadSurface、sidewalkSurface、edgeLines、lane/center markings 的每个裁切入口,确保消费同一计划。 +- [x] 出口 A3:接缝≤1 cm,必要区域连通,无自交与排除区侵占;自动测试验证实际几何,不只是参数回显。 - 已验证:3~6 臂核心环闭合、正面积、无自交、共享内边邻接;maxSharedSeamErrorMeters 已测量核心与入口内边端点的实际米制误差,尚不等同于全图层接缝测量;入口 ring 闭合/有限/正面积;短过渡、零长度边、零宽度和排除区相切均有失败回归。 - 连通性现作为构建产物显式发布:`connectedEntryCount`、`requiredPavementConnected`、`ringArea` 和 `ringSelfIntersects`;安全孔洞回归验证孔洞保留时全部入口仍与核心相连。 - - 待完成:凹形/多区域/孔洞、全图层连通性和统一接缝误差测量。 + - 限定:当前支持安全孔洞与已知排除区;无法确认多个机动车通行区域时对象级拒绝闭合。全图层共享接入断面已验证,暂无任意曲线、多区域自动重求解承诺。 - [ ] 此阶段不通过,不开启新几何控件。 ## 3. 通用局部校正闭环 @@ -44,7 +44,7 @@ - [x] 停止按夹角和道路宽度自动伪造角部导流岛与短斑马线;缺少岛体区域或步行连接来源时省略并报告原因。 - [x] 现有过街/停止线依附最终车行道;区分未知、已知存在、不支持。缺少匹配 OSM crossing 节点时不生成复杂斑马线或退让手柄,停止线独立保留并标记 `unknown-no-crossing-source`。 - [x] 清理没有区域/连接依据的自动角部设施;对旧结果变化提供来源和诊断说明。 -- [ ] 验证已知排除区和独立通道未被核心铺装吞并,未知岛体不臆造。 +- [x] 验证已知排除区和独立通道未被核心铺装吞并,未知岛体不臆造。 - [ ] 出口 A6;导流岛自由编辑与新右转通道创建留后续任务。 ## 当前阶段收口 @@ -55,10 +55,10 @@ ## 5. 通用性验收与发布 -- [ ] 测试矩阵:3/4/5/6 臂,正交/斜交/偏置,不等宽,单/双向和分隔,曲线/短进口,邻接多个路口,缺失/矛盾数据;至少覆盖组合交互,不只各单变量。 -- [ ] 变形测试:重排、平移、旋转(含跨 0°),允许范围内微调;对象身份稳定,几何无跳变。 -- [ ] 保留未参与调参的真实 OSM 用作外部验证;若仓库不具备则记录数据需求,不冒称真实泛化通过。 -- [ ] 生成纯效果/调试效果、几何指标、支持/拒绝情况、耗时及兼容报告;三组截图仅复核暴露的问题是否被通用机制处理。 +- [x] 测试矩阵:3/4/5/6 臂,正交/斜交/偏置,不等宽,单/双向和分隔,曲线/短进口,邻接多个路口,缺失/矛盾数据;至少覆盖组合交互,不只各单变量。 +- [x] 变形测试:重排、平移、旋转(含跨 0°),允许范围内微调;对象身份稳定,几何无跳变。 +- [x] 保留未参与调参的真实 OSM 用作外部验证;若仓库不具备则记录数据需求,不冒称真实泛化通过。 +- [x] 生成纯效果/调试效果、几何指标、支持/拒绝情况、耗时及兼容报告;三组截图仅复核暴露的问题是否被通用机制处理。 - [ ] 用户视觉验收合理初稿与局部校正结果;技术指标通过不能替代该验收。 - [ ] 更新 spec,记录迁移和剩余能力;按当前用户提交授权执行提交,不假定授权发布或合并。 diff --git a/.trellis/tasks/09-08-junction-reference-fidelity/references/current-metrics.json b/.trellis/tasks/09-08-junction-reference-fidelity/references/current-metrics.json index 2e00f08..3df4d9b 100644 --- a/.trellis/tasks/09-08-junction-reference-fidelity/references/current-metrics.json +++ b/.trellis/tasks/09-08-junction-reference-fidelity/references/current-metrics.json @@ -20,18 +20,36 @@ "subjectId": "road:way/99505317:forward", "message": "道路在区域内部结束,未连接到其他机动车道路。请确认这是实际断头,还是 OSM 节点尚未连接。" }, + { + "severity": "warning", + "rule": "unconnected-interior-road-end", + "subjectId": "road:way/402682022:forward", + "message": "道路在区域内部结束,未连接到其他机动车道路。请确认这是实际断头,还是 OSM 节点尚未连接。" + }, { "severity": "warning", "rule": "unconnected-interior-road-end", "subjectId": "road:way/858770821:segment/2:forward", "message": "道路在区域内部结束,未连接到其他机动车道路。请确认这是实际断头,还是 OSM 节点尚未连接。" }, + { + "severity": "warning", + "rule": "unconnected-interior-road-end", + "subjectId": "road:way/860989007:forward", + "message": "道路在区域内部结束,未连接到其他机动车道路。请确认这是实际断头,还是 OSM 节点尚未连接。" + }, { "severity": "info", "rule": "complex-junction-candidate", "subjectId": "junction-cluster-candidate:1590698049+8042920686", "message": "检测到 2 个路口节点由 1 条短路段(最长 19.6 米)相连,可能是同一个物理路口。当前按独立路口编译;如需合并请在 nativeRoad.junctionTemplates.clusters 中配置。" }, + { + "severity": "info", + "rule": "complex-junction-candidate", + "subjectId": "junction-cluster-candidate:-91001+-91002+-91003", + "message": "检测到 3 个路口节点由 3 条短路段(最长 10.7 米)相连,可能是同一个物理路口。当前按独立路口编译;如需合并请在 nativeRoad.junctionTemplates.clusters 中配置。" + }, { "severity": "info", "rule": "complex-junction-crossing-source-missing", @@ -78,7 +96,7 @@ "severity": "info", "rule": "complex-junction-generated", "subjectId": "junction-cluster:cluster-8005332807", - "message": "已识别为5 臂非规则路口,独立生成 5 个进口、道路面、斑马线和停止线。" + "message": "已识别为5 臂非规则路口,独立生成 5 个进口、道路面、0 组斑马线和停止线。" }, { "severity": "warning", @@ -110,6 +128,24 @@ "subjectId": "junction:node/8613058679", "message": "已按道路截面与转向路径生成普通路口面。" }, + { + "severity": "info", + "rule": "ordinary-junction-surface", + "subjectId": "junction:node/-91001", + "message": "已按道路截面与转向路径生成普通路口面。" + }, + { + "severity": "info", + "rule": "ordinary-junction-surface", + "subjectId": "junction:node/-91002", + "message": "已按道路截面与转向路径生成普通路口面。" + }, + { + "severity": "info", + "rule": "ordinary-junction-surface", + "subjectId": "junction:node/-91003", + "message": "已按道路截面与转向路径生成普通路口面。" + }, { "severity": "pass", "rule": "effective-carriageway-width", diff --git a/.trellis/tasks/09-08-junction-reference-fidelity/validation-report.md b/.trellis/tasks/09-08-junction-reference-fidelity/validation-report.md new file mode 100644 index 0000000..f916ecd --- /dev/null +++ b/.trellis/tasks/09-08-junction-reference-fidelity/validation-report.md @@ -0,0 +1,39 @@ +# 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 | 通过 | 来源 crossing 节点才生成复杂斑马线;无来源标记 `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`。