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
|
dca25fc42f
|
feat(portal-shell): exams 三子页面迁移（analytics/build/edit）
§9.1 教师域 exams 模块补完（继 d066da5 列表/详情/表单后）：
- /shell/teacher/exams/[id]/analytics：详情页（图表）- 混合契约
· 基础统计 ✅ assignmentAnalysis（data-ana 子图，schema 已就绪）
· 扩展字段（排名/每题正确率）❌ MSW 兜底（@contract-pending）
· 含 Summary/Distribution/QuestionAccuracy/Rankings 四区
- /shell/teacher/exams/[id]/build：工作台页（组卷）@contract-pending
· 三栏：题库候选 / 已选题目 / 预览
· 支持搜索/类型/难度筛选，添加/移除/上移/下移/改分
- /shell/teacher/exams/[id]/edit：工作台页（富文本试卷）@contract-pending
· contentEditable + 工具栏（B/I/U/H1-H3/列表）
· 右栏试卷属性面板
§11.3 DoD 11 项验收：
1. route-permissions：PREFIX 表 /shell/teacher/exams/ 已覆盖
2. 页面模板：analytics 用 DetailPageShell；build/edit 用 WorkbenchPageShell
3. 三态：loading/error/empty 均实现（workbench 用 errorNode 合并 empty）
4. lib/api hooks：useExamAnalytics/useExamBuild/useQuestionsLibrary/
useSaveExamBuild/useExamRichEditor/useSaveExamRichContent 6 个
5. @contract-pending MSW 模式：graphql-data.ts 扩展 6 个 case
6. i18n：analytics(19 keys)+build(28 keys)+edit(13 keys) 中英对齐
7. lint：0 errors（4 warnings 在 __generated__）
8. lint:tokens：0 errors
9. notify：success/error/warning 走 @/shared/lib/notify（非 sonner 直引）
10. vitest：transformations 新增 10 函数 22 测试，全量 273/273 通过
11. typecheck：0 errors（noUncheckedIndexedAccess 安全 swap 写法）
剩余：proctoring 标注"二期 WS"按 §9.1 暂缓。
|
2026-07-22 17:38:51 +08:00 |
|
SpecialX
|
d066da563f
|
feat(portal-shell): 教师域考试管理页面迁移（P2）
按 ARCHITECTURE.md §9.1/§10 P2 要求，迁移教师域 exams 模块：
- 列表页 /shell/teacher/exams（ListPageShell + URL 状态 + 客户端二次筛选）
- 详情页 /shell/teacher/exams/[id]（DetailPageShell + 真实 exam(id) 查询）
- 新建页 /shell/teacher/exams/new（FormPageShell + MSW 兜底）
- 纯函数 transformations.ts + 19 个 vitest 单测
- @contract-pending：exams(classId) 列表查询、createExam mutation 走 MSW
- 三态 UI（loading/error/empty）+ 路由级 loading.tsx/error.tsx
- i18n：zh-CN/en 双语补全，无硬编码中文
- MSW handlers 支持 variables 透传
§11.3 DoD 验收：
- lint: 0 errors（4 个 __generated__ 预存警告）
- typecheck: 0 errors
- test: 250/250 passed（含 19 个新增 transformations 测试）
- lint:tokens: 0 errors
|
2026-07-22 17:02:05 +08:00 |
|