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/homework/assignments/[id]/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import Link from "next/link"
 import { notFound } from "next/navigation"
 import { getHomeworkAssignmentAnalytics } from "@/modules/homework/data-access"
@@ -10,7 +11,7 @@ import { ChevronLeft, Users, Calendar, BarChart3, CheckCircle2 } from "lucide-re
 
 export const dynamic = "force-dynamic"
 
-export default async function HomeworkAssignmentDetailPage({ params }: { params: Promise<{ id: string }> }) {
+export default async function HomeworkAssignmentDetailPage({ params }: { params: Promise<{ id: string }> }): Promise<JSX.Element> {
   const { id } = await params
   const analytics = await getHomeworkAssignmentAnalytics(id)
 
@@ -23,17 +24,17 @@ export default async function HomeworkAssignmentDetailPage({ params }: { params:
       {/* Header */}
       <div className="border-b bg-background px-8 py-5">
         <div className="flex flex-col gap-4 md:flex-row md:items-start md:justify-between">
-          <div className="flex flex-col gap-2">
+          <div className="min-w-0 flex flex-col gap-2">
             <div className="flex items-center gap-2 text-sm text-muted-foreground mb-1">
               <Link href="/teacher/homework/assignments" className="flex items-center hover:text-foreground transition-colors">
-                <ChevronLeft className="h-4 w-4 mr-1" />
+                <ChevronLeft className="h-4 w-4 mr-1" aria-hidden="true" />
                 Assignments
               </Link>
-              <span>/</span>
+              <span aria-hidden="true">/</span>
               <span>Details</span>
             </div>
             <div className="flex items-center gap-3">
-              <h1 className="text-2xl font-bold tracking-tight text-foreground">{assignment.title}</h1>
+              <h1 className="text-2xl font-bold tracking-tight text-foreground line-clamp-2">{assignment.title}</h1>
               <Badge variant={assignment.status === "published" ? "default" : "secondary"} className="capitalize">
                 {assignment.status}
               </Badge>
@@ -44,7 +45,7 @@ export default async function HomeworkAssignmentDetailPage({ params }: { params:
           <div className="flex items-center gap-3 mt-2 md:mt-0">
             <Button asChild variant="outline" className="shadow-sm">
               <Link href={`/teacher/homework/assignments/${assignment.id}/submissions`}>
-                <Users className="h-4 w-4 mr-2" />
+                <Users className="h-4 w-4 mr-2" aria-hidden="true" />
                 View Submissions
               </Link>
             </Button>
@@ -54,20 +55,20 @@ export default async function HomeworkAssignmentDetailPage({ params }: { params:
         {/* Quick Stats Row */}
         <div className="flex flex-wrap gap-x-8 gap-y-2 mt-6 text-sm">
           <div className="flex items-center gap-2 text-muted-foreground">
-            <Calendar className="h-4 w-4" />
-            <span>Due: <span className="font-medium text-foreground">{assignment.dueAt ? formatDate(assignment.dueAt) : "No due date"}</span></span>
+            <Calendar className="h-4 w-4" aria-hidden="true" />
+            <span>Due: <span className="font-medium text-foreground tabular-nums">{assignment.dueAt ? formatDate(assignment.dueAt) : "No due date"}</span></span>
           </div>
           <div className="flex items-center gap-2 text-muted-foreground">
-            <Users className="h-4 w-4" />
-            <span>Targets: <span className="font-medium text-foreground">{assignment.targetCount}</span></span>
+            <Users className="h-4 w-4" aria-hidden="true" />
+            <span>Targets: <span className="font-medium text-foreground tabular-nums">{assignment.targetCount}</span></span>
           </div>
           <div className="flex items-center gap-2 text-muted-foreground">
-            <CheckCircle2 className="h-4 w-4" />
-            <span>Submissions: <span className="font-medium text-foreground">{assignment.submissionCount}</span></span>
+            <CheckCircle2 className="h-4 w-4" aria-hidden="true" />
+            <span>Submissions: <span className="font-medium text-foreground tabular-nums">{assignment.submissionCount}</span></span>
           </div>
           <div className="flex items-center gap-2 text-muted-foreground">
-            <BarChart3 className="h-4 w-4" />
-            <span>Graded: <span className="font-medium text-foreground">{gradedSampleCount}</span></span>
+            <BarChart3 className="h-4 w-4" aria-hidden="true" />
+            <span>Graded: <span className="font-medium text-foreground tabular-nums">{gradedSampleCount}</span></span>
           </div>
         </div>
       </div>

src/app/(dashboard)/teacher/homework/assignments/[id]/submissions/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import Link from "next/link"
 import { notFound } from "next/navigation"
 import { Badge } from "@/shared/components/ui/badge"
@@ -15,27 +16,28 @@ import { getHomeworkAssignmentById, getHomeworkSubmissions } from "@/modules/hom
 
 export const dynamic = "force-dynamic"
 
-export default async function HomeworkAssignmentSubmissionsPage({ params }: { params: Promise<{ id: string }> }) {
+export default async function HomeworkAssignmentSubmissionsPage({ params }: { params: Promise<{ id: string }> }): Promise<JSX.Element> {
   const { id } = await params
-  const assignment = await getHomeworkAssignmentById(id)
+  const [assignment, submissions] = await Promise.all([
+    getHomeworkAssignmentById(id),
+    getHomeworkSubmissions({ assignmentId: id }),
+  ])
   if (!assignment) return notFound()
 
-  const submissions = await getHomeworkSubmissions({ assignmentId: id })
-
   return (
     <div className="flex h-full flex-col space-y-8 p-8">
       <div className="flex flex-col justify-between gap-4 md:flex-row md:items-center">
-        <div>
-          <h2 className="text-2xl font-bold tracking-tight">Submissions</h2>
-          <p className="text-muted-foreground">{assignment.title}</p>
+        <div className="min-w-0">
+          <h1 className="text-2xl font-bold tracking-tight">Submissions</h1>
+          <p className="text-muted-foreground truncate">{assignment.title}</p>
           <div className="mt-2 flex flex-wrap items-center gap-2 text-sm text-muted-foreground">
             <span>Exam: {assignment.sourceExamTitle}</span>
-            <span>•</span>
-            <span>Targets: {assignment.targetCount}</span>
-            <span>•</span>
-            <span>Submitted: {assignment.submittedCount}</span>
-            <span>•</span>
-            <span>Graded: {assignment.gradedCount}</span>
+            <span aria-hidden="true">•</span>
+            <span className="tabular-nums">Targets: {assignment.targetCount}</span>
+            <span aria-hidden="true">•</span>
+            <span className="tabular-nums">Submitted: {assignment.submittedCount}</span>
+            <span aria-hidden="true">•</span>
+            <span className="tabular-nums">Graded: {assignment.gradedCount}</span>
           </div>
         </div>
         <div className="flex items-center gap-2">
@@ -62,15 +64,15 @@ export default async function HomeworkAssignmentSubmissionsPage({ params }: { pa
           <TableBody>
             {submissions.map((s) => (
               <TableRow key={s.id}>
-                <TableCell className="font-medium">{s.studentName}</TableCell>
+                <TableCell className="font-medium truncate max-w-[160px]">{s.studentName}</TableCell>
                 <TableCell>
                   <Badge variant="outline" className="capitalize">
                     {s.status}
                   </Badge>
                   {s.isLate ? <span className="ml-2 text-xs text-destructive">Late</span> : null}
                 </TableCell>
-                <TableCell className="text-muted-foreground">{s.submittedAt ? formatDate(s.submittedAt) : "-"}</TableCell>
-                <TableCell>{typeof s.score === "number" ? s.score : "-"}</TableCell>
+                <TableCell className="text-muted-foreground tabular-nums">{s.submittedAt ? formatDate(s.submittedAt) : "-"}</TableCell>
+                <TableCell className="tabular-nums">{typeof s.score === "number" ? s.score : "-"}</TableCell>
                 <TableCell>
                   <Link href={`/teacher/homework/submissions/${s.id}`} className="text-sm underline-offset-4 hover:underline">
                     Grade

src/app/(dashboard)/teacher/homework/assignments/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import Link from "next/link"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { Badge } from "@/shared/components/ui/badge"
@@ -11,6 +12,7 @@ import {
   TableRow,
 } from "@/shared/components/ui/table"
 import { formatDate } from "@/shared/lib/utils"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 import { getHomeworkAssignments } from "@/modules/homework/data-access"
 import { getTeacherClasses } from "@/modules/classes/data-access"
 import { PenTool, PlusCircle } from "lucide-react"
@@ -18,36 +20,33 @@ import { getTeacherIdForMutations } from "@/modules/classes/data-access"
 
 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 AssignmentsPage({ searchParams }: { searchParams: Promise<SearchParams> }) {
+export default async function AssignmentsPage({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   const sp = await searchParams
-  const classId = getParam(sp, "classId") || undefined
+  const rawClassId = getParam(sp, "classId")
   const creatorId = await getTeacherIdForMutations()
 
+  // Only fetch classes list when a class filter is active — needed to resolve
+  // the class name for display. When no filter is applied, skip the query to
+  // avoid an unnecessary DB round-trip.
+  const filteredClassId = rawClassId && rawClassId !== "all" ? rawClassId : null
   const [assignments, classes] = await Promise.all([
-    getHomeworkAssignments({ creatorId, classId: classId && classId !== "all" ? classId : undefined }),
-    classId && classId !== "all" ? getTeacherClasses() : Promise.resolve([]),
+    getHomeworkAssignments({ creatorId, classId: filteredClassId ?? undefined }),
+    filteredClassId ? getTeacherClasses() : Promise.resolve([]),
   ])
   const hasAssignments = assignments.length > 0
-  const className = classId && classId !== "all" ? classes.find((c) => c.id === classId)?.name : undefined
+  const className = filteredClassId ? classes.find((c) => c.id === filteredClassId)?.name : 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">Assignments</h2>
+          <h1 className="text-2xl font-bold tracking-tight">Assignments</h1>
           <p className="text-muted-foreground">
-            {classId && classId !== "all" ? `Filtered by class: ${className ?? classId}` : "Manage homework assignments."}
+            {filteredClassId ? `Filtered by class: ${className ?? filteredClassId}` : "Manage homework assignments."}
           </p>
         </div>
         <div className="flex items-center gap-2">
-          {classId && classId !== "all" ? (
+          {filteredClassId ? (
             <Button asChild variant="outline">
               <Link href="/teacher/homework/assignments">Clear filter</Link>
             </Button>
@@ -55,12 +54,12 @@ export default async function AssignmentsPage({ searchParams }: { searchParams:
           <Button asChild>
             <Link
               href={
-                classId && classId !== "all"
-                  ? `/teacher/homework/assignments/create?classId=${encodeURIComponent(classId)}`
+                filteredClassId
+                  ? `/teacher/homework/assignments/create?classId=${encodeURIComponent(filteredClassId)}`
                   : "/teacher/homework/assignments/create"
               }
             >
-              <PlusCircle className="mr-2 h-4 w-4" />
+              <PlusCircle className="mr-2 h-4 w-4" aria-hidden="true" />
               Create Assignment
             </Link>
           </Button>
@@ -70,13 +69,13 @@ export default async function AssignmentsPage({ searchParams }: { searchParams:
       {!hasAssignments ? (
         <EmptyState
           title="No assignments"
-          description={classId && classId !== "all" ? "No assignments for this class yet." : "You haven't created any assignments yet."}
+          description={filteredClassId ? "No assignments for this class yet." : "You haven't created any assignments yet."}
           icon={PenTool}
           action={{
             label: "Create Assignment",
             href:
-              classId && classId !== "all"
-                ? `/teacher/homework/assignments/create?classId=${encodeURIComponent(classId)}`
+              filteredClassId
+                ? `/teacher/homework/assignments/create?classId=${encodeURIComponent(filteredClassId)}`
                 : "/teacher/homework/assignments/create",
           }}
         />
@@ -96,7 +95,10 @@ export default async function AssignmentsPage({ searchParams }: { searchParams:
               {assignments.map((a) => (
                 <TableRow key={a.id}>
                   <TableCell className="font-medium">
-                    <Link href={`/teacher/homework/assignments/${a.id}`} className="hover:underline">
+                    <Link
+                      href={`/teacher/homework/assignments/${a.id}`}
+                      className="hover:underline line-clamp-2 max-w-[240px]"
+                    >
                       {a.title}
                     </Link>
                   </TableCell>
@@ -105,9 +107,9 @@ export default async function AssignmentsPage({ searchParams }: { searchParams:
                       {a.status}
                     </Badge>
                   </TableCell>
-                  <TableCell>{a.dueAt ? formatDate(a.dueAt) : "-"}</TableCell>
-                  <TableCell className="text-muted-foreground">{a.sourceExamTitle}</TableCell>
-                  <TableCell className="text-muted-foreground">{formatDate(a.createdAt)}</TableCell>
+                  <TableCell className="text-muted-foreground tabular-nums">{a.dueAt ? formatDate(a.dueAt) : "-"}</TableCell>
+                  <TableCell className="text-muted-foreground truncate max-w-[200px]">{a.sourceExamTitle}</TableCell>
+                  <TableCell className="text-muted-foreground tabular-nums">{formatDate(a.createdAt)}</TableCell>
                 </TableRow>
               ))}
             </TableBody>

src/app/(dashboard)/teacher/homework/submissions/[submissionId]/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { notFound } from "next/navigation"
 import { getHomeworkSubmissionDetails } from "@/modules/homework/data-access"
 import { HomeworkGradingView } from "@/modules/homework/components/homework-grading-view"
@@ -5,7 +6,7 @@ import { formatDate } from "@/shared/lib/utils"
 
 export const dynamic = "force-dynamic"
 
-export default async function HomeworkSubmissionGradingPage({ params }: { params: Promise<{ submissionId: string }> }) {
+export default async function HomeworkSubmissionGradingPage({ params }: { params: Promise<{ submissionId: string }> }): Promise<JSX.Element> {
   const { submissionId } = await params
   const submission = await getHomeworkSubmissionDetails(submissionId)
 
@@ -14,15 +15,15 @@ export default async function HomeworkSubmissionGradingPage({ params }: { params
   return (
     <div className="flex h-full flex-col space-y-4 p-6">
       <div className="flex items-center justify-between">
-        <div>
-          <h2 className="text-2xl font-bold tracking-tight">{submission.assignmentTitle}</h2>
+        <div className="min-w-0">
+          <h1 className="text-2xl font-bold tracking-tight line-clamp-2">{submission.assignmentTitle}</h1>
           <div className="flex items-center gap-4 text-sm text-muted-foreground mt-1">
             <span>
               Student: <span className="font-medium text-foreground">{submission.studentName}</span>
             </span>
-            <span>•</span>
-            <span>Submitted: {submission.submittedAt ? formatDate(submission.submittedAt) : "-"}</span>
-            <span>•</span>
+            <span aria-hidden="true">•</span>
+            <span className="tabular-nums">Submitted: {submission.submittedAt ? formatDate(submission.submittedAt) : "-"}</span>
+            <span aria-hidden="true">•</span>
             <span className="capitalize">Status: {submission.status}</span>
           </div>
         </div>

src/app/(dashboard)/teacher/homework/submissions/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import Link from "next/link"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { Badge } from "@/shared/components/ui/badge"
@@ -16,7 +17,7 @@ import { getTeacherIdForMutations } from "@/modules/classes/data-access"
 
 export const dynamic = "force-dynamic"
 
-export default async function SubmissionsPage() {
+export default async function SubmissionsPage(): Promise<JSX.Element> {
   const creatorId = await getTeacherIdForMutations()
   const assignments = await getHomeworkAssignmentReviewList({ creatorId })
   const hasAssignments = assignments.length > 0
@@ -25,7 +26,7 @@ export default async function SubmissionsPage() {
     <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">Submissions</h2>
+          <h1 className="text-2xl font-bold tracking-tight">Submissions</h1>
           <p className="text-muted-foreground">
             Review homework by assignment.
           </p>
@@ -55,20 +56,23 @@ export default async function SubmissionsPage() {
               {assignments.map((a) => (
                 <TableRow key={a.id}>
                   <TableCell className="font-medium">
-                    <Link href={`/teacher/homework/assignments/${a.id}/submissions`} className="hover:underline">
+                    <Link
+                      href={`/teacher/homework/assignments/${a.id}/submissions`}
+                      className="hover:underline line-clamp-2 max-w-[240px]"
+                    >
                       {a.title}
                     </Link>
-                    <div className="text-xs text-muted-foreground">{a.sourceExamTitle}</div>
+                    <div className="text-xs text-muted-foreground truncate max-w-[200px]">{a.sourceExamTitle}</div>
                   </TableCell>
                   <TableCell>
                     <Badge variant="outline" className="capitalize">
                       {a.status}
                     </Badge>
                   </TableCell>
-                  <TableCell className="text-muted-foreground">{a.dueAt ? formatDate(a.dueAt) : "-"}</TableCell>
-                  <TableCell className="text-right">{a.targetCount}</TableCell>
-                  <TableCell className="text-right">{a.submittedCount}</TableCell>
-                  <TableCell className="text-right">{a.gradedCount}</TableCell>
+                  <TableCell className="text-muted-foreground tabular-nums">{a.dueAt ? formatDate(a.dueAt) : "-"}</TableCell>
+                  <TableCell className="text-right tabular-nums">{a.targetCount}</TableCell>
+                  <TableCell className="text-right tabular-nums">{a.submittedCount}</TableCell>
+                  <TableCell className="text-right tabular-nums">{a.gradedCount}</TableCell>
                 </TableRow>
               ))}
             </TableBody>