- 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
53 lines
1.5 KiB
Markdown
53 lines
1.5 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/troubleshooting/known-issues.md)
|
||
- [项目规则](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 + 生产硬化
|