SpecialX b30d43f983 feat(portal-shell): enable Apollo Client APQ + PQ manifest generator
Task 12-13 of portal-shell data abstraction plan (M3 security).

APQ (Automatic Persisted Queries):
- Add createPersistedQueryLink with sha256 to apollo-client.ts
- Production: client sends only query hash, not plaintext query
- Dev: NEXT_PUBLIC_APOLLO_APQ=false to disable for debugging
- Prevents attackers from crafting arbitrary queries via DevTools

PQ Manifest generator:
- New scripts/generate-pq-manifest.ts iterates operations barrel
- Outputs public/pq-manifest.json (sha256 -> query text whitelist)
- prebuild hook: codegen + generate-pq-manifest before next build
- 51 queries currently registered

- crypto-hash dependency added
- typecheck + lint (0 errors) + test (85/85) verified
2026-07-17 13:31:11 +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%