xiner/Edu - Edu - Xiner

xiner/Edu

Fork 0

Commit Graph

Author	SHA1	Message	Date
SpecialX	2f8f3f3855	feat(portal-shell): grades 模块 5 页迁移（教师域 §9.1 B2） §9.1 B2 grades 行：/grades、/entry、/analytics、/stats、/report-card 契约：grade(id) ✅ 真实查询；列表/分析/统计/成绩单 → MSW 兜底新增文件： - src/lib/api/grades.ts (6 hooks) - src/lib/api/operations/grades.graphql.ts (6 documents) - src/features/teacher/grades/ (7 files: transformations + tests + 5 clients) - src/app/shell/teacher/grades/ (5 page.tsx + loading.tsx + error.tsx) 修改文件： - src/mocks/graphql-data.ts (5 mock 常量 + 6 handler cases) - src/messages/{zh-CN,en}.json (grades i18n) - src/lib/api/{index,operations/index}.ts (导出 grades) - scripts/check-page-count.ts (baseline 26 → 31) DoD 验收（§11.3 11 项）： - typecheck 0 errors - lint 0 errors - vitest 357 tests passed - lint:tokens 0 errors - check:pages 31 PASS 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.1 / §10 P2 / §11.3 / §11.4	2026-07-22 18:41:55 +08:00
SpecialX	081cb5fbc3	feat(portal-shell): homework 模块 7 页迁移（教师域 §9.1 B2） §9.1 教师域 homework 模块完整迁移（继 exams 之后第二个 B2 模块）： 7 页路由结构（与旧 teacher-portal 同构）： - /shell/teacher/homework：列表页（?classId/status/q 筛选） - /shell/teacher/homework/new：布置作业表单页 - /shell/teacher/homework/[id]：详情 + 内联批改（含提交列表 + recordGrade 表单） - /shell/teacher/homework/submissions：跨作业提交评审列表 - /shell/teacher/homework/submissions/[submissionId]：单份提交批改 + AI 建议 + 上下份导航 - /shell/teacher/homework/submissions/[submissionId]/scan-grading：扫描批改工作台（三栏） - /shell/teacher/homework/assignments/[id]/submissions：按作业批量批改 + 统计 + AI 批量评分数据契约（混合）： - ✅ homework(id: ID!) 真实查询（schema 已就绪，详情页用） - ❌ 列表/mutation/submissions/grading/aiBatchGrading 全部 @contract-pending MSW 兜底 · 9 个 hook 走 MSW，待后端补齐 mutation 后切换真实 fetcher §11.3 DoD 11 项验收： 1. route-permissions：EXACT + PREFIX 表 /shell/teacher/homework 已配置 2. 页面模板：list/new 用 ListPageShell/FormPageShell；detail/grading 用 DetailPageShell； scan-grading 用 WorkbenchPageShell（三栏，未使用 emptyNode） 3. 三态：loading(Skeleton)/error(errorNode 或 errorSummary)/empty(emptyNode) 全实现 4. lib/api hooks：homework.ts 10 个 hooks（useHomework 真实 + 9 个 MSW） 5. @contract-pending MSW：graphql-data.ts 扩展 6 块 mock + 10 个 switch case 6. i18n：homework 节点扩展 8 个分区共 130+ keys（list/detail/new/submissions/grading/ scan/assignment/error）中英对齐 7. lint：0 errors（4 warnings 在 __generated__） 8. lint:tokens：0 errors 9. notify：mutation 反馈走 @/shared/lib/notify（非 sonner 直引） 10. vitest：transformations 纯函数单测齐全，全量 323/323 通过（新增 ~50 测试） 11. typecheck：0 errors（noUncheckedIndexedAccess 安全访问）附带修复： - 修复 2 处遗留 broken link： · widgets/sidebar/quick-actions: /homework/new → /shell/teacher/homework/new · widgets/topbar/global-search: /homework → /shell/teacher/homework - scripts/check-page-count.ts baseline 同步 13 → 26（与 exams 6 + homework 7 一致）剩余模块：grades(5)+lesson-plans(6)+questions(1)+textbooks(2)+attendance(4)+classes(3)+ students(1)+course-plans(2)+elective(3)+error-book(1)+diagnostic(2)+analytics(2)+ai-*(3)+ knowledge-graph(1)+practice(1)+schedule-changes(1)+leave(1) 共 39 页。	2026-07-22 18:11:15 +08:00
SpecialX	7c511e74bd	feat(portal-shell): add CI structural checks for routes, pages, codegen (P1-8) ARCHITECTURE.md §10 P1-8: three structural checks wired into CI to prevent regressions identified in the §1.3 audit. Scripts (apps/portal-shell/scripts/): - check-route-table.ts: scans src/app/shell/*/page.tsx, parses route-permissions.ts (EXACT/PREFIX/DASHBOARD/PUBLIC_ROUTES), fails if any actual /shell/ route is unregistered. Reports ghost entries (EXACT declarations without page.tsx) as informational. - check-page-count.ts: asserts total page.tsx >= 13 and per-category minimums (dashboards/login/root/forbidden/catch-all/dev-templates). - check-codegen.ts: runs pnpm run codegen, fails if any output with skipDocumentsValidation:false has operations referencing non-existent schema fields (currently enforces dashboard-types.ts output from P1-7). npm scripts: check:routes / check:pages / check:codegen / check:all CI: .github/workflows/ci.yml quality-ts job — new "Portal-shell structural checks (P1-8)" step between typecheck and test. Acceptance (ARCHITECTURE.md §10 P1-8 — "CI 对预埋违规报红"): - Route violation: planted /shell/test-violation/page.tsx → check:routes exits 1 with "unregistered route" error; reverted → PASS - Codegen violation: planted non_existent_field in GetTeacherDashboard → check:codegen exits 1 with "Cannot query field" error; reverted → PASS - Page count: baseline=13, deleting any page.tsx triggers FAIL - Clean state: all 3 checks PASS (10 routes, 28 EXACT, 24 ghost entries informational, 13 pages, codegen 3 outputs SUCCESS) Refs: ARCHITECTURE.md §5.3, §10 P1-8, §11.6, §11.7 红线 #5	2026-07-22 15:57:58 +08:00

Author

SHA1

Message

Date

SpecialX

2f8f3f3855

feat(portal-shell): grades 模块 5 页迁移（教师域 §9.1 B2）

§9.1 B2 grades 行：/grades、/entry、/analytics、/stats、/report-card
契约：grade(id) ✅ 真实查询；列表/分析/统计/成绩单 → MSW 兜底

新增文件：
- src/lib/api/grades.ts (6 hooks)
- src/lib/api/operations/grades.graphql.ts (6 documents)
- src/features/teacher/grades/ (7 files: transformations + tests + 5 clients)
- src/app/shell/teacher/grades/ (5 page.tsx + loading.tsx + error.tsx)

修改文件：
- src/mocks/graphql-data.ts (5 mock 常量 + 6 handler cases)
- src/messages/{zh-CN,en}.json (grades i18n)
- src/lib/api/{index,operations/index}.ts (导出 grades)
- scripts/check-page-count.ts (baseline 26 → 31)

DoD 验收（§11.3 11 项）：
- typecheck 0 errors
- lint 0 errors
- vitest 357 tests passed
- lint:tokens 0 errors
- check:pages 31 PASS

关联：ARCHITECTURE.md §5.3 / §5.4 / §9.1 / §10 P2 / §11.3 / §11.4

2026-07-22 18:41:55 +08:00

SpecialX

081cb5fbc3

feat(portal-shell): homework 模块 7 页迁移（教师域 §9.1 B2）

§9.1 教师域 homework 模块完整迁移（继 exams 之后第二个 B2 模块）：

7 页路由结构（与旧 teacher-portal 同构）：
- /shell/teacher/homework：列表页（?classId/status/q 筛选）
- /shell/teacher/homework/new：布置作业表单页
- /shell/teacher/homework/[id]：详情 + 内联批改（含提交列表 + recordGrade 表单）
- /shell/teacher/homework/submissions：跨作业提交评审列表
- /shell/teacher/homework/submissions/[submissionId]：单份提交批改 + AI 建议 + 上下份导航
- /shell/teacher/homework/submissions/[submissionId]/scan-grading：扫描批改工作台（三栏）
- /shell/teacher/homework/assignments/[id]/submissions：按作业批量批改 + 统计 + AI 批量评分

数据契约（混合）：
- ✅ homework(id: ID!) 真实查询（schema 已就绪，详情页用）
- ❌ 列表/mutation/submissions/grading/aiBatchGrading 全部 @contract-pending MSW 兜底
  · 9 个 hook 走 MSW，待后端补齐 mutation 后切换真实 fetcher

§11.3 DoD 11 项验收：
1. route-permissions：EXACT + PREFIX 表 /shell/teacher/homework 已配置
2. 页面模板：list/new 用 ListPageShell/FormPageShell；detail/grading 用 DetailPageShell；
   scan-grading 用 WorkbenchPageShell（三栏，未使用 emptyNode）
3. 三态：loading(Skeleton)/error(errorNode 或 errorSummary)/empty(emptyNode) 全实现
4. lib/api hooks：homework.ts 10 个 hooks（useHomework 真实 + 9 个 MSW）
5. @contract-pending MSW：graphql-data.ts 扩展 6 块 mock + 10 个 switch case
6. i18n：homework 节点扩展 8 个分区共 130+ keys（list/detail/new/submissions/grading/
   scan/assignment/error）中英对齐
7. lint：0 errors（4 warnings 在 __generated__）
8. lint:tokens：0 errors
9. notify：mutation 反馈走 @/shared/lib/notify（非 sonner 直引）
10. vitest：transformations 纯函数单测齐全，全量 323/323 通过（新增 ~50 测试）
11. typecheck：0 errors（noUncheckedIndexedAccess 安全访问）

附带修复：
- 修复 2 处遗留 broken link：
  · widgets/sidebar/quick-actions: /homework/new → /shell/teacher/homework/new
  · widgets/topbar/global-search: /homework → /shell/teacher/homework
- scripts/check-page-count.ts baseline 同步 13 → 26（与 exams 6 + homework 7 一致）

剩余模块：grades(5)+lesson-plans(6)+questions(1)+textbooks(2)+attendance(4)+classes(3)+
students(1)+course-plans(2)+elective(3)+error-book(1)+diagnostic(2)+analytics(2)+ai-*(3)+
knowledge-graph(1)+practice(1)+schedule-changes(1)+leave(1) 共 39 页。

2026-07-22 18:11:15 +08:00

SpecialX

7c511e74bd

feat(portal-shell): add CI structural checks for routes, pages, codegen (P1-8)

ARCHITECTURE.md §10 P1-8: three structural checks wired into CI to
prevent regressions identified in the §1.3 audit.

Scripts (apps/portal-shell/scripts/):
- check-route-table.ts: scans src/app/shell/**/page.tsx, parses
  route-permissions.ts (EXACT/PREFIX/DASHBOARD/PUBLIC_ROUTES), fails
  if any actual /shell/* route is unregistered. Reports ghost entries
  (EXACT declarations without page.tsx) as informational.
- check-page-count.ts: asserts total page.tsx >= 13 and per-category
  minimums (dashboards/login/root/forbidden/catch-all/dev-templates).
- check-codegen.ts: runs pnpm run codegen, fails if any output with
  skipDocumentsValidation:false has operations referencing non-existent
  schema fields (currently enforces dashboard-types.ts output from P1-7).

npm scripts: check:routes / check:pages / check:codegen / check:all

CI: .github/workflows/ci.yml quality-ts job — new "Portal-shell
structural checks (P1-8)" step between typecheck and test.

Acceptance (ARCHITECTURE.md §10 P1-8 — "CI 对预埋违规报红"):
- Route violation: planted /shell/test-violation/page.tsx → check:routes
  exits 1 with "unregistered route" error; reverted → PASS
- Codegen violation: planted non_existent_field in GetTeacherDashboard →
  check:codegen exits 1 with "Cannot query field" error; reverted → PASS
- Page count: baseline=13, deleting any page.tsx triggers FAIL
- Clean state: all 3 checks PASS (10 routes, 28 EXACT, 24 ghost entries
  informational, 13 pages, codegen 3 outputs SUCCESS)

Refs: ARCHITECTURE.md §5.3, §10 P1-8, §11.6, §11.7 红线 #5

2026-07-22 15:57:58 +08:00

3 Commits