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)/admin/attendance/page.tsx

@@ -1,33 +1,43 @@
-import Link from "next/link"
+import Link from "next/link"
+import type { Metadata } from "next"
+import type { JSX } from "react"
 import { BarChart3, ClipboardList } from "lucide-react"
+
 import { Button } from "@/shared/components/ui/button"
 import { EmptyState } from "@/shared/components/ui/empty-state"
-import { getAuthContext } from "@/shared/lib/auth-guard"
+import { requirePermission, getAuthContext } from "@/shared/lib/auth-guard"
+import { Permissions } from "@/shared/types/permissions"
+import { getSearchParam, type SearchParams } from "@/shared/lib/utils"
 import { getAdminClasses } from "@/modules/classes/data-access"
 import { getAttendanceRecords } from "@/modules/attendance/data-access"
 import { AttendanceFilters } from "@/modules/attendance/components/attendance-filters"
 import { AttendanceRecordList } from "@/modules/attendance/components/attendance-record-list"
+import type { AttendanceStatus } from "@/modules/attendance/types"
+
+export const metadata: Metadata = {
+  title: "考勤总览 - Next_Edu",
+  description: "查看全校所有班级的考勤记录",
+}
 
 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
-}
+const isValidAttendanceStatus = (v?: string): v is AttendanceStatus =>
+  v === "present" || v === "absent" || v === "late" || v === "early_leave" || v === "excused"
 
 export default async function AdminAttendancePage({
   searchParams,
 }: {
   searchParams: Promise<SearchParams>
-}) {
+}): Promise<JSX.Element> {
+  await requirePermission(Permissions.ATTENDANCE_READ)
   const sp = await searchParams
   const ctx = await getAuthContext()
 
-  const classId = getParam(sp, "classId")
-  const status = getParam(sp, "status")
-  const date = getParam(sp, "date")
+  const classId = getSearchParam(sp, "classId")
+  const statusParam = getSearchParam(sp, "status")
+  const status =
+    statusParam && statusParam !== "all" && isValidAttendanceStatus(statusParam) ? statusParam : undefined
+  const date = getSearchParam(sp, "date")
 
   const classes = await getAdminClasses()
   const classOptions = classes.map((c) => ({ id: c.id, name: c.name }))
@@ -36,7 +46,7 @@ export default async function AdminAttendancePage({
     scope: ctx.dataScope,
     currentUserId: ctx.userId,
     classId: classId && classId !== "all" ? classId : undefined,
-    status: status && status !== "all" ? (status as "present" | "absent" | "late" | "early_leave" | "excused") : undefined,
+    status,
     date: date && date.length > 0 ? date : undefined,
   })
 
@@ -44,13 +54,13 @@ export default async function AdminAttendancePage({
     <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">Attendance Overview</h2>
-          <p className="text-muted-foreground">View all attendance records across the school.</p>
+          <h2 className="text-2xl font-bold tracking-tight">考勤总览</h2>
+          <p className="text-muted-foreground">查看全校所有班级的考勤记录。</p>
         </div>
         <Button asChild variant="outline">
           <Link href="/teacher/attendance/stats">
             <BarChart3 className="mr-2 h-4 w-4" />
-            Statistics
+            统计分析
           </Link>
         </Button>
       </div>
@@ -59,8 +69,8 @@ export default async function AdminAttendancePage({
 
       {result.items.length === 0 && !classId && !status && !date ? (
         <EmptyState
-          title="No attendance records"
-          description="There are no attendance records yet."
+          title="暂无考勤记录"
+          description="系统中尚未产生任何考勤记录。"
           icon={ClipboardList}
         />
       ) : (