SpecialX a6b0c54fba fix: 修复登录路由 + 端口冲突 + Prometheus 配置 + outbox 表结构 + 补充监控基础设施
1. teacher-portal 登录 JSON 解析错误修复
   - 根因:next.config.js rewrites /api/auth/* → gateway /api/auth/*,
     但 gateway 只在 /api/v1 路由组下注册代理,/api/auth/* 返回 404 纯文本
   - 修复:rewrites 映射 /api/auth/* → /api/v1/iam/*(对齐 iam controller @Controller("v1/iam"))

2. msg / data-ana 端口冲突修复
   - 根因:msg env.ts PORT 默认 3006,与 data-ana(config.py http_port=3006)冲突
   - 修复:msg PORT 默认 3006→3007(对齐端口分配表 msg=3007, data-ana=3006)

3. Prometheus classes-service 3001 DOWN 修复
   - 根因:classes 已合并入 core-edu(P3 裁决 C1),但 prometheus.yml 仍有 classes-service scrape 配置
   - 修复:从 prometheus.yml 删除 classes-service job

4. iam outbox 表 aggregate_id 列长度修复
   - 根因:iam_outbox.aggregate_id VARCHAR(32),但 UUID 是 36 字符,导致 "Data too long" 错误
   - 修复:DDL 中 VARCHAR(32) → VARCHAR(36);ALTER TABLE 修复现有数据库

5. 补充未搭建的监控基础设施
   - docker-compose.yml 新增 Alertmanager(9093)/ Loki(3100)/ Promtail(observability profile)
   - prometheus.yml alertmanager target 更新为 edu-alertmanager:9093

验证:
- TS typecheck 19 项目全部通过
- 登录链路 teacher-portal → gateway → iam 验证通过
- Prometheus targets 不再有 classes-service
- 3 个新基础设施容器(alertmanager/loki/promtail)启动成功

AI identity: trae-main(基础设施修复会话)
2026-07-11 09:22:09 +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%