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/classes/my/[id]/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { notFound } from "next/navigation"
 
 import { getClassHomeworkInsights, getClassSchedule, getClassStudentSubjectScoresV2, getClassStudents } from "@/modules/classes/data-access"
@@ -14,21 +15,19 @@ export default async function ClassDetailPage({
   params,
 }: {
   params: Promise<{ id: string }>
-}) {
+}): Promise<JSX.Element> {
   const { id } = await params
 
   // Parallel data fetching
-  const [insights, students, schedule] = await Promise.all([
+  const [insights, students, schedule, studentScores] = await Promise.all([
     getClassHomeworkInsights({ classId: id, limit: 20 }),
     getClassStudents({ classId: id }),
     getClassSchedule({ classId: id }),
+    getClassStudentSubjectScoresV2({ classId: id }),
   ])
 
   if (!insights) return notFound()
 
-  // Fetch subject scores
-  const studentScores = await getClassStudentSubjectScoresV2({ classId: id })
-
   // Data mapping for widgets
   const assignmentSummaries = insights.assignments.map(a => ({
     id: a.assignmentId,
@@ -85,17 +84,16 @@ export default async function ClassDetailPage({
 
         <div className="grid grid-cols-1 gap-6 lg:grid-cols-3">
           {/* Main Content Area (Left 2/3) */}
-          <div className="space-y-6 lg:col-span-2">
-             <ClassTrendsWidget assignments={assignmentSummaries} />
-             <ClassStudentsWidget 
-                classId={insights.class.id} 
-                students={studentSummaries} 
-             />
+          <div className="min-w-0 space-y-6 lg:col-span-2">
+            <ClassTrendsWidget assignments={assignmentSummaries} />
+            <ClassStudentsWidget
+              classId={insights.class.id}
+              students={studentSummaries}
+            />
           </div>
 
           {/* Sidebar Area (Right 1/3) */}
-          <div className="space-y-6">
-            {/* <ClassQuickActions classId={insights.class.id} /> */}
+          <div className="min-w-0 space-y-6">
             <ClassScheduleWidget classId={insights.class.id} schedule={schedule} />
             <ClassAssignmentsWidget
               classId={insights.class.id}

src/app/(dashboard)/teacher/classes/my/page.tsx

@@ -1,13 +1,10 @@
+import type { JSX } from "react"
 import { getClassSubjects, getTeacherClasses } from "@/modules/classes/data-access"
 import { MyClassesGrid } from "@/modules/classes/components/my-classes-grid"
 
 export const dynamic = "force-dynamic"
 
-export default function MyClassesPage() {
-  return <MyClassesPageImpl />
-}
-
-async function MyClassesPageImpl() {
+export default async function MyClassesPage(): Promise<JSX.Element> {
   const [classes, subjectOptions] = await Promise.all([getTeacherClasses(), getClassSubjects()])
 
   return (

src/app/(dashboard)/teacher/classes/schedule/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { Suspense } from "react"
 import { Calendar } from "lucide-react"
 
@@ -6,17 +7,11 @@ import { ScheduleFilters } from "@/modules/classes/components/schedule-filters"
 import { ScheduleView } from "@/modules/classes/components/schedule-view"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { Skeleton } from "@/shared/components/ui/skeleton"
+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 ScheduleResults({ searchParams }: { searchParams: Promise<SearchParams> }) {
+async function ScheduleResults({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   const params = await searchParams
   const classId = getParam(params, "classId")
 
@@ -62,7 +57,7 @@ function ScheduleResultsFallback() {
   )
 }
 
-export default async function SchedulePage({ searchParams }: { searchParams: Promise<SearchParams> }) {
+export default async function SchedulePage({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   const classes = await getTeacherClasses()
 
   return (

src/app/(dashboard)/teacher/classes/students/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { Suspense } from "react"
 import { User } from "lucide-react"
 
@@ -6,17 +7,11 @@ import { StudentsFilters } from "@/modules/classes/components/students-filters"
 import { StudentsTable } from "@/modules/classes/components/students-table"
 import { EmptyState } from "@/shared/components/ui/empty-state"
 import { Skeleton } from "@/shared/components/ui/skeleton"
+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 StudentsResults({ searchParams, defaultClassId }: { searchParams: Promise<SearchParams>, defaultClassId?: string }) {
+async function StudentsResults({ searchParams, defaultClassId }: { searchParams: Promise<SearchParams>, defaultClassId?: string }): Promise<JSX.Element> {
   const params = await searchParams
 
   const q = getParam(params, "q") || undefined
@@ -80,7 +75,7 @@ function StudentsResultsFallback() {
   )
 }
 
-export default async function StudentsPage({ searchParams }: { searchParams: Promise<SearchParams> }) {
+export default async function StudentsPage({ searchParams }: { searchParams: Promise<SearchParams> }): Promise<JSX.Element> {
   const classes = await getTeacherClasses()
   
   // Logic to determine default class (first one available)