chore(task): archive completed road editor workflows

This commit is contained in:
que01 committed 2026-09-07 14:21:57 +08:00
1 parent 39e338668b
commit d61c86ed2c
26 files changed
+6 -6

No files matched your search

@@ -0,0 +1,44 @@
# 复杂路口手动切换与独立浏览
## 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。
- 自动识别和自动切换留待首版验证后另行商议。