feat(portal-shell): grades 模块 5 页迁移（教师域 §9.1 B2）

§9.1 B2 grades 行：/grades、/entry、/analytics、/stats、/report-card
契约：grade(id) ✅ 真实查询；列表/分析/统计/成绩单 → MSW 兜底

新增文件：
- src/lib/api/grades.ts (6 hooks)
- src/lib/api/operations/grades.graphql.ts (6 documents)
- src/features/teacher/grades/ (7 files: transformations + tests + 5 clients)
- src/app/shell/teacher/grades/ (5 page.tsx + loading.tsx + error.tsx)

修改文件：
- src/mocks/graphql-data.ts (5 mock 常量 + 6 handler cases)
- src/messages/{zh-CN,en}.json (grades i18n)
- src/lib/api/{index,operations/index}.ts (导出 grades)
- scripts/check-page-count.ts (baseline 26 → 31)

DoD 验收（§11.3 11 项）：
- typecheck 0 errors
- lint 0 errors
- vitest 357 tests passed
- lint:tokens 0 errors
- check:pages 31 PASS

关联：ARCHITECTURE.md §5.3 / §5.4 / §9.1 / §10 P2 / §11.3 / §11.4

apps/portal-shell/src/app/shell/teacher/grades/analytics/page.tsx

@@ -0,0 +1,24 @@
+import { Suspense } from "react";
+
+import { GradeAnalyticsClient } from "@/features/teacher/grades/grade-analytics-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 成绩分析页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 GradeAnalyticsClient（client component）中。
+ *
+ * 数据契约：混合契约
+ * - 基础统计 ✅ assignmentAnalysis（data-ana 子图，schema 已就绪）
+ * - 扩展字段（排名/分布）❌ → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §5.5 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function GradeAnalyticsPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <GradeAnalyticsClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/grades/entry/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { GradeEntryClient } from "@/features/teacher/grades/grade-entry-client";
+import { FormPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 成绩录入表单页（ARCHITECTURE.md §7.3 表单页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 GradeEntryClient（client component）中。
+ *
+ * 数据契约：mutation createGrade(input) ❌ schema 无 Mutation → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#create-grade-mutation
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function GradeEntryPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<FormPageSkeleton />}>
+      <GradeEntryClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/grades/error.tsx

@@ -0,0 +1,38 @@
+"use client";
+
+/**
+ * 成绩路由错误边界（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment error.tsx，捕获子树未处理异常。
+ */
+import { useEffect } from "react";
+import { useTranslations } from "next-intl";
+
+import { Button } from "@/shared/components/ui/button";
+
+export default function GradesError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("grades");
+
+  useEffect(() => {
+    console.error("[portal-shell] grades route error:", error);
+  }, [error]);
+
+  return (
+    <div className="flex flex-col items-center justify-center gap-4 rounded-xl border border-destructive/30 bg-destructive/5 p-10">
+      <h2 className="text-lg font-semibold text-destructive">
+        {t("error.title")}
+      </h2>
+      <p className="text-sm text-muted-foreground">
+        {error.message || t("error.unknown")}
+      </p>
+      <Button onClick={reset} variant="outline">
+        {t("error.retry")}
+      </Button>
+    </div>
+  );
+}

apps/portal-shell/src/app/shell/teacher/grades/loading.tsx

@@ -0,0 +1,12 @@
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 成绩路由段加载骨架（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment loading.tsx，自动包裹页面渲染期间。
+ *
+ * 子页面（录入/分析/统计/成绩单）的 Skeleton 由各自 server page 的 <Suspense> 兜底，
+ * 本文件仅在 /shell/teacher/grades 列表/重定向期间显示。
+ */
+export default function GradesLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

apps/portal-shell/src/app/shell/teacher/grades/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { GradesListClient } from "@/features/teacher/grades/grades-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 成绩管理列表页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 GradesListClient（client component）中。
+ *
+ * 数据契约：列表查询 grades(classId) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#grades-list
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function GradesListPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<ListPageSkeleton rows={5} />}>
+      <GradesListClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/grades/report-card/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { ReportCardClient } from "@/features/teacher/grades/report-card-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生成绩单页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 ReportCardClient（client component）中。
+ *
+ * 数据契约：reportCard(studentId, period) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#report-card
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §5.5 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function ReportCardPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <ReportCardClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/grades/stats/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { GradeStatsClient } from "@/features/teacher/grades/grade-stats-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 成绩统计页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 GradeStatsClient（client component）中。
+ *
+ * 数据契约：gradeStats(classId, period) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#grade-stats
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §5.5 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function GradeStatsPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <GradeStatsClient />
+    </Suspense>
+  );
+}