SpecialX
|
e2e0487a3b
|
feat(attendance,elective): 实现所有 P2 长期改进项
P2 修复（来自审计报告）：
- 2.4.4: Server Action 错误消息 i18n 化（attendance/elective 全部 Action）
- 2.5.3: 抽取 AttendancePageLayout 组件复用（admin/teacher 页面）
- 2.5.4: 抽取 ElectivePageLayout 组件复用（admin/teacher 列表页）
- 2.6.3: 考勤月历键盘导航（tabIndex + 方向键 + Home/End + role=grid）
- 2.8.2: getStudentAttendanceSummary 分页优化（SQL 聚合统计 + LIMIT 分页）
- 2.8.3: resolveCourseDisplayNames 缓存优化（React cache 去重）
- 2.1.4: elective data-access 跨模块依赖接口抽象（resolvers.ts 可注入）
P2 建议项：
- 选课时间冲突检测（parseSchedule + isScheduleConflict 纯函数 + checkScheduleConflict）
- 学分上限校验（MAX_CREDIT_PER_TERM + checkCreditLimit）
- 考勤/选课数据导出 Excel（export.ts + API 路由扩展）
新增文件：
- src/modules/attendance/components/attendance-page-layout.tsx
- src/modules/elective/components/elective-page-layout.tsx
- src/modules/elective/resolvers.ts
- src/modules/attendance/export.ts
- src/modules/elective/export.ts
校验：
- npm run lint 通过（exit 0）
- npx tsc --noEmit attendance/elective/parent 相关零错误
|
2026-06-23 09:02:41 +08:00 |
|
SpecialX
|
f62b8c0f86
|
refactor(attendance,elective): 审计第二轮 — 全量完成 P0/P1 改进项
P0 修复：
- 页面层 i18n 全量补齐（admin/teacher/parent/student × attendance/elective）
- types.ts 状态标签常量迁移至 constants.ts（i18n key + Badge variant）
- 修复 getTranslations 导入路径（next-intl → next-intl/server）
P1 改进：
- 解耦 parent 模块对 attendance 类型的直接依赖（本地 view-model 类型）
- 导出纯函数（computeStats/buildWarnings/buildLotteryRankCase 等）
- 统一空状态为 EmptyState 组件
- 清理死代码读 Action（attendance 5 个 + elective 3 个）
- 预留监控埋点接口（trackEvent 13 个新事件名）
- 补齐骨架屏 loading.tsx（8 个页面）
- AlertDialog 替换 window.confirm（student-selection-view）
- a11y 改进（aria-label/role/键盘导航）
修复：
- AttendanceStatus 从 constants.ts 重导出，消除 types/constants 双源混乱
- buildWarnings 的 Translator 类型改用 ReturnType<typeof useTranslations>
|
2026-06-22 17:33:29 +08:00 |
|
SpecialX
|
4833930834
|
feat(attendance,elective): 考勤与选修课模块审计重构 — P0 修复 + i18n + Error Boundary
审计报告：docs/architecture/audit/attendance-elective-audit-report.md
P0 修复：
- attendance: getAttendanceStats 统计失真（仅基于前 20 条记录）改为 SQL 聚合查询
- attendance: getClassStudentsForAttendance 跨模块直查 classEnrollments 改为调用 classes data-access
- attendance: update/delete Action 新增资源归属校验（assertRecordOwnership）
- elective: update/delete/openSelection/closeSelection/runLottery Action 新增资源归属校验（assertCourseOwnership）
i18n 接入：
- 新增 attendance/elective 命名空间（zh-CN + en）
- attendance-stats-cards 接入 useTranslations
- elective-course-list/form 接入 useTranslations
类型安全（P1）：
- elective-course-form: 移除 as 断言，改用类型守卫 isSelectionMode
- elective-course-list: 移除 null as never 类型逃逸，改用泛型
Error Boundary：
- 新增 admin/teacher attendance error.tsx
- 新增 admin/student elective error.tsx
架构图同步：
- 004: 修正 attendance/elective/parent 章节的导出函数、文件清单、已知问题
- 005: 修正 actions 的 usedBy（标记无调用方的死代码）、新增 issues 字段、更新依赖矩阵
|
2026-06-22 16:17:00 +08:00 |
|
SpecialX
|
978d9a8309
|
feat: 新增备课模块并修复全模块 P0/P1/P2 缺陷
Security / deep-security-scan (push) Failing after 20m5s
DR Drill / dr-drill (push) Failing after 1m31s
CI / scheduled-backup (push) Failing after 1m31s
CI / backup-verify (push) Has been skipped
CI / weekly-dr-drill (push) Failing after 0s
CI / build-deploy (push) Has been cancelled
CI / security-scan (push) Has been cancelled
主要变更:
- 新增 lesson-preparation 模块: 备课编辑器、节点编辑、AI 建议、知识点选择、版本历史、作业发布
- 新增 shared 通用组件: charts/question-bank-filters/schedule-list/ui (chip-nav/filter-bar/page-header/stat-card/stat-item)
- 新增 student/admin 端 loading.tsx 与 error.tsx, 优化加载与错误态体验
- 新增 teacher/lesson-plans 页面 (列表/新建/编辑)
- 新增 drizzle 迁移 0002_tiny_lionheart 及 snapshot
- 新增 textbooks/schema.ts 与 exams/utils/normalize-structure.ts
- 修复 Tiptap v3 SSR hydration 崩溃 (rich-text-block immediatelyRender: false)
- 重构多模块 data-access/actions/组件, 修复权限校验与类型规范
- 同步架构文档 004/005 反映新增模块、导出、依赖关系
- 归档 bugs/* 测试报告与 e2e 测试脚本 (admin/parent/student/teacher web_test)
|
2026-06-22 01:06:16 +08:00 |
|
SpecialX
|
b86255f0ea
|
feat(P2): 实现选课管理、考试监考、学情诊断三大功能模块
## 新增功能模块
### 1. 选课管理（elective）
- 新增表：electiveCourses、courseSelections
- 新增权限：ELECTIVE_MANAGE/ELECTIVE_READ/ELECTIVE_SELECT
- 支持先到先得 + 抽签两种选课模式
- admin/teacher/student 三端页面
### 2. 考试监考（proctoring）
- exams 表扩展：examMode/durationMinutes/antiCheatEnabled 等字段
- 新增表：examProctoringEvents
- 新增权限：EXAM_PROCTOR/EXAM_PROCTOR_READ
- 教师监考面板 + 学生端防作弊监控
- API：/api/proctoring/event 接收事件上报
### 3. 学情诊断报告（diagnostic）
- 新增表：knowledgePointMastery、learningDiagnosticReports
- 新增权限：DIAGNOSTIC_MANAGE/DIAGNOSTIC_READ
- 基于提交答案自动计算知识点掌握度
- 生成个人/班级诊断报告（强项/弱项/建议）
- 雷达图可视化
## 其他改动
- 项目规则：单文件行数限制从 300 行调整为企业级规范（组件≤500/Actions≤800/硬上限1000）
- scripts/seed.ts：消除全部 any 类型，定义内部类型，0 lint 错误
- 架构文档 004/005 同步更新三个新模块
- 迁移文件 0001_heavy_sage.sql 生成
## 验证
- npx tsc --noEmit：0 错误
- npm run lint：0 错误 0 警告
|
2026-06-17 19:12:51 +08:00 |
|