chore(task): archive complex junction identity stage

This commit is contained in:
que01 committed 2026-09-08 11:27:39 +08:00
1 parent 0a5a229ce3
commit 3a151e97c3
7 files changed
+5 -5

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 状态变化而实际几何不变的路径。
- [x] 按 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": "completed",
"dev_type": "fullstack",
"scope": "junction",
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-09-08",
"completedAt": "2026-09-08",
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": "0a5a229",
"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,在这些稳定对象上实现宽度输入/拖拽、真正的复杂几何消费、预览/保存/重编译闭环。