que01
93f09e399e
Planning: parent design.md becomes the single authoritative contract (constraint model with 6 kinds, handle manifest, coordinate/unit layering, preview sequencing, storage layout and lazy migration, area config snapshot, API contract). Work is split into four independently verifiable child tasks with per-step gates and rollback points. Test infra: pin vitest 4.1.11, add test:client:unit for client pure logic, extend prettier globs to root *.ts so vitest.config.ts is checked. Add .gitignore: the repo had none, so inputs/, outputs/, workbench-data/ and the client build output were untracked rather than ignored. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
42 lines
2.5 KiB
Markdown
42 lines
2.5 KiB
Markdown
# 最小 JunctionTools
|
||
|
||
父任务：`.trellis/tasks/08-26-direct-manipulation-road-editor`。需求来源与权威合约在父任务的 `prd.md` / `design.md`。
|
||
|
||
## 目标
|
||
|
||
用专用工作区承载路口编辑，验证单一普通路口的进口宽度、cutback 与单个角部圆角，闭合"预览 → 应用到工作区 → 保存 → 取消"四态。这是路口能力的最小可信切片，不是完整路口编辑器。
|
||
|
||
## 顺序依赖
|
||
|
||
前置：`direct-edit-solver-api`（junction 相关的三个 kind 求解与预览端点）与 `direct-edit-map-editor`（`EditSession`、ghost/preview 图层、命令栈）。
|
||
后继：无。cluster 高级编辑、多路口联动为独立后续任务。
|
||
|
||
## 范围
|
||
|
||
- 单 `JunctionRef`（`{type:'node'|'cluster', id}`，本期只走 `node`）的工作区路由与返回主地图的上下文保持。
|
||
- 加载该路口的编辑上下文：路口面、进口、相邻道路短上下文、车道/connector、步行带、停止线、斑马线、诊断与当前约束。
|
||
- 三项可拖能力：进口宽度、cutback、单个角部圆角。
|
||
- session draft：首次拖拽即 ghost，防抖后服务端权威局部预览。
|
||
- 「应用到工作区」合并有效草稿为活动副本的未保存约束；「保存」持久化；「取消」丢弃草稿并复原。
|
||
- 会话边界：切换相邻路口前必须应用或取消。
|
||
|
||
## 不做
|
||
|
||
- cluster 的高级编辑与复合路口模板编排。
|
||
- 多个路口的联合会话或联动编辑。
|
||
- 控制设施的逐个手工布置。
|
||
- 主地图道路区间的编辑（属 `direct-edit-map-editor`）。
|
||
- OSM 图拓扑的修改。
|
||
|
||
## 验收标准
|
||
|
||
- [ ] 从路口面或诊断可进入工作区，并能带位置返回主地图。
|
||
- [ ] 三项能力各自可拖，首次拖拽即有 ghost，防抖后显示服务端权威几何。
|
||
- [ ] 预览包含全部受影响派生对象：道路面、路口面、步行带、车道中心线、connector/movement、停止线、斑马线、标线。
|
||
- [ ] 拟合失败时返回最后有效几何加结构化诊断，不把非法图形显示成已应用。
|
||
- [ ] 「应用到工作区」后返回主地图仍显示同一几何，且该编辑处于未保存状态、可被主地图 undo/redo 管理。
|
||
- [ ] 「取消」后回到进入工作区前的状态，活动副本无残留。
|
||
- [ ] 未处理草稿时切换相邻路口被拒绝，并提示先应用或取消。
|
||
- [ ] 「保存」后重新编译几何不变，约束状态 `exact`。
|
||
- [ ] `npm run format:check`、`npm run test`、`npm run test:client`、`npm run test:client:unit`、`npm run build` 全绿。
|