Files
road-compiler/.trellis/tasks/archive/2026-09/09-04-complex-junction-toggle/design.md
T

27 lines
1.6 KiB
Markdown

# 技术设计
## 边界
- 编译层复用 `src/compile/complex-junction.js` 与 `src/compile/native-road.js` 的既有 cluster 几何生成逻辑,不复制几何算法。
- 服务层负责读取候选、生成目标 cluster 配置、预览编译和持久化;保存遵守现有 revision/document 版本保护与原子写入约束。
- 前端只在 JunctionTools 独立页面消费候选和 cluster 状态,复用现有地图图层工厂与预览层,不污染普通路口 baseline。
## 数据流
1. `/api/edit-state` 或现有诊断数据提供候选 cluster 标识、节点集合、道路摘要、建议核心半径及当前启用状态。
2. 独立页面展示状态;用户点击启用后创建内存 draft,不立即写文件。
3. 预览请求携带 draft cluster 配置,服务端在临时编译上下文中生成局部复杂路口图层并返回 preview 序列号。
4. 放弃丢弃 draft 并恢复 baseline;保存经版本校验后原子写入 `nativeRoad.junctionTemplates.clusters`,随后触发正式编译。
5. 刷新重新从 edit-state/编译状态读取持久化配置。
## 兼容性与回滚
- 没有启用配置时保持现有普通路口输出字节和交互不变。
- 保存失败或版本冲突不改变活动配置;预览失败只清除预览并保留 draft 可重试。
- 不把候选诊断直接转换为启用配置,避免大范围几何变化。
## 取舍
- 首版只提供独立页面入口,避免主地图状态同步和误操作复杂度。
- 首版复杂参数只读,先验证渲染质量;后续再以独立约束模型开放编辑。