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,28 @@
|
||||
# 拓扑变更与事务一致性设计
|
||||
|
||||
## 边界与数据流
|
||||
|
||||
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
|
||||
|
||||
1. 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
|
||||
2. 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
|
||||
3. 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
|
||||
4. 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
|
||||
|
||||
## 影响文件
|
||||
|
||||
- `src/compile/direct-edit-solver.js`
|
||||
- `workbench/server.js`
|
||||
- `workbench/client/src/edit/session.ts`
|
||||
- `workbench/client/src/edit/preview-request.ts`
|
||||
- `workbench/client/src/hooks/useDirectEditSession.ts`
|
||||
- `workbench/client/src/App.tsx`
|
||||
- `workbench/client/src/junction/workspace.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 @@
|
||||
# 拓扑变更与事务一致性执行计划
|
||||
|
||||
## 启动门槛
|
||||
|
||||
- [ ] 最终规划获实现确认,前置条件满足:04 验收通过;本任务不替代 02 必需的保存安全门槛。
|
||||
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
|
||||
|
||||
## 顺序
|
||||
|
||||
- [ ] 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
|
||||
- [ ] 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
|
||||
- [ ] 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
|
||||
- [ ] 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
|
||||
|
||||
## 验证
|
||||
|
||||
- `node test/workbench-edit-api.js`
|
||||
- `node test/direct-edit-solver.js`
|
||||
- `npm run test:client`
|
||||
- `npm run test:client:unit`
|
||||
- `npm run test:e2e`
|
||||
|
||||
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
|
||||
|
||||
## 完成门槛
|
||||
|
||||
- [ ] PRD 每条验收关联具体测试或人工场景及结果。
|
||||
- [ ] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
|
||||
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
|
||||
@@ -0,0 +1,27 @@
|
||||
# 拓扑变更与事务一致性
|
||||
|
||||
## 目标
|
||||
|
||||
使复杂路口编辑在成员调整、重编译、刷新和快速切换时保持可解释且不丢失用户修改。
|
||||
|
||||
## 前置
|
||||
|
||||
04 验收通过;本任务不替代 02 必需的保存安全门槛。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
|
||||
|
||||
## 需求
|
||||
|
||||
- R1:成员重排不失效;成员增删、合并/拆分或来源消失后,编辑只能精确重放或明确报告失效/歧义。
|
||||
- R2:有未保存编辑时调整成员或离开路口沿用应用/放弃/停留语义,不静默清空。
|
||||
- R3:切换对象和路口时迟到预览不能覆盖新选择,手势取消、错误恢复和撤销历史正确。
|
||||
- R4:版本冲突无写入;保存成功但编译失败时明确告知已保存,允许重试编译。
|
||||
|
||||
## 验收
|
||||
|
||||
- [ ] A1:删除被编辑来源后约束显示 stale/conflicted,不按最近距离或编号改绑;恢复拓扑可重新检查。
|
||||
- [ ] A2:快速 A→B→A 切换并反序返回预览,画面只接受当前作用域的最新结果。
|
||||
- [ ] A3:保存冲突、保存失败、保存后编译失败、刷新及重新导入分别有可恢复状态。
|
||||
- [ ] A4:有其他路口约束的全局文档在局部编辑及放弃操作后仍完整保留。
|
||||
|
||||
## 范围边界
|
||||
|
||||
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
|
||||
@@ -0,0 +1,34 @@
|
||||
{
|
||||
"id": "cj-05-lifecycle",
|
||||
"name": "cj-05-lifecycle",
|
||||
"title": "复杂路口 05:拓扑变更与事务一致性",
|
||||
"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",
|
||||
"workbench/server.js",
|
||||
"workbench/client/src/edit/session.ts",
|
||||
"workbench/client/src/edit/preview-request.ts",
|
||||
"workbench/client/src/hooks/useDirectEditSession.ts",
|
||||
"workbench/client/src/App.tsx",
|
||||
"workbench/client/src/junction/workspace.ts"
|
||||
],
|
||||
"notes": "依赖:04 验收通过;本任务不替代 02 必需的保存安全门槛。规划已补齐,等待最终评审后启动;不表示实现已完成。",
|
||||
"meta": {}
|
||||
}
|
||||
Reference in new issue
Block a user