9db7fd917e
P6 硬化（5 项全部完成）:
- CDC 多实例水平扩展: _INSTANCE_ID + get_lag() 真实 lag 计算
- ExamCache Redis 化: key data_ana:exam:{exam_id}, TTL 30 天 + 内存 LRU fallback
- ClickHouse TTL 归档: 5 表均加 TTL（1-3 年），分区级删除
- Prometheus 监控: 18 个指标（CDC/CH/ExamCache/DataScope/gRPC/业务）
- readyz 深度硬化: 4 依赖超时检查（CH 1s/Redis 200ms/iam 2s/CDC lag<1000）
v2 新增 6 个 RPC（analytics.proto 扩展为 18 RPC）:
- GetStudentGrowth / GetAssignmentAnalysis / GetMasterySummary
- ListDiagnosticReports（占位，待 ai 服务）/ ListErrorBookItems / GetErrorBookStats
监控与可观测性: lifespan 预热 + gRPC ServerInterceptor + CDC 消费者指标
Docker 本地测试 19 项全部通过（healthz/readyz/metrics + 11 HTTP + 10 gRPC + ruff）
nextstep-v2.md: 上游需求对齐 + 下游要求（iam/core-edu/content/ai/SRE）
Next Edu Cloud
基于 DDD + EDA + CQRS 的企业级微服务架构教育云平台。
技术栈
- 网关层: Go (Gin)
- 业务服务: TypeScript (NestJS)
- 分析/AI: Python (FastAPI)
- 前端: React (Next.js + Module Federation)
- 存储: MySQL / Redis / ClickHouse / Neo4j / Elasticsearch
- 事件总线: Kafka + Debezium CDC
- 契约: protobuf + buf
快速开始
# 1. 安装依赖
pnpm install
# 2. 启动最小基础设施（MySQL + Redis）
docker compose -f infra/docker-compose.minimal.yml up -d
# 3. 复制环境变量
cp .env.example .env
# 4. 运行 arch.db 扫描
pnpm run arch:scan
# 5. 启动服务
pnpm dev
文档
开发阶段
- P1 地基 (M1-M3): 仓库骨架 + 基础设施 + classes 黄金模板
- P2 身份 (M4-M6): IAM 服务 + Teacher BFF + 微前端骨架
- P3 核心教学 (M7-M10): CoreEdu + Outbox + 考试/作业/成绩
- P4 内容分析 (M11-M13): Content + DataAna + CDC
- P5 沟通AI (M14-M16): Msg + Push + AI + ES
- P6 硬化 (M17-M18): Service Mesh + 生产硬化