# 路线图索引

> 本目录存放项目长远规划，与架构事实（004）分离。

## 文档清单

| 文档 | 用途 |
|------|------|
| [tech-debt.md](./tech-debt.md) | 技术债清单（按 P0/P1/P2 优先级 + 已解决项） |
| [pending-features.md](./pending-features.md) | 待开发功能路线图（6 阶段：P1 地基 → P6 硬化） |

## 6 阶段路线图总览

| 阶段 | 周期 | 核心交付 | 退出标准 |
|------|------|----------|----------|
| **P1 地基** | M1-M3 | 仓库骨架 + Docker 全量 infra + API Gateway + 契约层 + CI/CD + 文档体系 + classes 黄金模板 | classes 域 CRUD 端到端跑通 + 全横切关注点落地 + 30 分钟可复制新服务 |
| **P2 身份** | M4-M6 | IAM 服务 + Teacher BFF(GraphQL) + 微前端骨架 | 教师可登录并看到空白 Dashboard |
| **P3 核心教学** | M7-M10 | CoreEdu 服务 + Outbox 模式 + 考试/作业/成绩域 | 教师创建考试→学生作答→教师批改→成绩统计 全链路 |
| **P4 内容分析** | M11-M13 | Content 服务(Neo4j) + DataAna(Python+CH) + CDC 链路 | 知识图谱查询 + 学情诊断宽表 5s 内返回 |
| **P5 沟通AI** | M14-M16 | Msg 服务 + Push Gateway + AI 网关 + ES 题库检索 | 全校广播推送 + AI 辅助出题 + 题库检索 < 200ms |
| **P6 硬化** | M17-M18 | Service Mesh + 全链路可观测 + 生产硬化 | 单服务可独立扩缩容 + 99.9% 可用性 |

## 维护规则

- 规划实现后从本目录删除，迁入 004 架构事实或 git 历史
- 不含架构事实，不含经验（经验查 [../troubleshooting/known-issues.md](../troubleshooting/known-issues.md)）
- 每阶段完成后打 tag：`v0.1.0-p1`、`v0.2.0-p2`...
- 发现的新需求一律记入 `tech-debt.md`，不在当前阶段实现（YAGNI 原则）