SpecialX
|
97e59b95a1
|
refactor(lesson-preparation): V2 审计深度修复 — Server Actions i18n + 错误码模式 + 类型断言清零 + a11y 深度修复 + Tracker 埋点接入
V2-1: 12 个 Server Action 通过 getTranslations 翻译错误消息；Service/DataAccess 层抛出错误码异常（PublishServiceError/LessonPlanDataError），Actions 层通过 PUBLISH_ERROR_KEY_MAP 翻译为 i18n 消息
V2-2: SYSTEM_TEMPLATES name/title 改为 i18n 键，createLessonPlan 接受 translateTitle 函数在服务端翻译后存储到 DB
V2-3: 8 处 as unknown as 断言替换为显式类型映射函数（mapRowToLessonPlan/mapRowToListItem/mapRowToTemplate/mapRowToVersion）+ 类型守卫（isLessonPlanStatus/isTemplateType/isTemplateScope）
V2-4: MiniMap nodeColor 复用 lib/node-summary.ts 的 getNodeColor
V2-5: a11y 深度修复 — lesson-plan-filters/exercise-block/inline-question-editor 的 select 添加 label htmlFor 关联；exercise-block 题目列表改为 ul/li；node-editor 画布添加 role=application + 键盘导航配置
V2-6: Tracker 埋点接入 — 新增 useLessonPlanTrackerSafe hook，在 create/save/publish/revert/duplicate/archive 6 处调用 tracker.track
同步更新架构图 004 和 005 文档
|
2026-06-22 18:45:35 +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
|
e997abaf5e
|
refactor(dashboard): V2 审计重构 — i18n 补齐 + 共享抽象 + 单测 + a11y
V2 审计报告（docs/architecture/audit/dashboard-audit-report-v2.md）发现并修复：
- P0 i18n：10 个子组件硬编码字符串全部接入 next-intl（teacher-quick-actions /
teacher-classes-card / teacher-homework-card / teacher-schedule /
recent-submissions / teacher-grade-trends / student-grades-card /
student-today-schedule-card / student-upcoming-assignments-card /
admin-dashboard），新增 ~50 个翻译键
- P1 共享抽象：新增 DashboardGreetingHeader 组件，消除 teacher/student
头部 90% 重复代码，两个 Header 改为薄包装
- P2 单测：为 6 个纯函数添加 31 个单元测试
（tests/integration/dashboard/dashboard-utils.test.ts）
- P2 a11y：admin 表格 caption、teacher/student 视图语义化标签
（header / section aria-label / aside aria-label）
- 同步架构图 004/005
|
2026-06-22 17:01:00 +08:00 |
|
SpecialX
|
20691f53ce
|
feat(lesson-preparation): 备课模块审计重构 — 跨模块解耦 + i18n + 纯函数抽取 + 错误边界
P0-1 跨模块直查修复：publish-service 不再直查 examQuestions 表，新增 exams/data-access.addExamQuestions 接口，复用 classes/data-access.getStudentIdsByClassIds
P0-2 i18n 接入：新增 zh-CN/en 翻译文件，注册 lessonPreparation 命名空间，17 个组件改造为 useTranslations/getTranslations
P1 纯函数抽取：lib/document-migration.ts（类型守卫替代 as 断言）、lib/node-summary.ts（翻译函数注入）、lib/rf-mappers.ts
P1 错误边界+骨架屏：新增 LessonPlanErrorBoundary 和 4 个 Skeleton 组件
P1 Block 注册表：新增 config/block-registry.tsx（BlockRenderer 组件），node-edit-panel 重构为配置驱动渲染
P1 其他修复：exercise-block 改用 router.refresh()，node-editor/lesson-node 复用 lib/ 纯函数
架构图同步：更新 004 和 005 文档
Refs: docs/architecture/audit/lesson-preparation-audit-report.md
|
2026-06-22 16:17:58 +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 |
|