SpecialX 4307f6b73c feat(api-gateway): 实现 W1-W8 网关硬化与 P2-P5 路由扩展
依据 coord-final-decisions §3.8 W1-W8 裁决与
president-final-rulings §2.15/§2.16/§2.19 完整实现网关硬化:

- W1/W2: 错误码 GW_ 前缀 + ActionState 信封响应体
- W3: 全量替换为 log/slog 结构化日志
- W4: /readyz 并行 ping 9 下游 + 软失败规则
- W5: 7 个业务 Prometheus 指标 + /metrics 端点
- W6: tracer 资源属性补全(name/version/env/host)
- W7: DevMode=true && ENV=production panic 防护
- W8: 保持共享 downstream 熔断

P2 RS256 升级:接入 shared-go/jwks.Fetcher(TTL 5min)。
P2.7+P3-P5 路由扩展:student/parent/messages/dashboard。
文档同步:README/01/02/known-issues,arch.db 已更新。
质量校验:go vet + build + test 均通过。
2026-07-10 18:15:48 +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 6.8 MiB
Languages
TypeScript 81.8%
Python 12.3%
Go 2.8%
JavaScript 1.2%
PowerShell 0.5%
Other 1.4%