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/app/(dashboard)/teacher/attendance/page.tsx

@@ -1,27 +1,35 @@
+import type { JSX } from "react"
 import Link from "next/link"
 import { PlusCircle, BarChart3, ClipboardList } from "lucide-react"
 import { Button } from "@/shared/components/ui/button"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { getAuthContext } from "@/shared/lib/auth-guard"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 import { getTeacherClasses } from "@/modules/classes/data-access"
 import { getAttendanceRecords } from "@/modules/attendance/data-access"
 import { AttendanceFilters } from "@/modules/attendance/components/attendance-filters"
 import { AttendanceRecordList } from "@/modules/attendance/components/attendance-record-list"
+import type { AttendanceStatus } from "@/modules/attendance/types"
 
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
+const VALID_STATUSES: ReadonlySet<string> = new Set([
+  "present",
+  "absent",
+  "late",
+  "early_leave",
+  "excused",
+])
 
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
+function parseAttendanceStatus(v?: string): AttendanceStatus | undefined {
+  return v && VALID_STATUSES.has(v) ? (v as AttendanceStatus) : undefined
 }
 
 export default async function TeacherAttendancePage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   const sp = await searchParams
   const ctx = await getAuthContext()
 
@@ -29,34 +37,35 @@ export default async function TeacherAttendancePage({
   const status = getParam(sp, "status")
   const date = getParam(sp, "date")
 
-  const classes = await getTeacherClasses()
+  const [classes, result] = await Promise.all([
+    getTeacherClasses(),
+    getAttendanceRecords({
+      scope: ctx.dataScope,
+      currentUserId: ctx.userId,
+      classId: classId && classId !== "all" ? classId : undefined,
+      status: status && status !== "all" ? parseAttendanceStatus(status) : undefined,
+      date: date && date.length > 0 ? date : undefined,
+    }),
+  ])
   const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
 
-  const result = await getAttendanceRecords({
-    scope: ctx.dataScope,
-    currentUserId: ctx.userId,
-    classId: classId && classId !== "all" ? classId : undefined,
-    status: status && status !== "all" ? (status as "present" | "absent" | "late" | "early_leave" | "excused") : undefined,
-    date: date && date.length > 0 ? date : undefined,
-  })
-
   return (
     <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
       <div className="flex items-center justify-between space-y-2">
         <div>
-          <h2 className="text-2xl font-bold tracking-tight">Attendance</h2>
+          <h1 className="text-2xl font-bold tracking-tight">Attendance</h1>
           <p className="text-muted-foreground">Manage student attendance records.</p>
         </div>
         <div className="flex items-center gap-2">
           <Button asChild variant="outline">
             <Link href="/teacher/attendance/stats">
-              <BarChart3 className="mr-2 h-4 w-4" />
+              <BarChart3 className="mr-2 h-4 w-4" aria-hidden="true" />
               Statistics
             </Link>
           </Button>
           <Button asChild>
             <Link href="/teacher/attendance/sheet">
-              <PlusCircle className="mr-2 h-4 w-4" />
+              <PlusCircle className="mr-2 h-4 w-4" aria-hidden="true" />
               Take Attendance
             </Link>
           </Button>

src/app/(dashboard)/teacher/attendance/sheet/page.tsx

@@ -1,38 +1,33 @@
+import type { JSX } from "react"
 import { getTeacherClasses } from "@/modules/classes/data-access"
 import { getClassStudentsForAttendance } from "@/modules/attendance/data-access"
 import { AttendanceSheet } from "@/modules/attendance/components/attendance-sheet"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
-
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
-}
-
 export default async function AttendanceSheetPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   const sp = await searchParams
 
   const defaultClassId = getParam(sp, "classId")
   const defaultDate = getParam(sp, "date")
 
-  const classes = await getTeacherClasses()
+  const [classes, students] = await Promise.all([
+    getTeacherClasses(),
+    defaultClassId
+      ? getClassStudentsForAttendance(defaultClassId)
+      : Promise.resolve([] as Awaited<ReturnType<typeof getClassStudentsForAttendance>>),
+  ])
   const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
 
-  let students: Array<{ id: string; name: string; email: string }> = []
-  if (defaultClassId) {
-    students = await getClassStudentsForAttendance(defaultClassId)
-  }
-
   return (
     <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
       <div>
-        <h2 className="text-2xl font-bold tracking-tight">Take Attendance</h2>
+        <h1 className="text-2xl font-bold tracking-tight">Take Attendance</h1>
         <p className="text-muted-foreground">
           Select a class and date, then mark attendance for each student.
         </p>

src/app/(dashboard)/teacher/attendance/stats/page.tsx

@@ -1,24 +1,20 @@
+import type { JSX } from "react"
 import { getTeacherClasses } from "@/modules/classes/data-access"
 import { getClassAttendanceStats } from "@/modules/attendance/data-access-stats"
 import { AttendanceStatsCard } from "@/modules/attendance/components/attendance-stats-card"
 import { AttendanceRecordList } from "@/modules/attendance/components/attendance-record-list"
+import { AttendanceStatsClassSelector } from "@/modules/attendance/components/attendance-stats-class-selector"
 import { EmptyState } from "@/shared/components/ui/empty-state"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 import { BarChart3 } from "lucide-react"
 
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
-
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
-}
-
 export default async function AttendanceStatsPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
   const sp = await searchParams
 
   const classId = getParam(sp, "classId")
@@ -31,7 +27,7 @@ export default async function AttendanceStatsPage({
     return (
       <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
         <div>
-          <h2 className="text-2xl font-bold tracking-tight">Attendance Statistics</h2>
+          <h1 className="text-2xl font-bold tracking-tight">Attendance Statistics</h1>
           <p className="text-muted-foreground">View class attendance statistics.</p>
         </div>
         <EmptyState
@@ -57,11 +53,11 @@ export default async function AttendanceStatsPage({
   return (
     <div className="h-full flex-1 flex-col space-y-8 p-8 md:flex">
       <div>
-        <h2 className="text-2xl font-bold tracking-tight">Attendance Statistics</h2>
+        <h1 className="text-2xl font-bold tracking-tight">Attendance Statistics</h1>
         <p className="text-muted-foreground">View class attendance statistics and trends.</p>
       </div>
 
-      <StatsClassSelector
+      <AttendanceStatsClassSelector
         classes={classOptions}
         currentClassId={targetClassId}
         startDate={startDate ?? ""}
@@ -72,7 +68,7 @@ export default async function AttendanceStatsPage({
         <>
           <AttendanceStatsCard stats={summary.stats} />
           <div>
-            <h3 className="mb-4 text-lg font-semibold">Student Records</h3>
+            <h2 className="mb-4 text-lg font-semibold">Student Records</h2>
             <AttendanceRecordList records={summary.studentRecords} />
           </div>
         </>
@@ -87,34 +83,3 @@ export default async function AttendanceStatsPage({
     </div>
   )
 }
-
-function StatsClassSelector({
-  classes,
-  currentClassId,
-  startDate,
-  endDate,
-}: {
-  classes: Array<{ id: string; name: string }>
-  currentClassId: string
-  startDate: string
-  endDate: string
-}) {
-  const dateParams = `${startDate ? `&startDate=${startDate}` : ""}${endDate ? `&endDate=${endDate}` : ""}`
-  return (
-    <div className="flex flex-wrap gap-2">
-      {classes.map((c) => (
-        <a
-          key={c.id}
-          href={`/teacher/attendance/stats?classId=${c.id}${dateParams}`}
-          className={`rounded-md border px-3 py-1.5 text-sm transition-colors ${
-            c.id === currentClassId
-              ? "border-primary bg-primary text-primary-foreground"
-              : "bg-card hover:bg-accent"
-          }`}
-        >
-          {c.name}
-        </a>
-      ))}
-    </div>
-  )
-}