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,27 @@
# 权威结构与稳定对象标识设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 提取 complex-junction.js 中外部臂解析与形态分类所需的共用拓扑;geometry 与 projection 消费同一个结果。
2. 定义 JunctionRef、稳定 arm/carriageway/corner/facility key、source 映射与 topology fingerprint;标签编号与身份分离。
3. 修复 junction-structure normalizer 保留新增字段;projection 不再取首个 core 或按 road 数组凑角部。
4. 补齐 server selection 与客户端类型,保留旧 junction=node 请求;复杂参数能力暂为只读。
## 影响文件
- `src/compile/complex-junction.js`
- `src/compile/junction-projection.js`
- `src/compile/junction-structure.js`
- `workbench/server.js`
- `workbench/client/src/junction/hotspots.ts`
- `workbench/client/src/edit/types.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,27 @@
# 权威结构与稳定对象标识执行计划
## 启动门槛
- [x] 最终规划获实现确认,前置条件满足:无;完成后仍不开放参数写入。
- [x] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [x] 提取 complex-junction.js 中外部臂解析与形态分类所需的共用拓扑;geometry 与 projection 消费同一个结果。
- [x] 定义 JunctionRef、稳定 arm/carriageway/corner/facility key、source 映射与 topology fingerprint;标签编号与身份分离。
- [x] 修复 junction-structure normalizer 保留新增字段;projection 不再取首个 core 或按 road 数组凑角部。
- [x] 补齐 server selection 与客户端类型,保留旧 junction=node 请求;复杂参数能力暂为只读。
## 验证
- `node test/junction-structure.js`
- `node test/junction-projection.js`
- `npm run test:client`
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
## 完成门槛
- [x] PRD 每条验收关联具体测试或人工场景及结果。
- [x] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 权威结构与稳定对象标识
## 目标
让复杂路口的列表、地图、几何与后续编辑引用同一组对外道路臂、角部和设施。
## 前置
无;完成后仍不开放参数写入。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:显式区分 node 与 cluster,按指定路口返回结构,多个 cluster 互不串用。
- R2:排除内部连线,保留每个外部臂的车行道和来源;角部按几何相邻关系确定。
- R3:对象标识在成员/道路输入重排及无拓扑变化的重编译后保持稳定;歧义来源明确只读。
- R4:输出每类对象的编辑能力与不可编辑原因,为后续局部和默认参数准备契约。
## 验收
- [x] A1:包含两个 cluster 和一个简单路口的样本中,结构、地图 feature 和选择一一对应。
- [x] A2:倒序输入成员、道路和几何集合,语义对象 ID 不变;真正删除来源后不能沿用旧对象。
- [x] A3:3 臂、4 臂、偏置和多臂的数量与编译外部拓扑一致,内部连接不是可编辑道路臂。
- [x] A4:文档往返保留 provenance 和 capability;旧 node 结构与约束仍可读取。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,47 @@
{
"id": "cj-01-identity",
"name": "cj-01-identity",
"title": "复杂路口 01:权威结构与稳定对象标识",
"description": "让复杂路口的列表、地图、几何与后续编辑引用同一组对外道路臂、角部和设施。",
"status": "in_progress",
"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/complex-junction.js",
"src/compile/direct-edit-solver.js",
"src/compile/junction-projection.js",
"src/compile/junction-structure.js",
"src/compile/junction-topology.js",
"test/e2e-server.js",
"test/e2e/workbench.spec.ts",
"test/junction-projection.js",
"test/workbench-edit-api.js",
"workbench/client/src/App.tsx",
"workbench/client/src/components/MapCanvas.tsx",
"workbench/client/src/edit/types.ts",
"workbench/client/src/hooks/useDirectEditSession.ts",
"workbench/client/src/junction/JunctionWorkspace.tsx",
"workbench/client/src/junction/hotspots.ts",
"workbench/client/src/junction/local-state.ts",
"workbench/client/src/junction/structure.test.ts",
"workbench/client/src/junction/structure.ts",
"workbench/client/src/types/state.ts",
"workbench/server.js"
],
"notes": "第 1 阶段实现与验收完成;见 validation.md。复杂参数仍只读,第 2 阶段尚未启动。",
"meta": {}
}
@@ -0,0 +1,28 @@
# 第 1 阶段验收记录
日期:2026-09-08。范围:复杂路口权威只读结构、稳定身份、作用域与地图选择。参数编辑属于第 2 阶段,未开放。
## 结果映射
- A1:`test/junction-projection.js` 验证两份 cluster 编译结果不串用;`test/workbench-edit-api.js` 验证复杂与独立普通 node 的 scoped 结构;新增浏览器用真实候选开启复杂路口,验证列表→地图高亮与页面重载。
- A2:真实五臂样本重排 node/road 输入后,语义 ID、指纹和实际几何坐标一致;删除来源改变身份;重复来源显式只读。
- A3:合成 3/4/6 臂与 offset-cross 拓扑测试,以及真实五臂编译测试;内部连线不进入外部臂结构。偏置十字本阶段验证结构与分类,不宣称已完成真实偏置几何编辑验收。
- A4:新增 provenance/capability 的 JSON/normalizer 往返;旧 node 文档与编辑接口回归通过。信号通过明确成员节点关联并保留原始 UID,未改写信号存储。
## 验证命令
- `npm test`:通过,含 package、structure、projection、v2 document、revision、solver、API、import/compile 和 fixtures。首次因沙箱禁止本机端口失败,沙箱外重跑通过。
- `npm run test:client`:通过。
- `npm run test:client:unit`:15 文件、180 测试通过。
- `npm run build`:通过;已有超过 500 kB 的 bundle 提示仍存在。
- `npm run test:e2e`:11 测试通过,含新增复杂路口与既有简单路口回归。
- `npm run format:check`、`git diff --check`:通过。
- 复核修正信号投影、来源缺失诊断、provenance 校验、空结构过滤、浏览规范诊断汇总后,补跑 `test/junction-projection.js`、`test/junction-structure.js`、`test/workbench-edit-api.js`,全部通过。
## 实际设计与边界
编译器的 `resolveComplexJunctionTopology` 统一几何和结构身份。结构保存在 complex core/approach 的 `junction_structure`,API 投影从持久化结果读取;没有另建第二套客户端拓扑。新 metadata 不改变既有 v2 anchor。只读能力覆盖道路臂、角部、过街/停止线/岛/人行道转角及已有信号。
浏览状态 `junctionStructures` 只包含可用条目;没有复杂生成结果时不给出虚构结构,编辑 manifest 返回空。前端地图/列表用稳定 key 与明确 provenance 匹配,选择覆盖层只读且不重建地图。
下一步:09-08-cj-02-width,在这些稳定对象上实现宽度输入/拖拽、真正的复杂几何消费、预览/保存/重编译闭环。
@@ -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": {}
}
@@ -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,26 @@
# 收口与角部局部编辑设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 复用 02 cluster anchor 与优先级解析,增加 cutback/radius 值及对几何有效的范围。
2. 用相邻臂对定位角部,复杂生成器消费 per-corner/per-carriageway plan;不使用全局 coreRadius 冒充单角修改。
3. 更新核心边界、转角人行道和必要接缝;范围计算与最终几何校验分层。
4. 复用现有参数面板、手柄、reset 禁用约束和 EditSession 命令;补强影响对象诊断定位。
## 影响文件
- `src/compile/direct-edit-solver.js`
- `src/compile/complex-junction.js`
- `src/compile/native-road.js`
- `workbench/client/src/junction/JunctionWorkspace.tsx`
- `workbench/client/src/junction/local-state.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,29 @@
# 收口与角部局部编辑执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:02 验收通过。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 复用 02 cluster anchor 与优先级解析,增加 cutback/radius 值及对几何有效的范围。
- [ ] 用相邻臂对定位角部,复杂生成器消费 per-corner/per-carriageway plan;不使用全局 coreRadius 冒充单角修改。
- [ ] 更新核心边界、转角人行道和必要接缝;范围计算与最终几何校验分层。
- [ ] 复用现有参数面板、手柄、reset 禁用约束和 EditSession 命令;补强影响对象诊断定位。
## 验证
- `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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 收口与角部局部编辑
## 目标
让复杂路口可以逐进口调整收口、逐角部调整圆角,并与统一默认值可靠协作。
## 前置
02 验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:收口沿目标外部车行道中心线计距,圆角针对相邻外部臂围成的真实角部。
- R2:支持默认值、局部覆盖和恢复继承,清晰区分未修改、继承和显式修改。
- R3:拖拽与输入更新同一约束,边界由实际可用几何决定;不可实现的角部不发布有效控件。
- R4:过渡面、人行道与相邻边界随几何更新,无关角部不被统一改写。
## 验收
- [ ] A1:T 字、偏置十字和多臂样本单角修改正确,无角部串号。
- [ ] A2:收口变化沿道路方向可测,短臂的边界输入不能产生自交或断开的连接。
- [ ] A3:局部覆盖、改变统一值、恢复继承、撤销及刷新完整通过。
- [ ] A4:preview 与 save 的无效几何诊断一致,不能以自动退回普通路口表示编辑成功。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,32 @@
{
"id": "cj-03-geometry",
"name": "cj-03-geometry",
"title": "复杂路口 03:收口与角部局部编辑",
"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/direct-edit-solver.js",
"src/compile/complex-junction.js",
"src/compile/native-road.js",
"workbench/client/src/junction/JunctionWorkspace.tsx",
"workbench/client/src/junction/local-state.ts"
],
"notes": "依赖:02 验收通过。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}
@@ -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,29 @@
# 过街与控制设施编辑设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 从生成阶段输出设施语义 ID、cluster/arm/carriageway provenance 和 crossing-stop-line 关联。
2. 扩展/复用 junction-crossing anchor 与 solver,复杂生成器消费其值而非固定 cluster 比例常量。
3. 投影和 manifest 共享 scoped 设施索引,信号关联禁止 native ID 子串猜测。
4. 接通现有设施选择与编辑控制器;若信号使用不同存储域,沿用 App 保存协调并明确部分成功,不能伪装单文档原子事务。
5. 预览提供与正式编译一致的高级设施图层和诊断,不新增岛/分隔自由顶点编辑器。
## 影响文件
- `src/compile/complex-junction.js`
- `src/compile/junction-projection.js`
- `src/compile/direct-edit-solver.js`
- `workbench/server.js`
- `workbench/client/src/junction/facilities.ts`
- `workbench/client/src/junction/JunctionWorkspace.tsx`
- `workbench/client/src/App.tsx`
## 兼容与失败行为
保留 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 @@
# 过街与控制设施编辑执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:03 验收通过。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 从生成阶段输出设施语义 ID、cluster/arm/carriageway provenance 和 crossing-stop-line 关联。
- [ ] 扩展/复用 junction-crossing anchor 与 solver,复杂生成器消费其值而非固定 cluster 比例常量。
- [ ] 投影和 manifest 共享 scoped 设施索引,信号关联禁止 native ID 子串猜测。
- [ ] 接通现有设施选择与编辑控制器;若信号使用不同存储域,沿用 App 保存协调并明确部分成功,不能伪装单文档原子事务。
- [ ] 预览提供与正式编译一致的高级设施图层和诊断,不新增岛/分隔自由顶点编辑器。
## 验证
- `node test/junction-projection.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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 过街与控制设施编辑
## 目标
让复杂路口内斑马线、停止线和既有信号对象能准确选择并完成相关编辑。
## 前置
03 验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:斑马线按组编辑退距,停止线编辑相对该过街的偏移;双向车行道不能共用错误的来向对象。
- R2:复用现有信号编辑字段与持久化机制,结构列表选择可定位真实信号对象。
- R3:宽度、收口变化后设施保持正确关联和合法位置,独立设施修改不改变道路几何参数。
- R4:岛、中央分隔、人行道转角保持正确展示与联动;未实现的自由编辑能力明确只读。
## 验收
- [ ] A1:选中任意条纹对应同一组 crossing;修改退距不会误改邻近 crossing 或相反行车方向。
- [ ] A2:停止线关联、偏移方向和地理位置正确,越出路幅的候选被拒绝保存。
- [ ] A3:预览、撤销、保存、重编译和刷新设施值与位置一致。
- [ ] A4:已有信号字段可在复杂路口定位与保存;高级设施无虚假的可编辑状态。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,34 @@
{
"id": "cj-04-facilities",
"name": "cj-04-facilities",
"title": "复杂路口 04:过街与控制设施编辑",
"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/complex-junction.js",
"src/compile/junction-projection.js",
"src/compile/direct-edit-solver.js",
"workbench/server.js",
"workbench/client/src/junction/facilities.ts",
"workbench/client/src/junction/JunctionWorkspace.tsx",
"workbench/client/src/App.tsx"
],
"notes": "依赖:03 验收通过。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}
@@ -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,28 @@
# 拓扑变更与事务一致性设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
2. 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
3. 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
4. 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
## 影响文件
- `src/compile/direct-edit-solver.js`
- `workbench/server.js`
- `workbench/client/src/edit/session.ts`
- `workbench/client/src/edit/preview-request.ts`
- `workbench/client/src/hooks/useDirectEditSession.ts`
- `workbench/client/src/App.tsx`
- `workbench/client/src/junction/workspace.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,29 @@
# 拓扑变更与事务一致性执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:04 验收通过;本任务不替代 02 必需的保存安全门槛。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
- [ ] 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
- [ ] 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
- [ ] 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
## 验证
- `node test/workbench-edit-api.js`
- `node test/direct-edit-solver.js`
- `npm run test:client`
- `npm run test:client:unit`
- `npm run test:e2e`
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
## 完成门槛
- [ ] PRD 每条验收关联具体测试或人工场景及结果。
- [ ] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 拓扑变更与事务一致性
## 目标
使复杂路口编辑在成员调整、重编译、刷新和快速切换时保持可解释且不丢失用户修改。
## 前置
04 验收通过;本任务不替代 02 必需的保存安全门槛。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:成员重排不失效;成员增删、合并/拆分或来源消失后,编辑只能精确重放或明确报告失效/歧义。
- R2:有未保存编辑时调整成员或离开路口沿用应用/放弃/停留语义,不静默清空。
- R3:切换对象和路口时迟到预览不能覆盖新选择,手势取消、错误恢复和撤销历史正确。
- R4:版本冲突无写入;保存成功但编译失败时明确告知已保存,允许重试编译。
## 验收
- [ ] A1:删除被编辑来源后约束显示 stale/conflicted,不按最近距离或编号改绑;恢复拓扑可重新检查。
- [ ] A2:快速 A→B→A 切换并反序返回预览,画面只接受当前作用域的最新结果。
- [ ] A3:保存冲突、保存失败、保存后编译失败、刷新及重新导入分别有可恢复状态。
- [ ] A4:有其他路口约束的全局文档在局部编辑及放弃操作后仍完整保留。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,34 @@
{
"id": "cj-05-lifecycle",
"name": "cj-05-lifecycle",
"title": "复杂路口 05:拓扑变更与事务一致性",
"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/direct-edit-solver.js",
"workbench/server.js",
"workbench/client/src/edit/session.ts",
"workbench/client/src/edit/preview-request.ts",
"workbench/client/src/hooks/useDirectEditSession.ts",
"workbench/client/src/App.tsx",
"workbench/client/src/junction/workspace.ts"
],
"notes": "依赖:04 验收通过;本任务不替代 02 必需的保存安全门槛。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}
@@ -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,28 @@
# 形态矩阵与集成交付设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 建立 fixture 矩阵,优先复用现有复杂路口及 fengshu reference 样本;不足的拓扑补合成 OSM。
2. 在现有 test 及 Playwright 目录增加跨层场景,明确地理断言和保存文件不变断言。
3. 按父任务验收表逐条追踪到测试结果,人工检查地图重叠、手柄可达性、局部作用范围。
4. 运行最终质量门槛,更新 backend/frontend spec 的已实现契约;逐个完成提交与归档,最后复核父任务。
## 影响文件
- `test/direct-edit-solver.js`
- `test/junction-projection.js`
- `test/workbench-edit-api.js`
- `test/fixtures/fengshu-junction-reference.geojson`
- `workbench/client/src/junction/workspace.test.ts`
- `.trellis/spec/backend/direct-edit-api.md`
- `.trellis/spec/frontend/direct-edit-client.md`
## 兼容与失败行为
保留 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,30 @@
# 形态矩阵与集成交付执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:01–05 全部验收通过。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 建立 fixture 矩阵,优先复用现有复杂路口及 fengshu reference 样本;不足的拓扑补合成 OSM。
- [ ] 在现有 test 及 Playwright 目录增加跨层场景,明确地理断言和保存文件不变断言。
- [ ] 按父任务验收表逐条追踪到测试结果,人工检查地图重叠、手柄可达性、局部作用范围。
- [ ] 运行最终质量门槛,更新 backend/frontend spec 的已实现契约;逐个完成提交与归档,最后复核父任务。
## 验证
- `npm test`
- `npm run test:client`
- `npm run test:client:unit`
- `npm run build`
- `npm run test:e2e`
- `npm run format:check`
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
## 完成门槛
- [ ] PRD 每条验收关联具体测试或人工场景及结果。
- [ ] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 形态矩阵与集成交付
## 目标
证明复杂路口达到可实际操作的交付标准,记录真实样本效果和已知边界。
## 前置
01–05 全部验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:覆盖 T 字、十字、偏置十字、多臂、同节点布局不同形态、短臂、双向分离车行道及不支持形态。
- R2:各形态验证结构身份、参数变化、设施关联、保存与刷新;真实样本和合成样本互补。
- R3:检查简单路口回归、编辑关闭零副作用、参考层只读及地图实例稳定。
- R4:记录功能限制、验证命令、浏览器操作证据及性能结果,完成契约更新和任务交付。
## 验收
- [ ] A1:父任务 A1–A6 每项有明确测试或人工记录,不以快照存在或零约束恒等测试代替几何变化断言。
- [ ] A2:至少一个真实复杂路口完成宽度、收口、圆角、过街的连续操作与刷新演示。
- [ ] A3:后端、客户端类型、单元、构建、浏览器回归及格式检查通过;环境阻塞清楚标识。
- [ ] A4:预览时延和 degraded 行为有记录,过期响应不回退画面;不支持形态有明确原因。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,34 @@
{
"id": "cj-06-acceptance",
"name": "cj-06-acceptance",
"title": "复杂路口 06:形态矩阵与集成交付",
"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": [
"test/direct-edit-solver.js",
"test/junction-projection.js",
"test/workbench-edit-api.js",
"test/fixtures/fengshu-junction-reference.geojson",
"workbench/client/src/junction/workspace.test.ts",
".trellis/spec/backend/direct-edit-api.md",
".trellis/spec/frontend/direct-edit-client.md"
],
"notes": "依赖:01–05 全部验收通过。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}
@@ -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,32 @@
# 技术设计
## 架构
从复杂几何生成器提取共用的 cluster 外部拓扑解析,输出显式 JunctionRef、道路臂、组成车行道、相邻角部、设施及来源映射。正式编译、编辑 manifest 和结构投影消费同一份拓扑,前端只做显示与选择。
流程:cluster 配置 + baseline model → 外部拓扑 → v2 约束解析 → effective cluster plan → complex geometry → structure / manifest / diagnostics → EditSession。预览与保存复用候选求值;保存成功后沿用显式重新编译并刷新状态的流程。
## 对象与约束
- 引用使用 `{type: 'node'|'cluster', id}`。兼容既有 node 请求,新增显式 cluster 选择,禁止猜测无类型 ID;同时传多个选择应拒绝。
- Arm 身份来自 cluster ID 与稳定来源成员集合,不能来自数组下标、地图编号或浮点 heading;一臂可含多条有方向的车行道。车行道保留 node/segment/road 来源,目标宽度不包含中央分隔或人行道。
- Corner 身份由有序相邻臂对定义,来自环向几何排序;同一源拓扑下输入排序变化不改变 ID。拓扑指纹区分重排和真正成员变化。
- 设施采用语义对象标识;一组条纹对应一个 crossing 对象,停止线关联到对应来向 crossing,信号关联使用显式来源,不用字符串包含推断。
- 拟新增 cluster 专用 anchor(junctionRef + object kind/key + 必要车行道来源),扩展 v2 validator、客户端联合类型、replay 和 resolver。旧 node anchor 继续原样读取,不能复用 nodeId 字段塞入 cluster ID。
- 约束优先级:对象局部覆盖 > cluster 该参数默认值 > 编译基线。恢复继承禁用局部约束并记录操作;不删除仍被历史引用的约束。默认宽度作用于各外部车行道;道路臂批量操作明确列出组成车行道与影响范围,不把多个分离车行道的总宽当作单条路宽。
## 几何消费与校验
cluster effective plan 是复杂生成器的显式输入,不回写所有成员 node plan。宽度影响道路边界及必要连接;收口沿对应外部车行道中心线计距;角部圆角只作用于对应相邻边界。复杂核心、过街、人行道和连接面的联动由生成器统一生成。
候选求值先验证文档,再用相同 cluster 配置解析、编译并收集诊断。保存必须在任何候选写入之前拒绝 solver 或 compiled geometry error;warning 允许保存。不存在对象、越界、自交、过街越出可用路幅及断开的必要连接应给出对象级诊断,不能静默钳制输入或回退成看似成功的普通路口。
## 会话与兼容
App 继续负责跨域保存与重编译,组件不直接调 API。复用现有 EditSession、PreviewRequester 和手柄系统。请求带有作用域身份及序列校验,切换作用域放弃正在进行的手势并使旧响应失效;保持全局文档中其他对象的约束。地图实例不能因右栏或路口切换重建。
旧 node 文档几何保持一致。复杂编辑能力按参数发布,只有 anchor、求解、geometry、manifest、保存和 UI 都通过验收后才标记可编辑。高级设施没有实现的自由编辑能力保持只读。
## 风险与回滚
现有角度聚类和内部连线排除规则需要真实样本验证;歧义对象不开放编辑。几何校验会增加保存成本,应记录耗时及预览 degraded 状态。参考几何继续只读,不作为编辑真值。每个子任务独立提交;回滚先关闭对应能力入口,保留已保存约束的可读性及显式 unsupported 诊断,禁止静默丢弃文档。
@@ -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 @@
# 执行计划
## 开始前
- [ ] 向用户展示最终规划并取得本轮实现范围确认;随后逐个启动子任务,父任务仅统筹。
- [ ] 读取各子任务上下文及 trellis-before-dev;记录工作区状态,不覆盖已有改动。
- [ ] 使用 research/implementation-audit.md 作为现状索引;不要把历史测试结论当本轮结果。
## 顺序与闸门
1. 01 交付确定性结构与身份;未通过重排、多 cluster 隔离、内部连线排除测试,不启动宽度编辑。
2. 02 交付真实宽度变化和保存闭环;同阶段完成版本保护、编译诊断保存拒绝及最小失效保护,不能推迟到 05。
3. 03 交付收口和圆角,证明局部影响范围及统一值/覆盖/恢复继承。
4. 04 交付过街、停止线、既有信号编辑的选择与事务衔接。
5. 05 完成拓扑生命周期与异步竞态矩阵,不重复构建事务系统。
6. 06 做跨阶段形态矩阵及真实样本人工确认,记录结果后更新 spec、提交、归档。
## 验证命令
针对每个切片先运行相关脚本:`node test/junction-structure.js`、`node test/junction-projection.js`、`node test/direct-edit-solver.js`、`node test/native-road-edits.js`、`node test/workbench-edit-api.js`。
跨层切片运行 `npm run test:client`、`npm run test:client:unit` 和 `npm run build`。最终运行 `npm test`、`npm run test:e2e`、`npm run format:check`。只有新增改动、失败或未解决风险时重复已通过检查。环境失败与功能失败分开记录;需要端口或沙箱外能力时按环境权限处理,不把未运行检查报为通过。
## 交付证据
- [ ] 每个子任务 acceptance 关联具体测试/样本/浏览器步骤,记录命令和结果。
- [ ] 最终证明非空编辑改变目标几何,preview / save + compile 一致且 refresh 保留。
- [ ] 保存拒绝与 409 路径验证文件内容及版本未变化;预览验证文件内容和 mtime 未变化。
- [ ] 验证普通路口和编辑关闭状态;记录真实样本剩余限制。
- [ ] 更新 frontend/backend 契约,完成 Trellis 质量检查及任务归档,不能用文档完整代替实现完成。
@@ -0,0 +1,45 @@
# 复杂路口编辑能力闭环
## 目标
让用户在 JunctionTools 内像编辑简单路口一样,选择复杂路口的道路臂、角部和过街设施,通过数字输入或地图拖拽修改、预览、撤销、保存,重新编译和刷新后仍能看到相同结果。
## 已确认背景
昨天已完成候选与成员点选择、地图编号、外部形态识别、复杂几何生成、结构/设施展示与诊断。复杂路口仍是只读聚合视图,尚未接入完整编辑事务。现有 6 个子任务原为规划占位,本轮补齐正文。代码证据见 research/implementation-audit.md。
## 需求
- R1:按实际对外道路臂和相邻角部编辑;内部节点布局不能代替最终形态,地图和列表必须指向同一个对象。
- R2:支持对外车行道宽度、进口收口距离、角部圆角的局部修改、路口统一默认值和恢复继承;局部覆盖优先,设置统一默认值不能静默覆盖局部修改。
- R3:支持复杂路口过街退距及停止线偏移,选中一组斑马线时作为一个设施编辑;信号灯复用已有可编辑字段和保存机制,不扩大到新信号配时系统。
- R4:输入和拖拽共用预览、撤销/重做及保存链路;打开另一对象或路口时不能残留前一对象的预览。
- R5:保存后重编译和刷新结果一致;版本冲突、无效几何和失效对象必须明确提示,不能部分应用或静默改绑。
- R6:调整参与节点、重新导入或重编译时保留可追踪的编辑,失效和歧义编辑可定位、可复核,不能污染其他路口。
- R7:简单路口原有编辑能力、参考图层和普通地图使用不能回归;不支持的复杂形态明确只读及原因。
## 范围边界
本轮交付完整的上述编辑闭环,按子任务逐步开放。导流岛、中央分隔和人行道转角应正确展示和关联,可随几何联动;任意顶点编辑、新增/删除这些设施、道路拓扑绘制、新信号配时和自动套用参考几何不在本轮范围。
## 验收
- [ ] A1 / R1:十字、T 字、偏置十字、多臂的地图选择、结构列表和实际外部拓扑一致;成员/道路数组重排不改变对象身份。
- [ ] A2 / R2:单臂宽度、收口和单角圆角只影响目标及必要相邻连接;统一值、局部覆盖、恢复继承结果可解释。
- [ ] A3 / R3:过街及停止线编辑不误选相反行车方向或相邻设施;既有信号编辑可在复杂路口定位并保存。
- [ ] A4 / R4–R5:拖拽、输入、撤销、重做、保存、重编译、刷新都得到同一目标值与几何;无效候选保存不改写文件。
- [ ] A5 / R5–R6:旧版本返回 409;拓扑变更后原对象不可解析时显式失效,迟到预览不能覆盖新作用域。
- [ ] A6 / R7:简单路口回归通过;不支持形态没有无效手柄;编辑关闭时没有编辑图层和请求。
## 子任务与依赖
| 子任务 | 可验收交付 | 前置 |
| --- | --- | --- |
| 09-08-cj-01-identity | 权威外部结构、稳定标识、作用域与能力契约 | 无 |
| 09-08-cj-02-width | 宽度输入/拖拽到持久化的首个闭环,包含保存几何校验 | 01 |
| 09-08-cj-03-geometry | 收口、圆角及局部覆盖 | 02 |
| 09-08-cj-04-facilities | 过街、停止线及既有信号编辑衔接 | 03 |
| 09-08-cj-05-lifecycle | 成员变更、重放、切换与事务完整性 | 04;最低版本/失效保护已在 01、02 实现 |
| 09-08-cj-06-acceptance | 形态矩阵、浏览器和真实样本集成验收 | 01–05 |
第 1 阶段已完成只读结构、稳定身份、作用域和地图选择,并通过验收;其余阶段尚未启动,复杂参数编辑尚未开放。
@@ -0,0 +1,21 @@
# Implementation evidence (2026-09-08)
Baseline: `bba3ebe`, branch `feat/direct-edit-documents`. This is a source review; historical test results are not new verification results.
| Evidence | Current behavior | Required consequence |
| --- | --- | --- |
| `src/compile/direct-edit-solver.js:1159` | Cluster effective plans flatten member approaches and merge corner dictionaries; `readOnly: true` at line 1213. | Build authoritative external-arm/corner identities before permitting writes. Do not broadcast a node constraint across a cluster. |
| `src/compile/complex-junction.js:36` | Geometry discovers external approaches, groups carriageways by heading, and classifies shape. | Reuse/extract this topology for the editor and compiler; avoid a second frontend topology algorithm. |
| `src/compile/junction-projection.js:40` | Projection takes the first complex core and an endpoint-derived node, and makes corners from road array order. | Explicit junction scope, geometric adjacency, and deterministic identities are prerequisites. |
| `src/compile/junction-structure.js:32` | Normalization only retains declared arm fields. | Explicitly preserve provenance/capabilities; adding fields only to the projection input will lose them. |
| `workbench/server.js:323` | Selection parser supports segment and junction, without an explicit cluster branch. | Add unambiguous cluster selection while preserving existing node requests. |
| `workbench/server.js:334` | Edit-state solver context lacks cluster configuration; structure projection is not selection scoped. | State, preview, save, rebase and formal compile need the same cluster context. |
| `workbench/server.js:366` | Preview compiles geometry and returns compiled plus solver diagnostics. | Use the same candidate evaluation for save. |
| `workbench/server.js:436` | Save rejects solver errors but does not compile candidate geometry before persistence. | Reject compiled geometry errors before any candidate document write. |
| `workbench/client/src/junction/workspace.ts:49` | Only editable node descriptors pass canEditJunction. | Gate cluster editing on backend capability after the complete path exists. |
| `workbench/client/src/hooks/useDirectEditSession.ts:39` | Selection uses a node junction ID. | Carry explicit JunctionRef through request/response and session scoping. |
| `src/compile/complex-junction.js:94` | Complex core, crossing and stop-line placement use cluster geometry rules. | Node plan updates alone do not prove complex geometry consumption. |
Existing reusable assets: v2 document and EditSession, gesture history, numeric parameter input, handle/ghost/preview layers, version conflict protection, cluster membership UI, compiler shape classification and reference layer. Existing structure/facility display is not evidence that those objects are writable.
Research boundaries: no new editor engine; no automatic inference of shape from node count; no claim of full geometric validity based solely on unit tests. Runtime geometry and geographic fixtures must be checked in implementation.
@@ -0,0 +1,33 @@
{
"id": "complex-junction-editing",
"name": "complex-junction-editing",
"title": "复杂路口编辑能力闭环",
"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": [
"09-08-cj-01-identity",
"09-08-cj-02-width",
"09-08-cj-03-geometry",
"09-08-cj-04-facilities",
"09-08-cj-05-lifecycle",
"09-08-cj-06-acceptance"
],
"parent": null,
"relatedFiles": [],
"notes": "第 1 阶段已实现并验收:稳定结构/身份/作用域及地图选择;其余 5 个子任务保持 planning。",
"meta": {}
}