K12Study/docs/milestone.md

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