SpecialX 62682b9d61 docs(docs): 004 arch.db 二次校验 + 新增 v2 架构重设计 spec
004 修正 7 处与代码不符描述:

- proto 统计 / 包名 / core-edu gRPC service 数

- msg RPC 数 / data-ana RPC 数

- student-bff 模块数 / parent-bff 模块数

新增 v2 架构重设计 spec(996 行):

- Apollo Federation BFF 联邦

- DataScope @requires 运行时解析

- iam 拆分 config-service

- content CQRS / ai 无状态化

- SSE 优先 / Temporal 不引入

Spec 自审修复 6 处问题:

- apollo-router 端口冲突 4000→4011

- Kafka topic 命名一致性

- CDC/Outbox 投影器职责分工

- 改动点数字 / 服务数 / 容器数计算
2026-07-14 21:25:37 +08:00
2026-07-08 13:10:43 +08:00
2026-07-07 23:39:37 +08:00

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 + 生产硬化
Description
No description provided
Readme MIT 10 MiB
Languages
TypeScript 81.8%
Python 12.3%
Go 2.8%
JavaScript 1.2%
PowerShell 0.5%
Other 1.4%