# 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

## 快速开始

```bash
# 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
```

## 文档

- [架构设计](docs/architecture/004_architecture_impact_map.md)
- [理想蓝图](docs/architecture/0010_architecture.md)
- [编码规范](docs/standards/coding-standards.md)
- [UI 设计系统](docs/standards/ui-design-system.md)
- [Git 工作流](docs/standards/git-workflow.md)
- [本地启动手册](docs/standards/local-dev-runbook.md)
- [多 AI 协作指南](docs/standards/multi-ai-collaboration.md)
- [CI/CD 使用手册](docs/standards/cicd-runbook.md)
- [已知问题](docs/troubleshooting/known-issues.md)
- [项目规则](.trae/rules/project_rules.md)
- [迁移指南](MIGRATION_GUIDE.md)

## 开发阶段

- **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 + 生产硬化