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/grades/page.tsx

@@ -1,27 +1,36 @@
+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 { db } from "@/shared/db"
-import { subjects } from "@/shared/db/schema"
-import { asc } from "drizzle-orm"
 import { getAuthContext } from "@/shared/lib/auth-guard"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 import { getTeacherClasses } from "@/modules/classes/data-access"
 import { getGradeRecords } from "@/modules/grades/data-access"
+import { getSubjectOptions } from "@/modules/school/data-access"
 import { GradeQueryFilters } from "@/modules/grades/components/grade-query-filters"
 import { GradeRecordList } from "@/modules/grades/components/grade-record-list"
 import { ExportButton } from "@/modules/grades/components/export-button"
+import type { GradeRecordType, GradeRecordSemester } from "@/modules/grades/types"
 
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
+const VALID_GRADE_TYPES: ReadonlySet<string> = new Set(["exam", "quiz", "homework", "other"])
+const VALID_SEMESTERS: ReadonlySet<string> = new Set(["1", "2"])
 
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
+function parseGradeType(v?: string): GradeRecordType | undefined {
+  return v && VALID_GRADE_TYPES.has(v) ? (v as GradeRecordType) : undefined
 }
 
-export default async function TeacherGradesPage({ searchParams }: { searchParams: Promise<SearchParams> }) {
+function parseSemester(v?: string): GradeRecordSemester | undefined {
+  return v && VALID_SEMESTERS.has(v) ? (v as GradeRecordSemester) : undefined
+}
+
+export default async function TeacherGradesPage({
+  searchParams,
+}: {
+  searchParams: Promise<SearchParams>
+}): Promise<JSX.Element> {
   const sp = await searchParams
   const ctx = await getAuthContext()
 
@@ -30,20 +39,19 @@ export default async function TeacherGradesPage({ searchParams }: { searchParams
   const type = getParam(sp, "type")
   const semester = getParam(sp, "semester")
 
-  const [classes, allSubjects] = await Promise.all([
+  const [classes, allSubjects, records] = await Promise.all([
     getTeacherClasses(),
-    db.query.subjects.findMany({ orderBy: [asc(subjects.order), asc(subjects.name)] }),
+    getSubjectOptions(),
+    getGradeRecords({
+      scope: ctx.dataScope,
+      currentUserId: ctx.userId,
+      classId: classId && classId !== "all" ? classId : undefined,
+      subjectId: subjectId && subjectId !== "all" ? subjectId : undefined,
+      type: type && type !== "all" ? parseGradeType(type) : undefined,
+      semester: semester && semester !== "all" ? parseSemester(semester) : undefined,
+    }),
   ])
 
-  const records = await getGradeRecords({
-    scope: ctx.dataScope,
-    currentUserId: ctx.userId,
-    classId: classId && classId !== "all" ? classId : undefined,
-    subjectId: subjectId && subjectId !== "all" ? subjectId : undefined,
-    type: type && type !== "all" ? (type as "exam" | "quiz" | "homework" | "other") : undefined,
-    semester: semester && semester !== "all" ? (semester as "1" | "2") : undefined,
-  })
-
   const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
   const subjectOptions = allSubjects.map((s) => ({ id: s.id, name: s.name }))
 
@@ -51,19 +59,19 @@ export default async function TeacherGradesPage({ searchParams }: { searchParams
     <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">Grades</h2>
+          <h1 className="text-2xl font-bold tracking-tight">Grades</h1>
           <p className="text-muted-foreground">Manage student grade records.</p>
         </div>
         <div className="flex items-center gap-2">
           <Button asChild variant="outline">
             <Link href="/teacher/grades/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 variant="outline">
             <Link href="/teacher/grades/entry">
-              <ClipboardList className="mr-2 h-4 w-4" />
+              <ClipboardList className="mr-2 h-4 w-4" aria-hidden="true" />
               Batch Entry
             </Link>
           </Button>
@@ -74,7 +82,7 @@ export default async function TeacherGradesPage({ searchParams }: { searchParams
           />
           <Button asChild>
             <Link href="/teacher/grades/entry">
-              <PlusCircle className="mr-2 h-4 w-4" />
+              <PlusCircle className="mr-2 h-4 w-4" aria-hidden="true" />
               Record Grades
             </Link>
           </Button>