路线图与里程碑
1. 规划原则
- 先冻结需求，再展开设计，再推进实现与验收。
- 主链路优先于增强项，基本项优先于加分项。
- 每个里程碑都要有可检查的出口条件，而不是只写“继续推进”。
2. 课程周历映射
| 周次 | 目标 | 主要输出 | 出口条件 |
|---|---|---|---|
| 第 7 周前 | 计划阶段收口 | 软件开发计划书、项目章程、路线图 | 范围与非范围明确，阶段责任明确 |
| 第 8 周前 | 需求冻结 | SRS、产品文档、模块地图 | MUST / SHOULD / COULD 划分清晰，主链路冻结 |
| 第 9-10 周 | 概要设计 | 概要设计说明书、总体架构、API 总览 | 模块边界、部署拓扑、关键流程和技术路线稳定 |
| 第 11-12 周 | 详细设计 | 详细设计说明书、数据库设计、接口明细 | 页面、服务、数据表、状态机、异常流明确 |
| 第 13-14 周 | 编码与联调 | 可运行系统、前后端联调结果、测试策略 | 主链路跑通，核心缺陷受控 |
| 第 15 周前 | 验收收口 | 测试报告、部署文档、用户手册、演示脚本 | 部署可复现，演示路径稳定，文档与系统一致 |
3. 内部研发里程碑
M1 需求基线冻结
- 完成 SRS 编号化需求和业务规则整理。
- 确认平台管理员、教师、学员三类主角色的完整主链路。
- 明确 V1 非范围内容，防止开发阶段继续扩张。
M2 设计基线冻结
- 完成系统上下文、模块图、部署图、核心时序和数据模型。
- 定义前端路由、后端模块、数据库表和关键 API。
- 确认判题与沙箱的落地方式及结果模型。
M3 开发主链路可运行
- 教师可建课、发任务。
- 学员可加入课程、提交代码或文件。
- 系统可自动评测并回传结果。
- 教师可批改并发布成绩。
M4 验收与答辩就绪
- 环境部署脚本和操作手册可独立复现。
- 测试用例、缺陷清单和回归记录齐全。
- 视频脚本、答辩 PPT 和演示账号准备完成。
4. 任务分层
| 层级 | 内容 | 是否阻断交付 |
|---|---|---|
| L0 | 主链路：课程、任务、提交、评测、批改、成绩 | 是 |
| L1 | 平台治理：组织、用户、审计、平台概览 | 是 |
| L2 | 增强可用性：课程编排、Rubric、草稿、公告、导出 | 否，但强烈建议 |
| L3 | 加分项：AI 助教、可观测仪表盘、UI/UX 精修 | 否 |
5. 加分项插入点
| 加分项 | 最早启动时机 | 进入条件 |
|---|---|---|
| 可观测性仪表盘 | M3 后 | 平台关键指标已经可采集 |
| AI 助教 / 智能答疑 | M3 后 | 主链路稳定，且 AI 模块不阻断正常教学流程 |
| Skills 沉淀 | 全周期 | 已实际使用大模型，且有会话与复核记录 |
| UI/UX 提升 | M2 后 | 信息架构和页面流程已冻结 |
6. 风险缓冲
- 为判题与联调预留至少 1 周缓冲，不把其压到验收前最后三天。
- 为部署和演示准备预留至少 3 次完整彩排。
- 若增强项与主链路冲突，立即冻结增强项，优先处理主链路。
7. 里程碑检查表
- M1：SRS 是否覆盖课程要求中的核心需求和验收条件。
- M2：设计文档是否能直接指导数据库建模、API 编码和页面实现。
- M3：是否存在任何阻断“教师发任务 -> 学员提交 -> 教师出成绩”的故障。
- M4：是否能在全新环境下按照部署文档完成启动，并按照用户手册完成演示。