2ba4250165
- 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
路线图索引
本目录存放项目长远规划，与架构事实（004）分离。
文档清单
| 文档 | 用途 |
|---|---|
| tech-debt.md | 技术债清单（按 P0/P1/P2 优先级 + 已解决项） |
| 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）
- 每阶段完成后打 tag：
v0.1.0-p1、v0.2.0-p2... - 发现的新需求一律记入
tech-debt.md，不在当前阶段实现（YAGNI 原则）