5661938cc0
实现内容（仲裁裁决驱动，首次即最终方案）： P4 核心功能 - 认证：localStorage token 存储（F12）+ REST 登录（ISSUE-004）+ refreshAccessToken 竞态防护 - 子女切换：ChildSwitcher（Tab ≤3 / 下拉 ≥4）+ Zustand store（ISSUE-009 纯前端切换） - 数据查询：urql GraphQL 消费 parent-bff（F9）+ TanStack Query 缓存 - 通知中心：NotificationFeed + 已读/全部已读 mutations - 通知偏好：三维矩阵 + ISSUE-033 localStorage 降级 - 5 层状态管理：URL/Server/Client/Global UI/Form - 跨标签同步：BroadcastChannel + storage 事件 P5 实时推送 - WebSocket 连接 push-gateway + 指数退避重连 - HTTP 轮询降级（60s）+ 实时通知 Hook P6 硬化 - Web Vitals 上报 + OTel trace - i18n 5 语言（zh-CN/en-US/zh-TW/ja-JP/ar-SA 含 RTL） - PWA manifest + Service Worker - CSP 安全头 + 权限点 F7 命名 + 设计令牌三层 测试与构建 - Vitest 92 测试全通过（utils/auth/child-store/ChildSwitcher/NotificationFeed/login） - MSW mock 未就绪上游（parent-bff GraphQL + iam REST + iam GetChildrenByParent P0 阻塞用 fixtures） - Dockerfile 多阶段构建（G1，端口 4002，HEALTHCHECK /api/health） - typecheck + lint 零错误 经验沉淀 - known-issues.md §2.13 追加 12 条实现期经验（无 AI 身份标注） - arch.db 已更新（15 TS 模块 / 482 符号 / 138 proto） 依据：02-architecture-design.md（回写总裁裁决）、coord-final-decisions.md、 president-final-rulings.md、parent-portal_workline.md、parent-portal_contract.md
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 + 生产硬化