Files
road-compiler/.trellis/tasks/09-08-junction-reference-fidelity/visual-acceptance-checklist.md
T

2.8 KiB

复杂路口人工验收清单

这份清单只验证真实工作台的可见结果。每一步只需要记录“通过”或“失败”,失败时截一张图并写下步骤编号。

1. 启动与进入样例

在项目根目录执行:

npm run road:workbench

浏览器打开 http://127.0.0.1:8899/。等待地图和“道路编译工作台”出现。

在地图或路口列表中打开一个标记为复杂路口的 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. 需要用户做决定的项目

以下项目不在本清单的“通过”范围内,需要单独决定产品规则:

  • 复杂排除区域是否必须自动绕行;
  • 多个机动车通行区域是否必须自动规划连通;
  • 车辆轨迹是否需要车辆宽度、扫掠范围和最小转弯半径保证。