994441c2dc
P1-3 验收通过：4 个页面模板 + 4 个 dev 示例页 + 三态规范。
新增文件：
- src/shared/components/page-templates/
- list-page.tsx：ListPageShell + ListPageSkeleton
- detail-page.tsx：DetailPageShell + DetailSection + DetailField + DetailPageSkeleton
- form-page.tsx：FormPageShell + FormPageSkeleton
- workbench-page.tsx：WorkbenchPageShell + WorkbenchPanel + WorkbenchPageSkeleton
- index.ts：barrel 导出
- src/app/shell/dev/templates/
- page.tsx：索引页（4 个模板入口）
- list/page.tsx：列表页示例（支持 ?state=loading|empty|success）
- detail/page.tsx：详情页示例
- form/page.tsx：表单页示例
- workbench/page.tsx：工作台页示例
- src/shared/components/__tests__/page-templates.test.tsx：19 个单测
修改文件：
- src/shared/lib/route-permissions.ts：新增 PREFIX /shell/dev/（空 config = 仅校验登录）
- ARCHITECTURE.md：P1-3 状态回填 ✅ + 验收证据
路径命名修正：
- 原 ARCHITECTURE.md 写 /shell/_dev/templates/*，但 Next.js 将下划线开头的
文件夹视为"私有文件夹"（不参与路由），实测被 [[...route]] catch-all 兜底接管。
- 改用 dev 命名后，显式路由优先匹配，catch-all 不再触发。
三态规范验证：
- GET /shell/dev/templates/list?state=loading → 200，含 animate-pulse 骨架
- GET /shell/dev/templates/list?state=empty → 200，含"暂无数据"空态
- GET /shell/dev/templates/list（默认 success）→ 200，含表格数据
质量校验：
- tsc --noEmit 通过
- eslint（新/改文件）通过
- vitest run 全量 21 test files / 231 tests 全部通过（212 原有 + 19 新增）
Refs: apps/portal-shell/ARCHITECTURE.md §7.3 页面四种类型与模板、
§7.4 页面级数据获取模式、§11.3 每页硬性清单（DoD）三态规范
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 + 生产硬化