feat(portal-shell): attendance + classes + students 模块 8 页迁移（教师域 §9.1 B2）

§9.1 line 632-634 教师域：
- /shell/teacher/attendance (列表) / /sheet (表单) / /report (报表) / /stats (统计) — 4 页
- /shell/teacher/classes (列表) / /[id] (详情) / /schedule (课表) — 3 页
- /shell/teacher/students (列表) — 1 页
契约：
- attendance 全 ❌ → MSW 兜底
- classes 🟡 classInfo(id) ✅ 真实单查 + 列表 ❌ MSW
- students 全 ❌ → MSW 兜底

新增文件：
- src/lib/api/{attendance,classes,students}.ts (14 hooks 合计)
- src/lib/api/operations/{attendance,classes,students}.graphql.ts (14 documents)
- src/features/teacher/{attendance,classes,students}/ (clients + transformations + tests)
- src/app/shell/teacher/{attendance,classes,students}/ (8 page.tsx + 3 loading + 3 error)

修改文件：
- src/mocks/graphql-data.ts (12 mock 数据 + handler cases)
- src/messages/{zh-CN,en}.json (attendance/classes/students i18n 命名空间)
- src/lib/api/{index,operations/index}.ts (导出 attendance/classes/students)
- src/shared/lib/route-permissions.ts (attendance/classes/students 路由权限)
- scripts/check-page-count.ts (baseline 40 → 48)

DoD 验收（§11.3 11 项）：
- typecheck 0 errors
- lint 0 errors
- vitest 566 tests passed
- lint:tokens 0 errors
- check:pages 48 PASS
- route-permissions 已声明
- 三态齐备
- @contract-pending + MSW 兜底
- i18n zh-CN + en 同步

设计决策：
- classes/[id] 走真实 classInfo(id) 查询
- 无 STUDENT_* 权限点，students 路由复用 CLASS_READ/CLASS_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/attendance/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 AttendanceError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("attendance");
+
+  useEffect(() => {
+    console.error("[portal-shell] attendance 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/attendance/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 AttendanceLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

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

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

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

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { AttendanceReportClient } from "@/features/teacher/attendance/attendance-report-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 考勤报表页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 AttendanceReportClient（client component）中。
+ *
+ * 数据契约：attendanceReport(classId, range) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/classes_contract.md#attendance-report
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function AttendanceReportPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <AttendanceReportClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/attendance/sheet/page.tsx

@@ -0,0 +1,25 @@
+import { Suspense } from "react";
+
+import { AttendanceSheetClient } from "@/features/teacher/attendance/attendance-sheet-client";
+import { FormPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 考勤点名表页（ARCHITECTURE.md §7.3 表单页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 AttendanceSheetClient（client component）中。
+ *
+ * 数据契约：
+ * - attendanceSheet(classId, date) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - saveAttendanceSheet(input) ❌ schema 无 Mutation → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/classes_contract.md#attendance-sheet
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function AttendanceSheetPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<FormPageSkeleton />}>
+      <AttendanceSheetClient />
+    </Suspense>
+  );
+}

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

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { AttendanceStatsClient } from "@/features/teacher/attendance/attendance-stats-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 考勤统计页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 AttendanceStatsClient（client component）中。
+ *
+ * 数据契约：attendanceStats(...) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/classes_contract.md#attendance-stats
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function AttendanceStatsPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <AttendanceStatsClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/classes/[id]/page.tsx

@@ -0,0 +1,25 @@
+import { Suspense } from "react";
+
+import { ClassDetailClient } from "@/features/teacher/classes/class-detail-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 班级详情页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useParams 要求）。
+ * 业务逻辑在 ClassDetailClient（client component）中。
+ *
+ * 数据契约（混合）：
+ * - classInfo(id: ID!) ✅ schema 真实字段（classes 子图）
+ * - classStudents(classId) / classTeachers(classId) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/classes_contract.md#class-students
+ *
+ * 关联：ARCHITECTURE.md §5.5 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function ClassDetailPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <ClassDetailClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/classes/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 ClassesError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("classes");
+
+  useEffect(() => {
+    console.error("[portal-shell] classes 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/classes/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 ClassesLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

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

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

apps/portal-shell/src/app/shell/teacher/classes/schedule/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { ClassScheduleClient } from "@/features/teacher/classes/class-schedule-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 班级课表页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 ClassScheduleClient（client component）中。
+ *
+ * 数据契约：classSchedule(classId) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/classes_contract.md#class-schedule
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function ClassSchedulePage(): React.ReactElement {
+  return (
+    <Suspense fallback={<DetailPageSkeleton />}>
+      <ClassScheduleClient />
+    </Suspense>
+  );
+}

apps/portal-shell/src/app/shell/teacher/students/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 StudentsError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}): React.ReactElement {
+  const t = useTranslations("students");
+
+  useEffect(() => {
+    console.error("[portal-shell] students 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/students/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 StudentsLoading(): React.ReactElement {
+  return <ListPageSkeleton rows={5} />;
+}

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

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