- 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
29 lines
1.7 KiB
Markdown
29 lines
1.7 KiB
Markdown
# 路线图索引
|
||
|
||
> 本目录存放项目长远规划,与架构事实(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 原则)
|