# 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 缺陷清零。
- 关键指标可观测（错误率、超时率、任务积压）。