From 92c5977dd67f2539d40c4311dd6015e2a974f9a8 Mon Sep 17 00:00:00 2001 From: que01 Date: Mon, 14 Sep 2026 14:22:38 +0800 Subject: [PATCH] docs: add junction visual acceptance checklist --- .../implement.md | 2 + .../visual-acceptance-checklist.md | 66 +++++++++++++++++++ 2 files changed, 68 insertions(+) create mode 100644 .trellis/tasks/09-08-junction-reference-fidelity/visual-acceptance-checklist.md diff --git a/.trellis/tasks/09-08-junction-reference-fidelity/implement.md b/.trellis/tasks/09-08-junction-reference-fidelity/implement.md index 71c1b7e..e44194d 100644 --- a/.trellis/tasks/09-08-junction-reference-fidelity/implement.md +++ b/.trellis/tasks/09-08-junction-reference-fidelity/implement.md @@ -54,6 +54,8 @@ 明确遗留:复杂排除区绕行和多机动车通行区域自动重求解,全图层接缝测量,真实 OSM 视觉验收。导流岛自由编辑和独立右转通道继续留在后续任务。 +人工验收按同目录 `visual-acceptance-checklist.md` 执行。用户只需对 7 项结构观察和最小编辑闭环记录通过/失败及截图,不需要自行判断内部几何指标。 + ## 5. 通用性验收与发布 - [x] 测试矩阵:3/4/5/6 臂,正交/斜交/偏置,不等宽,单/双向和分隔,曲线/短进口,邻接多个路口,缺失/矛盾数据;至少覆盖组合交互,不只各单变量。 diff --git a/.trellis/tasks/09-08-junction-reference-fidelity/visual-acceptance-checklist.md b/.trellis/tasks/09-08-junction-reference-fidelity/visual-acceptance-checklist.md new file mode 100644 index 0000000..f821da5 --- /dev/null +++ b/.trellis/tasks/09-08-junction-reference-fidelity/visual-acceptance-checklist.md @@ -0,0 +1,66 @@ +# 复杂路口人工验收清单 + +这份清单只验证真实工作台的可见结果。每一步只需要记录“通过”或“失败”,失败时截一张图并写下步骤编号。 + +## 1. 启动与进入样例 + +在项目根目录执行: + +```bash +npm run road:workbench +``` + +浏览器打开 。等待地图和“道路编译工作台”出现。 + +在地图或路口列表中打开一个标记为复杂路口的 3~6 臂路口;优先使用四臂样例。进入“路口编辑工作区”后,确认页面没有红色错误提示。 + +## 2. 只看图的结构验收 + +开启“自研道路与路口面”“斑马线/停止线”“人行道与导流岛”“转向路径”图层,放大到路口中心。 + +逐项检查: + +1. 每个有效角部都有一个三角形安全岛;四臂路口应看到 4 个。 +2. 每个安全岛都有 3 组斑马线接触:两组组成直角边,第三组贴着弧形长边。 +3. 斑马线之间没有四角正方形重叠;白条方向统一、长度和间隔看起来一致。 +4. 安全岛三个角是圆角;岛体显示为绿色六点区域,绿色区域没有跑到岛体外。 +5. 停止线与对应斑马线之间有清晰空隙,没有压在斑马线上。 +6. 路口中心铺装连续,没有明显的空洞、尖角或悬空道路面。 +7. 转向路径从入口车道连续进入出口车道,没有明显断裂、自交或穿过安全岛。 + +通过标准:以上 7 项全部通过。任何一项失败都只需记录编号和截图,不要先尝试拖动修复。 + +## 3. 最小编辑闭环 + +开启编辑模式,在同一个复杂路口依次只改一个字段,每次等待地图完成预览: + +1. 进口宽度:增加约 0.5 m。 +2. 进口方向:增加约 5°。 +3. 左边界或右边界:向外拖约 0.5 m。 +4. 过渡长度:增加约 1 m。 + +每次修改检查: + +- 地图在约 2 秒内有变化,没有白屏; +- 安全岛仍为三角形,3 组斑马线仍完整接触; +- 没有新增红色诊断; +- 点击“撤销”后恢复上一个状态,点击“重做”后回到修改状态。 + +最后点击“保存并重新生成”,等待“已保存并重新生成”,刷新页面,确认最后一次修改仍存在。 + +## 4. 来源治理验收 + +再打开一个没有匹配 OSM crossing 来源的探出分支或普通复杂候选: + +- 不应凭空出现复杂斑马线; +- 停止线可以保留; +- 问题列表应出现 `complex-junction-crossing-source-missing` 或对应中文诊断。 + +## 5. 需要用户做决定的项目 + +以下项目不在本清单的“通过”范围内,需要单独决定产品规则: + +- 复杂排除区域是否必须自动绕行; +- 多个机动车通行区域是否必须自动规划连通; +- 车辆轨迹是否需要车辆宽度、扫掠范围和最小转弯半径保证。 +