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/modules/parent/components/child-grade-summary.tsx

@@ -1,23 +1,15 @@
 "use client"
 
+import { useMemo } from "react"
 import Link from "next/link"
 import { BarChart3, Trophy } from "lucide-react"
-import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts"
 
+import { ChartCardShell } from "@/shared/components/charts/chart-card-shell"
+import { TrendLineChart } from "@/shared/components/charts/trend-line-chart"
 import { Badge } from "@/shared/components/ui/badge"
-import { Card, CardContent, CardHeader, CardTitle } from "@/shared/components/ui/card"
-import { EmptyState } from "@/shared/components/ui/empty-state"
-import { ChartContainer, ChartTooltip, ChartTooltipContent } from "@/shared/components/ui/chart"
 import { formatDate } from "@/shared/lib/utils"
 import type { StudentDashboardGradeProps } from "@/modules/homework/types"
 
-const chartConfig = {
-  score: {
-    label: "Score (%)",
-    color: "hsl(var(--primary))",
-  },
-}
-
 export function ChildGradeSummary({
   grades,
   childId,
@@ -31,133 +23,100 @@ export function ChildGradeSummary({
   const ranking = grades.ranking
   const latestGrade = grades.trend[grades.trend.length - 1]
 
-  const chartData = grades.trend.map((item) => ({
-    title: item.assignmentTitle,
-    score: Math.round(item.percentage),
-    fullTitle: item.assignmentTitle,
-    submittedAt: formatDate(item.submittedAt),
-    rawScore: item.score,
-    maxScore: item.maxScore,
-  }))
+  const chartData = useMemo(
+    () =>
+      grades.trend.map((item) => ({
+        title: item.assignmentTitle,
+        score: Math.round(item.percentage),
+        fullTitle: item.assignmentTitle,
+        date: formatDate(item.submittedAt),
+        rawScore: item.score,
+        maxScore: item.maxScore,
+      })),
+    [grades.trend],
+  )
 
   return (
-    <Card>
-      <CardHeader>
-        <CardTitle className="flex items-center gap-2 text-base">
-          <BarChart3 className="h-4 w-4 text-muted-foreground" />
-          {childName}&apos;s Grades
-        </CardTitle>
-      </CardHeader>
-      <CardContent>
-        {!hasGradeTrend ? (
-          <EmptyState
-            icon={BarChart3}
-            title="No graded work yet"
-            description="Finish and submit assignments to see score trend."
-            className="border-none h-60"
-          />
-        ) : (
-          <div className="space-y-4">
-            <div className="grid grid-cols-2 gap-3">
-              <div className="rounded-md border bg-card p-3">
-                <div className="text-xs text-muted-foreground flex items-center gap-1">
-                  <BarChart3 className="h-3 w-3" />
-                  Latest Score
-                </div>
-                <div className="text-xl font-semibold tabular-nums">
-                  {latestGrade ? `${Math.round(latestGrade.percentage)}%` : "-"}
-                </div>
-                {latestGrade ? (
-                  <div className="text-xs text-muted-foreground tabular-nums">
-                    {latestGrade.score}/{latestGrade.maxScore}
-                  </div>
-                ) : null}
-              </div>
-              <div className="rounded-md border bg-card p-3">
-                <div className="text-xs text-muted-foreground flex items-center gap-1">
-                  <Trophy className="h-3 w-3" />
-                  Class Rank
-                </div>
-                <div className="text-xl font-semibold tabular-nums">
-                  {ranking ? `${ranking.rank}/${ranking.classSize}` : "-"}
-                </div>
-                {ranking ? (
-                  <div className="text-xs text-muted-foreground">Current position</div>
-                ) : null}
-              </div>
+    <ChartCardShell
+      title={`${childName}'s Grades`}
+      icon={BarChart3}
+      iconClassName="text-muted-foreground"
+      titleClassName="text-base"
+      isEmpty={!hasGradeTrend}
+      emptyTitle="No graded work yet"
+      emptyDescription="Finish and submit assignments to see score trend."
+      emptyClassName="h-48"
+    >
+      <div className="space-y-4">
+        <div className="grid grid-cols-2 gap-3">
+          <div className="rounded-md bg-muted/50 p-3">
+            <div className="text-xs text-muted-foreground flex items-center gap-1">
+              <BarChart3 className="h-3 w-3" />
+              Latest Score
             </div>
-
-            <div className="rounded-md border bg-card p-3">
-              <ChartContainer config={chartConfig} className="h-[160px] w-full">
-                <LineChart data={chartData} margin={{ left: 8, right: 8, top: 8, bottom: 8 }}>
-                  <CartesianGrid vertical={false} strokeDasharray="4 4" strokeOpacity={0.4} />
-                  <XAxis
-                    dataKey="title"
-                    tickLine={false}
-                    axisLine={false}
-                    tickMargin={8}
-                    tickFormatter={(value) =>
-                      value.slice(0, 8) + (value.length > 8 ? "..." : "")
-                    }
-                  />
-                  <YAxis
-                    domain={[0, 100]}
-                    tickLine={false}
-                    axisLine={false}
-                    tickFormatter={(value) => `${value}%`}
-                    width={30}
-                  />
-                  <ChartTooltip
-                    cursor={{
-                      stroke: "hsl(var(--muted-foreground))",
-                      strokeWidth: 1,
-                      strokeDasharray: "4 4",
-                    }}
-                    content={
-                      <ChartTooltipContent
-                        indicator="line"
-                        labelKey="fullTitle"
-                        className="w-[200px]"
-                      />
-                    }
-                  />
-                  <Line
-                    dataKey="score"
-                    type="monotone"
-                    stroke="var(--color-score)"
-                    strokeWidth={2}
-                    dot={{ fill: "var(--color-score)", r: 3, strokeWidth: 2 }}
-                    activeDot={{ r: 5, strokeWidth: 0 }}
-                  />
-                </LineChart>
-              </ChartContainer>
+            <div className="text-xl font-semibold tabular-nums">
+              {latestGrade ? `${Math.round(latestGrade.percentage)}%` : "-"}
             </div>
-
-            {grades.recent.length > 0 ? (
-              <div className="space-y-2">
-                <div className="text-xs font-medium uppercase text-muted-foreground">
-                  Recent Grades
-                </div>
-                {grades.recent.slice(0, 3).map((r) => (
-                  <Link
-                    key={r.assignmentId}
-                    href={`/parent/children/${childId}`}
-                    className="flex items-center justify-between rounded-md border bg-card p-2 hover:bg-muted/50 transition-colors"
-                  >
-                    <div className="min-w-0 flex-1">
-                      <div className="font-medium text-sm truncate">{r.assignmentTitle}</div>
-                      <div className="text-xs text-muted-foreground">{formatDate(r.submittedAt)}</div>
-                    </div>
-                    <Badge variant="secondary" className="tabular-nums shrink-0 ml-2">
-                      {r.score}/{r.maxScore}
-                    </Badge>
-                  </Link>
-                ))}
+            {latestGrade ? (
+              <div className="text-xs text-muted-foreground tabular-nums">
+                {latestGrade.score}/{latestGrade.maxScore}
               </div>
             ) : null}
           </div>
-        )}
-      </CardContent>
-    </Card>
+          <div className="rounded-md bg-muted/50 p-3">
+            <div className="text-xs text-muted-foreground flex items-center gap-1">
+              <Trophy className="h-3 w-3" />
+              Class Rank
+            </div>
+            <div className="text-xl font-semibold tabular-nums">
+              {ranking ? `${ranking.rank}/${ranking.classSize}` : "-"}
+            </div>
+            {ranking ? <div className="text-xs text-muted-foreground">Current position</div> : null}
+          </div>
+        </div>
+
+        <div className="rounded-md bg-muted/50 p-3">
+          <TrendLineChart
+            data={chartData}
+            series={[
+              {
+                dataKey: "score",
+                name: "Score (%)",
+                color: "hsl(var(--primary))",
+                dotRadius: 3,
+                activeDotRadius: 5,
+              },
+            ]}
+            xKey="date"
+            xTickFormatter={null}
+            heightClassName="h-[160px]"
+            margin={{ left: 8, right: 8, top: 8, bottom: 8 }}
+            yWidth={30}
+            tooltipClassName="w-[200px]"
+          />
+        </div>
+
+        {grades.recent.length > 0 ? (
+          <div className="space-y-2">
+            <div className="text-xs font-medium uppercase text-muted-foreground">Recent Grades</div>
+            {grades.recent.slice(0, 3).map((r) => (
+              <Link
+                key={r.assignmentId}
+                href={`/parent/children/${childId}?tab=grades`}
+                className="flex items-center justify-between rounded-md border bg-card p-2 hover:bg-muted/50 transition-colors"
+              >
+                <div className="min-w-0 flex-1">
+                  <div className="font-medium text-sm truncate">{r.assignmentTitle}</div>
+                  <div className="text-xs text-muted-foreground">{formatDate(r.submittedAt)}</div>
+                </div>
+                <Badge variant="secondary" className="tabular-nums shrink-0 ml-2">
+                  {r.score}/{r.maxScore}
+                </Badge>
+              </Link>
+            ))}
+          </div>
+        ) : null}
+      </div>
+    </ChartCardShell>
   )
 }