docs(路线图): 合并V2.5阶段基线
This commit is contained in:
。
@@ -1,8 +1,34 @@
|
||||
# 开发路线图
|
||||
|
||||
## 当前阶段：V2.4 — 领域 CRUD 主写迁移完成
|
||||
## 当前阶段：V2.5 — AppData 分阶段退场 + RBAC/审计/一致性收口
|
||||
|
||||
V2.4 将高增长和核心业务领域从“AppData 主写 + 关系表同步副本”推进到“领域 CRUD 主写关系表 + AppData 兼容/迁移兜底”。V2.2 快读 API 和 V2.3 AppData 写后同步继续保留，但它们现在是兼容基础设施，不再是已迁移领域的数据新鲜度主链路。
|
||||
V2.4 已将高增长和核心业务领域从“AppData 主写 + 关系表同步副本”推进到“领域 CRUD 主写关系表 + AppData 兼容/迁移兜底”。V2.2 快读 API 和 V2.3 AppData 写后同步继续保留，但它们现在是兼容基础设施，不再是已迁移领域的数据新鲜度主链路。
|
||||
|
||||
V2.5 的目标是正式收口后端权限、审计、AppData 禁写和一致性核对。AppData 不能直接删除，必须按“禁写 → 双读核对 → 移除 fallback → 只读归档/导出 → 后续删表”的顺序推进。
|
||||
|
||||
### 当前重点
|
||||
|
||||
1. **RBAC 收口**：领域 mutation API 接入服务端权限校验、资源作用域和当前用户上下文。
|
||||
2. **审计事件**：所有领域 mutation 写 append-only audit event，支持后台查询和敏感字段脱敏。
|
||||
3. **AppData 禁写**：业务 AppData key 进入 `write_frozen` 或 `read_only_archive`，读仍可用，写返回明确替代领域 API。
|
||||
4. **导出归档**：提供 AppData archive export/verify 脚本，包含 checksum、key list 和应用版本元数据。
|
||||
5. **一致性校验**：提供 counts、partition key、orphan refs、audit coverage 的本地脚本和后台页面。
|
||||
6. **管理端可视化**：补 `/admin/audit` 与 `/admin/consistency`，并由 `audit:view` / `consistency:view` 控制。
|
||||
|
||||
## V2 分阶段交付链路
|
||||
|
||||
| 阶段 | 主题 | 边界 |
|
||||
|------|------|------|
|
||||
| V2.1 | AppData 服务端持久化 | 业务数据从浏览器 localStorage 迁到服务端 `app_data`，先解决清站点数据丢失问题。 |
|
||||
| V2.2 | 关系表 + 分区 + 快读 API | 建高增长领域表、分区键、快读查询和小宝摘要读取，写入仍走 AppData。 |
|
||||
| V2.3 | AppData 写入后同步关系表 | AppData 仍是兼容期写入事实源，保存成功后非阻塞同步关系表和风险摘要脏标记。 |
|
||||
| V2.4 | 领域 CRUD 主写迁移 | 逐领域补写 API，前端保存迁到领域 API；同时埋权限、作用域、审计和分页/索引基础。 |
|
||||
| V2.5 | AppData 分阶段退场 + RBAC/审计/一致性收口 | 禁写 AppData、移除 fallback、归档/导出旧 JSON，正式收紧权限、审计和一致性校验。 |
|
||||
| V2.6 | 大数据性能增强 + 小宝预警后台化 | 在关系表主源稳定后做压测、慢查询治理、缓存/摘要、后台任务、幂等重试和小宝定时预警。 |
|
||||
| V2.7 | 企业级协作能力 + 管理治理 | 补齐通知、协同、组织治理、管理视图、数据治理和企业级配置能力。 |
|
||||
| V2.8 | 生产硬化稳定版 + 运维闭环 | 在现有 CI/CD 基线上补备份恢复演练、发布 smoke test、监控告警、日志检索、迁移回滚和运维手册。 |
|
||||
|
||||
阶段顺序不能倒置：权限/审计骨架从 V2.4 开始随领域 API 落地，V2.5 做全面收口；分页、索引、分区键查询从 V2.4 就必须进入 API 设计，V2.6 只做增强和压测治理；AppData 退场必须按“禁写 → 双读核对 → 移除 fallback → 只读归档/导出 → 后续删表”推进，不能一次性删除历史 JSON。
|
||||
|
||||
### 当前状态快照（2026-07-08）
|
||||
|
||||
@@ -108,6 +134,7 @@ V2.4 将高增长和核心业务领域从“AppData 主写 + 关系表同步副
|
||||
|
||||
### 进行中
|
||||
|
||||
- V2.4 领域 CRUD 主写迁移：从 AppData JSONB 主写入切换到关系表 API，并随 API 落基础权限、审计和查询性能边界。
|
||||
- 项目详情页 VersionCard 状态胶囊数据联动（部分已完成）
|
||||
|
||||
## V2 — 后端接入
|
||||
@@ -120,9 +147,12 @@ NestJS + Prisma + PostgreSQL 已推进到 V2.4。第一阶段用 `app_data` JSON
|
||||
2. **localStorage → API 切换**：业务主数据不再写浏览器（第一阶段已实现）
|
||||
3. **运行 Prisma 同步/迁移**：本地和服务器数据库都需要创建 `app_data` 与 V2.2/V2.3 关系表
|
||||
4. **关系化拆表**：把稳定模块从 JSONB 拆成 Product/Project/Version/Task 等领域表（关系模型、同步桥和 V2.4 领域写 API 已落地）
|
||||
5. **认证**：NextAuth.js + JWT
|
||||
6. **权限**：RBAC（Owner/Admin/Member/Viewer），按项目/版本级别
|
||||
7. **版本规则引擎收敛**：VersionPlan 完成条件、关联需求候选、TaskCategory 语义码、TestCase.categoryId 统一收束到规则层
|
||||
5. **领域 CRUD 主写入**：前端保存不再写整份 JSON 文档，而是调用具体领域 API 写关系表（V2.4 已完成）
|
||||
6. **基础权限/审计骨架**：领域 API 从迁移期开始接入用户身份、资源作用域、操作人和审计事件入口
|
||||
7. **AppData 主路径移除**：完成迁移核对后逐模块删除 JSON fallback 和 `/data/:key` 主写入依赖
|
||||
8. **认证**：NextAuth.js + JWT
|
||||
9. **权限**：RBAC（Owner/Admin/Member/Viewer），按项目/版本级别
|
||||
10. **版本规则引擎收敛**：VersionPlan 完成条件、关联需求候选、TaskCategory 语义码、TestCase.categoryId 统一收束到规则层
|
||||
|
||||
### 数据迁移策略
|
||||
|
||||
@@ -210,5 +240,6 @@ V2.4 完成后的兼容边界：AppData 不再是上述领域的事实源，只
|
||||
| V1 业务流程打磨 | 进行中 |
|
||||
| V1 朋友试用反馈 | 持续中 |
|
||||
| V2 后端接入 | 进行中（V2.4 领域 CRUD 主写迁移已完成；RBAC/认证仍待后续阶段） |
|
||||
| V2 后端接入 | 进行中（V2.4 领域 CRUD 主写迁移已完成；V2.5 RBAC/审计/AppData 退场进行中） |
|
||||
| V3 AI 集成 | 等 V2 数据沉淀 |
|
||||
| 公开发布 | TBD |
|
||||
|
||||
Reference in New Issue
Block a user