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,3 @@
{"file": ".trellis/spec/backend/direct-edit-api.md", "reason": "Solver, preview/save/rebase and persistence contracts."}
{"file": ".trellis/spec/frontend/direct-edit-client.md", "reason": "Shared gesture, session, preview and UI ownership contracts."}
{"file": ".trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md", "reason": "Verified source gaps and reusable implementation boundaries."}
@@ -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 不落盘,保存沿用版本冲突保护。
## 回滚
按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。
@@ -0,0 +1,3 @@
{"file": ".trellis/spec/backend/direct-edit-api.md", "reason": "Solver, preview/save/rebase and persistence contracts."}
{"file": ".trellis/spec/frontend/direct-edit-client.md", "reason": "Shared gesture, session, preview and UI ownership contracts."}
{"file": ".trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md", "reason": "Verified source gaps and reusable implementation boundaries."}
@@ -0,0 +1,31 @@
# 宽度编辑端到端闭环执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:01 验收通过。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 扩展 v2 anchor validator、联合类型、resolver 和 replay,cluster anchor 使用显式来源映射,不在 nodeId 中存 cluster ID。
- [ ] 建立 cluster effective plan,宽度由复杂生成器直接消费;多车行道臂保留分项宽度,批量设置使用一个可撤销命令。
- [ ] 抽取 preview/save 共用候选求值(同配置、同 solver、同 compiler diagnostics);任何候选写入前完成校验。
- [ ] state/preview/save/rebase/formal compile 一致传入 cluster 配置;为 cluster 发布 scoped handles 和 affects。
- [ ] 接通 useDirectEditSession、JunctionWorkspace 与现有参数/拖拽出口,服务端能力通过后才放开 canEditJunction。
## 验证
- `node test/native-road-edits.js`
- `node test/direct-edit-solver.js`
- `node test/workbench-edit-api.js`
- `npm run test:client`
- `npm run test:client:unit`
- `npm run build`
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
## 完成门槛
- [ ] PRD 每条验收关联具体测试或人工场景及结果。
- [ ] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
+28
View File
@@ -0,0 +1,28 @@
# 宽度编辑端到端闭环
## 目标
完成第一条可用的复杂路口宽度编辑链路,让用户能看到真实几何变化并保存保留。
## 前置
01 验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:支持选定外部车行道的有效宽度,提供 cluster 默认宽度及局部覆盖;明确影响车行道,不把分隔带算入宽度。
- R2:数字输入和地图拖拽具有一致的预览、撤销/重做、恢复继承行为。
- R3:保存后重编译与刷新保留结果;不能影响无关路口或内部连接约束。
- R4:开放入口前完成服务端越界/缺失对象/复杂几何错误拒绝,以及 documentVersion 冲突和最小拓扑失效保护。
## 验收
- [ ] A1:对一条外部车行道进行非零宽度修改,目标边界发生可测变化,无关臂保持一致。
- [ ] A2:默认值影响未覆盖对象,局部值不被默认值改写,恢复继承采用当前默认值。
- [ ] A3:同一手势或输入只产生一个撤销步骤,预览与保存重编译的几何一致。
- [ ] A4:伪造越界值、不存在的 cluster/object、仅几何编译可发现的错误均拒绝保存且文件与版本不变;旧版本返回 409。
- [ ] A5:刷新后值与几何保留,简单路口宽度编辑回归通过。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,35 @@
{
"id": "cj-02-width",
"name": "cj-02-width",
"title": "复杂路口 02:宽度编辑端到端闭环",
"description": "完成第一条可用的复杂路口宽度编辑链路,让用户能看到真实几何变化并保存保留。",
"status": "planning",
"dev_type": "fullstack",
"scope": "junction",
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-09-08",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": "09-08-complex-junction-editing",
"relatedFiles": [
"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"
],
"notes": "依赖:01 验收通过。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}