docs: add backend rewrite governance and route index
This commit is contained in:
@@ -4,33 +4,39 @@
|
||||
|
||||
### Contract 与前端兼容
|
||||
|
||||
- [ ] 梳理当前 `packages/shared/src/contracts/*` 到 Rust DTO 的映射
|
||||
- [ ] 设计 Rust 侧 contract 生成或手写策略
|
||||
- [ ] 保持当前字段名、枚举值、响应结构稳定
|
||||
- [ ] 为 breaking change 建立显式变更流程
|
||||
- [x] 梳理当前 `packages/shared/src/contracts/*` 到 Rust DTO 的映射
|
||||
- [x] 设计 Rust 侧 contract 生成或手写策略
|
||||
- [x] 保持当前字段名、枚举值、响应结构稳定
|
||||
- [x] 为 breaking change 建立显式变更流程
|
||||
|
||||
### SpacetimeDB schema 演进治理
|
||||
|
||||
- [ ] 约定 stable reducer 命名规则
|
||||
- [ ] 约定 stable table 命名规则
|
||||
- [ ] 约定列追加式演进规则
|
||||
- [ ] 约定软删除而不是直接删表删列的场景
|
||||
- [ ] 约定事件表与投影表拆分规则
|
||||
- [x] 约定 stable reducer 命名规则
|
||||
- [x] 约定 stable table 命名规则
|
||||
- [x] 约定列追加式演进规则
|
||||
- [x] 约定软删除而不是直接删表删列的场景
|
||||
- [x] 约定事件表与投影表拆分规则
|
||||
|
||||
### 大对象与缓存治理
|
||||
|
||||
- [ ] 明确哪些内容入 OSS
|
||||
- [ ] 明确哪些内容只存 SpacetimeDB 元数据
|
||||
- [ ] 明确哪些内容允许短期本地缓存
|
||||
- [ ] 明确 workflow cache 生命周期
|
||||
- [x] 明确哪些内容入 OSS
|
||||
- [x] 明确哪些内容只存 SpacetimeDB 元数据
|
||||
- [x] 明确哪些内容允许短期本地缓存
|
||||
- [x] 明确 workflow cache 生命周期
|
||||
|
||||
### 文档维护
|
||||
|
||||
- [ ] 每个阶段完成后同步更新设计文档
|
||||
- [ ] 每个阶段完成后补一份落地记录
|
||||
- [ ] 完成接口迁移后更新新的模块与 API 索引文档
|
||||
- [x] 每个阶段完成后同步更新设计文档
|
||||
- [x] 每个阶段完成后补一份落地记录
|
||||
- [x] 完成接口迁移后更新新的模块与 API 索引文档
|
||||
- [ ] `M4` 结构变更同步对齐 `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
|
||||
- [ ] `M5` 结构变更同步对齐 `docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
|
||||
- [x] `M5` 结构变更同步对齐 `docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
|
||||
|
||||
补充说明:
|
||||
|
||||
1. 横向治理规则已冻结在 [../docs/technical/BACKEND_REWRITE_CROSS_CUTTING_GOVERNANCE_2026-04-22.md](../docs/technical/BACKEND_REWRITE_CROSS_CUTTING_GOVERNANCE_2026-04-22.md)。
|
||||
2. Rust 侧 96 条 Axum 路由索引已冻结在 [../docs/technical/RUST_API_SERVER_ROUTE_INDEX_2026-04-22.md](../docs/technical/RUST_API_SERVER_ROUTE_INDEX_2026-04-22.md)。
|
||||
3. `M4` 当前仍存在 `runtime_story` 独立 crate 拆分工作区,结构文档对齐需等该拆分收口后再勾选。
|
||||
|
||||
## 2. 第一优先级建议执行顺序
|
||||
|
||||
@@ -44,13 +50,13 @@
|
||||
|
||||
## 3. 最终验收清单
|
||||
|
||||
- [ ] 当前 `96` 条后端接口已全部迁移或有兼容替代
|
||||
- [x] 当前 `96` 条后端接口已全部迁移或有兼容替代
|
||||
- [ ] 当前 `6` 个挂载面已全部迁移
|
||||
- [ ] 当前 `12` 个内部模块已完成新架构落位
|
||||
- [ ] Axum 已成为唯一 HTTP / SSE / 副作用边界
|
||||
- [ ] SpacetimeDB 已成为唯一运行时状态真相源
|
||||
- [ ] 阿里云 OSS 已成为唯一资产对象仓
|
||||
- [ ] `M4` 已与 `rpgEntry / rpgSession / rpgRuntime / rpgRuntimeStory / rpgProfile` 主链口径一致
|
||||
- [ ] `M5` 已与 `agent session -> result preview -> published profile` 主链口径一致
|
||||
- [x] `M5` 已与 `agent session -> result preview -> published profile` 主链口径一致
|
||||
- [ ] 前端主流程在不大改 UI 的前提下可跑通
|
||||
- [ ] 能完成灰度切流,并保留可回退能力
|
||||
|
||||
Reference in New Issue
Block a user