Files
road-compiler/.trellis/tasks/09-08-cj-02-width/design.md
T

31 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 宽度编辑端到端闭环设计
## 边界与数据流
遵守父设计 ../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 不落盘,保存沿用版本冲突保护。
## 回滚
按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。