Files

1.6 KiB

技术设计

边界

  • 编译层复用 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 可重试。
  • 不把候选诊断直接转换为启用配置,避免大范围几何变化。

取舍

  • 首版只提供独立页面入口,避免主地图状态同步和误操作复杂度。
  • 首版复杂参数只读,先验证渲染质量;后续再以独立约束模型开放编辑。