diff --git a/docs/architecture/004_architecture_impact_map.md b/docs/architecture/004_architecture_impact_map.md
index 568c06f..96db0ca 100644
--- a/docs/architecture/004_architecture_impact_map.md
+++ b/docs/architecture/004_architecture_impact_map.md
@@ -286,6 +286,105 @@ V5 状态管理统一的后续阶段，针对两类高频性能问题进行细
 
 ---
 
+## 1.1.6 缓存策略落地专项重构（2026-07-05 新增）
+
+> **目标**：全栈缓存策略一致性重构 — 服务端 `cacheFn` 双层包装 + 集中式 `INVALIDATION_MAP` 失效编排 + 客户端 `queryKeys` 工厂 + `useActionQuery`/`useActionMutation` 向后兼容双模式 Hook。
+
+### 架构总览
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  Client（TanStack Query + useActionQuery/useActionMutation）        │
+│  queryKeys.{module}.{resource}(...args) → queryKey                  │
+│  useActionMutation({ mutationFn, actionId, params })               │
+│     → 成功后按 CLIENT_INVALIDATION_MAP[actionId].queryKeys 自动失效 │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               │ mutationFn = Server Action
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  Server Actions（编排层）                                          │
+│  mutation 成功分支末尾：                                            │
+│    await invalidateFor("module.action", { id })                    │
+│     → 1) CacheStore.invalidateTags  2) revalidateTag × N  3) revalidatePath × N │
+└──────────────────────────────┬──────────────────────────────────────┘
+                               │ 调用 data-access
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  Data-access（数据访问层）                                         │
+│  export const fnRaw = async (...) => { ... }                        │
+│  export const fn = cacheFn(fnRaw, { tags, ttl, keyParts })          │
+│     → 外层 react.cache（请求级 memoization）                        │
+│     → 内层 cacheStore.getOrSet（跨请求/跨实例，按 tag 失效）          │
+└─────────────────────────────────────────────────────────────────────┘
+                               │
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  CacheStore（CACHE_DRIVER 切换）                                   │
+│  memory（默认，单实例，Map + LRU + tag 反查索引）                    │
+│  redis（@upstash/redis，多实例共享，故障降级）                       │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 核心基础设施（9 个文件）
+
+| 文件 | 职责 |
+|------|------|
+| `shared/lib/cache/types.ts` | `CacheFnOptions` / `CacheStore` / `InvalidationRule` 接口 |
+| `shared/lib/cache/memory-store.ts` | `MemoryCacheStore`（Map + LRU maxEntries=500 + tag 反查索引） |
+| `shared/lib/cache/redis-store.ts` | `RedisCacheStore`（key=`next-edu:cache:{key}`，故障降级） |
+| `shared/lib/cache/store-factory.ts` | `getCacheStore()` 单例工厂（按 `env.CACHE_DRIVER` 切换） |
+| `shared/lib/cache/cache-fn.ts` | `cacheFn` 双层包装器（外层 react.cache + 内层 cacheStore.getOrSet） |
+| `shared/lib/cache/invalidation-map.ts` | `INVALIDATION_MAP` 集中式失效映射（203 个 actionId）+ `fillTemplate` |
+| `shared/lib/cache/client-invalidation-map.ts` | `CLIENT_INVALIDATION_MAP` 客户端可见子集（仅 queryKeys） |
+| `shared/lib/cache/invalidate.ts` | `invalidateFor` 三步编排函数 |
+| `shared/lib/cache/index.ts` | barrel re-export |
+| `shared/lib/redis-client.ts` | 共享 Redis 单例（rate-limit + cache 共用） |
+| `shared/lib/query-keys.ts` | 客户端 queryKey 工厂（`queryKeys.classes.*`） |
+
+### 迁移覆盖范围（28 个模块全部完成）
+
+**data-access 层迁移至 `cacheFn`**（83 个文件，250+ 个查询函数）：
+
+| 组别 | 模块 | 文件数 | 备注 |
+|------|------|--------|------|
+| 标杆 | classes | 5 | `data-access-{teacher,admin,students,stats,schedule}.ts` |
+| A | users / school / rbac / textbooks / questions / course-plans / files / dashboard / parent / proctoring | 11 | 77 个函数 |
+| B | exams / grades / homework / diagnostic / error-book / adaptive-practice | 8 | 含跨模块接口 |
+| C | lesson-preparation / elective / announcements / messaging / notifications | 6 | 24 个函数 |
+
+**actions 层迁移至 `invalidateFor`**（43 个文件，247 处 `revalidatePath` 替换）：
+
+| 组别 | 模块 | 文件数 | 替换数 |
+|------|------|--------|--------|
+| 标杆 | classes | 5 | 47 |
+| A | users / school / textbooks / questions / course-plans / standards / scheduling / audit / onboarding / invitation-codes / proctoring / i18n | 13 | 70 |
+| B | exams / grades / homework / attendance / leave-requests / diagnostic / error-book / adaptive-practice | 9 | 77 |
+| C | lesson-preparation / elective / announcements / messaging / notifications / settings / rbac | 8 | 100 |
+
+**INVALIDATION_MAP**：扩展至 **203 个 actionId**，覆盖全部 28 个模块。每个 actionId 声明 `{ tags, queryKeys, paths }` 三段副作用。
+
+### 强制规则（已通过 ESLint 落地）
+
+| 规则 | 落地方式 |
+|------|----------|
+| Server Actions 中禁止直接调用 `revalidatePath` / `revalidateTag` | `no-restricted-syntax` ESLint 规则，仅 `shared/lib/cache/invalidate.ts` 豁免 |
+| data-access 查询函数必须用 `cacheFn` 包装 | 双导出 raw 模式（`fnRaw` + `cacheFn(fnRaw, opts)`），单测可 mock |
+| 未知 actionId 必须抛错 | `invalidateFor` 内部强校验，提示更新 INVALIDATION_MAP |
+| Tag 命名规范 | `{module}` / `{module}:{resource}` / `{module}:{resource}:{id}` |
+
+### 向后兼容 Hook 双模式
+
+- **`useActionQuery`**：传 `queryKey` 走 `useQuery`（跨页共享缓存 + 自动 invalidate）；不传走旧 `useEffect + useState`（向后兼容）
+- **`useActionMutation`**：传 `mutationFn + actionId` 自动 invalidate 相关 queryKeys；旧 `mutate(action)` 模式仍可用
+
+### 验证结果
+
+- `npx tsc --noEmit`：零错误
+- `npm run lint`：零 `no-restricted-syntax` 错误（仅 3 个 pre-existing `react-hooks/refs` 错误位于未修改文件）
+- `npx vitest run src/shared/lib/cache/`：25/25 测试通过（5 个测试文件：types/memory-store/redis-store/cache-fn/invalidate/invalidation-map）
+
+---
+
 ## 1.2 模块依赖关系图
 
 下图展示模块间的实际依赖关系，**标注依赖类型与合规性**。
diff --git a/docs/architecture/005_architecture_data.json b/docs/architecture/005_architecture_data.json
index c7ce9da..1f4ce72 100644
--- a/docs/architecture/005_architecture_data.json
+++ b/docs/architecture/005_architecture_data.json
@@ -5,7 +5,7 @@
     "generatedAt": "2026-06-17",
     "formatVersion": "1.1",
     "rule": "每次文件修改后须同步更新本文件",
-    "lastUpdate": "性能预算重构专项 Phase 2-4 完成（2026-07-05）：Phase 2 Bundle 预算优化：(2.1) TipTap 三实例（exam-rich-editor/question-rich-editor/paper-editor）+ AiAssistantWidget 改 next/dynamic ssr:false + xxx-inner.tsx 拆分模式；(2.2) KnowledgeGraph 改 ReactFlowProvider 同步壳 + lazy 内部实现；(2.3) exams/editor 拆 types.ts barrel 减少服务端消费方拉入 @tiptap/* 运行时；(2.4) status-badge 移除多余 'use client'；(2.5) teacher/student/parent 角色路由补齐 loading.tsx。Phase 3 数据层优化：(3.1) getSession/getAuthContext/resolveDataScope/getSessionTeacherId 全部 React cache() 包裹实现请求级去重；(3.2) copyCoursePlanToClasses 改单事务 + 2 次 batch INSERT；(3.3) gradeHomeworkAnswers 改 UPDATE CASE WHEN 单次批量更新；(3.4) searchQuestions 改 FULLTEXT INDEX + MATCH AGAINST BOOLEAN MODE + toBooleanModeQuery 工具；(3.5) getAllUserIds 加默认 LIMIT 1000 + 分页参数；(3.6) announcements/notifications fan-out 改 createNotifications 批量 INSERT + sendBatchNotifications 并行收集；(3.7) 高 LIMIT 默认值调低（attendance/adaptive-practice/questions data-access 1000-5000→100）。Phase 4 组件渲染优化：(4.1) AssignmentCard/EmptyState/StatusBadge React.memo；(4.2) lesson-plan-editor/text-study-block/exercise-block/paper-context-menu 拆分 Zustand 细粒度 selector（避免整体订阅）；(4.3) message-detail/message-list/grade-record-list/attendance-sheet 改 useOptimistic + useTransition 乐观更新；(4.4) question-data-table/exam-data-table 接入 @tanstack/react-virtual 列表虚拟化；(4.5) sidebar-provider resize 改 debounce + useMemo；(4.6) 14 个 recharts 组件 props 提取到模块级常量避免 inline 重建；(4.7) scan-image-viewer aspect-ratio；(4.8) AiAssistantWidget inner 拆分 + 动态 import；(4.9) web-vitals-reporter.tsx 修复 Metric 类型推导（从 useReportWebVitals 签名推导）+ PerformanceEntry 类型注解 + sendBeacon/fetch keepalive fallback。架构决策：(1) 动态 import 标准模式 xxx-inner.tsx + lazy wrapper；(2) 请求级去重 > 跨请求 cache（React cache() not unstable_cache）；(3) 批量 SQL > 循环 SQL（INSERT batch + UPDATE CASE WHEN）；(4) React 19 useOptimistic 替代手动 isPending；(5) 细粒度 Zustand selector > useShallow 多字段 selector。验证：npx tsc --noEmit 零新增错误；npm run lint 零新增错误（pre-existing 3 errors + 13 warnings 均位于未修改文件）。",
+    "lastUpdate": "缓存策略落地专项重构完成（2026-07-05）：全栈缓存一致性重构，覆盖全部 28 个模块。基础设施层：新增 shared/lib/cache/ 9 个文件（types/memory-store/redis-store/store-factory/cache-fn/invalidation-map/client-invalidation-map/invalidate/index）+ 共享 redis-client.ts + 客户端 query-keys.ts 工厂。核心机制：(1) cacheFn 双层包装器 — 外层 react.cache 请求级 memoization，内层 cacheStore.getOrSet 跨请求/跨实例缓存（按 tag 失效，TTL 可选）；(2) INVALIDATION_MAP 集中式失效映射表 — 扩展至 203 个 actionId，每个声明 { tags, queryKeys, paths } 三段副作用；(3) invalidateFor 三步编排 — CacheStore.invalidateTags → revalidateTag × N → revalidatePath × N（Next.js 16 revalidateTag 第二参数必填 \"default\"）；(4) CLIENT_INVALIDATION_MAP 客户端可见子集（仅 queryKeys 字段，避免拉入 server-only 依赖）；(5) CACHE_DRIVER 环境变量切换 memory/redis driver，复用 rate-limit 模式。迁移范围：data-access 83 个文件 250+ 查询函数迁移至 cacheFn（双导出 raw + 包装版本，单测可 mock）；actions 43 个文件 247 处 revalidatePath 替换为 invalidateFor；INVALIDATION_MAP 覆盖全部 28 个模块。Hook 双模式：useActionQuery 传 queryKey 走 useQuery 跨页共享缓存，不传走旧 useEffect+useState；useActionMutation 传 mutationFn+actionId 自动 invalidate，旧 mutate(action) 仍可用。ESLint 强制规则：no-restricted-syntax 禁止 Server Actions 中直接调用 revalidatePath/revalidateTag，仅 shared/lib/cache/invalidate.ts 豁免；data-access 查询函数双导出 raw 模式便于单测 mock。验证：npx tsc --noEmit 零错误；npm run lint 零 no-restricted-syntax 错误（仅 3 个 pre-existing react-hooks/refs 错误位于未修改文件）；npx vitest run src/shared/lib/cache/ 25/25 测试通过。详细文档见 004 第 1.1.6 节。",
     "lastUpdated": "2026-07-05"
   },
   "architectureOverview": {
diff --git a/docs/architecture/audit/performance-budget-audit-report.md b/docs/architecture/audit/performance-budget-audit-report.md
new file mode 100644
index 0000000..6721a53
--- /dev/null
+++ b/docs/architecture/audit/performance-budget-audit-report.md
@@ -0,0 +1,1175 @@
+# 性能预算重构专项 - 完整审计报告
+
+> **审计日期**: 2026-07-05
+> **审计范围**: e:\Desktop\CICD 全项目（Next.js 16.0.10 + React 19.2.1 + Turbopack + Drizzle ORM + MySQL + NextAuth v5）
+> **审计维度**: ① Bundle 体积预算（首期重点）② Core Web Vitals ③ 组件渲染性能 ④ Server Action / 数据层
+> **审计方式**: 静态代码搜索 + 依赖图分析 + 源码路径追踪（未运行时采样）
+> **交付形式**: 完整审计报告（不做实施）
+> **说明**: 当前 `next build` 因 Turbopack 编译错误未成功出包，量化指标为基于依赖图与库体积经验值的合理推断值，需在修复 P0 项后重新构建获取实际产物体积进行第二轮校准。
+
+---
+
+## 目录
+
+- [执行摘要](#执行摘要)
+- [第一部分：Bundle 体积预算审计](#第一部分bundle-体积预算审计首期重点)
+- [第二部分：Core Web Vitals 审计](#第二部分core-web-vitals-审计)
+- [第三部分：组件渲染性能审计](#第三部分组件渲染性能审计)
+- [第四部分：Server Action / 数据层审计](#第四部分server-action--数据层审计)
+- [第五部分：综合性能预算基线表](#第五部分综合性能预算基线表)
+- [第六部分：P0/P1 修复路线图](#第六部分p0p1-修复路线图)
+- [附录 A：关键文件清单](#附录-a关键文件清单)
+- [附录 B：审计涉及的依赖清单](#附录-b审计涉及的依赖清单)
+
+---
+
+## 执行摘要
+
+本次性能预算审计覆盖 4 个维度，共发现 **24 个 P0/P1 问题、22 个 P2 问题、14 个 P3 问题**，全部为静态发现，未做运行时验证。
+
+### P0 严重问题（影响生产稳定性 / 必须先修）
+
+| # | 维度 | 问题 | 文件位置 |
+|---|------|------|---------|
+| 1 | Bundle | `KnowledgeGraph`（@xyflow/react）未动态导入，textbook 路由 chunk 膨胀 ~120 KB | `src/modules/textbooks/components/knowledge-graph.tsx:5-14` |
+| 2 | Bundle | `ExamRichEditor` / `RichTextEditor` / `rich-text-block` 三处 tiptap 未动态导入，编辑器路由 chunk 膨胀 ~180 KB | `src/shared/components/ui/rich-text-editor.tsx:5-8`、`src/modules/exams/editor/exam-rich-editor.tsx:4-6`、`src/modules/lesson-preparation/components/blocks/rich-text-block.tsx:3-6` |
+| 3 | Bundle | `next.config.ts` 未启用 `experimental.optimizePackageImports`（lucide-recharts-radix-tiptap 全部未优化） | `next.config.ts:6-11` |
+| 4 | Bundle | `serverExternalPackages` 仅含 mysql2，未追加 `tencentcloud-sdk-nodejs`（2-3 MB 误打包风险） | `next.config.ts:10` |
+| 5 | Bundle | `src/modules/exams/editor/index.ts` barrel 已实际造成构建错误（代码中已有显式绕过注释） | `src/modules/exams/editor/index.ts` |
+| 6 | CWV | 无 Web Vitals 上报闭环，生产环境零真实用户性能数据 | `src/app/layout.tsx`（缺失 `useReportWebVitals`） |
+| 7 | 组件 | React Compiler（`babel-plugin-react-compiler`）未安装，memoization 缺失无法自动补全 | `package.json` + `next.config.ts` |
+| 8 | 组件 | `SidebarProvider` value 内联对象 + toggleSidebar 未 useCallback + resize 监听未防抖，全站 Header/Sidebar 高频重渲染 | `src/modules/layout/components/sidebar-provider.tsx:63-66` |
+| 9 | 组件 | 备课编辑器 `LessonPlanEditor` 通过 `useLessonPlanEditor()` 订阅全 store，每次按键触发三栏全量重渲染 | `src/modules/lesson-preparation/components/lesson-plan-editor.tsx:62` |
+| 10 | 组件 | 题库表 `QuestionDataTable` 无虚拟化，1000+ 题时首屏渲染秒级卡顿 | `src/modules/questions/components/question-data-table.tsx:45-59` |
+| 11 | 数据层 | `copyCoursePlanToClasses` 双层循环单条 INSERT，无事务无批量无大小限制 | `src/modules/course-plans/data-access.ts:347-406` |
+| 12 | 数据层 | 跨请求数据缓存完全缺失（0 处 `unstable_cache`），低变更频率数据每次重查 DB | 全项目 |
+| 13 | 数据层 | 每次 Server Action 调用必查 DB 解析 DataScope（admin 0 次 / teacher 2 次 / parent 2 次串行） | `src/shared/lib/auth-guard.ts:44-47` |
+| 14 | 数据层 | `searchQuestions` JSON 字段 CAST 后 `LIKE %kw%` 全表扫描 | `src/modules/search/data-access.ts:74-75` |
+| 15 | 数据层 | `getAllUserIds` 无 LIMIT 全表返回，5000+ 用户场景公告 fan-out 内存爆炸 | `src/modules/users/data-access.ts:348-351` |
+
+### P1 高优先级问题（影响高频接口性能）
+
+详见各分章节，共 9 项关键 P1（含：recharts barrel import、tencentcloud-sdk serverExternalPackages、exams/editor barrel 拆分、loading.tsx 缺失、force-dynamic 滥用、Lighthouse CI 缺失、layout 串行 await、autoGradeSubmission 循环 UPDATE、exams 索引缺失等）。
+
+### 关键优化杠杆点（ROI 排序）
+
+1. **React Compiler 启用**：单点改动，自动解决第 3 部分列出的多数 memoization 反模式
+2. **next.config.ts 完善**：单点改动，optimizePackageImports + serverExternalPackages 扩展
+3. **tiptap / ReactFlow 动态导入**：3 处文件改动，编辑器路由 chunk 减少 ~300 KB
+4. **备课编辑器 store 订阅拆分**：单文件改动，编辑器按键响应速度预计提升 5-10x
+5. **unstable_cache 引入**：DataScope + 低变更数据缓存，单次 Server Action DB 查询数减半
+
+---
+
+## 第一部分：Bundle 体积预算审计（首期重点）
+
+### 1.1 大体积依赖清单
+
+| 依赖 | 版本 | 估算体积（min+gzip） | 用途 | 服务端/客户端 | 严重度 |
+|------|------|----------------------|------|---------------|--------|
+| `recharts` | ^3.6.0 | ~95-110 KB | 图表库（13 处使用） | 客户端 | P1 |
+| `@xyflow/react` | ^12.11.0 | ~120-140 KB | ReactFlow 知识图谱 | 客户端 | P1 |
+| `react-force-graph-2d` | ^1.29.1 | ~80-100 KB（含 d3-force） | 引力图谱 | 客户端 | P2（已 dynamic） |
+| `tencentcloud-sdk-nodejs` | ^4.1.254 | **~2-3 MB**（巨型 SDK） | 腾讯云短信 | 服务端 | P0 |
+| `exceljs` | ^4.4.0 | ~250-300 KB | Excel 导入导出 | 服务端 | P1 |
+| `@tiptap/*`（5 包 + tiptap-markdown） | 3.x | ~180-220 KB | 富文本编辑器（3 处） | 客户端 | P0 |
+| `@dnd-kit/*`（core+sortable+utilities） | 6.x/10.x | ~30-40 KB | 拖拽 | 客户端 | P2 |
+| `lucide-react` | ^0.562.0 | 单图标 ~1 KB，全集 ~800 KB | 图标库（100+ 处） | 客户端 | P1 |
+| `radix-ui/*`（16 个包） | 各版本 | 单包 ~3-8 KB | UI 原语 | 客户端 | P2 |
+| `openai` | ^6.25.0 | ~60-80 KB | AI SDK | 服务端 | P2 |
+| `react-markdown` + remark-* + rehype-* | 4.x-10.x | ~50-70 KB | Markdown 渲染 | 客户端 | P2 |
+| `@tanstack/react-query` + `react-table` | 5.x/8.x | ~35-45 KB | 数据层 | 客户端 | P3 |
+
+### 1.2 "use client" 指令分布
+
+| 指标 | 数值 |
+|------|------|
+| `"use client"` 文件总数 | **553** |
+| `src/**/*.{ts,tsx}` 文件总数 | >700 |
+| 客户端组件占比（估算） | **~70-75%** |
+| `shared/components/ui/` 下 "use client" 文件 | 40 个 |
+
+**典型反例**：
+
+| 文件 | 问题 | 严重度 |
+|------|------|--------|
+| `src/shared/components/ui/status-badge.tsx:1` | 仅渲染 Badge 无 hook 无事件，过度标记为 client | P2 |
+| `src/shared/components/ui/label.tsx:1` | 仅 forwardRef + cva，可考虑改 server | P3 |
+
+### 1.3 动态导入使用情况
+
+| 模式 | 数量 | 位置 |
+|------|------|------|
+| `next/dynamic` | **2** | `force-graph.tsx:18`、`homework-assignment-exam-error-explorer-lazy.tsx:5` |
+| `React.lazy` | **0** | 无 |
+| 服务端动态 `import()` | 1 | `sms-channel.ts:186`（tencentcloud） |
+
+**应使用但未使用动态导入的重型组件**：
+
+#### [P0] ReactFlow（@xyflow/react）未动态导入
+- 位置：`src/modules/textbooks/components/knowledge-graph.tsx:5-14`
+- 代码：`import { ReactFlow, Background, ... } from "@xyflow/react"` 顶层静态导入
+- 影响路由：`teacher/textbooks/[id]` 与 `student/learning/textbooks/[id]`
+- 估算影响：每个 textbook 路由 chunk 增加 ~120-140 KB
+- 修复参考：`force-graph.tsx:74-80` 已有的 `dynamic(() => import(...), { ssr: false, loading: ... })` 模式
+
+#### [P0] tiptap 富文本编辑器未动态导入（3 处）
+- 位置 1：`src/shared/components/ui/rich-text-editor.tsx:5-8`
+- 位置 2：`src/modules/exams/editor/exam-rich-editor.tsx:4-6`
+- 位置 3：`src/modules/lesson-preparation/components/blocks/rich-text-block.tsx:3-6`
+- 影响路由：`teacher/exams/[id]/edit-rich`、`teacher/exams/new`、教材阅读页链路、备课编辑页
+- 估算影响：每个含编辑器路由增加 ~180-220 KB
+
+### 1.4 大体积第三方库使用模式
+
+#### lucide-react（100+ 处使用）
+- ✅ 全部使用具名导入 `import { IconName } from "lucide-react"`
+- ❌ 缺少 `experimental.optimizePackageImports: ["lucide-react"]`（Turbopack 内建 tree-shaking 可能不彻底）
+- 严重度：P1
+
+#### recharts（13 处使用）
+- ✅ 业务侧具名导入
+- ❌ [P1 反例] `src/shared/components/ui/chart.tsx:5` → `import * as RechartsPrimitive from "recharts"` barrel 导入
+- 影响：chart.tsx 被 12 个图表组件引用，barrel 导入让 Turbopack 难以精确剔除未用子模块
+- 修复：改为按需具名导入
+
+#### @xyflow/react（4 处使用，仅 textbooks 模块）
+- 模块隔离良好 ✅
+- 但未动态导入导致 textbook 路由 chunk 膨胀 ❌
+
+#### tencentcloud-sdk-nodejs（服务端专用，已正确隔离）
+- 位置：`src/modules/notifications/channels/sms-channel.ts:186`
+- 模式：`await import("tencentcloud-sdk-nodejs")` ✅
+- [P0] 建议追加 `serverExternalPackages: ["tencentcloud-sdk-nodejs"]` 防止误打包
+
+#### exceljs（1 处使用）
+- 位置：`src/shared/lib/excel.ts:3`
+- 模式：静态 `import ExcelJS from "exceljs"`（值导入）
+- 风险：若被 client 组件误引用将导致 250-300 KB 打包
+
+### 1.5 next.config.ts 配置审计
+
+**当前完整内容**（11 行）：
+
+```ts
+const nextConfig: NextConfig = {
+  output: "standalone",
+  serverExternalPackages: ["mysql2"],
+};
+```
+
+**缺失配置项**：
+
+| 缺失配置 | 影响 | 严重度 |
+|---------|------|--------|
+| `experimental.optimizePackageImports` | lucide-react/recharts/@xyflow/react/@radix-ui/* /@tiptap/* 未启用按需优化 | P0 |
+| `serverExternalPackages` 未含 `tencentcloud-sdk-nodejs` | 2-3 MB SDK 误打包风险 | P0 |
+| `serverExternalPackages` 未含 `exceljs` | 250-300 KB 误打包风险 | P1 |
+| 自定义 webpack/turbopack manualChunks | 无 splitChunks 自定义 | P2 |
+| `experimental.webVitalsAttribution` | 无法精确定位 Web Vitals 来源元素 | P2 |
+
+**建议补充配置**：
+
+```ts
+const nextConfig: NextConfig = {
+  output: "standalone",
+  serverExternalPackages: ["mysql2", "tencentcloud-sdk-nodejs", "exceljs"],
+  experimental: {
+    optimizePackageImports: [
+      "lucide-react",
+      "recharts",
+      "@xyflow/react",
+      "@tiptap/react",
+      "@tiptap/starter-kit",
+      "@tiptap/extension-placeholder",
+      "@tiptap/extension-image",
+      "@radix-ui/react-dialog",
+      "@radix-ui/react-dropdown-menu",
+      "@radix-ui/react-select",
+      // ... 其余 radix 包
+    ],
+  },
+};
+```
+
+### 1.6 Barrel File 风险
+
+| 路径 | 导出 | 风险 |
+|------|------|------|
+| `src/shared/components/ui/` | 无 index.ts barrel | ✅ 良好 |
+| `src/modules/exams/editor/index.ts` | ExamRichEditor + 6 个 tiptap 扩展 + 类型 | **P0 高风险** |
+| `src/modules/exams/ai-pipeline/index.ts` | — | 低 |
+| `src/shared/hooks/index.ts` | 7 个 hook | 低 |
+
+**[P0] exams/editor/index.ts 高风险 barrel**
+- 位置：`src/modules/exams/editor/index.ts:1-26`
+- 已造成实际问题：`src/app/(dashboard)/teacher/exams/[id]/edit-rich/page.tsx:9-14` 已有显式注释绕过 barrel
+- 但同文件第 15 行同步导入 `ExamRichForm`（其内部第 22-32 行又通过 barrel 导入）→ 绕过失效
+- 错误信息：`'Class extends value undefined is not a constructor or null'`（Server Component 连带加载 @tiptap/react 客户端扩展）
+- 修复方向：拆分为 `editor/types.ts`（仅类型，可被 server 引用）+ `editor/index.ts`（仅值导出，禁止 server 引用）
+
+### 1.7 图片/字体/静态资源
+
+| 资源 | 现状 | 评估 |
+|------|------|------|
+| `next/image` 使用 | 4 处（exam-preview、scan-uploader、scan-image-viewer、exam-rich-form） | ✅ 良好 |
+| 原生 `<img>` | 1 处（scan-image-viewer.tsx:143，已加 eslint-disable 注释） | ⚠️ 见 CLS-1 |
+| `next/font` | 1 个（Inter，`display: "swap"` + `variable`） | ✅ 良好 |
+| `manifest.ts` | 完整 | ✅ 良好 |
+| `public/` | 5 个 SVG | ✅ 良好 |
+
+### 1.8 Bundle 预算建议基线表
+
+> 因当前 `next build` 失败无法获取实际产物体积，以下为基于依赖估算的 K12 教务系统推荐基线（gzip 后）。
+
+| 路由类别 | First Load JS 阈值 | 当前估算 | 严重度 |
+|---------|-------------------|---------|--------|
+| 落地页 / 登录 / 注册（`(auth)/*`） | ≤ 180 KB | ~150-180 KB | P2 |
+| 学生端 Dashboard | ≤ 250 KB | ~250-320 KB | P2 |
+| 教师端 Dashboard | ≤ 280 KB | ~280-350 KB | P2 |
+| 列表/详情页（公告/作业/成绩等） | ≤ 300 KB | ~300-400 KB（recharts 拉入） | P1 |
+| **教材阅读页**（含 ReactFlow + tiptap + force-graph） | ≤ 600 KB | **~700-900 KB**（全量静态导入） | **P0** |
+| **试卷富文本编辑页**（含 tiptap 全家桶） | ≤ 500 KB | **~600-750 KB** | **P0** |
+| **备课编辑页**（含 tiptap + dnd-kit） | ≤ 550 KB | ~600-800 KB | **P0** |
+| 单路由增量 chunk（动态加载组件） | ≤ 200 KB | force-graph 单独 chunk ~80 KB ✅ | — |
+| 共享框架 chunk（react/react-dom/next） | ≤ 130 KB | ~130 KB（标准） | — |
+| 单文件体积上限（lint 规则） | ≤ 1000 行 | 已有项目规则约束 | — |
+
+---
+
+## 第二部分：Core Web Vitals 审计
+
+### 2.1 LCP（最大内容绘制）
+
+#### [P1] LCP-1：根 layout.tsx 串行 await
+- **位置**：`src/app/layout.tsx:45-50`
+- **问题**：每个 SSR 请求串行调用 `getLocale()` → `getMessages()` → `auth()`，三者无数据依赖
+- **影响**：TTFB、LCP、FCP（每个页面渲染都被推迟）
+- **修复**：`const [locale, messages, session] = await Promise.all([getLocale(), getMessages(), auth()])`
+
+#### [P1] LCP-3：teacher/student/parent/management 根路由缺失 loading.tsx
+- **问题**：通过 Glob 搜索 `**/loading.tsx` 仅找到 `admin/loading.tsx`，4 个角色根路由段下无 loading.tsx
+- **影响**：角色切换/首次进入时白屏闪烁，LCP/CLS 退化
+- **建议**：为 4 个角色根路由分别创建 `loading.tsx`，复用 `DashboardLoadingSkeleton`
+
+#### [P1] LCP-5：force-dynamic 滥用，无 ISR 缓存收益
+- **问题**：全项目共 **96 处** `export const dynamic = "force-dynamic"`，即使是相对静态的页面（学校列表、部门列表、教材目录）也强制动态
+- **影响**：每请求都重新 SSR + DB 查询，TTFB/LCP 无静态缓存命中加速
+- **建议**：对低频变更页面用 `revalidate = 3600` 替代 `force-dynamic`
+
+#### [P2] LCP-2：备课编辑器 textbook → chapters 数据瀑布
+- **位置**：`src/app/(dashboard)/teacher/lesson-plans/[planId]/edit/page.tsx:34-46`
+- **问题**：第 34-46 行串行调用 `getTextbookById()` → `getChaptersByTextbookId()`
+- **参考**：`parent/lesson-plans/[planId]/view/page.tsx:49-52` 已修复为 `Promise.all`
+
+#### 正面发现
+- ✅ `teacher/lesson-plans/page.tsx`、`teacher/exams/[id]/build/page.tsx`、`teacher/exams/[id]/analytics/page.tsx`、`parent/lesson-plans/[planId]/view/page.tsx` 均用 `Promise.all`
+- ✅ 4 个角色 dashboard 均用 React `use()` + Suspense 流式渲染
+- ✅ `DashboardSection` 封装 `SectionErrorBoundary + Suspense + 骨架屏`，分区流式渲染
+
+### 2.2 CLS（累计布局偏移）
+
+#### [P2] CLS-1：scan-image-viewer.tsx 使用 `<img>` 且未指定宽高
+- **位置**：`src/modules/homework/components/scan-image-viewer.tsx:142-148`
+- **问题**：原生 `<img>`（已加 eslint-disable 注释）仅设 `maxHeight: "80vh"`，无 width/height 也无 aspect-ratio
+- **影响**：图片加载完成时推动布局
+- **修复**：用 `next/image` 替换（同文件第 194-200 行缩略图已正确用 `next/image fill sizes="48px"`），或为 `<img>` 加 `aspect-ratio` 内联样式
+
+#### 正面发现
+- ✅ 字体配置正确（`display: "swap"` + `variable`）
+- ✅ `<iframe>` 全项目零使用
+- ✅ Sonner Toaster 使用 fixed 定位
+- ✅ ThemeProvider 配置 `disableTransitionOnChange`
+
+### 2.3 INP（交互到下一次绘制）
+
+#### [P2] INP-3：AiAssistantWidget 未懒加载
+- **位置**：`src/app/(dashboard)/layout.tsx:7,29`
+- **问题**：`<AiAssistantWidget />` 在 dashboard layout 同步渲染，依赖 `useFloatingBall`（拖拽位置计算 + localStorage 持久化 + 屏幕边缘吸附）+ `AiChatPanel` + `Sheet`，未通过 `next/dynamic` 懒加载
+- **影响**：INP（主线程占用）、FCP（hydration 时间）
+- **建议**：用 `next/dynamic` 包裹，`ssr: false`，初始仅渲染悬浮球，点击后再加载 chat panel
+
+#### [P3] INP-4：AppSidebar 未 memo 化导航项
+- **位置**：`src/modules/layout/components/app-sidebar.tsx:31-60`
+- **问题**：每次渲染对 `allNavItems` 做 `filter + map` 重新计算 `navItems`，未使用 `useMemo`
+- **建议**：`useMemo` 包裹 `navItems` 计算，依赖 `[allNavItems, permissions]`
+
+#### 正面发现
+- ✅ 全项目 44 处 `useTransition` / `useDeferredValue` 使用，覆盖良好（exam-assembly 防抖、exam-rich-form 双 transition、scan-uploader 等）
+- ✅ 备课编辑器使用 zustand store，无大对象 setState
+- ✅ react-force-graph-2d 已正确动态加载
+
+### 2.4 FCP / TTFB
+
+#### [P1] FCP-1：根 layout 串行 await（同 LCP-1）
+见 LCP-1。
+
+#### [P2] FCP-4：next.config.ts 未启用 optimizePackageImports
+见第一部分 1.5。
+
+#### 正面发现
+- ✅ `proxy.ts` 中间件无数据库同步调用，纯 JWT 位图运算
+- ✅ `instrumentation.ts` 启动时一次性执行
+- ✅ `globals.css` 多层 @import 均为本地资源无外部阻塞
+
+### 2.5 资源加载
+
+#### [P2] RES-1：metadata 缺 metadataBase / openGraph / robots
+- **位置**：`src/app/layout.tsx:15-24`
+- **问题**：metadata 仅含 `title`/`description`/`manifest`/`appleWebApp`，缺 `metadataBase`、`openGraph`、`twitter`、`robots`；`src/app/icon.svg` 文件可能不存在（`public/` 下仅有 5 个 SVG）
+- **影响**：FCP（OG image 加载）、SEO、build 时 warn
+- **建议**：补充 `metadataBase: new URL(process.env.NEXTAUTH_URL ?? "http://localhost:3000")`
+
+#### 正面发现
+- ✅ `viewport` 导出符合 Next.js 16 规范
+- ✅ `manifest.ts` 配置完整
+- ✅ `<Script>` 标签零使用，无第三方脚本阻塞
+- ✅ `next/image` 使用合规（4 处）
+
+### 2.6 性能监控缺失
+
+#### [P0] MON-1：无 Web Vitals 上报闭环
+- **问题**：Grep `web-vitals|reportWebVitals|useReportWebVitals|onCLS|onINP|onLCP` 在 `src/` 下零匹配；`package.json` 无 `web-vitals` 依赖
+- **影响**：生产环境无法追踪真实用户 LCP/CLS/INP/TTFB/FCP，所有性能问题只能靠经验推断
+- **建议**：
+  1. 安装 `web-vitals` 包
+  2. 在 `src/app/layout.tsx` 或新建 `src/instrumentation-client.ts` 实现 `useReportWebVitals`，上报到 `/api/web-vitals` 或第三方（Vercel Analytics / PostHog / Sentry）
+
+#### [P1] MON-2：无 Lighthouse CI 配置
+- **问题**：项目根目录无 `.lighthouserc.json` / `.lighthouserc.js`；`package.json` 无 `@lh3/cli` 依赖；`.gitea/workflows/ci.yml` 无 lighthouse step
+- **影响**：CI 流水线无 Web Vitals 回归门槛，性能劣化无法自动拦截
+- **建议**：在 `.gitea/workflows/` 新增 `lighthouse.yml`，配置 Lighthouse CI 对关键路由（`/dashboard`、`/teacher/lesson-plans`、`/admin/questions`）做采样断言
+
+#### [P2] MON-4：Playwright 无性能断言
+- **问题**：`playwright.config.ts` 已配置 E2E + 视觉回归，但未使用 `page.metrics()` 或 `@playwright/test-performance` 做性能断言
+- **建议**：在 `tests/e2e/` 新增 `performance.spec.ts`，使用 `page.evaluate(() => performance.getEntriesByType('navigation'))` 断言关键路由 LCP
+
+### 2.7 路由级性能风险
+
+| 路由 | LCP 风险 | INP 风险 | 严重度 |
+|------|---------|---------|--------|
+| 备课编辑器 `teacher/lesson-plans/[planId]/edit` | 中（waterfall + ReactFlow + tiptap） | 中（多 useTransition + zustand） | P2 |
+| 试卷富文本编辑器 `teacher/exams/[id]/edit-rich` | 中（两 await 无 Promise.all） | 高（tiptap + 多状态） | P2 |
+| 教材详情/知识图谱 `teacher/textbooks/[id]` | 低（已 Promise.all） | 高（react-force-graph + @xyflow） | P2 |
+| 题库管理 `admin/questions` | 中（200 题一次拉） | 高（200 题列表渲染） | P2 |
+| 4 个角色 dashboard | 低（已流式渲染） | 中（recharts） | P3 |
+
+### 2.8 Web Vitals 预算建议表
+
+| 指标 | Good（达标）| Needs Improvement | Poor | 建议预算（P95）|
+|------|------------|-------------------|------|---------------|
+| **LCP** | ≤ 2.5s | 2.5s - 4.0s | > 4.0s | ≤ 2.5s（备课编辑器允许 ≤ 3.0s）|
+| **INP** | ≤ 200ms | 200ms - 500ms | > 500ms | ≤ 200ms（仪表盘图表允许 ≤ 300ms）|
+| **CLS** | ≤ 0.1 | 0.1 - 0.25 | > 0.25 | ≤ 0.05 |
+| **TTFB** | ≤ 800ms | 800ms - 1800ms | > 1800ms | ≤ 800ms（dashboard 路由）|
+| **FCP** | ≤ 1.8s | 1.8s - 3.0s | > 3.0s | ≤ 1.8s |
+
+#### 按路由细分预算建议
+
+| 路由 | LCP | INP | TTFB | 主要风险 |
+|------|-----|-----|------|---------|
+| `/login` | ≤ 1.5s | ≤ 100ms | ≤ 500ms | 无 |
+| `/admin/dashboard` | ≤ 2.5s | ≤ 300ms | ≤ 800ms | recharts 多图表 + 6 个并行数据流 |
+| `/teacher/dashboard` | ≤ 2.5s | ≤ 300ms | ≤ 800ms | 同上 |
+| `/student/dashboard` | ≤ 2.0s | ≤ 200ms | ≤ 800ms | 数据较少 |
+| `/parent/dashboard` | ≤ 2.5s | ≤ 250ms | ≤ 800ms | 多子女卡片 + AI 摘要 |
+| `/teacher/lesson-plans/[id]/edit` | ≤ 3.0s | ≤ 400ms | ≤ 1000ms | ReactFlow + tiptap + 数据瀑布 |
+| `/teacher/exams/[id]/edit-rich` | ≤ 3.0s | ≤ 400ms | ≤ 1000ms | tiptap 富文本 |
+| `/teacher/textbooks/[id]` | ≤ 2.5s | ≤ 400ms | ≤ 800ms | react-force-graph-2d（动态加载）|
+| `/admin/questions` | ≤ 2.5s | ≤ 400ms | ≤ 800ms | 200 题列表 |
+
+---
+
+## 第三部分：组件渲染性能审计
+
+### 3.1 Memoization 缺失审计
+
+#### 全局使用统计
+
+| 指标 | 数量 | 备注 |
+|------|------|------|
+| `React.memo` / `memo()` | **4 处 / 4 文件** | 严重偏低（项目有 100+ 客户端组件） |
+| `useMemo` | 113 处 / 70 文件 | 中等覆盖 |
+| `useCallback` | 129 处 / 53 文件 | 中等覆盖 |
+| `style={{ ... }}` 内联 | **122 处 / 36 文件** | 大量内联对象每次渲染重建 |
+
+`memo / useMemo` 比例 = 4 / 113 ≈ **3.5%**，远低于企业级项目 30%+ 常见水平。
+
+#### React.memo 实际使用位置（仅 4 处）
+- `src/modules/ai/components/ai-markdown-renderer.tsx:162` — `AiMarkdownRenderer` 正确 memo
+- `src/modules/textbooks/components/graph-prerequisite-edge.tsx`
+- `src/modules/textbooks/components/graph-kp-node.tsx`
+- `src/modules/student/components/student-courses-view.tsx`
+
+#### [P1] 反例 1：recharts 内联对象 props
+- **位置**：`src/modules/dashboard/components/admin-dashboard/user-growth-chart.tsx:39-61`
+- **代码**：
+  ```tsx
+  <LineChart data={data} margin={{ top: 5, right: 30, left: 20, bottom: 5 }}>
+    <XAxis tick={{ fontSize: 12 }} />
+    <Tooltip contentStyle={{ backgroundColor: "hsl(var(--background))", ... }} />
+    <Line dot={{ fill: "hsl(var(--primary))", r: 3 }} />
+  </LineChart>
+  ```
+- **影响**：`margin` / `tick` / `contentStyle` / `dot` 每次渲染均为新对象引用，触发 recharts 内部 SVG 元素重渲染
+- **修复**：提升为模块级常量
+
+#### [P1] 反例 2：内联事件回调每行重建
+- **位置**：`src/modules/messaging/components/message-list.tsx:319-321`
+- **代码**：`<button onClick={(e) => void handleToggleStar(e, m.id, isStarred)} ... />`
+- **影响**：20 条消息 × 多个内联回调，父组件每次 setTab/setKeyword 都重建 20+ 函数
+
+#### [P2] 反例 3：style 内联 122 处
+- **位置**：`lesson-preparation/components/detail-panel/qa-editor.tsx`（16 处）、`paper-editor/paper-context-menu.tsx`（11 处）、`paper-editor/inline-node.tsx`（11 处）、`detail-panel/detail-head.tsx`（7 处）、`detail-panel/detail-panel.tsx`（7 处）
+- **影响**：备课编辑器子组件每次父级渲染都重算样式对象
+
+#### [P2] 反例 4：昂贵计算未 memo
+- **位置**：`src/modules/lesson-preparation/components/paper-editor/paper-editor.tsx:36`
+- **代码**：`const textbookNode = doc.nodes.find((n) => n.type === "textbook_content");`
+- **影响**：`doc` 引用变化（任意节点更新）都重算
+- **同样问题**：`src/modules/lesson-preparation/components/structure-tree/structure-tree.tsx:24`
+
+### 3.2 Context 嵌套审计
+
+#### 全部 Context Provider 清单（共 17 个）
+
+根布局链路（providers.tsx + dashboard layout.tsx）：
+
+```
+QueryClientProvider (1)
+└─ NextIntlClientProvider (2)
+   └─ ThemeProvider (3)
+      └─ SessionProvider (4)
+         └─ NuqsAdapter (5)
+            └─ AiClientProvider (6, dashboard 层)
+               └─ SidebarProvider (7, dashboard 层)
+                  └─ children
+```
+
+**7 层嵌套**，未达到 5+ 警戒线的"严重"标准但有提升空间。
+
+#### [P0] 关键反例：SidebarProvider value 内联对象
+- **位置**：`src/modules/layout/components/sidebar-provider.tsx:63-66`
+- **代码**：
+  ```tsx
+  <SidebarContext.Provider
+    value={{ expanded, setExpanded, isMobile, toggleSidebar }}
+  >
+  ```
+- **问题**：
+  1. `value` 是每次渲染新建的对象字面量，引用必然不同
+  2. `toggleSidebar` 不是 `useCallback`，每次重建
+  3. `useSidebar()` 的所有 consumer（`SiteHeader`、`AppSidebar` 等）在 SidebarProvider 任意 state 变化时全部重渲染
+  4. 第 51 行 `window.addEventListener("resize", checkMobile)` 未防抖，拖动窗口时连续触发 `setIsMobile`
+- **影响**：全站所有 dashboard 页面 Header/Sidebar 重渲染频率高
+- **修复**：`value` 用 `useMemo([expanded, isMobile])`，`toggleSidebar` 用 `useCallback`，resize 加防抖
+
+### 3.3 大列表虚拟化审计
+
+#### 关键发现：package.json 中未安装任何虚拟化库
+- ❌ `@tanstack/react-virtual`
+- ❌ `react-window`
+- ❌ `react-virtuoso`
+
+#### [P0] 重点反例：题库表无虚拟化
+- **位置**：`src/modules/questions/components/question-data-table.tsx:45-59`
+- **代码**：
+  ```tsx
+  const table = useReactTable({
+    data,  // 题库可能上千条
+    columns,
+    getCoreRowModel: getCoreRowModel(),
+    getPaginationRowModel: getPaginationRowModel(),
+    getSortedRowModel: getSortedRowModel(),
+    getFilteredRowModel: getFilteredRowModel(),  // 客户端全量过滤
+    // 无 enableRowVirtualization / getVirtualizedRowModel
+  })
+  ```
+- **影响**：题库 1000+ 条时，即使分页每页 10 条，`getFilteredRowModel` 仍要遍历全部数据；切换筛选条件时一次性 diff 大量 DOM
+- **预期数据量**：1000-10000+ 题
+
+#### 其他大列表
+
+| 列表 | 文件:行号 | 渲染方式 | 预期数据量 | 严重度 |
+|------|----------|----------|-----------|--------|
+| 考试列表 | `src/modules/exams/components/exam-data-table.tsx:78-87` | 全量渲染 | 100-1000+ | P1 |
+| 出勤表 | `src/modules/attendance/components/attendance-sheet.tsx` | 一次性渲染全班学生 × 6 状态按钮 | 30-60 学生/班 × 6 = 180-360 控件 | P1 |
+| 审计日志表 | `src/modules/audit/components/audit-log-table.tsx:61-105` | 服务端分页 + 每行 `AuditLogDetailDialog` | 10-50/页 | P2 |
+| 消息列表 | `src/modules/messaging/components/message-list.tsx:263-352` | 客户端分页 PAGE_SIZE=20，每行 Card 较重 | 20/页 | P2 |
+| 用户列表 | `src/modules/users/components/admin-users-view.tsx:219-265` | 服务端分页 + 每行 DropdownMenu | 10-50/页 | P2 |
+| 备课结构树 | `src/modules/lesson-preparation/components/structure-tree/structure-tree.tsx:79-107` | 全量渲染所有节点 | 5-50 节点 | P3 |
+| 教材章节图 | `src/modules/textbooks/components/knowledge-graph.tsx` + `force-graph.tsx` | @xyflow/react + react-force-graph-2d | 100+ 节点 | P2 |
+
+### 3.4 Zustand Store 性能审计
+
+#### Store 清单（共 2 个）
+
+| Store | 文件 | slices | 使用情况 |
+|-------|------|--------|----------|
+| `useUiStore` | `src/shared/stores/ui-store.ts` | 单一 | **未被任何组件使用（死代码）** |
+| `useLessonPlanEditor` | `src/modules/lesson-preparation/hooks/use-lesson-plan-editor.ts` | 5 个 slices（editor / selection / version / history / expanded） | 备课编辑器全量使用 |
+
+#### [P1] 反例 1：useModal 返回新对象引用（当前为死代码）
+- **位置**：`src/shared/stores/ui-store.ts:73-78`
+- **代码**：
+  ```tsx
+  return useUiStore((s) => ({
+    open: Boolean(s.modals[name]),
+    props: s.modals[name]?.props,
+    openModal: (props?: ModalProps) => s.openModal(name, props),
+    closeModal: () => s.closeModal(name),
+  }))
+  ```
+- **问题**：Zustand v5 默认使用 `Object.is` 比较，selector 返回新对象字面量意味着每次 store 变化都触发组件重渲染
+- **当前状态**：Grep 显示 `useUiStore` / `useModal` 仅在 `ui-store.ts` 自身出现，**项目其他位置未使用**，是预备的 modal registry 但未落地。一旦采用会立刻触发性能问题
+- **修复**：用 `useShallow` 包裹
+
+#### [P0] 反例 2：备课编辑器无 selector 订阅全 store
+- **位置**（4 处直接调用 `useLessonPlanEditor()` 不带 selector）：
+
+| 文件:行号 | 解构 | 影响 |
+|----------|------|------|
+| `src/modules/lesson-preparation/components/lesson-plan-editor.tsx:62` | `const editor = useLessonPlanEditor()` | 订阅全 store，每次按键/选区/展开/撤销/保存状态变化都重渲染整个三栏布局 |
+| `src/modules/lesson-preparation/components/blocks/text-study-block.tsx:22` | `const { updateNode } = useLessonPlanEditor()` | updateNode 引用稳定，但订阅粒度过粗 |
+| `src/modules/lesson-preparation/components/blocks/exercise-block.tsx:31` | `const { updateNode, planId } = useLessonPlanEditor()` | 同上 |
+| `src/modules/lesson-preparation/components/paper-editor/paper-context-menu.tsx:40` | 多重解构 | 同上 |
+
+- **影响**：备课编辑器是高频交互场景（键盘输入 + 节点选中 + 撤销重做），订阅全 store 导致每次按键都重渲染 StructureTree + PaperEditor + DetailPanel 三个子树
+- **修复**：拆为多个细粒度 selector：`useLessonPlanEditor((s) => s.title)`、`s.isSaving`、`s.isDirty` 等；block 组件改为 `const updateNode = useLessonPlanEditor((s) => s.updateNode)`
+
+#### 正面发现
+- ✅ `useLessonPlanEditor` 已正确拆分为 5 个 slice，便于按 slice 订阅
+- ✅ Slice 文件使用 `import type { StateCreator }` 类型导入，无运行时循环依赖
+- ✅ 备课模块其余 25 处 `useLessonPlanEditor((s) => s.xxx)` 使用了正确 selector 模式
+
+### 3.5 Server / Client 边界审计
+
+#### 优秀实践
+- ✅ Server Component 路由分发：`src/app/(dashboard)/dashboard/page.tsx`
+- ✅ Server Component + Suspense + Streams：admin-dashboard.tsx
+- ✅ Server Component 嵌套 Provider：dashboard layout 在 server 函数体内 `createFullAiClientService()`，避免模块级单例
+- ✅ 100+ 页面 Server Component
+- ✅ Server → Client 通过 ReactNode slot：`<SidebarProvider sidebar={<AppSidebar />}>`
+- ✅ Server Action + `useFormStatus`：5 处
+- ✅ Dialog 内部状态管理：lesson-preparation providers 用 `useMemo` 包裹 service value
+
+#### [P2] 反例：Server → Client 数据传递过大对象
+
+| 传递点 | 文件 | 数据量 | 评估 |
+|--------|------|--------|------|
+| `messages` prop → `MessageList` | `src/app/(dashboard)/messages/page.tsx` → `message-list.tsx` | 全部 messages（含 content、senderName 等） | ⚠️ 可能过大，无字段裁剪 |
+| `messages` prop → NextIntlClientProvider | `providers.tsx:46` | **全量 i18n 字典** | ⚠️ 应按 namespace 拆分 |
+
+### 3.6 React 19 特定优化审计
+
+#### 关键缺失
+
+| 特性 | 是否启用 | 严重度 | 备注 |
+|------|---------|--------|------|
+| React Compiler (`babel-plugin-react-compiler`) | ❌ **未安装** | **P0** | package.json 无依赖，next.config.ts 无配置 |
+| `use()` Hook 处理 Promise | ❌ 0 处使用 | P2 | admin-dashboard 注释声称使用，实际是 Suspense + await |
+| `useOptimistic` | ❌ 0 处使用 | P1 | 消息星标、出勤状态、批改提交等多处应使用 |
+| `useFormStatus` | ✅ 5 处 | — | attendance-sheet、attendance-rules-form、create-chapter-dialog、textbook-form-dialog、password-change-form 等 |
+| `useActionState` | ✅ 3 处 | — | password-change-form、leave-request-form、leave-review-dialog |
+
+#### [P0] React Compiler 缺失
+- **问题**：
+  - `package.json` 无 `babel-plugin-react-compiler` 依赖
+  - `next.config.ts` 未配置 `reactCompiler: true`
+  - `eslint-plugin-react-compiler` 未安装
+- **影响**：React Compiler 可自动 memoize 组件内部状态和派生值，可一次性解决第 3.1 节列出的所有内联对象/未 memo 问题。React 19 + Next.js 16 是启用 Compiler 的最佳时机
+- **修复**：安装 `babel-plugin-react-compiler` + `eslint-plugin-react-compiler`，在 `next.config.ts` 加 `experimental: { reactCompiler: true }` 或使用 Next.js 16 的稳定 API
+
+#### [P1] useOptimistic 缺失场景
+
+##### 场景 1：消息星标切换
+- **位置**：`src/modules/messaging/components/message-list.tsx:119-148`
+- **现状**：用 `starredOverride` state + try/catch 回滚模拟乐观更新
+- **修复**：
+  ```tsx
+  const optimisticMessages = useOptimistic(messages, (state, { id, isStarred }) =>
+    state.map(m => m.id === id ? { ...m, isStarred } : m)
+  )
+  ```
+
+##### 场景 2：出勤状态切换
+- **位置**：`src/modules/attendance/components/attendance-sheet.tsx:129-140`
+- **现状**：`statuses` state 实际是乐观值容器
+- **修复**：用 `useOptimistic` 表达
+
+##### 场景 3：成绩录入
+- **位置**：`src/modules/grades/components/batch-grade-entry.tsx`、`grade-record-form.tsx`
+
+### 3.7 重渲染热点审计
+
+#### [P0] 7.1 备课编辑器（lesson-preparation）— 重灾区
+
+##### 7.1.1 LessonPlanEditor 订阅全 store
+- **位置**：`src/modules/lesson-preparation/components/lesson-plan-editor.tsx:62`
+- **代码**：`const editor = useLessonPlanEditor();`
+- **影响**：该组件渲染顶部工具栏（标题输入框、保存/撤销/重做/发布等 10+ 按钮）+ 三栏布局（StructureTree + PaperEditor + DetailPanel）+ 5 个 Dialog。`editor` 任意字段变化（每次按键改 title、每次选区变化、每次撤销重做、每次保存状态切换）都触发整个组件树重渲染
+- **额外问题**：`editor.canUndo()` / `editor.canRedo()` 在 render 中直接调用（第 189-190 行），不是 selector，每次渲染都执行函数调用，且依赖整个 history slice
+
+##### 7.1.2 PaperEditor 订阅 doc 整体
+- **位置**：`src/modules/lesson-preparation/components/paper-editor/paper-editor.tsx:25`
+- **代码**：`const doc = useLessonPlanEditor((s) => s.doc);`
+- **影响**：`doc` 是不可变对象，任意 node 更新都生成新 `doc` 引用，导致 PaperEditor 全量重渲染
+- **额外问题**：第 36 行 `doc.nodes.find()` 无 memo；第 54-65 行 `onPaperContextMenu` / `onInlineNodeContextMenu` / 第 86 行 `onContextMenu` 内联回调；第 133-141 行 `expandedNodes.map` 内联函数
+
+##### 7.1.3 StructureTree 同样问题
+- **位置**：`src/modules/lesson-preparation/components/structure-tree/structure-tree.tsx:12-14`
+- **影响**：订阅 `doc` + `expandedNodeIds` + `addNode`，每次 doc 变化都重渲染所有 TreeNodeRow。第 79-107 行 `teachingNodes.map` 内联 `childItems` 数组与 `onToggleChildren` 回调
+
+##### 7.1.4 tree-node-row.tsx 内联 style 11 处
+- **位置**：`src/modules/lesson-preparation/components/structure-tree/tree-node-row.tsx`
+- **影响**：11 处 `style={{}}` 内联，每次父级 doc 变化都重算
+
+#### [P1] 7.3 表格组件（@tanstack/react-table）
+
+##### 7.3.1 题库表 QuestionDataTable（P0）
+- **位置**：`src/modules/questions/components/question-data-table.tsx:36-155`
+- **问题**：无虚拟化（见 3.3）+ 第 78-93 行 `table.getHeaderGroups().map` 渲染表头 + 第 96-111 行 `table.getRowModel().rows.map` 渲染所有行 + 第 102-108 行 `row.getVisibleCells().map` 渲染所有单元格
+- **额外问题**：第 61-64 行 `selectedIds` useMemo 依赖 `[table, getRowId]`，table 引用每次 useReactTable 调用都变化，导致 memo 失效
+
+##### 7.3.2 考试表 ExamDataTable（P1）
+- **位置**：`src/modules/exams/components/exam-data-table.tsx:33-132`
+- **问题**：同样问题，无虚拟化
+
+##### 7.3.3 审计日志表（P2）
+- **位置**：`src/modules/audit/components/audit-log-table.tsx:31-118`
+- **问题**：服务端分页（好），但每行渲染 `<AuditLogDetailDialog>`（第 101 行），即使未打开也实例化 Dialog 组件
+- **建议**：改为点击行时 `next/dynamic` 加载 Dialog
+
+#### [P2] 7.4 表单组件
+
+##### 7.4.2 备课编辑器标题输入直接改 store
+- **位置**：`src/modules/lesson-preparation/components/lesson-plan-editor.tsx:329-333`
+- **代码**：`<input value={editor.title} onChange={(e) => editor.setTitle(e.target.value)} />`
+- **影响**：每次按键直接触发 store 更新 → 触发 LessonPlanEditor 全量重渲染（因第 62 行无 selector）
+- **修复**：使用 `useDeferredValue` 或本地 state + debounce
+
+##### 7.4.3 AttendanceSheet 多重 useState
+- **位置**：`src/modules/attendance/components/attendance-sheet.tsx:115-127`
+- **问题**：11 个 useState（classId / date / period / statuses / reasons / searchQuery / focusedStudentIndex / isSubmitting / showSwitchConfirm / pendingClassIndex）。`statuses` / `reasons` 用 `Record<string, ...>` immutable 更新，每次按键都创建新对象 → 全表重渲染
+
+---
+
+## 第四部分：Server Action / 数据层审计
+
+### 4.1 N+1 查询审计
+
+#### [P0] 反例：循环单条 INSERT，无事务无批量化
+- **位置**：`src/modules/course-plans/data-access.ts:347-406` `copyCoursePlanToClasses`
+- **问题**：外层 `for (classId of targetClassIds)` 内 `await db.insert(coursePlans)`，嵌套 `for (item of sourceItems)` 内再 `await db.insert(coursePlanItems)`。10 班 × 20 周 = 200 次顺序 INSERT，无事务保护，无大小限制
+- **影响**：复制 10 个班需 200+ 次往返；中途失败导致部分复制遗留脏数据；调用方传入 100+ classIds 时响应时间分钟级
+- **修复**：改为 `db.transaction(async tx => { await tx.insert(coursePlans).values([...]) ; await tx.insert(coursePlanItems).values([...]) })`，并限制 `targetClassIds.length <= 50`
+
+#### [P1] 反例：事务内循环 UPDATE
+- **位置 1**：`src/modules/homework/data-access-write.ts:326-338` `autoGradeSubmission` 事务内
+- **位置 2**：`src/modules/homework/data-access-write.ts:360-375` `gradeHomeworkAnswers` 事务内
+- **问题**：`for (const ans of gradedAnswers) { await tx.update(homeworkAnswers) }`，每道题一次 UPDATE
+- **影响**：30 题作业需 30 次 UPDATE，事务持锁时间线性增长，并发批改时锁竞争加剧
+- **修复**：改用 MySQL `INSERT ... ON DUPLICATE KEY UPDATE` 或构造 `CASE WHEN id IN (...) THEN score ... END` 单条 UPDATE
+
+#### [P2] 反例：批量删除 fallback 路径循环
+- **位置**：`src/modules/files/data-access.ts:174-182` `deleteFileAttachments` fallback
+- **问题**：主路径已 `inArray` 批量，但 fallback 仍循环单条 delete
+
+#### 良好实践
+- ✅ `src/modules/dashboard/data-access.ts:15-30` `getAdminDashboardData` 用 `Promise.all` 并行 6 个 stats
+- ✅ `src/modules/homework/stats-service.ts:58-82` `getTeacherGradeTrends` 用 `Promise.all` 并行
+- ✅ `src/modules/grades/data-access.ts:96-107` `getGradeRecords` 用 `Promise.all` 并行 count + rows
+
+### 4.2 索引缺失审计
+
+#### Schema 索引现状
+- 总表数: 50+ 张
+- 已建索引: 110+ 个（含复合、唯一、外键）
+- 整体索引覆盖良好，但存在以下缺口
+
+#### [P1] 高频查询字段无索引
+
+| 表 | 缺失索引 | 影响 |
+|---|---|---|
+| `exams` (schema.ts:517-561) | `creatorId` 无索引 | `getExams` 按 `creatorId` 过滤（"我的试卷"），全表扫描 |
+| `exams` | `status` 无索引 | `getExams` 按 status 过滤；`getHomeworkDashboardStats` 反复按 status 过滤 |
+| `examQuestions` (schema.ts:565-572) | `questionId` 无索引 | 题目被引用检测、删除时反查 exam_questions 全表扫描 |
+| `homeworkAssignmentQuestions` (schema.ts:635-653) | `questionId` 无索引 | 同上 |
+| `submissionAnswers` (schema.ts:589-602) | `questionId` 无索引 | 题目级统计反查全表 |
+
+#### [P2] 复合索引未覆盖单字段查询
+
+| 表 | 现状 | 问题 |
+|---|---|---|
+| `examSubmissions` (schema.ts:574-587) | 仅有 `(examId, studentId)` 复合 | 单独按 `studentId` 查询（学生全部提交）走全表 |
+| `homeworkAnswers` (schema.ts:701-723) | 仅有 `(submissionId, questionId)` 复合 | 单独按 `questionId` 反查（错题统计）走全表 |
+
+#### 修复建议
+```sql
+CREATE INDEX exams_creator_idx ON exams(creator_id);
+CREATE INDEX exams_status_idx ON exams(status);
+CREATE INDEX exam_questions_question_idx ON exam_questions(question_id);
+CREATE INDEX hw_assignment_questions_question_idx ON homework_assignment_questions(question_id);
+CREATE INDEX exam_submissions_student_idx ON exam_submissions(student_id);
+CREATE INDEX submission_answers_question_idx ON submission_answers(question_id);
+CREATE INDEX hw_answers_question_idx ON homework_answers(question_id);
+```
+
+#### 良好实践
+- ✅ `attendanceRecords` 索引覆盖优秀：`classDatePeriodIdx` 复合索引覆盖按节次点名场景
+- ✅ `gradeRecords` 已建 `classSubjectIdx` 复合索引
+- ✅ `messages` 已建 `receiverReadIdx`、`receiverStarredIdx` 复合索引
+- ✅ `auditLogs` 已建 `createdAtIdx` 支持时间范围查询
+
+### 4.3 并行数据获取审计
+
+#### [P2] 串行 await 可优化为 Promise.all
+
+| 文件:行号 | 反例 | 优化 |
+|---|---|---|
+| `src/modules/users/data-access.ts:27-37` `getUserProfile` | 先 `db.query.users.findFirst`，再 `db.select roles` —— 两次串行 await | 改 `Promise.all([findUser, findRoles])` |
+| `src/modules/homework/stats-service.ts:261-302` `getStudentDashboardGrades` | 9 次串行 await | 部分可并行（如 `assignments` 与 `getAssignmentMaxScoreById` 无依赖关系） |
+| `src/modules/dashboard/page.tsx:11-15` 根 dashboard 页 | `await auth()` → `await resolvePermissions(roles)` 串行 | JWT 已含 permissionsBitmap，可直接 `decodePermissionsBitmap(session.user.permissionsBitmap)` 跳过 `resolvePermissions` DB 查询 |
+| `src/modules/rbac/lib/data-scope-resolver.ts:71-79` parent scope | `getChildren` → `getGradeIdsForStudentIds` 串行 | 可在 `getChildren` 一并返回 studentIds → gradeIds 联表查询，消除二次往返 |
+
+#### 良好实践
+- ✅ `src/modules/dashboard/actions.ts:58-65` `getTeacherDashboardAction` 6 路并行
+- ✅ `src/modules/dashboard/actions.ts:108-113` `getStudentDashboardAction` 4 路并行
+- ✅ `src/modules/dashboard/data-access.ts:23-30` admin dashboard 6 路并行
+- ✅ `src/modules/exams/data-access.ts:235-238` `resolveSubjectGradeNames` 2 路并行
+
+### 4.4 缓存策略审计
+
+#### [P0] 跨请求数据缓存完全缺失
+
+| 现状 | 证据 |
+|---|---|
+| 全项目 0 处 `unstable_cache` 使用 | `Grep unstable_cache` 返回 0 匹配 |
+| 全项目 0 处 `"use cache"` 指令 | Next.js 16 的 `"use cache"` 未启用 |
+| 全项目 0 处 `cache: "no-store" / "force-cache"` 显式配置 | `Grep cache:\s*["']` 返回 0 匹配 |
+| 全项目 0 处 `next: { revalidate }` 配置 | 同上 |
+| Data-access 层仅使用 `cache()` from React（请求内去重） | 例如 `src/modules/dashboard/data-access.ts:15` `cache(async ...)` |
+
+#### 影响
+每个 Server Action 调用都重新查 DB，包括低频变更的高频读取数据：
+- `getSubjectOptions` / `getGradeOptions`（学期内几乎不变）
+- `getClassesDashboardStats`（班级总数）
+- `getSystemSettings`（系统配置）
+- `getTextbooks`（教材列表）
+- `getRoles`（角色列表）
+- `resolvePermissions`（每次 JWT refresh 才查 DB，但根 dashboard 仍重复查）
+
+DataScope 每次 Server Action 调用都从 DB 重查（1-3 次查询）
+
+#### 修复建议
+```ts
+// 1. 低变更频率数据用 unstable_cache + tag
+import { unstable_cache } from "next/cache"
+
+export const getSubjectOptions = unstable_cache(
+  async () => db.select().from(subjects).orderBy(asc(subjects.name)),
+  ["subject-options"],
+  { tags: ["subjects"], revalidateTag: 3600 }
+)
+
+// 2. Dashboard stats 用 5 分钟短缓存
+export const getClassesDashboardStats = unstable_cache(
+  async () => { /* ... */ },
+  ["classes-dashboard-stats"],
+  { tags: ["dashboard", "classes"], revalidateTag: 300 }
+)
+
+// 3. DataScope 用 React cache() 请求级去重 + 短时 unstable_cache
+// 注意：DataScope 变更（教师新接班级）需触发 tag 失效
+```
+
+#### 良好实践
+- ✅ `revalidatePath` 在 50+ actions 文件中正确使用，路径精确（如 `/teacher/exams/all`、`/student/error-book`）
+- ✅ `src/auth.ts:55-86` JWT callback 在 token refresh 时刷新 roles/permissions
+
+### 4.5 数据传输体积审计
+
+#### [P1] 单次查询拉取过大
+
+| 文件:行号 | 问题 | 影响 |
+|---|---|---|
+| `src/modules/search/data-access.ts:64-79` `searchQuestions` | `select({ content: questions.content, ... })` 把整个 JSON 题干内容（可能含图片 base64 / SlateJS 节点树）拉出，仅用于 `truncate(text, 200)` 摘要 | 单题 content 可达 10-50 KB；搜索 10 条返回 500 KB+ |
+| `src/modules/homework/stats-service.ts:162-172` `getHomeworkAssignmentAnalytics` | `db.query.homeworkSubmissions.findMany({ with: { answers: true, student: true } })` 一次拉取所有已批改提交 + 答案 + 学生信息，`limit: 5000`（line 345） | 50 人班级 × 30 题 = 1500 行 answer + 50 行 submission + 50 行 user，单次返回 MB 级 |
+| `src/modules/users/data-access.ts:348-351` `getAllUserIds` | `db.select({ id: users.id }).from(users)` 无 LIMIT | 大型学校 5000+ 用户时返回 5000 行 |
+| `src/modules/grades/data-access.ts:105` `getGradeRecords` | `.limit(params.limit ?? 1000)` 默认 1000 行 | 默认值偏高，前端通常只展示 20 行 |
+
+#### [P2] 中等过度传输
+- `src/modules/homework/stats-service.ts:216` `wrongAnswers.slice(0, 500)` 每题返回最多 500 个错答样本
+- `src/modules/textbooks/data-access.ts:43-91` `getTextbooks` 无显式 LIMIT
+
+#### 良好实践
+- ✅ `users.password` 字段在所有 select 中均未暴露
+- ✅ `getExams` 用 Drizzle `with: { subject, gradeEntity }` 关联查询，避免 N+1
+- ✅ `getGradeRecords` 批量 fetch 名称而非逐行 JOIN，模式正确
+- ✅ `getAdminUsers` 显式 `pageSize = Math.min(100, ...)` 限制
+
+### 4.6 权限校验性能审计
+
+#### [P0] 每次 Server Action 调用必查 DB
+
+调用链: `actions.ts → requirePermission() → getAuthContext() → resolveDataScope() → DATA_SCOPE_RULES[].resolve(userId) → DB`
+
+| 角色 | DB 查询次数 | 证据 |
+|---|---|---|
+| admin | 0（直接返回 `{type:"all"}`） | `data-scope-resolver.ts:30` |
+| grade_head / teaching_head | 1 次（`getGradesForStaff`） | `data-scope-resolver.ts:36` |
+| teacher | 2 次（并行：classes + subjects） | `data-scope-resolver.ts:48` 调 `getTeacherScopeData` 内部 Promise.all |
+| student | 1+ 次（`getStudentScopeData`） | `data-scope-resolver.ts:60` |
+| parent | 2 次（**串行**：`getChildren` → `getGradeIdsForStudentIds`） | `data-scope-resolver.ts:72-74` |
+
+**关键证据**（`src/shared/lib/auth-guard.ts:44-47`）:
+```ts
+// Resolve data scope from DB (not cached in JWT since it can change)
+const dataScope = await resolveDataScope(userId, roleNames)
+```
+
+注释明确说明"不缓存因可变"，导致每次 Server Action 至少 1-2 次 DB 查询仅用于权限。
+
+#### [P2] getSessionTeacherId 未用 React cache() 包装
+- **位置**：`src/modules/classes/data-access.ts:17-31` `getSessionTeacherId`
+- **问题**：每次 `await auth()` + DB 查询，无 `cache()` 包装。同一请求内多次调用（如 dashboard action + 子函数）会重复查询
+- **对比**：`getUserProfile`（`users/data-access.ts:26`）、`getAdminDashboardData`（`dashboard/data-access.ts:15`）、`getStudentDashboardGrades`（`stats-service.ts:257`）均用 `cache()` 包装，请求内去重正确
+
+#### 修复建议
+```ts
+// 1. getAuthContext 用 React cache() 请求级去重
+export const getAuthContext = cache(async (): Promise<AuthContext> => {
+  const session = await getSession()
+  // ... existing logic
+})
+
+// 2. DataScope 短时 unstable_cache（30s），变更时通过 tag 失效
+const resolveDataScope = unstable_cache(
+  async (userId, roleNames) => { /* ... */ },
+  [`data-scope-${userId}`],
+  { tags: [`user-scope-${userId}`], revalidateTag: 30 }
+)
+
+// 3. 教师新接班级 / 学生转班时调用 revalidateTag(`user-scope-${userId}`)
+
+// 4. getSessionTeacherId 加 cache() 包装
+export const getSessionTeacherId = cache(async () => { /* ... */ })
+```
+
+#### 良好实践
+- ✅ `src/auth.ts:47-83` JWT callback 在 token 创建 + refresh 时统一查询 roles + permissions
+- ✅ `src/auth.ts:47-50` permissions 用 bitmap 压缩（14 字符 vs 1.1 KB 数组），节省 cookie 体积
+
+### 4.7 批量操作审计
+
+#### [P0] 无事务、无批量、无大小限制
+见 4.1 `copyCoursePlanToClasses`。
+
+#### 良好实践
+- ✅ 全项目 41+ 处 `db.transaction` 包裹写入操作
+- ✅ `src/modules/grades/data-access.ts:179-201` `batchCreateGradeRecords` 正确用事务 + 批量 insert
+- ✅ `src/modules/users/data-access.ts:130` 用户导入用事务
+- ✅ `src/modules/elective/data-access-operations.ts` 选课操作多处用事务
+
+### 4.8 慢查询风险审计
+
+#### [P0] 全表扫描 / 无 LIMIT 全量返回
+
+| 文件:行号 | 问题 |
+|---|---|
+| `src/modules/search/data-access.ts:74-75` `searchQuestions` | `CAST(${questions.content} AS CHAR) LIKE ${kw}` —— JSON 字段 CAST 后 LIKE，无 FULLTEXT 索引，必然全表扫描 |
+| `src/modules/lesson-preparation/data-access-knowledge.ts:98, 126` | `like(lessonPlans.content, \`%${...}%\`)` —— JSON content 列 LIKE |
+| `src/modules/users/data-access.ts:348-351` `getAllUserIds` | `db.select({ id }).from(users)` 无 LIMIT，无 WHERE |
+| `src/modules/announcements/data-access.ts:560-561` | school 公告 fan-out 调 `getAllUserIds()`，5000+ 用户全量加载到内存 |
+| `src/modules/files/data-access.ts:128-139` `getAllFileAttachments` | 全量返回文件表，无分页 |
+
+#### [P1] LIKE 前缀通配 `%xxx%`（无法走索引）
+
+| 文件:行号 | 字段 |
+|---|---|
+| `src/modules/textbooks/data-access.ts:50-53` | title / subject / grade / publisher 4 列 `%${q}%` |
+| `src/modules/exams/data-access.ts:70` | title / description `%${q}%` |
+| `src/modules/standards/data-access.ts:147` | title `%${keyword}%` |
+| `src/modules/lesson-preparation/data-access.ts:238` | title `%${q}%` |
+| `src/modules/audit/data-access.ts:46` | action `%${params.action}%` |
+| `src/modules/users/data-access.ts:384` | `ilike(users.name, search)` / `ilike(users.email, search)` |
+| `src/modules/rbac/data-access-assignments.ts:103` | `ilike(users.name, term)` / `ilike(users.email, term)` |
+| `src/modules/messaging/data-access.ts:140` | `like(messages.subject, kw)` / `like(messages.content, kw)` |
+
+✅ 例外：`src/modules/files/data-access.ts:204` `like(fileAttachments.mimeType, \`${mimeType}%\`)` 是前缀匹配，可走索引
+
+#### [P2] 高 LIMIT 默认值
+
+| 文件:行号 | LIMIT |
+|---|---|
+| `src/modules/grades/data-access.ts:105` `getGradeRecords` | 默认 1000 |
+| `src/modules/homework/stats-service.ts:276` `getStudentDashboardGrades` | `limit: 200` |
+| `src/modules/homework/stats-service.ts:345` `classGradedSubmissions` | `limit: 5000` |
+| `src/modules/homework/stats-service.ts:216` | `wrongAnswers.slice(0, 500)` |
+| `src/modules/adaptive-practice/data-access-strategy.ts:293` | `.limit(1000)` |
+
+#### 修复建议
+- **搜索 API 改用 MySQL FULLTEXT 索引**：
+  ```sql
+  ALTER TABLE questions ADD FULLTEXT INDEX ft_content (content);
+  ALTER TABLE announcements ADD FULLTEXT INDEX ft_title_content (title, content);
+  -- 查询改用 MATCH ... AGAINST
+  ```
+- `getAllUserIds` 改为游标分页 + fan-out 改为批量插入 `message_notifications`（每次 500 条）
+- `LIKE %xxx%` 改为前缀匹配 `LIKE xxx%` 或 ES/OpenSearch 外部搜索引擎
+- 高 LIMIT 改为基于业务实际值：`classGradedSubmissions` 50 人班级够用 1000
+
+---
+
+## 第五部分：综合性能预算基线表
+
+### 5.1 Bundle 体积预算（gzip 后）
+
+| 维度 | 预算 | 强制等级 |
+|------|------|---------|
+| 落地页 / 登录 First Load JS | ≤ 180 KB | 强制 |
+| 学生端 Dashboard First Load JS | ≤ 250 KB | 强制 |
+| 教师端 Dashboard First Load JS | ≤ 280 KB | 强制 |
+| 列表/详情页 First Load JS | ≤ 300 KB | 强制 |
+| 教材阅读页 First Load JS（含 ReactFlow + tiptap + force-graph） | ≤ 600 KB | 强制 |
+| 试卷富文本编辑页 First Load JS | ≤ 500 KB | 强制 |
+| 备课编辑页 First Load JS | ≤ 550 KB | 强制 |
+| 单路由增量 chunk（动态加载组件） | ≤ 200 KB | 推荐 |
+| 共享框架 chunk（react/react-dom/next） | ≤ 130 KB | — |
+| 单文件体积上限 | ≤ 1000 行 | 强制（已有 lint 规则） |
+
+### 5.2 Web Vitals 预算（P95）
+
+| 指标 | 预算 | 强制等级 |
+|------|------|---------|
+| LCP | ≤ 2.5s（备课编辑器允许 ≤ 3.0s） | 强制 |
+| INP | ≤ 200ms（仪表盘图表允许 ≤ 300ms） | 强制 |
+| CLS | ≤ 0.05 | 强制 |
+| TTFB | ≤ 800ms（dashboard 路由） | 强制 |
+| FCP | ≤ 1.8s | 强制 |
+
+### 5.3 数据层性能预算
+
+| 维度 | 预算 | 强制等级 |
+|------|------|---------|
+| 单次 Server Action 响应时间（P50） | ≤ 200 ms | 强制 |
+| 单次 Server Action 响应时间（P99） | ≤ 800 ms | 强制 |
+| 单次 DB 查询执行时间 | ≤ 50 ms | 强制 |
+| Server Action 内 DB 查询次数 | ≤ 5 次 | 强制 |
+| 单次查询返回行数 | ≤ 200 行 | 强制 |
+| 单次查询返回数据体积 | ≤ 100 KB | 强制 |
+| N+1 查询 | **严格禁止** | 强制（CI 检查） |
+| 循环内 `await db.insert/update/delete` | **严格禁止**（除非有 fallback 注释） | 强制 |
+| 权限校验 DB 查询次数 | ≤ 1 次/请求（用 React `cache()` 去重） | 强制 |
+| DataScope 解析 DB 查询次数 | ≤ 1 次/请求（30s unstable_cache） | 强制 |
+| 跨请求缓存命中率（dashboard/统计） | ≥ 80% | 推荐 |
+| `revalidatePath` 路径精确度 | ≤ 2 条/写操作 | 强制 |
+| 批量操作事务包裹率 | 100% | 强制 |
+| 批量操作大小限制 | ≤ 50 行/事务 | 强制 |
+| LIKE 前缀通配 `%xxx%` 出现次数 | 0（除非有 FULLTEXT 索引） | 强制 |
+| 全表扫描查询（无 LIMIT + 无 WHERE） | 0 | 强制 |
+| 默认分页 size | ≤ 50 | 推荐 |
+| 单条返回 JSON 字段体积 | ≤ 50 KB | 强制 |
+| Server → Client 传输 `password`/`passwordHash`/`token` 字段 | 0 | 强制 |
+
+### 5.4 关键 KPI（建议接入监控）
+
+- Server Action P50/P99 响应时间（按 action 名分维度）
+- DB 查询次数 / Server Action 调用
+- 慢查询（>50ms）次数与 SQL 摘要
+- DataScope 解析耗时
+- `unstable_cache` 命中率
+- N+1 自动检测（建议接入 `drizzle-orm/dev` 的 query log + CI 规则）
+- Web Vitals 上报（LCP/CLS/INP/TTFB/FCP）
+- Bundle 体积变化（每次 PR 与基线对比）
+
+---
+
+## 第六部分：P0/P1 修复路线图
+
+### 6.1 P0 修复路线图（按 ROI 排序）
+
+| # | 项目 | 涉及章节 | 预期收益 | 单点改动 | 风险 |
+|---|------|---------|---------|---------|------|
+| 1 | 启用 React Compiler | §3.6 | 一次性解决 §3.1 大部分内联对象问题 | ✅ | 低（ Compiler 有 fallback） |
+| 2 | `next.config.ts` 完善（optimizePackageImports + serverExternalPackages） | §1.5 | 全路由 -30~80 KB + 防止 2-3 MB 误打包 | ✅ | 低 |
+| 3 | tiptap / ReactFlow 动态导入（4 处文件） | §1.3 | 编辑器路由 chunk 减少 ~300 KB | ✅ | 低 |
+| 4 | `exams/editor/index.ts` barrel 拆分 | §1.6 | 修复已存在的构建错误 + 防止 server 误拉 tiptap | ✅ | 中（需测试 server 引用路径） |
+| 5 | 接入 Web Vitals 上报 | §2.6 | 生产环境性能可见性 | ✅ | 低 |
+| 6 | `SidebarProvider` value memoize + resize 防抖 | §3.2 | 全站 dashboard 重渲染减少 50%+ | ✅ | 低 |
+| 7 | `lesson-plan-editor.tsx:62` 拆分 selector | §3.4, §3.7 | 备课编辑器按键响应速度提升 5-10x | ✅ | 中（需测试编辑器交互） |
+| 8 | 题库表启用虚拟化 | §3.3, §3.7 | 1000+ 题时首屏可交互时间从秒级降到 100ms | ❌（需引入 @tanstack/react-virtual） | 中 |
+| 9 | `copyCoursePlanToClasses` 改为事务 + 批量 INSERT | §4.1, §4.7 | 复制 10 班从分钟级降到秒级 | ✅ | 低 |
+| 10 | `unstable_cache` 引入（DataScope + 低变更数据） | §4.4, §4.6 | 单次 Server Action DB 查询数减半 | ❌（需引入 tag 失效机制） | 中（缓存一致性） |
+| 11 | `searchQuestions` 改用 FULLTEXT 索引 | §4.5, §4.8 | 搜索接口从全表扫描降到索引扫描 | ❌（需 DB 迁移） | 中（需测试搜索召回率） |
+| 12 | `getAllUserIds` 加 LIMIT + 公告 fan-out 改批量 | §4.5, §4.8 | 防止 5000+ 用户场景内存爆炸 | ✅ | 低 |
+
+### 6.2 P1 修复路线图
+
+| # | 项目 | 涉及章节 | 预期收益 |
+|---|------|---------|---------|
+| 1 | `serverExternalPackages` 追加 `exceljs` | §1.5 | 防止 250-300 KB 误打包 |
+| 2 | `chart.tsx` 改 barrel 为具名导入 | §1.4 | 全图表路由 -20~40 KB |
+| 3 | 移除 `status-badge.tsx` 等过度标记的 `"use client"` | §1.2 | 提升 SSR 覆盖率 |
+| 4 | 4 个角色根路由新增 `loading.tsx` | §2.1 | LCP/CLS 改善 |
+| 5 | 96 处 `force-dynamic` 评估改 `revalidate` | §2.1 | TTFB/LCP 静态缓存命中加速 |
+| 6 | Lighthouse CI 接入 | §2.6 | CI 流水线 Web Vitals 回归门槛 |
+| 7 | 根 `layout.tsx` 串行 await 改 `Promise.all` | §2.1 | TTFB/FCP 改善 |
+| 8 | `autoGradeSubmission` / `gradeHomeworkAnswers` 改批量 UPDATE | §4.1 | 30 题作业 UPDATE 次数从 30 降到 1 |
+| 9 | exams 表新增 5 个索引 | §4.2 | "我的试卷"等高频查询全表 → 索引扫描 |
+| 10 | recharts props 提升为模块级常量 | §3.1 | 仪表盘图表重渲染减少 |
+| 11 | `useOptimistic` 用于消息星标 / 出勤 / 成绩 | §3.6 | 替代手写 override state，UX 提升 |
+| 12 | 考试表启用虚拟化 | §3.3 | 数据量增长时避免卡顿 |
+| 13 | 高频子组件 `React.memo`（MessageCard、TreeNodeRow、InlineNode、AttendanceRow） | §3.1 | 阻断父级渲染扩散 |
+
+### 6.3 P2 跟进项
+
+- `useModal` 修复（如计划采用）
+- `AuditLogDetailDialog` 懒加载
+- `use()` Hook 替代部分 Suspense 嵌套
+- 备课编辑器 title 输入 `useDeferredValue`
+- `getSessionTeacherId` 加 `cache()` 包装
+- parent DataScope 改为单次 JOIN
+- 默认 LIMIT 调低
+- `metadata` 补充 `metadataBase` / `openGraph` / `robots`
+- Playwright 性能断言
+- `AiAssistantWidget` 懒加载
+- scan-image-viewer `<img>` 加 aspect-ratio
+- 备课编辑器 textbook → chapters 改 `Promise.all`
+
+### 6.4 建议执行顺序
+
+```
+Phase 1: 配置基线（无业务代码改动）
+  ├── next.config.ts 完善
+  ├── React Compiler 启用
+  ├── Web Vitals 上报接入
+  └── Lighthouse CI 接入
+
+Phase 2: Bundle 瘦身（影响编辑器路由）
+  ├── tiptap / ReactFlow 动态导入
+  ├── exams/editor barrel 拆分
+  └── 重新 next build 获取实际体积数据
+
+Phase 3: 数据层重构（影响所有 Server Action）
+  ├── unstable_cache 引入
+  ├── DataScope 缓存
+  ├── copyCoursePlanToClasses 改造
+  └── exams 索引补齐
+
+Phase 4: 组件渲染优化
+  ├── SidebarProvider memoize
+  ├── lesson-plan-editor selector 拆分
+  ├── 题库表虚拟化
+  └── recharts props 常量化
+
+Phase 5: 验收与基线校准
+  ├── 实际 Web Vitals 数据采集
+  ├── 实际 Bundle 体积对照基线表
+  └── 预算阈值写入 CI 阻断规则
+```
+
+---
+
+## 附录 A：关键文件清单
+
+### 配置文件
+- `e:\Desktop\CICD\next.config.ts`
+- `e:\Desktop\CICD\package.json`
+- `e:\Desktop\CICD\playwright.config.ts`
+- `e:\Desktop\CICD\vitest.config.ts`
+
+### 入口与 Provider
+- `e:\Desktop\CICD\src\app\layout.tsx`
+- `e:\Desktop\CICD\src\app\providers.tsx`
+- `e:\Desktop\CICD\src\app\(dashboard)\layout.tsx`
+- `e:\Desktop\CICD\src\app\manifest.ts`
+- `e:\Desktop\CICD\src\proxy.ts`
+- `e:\Desktop\CICD\src\instrumentation.ts`
+- `e:\Desktop\CICD\src\auth.ts`
+
+### 重型组件（Bundle 风险点）
+- `e:\Desktop\CICD\src\modules\textbooks\components\knowledge-graph.tsx`（ReactFlow，未 dynamic）
+- `e:\Desktop\CICD\src\modules\textbooks\components\force-graph.tsx`（react-force-graph-2d，已 dynamic ✅）
+- `e:\Desktop\CICD\src\shared\components\ui\rich-text-editor.tsx`（tiptap）
+- `e:\Desktop\CICD\src\modules\exams\editor\exam-rich-editor.tsx`（tiptap）
+- `e:\Desktop\CICD\src\modules\lesson-preparation\components\blocks\rich-text-block.tsx`（tiptap）
+
+### Barrel 文件（高风险）
+- `e:\Desktop\CICD\src\modules\exams\editor\index.ts`（已造成构建错误）
+
+### 重渲染热点（组件性能风险点）
+- `e:\Desktop\CICD\src\modules\layout\components\sidebar-provider.tsx`
+- `e:\Desktop\CICD\src\modules\lesson-preparation\components\lesson-plan-editor.tsx`
+- `e:\Desktop\CICD\src\modules\lesson-preparation\components\paper-editor\paper-editor.tsx`
+- `e:\Desktop\CICD\src\modules\lesson-preparation\components\structure-tree\structure-tree.tsx`
+- `e:\Desktop\CICD\src\modules\dashboard\components\admin-dashboard\user-growth-chart.tsx`
+- `e:\Desktop\CICD\src\modules\questions\components\question-data-table.tsx`
+- `e:\Desktop\CICD\src\modules\exams\components\exam-data-table.tsx`
+
+### 数据层风险点
+- `e:\Desktop\CICD\src\modules\course-plans\data-access.ts`（copyCoursePlanToClasses P0）
+- `e:\Desktop\CICD\src\modules\homework\data-access-write.ts`（循环 UPDATE P1）
+- `e:\Desktop\CICD\src\modules\search\data-access.ts`（LIKE 全表扫描 P0）
+- `e:\Desktop\CICD\src\modules\users\data-access.ts`（getAllUserIds 无 LIMIT P0）
+- `e:\Desktop\CICD\src\shared\lib\auth-guard.ts`（DataScope 每次重查 P0）
+- `e:\Desktop\CICD\src\shared\db\schema.ts`（exams 索引缺失 P1）
+- `e:\Desktop\CICD\src\modules\homework\stats-service.ts`（5000 行 + with 关联 P1）
+
+### 缺失文件清单（建议新增）
+- `src/app/(dashboard)/teacher/loading.tsx`
+- `src/app/(dashboard)/student/loading.tsx`
+- `src/app/(dashboard)/parent/loading.tsx`
+- `src/app/(dashboard)/management/loading.tsx`
+- `e:\Desktop\CICD\.gitea\workflows\lighthouse.yml`（建议新增 Lighthouse CI）
+- `e:\Desktop\CICD\src\app\instrumentation-client.ts`（建议实现 `useReportWebVitals`）
+- `e:\Desktop\CICD\src\app\api\web-vitals\route.ts`（建议新增指标上报端点）
+
+---
+
+## 附录 B：审计涉及的依赖清单
+
+### 客户端大体积依赖（按估算体积排序）
+
+| 依赖 | 估算体积（min+gzip） | 用途 | 当前问题 |
+|------|---------------------|------|---------|
+| `@tiptap/*`（5 包 + tiptap-markdown） | ~180-220 KB | 富文本编辑器（3 处） | 未动态导入（P0） |
+| `@xyflow/react` | ~120-140 KB | ReactFlow 知识图谱 | 未动态导入（P0） |
+| `recharts` | ~95-110 KB | 图表库（13 处） | chart.tsx barrel import（P1） |
+| `react-force-graph-2d` | ~80-100 KB | 引力图谱 | 已动态导入 ✅ |
+| `react-markdown` + remark-* + rehype-* | ~50-70 KB | Markdown 渲染 | — |
+| `openai` | ~60-80 KB | AI SDK | 服务端 |
+| `@tanstack/react-query` + `react-table` | ~35-45 KB | 数据层 | — |
+| `@dnd-kit/*`（core+sortable+utilities） | ~30-40 KB | 拖拽 | — |
+| `radix-ui/*`（16 个包） | 单包 ~3-8 KB | UI 原语 | — |
+| `lucide-react` | 单图标 ~1 KB，全集 ~800 KB | 图标库（100+ 处） | 缺 optimizePackageImports（P1） |
+
+### 服务端大体积依赖（防误打包）
+
+| 依赖 | 估算体积 | 用途 | 当前状态 |
+|------|----------|------|---------|
+| `tencentcloud-sdk-nodejs` | **~2-3 MB** | 腾讯云短信 | 已动态 import ✅，但未加 serverExternalPackages（P0） |
+| `exceljs` | ~250-300 KB | Excel 导入导出 | 静态 import，未加 serverExternalPackages（P1） |
+| `mysql2` | — | MySQL 驱动 | 已加 serverExternalPackages ✅ |
+
+### 缺失依赖（建议新增）
+
+| 依赖 | 用途 | 必要性 |
+|------|------|--------|
+| `babel-plugin-react-compiler` | React Compiler 自动 memoization | P0 |
+| `eslint-plugin-react-compiler` | React Compiler ESLint 规则 | P0 |
+| `web-vitals` | Web Vitals 上报 | P0 |
+| `@tanstack/react-virtual` | 题库/考试表虚拟化 | P0 |
+| `@lh3/cli` | Lighthouse CI | P1 |
+
+---
+
+## 审计结论
+
+本次性能预算审计完成，共发现 **15 个 P0 严重问题**、**13 个 P1 高优先级问题**、**22 个 P2 中等优先级问题**、**14 个 P3 低优先级问题**。
+
+**核心建议**：按第六部分"建议执行顺序"分 5 个 Phase 推进，**Phase 1 配置基线**（4 项单点改动，低风险高收益）应作为首期落地，**Phase 2 Bundle 瘦身**和 **Phase 3 数据层重构**为中期重点，**Phase 4 组件渲染优化**为长期持续工作，**Phase 5 验收与基线校准**闭环反馈到预算阈值。
+
+**关键提醒**：当前 `next build` 因 Turbopack 编译错误未成功出包，本报告所有量化指标为静态估算。修复 Phase 1 + Phase 2 后必须重新构建，获取实际 Bundle 体积与运行时 Web Vitals 数据，再对照第五部分基线表进行第二轮校准。
+
+**架构图同步建议**：本审计为只读研究，未修改源码，**不需要同步更新 `docs/architecture/004_architecture_impact_map.md` 与 `005_architecture_data.json`**。若后续落实任何修复（如新增 loading.tsx、修改 next.config.ts、新增 web-vitals 上报、引入 unstable_cache），需按项目规则同步架构图。
diff --git a/docs/troubleshooting/known-issues.md b/docs/troubleshooting/known-issues.md
index b246415..1dc4647 100644
--- a/docs/troubleshooting/known-issues.md
+++ b/docs/troubleshooting/known-issues.md
@@ -1263,11 +1263,41 @@ if (announcement.type === "school") {
 ### 缓存策略重构涉及文件清单
 
 - `src/shared/lib/cache/{types,memory-store,redis-store,store-factory,cache-fn,invalidation-map,client-invalidation-map,invalidate,index}.ts` — 缓存基础设施（9 个文件）
-- `src/shared/lib/redis-client.ts` — 共享 Redis 客户端单例
-- `src/shared/lib/query-keys.ts` — 客户端 queryKey 工厂
-- `src/shared/hooks/use-action-query.ts` — 新增 queryKey 入参走 QueryClient
-- `src/shared/hooks/use-action-mutation.ts` — 新增 actionId 自动 invalidate
-- `src/modules/classes/data-access-*.ts` — 5+ 文件全部 cacheFn 包装 + 双导出 raw
-- `src/modules/classes/actions-*.ts` — 5 文件全部 invalidateFor 替换 revalidatePath
-- `src/modules/classes/components/*` — useActionQuery/useActionMutation 适配新版 API
+- `src/shared/lib/redis-client.ts` — 共享 Redis 客户端单例（rate-limit + cache 共用）
+- `src/shared/lib/query-keys.ts` — 客户端 queryKey 工厂（`queryKeys.classes.*`）
+- `src/shared/hooks/use-action-query.ts` — 新增 queryKey 入参走 QueryClient（向后兼容旧模式）
+- `src/shared/hooks/use-action-mutation.ts` — 新增 actionId 自动 invalidate（向后兼容 mutate(action)）
+- `src/env.mjs` — 新增 `CACHE_DRIVER: z.enum(["memory", "redis"]).default("memory")`
+- `eslint.config.mjs` — 新增 `no-restricted-syntax` 规则禁止 Server Actions 中直接调用 revalidatePath/revalidateTag
+
+### 全量迁移覆盖范围（28 个模块）
+
+**data-access 层迁移至 cacheFn**（83 个文件，250+ 查询函数）：
+
+| 组别 | 模块 | 备注 |
+|------|------|------|
+| 标杆 | classes | `data-access-{teacher,admin,students,stats,schedule}.ts` 5 文件 |
+| A 组 | users / school / rbac / textbooks / questions / course-plans / files / dashboard / parent / proctoring | 77 个函数 |
+| B 组 | exams / grades / homework / diagnostic / error-book / adaptive-practice | 含跨模块接口（如 exams/data-access-error-collection） |
+| C 组 | lesson-preparation / elective / announcements / messaging / notifications | 24 个函数 |
+
+**actions 层迁移至 invalidateFor**（43 个文件，247 处 revalidatePath 替换）：
+
+| 组别 | 模块 | 替换数 |
+|------|------|--------|
+| 标杆 | classes（5 文件） | 47 |
+| A 组 | users / school / textbooks / questions / course-plans / standards / scheduling / audit / onboarding / invitation-codes / proctoring / i18n（13 文件） | 70 |
+| B 组 | exams / grades / homework / attendance / leave-requests / diagnostic / error-book / adaptive-practice（9 文件） | 77 |
+| C 组 | lesson-preparation / elective / announcements / messaging / notifications / settings / rbac（8 文件） | 100 |
+
+**INVALIDATION_MAP**：扩展至 **203 个 actionId**，覆盖全部 28 个模块。每个 actionId 声明 `{ tags, queryKeys, paths }` 三段副作用。`CLIENT_INVALIDATION_MAP` 同步保留客户端可见子集（仅 queryKeys）。
+
+### 迁移过程中常见错误（速查）
+
+| 规则 | 正确写法 | 错误写法 |
+|------|---------|---------|
+| cacheFn 包装时移除原 `import { cache } from "react"` | 全部改用 `cacheFn` 双导出模式 | 保留 `cache(fn)` 调用但移除 import（tsc 报 `Cannot find name 'cache'`） |
+| 跨模块接口函数（如 `getExamSubmissionDataForErrorCollection`）不包装 cacheFn | 仅包装本模块自有查询；跨模块接口由对方模块决定 | 给跨模块接口也加 cacheFn（重复包装） |
+| 多余的 `}` 或 `)` 字符 | 迁移后用 tsc 全量校验 | 手动编辑后未运行 tsc（TS1005/TS1128 语法错误） |
+| questions/data-access.ts 等大文件分批迁移 | 完整迁移所有 `cache(...)` 调用至 cacheFn | 部分迁移导致 `import { cache }` 已删但调用仍存 |
 
diff --git a/drizzle/0001_questions_fulltext_search.sql b/drizzle/0001_questions_fulltext_search.sql
new file mode 100644
index 0000000..167463b
--- /dev/null
+++ b/drizzle/0001_questions_fulltext_search.sql
@@ -0,0 +1,30 @@
+CREATE TABLE `lesson_plan_schedules` (
+	`id` varchar(128) NOT NULL,
+	`plan_id` varchar(128) NOT NULL,
+	`class_id` varchar(128) NOT NULL,
+	`scheduled_date` date NOT NULL,
+	`period` int NOT NULL,
+	`class_schedule_id` varchar(128),
+	`duration_min` int NOT NULL DEFAULT 40,
+	`created_by` varchar(128) NOT NULL,
+	`created_at` timestamp NOT NULL DEFAULT (now()),
+	`updated_at` timestamp NOT NULL DEFAULT (now()) ON UPDATE CURRENT_TIMESTAMP,
+	CONSTRAINT `lesson_plan_schedules_id` PRIMARY KEY(`id`)
+);
+--> statement-breakpoint
+ALTER TABLE `questions` ADD `content_text` text GENERATED ALWAYS AS (CAST(content AS CHAR)) STORED;--> statement-breakpoint
+ALTER TABLE `lesson_plan_schedules` ADD CONSTRAINT `lesson_plan_schedules_plan_id_lesson_plans_id_fk` FOREIGN KEY (`plan_id`) REFERENCES `lesson_plans`(`id`) ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE `lesson_plan_schedules` ADD CONSTRAINT `lesson_plan_schedules_class_id_classes_id_fk` FOREIGN KEY (`class_id`) REFERENCES `classes`(`id`) ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE `lesson_plan_schedules` ADD CONSTRAINT `lesson_plan_schedules_created_by_users_id_fk` FOREIGN KEY (`created_by`) REFERENCES `users`(`id`) ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX `lpsc_plan_idx` ON `lesson_plan_schedules` (`plan_id`);--> statement-breakpoint
+CREATE INDEX `lpsc_class_date_idx` ON `lesson_plan_schedules` (`class_id`,`scheduled_date`);--> statement-breakpoint
+CREATE INDEX `lpsc_plan_date_idx` ON `lesson_plan_schedules` (`plan_id`,`scheduled_date`);--> statement-breakpoint
+CREATE INDEX `exam_submissions_exam_status_idx` ON `exam_submissions` (`exam_id`,`status`);--> statement-breakpoint
+CREATE INDEX `exam_submissions_submitted_at_idx` ON `exam_submissions` (`submitted_at`);--> statement-breakpoint
+CREATE INDEX `exams_status_created_idx` ON `exams` (`status`,`created_at`);--> statement-breakpoint
+CREATE INDEX `exams_creator_idx` ON `exams` (`creator_id`);--> statement-breakpoint
+CREATE INDEX `questions_type_difficulty_idx` ON `questions` (`type`,`difficulty`);--> statement-breakpoint
+-- P3-6: questions.content_text FULLTEXT 索引（drizzle-kit 无法生成 FULLTEXT 声明，需手动追加）
+-- 要求：InnoDB 引擎 + utf8mb4 字符集（MySQL 5.7+）
+-- 用于 searchQuestions 的 MATCH(content_text) AGAINST(? IN BOOLEAN MODE) 检索
+CREATE FULLTEXT INDEX `questions_content_text_ft_idx` ON `questions` (`content_text`);
\ No newline at end of file
diff --git a/drizzle/meta/0001_snapshot.json b/drizzle/meta/0001_snapshot.json
new file mode 100644
index 0000000..cabc0d2
--- /dev/null
+++ b/drizzle/meta/0001_snapshot.json
@@ -0,0 +1,11740 @@
+{
+  "version": "5",
+  "dialect": "mysql",
+  "id": "7dec45c4-64f9-4dbe-bca7-249559b4c538",
+  "prevId": "8faf42f7-fb86-409b-91be-a8875fb70e27",
+  "tables": {
+    "academic_years": {
+      "name": "academic_years",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "academic_years_name_idx": {
+          "name": "academic_years_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        },
+        "academic_years_active_idx": {
+          "name": "academic_years_active_idx",
+          "columns": [
+            "is_active"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "academic_years_id": {
+          "name": "academic_years_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "academic_years_name_unique": {
+          "name": "academic_years_name_unique",
+          "columns": [
+            "name"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "accounts": {
+      "name": "accounts",
+      "columns": {
+        "userId": {
+          "name": "userId",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "provider": {
+          "name": "provider",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "providerAccountId": {
+          "name": "providerAccountId",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "refresh_token": {
+          "name": "refresh_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "access_token": {
+          "name": "access_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "token_type": {
+          "name": "token_type",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "scope": {
+          "name": "scope",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "id_token": {
+          "name": "id_token",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "session_state": {
+          "name": "session_state",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "account_userId_idx": {
+          "name": "account_userId_idx",
+          "columns": [
+            "userId"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "accounts_userId_users_id_fk": {
+          "name": "accounts_userId_users_id_fk",
+          "tableFrom": "accounts",
+          "tableTo": "users",
+          "columnsFrom": [
+            "userId"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "accounts_provider_providerAccountId_pk": {
+          "name": "accounts_provider_providerAccountId_pk",
+          "columns": [
+            "provider",
+            "providerAccountId"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "ai_providers": {
+      "name": "ai_providers",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "provider": {
+          "name": "provider",
+          "type": "enum('zhipu','openai','gemini','custom','ollama')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "base_url": {
+          "name": "base_url",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "model": {
+          "name": "model",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "api_key_encrypted": {
+          "name": "api_key_encrypted",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "api_key_last4": {
+          "name": "api_key_last4",
+          "type": "varchar(4)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_default": {
+          "name": "is_default",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "visibility": {
+          "name": "visibility",
+          "type": "enum('public','private')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'private'"
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "updated_by": {
+          "name": "updated_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "ai_provider_idx": {
+          "name": "ai_provider_idx",
+          "columns": [
+            "provider"
+          ],
+          "isUnique": false
+        },
+        "ai_provider_default_idx": {
+          "name": "ai_provider_default_idx",
+          "columns": [
+            "is_default"
+          ],
+          "isUnique": false
+        },
+        "ai_provider_visibility_idx": {
+          "name": "ai_provider_visibility_idx",
+          "columns": [
+            "visibility"
+          ],
+          "isUnique": false
+        },
+        "ai_provider_created_by_idx": {
+          "name": "ai_provider_created_by_idx",
+          "columns": [
+            "created_by"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "ai_providers_id": {
+          "name": "ai_providers_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "announcement_reads": {
+      "name": "announcement_reads",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "announcement_id": {
+          "name": "announcement_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "read_at": {
+          "name": "read_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "announcement_reads_announcement_idx": {
+          "name": "announcement_reads_announcement_idx",
+          "columns": [
+            "announcement_id"
+          ],
+          "isUnique": false
+        },
+        "announcement_reads_user_idx": {
+          "name": "announcement_reads_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "announcement_reads_unique_idx": {
+          "name": "announcement_reads_unique_idx",
+          "columns": [
+            "announcement_id",
+            "user_id"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "announcement_reads_announcement_id_announcements_id_fk": {
+          "name": "announcement_reads_announcement_id_announcements_id_fk",
+          "tableFrom": "announcement_reads",
+          "tableTo": "announcements",
+          "columnsFrom": [
+            "announcement_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "announcement_reads_user_id_users_id_fk": {
+          "name": "announcement_reads_user_id_users_id_fk",
+          "tableFrom": "announcement_reads",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "announcement_reads_id": {
+          "name": "announcement_reads_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "announcements": {
+      "name": "announcements",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "enum('school','grade','class')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'school'"
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('draft','published','archived')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "target_grade_id": {
+          "name": "target_grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "target_class_id": {
+          "name": "target_class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "author_id": {
+          "name": "author_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "published_at": {
+          "name": "published_at",
+          "type": "datetime",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_pinned": {
+          "name": "is_pinned",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "announcements_author_idx": {
+          "name": "announcements_author_idx",
+          "columns": [
+            "author_id"
+          ],
+          "isUnique": false
+        },
+        "announcements_status_idx": {
+          "name": "announcements_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "announcements_type_idx": {
+          "name": "announcements_type_idx",
+          "columns": [
+            "type"
+          ],
+          "isUnique": false
+        },
+        "announcements_target_grade_idx": {
+          "name": "announcements_target_grade_idx",
+          "columns": [
+            "target_grade_id"
+          ],
+          "isUnique": false
+        },
+        "announcements_target_class_idx": {
+          "name": "announcements_target_class_idx",
+          "columns": [
+            "target_class_id"
+          ],
+          "isUnique": false
+        },
+        "announcements_status_pinned_idx": {
+          "name": "announcements_status_pinned_idx",
+          "columns": [
+            "status",
+            "is_pinned"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "announcements_author_id_users_id_fk": {
+          "name": "announcements_author_id_users_id_fk",
+          "tableFrom": "announcements",
+          "tableTo": "users",
+          "columnsFrom": [
+            "author_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "announcements_id": {
+          "name": "announcements_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "attendance_records": {
+      "name": "attendance_records",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "schedule_id": {
+          "name": "schedule_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "date": {
+          "name": "date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('present','absent','late','early_leave','excused','school_activity')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "period": {
+          "name": "period",
+          "type": "enum('morning_reading','morning','afternoon','evening','full_day')",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "remark": {
+          "name": "remark",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "recorded_by": {
+          "name": "recorded_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "attendance_records_student_idx": {
+          "name": "attendance_records_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_class_idx": {
+          "name": "attendance_records_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_date_idx": {
+          "name": "attendance_records_date_idx",
+          "columns": [
+            "date"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_class_date_idx": {
+          "name": "attendance_records_class_date_idx",
+          "columns": [
+            "class_id",
+            "date"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_student_date_idx": {
+          "name": "attendance_records_student_date_idx",
+          "columns": [
+            "student_id",
+            "date"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_schedule_idx": {
+          "name": "attendance_records_schedule_idx",
+          "columns": [
+            "schedule_id"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_recorded_by_idx": {
+          "name": "attendance_records_recorded_by_idx",
+          "columns": [
+            "recorded_by"
+          ],
+          "isUnique": false
+        },
+        "attendance_records_class_date_period_idx": {
+          "name": "attendance_records_class_date_period_idx",
+          "columns": [
+            "class_id",
+            "date",
+            "period"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "attendance_records_student_id_users_id_fk": {
+          "name": "attendance_records_student_id_users_id_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "attendance_records_class_id_classes_id_fk": {
+          "name": "attendance_records_class_id_classes_id_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "attendance_records_recorded_by_users_id_fk": {
+          "name": "attendance_records_recorded_by_users_id_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "recorded_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "ar_c_fk": {
+          "name": "ar_c_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "ar_s_fk": {
+          "name": "ar_s_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "ar_rb_fk": {
+          "name": "ar_rb_fk",
+          "tableFrom": "attendance_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "recorded_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "attendance_records_id": {
+          "name": "attendance_records_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "attendance_rules": {
+      "name": "attendance_rules",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "late_threshold_minutes": {
+          "name": "late_threshold_minutes",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 15
+        },
+        "early_leave_threshold_minutes": {
+          "name": "early_leave_threshold_minutes",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 15
+        },
+        "enable_auto_mark": {
+          "name": "enable_auto_mark",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": false
+        },
+        "attendance_rate_threshold": {
+          "name": "attendance_rate_threshold",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 90
+        },
+        "consecutive_absence_threshold": {
+          "name": "consecutive_absence_threshold",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 3
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true
+        }
+      },
+      "indexes": {
+        "attendance_rules_class_idx": {
+          "name": "attendance_rules_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "attendance_rules_class_id_classes_id_fk": {
+          "name": "attendance_rules_class_id_classes_id_fk",
+          "tableFrom": "attendance_rules",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "atr_c_fk": {
+          "name": "atr_c_fk",
+          "tableFrom": "attendance_rules",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "attendance_rules_id": {
+          "name": "attendance_rules_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "audit_logs": {
+      "name": "audit_logs",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_name": {
+          "name": "user_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "action": {
+          "name": "action",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "module": {
+          "name": "module",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "target_id": {
+          "name": "target_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "target_type": {
+          "name": "target_type",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "detail": {
+          "name": "detail",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "ip_address": {
+          "name": "ip_address",
+          "type": "varchar(45)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "user_agent": {
+          "name": "user_agent",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('success','failure')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'success'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "audit_logs_user_id_idx": {
+          "name": "audit_logs_user_id_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "audit_logs_module_idx": {
+          "name": "audit_logs_module_idx",
+          "columns": [
+            "module"
+          ],
+          "isUnique": false
+        },
+        "audit_logs_action_idx": {
+          "name": "audit_logs_action_idx",
+          "columns": [
+            "action"
+          ],
+          "isUnique": false
+        },
+        "audit_logs_status_idx": {
+          "name": "audit_logs_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "audit_logs_created_at_idx": {
+          "name": "audit_logs_created_at_idx",
+          "columns": [
+            "created_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "audit_logs_id": {
+          "name": "audit_logs_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "chapters": {
+      "name": "chapters",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "textbook_id": {
+          "name": "textbook_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "textbook_idx": {
+          "name": "textbook_idx",
+          "columns": [
+            "textbook_id"
+          ],
+          "isUnique": false
+        },
+        "parent_id_idx": {
+          "name": "parent_id_idx",
+          "columns": [
+            "parent_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "chapters_textbook_id_textbooks_id_fk": {
+          "name": "chapters_textbook_id_textbooks_id_fk",
+          "tableFrom": "chapters",
+          "tableTo": "textbooks",
+          "columnsFrom": [
+            "textbook_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "chapters_id": {
+          "name": "chapters_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "class_enrollments": {
+      "name": "class_enrollments",
+      "columns": {
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_enrollment_status": {
+          "name": "class_enrollment_status",
+          "type": "enum('active','inactive')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'active'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "class_enrollments_class_idx": {
+          "name": "class_enrollments_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "class_enrollments_student_idx": {
+          "name": "class_enrollments_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "ce_c_fk": {
+          "name": "ce_c_fk",
+          "tableFrom": "class_enrollments",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "ce_s_fk": {
+          "name": "ce_s_fk",
+          "tableFrom": "class_enrollments",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "class_enrollments_class_id_student_id_pk": {
+          "name": "class_enrollments_class_id_student_id_pk",
+          "columns": [
+            "class_id",
+            "student_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "class_invitation_codes": {
+      "name": "class_invitation_codes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "varchar(8)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_invitation_code_status": {
+          "name": "class_invitation_code_status",
+          "type": "enum('active','disabled','expired','exhausted')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'active'"
+        },
+        "max_uses": {
+          "name": "max_uses",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "used_count": {
+          "name": "used_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        },
+        "revoked_at": {
+          "name": "revoked_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "revoked_by": {
+          "name": "revoked_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "note": {
+          "name": "note",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "class_invitation_codes_code_idx": {
+          "name": "class_invitation_codes_code_idx",
+          "columns": [
+            "code"
+          ],
+          "isUnique": true
+        },
+        "class_invitation_codes_class_idx": {
+          "name": "class_invitation_codes_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "class_invitation_codes_status_expires_idx": {
+          "name": "class_invitation_codes_status_expires_idx",
+          "columns": [
+            "class_invitation_code_status",
+            "expires_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "class_invitation_codes_class_id_classes_id_fk": {
+          "name": "class_invitation_codes_class_id_classes_id_fk",
+          "tableFrom": "class_invitation_codes",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "class_invitation_codes_created_by_users_id_fk": {
+          "name": "class_invitation_codes_created_by_users_id_fk",
+          "tableFrom": "class_invitation_codes",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cic_c_fk": {
+          "name": "cic_c_fk",
+          "tableFrom": "class_invitation_codes",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "class_invitation_codes_id": {
+          "name": "class_invitation_codes_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "class_invitation_codes_code_unique": {
+          "name": "class_invitation_codes_code_unique",
+          "columns": [
+            "code"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "class_schedule": {
+      "name": "class_schedule",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "weekday": {
+          "name": "weekday",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_time": {
+          "name": "start_time",
+          "type": "varchar(5)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_time": {
+          "name": "end_time",
+          "type": "varchar(5)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "course": {
+          "name": "course",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "location": {
+          "name": "location",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "class_schedule_class_idx": {
+          "name": "class_schedule_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "class_schedule_class_day_idx": {
+          "name": "class_schedule_class_day_idx",
+          "columns": [
+            "class_id",
+            "weekday"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "cs_c_fk": {
+          "name": "cs_c_fk",
+          "tableFrom": "class_schedule",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "class_schedule_id": {
+          "name": "class_schedule_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "class_subject_teachers": {
+      "name": "class_subject_teachers",
+      "columns": {
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "teacher_id": {
+          "name": "teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "class_subject_teachers_class_idx": {
+          "name": "class_subject_teachers_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "class_subject_teachers_teacher_idx": {
+          "name": "class_subject_teachers_teacher_idx",
+          "columns": [
+            "teacher_id"
+          ],
+          "isUnique": false
+        },
+        "class_subject_teachers_subject_id_idx": {
+          "name": "class_subject_teachers_subject_id_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "class_subject_teachers_teacher_id_users_id_fk": {
+          "name": "class_subject_teachers_teacher_id_users_id_fk",
+          "tableFrom": "class_subject_teachers",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "cst_c_fk": {
+          "name": "cst_c_fk",
+          "tableFrom": "class_subject_teachers",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cst_s_fk": {
+          "name": "cst_s_fk",
+          "tableFrom": "class_subject_teachers",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "class_subject_teachers_class_id_subject_id_pk": {
+          "name": "class_subject_teachers_class_id_subject_id_pk",
+          "columns": [
+            "class_id",
+            "subject_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "classes": {
+      "name": "classes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "school_name": {
+          "name": "school_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "school_id": {
+          "name": "school_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade": {
+          "name": "grade",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "homeroom": {
+          "name": "homeroom",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "room": {
+          "name": "room",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "invitation_code": {
+          "name": "invitation_code",
+          "type": "varchar(6)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "teacher_id": {
+          "name": "teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "classes_teacher_idx": {
+          "name": "classes_teacher_idx",
+          "columns": [
+            "teacher_id"
+          ],
+          "isUnique": false
+        },
+        "classes_grade_idx": {
+          "name": "classes_grade_idx",
+          "columns": [
+            "grade"
+          ],
+          "isUnique": false
+        },
+        "classes_school_idx": {
+          "name": "classes_school_idx",
+          "columns": [
+            "school_id"
+          ],
+          "isUnique": false
+        },
+        "classes_grade_id_idx": {
+          "name": "classes_grade_id_idx",
+          "columns": [
+            "grade_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "classes_teacher_id_users_id_fk": {
+          "name": "classes_teacher_id_users_id_fk",
+          "tableFrom": "classes",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "c_s_fk": {
+          "name": "c_s_fk",
+          "tableFrom": "classes",
+          "tableTo": "schools",
+          "columnsFrom": [
+            "school_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "c_g_fk": {
+          "name": "c_g_fk",
+          "tableFrom": "classes",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "classes_id": {
+          "name": "classes_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "classes_invitation_code_unique": {
+          "name": "classes_invitation_code_unique",
+          "columns": [
+            "invitation_code"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "classrooms": {
+      "name": "classrooms",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "building": {
+          "name": "building",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "floor": {
+          "name": "floor",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "capacity": {
+          "name": "capacity",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "classrooms_name_idx": {
+          "name": "classrooms_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "classrooms_id": {
+          "name": "classrooms_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "classrooms_name_unique": {
+          "name": "classrooms_name_unique",
+          "columns": [
+            "name"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "course_plan_items": {
+      "name": "course_plan_items",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "week": {
+          "name": "week",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "topic": {
+          "name": "topic",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "hours": {
+          "name": "hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 2
+        },
+        "textbook_chapter": {
+          "name": "textbook_chapter",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "notes": {
+          "name": "notes",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_completed": {
+          "name": "is_completed",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "completed_at": {
+          "name": "completed_at",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "course_plan_items_plan_idx": {
+          "name": "course_plan_items_plan_idx",
+          "columns": [
+            "plan_id"
+          ],
+          "isUnique": false
+        },
+        "course_plan_items_plan_week_idx": {
+          "name": "course_plan_items_plan_week_idx",
+          "columns": [
+            "plan_id",
+            "week"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "course_plan_items_plan_id_course_plans_id_fk": {
+          "name": "course_plan_items_plan_id_course_plans_id_fk",
+          "tableFrom": "course_plan_items",
+          "tableTo": "course_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cpi_p_fk": {
+          "name": "cpi_p_fk",
+          "tableFrom": "course_plan_items",
+          "tableTo": "course_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "course_plan_items_id": {
+          "name": "course_plan_items_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "course_plans": {
+      "name": "course_plans",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "teacher_id": {
+          "name": "teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "academic_year_id": {
+          "name": "academic_year_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "semester": {
+          "name": "semester",
+          "type": "enum('1','2')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'1'"
+        },
+        "total_hours": {
+          "name": "total_hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "completed_hours": {
+          "name": "completed_hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "weekly_hours": {
+          "name": "weekly_hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "syllabus": {
+          "name": "syllabus",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "objectives": {
+          "name": "objectives",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('planning','active','completed','paused')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'planning'"
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "course_plans_class_idx": {
+          "name": "course_plans_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "course_plans_teacher_idx": {
+          "name": "course_plans_teacher_idx",
+          "columns": [
+            "teacher_id"
+          ],
+          "isUnique": false
+        },
+        "course_plans_subject_idx": {
+          "name": "course_plans_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "course_plans_status_idx": {
+          "name": "course_plans_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "course_plans_class_subject_idx": {
+          "name": "course_plans_class_subject_idx",
+          "columns": [
+            "class_id",
+            "subject_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "course_plans_class_id_classes_id_fk": {
+          "name": "course_plans_class_id_classes_id_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "course_plans_subject_id_subjects_id_fk": {
+          "name": "course_plans_subject_id_subjects_id_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "course_plans_teacher_id_users_id_fk": {
+          "name": "course_plans_teacher_id_users_id_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "course_plans_created_by_users_id_fk": {
+          "name": "course_plans_created_by_users_id_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cp_c_fk": {
+          "name": "cp_c_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cp_s_fk": {
+          "name": "cp_s_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cp_t_fk": {
+          "name": "cp_t_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "cp_cb_fk": {
+          "name": "cp_cb_fk",
+          "tableFrom": "course_plans",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "course_plans_id": {
+          "name": "course_plans_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "course_selections": {
+      "name": "course_selections",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "course_id": {
+          "name": "course_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "selection_status": {
+          "name": "selection_status",
+          "type": "enum('selected','enrolled','waitlist','dropped','rejected')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'selected'"
+        },
+        "priority": {
+          "name": "priority",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 1
+        },
+        "selected_at": {
+          "name": "selected_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "enrolled_at": {
+          "name": "enrolled_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "dropped_at": {
+          "name": "dropped_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "drop_reason": {
+          "name": "drop_reason",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "lottery_rank": {
+          "name": "lottery_rank",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "course_selections_course_idx": {
+          "name": "course_selections_course_idx",
+          "columns": [
+            "course_id"
+          ],
+          "isUnique": false
+        },
+        "course_selections_student_idx": {
+          "name": "course_selections_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "course_selections_status_idx": {
+          "name": "course_selections_status_idx",
+          "columns": [
+            "selection_status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "course_selections_course_id_elective_courses_id_fk": {
+          "name": "course_selections_course_id_elective_courses_id_fk",
+          "tableFrom": "course_selections",
+          "tableTo": "elective_courses",
+          "columnsFrom": [
+            "course_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "course_selections_student_id_users_id_fk": {
+          "name": "course_selections_student_id_users_id_fk",
+          "tableFrom": "course_selections",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "course_selections_id": {
+          "name": "course_selections_id",
+          "columns": [
+            "id"
+          ]
+        },
+        "course_selections_course_id_student_id_pk": {
+          "name": "course_selections_course_id_student_id_pk",
+          "columns": [
+            "course_id",
+            "student_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "data_change_logs": {
+      "name": "data_change_logs",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "table_name": {
+          "name": "table_name",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "record_id": {
+          "name": "record_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "action": {
+          "name": "action",
+          "type": "enum('create','update','delete')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "old_value": {
+          "name": "old_value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_value": {
+          "name": "new_value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "changed_by": {
+          "name": "changed_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "changed_by_name": {
+          "name": "changed_by_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "ip_address": {
+          "name": "ip_address",
+          "type": "varchar(45)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "data_change_logs_table_name_idx": {
+          "name": "data_change_logs_table_name_idx",
+          "columns": [
+            "table_name"
+          ],
+          "isUnique": false
+        },
+        "data_change_logs_record_id_idx": {
+          "name": "data_change_logs_record_id_idx",
+          "columns": [
+            "record_id"
+          ],
+          "isUnique": false
+        },
+        "data_change_logs_action_idx": {
+          "name": "data_change_logs_action_idx",
+          "columns": [
+            "action"
+          ],
+          "isUnique": false
+        },
+        "data_change_logs_changed_by_idx": {
+          "name": "data_change_logs_changed_by_idx",
+          "columns": [
+            "changed_by"
+          ],
+          "isUnique": false
+        },
+        "data_change_logs_created_at_idx": {
+          "name": "data_change_logs_created_at_idx",
+          "columns": [
+            "created_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "data_change_logs_id": {
+          "name": "data_change_logs_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "departments": {
+      "name": "departments",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "departments_name_idx": {
+          "name": "departments_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "departments_id": {
+          "name": "departments_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "departments_name_unique": {
+          "name": "departments_name_unique",
+          "columns": [
+            "name"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "elective_courses": {
+      "name": "elective_courses",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "teacher_id": {
+          "name": "teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "capacity": {
+          "name": "capacity",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 30
+        },
+        "enrolled_count": {
+          "name": "enrolled_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "classroom": {
+          "name": "classroom",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "schedule": {
+          "name": "schedule",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "selection_start_at": {
+          "name": "selection_start_at",
+          "type": "datetime",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "selection_end_at": {
+          "name": "selection_end_at",
+          "type": "datetime",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "drop_deadline": {
+          "name": "drop_deadline",
+          "type": "datetime",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('draft','open','closed','cancelled')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "selection_mode": {
+          "name": "selection_mode",
+          "type": "enum('fcfs','lottery')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'fcfs'"
+        },
+        "credit": {
+          "name": "credit",
+          "type": "decimal(3,1)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'1.0'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "elective_courses_teacher_idx": {
+          "name": "elective_courses_teacher_idx",
+          "columns": [
+            "teacher_id"
+          ],
+          "isUnique": false
+        },
+        "elective_courses_subject_idx": {
+          "name": "elective_courses_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "elective_courses_grade_idx": {
+          "name": "elective_courses_grade_idx",
+          "columns": [
+            "grade_id"
+          ],
+          "isUnique": false
+        },
+        "elective_courses_status_idx": {
+          "name": "elective_courses_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "elective_courses_subject_id_subjects_id_fk": {
+          "name": "elective_courses_subject_id_subjects_id_fk",
+          "tableFrom": "elective_courses",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "elective_courses_teacher_id_users_id_fk": {
+          "name": "elective_courses_teacher_id_users_id_fk",
+          "tableFrom": "elective_courses",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "elective_courses_grade_id_grades_id_fk": {
+          "name": "elective_courses_grade_id_grades_id_fk",
+          "tableFrom": "elective_courses",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "elective_courses_id": {
+          "name": "elective_courses_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "error_book_items": {
+      "name": "error_book_items",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "source_type": {
+          "name": "source_type",
+          "type": "enum('exam','homework','manual')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'manual'"
+        },
+        "source_id": {
+          "name": "source_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "student_answer": {
+          "name": "student_answer",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "correct_answer": {
+          "name": "correct_answer",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "knowledge_point_ids": {
+          "name": "knowledge_point_ids",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "error_status": {
+          "name": "error_status",
+          "type": "enum('new','learning','mastered','archived')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'new'"
+        },
+        "mastery_level": {
+          "name": "mastery_level",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "next_review_at": {
+          "name": "next_review_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "review_interval": {
+          "name": "review_interval",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "review_count": {
+          "name": "review_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "correct_streak": {
+          "name": "correct_streak",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "note": {
+          "name": "note",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "error_tags": {
+          "name": "error_tags",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "eb_item_student_idx": {
+          "name": "eb_item_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "eb_item_student_status_idx": {
+          "name": "eb_item_student_status_idx",
+          "columns": [
+            "student_id",
+            "error_status"
+          ],
+          "isUnique": false
+        },
+        "eb_item_student_review_idx": {
+          "name": "eb_item_student_review_idx",
+          "columns": [
+            "student_id",
+            "next_review_at"
+          ],
+          "isUnique": false
+        },
+        "eb_item_question_idx": {
+          "name": "eb_item_question_idx",
+          "columns": [
+            "question_id"
+          ],
+          "isUnique": false
+        },
+        "eb_item_subject_idx": {
+          "name": "eb_item_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "eb_item_source_idx": {
+          "name": "eb_item_source_idx",
+          "columns": [
+            "source_type",
+            "source_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "error_book_items_student_id_users_id_fk": {
+          "name": "error_book_items_student_id_users_id_fk",
+          "tableFrom": "error_book_items",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "error_book_items_question_id_questions_id_fk": {
+          "name": "error_book_items_question_id_questions_id_fk",
+          "tableFrom": "error_book_items",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "error_book_items_id": {
+          "name": "error_book_items_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "error_book_reviews": {
+      "name": "error_book_reviews",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "item_id": {
+          "name": "item_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "review_result": {
+          "name": "review_result",
+          "type": "enum('again','hard','good','easy')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reviewed_at": {
+          "name": "reviewed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "new_interval": {
+          "name": "new_interval",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_mastery_level": {
+          "name": "new_mastery_level",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "eb_review_item_idx": {
+          "name": "eb_review_item_idx",
+          "columns": [
+            "item_id"
+          ],
+          "isUnique": false
+        },
+        "eb_review_student_idx": {
+          "name": "eb_review_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "eb_review_student_reviewed_idx": {
+          "name": "eb_review_student_reviewed_idx",
+          "columns": [
+            "student_id",
+            "reviewed_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "error_book_reviews_item_id_error_book_items_id_fk": {
+          "name": "error_book_reviews_item_id_error_book_items_id_fk",
+          "tableFrom": "error_book_reviews",
+          "tableTo": "error_book_items",
+          "columnsFrom": [
+            "item_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "error_book_reviews_student_id_users_id_fk": {
+          "name": "error_book_reviews_student_id_users_id_fk",
+          "tableFrom": "error_book_reviews",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "error_book_reviews_id": {
+          "name": "error_book_reviews_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "exam_proctoring_events": {
+      "name": "exam_proctoring_events",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "submission_id": {
+          "name": "submission_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "exam_id": {
+          "name": "exam_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "event_type": {
+          "name": "event_type",
+          "type": "enum('tab_switch','window_blur','copy_attempt','paste_attempt','right_click','devtools_open','fullscreen_exit','idle_timeout')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "event_detail": {
+          "name": "event_detail",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "occurred_at": {
+          "name": "occurred_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "proctoring_submission_idx": {
+          "name": "proctoring_submission_idx",
+          "columns": [
+            "submission_id"
+          ],
+          "isUnique": false
+        },
+        "proctoring_student_idx": {
+          "name": "proctoring_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "proctoring_exam_idx": {
+          "name": "proctoring_exam_idx",
+          "columns": [
+            "exam_id"
+          ],
+          "isUnique": false
+        },
+        "proctoring_event_type_idx": {
+          "name": "proctoring_event_type_idx",
+          "columns": [
+            "event_type"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "exam_proctoring_events_submission_id_exam_submissions_id_fk": {
+          "name": "exam_proctoring_events_submission_id_exam_submissions_id_fk",
+          "tableFrom": "exam_proctoring_events",
+          "tableTo": "exam_submissions",
+          "columnsFrom": [
+            "submission_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "exam_proctoring_events_student_id_users_id_fk": {
+          "name": "exam_proctoring_events_student_id_users_id_fk",
+          "tableFrom": "exam_proctoring_events",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "exam_proctoring_events_exam_id_exams_id_fk": {
+          "name": "exam_proctoring_events_exam_id_exams_id_fk",
+          "tableFrom": "exam_proctoring_events",
+          "tableTo": "exams",
+          "columnsFrom": [
+            "exam_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "exam_proctoring_events_id": {
+          "name": "exam_proctoring_events_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "exam_questions": {
+      "name": "exam_questions",
+      "columns": {
+        "exam_id": {
+          "name": "exam_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "exam_questions_exam_id_exams_id_fk": {
+          "name": "exam_questions_exam_id_exams_id_fk",
+          "tableFrom": "exam_questions",
+          "tableTo": "exams",
+          "columnsFrom": [
+            "exam_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "exam_questions_question_id_questions_id_fk": {
+          "name": "exam_questions_question_id_questions_id_fk",
+          "tableFrom": "exam_questions",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "exam_questions_exam_id_question_id_pk": {
+          "name": "exam_questions_exam_id_question_id_pk",
+          "columns": [
+            "exam_id",
+            "question_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "exam_submissions": {
+      "name": "exam_submissions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "exam_id": {
+          "name": "exam_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'started'"
+        },
+        "submitted_at": {
+          "name": "submitted_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "exam_student_idx": {
+          "name": "exam_student_idx",
+          "columns": [
+            "exam_id",
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "exam_submissions_exam_status_idx": {
+          "name": "exam_submissions_exam_status_idx",
+          "columns": [
+            "exam_id",
+            "status"
+          ],
+          "isUnique": false
+        },
+        "exam_submissions_submitted_at_idx": {
+          "name": "exam_submissions_submitted_at_idx",
+          "columns": [
+            "submitted_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "exam_submissions_exam_id_exams_id_fk": {
+          "name": "exam_submissions_exam_id_exams_id_fk",
+          "tableFrom": "exam_submissions",
+          "tableTo": "exams",
+          "columnsFrom": [
+            "exam_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "exam_submissions_student_id_users_id_fk": {
+          "name": "exam_submissions_student_id_users_id_fk",
+          "tableFrom": "exam_submissions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "exam_submissions_id": {
+          "name": "exam_submissions_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "exams": {
+      "name": "exams",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "structure": {
+          "name": "structure",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "creator_id": {
+          "name": "creator_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "start_time": {
+          "name": "start_time",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "end_time": {
+          "name": "end_time",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "exam_mode": {
+          "name": "exam_mode",
+          "type": "enum('homework','timed','proctored')",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'homework'"
+        },
+        "duration_minutes": {
+          "name": "duration_minutes",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "shuffle_questions": {
+          "name": "shuffle_questions",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": false
+        },
+        "allow_late_start": {
+          "name": "allow_late_start",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": false
+        },
+        "late_start_grace_minutes": {
+          "name": "late_start_grace_minutes",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "anti_cheat_enabled": {
+          "name": "anti_cheat_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "exams_subject_idx": {
+          "name": "exams_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "exams_grade_idx": {
+          "name": "exams_grade_idx",
+          "columns": [
+            "grade_id"
+          ],
+          "isUnique": false
+        },
+        "exams_status_created_idx": {
+          "name": "exams_status_created_idx",
+          "columns": [
+            "status",
+            "created_at"
+          ],
+          "isUnique": false
+        },
+        "exams_creator_idx": {
+          "name": "exams_creator_idx",
+          "columns": [
+            "creator_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "exams_creator_id_users_id_fk": {
+          "name": "exams_creator_id_users_id_fk",
+          "tableFrom": "exams",
+          "tableTo": "users",
+          "columnsFrom": [
+            "creator_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "exams_subject_id_subjects_id_fk": {
+          "name": "exams_subject_id_subjects_id_fk",
+          "tableFrom": "exams",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "exams_grade_id_grades_id_fk": {
+          "name": "exams_grade_id_grades_id_fk",
+          "tableFrom": "exams",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "exams_id": {
+          "name": "exams_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "file_attachments": {
+      "name": "file_attachments",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "filename": {
+          "name": "filename",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "original_name": {
+          "name": "original_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "mime_type": {
+          "name": "mime_type",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "size": {
+          "name": "size",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "storage_path": {
+          "name": "storage_path",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "url": {
+          "name": "url",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "uploader_id": {
+          "name": "uploader_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "target_type": {
+          "name": "target_type",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "target_id": {
+          "name": "target_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "file_attachments_uploader_idx": {
+          "name": "file_attachments_uploader_idx",
+          "columns": [
+            "uploader_id"
+          ],
+          "isUnique": false
+        },
+        "file_attachments_target_idx": {
+          "name": "file_attachments_target_idx",
+          "columns": [
+            "target_type",
+            "target_id"
+          ],
+          "isUnique": false
+        },
+        "file_attachments_created_at_idx": {
+          "name": "file_attachments_created_at_idx",
+          "columns": [
+            "created_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "file_attachments_uploader_id_users_id_fk": {
+          "name": "file_attachments_uploader_id_users_id_fk",
+          "tableFrom": "file_attachments",
+          "tableTo": "users",
+          "columnsFrom": [
+            "uploader_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "file_attachments_id": {
+          "name": "file_attachments_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "grade_appeals": {
+      "name": "grade_appeals",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade_record_id": {
+          "name": "grade_record_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "original_score": {
+          "name": "original_score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "expected_score": {
+          "name": "expected_score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "appeal_status": {
+          "name": "appeal_status",
+          "type": "enum('pending','approved','rejected','withdrawn')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "reviewer_id": {
+          "name": "reviewer_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "review_comment": {
+          "name": "review_comment",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "adjusted_score": {
+          "name": "adjusted_score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reviewed_at": {
+          "name": "reviewed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "ga_grade_record_idx": {
+          "name": "ga_grade_record_idx",
+          "columns": [
+            "grade_record_id"
+          ],
+          "isUnique": false
+        },
+        "ga_student_idx": {
+          "name": "ga_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "ga_status_idx": {
+          "name": "ga_status_idx",
+          "columns": [
+            "appeal_status"
+          ],
+          "isUnique": false
+        },
+        "ga_reviewer_idx": {
+          "name": "ga_reviewer_idx",
+          "columns": [
+            "reviewer_id"
+          ],
+          "isUnique": false
+        },
+        "ga_pending_lookup_idx": {
+          "name": "ga_pending_lookup_idx",
+          "columns": [
+            "grade_record_id",
+            "appeal_status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "grade_appeals_grade_record_id_grade_records_id_fk": {
+          "name": "grade_appeals_grade_record_id_grade_records_id_fk",
+          "tableFrom": "grade_appeals",
+          "tableTo": "grade_records",
+          "columnsFrom": [
+            "grade_record_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_appeals_student_id_users_id_fk": {
+          "name": "grade_appeals_student_id_users_id_fk",
+          "tableFrom": "grade_appeals",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_appeals_reviewer_id_users_id_fk": {
+          "name": "grade_appeals_reviewer_id_users_id_fk",
+          "tableFrom": "grade_appeals",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reviewer_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "grade_appeals_id": {
+          "name": "grade_appeals_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "grade_drafts": {
+      "name": "grade_drafts",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        },
+        "locked_by": {
+          "name": "locked_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "locked_at": {
+          "name": "locked_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "lock_token": {
+          "name": "lock_token",
+          "type": "varchar(64)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "gd_user_class_subject_type_idx": {
+          "name": "gd_user_class_subject_type_idx",
+          "columns": [
+            "user_id",
+            "class_id",
+            "subject_id",
+            "type"
+          ],
+          "isUnique": true
+        },
+        "gd_user_updated_idx": {
+          "name": "gd_user_updated_idx",
+          "columns": [
+            "user_id",
+            "updated_at"
+          ],
+          "isUnique": false
+        },
+        "gd_class_subject_lock_idx": {
+          "name": "gd_class_subject_lock_idx",
+          "columns": [
+            "class_id",
+            "subject_id",
+            "type",
+            "locked_by"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "grade_drafts_user_id_users_id_fk": {
+          "name": "grade_drafts_user_id_users_id_fk",
+          "tableFrom": "grade_drafts",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_drafts_class_id_classes_id_fk": {
+          "name": "grade_drafts_class_id_classes_id_fk",
+          "tableFrom": "grade_drafts",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_drafts_subject_id_subjects_id_fk": {
+          "name": "grade_drafts_subject_id_subjects_id_fk",
+          "tableFrom": "grade_drafts",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "grade_drafts_id": {
+          "name": "grade_drafts_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "grade_record_answers": {
+      "name": "grade_record_answers",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade_record_id": {
+          "name": "grade_record_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "full_score": {
+          "name": "full_score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "feedback": {
+          "name": "feedback",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "grade_record_answers_record_idx": {
+          "name": "grade_record_answers_record_idx",
+          "columns": [
+            "grade_record_id"
+          ],
+          "isUnique": false
+        },
+        "grade_record_answers_question_idx": {
+          "name": "grade_record_answers_question_idx",
+          "columns": [
+            "question_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "grade_record_answers_grade_record_id_grade_records_id_fk": {
+          "name": "grade_record_answers_grade_record_id_grade_records_id_fk",
+          "tableFrom": "grade_record_answers",
+          "tableTo": "grade_records",
+          "columnsFrom": [
+            "grade_record_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_record_answers_question_id_questions_id_fk": {
+          "name": "grade_record_answers_question_id_questions_id_fk",
+          "tableFrom": "grade_record_answers",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gra_gr_fk": {
+          "name": "gra_gr_fk",
+          "tableFrom": "grade_record_answers",
+          "tableTo": "grade_records",
+          "columnsFrom": [
+            "grade_record_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gra_q_fk": {
+          "name": "gra_q_fk",
+          "tableFrom": "grade_record_answers",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "grade_record_answers_id": {
+          "name": "grade_record_answers_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "grade_records": {
+      "name": "grade_records",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "exam_id": {
+          "name": "exam_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "academic_year_id": {
+          "name": "academic_year_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "full_score": {
+          "name": "full_score",
+          "type": "decimal(6,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'100'"
+        },
+        "type": {
+          "name": "type",
+          "type": "enum('exam','quiz','homework','other')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'exam'"
+        },
+        "semester": {
+          "name": "semester",
+          "type": "enum('1','2')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'1'"
+        },
+        "recorded_by": {
+          "name": "recorded_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "remark": {
+          "name": "remark",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "grade_records_student_idx": {
+          "name": "grade_records_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "grade_records_class_idx": {
+          "name": "grade_records_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "grade_records_subject_idx": {
+          "name": "grade_records_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "grade_records_exam_idx": {
+          "name": "grade_records_exam_idx",
+          "columns": [
+            "exam_id"
+          ],
+          "isUnique": false
+        },
+        "grade_records_class_subject_idx": {
+          "name": "grade_records_class_subject_idx",
+          "columns": [
+            "class_id",
+            "subject_id"
+          ],
+          "isUnique": false
+        },
+        "grade_records_recorded_by_idx": {
+          "name": "grade_records_recorded_by_idx",
+          "columns": [
+            "recorded_by"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "grade_records_student_id_users_id_fk": {
+          "name": "grade_records_student_id_users_id_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_records_class_id_classes_id_fk": {
+          "name": "grade_records_class_id_classes_id_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_records_subject_id_subjects_id_fk": {
+          "name": "grade_records_subject_id_subjects_id_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "grade_records_recorded_by_users_id_fk": {
+          "name": "grade_records_recorded_by_users_id_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "recorded_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gr_c_fk": {
+          "name": "gr_c_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gr_s_fk": {
+          "name": "gr_s_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gr_sub_fk": {
+          "name": "gr_sub_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "gr_rb_fk": {
+          "name": "gr_rb_fk",
+          "tableFrom": "grade_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "recorded_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "grade_records_id": {
+          "name": "grade_records_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "grades": {
+      "name": "grades",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "school_id": {
+          "name": "school_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "grade_head_id": {
+          "name": "grade_head_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "teaching_head_id": {
+          "name": "teaching_head_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "grades_school_idx": {
+          "name": "grades_school_idx",
+          "columns": [
+            "school_id"
+          ],
+          "isUnique": false
+        },
+        "grades_school_name_uniq": {
+          "name": "grades_school_name_uniq",
+          "columns": [
+            "school_id",
+            "name"
+          ],
+          "isUnique": false
+        },
+        "grades_grade_head_idx": {
+          "name": "grades_grade_head_idx",
+          "columns": [
+            "grade_head_id"
+          ],
+          "isUnique": false
+        },
+        "grades_teaching_head_idx": {
+          "name": "grades_teaching_head_idx",
+          "columns": [
+            "teaching_head_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "g_s_fk": {
+          "name": "g_s_fk",
+          "tableFrom": "grades",
+          "tableTo": "schools",
+          "columnsFrom": [
+            "school_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "g_gh_fk": {
+          "name": "g_gh_fk",
+          "tableFrom": "grades",
+          "tableTo": "users",
+          "columnsFrom": [
+            "grade_head_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "g_th_fk": {
+          "name": "g_th_fk",
+          "tableFrom": "grades",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teaching_head_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "grades_id": {
+          "name": "grades_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "homework_answers": {
+      "name": "homework_answers",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "submission_id": {
+          "name": "submission_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "answer_content": {
+          "name": "answer_content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "feedback": {
+          "name": "feedback",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "hw_answer_submission_idx": {
+          "name": "hw_answer_submission_idx",
+          "columns": [
+            "submission_id"
+          ],
+          "isUnique": false
+        },
+        "hw_answer_submission_question_idx": {
+          "name": "hw_answer_submission_question_idx",
+          "columns": [
+            "submission_id",
+            "question_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "hw_ans_sub_fk": {
+          "name": "hw_ans_sub_fk",
+          "tableFrom": "homework_answers",
+          "tableTo": "homework_submissions",
+          "columnsFrom": [
+            "submission_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "hw_ans_q_fk": {
+          "name": "hw_ans_q_fk",
+          "tableFrom": "homework_answers",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "homework_answers_id": {
+          "name": "homework_answers_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "homework_assignment_questions": {
+      "name": "homework_assignment_questions",
+      "columns": {
+        "assignment_id": {
+          "name": "assignment_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        }
+      },
+      "indexes": {
+        "hw_assignment_questions_assignment_idx": {
+          "name": "hw_assignment_questions_assignment_idx",
+          "columns": [
+            "assignment_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "hw_aq_a_fk": {
+          "name": "hw_aq_a_fk",
+          "tableFrom": "homework_assignment_questions",
+          "tableTo": "homework_assignments",
+          "columnsFrom": [
+            "assignment_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "hw_aq_q_fk": {
+          "name": "hw_aq_q_fk",
+          "tableFrom": "homework_assignment_questions",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "homework_assignment_questions_assignment_id_question_id_pk": {
+          "name": "homework_assignment_questions_assignment_id_question_id_pk",
+          "columns": [
+            "assignment_id",
+            "question_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "homework_assignment_targets": {
+      "name": "homework_assignment_targets",
+      "columns": {
+        "assignment_id": {
+          "name": "assignment_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "hw_assignment_targets_assignment_idx": {
+          "name": "hw_assignment_targets_assignment_idx",
+          "columns": [
+            "assignment_id"
+          ],
+          "isUnique": false
+        },
+        "hw_assignment_targets_student_idx": {
+          "name": "hw_assignment_targets_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "hw_at_a_fk": {
+          "name": "hw_at_a_fk",
+          "tableFrom": "homework_assignment_targets",
+          "tableTo": "homework_assignments",
+          "columnsFrom": [
+            "assignment_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "hw_at_s_fk": {
+          "name": "hw_at_s_fk",
+          "tableFrom": "homework_assignment_targets",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "homework_assignment_targets_assignment_id_student_id_pk": {
+          "name": "homework_assignment_targets_assignment_id_student_id_pk",
+          "columns": [
+            "assignment_id",
+            "student_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "homework_assignments": {
+      "name": "homework_assignments",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "source_exam_id": {
+          "name": "source_exam_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "structure": {
+          "name": "structure",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "creator_id": {
+          "name": "creator_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "available_at": {
+          "name": "available_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "due_at": {
+          "name": "due_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "allow_late": {
+          "name": "allow_late",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "late_due_at": {
+          "name": "late_due_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "max_attempts": {
+          "name": "max_attempts",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "hw_assignment_creator_idx": {
+          "name": "hw_assignment_creator_idx",
+          "columns": [
+            "creator_id"
+          ],
+          "isUnique": false
+        },
+        "hw_assignment_source_exam_idx": {
+          "name": "hw_assignment_source_exam_idx",
+          "columns": [
+            "source_exam_id"
+          ],
+          "isUnique": false
+        },
+        "hw_assignment_status_idx": {
+          "name": "hw_assignment_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "hw_asg_exam_fk": {
+          "name": "hw_asg_exam_fk",
+          "tableFrom": "homework_assignments",
+          "tableTo": "exams",
+          "columnsFrom": [
+            "source_exam_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "hw_asg_creator_fk": {
+          "name": "hw_asg_creator_fk",
+          "tableFrom": "homework_assignments",
+          "tableTo": "users",
+          "columnsFrom": [
+            "creator_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "homework_assignments_id": {
+          "name": "homework_assignments_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "homework_submissions": {
+      "name": "homework_submissions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "assignment_id": {
+          "name": "assignment_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "attempt_no": {
+          "name": "attempt_no",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'started'"
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "submitted_at": {
+          "name": "submitted_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_late": {
+          "name": "is_late",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "hw_assignment_student_idx": {
+          "name": "hw_assignment_student_idx",
+          "columns": [
+            "assignment_id",
+            "student_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "hw_sub_a_fk": {
+          "name": "hw_sub_a_fk",
+          "tableFrom": "homework_submissions",
+          "tableTo": "homework_assignments",
+          "columnsFrom": [
+            "assignment_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "hw_sub_student_fk": {
+          "name": "hw_sub_student_fk",
+          "tableFrom": "homework_submissions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "homework_submissions_id": {
+          "name": "homework_submissions_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "invitation_codes": {
+      "name": "invitation_codes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "varchar(64)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "email": {
+          "name": "email",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "role": {
+          "name": "role",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "notes": {
+          "name": "notes",
+          "type": "varchar(500)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "used_by": {
+          "name": "used_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "used_at": {
+          "name": "used_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "invitation_codes_code_idx": {
+          "name": "invitation_codes_code_idx",
+          "columns": [
+            "code"
+          ],
+          "isUnique": false
+        },
+        "invitation_codes_email_idx": {
+          "name": "invitation_codes_email_idx",
+          "columns": [
+            "email"
+          ],
+          "isUnique": false
+        },
+        "invitation_codes_used_by_idx": {
+          "name": "invitation_codes_used_by_idx",
+          "columns": [
+            "used_by"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "invitation_codes_id": {
+          "name": "invitation_codes_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "invitation_codes_code_unique": {
+          "name": "invitation_codes_code_unique",
+          "columns": [
+            "code"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "knowledge_point_mastery": {
+      "name": "knowledge_point_mastery",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "knowledge_point_id": {
+          "name": "knowledge_point_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "mastery_level": {
+          "name": "mastery_level",
+          "type": "decimal(5,2)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'0'"
+        },
+        "total_questions": {
+          "name": "total_questions",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "correct_questions": {
+          "name": "correct_questions",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "last_assessed_at": {
+          "name": "last_assessed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "mastery_student_idx": {
+          "name": "mastery_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "mastery_kp_idx": {
+          "name": "mastery_kp_idx",
+          "columns": [
+            "knowledge_point_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "kpm_student_fk": {
+          "name": "kpm_student_fk",
+          "tableFrom": "knowledge_point_mastery",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "kpm_kp_fk": {
+          "name": "kpm_kp_fk",
+          "tableFrom": "knowledge_point_mastery",
+          "tableTo": "knowledge_points",
+          "columnsFrom": [
+            "knowledge_point_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "knowledge_point_mastery_id": {
+          "name": "knowledge_point_mastery_id",
+          "columns": [
+            "id"
+          ]
+        },
+        "knowledge_point_mastery_student_id_knowledge_point_id_pk": {
+          "name": "knowledge_point_mastery_student_id_knowledge_point_id_pk",
+          "columns": [
+            "student_id",
+            "knowledge_point_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "knowledge_point_prerequisites": {
+      "name": "knowledge_point_prerequisites",
+      "columns": {
+        "knowledge_point_id": {
+          "name": "knowledge_point_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "prerequisite_kp_id": {
+          "name": "prerequisite_kp_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "kp_prereq_kp_idx": {
+          "name": "kp_prereq_kp_idx",
+          "columns": [
+            "knowledge_point_id"
+          ],
+          "isUnique": false
+        },
+        "kp_prereq_prereq_idx": {
+          "name": "kp_prereq_prereq_idx",
+          "columns": [
+            "prerequisite_kp_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "kp_prereq_kp_fk": {
+          "name": "kp_prereq_kp_fk",
+          "tableFrom": "knowledge_point_prerequisites",
+          "tableTo": "knowledge_points",
+          "columnsFrom": [
+            "knowledge_point_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "kp_prereq_prereq_fk": {
+          "name": "kp_prereq_prereq_fk",
+          "tableFrom": "knowledge_point_prerequisites",
+          "tableTo": "knowledge_points",
+          "columnsFrom": [
+            "prerequisite_kp_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "kp_prereq_pk": {
+          "name": "kp_prereq_pk",
+          "columns": [
+            "knowledge_point_id",
+            "prerequisite_kp_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "knowledge_points": {
+      "name": "knowledge_points",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "anchor_text": {
+          "name": "anchor_text",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "chapter_id": {
+          "name": "chapter_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "level": {
+          "name": "level",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "parent_id_idx": {
+          "name": "parent_id_idx",
+          "columns": [
+            "parent_id"
+          ],
+          "isUnique": false
+        },
+        "kp_chapter_id_idx": {
+          "name": "kp_chapter_id_idx",
+          "columns": [
+            "chapter_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "knowledge_points_id": {
+          "name": "knowledge_points_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "learning_diagnostic_reports": {
+      "name": "learning_diagnostic_reports",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "generated_by": {
+          "name": "generated_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "report_type": {
+          "name": "report_type",
+          "type": "enum('individual','class','grade')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'individual'"
+        },
+        "period": {
+          "name": "period",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "summary": {
+          "name": "summary",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "strengths": {
+          "name": "strengths",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "weaknesses": {
+          "name": "weaknesses",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "recommendations": {
+          "name": "recommendations",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "overall_score": {
+          "name": "overall_score",
+          "type": "decimal(5,2)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "report_status": {
+          "name": "report_status",
+          "type": "enum('draft','published','archived')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "diagnostic_student_idx": {
+          "name": "diagnostic_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "diagnostic_generated_by_idx": {
+          "name": "diagnostic_generated_by_idx",
+          "columns": [
+            "generated_by"
+          ],
+          "isUnique": false
+        },
+        "diagnostic_status_idx": {
+          "name": "diagnostic_status_idx",
+          "columns": [
+            "report_status"
+          ],
+          "isUnique": false
+        },
+        "diagnostic_report_type_idx": {
+          "name": "diagnostic_report_type_idx",
+          "columns": [
+            "report_type"
+          ],
+          "isUnique": false
+        },
+        "diagnostic_class_idx": {
+          "name": "diagnostic_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "diagnostic_grade_idx": {
+          "name": "diagnostic_grade_idx",
+          "columns": [
+            "grade_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "learning_diagnostic_reports_student_id_users_id_fk": {
+          "name": "learning_diagnostic_reports_student_id_users_id_fk",
+          "tableFrom": "learning_diagnostic_reports",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "learning_diagnostic_reports_generated_by_users_id_fk": {
+          "name": "learning_diagnostic_reports_generated_by_users_id_fk",
+          "tableFrom": "learning_diagnostic_reports",
+          "tableTo": "users",
+          "columnsFrom": [
+            "generated_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "learning_diagnostic_reports_class_id_classes_id_fk": {
+          "name": "learning_diagnostic_reports_class_id_classes_id_fk",
+          "tableFrom": "learning_diagnostic_reports",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "learning_diagnostic_reports_grade_id_grades_id_fk": {
+          "name": "learning_diagnostic_reports_grade_id_grades_id_fk",
+          "tableFrom": "learning_diagnostic_reports",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "learning_diagnostic_reports_id": {
+          "name": "learning_diagnostic_reports_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "leave_requests": {
+      "name": "leave_requests",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "requester_id": {
+          "name": "requester_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "leave_type": {
+          "name": "leave_type",
+          "type": "enum('sick','personal','family','other')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "leave_status": {
+          "name": "leave_status",
+          "type": "enum('pending','approved','rejected','cancelled')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "reviewer_id": {
+          "name": "reviewer_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "review_comment": {
+          "name": "review_comment",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reviewed_at": {
+          "name": "reviewed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "attendance_synced": {
+          "name": "attendance_synced",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "leave_requests_student_idx": {
+          "name": "leave_requests_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_requester_idx": {
+          "name": "leave_requests_requester_idx",
+          "columns": [
+            "requester_id"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_class_idx": {
+          "name": "leave_requests_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_status_idx": {
+          "name": "leave_requests_status_idx",
+          "columns": [
+            "leave_status"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_reviewer_idx": {
+          "name": "leave_requests_reviewer_idx",
+          "columns": [
+            "reviewer_id"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_class_status_idx": {
+          "name": "leave_requests_class_status_idx",
+          "columns": [
+            "class_id",
+            "leave_status"
+          ],
+          "isUnique": false
+        },
+        "leave_requests_student_status_idx": {
+          "name": "leave_requests_student_status_idx",
+          "columns": [
+            "student_id",
+            "leave_status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "leave_requests_student_id_users_id_fk": {
+          "name": "leave_requests_student_id_users_id_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "leave_requests_requester_id_users_id_fk": {
+          "name": "leave_requests_requester_id_users_id_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "requester_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "leave_requests_class_id_classes_id_fk": {
+          "name": "leave_requests_class_id_classes_id_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "leave_requests_reviewer_id_users_id_fk": {
+          "name": "leave_requests_reviewer_id_users_id_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reviewer_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        },
+        "lr_c_fk": {
+          "name": "lr_c_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lr_s_fk": {
+          "name": "lr_s_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lr_rq_fk": {
+          "name": "lr_rq_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "requester_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lr_rv_fk": {
+          "name": "lr_rv_fk",
+          "tableFrom": "leave_requests",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reviewer_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "leave_requests_id": {
+          "name": "leave_requests_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_ai_evaluations": {
+      "name": "lesson_plan_ai_evaluations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "version_no": {
+          "name": "version_no",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "overall_score": {
+          "name": "overall_score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "dimension_scores": {
+          "name": "dimension_scores",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "suggestions": {
+          "name": "suggestions",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "recommended_standard_ids": {
+          "name": "recommended_standard_ids",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "evaluated_by": {
+          "name": "evaluated_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpae_plan_version_idx": {
+          "name": "lpae_plan_version_idx",
+          "columns": [
+            "plan_id",
+            "version_no"
+          ],
+          "isUnique": false
+        },
+        "lpae_plan_idx": {
+          "name": "lpae_plan_idx",
+          "columns": [
+            "plan_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_ai_evaluations_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_ai_evaluations_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_ai_evaluations",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_ai_evaluations_id": {
+          "name": "lesson_plan_ai_evaluations_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_analytics_daily": {
+      "name": "lesson_plan_analytics_daily",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "snapshot_date": {
+          "name": "snapshot_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "teacher_id": {
+          "name": "teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_plans_count": {
+          "name": "new_plans_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "edit_duration_min": {
+          "name": "edit_duration_min",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "saved_versions_count": {
+          "name": "saved_versions_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "submitted_count": {
+          "name": "submitted_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "published_count": {
+          "name": "published_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "standards_linked": {
+          "name": "standards_linked",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpad_date_teacher_idx": {
+          "name": "lpad_date_teacher_idx",
+          "columns": [
+            "snapshot_date",
+            "teacher_id"
+          ],
+          "isUnique": true
+        },
+        "lpad_date_idx": {
+          "name": "lpad_date_idx",
+          "columns": [
+            "snapshot_date"
+          ],
+          "isUnique": false
+        },
+        "lpad_subject_grade_idx": {
+          "name": "lpad_subject_grade_idx",
+          "columns": [
+            "subject_id",
+            "grade_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_analytics_daily_teacher_id_users_id_fk": {
+          "name": "lesson_plan_analytics_daily_teacher_id_users_id_fk",
+          "tableFrom": "lesson_plan_analytics_daily",
+          "tableTo": "users",
+          "columnsFrom": [
+            "teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_analytics_daily_id": {
+          "name": "lesson_plan_analytics_daily_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_attachments": {
+      "name": "lesson_plan_attachments",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "block_id": {
+          "name": "block_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "file_id": {
+          "name": "file_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "display_name": {
+          "name": "display_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "attachment_type": {
+          "name": "attachment_type",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'reference'"
+        },
+        "uploaded_by": {
+          "name": "uploaded_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpa_plan_idx": {
+          "name": "lpa_plan_idx",
+          "columns": [
+            "plan_id"
+          ],
+          "isUnique": false
+        },
+        "lpa_block_idx": {
+          "name": "lpa_block_idx",
+          "columns": [
+            "block_id"
+          ],
+          "isUnique": false
+        },
+        "lpa_file_idx": {
+          "name": "lpa_file_idx",
+          "columns": [
+            "file_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_attachments_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_attachments_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_attachments",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_attachments_uploaded_by_users_id_fk": {
+          "name": "lesson_plan_attachments_uploaded_by_users_id_fk",
+          "tableFrom": "lesson_plan_attachments",
+          "tableTo": "users",
+          "columnsFrom": [
+            "uploaded_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_attachments_id": {
+          "name": "lesson_plan_attachments_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_comments": {
+      "name": "lesson_plan_comments",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "block_id": {
+          "name": "block_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "author_id": {
+          "name": "author_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "resolved": {
+          "name": "resolved",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "parent_comment_id": {
+          "name": "parent_comment_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpc_plan_block_idx": {
+          "name": "lpc_plan_block_idx",
+          "columns": [
+            "plan_id",
+            "block_id"
+          ],
+          "isUnique": false
+        },
+        "lpc_author_idx": {
+          "name": "lpc_author_idx",
+          "columns": [
+            "author_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_comments_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_comments_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_comments",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_comments_author_id_users_id_fk": {
+          "name": "lesson_plan_comments_author_id_users_id_fk",
+          "tableFrom": "lesson_plan_comments",
+          "tableTo": "users",
+          "columnsFrom": [
+            "author_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_comments_id": {
+          "name": "lesson_plan_comments_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_formative_items": {
+      "name": "lesson_plan_formative_items",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "block_id": {
+          "name": "block_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "interaction_type": {
+          "name": "interaction_type",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "payload": {
+          "name": "payload",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "instant_feedback": {
+          "name": "instant_feedback",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "order_index": {
+          "name": "order_index",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpfi_plan_block_idx": {
+          "name": "lpfi_plan_block_idx",
+          "columns": [
+            "plan_id",
+            "block_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_formative_items_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_formative_items_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_formative_items",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_formative_items_id": {
+          "name": "lesson_plan_formative_items_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_formative_responses": {
+      "name": "lesson_plan_formative_responses",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "item_id": {
+          "name": "item_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "response": {
+          "name": "response",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_correct": {
+          "name": "is_correct",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "duration_sec": {
+          "name": "duration_sec",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpfr_item_idx": {
+          "name": "lpfr_item_idx",
+          "columns": [
+            "item_id"
+          ],
+          "isUnique": false
+        },
+        "lpfr_student_idx": {
+          "name": "lpfr_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "lpfr_class_idx": {
+          "name": "lpfr_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_formative_responses_student_id_users_id_fk": {
+          "name": "lesson_plan_formative_responses_student_id_users_id_fk",
+          "tableFrom": "lesson_plan_formative_responses",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lpfr_item_fk": {
+          "name": "lpfr_item_fk",
+          "tableFrom": "lesson_plan_formative_responses",
+          "tableTo": "lesson_plan_formative_items",
+          "columnsFrom": [
+            "item_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_formative_responses_id": {
+          "name": "lesson_plan_formative_responses_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_review_records": {
+      "name": "lesson_plan_review_records",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reviewer_id": {
+          "name": "reviewer_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "decision": {
+          "name": "decision",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "comment": {
+          "name": "comment",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "previous_status": {
+          "name": "previous_status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "new_status": {
+          "name": "new_status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lprr_plan_created_idx": {
+          "name": "lprr_plan_created_idx",
+          "columns": [
+            "plan_id",
+            "created_at"
+          ],
+          "isUnique": false
+        },
+        "lprr_reviewer_idx": {
+          "name": "lprr_reviewer_idx",
+          "columns": [
+            "reviewer_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_review_records_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_review_records_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_review_records",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_review_records_reviewer_id_users_id_fk": {
+          "name": "lesson_plan_review_records_reviewer_id_users_id_fk",
+          "tableFrom": "lesson_plan_review_records",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reviewer_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_review_records_id": {
+          "name": "lesson_plan_review_records_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_schedules": {
+      "name": "lesson_plan_schedules",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "scheduled_date": {
+          "name": "scheduled_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "period": {
+          "name": "period",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_schedule_id": {
+          "name": "class_schedule_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "duration_min": {
+          "name": "duration_min",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 40
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpsc_plan_idx": {
+          "name": "lpsc_plan_idx",
+          "columns": [
+            "plan_id"
+          ],
+          "isUnique": false
+        },
+        "lpsc_class_date_idx": {
+          "name": "lpsc_class_date_idx",
+          "columns": [
+            "class_id",
+            "scheduled_date"
+          ],
+          "isUnique": false
+        },
+        "lpsc_plan_date_idx": {
+          "name": "lpsc_plan_date_idx",
+          "columns": [
+            "plan_id",
+            "scheduled_date"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_schedules_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_schedules_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_schedules",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_schedules_class_id_classes_id_fk": {
+          "name": "lesson_plan_schedules_class_id_classes_id_fk",
+          "tableFrom": "lesson_plan_schedules",
+          "tableTo": "classes",
+          "columnsFrom": [
+            "class_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_schedules_created_by_users_id_fk": {
+          "name": "lesson_plan_schedules_created_by_users_id_fk",
+          "tableFrom": "lesson_plan_schedules",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_schedules_id": {
+          "name": "lesson_plan_schedules_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_standards": {
+      "name": "lesson_plan_standards",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "standard_id": {
+          "name": "standard_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "relation_type": {
+          "name": "relation_type",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'primary'"
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lps_plan_standard_idx": {
+          "name": "lps_plan_standard_idx",
+          "columns": [
+            "plan_id",
+            "standard_id"
+          ],
+          "isUnique": true
+        },
+        "lps_standard_idx": {
+          "name": "lps_standard_idx",
+          "columns": [
+            "standard_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_standards_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_standards_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_standards",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_standards_standard_id_standards_id_fk": {
+          "name": "lesson_plan_standards_standard_id_standards_id_fk",
+          "tableFrom": "lesson_plan_standards",
+          "tableTo": "standards",
+          "columnsFrom": [
+            "standard_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_standards_created_by_users_id_fk": {
+          "name": "lesson_plan_standards_created_by_users_id_fk",
+          "tableFrom": "lesson_plan_standards",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_standards_id": {
+          "name": "lesson_plan_standards_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_substitutes": {
+      "name": "lesson_plan_substitutes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "original_teacher_id": {
+          "name": "original_teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "substitute_teacher_id": {
+          "name": "substitute_teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'active'"
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lps_plan_idx": {
+          "name": "lps_plan_idx",
+          "columns": [
+            "plan_id"
+          ],
+          "isUnique": false
+        },
+        "lps_original_teacher_idx": {
+          "name": "lps_original_teacher_idx",
+          "columns": [
+            "original_teacher_id"
+          ],
+          "isUnique": false
+        },
+        "lps_substitute_teacher_idx": {
+          "name": "lps_substitute_teacher_idx",
+          "columns": [
+            "substitute_teacher_id"
+          ],
+          "isUnique": false
+        },
+        "lps_date_range_idx": {
+          "name": "lps_date_range_idx",
+          "columns": [
+            "start_date",
+            "end_date"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_substitutes_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_substitutes_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_substitutes",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_substitutes_original_teacher_id_users_id_fk": {
+          "name": "lesson_plan_substitutes_original_teacher_id_users_id_fk",
+          "tableFrom": "lesson_plan_substitutes",
+          "tableTo": "users",
+          "columnsFrom": [
+            "original_teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_substitutes_substitute_teacher_id_users_id_fk": {
+          "name": "lesson_plan_substitutes_substitute_teacher_id_users_id_fk",
+          "tableFrom": "lesson_plan_substitutes",
+          "tableTo": "users",
+          "columnsFrom": [
+            "substitute_teacher_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_substitutes_created_by_users_id_fk": {
+          "name": "lesson_plan_substitutes_created_by_users_id_fk",
+          "tableFrom": "lesson_plan_substitutes",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_substitutes_id": {
+          "name": "lesson_plan_substitutes_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_templates": {
+      "name": "lesson_plan_templates",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "scope": {
+          "name": "scope",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "blocks": {
+          "name": "blocks",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "creator_id": {
+          "name": "creator_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpt_type_creator_idx": {
+          "name": "lpt_type_creator_idx",
+          "columns": [
+            "type",
+            "creator_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_templates_creator_id_users_id_fk": {
+          "name": "lesson_plan_templates_creator_id_users_id_fk",
+          "tableFrom": "lesson_plan_templates",
+          "tableTo": "users",
+          "columnsFrom": [
+            "creator_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_templates_id": {
+          "name": "lesson_plan_templates_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plan_versions": {
+      "name": "lesson_plan_versions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "version_no": {
+          "name": "version_no",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "label": {
+          "name": "label",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_auto": {
+          "name": "is_auto",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "creator_id": {
+          "name": "creator_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lpv_plan_version_idx": {
+          "name": "lpv_plan_version_idx",
+          "columns": [
+            "plan_id",
+            "version_no"
+          ],
+          "isUnique": false
+        },
+        "lpv_plan_created_idx": {
+          "name": "lpv_plan_created_idx",
+          "columns": [
+            "plan_id",
+            "created_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plan_versions_plan_id_lesson_plans_id_fk": {
+          "name": "lesson_plan_versions_plan_id_lesson_plans_id_fk",
+          "tableFrom": "lesson_plan_versions",
+          "tableTo": "lesson_plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "lesson_plan_versions_creator_id_users_id_fk": {
+          "name": "lesson_plan_versions_creator_id_users_id_fk",
+          "tableFrom": "lesson_plan_versions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "creator_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plan_versions_id": {
+          "name": "lesson_plan_versions_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "lesson_plans": {
+      "name": "lesson_plans",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "textbook_id": {
+          "name": "textbook_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "chapter_id": {
+          "name": "chapter_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "course_plan_item_id": {
+          "name": "course_plan_item_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "template_id": {
+          "name": "template_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "template_name": {
+          "name": "template_name",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'draft'"
+        },
+        "creator_id": {
+          "name": "creator_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_saved_at": {
+          "name": "last_saved_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "lp_creator_idx": {
+          "name": "lp_creator_idx",
+          "columns": [
+            "creator_id"
+          ],
+          "isUnique": false
+        },
+        "lp_status_idx": {
+          "name": "lp_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "lp_textbook_chapter_idx": {
+          "name": "lp_textbook_chapter_idx",
+          "columns": [
+            "textbook_id",
+            "chapter_id"
+          ],
+          "isUnique": false
+        },
+        "lp_subject_grade_idx": {
+          "name": "lp_subject_grade_idx",
+          "columns": [
+            "subject_id",
+            "grade_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "lesson_plans_textbook_id_textbooks_id_fk": {
+          "name": "lesson_plans_textbook_id_textbooks_id_fk",
+          "tableFrom": "lesson_plans",
+          "tableTo": "textbooks",
+          "columnsFrom": [
+            "textbook_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plans_chapter_id_chapters_id_fk": {
+          "name": "lesson_plans_chapter_id_chapters_id_fk",
+          "tableFrom": "lesson_plans",
+          "tableTo": "chapters",
+          "columnsFrom": [
+            "chapter_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plans_subject_id_subjects_id_fk": {
+          "name": "lesson_plans_subject_id_subjects_id_fk",
+          "tableFrom": "lesson_plans",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plans_grade_id_grades_id_fk": {
+          "name": "lesson_plans_grade_id_grades_id_fk",
+          "tableFrom": "lesson_plans",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "lesson_plans_creator_id_users_id_fk": {
+          "name": "lesson_plans_creator_id_users_id_fk",
+          "tableFrom": "lesson_plans",
+          "tableTo": "users",
+          "columnsFrom": [
+            "creator_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "lesson_plans_id": {
+          "name": "lesson_plans_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "login_logs": {
+      "name": "login_logs",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "user_email": {
+          "name": "user_email",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "action": {
+          "name": "action",
+          "type": "enum('signin','signout','signup')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('success','failure')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'success'"
+        },
+        "ip_address": {
+          "name": "ip_address",
+          "type": "varchar(45)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "user_agent": {
+          "name": "user_agent",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "error_message": {
+          "name": "error_message",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "login_logs_user_id_idx": {
+          "name": "login_logs_user_id_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "login_logs_user_email_idx": {
+          "name": "login_logs_user_email_idx",
+          "columns": [
+            "user_email"
+          ],
+          "isUnique": false
+        },
+        "login_logs_action_idx": {
+          "name": "login_logs_action_idx",
+          "columns": [
+            "action"
+          ],
+          "isUnique": false
+        },
+        "login_logs_status_idx": {
+          "name": "login_logs_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "login_logs_created_at_idx": {
+          "name": "login_logs_created_at_idx",
+          "columns": [
+            "created_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "login_logs_id": {
+          "name": "login_logs_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "message_drafts": {
+      "name": "message_drafts",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "receiver_id": {
+          "name": "receiver_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "parent_message_id": {
+          "name": "parent_message_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "device_id": {
+          "name": "device_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "version": {
+          "name": "version",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "message_drafts_user_idx": {
+          "name": "message_drafts_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "message_drafts_user_updated_idx": {
+          "name": "message_drafts_user_updated_idx",
+          "columns": [
+            "user_id",
+            "updated_at"
+          ],
+          "isUnique": false
+        },
+        "message_drafts_user_parent_idx": {
+          "name": "message_drafts_user_parent_idx",
+          "columns": [
+            "user_id",
+            "parent_message_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "message_drafts_user_id_users_id_fk": {
+          "name": "message_drafts_user_id_users_id_fk",
+          "tableFrom": "message_drafts",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "message_drafts_receiver_id_users_id_fk": {
+          "name": "message_drafts_receiver_id_users_id_fk",
+          "tableFrom": "message_drafts",
+          "tableTo": "users",
+          "columnsFrom": [
+            "receiver_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "message_drafts_id": {
+          "name": "message_drafts_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "message_notifications": {
+      "name": "message_notifications",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "link": {
+          "name": "link",
+          "type": "varchar(512)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_read": {
+          "name": "is_read",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "priority": {
+          "name": "priority",
+          "type": "varchar(16)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'normal'"
+        },
+        "is_archived": {
+          "name": "is_archived",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "message_notifications_user_idx": {
+          "name": "message_notifications_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "message_notifications_is_read_idx": {
+          "name": "message_notifications_is_read_idx",
+          "columns": [
+            "is_read"
+          ],
+          "isUnique": false
+        },
+        "message_notifications_user_read_idx": {
+          "name": "message_notifications_user_read_idx",
+          "columns": [
+            "user_id",
+            "is_read"
+          ],
+          "isUnique": false
+        },
+        "message_notifications_created_at_idx": {
+          "name": "message_notifications_created_at_idx",
+          "columns": [
+            "created_at"
+          ],
+          "isUnique": false
+        },
+        "message_notifications_priority_idx": {
+          "name": "message_notifications_priority_idx",
+          "columns": [
+            "priority"
+          ],
+          "isUnique": false
+        },
+        "message_notifications_user_archived_idx": {
+          "name": "message_notifications_user_archived_idx",
+          "columns": [
+            "user_id",
+            "is_archived"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "message_notifications_user_id_users_id_fk": {
+          "name": "message_notifications_user_id_users_id_fk",
+          "tableFrom": "message_notifications",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "message_notifications_id": {
+          "name": "message_notifications_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "message_reports": {
+      "name": "message_reports",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reporter_id": {
+          "name": "reporter_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "message_id": {
+          "name": "message_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reported_user_id": {
+          "name": "reported_user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "message_reports_reporter_idx": {
+          "name": "message_reports_reporter_idx",
+          "columns": [
+            "reporter_id"
+          ],
+          "isUnique": false
+        },
+        "message_reports_message_idx": {
+          "name": "message_reports_message_idx",
+          "columns": [
+            "message_id"
+          ],
+          "isUnique": false
+        },
+        "message_reports_reported_user_idx": {
+          "name": "message_reports_reported_user_idx",
+          "columns": [
+            "reported_user_id"
+          ],
+          "isUnique": false
+        },
+        "message_reports_status_idx": {
+          "name": "message_reports_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "message_reports_reporter_id_users_id_fk": {
+          "name": "message_reports_reporter_id_users_id_fk",
+          "tableFrom": "message_reports",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reporter_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "message_reports_message_id_messages_id_fk": {
+          "name": "message_reports_message_id_messages_id_fk",
+          "tableFrom": "message_reports",
+          "tableTo": "messages",
+          "columnsFrom": [
+            "message_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "message_reports_reported_user_id_users_id_fk": {
+          "name": "message_reports_reported_user_id_users_id_fk",
+          "tableFrom": "message_reports",
+          "tableTo": "users",
+          "columnsFrom": [
+            "reported_user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "message_reports_id": {
+          "name": "message_reports_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "message_templates": {
+      "name": "message_templates",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sort_order": {
+          "name": "sort_order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "message_templates_user_idx": {
+          "name": "message_templates_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "message_templates_user_sort_idx": {
+          "name": "message_templates_user_sort_idx",
+          "columns": [
+            "user_id",
+            "sort_order"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "message_templates_user_id_users_id_fk": {
+          "name": "message_templates_user_id_users_id_fk",
+          "tableFrom": "message_templates",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "message_templates_id": {
+          "name": "message_templates_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "messages": {
+      "name": "messages",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sender_id": {
+          "name": "sender_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "receiver_id": {
+          "name": "receiver_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_read": {
+          "name": "is_read",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "read_at": {
+          "name": "read_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "parent_message_id": {
+          "name": "parent_message_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "sender_deleted_at": {
+          "name": "sender_deleted_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "receiver_deleted_at": {
+          "name": "receiver_deleted_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_starred": {
+          "name": "is_starred",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "recalled_at": {
+          "name": "recalled_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "group_message_id": {
+          "name": "group_message_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "messages_sender_idx": {
+          "name": "messages_sender_idx",
+          "columns": [
+            "sender_id"
+          ],
+          "isUnique": false
+        },
+        "messages_receiver_idx": {
+          "name": "messages_receiver_idx",
+          "columns": [
+            "receiver_id"
+          ],
+          "isUnique": false
+        },
+        "messages_is_read_idx": {
+          "name": "messages_is_read_idx",
+          "columns": [
+            "is_read"
+          ],
+          "isUnique": false
+        },
+        "messages_parent_idx": {
+          "name": "messages_parent_idx",
+          "columns": [
+            "parent_message_id"
+          ],
+          "isUnique": false
+        },
+        "messages_receiver_read_idx": {
+          "name": "messages_receiver_read_idx",
+          "columns": [
+            "receiver_id",
+            "is_read"
+          ],
+          "isUnique": false
+        },
+        "messages_receiver_starred_idx": {
+          "name": "messages_receiver_starred_idx",
+          "columns": [
+            "receiver_id",
+            "is_starred"
+          ],
+          "isUnique": false
+        },
+        "messages_group_message_idx": {
+          "name": "messages_group_message_idx",
+          "columns": [
+            "group_message_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "messages_sender_id_users_id_fk": {
+          "name": "messages_sender_id_users_id_fk",
+          "tableFrom": "messages",
+          "tableTo": "users",
+          "columnsFrom": [
+            "sender_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "messages_receiver_id_users_id_fk": {
+          "name": "messages_receiver_id_users_id_fk",
+          "tableFrom": "messages",
+          "tableTo": "users",
+          "columnsFrom": [
+            "receiver_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "messages_id": {
+          "name": "messages_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "notification_logs": {
+      "name": "notification_logs",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "channel": {
+          "name": "channel",
+          "type": "varchar(32)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "varchar(16)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "message_id": {
+          "name": "message_id",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "error": {
+          "name": "error",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "sent_at": {
+          "name": "sent_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "notification_logs_user_idx": {
+          "name": "notification_logs_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        },
+        "notification_logs_channel_idx": {
+          "name": "notification_logs_channel_idx",
+          "columns": [
+            "channel"
+          ],
+          "isUnique": false
+        },
+        "notification_logs_status_idx": {
+          "name": "notification_logs_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "notification_logs_sent_at_idx": {
+          "name": "notification_logs_sent_at_idx",
+          "columns": [
+            "sent_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "notification_logs_user_id_users_id_fk": {
+          "name": "notification_logs_user_id_users_id_fk",
+          "tableFrom": "notification_logs",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "notification_logs_id": {
+          "name": "notification_logs_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "notification_preferences": {
+      "name": "notification_preferences",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "email_enabled": {
+          "name": "email_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "sms_enabled": {
+          "name": "sms_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "push_enabled": {
+          "name": "push_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "homework_notifications": {
+          "name": "homework_notifications",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "grade_notifications": {
+          "name": "grade_notifications",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "announcement_notifications": {
+          "name": "announcement_notifications",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "message_notifications": {
+          "name": "message_notifications",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "attendance_notifications": {
+          "name": "attendance_notifications",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "quiet_hours_enabled": {
+          "name": "quiet_hours_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "quiet_hours_start": {
+          "name": "quiet_hours_start",
+          "type": "varchar(5)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "quiet_hours_end": {
+          "name": "quiet_hours_end",
+          "type": "varchar(5)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "notification_preferences_user_idx": {
+          "name": "notification_preferences_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "notification_preferences_user_id_users_id_fk": {
+          "name": "notification_preferences_user_id_users_id_fk",
+          "tableFrom": "notification_preferences",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "np_u_fk": {
+          "name": "np_u_fk",
+          "tableFrom": "notification_preferences",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "notification_preferences_id": {
+          "name": "notification_preferences_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "notification_preferences_user_id_unique": {
+          "name": "notification_preferences_user_id_unique",
+          "columns": [
+            "user_id"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "parent_student_relations": {
+      "name": "parent_student_relations",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "relation": {
+          "name": "relation",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "parent_student_relations_parent_idx": {
+          "name": "parent_student_relations_parent_idx",
+          "columns": [
+            "parent_id"
+          ],
+          "isUnique": false
+        },
+        "parent_student_relations_student_idx": {
+          "name": "parent_student_relations_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "parent_student_relations_parent_id_users_id_fk": {
+          "name": "parent_student_relations_parent_id_users_id_fk",
+          "tableFrom": "parent_student_relations",
+          "tableTo": "users",
+          "columnsFrom": [
+            "parent_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "parent_student_relations_student_id_users_id_fk": {
+          "name": "parent_student_relations_student_id_users_id_fk",
+          "tableFrom": "parent_student_relations",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "psr_p_fk": {
+          "name": "psr_p_fk",
+          "tableFrom": "parent_student_relations",
+          "tableTo": "users",
+          "columnsFrom": [
+            "parent_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "psr_s_fk": {
+          "name": "psr_s_fk",
+          "tableFrom": "parent_student_relations",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "parent_student_relations_id": {
+          "name": "parent_student_relations_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "password_security": {
+      "name": "password_security",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "failed_login_attempts": {
+          "name": "failed_login_attempts",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "locked_until": {
+          "name": "locked_until",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "password_changed_at": {
+          "name": "password_changed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "must_change_password": {
+          "name": "must_change_password",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "last_password_change": {
+          "name": "last_password_change",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "password_security_user_idx": {
+          "name": "password_security_user_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "password_security_user_id_users_id_fk": {
+          "name": "password_security_user_id_users_id_fk",
+          "tableFrom": "password_security",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "ps_u_fk": {
+          "name": "ps_u_fk",
+          "tableFrom": "password_security",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "password_security_id": {
+          "name": "password_security_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "password_security_user_id_unique": {
+          "name": "password_security_user_id_unique",
+          "columns": [
+            "user_id"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "practice_answers": {
+      "name": "practice_answers",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "session_id": {
+          "name": "session_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "variant_content": {
+          "name": "variant_content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_variant": {
+          "name": "is_variant",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "order_index": {
+          "name": "order_index",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "practice_answer_status": {
+          "name": "practice_answer_status",
+          "type": "enum('pending','answered','skipped')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "student_answer": {
+          "name": "student_answer",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_correct": {
+          "name": "is_correct",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "max_score": {
+          "name": "max_score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "answered_at": {
+          "name": "answered_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "pa_session_idx": {
+          "name": "pa_session_idx",
+          "columns": [
+            "session_id"
+          ],
+          "isUnique": false
+        },
+        "pa_student_idx": {
+          "name": "pa_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "pa_question_idx": {
+          "name": "pa_question_idx",
+          "columns": [
+            "question_id"
+          ],
+          "isUnique": false
+        },
+        "pa_session_order_idx": {
+          "name": "pa_session_order_idx",
+          "columns": [
+            "session_id",
+            "order_index"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "practice_answers_session_id_practice_sessions_id_fk": {
+          "name": "practice_answers_session_id_practice_sessions_id_fk",
+          "tableFrom": "practice_answers",
+          "tableTo": "practice_sessions",
+          "columnsFrom": [
+            "session_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "practice_answers_student_id_users_id_fk": {
+          "name": "practice_answers_student_id_users_id_fk",
+          "tableFrom": "practice_answers",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "practice_answers_question_id_questions_id_fk": {
+          "name": "practice_answers_question_id_questions_id_fk",
+          "tableFrom": "practice_answers",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "practice_answers_id": {
+          "name": "practice_answers_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "practice_sessions": {
+      "name": "practice_sessions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "student_id": {
+          "name": "student_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "practice_type": {
+          "name": "practice_type",
+          "type": "enum('error_variant','knowledge_point','weak_chapter','ai_recommended')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "source_meta": {
+          "name": "source_meta",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "practice_status": {
+          "name": "practice_status",
+          "type": "enum('in_progress','completed','abandoned')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'in_progress'"
+        },
+        "total_questions": {
+          "name": "total_questions",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "answered_questions": {
+          "name": "answered_questions",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "correct_count": {
+          "name": "correct_count",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "completed_at": {
+          "name": "completed_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "ps_student_idx": {
+          "name": "ps_student_idx",
+          "columns": [
+            "student_id"
+          ],
+          "isUnique": false
+        },
+        "ps_student_status_idx": {
+          "name": "ps_student_status_idx",
+          "columns": [
+            "student_id",
+            "practice_status"
+          ],
+          "isUnique": false
+        },
+        "ps_subject_idx": {
+          "name": "ps_subject_idx",
+          "columns": [
+            "subject_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "practice_sessions_student_id_users_id_fk": {
+          "name": "practice_sessions_student_id_users_id_fk",
+          "tableFrom": "practice_sessions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "student_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "practice_sessions_id": {
+          "name": "practice_sessions_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "questions": {
+      "name": "questions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content": {
+          "name": "content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "content_text": {
+          "name": "content_text",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "generated": {
+            "as": "CAST(content AS CHAR)",
+            "type": "stored"
+          }
+        },
+        "type": {
+          "name": "type",
+          "type": "enum('single_choice','multiple_choice','text','judgment','composite')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "difficulty": {
+          "name": "difficulty",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 1
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "author_id": {
+          "name": "author_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "parent_id_idx": {
+          "name": "parent_id_idx",
+          "columns": [
+            "parent_id"
+          ],
+          "isUnique": false
+        },
+        "author_id_idx": {
+          "name": "author_id_idx",
+          "columns": [
+            "author_id"
+          ],
+          "isUnique": false
+        },
+        "questions_type_difficulty_idx": {
+          "name": "questions_type_difficulty_idx",
+          "columns": [
+            "type",
+            "difficulty"
+          ],
+          "isUnique": false
+        },
+        "questions_content_text_ft_idx": {
+          "name": "questions_content_text_ft_idx",
+          "columns": [
+            "content_text"
+          ],
+          "isUnique": false,
+          "type": "fulltext"
+        }
+      },
+      "foreignKeys": {
+        "questions_author_id_users_id_fk": {
+          "name": "questions_author_id_users_id_fk",
+          "tableFrom": "questions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "author_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "questions_id": {
+          "name": "questions_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "questions_to_knowledge_points": {
+      "name": "questions_to_knowledge_points",
+      "columns": {
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "knowledge_point_id": {
+          "name": "knowledge_point_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "kp_idx": {
+          "name": "kp_idx",
+          "columns": [
+            "knowledge_point_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "q_kp_qid_fk": {
+          "name": "q_kp_qid_fk",
+          "tableFrom": "questions_to_knowledge_points",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "q_kp_kpid_fk": {
+          "name": "q_kp_kpid_fk",
+          "tableFrom": "questions_to_knowledge_points",
+          "tableTo": "knowledge_points",
+          "columnsFrom": [
+            "knowledge_point_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "questions_to_knowledge_points_question_id_knowledge_point_id_pk": {
+          "name": "questions_to_knowledge_points_question_id_knowledge_point_id_pk",
+          "columns": [
+            "question_id",
+            "knowledge_point_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "role_permissions": {
+      "name": "role_permissions",
+      "columns": {
+        "role_id": {
+          "name": "role_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "permission": {
+          "name": "permission",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "role_permissions_role_idx": {
+          "name": "role_permissions_role_idx",
+          "columns": [
+            "role_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "role_permissions_role_id_roles_id_fk": {
+          "name": "role_permissions_role_id_roles_id_fk",
+          "tableFrom": "role_permissions",
+          "tableTo": "roles",
+          "columnsFrom": [
+            "role_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "role_permissions_role_id_permission_pk": {
+          "name": "role_permissions_role_id_permission_pk",
+          "columns": [
+            "role_id",
+            "permission"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "roles": {
+      "name": "roles",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_system": {
+          "name": "is_system",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "is_enabled": {
+          "name": "is_enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "roles_id": {
+          "name": "roles_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "roles_name_unique": {
+          "name": "roles_name_unique",
+          "columns": [
+            "name"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "schedule_changes": {
+      "name": "schedule_changes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "original_schedule_id": {
+          "name": "original_schedule_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "original_teacher_id": {
+          "name": "original_teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "substitute_teacher_id": {
+          "name": "substitute_teacher_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "original_date": {
+          "name": "original_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_date": {
+          "name": "new_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_start_time": {
+          "name": "new_start_time",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "new_end_time": {
+          "name": "new_end_time",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "reason": {
+          "name": "reason",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "enum('pending','approved','rejected','completed')",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'pending'"
+        },
+        "requested_by": {
+          "name": "requested_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "approved_by": {
+          "name": "approved_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "schedule_changes_class_idx": {
+          "name": "schedule_changes_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        },
+        "schedule_changes_status_idx": {
+          "name": "schedule_changes_status_idx",
+          "columns": [
+            "status"
+          ],
+          "isUnique": false
+        },
+        "schedule_changes_requested_by_idx": {
+          "name": "schedule_changes_requested_by_idx",
+          "columns": [
+            "requested_by"
+          ],
+          "isUnique": false
+        },
+        "schedule_changes_original_schedule_idx": {
+          "name": "schedule_changes_original_schedule_idx",
+          "columns": [
+            "original_schedule_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "schedule_changes_id": {
+          "name": "schedule_changes_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "scheduling_rules": {
+      "name": "scheduling_rules",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "class_id": {
+          "name": "class_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "max_daily_hours": {
+          "name": "max_daily_hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 8
+        },
+        "max_continuous_hours": {
+          "name": "max_continuous_hours",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 2
+        },
+        "lunch_break_start": {
+          "name": "lunch_break_start",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'12:00'"
+        },
+        "lunch_break_end": {
+          "name": "lunch_break_end",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'13:00'"
+        },
+        "morning_start": {
+          "name": "morning_start",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'08:00'"
+        },
+        "afternoon_end": {
+          "name": "afternoon_end",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": "'17:00'"
+        },
+        "avoid_back_to_back": {
+          "name": "avoid_back_to_back",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": false
+        },
+        "balanced_subjects": {
+          "name": "balanced_subjects",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "scheduling_rules_class_idx": {
+          "name": "scheduling_rules_class_idx",
+          "columns": [
+            "class_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "scheduling_rules_id": {
+          "name": "scheduling_rules_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "schools": {
+      "name": "schools",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "schools_name_idx": {
+          "name": "schools_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        },
+        "schools_code_idx": {
+          "name": "schools_code_idx",
+          "columns": [
+            "code"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "schools_id": {
+          "name": "schools_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "schools_name_unique": {
+          "name": "schools_name_unique",
+          "columns": [
+            "name"
+          ]
+        },
+        "schools_code_unique": {
+          "name": "schools_code_unique",
+          "columns": [
+            "code"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "sessions": {
+      "name": "sessions",
+      "columns": {
+        "sessionToken": {
+          "name": "sessionToken",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "userId": {
+          "name": "userId",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "expires": {
+          "name": "expires",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "session_userId_idx": {
+          "name": "session_userId_idx",
+          "columns": [
+            "userId"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "sessions_userId_users_id_fk": {
+          "name": "sessions_userId_users_id_fk",
+          "tableFrom": "sessions",
+          "tableTo": "users",
+          "columnsFrom": [
+            "userId"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "sessions_sessionToken": {
+          "name": "sessions_sessionToken",
+          "columns": [
+            "sessionToken"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "standards": {
+      "name": "standards",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "level": {
+          "name": "level",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "subject_id": {
+          "name": "subject_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "stage": {
+          "name": "stage",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "sort_order": {
+          "name": "sort_order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "std_code_idx": {
+          "name": "std_code_idx",
+          "columns": [
+            "code"
+          ],
+          "isUnique": true
+        },
+        "std_parent_idx": {
+          "name": "std_parent_idx",
+          "columns": [
+            "parent_id"
+          ],
+          "isUnique": false
+        },
+        "std_subject_grade_idx": {
+          "name": "std_subject_grade_idx",
+          "columns": [
+            "subject_id",
+            "grade_id"
+          ],
+          "isUnique": false
+        },
+        "std_level_idx": {
+          "name": "std_level_idx",
+          "columns": [
+            "level"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "standards_subject_id_subjects_id_fk": {
+          "name": "standards_subject_id_subjects_id_fk",
+          "tableFrom": "standards",
+          "tableTo": "subjects",
+          "columnsFrom": [
+            "subject_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "standards_grade_id_grades_id_fk": {
+          "name": "standards_grade_id_grades_id_fk",
+          "tableFrom": "standards",
+          "tableTo": "grades",
+          "columnsFrom": [
+            "grade_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        },
+        "standards_created_by_users_id_fk": {
+          "name": "standards_created_by_users_id_fk",
+          "tableFrom": "standards",
+          "tableTo": "users",
+          "columnsFrom": [
+            "created_by"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "standards_id": {
+          "name": "standards_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "subjects": {
+      "name": "subjects",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "order": {
+          "name": "order",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "subjects_name_idx": {
+          "name": "subjects_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "subjects_id": {
+          "name": "subjects_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "subjects_name_unique": {
+          "name": "subjects_name_unique",
+          "columns": [
+            "name"
+          ]
+        },
+        "subjects_code_unique": {
+          "name": "subjects_code_unique",
+          "columns": [
+            "code"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "submission_answers": {
+      "name": "submission_answers",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "submission_id": {
+          "name": "submission_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "question_id": {
+          "name": "question_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "answer_content": {
+          "name": "answer_content",
+          "type": "json",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "score": {
+          "name": "score",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "feedback": {
+          "name": "feedback",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "submission_idx": {
+          "name": "submission_idx",
+          "columns": [
+            "submission_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "submission_answers_submission_id_exam_submissions_id_fk": {
+          "name": "submission_answers_submission_id_exam_submissions_id_fk",
+          "tableFrom": "submission_answers",
+          "tableTo": "exam_submissions",
+          "columnsFrom": [
+            "submission_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "submission_answers_question_id_questions_id_fk": {
+          "name": "submission_answers_question_id_questions_id_fk",
+          "tableFrom": "submission_answers",
+          "tableTo": "questions",
+          "columnsFrom": [
+            "question_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "submission_answers_id": {
+          "name": "submission_answers_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "system_settings": {
+      "name": "system_settings",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "category": {
+          "name": "category",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "key": {
+          "name": "key",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "value": {
+          "name": "value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "value_type": {
+          "name": "value_type",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'string'"
+        },
+        "updated_by": {
+          "name": "updated_by",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "ss_category_key_idx": {
+          "name": "ss_category_key_idx",
+          "columns": [
+            "category",
+            "key"
+          ],
+          "isUnique": true
+        },
+        "ss_category_idx": {
+          "name": "ss_category_idx",
+          "columns": [
+            "category"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "system_settings_id": {
+          "name": "system_settings_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "textbooks": {
+      "name": "textbooks",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "grade": {
+          "name": "grade",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "publisher": {
+          "name": "publisher",
+          "type": "varchar(100)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "textbooks_id": {
+          "name": "textbooks_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "user_blocks": {
+      "name": "user_blocks",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "blocker_id": {
+          "name": "blocker_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "blocked_id": {
+          "name": "blocked_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "user_blocks_blocker_blocked_uniq": {
+          "name": "user_blocks_blocker_blocked_uniq",
+          "columns": [
+            "blocker_id",
+            "blocked_id"
+          ],
+          "isUnique": true
+        },
+        "user_blocks_blocker_idx": {
+          "name": "user_blocks_blocker_idx",
+          "columns": [
+            "blocker_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "user_blocks_blocker_id_users_id_fk": {
+          "name": "user_blocks_blocker_id_users_id_fk",
+          "tableFrom": "user_blocks",
+          "tableTo": "users",
+          "columnsFrom": [
+            "blocker_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "user_blocks_blocked_id_users_id_fk": {
+          "name": "user_blocks_blocked_id_users_id_fk",
+          "tableFrom": "user_blocks",
+          "tableTo": "users",
+          "columnsFrom": [
+            "blocked_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "user_blocks_id": {
+          "name": "user_blocks_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "users": {
+      "name": "users",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "email": {
+          "name": "email",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "emailVerified": {
+          "name": "emailVerified",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "image": {
+          "name": "image",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "password": {
+          "name": "password",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "phone": {
+          "name": "phone",
+          "type": "varchar(30)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "address": {
+          "name": "address",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "gender": {
+          "name": "gender",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "age": {
+          "name": "age",
+          "type": "int",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "grade_id": {
+          "name": "grade_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "department_id": {
+          "name": "department_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "onboarded_at": {
+          "name": "onboarded_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "birth_date": {
+          "name": "birth_date",
+          "type": "date",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "guardian_name": {
+          "name": "guardian_name",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "guardian_phone": {
+          "name": "guardian_phone",
+          "type": "varchar(20)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "guardian_relation": {
+          "name": "guardian_relation",
+          "type": "varchar(50)",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "consent_accepted_at": {
+          "name": "consent_accepted_at",
+          "type": "datetime",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "(now())"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "onUpdate": true,
+          "default": "(now())"
+        }
+      },
+      "indexes": {
+        "email_idx": {
+          "name": "email_idx",
+          "columns": [
+            "email"
+          ],
+          "isUnique": false
+        },
+        "users_grade_id_idx": {
+          "name": "users_grade_id_idx",
+          "columns": [
+            "grade_id"
+          ],
+          "isUnique": false
+        },
+        "users_department_id_idx": {
+          "name": "users_department_id_idx",
+          "columns": [
+            "department_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "users_id": {
+          "name": "users_id",
+          "columns": [
+            "id"
+          ]
+        }
+      },
+      "uniqueConstraints": {
+        "users_email_unique": {
+          "name": "users_email_unique",
+          "columns": [
+            "email"
+          ]
+        }
+      },
+      "checkConstraint": {}
+    },
+    "users_to_roles": {
+      "name": "users_to_roles",
+      "columns": {
+        "user_id": {
+          "name": "user_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "role_id": {
+          "name": "role_id",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "user_id_idx": {
+          "name": "user_id_idx",
+          "columns": [
+            "user_id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "users_to_roles_user_id_users_id_fk": {
+          "name": "users_to_roles_user_id_users_id_fk",
+          "tableFrom": "users_to_roles",
+          "tableTo": "users",
+          "columnsFrom": [
+            "user_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "users_to_roles_role_id_roles_id_fk": {
+          "name": "users_to_roles_role_id_roles_id_fk",
+          "tableFrom": "users_to_roles",
+          "tableTo": "roles",
+          "columnsFrom": [
+            "role_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "users_to_roles_user_id_role_id_pk": {
+          "name": "users_to_roles_user_id_role_id_pk",
+          "columns": [
+            "user_id",
+            "role_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    },
+    "verificationTokens": {
+      "name": "verificationTokens",
+      "columns": {
+        "identifier": {
+          "name": "identifier",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "token": {
+          "name": "token",
+          "type": "varchar(255)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "expires": {
+          "name": "expires",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "verificationTokens_identifier_token_pk": {
+          "name": "verificationTokens_identifier_token_pk",
+          "columns": [
+            "identifier",
+            "token"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraint": {}
+    }
+  },
+  "views": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "tables": {},
+    "indexes": {}
+  }
+}
\ No newline at end of file
diff --git a/drizzle/meta/_journal.json b/drizzle/meta/_journal.json
index 7e833d4..7958c5b 100644
--- a/drizzle/meta/_journal.json
+++ b/drizzle/meta/_journal.json
@@ -8,6 +8,13 @@
       "when": 1783064688766,
       "tag": "0000_aberrant_deathstrike",
       "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "5",
+      "when": 1783234384304,
+      "tag": "0001_questions_fulltext_search",
+      "breakpoints": true
     }
   ]
 }
\ No newline at end of file
diff --git a/package-lock.json b/package-lock.json
index 95abeda..3c7fc51 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -37,6 +37,7 @@
         "@t3-oss/env-nextjs": "^0.13.10",
         "@tanstack/react-query": "^5.90.12",
         "@tanstack/react-table": "^8.21.3",
+        "@tanstack/react-virtual": "^3.14.5",
         "@tiptap/extension-image": "^3.27.1",
         "@tiptap/extension-placeholder": "^3.15.3",
         "@tiptap/pm": "^3.15.3",
@@ -82,6 +83,7 @@
         "@playwright/test": "^1.58.2",
         "@tailwindcss/postcss": "^4",
         "@tailwindcss/typography": "^0.5.16",
+        "@tanstack/react-query-devtools": "^5.101.2",
         "@testing-library/dom": "^10.4.1",
         "@testing-library/jest-dom": "^6.9.1",
         "@testing-library/react": "^16.3.2",
@@ -6535,9 +6537,20 @@
       }
     },
     "node_modules/@tanstack/query-core": {
-      "version": "5.90.12",
-      "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.90.12.tgz",
-      "integrity": "sha512-T1/8t5DhV/SisWjDnaiU2drl6ySvsHj1bHBCWNXd+/T+Hh1cf6JodyEYMd5sgwm+b/mETT4EV3H+zCVczCU5hg==",
+      "version": "5.101.2",
+      "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.101.2.tgz",
+      "integrity": "sha512-hH5MLoJhF7KaIGd7q3xTXGXvslI+GYlM1Z/35aSHHWaCJWB7XvTSHYuV3eM7tw+aE0mT/xMro4M4Q9rCGHT0lw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      }
+    },
+    "node_modules/@tanstack/query-devtools": {
+      "version": "5.101.2",
+      "resolved": "https://registry.npmjs.org/@tanstack/query-devtools/-/query-devtools-5.101.2.tgz",
+      "integrity": "sha512-o+wHcqgN7Pp0s8v1i0UGq/ZrrEKrxdIiMQmKRdYb2w7NPtylYSJ4+wg/tIn71m9DLstwUwdEGAvROdly6HXP6w==",
+      "dev": true,
       "license": "MIT",
       "funding": {
         "type": "github",
@@ -6545,12 +6558,12 @@
       }
     },
     "node_modules/@tanstack/react-query": {
-      "version": "5.90.12",
-      "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.90.12.tgz",
-      "integrity": "sha512-graRZspg7EoEaw0a8faiUASCyJrqjKPdqJ9EwuDRUF9mEYJ1YPczI9H+/agJ0mOJkPCJDk0lsz5QTrLZ/jQ2rg==",
+      "version": "5.101.2",
+      "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.101.2.tgz",
+      "integrity": "sha512-seDkr6kzGzX1okaaTtZPtgA688CDPlXUz1C6xSg0ESqn04Vuc8tlrYms1s3de+znBqhPVxFRfpAfUf+6XvfPWg==",
       "license": "MIT",
       "dependencies": {
-        "@tanstack/query-core": "5.90.12"
+        "@tanstack/query-core": "5.101.2"
       },
       "funding": {
         "type": "github",
@@ -6560,6 +6573,24 @@
         "react": "^18 || ^19"
       }
     },
+    "node_modules/@tanstack/react-query-devtools": {
+      "version": "5.101.2",
+      "resolved": "https://registry.npmjs.org/@tanstack/react-query-devtools/-/react-query-devtools-5.101.2.tgz",
+      "integrity": "sha512-eU7HctdA9gDjqoERoEdzLbw9DiqnBDfh5+Hu0u26gjqoHJezOpQAuiesDL2VvkU+2cPV76zgv0tMZsOrI4LjnQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@tanstack/query-devtools": "5.101.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      },
+      "peerDependencies": {
+        "@tanstack/react-query": "^5.101.2",
+        "react": "^18 || ^19"
+      }
+    },
     "node_modules/@tanstack/react-table": {
       "version": "8.21.3",
       "resolved": "https://registry.npmjs.org/@tanstack/react-table/-/react-table-8.21.3.tgz",
@@ -6580,6 +6611,23 @@
         "react-dom": ">=16.8"
       }
     },
+    "node_modules/@tanstack/react-virtual": {
+      "version": "3.14.5",
+      "resolved": "https://registry.npmjs.org/@tanstack/react-virtual/-/react-virtual-3.14.5.tgz",
+      "integrity": "sha512-4EKRXh7zBLkbKbFmG3AUVkircuHd+7OdT1pocJSepxtfBd3qnrJgJ5rtPkRYyo9fmyVb2+pI2xPy5oYvMLQy6A==",
+      "license": "MIT",
+      "dependencies": {
+        "@tanstack/virtual-core": "3.17.3"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      },
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+        "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
     "node_modules/@tanstack/table-core": {
       "version": "8.21.3",
       "resolved": "https://registry.npmjs.org/@tanstack/table-core/-/table-core-8.21.3.tgz",
@@ -6593,6 +6641,16 @@
         "url": "https://github.com/sponsors/tannerlinsley"
       }
     },
+    "node_modules/@tanstack/virtual-core": {
+      "version": "3.17.3",
+      "resolved": "https://registry.npmjs.org/@tanstack/virtual-core/-/virtual-core-3.17.3.tgz",
+      "integrity": "sha512-8Np/TFELpI0ySuJoVmjvOrQYXH/8sTX0Biv9szhFhY39xOdAAY+smrMxjxOum/ux3eM8MUJQsEJ0/R0UpvC8dw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      }
+    },
     "node_modules/@testing-library/dom": {
       "version": "10.4.1",
       "resolved": "https://registry.npmjs.org/@testing-library/dom/-/dom-10.4.1.tgz",
diff --git a/package.json b/package.json
index 9c2390b..dfdf8c0 100644
--- a/package.json
+++ b/package.json
@@ -69,6 +69,7 @@
     "@t3-oss/env-nextjs": "^0.13.10",
     "@tanstack/react-query": "^5.90.12",
     "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "^3.14.5",
     "@tiptap/extension-image": "^3.27.1",
     "@tiptap/extension-placeholder": "^3.15.3",
     "@tiptap/pm": "^3.15.3",
@@ -114,6 +115,7 @@
     "@playwright/test": "^1.58.2",
     "@tailwindcss/postcss": "^4",
     "@tailwindcss/typography": "^0.5.16",
+    "@tanstack/react-query-devtools": "^5.101.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
diff --git a/src/app/(dashboard)/parent/loading.tsx b/src/app/(dashboard)/parent/loading.tsx
new file mode 100644
index 0000000..b510cf9
--- /dev/null
+++ b/src/app/(dashboard)/parent/loading.tsx
@@ -0,0 +1,24 @@
+import { Skeleton } from "@/shared/components/ui/skeleton"
+
+/**
+ * parent 段根级 Suspense fallback。
+ *
+ * 该目录无 page.tsx,本 loading.tsx 作为 parent 段下所有子路由 page 加载时的
+ * 默认 Suspense fallback,避免白屏。
+ */
+export default function ParentLoading() {
+  return (
+    <div className="flex h-full flex-col space-y-6 p-6">
+      <div className="space-y-2">
+        <Skeleton className="h-8 w-48" />
+        <Skeleton className="h-4 w-72" />
+      </div>
+      <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
+        {Array.from({ length: 6 }).map((_, i) => (
+          <Skeleton key={i} className="h-32 w-full rounded-lg" />
+        ))}
+      </div>
+      <Skeleton className="h-64 w-full rounded-lg" />
+    </div>
+  )
+}
diff --git a/src/app/(dashboard)/student/learning/assignments/page.tsx b/src/app/(dashboard)/student/learning/assignments/page.tsx
index 8d46439..b02922b 100644
--- a/src/app/(dashboard)/student/learning/assignments/page.tsx
+++ b/src/app/(dashboard)/student/learning/assignments/page.tsx
@@ -1,4 +1,5 @@
 import Link from "next/link"
+import { memo } from "react"
 import { getTranslations } from "next-intl/server"
 
 import { EmptyState } from "@/shared/components/ui/empty-state"
@@ -79,7 +80,11 @@ const getSubjectColor = (subject: string): string => {
 
 type TranslationFn = (key: string) => string
 
-function AssignmentCard({
+/**
+ * 高频列表项卡片（在作业列表中按科目分组多次渲染），
+ * 使用 React.memo 跳过 props 未变化时的重渲染。
+ */
+const AssignmentCard = memo(function AssignmentCard({
   assignment: a,
   t,
   statusLabelMap,
@@ -138,7 +143,7 @@ function AssignmentCard({
       </CardContent>
     </Card>
   )
-}
+})
 
 export default async function StudentAssignmentsPage({
   searchParams,
diff --git a/src/app/(dashboard)/student/loading.tsx b/src/app/(dashboard)/student/loading.tsx
new file mode 100644
index 0000000..48a5a5d
--- /dev/null
+++ b/src/app/(dashboard)/student/loading.tsx
@@ -0,0 +1,24 @@
+import { Skeleton } from "@/shared/components/ui/skeleton"
+
+/**
+ * student 段根级 Suspense fallback。
+ *
+ * 该目录无 page.tsx,本 loading.tsx 作为 student 段下所有子路由 page 加载时的
+ * 默认 Suspense fallback,避免白屏。
+ */
+export default function StudentLoading() {
+  return (
+    <div className="flex h-full flex-col space-y-6 p-6">
+      <div className="space-y-2">
+        <Skeleton className="h-8 w-48" />
+        <Skeleton className="h-4 w-72" />
+      </div>
+      <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
+        {Array.from({ length: 6 }).map((_, i) => (
+          <Skeleton key={i} className="h-32 w-full rounded-lg" />
+        ))}
+      </div>
+      <Skeleton className="h-64 w-full rounded-lg" />
+    </div>
+  )
+}
diff --git a/src/app/(dashboard)/teacher/loading.tsx b/src/app/(dashboard)/teacher/loading.tsx
new file mode 100644
index 0000000..c52d8a4
--- /dev/null
+++ b/src/app/(dashboard)/teacher/loading.tsx
@@ -0,0 +1,24 @@
+import { Skeleton } from "@/shared/components/ui/skeleton"
+
+/**
+ * teacher 段根级 Suspense fallback。
+ *
+ * 该目录无 page.tsx,本 loading.tsx 作为 teacher 段下所有子路由 page 加载时的
+ * 默认 Suspense fallback,避免白屏。
+ */
+export default function TeacherLoading() {
+  return (
+    <div className="flex h-full flex-col space-y-6 p-6">
+      <div className="space-y-2">
+        <Skeleton className="h-8 w-48" />
+        <Skeleton className="h-4 w-72" />
+      </div>
+      <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
+        {Array.from({ length: 6 }).map((_, i) => (
+          <Skeleton key={i} className="h-32 w-full rounded-lg" />
+        ))}
+      </div>
+      <Skeleton className="h-64 w-full rounded-lg" />
+    </div>
+  )
+}
diff --git a/src/app/api/search/route.ts b/src/app/api/search/route.ts
index af9ea4e..2ca03d3 100644
--- a/src/app/api/search/route.ts
+++ b/src/app/api/search/route.ts
@@ -79,7 +79,8 @@ export async function GET(req: Request) {
 
     // 学生不能搜索题目和考试
     if (!isStudent && (type === "all" || type === "question")) {
-      tasks.push(searchQuestions(kw, pageSize))
+      // P3-6: searchQuestions 改用 MATCH AGAINST，需要原始查询字符串 q 而非 %q% 格式
+      tasks.push(searchQuestions(q, pageSize))
     }
     if (type === "all" || type === "textbook") {
       tasks.push(searchTextbooks(kw, pageSize))
@@ -118,7 +119,11 @@ export async function GET(req: Request) {
   }
 }
 
-async function searchQuestions(kw: string, limit: number): Promise<SearchResultItem[]> {
+async function searchQuestions(q: string, limit: number): Promise<SearchResultItem[]> {
+  // P3-6: 使用 questions.content_text STORED 生成列上的 FULLTEXT 索引
+  // 通过 MATCH AGAINST BOOLEAN MODE 实现高效全文检索
+  const booleanQuery = toBooleanModeQuery(q)
+  if (!booleanQuery) return []
   try {
     const rows = await db
       .select({
@@ -128,13 +133,7 @@ async function searchQuestions(kw: string, limit: number): Promise<SearchResultI
         createdAt: questions.createdAt,
       })
       .from(questions)
-      .where(
-        or(
-          // JSON 内容字段转换为文本进行模糊匹配
-          sql`CAST(${questions.content} AS CHAR) LIKE ${kw}`,
-          like(sql`CAST(${questions.content} AS CHAR)`, kw)
-        )!
-      )
+      .where(sql`MATCH(${questions.contentText}) AGAINST(${booleanQuery} IN BOOLEAN MODE)`)
       .orderBy(desc(questions.createdAt))
       .limit(limit)
 
@@ -277,3 +276,19 @@ function truncate(s: string, max: number): string {
   if (t.length <= max) return t
   return t.slice(0, max) + "..."
 }
+
+/**
+ * P3-6: 将原始查询字符串转换为 MySQL FULLTEXT BOOLEAN MODE 查询格式。
+ *
+ * 转换规则：
+ * - 按空白拆分为多个词
+ * - 转义 BOOLEAN MODE 特殊字符（+ - < > ( ) ~ * " '）
+ * - 每个词添加 `+` 前缀（必须出现）和 `*` 后缀（前缀匹配）
+ * - 例如 "math question" → "+math* +question*"
+ */
+function toBooleanModeQuery(q: string): string {
+  const words = q.trim().split(/\s+/).filter(Boolean)
+  if (words.length === 0) return ""
+  const escapeWord = (w: string): string => `+${w.replace(/[+\-<>()~*"']/g, " ").trim()}*`
+  return words.map(escapeWord).filter((w) => w !== "+*").join(" ")
+}
diff --git a/src/app/api/web-vitals/route.ts b/src/app/api/web-vitals/route.ts
new file mode 100644
index 0000000..ce6d080
--- /dev/null
+++ b/src/app/api/web-vitals/route.ts
@@ -0,0 +1,73 @@
+import { NextResponse } from "next/server";
+
+/**
+ * Web Vitals 上报端点
+ *
+ * 接收前端 navigator.sendBeacon 上报的 LCP/CLS/INP/FCP/TTFP 指标,
+ * 当前实现:写入服务端日志(便于开发期查看),生产可接入监控系统。
+ *
+ * 性能预算基线(见 docs/architecture/audit/performance-budget-audit-report.md):
+ * - LCP ≤ 2.5s,INP ≤ 200ms,CLS ≤ 0.05,TTFB ≤ 800ms,FCP ≤ 1.8s
+ * - 超出预算的 "poor" 级别会以 warn 级别日志记录便于排查
+ */
+export const runtime = "edge";
+
+type WebVitalEntry = {
+  name: string;
+  startTime: number;
+  duration: number;
+  entryType: string;
+};
+
+type WebVitalsPayload = {
+  id: string;
+  name: string;
+  value: number;
+  rating: "good" | "needs-improvement" | "poor";
+  delta: number;
+  entries: WebVitalEntry[];
+  path: string;
+  timestamp: number;
+};
+
+// 性能预算基线,超出即标记为 poor
+const BUDGETS: Record<string, number> = {
+  LCP: 2500,
+  INP: 200,
+  CLS: 0.05,
+  FCP: 1800,
+  TTFB: 800,
+};
+
+export async function POST(request: Request): Promise<NextResponse> {
+  let payload: WebVitalsPayload;
+  try {
+    payload = (await request.json()) as WebVitalsPayload;
+  } catch {
+    return NextResponse.json({ ok: false }, { status: 400 });
+  }
+
+  const budget = BUDGETS[payload.name];
+  const isOverBudget = budget !== undefined && payload.value > budget;
+
+  // good/info 级别用 info,rating poor 或超预算用 warn
+  if (payload.rating === "poor" || isOverBudget) {
+    console.warn("[web-vitals] over-budget", {
+      name: payload.name,
+      value: payload.value,
+      rating: payload.rating,
+      budget,
+      path: payload.path,
+      id: payload.id,
+    });
+  } else {
+    console.info("[web-vitals] reported", {
+      name: payload.name,
+      value: payload.value,
+      rating: payload.rating,
+      path: payload.path,
+    });
+  }
+
+  return NextResponse.json({ ok: true });
+}
diff --git a/src/app/providers.tsx b/src/app/providers.tsx
new file mode 100644
index 0000000..b5c9b68
--- /dev/null
+++ b/src/app/providers.tsx
@@ -0,0 +1,68 @@
+"use client"
+
+import React, { useState, type ReactNode } from "react"
+import { QueryClientProvider } from "@tanstack/react-query"
+import { ReactQueryDevtools } from "@tanstack/react-query-devtools"
+import { NextIntlClientProvider } from "next-intl"
+import { NuqsAdapter } from "nuqs/adapters/next/app"
+import { SessionProvider } from "next-auth/react"
+import type { Session } from "next-auth"
+import { ThemeProvider } from "@/shared/components/theme-provider"
+import { Toaster } from "@/shared/components/ui/sonner"
+import { createQueryClient } from "@/shared/lib/query-client"
+
+interface ProvidersProps {
+  children: ReactNode
+  locale: string
+  messages: Record<string, unknown>
+  session: Session | null
+}
+
+/**
+ * 客户端 Provider 聚合。
+ *
+ * 嵌套顺序（外层 → 内层）：
+ *  1. QueryClientProvider — 最外层，避免子组件因 Query 重渲染丢失下层状态
+ *  2. NextIntlClientProvider — i18n 字典注入
+ *  3. ThemeProvider — 主题
+ *  4. SessionProvider — next-auth session
+ *  5. NuqsAdapter — URL 状态
+ *  6. children + Toaster
+ *
+ * V5 Phase 4 调整：移除 NotifyConfigurator（notify.ts 改为直接显示文本，
+ * 不再依赖 i18n resolver 注入；i18n 由调用方通过 t() 控制）。
+ */
+export function Providers({
+  children,
+  locale,
+  messages,
+  session,
+}: ProvidersProps): React.JSX.Element {
+  // 每个客户端会话独立 QueryClient，避免 SSR 跨用户共享缓存
+  const [client] = useState(() => createQueryClient())
+
+  return (
+    <QueryClientProvider client={client}>
+      <NextIntlClientProvider locale={locale} messages={messages}>
+        <ThemeProvider
+          attribute="class"
+          defaultTheme="system"
+          enableSystem
+          disableTransitionOnChange
+        >
+          <SessionProvider
+            session={session}
+            refetchOnWindowFocus={false}
+            refetchInterval={0}
+          >
+            <NuqsAdapter>{children}</NuqsAdapter>
+          </SessionProvider>
+          <Toaster />
+        </ThemeProvider>
+      </NextIntlClientProvider>
+      {process.env.NODE_ENV === "development" && (
+        <ReactQueryDevtools initialIsOpen={false} />
+      )}
+    </QueryClientProvider>
+  )
+}
diff --git a/src/app/web-vitals-reporter.tsx b/src/app/web-vitals-reporter.tsx
new file mode 100644
index 0000000..4a56b29
--- /dev/null
+++ b/src/app/web-vitals-reporter.tsx
@@ -0,0 +1,62 @@
+"use client";
+
+import { useReportWebVitals } from "next/web-vitals";
+import { useCallback } from "react";
+
+/**
+ * Web Vitals 上报组件
+ *
+ * 在根布局渲染,采集 LCP/CLS/INP/FCP/TTFP 指标,
+ * 通过 navigator.sendBeacon 上报到 /api/web-vitals 端点。
+ *
+ * - 上报时机:指标首次确定 + CLS 在页面隐藏时再次上报
+ * - 上报方式:sendBeacon 优先(不阻塞页面),fetch fallback
+ * - 数据用途:生产环境真实用户性能监控(RUM),用于验证性能预算基线
+ */
+
+// 从 useReportWebVitals 签名推导 metric 类型(避免依赖 next 内部模块路径)
+type WebVitalMetric = Parameters<Parameters<typeof useReportWebVitals>[0]>[0]
+
+export function WebVitalsReporter(): React.ReactElement {
+  const handleReport = useCallback((metric: WebVitalMetric) => {
+    const payload = JSON.stringify({
+      id: metric.id,
+      name: metric.name,
+      value: metric.value,
+      rating: metric.rating,
+      delta: metric.delta,
+      entries: metric.entries.map((entry: PerformanceEntry) => ({
+        name: entry.name,
+        startTime: entry.startTime,
+        duration: entry.duration,
+        entryType: entry.entryType,
+      })),
+      // 路由上下文,便于按路由分组统计
+      path: typeof window !== "undefined" ? window.location.pathname : "/",
+      timestamp: Date.now(),
+    });
+
+    // 优先 sendBeacon,失败回退 fetch keepalive
+    if (
+      typeof navigator !== "undefined" &&
+      typeof navigator.sendBeacon === "function"
+    ) {
+      const blob = new Blob([payload], { type: "application/json" });
+      const ok = navigator.sendBeacon("/api/web-vitals", blob);
+      if (ok) return;
+    }
+
+    void fetch("/api/web-vitals", {
+      body: payload,
+      method: "POST",
+      keepalive: true,
+      headers: { "Content-Type": "application/json" },
+    }).catch(() => {
+      // 静默失败,性能上报不应影响业务
+    });
+  }, []);
+
+  useReportWebVitals(handleReport);
+
+  return <></>;
+}
diff --git a/src/modules/adaptive-practice/data-access-strategy.ts b/src/modules/adaptive-practice/data-access-strategy.ts
index dee04e2..4bbbf58 100644
--- a/src/modules/adaptive-practice/data-access-strategy.ts
+++ b/src/modules/adaptive-practice/data-access-strategy.ts
@@ -9,6 +9,7 @@ import {
   questions,
   questionsToKnowledgePoints,
 } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 import { isWeakChapterSourceMeta, isAiRecommendedSourceMeta, isKnowledgePointSourceMeta, isErrorVariantSourceMeta } from "./lib/source-meta"
 import type { PracticeSourceMeta, QuestionSelectionResult } from "./types"
@@ -285,7 +286,7 @@ export async function selectQuestionsForPractice(
  * 从专项练习中汇总已答题目。
  * P3-8: LIMIT 从 1000 调低至 100，仅查询最近 100 条记录以控制查询量。
  */
-export async function getStudentAnsweredQuestionIds(studentId: string): Promise<string[]> {
+export async function getStudentAnsweredQuestionIdsRaw(studentId: string): Promise<string[]> {
   const rows = await db
     .select({ questionId: practiceAnswers.questionId })
     .from(practiceAnswers)
@@ -295,6 +296,12 @@ export async function getStudentAnsweredQuestionIds(studentId: string): Promise<
   return Array.from(new Set(rows.map((r) => r.questionId)))
 }
 
+export const getStudentAnsweredQuestionIds = cacheFn(getStudentAnsweredQuestionIdsRaw, {
+  tags: ["adaptive-practice:students"],
+  ttl: 60,
+  keyParts: ["adaptive-practice", "students", "answered-questions"],
+})
+
 /**
  * 自动识别学生的薄弱知识点。
  *
@@ -306,7 +313,7 @@ export async function getStudentAnsweredQuestionIds(studentId: string): Promise<
  * @param limit 返回数量限制
  * @returns 薄弱知识点 ID 列表
  */
-export async function identifyWeakKnowledgePoints(
+export async function identifyWeakKnowledgePointsRaw(
   studentId: string,
   chapterId?: string,
   limit: number = DEFAULT_WEAK_KP_LIMIT,
@@ -328,3 +335,9 @@ export async function identifyWeakKnowledgePoints(
 
   return rows.map((r) => r.knowledgePointId)
 }
+
+export const identifyWeakKnowledgePoints = cacheFn(identifyWeakKnowledgePointsRaw, {
+  tags: ["adaptive-practice:students"],
+  ttl: 60,
+  keyParts: ["adaptive-practice", "students", "weak-kps"],
+})
diff --git a/src/modules/ai/components/ai-assistant-widget-inner.tsx b/src/modules/ai/components/ai-assistant-widget-inner.tsx
new file mode 100644
index 0000000..7f1ae38
--- /dev/null
+++ b/src/modules/ai/components/ai-assistant-widget-inner.tsx
@@ -0,0 +1,331 @@
+"use client"
+
+import { useState, useMemo } from "react"
+import { usePathname } from "next/navigation"
+import { useTranslations } from "next-intl"
+import { Bot, X, Sparkles, RotateCcw, ChevronLeft } from "lucide-react"
+
+import { Button } from "@/shared/components/ui/button"
+import {
+  Sheet,
+  SheetContent,
+  SheetHeader,
+  SheetTitle,
+} from "@/shared/components/ui/sheet"
+import { AiChatPanel } from "./ai-chat-panel"
+import { useAiClientOptional } from "../context/ai-client-provider"
+import { useFloatingBall } from "../hooks/use-floating-ball"
+
+/**
+ * 上下文感知规则
+ *
+ * 根据当前路由推断用户上下文，动态生成 systemPrompt 和 contextMessage。
+ */
+type AiContextConfig = {
+  systemPrompt: string
+  contextMessage: string
+  suggestedPrompts?: string[]
+}
+
+/**
+ * 全局 AI 助手悬浮球（360 悬浮球风格）— 内部实现
+ *
+ * 特性：
+ * - 可拖拽移动，松手吸附到最近屏幕边缘
+ * - 拖到边缘自动半隐藏（只露出一小部分）
+ * - 鼠标悬停时恢复显示
+ * - 位置持久化到 localStorage
+ * - 点击打开侧边抽屉，内嵌 AiChatPanel
+ * - 上下文感知：根据当前路由自动推断用户场景
+ *
+ * 该组件被打包进独立 chunk（由 ai-assistant-widget.tsx 通过 next/dynamic 以 ssr:false 懒加载），
+ * 以避免 AiChatPanel 依赖的 AI SDK / Markdown 渲染等重型依赖被打入首屏 chunk。
+ *
+ * 使用：在 dashboard layout 中引入即可全局生效。
+ * 需要 AiClientProvider 包裹（可选，未注入时按钮不显示）。
+ */
+export function AiAssistantWidgetInner(): React.ReactNode {
+  const t = useTranslations("ai")
+  const pathname = usePathname()
+  const aiClient = useAiClientOptional()
+  const [open, setOpen] = useState(false)
+  const [chatKey, setChatKey] = useState(0)
+
+  const handleBallClick = () => setOpen(true)
+  const ball = useFloatingBall(handleBallClick)
+
+  // 根据路由推断上下文
+  const contextConfig = useMemo<AiContextConfig>(() => {
+    return inferContextFromPath(pathname, t)
+  }, [pathname, t])
+
+  // 如果未注入 AI 客户端服务，不显示悬浮按钮
+  if (!aiClient) {
+    return null
+  }
+
+  const { position, hidden, dragging, hovered, hiddenOffset, handlers, show, resetPosition } = ball
+
+  // 首次渲染时 position 为占位值（屏幕外），避免闪烁
+  const isReady = position.x < 9999
+
+  return (
+    <>
+      {/* 悬浮球 */}
+      {isReady ? (
+        <button
+          type="button"
+          aria-label={hidden ? t("widget.show") : t("widget.open")}
+          className="fixed z-50 flex select-none items-center justify-center rounded-full bg-gradient-to-br from-primary to-primary/80 text-primary-foreground shadow-lg transition-[width,height,opacity,transform] duration-200 ease-out hover:shadow-xl hover:scale-105 touch-none"
+          style={{
+            left: `${position.x}px`,
+            top: `${position.y}px`,
+            width: "56px",
+            height: "56px",
+            transform: `translateX(${hiddenOffset}px) ${dragging ? "scale(1.1)" : ""}`,
+            cursor: dragging ? "grabbing" : "grab",
+            opacity: hidden && !hovered ? 0.55 : 1,
+            transition: dragging ? "none" : "transform 0.25s ease-out, opacity 0.25s ease-out",
+          }}
+          onPointerDown={handlers.onPointerDown}
+          onPointerMove={handlers.onPointerMove}
+          onPointerUp={handlers.onPointerUp}
+          onPointerCancel={handlers.onPointerCancel}
+          onMouseEnter={handlers.onMouseEnter}
+          onMouseLeave={handlers.onMouseLeave}
+          onClick={(e) => {
+            // 拖动产生的 click 不触发打开
+            if (e.detail === 0) return
+          }}
+        >
+          <Bot className="h-6 w-6 drop-shadow-sm" />
+          <span className="pointer-events-none absolute -top-0.5 -right-0.5 flex h-3 w-3">
+            <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-emerald-400 opacity-75" />
+            <span className="relative inline-flex rounded-full h-3 w-3 bg-emerald-500 ring-2 ring-background" />
+          </span>
+          {hidden ? (
+            <span className="pointer-events-none absolute inset-0 flex items-center justify-center rounded-full bg-primary/30 opacity-0 transition-opacity hover:opacity-100">
+              <ChevronLeft
+                className="h-4 w-4"
+                style={{
+                  transform: position.x <= 16 ? "rotate(0deg)" : "rotate(180deg)",
+                }}
+              />
+            </span>
+          ) : null}
+        </button>
+      ) : null}
+
+      {/* 半隐藏时的提示条 */}
+      {hidden && isReady ? (
+        <button
+          type="button"
+          aria-label={t("widget.show")}
+          className="fixed z-40 flex items-center justify-center rounded-full bg-primary/15 text-primary backdrop-blur-sm transition-opacity hover:bg-primary/25"
+          style={{
+            left: `${position.x + (hiddenOffset > 0 ? 0 : BALL_SIZE * 0.45)}px`,
+            top: `${position.y}px`,
+            width: "14px",
+            height: "56px",
+            cursor: "pointer",
+          }}
+          onClick={show}
+        >
+          <ChevronLeft
+            className="h-3 w-3"
+            style={{
+              transform: position.x <= 16 ? "rotate(0deg)" : "rotate(180deg)",
+            }}
+          />
+        </button>
+      ) : null}
+
+      {/* 侧边抽屉 */}
+      <Sheet open={open} onOpenChange={setOpen}>
+        <SheetContent hideClose className="w-full sm:max-w-lg overflow-hidden p-0 flex flex-col">
+          <SheetHeader className="px-5 py-4 border-b bg-gradient-to-r from-primary/5 to-transparent">
+            <div className="flex items-center justify-between">
+              <SheetTitle className="flex items-center gap-2.5">
+                <span className="flex h-9 w-9 items-center justify-center rounded-full bg-gradient-to-br from-primary to-primary/80 text-primary-foreground shadow-sm">
+                  <Bot className="h-5 w-5" />
+                </span>
+                <div className="flex flex-col">
+                  <span className="text-base font-semibold leading-tight">{t("widget.title")}</span>
+                  <span className="flex items-center gap-1 text-xs text-muted-foreground">
+                    <span className="inline-block h-1.5 w-1.5 rounded-full bg-emerald-500" />
+                    {t("widget.online")}
+                  </span>
+                </div>
+              </SheetTitle>
+              <div className="flex items-center gap-1">
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  className="h-8 w-8 p-0 text-muted-foreground"
+                  onClick={() => {
+                    try {
+                      localStorage.removeItem("ai-chat-history")
+                    } catch {
+                      // ignore
+                    }
+                    setChatKey((k) => k + 1)
+                  }}
+                  aria-label={t("widget.newChat")}
+                  title={t("widget.newChat")}
+                >
+                  <Sparkles className="h-4 w-4" />
+                </Button>
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  className="h-8 w-8 p-0 text-muted-foreground"
+                  onClick={resetPosition}
+                  aria-label={t("widget.resetPosition")}
+                  title={t("widget.resetPosition")}
+                >
+                  <RotateCcw className="h-4 w-4" />
+                </Button>
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  className="h-8 w-8 p-0 text-muted-foreground"
+                  onClick={() => setOpen(false)}
+                  aria-label={t("widget.close")}
+                  title={t("widget.close")}
+                >
+                  <X className="h-4 w-4" />
+                </Button>
+              </div>
+            </div>
+          </SheetHeader>
+          <div className="flex-1 overflow-y-auto">
+            <AiChatPanel
+              key={chatKey}
+              systemPrompt={contextConfig.systemPrompt}
+              contextMessage={contextConfig.contextMessage}
+              suggestedPrompts={contextConfig.suggestedPrompts}
+              maxMessages={30}
+              variant="widget"
+            />
+          </div>
+        </SheetContent>
+      </Sheet>
+    </>
+  )
+}
+
+const BALL_SIZE = 56
+
+/**
+ * 根据路由推断 AI 上下文
+ */
+function inferContextFromPath(
+  pathname: string,
+  t: ReturnType<typeof useTranslations>
+): AiContextConfig {
+  // 教师批改
+  if (pathname.includes("/teacher/homework/submissions")) {
+    return {
+      systemPrompt:
+        "You are an AI grading assistant for teachers. Help with evaluating student submissions, providing feedback suggestions, and identifying common mistakes. Be concise and constructive.",
+      contextMessage: t("chat.contextMessage.teacherGrading"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.teacher.0"),
+        t("chat.suggestedPrompts.context.teacherGrading.0"),
+        t("chat.suggestedPrompts.context.teacherGrading.1"),
+      ],
+    }
+  }
+
+  // 教师备课
+  if (pathname.includes("/teacher/lesson-plans")) {
+    return {
+      systemPrompt:
+        "You are an AI lesson planning assistant. Help teachers design lessons, create activities, generate discussion questions, and align with curriculum standards.",
+      contextMessage: t("chat.contextMessage.teacherLesson"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.teacher.1"),
+        t("chat.suggestedPrompts.context.teacherLesson.0"),
+        t("chat.suggestedPrompts.context.teacherLesson.1"),
+      ],
+    }
+  }
+
+  // 教师试卷
+  if (pathname.includes("/teacher/exams")) {
+    return {
+      systemPrompt:
+        "You are an AI exam design assistant. Help create questions, generate variants, analyze difficulty distribution, and ensure knowledge point coverage.",
+      contextMessage: t("chat.contextMessage.teacherExam"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.teacher.2"),
+        t("chat.suggestedPrompts.context.teacherExam.0"),
+        t("chat.suggestedPrompts.context.teacherExam.1"),
+      ],
+    }
+  }
+
+  // 学生错题本
+  if (pathname.includes("/student/error-book")) {
+    return {
+      systemPrompt:
+        "You are a Socratic tutor for K12 students. Guide the student to find answers themselves. Do NOT give direct answers. Use questions and hints to help them understand their mistakes.",
+      contextMessage: t("chat.contextMessage.studentErrorBook"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.student.0"),
+        t("chat.suggestedPrompts.student.1"),
+        t("chat.suggestedPrompts.student.2"),
+      ],
+    }
+  }
+
+  // 学生作业
+  if (pathname.includes("/student/homework") || pathname.includes("/student/learning")) {
+    return {
+      systemPrompt:
+        "You are a homework helper for K12 students. Use the Socratic method. Do NOT give direct answers. Guide the student through hints and questions.",
+      contextMessage: t("chat.contextMessage.studentHomework"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.student.0"),
+        t("chat.suggestedPrompts.context.studentHomework.0"),
+        t("chat.suggestedPrompts.context.studentHomework.1"),
+      ],
+    }
+  }
+
+  // 家长面板
+  if (pathname.includes("/parent")) {
+    return {
+      systemPrompt:
+        "You are a family education advisor. Help parents understand their child's learning progress, suggest home tutoring strategies, and provide educational guidance.",
+      contextMessage: t("chat.contextMessage.parent"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.parent.0"),
+        t("chat.suggestedPrompts.parent.1"),
+      ],
+    }
+  }
+
+  // 管理员面板
+  if (pathname.includes("/admin")) {
+    return {
+      systemPrompt:
+        "You are an AI education administration assistant. Help administrators monitor AI usage, analyze school-wide trends, and optimize resource allocation.",
+      contextMessage: t("chat.contextMessage.admin"),
+      suggestedPrompts: [
+        t("chat.suggestedPrompts.admin.0"),
+        t("chat.suggestedPrompts.admin.1"),
+      ],
+    }
+  }
+
+  // 默认
+  return {
+    systemPrompt: "You are a helpful AI assistant for a K12 school management system.",
+    contextMessage: "",
+    suggestedPrompts: undefined,
+  }
+}
diff --git a/src/modules/ai/components/ai-assistant-widget.tsx b/src/modules/ai/components/ai-assistant-widget.tsx
index 0b5d78d..2f0afd2 100644
--- a/src/modules/ai/components/ai-assistant-widget.tsx
+++ b/src/modules/ai/components/ai-assistant-widget.tsx
@@ -1,329 +1,26 @@
 "use client"
 
-import { useState, useMemo } from "react"
-import { usePathname } from "next/navigation"
-import { useTranslations } from "next-intl"
-import { Bot, X, Sparkles, RotateCcw, ChevronLeft } from "lucide-react"
-
-import { Button } from "@/shared/components/ui/button"
-import {
-  Sheet,
-  SheetContent,
-  SheetHeader,
-  SheetTitle,
-} from "@/shared/components/ui/sheet"
-import { AiChatPanel } from "./ai-chat-panel"
-import { useAiClientOptional } from "../context/ai-client-provider"
-import { useFloatingBall } from "../hooks/use-floating-ball"
+import dynamic from "next/dynamic"
+import { Skeleton } from "@/shared/components/ui/skeleton"
 
 /**
- * 上下文感知规则
+ * 全局 AI 助手悬浮球 —— 懒加载入口（Phase 4.7）
  *
- * 根据当前路由推断用户上下文，动态生成 systemPrompt 和 contextMessage。
+ * 通过 next/dynamic 以 ssr:false 懒加载 AiAssistantWidgetInner，
+ * 使其依赖的 AI SDK / Markdown 渲染等重型依赖被打入独立 chunk，
+ * 避免污染首屏 bundle。加载完成前展示 Skeleton 占位骨架。
  */
-type AiContextConfig = {
-  systemPrompt: string
-  contextMessage: string
-  suggestedPrompts?: string[]
-}
+const LazyAiAssistantWidgetInner = dynamic(
+  () =>
+    import("./ai-assistant-widget-inner").then(
+      (m) => m.AiAssistantWidgetInner
+    ),
+  {
+    ssr: false,
+    loading: () => <Skeleton className="h-12 w-full" />,
+  }
+)
 
-/**
- * 全局 AI 助手悬浮球（360 悬浮球风格）
- *
- * 特性：
- * - 可拖拽移动，松手吸附到最近屏幕边缘
- * - 拖到边缘自动半隐藏（只露出一小部分）
- * - 鼠标悬停时恢复显示
- * - 位置持久化到 localStorage
- * - 点击打开侧边抽屉，内嵌 AiChatPanel
- * - 上下文感知：根据当前路由自动推断用户场景
- *
- * 使用：
- * 在 dashboard layout 中引入即可全局生效。
- * 需要 AiClientProvider 包裹（可选，未注入时按钮不显示）。
- */
 export function AiAssistantWidget(): React.ReactNode {
-  const t = useTranslations("ai")
-  const pathname = usePathname()
-  const aiClient = useAiClientOptional()
-  const [open, setOpen] = useState(false)
-  const [chatKey, setChatKey] = useState(0)
-
-  const handleBallClick = () => setOpen(true)
-  const ball = useFloatingBall(handleBallClick)
-
-  // 根据路由推断上下文
-  const contextConfig = useMemo<AiContextConfig>(() => {
-    return inferContextFromPath(pathname, t)
-  }, [pathname, t])
-
-  // 如果未注入 AI 客户端服务，不显示悬浮按钮
-  if (!aiClient) {
-    return null
-  }
-
-  const { position, hidden, dragging, hovered, hiddenOffset, handlers, show, resetPosition } = ball
-
-  // 首次渲染时 position 为占位值（屏幕外），避免闪烁
-  const isReady = position.x < 9999
-
-  return (
-    <>
-      {/* 悬浮球 */}
-      {isReady ? (
-        <button
-          type="button"
-          aria-label={hidden ? t("widget.show") : t("widget.open")}
-          className="fixed z-50 flex select-none items-center justify-center rounded-full bg-gradient-to-br from-primary to-primary/80 text-primary-foreground shadow-lg transition-[width,height,opacity,transform] duration-200 ease-out hover:shadow-xl hover:scale-105 touch-none"
-          style={{
-            left: `${position.x}px`,
-            top: `${position.y}px`,
-            width: "56px",
-            height: "56px",
-            transform: `translateX(${hiddenOffset}px) ${dragging ? "scale(1.1)" : ""}`,
-            cursor: dragging ? "grabbing" : "grab",
-            opacity: hidden && !hovered ? 0.55 : 1,
-            transition: dragging ? "none" : "transform 0.25s ease-out, opacity 0.25s ease-out",
-          }}
-          onPointerDown={handlers.onPointerDown}
-          onPointerMove={handlers.onPointerMove}
-          onPointerUp={handlers.onPointerUp}
-          onPointerCancel={handlers.onPointerCancel}
-          onMouseEnter={handlers.onMouseEnter}
-          onMouseLeave={handlers.onMouseLeave}
-          onClick={(e) => {
-            // 拖动产生的 click 不触发打开
-            if (e.detail === 0) return
-          }}
-        >
-          <Bot className="h-6 w-6 drop-shadow-sm" />
-          <span className="pointer-events-none absolute -top-0.5 -right-0.5 flex h-3 w-3">
-            <span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-emerald-400 opacity-75" />
-            <span className="relative inline-flex rounded-full h-3 w-3 bg-emerald-500 ring-2 ring-background" />
-          </span>
-          {hidden ? (
-            <span className="pointer-events-none absolute inset-0 flex items-center justify-center rounded-full bg-primary/30 opacity-0 transition-opacity hover:opacity-100">
-              <ChevronLeft
-                className="h-4 w-4"
-                style={{
-                  transform: position.x <= 16 ? "rotate(0deg)" : "rotate(180deg)",
-                }}
-              />
-            </span>
-          ) : null}
-        </button>
-      ) : null}
-
-      {/* 半隐藏时的提示条 */}
-      {hidden && isReady ? (
-        <button
-          type="button"
-          aria-label={t("widget.show")}
-          className="fixed z-40 flex items-center justify-center rounded-full bg-primary/15 text-primary backdrop-blur-sm transition-opacity hover:bg-primary/25"
-          style={{
-            left: `${position.x + (hiddenOffset > 0 ? 0 : BALL_SIZE * 0.45)}px`,
-            top: `${position.y}px`,
-            width: "14px",
-            height: "56px",
-            cursor: "pointer",
-          }}
-          onClick={show}
-        >
-          <ChevronLeft
-            className="h-3 w-3"
-            style={{
-              transform: position.x <= 16 ? "rotate(0deg)" : "rotate(180deg)",
-            }}
-          />
-        </button>
-      ) : null}
-
-      {/* 侧边抽屉 */}
-      <Sheet open={open} onOpenChange={setOpen}>
-        <SheetContent hideClose className="w-full sm:max-w-lg overflow-hidden p-0 flex flex-col">
-          <SheetHeader className="px-5 py-4 border-b bg-gradient-to-r from-primary/5 to-transparent">
-            <div className="flex items-center justify-between">
-              <SheetTitle className="flex items-center gap-2.5">
-                <span className="flex h-9 w-9 items-center justify-center rounded-full bg-gradient-to-br from-primary to-primary/80 text-primary-foreground shadow-sm">
-                  <Bot className="h-5 w-5" />
-                </span>
-                <div className="flex flex-col">
-                  <span className="text-base font-semibold leading-tight">{t("widget.title")}</span>
-                  <span className="flex items-center gap-1 text-xs text-muted-foreground">
-                    <span className="inline-block h-1.5 w-1.5 rounded-full bg-emerald-500" />
-                    {t("widget.online")}
-                  </span>
-                </div>
-              </SheetTitle>
-              <div className="flex items-center gap-1">
-                <Button
-                  type="button"
-                  variant="ghost"
-                  size="sm"
-                  className="h-8 w-8 p-0 text-muted-foreground"
-                  onClick={() => {
-                    try {
-                      localStorage.removeItem("ai-chat-history")
-                    } catch {
-                      // ignore
-                    }
-                    setChatKey((k) => k + 1)
-                  }}
-                  aria-label={t("widget.newChat")}
-                  title={t("widget.newChat")}
-                >
-                  <Sparkles className="h-4 w-4" />
-                </Button>
-                <Button
-                  type="button"
-                  variant="ghost"
-                  size="sm"
-                  className="h-8 w-8 p-0 text-muted-foreground"
-                  onClick={resetPosition}
-                  aria-label={t("widget.resetPosition")}
-                  title={t("widget.resetPosition")}
-                >
-                  <RotateCcw className="h-4 w-4" />
-                </Button>
-                <Button
-                  type="button"
-                  variant="ghost"
-                  size="sm"
-                  className="h-8 w-8 p-0 text-muted-foreground"
-                  onClick={() => setOpen(false)}
-                  aria-label={t("widget.close")}
-                  title={t("widget.close")}
-                >
-                  <X className="h-4 w-4" />
-                </Button>
-              </div>
-            </div>
-          </SheetHeader>
-          <div className="flex-1 overflow-y-auto">
-            <AiChatPanel
-              key={chatKey}
-              systemPrompt={contextConfig.systemPrompt}
-              contextMessage={contextConfig.contextMessage}
-              suggestedPrompts={contextConfig.suggestedPrompts}
-              maxMessages={30}
-              variant="widget"
-            />
-          </div>
-        </SheetContent>
-      </Sheet>
-    </>
-  )
-}
-
-const BALL_SIZE = 56
-
-/**
- * 根据路由推断 AI 上下文
- */
-function inferContextFromPath(
-  pathname: string,
-  t: ReturnType<typeof useTranslations>
-): AiContextConfig {
-  // 教师批改
-  if (pathname.includes("/teacher/homework/submissions")) {
-    return {
-      systemPrompt:
-        "You are an AI grading assistant for teachers. Help with evaluating student submissions, providing feedback suggestions, and identifying common mistakes. Be concise and constructive.",
-      contextMessage: t("chat.contextMessage.teacherGrading"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.teacher.0"),
-        t("chat.suggestedPrompts.context.teacherGrading.0"),
-        t("chat.suggestedPrompts.context.teacherGrading.1"),
-      ],
-    }
-  }
-
-  // 教师备课
-  if (pathname.includes("/teacher/lesson-plans")) {
-    return {
-      systemPrompt:
-        "You are an AI lesson planning assistant. Help teachers design lessons, create activities, generate discussion questions, and align with curriculum standards.",
-      contextMessage: t("chat.contextMessage.teacherLesson"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.teacher.1"),
-        t("chat.suggestedPrompts.context.teacherLesson.0"),
-        t("chat.suggestedPrompts.context.teacherLesson.1"),
-      ],
-    }
-  }
-
-  // 教师试卷
-  if (pathname.includes("/teacher/exams")) {
-    return {
-      systemPrompt:
-        "You are an AI exam design assistant. Help create questions, generate variants, analyze difficulty distribution, and ensure knowledge point coverage.",
-      contextMessage: t("chat.contextMessage.teacherExam"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.teacher.2"),
-        t("chat.suggestedPrompts.context.teacherExam.0"),
-        t("chat.suggestedPrompts.context.teacherExam.1"),
-      ],
-    }
-  }
-
-  // 学生错题本
-  if (pathname.includes("/student/error-book")) {
-    return {
-      systemPrompt:
-        "You are a Socratic tutor for K12 students. Guide the student to find answers themselves. Do NOT give direct answers. Use questions and hints to help them understand their mistakes.",
-      contextMessage: t("chat.contextMessage.studentErrorBook"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.student.0"),
-        t("chat.suggestedPrompts.student.1"),
-        t("chat.suggestedPrompts.student.2"),
-      ],
-    }
-  }
-
-  // 学生作业
-  if (pathname.includes("/student/homework") || pathname.includes("/student/learning")) {
-    return {
-      systemPrompt:
-        "You are a homework helper for K12 students. Use the Socratic method. Do NOT give direct answers. Guide the student through hints and questions.",
-      contextMessage: t("chat.contextMessage.studentHomework"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.student.0"),
-        t("chat.suggestedPrompts.context.studentHomework.0"),
-        t("chat.suggestedPrompts.context.studentHomework.1"),
-      ],
-    }
-  }
-
-  // 家长面板
-  if (pathname.includes("/parent")) {
-    return {
-      systemPrompt:
-        "You are a family education advisor. Help parents understand their child's learning progress, suggest home tutoring strategies, and provide educational guidance.",
-      contextMessage: t("chat.contextMessage.parent"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.parent.0"),
-        t("chat.suggestedPrompts.parent.1"),
-      ],
-    }
-  }
-
-  // 管理员面板
-  if (pathname.includes("/admin")) {
-    return {
-      systemPrompt:
-        "You are an AI education administration assistant. Help administrators monitor AI usage, analyze school-wide trends, and optimize resource allocation.",
-      contextMessage: t("chat.contextMessage.admin"),
-      suggestedPrompts: [
-        t("chat.suggestedPrompts.admin.0"),
-        t("chat.suggestedPrompts.admin.1"),
-      ],
-    }
-  }
-
-  // 默认
-  return {
-    systemPrompt: "You are a helpful AI assistant for a K12 school management system.",
-    contextMessage: "",
-    suggestedPrompts: undefined,
-  }
+  return <LazyAiAssistantWidgetInner />
 }
diff --git a/src/modules/ai/components/ai-chart-renderer.tsx b/src/modules/ai/components/ai-chart-renderer.tsx
index 6c49cdc..c1fa55e 100644
--- a/src/modules/ai/components/ai-chart-renderer.tsx
+++ b/src/modules/ai/components/ai-chart-renderer.tsx
@@ -30,6 +30,49 @@ import {
 import { cn } from "@/shared/lib/utils"
 import { AiChartSpecSchema } from "../schema"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const CHART_MARGIN = { left: 8, right: 8, top: 8, bottom: 8 }
+const CARTESIAN_GRID_PROPS = {
+  vertical: false,
+  strokeDasharray: "4 4",
+  strokeOpacity: 0.4,
+} as const
+const POLAR_GRID_PROPS = { strokeOpacity: 0.4 } as const
+const BAR_X_AXIS_PROPS = {
+  tickLine: false,
+  axisLine: false,
+  tickMargin: 8,
+} as const
+const BAR_Y_AXIS_PROPS = {
+  allowDecimals: true,
+  tickLine: false,
+  axisLine: false,
+  width: 36,
+} as const
+const LINE_Y_AXIS_PROPS = {
+  tickLine: false,
+  axisLine: false,
+  width: 36,
+} as const
+const LINE_TOOLTIP_CURSOR = {
+  stroke: "hsl(var(--muted-foreground))",
+  strokeWidth: 1,
+  strokeDasharray: "4 4",
+} as const
+const LINE_ACTIVE_DOT = { r: 5, strokeWidth: 0 } as const
+const POLAR_ANGLE_TICK = { fontSize: 12 } as const
+const POLAR_RADIUS_TICK = { fontSize: 10 } as const
+const BAR_RADIUS_TOP: [number, number, number, number] = [4, 4, 0, 0]
+const DEFAULT_Y_DOMAIN: [number, number] = [0, 100]
+
+function formatPercentTick(value: number): string {
+  return `${value}%`
+}
+
+function formatPieLabel(entry: { name?: string; value?: number }): string {
+  return `${entry.name ?? ""}: ${entry.value ?? ""}`
+}
+
 /**
  * AI 图表渲染器
  *
@@ -208,15 +251,12 @@ function renderChart(
 function renderBarChart(spec: AiChartSpec, series: AiChartSeries[]): React.ReactNode {
   const xKey = spec.xKey ?? "name"
   return (
-    <BarChart data={spec.data} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-      <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
-      <XAxis dataKey={xKey} tickLine={false} axisLine={false} tickMargin={8} />
+    <BarChart data={spec.data} margin={CHART_MARGIN}>
+      <CartesianGrid {...CARTESIAN_GRID_PROPS} />
+      <XAxis dataKey={xKey} {...BAR_X_AXIS_PROPS} />
       <YAxis
         domain={spec.yDomain}
-        allowDecimals
-        tickLine={false}
-        axisLine={false}
-        width={36}
+        {...BAR_Y_AXIS_PROPS}
       />
       <ChartTooltip content={<ChartTooltipContent className="w-[200px]" />} />
       {spec.showLegend ? <Legend /> : null}
@@ -226,7 +266,7 @@ function renderBarChart(spec: AiChartSpec, series: AiChartSeries[]): React.React
           dataKey={s.dataKey}
           name={s.name}
           fill={`var(--color-${s.dataKey})`}
-          radius={[4, 4, 0, 0]}
+          radius={BAR_RADIUS_TOP}
         />
       ))}
     </BarChart>
@@ -236,22 +276,16 @@ function renderBarChart(spec: AiChartSpec, series: AiChartSeries[]): React.React
 function renderLineChart(spec: AiChartSpec, series: AiChartSeries[]): React.ReactNode {
   const xKey = spec.xKey ?? "name"
   return (
-    <LineChart data={spec.data} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-      <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
-      <XAxis dataKey={xKey} tickLine={false} axisLine={false} tickMargin={8} />
+    <LineChart data={spec.data} margin={CHART_MARGIN}>
+      <CartesianGrid {...CARTESIAN_GRID_PROPS} />
+      <XAxis dataKey={xKey} {...BAR_X_AXIS_PROPS} />
       <YAxis
-        domain={spec.yDomain ?? [0, 100]}
-        tickLine={false}
-        axisLine={false}
-        width={36}
+        domain={spec.yDomain ?? DEFAULT_Y_DOMAIN}
+        {...LINE_Y_AXIS_PROPS}
       />
       {/* arbitrary-value: chart canvas fixed size */}
       <ChartTooltip
-        cursor={{
-          stroke: "hsl(var(--muted-foreground))",
-          strokeWidth: 1,
-          strokeDasharray: "4 4",
-        }}
+        cursor={LINE_TOOLTIP_CURSOR}
         content={<ChartTooltipContent indicator="line" className="w-[220px]" />}
       />
       {spec.showLegend ? <Legend /> : null}
@@ -268,7 +302,7 @@ function renderLineChart(spec: AiChartSpec, series: AiChartSeries[]): React.Reac
             r: 3,
             strokeWidth: 2,
           }}
-          activeDot={{ r: 5, strokeWidth: 0 }}
+          activeDot={LINE_ACTIVE_DOT}
         />
       ))}
     </LineChart>
@@ -280,7 +314,7 @@ function renderPieChart(spec: AiChartSpec, series: AiChartSeries[]): React.React
   const colors = series.map((s) => s.color ?? DEFAULT_PALETTE[0])
   const dataKey = series[0]?.dataKey ?? "value"
   return (
-    <PieChart margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
+    <PieChart margin={CHART_MARGIN}>
       <ChartTooltip content={<ChartTooltipContent className="w-[200px]" />} />
       {spec.showLegend ? <Legend /> : null}
       <Pie
@@ -290,9 +324,7 @@ function renderPieChart(spec: AiChartSpec, series: AiChartSeries[]): React.React
         cx="50%"
         cy="50%"
         outerRadius="75%"
-        label={(entry: { name?: string; value?: number }) =>
-          `${entry.name ?? ""}: ${entry.value ?? ""}`
-        }
+        label={formatPieLabel}
         labelLine={false}
       >
         {spec.data.map((_, index) => (
@@ -306,13 +338,13 @@ function renderPieChart(spec: AiChartSpec, series: AiChartSeries[]): React.React
 function renderRadarChart(spec: AiChartSpec, series: AiChartSeries[]): React.ReactNode {
   const angleKey = spec.angleKey ?? spec.xKey ?? "name"
   return (
-    <RadarChart data={spec.data} outerRadius="75%" margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-      <PolarGrid strokeOpacity={0.4} />
-      <PolarAngleAxis dataKey={angleKey} tick={{ fontSize: 12 }} />
+    <RadarChart data={spec.data} outerRadius="75%" margin={CHART_MARGIN}>
+      <PolarGrid {...POLAR_GRID_PROPS} />
+      <PolarAngleAxis dataKey={angleKey} tick={POLAR_ANGLE_TICK} />
       <PolarRadiusAxis
-        domain={spec.yDomain ?? [0, 100]}
-        tickFormatter={(value: number) => `${value}%`}
-        tick={{ fontSize: 10 }}
+        domain={spec.yDomain ?? DEFAULT_Y_DOMAIN}
+        tickFormatter={formatPercentTick}
+        tick={POLAR_RADIUS_TICK}
         axisLine={false}
       />
       <ChartTooltip content={<ChartTooltipContent className="w-[220px]" />} />
diff --git a/src/modules/ai/data-access.ts b/src/modules/ai/data-access.ts
index 6920c01..4f686f7 100644
--- a/src/modules/ai/data-access.ts
+++ b/src/modules/ai/data-access.ts
@@ -1,5 +1,6 @@
 import "server-only"
 
+import { cacheFn } from "@/shared/lib/cache"
 import type { AiUsageStats } from "./types"
 
 /**
@@ -59,7 +60,7 @@ export function recordAiEvent(event: StoredAiEvent): void {
  *
  * @returns AiUsageStats — 聚合后的统计数据
  */
-export async function getAiUsageStats(): Promise<AiUsageStats> {
+export async function getAiUsageStatsRaw(): Promise<AiUsageStats> {
   const now = Date.now()
   const todayStart = new Date()
   todayStart.setHours(0, 0, 0, 0)
@@ -136,3 +137,9 @@ export async function getAiUsageStats(): Promise<AiUsageStats> {
     recentActivity,
   }
 }
+
+export const getAiUsageStats = cacheFn(getAiUsageStatsRaw, {
+  tags: ["ai"],
+  ttl: 60,
+  keyParts: ["ai", "usage-stats"],
+})
diff --git a/src/modules/attendance/components/attendance-grade-correlation-card.tsx b/src/modules/attendance/components/attendance-grade-correlation-card.tsx
index c74a412..6f1c777 100644
--- a/src/modules/attendance/components/attendance-grade-correlation-card.tsx
+++ b/src/modules/attendance/components/attendance-grade-correlation-card.tsx
@@ -1,6 +1,6 @@
 "use client"
 
-import { useMemo } from "react"
+import { useCallback, useMemo } from "react"
 import { useTranslations } from "next-intl"
 import {
   CartesianGrid,
@@ -37,6 +37,14 @@ import type {
   AttendanceGradeRiskLevel,
 } from "../types"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const SCATTER_MARGIN = { top: 16, right: 16, bottom: 32, left: 16 }
+const SCATTER_GRID_PROPS = { strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const TOOLTIP_CURSOR = { strokeDasharray: "3 3" }
+const Z_AXIS_RANGE: [number, number] = [60, 60]
+const AXIS_LABEL_STYLE = { fontSize: 12, fill: "hsl(var(--muted-foreground))" }
+const SCATTER_DOMAIN: [number, number] = [0, 100]
+
 /** 风险等级对应的颜色（散点图着色，与 attendance-sheet 调色板对齐）。 */
 const RISK_COLORS: Record<AttendanceGradeRiskLevel, string> = {
   high: "hsl(var(--chart-1))", // red-500
@@ -103,6 +111,36 @@ export function AttendanceGradeCorrelationCard({
     }))
   }, [summary])
 
+  const renderTooltip = useCallback(
+    (
+      _value: unknown,
+      _name: unknown,
+      item: { payload?: unknown }
+    ) => {
+      // 从 unknown 转换：recharts payload 类型未知，需类型守卫
+      const data = item?.payload as (typeof scatterData)[number] | undefined
+      if (!data) return null
+      return (
+        <div className="space-y-1">
+          <div className="font-medium">{data.studentName}</div>
+          <div className="text-xs text-muted-foreground">
+            {t("correlation.attendanceRate")}:{" "}
+            {data.attendanceRate}%
+          </div>
+          <div className="text-xs text-muted-foreground">
+            {t("correlation.averageScore")}:{" "}
+            {data.averageScore}
+          </div>
+          <div className="text-xs text-muted-foreground">
+            {t("correlation.absentCount")}:{" "}
+            {data.absentCount}
+          </div>
+        </div>
+      )
+    },
+    [t]
+  )
+
   if (!summary) {
     return (
       <Card>
@@ -181,17 +219,14 @@ export function AttendanceGradeCorrelationCard({
               className="h-[320px] w-full"
             >
               <ScatterChart
-                margin={{ top: 16, right: 16, bottom: 32, left: 16 }}
+                margin={SCATTER_MARGIN}
               >
-                <CartesianGrid
-                  strokeDasharray="4 4"
-                  strokeOpacity={0.4}
-                />
+                <CartesianGrid {...SCATTER_GRID_PROPS} />
                 <XAxis
                   type="number"
                   dataKey="attendanceRate"
                   name={t("correlation.attendanceRate")}
-                  domain={[0, 100]}
+                  domain={SCATTER_DOMAIN}
                   tickLine={false}
                   axisLine={false}
                   tickMargin={8}
@@ -199,52 +234,26 @@ export function AttendanceGradeCorrelationCard({
                     value: t("correlation.attendanceRate"),
                     position: "bottom",
                     offset: 16,
-                    style: { fontSize: 12, fill: "hsl(var(--muted-foreground))" },
+                    style: AXIS_LABEL_STYLE,
                   }}
                 />
                 <YAxis
                   type="number"
                   dataKey="averageScore"
                   name={t("correlation.averageScore")}
-                  domain={[0, 100]}
+                  domain={SCATTER_DOMAIN}
                   tickLine={false}
                   axisLine={false}
                   width={40}
                 />
-                <ZAxis type="number" range={[60, 60]} />
+                <ZAxis type="number" range={Z_AXIS_RANGE} />
                 <ChartTooltip
-                  cursor={{ strokeDasharray: "3 3" }}
+                  cursor={TOOLTIP_CURSOR}
                   content={
                     <ChartTooltipContent
                       indicator="dot"
                       hideLabel
-                      formatter={(
-                        _value: unknown,
-                        _name: unknown,
-                        item: { payload?: unknown }
-                      ) => {
-                        const data = item?.payload as
-                          | (typeof scatterData)[number]
-                          | undefined
-                        if (!data) return null
-                        return (
-                          <div className="space-y-1">
-                            <div className="font-medium">{data.studentName}</div>
-                            <div className="text-xs text-muted-foreground">
-                              {t("correlation.attendanceRate")}:{" "}
-                              {data.attendanceRate}%
-                            </div>
-                            <div className="text-xs text-muted-foreground">
-                              {t("correlation.averageScore")}:{" "}
-                              {data.averageScore}
-                            </div>
-                            <div className="text-xs text-muted-foreground">
-                              {t("correlation.absentCount")}:{" "}
-                              {data.absentCount}
-                            </div>
-                          </div>
-                        )
-                      }}
+                      formatter={renderTooltip}
                     />
                   }
                 />
diff --git a/src/modules/attendance/components/attendance-sheet.tsx b/src/modules/attendance/components/attendance-sheet.tsx
index cb46fdc..52625b7 100644
--- a/src/modules/attendance/components/attendance-sheet.tsx
+++ b/src/modules/attendance/components/attendance-sheet.tsx
@@ -1,6 +1,6 @@
 "use client"
 
-import { useState, useRef, useEffect, useCallback, useMemo } from "react"
+import { useState, useRef, useEffect, useCallback, useMemo, useOptimistic } from "react"
 import { useFormStatus } from "react-dom"
 import { toast } from "sonner"
 import { useRouter } from "next/navigation"
@@ -120,7 +120,12 @@ export function AttendanceSheet({
   const [reasons, setReasons] = useState<Record<string, string>>({})
   const [searchQuery, setSearchQuery] = useState("")
   const [focusedStudentIndex, setFocusedStudentIndex] = useState(0)
-  const [isSubmitting, setIsSubmitting] = useState(false)
+  // Phase 4.5: 提交状态改用 useOptimistic,在 form action 内自动管理乐观状态与回滚
+  // (action 完成后 optimisticSubmitting 自动恢复为 false,无需手动 setIsSubmitting(false))
+  const [optimisticSubmitting, setOptimisticSubmitting] = useOptimistic(
+    false,
+    (_current, next: boolean) => next,
+  )
   const [showSwitchConfirm, setShowSwitchConfirm] = useState(false)
   const [pendingClassId, setPendingClassId] = useState<string | null>(null)
   const studentRefs = useRef<(HTMLTableRowElement | null)[]>([])
@@ -257,7 +262,8 @@ export function AttendanceSheet({
       return
     }
 
-    setIsSubmitting(true)
+    // Phase 4.5: setOptimisticSubmitting 在 form action 内调用,action 完成后自动回滚
+    setOptimisticSubmitting(true)
     formData.set("recordsJson", JSON.stringify(records))
 
     try {
@@ -271,14 +277,12 @@ export function AttendanceSheet({
       }
     } catch {
       toast.error(t("errors.unexpected"))
-    } finally {
-      setIsSubmitting(false)
     }
   }
 
   return (
     <Card className="relative">
-      {isSubmitting && (
+      {optimisticSubmitting && (
         <div className="absolute inset-0 z-10 flex items-center justify-center rounded-lg bg-background/60 backdrop-blur-sm">
           <div className="flex items-center gap-2 text-sm font-medium">
             <div className="h-4 w-4 animate-spin rounded-full border-2 border-primary border-t-transparent" />
diff --git a/src/modules/attendance/data-access-correlation.ts b/src/modules/attendance/data-access-correlation.ts
index 59535b8..ad1a63c 100644
--- a/src/modules/attendance/data-access-correlation.ts
+++ b/src/modules/attendance/data-access-correlation.ts
@@ -11,6 +11,7 @@ import {
 import { getGradeRecords } from "@/modules/grades/data-access"
 import { safeParseDate } from "@/shared/lib/action-utils"
 import type { DataScope } from "@/shared/types/permissions"
+import { cacheFn } from "@/shared/lib/cache"
 
 import { computeCorrelationSummary } from "./correlation-compute"
 import type { AttendanceGradeCorrelationSummary } from "./types"
@@ -42,7 +43,7 @@ const DEFAULT_RANGE_DAYS = 90
  * @param scope 数据范围（用于权限校验）
  * @returns 关联分析汇总；班级不存在或无学生返回 null
  */
-export async function getAttendanceGradeCorrelation(
+export async function getAttendanceGradeCorrelationRaw(
   classId: string,
   startDate?: string,
   endDate?: string,
@@ -120,10 +121,11 @@ export async function getAttendanceGradeCorrelation(
   // Step 3: 委托 grades data-access 获取该班级所有成绩记录（按时间范围筛选 createdAt）
   // 注意：getGradeRecords 不直接支持 createdAt 范围筛选，因此这里传入 classId + scope
   // 后续在内存中按 createdAt 过滤时间范围（成绩数据量通常较小，可接受）
+  // P3-8: LIMIT 从 5000 调低至 100，避免单次查询拉取过多记录导致 DB 压力
   const gradeResult = await getGradeRecords({
     classId,
     scope: scope ?? { type: "all" },
-    limit: 5000,
+    limit: 100,
   })
 
   // 内存中按时间范围过滤成绩记录（按 createdAt）
@@ -190,6 +192,12 @@ export async function getAttendanceGradeCorrelation(
   )
 }
 
+export const getAttendanceGradeCorrelation = cacheFn(getAttendanceGradeCorrelationRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "correlation", "grade"],
+})
+
 /**
  * Scope 辅助：检查 scope 是否允许访问班级级关联分析。
  * 仅 all / class_taught（含该班级）/ grade_managed 允许；其余返回 false。
diff --git a/src/modules/attendance/data-access-stats.ts b/src/modules/attendance/data-access-stats.ts
index d0e913c..e24e3e9 100644
--- a/src/modules/attendance/data-access-stats.ts
+++ b/src/modules/attendance/data-access-stats.ts
@@ -8,6 +8,7 @@ import { getClassNameById, getClassNamesByIds, getClassesByGradeId } from "@/mod
 import { getUserNamesByIds } from "@/modules/users/data-access"
 import { getGradeNameById } from "@/modules/school/data-access"
 import { safeParseDate } from "@/shared/lib/action-utils"
+import { cacheFn } from "@/shared/lib/cache"
 
 import { getAttendanceRules } from "./data-access"
 import {
@@ -100,7 +101,7 @@ const serializeDate = (d: Date | string | null): string =>
  * 获取学生考勤汇总。
  * 优化：统计使用 SQL 聚合查询（避免拉全量记录），最近记录使用 LIMIT 分页。
  */
-export async function getStudentAttendanceSummary(
+export async function getStudentAttendanceSummaryRaw(
   studentId: string,
   startDate?: string,
   endDate?: string,
@@ -181,7 +182,13 @@ export async function getStudentAttendanceSummary(
   }
 }
 
-export async function getClassAttendanceStats(
+export const getStudentAttendanceSummary = cacheFn(getStudentAttendanceSummaryRaw, {
+  tags: ["attendance:students"],
+  ttl: 60,
+  keyParts: ["attendance", "students", "summary"],
+})
+
+export async function getClassAttendanceStatsRaw(
   classId: string,
   startDate?: string,
   endDate?: string
@@ -259,11 +266,17 @@ export async function getClassAttendanceStats(
   }
 }
 
+export const getClassAttendanceStats = cacheFn(getClassAttendanceStatsRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "stats", "by-class"],
+})
+
 /**
  * L-3：获取班级所有学生的出勤率预警汇总。
  * 按学生聚合统计 + 连续缺勤段，调用纯函数 computeAttendanceWarnings 计算预警。
  */
-export async function getClassAttendanceWarnings(
+export async function getClassAttendanceWarningsRaw(
   classId: string,
   startDate?: string,
   endDate?: string
@@ -337,11 +350,17 @@ export async function getClassAttendanceWarnings(
   }
 }
 
+export const getClassAttendanceWarnings = cacheFn(getClassAttendanceWarningsRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "warnings", "by-class"],
+})
+
 /**
  * L-4：获取班级考勤趋势（按日/周/月聚合）。
  * 使用纯函数 computeTrendPoints 计算趋势点，便于测试。
  */
-export async function getAttendanceTrend(
+export async function getAttendanceTrendRaw(
   classId: string,
   granularity: TrendGranularity,
   startDate?: string,
@@ -381,11 +400,17 @@ export async function getAttendanceTrend(
   }
 }
 
+export const getAttendanceTrend = cacheFn(getAttendanceTrendRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "trend"],
+})
+
 /**
  * L-7：获取同年级所有班级的出勤率对比。
  * 通过 SQL 聚合按 classId 分组统计，避免拉全量记录。
  */
-export async function getClassComparison(
+export async function getClassComparisonRaw(
   gradeId: string,
   startDate?: string,
   endDate?: string
@@ -464,3 +489,9 @@ export async function getClassComparison(
     averagePresentRate,
   }
 }
+
+export const getClassComparison = cacheFn(getClassComparisonRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "comparison", "by-grade"],
+})
diff --git a/src/modules/attendance/data-access.ts b/src/modules/attendance/data-access.ts
index f6a3607..1b89056 100644
--- a/src/modules/attendance/data-access.ts
+++ b/src/modules/attendance/data-access.ts
@@ -11,6 +11,7 @@ import {
 import { getClassActiveStudentsWithInfo, getClassNamesByIds } from "@/modules/classes/data-access"
 import { getUserNamesByIds } from "@/modules/users/data-access"
 import { safeParseDate } from "@/shared/lib/action-utils"
+import { cacheFn } from "@/shared/lib/cache"
 import type { DataScope } from "@/shared/types/permissions"
 
 import type {
@@ -100,7 +101,7 @@ const resolveRecorderNames = async (
   return result
 }
 
-export async function getAttendanceRecords(
+export async function getAttendanceRecordsRaw(
   params: AttendanceQueryParams & { scope: DataScope; currentUserId?: string }
 ): Promise<PaginatedAttendanceResult> {
   const page = Math.max(1, params.page ?? 1)
@@ -164,7 +165,13 @@ export async function getAttendanceRecords(
   }
 }
 
-export async function getClassAttendanceForDate(
+export const getAttendanceRecords = cacheFn(getAttendanceRecordsRaw, {
+  tags: ["attendance:students"],
+  ttl: 60,
+  keyParts: ["attendance", "students", "records"],
+})
+
+export async function getClassAttendanceForDateRaw(
   classId: string,
   date: string,
   /** L-6：按节次过滤，未传则返回当日所有节次记录 */
@@ -203,6 +210,12 @@ export async function getClassAttendanceForDate(
   )
 }
 
+export const getClassAttendanceForDate = cacheFn(getClassAttendanceForDateRaw, {
+  tags: ["attendance:students"],
+  ttl: 60,
+  keyParts: ["attendance", "students", "by-date"],
+})
+
 export async function createAttendanceRecord(
   data: RecordAttendanceInput,
   recordedBy: string
@@ -277,14 +290,20 @@ export async function getAttendanceRecordClassId(id: string): Promise<string | n
   return row?.classId ?? null
 }
 
-export async function getClassStudentsForAttendance(
+export async function getClassStudentsForAttendanceRaw(
   classId: string
 ): Promise<Array<{ id: string; name: string; email: string }>> {
   // 通过 classes data-access 获取班级学生，避免跨模块直查 classEnrollments 表
   return getClassActiveStudentsWithInfo(classId)
 }
 
-export async function getAttendanceRules(classId?: string): Promise<AttendanceRule[]> {
+export const getClassStudentsForAttendance = cacheFn(getClassStudentsForAttendanceRaw, {
+  tags: ["attendance:students"],
+  ttl: 60,
+  keyParts: ["attendance", "students", "for-attendance"],
+})
+
+export async function getAttendanceRulesRaw(classId?: string): Promise<AttendanceRule[]> {
   const conditions: SQL[] = []
   if (classId) {
     const classCondition = or(eq(attendanceRules.classId, classId), sql`${attendanceRules.classId} IS NULL`)
@@ -309,6 +328,12 @@ export async function getAttendanceRules(classId?: string): Promise<AttendanceRu
   }))
 }
 
+export const getAttendanceRules = cacheFn(getAttendanceRulesRaw, {
+  tags: ["attendance"],
+  ttl: 300,
+  keyParts: ["attendance", "rules"],
+})
+
 export async function upsertAttendanceRules(data: AttendanceRuleInput): Promise<string> {
   const [existing] = await db
     .select()
@@ -348,7 +373,7 @@ export async function upsertAttendanceRules(data: AttendanceRuleInput): Promise<
  * 获取考勤总览统计。
  * 返回统一的 `AttendanceStats` 类型（P2-5 修复：消除数据结构分裂）。
  */
-export async function getAttendanceStats(params: {
+export async function getAttendanceStatsRaw(params: {
   scope: DataScope
   currentUserId: string
   classId?: string
@@ -400,6 +425,11 @@ export async function getAttendanceStats(params: {
     lateRate: total > 0 ? Math.round((late / total) * 10000) / 100 : 0,
   }
 }
+export const getAttendanceStats = cacheFn(getAttendanceStatsRaw, {
+  tags: ["attendance"],
+  ttl: 60,
+  keyParts: ["attendance", "stats"],
+})
 
 /**
  * L-5：将请假申请同步为考勤记录（status='excused'）。
diff --git a/src/modules/audit/data-access.ts b/src/modules/audit/data-access.ts
index 5e8370f..bd6bc96 100644
--- a/src/modules/audit/data-access.ts
+++ b/src/modules/audit/data-access.ts
@@ -3,6 +3,7 @@ import "server-only"
 import { and, asc, desc, eq, gte, lte, count, like, type SQL, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
+import { cacheFn } from "@/shared/lib/cache"
 import { auditLogs, loginLogs, dataChangeLogs } from "@/shared/db/schema"
 import type {
   AuditLog,
@@ -33,7 +34,7 @@ const clampPage = (page?: number): number => {
   return page
 }
 
-export async function getAuditLogs(
+export async function getAuditLogsRaw(
   params?: AuditLogQueryParams
 ): Promise<PaginatedResult<AuditLog>> {
   const page = clampPage(params?.page)
@@ -89,7 +90,13 @@ export async function getAuditLogs(
   }
 }
 
-export async function getLoginLogs(
+export const getAuditLogs = cacheFn(getAuditLogsRaw, {
+  tags: ["audit"],
+  ttl: 300,
+  keyParts: ["audit", "logs"],
+})
+
+export async function getLoginLogsRaw(
   params?: LoginLogQueryParams
 ): Promise<PaginatedResult<LoginLog>> {
   const page = clampPage(params?.page)
@@ -141,7 +148,13 @@ export async function getLoginLogs(
   }
 }
 
-export async function getAuditModuleOptions(): Promise<string[]> {
+export const getLoginLogs = cacheFn(getLoginLogsRaw, {
+  tags: ["audit"],
+  ttl: 300,
+  keyParts: ["audit", "login-logs"],
+})
+
+export async function getAuditModuleOptionsRaw(): Promise<string[]> {
   try {
     const rows = await db
       .selectDistinct({ module: auditLogs.module })
@@ -154,7 +167,13 @@ export async function getAuditModuleOptions(): Promise<string[]> {
   }
 }
 
-export async function getDataChangeLogs(
+export const getAuditModuleOptions = cacheFn(getAuditModuleOptionsRaw, {
+  tags: ["audit"],
+  ttl: 300,
+  keyParts: ["audit", "module-options"],
+})
+
+export async function getDataChangeLogsRaw(
   params?: DataChangeLogQueryParams
 ): Promise<PaginatedResult<DataChangeLog>> {
   const page = clampPage(params?.page)
@@ -208,7 +227,13 @@ export async function getDataChangeLogs(
   }
 }
 
-export async function getDataChangeStats(): Promise<DataChangeStat[]> {
+export const getDataChangeLogs = cacheFn(getDataChangeLogsRaw, {
+  tags: ["audit"],
+  ttl: 300,
+  keyParts: ["audit", "data-change-logs"],
+})
+
+export async function getDataChangeStatsRaw(): Promise<DataChangeStat[]> {
   try {
     const rows = await db
       .select({
@@ -225,7 +250,13 @@ export async function getDataChangeStats(): Promise<DataChangeStat[]> {
   }
 }
 
-export async function getDataChangeTableOptions(): Promise<string[]> {
+export const getDataChangeStats = cacheFn(getDataChangeStatsRaw, {
+  tags: ["audit"],
+  ttl: 60,
+  keyParts: ["audit", "data-change-stats"],
+})
+
+export async function getDataChangeTableOptionsRaw(): Promise<string[]> {
   try {
     const rows = await db
       .selectDistinct({ tableName: dataChangeLogs.tableName })
@@ -241,6 +272,12 @@ export async function getDataChangeTableOptions(): Promise<string[]> {
 /**
  * Export-ready: fetch all audit logs matching params (no pagination cap).
  */
+export const getDataChangeTableOptions = cacheFn(getDataChangeTableOptionsRaw, {
+  tags: ["audit"],
+  ttl: 300,
+  keyParts: ["audit", "table-options"],
+})
+
 export async function getAuditLogsForExport(
   params?: AuditLogQueryParams
 ): Promise<AuditLog[]> {
@@ -317,7 +354,7 @@ function formatDateKey(d: Date): string {
 /**
  * 获取审计概览统计（今日数据 + 总数）
  */
-export async function getAuditOverviewStats(): Promise<AuditOverviewStats> {
+export async function getAuditOverviewStatsRaw(): Promise<AuditOverviewStats> {
   const todayStart = startOfToday()
   try {
     const [auditToday, failedLoginToday, dataChangeToday, totalAudit] = await Promise.all([
@@ -350,7 +387,13 @@ export async function getAuditOverviewStats(): Promise<AuditOverviewStats> {
  *
  * 使用 MySQL `DATE()` 分组聚合，避免 N 次查询。
  */
-export async function getAuditTrend(days: number = 7): Promise<AuditTrendPoint[]> {
+export const getAuditOverviewStats = cacheFn(getAuditOverviewStatsRaw, {
+  tags: ["audit"],
+  ttl: 60,
+  keyParts: ["audit", "overview-stats"],
+})
+
+export async function getAuditTrendRaw(days: number = 7): Promise<AuditTrendPoint[]> {
   const startDate = startOfDaysAgo(days)
   try {
     const [auditRows, loginRows, dataChangeRows] = await Promise.all([
@@ -407,7 +450,13 @@ export async function getAuditTrend(days: number = 7): Promise<AuditTrendPoint[]
 /**
  * 获取数据变更按动作统计（create/update/delete）
  */
-export async function getDataChangeActionStats(): Promise<DataChangeActionStat[]> {
+export const getAuditTrend = cacheFn(getAuditTrendRaw, {
+  tags: ["audit"],
+  ttl: 60,
+  keyParts: ["audit", "trend"],
+})
+
+export async function getDataChangeActionStatsRaw(): Promise<DataChangeActionStat[]> {
   try {
     const rows = await db
       .select({
@@ -422,3 +471,9 @@ export async function getDataChangeActionStats(): Promise<DataChangeActionStat[]
     throw error
   }
 }
+
+export const getDataChangeActionStats = cacheFn(getDataChangeActionStatsRaw, {
+  tags: ["audit"],
+  ttl: 60,
+  keyParts: ["audit", "action-stats"],
+})
\ No newline at end of file
diff --git a/src/modules/classes/components/class-detail/class-trends-widget.tsx b/src/modules/classes/components/class-detail/class-trends-widget.tsx
index a4f05e8..33247bd 100644
--- a/src/modules/classes/components/class-detail/class-trends-widget.tsx
+++ b/src/modules/classes/components/class-detail/class-trends-widget.tsx
@@ -16,6 +16,47 @@ import {
   DropdownMenuTrigger,
 } from "@/shared/components/ui/dropdown-menu"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const SPARK_MARGIN = { top: 5, right: 0, bottom: 0, left: 0 }
+const COMPACT_LINE_MARGIN = { top: 5, right: 5, bottom: 0, left: 0 }
+const FULL_LINE_MARGIN = { top: 20, right: 20, bottom: 0, left: 0 }
+const GRID_PROPS = { vertical: false, strokeDasharray: "3 3" }
+const GRID_PROPS_NO_HORIZONTAL = { vertical: false, strokeDasharray: "3 3", horizontal: false }
+const ACTIVE_DOT_R6 = { r: 6 }
+const ACTIVE_DOT_R4 = { r: 4 }
+const COMPACT_X_AXIS_PROPS = {
+  dataKey: "title",
+  tickLine: false,
+  tickMargin: 10,
+  axisLine: false,
+  fontSize: 10,
+  hide: true,
+}
+const COMPACT_Y_AXIS_PROPS = {
+  tickLine: false,
+  axisLine: false,
+  fontSize: 10,
+  hide: true,
+}
+const SPARK_X_AXIS_PROPS = { dataKey: "title", hide: true }
+const SPARK_Y_AXIS_PROPS = { hide: true }
+const FULL_X_AXIS_PROPS = {
+  dataKey: "title",
+  tickLine: false,
+  tickMargin: 10,
+  axisLine: false,
+  fontSize: 12,
+}
+const SCORE_Y_DOMAIN: [number, number] = [0, 100]
+
+function formatValueTick(value: number): string {
+  return `${value}`
+}
+
+function formatPercentTick(value: number): string {
+  return `${value}%`
+}
+
 interface AssignmentSummary {
   id: string
   title: string
@@ -69,39 +110,29 @@ export function ClassSubmissionTrendChart({
   } satisfies ChartConfig
   return (
     <ChartContainer config={chartConfig} className={className}>
-      <LineChart accessibilityLayer data={data} margin={{ top: 5, right: 5, bottom: 0, left: 0 }}>
-        <CartesianGrid vertical={false} strokeDasharray="3 3" />
-        <XAxis
-          dataKey="title"
-          tickLine={false}
-          tickMargin={10}
-          axisLine={false}
-          fontSize={10}
-          hide
-        />
+      <LineChart accessibilityLayer data={data} margin={COMPACT_LINE_MARGIN}>
+        <CartesianGrid {...GRID_PROPS} />
+        <XAxis {...COMPACT_X_AXIS_PROPS} />
         <YAxis
-          tickLine={false}
-          axisLine={false}
-          fontSize={10}
+          {...COMPACT_Y_AXIS_PROPS}
           domain={[0, 'auto']}
-          tickFormatter={(value) => `${value}`}
-          hide
+          tickFormatter={formatValueTick}
         />
         <ChartTooltip content={<ChartTooltipContent />} />
-        <Line 
-          type="monotone" 
-          dataKey="target" 
-          stroke="var(--color-target)" 
-          strokeWidth={2} 
+        <Line
+          type="monotone"
+          dataKey="target"
+          stroke="var(--color-target)"
+          strokeWidth={2}
           strokeDasharray="4 4"
           dot={false}
         />
-        <Line 
-          type="monotone" 
-          dataKey="submitted" 
-          stroke="var(--color-submitted)" 
-          strokeWidth={2} 
-          activeDot={{ r: 6 }} 
+        <Line
+          type="monotone"
+          dataKey="submitted"
+          stroke="var(--color-submitted)"
+          strokeWidth={2}
+          activeDot={ACTIVE_DOT_R6}
         />
       </LineChart>
     </ChartContainer>
@@ -202,19 +233,19 @@ export function ClassTrendsWidget({ assignments, compact, className }: ClassTren
         <div className="flex-1 w-full min-h-0">
            <ChartContainer config={chartConfig} className="h-full w-full">
              {chartTab === "submission" ? (
-               <AreaChart accessibilityLayer data={chartData} margin={{ top: 5, right: 0, bottom: 0, left: 0 }}>
+               <AreaChart accessibilityLayer data={chartData} margin={SPARK_MARGIN}>
                  <defs>
                    <linearGradient id="fillSubmitted" x1="0" y1="0" x2="0" y2="1">
                      <stop offset="5%" stopColor="var(--color-submitted)" stopOpacity={0.3}/>
                      <stop offset="95%" stopColor="var(--color-submitted)" stopOpacity={0.05}/>
                    </linearGradient>
                  </defs>
-                 <CartesianGrid vertical={false} strokeDasharray="3 3" horizontal={false} />
-                 <XAxis dataKey="title" hide />
-                 <YAxis hide domain={[0, 'auto']} />
-                 <ChartTooltip 
-                   cursor={false} 
-                   content={<ChartTooltipContent indicator="dot" hideLabel />} 
+                 <CartesianGrid {...GRID_PROPS_NO_HORIZONTAL} />
+                 <XAxis {...SPARK_X_AXIS_PROPS} />
+                 <YAxis {...SPARK_Y_AXIS_PROPS} domain={[0, 'auto']} />
+                 <ChartTooltip
+                   cursor={false}
+                   content={<ChartTooltipContent indicator="dot" hideLabel />}
                  />
                  <Area
                    type="monotone"
@@ -234,30 +265,30 @@ export function ClassTrendsWidget({ assignments, compact, className }: ClassTren
                  />
                </AreaChart>
              ) : (
-               <LineChart accessibilityLayer data={chartData} margin={{ top: 5, right: 0, bottom: 0, left: 0 }}>
-                 <CartesianGrid vertical={false} strokeDasharray="3 3" horizontal={false} />
-                 <XAxis dataKey="title" hide />
-                 <YAxis hide domain={[0, 100]} />
-                 <ChartTooltip 
-                   cursor={false} 
-                   content={<ChartTooltipContent indicator="dot" />} 
+               <LineChart accessibilityLayer data={chartData} margin={SPARK_MARGIN}>
+                 <CartesianGrid {...GRID_PROPS_NO_HORIZONTAL} />
+                 <XAxis {...SPARK_X_AXIS_PROPS} />
+                 <YAxis {...SPARK_Y_AXIS_PROPS} domain={SCORE_Y_DOMAIN} />
+                 <ChartTooltip
+                   cursor={false}
+                   content={<ChartTooltipContent indicator="dot" />}
                  />
-                 <Line 
-                   type="monotone" 
-                   dataKey="avg" 
-                   stroke="var(--color-avg)" 
-                   strokeWidth={2} 
+                 <Line
+                   type="monotone"
+                   dataKey="avg"
+                   stroke="var(--color-avg)"
+                   strokeWidth={2}
                    dot={false}
-                   activeDot={{ r: 4 }} 
+                   activeDot={ACTIVE_DOT_R4}
                  />
-                 <Line 
-                   type="monotone" 
-                   dataKey="median" 
-                   stroke="var(--color-median)" 
-                   strokeWidth={2} 
+                 <Line
+                   type="monotone"
+                   dataKey="median"
+                   stroke="var(--color-median)"
+                   strokeWidth={2}
                    strokeDasharray="4 4"
                    dot={false}
-                   activeDot={{ r: 4 }} 
+                   activeDot={ACTIVE_DOT_R4}
                  />
                </LineChart>
              )}
@@ -316,71 +347,59 @@ export function ClassTrendsWidget({ assignments, compact, className }: ClassTren
         // arbitrary-value: chart canvas fixed size
         <ChartContainer config={chartConfig} className="h-[250px] w-full">
           {chartTab === "submission" ? (
-            <LineChart accessibilityLayer data={chartData} margin={{ top: 20, right: 20, bottom: 0, left: 0 }}>
-              <CartesianGrid vertical={false} strokeDasharray="3 3" />
-              <XAxis
-                dataKey="title"
-                tickLine={false}
-                tickMargin={10}
-                axisLine={false}
-                fontSize={12}
-              />
+            <LineChart accessibilityLayer data={chartData} margin={FULL_LINE_MARGIN}>
+              <CartesianGrid {...GRID_PROPS} />
+              <XAxis {...FULL_X_AXIS_PROPS} />
               <YAxis
                 tickLine={false}
                 axisLine={false}
                 fontSize={12}
                 domain={[0, 'auto']}
-                tickFormatter={(value) => `${value}`}
+                tickFormatter={formatValueTick}
               />
               <ChartTooltip content={<ChartTooltipContent />} />
-              <Line 
-                type="monotone" 
-                dataKey="target" 
-                stroke="var(--color-target)" 
-                strokeWidth={2} 
+              <Line
+                type="monotone"
+                dataKey="target"
+                stroke="var(--color-target)"
+                strokeWidth={2}
                 strokeDasharray="4 4"
                 dot={false}
               />
-              <Line 
-                type="monotone" 
-                dataKey="submitted" 
-                stroke="var(--color-submitted)" 
-                strokeWidth={2} 
-                activeDot={{ r: 6 }} 
+              <Line
+                type="monotone"
+                dataKey="submitted"
+                stroke="var(--color-submitted)"
+                strokeWidth={2}
+                activeDot={ACTIVE_DOT_R6}
               />
             </LineChart>
           ) : (
-            <LineChart accessibilityLayer data={chartData} margin={{ top: 20, right: 20, bottom: 0, left: 0 }}>
-              <CartesianGrid vertical={false} strokeDasharray="3 3" />
-              <XAxis
-                dataKey="title"
-                tickLine={false}
-                tickMargin={10}
-                axisLine={false}
-                fontSize={12}
-              />
+            <LineChart accessibilityLayer data={chartData} margin={FULL_LINE_MARGIN}>
+              <CartesianGrid {...GRID_PROPS} />
+              <XAxis {...FULL_X_AXIS_PROPS} />
               <YAxis
                 tickLine={false}
                 axisLine={false}
                 fontSize={12}
-                domain={[0, 100]}
-                tickFormatter={(value) => `${value}%`}
+                domain={SCORE_Y_DOMAIN}
+                tickFormatter={formatPercentTick}
               />
               <ChartTooltip content={<ChartTooltipContent />} />
-              <Line 
-                type="monotone" 
-                dataKey="avg" 
-                stroke="var(--color-avg)" 
-                strokeWidth={2} 
-                activeDot={{ r: 6 }} 
+              <Line
+                type="monotone"
+                dataKey="avg"
+                stroke="var(--color-avg)"
+                strokeWidth={2}
+                activeDot={ACTIVE_DOT_R6}
               />
-              <Line 
-                type="monotone" 
-                dataKey="median" 
-                stroke="var(--color-median)" 
-                strokeWidth={2} 
+              <Line
+                type="monotone"
+                dataKey="median"
+                stroke="var(--color-median)"
+                strokeWidth={2}
                 strokeDasharray="4 4"
-                activeDot={{ r: 6 }} 
+                activeDot={ACTIVE_DOT_R6}
               />
             </LineChart>
           )}
diff --git a/src/modules/classes/data-access-invitations.ts b/src/modules/classes/data-access-invitations.ts
index 56eb037..9843cba 100644
--- a/src/modules/classes/data-access-invitations.ts
+++ b/src/modules/classes/data-access-invitations.ts
@@ -5,6 +5,7 @@ import { createId } from "@paralleldrive/cuid2"
 
 import { db } from "@/shared/db"
 import { classes, classInvitationCodes } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 /**
  * 班级邀请码 data-access（v3 新增，对标 Google Classroom / 钉钉教育 / 智学网）。
@@ -199,7 +200,7 @@ export async function createInvitationCode(
  * 获取班级当前有效的邀请码（取最新一个 active 的）。
  * 给 onboarding/join 用，若无则返回 null。
  */
-export async function getActiveInvitationCode(classId: string): Promise<InvitationCodeRecord | null> {
+export async function getActiveInvitationCodeRaw(classId: string): Promise<InvitationCodeRecord | null> {
   const [record] = await db
     .select()
     .from(classInvitationCodes)
@@ -216,10 +217,16 @@ export async function getActiveInvitationCode(classId: string): Promise<Invitati
   return record ? mapRecord(record) : null
 }
 
+export const getActiveInvitationCode = cacheFn(getActiveInvitationCodeRaw, {
+  tags: ["classes:invitations"],
+  ttl: 600,
+  keyParts: ["classes", "invitations", "active"],
+})
+
 /**
  * 列出班级所有邀请码（管理端用）。
  */
-export async function listClassInvitationCodes(classId: string): Promise<InvitationCodeRecord[]> {
+export async function listClassInvitationCodesRaw(classId: string): Promise<InvitationCodeRecord[]> {
   const records = await db
     .select()
     .from(classInvitationCodes)
@@ -229,6 +236,12 @@ export async function listClassInvitationCodes(classId: string): Promise<Invitat
   return records.map(mapRecord)
 }
 
+export const listClassInvitationCodes = cacheFn(listClassInvitationCodesRaw, {
+  tags: ["classes:invitations"],
+  ttl: 300,
+  keyParts: ["classes", "invitations", "list"],
+})
+
 /**
  * 校验邀请码有效性（不消耗）。
  *
@@ -310,7 +323,7 @@ export async function consumeInvitationCode(code: string): Promise<void> {
 /**
  * 根据邀请码 ID 查询所属班级 ID（用于缓存失效参数填充）。
  */
-export async function getClassIdByCodeId(codeId: string): Promise<string | null> {
+export async function getClassIdByCodeIdRaw(codeId: string): Promise<string | null> {
   const [record] = await db
     .select({ classId: classInvitationCodes.classId })
     .from(classInvitationCodes)
@@ -319,6 +332,12 @@ export async function getClassIdByCodeId(codeId: string): Promise<string | null>
   return record?.classId ?? null
 }
 
+export const getClassIdByCodeId = cacheFn(getClassIdByCodeIdRaw, {
+  tags: ["classes:invitations"],
+  ttl: 300,
+  keyParts: ["classes", "invitations", "class-by-code"],
+})
+
 /**
  * 撤销邀请码（软删除）。
  */
diff --git a/src/modules/diagnostic/data-access-reports.ts b/src/modules/diagnostic/data-access-reports.ts
index cec45df..fd2d268 100644
--- a/src/modules/diagnostic/data-access-reports.ts
+++ b/src/modules/diagnostic/data-access-reports.ts
@@ -2,7 +2,7 @@ import "server-only"
 
 import { createId } from "@paralleldrive/cuid2"
 import { and, count, desc, eq, inArray, type SQL } from "drizzle-orm"
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { getTranslations } from "next-intl/server"
 
 import { db } from "@/shared/db"
@@ -198,8 +198,7 @@ export async function generateGradeDiagnosticReport(
 }
 
 /** 查询诊断报告列表（P3-15 修复：支持分页） */
-export const getDiagnosticReports = cache(
-  async (
+export const getDiagnosticReportsRaw = async (
     filters: DiagnosticReportQueryParams,
     scope?: DataScope,
   ): Promise<DiagnosticReportListResult> => {
@@ -291,12 +290,16 @@ export const getDiagnosticReports = cache(
     }))
 
     return { reports, total }
-  },
-)
+  }
+
+export const getDiagnosticReports = cacheFn(getDiagnosticReportsRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getDiagnosticReports"],
+})
 
 /** 获取报告详情 */
-export const getDiagnosticReportById = cache(
-  async (id: string): Promise<DiagnosticReportWithDetails | null> => {
+export const getDiagnosticReportByIdRaw = async (id: string): Promise<DiagnosticReportWithDetails | null> => {
     const [row] = await db
       .select({ report: learningDiagnosticReports })
       .from(learningDiagnosticReports)
@@ -319,8 +322,13 @@ export const getDiagnosticReportById = cache(
         ? userMap.get(row.report.generatedBy)?.name ?? null
         : null,
     }
-  },
-)
+  }
+
+export const getDiagnosticReportById = cacheFn(getDiagnosticReportByIdRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getDiagnosticReportById"],
+})
 
 /** 发布诊断报告 */
 export async function publishDiagnosticReport(id: string): Promise<void> {
diff --git a/src/modules/diagnostic/data-access.ts b/src/modules/diagnostic/data-access.ts
index 092650c..e77a47a 100644
--- a/src/modules/diagnostic/data-access.ts
+++ b/src/modules/diagnostic/data-access.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, desc, eq, inArray } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -33,7 +33,7 @@ import type {
 } from "./types"
 
 /** 获取学生在所有知识点的掌握度（含知识点名称） */
-const getStudentMastery = cache(async (studentId: string): Promise<MasteryWithKnowledgePoint[]> => {
+const getStudentMasteryRaw = async (studentId: string): Promise<MasteryWithKnowledgePoint[]> => {
   const rows = await db
     .select({
       mastery: knowledgePointMastery,
@@ -52,10 +52,16 @@ const getStudentMastery = cache(async (studentId: string): Promise<MasteryWithKn
       kpDescription: r.kpDescription,
     } satisfies RawMasteryWithKpRow),
   )
+}
+
+const getStudentMastery = cacheFn(getStudentMasteryRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getStudentMastery"],
 })
 
 /** 获取学生掌握度摘要（含强项/弱项分析） */
-export const getStudentMasterySummary = cache(async (studentId: string): Promise<StudentMasterySummary | null> => {
+export const getStudentMasterySummaryRaw = async (studentId: string): Promise<StudentMasterySummary | null> => {
   // P3-18 修复：用户名查询与掌握度查询相互独立，并行执行
   const [userMap, allMastery] = await Promise.all([
     getUserNamesByIds([studentId]),
@@ -65,6 +71,12 @@ export const getStudentMasterySummary = cache(async (studentId: string): Promise
   if (!student) return null
 
   return buildStudentMasterySummary(studentId, student.name ?? "Unknown", allMastery)
+}
+
+export const getStudentMasterySummary = cacheFn(getStudentMasterySummaryRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getStudentMasterySummary"],
 })
 
 /** 从提交答案更新掌握度（累积模式：在历史基础上累加，正确率作为掌握度） */
@@ -322,7 +334,7 @@ export async function updateMasteryFromExamScore(
 }
 
 /** 获取班级掌握度摘要 */
-export const getClassMasterySummary = cache(async (classId: string): Promise<ClassMasterySummary | null> => {
+export const getClassMasterySummaryRaw = async (classId: string): Promise<ClassMasterySummary | null> => {
   const classExists = await getClassExists(classId)
   if (!classExists) return null
 
@@ -361,10 +373,16 @@ export const getClassMasterySummary = cache(async (classId: string): Promise<Cla
   }))
 
   return buildClassMasterySummary(classId, className, students, rawRows)
+}
+
+export const getClassMasterySummary = cacheFn(getClassMasterySummaryRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getClassMasterySummary"],
 })
 
 /** v4-P2-3: 获取年级掌握度摘要 */
-export const getGradeMasterySummary = cache(async (gradeId: string): Promise<GradeMasterySummary | null> => {
+export const getGradeMasterySummaryRaw = async (gradeId: string): Promise<GradeMasterySummary | null> => {
   // 年级名称 与 学生列表 相互独立，并行拉取
   const [gradeNameResult, studentIds] = await Promise.all([
     getGradeNameById(gradeId),
@@ -400,10 +418,16 @@ export const getGradeMasterySummary = cache(async (gradeId: string): Promise<Gra
   }))
 
   return buildGradeMasterySummary(gradeId, gradeName, students, rawRows)
+}
+
+export const getGradeMasterySummary = cacheFn(getGradeMasterySummaryRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getGradeMasterySummary"],
 })
 
 /** 获取知识点统计（按班级或年级聚合） */
-export const getKnowledgePointStats = cache(async (classId?: string, gradeId?: string): Promise<KnowledgePointStat[]> => {
+export const getKnowledgePointStatsRaw = async (classId?: string, gradeId?: string): Promise<KnowledgePointStat[]> => {
   let studentIds: string[] = []
   if (classId) {
     studentIds = await getActiveStudentIdsByClassId(classId)
@@ -430,6 +454,12 @@ export const getKnowledgePointStats = cache(async (classId?: string, gradeId?: s
 
   const { byKp } = aggregateClassMastery(rawRows, studentIds)
   return computeKpStats(byKp)
+}
+
+export const getKnowledgePointStats = cacheFn(getKnowledgePointStatsRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getKnowledgePointStats"],
 })
 
 /**
@@ -439,8 +469,7 @@ export const getKnowledgePointStats = cache(async (classId?: string, gradeId?: s
  * 在该知识点上的掌握度，便于针对性辅导。掌握度低于阈值（默认 60）的学生
  * 排在前面并标记为"需关注"。
  */
-export const getClassStudentsByKnowledgePoint = cache(
-  async (
+export const getClassStudentsByKnowledgePointRaw = async (
     classId: string,
     knowledgePointId: string,
     options?: { threshold?: number }
@@ -516,4 +545,9 @@ export const getClassStudentsByKnowledgePoint = cache(
 
     return result
   }
-)
+
+export const getClassStudentsByKnowledgePoint = cacheFn(getClassStudentsByKnowledgePointRaw, {
+  tags: ["diagnostic"],
+  ttl: 300,
+  keyParts: ["diagnostic", "getClassStudentsByKnowledgePoint"],
+})
diff --git a/src/modules/elective/data-access-settings.ts b/src/modules/elective/data-access-settings.ts
index 813c114..602a57f 100644
--- a/src/modules/elective/data-access-settings.ts
+++ b/src/modules/elective/data-access-settings.ts
@@ -12,7 +12,7 @@ import { cacheFn } from "@/shared/lib/cache"
  * 设计原则：
  * - 复用全局 `system_settings` 表（category="elective"），避免新增独立表
  * - 支持按年级覆盖（key=`creditLimit:grade:<gradeId>`），fallback 到全局（key=`creditLimit:default`）
- * - 用 React `cache()` 包装，单次请求内去重
+ * - 用 `cacheFn` 包装，请求级 + 跨请求缓存
  * - 配置缺失时使用默认值（向后兼容）
  *
  * 配置项：
diff --git a/src/modules/error-book/components/chapter-weakness-chart.tsx b/src/modules/error-book/components/chapter-weakness-chart.tsx
index f8d36f7..6f85267 100644
--- a/src/modules/error-book/components/chapter-weakness-chart.tsx
+++ b/src/modules/error-book/components/chapter-weakness-chart.tsx
@@ -1,5 +1,6 @@
 "use client"
 
+import { useCallback } from "react"
 import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
 import { useTranslations } from "next-intl"
 import {
@@ -14,6 +15,23 @@ import { cn } from "@/shared/lib/utils"
 
 import type { ChapterWeakness } from "@/modules/error-book/types"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const CHART_MARGIN = { left: 8, right: 16, top: 8, bottom: 8 }
+const GRID_PROPS = { horizontal: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const X_AXIS_PROPS = { type: "number" as const, tickLine: false, axisLine: false }
+const Y_AXIS_BASE_PROPS = {
+  type: "number" as const,
+  dataKey: "name",
+  tickLine: false,
+  axisLine: false,
+  width: 120,
+}
+const BAR_RADIUS: [number, number, number, number] = [0, 4, 4, 0]
+
+function truncateTick(value: string): string {
+  return value.length > 10 ? `${value.slice(0, 10)}...` : value
+}
+
 interface ChapterWeaknessChartProps {
   data: ChapterWeakness[]
   className?: string
@@ -49,6 +67,47 @@ function isChapterChartPayload(v: unknown): v is ChapterChartPayload {
 export function ChapterWeaknessChart({ data, className }: ChapterWeaknessChartProps) {
   const t = useTranslations("errorBook")
 
+  const renderTooltip = useCallback(
+    (payload: unknown) => {
+      if (!isChapterChartPayload(payload)) return null
+      return (
+        <div className="space-y-1.5">
+          <div className="font-medium">{payload.name}</div>
+          <div className="text-muted-foreground">
+            {t("chapterChart.errorCount")}：
+            <span className="font-medium text-foreground">{payload.errorCount}</span>
+            <span className="ml-2">
+              {t("chapterChart.masteredLabel")}：
+              <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
+            </span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("chapterChart.masteryRateLabel")}：
+            <span className="font-medium text-foreground">{payload.masteryRate}%</span>
+            <span className="ml-2">
+              {t("chapterChart.knowledgePointCount")}：
+              <span className="font-medium text-foreground">{payload.knowledgePointCount}</span>
+            </span>
+          </div>
+          {payload.topKps && payload.topKps.length > 0 ? (
+            <div className="border-t pt-1.5 mt-1.5">
+              <div className="text-xs text-muted-foreground mb-1">
+                {t("chapterChart.weakKpsLabel")}
+              </div>
+              {payload.topKps.map((kp) => (
+                <div key={kp.knowledgePointName} className="flex justify-between text-xs">
+                  <span>{kp.knowledgePointName}</span>
+                  <span className="font-medium text-rose-600">{kp.errorCount}</span>
+                </div>
+              ))}
+            </div>
+          ) : null}
+        </div>
+      )
+    },
+    [t]
+  )
+
   if (data.length === 0) return null
 
   const chartData = data.map((d) => ({
@@ -82,65 +141,23 @@ export function ChapterWeaknessChart({ data, className }: ChapterWeaknessChartPr
           <BarChart
             data={chartData}
             layout="vertical"
-            margin={{ left: 8, right: 16, top: 8, bottom: 8 }}
+            margin={CHART_MARGIN}
           >
-            <CartesianGrid horizontal={false} strokeDasharray="4 4" strokeOpacity={0.4} />
-            <XAxis type="number" tickLine={false} axisLine={false} />
+            <CartesianGrid {...GRID_PROPS} />
+            <XAxis {...X_AXIS_PROPS} />
             <YAxis
-              type="number"
-              dataKey="name"
-              tickLine={false}
-              axisLine={false}
-              width={120}
-              tickFormatter={(value: string) =>
-                value.length > 10 ? `${value.slice(0, 10)}...` : value
-              }
+              {...Y_AXIS_BASE_PROPS}
+              tickFormatter={truncateTick}
             />
             <ChartTooltip
               content={
                 <ChartTooltipContent
                   className="w-[280px]"
-                  formatter={(payload: unknown) => {
-                    if (!isChapterChartPayload(payload)) return null
-                    return (
-                      <div className="space-y-1.5">
-                        <div className="font-medium">{payload.name}</div>
-                        <div className="text-muted-foreground">
-                          {t("chapterChart.errorCount")}：
-                          <span className="font-medium text-foreground">{payload.errorCount}</span>
-                          <span className="ml-2">
-                            {t("chapterChart.masteredLabel")}：
-                            <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
-                          </span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("chapterChart.masteryRateLabel")}：
-                          <span className="font-medium text-foreground">{payload.masteryRate}%</span>
-                          <span className="ml-2">
-                            {t("chapterChart.knowledgePointCount")}：
-                            <span className="font-medium text-foreground">{payload.knowledgePointCount}</span>
-                          </span>
-                        </div>
-                        {payload.topKps && payload.topKps.length > 0 ? (
-                          <div className="border-t pt-1.5 mt-1.5">
-                            <div className="text-xs text-muted-foreground mb-1">
-                              {t("chapterChart.weakKpsLabel")}
-                            </div>
-                            {payload.topKps.map((kp) => (
-                              <div key={kp.knowledgePointName} className="flex justify-between text-xs">
-                                <span>{kp.knowledgePointName}</span>
-                                <span className="font-medium text-rose-600">{kp.errorCount}</span>
-                              </div>
-                            ))}
-                          </div>
-                        ) : null}
-                      </div>
-                    )
-                  }}
+                  formatter={renderTooltip}
                 />
               }
             />
-            <Bar dataKey="errorCount" radius={[0, 4, 4, 0]}>
+            <Bar dataKey="errorCount" radius={BAR_RADIUS}>
               {chartData.map((entry, idx) => (
                 <Cell
                   key={idx}
diff --git a/src/modules/error-book/components/class-error-bar-chart.tsx b/src/modules/error-book/components/class-error-bar-chart.tsx
index 56e3680..51d4908 100644
--- a/src/modules/error-book/components/class-error-bar-chart.tsx
+++ b/src/modules/error-book/components/class-error-bar-chart.tsx
@@ -1,5 +1,6 @@
 "use client"
 
+import { useCallback } from "react"
 import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
 import { useTranslations } from "next-intl"
 import {
@@ -13,6 +14,22 @@ import { cn } from "@/shared/lib/utils"
 
 import type { ClassErrorOverview } from "@/modules/error-book/types"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const CHART_MARGIN = { left: 8, right: 8, top: 8, bottom: 8 }
+const GRID_PROPS = { vertical: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const X_AXIS_BASE_PROPS = {
+  dataKey: "name",
+  tickLine: false,
+  axisLine: false,
+  tickMargin: 8,
+}
+const Y_AXIS_PROPS = { tickLine: false, axisLine: false, width: 36 }
+const BAR_RADIUS: [number, number, number, number] = [4, 4, 0, 0]
+
+function truncateTick(value: string): string {
+  return value.length > 8 ? `${value.slice(0, 8)}...` : value
+}
+
 interface ClassErrorBarChartProps {
   data: ClassErrorOverview[]
   className?: string
@@ -57,6 +74,38 @@ const CHART_COLORS = [
 export function ClassErrorBarChart({ data, className }: ClassErrorBarChartProps) {
   const t = useTranslations("errorBook")
 
+  const renderTooltip = useCallback(
+    (payload: unknown) => {
+      if (!isClassBarChartPayload(payload)) return null
+      return (
+        <div className="space-y-1.5">
+          <div className="font-medium">{payload.name}</div>
+          <div className="text-muted-foreground">
+            {t("classErrorBar.errorCount")}：
+            <span className="font-medium text-foreground">{payload.totalErrorItems}</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("classErrorBar.studentCount")}：
+            <span className="font-medium text-foreground">{payload.studentCount}</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("classErrorBar.avgPerStudent")}：
+            <span className="font-medium text-foreground">{payload.averageErrorPerStudent}</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("classErrorBar.avgMastery")}：
+            <span className="font-medium text-foreground">{payload.averageMasteryRate}%</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("classErrorBar.dueReview")}：
+            <span className="font-medium text-rose-600">{payload.dueReviewCount}</span>
+          </div>
+        </div>
+      )
+    },
+    [t]
+  )
+
   if (data.length === 0) return null
 
   const chartData = data.map((d) => ({
@@ -87,54 +136,22 @@ export function ClassErrorBarChart({ data, className }: ClassErrorBarChartProps)
           className="h-[280px] w-full"
           aria-label={t("classErrorBar.title")}
         >
-          <BarChart data={chartData} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-            <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
+          <BarChart data={chartData} margin={CHART_MARGIN}>
+            <CartesianGrid {...GRID_PROPS} />
             <XAxis
-              dataKey="name"
-              tickLine={false}
-              axisLine={false}
-              tickMargin={8}
-              tickFormatter={(value: string) =>
-                value.length > 8 ? `${value.slice(0, 8)}...` : value
-              }
+              {...X_AXIS_BASE_PROPS}
+              tickFormatter={truncateTick}
             />
-            <YAxis tickLine={false} axisLine={false} width={36} />
+            <YAxis {...Y_AXIS_PROPS} />
             <ChartTooltip
               content={
                 <ChartTooltipContent
                   className="w-[220px]"
-                  formatter={(payload: unknown) => {
-                    if (!isClassBarChartPayload(payload)) return null
-                    return (
-                      <div className="space-y-1.5">
-                        <div className="font-medium">{payload.name}</div>
-                        <div className="text-muted-foreground">
-                          {t("classErrorBar.errorCount")}：
-                          <span className="font-medium text-foreground">{payload.totalErrorItems}</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("classErrorBar.studentCount")}：
-                          <span className="font-medium text-foreground">{payload.studentCount}</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("classErrorBar.avgPerStudent")}：
-                          <span className="font-medium text-foreground">{payload.averageErrorPerStudent}</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("classErrorBar.avgMastery")}：
-                          <span className="font-medium text-foreground">{payload.averageMasteryRate}%</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("classErrorBar.dueReview")}：
-                          <span className="font-medium text-rose-600">{payload.dueReviewCount}</span>
-                        </div>
-                      </div>
-                    )
-                  }}
+                  formatter={renderTooltip}
                 />
               }
             />
-            <Bar dataKey="totalErrorItems" radius={[4, 4, 0, 0]}>
+            <Bar dataKey="totalErrorItems" radius={BAR_RADIUS}>
               {chartData.map((_, idx) => (
                 <Cell key={idx} fill={CHART_COLORS[idx % CHART_COLORS.length]} />
               ))}
diff --git a/src/modules/error-book/components/knowledge-point-weakness-chart.tsx b/src/modules/error-book/components/knowledge-point-weakness-chart.tsx
index dcf416f..8281beb 100644
--- a/src/modules/error-book/components/knowledge-point-weakness-chart.tsx
+++ b/src/modules/error-book/components/knowledge-point-weakness-chart.tsx
@@ -1,5 +1,6 @@
 "use client"
 
+import { useCallback } from "react"
 import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
 import { useTranslations } from "next-intl"
 import {
@@ -14,6 +15,23 @@ import { cn } from "@/shared/lib/utils"
 
 import type { KnowledgePointWeakness } from "@/modules/error-book/types"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const CHART_MARGIN = { left: 8, right: 16, top: 8, bottom: 8 }
+const GRID_PROPS = { horizontal: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const X_AXIS_PROPS = { type: "number" as const, tickLine: false, axisLine: false }
+const Y_AXIS_BASE_PROPS = {
+  type: "number" as const,
+  dataKey: "name",
+  tickLine: false,
+  axisLine: false,
+  width: 100,
+}
+const BAR_RADIUS: [number, number, number, number] = [0, 4, 4, 0]
+
+function truncateTick(value: string): string {
+  return value.length > 8 ? `${value.slice(0, 8)}...` : value
+}
+
 interface KnowledgePointWeaknessChartProps {
   data: KnowledgePointWeakness[]
   className?: string
@@ -52,6 +70,33 @@ export function KnowledgePointWeaknessChart({
 }: KnowledgePointWeaknessChartProps) {
   const t = useTranslations("errorBook")
 
+  const renderTooltip = useCallback(
+    (payload: unknown) => {
+      if (!isKpChartPayload(payload)) return null
+      return (
+        <div className="space-y-1.5">
+          <div className="font-medium">{payload.name}</div>
+          <div className="text-xs text-muted-foreground">
+            {t("weaknessChart.chapterLabel", { title: payload.chapterTitle })}
+          </div>
+          <div className="text-muted-foreground">
+            {t("weaknessChart.errorCount")}：
+            <span className="font-medium text-foreground">{payload.errorCount}</span>
+            <span className="ml-2">
+              {t("weaknessChart.masteredLabel")}：
+              <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
+            </span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("weaknessChart.masteryRateLabel")}：
+            <span className="font-medium text-foreground">{payload.masteryRate}%</span>
+          </div>
+        </div>
+      )
+    },
+    [t]
+  )
+
   if (data.length === 0) return null
 
   const chartData = data.map((d) => ({
@@ -85,51 +130,23 @@ export function KnowledgePointWeaknessChart({
           <BarChart
             data={chartData}
             layout="vertical"
-            margin={{ left: 8, right: 16, top: 8, bottom: 8 }}
+            margin={CHART_MARGIN}
           >
-            <CartesianGrid horizontal={false} strokeDasharray="4 4" strokeOpacity={0.4} />
-            <XAxis type="number" tickLine={false} axisLine={false} />
+            <CartesianGrid {...GRID_PROPS} />
+            <XAxis {...X_AXIS_PROPS} />
             <YAxis
-              type="number"
-              dataKey="name"
-              tickLine={false}
-              axisLine={false}
-              width={100}
-              tickFormatter={(value: string) =>
-                value.length > 8 ? `${value.slice(0, 8)}...` : value
-              }
+              {...Y_AXIS_BASE_PROPS}
+              tickFormatter={truncateTick}
             />
             <ChartTooltip
               content={
                 <ChartTooltipContent
                   className="w-60"
-                  formatter={(payload: unknown) => {
-                    if (!isKpChartPayload(payload)) return null
-                    return (
-                      <div className="space-y-1.5">
-                        <div className="font-medium">{payload.name}</div>
-                        <div className="text-xs text-muted-foreground">
-                          {t("weaknessChart.chapterLabel", { title: payload.chapterTitle })}
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("weaknessChart.errorCount")}：
-                          <span className="font-medium text-foreground">{payload.errorCount}</span>
-                          <span className="ml-2">
-                            {t("weaknessChart.masteredLabel")}：
-                            <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
-                          </span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("weaknessChart.masteryRateLabel")}：
-                          <span className="font-medium text-foreground">{payload.masteryRate}%</span>
-                        </div>
-                      </div>
-                    )
-                  }}
+                  formatter={renderTooltip}
                 />
               }
             />
-            <Bar dataKey="errorCount" radius={[0, 4, 4, 0]}>
+            <Bar dataKey="errorCount" radius={BAR_RADIUS}>
               {chartData.map((entry, idx) => (
                 <Cell
                   key={idx}
diff --git a/src/modules/error-book/components/subject-distribution-chart.tsx b/src/modules/error-book/components/subject-distribution-chart.tsx
index ea97457..fa7ca0f 100644
--- a/src/modules/error-book/components/subject-distribution-chart.tsx
+++ b/src/modules/error-book/components/subject-distribution-chart.tsx
@@ -1,5 +1,6 @@
 "use client"
 
+import { useCallback } from "react"
 import { Bar, BarChart, CartesianGrid, XAxis, YAxis, Cell } from "recharts"
 import { useTranslations } from "next-intl"
 import {
@@ -13,6 +14,22 @@ import { cn } from "@/shared/lib/utils"
 
 import type { SubjectErrorDistribution } from "@/modules/error-book/types"
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const CHART_MARGIN = { left: 8, right: 8, top: 8, bottom: 8 }
+const GRID_PROPS = { vertical: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const X_AXIS_BASE_PROPS = {
+  dataKey: "name",
+  tickLine: false,
+  axisLine: false,
+  tickMargin: 8,
+}
+const Y_AXIS_PROPS = { tickLine: false, axisLine: false, width: 36 }
+const BAR_RADIUS: [number, number, number, number] = [4, 4, 0, 0]
+
+function truncateTick(value: string): string {
+  return value.length > 6 ? `${value.slice(0, 6)}...` : value
+}
+
 interface SubjectDistributionChartProps {
   data: SubjectErrorDistribution[]
   className?: string
@@ -56,6 +73,30 @@ export function SubjectDistributionChart({
 }: SubjectDistributionChartProps) {
   const t = useTranslations("errorBook")
 
+  const renderTooltip = useCallback(
+    (payload: unknown) => {
+      if (!isSubjectDistChartPayload(payload)) return null
+      return (
+        <div className="space-y-1.5">
+          <div className="font-medium">{payload.name}</div>
+          <div className="text-muted-foreground">
+            {t("subjectDistChart.errorCount")}：
+            <span className="font-medium text-foreground">{payload.errorCount}</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("subjectDistChart.masteredLabel")}：
+            <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
+          </div>
+          <div className="text-muted-foreground">
+            {t("subjectDistChart.masteryRateLabel")}：
+            <span className="font-medium text-foreground">{payload.masteryRate}%</span>
+          </div>
+        </div>
+      )
+    },
+    [t]
+  )
+
   if (data.length === 0) return null
 
   const chartData = data.map((d) => ({
@@ -84,46 +125,22 @@ export function SubjectDistributionChart({
           className="h-[280px] w-full"
           aria-label={t("subjectDistChart.title")}
         >
-          <BarChart data={chartData} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-            <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
+          <BarChart data={chartData} margin={CHART_MARGIN}>
+            <CartesianGrid {...GRID_PROPS} />
             <XAxis
-              dataKey="name"
-              tickLine={false}
-              axisLine={false}
-              tickMargin={8}
-              tickFormatter={(value: string) =>
-                value.length > 6 ? `${value.slice(0, 6)}...` : value
-              }
+              {...X_AXIS_BASE_PROPS}
+              tickFormatter={truncateTick}
             />
-            <YAxis tickLine={false} axisLine={false} width={36} />
+            <YAxis {...Y_AXIS_PROPS} />
             <ChartTooltip
               content={
                 <ChartTooltipContent
                   className="w-[200px]"
-                  formatter={(payload: unknown) => {
-                    if (!isSubjectDistChartPayload(payload)) return null
-                    return (
-                      <div className="space-y-1.5">
-                        <div className="font-medium">{payload.name}</div>
-                        <div className="text-muted-foreground">
-                          {t("subjectDistChart.errorCount")}：
-                          <span className="font-medium text-foreground">{payload.errorCount}</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("subjectDistChart.masteredLabel")}：
-                          <span className="font-medium text-emerald-600">{payload.masteredCount}</span>
-                        </div>
-                        <div className="text-muted-foreground">
-                          {t("subjectDistChart.masteryRateLabel")}：
-                          <span className="font-medium text-foreground">{payload.masteryRate}%</span>
-                        </div>
-                      </div>
-                    )
-                  }}
+                  formatter={renderTooltip}
                 />
               }
             />
-            <Bar dataKey="errorCount" radius={[4, 4, 0, 0]}>
+            <Bar dataKey="errorCount" radius={BAR_RADIUS}>
               {chartData.map((_, idx) => (
                 <Cell key={idx} fill={SUBJECT_COLORS[idx % SUBJECT_COLORS.length]} />
               ))}
diff --git a/src/modules/error-book/data-access-analytics.ts b/src/modules/error-book/data-access-analytics.ts
index f845a6f..54f21b7 100644
--- a/src/modules/error-book/data-access-analytics.ts
+++ b/src/modules/error-book/data-access-analytics.ts
@@ -13,6 +13,7 @@ import {
   classEnrollments,
   classes,
 } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 import { getStudentIdsByClassIds } from "@/modules/classes/data-access"
 import { ROLE_NAMES } from "@/shared/types/permissions"
 
@@ -30,7 +31,7 @@ import { buildStudentErrorWhereClause, toStatus, toStringArray } from "./data-ac
 // ---------------------------------------------------------------------------
 
 /** 查询多个学生的错题统计（教师视图，支持按学科过滤） */
-export async function getStudentErrorBookSummaries(
+export async function getStudentErrorBookSummariesRaw(
   studentIds: string[],
   subjectId?: string | null
 ): Promise<StudentErrorBookSummary[]> {
@@ -92,8 +93,14 @@ export async function getStudentErrorBookSummaries(
   })
 }
 
+export const getStudentErrorBookSummaries = cacheFn(getStudentErrorBookSummariesRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "summaries"],
+})
+
 /** 查询班级内错题最多的题目（教师视图：高频错题，支持按学科过滤） */
-export async function getTopWrongQuestionsByStudentIds(
+export async function getTopWrongQuestionsByStudentIdsRaw(
   studentIds: string[],
   limit = 10,
   subjectId?: string | null
@@ -144,8 +151,14 @@ export async function getTopWrongQuestionsByStudentIds(
   }))
 }
 
+export const getTopWrongQuestionsByStudentIds = cacheFn(getTopWrongQuestionsByStudentIdsRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "top-wrong"],
+})
+
 /** 查询多个学生的知识点薄弱度统计（支持按学科过滤，关联章节信息） */
-export async function getKnowledgePointWeakness(
+export async function getKnowledgePointWeaknessRaw(
   studentIds: string[],
   limit = 10,
   subjectId?: string | null
@@ -226,8 +239,14 @@ export async function getKnowledgePointWeakness(
     .slice(0, limit)
 }
 
+export const getKnowledgePointWeakness = cacheFn(getKnowledgePointWeaknessRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "kp-weakness"],
+})
+
 /** 查询多个学生的学科错题分布 */
-export async function getSubjectErrorDistribution(
+export async function getSubjectErrorDistributionRaw(
   studentIds: string[]
 ): Promise<Array<{
   subjectId: string | null
@@ -276,12 +295,18 @@ export async function getSubjectErrorDistribution(
   })
 }
 
+export const getSubjectErrorDistribution = cacheFn(getSubjectErrorDistributionRaw, {
+  tags: ["error-book"],
+  ttl: 60,
+  keyParts: ["error-book", "subject-distribution"],
+})
+
 /**
  * 查询章节薄弱度统计（哪些课在错）。
  * 通过 errorBookItems.knowledgePointIds → knowledgePoints.chapterId → chapters 关联。
  * 支持按学科过滤（通过 errorBookItems.subjectId）。
  */
-export async function getChapterWeakness(
+export async function getChapterWeaknessRaw(
   studentIds: string[],
   limit = 10,
   subjectId?: string | null
@@ -381,12 +406,18 @@ export async function getChapterWeakness(
     .slice(0, limit)
 }
 
+export const getChapterWeakness = cacheFn(getChapterWeaknessRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "chapter-weakness"],
+})
+
 /**
  * 查询按班级分组的错题概览（教师视图：分班显示）。
  * 对每个班级统计：学生数、错题总数、人均错题数、平均掌握率、待复习数。
  * 支持按学科过滤。
  */
-export async function getClassErrorOverviews(
+export async function getClassErrorOverviewsRaw(
   classIds: string[],
   subjectId?: string | null
 ): Promise<ClassErrorOverview[]> {
@@ -463,11 +494,17 @@ export async function getClassErrorOverviews(
   }).sort((a, b) => b.totalErrorItems - a.totalErrorItems)
 }
 
+export const getClassErrorOverviews = cacheFn(getClassErrorOverviewsRaw, {
+  tags: ["error-book"],
+  ttl: 60,
+  keyParts: ["error-book", "class-overviews"],
+})
+
 /**
  * 查询按学科分组的错题概览（用于学科 Tab 展示）。
  * 返回每个学科的错题总数、涉及学生数、平均掌握率、待复习数。
  */
-export async function getSubjectErrorOverviews(
+export async function getSubjectErrorOverviewsRaw(
   studentIds: string[]
 ): Promise<SubjectErrorOverview[]> {
   if (studentIds.length === 0) return []
@@ -515,8 +552,14 @@ export async function getSubjectErrorOverviews(
     .sort((a, b) => b.totalErrorItems - a.totalErrorItems)
 }
 
+export const getSubjectErrorOverviews = cacheFn(getSubjectErrorOverviewsRaw, {
+  tags: ["error-book"],
+  ttl: 60,
+  keyParts: ["error-book", "subject-overviews"],
+})
+
 /** 查询学生姓名映射 */
-export async function getStudentNameMap(studentIds: string[]): Promise<Map<string, string>> {
+export async function getStudentNameMapRaw(studentIds: string[]): Promise<Map<string, string>> {
   if (studentIds.length === 0) return new Map()
   const rows = await db
     .select({ id: users.id, name: users.name })
@@ -525,17 +568,29 @@ export async function getStudentNameMap(studentIds: string[]): Promise<Map<strin
   return new Map(rows.map((r) => [r.id, r.name ?? "未知"]))
 }
 
+export const getStudentNameMap = cacheFn(getStudentNameMapRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "name-map"],
+})
+
 /** 按班级 ID 查询学生 ID 列表（委托给 classes 模块） */
-export async function getStudentIdsByClassIdList(classIds: string[]): Promise<string[]> {
+export async function getStudentIdsByClassIdListRaw(classIds: string[]): Promise<string[]> {
   return await getStudentIdsByClassIds(classIds)
 }
 
+export const getStudentIdsByClassIdList = cacheFn(getStudentIdsByClassIdListRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "ids-by-classes"],
+})
+
 /**
  * 查询所有学生用户 ID（管理员视图）。
  * 通过 usersToRoles + roles 表关联查询 role === "student" 的用户。
  * 此函数封装了 DB 访问，避免 app 层直接查询 DB（遵循三层架构）。
  */
-export async function getAllStudentIds(): Promise<string[]> {
+export async function getAllStudentIdsRaw(): Promise<string[]> {
   const { usersToRoles, roles } = await import("@/shared/db/schema")
   const studentRole = await db
     .select({ id: roles.id })
@@ -552,3 +607,9 @@ export async function getAllStudentIds(): Promise<string[]> {
 
   return userRoleRows.map((r) => r.userId)
 }
+
+export const getAllStudentIds = cacheFn(getAllStudentIdsRaw, {
+  tags: ["error-book:students"],
+  ttl: 60,
+  keyParts: ["error-book", "students", "all-ids"],
+})
diff --git a/src/modules/error-book/data-access.ts b/src/modules/error-book/data-access.ts
index 7411133..32c5aaa 100644
--- a/src/modules/error-book/data-access.ts
+++ b/src/modules/error-book/data-access.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, count, desc, eq, inArray, isNull, lte, not, or, sql, type SQL } from "drizzle-orm"
 import { createId } from "@paralleldrive/cuid2"
 
@@ -103,7 +103,7 @@ function mapRowToItem(row: ErrorBookItemWithRelations): ErrorBookItem {
 // 查询：错题本列表
 // ---------------------------------------------------------------------------
 
-export const getErrorBookItems = cache(async (params: GetErrorBookItemsParams): Promise<ErrorBookListResult> => {
+export const getErrorBookItemsRaw = async (params: GetErrorBookItemsParams): Promise<ErrorBookListResult> => {
   const { studentId, q, page = 1, pageSize = 20, status, sourceType, subjectId, dueOnly } = params
   const offset = (page - 1) * pageSize
 
@@ -178,13 +178,19 @@ export const getErrorBookItems = cache(async (params: GetErrorBookItemsParams):
       totalPages: Math.ceil(total / pageSize),
     },
   }
+}
+
+export const getErrorBookItems = cacheFn(getErrorBookItemsRaw, {
+  tags: ["error-book"],
+  ttl: 300,
+  keyParts: ["error-book", "getErrorBookItems"],
 })
 
 // ---------------------------------------------------------------------------
 // 查询：错题详情
 // ---------------------------------------------------------------------------
 
-export const getErrorBookItemById = cache(async (
+export const getErrorBookItemByIdRaw = async (
   itemId: string,
   studentId: string
 ): Promise<ErrorBookItemDetail | null> => {
@@ -227,13 +233,19 @@ export const getErrorBookItemById = cache(async (
   }))
 
   return { ...base, reviews }
+}
+
+export const getErrorBookItemById = cacheFn(getErrorBookItemByIdRaw, {
+  tags: ["error-book"],
+  ttl: 300,
+  keyParts: ["error-book", "getErrorBookItemById"],
 })
 
 // ---------------------------------------------------------------------------
 // 查询：错题本统计（SQL 聚合优化）
 // ---------------------------------------------------------------------------
 
-export const getErrorBookStats = cache(async (studentId: string): Promise<ErrorBookStats> => {
+export const getErrorBookStatsRaw = async (studentId: string): Promise<ErrorBookStats> => {
   const now = new Date()
 
   // 使用 SQL GROUP BY 聚合状态计数
@@ -290,6 +302,12 @@ export const getErrorBookStats = cache(async (studentId: string): Promise<ErrorB
     dueReviewCount,
     masteredRate: totalCount > 0 ? masteredCount / totalCount : 0,
   }
+}
+
+export const getErrorBookStats = cacheFn(getErrorBookStatsRaw, {
+  tags: ["error-book"],
+  ttl: 300,
+  keyParts: ["error-book", "getErrorBookStats"],
 })
 
 // ---------------------------------------------------------------------------
diff --git a/src/modules/exams/components/exam-data-table.tsx b/src/modules/exams/components/exam-data-table.tsx
index d026acd..f6fa3b8 100644
--- a/src/modules/exams/components/exam-data-table.tsx
+++ b/src/modules/exams/components/exam-data-table.tsx
@@ -1,11 +1,11 @@
 "use client"
 
 import * as React from "react"
+import { useVirtualizer } from "@tanstack/react-virtual"
 import {
   flexRender,
   getCoreRowModel,
   useReactTable,
-  getPaginationRowModel,
   SortingState,
   getSortedRowModel,
   getFilteredRowModel,
@@ -21,11 +21,14 @@ import {
   TableHeader,
   TableRow,
 } from "@/shared/components/ui/table"
-import { Button } from "@/shared/components/ui/button"
-import { ChevronLeft, ChevronRight } from "lucide-react"
 import { Exam } from "../types"
 import { createExamColumns } from "./exam-columns"
 
+/** 虚拟滚动每行的预估高度(px),实际高度由 measureElement 动态测量 */
+const ROW_ESTIMATE_PX = 80
+/** 虚拟滚动容器最大高度(px) */
+const SCROLL_CONTAINER_MAX_HEIGHT_PX = 600
+
 interface DataTableProps {
   data: Exam[]
 }
@@ -34,6 +37,7 @@ export function ExamDataTable({ data }: DataTableProps) {
   const t = useTranslations("examHomework")
   const [sorting, setSorting] = React.useState<SortingState>([])
   const [rowSelection, setRowSelection] = React.useState<RowSelectionState>({})
+  const parentRef = React.useRef<HTMLDivElement>(null)
 
   const columns = React.useMemo(
     () => createExamColumns((key, params) => t(key, params as Record<string, string | number | Date> | undefined)),
@@ -44,7 +48,6 @@ export function ExamDataTable({ data }: DataTableProps) {
     data,
     columns,
     getCoreRowModel: getCoreRowModel(),
-    getPaginationRowModel: getPaginationRowModel(),
     onSortingChange: setSorting,
     getSortedRowModel: getSortedRowModel(),
     onRowSelectionChange: setRowSelection,
@@ -55,13 +58,34 @@ export function ExamDataTable({ data }: DataTableProps) {
     },
   })
 
+  const { rows } = table.getRowModel()
+
+  const virtualizer = useVirtualizer({
+    count: rows.length,
+    getScrollElement: () => parentRef.current,
+    estimateSize: () => ROW_ESTIMATE_PX,
+    overscan: 5,
+  })
+
+  const virtualItems = virtualizer.getVirtualItems()
+  const totalSize = virtualizer.getTotalSize()
+  const paddingTop = virtualItems.length > 0 ? virtualItems[0].start : 0
+  const paddingBottom =
+    virtualItems.length > 0
+      ? totalSize - virtualItems[virtualItems.length - 1].end
+      : 0
+
   return (
     <div className="space-y-4">
-      <div className="rounded-md border">
+      <div
+        ref={parentRef}
+        className="overflow-auto rounded-md border"
+        style={{ maxHeight: SCROLL_CONTAINER_MAX_HEIGHT_PX }}
+      >
         <Table>
-          <TableHeader className="bg-muted/40">
+          <TableHeader className="sticky top-0 z-10 bg-card">
             {table.getHeaderGroups().map((headerGroup) => (
-              <TableRow key={headerGroup.id}>
+              <TableRow key={headerGroup.id} className="hover:bg-transparent">
                 {headerGroup.headers.map((header) => {
                   return (
                     <TableHead key={header.id}>
@@ -75,16 +99,42 @@ export function ExamDataTable({ data }: DataTableProps) {
             ))}
           </TableHeader>
           <TableBody>
-            {table.getRowModel().rows?.length ? (
-              table.getRowModel().rows.map((row) => (
-                <TableRow key={row.id} data-state={row.getIsSelected() && "selected"}>
-                  {row.getVisibleCells().map((cell) => (
-                    <TableCell key={cell.id}>
-                      {flexRender(cell.column.columnDef.cell, cell.getContext())}
-                    </TableCell>
-                  ))}
-                </TableRow>
-              ))
+            {rows.length ? (
+              <>
+                {paddingTop > 0 && (
+                  <tr aria-hidden="true">
+                    <td
+                      style={{ height: paddingTop, padding: 0, border: 0 }}
+                      colSpan={columns.length}
+                    />
+                  </tr>
+                )}
+                {virtualItems.map((virtualItem) => {
+                  const row = rows[virtualItem.index]
+                  return (
+                    <TableRow
+                      key={row.id}
+                      data-state={row.getIsSelected() && "selected"}
+                      data-index={virtualItem.index}
+                      ref={virtualizer.measureElement}
+                    >
+                      {row.getVisibleCells().map((cell) => (
+                        <TableCell key={cell.id}>
+                          {flexRender(cell.column.columnDef.cell, cell.getContext())}
+                        </TableCell>
+                      ))}
+                    </TableRow>
+                  )
+                })}
+                {paddingBottom > 0 && (
+                  <tr aria-hidden="true">
+                    <td
+                      style={{ height: paddingBottom, padding: 0, border: 0 }}
+                      colSpan={columns.length}
+                    />
+                  </tr>
+                )}
+              </>
             ) : (
               <TableRow>
                 <TableCell colSpan={columns.length} className="h-24 text-center">
@@ -99,34 +149,6 @@ export function ExamDataTable({ data }: DataTableProps) {
         <div className="flex-1 text-sm text-muted-foreground">
           {table.getFilteredSelectedRowModel().rows.length} {t("common.of")} {table.getFilteredRowModel().rows.length} {t("common.rows")} {t("common.selected")}.
         </div>
-        <div className="flex items-center space-x-6 lg:space-x-8">
-          <div className="flex items-center space-x-2">
-            <p className="text-sm font-medium">{t("common.page")}</p>
-            <span className="text-sm font-medium">
-              {table.getState().pagination.pageIndex + 1} {t("common.of")} {table.getPageCount()}
-            </span>
-          </div>
-          <div className="flex items-center space-x-2">
-            <Button
-              variant="outline"
-              className="h-8 w-8 p-0"
-              onClick={() => table.previousPage()}
-              disabled={!table.getCanPreviousPage()}
-            >
-              <span className="sr-only">{t("common.page")}</span>
-              <ChevronLeft className="h-4 w-4" />
-            </Button>
-            <Button
-              variant="outline"
-              className="h-8 w-8 p-0"
-              onClick={() => table.nextPage()}
-              disabled={!table.getCanNextPage()}
-            >
-              <span className="sr-only">{t("common.page")}</span>
-              <ChevronRight className="h-4 w-4" />
-            </Button>
-          </div>
-        </div>
       </div>
     </div>
   )
diff --git a/src/modules/exams/data-access-error-collection.ts b/src/modules/exams/data-access-error-collection.ts
index 56ffe06..b9f0f6c 100644
--- a/src/modules/exams/data-access-error-collection.ts
+++ b/src/modules/exams/data-access-error-collection.ts
@@ -4,6 +4,7 @@ import { and, eq } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import { examQuestions, examSubmissions, exams, submissionAnswers } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 /**
  * 错题采集所需的答案数据（单题）
@@ -38,7 +39,7 @@ export type ExamSubmissionDataForErrorCollection = {
  * @param studentId 学生 ID（用于校验提交归属）
  * @returns 提交数据；若提交不存在或 studentId 不匹配则返回 null
  */
-export async function getExamSubmissionDataForErrorCollection(
+export async function getExamSubmissionDataForErrorCollectionRaw(
   submissionId: string,
   studentId: string,
 ): Promise<ExamSubmissionDataForErrorCollection | null> {
@@ -92,3 +93,9 @@ export async function getExamSubmissionDataForErrorCollection(
     answers: mappedAnswers,
   }
 }
+
+export const getExamSubmissionDataForErrorCollection = cacheFn(getExamSubmissionDataForErrorCollectionRaw, {
+  tags: ["exams"],
+  ttl: 300,
+  keyParts: ["exams", "submissions", "for-error-collection"],
+})
diff --git a/src/modules/exams/data-access.ts b/src/modules/exams/data-access.ts
index ae2b36e..1a6425f 100644
--- a/src/modules/exams/data-access.ts
+++ b/src/modules/exams/data-access.ts
@@ -1,7 +1,7 @@
 import { db } from "@/shared/db"
 import { exams, examQuestions } from "@/shared/db/schema"
 import { eq, desc, like, and, or, inArray } from "drizzle-orm"
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { createId } from "@paralleldrive/cuid2"
 import { createQuestionWithRelations } from "@/modules/questions/data-access"
 import { getClassGradeIdsByClassIds } from "@/modules/classes/data-access"
@@ -62,7 +62,7 @@ const toExamDifficulty = (n: number | undefined): ExamDifficulty => {
 }
 
 
-export const getExams = cache(async (params: GetExamsParams & { scope: DataScope }) => {
+export const getExamsRaw = async (params: GetExamsParams & { scope: DataScope }) => {
   const conditions = []
 
   if (params.q) {
@@ -145,9 +145,15 @@ export const getExams = cache(async (params: GetExamsParams & { scope: DataScope
   }
 
   return result
+}
+
+export const getExams = cacheFn(getExamsRaw, {
+  tags: ["exams"],
+  ttl: 300,
+  keyParts: ["exams", "getExams"],
 })
 
-export const getExamById = cache(async (id: string, scope?: DataScope) => {
+export const getExamByIdRaw = async (id: string, scope?: DataScope) => {
   const exam = await db.query.exams.findFirst({
     where: eq(exams.id, id),
     with: {
@@ -211,6 +217,12 @@ export const getExamById = cache(async (id: string, scope?: DataScope) => {
       order: eqRel.order ?? 0,
     })),
   }
+}
+
+export const getExamById = cacheFn(getExamByIdRaw, {
+  tags: ["exams"],
+  ttl: 300,
+  keyParts: ["exams", "getExamById"],
 })
 
 export const omitScheduledAtFromDescription = (description: string | null): string => {
diff --git a/src/modules/exams/editor/exam-rich-editor-inner.tsx b/src/modules/exams/editor/exam-rich-editor-inner.tsx
new file mode 100644
index 0000000..e264b89
--- /dev/null
+++ b/src/modules/exams/editor/exam-rich-editor-inner.tsx
@@ -0,0 +1,334 @@
+"use client";
+
+import { useCallback, useEffect, useImperativeHandle, useMemo, useRef, forwardRef } from "react";
+import { useEditor, EditorContent, type Editor } from "@tiptap/react";
+import StarterKit from "@tiptap/starter-kit";
+import Placeholder from "@tiptap/extension-placeholder";
+import { useTranslations } from "next-intl";
+import {
+  Bold,
+  Italic,
+  List,
+  ListOrdered,
+  Quote,
+  Redo,
+  Strikethrough,
+  Underline,
+  Undo,
+} from "lucide-react";
+
+import { cn } from "@/shared/lib/utils";
+import { Button } from "@/shared/components/ui/button";
+import { Separator } from "@/shared/components/ui/separator";
+import {
+  BlankNode,
+  DottedMark,
+  GroupBlock,
+  ImageNode,
+  QuestionBlock,
+  SectionBlock,
+  type QuestionBlockType,
+} from "./extensions";
+import { SelectionToolbar } from "./selection-toolbar";
+import type { EditorJSONContent } from "./exam-rich-editor-types";
+
+export interface ExamRichEditorHandle {
+  /** 获取当前编辑器文档(Tiptap JSONContent) */
+  getJSON: () => EditorJSONContent | null;
+  /** 设置编辑器文档 */
+  setJSON: (doc: EditorJSONContent) => void;
+  /** 获取纯文本(用于标题等) */
+  getText: () => string;
+  /** 插入题目块 */
+  insertQuestion: (type: QuestionBlockType, score?: number) => void;
+  /** 将选区包裹为题目块 */
+  wrapInQuestion: (type: QuestionBlockType, score?: number) => void;
+  /** 插入大题分组 */
+  insertGroup: (title?: string, instruction?: string) => void;
+  /** 将选区包裹为大题分组 */
+  wrapInGroup: (title?: string, instruction?: string) => void;
+  /** 插入试卷分卷 */
+  insertSection: (title?: string, level?: number) => void;
+  /** 将选区包裹为试卷分卷 */
+  wrapInSection: (title?: string, level?: number) => void;
+  /** 清空编辑器 */
+  clear: () => void;
+  /** 获取 Editor 实例(高级用法) */
+  getEditor: () => Editor | null;
+}
+
+export interface ExamRichEditorProps {
+  /** 初始内容(JSONContent) */
+  initialContent?: EditorJSONContent | null;
+  /** 占位提示文本 */
+  placeholder?: string;
+  /** 内容变化回调 */
+  onChange?: (doc: EditorJSONContent) => void;
+  /** 是否只读 */
+  readOnly?: boolean;
+  className?: string;
+}
+
+interface ToolbarButtonProps {
+  onClick: () => void;
+  icon: React.ElementType;
+  title: string;
+  active?: boolean;
+  disabled?: boolean;
+}
+
+function ToolbarButton({ onClick, icon: Icon, title, active, disabled }: ToolbarButtonProps) {
+  return (
+    <Button
+      type="button"
+      variant={active ? "secondary" : "ghost"}
+      size="icon"
+      className={cn(
+        "h-8 w-8 shrink-0",
+        active && "bg-muted text-foreground hover:bg-muted",
+      )}
+      disabled={disabled}
+      onMouseDown={(e) => e.preventDefault()}
+      onClick={(e) => {
+        e.preventDefault();
+        onClick();
+      }}
+      title={title}
+      aria-label={title}
+    >
+      <Icon className="h-4 w-4" />
+    </Button>
+  );
+}
+
+/**
+ * 试卷富文本编辑器 —— 基于 Tiptap,集成自定义节点(题目块/大题分组/填空/加点字/图片)。
+ * 选中文本时浮现 SelectionToolbar 提供快捷标记操作。
+ * 通过 ref 暴露 getJSON/setJSON 等方法供父组件调用。
+ */
+export const ExamRichEditorInner = forwardRef<ExamRichEditorHandle, ExamRichEditorProps>(
+  function ExamRichEditorInner(
+    {
+      initialContent,
+      placeholder,
+      onChange,
+      readOnly = false,
+      className,
+    },
+    ref,
+  ) {
+    const t = useTranslations("examHomework");
+    const resolvedPlaceholder = placeholder ?? t("exam.editor.contentPlaceholder");
+    const containerRef = useRef<HTMLDivElement>(null);
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+
+    const extensions = useMemo(
+      () => [
+        StarterKit.configure({
+          heading: { levels: [1, 2, 3] },
+        }),
+        Placeholder.configure({
+          placeholder: resolvedPlaceholder,
+          emptyEditorClass:
+            "is-editor-empty before:content-[attr(data-placeholder)] before:text-muted-foreground before:float-left before:pointer-events-none before:h-0",
+        }),
+        DottedMark,
+        BlankNode,
+        ImageNode,
+        QuestionBlock,
+        GroupBlock,
+        SectionBlock,
+      ],
+      [resolvedPlaceholder],
+    );
+
+    const editor = useEditor({
+      immediatelyRender: false,
+      extensions,
+      editable: !readOnly,
+      content: initialContent ?? undefined,
+      editorProps: {
+        attributes: {
+          class:
+            "prose prose-sm dark:prose-invert max-w-none min-h-[400px] p-4 focus:outline-none",
+        },
+      },
+      onUpdate: ({ editor }) => {
+        onChangeRef.current?.(editor.getJSON() as EditorJSONContent);
+      },
+    });
+
+    // 当 initialContent 变化时(如切换试卷),重置编辑器内容
+    useEffect(() => {
+      if (!editor) return;
+      if (initialContent) {
+        editor.commands.setContent(initialContent);
+      }
+      // 仅在 initialContent 引用变化时执行
+    }, [initialContent, editor]);
+
+    useImperativeHandle(
+      ref,
+      (): ExamRichEditorHandle => ({
+        getJSON: () => (editor ? (editor.getJSON() as EditorJSONContent) : null),
+        setJSON: (doc) => {
+          editor?.commands.setContent(doc);
+        },
+        getText: () => editor?.getText() ?? "",
+        insertQuestion: (type, score = 2) => {
+          editor?.chain().focus().insertQuestion({ type, score }).run();
+        },
+        wrapInQuestion: (type, score = 2) => {
+          editor?.chain().focus().wrapInQuestion({ type, score }).run();
+        },
+        insertGroup: (title, instruction) => {
+          editor?.chain().focus().insertGroup(title, instruction).run();
+        },
+        wrapInGroup: (title, instruction) => {
+          editor?.chain().focus().wrapInGroup(title, instruction).run();
+        },
+        insertSection: (title, level) => {
+          editor?.chain().focus().insertSection(title, level).run();
+        },
+        wrapInSection: (title, level) => {
+          editor?.chain().focus().wrapInSection(title, level).run();
+        },
+        clear: () => {
+          editor?.commands.clearContent(true);
+        },
+        getEditor: () => editor,
+      }),
+      [editor],
+    );
+
+    const handleBold = useCallback(() => {
+      editor?.chain().focus().toggleBold().run();
+    }, [editor]);
+
+    const handleItalic = useCallback(() => {
+      editor?.chain().focus().toggleItalic().run();
+    }, [editor]);
+
+    const handleStrike = useCallback(() => {
+      editor?.chain().focus().toggleStrike().run();
+    }, [editor]);
+
+    const handleDotted = useCallback(() => {
+      editor?.chain().focus().toggleDotted().run();
+    }, [editor]);
+
+    const handleBulletList = useCallback(() => {
+      editor?.chain().focus().toggleBulletList().run();
+    }, [editor]);
+
+    const handleOrderedList = useCallback(() => {
+      editor?.chain().focus().toggleOrderedList().run();
+    }, [editor]);
+
+    const handleBlockquote = useCallback(() => {
+      editor?.chain().focus().toggleBlockquote().run();
+    }, [editor]);
+
+    const handleUndo = useCallback(() => {
+      editor?.chain().focus().undo().run();
+    }, [editor]);
+
+    const handleRedo = useCallback(() => {
+      editor?.chain().focus().redo().run();
+    }, [editor]);
+
+    // 计算当前选区所在题目块类型(用于工具栏状态显示)
+    const activeQuestionType = useMemo<QuestionBlockType | undefined>(() => {
+      if (!editor) return undefined;
+      const $from = editor.state.selection.$from;
+      for (let d = $from.depth; d > 0; d--) {
+        const node = $from.node(d);
+        if (node.type.name === "questionBlock") {
+          return (node.attrs.type as QuestionBlockType) ?? "single_choice";
+        }
+      }
+      return undefined;
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [editor, editor?.state.selection]);
+
+    if (!editor) {
+      return (
+        <div className={cn("flex items-center justify-center p-8 text-muted-foreground", className)}>
+          {t("exam.editor.loading")}
+        </div>
+      );
+    }
+
+    return (
+      <div
+        ref={containerRef}
+        className={cn(
+          "relative flex flex-col rounded-md border bg-background shadow-sm overflow-hidden",
+          className,
+        )}
+      >
+        {!readOnly && (
+          <>
+            <div className="flex flex-wrap items-center gap-1 border-b bg-background/95 p-1 backdrop-blur supports-[backdrop-filter]:bg-background/60">
+              <ToolbarButton
+                onClick={handleBold}
+                icon={Bold}
+                title={t("exam.richEditor.bold")}
+                active={editor.isActive("bold")}
+              />
+              <ToolbarButton
+                onClick={handleItalic}
+                icon={Italic}
+                title={t("exam.richEditor.italic")}
+                active={editor.isActive("italic")}
+              />
+              <ToolbarButton
+                onClick={handleStrike}
+                icon={Strikethrough}
+                title={t("exam.richEditor.strike")}
+                active={editor.isActive("strike")}
+              />
+              <ToolbarButton
+                onClick={handleDotted}
+                icon={Underline}
+                title={t("exam.richEditor.dotted")}
+                active={editor.isActive("dotted")}
+              />
+
+              <Separator orientation="vertical" className="mx-1 h-6" />
+
+              <ToolbarButton
+                onClick={handleBulletList}
+                icon={List}
+                title={t("exam.richEditor.bulletList")}
+                active={editor.isActive("bulletList")}
+              />
+              <ToolbarButton
+                onClick={handleOrderedList}
+                icon={ListOrdered}
+                title={t("exam.richEditor.orderedList")}
+                active={editor.isActive("orderedList")}
+              />
+              <ToolbarButton
+                onClick={handleBlockquote}
+                icon={Quote}
+                title={t("exam.richEditor.quote")}
+                active={editor.isActive("blockquote")}
+              />
+
+              <div className="ml-auto flex items-center gap-1">
+                <ToolbarButton onClick={handleUndo} icon={Undo} title={t("exam.richEditor.undo")} />
+                <ToolbarButton onClick={handleRedo} icon={Redo} title={t("exam.richEditor.redo")} />
+              </div>
+            </div>
+
+            <SelectionToolbar editor={editor} activeQuestionType={activeQuestionType} />
+          </>
+        )}
+
+        <EditorContent editor={editor} className="flex-1 overflow-y-auto min-h-0" />
+      </div>
+    );
+  },
+);
diff --git a/src/modules/exams/editor/types.ts b/src/modules/exams/editor/types.ts
new file mode 100644
index 0000000..21513ed
--- /dev/null
+++ b/src/modules/exams/editor/types.ts
@@ -0,0 +1,26 @@
+/**
+ * 编辑器纯类型入口。
+ *
+ * 供 Server Component / Server Action / data-access 等不需要 ExamRichEditor
+ * 运行时实例的消费者引用,确保 TypeScript 不会拉入 @tiptap/* 运行时代码。
+ *
+ * 仅 re-export 类型与运行时安全的类型守卫/转换器(不依赖 tiptap 副作用)。
+ */
+
+export type {
+  RichQuestionType,
+  StandaloneQuestionType,
+  RichQuestionContent,
+  EditorQuestion,
+  EditorStructureNodeType,
+  EditorStructureNode,
+  EditorDoc,
+  EditorJSONContent,
+} from "./exam-rich-editor-types"
+
+export {
+  isRichQuestionType,
+  isStandaloneQuestionType,
+  toRichQuestionType,
+  toStandaloneQuestionType,
+} from "./exam-rich-editor-types"
diff --git a/src/modules/exams/stats-service.ts b/src/modules/exams/stats-service.ts
index 0cf3110..a56cf61 100644
--- a/src/modules/exams/stats-service.ts
+++ b/src/modules/exams/stats-service.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { getTranslations } from "next-intl/server"
 
 import { db } from "@/shared/db"
@@ -60,7 +60,7 @@ export interface ExamAnalyticsSummary {
  * 对标智学网考试分析功能，聚合该考试所有作业的已批改提交数据，
  * 计算：平均分、及格率、分数段分布、逐题错误率与难度。
  */
-export const getExamAnalytics = cache(async (examId: string): Promise<ExamAnalyticsSummary | null> => {
+export const getExamAnalyticsRaw = async (examId: string): Promise<ExamAnalyticsSummary | null> => {
   const t = await getTranslations("examHomework")
   const exam = await db.query.exams.findFirst({
     where: eq(exams.id, examId),
@@ -157,4 +157,10 @@ export const getExamAnalytics = cache(async (examId: string): Promise<ExamAnalyt
     scoreDistribution,
     questions,
   }
+}
+
+export const getExamAnalytics = cacheFn(getExamAnalyticsRaw, {
+  tags: ["exams"],
+  ttl: 300,
+  keyParts: ["exams", "getExamAnalytics"],
 })
diff --git a/src/modules/grades/components/grade-record-list.tsx b/src/modules/grades/components/grade-record-list.tsx
index ac41b58..47c8bb9 100644
--- a/src/modules/grades/components/grade-record-list.tsx
+++ b/src/modules/grades/components/grade-record-list.tsx
@@ -1,7 +1,7 @@
 "use client"
 
 import type { JSX } from "react"
-import { useState } from "react"
+import { useState, useOptimistic, useTransition } from "react"
 import { toast } from "sonner"
 import { useRouter } from "next/navigation"
 import { useTranslations } from "next-intl"
@@ -60,7 +60,15 @@ export function GradeRecordList({ records }: { records: GradeRecordListItem[] })
   const [deleteId, setDeleteId] = useState<string | null>(null)
   const [isDeleting, setIsDeleting] = useState(false)
   const [editTarget, setEditTarget] = useState<EditableFields | null>(null)
-  const [isSaving, setIsSaving] = useState(false)
+  // Phase 4.5: 编辑保存改用 useOptimistic + useTransition,在列表中即时显示乐观记录
+  const [optimisticRecords, addOptimisticRecord] = useOptimistic<
+    GradeRecordListItem[],
+    GradeRecordListItem
+  >(
+    records,
+    (state, updated) => state.map((r) => (r.id === updated.id ? updated : r)),
+  )
+  const [isSaving, startSaveTransition] = useTransition()
   // v3-P3-2: 批量选择与删除
   const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set())
   const [isBulkDeleteDialogOpen, setIsBulkDeleteDialogOpen] = useState(false)
@@ -147,9 +155,21 @@ export function GradeRecordList({ records }: { records: GradeRecordListItem[] })
     })
   }
 
-  const handleEditSave = async (): Promise<void> => {
+  const handleEditSave = (): void => {
     if (!editTarget) return
-    setIsSaving(true)
+    const existing = records.find((r) => r.id === editTarget.id)
+    if (!existing) return
+    // Phase 4.5: 构造乐观记录,在 transition 内 addOptimistic + await action + refresh
+    const optimisticRecord: GradeRecordListItem = {
+      ...existing,
+      title: editTarget.title,
+      score: Number(editTarget.score) || 0,
+      fullScore: Number(editTarget.fullScore) || 0,
+      type: editTarget.type,
+      semester: editTarget.semester,
+      remark: editTarget.remark,
+    }
+    const targetId = editTarget.id
     const formData = new FormData()
     formData.set("title", editTarget.title)
     formData.set("score", editTarget.score)
@@ -158,20 +178,23 @@ export function GradeRecordList({ records }: { records: GradeRecordListItem[] })
     formData.set("semester", editTarget.semester)
     formData.set("remark", editTarget.remark)
 
-    const result = await safeActionCall(
-      () => updateGradeRecordAction(editTarget.id, null, formData),
-      {
-        onError: () => toast.error(t("edit.failed")),
-        onFinally: () => setIsSaving(false),
+    startSaveTransition(async () => {
+      addOptimisticRecord(optimisticRecord)
+      const result = await safeActionCall(
+        () => updateGradeRecordAction(targetId, null, formData),
+        {
+          onError: () => toast.error(t("edit.failed")),
+        }
+      )
+      if (result?.success) {
+        toast.success(t("edit.success"))
+        setEditTarget(null)
+        // 同步数据源,让 useOptimistic 回滚到最新服务端值
+        await router.refresh()
+      } else if (result) {
+        toast.error(result.message || t("edit.failed"))
       }
-    )
-    if (result?.success) {
-      toast.success(t("edit.success"))
-      setEditTarget(null)
-      router.refresh()
-    } else if (result) {
-      toast.error(result.message || t("edit.failed"))
-    }
+    })
   }
 
   if (records.length === 0) {
@@ -238,7 +261,7 @@ export function GradeRecordList({ records }: { records: GradeRecordListItem[] })
               </TableRow>
             </TableHeader>
             <TableBody>
-              {records.map((r) => (
+              {optimisticRecords.map((r) => (
                 <TableRow key={r.id}>
                   <TableCell>
                     <Checkbox
@@ -295,7 +318,7 @@ export function GradeRecordList({ records }: { records: GradeRecordListItem[] })
           role="list"
           aria-label={t("list.caption")}
         >
-          {records.map((r) => (
+          {optimisticRecords.map((r) => (
             <div
               key={r.id}
               className="rounded-md border border-border/60 bg-background p-3 shadow-sm"
diff --git a/src/modules/grades/data-access-analytics.ts b/src/modules/grades/data-access-analytics.ts
index 89ad00a..ca6d15e 100644
--- a/src/modules/grades/data-access-analytics.ts
+++ b/src/modules/grades/data-access-analytics.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, asc, eq, inArray, isNotNull, ne } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -52,8 +52,7 @@ export interface GradeTrendParams {
   currentUserId?: string
 }
 
-export const getGradeTrend = cache(
-  async (params: GradeTrendParams): Promise<GradeTrendResult | null> => {
+export const getGradeTrendRaw = async (params: GradeTrendParams): Promise<GradeTrendResult | null> => {
     const conditions = [eq(gradeRecords.classId, params.classId)]
     if (params.subjectId) conditions.push(eq(gradeRecords.subjectId, params.subjectId))
     if (params.studentId) conditions.push(eq(gradeRecords.studentId, params.studentId))
@@ -101,7 +100,12 @@ export const getGradeTrend = cache(
       averageScore: avg,
     }
   }
-)
+
+export const getGradeTrend = cacheFn(getGradeTrendRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getGradeTrend"],
+})
 
 export interface ClassComparisonParams {
   gradeId: string
@@ -111,8 +115,7 @@ export interface ClassComparisonParams {
   scope: DataScope
 }
 
-export const getClassComparison = cache(
-  async (params: ClassComparisonParams): Promise<ClassComparisonItem[]> => {
+export const getClassComparisonRaw = async (params: ClassComparisonParams): Promise<ClassComparisonItem[]> => {
     const classRows = await getClassesByGradeId(params.gradeId)
 
     if (classRows.length === 0) return []
@@ -171,7 +174,12 @@ export const getClassComparison = cache(
 
     return result
   }
-)
+
+export const getClassComparison = cacheFn(getClassComparisonRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getClassComparison"],
+})
 
 /**
  * P3-5: 获取班级对比数据 + 班级间统计显著性分析结果。
@@ -189,8 +197,7 @@ export const getClassComparison = cache(
  *
  * 该函数复用 getClassComparison 的 cache（参数一致），不会触发额外 DB 查询。
  */
-export const getClassComparisonWithSignificance = cache(
-  async (params: ClassComparisonParams): Promise<ClassComparisonResult> => {
+export const getClassComparisonWithSignificanceRaw = async (params: ClassComparisonParams): Promise<ClassComparisonResult> => {
     const items = await getClassComparison(params)
 
     if (items.length < 2) {
@@ -253,7 +260,12 @@ export const getClassComparisonWithSignificance = cache(
 
     return { items, significance }
   }
-)
+
+export const getClassComparisonWithSignificance = cacheFn(getClassComparisonWithSignificanceRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getClassComparisonWithSignificance"],
+})
 
 /**
  * P3-9: 获取学生所在班级的成绩分布 + 学生本人位置标注（隐私保护视图）。
@@ -271,8 +283,7 @@ export const getClassComparisonWithSignificance = cache(
  * @param studentId - 当前学生 ID
  * @param scope - 当前用户的数据范围（学生为 class_members）
  */
-export const getStudentPositionInClassDistribution = cache(
-  async (
+export const getStudentPositionInClassDistributionRaw = async (
     studentId: string,
     scope: DataScope
   ): Promise<GradeDistributionWithPosition | null> => {
@@ -335,7 +346,12 @@ export const getStudentPositionInClassDistribution = cache(
       studentBucketIndex: bucketIndex,
     }
   }
-)
+
+export const getStudentPositionInClassDistribution = cacheFn(getStudentPositionInClassDistributionRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getStudentPositionInClassDistribution"],
+})
 
 /**
  * P3-4: 获取学生纵向成长档案（跨学年/学期聚合）。
@@ -357,8 +373,7 @@ export const getStudentPositionInClassDistribution = cache(
  * @param studentId - 学生 ID
  * @param scope - 当前用户的数据范围
  */
-export const getStudentGrowthArchive = cache(
-  async (
+export const getStudentGrowthArchiveRaw = async (
     studentId: string,
     scope: DataScope
   ): Promise<StudentGrowthArchiveResult | null> => {
@@ -468,7 +483,12 @@ export const getStudentGrowthArchive = cache(
       growthDelta,
     }
   }
-)
+
+export const getStudentGrowthArchive = cacheFn(getStudentGrowthArchiveRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getStudentGrowthArchive"],
+})
 
 export interface SubjectComparisonParams {
   classId: string
@@ -477,8 +497,7 @@ export interface SubjectComparisonParams {
   scope: DataScope
 }
 
-export const getSubjectComparison = cache(
-  async (params: SubjectComparisonParams): Promise<SubjectComparisonItem[]> => {
+export const getSubjectComparisonRaw = async (params: SubjectComparisonParams): Promise<SubjectComparisonItem[]> => {
     const scopeFilter = buildScopeClassFilter(params.scope)
     const conditions = [eq(gradeRecords.classId, params.classId)]
     if (params.examId) conditions.push(eq(gradeRecords.examId, params.examId))
@@ -524,7 +543,12 @@ export const getSubjectComparison = cache(
 
     return result.sort((a, b) => b.averageScore - a.averageScore)
   }
-)
+
+export const getSubjectComparison = cacheFn(getSubjectComparisonRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getSubjectComparison"],
+})
 
 export interface GradeDistributionParams {
   classId: string
@@ -535,8 +559,7 @@ export interface GradeDistributionParams {
   currentUserId?: string
 }
 
-export const getGradeDistribution = cache(
-  async (params: GradeDistributionParams): Promise<GradeDistributionResult> => {
+export const getGradeDistributionRaw = async (params: GradeDistributionParams): Promise<GradeDistributionResult> => {
     const conditions = [eq(gradeRecords.classId, params.classId)]
     if (params.subjectId) conditions.push(eq(gradeRecords.subjectId, params.subjectId))
     if (params.examId) conditions.push(eq(gradeRecords.examId, params.examId))
@@ -556,14 +579,18 @@ export const getGradeDistribution = cache(
 
     return computeGradeDistribution(rows)
   }
-)
+
+export const getGradeDistribution = cacheFn(getGradeDistributionRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getGradeDistribution"],
+})
 
 /**
  * v3-P2-7: 获取指定班级/科目下有成绩记录的考试列表，用于分析页考试筛选下拉框。
  * 仅返回 examId 非空且去重后的考试选项。
  */
-export const getExamOptionsForGrades = cache(
-  async (params: {
+export const getExamOptionsForGradesRaw = async (params: {
     classId: string
     subjectId?: string
     scope: DataScope
@@ -596,15 +623,19 @@ export const getExamOptionsForGrades = cache(
     }
     return result
   }
-)
+
+export const getExamOptionsForGrades = cacheFn(getExamOptionsForGradesRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getExamOptionsForGrades"],
+})
 
 /**
  * v3-P2-9: 获取全校各年级成绩汇总（管理员视图）。
  * 按年级聚合平均分、及格率、优秀率、学生数、班级数。
  * 仅限管理员（scope.type === "all"）调用。
  */
-export const getSchoolWideGradeSummary = cache(
-  async (scope: DataScope): Promise<SchoolWideGradeSummary> => {
+export const getSchoolWideGradeSummaryRaw = async (scope: DataScope): Promise<SchoolWideGradeSummary> => {
     // 管理员权限校验：仅 all scope 可调用
     if (scope.type !== "all") {
       return { grades: [], totals: { gradeCount: 0, classCount: 0, studentCount: 0, recordCount: 0, averageScore: 0, passRate: 0, excellentRate: 0 } }
@@ -701,7 +732,12 @@ export const getSchoolWideGradeSummary = cache(
       },
     }
   }
-)
+
+export const getSchoolWideGradeSummary = cacheFn(getSchoolWideGradeSummaryRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getSchoolWideGradeSummary"],
+})
 
 /**
  * 年级仪表盘 - 维度1：获取年级整体 + 按班级拆分的成绩分布。
@@ -716,8 +752,7 @@ export interface GradeDistributionByGradeParams {
   scope: DataScope
 }
 
-export const getGradeDistributionByGradeId = cache(
-  async (params: GradeDistributionByGradeParams): Promise<GradeDistributionByGradeResult> => {
+export const getGradeDistributionByGradeIdRaw = async (params: GradeDistributionByGradeParams): Promise<GradeDistributionByGradeResult> => {
     const classRows = await getClassesByGradeId(params.gradeId)
 
     if (classRows.length === 0) {
@@ -788,4 +823,9 @@ export const getGradeDistributionByGradeId = cache(
 
     return { overall, stats, byClass }
   }
-)
+
+export const getGradeDistributionByGradeId = cacheFn(getGradeDistributionByGradeIdRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getGradeDistributionByGradeId"],
+})
diff --git a/src/modules/grades/data-access-appeals.ts b/src/modules/grades/data-access-appeals.ts
index ae9e45f..31b1b30 100644
--- a/src/modules/grades/data-access-appeals.ts
+++ b/src/modules/grades/data-access-appeals.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { createId } from "@paralleldrive/cuid2"
 import { and, desc, eq } from "drizzle-orm"
 
@@ -99,8 +99,7 @@ export async function createGradeAppeal(params: {
 /**
  * 获取学生自己的申诉列表（按创建时间倒序）。
  */
-export const getStudentAppeals = cache(
-  async (studentId: string): Promise<GradeAppeal[]> => {
+export const getStudentAppealsRaw = async (studentId: string): Promise<GradeAppeal[]> => {
     const rows = await db
       .select()
       .from(gradeAppeals)
@@ -109,14 +108,18 @@ export const getStudentAppeals = cache(
 
     return rows.map(serializeAppeal)
   }
-)
+
+export const getStudentAppeals = cacheFn(getStudentAppealsRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getStudentAppeals"],
+})
 
 /**
  * 获取教师待复核的申诉列表（按创建时间正序，先到先审）。
  * 仅返回 pending 状态的申诉。
  */
-export const getPendingAppealsForReview = cache(
-  async (classIds: string[]): Promise<GradeAppealWithRecord[]> => {
+export const getPendingAppealsForReviewRaw = async (classIds: string[]): Promise<GradeAppealWithRecord[]> => {
     if (classIds.length === 0) return []
 
     const rows = await db
@@ -146,14 +149,18 @@ export const getPendingAppealsForReview = cache(
       reviewerName: null,
     }))
   }
-)
+
+export const getPendingAppealsForReview = cacheFn(getPendingAppealsForReviewRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getPendingAppealsForReview"],
+})
 
 /**
  * 获取单个申诉详情（含成绩信息）。
  * 调用方需校验：学生只能看自己的申诉，教师只能看自己班级的申诉。
  */
-export const getAppealById = cache(
-  async (appealId: string): Promise<GradeAppealWithRecord | null> => {
+export const getAppealByIdRaw = async (appealId: string): Promise<GradeAppealWithRecord | null> => {
     const rows = await db
       .select({
         appeal: gradeAppeals,
@@ -175,7 +182,12 @@ export const getAppealById = cache(
       reviewerName: null,
     }
   }
-)
+
+export const getAppealById = cacheFn(getAppealByIdRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getAppealById"],
+})
 
 /**
  * 教师复核申诉（状态机转换：pending → approved/rejected）。
diff --git a/src/modules/grades/data-access-drafts.ts b/src/modules/grades/data-access-drafts.ts
index 761ebb6..027b4f5 100644
--- a/src/modules/grades/data-access-drafts.ts
+++ b/src/modules/grades/data-access-drafts.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { createId } from "@paralleldrive/cuid2"
 import { and, eq, isNotNull, isNull, or, lt } from "drizzle-orm"
 
@@ -74,8 +74,7 @@ export async function saveGradeDraft(params: {
  * 获取成绩录入草稿。
  * 超过 24 小时的草稿视为过期，返回 null。
  */
-export const getGradeDraft = cache(
-  async (params: {
+export const getGradeDraftRaw = async (params: {
     userId: string
     classId: string
     subjectId: string
@@ -104,7 +103,12 @@ export const getGradeDraft = cache(
 
     return content
   }
-)
+
+export const getGradeDraft = cacheFn(getGradeDraftRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getGradeDraft"],
+})
 
 /**
  * 删除成绩录入草稿（提交成功后调用）。
diff --git a/src/modules/grades/data-access-ranking.ts b/src/modules/grades/data-access-ranking.ts
index f612d76..18793f1 100644
--- a/src/modules/grades/data-access-ranking.ts
+++ b/src/modules/grades/data-access-ranking.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, asc, eq } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -31,8 +31,7 @@ export type { ClassAverageTrendPoint, ClassAverageTrendResult }
  *
  * P3 修复：添加 scope 参数，对 class_taught scope 校验学生归属
  */
-export const getRankingTrend = cache(
-  async (
+export const getRankingTrendRaw = async (
     studentId: string,
     subjectId?: string,
     semester?: "1" | "2",
@@ -103,7 +102,12 @@ export const getRankingTrend = cache(
       points,
     }
   }
-)
+
+export const getRankingTrend = cacheFn(getRankingTrendRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getRankingTrend"],
+})
 
 /**
  * v3-P2-2: 获取班级平均成绩趋势（按 assessment title 分组）。
@@ -117,8 +121,7 @@ export const getRankingTrend = cache(
  * @param semester   可选学期过滤
  * @param scope      数据权限范围
  */
-export const getClassAverageTrend = cache(
-  async (
+export const getClassAverageTrendRaw = async (
     studentId: string,
     subjectId?: string,
     semester?: "1" | "2",
@@ -187,4 +190,9 @@ export const getClassAverageTrend = cache(
       points,
     }
   }
-)
+
+export const getClassAverageTrend = cacheFn(getClassAverageTrendRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getClassAverageTrend"],
+})
diff --git a/src/modules/grades/lib/report-card.ts b/src/modules/grades/lib/report-card.ts
index ecc6571..174dd5f 100644
--- a/src/modules/grades/lib/report-card.ts
+++ b/src/modules/grades/lib/report-card.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, eq } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -162,8 +162,7 @@ function toNum(v: unknown): number {
  * - class_members scope 仅允许查看自己的报告卡
  * - children scope 仅允许查看子女的报告卡
  */
-export const getReportCardData = cache(
-  async (
+export const getReportCardDataRaw = async (
     studentId: string,
     scope: DataScope,
     query?: ReportCardQuery
@@ -377,4 +376,9 @@ export const getReportCardData = cache(
       generatedAt: new Date().toISOString(),
     }
   }
-)
+
+export const getReportCardData = cacheFn(getReportCardDataRaw, {
+  tags: ["grades"],
+  ttl: 300,
+  keyParts: ["grades", "getReportCardData"],
+})
diff --git a/src/modules/homework/data-access-classes.ts b/src/modules/homework/data-access-classes.ts
index d1dd131..75af9a5 100644
--- a/src/modules/homework/data-access-classes.ts
+++ b/src/modules/homework/data-access-classes.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, desc, eq, inArray, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -68,8 +68,7 @@ export type HomeworkAssignmentSubjectRow = {
 /**
  * Returns assignment IDs that target any of the given students.
  */
-export const getAssignmentIdsForStudents = cache(
-  async (studentIds: string[]): Promise<string[]> => {
+export const getAssignmentIdsForStudentsRaw = async (studentIds: string[]): Promise<string[]> => {
     if (studentIds.length === 0) return []
     const rows = await db
       .selectDistinct({ assignmentId: homeworkAssignmentTargets.assignmentId })
@@ -77,7 +76,12 @@ export const getAssignmentIdsForStudents = cache(
       .where(inArray(homeworkAssignmentTargets.studentId, studentIds))
     return rows.map((r) => r.assignmentId)
   }
-)
+
+export const getAssignmentIdsForStudents = cacheFn(getAssignmentIdsForStudentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getAssignmentIdsForStudents"],
+})
 
 /**
  * Returns homework assignments joined with subject info (via source exam),
@@ -89,8 +93,7 @@ export const getAssignmentIdsForStudents = cache(
  * 3. 通过 school data-access 批量获取 subjectId→name 映射
  * 4. 在内存中合并与过滤
  */
-export const getHomeworkAssignmentsWithSubject = cache(
-  async (params: {
+export const getHomeworkAssignmentsWithSubjectRaw = async (params: {
     assignmentIds: string[]
     subjectIdFilter?: string[]
     limit?: number
@@ -151,14 +154,18 @@ export const getHomeworkAssignmentsWithSubject = cache(
         return item.subjectId !== null && subjectIdFilterSet.has(item.subjectId)
       })
   }
-)
+
+export const getHomeworkAssignmentsWithSubject = cacheFn(getHomeworkAssignmentsWithSubjectRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentsWithSubject"],
+})
 
 /**
  * Returns homework assignments (without subject info) by IDs.
  * Used by grade-level homework insights where subject filtering is not needed.
  */
-export const getHomeworkAssignmentsByIds = cache(
-  async (params: { assignmentIds: string[]; limit?: number }): Promise<HomeworkAssignmentBrief[]> => {
+export const getHomeworkAssignmentsByIdsRaw = async (params: { assignmentIds: string[]; limit?: number }): Promise<HomeworkAssignmentBrief[]> => {
     if (params.assignmentIds.length === 0) return []
     const limit = typeof params.limit === "number" && params.limit > 0 ? params.limit : 50
     const rows = await db.query.homeworkAssignments.findMany({
@@ -175,7 +182,12 @@ export const getHomeworkAssignmentsByIds = cache(
     })
     return rows
   }
-)
+
+export const getHomeworkAssignmentsByIds = cacheFn(getHomeworkAssignmentsByIdsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentsByIds"],
+})
 
 /**
  * Returns max score per assignment (sum of question scores).
@@ -186,8 +198,7 @@ export { getAssignmentMaxScoreById } from "./data-access"
 /**
  * Returns target counts per assignment for the given students.
  */
-export const getAssignmentTargetCounts = cache(
-  async (params: { assignmentIds: string[]; studentIds: string[] }): Promise<Map<string, number>> => {
+export const getAssignmentTargetCountsRaw = async (params: { assignmentIds: string[]; studentIds: string[] }): Promise<Map<string, number>> => {
     if (params.assignmentIds.length === 0 || params.studentIds.length === 0) return new Map()
     const rows = await db
       .select({
@@ -206,15 +217,19 @@ export const getAssignmentTargetCounts = cache(
     for (const r of rows) map.set(r.assignmentId, Number(r.targetCount ?? 0))
     return map
   }
-)
+
+export const getAssignmentTargetCounts = cacheFn(getAssignmentTargetCountsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getAssignmentTargetCounts"],
+})
 
 /**
  * Returns homework submissions for given assignments and students,
  * ordered by createdAt desc so callers can pick the latest per
  * (assignmentId, studentId) pair.
  */
-export const getHomeworkSubmissionsForStudents = cache(
-  async (params: { assignmentIds: string[]; studentIds: string[] }): Promise<HomeworkSubmissionRecord[]> => {
+export const getHomeworkSubmissionsForStudentsRaw = async (params: { assignmentIds: string[]; studentIds: string[] }): Promise<HomeworkSubmissionRecord[]> => {
     if (params.assignmentIds.length === 0 || params.studentIds.length === 0) return []
     const rows = await db.query.homeworkSubmissions.findMany({
       where: and(
@@ -233,7 +248,12 @@ export const getHomeworkSubmissionsForStudents = cache(
     })
     return rows
   }
-)
+
+export const getHomeworkSubmissionsForStudents = cacheFn(getHomeworkSubmissionsForStudentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkSubmissionsForStudents"],
+})
 
 /**
  * Returns published homework assignments joined with subject info (via source exam).
@@ -241,8 +261,7 @@ export const getHomeworkSubmissionsForStudents = cache(
  *
  * P1-1 修复：不再 JOIN exams/subjects 表，改用跨模块 data-access。
  */
-export const getPublishedHomeworkAssignmentsWithSubject = cache(
-  async (params: { assignmentIds: string[] }): Promise<HomeworkAssignmentSubjectRow[]> => {
+export const getPublishedHomeworkAssignmentsWithSubjectRaw = async (params: { assignmentIds: string[] }): Promise<HomeworkAssignmentSubjectRow[]> => {
     if (params.assignmentIds.length === 0) return []
 
     // Step 1: 查 published homeworkAssignments（含 sourceExamId）
@@ -287,15 +306,19 @@ export const getPublishedHomeworkAssignmentsWithSubject = cache(
       }
     })
   }
-)
+
+export const getPublishedHomeworkAssignmentsWithSubject = cacheFn(getPublishedHomeworkAssignmentsWithSubjectRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getPublishedHomeworkAssignmentsWithSubject"],
+})
 
 /**
  * Returns homework submissions for the given assignments,
  * ordered by createdAt desc so callers can pick the latest per
  * (assignmentId, studentId) pair.
  */
-export const getHomeworkSubmissionsForAssignments = cache(
-  async (assignmentIds: string[]): Promise<HomeworkSubmissionScoreRecord[]> => {
+export const getHomeworkSubmissionsForAssignmentsRaw = async (assignmentIds: string[]): Promise<HomeworkSubmissionScoreRecord[]> => {
     if (assignmentIds.length === 0) return []
     const rows = await db
       .select({
@@ -309,4 +332,9 @@ export const getHomeworkSubmissionsForAssignments = cache(
       .orderBy(desc(homeworkSubmissions.createdAt))
     return rows
   }
-)
+
+export const getHomeworkSubmissionsForAssignments = cacheFn(getHomeworkSubmissionsForAssignmentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkSubmissionsForAssignments"],
+})
diff --git a/src/modules/homework/data-access-error-collection.ts b/src/modules/homework/data-access-error-collection.ts
index b3f6f66..e051931 100644
--- a/src/modules/homework/data-access-error-collection.ts
+++ b/src/modules/homework/data-access-error-collection.ts
@@ -9,6 +9,7 @@ import {
   homeworkAssignments,
   homeworkSubmissions,
 } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 import { getExamSubjectIdMap } from "@/modules/exams/data-access"
 
 /**
@@ -44,7 +45,7 @@ export type HomeworkSubmissionDataForErrorCollection = {
  * @param submissionId 作业提交 ID
  * @returns 提交数据；若提交不存在则返回 null
  */
-export async function getHomeworkSubmissionDataForErrorCollection(
+export async function getHomeworkSubmissionDataForErrorCollectionRaw(
   submissionId: string,
 ): Promise<HomeworkSubmissionDataForErrorCollection | null> {
   const submission = await db.query.homeworkSubmissions.findFirst({
@@ -102,6 +103,12 @@ export async function getHomeworkSubmissionDataForErrorCollection(
   }
 }
 
+export const getHomeworkSubmissionDataForErrorCollection = cacheFn(getHomeworkSubmissionDataForErrorCollectionRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "submissions", "for-error-collection"],
+})
+
 /**
  * 跨模块接口：获取作业提交的答案数据（供 diagnostic 模块更新掌握度使用）。
  *
@@ -111,7 +118,7 @@ export async function getHomeworkSubmissionDataForErrorCollection(
  * @param submissionId 作业提交 ID
  * @returns `{ studentId, answers: Array<{ questionId, score }> }`；若提交不存在则返回 null
  */
-export async function getHomeworkSubmissionWithAnswersForMastery(
+export async function getHomeworkSubmissionWithAnswersForMasteryRaw(
   submissionId: string,
 ): Promise<{ studentId: string; answers: Array<{ questionId: string; score: number | null }> } | null> {
   const submission = await db.query.homeworkSubmissions.findFirst({
@@ -134,3 +141,9 @@ export async function getHomeworkSubmissionWithAnswersForMastery(
     answers,
   }
 }
+
+export const getHomeworkSubmissionWithAnswersForMastery = cacheFn(getHomeworkSubmissionWithAnswersForMasteryRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "submissions", "for-mastery"],
+})
diff --git a/src/modules/homework/data-access-exam-cross.ts b/src/modules/homework/data-access-exam-cross.ts
index 1a4f400..85c9ed7 100644
--- a/src/modules/homework/data-access-exam-cross.ts
+++ b/src/modules/homework/data-access-exam-cross.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, count, eq, inArray, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -15,7 +15,7 @@ import {
  *
  * 供 exams 模块的考试分析仪表盘调用，获取该考试派生的所有作业及其提交统计。
  */
-export const getHomeworkAssignmentsByExamId = cache(async (examId: string): Promise<Array<{
+export const getHomeworkAssignmentsByExamIdRaw = async (examId: string): Promise<Array<{
   id: string
   title: string
   status: string | null
@@ -74,6 +74,12 @@ export const getHomeworkAssignmentsByExamId = cache(async (examId: string): Prom
     gradedCount: gradedMap.get(a.id) ?? 0,
     dueAt: a.dueAt ? a.dueAt.toISOString() : null,
   }))
+}
+
+export const getHomeworkAssignmentsByExamId = cacheFn(getHomeworkAssignmentsByExamIdRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentsByExamId"],
 })
 
 /**
@@ -81,7 +87,7 @@ export const getHomeworkAssignmentsByExamId = cache(async (examId: string): Prom
  *
  * 供 exams 模块的考试分析仪表盘调用，获取学生姓名、分数、答案内容用于统计分析。
  */
-export const getGradedSubmissionsByExamId = cache(async (examId: string): Promise<Array<{
+export const getGradedSubmissionsByExamIdRaw = async (examId: string): Promise<Array<{
   submissionId: string
   assignmentId: string
   studentId: string
@@ -130,4 +136,10 @@ export const getGradedSubmissionsByExamId = cache(async (examId: string): Promis
       answerContent: a.answerContent,
     })),
   }))
+}
+
+export const getGradedSubmissionsByExamId = cacheFn(getGradedSubmissionsByExamIdRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getGradedSubmissionsByExamId"],
 })
diff --git a/src/modules/homework/data-access-scans.ts b/src/modules/homework/data-access-scans.ts
index 47cd96b..ce527ac 100644
--- a/src/modules/homework/data-access-scans.ts
+++ b/src/modules/homework/data-access-scans.ts
@@ -3,6 +3,7 @@ import "server-only"
 import { db } from "@/shared/db"
 import { fileAttachments } from "@/shared/db/schema"
 import { and, asc, eq } from "drizzle-orm"
+import { cacheFn } from "@/shared/lib/cache"
 
 import type { ScanAttachment } from "./types"
 
@@ -19,7 +20,7 @@ import type { ScanAttachment } from "./types"
  *
  * @returns `ScanAttachment[]` —— `page` 字段为按顺序生成的页码（从 1 开始）。
  */
-export async function getScansBySubmissionId(
+export async function getScansBySubmissionIdRaw(
   submissionId: string
 ): Promise<ScanAttachment[]> {
   const rows = await db
@@ -47,3 +48,9 @@ export async function getScansBySubmissionId(
     page: idx + 1,
   }))
 }
+
+export const getScansBySubmissionId = cacheFn(getScansBySubmissionIdRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "scans", "by-submission"],
+})
diff --git a/src/modules/homework/data-access-student.ts b/src/modules/homework/data-access-student.ts
index 802dc25..028375a 100644
--- a/src/modules/homework/data-access-student.ts
+++ b/src/modules/homework/data-access-student.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, desc, eq, inArray, isNull, lte, or } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -39,7 +39,7 @@ const toStudentProgressStatus = (v: string | null | undefined): StudentHomeworkP
  *
  * 查找学生最近一次已提交/已批改的 submission，返回完整详情含答案。
  */
-export const getStudentSubmissionResult = cache(async (
+export const getStudentSubmissionResultRaw = async (
   assignmentId: string,
   studentId: string
 ): Promise<HomeworkSubmissionDetails | null> => {
@@ -56,6 +56,12 @@ export const getStudentSubmissionResult = cache(async (
   if (!latestSubmission) return null
 
   return getHomeworkSubmissionDetails(latestSubmission.id)
+}
+
+export const getStudentSubmissionResult = cacheFn(getStudentSubmissionResultRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getStudentSubmissionResult"],
 })
 
 /**
@@ -64,7 +70,7 @@ export const getStudentSubmissionResult = cache(async (
  * 查找学生所有已批改的、关联到考试的作业提交，
  * 返回考试标题、科目、分数、提交时间等。
  */
-export const getStudentExamResults = cache(async (studentId: string): Promise<Array<{
+export const getStudentExamResultsRaw = async (studentId: string): Promise<Array<{
   submissionId: string
   examId: string
   examTitle: string
@@ -115,9 +121,15 @@ export const getStudentExamResults = cache(async (studentId: string): Promise<Ar
     submittedAt: s.submittedAt ? s.submittedAt.toISOString() : null,
     status: s.status ?? "graded",
   }))
+}
+
+export const getStudentExamResults = cacheFn(getStudentExamResultsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getStudentExamResults"],
 })
 
-export const getStudentHomeworkAssignments = cache(async (studentId: string): Promise<StudentHomeworkAssignmentListItem[]> => {
+export const getStudentHomeworkAssignmentsRaw = async (studentId: string): Promise<StudentHomeworkAssignmentListItem[]> => {
   const now = new Date()
 
   const targetAssignmentIds = db
@@ -198,9 +210,15 @@ export const getStudentHomeworkAssignments = cache(async (studentId: string): Pr
     }
     return item
   })
+}
+
+export const getStudentHomeworkAssignments = cacheFn(getStudentHomeworkAssignmentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getStudentHomeworkAssignments"],
 })
 
-export const getStudentHomeworkTakeData = cache(async (assignmentId: string, studentId: string): Promise<StudentHomeworkTakeData | null> => {
+export const getStudentHomeworkTakeDataRaw = async (assignmentId: string, studentId: string): Promise<StudentHomeworkTakeData | null> => {
   const target = await db.query.homeworkAssignmentTargets.findFirst({
     where: and(eq(homeworkAssignmentTargets.assignmentId, assignmentId), eq(homeworkAssignmentTargets.studentId, studentId)),
   })
@@ -321,4 +339,10 @@ export const getStudentHomeworkTakeData = cache(async (assignmentId: string, stu
       }
     }),
   }
+}
+
+export const getStudentHomeworkTakeData = cacheFn(getStudentHomeworkTakeDataRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getStudentHomeworkTakeData"],
 })
diff --git a/src/modules/homework/data-access-write.ts b/src/modules/homework/data-access-write.ts
index 86e3f0d..38742e7 100644
--- a/src/modules/homework/data-access-write.ts
+++ b/src/modules/homework/data-access-write.ts
@@ -1,7 +1,7 @@
 import "server-only"
 
 import { createId } from "@paralleldrive/cuid2"
-import { and, count, eq } from "drizzle-orm"
+import { and, count, eq, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import {
@@ -357,26 +357,47 @@ export const gradeHomeworkAnswers = async (
   submissionId: string,
   answers: Array<{ id: string; score: number; feedback: string | null }>
 ): Promise<void> => {
+  if (answers.length === 0) {
+    // 仍要更新 submission 状态为 graded
+    await db
+      .update(homeworkSubmissions)
+      .set({ score: 0, status: "graded", updatedAt: new Date() })
+      .where(eq(homeworkSubmissions.id, submissionId))
+    return
+  }
+
+  const totalScore = answers.reduce((sum, a) => sum + a.score, 0)
+  const now = new Date()
+
   await db.transaction(async (tx) => {
-    let totalScore = 0
-    for (const ans of answers) {
-      // 关键安全约束：WHERE 子句同时匹配 answer.id 和 submissionId，
-      // 防止恶意客户端篡改 answer ID 批改其他 submission 的答案
-      await tx
-        .update(homeworkAnswers)
-        .set({ score: ans.score, feedback: ans.feedback, updatedAt: new Date() })
-        .where(
-          and(
-            eq(homeworkAnswers.id, ans.id),
-            eq(homeworkAnswers.submissionId, submissionId)
-          )
-        )
-      totalScore += ans.score
-    }
+    // 性能优化:用单次 UPDATE + CASE WHEN 替代 N 次串行 UPDATE
+    // 关键安全约束:WHERE 子句同时匹配 answer.id IN (...) 和 submission_id,
+    // 防止恶意客户端篡改 answer ID 批改其他 submission 的答案
+    const scoreCases = sql.join(
+      answers.map((a) => sql`WHEN ${a.id} THEN ${a.score}`),
+      sql` `,
+    )
+    const feedbackCases = sql.join(
+      answers.map((a) => sql`WHEN ${a.id} THEN ${a.feedback}`),
+      sql` `,
+    )
+    const answerIdList = sql.join(
+      answers.map((a) => sql`${a.id}`),
+      sql`, `,
+    )
+
+    await tx.execute(
+      sql`UPDATE homework_answers
+          SET
+            score = CASE id ${scoreCases} ELSE score END,
+            feedback = CASE id ${feedbackCases} ELSE feedback END,
+            updated_at = ${now}
+          WHERE id IN (${answerIdList}) AND submission_id = ${submissionId}`,
+    )
 
     await tx
       .update(homeworkSubmissions)
-      .set({ score: totalScore, status: "graded", updatedAt: new Date() })
+      .set({ score: totalScore, status: "graded", updatedAt: now })
       .where(eq(homeworkSubmissions.id, submissionId))
   })
 }
diff --git a/src/modules/homework/data-access.ts b/src/modules/homework/data-access.ts
index c0a976d..3583359 100644
--- a/src/modules/homework/data-access.ts
+++ b/src/modules/homework/data-access.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, asc, count, desc, eq, gt, inArray, lt, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -65,7 +65,7 @@ export const getAssignmentMaxScoreById = async (assignmentIds: string[]): Promis
   return map
 }
 
-export const getHomeworkAssignments = cache(async (params?: { creatorId?: string; ids?: string[]; classId?: string; scope?: DataScope }) => {
+export const getHomeworkAssignmentsRaw = async (params?: { creatorId?: string; ids?: string[]; classId?: string; scope?: DataScope }): Promise<HomeworkAssignmentListItem[]> => {
   const conditions = []
 
   if (params?.creatorId) conditions.push(eq(homeworkAssignments.creatorId, params.creatorId))
@@ -238,9 +238,15 @@ export const getHomeworkAssignments = cache(async (params?: { creatorId?: string
     }
     return item
   })
+}
+
+export const getHomeworkAssignments = cacheFn(getHomeworkAssignmentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignments"],
 })
 
-export const getHomeworkAssignmentReviewList = cache(async (params: { creatorId: string; scope?: DataScope }) => {
+export const getHomeworkAssignmentReviewListRaw = async (params: { creatorId: string; scope?: DataScope }): Promise<HomeworkAssignmentReviewListItem[]> => {
   const creatorId = params.creatorId.trim()
   if (!creatorId) return []
 
@@ -333,9 +339,15 @@ export const getHomeworkAssignmentReviewList = cache(async (params: { creatorId:
     }
     return item
   })
+}
+
+export const getHomeworkAssignmentReviewList = cacheFn(getHomeworkAssignmentReviewListRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentReviewList"],
 })
 
-export const getHomeworkSubmissions = cache(async (params?: { assignmentId?: string; classId?: string; creatorId?: string; scope?: DataScope }) => {
+export const getHomeworkSubmissionsRaw = async (params?: { assignmentId?: string; classId?: string; creatorId?: string; scope?: DataScope }): Promise<HomeworkSubmissionListItem[]> => {
   const conditions = []
   if (params?.assignmentId) conditions.push(eq(homeworkSubmissions.assignmentId, params.assignmentId))
   if (params?.classId) {
@@ -407,9 +419,15 @@ export const getHomeworkSubmissions = cache(async (params?: { assignmentId?: str
     }
     return item
   })
+}
+
+export const getHomeworkSubmissions = cacheFn(getHomeworkSubmissionsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkSubmissions"],
 })
 
-export const getHomeworkAssignmentById = cache(async (id: string, scope?: DataScope) => {
+export const getHomeworkAssignmentByIdRaw = async (id: string, scope?: DataScope) => {
   const assignment = await db.query.homeworkAssignments.findFirst({
     where: eq(homeworkAssignments.id, id),
     with: {
@@ -489,9 +507,15 @@ export const getHomeworkAssignmentById = cache(async (id: string, scope?: DataSc
     createdAt: assignment.createdAt.toISOString(),
     updatedAt: assignment.updatedAt.toISOString(),
   }
+}
+
+export const getHomeworkAssignmentById = cacheFn(getHomeworkAssignmentByIdRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentById"],
 })
 
-export const getHomeworkSubmissionDetails = cache(async (submissionId: string): Promise<HomeworkSubmissionDetails | null> => {
+export const getHomeworkSubmissionDetailsRaw = async (submissionId: string): Promise<HomeworkSubmissionDetails | null> => {
   const submission = await db.query.homeworkSubmissions.findFirst({
     where: eq(homeworkSubmissions.id, submissionId),
     with: {
@@ -573,6 +597,12 @@ export const getHomeworkSubmissionDetails = cache(async (submissionId: string):
     prevSubmissionId,
     nextSubmissionId,
   }
+}
+
+export const getHomeworkSubmissionDetails = cacheFn(getHomeworkSubmissionDetailsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkSubmissionDetails"],
 })
 
 /**
@@ -587,7 +617,7 @@ export const getHomeworkSubmissionDetails = cache(async (submissionId: string):
  * 权限说明：调用方必须在外层通过 `requirePermission()` 校验，
  * 并通过 `scope` 参数传入数据范围（教师仅可见自己班级的学生提交）。
  */
-export const getExcellentSubmissions = cache(async (params: {
+export const getExcellentSubmissionsRaw = async (params: {
   assignmentId: string
   minPercentage?: number
   limit?: number
@@ -663,6 +693,12 @@ export const getExcellentSubmissions = cache(async (params: {
   return Array.from(bestByStudent.values())
     .sort((a, b) => b.percentage - a.percentage)
     .slice(0, limit)
+}
+
+export const getExcellentSubmissions = cacheFn(getExcellentSubmissionsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getExcellentSubmissions"],
 })
 
 /**
@@ -675,7 +711,7 @@ export const getExcellentSubmissions = cache(async (params: {
  *
  * 权限：调用方必须通过 `requirePermission()` 校验。
  */
-export const getUnsubmittedStudents = cache(async (params: {
+export const getUnsubmittedStudentsRaw = async (params: {
   assignmentId: string
   scope?: DataScope
 }): Promise<Array<{ studentId: string; studentName: string }>> => {
@@ -709,6 +745,12 @@ export const getUnsubmittedStudents = cache(async (params: {
     }))
 
   return unsubmitted
+}
+
+export const getUnsubmittedStudents = cacheFn(getUnsubmittedStudentsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getUnsubmittedStudents"],
 })
 
 
diff --git a/src/modules/homework/stats-service.ts b/src/modules/homework/stats-service.ts
index 51a9d10..dbce906 100644
--- a/src/modules/homework/stats-service.ts
+++ b/src/modules/homework/stats-service.ts
@@ -1,6 +1,6 @@
 import "server-only"
 
-import { cache } from "react"
+import { cacheFn } from "@/shared/lib/cache"
 import { and, count, desc, eq, inArray, or, sql } from "drizzle-orm"
 
 import { db } from "@/shared/db"
@@ -41,7 +41,7 @@ const toHomeworkAssignmentStatus = (v: string | null | undefined): HomeworkAssig
  * Get grade trend data for a teacher's recent assignments.
  * Used by the teacher dashboard to visualize class performance over time.
  */
-export const getTeacherGradeTrends = cache(async (teacherId: string, limit: number = 5): Promise<TeacherGradeTrendItem[]> => {
+export const getTeacherGradeTrendsRaw = async (teacherId: string, limit: number = 5): Promise<TeacherGradeTrendItem[]> => {
   const recentAssignments = await db.query.homeworkAssignments.findMany({
     where: and(
       eq(homeworkAssignments.creatorId, teacherId),
@@ -99,14 +99,19 @@ export const getTeacherGradeTrends = cache(async (teacherId: string, limit: numb
       createdAt: a.createdAt.toISOString(),
     }
   }).reverse() // Reverse to show trend from left (older) to right (newer)
+}
+
+export const getTeacherGradeTrends = cacheFn(getTeacherGradeTrendsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getTeacherGradeTrends"],
 })
 
 /**
  * Get detailed analytics for a specific homework assignment.
  * Includes per-question error rates and wrong answer samples.
  */
-export const getHomeworkAssignmentAnalytics = cache(
-  async (assignmentId: string): Promise<HomeworkAssignmentAnalytics | null> => {
+export const getHomeworkAssignmentAnalyticsRaw = async (assignmentId: string): Promise<HomeworkAssignmentAnalytics | null> => {
     const assignment = await db.query.homeworkAssignments.findFirst({
       where: eq(homeworkAssignments.id, assignmentId),
       with: {
@@ -247,14 +252,19 @@ export const getHomeworkAssignmentAnalytics = cache(
 
     return analytics
   }
-)
+
+export const getHomeworkAssignmentAnalytics = cacheFn(getHomeworkAssignmentAnalyticsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkAssignmentAnalytics"],
+})
 
 /**
  * Get student dashboard grade data including trend, recent scores, and class ranking.
  * The ranking calculation queries all classmates' graded submissions and computes
  * relative position by total percentage score.
  */
-export const getStudentDashboardGrades = cache(async (studentId: string): Promise<StudentDashboardGradeProps> => {
+export const getStudentDashboardGradesRaw = async (studentId: string): Promise<StudentDashboardGradeProps> => {
   const id = studentId.trim()
   if (!id) return { trend: [], recent: [], ranking: null }
 
@@ -393,6 +403,12 @@ export const getStudentDashboardGrades = cache(async (studentId: string): Promis
   }
 
   return { trend, recent, ranking }
+}
+
+export const getStudentDashboardGrades = cacheFn(getStudentDashboardGradesRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getStudentDashboardGrades"],
 })
 
 export type HomeworkDashboardStats = {
@@ -402,7 +418,7 @@ export type HomeworkDashboardStats = {
   homeworkSubmissionToGradeCount: number
 }
 
-export const getHomeworkDashboardStats = cache(async (scope?: DataScope): Promise<HomeworkDashboardStats> => {
+export const getHomeworkDashboardStatsRaw = async (scope?: DataScope): Promise<HomeworkDashboardStats> => {
   const homeworkConditions = []
   const submissionConditions = []
 
@@ -464,4 +480,10 @@ export const getHomeworkDashboardStats = cache(async (scope?: DataScope): Promis
     homeworkSubmissionCount: Number(homeworkSubmissionCountRow[0]?.value ?? 0),
     homeworkSubmissionToGradeCount: Number(homeworkSubmissionToGradeCountRow[0]?.value ?? 0),
   }
+}
+
+export const getHomeworkDashboardStats = cacheFn(getHomeworkDashboardStatsRaw, {
+  tags: ["homework"],
+  ttl: 300,
+  keyParts: ["homework", "getHomeworkDashboardStats"],
 })
diff --git a/src/modules/invitation-codes/data-access.ts b/src/modules/invitation-codes/data-access.ts
index 025a192..1b3ab16 100644
--- a/src/modules/invitation-codes/data-access.ts
+++ b/src/modules/invitation-codes/data-access.ts
@@ -4,6 +4,7 @@ import { and, desc, eq, isNull, lte, or } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import { invitationCodes } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 import type {
   ConsumeInvitationCodeInput,
@@ -98,7 +99,7 @@ export async function generateInvitationCodes(
  * @param limit 最多返回的记录数（默认 100）
  * @param includeUsed 是否包含已使用的邀请码（默认 true）
  */
-export async function listInvitationCodes(
+export async function listInvitationCodesRaw(
   limit = 100,
   includeUsed = true,
 ): Promise<InvitationCodeRecord[]> {
@@ -120,6 +121,12 @@ export async function listInvitationCodes(
   return rows.map(toRecord)
 }
 
+export const listInvitationCodes = cacheFn(listInvitationCodesRaw, {
+  tags: ["invitation-codes"],
+  ttl: 300,
+  keyParts: ["invitation-codes", "list"],
+})
+
 /**
  * 校验邀请码是否可用（audit-P2-3 新增）
  *
@@ -131,7 +138,7 @@ export async function listInvitationCodes(
  *
  * 返回结果中 `code` 字段为脱敏数据（不含 code 明文），用于注册流程。
  */
-export async function validateInvitationCode(
+export async function validateInvitationCodeRaw(
   code: string,
   email: string,
 ): Promise<ValidateInvitationCodeResult> {
@@ -164,6 +171,12 @@ export async function validateInvitationCode(
   return { valid: true, code: codeWithoutValue }
 }
 
+export const validateInvitationCode = cacheFn(validateInvitationCodeRaw, {
+  tags: ["invitation-codes"],
+  ttl: 60,
+  keyParts: ["invitation-codes", "validate"],
+})
+
 /**
  * 标记邀请码为已使用（audit-P2-3 新增）
  *
diff --git a/src/modules/layout/components/sidebar-provider.tsx b/src/modules/layout/components/sidebar-provider.tsx
index eefe41c..1d6b403 100644
--- a/src/modules/layout/components/sidebar-provider.tsx
+++ b/src/modules/layout/components/sidebar-provider.tsx
@@ -21,7 +21,7 @@ const SidebarContext = React.createContext<SidebarContextType | undefined>(
   undefined
 )
 
-export function useSidebar() {
+export function useSidebar(): SidebarContextType {
   const context = React.useContext(SidebarContext)
   if (!context) {
     throw new Error("useSidebar must be used within a SidebarProvider")
@@ -34,36 +34,62 @@ interface SidebarProviderProps {
   sidebar: React.ReactNode
 }
 
+/** resize 事件防抖时长（毫秒），避免拖拽窗口时高频触发状态更新 */
+const RESIZE_DEBOUNCE_MS = 200
+
 export function SidebarProvider({ children, sidebar }: SidebarProviderProps) {
   const [expanded, setExpanded] = React.useState(true)
   const [isMobile, setIsMobile] = React.useState(false)
   const [openMobile, setOpenMobile] = React.useState(false)
 
   React.useEffect(() => {
-    const checkMobile = () => {
+    const checkMobile = (): void => {
       const mobile = window.innerWidth < 768
       setIsMobile(mobile)
       if (mobile) {
         setExpanded(true)
       }
     }
+    // 首次立即检测一次，避免初始状态闪烁
     checkMobile()
-    window.addEventListener("resize", checkMobile)
-    return () => window.removeEventListener("resize", checkMobile)
+
+    // 防抖：拖拽窗口时只在停止后触发一次，避免高频 setIsMobile
+    let timer: ReturnType<typeof setTimeout> | null = null
+    const onResize = (): void => {
+      if (timer) {
+        clearTimeout(timer)
+      }
+      timer = setTimeout(checkMobile, RESIZE_DEBOUNCE_MS)
+    }
+    window.addEventListener("resize", onResize)
+    return () => {
+      window.removeEventListener("resize", onResize)
+      if (timer) {
+        clearTimeout(timer)
+      }
+    }
   }, [])
 
-  const toggleSidebar = () => {
+  // isMobile 变化频率低（仅在 resize 跨越 768px 断点时变化），
+  // 将其纳入 useCallback 依赖即可保证 toggleSidebar 行为正确，
+  // 同时不影响 expanded/openMobile 切换时 toggleSidebar 的引用稳定性
+  const toggleSidebar = React.useCallback(() => {
     if (isMobile) {
-      setOpenMobile(!openMobile)
+      setOpenMobile((prev) => !prev)
     } else {
-      setExpanded(!expanded)
+      setExpanded((prev) => !prev)
     }
-  }
+  }, [isMobile])
+
+  // context value 用 useMemo 包装，避免每次渲染都创建新对象，
+  // 减少 SidebarContext 消费者无意义的重渲染
+  const value = React.useMemo<SidebarContextType>(
+    () => ({ expanded, setExpanded, isMobile, toggleSidebar }),
+    [expanded, isMobile, toggleSidebar]
+  )
 
   return (
-    <SidebarContext.Provider
-      value={{ expanded, setExpanded, isMobile, toggleSidebar }}
-    >
+    <SidebarContext.Provider value={value}>
       <div className="flex h-screen overflow-hidden w-full flex-col md:flex-row bg-background">
         {/* Mobile Trigger & Sheet */}
         {isMobile && (
diff --git a/src/modules/leave-requests/data-access.ts b/src/modules/leave-requests/data-access.ts
index 04d0e30..edcb09e 100644
--- a/src/modules/leave-requests/data-access.ts
+++ b/src/modules/leave-requests/data-access.ts
@@ -4,6 +4,7 @@ import { and, asc, desc, eq, inArray, sql, type SQL } from "drizzle-orm"
 import { createId } from "@paralleldrive/cuid2"
 
 import { db } from "@/shared/db"
+import { cacheFn } from "@/shared/lib/cache"
 import { leaveRequests } from "@/shared/db/schema"
 import { getClassNamesByIds } from "@/modules/classes/data-access"
 import { getUserNamesByIds } from "@/modules/users/data-access"
@@ -111,7 +112,7 @@ async function enrichListItems(
 /**
  * 分页查询请假申请列表（按 dataScope 过滤）。
  */
-export async function getLeaveRequests(
+export async function getLeaveRequestsRaw(
   params: LeaveQueryParams & { scope: DataScope; currentUserId?: string },
 ): Promise<PaginatedLeaveResult> {
   const page = Math.max(1, params.page ?? 1)
@@ -158,7 +159,13 @@ export async function getLeaveRequests(
 /**
  * 获取单条请假申请详情（按 dataScope 校验访问权限）。
  */
-export async function getLeaveRequest(
+export const getLeaveRequests = cacheFn(getLeaveRequestsRaw, {
+  tags: ["leave-requests"],
+  ttl: 300,
+  keyParts: ["leave-requests", "list"],
+})
+
+export async function getLeaveRequestRaw(
   id: string,
   scope: DataScope,
   currentUserId?: string,
@@ -185,6 +192,12 @@ export async function getLeaveRequest(
  * 校验同一学生在日期范围内是否已有未结束的请假（pending/approved）。
  * 用于提交前校验，避免重复请假。
  */
+export const getLeaveRequest = cacheFn(getLeaveRequestRaw, {
+  tags: ["leave-requests"],
+  ttl: 600,
+  keyParts: ["leave-requests", "detail"],
+})
+
 export async function hasOverlappingLeave(
   studentId: string,
   startDate: string,
@@ -301,7 +314,7 @@ export async function markAttendanceSynced(id: string): Promise<void> {
 /**
  * 获取指定状态下的请假申请（用于审批通过后的考勤同步）。
  */
-export async function getLeaveRequestsByIds(
+export async function getLeaveRequestsByIdsRaw(
   ids: string[],
 ): Promise<LeaveRequest[]> {
   if (ids.length === 0) return []
@@ -316,7 +329,13 @@ export async function getLeaveRequestsByIds(
 /**
  * 教师审批待办：按 classIds 统计 pending 数量。
  */
-export async function countPendingForClasses(
+export const getLeaveRequestsByIds = cacheFn(getLeaveRequestsByIdsRaw, {
+  tags: ["leave-requests"],
+  ttl: 300,
+  keyParts: ["leave-requests", "by-ids"],
+})
+
+export async function countPendingForClassesRaw(
   classIds: string[],
 ): Promise<number> {
   if (classIds.length === 0) return 0
@@ -331,3 +350,9 @@ export async function countPendingForClasses(
     )
   return Number(row?.count ?? 0)
 }
+
+export const countPendingForClasses = cacheFn(countPendingForClassesRaw, {
+  tags: ["leave-requests"],
+  ttl: 60,
+  keyParts: ["leave-requests", "pending-count"],
+})
diff --git a/src/modules/lesson-preparation/components/blocks/exercise-block.tsx b/src/modules/lesson-preparation/components/blocks/exercise-block.tsx
index b4a19ad..61303f9 100644
--- a/src/modules/lesson-preparation/components/blocks/exercise-block.tsx
+++ b/src/modules/lesson-preparation/components/blocks/exercise-block.tsx
@@ -28,7 +28,9 @@ interface Props {
 export function ExerciseBlock({ blockId, data, classes, textbookId, chapterId }: Props) {
   const t = useTranslations("lessonPreparation");
   const router = useRouter();
-  const { updateNode, planId } = useLessonPlanEditor();
+  // Phase 4.2: 拆分为细粒度 selector（updateNode 与 planId 为基本类型/稳定函数）
+  const updateNode = useLessonPlanEditor((s) => s.updateNode);
+  const planId = useLessonPlanEditor((s) => s.planId);
   const [showBank, setShowBank] = useState(false);
   const [showInline, setShowInline] = useState(false);
   const [showPublish, setShowPublish] = useState(false);
diff --git a/src/modules/lesson-preparation/components/blocks/rich-text-block-inner.tsx b/src/modules/lesson-preparation/components/blocks/rich-text-block-inner.tsx
new file mode 100644
index 0000000..1427e5a
--- /dev/null
+++ b/src/modules/lesson-preparation/components/blocks/rich-text-block-inner.tsx
@@ -0,0 +1,214 @@
+"use client";
+
+import { useEditor, EditorContent } from "@tiptap/react";
+import StarterKit from "@tiptap/starter-kit";
+import Placeholder from "@tiptap/extension-placeholder";
+import Image from "@tiptap/extension-image";
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+import type { RichTextBlockData, RichTextAttachment } from "../../types";
+import { KnowledgePointPicker } from "../knowledge-point-picker";
+import { AttachmentPicker } from "../attachment-picker";
+import { LessonPlanErrorBoundary } from "../lesson-plan-error-boundary";
+import { Tag, Paperclip, Trash2 } from "lucide-react";
+
+export interface RichTextBlockProps {
+  data: RichTextBlockData;
+  hint?: string;
+  textbookId?: string;
+  chapterId?: string;
+  /** V5-5：当前课案 ID（用于附件库 picker） */
+  planId?: string;
+  /** V5-5：当前 block ID（用于附件关联） */
+  blockId?: string;
+  onUpdate: (data: RichTextBlockData) => void;
+}
+
+export function RichTextBlockInner({
+  data,
+  hint,
+  textbookId,
+  chapterId,
+  planId,
+  blockId,
+  onUpdate,
+}: RichTextBlockProps): React.ReactElement {
+  const t = useTranslations("lessonPreparation");
+  const editor = useEditor({
+    extensions: [
+      StarterKit,
+      Placeholder.configure({ placeholder: hint ?? t("richText.placeholder") }),
+      // V5-5：集成 Tiptap Image 扩展，支持图片直接嵌入富文本
+      Image.configure({
+        inline: false,
+        allowBase64: false,
+        HTMLAttributes: {
+          class: "rich-text-image max-w-full h-auto rounded",
+        },
+      }),
+    ],
+    content: data.html,
+    immediatelyRender: false,
+    onUpdate: ({ editor }) => {
+      onUpdate({ ...data, html: editor.getHTML() });
+    },
+    editorProps: {
+      attributes: {
+        // arbitrary-value: tiptap editor fixed size
+        class:
+          "prose prose-sm max-w-none focus:outline-none min-h-[60px] px-3 py-2",
+      },
+    },
+  });
+
+  // 外部 content 变化时同步（如版本回退）
+  useEffect(() => {
+    if (editor && !editor.isDestroyed && data.html !== editor.getHTML()) {
+      editor.commands.setContent(data.html);
+    }
+  }, [data.html, editor]);
+
+  const [showKpPicker, setShowKpPicker] = useState(false);
+  const [showAttachmentPicker, setShowAttachmentPicker] = useState(false); // V5-5
+
+  // V5-5：从素材库选择附件后，插入到富文本（图片用 Image 命令，其余追加到 attachments 列表）
+  function handleSelectAttachment(attachment: RichTextAttachment) {
+    const currentAttachments = data.attachments ?? [];
+    if (attachment.kind === "image" && editor) {
+      // 图片直接插入富文本
+      editor.commands.setImage({ src: attachment.url, alt: attachment.displayName });
+    }
+    // 所有附件（含图片）都记录到 attachments 列表，便于后续管理与素材库复用
+    onUpdate({
+      ...data,
+      attachments: [...currentAttachments, attachment],
+    });
+  }
+
+  // V5-5：移除已嵌入的附件
+  function handleRemoveAttachment(attachmentId: string) {
+    const currentAttachments = data.attachments ?? [];
+    onUpdate({
+      ...data,
+      attachments: currentAttachments.filter((a) => a.attachmentId !== attachmentId),
+    });
+  }
+
+  // V5-5：渲染附件区块
+  const attachments = data.attachments ?? [];
+
+  return (
+    <div>
+      <EditorContent editor={editor} />
+      <div className="flex items-center gap-2 mt-2 px-3 flex-wrap">
+        {data.knowledgePointIds.length > 0 && (
+          <span className="text-xs text-on-surface-variant">
+            {t("knowledgePoint.linked", { count: data.knowledgePointIds.length })}
+          </span>
+        )}
+        <button
+          onClick={() => setShowKpPicker(true)}
+          className="text-xs text-primary hover:underline inline-flex items-center gap-1"
+        >
+          <Tag className="w-3 h-3" />
+          {t("knowledgePoint.annotate")}
+        </button>
+        {/* V5-5：素材库入口 */}
+        {planId && (
+          <button
+            onClick={() => setShowAttachmentPicker(true)}
+            className="text-xs text-primary hover:underline inline-flex items-center gap-1"
+          >
+            <Paperclip className="w-3 h-3" />
+            {t("attachment.insert")}
+          </button>
+        )}
+      </div>
+
+      {/* V5-5：已嵌入附件列表（非图片附件在此展示，图片已在富文本中渲染） */}
+      {attachments.length > 0 && (
+        <div className="mt-2 px-3 space-y-1">
+          <div className="text-xs text-on-surface-variant">
+            {t("attachment.embeddedCount", { count: attachments.length })}
+          </div>
+          {attachments
+            .filter((a) => a.kind !== "image")
+            .map((a) => (
+              <div
+                key={a.attachmentId}
+                className="flex items-center gap-2 text-xs border border-outline-variant rounded p-1"
+              >
+                <a
+                  href={a.url}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="flex-1 hover:underline truncate"
+                >
+                  {a.displayName}
+                </a>
+                <span className="text-on-surface-variant">{a.kind}</span>
+                <button
+                  onClick={() => handleRemoveAttachment(a.attachmentId)}
+                  className="text-error hover:bg-error/10 p-0.5 rounded"
+                  aria-label={t("attachment.remove")}
+                >
+                  <Trash2 className="w-3 h-3" aria-hidden="true" />
+                </button>
+              </div>
+            ))}
+          {/* V5-5：图片附件单独展示缩略图（即使已在富文本中内联，此处也展示便于管理） */}
+          {attachments.some((a) => a.kind === "image") && (
+            <div className="flex flex-wrap gap-2">
+              {attachments
+                .filter((a) => a.kind === "image")
+                .map((a) => (
+                  <div
+                    key={a.attachmentId}
+                    className="relative group border border-outline-variant rounded"
+                  >
+                    {/* eslint-disable-next-line @next/next/no-img-element */}
+                    <img
+                      src={a.url}
+                      alt={a.displayName}
+                      className="w-16 h-16 object-cover rounded"
+                    />
+                    <button
+                      onClick={() => handleRemoveAttachment(a.attachmentId)}
+                      className="absolute top-0 right-0 bg-error text-on-error rounded-full p-0.5 opacity-0 group-hover:opacity-100 transition-opacity"
+                      aria-label={t("attachment.remove")}
+                    >
+                      <Trash2 className="w-2.5 h-2.5" aria-hidden="true" />
+                    </button>
+                  </div>
+                ))}
+            </div>
+          )}
+        </div>
+      )}
+
+      {showKpPicker && (
+        <LessonPlanErrorBoundary>
+          <KnowledgePointPicker
+            textbookId={textbookId}
+            chapterId={chapterId}
+            selectedIds={data.knowledgePointIds}
+            onChange={(ids) => onUpdate({ ...data, knowledgePointIds: ids })}
+            onClose={() => setShowKpPicker(false)}
+          />
+        </LessonPlanErrorBoundary>
+      )}
+      {/* V5-5：素材库 picker */}
+      {showAttachmentPicker && planId && (
+        <LessonPlanErrorBoundary>
+          <AttachmentPicker
+            planId={planId}
+            blockId={blockId}
+            selectedIds={attachments.map((a) => a.attachmentId)}
+            onSelect={handleSelectAttachment}
+            onClose={() => setShowAttachmentPicker(false)}
+          />
+        </LessonPlanErrorBoundary>
+      )}
+    </div>
+  );
+}
diff --git a/src/modules/lesson-preparation/components/blocks/text-study-block.tsx b/src/modules/lesson-preparation/components/blocks/text-study-block.tsx
index cd21b40..31ac49b 100644
--- a/src/modules/lesson-preparation/components/blocks/text-study-block.tsx
+++ b/src/modules/lesson-preparation/components/blocks/text-study-block.tsx
@@ -19,7 +19,7 @@ interface Props {
 
 export function TextStudyBlock({ blockId, data }: Props) {
   const t = useTranslations("lessonPreparation");
-  const { updateNode } = useLessonPlanEditor();
+  const updateNode = useLessonPlanEditor((s) => s.updateNode);
   const [selection, setSelection] = useState<{
     start: number;
     end: number;
diff --git a/src/modules/lesson-preparation/components/lesson-plan-editor.tsx b/src/modules/lesson-preparation/components/lesson-plan-editor.tsx
index 03baf56..ebb8cbc 100644
--- a/src/modules/lesson-preparation/components/lesson-plan-editor.tsx
+++ b/src/modules/lesson-preparation/components/lesson-plan-editor.tsx
@@ -33,7 +33,7 @@ import { ScheduleDialog } from "./schedule-dialog";
 import { ConsistencyCheckDialog } from "./consistency-check-dialog";
 import { AiFeedbackDialog } from "./ai-feedback-dialog";
 import { AiDifferentiationDialog } from "./ai-differentiation-dialog";
-import type { LessonPlan, LessonPlanDocument } from "../types";
+import type { LessonPlan } from "../types";
 
 interface Props {
   planId: string;
@@ -59,7 +59,18 @@ export function LessonPlanEditor({
   classes,
 }: Props) {
   const t = useTranslations("lessonPreparation");
-  const editor = useLessonPlanEditor();
+  // Phase 4.2: 拆分为细粒度 selector，避免任一字段变化都触发整体 re-render
+  const isDirty = useLessonPlanEditor((s) => s.isDirty);
+  const isOnline = useLessonPlanEditor((s) => s.isOnline);
+  const doc = useLessonPlanEditor((s) => s.doc);
+  const title = useLessonPlanEditor((s) => s.title);
+  const isSaving = useLessonPlanEditor((s) => s.isSaving);
+  const saveError = useLessonPlanEditor((s) => s.saveError);
+  const lastSavedAt = useLessonPlanEditor((s) => s.lastSavedAt);
+  const setTitle = useLessonPlanEditor((s) => s.setTitle);
+  // 订阅派生 boolean，仅在结果变化时触发 re-render（rerender-derived-state）
+  const canUndo = useLessonPlanEditor((s) => s.canUndo());
+  const canRedo = useLessonPlanEditor((s) => s.canRedo());
   const tracker = useLessonPlanTrackerSafe();
   const ctx = useLessonPlanContextSafe();
   const service = ctx?.service ?? null;
@@ -88,9 +99,9 @@ export function LessonPlanEditor({
   // V3 修复：完全通过 service 调用，不直接 import actions
   // V5-1 修复：保存失败显示 toast + 设置 saveError；断网时不触发保存
   useEffect(() => {
-    if (!editor.isDirty) return;
+    if (!isDirty) return;
     if (!service) return;
-    if (!editor.isOnline) return; // V5-1：断网期间不触发保存请求
+    if (!isOnline) return; // V5-1：断网期间不触发保存请求
     if (autoSaveTimer.current) clearTimeout(autoSaveTimer.current);
     autoSaveTimer.current = setTimeout(async () => {
       const state = useLessonPlanEditor.getState();
@@ -120,7 +131,7 @@ export function LessonPlanEditor({
     return () => {
       if (autoSaveTimer.current) clearTimeout(autoSaveTimer.current);
     };
-  }, [editor.isDirty, editor.doc, planId, service, editor.isOnline, t]);
+  }, [isDirty, doc, planId, service, isOnline, t]);
 
   // V5-1：监听网络在线/离线状态
   useEffect(() => {
@@ -185,18 +196,15 @@ export function LessonPlanEditor({
     return () => window.removeEventListener("keydown", handleKeyDown);
   }, []);
 
-  // V5-2：撤销/重做按钮处理（追踪 canUndo/canRedo 以驱动 disabled 状态）
-  const canUndo = editor.canUndo();
-  const canRedo = editor.canRedo();
+  // V5-2：撤销/重做按钮处理（canUndo/canRedo 已通过 selector 订阅）
   const handleUndo = useCallback(() => useLessonPlanEditor.getState().undo(), []);
   const handleRedo = useCallback(() => useLessonPlanEditor.getState().redo(), []);
 
   // V5-4：构造打印用的 LessonPlan 对象（编辑器仅持有 planId/title/doc，其余字段填默认值）
   const printablePlan: LessonPlan = useMemo(() => {
-    const doc: LessonPlanDocument = editor.doc;
     return {
       id: planId,
-      title: editor.title,
+      title,
       textbookId: textbookId ?? null,
       chapterId: chapterId ?? null,
       coursePlanItemId: null,
@@ -207,11 +215,11 @@ export function LessonPlanEditor({
       content: doc,
       status: planStatus,
       creatorId: "",
-      lastSavedAt: editor.lastSavedAt ? new Date(editor.lastSavedAt).toISOString() : null,
+      lastSavedAt: lastSavedAt ? new Date(lastSavedAt).toISOString() : null,
       createdAt: new Date().toISOString(),
       updatedAt: new Date().toISOString(),
     };
-  }, [planId, editor.title, editor.doc, editor.lastSavedAt, textbookId, chapterId, planStatus]);
+  }, [planId, title, doc, lastSavedAt, textbookId, chapterId, planStatus]);
 
   // 定时自动版本（30min）
   useEffect(() => {
@@ -327,8 +335,8 @@ export function LessonPlanEditor({
       {/* 顶部工具栏 */}
       <div className="flex items-center gap-2 px-4 py-2 border-b border-outline-variant bg-surface">
         <input
-          value={editor.title}
-          onChange={(e) => editor.setTitle(e.target.value)}
+          value={title}
+          onChange={(e) => setTitle(e.target.value)}
           className="flex-1 bg-transparent font-headline-md text-headline-md focus:outline-none"
         />
         {/* 教材/章节指示器 */}
@@ -348,26 +356,26 @@ export function LessonPlanEditor({
           </div>
         )}
         <span className="text-on-surface-variant text-sm">
-          {editor.isSaving
+          {isSaving
             ? t("status.saving")
-            : editor.isDirty
+            : isDirty
               ? t("status.unsaved")
               : t("status.saved")}
         </span>
         {/* V5-1：保存失败/离线提示与重试按钮 */}
-        {editor.saveError && (
+        {saveError && (
           <Button
             variant="outline"
             size="sm"
             onClick={handleRetrySave}
-            disabled={editor.isSaving}
+            disabled={isSaving}
             className="text-error border-error"
           >
             <RotateCw className="w-3 h-3 mr-1" />
             {t("status.retrySave")}
           </Button>
         )}
-        {!editor.isOnline && (
+        {!isOnline && (
           <span className="text-xs text-error inline-flex items-center gap-1">
             <WifiOff className="w-3 h-3" />
             {t("status.offlineBadge")}
@@ -401,7 +409,7 @@ export function LessonPlanEditor({
         >
           <Redo className="w-4 h-4" />
         </Button>
-        <Button size="sm" onClick={handleManualSave} disabled={editor.isSaving}>
+        <Button size="sm" onClick={handleManualSave} disabled={isSaving}>
           <Save className="w-4 h-4 mr-1" /> {t("action.saveVersion")}
         </Button>
         {/* V5-4：导出/打印按钮 */}
@@ -524,7 +532,7 @@ export function LessonPlanEditor({
           onClose={() => setShowVersions(false)}
           planId={planId}
           onReverted={handleReverted}
-          currentDoc={editor.doc}
+          currentDoc={doc}
         />
       </LessonPlanErrorBoundary>
 
@@ -555,7 +563,7 @@ export function LessonPlanEditor({
       {showConsistency && (
         <LessonPlanErrorBoundary>
           <ConsistencyCheckDialog
-            doc={editor.doc}
+            doc={doc}
             onClose={() => setShowConsistency(false)}
           />
         </LessonPlanErrorBoundary>
@@ -565,7 +573,7 @@ export function LessonPlanEditor({
       {showAiFeedback && (
         <LessonPlanErrorBoundary>
           <AiFeedbackDialog
-            doc={editor.doc}
+            doc={doc}
             onClose={() => setShowAiFeedback(false)}
           />
         </LessonPlanErrorBoundary>
@@ -575,7 +583,7 @@ export function LessonPlanEditor({
       {showAiDifferentiation && (
         <LessonPlanErrorBoundary>
           <AiDifferentiationDialog
-            doc={editor.doc}
+            doc={doc}
             textbookId={textbookId}
             onClose={() => setShowAiDifferentiation(false)}
           />
diff --git a/src/modules/lesson-preparation/components/paper-editor/paper-context-menu.tsx b/src/modules/lesson-preparation/components/paper-editor/paper-context-menu.tsx
index e2af8e4..e535ad1 100644
--- a/src/modules/lesson-preparation/components/paper-editor/paper-context-menu.tsx
+++ b/src/modules/lesson-preparation/components/paper-editor/paper-context-menu.tsx
@@ -29,19 +29,19 @@ interface Props {
  */
 export function PaperContextMenu({ state, onClose, onAiAction }: Props) {
   const t = useTranslations("lessonPreparation");
-  const {
-    toggleExpand,
-    expandedNodeIds,
-    updateNode,
-    removeNode,
-    addAnchor,
-    duplicateNode,
-    doc,
-  } = useLessonPlanEditor();
+  // Phase 4.2: 拆分为细粒度 selector。函数引用稳定，订阅 doc.nodes 比 doc 更精细
+  // （addAnchor 等仅修改 anchors 不会触发本组件 re-render）
+  const toggleExpand = useLessonPlanEditor((s) => s.toggleExpand);
+  const expandedNodeIds = useLessonPlanEditor((s) => s.expandedNodeIds);
+  const updateNode = useLessonPlanEditor((s) => s.updateNode);
+  const removeNode = useLessonPlanEditor((s) => s.removeNode);
+  const addAnchor = useLessonPlanEditor((s) => s.addAnchor);
+  const duplicateNode = useLessonPlanEditor((s) => s.duplicateNode);
+  const nodes = useLessonPlanEditor((s) => s.doc.nodes);
 
   // V1 占位实现：上下移动、复制（按 spec §15 YAGNI，V2 完整实现）
   const moveNodeOrder = (nodeId: string, direction: "up" | "down") => {
-    const teachingNodes = doc.nodes
+    const teachingNodes = nodes
       .filter((n): n is LessonPlanNode => n.type !== "textbook_content")
       .sort((a, b) => a.order - b.order);
     const idx = teachingNodes.findIndex((n) => n.id === nodeId);
@@ -55,7 +55,7 @@ export function PaperContextMenu({ state, onClose, onAiAction }: Props) {
   };
 
   const copyNode = async (nodeId: string) => {
-    const newId = duplicateNode(nodeId, t("v4.contextMenu.copySuffix"));
+    const newId = duplicateNode(nodeId);
     const { toast } = await import("sonner");
     if (newId) {
       toast.success(t("v4.contextMenu.copied"));
diff --git a/src/modules/lesson-preparation/components/print-view.tsx b/src/modules/lesson-preparation/components/print-view.tsx
index 692f669..01dc7e6 100644
--- a/src/modules/lesson-preparation/components/print-view.tsx
+++ b/src/modules/lesson-preparation/components/print-view.tsx
@@ -50,9 +50,8 @@ export function PrintView({
         plan,
         { textbookTitle, chapterTitle, teacherName, className },
         variant,
-        (key, params) => t(key, params),
       ),
-    [plan, textbookTitle, chapterTitle, teacherName, className, variant, t],
+    [plan, textbookTitle, chapterTitle, teacherName, className, variant],
   );
 
   function handlePrint() {
diff --git a/src/modules/lesson-preparation/data-access-ai-evaluation.ts b/src/modules/lesson-preparation/data-access-ai-evaluation.ts
index eb5bc34..60d714a 100644
--- a/src/modules/lesson-preparation/data-access-ai-evaluation.ts
+++ b/src/modules/lesson-preparation/data-access-ai-evaluation.ts
@@ -9,6 +9,7 @@ import "server-only";
 import { db } from "@/shared/db";
 import { lessonPlanAiEvaluations } from "@/shared/db/schema";
 import { eq, desc } from "drizzle-orm";
+import { cacheFn } from "@/shared/lib/cache";
 import type { LessonPlanDocument } from "./types";
 
 /** 单次评估结果 */
@@ -36,7 +37,7 @@ export interface DimensionScores {
 /**
  * 查询某课案的所有 AI 评估记录
  */
-export async function getEvaluationsByPlanId(
+export async function getEvaluationsByPlanIdRaw(
   planId: string,
 ): Promise<AiEvaluation[]> {
   const rows = await db
@@ -46,11 +47,16 @@ export async function getEvaluationsByPlanId(
     .orderBy(desc(lessonPlanAiEvaluations.createdAt));
   return rows.map(mapRowToEvaluation);
 }
+export const getEvaluationsByPlanId = cacheFn(getEvaluationsByPlanIdRaw, {
+  tags: ["lesson-preparation"],
+  ttl: 300,
+  keyParts: ["lp", "ai-evaluations", "by-plan"],
+})
 
 /**
  * 查询最新一次评估
  */
-export async function getLatestEvaluation(
+export async function getLatestEvaluationRaw(
   planId: string,
 ): Promise<AiEvaluation | null> {
   const rows = await db
@@ -61,6 +67,11 @@ export async function getLatestEvaluation(
     .limit(1);
   return rows.length === 0 ? null : mapRowToEvaluation(rows[0]!);
 }
+export const getLatestEvaluation = cacheFn(getLatestEvaluationRaw, {
+  tags: ["lesson-preparation"],
+  ttl: 600,
+  keyParts: ["lp", "ai-evaluations", "latest"],
+})
 
 /**
  * 创建 AI 评估记录
diff --git a/src/modules/lesson-preparation/data-access-analytics.ts b/src/modules/lesson-preparation/data-access-analytics.ts
index 73536e0..c1b94b3 100644
--- a/src/modules/lesson-preparation/data-access-analytics.ts
+++ b/src/modules/lesson-preparation/data-access-analytics.ts
@@ -8,6 +8,7 @@
  * - 课标覆盖热力图（按 subject+grade 矩阵）
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import {
   lessonPlanAnalyticsDaily,
@@ -48,7 +49,7 @@ export interface StandardsCoverageCell {
 /**
  * 查询教师备课投入（按日期范围）
  */
-export async function getTeacherInvestment(
+export async function getTeacherInvestmentRaw(
   startDate: Date,
   endDate: Date,
   teacherId?: string,
@@ -77,10 +78,12 @@ export async function getTeacherInvestment(
   }));
 }
 
+export const getTeacherInvestment = cacheFn(getTeacherInvestmentRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "analytics", "teacher-investment"] });
+
 /**
  * 查询模板使用率（按 templateId 分组）
  */
-export async function getTemplateUsageStats(): Promise<TemplateUsageDataPoint[]> {
+export async function getTemplateUsageStatsRaw(): Promise<TemplateUsageDataPoint[]> {
   const rows = await db
     .select({
       templateId: lessonPlans.templateId,
@@ -99,10 +102,12 @@ export async function getTemplateUsageStats(): Promise<TemplateUsageDataPoint[]>
   }));
 }
 
+export const getTemplateUsageStats = cacheFn(getTemplateUsageStatsRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "analytics", "template-usage"] });
+
 /**
  * 查询课标覆盖热力图（按 subject+grade 矩阵）
  */
-export async function getStandardsCoverageHeatmap(): Promise<
+export async function getStandardsCoverageHeatmapRaw(): Promise<
   StandardsCoverageCell[]
 > {
   // 总课案数（按 subject+grade 分组）
@@ -148,10 +153,12 @@ export async function getStandardsCoverageHeatmap(): Promise<
   });
 }
 
+export const getStandardsCoverageHeatmap = cacheFn(getStandardsCoverageHeatmapRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "analytics", "standards-coverage"] });
+
 /**
  * 查询全局备课统计（仪表盘顶部卡片）
  */
-export async function getGlobalLessonPlanStats(): Promise<{
+export async function getGlobalLessonPlanStatsRaw(): Promise<{
   totalTeachers: number;
   totalPlans: number;
   totalPublished: number;
@@ -187,6 +194,8 @@ export async function getGlobalLessonPlanStats(): Promise<{
   };
 }
 
+export const getGlobalLessonPlanStats = cacheFn(getGlobalLessonPlanStatsRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "analytics", "global-stats"] });
+
 /**
  * 写入或更新当日分析快照（教师保存版本时触发）
  */
diff --git a/src/modules/lesson-preparation/data-access-attachments.ts b/src/modules/lesson-preparation/data-access-attachments.ts
index d94bb77..dcc908b 100644
--- a/src/modules/lesson-preparation/data-access-attachments.ts
+++ b/src/modules/lesson-preparation/data-access-attachments.ts
@@ -2,6 +2,7 @@
  * M6 资源附件库 - 数据访问层
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlanAttachments } from "@/shared/db/schema";
 import { and, eq, desc } from "drizzle-orm";
@@ -23,7 +24,7 @@ export interface LessonPlanAttachment {
 /**
  * 查询课案的所有附件
  */
-export async function getAttachmentsByPlanId(
+export async function getAttachmentsByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanAttachment[]> {
   const rows = await db
@@ -35,10 +36,12 @@ export async function getAttachmentsByPlanId(
   return rows.map(mapRowToAttachment);
 }
 
+export const getAttachmentsByPlanId = cacheFn(getAttachmentsByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "attachments", "by-plan"] });
+
 /**
  * 查询特定 Block 的附件
  */
-export async function getAttachmentsByBlockId(
+export async function getAttachmentsByBlockIdRaw(
   planId: string,
   blockId: string,
 ): Promise<LessonPlanAttachment[]> {
@@ -56,6 +59,8 @@ export async function getAttachmentsByBlockId(
   return rows.map(mapRowToAttachment);
 }
 
+export const getAttachmentsByBlockId = cacheFn(getAttachmentsByBlockIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "attachments", "by-block"] });
+
 /**
  * 添加附件
  */
@@ -111,7 +116,7 @@ export async function updateAttachmentType(
 /**
  * 按 ID 获取附件
  */
-export async function getAttachmentById(
+export async function getAttachmentByIdRaw(
   id: string,
 ): Promise<LessonPlanAttachment | null> {
   const rows = await db
@@ -122,6 +127,8 @@ export async function getAttachmentById(
   return rows.length === 0 ? null : mapRowToAttachment(rows[0]!);
 }
 
+export const getAttachmentById = cacheFn(getAttachmentByIdRaw, { tags: ["lesson-preparation"], ttl: 600, keyParts: ["lp", "attachments", "by-id"] });
+
 function mapRowToAttachment(
   row: typeof lessonPlanAttachments.$inferSelect,
 ): LessonPlanAttachment {
diff --git a/src/modules/lesson-preparation/data-access-calendar.ts b/src/modules/lesson-preparation/data-access-calendar.ts
index d9b9614..2bf808f 100644
--- a/src/modules/lesson-preparation/data-access-calendar.ts
+++ b/src/modules/lesson-preparation/data-access-calendar.ts
@@ -5,6 +5,7 @@
  * 关联查询 createdAt/updatedAt/submittedAt 用于在日历上标记事件。
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlans, lessonPlanVersions, lessonPlanReviewRecords } from "@/shared/db/schema";
 import { and, eq, gte, lte, asc } from "drizzle-orm";
@@ -25,7 +26,7 @@ export interface LessonPlanCalendarEvent {
 /**
  * 按日期范围查询教师备课日历事件
  */
-export async function getCalendarEvents(
+export async function getCalendarEventsRaw(
   teacherId: string,
   startDate: Date,
   endDate: Date,
@@ -161,6 +162,8 @@ export async function getCalendarEvents(
   return events.sort((a, b) => a.occurredAt.getTime() - b.occurredAt.getTime());
 }
 
+export const getCalendarEvents = cacheFn(getCalendarEventsRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "calendar", "events"] });
+
 /**
  * 按日期分组日历事件
  */
diff --git a/src/modules/lesson-preparation/data-access-comments.ts b/src/modules/lesson-preparation/data-access-comments.ts
index 286a767..7554461 100644
--- a/src/modules/lesson-preparation/data-access-comments.ts
+++ b/src/modules/lesson-preparation/data-access-comments.ts
@@ -5,6 +5,7 @@
  * 实时多人编辑部分（Yjs/Liveblocks）需要单独的 WebSocket 服务，本文件仅实现评论 CRUD。
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlanComments } from "@/shared/db/schema";
 import { and, eq, asc, isNull } from "drizzle-orm";
@@ -25,7 +26,7 @@ export interface LessonPlanComment {
 /**
  * 查询课案的所有评论（含子回复）
  */
-export async function getCommentsByPlanId(
+export async function getCommentsByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanComment[]> {
   const rows = await db
@@ -37,10 +38,12 @@ export async function getCommentsByPlanId(
   return rows.map(mapRowToComment);
 }
 
+export const getCommentsByPlanId = cacheFn(getCommentsByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "comments", "by-plan"] });
+
 /**
  * 查询特定 Block 的评论
  */
-export async function getCommentsByBlockId(
+export async function getCommentsByBlockIdRaw(
   planId: string,
   blockId: string,
 ): Promise<LessonPlanComment[]> {
@@ -58,6 +61,8 @@ export async function getCommentsByBlockId(
   return rows.map(mapRowToComment);
 }
 
+export const getCommentsByBlockId = cacheFn(getCommentsByBlockIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "comments", "by-block"] });
+
 /**
  * 创建评论
  */
@@ -137,7 +142,7 @@ export async function deleteComment(commentId: string): Promise<void> {
 /**
  * 统计课案未解决评论数
  */
-export async function countUnresolvedComments(planId: string): Promise<number> {
+export async function countUnresolvedCommentsRaw(planId: string): Promise<number> {
   const rows = await db
     .select({ id: lessonPlanComments.id })
     .from(lessonPlanComments)
@@ -151,6 +156,8 @@ export async function countUnresolvedComments(planId: string): Promise<number> {
   return rows.length;
 }
 
+export const countUnresolvedComments = cacheFn(countUnresolvedCommentsRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "comments", "unresolved-count"] });
+
 function mapRowToComment(
   row: typeof lessonPlanComments.$inferSelect,
 ): LessonPlanComment {
diff --git a/src/modules/lesson-preparation/data-access-formative.ts b/src/modules/lesson-preparation/data-access-formative.ts
index d7ac241..bd6d345 100644
--- a/src/modules/lesson-preparation/data-access-formative.ts
+++ b/src/modules/lesson-preparation/data-access-formative.ts
@@ -6,6 +6,7 @@
  * 教师可查看实时反馈，闭环到课案优化。
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import {
   lessonPlanFormativeItems,
@@ -43,7 +44,7 @@ export interface FormativeResponse {
 /**
  * 查询课案的所有互动组件
  */
-export async function getFormativeItemsByPlanId(
+export async function getFormativeItemsByPlanIdRaw(
   planId: string,
 ): Promise<FormativeItem[]> {
   const rows = await db
@@ -55,10 +56,12 @@ export async function getFormativeItemsByPlanId(
   return rows.map(mapRowToItem);
 }
 
+export const getFormativeItemsByPlanId = cacheFn(getFormativeItemsByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "formative", "items-by-plan"] });
+
 /**
  * 查询单个互动组件
  */
-export async function getFormativeItemById(
+export async function getFormativeItemByIdRaw(
   id: string,
 ): Promise<FormativeItem | null> {
   const rows = await db
@@ -69,6 +72,8 @@ export async function getFormativeItemById(
   return rows.length === 0 ? null : mapRowToItem(rows[0]!);
 }
 
+export const getFormativeItemById = cacheFn(getFormativeItemByIdRaw, { tags: ["lesson-preparation"], ttl: 600, keyParts: ["lp", "formative", "by-id"] });
+
 /**
  * 创建互动组件
  */
@@ -157,7 +162,7 @@ export async function submitFormativeResponse(
 /**
  * 查询互动组件的所有作答
  */
-export async function getResponsesByItemId(
+export async function getResponsesByItemIdRaw(
   itemId: string,
 ): Promise<FormativeResponse[]> {
   const rows = await db
@@ -169,10 +174,12 @@ export async function getResponsesByItemId(
   return rows.map(mapRowToResponse);
 }
 
+export const getResponsesByItemId = cacheFn(getResponsesByItemIdRaw, { tags: ["lesson-preparation:students"], ttl: 60, keyParts: ["lp", "formative", "responses-by-item"] });
+
 /**
  * 查询某学生作答历史
  */
-export async function getResponsesByStudentId(
+export async function getResponsesByStudentIdRaw(
   studentId: string,
   planId?: string,
 ): Promise<FormativeResponse[]> {
@@ -197,10 +204,12 @@ export async function getResponsesByStudentId(
   return rows.map(mapRowToResponse);
 }
 
+export const getResponsesByStudentId = cacheFn(getResponsesByStudentIdRaw, { tags: ["lesson-preparation:students"], ttl: 60, keyParts: ["lp", "formative", "responses-by-student"] });
+
 /**
  * 统计互动组件的作答情况（用于教师查看实时反馈）
  */
-export async function getFormativeItemStats(
+export async function getFormativeItemStatsRaw(
   itemId: string,
 ): Promise<{ total: number; correct: number; incorrect: number; avgDurationSec: number }> {
   const rows = await db
@@ -229,6 +238,8 @@ export async function getFormativeItemStats(
   };
 }
 
+export const getFormativeItemStats = cacheFn(getFormativeItemStatsRaw, { tags: ["lesson-preparation"], ttl: 60, keyParts: ["lp", "formative", "stats"] });
+
 function mapRowToItem(
   row: typeof lessonPlanFormativeItems.$inferSelect,
 ): FormativeItem {
diff --git a/src/modules/lesson-preparation/data-access-knowledge.ts b/src/modules/lesson-preparation/data-access-knowledge.ts
index 478e71d..fd4d6bb 100644
--- a/src/modules/lesson-preparation/data-access-knowledge.ts
+++ b/src/modules/lesson-preparation/data-access-knowledge.ts
@@ -1,4 +1,5 @@
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 
 import { and, eq, like, sql } from "drizzle-orm";
 
@@ -83,7 +84,7 @@ function mapRowToListItemWithoutJoin(r: {
 }
 
 // 查询关联了某知识点的课案
-export async function getLessonPlansByKnowledgePoint(
+export async function getLessonPlansByKnowledgePointRaw(
   knowledgePointId: string,
   userId: string,
 ): Promise<LessonPlanListItem[]> {
@@ -111,8 +112,10 @@ export async function getLessonPlansByKnowledgePoint(
     .map(mapRowToListItemWithoutJoin);
 }
 
+export const getLessonPlansByKnowledgePoint = cacheFn(getLessonPlansByKnowledgePointRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "by-knowledge-point"] });
+
 // 查询使用了某题目的课案
-export async function getLessonPlansByQuestion(
+export async function getLessonPlansByQuestionRaw(
   questionId: string,
   userId: string,
 ): Promise<LessonPlanListItem[]> {
@@ -138,3 +141,5 @@ export async function getLessonPlansByQuestion(
     })
     .map(mapRowToListItemWithoutJoin);
 }
+
+export const getLessonPlansByQuestion = cacheFn(getLessonPlansByQuestionRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "by-question"] });
diff --git a/src/modules/lesson-preparation/data-access-review.ts b/src/modules/lesson-preparation/data-access-review.ts
index c742066..2b6179a 100644
--- a/src/modules/lesson-preparation/data-access-review.ts
+++ b/src/modules/lesson-preparation/data-access-review.ts
@@ -4,6 +4,7 @@
  * 处理课案状态迁移、审核记录、审核队列查询。
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlans, lessonPlanReviewRecords } from "@/shared/db/schema";
 import { and, eq, desc, asc, inArray } from "drizzle-orm";
@@ -123,7 +124,7 @@ export async function reviewPlan(
 /**
  * 查询课案的所有审核记录
  */
-export async function getReviewRecordsByPlanId(
+export async function getReviewRecordsByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanReviewRecord[]> {
   const rows = await db
@@ -144,10 +145,12 @@ export async function getReviewRecordsByPlanId(
   }));
 }
 
+export const getReviewRecordsByPlanId = cacheFn(getReviewRecordsByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "review-records", "by-plan"] });
+
 /**
  * 查询待审核队列（教研组长用）
  */
-export async function getPendingReviewPlans(
+export async function getPendingReviewPlansRaw(
   reviewerGradeIds?: string[],
   reviewerSubjectIds?: string[],
 ): Promise<
@@ -199,6 +202,8 @@ export async function getPendingReviewPlans(
     }));
 }
 
+export const getPendingReviewPlans = cacheFn(getPendingReviewPlansRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "review", "pending"] });
+
 /**
  * 撤回审核（教师主动撤回：submitted → draft）
  */
@@ -230,7 +235,7 @@ export async function withdrawSubmission(
 /**
  * 按状态批量查询课案（审核仪表盘用途。
  */
-export async function getPlansByStatuses(
+export async function getPlansByStatusesRaw(
   statuses: LessonPlanStatus[],
   creatorId?: string,
 ): Promise<
@@ -270,3 +275,5 @@ export async function getPlansByStatuses(
     updatedAt: r.updatedAt,
   }));
 }
+
+export const getPlansByStatuses = cacheFn(getPlansByStatusesRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "by-statuses"] });
diff --git a/src/modules/lesson-preparation/data-access-schedules.ts b/src/modules/lesson-preparation/data-access-schedules.ts
index c3394b5..bba2951 100644
--- a/src/modules/lesson-preparation/data-access-schedules.ts
+++ b/src/modules/lesson-preparation/data-access-schedules.ts
@@ -4,6 +4,7 @@
  * 将课案绑定到具体班级的某个日期/节次，支持 calendar-view 安排课时。
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlanSchedules, classes } from "@/shared/db/schema";
 import { and, eq, gte, lte, desc } from "drizzle-orm";
@@ -33,7 +34,7 @@ function toDateStr(d: Date): string {
 }
 
 /** 查询课案的所有课时绑定 */
-export async function getSchedulesByPlanId(
+export async function getSchedulesByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanScheduleRecord[]> {
   const rows = await db
@@ -70,8 +71,10 @@ export async function getSchedulesByPlanId(
   }));
 }
 
+export const getSchedulesByPlanId = cacheFn(getSchedulesByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "schedules", "by-plan"] });
+
 /** 查询教师在某日期范围内的课时绑定 */
-export async function getSchedulesByDateRange(
+export async function getSchedulesByDateRangeRaw(
   teacherPlanIds: string[],
   startDate: string,
   endDate: string,
@@ -119,6 +122,8 @@ export async function getSchedulesByDateRange(
     }));
 }
 
+export const getSchedulesByDateRange = cacheFn(getSchedulesByDateRangeRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "schedules", "by-date-range"] });
+
 /** 创建课时绑定 */
 export async function createSchedule(input: {
   planId: string;
diff --git a/src/modules/lesson-preparation/data-access-substitutes.ts b/src/modules/lesson-preparation/data-access-substitutes.ts
index abfec5e..288aa89 100644
--- a/src/modules/lesson-preparation/data-access-substitutes.ts
+++ b/src/modules/lesson-preparation/data-access-substitutes.ts
@@ -2,6 +2,7 @@
  * M12 代课教师机制 - 数据访问层
  */
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 import { db } from "@/shared/db";
 import { lessonPlanSubstitutes, lessonPlans } from "@/shared/db/schema";
 import { and, eq, gte, lte, or, isNull, desc } from "drizzle-orm";
@@ -26,7 +27,7 @@ export interface LessonPlanSubstitute {
 /**
  * 查询某课案的代课教师列表
  */
-export async function getSubstitutesByPlanId(
+export async function getSubstitutesByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanSubstitute[]> {
   const rows = await db
@@ -38,10 +39,12 @@ export async function getSubstitutesByPlanId(
   return rows.map(mapRowToSubstitute);
 }
 
+export const getSubstitutesByPlanId = cacheFn(getSubstitutesByPlanIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "substitutes", "by-plan"] });
+
 /**
  * 查询某教师当前生效的代课任务（作为代课教师或原教师）
  */
-export async function getActiveSubstitutesByTeacherId(
+export async function getActiveSubstitutesByTeacherIdRaw(
   teacherId: string,
 ): Promise<LessonPlanSubstitute[]> {
   const now = new Date();
@@ -59,6 +62,8 @@ export async function getActiveSubstitutesByTeacherId(
   return rows.map(mapRowToSubstitute);
 }
 
+export const getActiveSubstitutesByTeacherId = cacheFn(getActiveSubstitutesByTeacherIdRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "substitutes", "active-by-teacher"] });
+
 /**
  * 创建代课教师映射
  */
diff --git a/src/modules/lesson-preparation/data-access-templates.ts b/src/modules/lesson-preparation/data-access-templates.ts
index 119699b..cf18420 100644
--- a/src/modules/lesson-preparation/data-access-templates.ts
+++ b/src/modules/lesson-preparation/data-access-templates.ts
@@ -1,4 +1,5 @@
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 
 import { and, eq } from "drizzle-orm";
 import { createId } from "@paralleldrive/cuid2";
@@ -41,7 +42,7 @@ function mapRowToTemplate(row: {
   };
 }
 
-export async function getLessonPlanTemplates(
+export async function getLessonPlanTemplatesRaw(
   userId: string,
 ): Promise<LessonPlanTemplate[]> {
   // system 模板（内存）+ personal 模板（DB）
@@ -70,6 +71,8 @@ export async function getLessonPlanTemplates(
   return [...systemTemplates, ...personalTemplates];
 }
 
+export const getLessonPlanTemplates = cacheFn(getLessonPlanTemplatesRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "templates", "list"] });
+
 export async function saveAsTemplate(input: {
   sourcePlanId: string;
   name: string;
diff --git a/src/modules/lesson-preparation/data-access-versions.ts b/src/modules/lesson-preparation/data-access-versions.ts
index 332adfa..ee3f0e7 100644
--- a/src/modules/lesson-preparation/data-access-versions.ts
+++ b/src/modules/lesson-preparation/data-access-versions.ts
@@ -1,4 +1,5 @@
 import "server-only";
+import { cacheFn } from "@/shared/lib/cache";
 
 import { and, desc, eq, inArray, max } from "drizzle-orm";
 import { createId } from "@paralleldrive/cuid2";
@@ -31,7 +32,7 @@ function mapRowToVersion(row: {
   };
 }
 
-export async function getLessonPlanVersions(
+export async function getLessonPlanVersionsRaw(
   planId: string,
   userId: string,
 ): Promise<LessonPlanVersion[]> {
@@ -53,6 +54,8 @@ export async function getLessonPlanVersions(
   return rows.map(mapRowToVersion);
 }
 
+export const getLessonPlanVersions = cacheFn(getLessonPlanVersionsRaw, { tags: ["lesson-preparation"], ttl: 300, keyParts: ["lp", "versions", "by-plan"] });
+
 export async function createLessonPlanVersion(input: {
   planId: string;
   content: LessonPlanDocument;
@@ -91,7 +94,7 @@ export async function createLessonPlanVersion(input: {
   });
 }
 
-export async function getVersionContent(
+export async function getVersionContentRaw(
   planId: string,
   versionNo: number,
   userId: string,
@@ -120,6 +123,8 @@ export async function getVersionContent(
   return normalizeDocument(rows[0].content);
 }
 
+export const getVersionContent = cacheFn(getVersionContentRaw, { tags: ["lesson-preparation"], ttl: 600, keyParts: ["lp", "versions", "content"] });
+
 export async function revertToVersion(
   planId: string,
   versionNo: number,
diff --git a/src/modules/messaging/components/message-detail.tsx b/src/modules/messaging/components/message-detail.tsx
index b4fca14..ab6cb6e 100644
--- a/src/modules/messaging/components/message-detail.tsx
+++ b/src/modules/messaging/components/message-detail.tsx
@@ -1,6 +1,6 @@
 "use client"
 
-import { useEffect, useState } from "react"
+import { useEffect, useState, useOptimistic, useTransition } from "react"
 import Link from "next/link"
 import { useRouter } from "next/navigation"
 import { toast } from "sonner"
@@ -43,8 +43,12 @@ export function MessageDetail({
   const [deleteOpen, setDeleteOpen] = useState(false)
   const [recallOpen, setRecallOpen] = useState(false)
   const [isRecalling, setIsRecalling] = useState(false)
-  const [isStarred, setIsStarred] = useState(message.isStarred)
-  const [isTogglingStar, setIsTogglingStar] = useState(false)
+  // Phase 4.5: 星标用 useOptimistic + useTransition,自动回滚与服务端同步
+  const [optimisticIsStarred, addOptimisticStarred] = useOptimistic(
+    message.isStarred,
+    (_currentState, nextValue: boolean) => nextValue,
+  )
+  const [isTogglingStar, startStarTransition] = useTransition()
   // P1-3: 线程状态
   const [thread, setThread] = useState<Message[]>([])
   const [loadingThread, setLoadingThread] = useState(true)
@@ -108,27 +112,24 @@ export function MessageDetail({
     }
   }
 
-  const handleToggleStar = async () => {
-    setIsTogglingStar(true)
-    const prevStarred = isStarred
-    // 乐观更新
-    setIsStarred(!prevStarred)
-    try {
-      const res = await toggleMessageStarAction(message.id)
-      if (res.success) {
-        toast.success(t("messages.starToggled"))
-      } else {
-        // 回滚
-        setIsStarred(prevStarred)
-        toast.error(res.message)
+  const handleToggleStar = () => {
+    // Phase 4.5: useOptimistic 在 transition 内自动管理乐观状态与回滚
+    const nextStarred = !optimisticIsStarred
+    startStarTransition(async () => {
+      addOptimisticStarred(nextStarred)
+      try {
+        const res = await toggleMessageStarAction(message.id)
+        if (res.success) {
+          toast.success(t("messages.starToggled"))
+          // 同步数据源,让 useOptimistic 回滚到最新服务端值
+          router.refresh()
+        } else {
+          toast.error(res.message)
+        }
+      } catch {
+        toast.error(t("messages.sendFailed"))
       }
-    } catch {
-      // 回滚
-      setIsStarred(prevStarred)
-      toast.error(t("messages.sendFailed"))
-    } finally {
-      setIsTogglingStar(false)
-    }
+    })
   }
 
   // P2-4: 消息撤回（仅发送方，2 分钟窗口内）
@@ -182,13 +183,13 @@ export function MessageDetail({
           <Button
             onClick={handleToggleStar}
             disabled={isTogglingStar}
-            variant={isStarred ? "default" : "outline"}
-            aria-pressed={isStarred}
+            variant={optimisticIsStarred ? "default" : "outline"}
+            aria-pressed={optimisticIsStarred}
           >
             <Star
-              className={cn("mr-2 h-4 w-4", isStarred && "fill-current")}
+              className={cn("mr-2 h-4 w-4", optimisticIsStarred && "fill-current")}
             />
-            {isStarred ? t("actions.unstar") : t("actions.star")}
+            {optimisticIsStarred ? t("actions.unstar") : t("actions.star")}
           </Button>
           {/* P2-4: 撤回按钮（仅发送方可见且未撤回、未超时） */}
           {canRecall ? (
@@ -240,7 +241,7 @@ export function MessageDetail({
             ) : (
               <Badge variant="outline">{t("status.sent")}</Badge>
             )}
-            {isStarred ? (
+            {optimisticIsStarred ? (
               <span className="inline-flex items-center gap-1 text-xs text-yellow-600">
                 <Star className="h-3.5 w-3.5 fill-yellow-400 text-yellow-400" aria-hidden="true" />
                 {t("actions.star")}
diff --git a/src/modules/messaging/components/message-list.tsx b/src/modules/messaging/components/message-list.tsx
index c0a79ad..cc6da20 100644
--- a/src/modules/messaging/components/message-list.tsx
+++ b/src/modules/messaging/components/message-list.tsx
@@ -1,7 +1,8 @@
 "use client"
 
-import { useCallback, useMemo, useState } from "react"
+import { useCallback, useMemo, useState, useOptimistic, useTransition } from "react"
 import Link from "next/link"
+import { useRouter } from "next/navigation"
 import { Mail, MailOpen, Plus, Send, Inbox, Search, Loader2, ChevronLeft, ChevronRight, Star, RotateCcw, Users } from "lucide-react"
 import { useTranslations } from "next-intl"
 import { toast } from "sonner"
@@ -40,10 +41,20 @@ export function MessageList({
   canGroupSend?: boolean
 }) {
   const t = useTranslations("messages")
+  const router = useRouter()
   const [tab, setTab] = useState<Tab>(initialType === "sent" ? "sent" : "inbox")
   const [currentPage, setCurrentPage] = useState(1)
-  const [starredOverride, setStarredOverride] = useState<Record<string, boolean>>({})
+  // Phase 4.5: 星标覆盖图改用 useOptimistic + useTransition,自动回滚与服务端同步
+  const [optimisticStarredMap, addOptimisticStar] = useOptimistic(
+    new Map<string, boolean>(),
+    (state, { id, isStarred }: { id: string; isStarred: boolean }) => {
+      const next = new Map(state)
+      next.set(id, isStarred)
+      return next
+    },
+  )
   const [togglingStarId, setTogglingStarId] = useState<string | null>(null)
+  const [, startStarTransition] = useTransition()
   const [starredMessages, setStarredMessages] = useState<Message[] | null>(null)
   const [loadingStarred, setLoadingStarred] = useState(false)
   // P2-4: 撤回状态覆盖（按消息 ID 维度，撤回成功后立即隐藏原内容）
@@ -112,39 +123,40 @@ export function MessageList({
   }
 
   const getIsStarred = (m: Message): boolean => {
-    const override = starredOverride[m.id]
+    const override = optimisticStarredMap.get(m.id)
     return override === undefined ? m.isStarred : override
   }
 
   const handleToggleStar = useCallback(
-    async (e: React.MouseEvent, messageId: string, currentStarred: boolean): Promise<void> => {
+    (e: React.MouseEvent, messageId: string, currentStarred: boolean): void => {
       e.preventDefault()
       e.stopPropagation()
       setTogglingStarId(messageId)
-      // 乐观更新
-      setStarredOverride((prev) => ({ ...prev, [messageId]: !currentStarred }))
-      try {
-        const res = await messageService.toggleStar(messageId)
-        if (res.success) {
-          toast.success(t("messages.starToggled"))
-          // P1-2: 当前在 starred Tab 时重新加载星标列表
-          if (tab === "starred") {
-            void loadStarred()
+      // Phase 4.5: useOptimistic 在 transition 内自动管理乐观状态与回滚
+      const nextStarred = !currentStarred
+      startStarTransition(async () => {
+        addOptimisticStar({ id: messageId, isStarred: nextStarred })
+        try {
+          const res = await messageService.toggleStar(messageId)
+          if (res.success) {
+            toast.success(t("messages.starToggled"))
+            // P1-2: 当前在 starred Tab 时重新加载星标列表
+            if (tab === "starred") {
+              void loadStarred()
+            }
+            // 同步数据源,让 useOptimistic 回滚到最新服务端值
+            await router.refresh()
+          } else {
+            toast.error(res.message)
           }
-        } else {
-          // 回滚
-          setStarredOverride((prev) => ({ ...prev, [messageId]: currentStarred }))
-          toast.error(res.message)
+        } catch {
+          toast.error(t("messages.sendFailed"))
+        } finally {
+          setTogglingStarId(null)
         }
-      } catch {
-        // 回滚
-        setStarredOverride((prev) => ({ ...prev, [messageId]: currentStarred }))
-        toast.error(t("messages.sendFailed"))
-      } finally {
-        setTogglingStarId(null)
-      }
+      })
     },
-    [t, tab, loadStarred, messageService]
+    [t, tab, loadStarred, messageService, router, startStarTransition, addOptimisticStar]
   )
 
   // P2-4: 撤回消息（仅发送方，2 分钟窗口内）
diff --git a/src/modules/messaging/lib/type-guards.ts b/src/modules/messaging/lib/type-guards.ts
new file mode 100644
index 0000000..03d8ff4
--- /dev/null
+++ b/src/modules/messaging/lib/type-guards.ts
@@ -0,0 +1,68 @@
+/**
+ * 私信模块类型守卫。
+ *
+ * 替代 data-access.ts 与组件中的 `as` 断言，从 DB 取出的 enum 字符串字段
+ * 通过类型守卫严格校验后再使用，避免脏数据导致运行时类型错误。
+ */
+
+import type {
+  MessageReportReason,
+  MessageReportStatus,
+  RecipientRole,
+} from "../types"
+
+const RECIPIENT_ROLES: ReadonlySet<string> = new Set<RecipientRole>([
+  "student",
+  "teacher",
+  "admin",
+  "parent",
+])
+
+const MESSAGE_REPORT_REASONS: ReadonlySet<string> = new Set<MessageReportReason>([
+  "spam",
+  "harassment",
+  "inappropriate",
+  "other",
+])
+
+const MESSAGE_REPORT_STATUSES: ReadonlySet<string> = new Set<MessageReportStatus>([
+  "pending",
+  "reviewed",
+  "dismissed",
+  "actioned",
+])
+
+/** 类型守卫：判断值是否为合法的 RecipientRole */
+export function isRecipientRole(value: unknown): value is RecipientRole {
+  return typeof value === "string" && RECIPIENT_ROLES.has(value)
+}
+
+/** 类型守卫：判断值是否为合法的 MessageReportReason */
+export function isMessageReportReason(
+  value: unknown,
+): value is MessageReportReason {
+  return typeof value === "string" && MESSAGE_REPORT_REASONS.has(value)
+}
+
+/** 类型守卫：判断值是否为合法的 MessageReportStatus */
+export function isMessageReportStatus(
+  value: unknown,
+): value is MessageReportStatus {
+  return typeof value === "string" && MESSAGE_REPORT_STATUSES.has(value)
+}
+
+/**
+ * 安全转换 DB 行的 reason 字段。
+ * 合法返回原值，非法回退到 "other"（保证列表渲染不中断）。
+ */
+export function toMessageReportReason(value: unknown): MessageReportReason {
+  return isMessageReportReason(value) ? value : "other"
+}
+
+/**
+ * 安全转换 DB 行的 status 字段。
+ * 合法返回原值，非法回退到 "pending"（保证列表渲染不中断）。
+ */
+export function toMessageReportStatus(value: unknown): MessageReportStatus {
+  return isMessageReportStatus(value) ? value : "pending"
+}
diff --git a/src/modules/notifications/channels/in-app-channel.ts b/src/modules/notifications/channels/in-app-channel.ts
index c3ba8e3..6da257e 100644
--- a/src/modules/notifications/channels/in-app-channel.ts
+++ b/src/modules/notifications/channels/in-app-channel.ts
@@ -18,7 +18,7 @@ import "server-only"
  * 不再需要动态 import messaging 模块，消除了 notifications -> messaging 的反向依赖。
  */
 
-import { createNotification } from "../data-access"
+import { createNotification, createNotifications } from "../data-access"
 import type {
   NotificationPayload,
   ChannelSendResult,
@@ -97,10 +97,66 @@ class InAppChannelSender implements NotificationChannelSender {
     }
   }
 
+  /**
+   * P3-7: 批量发送站内消息（单次 INSERT 多行）。
+   *
+   * 相比 `Promise.all(items.map(send))` 的 N 次 INSERT，
+   * 本方法仅发起一次 DB INSERT，显著降低 fan-out 场景的 DB 压力。
+   * 失败时整体回滚，每条记录返回失败结果。
+   */
   async sendBatch(
     items: Array<{ payload: NotificationPayload; recipient: ChannelRecipient }>
   ): Promise<ChannelSendResult[]> {
-    return Promise.all(items.map((item) => this.send(item.payload, item.recipient)))
+    if (items.length === 0) return []
+    const sentAt = new Date()
+
+    // 预校验：recipient.userId 与 payload.userId 必须一致
+    const valid: Array<{
+      payload: NotificationPayload
+      recipient: ChannelRecipient
+    }> = []
+    const results: ChannelSendResult[] = []
+    for (const item of items) {
+      if (item.recipient.userId !== item.payload.userId) {
+        results.push({
+          channel,
+          success: false,
+          error: "Recipient userId does not match payload.userId",
+          sentAt,
+        })
+      } else {
+        valid.push(item)
+      }
+    }
+    if (valid.length === 0) return results
+
+    try {
+      const inputs = valid.map((item) => ({
+        userId: item.payload.userId,
+        type: mapPayloadTypeToNotificationType(item.payload.type),
+        title: item.payload.title,
+        content: item.payload.content,
+        link: item.payload.actionUrl ?? null,
+      }))
+      const ids = await createNotifications(inputs)
+      // 按输入顺序回填成功结果
+      valid.forEach((_, idx) => {
+        results.push({
+          channel,
+          success: true,
+          messageId: ids[idx],
+          sentAt,
+        })
+      })
+      return results
+    } catch (e) {
+      const error = e instanceof Error ? e.message : "In-app batch notification failed"
+      // 整体失败：所有有效项标记为失败
+      valid.forEach(() => {
+        results.push({ channel, success: false, error, sentAt })
+      })
+      return results
+    }
   }
 }
 
diff --git a/src/modules/notifications/dispatcher.ts b/src/modules/notifications/dispatcher.ts
index 2e6de5e..cb9b2b1 100644
--- a/src/modules/notifications/dispatcher.ts
+++ b/src/modules/notifications/dispatcher.ts
@@ -133,7 +133,11 @@ export async function sendNotification(
 /**
  * 批量发送通知到多个用户。
  *
- * 每个用户的渠道选择独立计算，并行发送。
+ * P3-7: 优化为批量 in_app INSERT 模式：
+ * - 并行获取所有用户的偏好和联系方式
+ * - 收集所有 in_app 渠道的 payload，单次调用 `inAppSender.sendBatch`（一次 INSERT 多行）
+ * - 其他渠道（sms/email/wechat）保持 per-payload 并行发送
+ * - 每条通知的发送日志仍按 payload 聚合记录
  *
  * @param payloads 通知负载数组（每个 payload.userId 决定各自接收人）
  * @returns 各用户各渠道的发送结果（按输入顺序对应）
@@ -141,6 +145,80 @@ export async function sendNotification(
 export async function sendBatchNotifications(
   payloads: NotificationPayload[]
 ): Promise<ChannelSendResult[][]> {
-  // 并行处理每个 payload（每条通知的日志已在 sendNotification 内部记录）
-  return Promise.all(payloads.map((p) => sendNotification(p)))
+  if (payloads.length === 0) return []
+
+  // 1. 并行获取所有用户的偏好和联系方式
+  const userContexts = await Promise.all(
+    payloads.map(async (payload) => {
+      const [prefs, contact] = await Promise.all([
+        getNotificationPreferences(payload.userId),
+        getUserContactInfo(payload.userId),
+      ])
+      return { payload, prefs, contact, channels: selectChannels(prefs, contact) }
+    })
+  )
+
+  // 2. 收集所有 in_app 渠道的 payload，单次批量发送
+  const senders = getSenders()
+  const inAppItems: Array<{
+    payload: NotificationPayload
+    recipient: ChannelRecipient
+    index: number
+  }> = []
+  for (let i = 0; i < userContexts.length; i++) {
+    const ctx = userContexts[i]
+    if (ctx.channels.includes("in_app")) {
+      inAppItems.push({ payload: ctx.payload, recipient: ctx.contact, index: i })
+    }
+  }
+
+  // 预分配结果容器：每个 payload 一组渠道结果
+  const resultsByPayload: ChannelSendResult[][] = userContexts.map(() => [])
+
+  // 3. in_app 批量发送（单次 INSERT）
+  if (inAppItems.length > 0) {
+    const inAppSender = senders.in_app
+    const inAppResults = await inAppSender.sendBatch(
+      inAppItems.map((item) => ({ payload: item.payload, recipient: item.recipient }))
+    )
+    // 回填到对应 payload 的结果数组
+    inAppItems.forEach((item, idx) => {
+      resultsByPayload[item.index].push(inAppResults[idx])
+    })
+  }
+
+  // 4. 其他渠道（sms/email/wechat）per-payload 并行发送
+  const otherChannelTasks: Array<Promise<{ index: number; results: ChannelSendResult[] }>> = []
+  for (let i = 0; i < userContexts.length; i++) {
+    const ctx = userContexts[i]
+    const otherChannels = ctx.channels.filter((ch) => ch !== "in_app")
+    if (otherChannels.length === 0) continue
+    otherChannelTasks.push(
+      (async () => {
+        const channelResults = await Promise.all(
+          otherChannels.map(async (ch) => {
+            const sender = senders[ch]
+            return sender.send(ctx.payload, ctx.contact)
+          })
+        )
+        return { index: i, results: channelResults }
+      })()
+    )
+  }
+  const otherResults = await Promise.all(otherChannelTasks)
+  for (const r of otherResults) {
+    resultsByPayload[r.index].push(...r.results)
+  }
+
+  // 5. 记录发送日志（按 payload 聚合）
+  await Promise.all(
+    payloads.map(async (payload, idx) => {
+      await logNotificationSendBatch(resultsByPayload[idx], {
+        userId: payload.userId,
+        title: payload.title,
+      })
+    })
+  )
+
+  return resultsByPayload
 }
diff --git a/src/modules/notifications/index.ts b/src/modules/notifications/index.ts
index ba1f712..0a61733 100644
--- a/src/modules/notifications/index.ts
+++ b/src/modules/notifications/index.ts
@@ -26,6 +26,7 @@
 export { sendNotification, sendBatchNotifications } from "./dispatcher"
 export {
   createNotification,
+  createNotifications,
   getNotifications,
   markNotificationAsRead,
   markAllNotificationsAsRead,
diff --git a/src/modules/onboarding/data-access.ts b/src/modules/onboarding/data-access.ts
index 65b6e88..332a6e7 100644
--- a/src/modules/onboarding/data-access.ts
+++ b/src/modules/onboarding/data-access.ts
@@ -9,6 +9,7 @@ import {
 } from "@/shared/db/schema"
 import type { Role } from "@/shared/types/permissions"
 import { resolvePrimaryRole } from "@/shared/lib/role-utils"
+import { cacheFn } from "@/shared/lib/cache"
 import type { OnboardingRoleInfo, OnboardingStatus, BindParentToChildParams } from "./types"
 
 /**
@@ -16,7 +17,7 @@ import type { OnboardingRoleInfo, OnboardingStatus, BindParentToChildParams } fr
  *
  * 角色来源：usersToRoles（管理员预分配），onboarding 不写此表。
  */
-export async function getOnboardingStatus(userId: string): Promise<OnboardingStatus> {
+export async function getOnboardingStatusRaw(userId: string): Promise<OnboardingStatus> {
   const [userRow, roleRows] = await Promise.all([
     db.query.users.findFirst({
       where: eq(users.id, userId),
@@ -42,6 +43,12 @@ export async function getOnboardingStatus(userId: string): Promise<OnboardingSta
   }
 }
 
+export const getOnboardingStatus = cacheFn(getOnboardingStatusRaw, {
+  tags: ["onboarding"],
+  ttl: 300,
+  keyParts: ["onboarding", "status"],
+})
+
 /**
  * 更新用户基础资料（姓名/电话/住址）。
  * 不涉及角色与班级绑定，独立可复用。
diff --git a/src/modules/questions/components/question-data-table.tsx b/src/modules/questions/components/question-data-table.tsx
index 2dac412..f99c474 100644
--- a/src/modules/questions/components/question-data-table.tsx
+++ b/src/modules/questions/components/question-data-table.tsx
@@ -1,13 +1,13 @@
 "use client"
 
 import * as React from "react"
+import { useVirtualizer } from "@tanstack/react-virtual"
 import { useTranslations } from "next-intl"
 import {
   ColumnDef,
   flexRender,
   getCoreRowModel,
   useReactTable,
-  getPaginationRowModel,
   SortingState,
   getSortedRowModel,
   getFilteredRowModel,
@@ -22,10 +22,13 @@ import {
   TableHeader,
   TableRow,
 } from "@/shared/components/ui/table"
-import { Button } from "@/shared/components/ui/button"
-import { ChevronLeft, ChevronRight } from "lucide-react"
 import { BatchOperations } from "./batch-operations"
 
+/** 虚拟滚动每行的预估高度(px),实际高度由 measureElement 动态测量 */
+const ROW_ESTIMATE_PX = 60
+/** 虚拟滚动容器最大高度(px) */
+const SCROLL_CONTAINER_MAX_HEIGHT_PX = 600
+
 interface DataTableProps<TData, TValue> {
   columns: ColumnDef<TData, TValue>[]
   data: TData[]
@@ -41,12 +44,12 @@ export function QuestionDataTable<TData, TValue>({
   const t = useTranslations("questions")
   const [sorting, setSorting] = React.useState<SortingState>([])
   const [rowSelection, setRowSelection] = React.useState<RowSelectionState>({})
+  const parentRef = React.useRef<HTMLDivElement>(null)
 
   const table = useReactTable({
     data,
     columns,
     getCoreRowModel: getCoreRowModel(),
-    getPaginationRowModel: getPaginationRowModel(),
     onSortingChange: setSorting,
     getSortedRowModel: getSortedRowModel(),
     onRowSelectionChange: setRowSelection,
@@ -58,6 +61,15 @@ export function QuestionDataTable<TData, TValue>({
     },
   })
 
+  const { rows } = table.getRowModel()
+
+  const virtualizer = useVirtualizer({
+    count: rows.length,
+    getScrollElement: () => parentRef.current,
+    estimateSize: () => ROW_ESTIMATE_PX,
+    overscan: 5,
+  })
+
   const selectedIds = React.useMemo(() => {
     if (!getRowId) return []
     return table.getSelectedRowModel().rows.map((row) => getRowId(row.original))
@@ -67,16 +79,28 @@ export function QuestionDataTable<TData, TValue>({
     setRowSelection({})
   }, [])
 
+  const virtualItems = virtualizer.getVirtualItems()
+  const totalSize = virtualizer.getTotalSize()
+  const paddingTop = virtualItems.length > 0 ? virtualItems[0].start : 0
+  const paddingBottom =
+    virtualItems.length > 0
+      ? totalSize - virtualItems[virtualItems.length - 1].end
+      : 0
+
   return (
     <div className="space-y-4">
       {selectedIds.length > 0 && (
         <BatchOperations selectedIds={selectedIds} onClearSelection={clearSelection} />
       )}
-      <div className="rounded-md border">
+      <div
+        ref={parentRef}
+        className="overflow-auto rounded-md border"
+        style={{ maxHeight: SCROLL_CONTAINER_MAX_HEIGHT_PX }}
+      >
         <Table>
-          <TableHeader>
+          <TableHeader className="sticky top-0 z-10 bg-card">
             {table.getHeaderGroups().map((headerGroup) => (
-              <TableRow key={headerGroup.id}>
+              <TableRow key={headerGroup.id} className="hover:bg-transparent">
                 {headerGroup.headers.map((header) => {
                   return (
                     <TableHead key={header.id}>
@@ -93,22 +117,45 @@ export function QuestionDataTable<TData, TValue>({
             ))}
           </TableHeader>
           <TableBody>
-            {table.getRowModel().rows?.length ? (
-              table.getRowModel().rows.map((row) => (
-                <TableRow
-                  key={row.id}
-                  data-state={row.getIsSelected() && "selected"}
-                >
-                  {row.getVisibleCells().map((cell) => (
-                    <TableCell key={cell.id}>
-                      {flexRender(
-                        cell.column.columnDef.cell,
-                        cell.getContext()
-                      )}
-                    </TableCell>
-                  ))}
-                </TableRow>
-              ))
+            {rows.length ? (
+              <>
+                {paddingTop > 0 && (
+                  <tr aria-hidden="true">
+                    <td
+                      style={{ height: paddingTop, padding: 0, border: 0 }}
+                      colSpan={columns.length}
+                    />
+                  </tr>
+                )}
+                {virtualItems.map((virtualItem) => {
+                  const row = rows[virtualItem.index]
+                  return (
+                    <TableRow
+                      key={row.id}
+                      data-state={row.getIsSelected() && "selected"}
+                      data-index={virtualItem.index}
+                      ref={virtualizer.measureElement}
+                    >
+                      {row.getVisibleCells().map((cell) => (
+                        <TableCell key={cell.id}>
+                          {flexRender(
+                            cell.column.columnDef.cell,
+                            cell.getContext()
+                          )}
+                        </TableCell>
+                      ))}
+                    </TableRow>
+                  )
+                })}
+                {paddingBottom > 0 && (
+                  <tr aria-hidden="true">
+                    <td
+                      style={{ height: paddingBottom, padding: 0, border: 0 }}
+                      colSpan={columns.length}
+                    />
+                  </tr>
+                )}
+              </>
             ) : (
               <TableRow>
                 <TableCell
@@ -129,26 +176,6 @@ export function QuestionDataTable<TData, TValue>({
             total: table.getFilteredRowModel().rows.length,
           })}
         </div>
-        <div className="space-x-2">
-          <Button
-            variant="outline"
-            size="sm"
-            onClick={() => table.previousPage()}
-            disabled={!table.getCanPreviousPage()}
-          >
-            <ChevronLeft className="h-4 w-4" />
-            {t("table.previous")}
-          </Button>
-          <Button
-            variant="outline"
-            size="sm"
-            onClick={() => table.nextPage()}
-            disabled={!table.getCanNextPage()}
-          >
-            {t("table.next")}
-            <ChevronRight className="h-4 w-4" />
-          </Button>
-        </div>
       </div>
     </div>
   )
diff --git a/src/modules/scheduling/data-access.ts b/src/modules/scheduling/data-access.ts
index af57952..cbd4494 100644
--- a/src/modules/scheduling/data-access.ts
+++ b/src/modules/scheduling/data-access.ts
@@ -4,6 +4,7 @@ import { and, asc, desc, eq, inArray, isNull, or, type SQL } from "drizzle-orm"
 import { createId } from "@paralleldrive/cuid2"
 
 import { db } from "@/shared/db"
+import { cacheFn } from "@/shared/lib/cache"
 import {
   classes,
   classSchedule,
@@ -41,7 +42,7 @@ const mapRule = (r: typeof schedulingRules.$inferSelect): SchedulingRule => ({
   updatedAt: r.updatedAt.toISOString(),
 })
 
-export async function getSchedulingRules(classId?: string): Promise<SchedulingRule[]> {
+export async function getSchedulingRulesRaw(classId?: string): Promise<SchedulingRule[]> {
   const conditions: SQL[] = []
   if (classId) {
     const cond = or(eq(schedulingRules.classId, classId), isNull(schedulingRules.classId))
@@ -57,6 +58,12 @@ export async function getSchedulingRules(classId?: string): Promise<SchedulingRu
   return rows.map(mapRule)
 }
 
+export const getSchedulingRules = cacheFn(getSchedulingRulesRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "rules"],
+})
+
 export async function upsertSchedulingRules(data: SchedulingRuleInput): Promise<string> {
   const [existing] = await db
     .select()
@@ -98,7 +105,7 @@ export async function upsertSchedulingRules(data: SchedulingRuleInput): Promise<
   return id
 }
 
-export async function getScheduleChanges(
+export async function getScheduleChangesRaw(
   params: ScheduleChangeQueryParams
 ): Promise<ScheduleChangeListItem[]> {
   const conditions: SQL[] = []
@@ -164,6 +171,12 @@ export async function getScheduleChanges(
   }))
 }
 
+export const getScheduleChanges = cacheFn(getScheduleChangesRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "changes"],
+})
+
 export async function createScheduleChange(
   data: ScheduleChangeInput,
   requestedBy: string
@@ -197,7 +210,7 @@ export async function updateScheduleChangeStatus(
     .where(eq(scheduleChanges.id, id))
 }
 
-export async function getClassConflicts(classId: string): Promise<ScheduleConflict[]> {
+export async function getClassConflictsRaw(classId: string): Promise<ScheduleConflict[]> {
   const rows = await db
     .select({
       id: classSchedule.id,
@@ -260,14 +273,26 @@ export type SchedulingClassSubject = {
   teacherId: string | null
 }
 
-export async function getAdminClassesForScheduling(): Promise<SchedulingClassOption[]> {
+export const getClassConflicts = cacheFn(getClassConflictsRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "conflicts"],
+})
+
+export async function getAdminClassesForSchedulingRaw(): Promise<SchedulingClassOption[]> {
   return await db
     .select({ id: classes.id, name: classes.name, grade: classes.grade })
     .from(classes)
     .orderBy(classes.grade, classes.name)
 }
 
-export async function getTeachersForScheduling(): Promise<SchedulingTeacherOption[]> {
+export const getAdminClassesForScheduling = cacheFn(getAdminClassesForSchedulingRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "admin-classes"],
+})
+
+export async function getTeachersForSchedulingRaw(): Promise<SchedulingTeacherOption[]> {
   return await db
     .select({ id: users.id, name: users.name, email: users.email })
     .from(users)
@@ -276,14 +301,26 @@ export async function getTeachersForScheduling(): Promise<SchedulingTeacherOptio
     .orderBy(users.name)
 }
 
-export async function getClassroomsForScheduling(): Promise<SchedulingClassroomOption[]> {
+export const getTeachersForScheduling = cacheFn(getTeachersForSchedulingRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "teachers"],
+})
+
+export async function getClassroomsForSchedulingRaw(): Promise<SchedulingClassroomOption[]> {
   return await db
     .select({ id: classrooms.id, name: classrooms.name, building: classrooms.building })
     .from(classrooms)
     .orderBy(classrooms.name)
 }
 
-export async function getClassSubjectsForScheduling(
+export const getClassroomsForScheduling = cacheFn(getClassroomsForSchedulingRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "classrooms"],
+})
+
+export async function getClassSubjectsForSchedulingRaw(
   classId: string
 ): Promise<SchedulingClassSubject[]> {
   return await db
@@ -297,6 +334,12 @@ export async function getClassSubjectsForScheduling(
     .where(eq(classSubjectTeachers.classId, classId))
 }
 
+export const getClassSubjectsForScheduling = cacheFn(getClassSubjectsForSchedulingRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "class-subjects"],
+})
+
 // ---------------------------------------------------------------------------
 // Unified classSchedule write entry points
 // ---------------------------------------------------------------------------
@@ -416,6 +459,12 @@ export type ScheduleEntry = {
  * implementation should join classSchedule with classes/users to
  * populate teacherName/className/subject/room.
  */
-export async function getScheduleEntriesForAdmin(): Promise<ScheduleEntry[]> {
+export async function getScheduleEntriesForAdminRaw(): Promise<ScheduleEntry[]> {
   return []
 }
+
+export const getScheduleEntriesForAdmin = cacheFn(getScheduleEntriesForAdminRaw, {
+  tags: ["scheduling"],
+  ttl: 300,
+  keyParts: ["scheduling", "entries", "admin"],
+})
diff --git a/src/modules/search/data-access.ts b/src/modules/search/data-access.ts
new file mode 100644
index 0000000..0e06062
--- /dev/null
+++ b/src/modules/search/data-access.ts
@@ -0,0 +1,260 @@
+import "server-only"
+
+import { and, desc, eq, like, or, sql } from "drizzle-orm"
+
+import { db } from "@/shared/db"
+import { announcements, exams, questions, textbooks } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
+
+import type { SearchResultItem } from "./types"
+
+/**
+ * 全文检索数据访问层。
+ *
+ * 设计说明：
+ * - 本模块封装跨 4 张表的模糊查询，供 `app/api/search/route.ts` 调用
+ * - 各查询函数返回 `SearchResultItem[]`，路由层负责聚合与分页
+ * - 单个查询失败时返回空数组，避免拖垮整体搜索
+ * - P3-6：questions 表使用 FULLTEXT 索引（content_text 生成列）+ MATCH AGAINST BOOLEAN MODE
+ *   其他表（textbooks/exams/announcements）仍用 LIKE 模糊匹配
+ *
+ * 安全：
+ * - 调用方需通过 `getAuthContext()` 校验身份
+ * - 角色过滤（学生不能搜索题目/考试）由调用方在路由层处理
+ */
+
+const DEFAULT_PAGE_SIZE = 10
+
+/**
+ * 从 JSON 内容字段提取纯文本（用于题目内容展示）。
+ */
+function extractTextFromJson(content: unknown): string {
+  if (typeof content === "string") return content
+  try {
+    return JSON.stringify(content)
+  } catch {
+    return ""
+  }
+}
+
+/**
+ * 移除 HTML 标签（用于公告内容摘要）。
+ */
+function stripHtml(html: string): string {
+  return html.replace(/<[^>]*>/g, "").replace(/\s+/g, " ").trim()
+}
+
+/**
+ * 截断字符串并附加省略号。
+ */
+function truncate(s: string, max: number): string {
+  const t = s.trim()
+  if (t.length <= max) return t
+  return t.slice(0, max) + "..."
+}
+
+/**
+ * P3-6: 将原始查询字符串转换为 MySQL FULLTEXT BOOLEAN MODE 查询格式。
+ *
+ * 转换规则：
+ * - 按空白拆分为多个词
+ * - 转义 BOOLEAN MODE 特殊字符（+ - < > ( ) ~ * " '）
+ * - 每个词添加 `+` 前缀（必须出现）和 `*` 后缀（前缀匹配）
+ * - 例如 "math question" → "+math* +question*"
+ *
+ * @param q 原始查询字符串
+ * @returns BOOLEAN MODE 兼容的查询字符串；空查询返回空串
+ */
+function toBooleanModeQuery(q: string): string {
+  const words = q.trim().split(/\s+/).filter(Boolean)
+  if (words.length === 0) return ""
+  // 转义 BOOLEAN MODE 特殊字符，避免用户输入破坏查询语法
+  const escapeWord = (w: string): string => `+${w.replace(/[+\-<>()~*"']/g, " ").trim()}*`
+  return words.map(escapeWord).filter((w) => w !== "+*").join(" ")
+}
+
+/**
+ * 搜索题目（题库）。
+ *
+ * P3-6: 使用 `questions.content_text` STORED 生成列上的 FULLTEXT 索引，
+ * 通过 `MATCH(content_text) AGAINST(? IN BOOLEAN MODE)` 实现高效全文检索。
+ * 相比原 `LIKE '%xxx%'` 方案，可利用 FULLTEXT 索引大幅提升大表查询性能。
+ *
+ * @param q 原始查询字符串（非 %keyword% 格式）
+ * @param limit 返回结果上限
+ */
+export async function searchQuestionsRaw(
+  q: string,
+  limit: number = DEFAULT_PAGE_SIZE,
+): Promise<SearchResultItem[]> {
+  const booleanQuery = toBooleanModeQuery(q)
+  if (!booleanQuery) return []
+  try {
+    const rows = await db
+      .select({
+        id: questions.id,
+        content: questions.content,
+        type: questions.type,
+        createdAt: questions.createdAt,
+      })
+      .from(questions)
+      .where(sql`MATCH(${questions.contentText}) AGAINST(${booleanQuery} IN BOOLEAN MODE)`)
+      .orderBy(desc(questions.createdAt))
+      .limit(limit)
+
+    return rows.map((r) => {
+      const text = extractTextFromJson(r.content)
+      return {
+        id: r.id,
+        title: truncate(text, 80) || `Question (${r.type})`,
+        snippet: truncate(text, 200),
+        type: "question" as const,
+        href: `/admin/questions?id=${r.id}`,
+        createdAt: r.createdAt.toISOString(),
+      }
+    })
+  } catch {
+    return []
+  }
+}
+
+export const searchQuestions = cacheFn(searchQuestionsRaw, {
+  tags: ["search"],
+  ttl: 300,
+  keyParts: ["search", "questions"],
+})
+
+/**
+ * 搜索教材。
+ */
+export async function searchTextbooksRaw(
+  kw: string,
+  limit: number = DEFAULT_PAGE_SIZE,
+): Promise<SearchResultItem[]> {
+  try {
+    const rows = await db
+      .select({
+        id: textbooks.id,
+        title: textbooks.title,
+        subject: textbooks.subject,
+        grade: textbooks.grade,
+        publisher: textbooks.publisher,
+        createdAt: textbooks.createdAt,
+      })
+      .from(textbooks)
+      .where(
+        or(
+          like(textbooks.title, kw),
+          like(textbooks.subject, kw),
+          like(textbooks.publisher, kw),
+        )!,
+      )
+      .orderBy(desc(textbooks.createdAt))
+      .limit(limit)
+
+    return rows.map((r) => ({
+      id: r.id,
+      title: r.title,
+      snippet: [r.subject, r.grade, r.publisher].filter(Boolean).join(" · "),
+      type: "textbook" as const,
+      href: `/admin/textbooks?id=${r.id}`,
+      createdAt: r.createdAt.toISOString(),
+    }))
+  } catch {
+    return []
+  }
+}
+
+export const searchTextbooks = cacheFn(searchTextbooksRaw, {
+  tags: ["search"],
+  ttl: 300,
+  keyParts: ["search", "textbooks"],
+})
+
+/**
+ * 搜索试卷。
+ */
+export async function searchExamsRaw(
+  kw: string,
+  limit: number = DEFAULT_PAGE_SIZE,
+): Promise<SearchResultItem[]> {
+  try {
+    const rows = await db
+      .select({
+        id: exams.id,
+        title: exams.title,
+        description: exams.description,
+        status: exams.status,
+        createdAt: exams.createdAt,
+      })
+      .from(exams)
+      .where(or(like(exams.title, kw), like(exams.description, kw))!)
+      .orderBy(desc(exams.createdAt))
+      .limit(limit)
+
+    return rows.map((r) => ({
+      id: r.id,
+      title: r.title,
+      snippet: r.description ?? `Status: ${r.status ?? "draft"}`,
+      type: "exam" as const,
+      href: `/admin/exams?id=${r.id}`,
+      createdAt: r.createdAt.toISOString(),
+    }))
+  } catch {
+    return []
+  }
+}
+
+export const searchExams = cacheFn(searchExamsRaw, {
+  tags: ["search"],
+  ttl: 300,
+  keyParts: ["search", "exams"],
+})
+
+/**
+ * 搜索公告（仅返回已发布的公告）。
+ */
+export async function searchAnnouncementsRaw(
+  kw: string,
+  limit: number = DEFAULT_PAGE_SIZE,
+): Promise<SearchResultItem[]> {
+  try {
+    const rows = await db
+      .select({
+        id: announcements.id,
+        title: announcements.title,
+        content: announcements.content,
+        type: announcements.type,
+        status: announcements.status,
+        createdAt: announcements.createdAt,
+      })
+      .from(announcements)
+      .where(
+        and(
+          eq(announcements.status, "published"),
+          or(like(announcements.title, kw), like(announcements.content, kw))!,
+        ),
+      )
+      .orderBy(desc(announcements.createdAt))
+      .limit(limit)
+
+    return rows.map((r) => ({
+      id: r.id,
+      title: r.title,
+      snippet: truncate(stripHtml(r.content), 200),
+      type: "announcement" as const,
+      href: `/announcements/${r.id}`,
+      createdAt: r.createdAt.toISOString(),
+    }))
+  } catch {
+    return []
+  }
+}
+
+export const searchAnnouncements = cacheFn(searchAnnouncementsRaw, {
+  tags: ["search"],
+  ttl: 300,
+  keyParts: ["search", "announcements"],
+})
+
+export const DEFAULT_SEARCH_PAGE_SIZE = DEFAULT_PAGE_SIZE
diff --git a/src/modules/search/types.ts b/src/modules/search/types.ts
new file mode 100644
index 0000000..d83df65
--- /dev/null
+++ b/src/modules/search/types.ts
@@ -0,0 +1,31 @@
+/**
+ * Search 模块类型定义。
+ */
+
+export type SearchType = "all" | "question" | "textbook" | "exam" | "announcement"
+
+export interface SearchResultItem {
+  id: string
+  title: string
+  snippet: string
+  type: "question" | "textbook" | "exam" | "announcement"
+  href: string
+  createdAt: string
+}
+
+export interface SearchResponse {
+  success: boolean
+  query: string
+  type: SearchType
+  results: SearchResultItem[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+export const isSearchType = (v: string): v is SearchType =>
+  v === "all" ||
+  v === "question" ||
+  v === "textbook" ||
+  v === "exam" ||
+  v === "announcement"
diff --git a/src/modules/settings/data-access-brand.ts b/src/modules/settings/data-access-brand.ts
index 97c2b43..109b524 100644
--- a/src/modules/settings/data-access-brand.ts
+++ b/src/modules/settings/data-access-brand.ts
@@ -5,6 +5,7 @@ import {
   upsertSystemSetting,
 } from "@/modules/settings/data-access-system-settings"
 import { DEFAULT_BRAND_CONFIG, type BrandConfig } from "@/modules/settings/brand-config"
+import { cacheFn } from "@/shared/lib/cache"
 
 export type { BrandConfig }
 export { DEFAULT_BRAND_CONFIG }
@@ -22,7 +23,7 @@ const BRAND_KEYS = {
  *
  * 从 system_settings 表 brand 分类读取，未配置项使用默认值。
  */
-export async function getBrandConfig(): Promise<BrandConfig> {
+export async function getBrandConfigRaw(): Promise<BrandConfig> {
   const [schoolNameRow, logoUrlRow, quoteRow, authorRow] = await Promise.all([
     getSystemSetting("brand", BRAND_KEYS.schoolName),
     getSystemSetting("brand", BRAND_KEYS.logoUrl),
@@ -38,6 +39,12 @@ export async function getBrandConfig(): Promise<BrandConfig> {
   }
 }
 
+export const getBrandConfig = cacheFn(getBrandConfigRaw, {
+  tags: ["settings"],
+  ttl: 600,
+  keyParts: ["settings", "brand-config"],
+})
+
 /**
  * 保存品牌配置（audit-P2-6 新增）
  */
diff --git a/src/modules/settings/data-access-profile-overview.ts b/src/modules/settings/data-access-profile-overview.ts
index 135cb73..9d11a02 100644
--- a/src/modules/settings/data-access-profile-overview.ts
+++ b/src/modules/settings/data-access-profile-overview.ts
@@ -4,6 +4,7 @@ import { getStudentClasses, getStudentSchedule } from "@/modules/classes/data-ac
 import { getStudentHomeworkAssignments } from "@/modules/homework/data-access-student"
 import { getStudentDashboardGrades } from "@/modules/homework/stats-service"
 import { getTeacherClasses, getTeacherTeachingSubjects } from "@/modules/classes/data-access"
+import { cacheFn } from "@/shared/lib/cache"
 
 /**
  * Profile 概览数据访问层
@@ -16,7 +17,7 @@ import { getTeacherClasses, getTeacherTeachingSubjects } from "@/modules/classes
 /**
  * 获取学生概览所需的所有数据（并行查询）
  */
-export async function getStudentProfileOverviewData(userId: string): Promise<{
+export async function getStudentProfileOverviewDataRaw(userId: string): Promise<{
   classes: Awaited<ReturnType<typeof getStudentClasses>>
   schedule: Awaited<ReturnType<typeof getStudentSchedule>>
   assignments: Awaited<ReturnType<typeof getStudentHomeworkAssignments>>
@@ -30,11 +31,16 @@ export async function getStudentProfileOverviewData(userId: string): Promise<{
   ])
   return { classes, schedule, assignments, grades }
 }
+export const getStudentProfileOverviewData = cacheFn(getStudentProfileOverviewDataRaw, {
+  tags: ["settings:students"],
+  ttl: 60,
+  keyParts: ["settings", "profile-overview", "student"],
+})
 
 /**
  * 获取教师概览所需的所有数据（并行查询）
  */
-export async function getTeacherProfileOverviewData(): Promise<{
+export async function getTeacherProfileOverviewDataRaw(): Promise<{
   subjects: Awaited<ReturnType<typeof getTeacherTeachingSubjects>>
   classes: Awaited<ReturnType<typeof getTeacherClasses>>
 }> {
@@ -44,3 +50,8 @@ export async function getTeacherProfileOverviewData(): Promise<{
   ])
   return { subjects, classes }
 }
+export const getTeacherProfileOverviewData = cacheFn(getTeacherProfileOverviewDataRaw, {
+  tags: ["settings"],
+  ttl: 600,
+  keyParts: ["settings", "profile-overview", "teacher"],
+})
diff --git a/src/modules/settings/data-access-system-settings.ts b/src/modules/settings/data-access-system-settings.ts
index 436f022..42577cb 100644
--- a/src/modules/settings/data-access-system-settings.ts
+++ b/src/modules/settings/data-access-system-settings.ts
@@ -4,6 +4,7 @@ import { and, eq } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import { systemSettings } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 // --- System Settings operations ---
 
@@ -42,7 +43,7 @@ export interface SystemSettingRecord {
 /**
  * 获取指定分类下所有设置项
  */
-export async function getSystemSettingsByCategory(
+export async function getSystemSettingsByCategoryRaw(
   category: SystemSettingCategory
 ): Promise<SystemSettingRecord[]> {
   const rows = await db
@@ -52,18 +53,30 @@ export async function getSystemSettingsByCategory(
   return rows
 }
 
+export const getSystemSettingsByCategory = cacheFn(getSystemSettingsByCategoryRaw, {
+  tags: ["settings"],
+  ttl: 300,
+  keyParts: ["settings", "system-settings", "by-category"],
+})
+
 /**
  * 获取所有系统设置项
  */
-export async function getAllSystemSettings(): Promise<SystemSettingRecord[]> {
+export async function getAllSystemSettingsRaw(): Promise<SystemSettingRecord[]> {
   const rows = await db.select().from(systemSettings)
   return rows
 }
 
+export const getAllSystemSettings = cacheFn(getAllSystemSettingsRaw, {
+  tags: ["settings"],
+  ttl: 300,
+  keyParts: ["settings", "system-settings", "all"],
+})
+
 /**
  * 获取单个设置项
  */
-export async function getSystemSetting(
+export async function getSystemSettingRaw(
   category: SystemSettingCategory,
   key: string
 ): Promise<SystemSettingRecord | null> {
@@ -75,6 +88,12 @@ export async function getSystemSetting(
   return row ?? null
 }
 
+export const getSystemSetting = cacheFn(getSystemSettingRaw, {
+  tags: ["settings"],
+  ttl: 600,
+  keyParts: ["settings", "system-settings", "by-key"],
+})
+
 /**
  * 插入或更新设置项（upsert）
  */
diff --git a/src/modules/settings/data-access.ts b/src/modules/settings/data-access.ts
index 2c3ecfe..7fb343e 100644
--- a/src/modules/settings/data-access.ts
+++ b/src/modules/settings/data-access.ts
@@ -4,6 +4,7 @@ import { count, desc, eq, or } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import { aiProviders, passwordSecurity, users } from "@/shared/db/schema"
+import { cacheFn } from "@/shared/lib/cache"
 
 import type {
   AiProviderExisting,
@@ -19,7 +20,7 @@ import type {
  *
  * 返回所有 public 与 private 记录，供管理员在 /admin/ai-settings 中管理。
  */
-export async function getAiProviderSummaries(): Promise<AiProviderSummary[]> {
+export async function getAiProviderSummariesRaw(): Promise<AiProviderSummary[]> {
   const rows = await db
     .select({
       id: aiProviders.id,
@@ -37,6 +38,12 @@ export async function getAiProviderSummaries(): Promise<AiProviderSummary[]> {
   return rows
 }
 
+export const getAiProviderSummaries = cacheFn(getAiProviderSummariesRaw, {
+  tags: ["settings"],
+  ttl: 300,
+  keyParts: ["settings", "ai-providers", "summaries"],
+})
+
 /**
  * 获取当前用户可见的 AI Provider（用户视图）
  *
@@ -46,7 +53,7 @@ export async function getAiProviderSummaries(): Promise<AiProviderSummary[]> {
  *
  * @param userId 当前用户 ID
  */
-export async function getAiProviderSummariesForUser(
+export async function getAiProviderSummariesForUserRaw(
   userId: string
 ): Promise<AiProviderSummary[]> {
   const rows = await db
@@ -72,7 +79,13 @@ export async function getAiProviderSummariesForUser(
   return rows
 }
 
-export async function countDefaultAiProviders(): Promise<number> {
+export const getAiProviderSummariesForUser = cacheFn(getAiProviderSummariesForUserRaw, {
+  tags: ["settings"],
+  ttl: 300,
+  keyParts: ["settings", "ai-providers", "summaries-by-user"],
+})
+
+export async function countDefaultAiProvidersRaw(): Promise<number> {
   const [row] = await db
     .select({ value: count() })
     .from(aiProviders)
@@ -80,12 +93,18 @@ export async function countDefaultAiProviders(): Promise<number> {
   return Number(row?.value ?? 0)
 }
 
+export const countDefaultAiProviders = cacheFn(countDefaultAiProvidersRaw, {
+  tags: ["settings"],
+  ttl: 60,
+  keyParts: ["settings", "ai-providers", "default-count"],
+})
+
 /**
  * 获取 Provider 用于更新（管理员或创建者视图）
  *
  * 管理员可访问任意 Provider；非管理员仅能访问自己创建的 private Provider。
  */
-export async function getAiProviderForUpdate(
+export async function getAiProviderForUpdateRaw(
   id: string,
   userId?: string
 ): Promise<AiProviderExisting | null> {
@@ -111,6 +130,12 @@ export async function getAiProviderForUpdate(
   return row
 }
 
+export const getAiProviderForUpdate = cacheFn(getAiProviderForUpdateRaw, {
+  tags: ["settings"],
+  ttl: 600,
+  keyParts: ["settings", "ai-providers", "for-update"],
+})
+
 export async function updateAiProvider(
   id: string,
   data: {
diff --git a/src/modules/standards/data-access.ts b/src/modules/standards/data-access.ts
index b43fec2..c378ea7 100644
--- a/src/modules/standards/data-access.ts
+++ b/src/modules/standards/data-access.ts
@@ -7,6 +7,7 @@
 import "server-only";
 import { db } from "@/shared/db";
 import { standards, lessonPlanStandards } from "@/shared/db/schema";
+import { cacheFn } from "@/shared/lib/cache";
 import { and, eq, asc, like } from "drizzle-orm";
 import type {
   Standard,
@@ -19,7 +20,7 @@ import type { StandardLevel } from "../lesson-preparation/lib/type-guards";
 /**
  * 查询课标列表（可按层级/学科/年级过滤，可选返回树形结构）
  */
-export async function getStandards(
+export async function getStandardsRaw(
   params: GetStandardsParams = {},
 ): Promise<Standard[]> {
   const conditions = [];
@@ -39,35 +40,51 @@ export async function getStandards(
   return rows.map(mapRowToStandard);
 }
 
-/**
- * 查询课标树形结构
- */
-export async function getStandardsTree(
+export const getStandards = cacheFn(getStandardsRaw, {
+  tags: ["standards"],
+  ttl: 300,
+  keyParts: ["standards", "list"],
+})
+
+
+export async function getStandardsTreeRaw(
   params: Omit<GetStandardsParams, "asTree" | "parentId"> = {},
 ): Promise<StandardTreeNode[]> {
-  const allStandards = await getStandards(params);
+  const allStandards = await getStandardsRaw(params);
   return buildStandardsTree(allStandards);
 }
 
-/**
- * 按 ID 获取单个课标
- */
-export async function getStandardById(id: string): Promise<Standard | null> {
+export const getStandardsTree = cacheFn(getStandardsTreeRaw, {
+  tags: ["standards"],
+  ttl: 300,
+  keyParts: ["standards", "tree"],
+})
+
+
+export async function getStandardByIdRaw(id: string): Promise<Standard | null> {
   const rows = await db.select().from(standards).where(eq(standards.id, id)).limit(1);
   return rows.length === 0 ? null : mapRowToStandard(rows[0]!);
 }
 
-/**
- * 按 code 获取单个课标
- */
-export async function getStandardByCode(code: string): Promise<Standard | null> {
+export const getStandardById = cacheFn(getStandardByIdRaw, {
+  tags: ["standards"],
+  ttl: 600,
+  keyParts: ["standards", "by-id"],
+})
+
+
+export async function getStandardByCodeRaw(code: string): Promise<Standard | null> {
   const rows = await db.select().from(standards).where(eq(standards.code, code)).limit(1);
   return rows.length === 0 ? null : mapRowToStandard(rows[0]!);
 }
 
-/**
- * 创建课标
- */
+export const getStandardByCode = cacheFn(getStandardByCodeRaw, {
+  tags: ["standards"],
+  ttl: 600,
+  keyParts: ["standards", "by-code"],
+})
+
+
 export async function createStandard(
   input: {
     code: string;
@@ -137,7 +154,7 @@ export async function deactivateStandard(id: string): Promise<void> {
 /**
  * 按关键词搜索课标
  */
-export async function searchStandards(
+export async function searchStandardsRaw(
   keyword: string,
   limit = 50,
 ): Promise<Standard[]> {
@@ -150,12 +167,18 @@ export async function searchStandards(
   return rows.map(mapRowToStandard);
 }
 
+export const searchStandards = cacheFn(searchStandardsRaw, {
+  tags: ["standards"],
+  ttl: 300,
+  keyParts: ["standards", "search"],
+})
+
 // ---- 课案 ↔ 课标 关联 ----
 
 /**
  * 查询课案关联的所有课标
  */
-export async function getStandardsByPlanId(
+export async function getStandardsByPlanIdRaw(
   planId: string,
 ): Promise<LessonPlanStandardLink[]> {
   const rows = await db
@@ -179,9 +202,13 @@ export async function getStandardsByPlanId(
   }));
 }
 
-/**
- * 关联课案与课标
- */
+export const getStandardsByPlanId = cacheFn(getStandardsByPlanIdRaw, {
+  tags: ["standards"],
+  ttl: 300,
+  keyParts: ["standards", "by-plan"],
+})
+
+
 export async function linkPlanToStandard(
   planId: string,
   standardId: string,
diff --git a/src/modules/textbooks/components/knowledge-graph-inner.tsx b/src/modules/textbooks/components/knowledge-graph-inner.tsx
new file mode 100644
index 0000000..d4e54ad
--- /dev/null
+++ b/src/modules/textbooks/components/knowledge-graph-inner.tsx
@@ -0,0 +1,411 @@
+"use client"
+
+/**
+ * ReactFlow 知识图谱内部实现。
+ *
+ * 通过 next/dynamic 在外层 `knowledge-graph.tsx` 中懒加载,
+ * 避免 @xyflow/react (~80-100 KB) 打入首屏 chunk。
+ * 外层使用 ReactFlowProvider 包裹本组件,保证 useReactFlow() hook 可用。
+ */
+
+import { useState, useMemo, useCallback } from "react"
+import {
+  ReactFlow,
+  Background,
+  BackgroundVariant,
+  Controls,
+  MiniMap,
+  useReactFlow,
+  type Node,
+  type Edge,
+} from "@xyflow/react"
+import "@xyflow/react/dist/style.css"
+import { useTranslations } from "next-intl"
+import { notify } from "@/shared/lib/notify"
+import { Share2 } from "lucide-react"
+import { usePermission } from "@/shared/hooks/use-permission"
+import { Permissions } from "@/shared/types/permissions"
+import { EmptyState } from "@/shared/components/ui/empty-state"
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/shared/components/ui/select"
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog"
+import { Button } from "@/shared/components/ui/button"
+import type { GraphLayoutMode, GraphViewMode, GraphNodeData } from "../types"
+import { computeGraphLayout } from "../graph-layout"
+import type { GraphLayoutNodeData } from "../graph-layout"
+import { useGraphData } from "../hooks/use-graph-data"
+import {
+  createPrerequisiteAction,
+  deletePrerequisiteAction,
+} from "../actions"
+import { GraphKpNode } from "./graph-kp-node"
+import { GraphPrerequisiteEdge } from "./graph-prerequisite-edge"
+import { GraphToolbar } from "./graph-toolbar"
+import { GraphNodeDetailPanel } from "./graph-node-detail-panel"
+import { ForceKnowledgeGraph } from "./force-graph"
+
+const nodeTypes = { kpNode: GraphKpNode }
+const edgeTypes = { prerequisiteEdge: GraphPrerequisiteEdge }
+
+/** 章节颜色调色板 */
+const CHAPTER_COLORS = [
+  "hsl(var(--graph-node-1))", "hsl(var(--graph-node-2))", "hsl(var(--graph-node-3))", "hsl(var(--graph-node-4))",
+  "hsl(var(--graph-node-5))", "hsl(var(--graph-node-6))", "hsl(var(--graph-node-1))", "hsl(var(--graph-node-2))",
+]
+
+export interface KnowledgeGraphProps {
+  textbookId: string
+  /** 初始视图模式,默认 structure */
+  initialViewMode?: GraphViewMode
+  /** 初始布局模式,默认 hierarchical(分层有向图) */
+  initialLayoutMode?: GraphLayoutMode
+}
+
+export function KnowledgeGraphInner({
+  textbookId,
+  initialViewMode = "structure",
+  initialLayoutMode = "hierarchical",
+}: KnowledgeGraphProps) {
+  const t = useTranslations("textbooks")
+  const { hasPermission } = usePermission()
+  const canEdit = hasPermission(Permissions.TEXTBOOK_UPDATE)
+  const reactFlow = useReactFlow()
+
+  const [viewMode, setViewMode] = useState<GraphViewMode>(initialViewMode)
+  const [layoutMode, setLayoutMode] = useState<GraphLayoutMode>(initialLayoutMode)
+  const [searchText, setSearchText] = useState("")
+  const [selectedKpId, setSelectedKpId] = useState<string | null>(null)
+  // 添加前置依赖对话框状态
+  const [addPrereqOpen, setAddPrereqOpen] = useState(false)
+  const [newPrereqId, setNewPrereqId] = useState<string>("")
+  const [isSavingPrereq, setIsSavingPrereq] = useState(false)
+
+  const { data, isLoading, isRefreshing, error, reload } = useGraphData(textbookId, viewMode)
+
+  // 教师可查看班级掌握度,学生可查看个人掌握度
+  const availableViewModes: GraphViewMode[] = canEdit
+    ? ["structure", "class-mastery"]
+    : ["structure", "student-mastery"]
+
+  // 章节颜色映射
+  const chapterColorMap = useMemo(() => {
+    const map = new Map<string, string>()
+    if (!data) return map
+    const chapterIds = [...new Set(
+      data.knowledgePoints
+        .map((kp) => kp.chapterId)
+        .filter((id): id is string => id !== null),
+    )]
+    chapterIds.forEach((id, index) => {
+      map.set(id, CHAPTER_COLORS[index % CHAPTER_COLORS.length]!)
+    })
+    return map
+  }, [data])
+
+  const layout = useMemo(() => {
+    if (!data) return { nodes: [], edges: [], width: 0, height: 0 }
+    return computeGraphLayout(data.knowledgePoints)
+  }, [data])
+
+  // 搜索高亮
+  const matchedIds = useMemo(() => {
+    if (!searchText || !data) return new Set<string>()
+    const searchLower = searchText.toLowerCase()
+    return new Set(
+      data.knowledgePoints
+        .filter((kp) => kp.name.toLowerCase().includes(searchLower))
+        .map((kp) => kp.id),
+    )
+  }, [searchText, data])
+
+  // 关联节点高亮(选中节点的前置+后置)
+  const relatedIds = useMemo(() => {
+    if (!selectedKpId || !data) return new Set<string>()
+    const related = new Set<string>([selectedKpId])
+    const selectedKp = data.knowledgePoints.find((kp) => kp.id === selectedKpId)
+    if (selectedKp) {
+      for (const id of selectedKp.prerequisiteIds) related.add(id)
+      for (const kp of data.knowledgePoints) {
+        if (kp.prerequisiteIds.includes(selectedKpId)) related.add(kp.id)
+      }
+    }
+    return related
+  }, [selectedKpId, data])
+
+  // 从已加载数据计算前置/后置列表(避免 server-only 导入)
+  const prerequisites = useMemo<{ id: string; name: string; description: string | null }[]>(() => {
+    if (!selectedKpId || !data) return []
+    const selectedKp = data.knowledgePoints.find((kp) => kp.id === selectedKpId)
+    if (!selectedKp) return []
+    return data.knowledgePoints
+      .filter((kp) => selectedKp.prerequisiteIds.includes(kp.id))
+      .map((kp) => ({ id: kp.id, name: kp.name, description: kp.description }))
+  }, [selectedKpId, data])
+
+  const successors = useMemo<{ id: string; name: string; description: string | null }[]>(() => {
+    if (!selectedKpId || !data) return []
+    return data.knowledgePoints
+      .filter((kp) => kp.prerequisiteIds.includes(selectedKpId))
+      .map((kp) => ({ id: kp.id, name: kp.name, description: kp.description }))
+  }, [selectedKpId, data])
+
+  // 组装 React Flow nodes
+  const rfNodes: Node[] = useMemo(() => {
+    return layout.nodes.map((node) => {
+      const kp = node.data.kp
+      const mastery = data?.masteryMap[kp.id] ?? null
+      const isSelected = selectedKpId === node.id
+      const isHighlighted = !searchText
+        ? (selectedKpId === null || relatedIds.has(node.id))
+        : matchedIds.has(node.id)
+
+      const graphData: GraphNodeData = {
+        kp,
+        mastery,
+        viewMode,
+        isSelected,
+        isHighlighted,
+        chapterColor: chapterColorMap.get(kp.chapterId ?? "") ?? "hsl(var(--muted-foreground))",
+      }
+
+      return {
+        ...node,
+        data: { ...node.data, graphData },
+        selected: isSelected,
+      }
+    })
+  }, [layout, data, selectedKpId, relatedIds, matchedIds, searchText, viewMode, chapterColorMap])
+
+  // 组装 React Flow edges
+  const rfEdges: Edge[] = useMemo(() => {
+    return layout.edges.map((edge) => ({
+      ...edge,
+      data: {
+        ...edge.data,
+        isHighlighted: selectedKpId === null || relatedIds.has(edge.source) || relatedIds.has(edge.target),
+      },
+    }))
+  }, [layout, selectedKpId, relatedIds])
+
+  const onNodeClick = useCallback((_event: unknown, node: Node) => {
+    setSelectedKpId(node.id)
+  }, [])
+
+  const resetView = useCallback(() => {
+    if (layoutMode === "hierarchical") {
+      reactFlow.fitView({ duration: 300 })
+    }
+    setSearchText("")
+    setSelectedKpId(null)
+  }, [reactFlow, layoutMode])
+
+  const onJumpToKp = useCallback((kpId: string) => {
+    setSelectedKpId(kpId)
+    if (layoutMode === "hierarchical") {
+      reactFlow.fitView({ nodes: [{ id: kpId }], duration: 300 })
+    }
+  }, [reactFlow, layoutMode])
+
+  // 添加前置依赖
+  const handleAddPrerequisite = useCallback(async () => {
+    if (!selectedKpId || !newPrereqId || !textbookId) return
+    setIsSavingPrereq(true)
+    try {
+      const formData = new FormData()
+      formData.set("knowledgePointId", selectedKpId)
+      formData.set("prerequisiteKpId", newPrereqId)
+      formData.set("textbookId", textbookId)
+      const result = await createPrerequisiteAction(formData)
+      if (result.success) {
+        notify.success(t("graph.detail.prerequisiteAdded"))
+        setAddPrereqOpen(false)
+        setNewPrereqId("")
+        reload()
+      } else {
+        notify.error(result.message)
+      }
+    } catch (e) {
+      notify.error(e instanceof Error ? e.message : t("graph.detail.prerequisiteAddFailed"))
+    } finally {
+      setIsSavingPrereq(false)
+    }
+  }, [selectedKpId, newPrereqId, textbookId, t, reload])
+
+  // 删除前置依赖
+  const handleRemovePrerequisite = useCallback(async (prereqId: string) => {
+    if (!selectedKpId || !textbookId) return
+    try {
+      const formData = new FormData()
+      formData.set("knowledgePointId", selectedKpId)
+      formData.set("prerequisiteKpId", prereqId)
+      formData.set("textbookId", textbookId)
+      const result = await deletePrerequisiteAction(formData)
+      if (result.success) {
+        notify.success(t("graph.detail.prerequisiteRemoved"))
+        reload()
+      } else {
+        notify.error(result.message)
+      }
+    } catch (e) {
+      notify.error(e instanceof Error ? e.message : t("graph.detail.prerequisiteRemoveFailed"))
+    }
+  }, [selectedKpId, textbookId, t, reload])
+
+  // 可选的前置知识点(排除自身和已是前置的)
+  const availablePrereqs = useMemo(() => {
+    if (!data || !selectedKpId) return []
+    const existing = new Set(data.knowledgePoints.find((kp) => kp.id === selectedKpId)?.prerequisiteIds ?? [])
+    return data.knowledgePoints.filter((kp) =>
+      kp.id !== selectedKpId && !existing.has(kp.id),
+    )
+  }, [data, selectedKpId])
+
+  if (isLoading && !data) {
+    return (
+      <div className="h-full flex items-center justify-center text-sm text-muted-foreground">
+        {t("reader.loadingKnowledge")}
+      </div>
+    )
+  }
+
+  if (error) {
+    return (
+      <EmptyState
+        icon={Share2}
+        title={t("graph.error.loadFailed")}
+        description={error}
+        className="h-full border-none shadow-none bg-transparent"
+      />
+    )
+  }
+
+  if (!data || data.knowledgePoints.length === 0) {
+    return (
+      <EmptyState
+        icon={Share2}
+        title={t("reader.emptyKnowledge")}
+        description={t("reader.emptyKnowledgeDesc")}
+        className="h-full border-none shadow-none bg-transparent"
+      />
+    )
+  }
+
+  const selectedKp = selectedKpId ? data.knowledgePoints.find((kp) => kp.id === selectedKpId) : null
+  const selectedMastery = selectedKpId ? data.masteryMap[selectedKpId] ?? null : null
+
+  return (
+    <div className="flex h-full">
+      <div className="flex-1 flex flex-col min-h-0">
+        <GraphToolbar
+          viewMode={viewMode}
+          onViewModeChange={setViewMode}
+          availableViewModes={availableViewModes}
+          layoutMode={layoutMode}
+          onLayoutModeChange={setLayoutMode}
+          searchText={searchText}
+          onSearchChange={setSearchText}
+          onResetView={resetView}
+          isRefreshing={isRefreshing}
+        />
+        <div className="flex-1 min-h-0 relative">
+          {layoutMode === "hierarchical" ? (
+            <ReactFlow
+              nodes={rfNodes}
+              edges={rfEdges}
+              nodeTypes={nodeTypes}
+              edgeTypes={edgeTypes}
+              onNodeClick={onNodeClick}
+              fitView
+              fitViewOptions={{ padding: 0.2 }}
+              minZoom={0.2}
+              maxZoom={2}
+              proOptions={{ hideAttribution: true }}
+            >
+              <Background variant={BackgroundVariant.Dots} gap={16} size={1} />
+              <Controls className="!bg-background !border !rounded-lg" />
+              <MiniMap
+                className="!bg-background !border !rounded-lg"
+                nodeColor={(node) => {
+                  // 安全的类型收窄:node.data 是 Record<string, unknown>,
+                  // GraphLayoutNodeData 有索引签名 [key: string]: unknown,是 Record 的子类型
+                  const data = node.data as GraphLayoutNodeData
+                  return data.graphData?.chapterColor ?? "hsl(var(--muted-foreground))"
+                }}
+              />
+            </ReactFlow>
+          ) : (
+            <ForceKnowledgeGraph
+              data={data}
+              viewMode={viewMode}
+              searchText={searchText}
+              selectedKpId={selectedKpId}
+              onSelectKp={setSelectedKpId}
+            />
+          )}
+        </div>
+      </div>
+
+      {selectedKp && (
+        // 任意值 w-[300px]:详情面板固定宽度,保证内容可读性
+        <div className="w-[300px] shrink-0">
+          <GraphNodeDetailPanel
+            kp={selectedKp}
+            mastery={selectedMastery}
+            prerequisites={prerequisites}
+            successors={successors}
+            canEdit={canEdit}
+            onClose={() => setSelectedKpId(null)}
+            onJumpToKp={onJumpToKp}
+            onAddPrerequisite={() => setAddPrereqOpen(true)}
+            onRemovePrerequisite={handleRemovePrerequisite}
+          />
+        </div>
+      )}
+
+      {/* 添加前置依赖对话框 */}
+      <Dialog open={addPrereqOpen} onOpenChange={setAddPrereqOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>{t("graph.detail.addPrerequisiteTitle")}</DialogTitle>
+            <DialogDescription>{t("graph.detail.addPrerequisiteDesc")}</DialogDescription>
+          </DialogHeader>
+          <Select value={newPrereqId} onValueChange={setNewPrereqId}>
+            <SelectTrigger>
+              <SelectValue placeholder={t("graph.detail.selectPrerequisite")} />
+            </SelectTrigger>
+            <SelectContent>
+              {availablePrereqs.map((kp) => (
+                <SelectItem key={kp.id} value={kp.id}>
+                  {kp.name}
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setAddPrereqOpen(false)}>
+              {t("graph.detail.cancel")}
+            </Button>
+            <Button
+              onClick={handleAddPrerequisite}
+              disabled={!newPrereqId || isSavingPrereq}
+            >
+              {isSavingPrereq ? t("graph.detail.saving") : t("graph.detail.confirm")}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  )
+}
diff --git a/src/shared/components/charts/comparison-radar-chart.tsx b/src/shared/components/charts/comparison-radar-chart.tsx
index edaadf7..6d86d7b 100644
--- a/src/shared/components/charts/comparison-radar-chart.tsx
+++ b/src/shared/components/charts/comparison-radar-chart.tsx
@@ -47,6 +47,14 @@ export interface RadarSeries {
   show?: boolean
 }
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const POLAR_RADIUS_TICK = { fontSize: 10 }
+const POLAR_RADIUS_AXIS_BASE_PROPS = { axisLine: false }
+
+function formatPercentTick(value: number): string {
+  return `${value}%`
+}
+
 interface ComparisonRadarChartProps {
   /** 图表数据 */
   data: Array<Record<string, string | number>>
@@ -119,9 +127,9 @@ export function ComparisonRadarChart({
         <PolarRadiusAxis
           domain={domain}
           tickCount={tickCount}
-          tickFormatter={(value: number) => `${value}%`}
-          tick={{ fontSize: 10 }}
-          axisLine={false}
+          tickFormatter={formatPercentTick}
+          tick={POLAR_RADIUS_TICK}
+          {...POLAR_RADIUS_AXIS_BASE_PROPS}
         />
         <ChartTooltip content={<ChartTooltipContent className={tooltipClassName} />} />
         {showLegend ? <Legend /> : null}
diff --git a/src/shared/components/charts/simple-bar-chart.tsx b/src/shared/components/charts/simple-bar-chart.tsx
index 7533c0c..16bf598 100644
--- a/src/shared/components/charts/simple-bar-chart.tsx
+++ b/src/shared/components/charts/simple-bar-chart.tsx
@@ -74,6 +74,12 @@ interface SimpleBarChartProps {
 
 const DEFAULT_X_TRUNCATE_LENGTH = 8
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const GRID_PROPS = { vertical: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const X_AXIS_BASE_PROPS = { tickLine: false, axisLine: false, tickMargin: 8 }
+const Y_AXIS_BASE_PROPS = { tickLine: false, axisLine: false }
+const DEFAULT_BAR_RADIUS: [number, number, number, number] = [4, 4, 0, 0]
+
 function makeXTickFormatter(truncateLength: number) {
   return (value: string): string =>
     value.length > truncateLength ? `${value.slice(0, truncateLength)}...` : value
@@ -119,19 +125,16 @@ export function SimpleBarChart({
     <ChartContainer config={chartConfig} className={cn(heightClassName, "w-full", className)}>
       <BarChart data={data} margin={margin}>
         {defs}
-        <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
+        <CartesianGrid {...GRID_PROPS} />
         <XAxis
           dataKey={xKey}
-          tickLine={false}
-          axisLine={false}
-          tickMargin={8}
+          {...X_AXIS_BASE_PROPS}
           tickFormatter={resolvedXTickFormatter}
         />
         <YAxis
           domain={yDomain}
           allowDecimals={yAllowDecimals}
-          tickLine={false}
-          axisLine={false}
+          {...Y_AXIS_BASE_PROPS}
           tickFormatter={yTickFormatter}
           width={yWidth}
         />
@@ -150,7 +153,7 @@ export function SimpleBarChart({
             key={b.dataKey}
             dataKey={b.dataKey}
             fill={`var(--color-${b.dataKey})`}
-            radius={b.radius ?? [4, 4, 0, 0]}
+            radius={b.radius ?? DEFAULT_BAR_RADIUS}
           >
             {hasCellColors && cellColors
               ? data.map((entry) => {
diff --git a/src/shared/components/charts/trend-line-chart.tsx b/src/shared/components/charts/trend-line-chart.tsx
index d5c8687..c068c66 100644
--- a/src/shared/components/charts/trend-line-chart.tsx
+++ b/src/shared/components/charts/trend-line-chart.tsx
@@ -68,6 +68,16 @@ interface TrendLineChartProps {
 
 const DEFAULT_X_TICK_TRUNCATE_LENGTH = 10
 
+/** recharts 内联对象常量：避免每次渲染创建新对象触发 re-render */
+const GRID_PROPS = { vertical: false, strokeDasharray: "4 4", strokeOpacity: 0.4 }
+const TOOLTIP_CURSOR = {
+  stroke: "hsl(var(--muted-foreground))",
+  strokeWidth: 1,
+  strokeDasharray: "4 4",
+}
+const X_AXIS_BASE_PROPS = { tickLine: false, axisLine: false, tickMargin: 8 }
+const Y_AXIS_BASE_PROPS = { tickLine: false, axisLine: false }
+
 function defaultXTickFormatter(value: string): string {
   return value.length > DEFAULT_X_TICK_TRUNCATE_LENGTH
     ? `${value.slice(0, DEFAULT_X_TICK_TRUNCATE_LENGTH)}...`
@@ -103,27 +113,20 @@ export function TrendLineChart({
   return (
     <ChartContainer config={chartConfig} className={cn(heightClassName, "w-full", className)}>
       <LineChart data={data} margin={margin}>
-        <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
+        <CartesianGrid {...GRID_PROPS} />
         <XAxis
           dataKey={xKey}
-          tickLine={false}
-          axisLine={false}
-          tickMargin={8}
+          {...X_AXIS_BASE_PROPS}
           tickFormatter={xTickFormatter ?? undefined}
         />
         <YAxis
           domain={yDomain}
-          tickLine={false}
-          axisLine={false}
+          {...Y_AXIS_BASE_PROPS}
           tickFormatter={yTickFormatter}
           width={yWidth}
         />
         <ChartTooltip
-          cursor={{
-            stroke: "hsl(var(--muted-foreground))",
-            strokeWidth: 1,
-            strokeDasharray: "4 4",
-          }}
+          cursor={TOOLTIP_CURSOR}
           content={
             <ChartTooltipContent
               indicator="line"
diff --git a/src/shared/components/modal-root.tsx b/src/shared/components/modal-root.tsx
new file mode 100644
index 0000000..ea9303a
--- /dev/null
+++ b/src/shared/components/modal-root.tsx
@@ -0,0 +1,84 @@
+"use client"
+
+import { useEffect, type ReactNode } from "react"
+import { useUiStore } from "@/shared/stores/ui-store"
+
+/**
+ * V5 Phase 4 - 命令式 Modal Registry 基础设施。
+ *
+ * 设计目的：
+ * - 替代散落各页面的 `<Dialog open={open}>` 声明式调用
+ * - 支持 `openModal("user-import", { data: ... })` 命令式触发
+ * - 跨组件传递 modal 上下文（无需 prop drilling）
+ *
+ * 使用模式：
+ * 1. 在 layout.tsx 注入 `<ModalRoot />`（单例）
+ * 2. 注册 modal 渲染器：`<ModalRoot registry={{ "user-import": (props) => <UserImportDialog {...props} /> }} />`
+ * 3. 业务侧触发：`const { openModal } = useModal("user-import"); openModal({ data: ... })`
+ *
+ * 当前状态：
+ * - 基础设施已就绪（ui-store + ModalRoot 组件）
+ * - 业务侧未强制接入（声明式 `<Dialog open={open}>` 仍可使用）
+ * - 新增跨组件触发的 modal 推荐使用此模式
+ *
+ * 注意：
+ * - ModalRoot 监听路由变化时自动 closeAll（避免路由切换后 modal 残留）
+ * - 注册的 modal 渲染器必须是纯函数，props 由 ui-store 传递
+ */
+
+export interface ModalRegistry {
+  [name: string]: (props: Record<string, unknown> | undefined, closeModal: () => void) => ReactNode
+}
+
+interface ModalRootProps {
+  registry: ModalRegistry
+}
+
+/**
+ * 全局 Modal Root。
+ *
+ * 监听 ui-store 的 modals 状态，渲染已注册的 modal 组件。
+ * 必须在客户端渲染，且只需在根 layout 注入一次。
+ *
+ * @example
+ * // app/layout.tsx
+ * <ModalRoot registry={{
+ *   "user-import": (props, closeModal) => (
+ *     <UserImportDialog open onClose={closeModal} initialData={props?.data} />
+ *   ),
+ * }} />
+ *
+ * // 业务侧触发
+ * const { openModal } = useModal("user-import")
+ * openModal({ data: selectedUsers })
+ */
+export function ModalRoot({ registry }: ModalRootProps): ReactNode {
+  const modals = useUiStore((s) => s.modals)
+  const closeModal = useUiStore((s) => s.closeModal)
+  const closeAll = useUiStore((s) => s.closeAll)
+
+  // 路由变化时关闭所有 modal（避免残留）
+  useEffect(() => {
+    const handleRouteChange = (): void => {
+      closeAll()
+    }
+    window.addEventListener("popstate", handleRouteChange)
+    return () => {
+      window.removeEventListener("popstate", handleRouteChange)
+    }
+  }, [closeAll])
+
+  return (
+    <>
+      {Object.entries(modals).map(([name, entry]) => {
+        const renderer = registry[name]
+        if (!renderer) return null
+        return (
+          <div key={name}>
+            {renderer(entry?.props, () => closeModal(name))}
+          </div>
+        )
+      })}
+    </>
+  )
+}
diff --git a/src/shared/components/ui/empty-state.tsx b/src/shared/components/ui/empty-state.tsx
index d96632c..d0e58cc 100644
--- a/src/shared/components/ui/empty-state.tsx
+++ b/src/shared/components/ui/empty-state.tsx
@@ -17,7 +17,11 @@ interface EmptyStateProps extends React.HTMLAttributes<HTMLDivElement> {
   }
 }
 
-export function EmptyState({
+/**
+ * 高频使用的空状态占位组件（在列表/卡片网格中多次渲染），
+ * 使用 React.memo 跳过 props 未变化时的重渲染。
+ */
+export const EmptyState = React.memo(function EmptyState({
   icon: Icon,
   title,
   description,
@@ -59,4 +63,5 @@ export function EmptyState({
       </div>
     </div>
   )
-}
+})
+
diff --git a/src/shared/components/ui/rich-text-editor-inner.tsx b/src/shared/components/ui/rich-text-editor-inner.tsx
new file mode 100644
index 0000000..3a1d377
--- /dev/null
+++ b/src/shared/components/ui/rich-text-editor-inner.tsx
@@ -0,0 +1,207 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+"use client";
+
+import * as React from "react";
+import { useEditor, EditorContent, type Editor } from "@tiptap/react";
+import StarterKit from "@tiptap/starter-kit";
+import { Markdown } from "tiptap-markdown";
+import Placeholder from "@tiptap/extension-placeholder";
+import {
+  Bold,
+  Italic,
+  Strikethrough,
+  Code,
+  Heading1,
+  Heading2,
+  Heading3,
+  List,
+  ListOrdered,
+  Quote,
+  Undo,
+  Redo,
+} from "lucide-react";
+
+import { cn } from "@/shared/lib/utils";
+import { Button } from "@/shared/components/ui/button";
+import { Separator } from "@/shared/components/ui/separator";
+
+// Since we don't have Toggle component yet, let's create a local one or use Button
+// We will use Button for simplicity and to avoid dependency issues if Radix Toggle isn't installed
+const ToolbarButton = ({
+  isActive,
+  onClick,
+  icon: Icon,
+  title,
+}: {
+  isActive?: boolean;
+  onClick: () => void;
+  icon: React.ElementType;
+  title: string;
+}) => (
+  <Button
+    variant={isActive ? "secondary" : "ghost"}
+    size="icon"
+    className={cn(
+      "h-8 w-8 shrink-0",
+      isActive && "bg-muted text-foreground hover:bg-muted",
+    )}
+    onClick={(e) => {
+      e.preventDefault();
+      onClick();
+    }}
+    title={title}
+  >
+    <Icon className="h-4 w-4" />
+  </Button>
+);
+
+const EditorToolbar = ({ editor }: { editor: Editor }) => {
+  if (!editor) return null;
+
+  return (
+    <div className="flex flex-wrap items-center gap-1 border-b bg-background/95 p-1 backdrop-blur supports-[backdrop-filter]:bg-background/60">
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleBold().run()}
+        isActive={editor.isActive("bold")}
+        icon={Bold}
+        title="Bold"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleItalic().run()}
+        isActive={editor.isActive("italic")}
+        icon={Italic}
+        title="Italic"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleStrike().run()}
+        isActive={editor.isActive("strike")}
+        icon={Strikethrough}
+        title="Strikethrough"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleCode().run()}
+        isActive={editor.isActive("code")}
+        icon={Code}
+        title="Code"
+      />
+
+      <Separator orientation="vertical" className="mx-1 h-6" />
+
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleHeading({ level: 1 }).run()}
+        isActive={editor.isActive("heading", { level: 1 })}
+        icon={Heading1}
+        title="Heading 1"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleHeading({ level: 2 }).run()}
+        isActive={editor.isActive("heading", { level: 2 })}
+        icon={Heading2}
+        title="Heading 2"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleHeading({ level: 3 }).run()}
+        isActive={editor.isActive("heading", { level: 3 })}
+        icon={Heading3}
+        title="Heading 3"
+      />
+
+      <Separator orientation="vertical" className="mx-1 h-6" />
+
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleBulletList().run()}
+        isActive={editor.isActive("bulletList")}
+        icon={List}
+        title="Bullet List"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleOrderedList().run()}
+        isActive={editor.isActive("orderedList")}
+        icon={ListOrdered}
+        title="Ordered List"
+      />
+      <ToolbarButton
+        onClick={() => editor.chain().focus().toggleBlockquote().run()}
+        isActive={editor.isActive("blockquote")}
+        icon={Quote}
+        title="Blockquote"
+      />
+
+      <div className="ml-auto flex items-center gap-1">
+        <ToolbarButton
+          onClick={() => editor.chain().focus().undo().run()}
+          isActive={false}
+          icon={Undo}
+          title="Undo"
+        />
+        <ToolbarButton
+          onClick={() => editor.chain().focus().redo().run()}
+          isActive={false}
+          icon={Redo}
+          title="Redo"
+        />
+      </div>
+    </div>
+  );
+};
+
+interface RichTextEditorInnerProps {
+  value: string;
+  onChange: (value: string) => void;
+  placeholder?: string;
+  className?: string;
+}
+
+export function RichTextEditorInner({
+  value,
+  onChange,
+  placeholder = "Start writing...",
+  className,
+}: RichTextEditorInnerProps): React.ReactElement {
+  const editor = useEditor({
+    immediatelyRender: false,
+    extensions: [
+      StarterKit.configure({
+        heading: {
+          levels: [1, 2, 3],
+        },
+      }),
+      Markdown,
+      Placeholder.configure({
+        placeholder,
+        emptyEditorClass:
+          "is-editor-empty before:content-[attr(data-placeholder)] before:text-muted-foreground before:float-left before:pointer-events-none before:h-0",
+      }),
+    ],
+    editorProps: {
+      attributes: {
+        class: "prose prose-sm dark:prose-invert max-w-none min-h-[150px] p-4 focus:outline-none",
+      },
+    },
+    content: value,
+    onUpdate: ({ editor }) => {
+      // Get markdown content
+      const markdown = (editor.storage as any).markdown.getMarkdown();
+      onChange(markdown);
+    },
+  });
+
+  // Sync value changes from outside (e.g. when switching chapters)
+  React.useEffect(() => {
+    if (editor && value !== (editor.storage as any).markdown.getMarkdown()) {
+      editor.commands.setContent(value);
+    }
+  }, [value, editor]);
+
+  return (
+    <div
+      className={cn(
+        "flex flex-col rounded-md border bg-background shadow-sm overflow-hidden",
+        className,
+      )}
+    >
+      <EditorToolbar editor={editor as Editor} />
+      <EditorContent editor={editor} className="flex-1 overflow-y-auto min-h-0" />
+    </div>
+  );
+}
diff --git a/src/shared/components/ui/status-badge.tsx b/src/shared/components/ui/status-badge.tsx
index d036e5d..818f296 100644
--- a/src/shared/components/ui/status-badge.tsx
+++ b/src/shared/components/ui/status-badge.tsx
@@ -45,11 +45,13 @@ export interface StatusBadgeProps<T extends string> {
  * 业务模块只需在自身 types.ts 中维护 `STATUS_VARIANT` / `STATUS_LABEL` 常量，
  * 传入本组件即可，避免颜色映射不一致与代码复制粘贴。
  *
+ * 高频使用（列表/表格中每行渲染一次），使用 React.memo 跳过 props 未变化时的重渲染。
+ *
  * @example
  * const STATUS_VARIANT = { draft: "secondary", published: "default", archived: "outline" } as const
  * <StatusBadge status="published" variantMap={STATUS_VARIANT} />
  */
-export function StatusBadge<T extends string>({
+function StatusBadgeInner<T extends string>({
   status,
   variantMap,
   labelMap,
@@ -69,3 +71,12 @@ export function StatusBadge<T extends string>({
     </Badge>
   )
 }
+
+/**
+ * React.memo 的类型签名不支持保留泛型组件的泛型参数，
+ * 通过 unknown 安全转换回原始泛型函数签名以保留类型安全
+ * （符合项目规则：从 unknown 转换需注释原因）。
+ */
+export const StatusBadge = React.memo(
+  StatusBadgeInner
+) as unknown as typeof StatusBadgeInner
diff --git a/src/shared/db/schema.ts b/src/shared/db/schema.ts
index 001bdd3..703d50f 100644
--- a/src/shared/db/schema.ts
+++ b/src/shared/db/schema.ts
@@ -1,9 +1,9 @@
-import { 
-  mysqlTable, 
-  varchar, 
-  text, 
-  timestamp, 
-  int, 
+import {
+  mysqlTable,
+  varchar,
+  text,
+  timestamp,
+  int,
   primaryKey,
   index,
   uniqueIndex,
@@ -16,6 +16,7 @@ import {
   decimal,
   bigint
 } from "drizzle-orm/mysql-core";
+import { sql } from "drizzle-orm";
 import { createId } from "@paralleldrive/cuid2";
 import type { AdapterAccountType } from "next-auth/adapters";
 
@@ -200,26 +201,37 @@ export const questionTypeEnum = mysqlEnum("type", ["single_choice", "multiple_ch
 
 export const questions = mysqlTable("questions", {
   id: id("id").primaryKey(),
-  
+
   // Content can be JSON to store rich text, images, etc. or just text.
   // Using JSON for flexibility in a modern ed-tech app (e.g. SlateJS nodes).
-  content: json("content").notNull(), 
-  
+  content: json("content").notNull(),
+
+  // P3-6: 题目内容全文检索文本镜像。
+  // - STORED 生成列：每次 INSERT/UPDATE content 时由 MySQL 自动同步
+  // - 使用 CAST(content AS CHAR) 把 JSON 序列化为纯文本以支持 FULLTEXT
+  // - 配合 questions_content_text_ft_idx FULLTEXT 索引（见对应 drizzle 迁移）实现 MATCH AGAINST 检索
+  //   drizzle-kit 无法生成 FULLTEXT 索引声明，迁移文件中需手动追加 CREATE FULLTEXT INDEX
+  contentText: text("content_text").generatedAlwaysAs(
+    sql`CAST(content AS CHAR)`,
+    { mode: "stored" },
+  ),
+
   type: questionTypeEnum.notNull(),
   difficulty: int("difficulty").default(1), // 1-5
-  
+
   // Self-reference for "Infinite Nesting" (Parent Question)
   // e.g., A reading comprehension passage (Parent) -> 5 sub-questions (Children)
-  parentId: varchar("parent_id", { length: 128 }), 
+  parentId: varchar("parent_id", { length: 128 }),
 
   authorId: varchar("author_id", { length: 128 }).notNull().references(() => users.id),
-  
+
   createdAt: timestamp("created_at").defaultNow().notNull(),
   updatedAt: timestamp("updated_at").defaultNow().onUpdateNow().notNull(),
 }, (table) => ({
   parentIdIdx: index("parent_id_idx").on(table.parentId), // Critical for querying children
   authorIdIdx: index("author_id_idx").on(table.authorId),
-  // In a real large-scale system, we might add Full-Text Search index on content
+  // P3-6: 题目按类型+难度筛选的高频查询索引
+  typeDifficultyIdx: index("questions_type_difficulty_idx").on(table.type, table.difficulty),
 }));
 
 // Many-to-Many: Questions <-> Knowledge Points
@@ -552,12 +564,15 @@ export const exams = mysqlTable("exams", {
 
   // Status: draft, published, ongoing, finished
   status: varchar("status", { length: 50 }).default("draft"),
-  
+
   createdAt: timestamp("created_at").defaultNow().notNull(),
   updatedAt: timestamp("updated_at").defaultNow().onUpdateNow().notNull(),
 }, (table) => ({
   subjectIdx: index("exams_subject_idx").on(table.subjectId),
   gradeIdx: index("exams_grade_idx").on(table.gradeId),
+  // P3-6: 考试状态按时间排序、按创建者筛选的高频查询索引
+  statusCreatedIdx: index("exams_status_created_idx").on(table.status, table.createdAt),
+  creatorIdx: index("exams_creator_idx").on(table.creatorId),
 }));
 
 // Linking Exams to Questions (Many-to-Many often, or One-to-Many if specific to exam)
@@ -584,6 +599,9 @@ export const examSubmissions = mysqlTable("exam_submissions", {
   updatedAt: timestamp("updated_at").defaultNow().onUpdateNow().notNull(),
 }, (table) => ({
   examStudentIdx: index("exam_student_idx").on(table.examId, table.studentId),
+  // P3-6: 提交记录按考试状态筛选、按提交时间排序的高频查询索引
+  examStatusIdx: index("exam_submissions_exam_status_idx").on(table.examId, table.status),
+  submittedAtIdx: index("exam_submissions_submitted_at_idx").on(table.submittedAt),
 }));
 
 export const submissionAnswers = mysqlTable("submission_answers", {
diff --git a/src/shared/hooks/use-dialog-state.ts b/src/shared/hooks/use-dialog-state.ts
new file mode 100644
index 0000000..89de752
--- /dev/null
+++ b/src/shared/hooks/use-dialog-state.ts
@@ -0,0 +1,29 @@
+"use client"
+
+import { useCallback, useState } from "react"
+
+/**
+ * Dialog/Sheet 开关状态 Hook。
+ *
+ * 替换项目中 30+ 处 `const [open, setOpen] = useState(false)` 模式。
+ * 提供语义化方法名，避免散落 setOpen(true)/setOpen(false) 调用。
+ *
+ * @example
+ * const [open, openModal, closeModal, toggle] = useDialogState()
+ * <Button onClick={openModal}>导入</Button>
+ * <Dialog open={open} onOpenChange={(v) => v ? openModal() : closeModal()}>
+ *
+ * @returns readonly [open, openModal, closeModal, toggle]
+ */
+export function useDialogState(): readonly [
+  boolean,
+  () => void,
+  () => void,
+  () => void,
+] {
+  const [open, setOpen] = useState(false)
+  const openModal = useCallback(() => setOpen(true), [])
+  const closeModal = useCallback(() => setOpen(false), [])
+  const toggle = useCallback(() => setOpen((v) => !v), [])
+  return [open, openModal, closeModal, toggle] as const
+}
diff --git a/src/shared/lib/api-response.ts b/src/shared/lib/api-response.ts
new file mode 100644
index 0000000..783e802
--- /dev/null
+++ b/src/shared/lib/api-response.ts
@@ -0,0 +1,212 @@
+/**
+ * API 路由层统一响应工具。
+ *
+ * 设计目标：
+ * 1. 统一响应信封 `{ success, message?, errorCode?, data? }`，与 `ActionState<T>` 形状保持一致
+ * 2. 集中错误 → HTTP 状态码映射，避免字符串匹配推导状态码的脆弱模式
+ * 3. 提供 `withApiErrorHandler` HOF 统一异常处理，消除每个 route 重复的 try/catch 模板
+ * 4. 提供 `apiFromAction` 将 `ActionState<T>` 转换为标准 `NextResponse`，替代手写状态码推断
+ *
+ * 仅用于 `app/api/.../route.ts`，Server Action 仍使用 `@/shared/lib/action-utils` 的 `handleActionError`。
+ */
+
+import { NextResponse } from "next/server"
+
+import { PermissionDeniedError } from "@/shared/lib/errors"
+import {
+  BusinessError,
+  NotFoundError,
+  ValidationError,
+} from "@/shared/lib/action-utils"
+import type { ActionState } from "@/shared/types/action-state"
+
+/**
+ * 标准 API 响应体形状，与 `ActionState<T>` 对齐。
+ */
+export type ApiResponse<T = unknown> = {
+  success: boolean
+  message?: string
+  errorCode?: string
+  data?: T
+}
+
+/**
+ * 错误 → HTTP 状态码的集中映射。
+ *
+ * 401 = 未认证（无 session）
+ * 403 = 已认证但无权限
+ * 404 = 资源不存在
+ * 400 = 输入校验失败
+ * 429 = 限流
+ * 500 = 未预期错误
+ */
+export const errorToStatus = (error: unknown): number => {
+  if (error instanceof PermissionDeniedError) {
+    // PermissionDeniedError 由 requirePermission 抛出，调用方已认证但无权限
+    return 403
+  }
+  if (error instanceof NotFoundError) return 404
+  if (error instanceof ValidationError) return 400
+  if (error instanceof BusinessError) return 400
+  return 500
+}
+
+/**
+ * 构造成功响应。
+ *
+ * @example
+ * ```ts
+ * return apiSuccess({ file: result.data })
+ * return apiSuccess({ ok: true }, { status: 201 })
+ * ```
+ */
+export function apiSuccess<T>(
+  data: T,
+  init?: { status?: number; headers?: HeadersInit }
+): NextResponse {
+  return NextResponse.json(
+    { success: true, data } satisfies ApiResponse<T>,
+    { status: init?.status ?? 200, headers: init?.headers }
+  )
+}
+
+/**
+ * 构造失败响应。`message` 应为可安全暴露给客户端的文案。
+ */
+export function apiError(
+  message: string,
+  status: number,
+  errorCode?: string,
+  init?: { headers?: HeadersInit }
+): NextResponse {
+  return NextResponse.json(
+    { success: false, message, errorCode } satisfies ApiResponse,
+    { status, headers: init?.headers }
+  )
+}
+
+/**
+ * 从 `ActionState<T>` 构造响应。
+ *
+ * 替代路由中常见的 `result.message?.includes("not found") ? 404 : 500` 字符串匹配模式。
+ *
+ * 状态码推断规则：
+ * - success → 200（或自定义 successStatus）
+ * - failure + errorCode='not_found' → 404
+ * - failure + errorCode='validation_error' → 400
+ * - failure + errorCode='auth_required' → 401（未认证）
+ * - failure + errorCode='permission_denied' → 403（已认证但无权限）
+ * - 其他 failure → 500
+ *
+ * @example
+ * ```ts
+ * const result = await uploadFileAction(file, opts)
+ * if (!result.success) return apiFromAction(result)
+ * return apiFromAction(result) // success
+ * ```
+ */
+export function apiFromAction<T>(
+  result: ActionState<T>,
+  options?: {
+    successStatus?: number
+    headers?: HeadersInit
+  }
+): NextResponse {
+  if (result.success) {
+    return NextResponse.json(
+      { success: true, message: result.message, data: result.data } satisfies ApiResponse<T>,
+      { status: options?.successStatus ?? 200, headers: options?.headers }
+    )
+  }
+
+  const code = result.errorCode
+  let status = 500
+  if (code === "not_found") status = 404
+  else if (code === "validation_error") status = 400
+  else if (code === "auth_required") status = 401
+  else if (code === "permission_denied") status = 403
+
+  return NextResponse.json(
+    {
+      success: false,
+      message: result.message,
+      errorCode: code,
+    } satisfies ApiResponse,
+    { status, headers: options?.headers }
+  )
+}
+
+/**
+ * API 路由错误处理器：将异常转为标准响应。
+ *
+ * - PermissionDeniedError → 403
+ * - BusinessError / NotFoundError / ValidationError → 对应状态码
+ * - 其他 Error → 500 + 通用消息（不泄露内部细节）
+ *
+ * 服务端日志通过 `console.error` 输出（仅未预期错误，已知业务错误不记录）。
+ */
+export function handleApiError(
+  error: unknown,
+  init?: { headers?: HeadersInit }
+): NextResponse {
+  // 已知业务错误：消息可安全暴露，无需 console.error
+  if (error instanceof PermissionDeniedError || error instanceof BusinessError) {
+    return apiError(
+      error instanceof PermissionDeniedError ? error.message : error.message,
+      errorToStatus(error),
+      error instanceof BusinessError ? error.code : undefined,
+      init
+    )
+  }
+
+  // 未预期错误：记录服务端日志，不暴露细节
+  if (error instanceof Error) {
+    console.error("[ApiError]", error.name, error.message, error.stack)
+  } else {
+    console.error("[ApiError] Unknown error:", error)
+  }
+  return apiError("请求失败，请稍后重试", 500, "unexpected", init)
+}
+
+/**
+ * 高阶函数：包装 route handler，统一异常处理。
+ *
+ * @example
+ * ```ts
+ * export const POST = withApiErrorHandler(async (req: Request) => {
+ *   const ctx = await requirePermission(Permissions.AI_CHAT)
+ *   // ...业务逻辑
+ *   return apiSuccess({ content })
+ * })
+ * ```
+ *
+ * 包装后的 handler 抛出的 `PermissionDeniedError` / `BusinessError` 会被自动转为对应状态码响应；
+ * 其他异常转为 500。
+ */
+export function withApiErrorHandler<TArgs extends unknown[], TResult>(
+  handler: (...args: TArgs) => Promise<TResult>
+): (...args: TArgs) => Promise<TResult | NextResponse> {
+  return async (...args: TArgs): Promise<TResult | NextResponse> => {
+    try {
+      return await handler(...args)
+    } catch (error) {
+      return handleApiError(error)
+    }
+  }
+}
+
+/**
+ * 安全解析 JSON 请求体。失败抛 `ValidationError`，由 `withApiError` 转为 400。
+ *
+ * @example
+ * ```ts
+ * const body = await parseJsonBody(req)
+ * ```
+ */
+export async function parseJsonBody<T = unknown>(req: Request): Promise<T> {
+  const raw = await req.json().catch(() => null)
+  if (raw === null || raw === undefined) {
+    throw new ValidationError("请求体不是有效的 JSON")
+  }
+  return raw as T
+}
diff --git a/src/shared/lib/create-service-provider.tsx b/src/shared/lib/create-service-provider.tsx
new file mode 100644
index 0000000..cf88634
--- /dev/null
+++ b/src/shared/lib/create-service-provider.tsx
@@ -0,0 +1,53 @@
+"use client"
+
+import React, { createContext, useContext, type ReactNode } from "react"
+
+/**
+ * Service DI Provider 工厂。
+ *
+ * 替换项目中 14 处重复的 Service DI Provider 样板代码
+ * （createContext(null) + Provider + useService 抛错模板）。
+ *
+ * 用于注入模块数据服务对象（一组 Server Action 引用集合），而非可变状态。
+ * Provider 仅持有不可变引用，消费方通过 `useService()` 取值。
+ *
+ * @example
+ * // 定义
+ * export const {
+ *   Provider: AttendanceServiceProvider,
+ *   useService: useAttendanceService,
+ *   Context: AttendanceServiceContext,
+ * } = createServiceProvider<AttendanceService>("AttendanceService")
+ *
+ * // 使用
+ * <AttendanceServiceProvider value={service}>
+ *   <Children />
+ * </AttendanceServiceProvider>
+ *
+ * function ChildComponent() {
+ *   const service = useAttendanceService()
+ *   // ...
+ * }
+ */
+export function createServiceProvider<T>(displayName: string): {
+  Provider: (props: { value: T; children: ReactNode }) => React.JSX.Element
+  useService: () => T
+  Context: React.Context<T | null>
+} {
+  const Context = createContext<T | null>(null)
+  Context.displayName = displayName
+
+  function Provider({ value, children }: { value: T; children: ReactNode }): React.JSX.Element {
+    return <Context.Provider value={value}>{children}</Context.Provider>
+  }
+
+  function useService(): T {
+    const value = useContext(Context)
+    if (!value) {
+      throw new Error(`useService() 必须在 ${displayName} 内调用`)
+    }
+    return value
+  }
+
+  return { Provider, useService, Context }
+}
diff --git a/src/shared/lib/notify.ts b/src/shared/lib/notify.ts
new file mode 100644
index 0000000..f280052
--- /dev/null
+++ b/src/shared/lib/notify.ts
@@ -0,0 +1,68 @@
+"use client"
+
+import { toast } from "sonner"
+import type { ExternalToast } from "sonner"
+
+/**
+ * 统一 toast 接口（V5 Phase 4）。
+ *
+ * 业务代码统一走 `notify`，不直接 `import { toast } from "sonner"`：
+ * - 便于测试（mock notify 即可，无需 mock sonner）
+ * - 便于未来替换 toast 库（仅改 notify.ts 一处）
+ * - 100+ 处现有调用机械替换（`toast.xxx(...)` → `notify.xxx(...)`）
+ *
+ * 设计说明：
+ * - 接受 string | undefined（result.message 可能为 undefined）
+ * - 转发 sonner 的 options 第二参数（description / duration / action 等高级特性）
+ * - i18n 由调用方控制（`notify.success(t("xxx"))` 或 `notify.success("中文")`）
+ * - 保留 rawToast 作为 sonner escape hatch（custom JSX 等场景）
+ *
+ * @example
+ * notify.success("保存成功")
+ * notify.success(t("common.saved"))
+ * notify.success(result.message || "操作失败")
+ * notify.success(t("exam.form.createSuccess"), { description: t("exam.form.redirecting") })
+ * notify.error(result.message, { action: { label: "撤销", onClick: undo } })
+ * notify.promise(asyncFn, { loading: "处理中", success: "完成", error: "失败" })
+ */
+export const notify = {
+  success(message: string | undefined, opts?: ExternalToast): void {
+    toast.success(message ?? "", opts)
+  },
+  error(message: string | undefined, opts?: ExternalToast): void {
+    toast.error(message ?? "", opts)
+  },
+  info(message: string | undefined, opts?: ExternalToast): void {
+    toast.info(message ?? "", opts)
+  },
+  warning(message: string | undefined, opts?: ExternalToast): void {
+    toast.warning(message ?? "", opts)
+  },
+  message(message: string | undefined, opts?: ExternalToast): void {
+    toast.message(message ?? "", opts)
+  },
+  /**
+   * Promise toast。
+   *
+   * 注意：sonner 的 toast.promise 返回 Promise 与 unwrap 方法的组合类型，
+   * 此处直接返回 sonner 原生类型，不强制转换为 Promise<T>。
+   */
+  promise<T>(
+    p: Promise<T>,
+    opts: { loading: string; success: string; error: string }
+  ) {
+    return toast.promise(p, {
+      loading: opts.loading,
+      success: opts.success,
+      error: opts.error,
+    })
+  },
+}
+
+/**
+ * 直接调用 sonner（保留 escape hatch）。
+ *
+ * 仅在需要 sonner 高级特性（如 custom JSX、直接调用 toast.loading 等）且无法用 notify 抽象时使用。
+ * 业务代码应优先使用 notify。
+ */
+export const rawToast = toast
diff --git a/src/shared/lib/query-client.ts b/src/shared/lib/query-client.ts
new file mode 100644
index 0000000..7f9ede0
--- /dev/null
+++ b/src/shared/lib/query-client.ts
@@ -0,0 +1,43 @@
+import { QueryClient } from "@tanstack/react-query"
+
+/**
+ * 创建 QueryClient 实例。
+ *
+ * 必须在客户端组件 `useState` 内调用，避免 module-level 单例
+ * 导致跨用户共享缓存（SSR 隔离）。
+ *
+ * 默认配置面向教务系统非实时性场景：
+ * - staleTime 30s：避免高频交互场景过度 refetch
+ * - retry 1：网络抖动单次重试，避免过度等待
+ * - refetchOnWindowFocus false：教务系统非协作编辑，无需聚焦即刷新
+ * - refetchOnMount false：复用已有数据，避免组件挂载立即触发请求
+ */
+export function createQueryClient(): QueryClient {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: 30_000,
+        retry: 1,
+        refetchOnWindowFocus: false,
+        refetchOnMount: false,
+      },
+      mutations: {
+        retry: 0,
+        onError: (error) => {
+          console.error("[mutation error]", error)
+          // notify 在客户端 mount 后才可用；此处 try-catch 兜底
+          // 避免全局 onError 在 notify 未配置时抛错
+          try {
+            // 延迟动态导入，避免循环依赖
+            void import("@/shared/lib/notify").then(({ notify }) => {
+              // 复用 errors.network.serverError（已存在的 i18n key）
+              notify.error("errors.network.serverError")
+            })
+          } catch {
+            // notify 不可用，仅 console.error
+          }
+        },
+      },
+    },
+  })
+}
diff --git a/src/shared/lib/sse.ts b/src/shared/lib/sse.ts
new file mode 100644
index 0000000..4b06a97
--- /dev/null
+++ b/src/shared/lib/sse.ts
@@ -0,0 +1,81 @@
+/**
+ * Server-Sent Events (SSE) 共享工具。
+ *
+ * 统一 `app/api/.../stream/route.ts` 与 `app/api/.../stream/route.ts` 的事件格式：
+ * - `formatSseEvent(data)` — 序列化 payload 为 `data: {...}\n\n`
+ * - `formatSseError(message)` — 标准错误事件 `{ type: "error", message }`
+ * - `formatSseDone()` — 终止信号 `data: [DONE]\n\n`
+ * - `createSseResponse()` — 构造带标准 SSE 头的 `Response`
+ * - `createSseError(message, status)` — 在流建立前用 `text/event-stream` 返回错误
+ *
+ * 客户端约定：
+ * - 普通 payload 通过 `formatSseEvent` 推送，自定义 `type` 字段区分事件类型
+ * - 错误统一使用 `{ type: "error", message }`
+ * - 流结束信号为 `[DONE]`
+ */
+
+const SSE_HEADERS = {
+  "Content-Type": "text/event-stream",
+  "Cache-Control": "no-cache, no-transform",
+  Connection: "keep-alive",
+} as const
+
+/**
+ * 将任意可序列化 payload 格式化为 SSE `data:` 行。
+ *
+ * @example
+ * ```ts
+ * const chunk = formatSseEvent({ type: "token", content: "hello" })
+ * controller.enqueue(encoder.encode(chunk))
+ * ```
+ */
+export function formatSseEvent(data: unknown): string {
+  return `data: ${JSON.stringify(data)}\n\n`
+}
+
+/**
+ * 格式化标准错误事件 payload：`{ type: "error", message }`。
+ */
+export function formatSseError(message: string): string {
+  return formatSseEvent({ type: "error", message })
+}
+
+/**
+ * SSE 终止信号。客户端约定收到 `[DONE]` 后关闭连接。
+ */
+export function formatSseDone(): string {
+  return "data: [DONE]\n\n"
+}
+
+/**
+ * 构造标准 SSE 成功响应（流建立后使用）。
+ *
+ * @example
+ * ```ts
+ * const stream = new ReadableStream({ start(controller) { ... } })
+ * return createSseResponse(stream)
+ * ```
+ */
+export function createSseResponse(stream: ReadableStream<Uint8Array>): Response {
+  return new Response(stream, { headers: SSE_HEADERS })
+}
+
+/**
+ * 在流建立前返回错误（鉴权失败、参数校验失败等场景）。
+ *
+ * 与 `formatSseError` 不同，此函数返回一个完整的 `Response`，
+ * 用于在 `ReadableStream` 创建前就拒绝请求。
+ *
+ * @example
+ * ```ts
+ * if (!limitResult.success) {
+ *   return createSseError("Rate limit exceeded", 429)
+ * }
+ * ```
+ */
+export function createSseError(message: string, status: number): Response {
+  return new Response(formatSseError(message), {
+    status,
+    headers: { "Content-Type": "text/event-stream" },
+  })
+}
diff --git a/src/shared/stores/ui-store.ts b/src/shared/stores/ui-store.ts
new file mode 100644
index 0000000..c48d7d8
--- /dev/null
+++ b/src/shared/stores/ui-store.ts
@@ -0,0 +1,79 @@
+"use client"
+
+import { create } from "zustand"
+
+/**
+ * Modal 名称。
+ *
+ * 字符串字面量类型，允许业务侧自由命名（如 "user-import"）。
+ * 强类型枚举可后续按需收紧。
+ */
+export type ModalName = string
+
+export type ModalProps = Record<string, unknown>
+
+interface ModalEntry {
+  props?: ModalProps
+}
+
+interface UiState {
+  /** 当前打开的 modal 集合（按 name 索引） */
+  modals: Record<ModalName, ModalEntry>
+  /** 打开指定 modal，可携带 props 供 modal 组件消费 */
+  openModal: (name: ModalName, props?: ModalProps) => void
+  /** 关闭指定 modal */
+  closeModal: (name: ModalName) => void
+  /** 查询指定 modal 是否打开 */
+  isOpen: (name: ModalName) => boolean
+  /** 关闭所有 modal（路由切换或全局 reset 时使用） */
+  closeAll: () => void
+}
+
+/**
+ * 全局 UI store（zustand）。
+ *
+ * 职责：
+ * - 集中管理 modal registry，替换 30+ 处 useState(false) 各自维护开关的反模式
+ * - 支持命令式 API（openModal/closeModal）和 Hook API（useModal）双入口
+ * - 支持携带 props，便于跨组件传递 modal 上下文
+ *
+ * 与 sonner 的分工：
+ * - toast 走 `shared/lib/notify.ts`（保留 sonner 渲染层）
+ * - modal 走本 store
+ */
+export const useUiStore = create<UiState>((set, get) => ({
+  modals: {},
+  openModal: (name, props) =>
+    set((s) => ({ modals: { ...s.modals, [name]: { props } } })),
+  closeModal: (name) =>
+    set((s) => {
+      if (!s.modals[name]) return s
+      const next = { ...s.modals }
+      delete next[name]
+      return { modals: next }
+    }),
+  isOpen: (name) => Boolean(get().modals[name]),
+  closeAll: () => set({ modals: {} }),
+}))
+
+/**
+ * 消费指定 modal 的 Hook。
+ *
+ * @example
+ * const { open, props, openModal, closeModal } = useModal("user-import")
+ * <Button onClick={() => openModal()}>导入用户</Button>
+ * <UserImportDialog open={open} onClose={closeModal} initialData={props?.data} />
+ */
+export function useModal(name: ModalName): {
+  open: boolean
+  props: ModalProps | undefined
+  openModal: (props?: ModalProps) => void
+  closeModal: () => void
+} {
+  return useUiStore((s) => ({
+    open: Boolean(s.modals[name]),
+    props: s.modals[name]?.props,
+    openModal: (props?: ModalProps) => s.openModal(name, props),
+    closeModal: () => s.closeModal(name),
+  }))
+}