docs(task): record complex junction editing roadmap
This commit is contained in:
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,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": {}
|
||||
}
|
||||
Reference in new issue
Block a user