chore(task): archive completed road editor workflows

This commit is contained in:
que01 committed 2026-09-07 14:21:57 +08:00
1 parent 39e338668b
commit d61c86ed2c
26 files changed
+6 -6

No files matched your search

@@ -0,0 +1,3 @@
{"file":".trellis/spec/backend/direct-edit-api.md","reason":"质量检查需覆盖 preview/save 的版本保护、原子写入及编译状态一致性。"}
{"file":".trellis/spec/frontend/direct-edit-client.md","reason":"质量检查需确认 preview layer、baseline 和普通路口编辑行为不回归。"}
{"file":".trellis/spec/guides/cross-layer-thinking-guide.md","reason":"质量检查需验证候选配置从 API 到编译和 UI 的完整往返。"}
@@ -0,0 +1,26 @@
# 技术设计
## 边界
- 编译层复用 `src/compile/complex-junction.js` 与 `src/compile/native-road.js` 的既有 cluster 几何生成逻辑,不复制几何算法。
- 服务层负责读取候选、生成目标 cluster 配置、预览编译和持久化;保存遵守现有 revision/document 版本保护与原子写入约束。
- 前端只在 JunctionTools 独立页面消费候选和 cluster 状态,复用现有地图图层工厂与预览层,不污染普通路口 baseline。
## 数据流
1. `/api/edit-state` 或现有诊断数据提供候选 cluster 标识、节点集合、道路摘要、建议核心半径及当前启用状态。
2. 独立页面展示状态;用户点击启用后创建内存 draft,不立即写文件。
3. 预览请求携带 draft cluster 配置,服务端在临时编译上下文中生成局部复杂路口图层并返回 preview 序列号。
4. 放弃丢弃 draft 并恢复 baseline;保存经版本校验后原子写入 `nativeRoad.junctionTemplates.clusters`,随后触发正式编译。
5. 刷新重新从 edit-state/编译状态读取持久化配置。
## 兼容性与回滚
- 没有启用配置时保持现有普通路口输出字节和交互不变。
- 保存失败或版本冲突不改变活动配置;预览失败只清除预览并保留 draft 可重试。
- 不把候选诊断直接转换为启用配置,避免大范围几何变化。
## 取舍
- 首版只提供独立页面入口,避免主地图状态同步和误操作复杂度。
- 首版复杂参数只读,先验证渲染质量;后续再以独立约束模型开放编辑。
@@ -0,0 +1,4 @@
{"file":".trellis/spec/backend/direct-edit-api.md","reason":"复用现有预览、版本校验、原子保存和编译后状态契约。"}
{"file":".trellis/spec/frontend/direct-edit-client.md","reason":"保证复杂路口预览不覆盖 baseline,并沿用 JunctionTools 的状态与预览边界。"}
{"file":".trellis/spec/guides/cross-layer-thinking-guide.md","reason":"该功能跨编译、服务和前端,需要按数据流和契约检查。"}
{"file":".trellis/spec/guides/code-reuse-thinking-guide.md","reason":"候选状态、预览图层和保存逻辑必须复用现有实现,避免第二套契约。"}
@@ -0,0 +1,16 @@
# 执行清单
1. 梳理现有候选诊断、cluster 配置读取、编辑保存和编译入口,确定最小 API 接口。
2. 后端增加候选 cluster 状态投影及 preview/save 所需的专用数据契约,复用现有版本校验和原子保存。
3. 前端在独立 JunctionTools 页面增加普通/复杂状态区、启用、预览、放弃、保存和只读提示。
4. 接入局部复杂路口图层预览,确保 baseline 图层不被覆盖,且只影响目标 cluster。
5. 为候选样本补充后端单测、HTTP 集成测试和前端/E2E 状态流测试。
6. 运行类型检查、构建、相关测试和完整质量检查;修复回归后再提交。
验证命令:
- `python3 ./.trellis/scripts/task.py validate 09-04-complex-junction-toggle`
- `npm run test`
- `npm run build`
回滚点:API 契约、cluster 配置写入、JunctionTools 状态区和 preview 图层分别可独立回退;不得回退用户已有的普通路口编辑修复。
@@ -0,0 +1,44 @@
# 复杂路口手动切换与独立浏览
## Goal
让用户可以针对 `枫树二路.osm` 中的复杂路口候选,在独立 JunctionTools 页面中将该候选从普通路口渲染切换为 `complex-junction-v1`,通过局部预览确认效果,并可放弃或保存。首版解决复杂路口当前普通渲染难看的问题,同时保留普通路口既有编辑能力。
## Background and Confirmed Facts
- `/Users/que01/Desktop/枫树二路.osm` 当前编译会产生多组 `complex-junction-candidate` 诊断。
- 首个验证候选为节点 `8005332807、8024512135、8024512145、8024512147、8613058676`,节点直径约 41.2m,建议核心半径约 32m,关联道路为硃山湖大道、枫树二路。
- 复杂路口几何由 `src/compile/complex-junction.js` 生成;只有 `nativeRoad.junctionTemplates.enabled=true` 且存在对应 cluster 配置时才会启用。
- `cluster` 当前在 `src/compile/direct-edit-solver.js` 与 JunctionTools 中为只读,不能通过解除前端限制直接编辑。
- 候选检测是 advisory,只产生 `complex-junction-candidate` 诊断,不会自动改变几何。
## In Scope
1. 候选复杂路口可进入独立 JunctionTools 页面。
2. 页面显示当前渲染模式:普通路口或复杂路口;普通模式提供“启用复杂路口渲染”入口。
3. 切换使用候选诊断提供的 cluster 节点和建议核心半径,并只影响该 cluster。
4. 切换后提供局部复杂路口几何预览,支持放弃、保存;保存后重新编译,刷新仍保持状态。
5. 复杂路口页面保持只读参数状态,并明确提示首版暂不支持复杂路口几何拖拽编辑。
6. 切换入口只放在独立页面状态区,不在主地图候选标记上提供快捷切换。
## Out of Scope
- 不根据候选自动启用或静默切换。
- 不开放复杂路口核心半径、进口宽度、收口距离、圆角等拖拽编辑。
- 不修改 OSM 拓扑,不创建或删除道路、信号灯、斑马线、停止线等设施。
- 不跨多个 cluster 联合编辑。
- 不改变普通路口现有 JunctionTools 行为。
## Acceptance Criteria
- [ ] 从 `枫树二路.osm` 的目标候选可进入独立 JunctionTools 页面。
- [ ] 页面明确显示“当前按普通路口渲染”,并提供“启用复杂路口渲染”。
- [ ] 预览只改变目标 cluster 的局部几何,其他路口保持不变。
- [ ] 放弃后恢复普通路口渲染;保存并刷新后仍显示复杂路口渲染。
- [ ] 复杂路口页面不显示可编辑普通 node 控件,未实现的参数编辑明确为只读。
- [ ] 普通路口既有测试、复杂路口相关测试、类型检查和构建通过。
## Risks and Deferred Decisions
- 复杂 cluster 配置写入现有 `nativeRoad.junctionTemplates.clusters` 语义;若现有保存 API 不能原子更新该配置,需要在 API 层增加最小专用操作,不能从前端直接写派生 GeoJSON。
- 自动识别和自动切换留待首版验证后另行商议。
@@ -0,0 +1,26 @@
{
"id": "complex-junction-toggle",
"name": "complex-junction-toggle",
"title": "复杂路口手动切换与独立浏览",
"description": "",
"status": "completed",
"dev_type": null,
"scope": null,
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-09-04",
"completedAt": "2026-09-07",
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [],
"notes": "",
"meta": {}
}