SpecialX 2910a90271 feat(portal-shell): extract domain API layer and migrate 31 widgets
Task 4-10 of portal-shell data abstraction plan (M1-M2).

Add 7 domain API modules under src/lib/api/ (parent/admin/teacher/
student/universal/sidebar/topbar), each exposing semantic hooks that
wrap useWidgetQuery/useWidgetMutation and return flattened domain
models. Widget code now imports from @/lib/api instead of inlining
gql literals.

- 31 widgets migrated (gql literal count in widgets: 0)
- 7 test files (85 cases, all passing)
- topbar.useNotifications renamed to useNotificationBell to avoid
  barrel export collision with universal.useNotifications
- typecheck + lint (0 errors) + test (85/85) verified
2026-07-17 13:07:24 +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 10 MiB
Languages
TypeScript 81.8%
Python 12.3%
Go 2.8%
JavaScript 1.2%
PowerShell 0.5%
Other 1.4%