feat(p1): complete P1 foundation stage

- monorepo: pnpm workspace + go.work + pyproject.toml + commitlint/husky
- infra: docker-compose (minimal + full profiles) + init-sql + prometheus
- arch-scan: multi-language scanner skeleton (TS/Go/Python/Proto)
- shared-proto: buf v2 + classes.proto (ClassService CRUD contract)
- api-gateway: Go/Gin + JWT HS256 auth + reverse proxy + request ID
- classes: NestJS golden template (error system + observability + middleware + CRUD + tests)
- teacher-portal: Next.js + paper-feel UI design system
- CI/CD: 4 workflows (go/ts/py/proto)
- docs: migration guide + project_rules + coding-standards + git-workflow + ui-design-system + 004 + 9 module READMEs + known-issues + spec/plan migration + roadmap

docs/architecture/roadmap/README.md

@@ -0,0 +1,28 @@
+# 路线图索引
+
+> 本目录存放项目长远规划，与架构事实（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 原则）