Files

3.0 KiB

复杂路口手动切换与独立浏览

Goal

让用户可以针对 枫树二路.osm 中的复杂路口候选,在独立 JunctionTools 页面中将该候选从普通路口渲染切换为 complex-junction-v1,通过局部预览确认效果,并可放弃或保存。首版解决复杂路口当前普通渲染难看的问题,同时保留普通路口既有编辑能力。

Background and Confirmed Facts

  • /Users/que01/Desktop/枫树二路.osm 当前编译会产生多组 complex-junction-candidate 诊断。
  • 首个验证候选为节点 8005332807、8024512135、8024512145、8024512147、8613058676,节点直径约 41.2m,建议核心半径约 32m,关联道路为硃山湖大道、枫树二路。
  • 复杂路口几何由 src/compile/complex-junction.js 生成;只有 nativeRoad.junctionTemplates.enabled=true 且存在对应 cluster 配置时才会启用。
  • cluster 当前在 src/compile/direct-edit-solver.js 与 JunctionTools 中为只读,不能通过解除前端限制直接编辑。
  • 候选检测是 advisory,只产生 complex-junction-candidate 诊断,不会自动改变几何。

In Scope

  1. 候选复杂路口可进入独立 JunctionTools 页面。
  2. 页面显示当前渲染模式:普通路口或复杂路口;普通模式提供“启用复杂路口渲染”入口。
  3. 切换使用候选诊断提供的 cluster 节点和建议核心半径,并只影响该 cluster。
  4. 切换后提供局部复杂路口几何预览,支持放弃、保存;保存后重新编译,刷新仍保持状态。
  5. 复杂路口页面保持只读参数状态,并明确提示首版暂不支持复杂路口几何拖拽编辑。
  6. 切换入口只放在独立页面状态区,不在主地图候选标记上提供快捷切换。

Out of Scope

  • 不根据候选自动启用或静默切换。
  • 不开放复杂路口核心半径、进口宽度、收口距离、圆角等拖拽编辑。
  • 不修改 OSM 拓扑,不创建或删除道路、信号灯、斑马线、停止线等设施。
  • 不跨多个 cluster 联合编辑。
  • 不改变普通路口现有 JunctionTools 行为。

Acceptance Criteria

  • 从 枫树二路.osm 的目标候选可进入独立 JunctionTools 页面。
  • 页面明确显示“当前按普通路口渲染”,并提供“启用复杂路口渲染”。
  • 预览只改变目标 cluster 的局部几何,其他路口保持不变。
  • 放弃后恢复普通路口渲染;保存并刷新后仍显示复杂路口渲染。
  • 复杂路口页面不显示可编辑普通 node 控件,未实现的参数编辑明确为只读。
  • 普通路口既有测试、复杂路口相关测试、类型检查和构建通过。

Risks and Deferred Decisions

  • 复杂 cluster 配置写入现有 nativeRoad.junctionTemplates.clusters 语义;若现有保存 API 不能原子更新该配置,需要在 API 层增加最小专用操作,不能从前端直接写派生 GeoJSON。
  • 自动识别和自动切换留待首版验证后另行商议。