3.0 KiB
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
- 候选复杂路口可进入独立 JunctionTools 页面。
- 页面显示当前渲染模式:普通路口或复杂路口;普通模式提供“启用复杂路口渲染”入口。
- 切换使用候选诊断提供的 cluster 节点和建议核心半径,并只影响该 cluster。
- 切换后提供局部复杂路口几何预览,支持放弃、保存;保存后重新编译,刷新仍保持状态。
- 复杂路口页面保持只读参数状态,并明确提示首版暂不支持复杂路口几何拖拽编辑。
- 切换入口只放在独立页面状态区,不在主地图候选标记上提供快捷切换。
Out of Scope
- 不根据候选自动启用或静默切换。
- 不开放复杂路口核心半径、进口宽度、收口距离、圆角等拖拽编辑。
- 不修改 OSM 拓扑,不创建或删除道路、信号灯、斑马线、停止线等设施。
- 不跨多个 cluster 联合编辑。
- 不改变普通路口现有 JunctionTools 行为。
Acceptance Criteria
- 从
枫树二路.osm的目标候选可进入独立 JunctionTools 页面。 - 页面明确显示“当前按普通路口渲染”,并提供“启用复杂路口渲染”。
- 预览只改变目标 cluster 的局部几何,其他路口保持不变。
- 放弃后恢复普通路口渲染;保存并刷新后仍显示复杂路口渲染。
- 复杂路口页面不显示可编辑普通 node 控件,未实现的参数编辑明确为只读。
- 普通路口既有测试、复杂路口相关测试、类型检查和构建通过。
Risks and Deferred Decisions
- 复杂 cluster 配置写入现有
nativeRoad.junctionTemplates.clusters语义;若现有保存 API 不能原子更新该配置,需要在 API 层增加最小专用操作,不能从前端直接写派生 GeoJSON。 - 自动识别和自动切换留待首版验证后另行商议。