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
SpecialX
f623dcf4a7
feat(portal-shell): extract gql documents to operations layer
...
M1 Task 3: 从 31 widget 抽取 51 个 gql 文档到 7 个 operations 文件
- universal(7) + sidebar(3) + topbar(3) + teacher(6) + student(8) + parent(4) + admin(20) = 51 DOC
- operations/index.ts barrel 统一出口
- codegen.yml 启用 documents + skipDocumentsValidation（services 子图字段待补齐）
- 生成 types.ts (28KB) + operations.ts (10KB)
2026-07-17 12:37:36 +08:00
SpecialX
7c234947e1
feat(portal-shell): add graphql-codegen configuration
...
M1 Task 2: 配置 graphql-codegen 与 federation schema 预处理
- codegen.yml: schema 从 combined-schema.graphql 读取（federation 已剥离）
- scripts/normalize-schema.ts: 把 7 个子图的 extend type Query 合并为 type Query
- package.json: 新增 codegen/codegen:watch scripts + 4 个 codegen deps + tsx
- .gitignore: 忽略 src/lib/api/__generated__/
- documents 配置暂注释，Task 3 创建 operations 文件后启用
2026-07-17 12:12:37 +08:00
SpecialX
989603e318
feat(portal-shell): add lib/api skeleton with errors and types
...
M1 Task 1: 创建 4 层数据抽象层的骨架文件
- errors.ts: ApiError + GraphQLErrorCode 枚举
- types.ts: Pagination / PaginatedResult / UseQueryResult / UseMutationResult
- internal.ts: normalizeError 把 ApolloError 转为 ApiError
- index.ts: barrel 出口
2026-07-17 12:06:01 +08:00
SpecialX
514e26ebb4
feat(portal-shell): implement portal-shell with apollo-router integration
...
M8: portal-shell unified frontend shell (Modular Monolith + micro-kernel).
- Apollo Client -> apollo-router (port 4010, RSC prefetch)
- 5 layouts: classic/focus/split/triple/canvas
- Registry + PluginLoader (dynamic import ssr:false)
- 3-layer props merge, Zustand PluginStore
- 4 widgets: grades/notification-bell/user-menu/class-selector
- config-service: new pluginConfig GraphQL resolver
- apollo-router: CORS + header propagation for portal-shell
- docker-compose.yml: portal-shell service block
2026-07-15 08:06:09 +08:00
