feat(portal-shell): error-book + diagnostic + analytics 模块 5 页迁移（教师域 §9.1 B2）

§9.1 line 637-639 教师域：
- /shell/teacher/error-book (列表，1 页)
- /shell/teacher/diagnostic (列表) + /class/[classId] (详情) — 2 页
- /shell/teacher/analytics (概览) + /[studentId] (详情) — 2 页
契约：
- error-book ✅ 真实 errorBookItems/errorBookStats
- diagnostic ✅ 真实 diagnosticReports 列表 + 详情 ❌ MSW
- analytics 🟡 真实 learningTrend/studentWeakness + 概览 ❌ MSW

新增文件（24 个）：
- src/lib/api/{error-book,diagnostic,analytics}.ts (hooks)
- src/lib/api/operations/{error-book,diagnostic,analytics}.graphql.ts (documents)
- src/features/teacher/{error-book,diagnostic,analytics}/ (clients + transformations + tests)
- src/app/shell/teacher/{error-book,diagnostic,analytics}/ (5 page.tsx + 3 loading + 3 error)

修改文件（7 个）：
- src/mocks/graphql-data.ts (7 handler cases)
- src/messages/{zh-CN,en}.json (errorBook/diagnostic/analytics i18n)
- src/lib/api/{index,operations/index}.ts (导出)
- src/shared/lib/route-permissions.ts (3 EXACT + 3 PREFIX 路由权限)
- scripts/check-page-count.ts (baseline 53 → 58)

DoD 验收（§11.3 11 项）：
- typecheck 0 errors
- lint 0 errors
- vitest 734 tests passed
- lint:tokens 0 errors
- check:pages 58 PASS
- route-permissions 已声明
- 三态齐备
- @contract-pending + MSW 兜底（仅对 schema 不存在的字段）
- i18n zh-CN + en 同步

设计决策：
- 类型命名冲突解决：ErrorBookItem → ErrorBookEntry；ErrorBookStats → TeacherErrorBookStats；
  KnowledgePointErrorStats → ErrorBookKpStats；useErrorBookStats → useTeacherErrorBookStats
  （避免与 dashboard.ts/student.ts 同名类型冲突）
- analytics TrendPoint/WeakPoint 形状相同，从 dashboard.ts import 复用
- error-book/analytics 复用 CLASS_READ/CLASS_MANAGE（无专用教师权限点）；
  diagnostic 复用 DIAGNOSTIC_READ/DIAGNOSTIC_MANAGE

关联：ARCHITECTURE.md §5.3 / §5.4 / §5.5 / §9.1 / §10 P2 / §11.3 / §11.4
契约工单：docs/architecture/issues/contracts/core-edu_contract.md

apps/portal-shell/src/app/shell/teacher/analytics/[studentId]/page.tsx

@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { StudentAnalyticsClient } from "@/features/teacher/analytics/student-analytics-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 单生学情分析详情页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ *
+ * 数据契约：单查 studentAnalytics(studentId) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/data-ana_contract.md#student-analytics
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function StudentAnalyticsPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <StudentAnalyticsClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/analytics/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 { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function AnalyticsError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("analytics");
+
+  useEffect(() => {
+    console.error("[portal-shell] analytics 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/analytics/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/analytics 总览期间显示。
+ */
+export default function AnalyticsLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

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

@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { AnalyticsOverviewClient } from "@/features/teacher/analytics/analytics-overview-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学情分析总览页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ *
+ * 数据契约：analyticsOverview ❌ schema 无此聚合根字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/data-ana_contract.md#analytics-overview
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function AnalyticsOverviewPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<ListPageSkeleton rows={5} />}>
+      <AnalyticsOverviewClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/diagnostic/class/[classId]/page.tsx

@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { DiagnosticClassDetailClient } from "@/features/teacher/diagnostic/diagnostic-class-detail-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 班级诊断报告详情页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ *
+ * 数据契约：单查 diagnosticReport(classId) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/data-ana_contract.md#diagnostic-class-detail
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function DiagnosticClassDetailPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <DiagnosticClassDetailClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/diagnostic/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 { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function DiagnosticError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("diagnostic");
+
+  useEffect(() => {
+    console.error("[portal-shell] diagnostic 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/diagnostic/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/diagnostic 列表期间显示。
+ */
+export default function DiagnosticLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

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

@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { DiagnosticListClient } from "@/features/teacher/diagnostic/diagnostic-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 诊断报告列表页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 DiagnosticListClient（client component）中。
+ *
+ * 数据契约：diagnosticReports ✅ 真实 schema 字段
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.5 / §7.3 / §9.1 / §10 P2 / §11.3
+ */
+export default function DiagnosticListPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<ListPageSkeleton rows={5} />}>
+      <DiagnosticListClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/error-book/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 { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function ErrorBookError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("errorBook");
+
+  useEffect(() => {
+    console.error("[portal-shell] error-book 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/error-book/loading.tsx

@@ -0,0 +1,9 @@
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 错题本路由段加载骨架（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment loading.tsx，自动包裹页面渲染期间。
+ */
+export default function ErrorBookLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

apps/portal-shell/src/app/shell/teacher/error-book/page.tsx

@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { ErrorBookListClient } from "@/features/teacher/error-book/error-book-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 错题本列表页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 ErrorBookListClient（client component）中。
+ *
+ * 数据契约：errorBookItems / errorBookStats ✅ 真实 schema 字段
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.5 / §7.3 / §9.1 / §10 P2 / §11.3
+ */
+export default function ErrorBookListPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<ListPageSkeleton rows={5} />}>
+      <ErrorBookListClient />
+    </Suspense>
+  );
+}