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