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/exams/[id]/build/page.tsx

@@ -1,36 +1,45 @@
+import type { JSX } from "react"
 import { notFound } from "next/navigation"
 import { ExamAssembly } from "@/modules/exams/components/exam-assembly"
 import { getExamById } from "@/modules/exams/data-access"
 import { getQuestions } from "@/modules/questions/data-access"
+import { normalizeStructure } from "@/modules/exams/utils/normalize-structure"
 import type { Question } from "@/modules/questions/types"
 import type { ExamNode } from "@/modules/exams/components/assembly/selected-question-list"
 import { createId } from "@paralleldrive/cuid2"
 
-export default async function BuildExamPage({ params }: { params: Promise<{ id: string }> }) {
+export const dynamic = "force-dynamic"
+
+export default async function BuildExamPage({ params }: { params: Promise<{ id: string }> }): Promise<JSX.Element> {
   const { id } = await params
-  
+
   const exam = await getExamById(id)
   if (!exam) return notFound()
 
   // Fetch initial questions for the bank (pagination handled by client)
-  const { data: questionsData } = await getQuestions({ pageSize: 20 })
-  
+  // Run both queries in parallel since the second depends on exam.questions IDs
   const initialSelected = (exam.questions || []).map(q => ({
     id: q.id,
     score: q.score || 0
   }))
 
   const selectedQuestionIds = initialSelected.map((s) => s.id)
-  const { data: selectedQuestionsData } = selectedQuestionIds.length
-    ? await getQuestions({ ids: selectedQuestionIds, pageSize: Math.max(10, selectedQuestionIds.length) })
-    : { data: [] as typeof questionsData }
+  const [bankResult, selectedResult] = await Promise.all([
+    getQuestions({ pageSize: 20 }),
+    selectedQuestionIds.length
+      ? getQuestions({ ids: selectedQuestionIds, pageSize: Math.max(10, selectedQuestionIds.length) })
+      : Promise.resolve({ data: [] as Awaited<ReturnType<typeof getQuestions>>["data"] }),
+  ])
+
+  const questionsData = bankResult.data
+  const selectedQuestionsData = selectedResult.data
 
   type RawQuestion = (typeof questionsData)[number]
 
   const toQuestionOption = (q: RawQuestion): Question => ({
     id: q.id,
-    content: q.content as Question["content"],
-    type: q.type as Question["type"],
+    content: q.content,
+    type: q.type,
     difficulty: q.difficulty ?? 1,
     createdAt: new Date(q.createdAt),
     updatedAt: new Date(q.updatedAt),
@@ -49,49 +58,8 @@ export default async function BuildExamPage({ params }: { params: Promise<{ id:
   for (const q of selectedQuestionsData) questionOptionsById.set(q.id, toQuestionOption(q))
   const questionOptions = Array.from(questionOptionsById.values())
 
-  const normalizeStructure = (nodes: unknown): ExamNode[] => {
-    const seen = new Set<string>()
-    const isRecord = (v: unknown): v is Record<string, unknown> =>
-      typeof v === "object" && v !== null
-
-    const normalize = (raw: unknown[]): ExamNode[] => {
-      return raw
-        .map((n) => {
-          if (!isRecord(n)) return null
-          const type = n.type
-          if (type !== "group" && type !== "question") return null
-
-          let id = typeof n.id === "string" && n.id.length > 0 ? n.id : createId()
-          while (seen.has(id)) id = createId()
-          seen.add(id)
-
-          if (type === "group") {
-            return {
-              id,
-              type: "group",
-              title: typeof n.title === "string" ? n.title : undefined,
-              children: normalize(Array.isArray(n.children) ? n.children : []),
-            } satisfies ExamNode
-          }
-
-          if (typeof n.questionId !== "string" || n.questionId.length === 0) return null
-
-          return {
-            id,
-            type: "question",
-            questionId: n.questionId,
-            score: typeof n.score === "number" ? n.score : undefined,
-          } satisfies ExamNode
-        })
-        .filter(Boolean) as ExamNode[]
-    }
-
-    if (!Array.isArray(nodes)) return []
-    return normalize(nodes)
-  }
-
   let initialStructure: ExamNode[] = normalizeStructure(exam.structure)
-  
+
   if (initialStructure.length === 0 && initialSelected.length > 0) {
     initialStructure = initialSelected.map((s) => ({
       id: createId(),
@@ -103,6 +71,10 @@ export default async function BuildExamPage({ params }: { params: Promise<{ id:
 
   return (
     <div className="flex h-full flex-col space-y-4 p-4">
+      <div>
+        <h1 className="text-2xl font-bold tracking-tight">Build Exam</h1>
+        <p className="text-muted-foreground">Assemble questions for your exam.</p>
+      </div>
       <ExamAssembly
         examId={exam.id}
         title={exam.title}

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

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { notFound } from "next/navigation"
 import { requirePermission, PermissionDeniedError } from "@/shared/lib/auth-guard"
 import { Permissions } from "@/shared/types/permissions"
@@ -16,7 +17,7 @@ export default async function ExamProctoringPage({
   params,
 }: {
   params: Promise<{ id: string }>
-}) {
+}): Promise<JSX.Element> {
   try {
     await requirePermission(Permissions.EXAM_PROCTOR)
   } catch (error) {
@@ -49,6 +50,10 @@ export default async function ExamProctoringPage({
 
   return (
     <div className="flex h-full flex-col space-y-4 p-4">
+      <div>
+        <h1 className="text-2xl font-bold tracking-tight">Exam Proctoring</h1>
+        <p className="text-muted-foreground">Monitor student activity during the exam.</p>
+      </div>
       <ProctoringDashboard examId={id} initialData={initialData} />
     </div>
   )