feat: 新增备课模块并修复全模块 P0/P1/P2 缺陷

主要变更:

- 新增 lesson-preparation 模块: 备课编辑器、节点编辑、AI 建议、知识点选择、版本历史、作业发布

- 新增 shared 通用组件: charts/question-bank-filters/schedule-list/ui (chip-nav/filter-bar/page-header/stat-card/stat-item)

- 新增 student/admin 端 loading.tsx 与 error.tsx, 优化加载与错误态体验

- 新增 teacher/lesson-plans 页面 (列表/新建/编辑)

- 新增 drizzle 迁移 0002_tiny_lionheart 及 snapshot

- 新增 textbooks/schema.ts 与 exams/utils/normalize-structure.ts

- 修复 Tiptap v3 SSR hydration 崩溃 (rich-text-block immediatelyRender: false)

- 重构多模块 data-access/actions/组件, 修复权限校验与类型规范

- 同步架构文档 004/005 反映新增模块、导出、依赖关系

- 归档 bugs/* 测试报告与 e2e 测试脚本 (admin/parent/student/teacher web_test)

src/modules/messaging/data-access.ts

@@ -9,31 +9,35 @@ import "server-only"
  * - getUnreadMessageCount: 未读私信计数
  * - getRecipients: 获取收件人列表（按 DataScope 过滤）
  *
- * 注意: 通知相关函数（createNotification / getNotifications /
+ * 通知相关函数（createNotification / getNotifications /
  * markNotificationAsRead / markAllNotificationsAsRead / getUnreadNotificationCount）
- * 已迁移到 notifications/data-access.ts（P0-4 / P1-5 修复）。
- * 本文件通过 re-export 保持向后兼容，现有调用方无需修改 import 路径。
+ * 已迁移到 notifications/data-access.ts，请直接从该模块导入。
  */
 
 import { cache } from "react"
 import { createId } from "@paralleldrive/cuid2"
-import { and, count, desc, eq, inArray, or } from "drizzle-orm"
+import { and, count, desc, eq, inArray, or, type SQL } from "drizzle-orm"
 
 import { db } from "@/shared/db"
 import {
   messages,
   users,
-  classEnrollments,
-  classes,
 } from "@/shared/db/schema"
+import {
+  getClassesByGradeId,
+  getStudentIdsByClassIds,
+  getTeacherIdsByClassIds,
+  getStudentActiveClassId,
+} from "@/modules/classes/data-access"
+import { getUserNamesByIds } from "@/modules/users/data-access"
 import type { DataScope } from "@/shared/types/permissions"
 import type {
   Message,
   GetMessagesParams,
   CreateMessageInput,
-  PaginatedResult,
   RecipientOption,
 } from "./types"
+import type { PaginatedResult } from "@/modules/notifications/types"
 
 const toIso = (d: Date | null | undefined): string | null => (d ? d.toISOString() : null)
 
@@ -81,7 +85,7 @@ export const getMessages = cache(
     const pageSize = Math.max(1, params.pageSize ?? 20)
     const offset = (page - 1) * pageSize
 
-    const conds = []
+    const conds: SQL[] = []
     if (params.type === "inbox") conds.push(eq(messages.receiverId, params.userId))
     else if (params.type === "sent") conds.push(eq(messages.senderId, params.userId))
     else {
@@ -171,34 +175,42 @@ export const getRecipients = cache(
       return all.filter((r) => r.id !== userId).map((r) => ({ ...r, name: r.name ?? r.email }))
     }
     if (scope.type === "class_taught" && scope.classIds.length > 0) {
-      const rows = await db
-        .selectDistinct({ id: users.id, name: users.name, email: users.email })
-        .from(users)
-        .innerJoin(classEnrollments, eq(classEnrollments.studentId, users.id))
-        .where(inArray(classEnrollments.classId, scope.classIds))
-      return rows.map((r) => ({ ...r, name: r.name ?? r.email, role: "student" }))
+      // 通过 classes data-access 获取学生 ID，避免直接 JOIN classEnrollments 表
+      const studentIds = await getStudentIdsByClassIds(scope.classIds)
+      const userMap = await getUserNamesByIds(studentIds)
+      return Array.from(userMap.values())
+        .filter((u) => u.id !== userId)
+        .map((u) => ({ id: u.id, name: u.name ?? u.email, email: u.email, role: "student" }))
     }
     if (scope.type === "grade_managed" && scope.gradeIds.length > 0) {
-      const rows = await db
-        .selectDistinct({ id: users.id, name: users.name, email: users.email })
-        .from(users)
-        .innerJoin(classEnrollments, eq(classEnrollments.studentId, users.id))
-        .innerJoin(classes, eq(classes.id, classEnrollments.classId))
-        .where(inArray(classes.gradeId, scope.gradeIds))
-      return rows.map((r) => ({ ...r, name: r.name ?? r.email, role: "student" }))
+      // 通过 classes data-access 获取年级下所有班级，再获取学生 ID，
+      // 避免直接 JOIN classes / classEnrollments 表
+      const classLists = await Promise.all(scope.gradeIds.map((g) => getClassesByGradeId(g)))
+      const classIds = classLists.flat().map((c) => c.id)
+      const studentIds = await getStudentIdsByClassIds(classIds)
+      const userMap = await getUserNamesByIds(studentIds)
+      return Array.from(userMap.values())
+        .filter((u) => u.id !== userId)
+        .map((u) => ({ id: u.id, name: u.name ?? u.email, email: u.email, role: "student" }))
+    }
+    if (scope.type === "class_members" && scope.classIds.length > 0) {
+      // 学生可以给自己班级的任课教师/班主任发消息
+      const teacherIds = await getTeacherIdsByClassIds(scope.classIds)
+      const userMap = await getUserNamesByIds(teacherIds)
+      return Array.from(userMap.values())
+        .filter((u) => u.id !== userId)
+        .map((u) => ({ id: u.id, name: u.name ?? u.email, email: u.email, role: "teacher" }))
+    }
+    if (scope.type === "children" && scope.childrenIds.length > 0) {
+      // 家长可以给孩子的班主任/任课教师发消息
+      const classIds = await Promise.all(scope.childrenIds.map((id) => getStudentActiveClassId(id)))
+      const validClassIds = classIds.filter((id): id is string => id !== null)
+      const teacherIds = await getTeacherIdsByClassIds(validClassIds)
+      const userMap = await getUserNamesByIds(teacherIds)
+      return Array.from(userMap.values())
+        .filter((u) => u.id !== userId)
+        .map((u) => ({ id: u.id, name: u.name ?? u.email, email: u.email, role: "teacher" }))
     }
     return []
   }
 )
-
-// ---------------------------------------------------------------------------
-// 向后兼容 re-export：通知 CRUD 已迁移到 notifications/data-access.ts
-// ---------------------------------------------------------------------------
-
-export {
-  createNotification,
-  getNotifications,
-  markNotificationAsRead,
-  markAllNotificationsAsRead,
-  getUnreadNotificationCount,
-} from "@/modules/notifications/data-access"