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/textbooks/[id]/loading.tsx

@@ -1,5 +1,5 @@
-import { Skeleton } from "@/shared/components/ui/skeleton";
-import { Separator } from "@/shared/components/ui/separator";
+import { Skeleton } from "@/shared/components/ui/skeleton"
+import { Separator } from "@/shared/components/ui/separator"
 
 export default function Loading() {
   return (
@@ -24,43 +24,43 @@ export default function Loading() {
             <Skeleton className="h-6 w-40" />
             <Skeleton className="h-8 w-24" />
           </div>
-          
+
           <div className="rounded-lg border bg-card p-6 space-y-4">
-             {Array.from({ length: 5 }).map((_, i) => (
-                <div key={i} className="flex items-center gap-4">
-                    <Skeleton className="h-6 w-6 rounded-md" />
-                    <Skeleton className="h-6 w-full rounded-md" />
-                </div>
-             ))}
+            {Array.from({ length: 5 }).map((_, i) => (
+              <div key={i} className="flex items-center gap-4">
+                <Skeleton className="h-6 w-6 rounded-md" />
+                <Skeleton className="h-6 w-full rounded-md" />
+              </div>
+            ))}
           </div>
         </div>
 
         {/* Sidebar Skeleton */}
         <div className="space-y-6">
           <div className="rounded-lg border bg-card p-6 space-y-4">
-             <Skeleton className="h-6 w-32 mb-4" />
-             <div className="space-y-2">
-                <Skeleton className="h-4 w-16" />
-                <Skeleton className="h-5 w-32" />
-             </div>
-             <div className="space-y-2">
-                <Skeleton className="h-4 w-20" />
-                <Skeleton className="h-20 w-full" />
-             </div>
-             <Separator />
-             <div className="grid grid-cols-2 gap-4">
-                <div className="space-y-2">
-                    <Skeleton className="h-3 w-12" />
-                    <Skeleton className="h-4 w-24" />
-                </div>
-                <div className="space-y-2">
-                    <Skeleton className="h-3 w-12" />
-                    <Skeleton className="h-4 w-24" />
-                </div>
-             </div>
+            <Skeleton className="h-6 w-32 mb-4" />
+            <div className="space-y-2">
+              <Skeleton className="h-4 w-16" />
+              <Skeleton className="h-5 w-32" />
+            </div>
+            <div className="space-y-2">
+              <Skeleton className="h-4 w-20" />
+              <Skeleton className="h-20 w-full" />
+            </div>
+            <Separator />
+            <div className="grid grid-cols-2 gap-4">
+              <div className="space-y-2">
+                <Skeleton className="h-3 w-12" />
+                <Skeleton className="h-4 w-24" />
+              </div>
+              <div className="space-y-2">
+                <Skeleton className="h-3 w-12" />
+                <Skeleton className="h-4 w-24" />
+              </div>
+            </div>
           </div>
         </div>
       </div>
     </div>
-  );
+  )
 }

src/app/(dashboard)/teacher/textbooks/[id]/page.tsx

@@ -1,29 +1,30 @@
-import { notFound } from "next/navigation";
-import { ArrowLeft } from "lucide-react";
-import Link from "next/link";
-import { Button } from "@/shared/components/ui/button";
-import { Badge } from "@/shared/components/ui/badge";
-import { getTextbookById, getChaptersByTextbookId, getKnowledgePointsByTextbookId } from "@/modules/textbooks/data-access";
-import { TextbookReader } from "@/modules/textbooks/components/textbook-reader";
-import { TextbookSettingsDialog } from "@/modules/textbooks/components/textbook-settings-dialog";
+import type { JSX } from "react"
+import { notFound } from "next/navigation"
+import { ArrowLeft } from "lucide-react"
+import Link from "next/link"
+import { Button } from "@/shared/components/ui/button"
+import { Badge } from "@/shared/components/ui/badge"
+import { getTextbookById, getChaptersByTextbookId, getKnowledgePointsByTextbookId } from "@/modules/textbooks/data-access"
+import { TextbookReader } from "@/modules/textbooks/components/textbook-reader"
+import { TextbookSettingsDialog } from "@/modules/textbooks/components/textbook-settings-dialog"
 
 export const dynamic = "force-dynamic"
 
 export default async function TextbookDetailPage({
   params,
 }: {
-  params: Promise<{ id: string }>;
-}) {
-  const { id } = await params;
-  
+  params: Promise<{ id: string }>
+}): Promise<JSX.Element> {
+  const { id } = await params
+
   const [textbook, chapters, knowledgePoints] = await Promise.all([
     getTextbookById(id),
     getChaptersByTextbookId(id),
     getKnowledgePointsByTextbookId(id),
-  ]);
+  ])
 
   if (!textbook) {
-    notFound();
+    notFound()
   }
 
   return (
@@ -31,33 +32,33 @@ export default async function TextbookDetailPage({
       {/* Header / Nav (Fixed height) */}
       <div className="flex items-center gap-4 py-4 border-b shrink-0 bg-background z-10">
         <Button variant="ghost" size="icon" asChild>
-          <Link href="/teacher/textbooks">
-            <ArrowLeft className="h-4 w-4" />
+          <Link href="/teacher/textbooks" aria-label="Back to textbooks">
+            <ArrowLeft className="h-4 w-4" aria-hidden="true" />
           </Link>
         </Button>
-        <div className="flex-1">
+        <div className="flex-1 min-w-0">
           <div className="flex items-center gap-2 mb-1">
-             <Badge variant="outline">{textbook.subject}</Badge>
-             <span className="text-xs text-muted-foreground uppercase tracking-wider font-medium">
-                {textbook.grade}
-             </span>
+            <Badge variant="outline">{textbook.subject}</Badge>
+            <span className="text-xs text-muted-foreground uppercase tracking-wider font-medium">
+              {textbook.grade}
+            </span>
           </div>
           <h1 className="text-xl font-bold tracking-tight line-clamp-1">{textbook.title}</h1>
         </div>
         <div className="flex gap-2">
-            <TextbookSettingsDialog textbook={textbook} />
+          <TextbookSettingsDialog textbook={textbook} />
         </div>
       </div>
 
       {/* Main Content Layout (Flex grow) */}
       <div className="flex-1 overflow-hidden pt-6">
-        <TextbookReader 
-            chapters={chapters} 
-            knowledgePoints={knowledgePoints}
-            textbookId={id} 
-            canEdit={true}
+        <TextbookReader
+          chapters={chapters}
+          knowledgePoints={knowledgePoints}
+          textbookId={id}
+          canEdit={true}
         />
       </div>
     </div>
-  );
+  )
 }

src/app/(dashboard)/teacher/textbooks/loading.tsx

@@ -1,5 +1,5 @@
-import { Skeleton } from "@/shared/components/ui/skeleton";
-import { Card, CardContent, CardFooter, CardHeader } from "@/shared/components/ui/card";
+import { Skeleton } from "@/shared/components/ui/skeleton"
+import { Card, CardContent, CardFooter, CardHeader } from "@/shared/components/ui/card"
 
 export default function Loading() {
   return (
@@ -34,15 +34,15 @@ export default function Loading() {
               <Skeleton className="h-6 w-full" />
             </CardHeader>
             <CardContent className="p-4 pt-0 space-y-2">
-               <Skeleton className="h-4 w-24" />
-               <Skeleton className="h-4 w-32" />
+              <Skeleton className="h-4 w-24" />
+              <Skeleton className="h-4 w-32" />
             </CardContent>
             <CardFooter className="p-4 pt-0 mt-auto">
-               <Skeleton className="h-6 w-full rounded-md" />
+              <Skeleton className="h-6 w-full rounded-md" />
             </CardFooter>
           </Card>
         ))}
       </div>
     </div>
-  );
+  )
 }

src/app/(dashboard)/teacher/textbooks/page.tsx

@@ -1,21 +1,16 @@
+import type { JSX } from "react"
 import { Suspense } from "react"
 import { BookOpen } from "lucide-react"
-import { TextbookCard } from "@/modules/textbooks/components/textbook-card";
-import { TextbookFormDialog } from "@/modules/textbooks/components/textbook-form-dialog";
-import { getTextbooks } from "@/modules/textbooks/data-access";
+import { TextbookCard } from "@/modules/textbooks/components/textbook-card"
+import { TextbookFormDialog } from "@/modules/textbooks/components/textbook-form-dialog"
+import { getTextbooks } from "@/modules/textbooks/data-access"
 import { TextbookFilters } from "@/modules/textbooks/components/textbook-filters"
 import { EmptyState } from "@/shared/components/ui/empty-state"
+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
-}
-
-async function TextbooksResults({ searchParams }: { searchParams: Promise<SearchParams> }) {
+async function TextbooksResults({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   const params = await searchParams
 
   const q = getParam(params, "q") || undefined
@@ -47,8 +42,7 @@ async function TextbooksResults({ searchParams }: { searchParams: Promise<Search
   )
 }
 
-export default async function TextbooksPage({ searchParams }: { searchParams: Promise<SearchParams> }) {
-
+export default async function TextbooksPage({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   return (
     <div className="space-y-6 p-8">
       {/* Page Header */}
@@ -70,5 +64,5 @@ export default async function TextbooksPage({ searchParams }: { searchParams: Pr
         <TextbooksResults searchParams={searchParams} />
       </Suspense>
     </div>
-  );
+  )
 }