From bd8b55e58b272b21b0c6ae99c9aac05b7eae4660 Mon Sep 17 00:00:00 2001 From: que01 Date: Tue, 8 Sep 2026 11:25:05 +0800 Subject: [PATCH] docs(task): record complex junction editing roadmap --- .../tasks/09-08-cj-01-identity/check.jsonl | 3 ++ .trellis/tasks/09-08-cj-01-identity/design.md | 27 +++++++++++ .../09-08-cj-01-identity/implement.jsonl | 3 ++ .../tasks/09-08-cj-01-identity/implement.md | 27 +++++++++++ .trellis/tasks/09-08-cj-01-identity/prd.md | 27 +++++++++++ .trellis/tasks/09-08-cj-01-identity/task.json | 47 +++++++++++++++++++ .../tasks/09-08-cj-01-identity/validation.md | 28 +++++++++++ .trellis/tasks/09-08-cj-02-width/check.jsonl | 3 ++ .trellis/tasks/09-08-cj-02-width/design.md | 30 ++++++++++++ .../tasks/09-08-cj-02-width/implement.jsonl | 3 ++ .trellis/tasks/09-08-cj-02-width/implement.md | 31 ++++++++++++ .trellis/tasks/09-08-cj-02-width/prd.md | 28 +++++++++++ .trellis/tasks/09-08-cj-02-width/task.json | 35 ++++++++++++++ .../tasks/09-08-cj-03-geometry/check.jsonl | 3 ++ .trellis/tasks/09-08-cj-03-geometry/design.md | 26 ++++++++++ .../09-08-cj-03-geometry/implement.jsonl | 3 ++ .../tasks/09-08-cj-03-geometry/implement.md | 29 ++++++++++++ .trellis/tasks/09-08-cj-03-geometry/prd.md | 27 +++++++++++ .trellis/tasks/09-08-cj-03-geometry/task.json | 32 +++++++++++++ .../tasks/09-08-cj-04-facilities/check.jsonl | 3 ++ .../tasks/09-08-cj-04-facilities/design.md | 29 ++++++++++++ .../09-08-cj-04-facilities/implement.jsonl | 3 ++ .../tasks/09-08-cj-04-facilities/implement.md | 31 ++++++++++++ .trellis/tasks/09-08-cj-04-facilities/prd.md | 27 +++++++++++ .../tasks/09-08-cj-04-facilities/task.json | 34 ++++++++++++++ .../tasks/09-08-cj-05-lifecycle/check.jsonl | 3 ++ .../tasks/09-08-cj-05-lifecycle/design.md | 28 +++++++++++ .../09-08-cj-05-lifecycle/implement.jsonl | 3 ++ .../tasks/09-08-cj-05-lifecycle/implement.md | 29 ++++++++++++ .trellis/tasks/09-08-cj-05-lifecycle/prd.md | 27 +++++++++++ .../tasks/09-08-cj-05-lifecycle/task.json | 34 ++++++++++++++ .../tasks/09-08-cj-06-acceptance/check.jsonl | 3 ++ .../tasks/09-08-cj-06-acceptance/design.md | 28 +++++++++++ .../09-08-cj-06-acceptance/implement.jsonl | 3 ++ .../tasks/09-08-cj-06-acceptance/implement.md | 30 ++++++++++++ .trellis/tasks/09-08-cj-06-acceptance/prd.md | 27 +++++++++++ .../tasks/09-08-cj-06-acceptance/task.json | 34 ++++++++++++++ .../check.jsonl | 3 ++ .../09-08-complex-junction-editing/design.md | 32 +++++++++++++ .../implement.jsonl | 3 ++ .../implement.md | 30 ++++++++++++ .../09-08-complex-junction-editing/prd.md | 45 ++++++++++++++++++ .../research/implementation-audit.md | 21 +++++++++ .../09-08-complex-junction-editing/task.json | 33 +++++++++++++ 44 files changed, 955 insertions(+) create mode 100644 .trellis/tasks/09-08-cj-01-identity/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-01-identity/design.md create mode 100644 .trellis/tasks/09-08-cj-01-identity/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-01-identity/implement.md create mode 100644 .trellis/tasks/09-08-cj-01-identity/prd.md create mode 100644 .trellis/tasks/09-08-cj-01-identity/task.json create mode 100644 .trellis/tasks/09-08-cj-01-identity/validation.md create mode 100644 .trellis/tasks/09-08-cj-02-width/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-02-width/design.md create mode 100644 .trellis/tasks/09-08-cj-02-width/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-02-width/implement.md create mode 100644 .trellis/tasks/09-08-cj-02-width/prd.md create mode 100644 .trellis/tasks/09-08-cj-02-width/task.json create mode 100644 .trellis/tasks/09-08-cj-03-geometry/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-03-geometry/design.md create mode 100644 .trellis/tasks/09-08-cj-03-geometry/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-03-geometry/implement.md create mode 100644 .trellis/tasks/09-08-cj-03-geometry/prd.md create mode 100644 .trellis/tasks/09-08-cj-03-geometry/task.json create mode 100644 .trellis/tasks/09-08-cj-04-facilities/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-04-facilities/design.md create mode 100644 .trellis/tasks/09-08-cj-04-facilities/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-04-facilities/implement.md create mode 100644 .trellis/tasks/09-08-cj-04-facilities/prd.md create mode 100644 .trellis/tasks/09-08-cj-04-facilities/task.json create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/design.md create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/implement.md create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/prd.md create mode 100644 .trellis/tasks/09-08-cj-05-lifecycle/task.json create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/check.jsonl create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/design.md create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/implement.jsonl create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/implement.md create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/prd.md create mode 100644 .trellis/tasks/09-08-cj-06-acceptance/task.json create mode 100644 .trellis/tasks/09-08-complex-junction-editing/check.jsonl create mode 100644 .trellis/tasks/09-08-complex-junction-editing/design.md create mode 100644 .trellis/tasks/09-08-complex-junction-editing/implement.jsonl create mode 100644 .trellis/tasks/09-08-complex-junction-editing/implement.md create mode 100644 .trellis/tasks/09-08-complex-junction-editing/prd.md create mode 100644 .trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md create mode 100644 .trellis/tasks/09-08-complex-junction-editing/task.json diff --git a/.trellis/tasks/09-08-cj-01-identity/check.jsonl b/.trellis/tasks/09-08-cj-01-identity/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-01-identity/design.md b/.trellis/tasks/09-08-cj-01-identity/design.md new file mode 100644 index 0000000..f2fe58c --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-01-identity/implement.jsonl b/.trellis/tasks/09-08-cj-01-identity/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-01-identity/implement.md b/.trellis/tasks/09-08-cj-01-identity/implement.md new file mode 100644 index 0000000..385bb18 --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-01-identity/prd.md b/.trellis/tasks/09-08-cj-01-identity/prd.md new file mode 100644 index 0000000..a813b5f --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/prd.md @@ -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 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-01-identity/task.json b/.trellis/tasks/09-08-cj-01-identity/task.json new file mode 100644 index 0000000..717e6c3 --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-cj-01-identity/validation.md b/.trellis/tasks/09-08-cj-01-identity/validation.md new file mode 100644 index 0000000..bef0c17 --- /dev/null +++ b/.trellis/tasks/09-08-cj-01-identity/validation.md @@ -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,在这些稳定对象上实现宽度输入/拖拽、真正的复杂几何消费、预览/保存/重编译闭环。 diff --git a/.trellis/tasks/09-08-cj-02-width/check.jsonl b/.trellis/tasks/09-08-cj-02-width/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-02-width/design.md b/.trellis/tasks/09-08-cj-02-width/design.md new file mode 100644 index 0000000..1d3008a --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-02-width/implement.jsonl b/.trellis/tasks/09-08-cj-02-width/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-02-width/implement.md b/.trellis/tasks/09-08-cj-02-width/implement.md new file mode 100644 index 0000000..2f65acb --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-02-width/prd.md b/.trellis/tasks/09-08-cj-02-width/prd.md new file mode 100644 index 0000000..2fc0bb4 --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/prd.md @@ -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 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-02-width/task.json b/.trellis/tasks/09-08-cj-02-width/task.json new file mode 100644 index 0000000..60923b1 --- /dev/null +++ b/.trellis/tasks/09-08-cj-02-width/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-cj-03-geometry/check.jsonl b/.trellis/tasks/09-08-cj-03-geometry/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-03-geometry/design.md b/.trellis/tasks/09-08-cj-03-geometry/design.md new file mode 100644 index 0000000..7660a66 --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-03-geometry/implement.jsonl b/.trellis/tasks/09-08-cj-03-geometry/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-03-geometry/implement.md b/.trellis/tasks/09-08-cj-03-geometry/implement.md new file mode 100644 index 0000000..1765b8c --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-03-geometry/prd.md b/.trellis/tasks/09-08-cj-03-geometry/prd.md new file mode 100644 index 0000000..9af08e6 --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/prd.md @@ -0,0 +1,27 @@ +# 收口与角部局部编辑 + +## 目标 + +让复杂路口可以逐进口调整收口、逐角部调整圆角,并与统一默认值可靠协作。 + +## 前置 + +02 验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。 + +## 需求 + +- R1:收口沿目标外部车行道中心线计距,圆角针对相邻外部臂围成的真实角部。 +- R2:支持默认值、局部覆盖和恢复继承,清晰区分未修改、继承和显式修改。 +- R3:拖拽与输入更新同一约束,边界由实际可用几何决定;不可实现的角部不发布有效控件。 +- R4:过渡面、人行道与相邻边界随几何更新,无关角部不被统一改写。 + +## 验收 + +- [ ] A1:T 字、偏置十字和多臂样本单角修改正确,无角部串号。 +- [ ] A2:收口变化沿道路方向可测,短臂的边界输入不能产生自交或断开的连接。 +- [ ] A3:局部覆盖、改变统一值、恢复继承、撤销及刷新完整通过。 +- [ ] A4:preview 与 save 的无效几何诊断一致,不能以自动退回普通路口表示编辑成功。 + +## 范围边界 + +只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-03-geometry/task.json b/.trellis/tasks/09-08-cj-03-geometry/task.json new file mode 100644 index 0000000..ca423c7 --- /dev/null +++ b/.trellis/tasks/09-08-cj-03-geometry/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-cj-04-facilities/check.jsonl b/.trellis/tasks/09-08-cj-04-facilities/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-04-facilities/design.md b/.trellis/tasks/09-08-cj-04-facilities/design.md new file mode 100644 index 0000000..e463574 --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-04-facilities/implement.jsonl b/.trellis/tasks/09-08-cj-04-facilities/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-04-facilities/implement.md b/.trellis/tasks/09-08-cj-04-facilities/implement.md new file mode 100644 index 0000000..ec1d954 --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-04-facilities/prd.md b/.trellis/tasks/09-08-cj-04-facilities/prd.md new file mode 100644 index 0000000..c026de4 --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/prd.md @@ -0,0 +1,27 @@ +# 过街与控制设施编辑 + +## 目标 + +让复杂路口内斑马线、停止线和既有信号对象能准确选择并完成相关编辑。 + +## 前置 + +03 验收通过。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。 + +## 需求 + +- R1:斑马线按组编辑退距,停止线编辑相对该过街的偏移;双向车行道不能共用错误的来向对象。 +- R2:复用现有信号编辑字段与持久化机制,结构列表选择可定位真实信号对象。 +- R3:宽度、收口变化后设施保持正确关联和合法位置,独立设施修改不改变道路几何参数。 +- R4:岛、中央分隔、人行道转角保持正确展示与联动;未实现的自由编辑能力明确只读。 + +## 验收 + +- [ ] A1:选中任意条纹对应同一组 crossing;修改退距不会误改邻近 crossing 或相反行车方向。 +- [ ] A2:停止线关联、偏移方向和地理位置正确,越出路幅的候选被拒绝保存。 +- [ ] A3:预览、撤销、保存、重编译和刷新设施值与位置一致。 +- [ ] A4:已有信号字段可在复杂路口定位与保存;高级设施无虚假的可编辑状态。 + +## 范围边界 + +只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-04-facilities/task.json b/.trellis/tasks/09-08-cj-04-facilities/task.json new file mode 100644 index 0000000..d766364 --- /dev/null +++ b/.trellis/tasks/09-08-cj-04-facilities/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/check.jsonl b/.trellis/tasks/09-08-cj-05-lifecycle/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/design.md b/.trellis/tasks/09-08-cj-05-lifecycle/design.md new file mode 100644 index 0000000..70bec87 --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/implement.jsonl b/.trellis/tasks/09-08-cj-05-lifecycle/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/implement.md b/.trellis/tasks/09-08-cj-05-lifecycle/implement.md new file mode 100644 index 0000000..c581fe2 --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/prd.md b/.trellis/tasks/09-08-cj-05-lifecycle/prd.md new file mode 100644 index 0000000..827222c --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/prd.md @@ -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 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-05-lifecycle/task.json b/.trellis/tasks/09-08-cj-05-lifecycle/task.json new file mode 100644 index 0000000..f836cc9 --- /dev/null +++ b/.trellis/tasks/09-08-cj-05-lifecycle/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-cj-06-acceptance/check.jsonl b/.trellis/tasks/09-08-cj-06-acceptance/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-06-acceptance/design.md b/.trellis/tasks/09-08-cj-06-acceptance/design.md new file mode 100644 index 0000000..c37d02e --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/design.md @@ -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 不落盘,保存沿用版本冲突保护。 + +## 回滚 + +按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。 diff --git a/.trellis/tasks/09-08-cj-06-acceptance/implement.jsonl b/.trellis/tasks/09-08-cj-06-acceptance/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-cj-06-acceptance/implement.md b/.trellis/tasks/09-08-cj-06-acceptance/implement.md new file mode 100644 index 0000000..999134f --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/implement.md @@ -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 完成质量检查,更新已实现契约并保存提交/验证记录后归档。 diff --git a/.trellis/tasks/09-08-cj-06-acceptance/prd.md b/.trellis/tasks/09-08-cj-06-acceptance/prd.md new file mode 100644 index 0000000..b2a407f --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/prd.md @@ -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 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。 diff --git a/.trellis/tasks/09-08-cj-06-acceptance/task.json b/.trellis/tasks/09-08-cj-06-acceptance/task.json new file mode 100644 index 0000000..ecdd8f5 --- /dev/null +++ b/.trellis/tasks/09-08-cj-06-acceptance/task.json @@ -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": {} +} diff --git a/.trellis/tasks/09-08-complex-junction-editing/check.jsonl b/.trellis/tasks/09-08-complex-junction-editing/check.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/check.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-complex-junction-editing/design.md b/.trellis/tasks/09-08-complex-junction-editing/design.md new file mode 100644 index 0000000..b6e9ac0 --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/design.md @@ -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 诊断,禁止静默丢弃文档。 diff --git a/.trellis/tasks/09-08-complex-junction-editing/implement.jsonl b/.trellis/tasks/09-08-complex-junction-editing/implement.jsonl new file mode 100644 index 0000000..b756afa --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/implement.jsonl @@ -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."} diff --git a/.trellis/tasks/09-08-complex-junction-editing/implement.md b/.trellis/tasks/09-08-complex-junction-editing/implement.md new file mode 100644 index 0000000..a25d5ea --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/implement.md @@ -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 质量检查及任务归档,不能用文档完整代替实现完成。 diff --git a/.trellis/tasks/09-08-complex-junction-editing/prd.md b/.trellis/tasks/09-08-complex-junction-editing/prd.md new file mode 100644 index 0000000..bd3a52f --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/prd.md @@ -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 阶段已完成只读结构、稳定身份、作用域和地图选择,并通过验收;其余阶段尚未启动,复杂参数编辑尚未开放。 diff --git a/.trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md b/.trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md new file mode 100644 index 0000000..f5a3f77 --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md @@ -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. diff --git a/.trellis/tasks/09-08-complex-junction-editing/task.json b/.trellis/tasks/09-08-complex-junction-editing/task.json new file mode 100644 index 0000000..c13b653 --- /dev/null +++ b/.trellis/tasks/09-08-complex-junction-editing/task.json @@ -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": {} +}