17 Commits

Author	SHA1	Message	Date
SpecialX	4da9194a5e	feat(ai): V2 深度增强 — SSE 流式/全局助手/内容安全/多角色覆盖 ... 对标 Khanmigo/Duolingo Max/Squirrel AI/Century Tech 实现： - SSE 流式响应：createAiChatCompletionStream AsyncGenerator + /api/ai/chat/stream SSE 端点 + useAiChatStream hook（AbortController 停止生成 + localStorage 持久化） - Markdown 渲染：AiMarkdownRenderer（react-markdown + remark-gfm + 代码块/表格/列表 + hover 复制按钮） - 全局 AI 助手：AiAssistantWidget 浮动按钮 + Sheet 侧抽屉 + usePathname 路由推断上下文（7 类场景系统提示）+ dashboard layout 全局注入 AiClientProvider - 内容安全：content-safety.ts 多层过滤（输入/输出安全过滤 + 每日限制 student 50/teacher 200/parent 30/admin 500 + 学生苏格拉底模式），COPPA/FERPA K12 合规 - 多角色 AI 覆盖：家长端 AiChildSummary（学情摘要）+ 管理员端 AiUsageDashboard（使用监控）+ 学生端 AiStudyPath（个性化学习路径） - i18n 修复：8 处错误键引用 + zh-CN/en ai.json 全面扩展 - 架构文档 004/005 同步更新	2026-06-23 01:34:37 +08:00
SpecialX	21c5eba96c	feat(ai): 新增 AI 模块并集成至备课/错题集/试卷/改题四大业务场景 ... - 新增 src/modules/ai 独立模块，遵循三层架构（actions → services → shared/lib/ai） - 通过 AiClientProvider + useAiClient 实现 React Context 依赖注入，业务组件零直接 import - 6 个 Server Actions 均调用 requirePermission() 权限校验，返回 ActionState<T> - withAiTracking 统一埋点，覆盖 chat/similar_question/grading_assist/lesson_content/question_variant/weakness_analysis - 集成场景：作业批改 AiGradingAssist、错题集 AiErrorBookAnalysis、备课 AiLessonContentGenerator、试卷 AiQuestionVariantGenerator - 全量 i18n（en/zh-CN ai.json），Error Boundary + Skeleton 边界处理 - 同步架构图 004/005，新增审计报告 ai-module-audit-report.md	2026-06-23 00:52:39 +08:00
SpecialX	682d385ee2	fix(dashboard): v3 审计修复 — 数据完整性、i18n、类型安全、死代码清理 ... P0 修复（严重）: - admin ContentRow 标签与值错配（stats.users→textbooks 等 6 处） - admin/error.tsx 硬编码中文替换为 useTranslations - UserGrowthChart 空数据时渲染 EmptyState（userGrowth/homeworkTrend 永远为空数组） P1 修复（高）: - 新增 admin/dashboard 和 student/dashboard 的 loading.tsx + error.tsx - 抽取 DashboardLoadingSkeleton 和 DashboardErrorFallback 共享组件，消除 5 套重复文件 - formatDate/formatLongDate 传入用户 locale（admin/teacher/student 共 6 个组件） - 移除死代码：getCachedAdminDashboard、AvatarImage src={undefined}、TeacherStats isLoading prop - filterTodaySchedule 改为泛型函数，消除 as 类型断言 - 辅助函数 getStatus/getDueUrgency 新增显式返回类型 - UserGrowthChart 新增 labelKey prop 区分用户增长/作业提交趋势标签 P2 修复（中）: - 4 个组件从客户端转为服务端组件（DashboardGreetingHeader、TeacherQuickActions、TeacherDashboardHeader、StudentDashboardHeader） - Student dashboard 空状态新增 CTA（viewSchedule、viewAll） - TeacherHomeworkCard 图标按钮新增 aria-label - TeacherTodoCard 排序逻辑重写为可读的 if/return 模式 同步更新: - docs/architecture/005_architecture_data.json 新增 DashboardLoadingSkeleton、DashboardErrorFallback 条目 - 新增 docs/architecture/audit/dashboard-audit-report-v3.md 审计报告 - dashboard.json 新增 6 个 i18n 键（textbooks/chapters/questions/exams/totalAssignments/totalSubmissions）	2026-06-22 18:36:46 +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	868ac5f9cf	feat(dashboard): 仪表盘模块审计重构 — 权限校验 + i18n + 逻辑抽离 ... 基于 dashboard-audit-report.md 审计结论，对仪表盘模块进行 P0/P1 级修复： - 新增 4 个 dashboard 权限点（DASHBOARD_ADMIN/TEACHER/STUDENT/PARENT_READ），补充到 permissions.ts 和角色-权限映射 - 新建 actions.ts：4 个 Server Action 均调用 requirePermission() 校验权限，消除 admin 页面零鉴权、teacher/student/parent 仅 requireAuth 的安全隐患 - 根重定向页 /dashboard 改用 resolvePermissions() + 权限点判断，不再 role === xxx 硬编码 - 新建 lib/dashboard-utils.ts：抽取 toWeekday / countStudentAssignments / sortUpcomingAssignments / filterTodaySchedule / computeTeacherMetrics / getGreetingKey 纯函数，与 UI 分离，便于单测 - 新建 messages/{zh-CN,en}/dashboard.json 翻译文件，i18n request.ts 加载 dashboard 命名空间；所有视图组件接入 useTranslations / getTranslations，消除中英混杂硬编码 - 重构 4 个角色 page.tsx：通过 actions 获取数据，generateMetadata 使用 i18n - 同步更新架构图 004 / 005 文档（dashboard exports / permissions / 文件清单）	2026-06-22 15:50:56 +08:00
SpecialX	5ff7ab9e72	fix(teacher): 统一详情页返回路径与中英文文案 (P1-3+P2-1) ... P1-3: empty-state 默认按钮 variant 改为 outline 并新增 variant prop；button.tsx 导出 ButtonProps；统一 5 个详情页返回路径为 ghost+ArrowLeft+文字标签；course-plan-detail raw a 改为 Link。P2-1: formatLongDate 默认 locale 改为 zh-CN，weekday 改为 short；返回按钮文案中文化；course-plan-detail 全量中文化；grades/analytics 标题中文化。验证：tsc 0 错误，lint 0 错误，架构图 004/005 已同步。	2026-06-22 13:52:26 +08:00
SpecialX	978d9a8309	feat: 新增备课模块并修复全模块 P0/P1/P2 缺陷 ... 主要变更: - 新增 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	49291fcc31	refactor: fix all P0/P1/P2 bugs and architecture issues ... Bug fixes (from bugs/ directory): - Fix cross-module DB queries in 9 modules (homework, grades, parent, diagnostic, elective, proctoring, notifications, scheduling, classes) by routing through data-access functions - Fix shared/lib <-> auth circular dependency via new session.ts module - Fix divide-by-zero guard in grades data-access - Fix audit export data truncation (paginated fetch for full datasets) - Fix missing transactions in homework grading and elective lottery - Fix missing revalidatePath in course-plans actions - Fix frontend permission checks using requirePermission instead of requireAuth - Fix dashboard role routing using session.user.roles - Fix student auth pattern (migrate getDemoStudentUser to users module) - Fix ActionState return type handling in components Code quality fixes: - Remove 60+ as type assertions (replace with type guards) - Remove non-null assertions (use optional chaining or explicit checks) - Convert dynamic imports to static imports (grades, diagnostic) - Add React.cache() wrapping for read functions - Parallelize independent queries with Promise.all - Add explicit return types to 30+ arrow functions - Replace any with unknown + type guards - Fix import type for type-only imports - Add Zod validation schemas for classes and diagnostic modules - Extract duplicate code (normalizeRoleName, normalizeBcryptHash, logger IP extraction) - Add console.error to silent catch blocks - Fix permission naming consistency (exam:proctor_read -> exam:proctor:read) Architecture doc sync: - Update 004_architecture_impact_map.md and 005_architecture_data.json - Update management-modules-audit.md for P0-7 cross-module fix Moved deleted proctoring event route to deletes/ folder.	2026-06-19 05:13:34 +08:00
SpecialX	6588f7484f	refactor: P2-2 拆分 ai.ts 为 5 类职责 (payload-parser/api-key-crypto/provider-config/client/errors)	2026-06-18 02:43:18 +08:00
SpecialX	2c8e229e00	refactor: P1-3/4/6 解耦修复 - 拆分 auth/users 文件 + notifications 反向依赖	2026-06-18 02:21:44 +08:00
SpecialX	220061d62e	refactor: P0-3/5/6 解耦修复 - 循环依赖/通知分发/课表写入口 ... P0-3: 修复 shared/lib <-> auth 循环依赖 - audit-logger.ts, change-logger.ts, auth-guard.ts, classes/data-access.ts 改用动态 import("@/auth") 打破静态模块级循环依赖 - shared/lib 不再静态导入 @/auth P0-5: messaging 改用 notifications dispatcher - messaging/actions.ts 的 sendMessageAction 改用 sendNotification 替代直接调用 createNotification - 用户通知偏好(SMS/微信/邮件/站内)现在被正确尊重 P0-6: 统一 classSchedule 写入口到 scheduling/data-access - 新增 insertClassScheduleItem/updateClassScheduleItemById/ deleteClassScheduleItemById/replaceClassSchedule 统一写入函数 - classes/data-access.ts 的三个 schedule 写入函数委托给 scheduling - scheduling/actions.ts 的 applyAutoScheduleAction 改用 replaceClassSchedule - 移除 scheduling/actions.ts 中不再使用的 classSchedule/createId 导入 验证: tsc --noEmit 0 errors, npm run lint 0 errors	2026-06-17 23:44:02 +08:00
SpecialX	6585e10c6f	feat(P2): 实现质量保障类5项功能(无障碍/视觉回归/通知渠道/漏洞扫描/灾备) ... ## 新增功能 ### 1. 屏幕阅读器兼容性增强（a11y） - 无障碍工具库：src/shared/lib/a11y.ts - aria-live Hook：src/shared/hooks/use-aria-live.ts - a11y 组件：skip-link/visually-hidden/focus-trap/aria-status - 增强 UI：table.tsx 系统性 ARIA role，dialog.tsx aria-modal - 审计文档：docs/accessibility/a11y-audit.md（WCAG 2.1 AA 清单） ### 2. 视觉回归测试 - 测试套件：tests/visual/（homepage + 3 个 dashboard） - 3 视口（desktop/tablet/mobile）× 2 主题（light/dark） - 动态元素遮罩，避免误报 - playwright.config.ts 新增 visual-chromium 项目 - 文档：docs/testing/visual-regression.md ### 3. 短信/微信推送渠道集成 - 新模块：src/modules/notifications/ - 4 个渠道：SMS（阿里云/腾讯云）、WeChat（公众号）、Email（SMTP）、In-App - 分发器按用户偏好并行多渠道发送 - 外部 SDK 动态 import，Mock 模式开发可用 - 文档：docs/notifications/channels.md ### 4. 漏洞扫描 CI 集成 - CI security-scan job：npm audit + Snyk + Trivy FS + OWASP ZAP - 独立工作流 security.yml：每周一深度扫描 + 容器镜像扫描 - 配置：suppressions.json + .trivyignore - 本地脚本：security-scan.sh/ps1 - 文档：docs/security/scanning.md（SLA 分级） ### 5. 灾备方案 - 脚本：backup-verify/backup-offsite-sync/dr-drill/failover/health-check - CI 增强：备份后校验+异地同步，每周灾备演练 - 独立工作流 dr-drill.yml：每周一凌晨 4 点自动演练 - 文档：docs/dr/dr-plan.md（RTO 4h/RPO 24h）+ dr-runbook.md（6 故障场景） ## 验证 - npx tsc --noEmit：0 错误 - npm run lint：0 错误 0 警告	2026-06-17 20:18:29 +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
SpecialX	3b6272c99d	feat: 完成 P1 全部功能 + 修复 proxy 导出 + 切换 MySQL 端口至 14013 ... ## P1 功能（20 项） - 站内消息系统、家长仪表盘、学生考勤管理 - Excel 导入导出、用户批量导入、成绩导出 - 排课规则+自动排课+课表调整 - 成绩趋势+对比分析、密码安全策略、速率限制 - 数据变更日志、文件预览+存储策略、全文检索 - 依赖审计集成 CI、数据库定时备份、E2E 测试完善 - 通知偏好管理 ## 基础设施修复 - src/proxy.ts: 将 middleware 导出重命名为 proxy（Next.js 16 要求） - .env: MySQL 端口从 13002 切换至 14013 - scripts/create-db.ts: 新增数据库初始化脚本 ## 架构文档同步 - 004_architecture_impact_map.md 和 005_architecture_data.json 完整记录所有新增表、模块、路由、权限、依赖关系	2026-06-17 13:44:37 +08:00
SpecialX	125f7ec54c	refactor: RBAC权限系统重构 + UI组件拆分 + 测试修复 + 架构文档 ... - RBAC: 新增30个权限点、DataScope行级权限、requirePermission守卫，所有57+ Server Action接入权限校验 - UI拆分: exam-form(1623行→11文件)、textbook-reader(744行→7文件)，均降至300行以内 - 测试: 新增5个单元测试文件(19用例)，修复4个集成测试文件(38用例全部通过) - 架构文档: 新增架构影响地图(004/005)、标准功能清单(006)、差距审计报告(007) - 项目规则: 架构图优先规则，改码必同步图 - 安全: rehype-sanitize净化、AES加密API Key、权限路由守卫 - 无障碍: skip-link、aria-label、prefers-reduced-motion - 性能: next/font优化、next/image、代码分割	2026-06-16 23:38:33 +08:00
SpecialX	99f116cb64	=test_update_homework_tests_and_work_log	2026-03-19 13:16:49 +08:00
SpecialX	e7c902e8e1	Module Update	2025-12-30 14:42:30 +08:00