d19285a977
- local-dev-runbook.md: 8 章本地启动手册（环境依赖/端口分配/开发模式/生产模式/裸机运行/常见问题） - multi-ai-collaboration.md: 15 章多AI协作文档（角色定义/模块分工/分支策略/PR流程/审核合并/跨模块变更） - cicd-runbook.md: 10 章 CI/CD 使用手册（架构总览/一次性配置/日常使用/镜像管理/部署验证/回滚） - README.md: 文档清单新增三个 runbook 链接
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# 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 + 生产硬化
|