# 技术设计 ## 边界 - 编译层复用 `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 可重试。 - 不把候选诊断直接转换为启用配置,避免大范围几何变化。 ## 取舍 - 首版只提供独立页面入口,避免主地图状态同步和误操作复杂度。 - 首版复杂参数只读,先验证渲染质量;后续再以独立约束模型开放编辑。