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)/management/grade/insights/page.tsx

@@ -1,8 +1,10 @@
-import { requireAuth } from "@/shared/lib/auth-guard"
+import { requirePermission } from "@/shared/lib/auth-guard"
+import { Permissions } from "@/shared/types/permissions"
 import { getTeacherIdForMutations } from "@/modules/classes/data-access"
 import { getGradeHomeworkInsights } from "@/modules/classes/data-access"
 import { getGradesForStaff } from "@/modules/school/data-access"
 import { EmptyState } from "@/shared/components/ui/empty-state"
+import { StatCard } from "@/shared/components/ui/stat-card"
 import { Card, CardContent, CardHeader, CardTitle } from "@/shared/components/ui/card"
 import { Badge } from "@/shared/components/ui/badge"
 import { Button } from "@/shared/components/ui/button"
@@ -21,10 +23,10 @@ const getParam = (params: SearchParams, key: string) => {
   return undefined
 }
 
-const fmt = (v: number | null, digits = 1) => (typeof v === "number" && Number.isFinite(v) ? v.toFixed(digits) : "-")
+const formatScore = (v: number | null, digits = 1) => (typeof v === "number" && Number.isFinite(v) ? v.toFixed(digits) : "-")
 
 export default async function TeacherGradeInsightsPage({ searchParams }: { searchParams: Promise<SearchParams> }) {
-  await requireAuth()
+  await requirePermission(Permissions.GRADE_RECORD_READ)
   const params = await searchParams
   const gradeId = getParam(params, "gradeId")
 
@@ -68,8 +70,9 @@ export default async function TeacherGradeInsightsPage({ searchParams }: { searc
         </CardHeader>
         <CardContent>
           <form action="/management/grade/insights" method="get" className="flex flex-col gap-3 md:flex-row md:items-center">
-            <label className="text-sm font-medium">Grade</label>
+            <label htmlFor="gradeId" className="text-sm font-medium">Grade</label>
             <select
+              id="gradeId"
               name="gradeId"
               defaultValue={selected || "all"}
               className="h-10 w-full rounded-md border bg-background px-3 text-sm md:w-[360px]"
@@ -112,46 +115,30 @@ export default async function TeacherGradeInsightsPage({ searchParams }: { searc
       ) : (
         <div className="space-y-6">
           <div className="grid gap-4 md:grid-cols-4">
-            <Card>
-              <CardHeader className="pb-2">
-                <CardTitle className="text-sm font-medium">Classes</CardTitle>
-              </CardHeader>
-              <CardContent>
-                <div className="text-2xl font-bold tabular-nums">{insights.classCount}</div>
-                <div className="text-xs text-muted-foreground">
-                  {insights.grade.school.name} / {insights.grade.name}
-                </div>
-              </CardContent>
-            </Card>
-            <Card>
-              <CardHeader className="pb-2">
-                <CardTitle className="text-sm font-medium">Students</CardTitle>
-              </CardHeader>
-              <CardContent>
-                <div className="text-2xl font-bold tabular-nums">{insights.studentCounts.total}</div>
-                <div className="text-xs text-muted-foreground">
-                  Active {insights.studentCounts.active} • Inactive {insights.studentCounts.inactive}
-                </div>
-              </CardContent>
-            </Card>
-            <Card>
-              <CardHeader className="pb-2">
-                <CardTitle className="text-sm font-medium">Overall Avg</CardTitle>
-              </CardHeader>
-              <CardContent>
-                <div className="text-2xl font-bold tabular-nums">{fmt(insights.overallScores.avg)}</div>
-                <div className="text-xs text-muted-foreground">Across graded homework</div>
-              </CardContent>
-            </Card>
-            <Card>
-              <CardHeader className="pb-2">
-                <CardTitle className="text-sm font-medium">Latest Avg</CardTitle>
-              </CardHeader>
-              <CardContent>
-                <div className="text-2xl font-bold tabular-nums">{fmt(insights.latest?.scoreStats.avg ?? null)}</div>
-                <div className="text-xs text-muted-foreground">{insights.latest ? insights.latest.title : "-"}</div>
-              </CardContent>
-            </Card>
+            <StatCard
+              title="Classes"
+              value={insights.classCount}
+              description={`${insights.grade.school.name} / ${insights.grade.name}`}
+              valueClassName="tabular-nums"
+            />
+            <StatCard
+              title="Students"
+              value={insights.studentCounts.total}
+              description={`Active ${insights.studentCounts.active} • Inactive ${insights.studentCounts.inactive}`}
+              valueClassName="tabular-nums"
+            />
+            <StatCard
+              title="Overall Avg"
+              value={formatScore(insights.overallScores.avg)}
+              description="Across graded homework"
+              valueClassName="tabular-nums"
+            />
+            <StatCard
+              title="Latest Avg"
+              value={formatScore(insights.latest?.scoreStats.avg ?? null)}
+              description={insights.latest ? insights.latest.title : "-"}
+              valueClassName="tabular-nums"
+            />
           </div>
 
           <Card className="shadow-none">
@@ -189,8 +176,8 @@ export default async function TeacherGradeInsightsPage({ searchParams }: { searc
                         <TableCell className="text-right tabular-nums">{a.targetCount}</TableCell>
                         <TableCell className="text-right tabular-nums">{a.submittedCount}</TableCell>
                         <TableCell className="text-right tabular-nums">{a.gradedCount}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(a.scoreStats.avg)}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(a.scoreStats.median)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(a.scoreStats.avg)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(a.scoreStats.median)}</TableCell>
                       </TableRow>
                     ))}
                   </TableBody>
@@ -227,10 +214,10 @@ export default async function TeacherGradeInsightsPage({ searchParams }: { searc
                           {c.class.homeroom ? <span className="text-muted-foreground"> • {c.class.homeroom}</span> : null}
                         </TableCell>
                         <TableCell className="text-right tabular-nums">{c.studentCounts.total}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(c.latestAvg)}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(c.prevAvg)}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(c.deltaAvg)}</TableCell>
-                        <TableCell className="text-right tabular-nums">{fmt(c.overallScores.avg)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(c.latestAvg)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(c.prevAvg)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(c.deltaAvg)}</TableCell>
+                        <TableCell className="text-right tabular-nums">{formatScore(c.overallScores.avg)}</TableCell>
                       </TableRow>
                     ))}
                   </TableBody>