Files
Edu/docs/architecture/roadmap/README.md
SpecialX 2ba4250165
Some checks failed
CI Go / test (push) Has been cancelled
CI Proto / lint (push) Has been cancelled
CI Python / test (push) Has been cancelled
CI TypeScript / test (push) Has been cancelled
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
2026-07-07 23:39:37 +08:00

1.7 KiB
Raw Permalink Blame History

路线图索引

本目录存放项目长远规划与架构事实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
  • 每阶段完成后打 tagv0.1.0-p1v0.2.0-p2...
  • 发现的新需求一律记入 tech-debt.md不在当前阶段实现YAGNI 原则)