Files
Edu/README.md
SpecialX 2ba4250165
Some checks failed
CI Go / test (push) Has been cancelled
CI Proto / lint (push) Has been cancelled
CI Python / test (push) Has been cancelled
CI TypeScript / test (push) Has been cancelled
feat(p1): complete P1 foundation stage
- 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
2026-07-07 23:39:37 +08:00

53 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 + 生产硬化