chore(task): archive complex junction facilities stage

This commit is contained in:
que01 committed 2026-09-08 15:08:45 +08:00
1 parent 49a44fdf73
commit 89f4ce79b0
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,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": "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": [
"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": {}
}