docs(task): record complex junction editing roadmap

This commit is contained in:
que01 committed 2026-09-08 11:25:05 +08:00
1 parent bba3ebe4b0
commit bd8b55e58b
44 files changed
+955

No files matched your search

@@ -0,0 +1,30 @@
# 宽度编辑端到端闭环设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 扩展 v2 anchor validator、联合类型、resolver 和 replay,cluster anchor 使用显式来源映射,不在 nodeId 中存 cluster ID。
2. 建立 cluster effective plan,宽度由复杂生成器直接消费;多车行道臂保留分项宽度,批量设置使用一个可撤销命令。
3. 抽取 preview/save 共用候选求值(同配置、同 solver、同 compiler diagnostics);任何候选写入前完成校验。
4. state/preview/save/rebase/formal compile 一致传入 cluster 配置;为 cluster 发布 scoped handles 和 affects。
5. 接通 useDirectEditSession、JunctionWorkspace 与现有参数/拖拽出口,服务端能力通过后才放开 canEditJunction。
## 影响文件
- `src/compile/native-road-edits.js`
- `src/compile/direct-edit-solver.js`
- `src/compile/complex-junction.js`
- `src/compile/native-road.js`
- `workbench/server.js`
- `workbench/client/src/hooks/useDirectEditSession.ts`
- `workbench/client/src/junction/JunctionWorkspace.tsx`
- `workbench/client/src/edit/session.ts`
## 兼容与失败行为
保留 node 路口现有文档与操作语义;新字段必须经过 validator、序列化、API 和客户端类型的完整往返。缺失或歧义来源显式只读/失效,不能通过数组下标修复引用。preview 不落盘,保存沿用版本冲突保护。
## 回滚
按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。