sql更新、架构更新

This commit is contained in:
2026-04-16 15:46:29 +08:00
parent 2f2d796e30
commit d5c06eca28
36 changed files with 2099 additions and 387415 deletions

81
docs/milestone.md Normal file
View File

@@ -0,0 +1,81 @@
# K12Study 项目里程碑4.13-7.1
## 1. 目标
- 在 7.1 前完成从基础架构到业务闭环的可交付版本。
- 形成“可开发、可联调、可测试、可发布”的完整流程。
## 2. 里程碑总览
### M0 逻辑视图梳理04.13-04.15
- 产出
- 逻辑分层、模块边界、核心调用链路。
- 完成标准
- 前后端、网关、服务、数据层职责边界确认。
### M1 ER 图与 SQL 设计04.16-04.21
- 产出
- 核心域 ER 关系与 SQL 基线。
- 完成标准
- 关键业务实体关系可支持后续 API 定义与实现。
### M2 基础服务配置04.22-04.26
- 产出
- PostgreSQL、Redis、Nacos、知识图谱、向量库基础编排。
- 完成标准
- 本地环境可稳定启动并通过健康检查。
### M3 基础架构 API 定义04.27-05.03
- 产出
- 认证、权限、组织、动态路由 API 契约冻结。
- 完成标准
- API 输入输出、鉴权策略、错误码规范完成评审。
### M4 基础架构前后端构建05.04-05.10
- 产出
- auth/upms/gateway 联调通过,前端与小程序可调用基础 API。
- 完成标准
- 登录、当前用户、动态路由、组织树查询链路可演示。
### M5 核心课程/学习业务 API 与模型冻结05.11-05.17
- 产出
- 课程、学习路径、学习记录、学习效果相关 API 与数据模型冻结。
- 完成标准
- 核心课程/学习域接口契约可直接指导开发实现。
### M6 核心课程/学习业务前后端构建05.18-06.14
- 产出
- 课程与学习主流程前后端实现并完成联调。
- 完成标准
- 课程发布 -> 学习执行 -> 学习记录回写闭环可运行。
### M7 核心内容专项测试与修复06.15-06.24
- 产出
- 课程/学习相关模块测试报告与修复记录。
- 完成标准
- 阻塞级问题清理并完成修复回归。
### M8 全链路回归与发布评估06.25-07.01
- 产出
- 端到端测试结果、发布准入结论Go/No-Go
- 完成标准
- 核心主流程通过,具备发布条件。
## 3. 关键交付物映射
- 架构与设计
- `docs/architecture.md`
- `docs/architecture/logical-view.md`
- `docs/architecture/er-diagram.md`
- `docs/architecture/schema-baseline.sql`
- 服务与环境
- `docker/dev-common/docker-compose.yml`
- `docker/dev-common/docker-compose.public-services.yml`
- `.devcontainer/external/docker-compose.yml`
- `.devcontainer/internal/docker-compose.yml`
- API 与测试
- `docs/architecture/api-design.md`
- `docs/architecture/test-plan.md`
## 4. 发布前检查清单
- API 契约无破坏性变更。
- 基础服务编排可稳定启动。
- 核心闭环 E2E 全通过。
- P0/P1 缺陷清零。
- 关键指标可观测(错误率、超时率、任务积压)。