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/course-plans/[id]/page.tsx

@@ -1,3 +1,4 @@
+import type { JSX } from "react"
 import { notFound } from "next/navigation"
 
 import { getCoursePlanById } from "@/modules/course-plans/data-access"
@@ -9,7 +10,7 @@ export default async function TeacherCoursePlanDetailPage({
   params,
 }: {
   params: Promise<{ id: string }>
-}) {
+}): Promise<JSX.Element> {
   const { id } = await params
   const plan = await getCoursePlanById(id)
 

src/app/(dashboard)/teacher/course-plans/page.tsx

@@ -1,31 +1,34 @@
-import { auth } from "@/auth"
+import type { JSX } from "react"
+import { getAuthContext } from "@/shared/lib/auth-guard"
+import { getParam, type SearchParams } from "@/shared/lib/search-params"
 import { getCoursePlans } from "@/modules/course-plans/data-access"
 import { CoursePlanList } from "@/modules/course-plans/components/course-plan-list"
 import type { CoursePlanStatus } from "@/modules/course-plans/types"
 
 export const dynamic = "force-dynamic"
 
-type SearchParams = { [key: string]: string | string[] | undefined }
+const VALID_STATUSES: ReadonlySet<string> = new Set([
+  "planning",
+  "active",
+  "completed",
+  "paused",
+])
 
-const getParam = (params: SearchParams, key: string) => {
-  const v = params[key]
-  return Array.isArray(v) ? v[0] : v
+function parseStatus(v?: string): CoursePlanStatus | undefined {
+  return v && VALID_STATUSES.has(v) ? (v as CoursePlanStatus) : undefined
 }
 
-const isValidStatus = (v?: string): v is CoursePlanStatus =>
-  v === "planning" || v === "active" || v === "completed" || v === "paused"
-
 export default async function TeacherCoursePlansPage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
-  const session = await auth()
-  const teacherId = String(session?.user?.id ?? "")
+}): Promise<JSX.Element> {
+  const ctx = await getAuthContext()
+  const teacherId = ctx.userId
 
   const sp = await searchParams
   const statusParam = getParam(sp, "status")
-  const status = isValidStatus(statusParam) ? statusParam : undefined
+  const status = parseStatus(statusParam)
 
   const plans = teacherId
     ? await getCoursePlans({ teacherId, status })
@@ -34,14 +37,14 @@ export default async function TeacherCoursePlansPage({
   return (
     <div className="flex h-full flex-col space-y-8 p-8">
       <div className="space-y-1">
-        <h2 className="text-2xl font-bold tracking-tight">My Course Plans</h2>
+        <h1 className="text-2xl font-bold tracking-tight">My Course Plans</h1>
         <p className="text-muted-foreground">
           View your course teaching plans and weekly schedules.
         </p>
       </div>
       <CoursePlanList
         plans={plans}
-        detailHrefBuilder={(id) => `/teacher/course-plans/${id}`}
+        detailBaseHref="/teacher/course-plans"
         initialStatus={status}
       />
     </div>