chore(task): archive complex junction acceptance stage

This commit is contained in:
que01 committed 2026-09-08 15:55:56 +08:00
1 parent 6896f8a554
commit 880ca8da91
6 files changed
+3 -3

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,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": "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": 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": {}
}