From f991bf04467911d7232ed8f33ad4b3a185ae5534 Mon Sep 17 00:00:00 2001
From: SpecialX <47072643+wangxiner55@users.noreply.github.com>
Date: Thu, 30 Jul 2026 17:49:49 +0800
Subject: [PATCH] =?UTF-8?q?feat(portal-shell):=20=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E5=9F=9F=E5=85=A8=E6=A8=A1=E5=9D=97=E5=8A=9F=E8=83=BD=E8=A1=A5?=
 =?UTF-8?q?=E9=BD=90=E4=B8=8E=E5=B7=AE=E5=BC=82=E4=BF=AE=E5=A4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

按 ARCHITECTURE.md 与 admin-NeedTodo.md 要求补齐所有管理页面缺失功能：
- users/roles/permissions：权限矩阵搜索/折叠、zod 校验、value 字段
- audit-logs：行内详情对话框、分页页码、ChartCardShell
- school：CRUD 对话框、GradeOverviewCards、academic-year 侧栏
- announcements/invitation-codes/ai-settings：发布按钮、分页、zod 校验
- course-plans/elective：Select 导入、undefined 处理
- error-book/scheduling/questions/lesson-plans/attendance：统计卡片

验证：typecheck 0 错误、arch:scan 已更新
---
 .../src/app/shell/admin/ai-settings/page.tsx  |    7 +
 .../src/app/shell/admin/classes/page.tsx      |   13 +
 .../src/app/shell/admin/plugins/page.tsx      |    4 +-
 .../src/app/shell/admin/scheduling/page.tsx   |   12 +
 .../admin/school/grades/insights/page.tsx     |   25 +
 .../src/app/shell/admin/viewports/page.tsx    |    5 +
 .../__tests__/transformations.test.ts         |   27 +-
 .../ai-settings/ai-provider-delete-dialog.tsx |  123 +
 .../admin/ai-settings/ai-provider-form.tsx    |  401 ++
 .../admin/ai-settings/ai-settings-client.tsx  |  283 +-
 .../admin/ai-settings/transformations.ts      |   37 +-
 .../announcement-create-dialog.tsx            |  233 +
 .../announcement-detail-client.tsx            |   60 +-
 .../announcement-edit-client.tsx              |   64 +-
 .../announcements-list-client.tsx             |  190 +-
 .../announcements/grade-multi-select.tsx      |  182 +
 .../__tests__/transformations.test.ts         |    3 +
 .../attendance/_write-correlation-card.mjs    |    0
 .../attendance/admin-attendance-client.tsx    |  188 +-
 .../attendance-grade-correlation-card.tsx     |  466 ++
 .../attendance/attendance-records-list.tsx    |  293 ++
 .../attendance/class-comparison-card.tsx      |  264 ++
 .../audit-logs/audit-log-detail-dialog.tsx    |  177 +
 .../audit-logs/audit-log-export-button.tsx    |   72 +
 .../audit-logs/audit-logs-list-client.tsx     |  235 +-
 .../audit-logs/audit-logs-pagination.tsx      |  125 +
 .../audit-logs/audit-overview-client.tsx      |  231 +-
 .../audit-logs/audit-retention-settings.tsx   |  233 +
 .../admin/audit-logs/data-changes-client.tsx  |  285 +-
 .../admin/audit-logs/login-logs-client.tsx    |  127 +-
 .../course-plan-create-client.tsx             |  261 +-
 .../course-plan-detail-client.tsx             |  513 ++-
 .../course-plans/course-plan-edit-client.tsx  |  341 +-
 .../course-plans/course-plan-item-editor.tsx  |  286 ++
 .../course-plans/course-plans-list-client.tsx |  114 +-
 .../admin/course-plans/export-utils.ts        |  141 +
 .../admin/course-plans/sortable-week-row.tsx  |  116 +
 .../course-plans/template-picker-dialog.tsx   |  197 +
 .../__tests__/transformations.test.ts         |   84 +-
 .../curriculum-map/curriculum-map-client.tsx  |   55 +-
 .../admin/curriculum-map/transformations.ts   |   74 +-
 .../admin/elective/elective-create-client.tsx |  224 +-
 .../admin/elective/elective-detail-client.tsx |  189 +-
 .../admin/elective/elective-edit-client.tsx   |  253 +-
 .../admin/elective/elective-list-client.tsx   |  365 +-
 .../admin/elective/transformations.ts         |   28 +
 .../__tests__/transformations.test.ts         |   17 +
 .../admin/error-book/error-book-client.tsx    |  362 +-
 .../error-book/error-book-detail-dialog.tsx   |  267 ++
 .../admin/error-book/transformations.ts       |   54 +
 .../files/__tests__/transformations.test.ts   |   41 +
 .../admin/files/file-batch-operations.tsx     |  204 +
 .../admin/files/file-preview-dialog.tsx       |  515 +++
 .../admin/files/file-upload-button.tsx        |  187 +
 .../admin/files/files-list-client.tsx         |  514 ++-
 .../features/admin/files/transformations.ts   |   68 +
 .../generate-invitation-codes-dialog.tsx      |  367 ++
 .../invitation-codes-list-client.tsx          |  423 +-
 .../admin/invitation-codes/transformations.ts |   32 +-
 .../__tests__/transformations.test.ts         |  145 +-
 .../lesson-plans/delete-confirm-dialog.tsx    |  106 +
 .../lesson-plans/lesson-plan-view-client.tsx  |   90 +-
 .../lesson-plans/lesson-plans-list-client.tsx |  354 +-
 .../admin/lesson-plans/transformations.ts     |   10 +
 .../organization/organization-tree-client.tsx |   12 +-
 .../permissions/permissions-list-client.tsx   |    6 +
 .../admin/questions/batch-operations.tsx      |  168 +
 .../questions/create-question-dialog.tsx      |  266 ++
 .../admin/questions/import-export-buttons.tsx |  214 +
 .../questions/question-detail-dialog.tsx      |  307 ++
 .../admin/questions/questions-list-client.tsx |  463 +-
 .../admin/roles/_write-role-form-dialog.ps1   |    0
 .../admin/roles/role-detail-client.tsx        |   10 +
 .../features/admin/roles/role-form-dialog.tsx |  213 +
 .../admin/roles/role-permission-matrix.tsx    |  348 ++
 .../admin/roles/roles-list-client.tsx         |  284 +-
 .../features/admin/roles/transformations.ts   |   17 +
 .../admin/school/academic-year-client.tsx     |  339 +-
 .../admin/school/admin-classes-client.tsx     |  404 +-
 .../admin/school/class-invitation-manager.tsx |  408 ++
 .../admin/school/class-schedule-dialog.tsx    |  509 +++
 .../admin/school/departments-client.tsx       |   24 +-
 .../admin/school/grade-insights-client.tsx    |  495 ++
 .../features/admin/school/grades-client.tsx   |  244 +-
 .../features/admin/school/schools-client.tsx  |  226 +-
 .../admin/students/students-list-client.tsx   |   12 +-
 .../admin/teachers/teachers-list-client.tsx   |   12 +-
 .../admin/users/user-role-assign-dialog.tsx   |  227 +
 .../admin/users/users-import-client.tsx       |  140 +-
 .../admin/users/users-list-client.tsx         |  289 +-
 .../admin/viewports/viewports-client.tsx      |   14 +-
 apps/portal-shell/src/lib/api/admin-p5.ts     | 1500 ++++++-
 apps/portal-shell/src/lib/api/admin.ts        |    6 +
 .../src/lib/api/operations/admin.graphql.ts   |   15 +-
 apps/portal-shell/src/messages/en.json        | 3973 ++++++++++++++++-
 apps/portal-shell/src/messages/zh-CN.json     | 3832 +++++++++++++++-
 apps/portal-shell/src/mocks/graphql-data.ts   | 1748 +++++++-
 docs/troubleshooting/known-issues.md          |    9 +
 98 files changed, 25956 insertions(+), 2140 deletions(-)
 create mode 100644 apps/portal-shell/src/app/shell/admin/classes/page.tsx
 create mode 100644 apps/portal-shell/src/app/shell/admin/scheduling/page.tsx
 create mode 100644 apps/portal-shell/src/app/shell/admin/school/grades/insights/page.tsx
 create mode 100644 apps/portal-shell/src/features/admin/ai-settings/ai-provider-delete-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/ai-settings/ai-provider-form.tsx
 create mode 100644 apps/portal-shell/src/features/admin/announcements/announcement-create-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/announcements/grade-multi-select.tsx
 create mode 100644 apps/portal-shell/src/features/admin/attendance/_write-correlation-card.mjs
 create mode 100644 apps/portal-shell/src/features/admin/attendance/attendance-grade-correlation-card.tsx
 create mode 100644 apps/portal-shell/src/features/admin/attendance/attendance-records-list.tsx
 create mode 100644 apps/portal-shell/src/features/admin/attendance/class-comparison-card.tsx
 create mode 100644 apps/portal-shell/src/features/admin/audit-logs/audit-log-detail-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/audit-logs/audit-log-export-button.tsx
 create mode 100644 apps/portal-shell/src/features/admin/audit-logs/audit-logs-pagination.tsx
 create mode 100644 apps/portal-shell/src/features/admin/audit-logs/audit-retention-settings.tsx
 create mode 100644 apps/portal-shell/src/features/admin/course-plans/course-plan-item-editor.tsx
 create mode 100644 apps/portal-shell/src/features/admin/course-plans/export-utils.ts
 create mode 100644 apps/portal-shell/src/features/admin/course-plans/sortable-week-row.tsx
 create mode 100644 apps/portal-shell/src/features/admin/course-plans/template-picker-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/error-book/error-book-detail-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/files/file-batch-operations.tsx
 create mode 100644 apps/portal-shell/src/features/admin/files/file-preview-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/files/file-upload-button.tsx
 create mode 100644 apps/portal-shell/src/features/admin/invitation-codes/generate-invitation-codes-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/lesson-plans/delete-confirm-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/questions/batch-operations.tsx
 create mode 100644 apps/portal-shell/src/features/admin/questions/create-question-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/questions/import-export-buttons.tsx
 create mode 100644 apps/portal-shell/src/features/admin/questions/question-detail-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/roles/_write-role-form-dialog.ps1
 create mode 100644 apps/portal-shell/src/features/admin/roles/role-form-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/roles/role-permission-matrix.tsx
 create mode 100644 apps/portal-shell/src/features/admin/school/class-invitation-manager.tsx
 create mode 100644 apps/portal-shell/src/features/admin/school/class-schedule-dialog.tsx
 create mode 100644 apps/portal-shell/src/features/admin/school/grade-insights-client.tsx
 create mode 100644 apps/portal-shell/src/features/admin/users/user-role-assign-dialog.tsx

diff --git a/apps/portal-shell/src/app/shell/admin/ai-settings/page.tsx b/apps/portal-shell/src/app/shell/admin/ai-settings/page.tsx
index 4365134..2383a76 100644
--- a/apps/portal-shell/src/app/shell/admin/ai-settings/page.tsx
+++ b/apps/portal-shell/src/app/shell/admin/ai-settings/page.tsx
@@ -13,6 +13,13 @@ import { ListPageSkeleton } from "@/shared/components/page-templates";
  * - aiProviders(scope) ❌ schema 未就绪 → MSW 兜底（@contract-pending）
  * - aiUsageDashboard(range) ❌ schema 未就绪 → MSW 兜底（@contract-pending）
  *
+ * 权限模型（双权限，CICD admin/ai-settings 对齐）：
+ * - AI_CHAT（普通用户可访问自己的 private provider）
+ * - AI_CONFIGURE（管理员额外权限：管理 public provider 与他人 private provider）
+ * - 路由登记：route-permissions.ts EXACT `/shell/admin/ai-settings` → ["admin"]
+ *   （管理员隐含 AI_CONFIGURE；普通用户访问自己的 provider 走 /shell/ai-settings，
+ *    该路由不在 admin 域，故本页只面向管理员视角）
+ *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 export default function AiSettingsPage(): React.ReactElement {
diff --git a/apps/portal-shell/src/app/shell/admin/classes/page.tsx b/apps/portal-shell/src/app/shell/admin/classes/page.tsx
new file mode 100644
index 0000000..127aac1
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/admin/classes/page.tsx
@@ -0,0 +1,13 @@
+import { redirect } from "next/navigation";
+
+/**
+ * 班级管理入口重定向（ARCHITECTURE.md §9.4 / §10 P5）。
+ *
+ * /shell/admin/classes 默认跳转到学校管理下的班级列表页，避免空白入口
+ * （班级管理归属于 school 限界上下文）。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §9.4 / §10 P5
+ */
+export default function ClassesAdminIndexPage(): never {
+  redirect("/shell/admin/school/classes");
+}
diff --git a/apps/portal-shell/src/app/shell/admin/plugins/page.tsx b/apps/portal-shell/src/app/shell/admin/plugins/page.tsx
index 5f86ab2..57a302d 100644
--- a/apps/portal-shell/src/app/shell/admin/plugins/page.tsx
+++ b/apps/portal-shell/src/app/shell/admin/plugins/page.tsx
@@ -10,8 +10,8 @@ import { ListPageSkeleton } from "@/shared/components/page-templates";
  * 业务逻辑在 PluginsClient（client component）中。
  *
  * 数据契约：
- * - pluginRegistry ✅ schema 已就绪（config-service）
- * - updatePluginRegistry(pluginId, input) ✅ schema 已就绪
+ * - pluginRegistry ❌ schema 未就绪（config-service 实际暴露 plugins/layoutTemplates/userLayoutOverride/pluginConfig，无 pluginRegistry 字段；requiredRoles/defaultSlot/defaultSize/defaultProps/propsSchema 字段缺失）→ MSW 兜底（@contract-pending）
+ * - updatePluginRegistry(pluginId, input) ❌ schema 无 Mutation 类型 → MSW 兜底（@contract-pending）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
diff --git a/apps/portal-shell/src/app/shell/admin/scheduling/page.tsx b/apps/portal-shell/src/app/shell/admin/scheduling/page.tsx
new file mode 100644
index 0000000..1c19a36
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/admin/scheduling/page.tsx
@@ -0,0 +1,12 @@
+import { redirect } from "next/navigation";
+
+/**
+ * 排课管理入口重定向（ARCHITECTURE.md §9.4 / §10 P5）。
+ *
+ * /shell/admin/scheduling 默认跳转到排课变更审批子页，避免空白入口。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §9.4 / §10 P5
+ */
+export default function SchedulingAdminIndexPage(): never {
+  redirect("/shell/admin/scheduling/changes");
+}
diff --git a/apps/portal-shell/src/app/shell/admin/school/grades/insights/page.tsx b/apps/portal-shell/src/app/shell/admin/school/grades/insights/page.tsx
new file mode 100644
index 0000000..9221865
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/admin/school/grades/insights/page.tsx
@@ -0,0 +1,25 @@
+import { Suspense } from "react";
+
+import { GradeInsightsClient } from "@/features/admin/school/grade-insights-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 年级洞察页（ARCHITECTURE.md §9.4 管理域 / §10 P5）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 GradeInsightsClient（client component）中。
+ *
+ * 数据契约：schoolWideGradeSummary()（@contract-pending → MSW 兜底）
+ *  - overallStats：全校平均分 / 及格率 / 优秀率 / 参考人数
+ *  - grades[]：各年级统计 + 班级排名
+ *  - recentAssignments[]：最近作业列表
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+export default function GradeInsightsPage(): React.ReactElement {
+  return (
+    <Suspense fallback={<ListPageSkeleton rows={5} />}>
+      <GradeInsightsClient />
+    </Suspense>
+  );
+}
diff --git a/apps/portal-shell/src/app/shell/admin/viewports/page.tsx b/apps/portal-shell/src/app/shell/admin/viewports/page.tsx
index 1f46a64..e308afd 100644
--- a/apps/portal-shell/src/app/shell/admin/viewports/page.tsx
+++ b/apps/portal-shell/src/app/shell/admin/viewports/page.tsx
@@ -13,6 +13,11 @@ import { ListPageSkeleton } from "@/shared/components/page-templates";
  * - viewports ❌ schema 未就绪 → MSW 兜底（@contract-pending）
  * - updateViewport(id, input) ❌ schema 无 Mutation → MSW 兜底
  *
+ * DataScope 说明（CICD ctx.dataScope 对齐）：
+ * - 视口配置属管理员全局视角（DataScope = "all"），不随班级/年级范围收窄
+ * - 普通教师/学生/家长角色不访问本页（route-permissions.ts 仅放行 ["admin"]）
+ * - 与 CICD 中 admin/* 视图一致：管理员 = 全校 DataScope，无需 ctx.dataScope 上下文
+ *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 export default function ViewportsPage(): React.ReactElement {
diff --git a/apps/portal-shell/src/features/admin/ai-settings/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/ai-settings/__tests__/transformations.test.ts
index e3e4c48..811a7bb 100644
--- a/apps/portal-shell/src/features/admin/ai-settings/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/ai-settings/__tests__/transformations.test.ts
@@ -21,37 +21,40 @@ import {
 
 describe("formatProviderType", () => {
   it("maps known types to display labels", () => {
+    expect(formatProviderType("zhipu")).toBe("智谱 AI");
     expect(formatProviderType("openai")).toBe("OpenAI");
-    expect(formatProviderType("anthropic")).toBe("Anthropic");
-    expect(formatProviderType("azure")).toBe("Azure OpenAI");
-    expect(formatProviderType("local")).toBe("本地模型");
+    expect(formatProviderType("gemini")).toBe("Google Gemini");
+    expect(formatProviderType("ollama")).toBe("Ollama（本地）");
+    expect(formatProviderType("custom")).toBe("自定义");
   });
 
   it("returns original value for unknown type", () => {
-    expect(formatProviderType("custom")).toBe("custom");
+    expect(formatProviderType("unknown-vendor")).toBe("unknown-vendor");
     expect(formatProviderType("")).toBe("");
   });
 
-  it("PROVIDER_TYPE_LABEL covers 4 standard types", () => {
-    expect(Object.keys(PROVIDER_TYPE_LABEL)).toHaveLength(4);
+  it("PROVIDER_TYPE_LABEL covers 5 standard types", () => {
+    expect(Object.keys(PROVIDER_TYPE_LABEL)).toHaveLength(5);
   });
 });
 
 describe("isValidProviderType", () => {
   it("returns true for supported types", () => {
+    expect(isValidProviderType("zhipu")).toBe(true);
     expect(isValidProviderType("openai")).toBe(true);
-    expect(isValidProviderType("anthropic")).toBe(true);
-    expect(isValidProviderType("azure")).toBe(true);
-    expect(isValidProviderType("local")).toBe(true);
+    expect(isValidProviderType("gemini")).toBe(true);
+    expect(isValidProviderType("ollama")).toBe(true);
+    expect(isValidProviderType("custom")).toBe(true);
   });
 
   it("returns false for unsupported types", () => {
-    expect(isValidProviderType("custom")).toBe(false);
+    expect(isValidProviderType("anthropic")).toBe(false);
+    expect(isValidProviderType("azure")).toBe(false);
     expect(isValidProviderType("")).toBe(false);
   });
 
-  it("PROVIDER_TYPES has exactly 4 entries", () => {
-    expect(PROVIDER_TYPES).toHaveLength(4);
+  it("PROVIDER_TYPES has exactly 5 entries", () => {
+    expect(PROVIDER_TYPES).toHaveLength(5);
   });
 });
 
diff --git a/apps/portal-shell/src/features/admin/ai-settings/ai-provider-delete-dialog.tsx b/apps/portal-shell/src/features/admin/ai-settings/ai-provider-delete-dialog.tsx
new file mode 100644
index 0000000..5e5a74c
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/ai-settings/ai-provider-delete-dialog.tsx
@@ -0,0 +1,123 @@
+"use client";
+
+/**
+ * AI Provider 删除确认对话框
+ *
+ * 数据契约：deleteAiProvider mutation ❌ schema 无 Mutation → MSW 兜底（@contract-pending）
+ *
+ * 安全删除模式：用户必须输入 Provider 名称才能确认删除（防误操作）。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §11.3 / §11.4
+ */
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import type { AiProvider } from "@/lib/api";
+import { useDeleteAiProvider } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+
+export interface AiProviderDeleteDialogProps {
+  provider: AiProvider | null;
+  open: boolean;
+  onClose: () => void;
+  onDeleted: () => Promise<void> | void;
+}
+
+export function AiProviderDeleteDialog({
+  provider,
+  open,
+  onClose,
+  onDeleted,
+}: AiProviderDeleteDialogProps): React.ReactElement {
+  const t = useTranslations("adminDomain.aiSettings.deleteDialog");
+  const tError = useTranslations("adminDomain.aiSettings.error");
+  const deleteProvider = useDeleteAiProvider();
+  const [confirmText, setConfirmText] = useState<string>("");
+  const [submitting, setSubmitting] = useState<boolean>(false);
+
+  // 打开时重置输入，关闭时也清理
+  useEffect(() => {
+    if (open) {
+      setConfirmText("");
+      setSubmitting(false);
+    }
+  }, [open]);
+
+  const providerName = provider?.name ?? "";
+  const canConfirm = confirmText === providerName && providerName !== "";
+
+  const handleConfirm = async (): Promise<void> => {
+    if (!provider || !canConfirm) return;
+    setSubmitting(true);
+    try {
+      await deleteProvider.run(provider.id);
+      notify.success(t("success", { name: providerName }));
+      onClose();
+      await onDeleted();
+    } catch (err: unknown) {
+      notify.error(tError("unknown"));
+      console.error("Failed to delete AI provider:", err);
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={(next) => !next && onClose()}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>{t("title")}</DialogTitle>
+          <DialogDescription>
+            {t("warning", { name: providerName })}
+          </DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-2">
+          <p className="text-sm text-muted-foreground">
+            {t("confirmPrompt", { name: providerName })}
+          </p>
+          <Input
+            type="text"
+            value={confirmText}
+            onChange={(e) => setConfirmText(e.target.value)}
+            placeholder={t("confirmInputPlaceholder")}
+            disabled={submitting}
+            autoComplete="off"
+          />
+          <p className="text-xs text-muted-foreground">
+            {t("confirmInputHint")}
+          </p>
+        </div>
+
+        <DialogFooter>
+          <Button
+            type="button"
+            variant="outline"
+            onClick={onClose}
+            disabled={submitting}
+          >
+            {t("cancel")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            onClick={handleConfirm}
+            disabled={submitting || !canConfirm}
+          >
+            {submitting ? t("deleting") : t("confirm")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/ai-settings/ai-provider-form.tsx b/apps/portal-shell/src/features/admin/ai-settings/ai-provider-form.tsx
new file mode 100644
index 0000000..9a52b57
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/ai-settings/ai-provider-form.tsx
@@ -0,0 +1,401 @@
+"use client";
+
+/**
+ * AI Provider 创建/编辑对话框（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 基于 CICD src/modules/settings/components/ai-provider-settings-card.tsx 适配到 portal-shell：
+ * - Server Actions → Apollo Client mutations + MSW 兜底
+ * - 表单字段：name / type / scope / model / apiBase / apiKey / isActive
+ * - apiKey 写入 config.apiKey，与列表页 extractApiKey 对称
+ * - 支持 create / edit 双模式
+ *
+ * 数据契约：
+ * - createAiProvider / updateAiProvider：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+import { z } from "zod";
+
+import type { AiProvider, AiProviderInput } from "@/lib/api";
+import {
+  useCreateAiProvider,
+  useTestAiProvider,
+  useUpdateAiProvider,
+} from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Select } from "@/shared/components/ui/select";
+import { Switch } from "@/shared/components/ui/switch";
+import { notify } from "@/shared/lib/notify";
+import {
+  PROVIDER_TYPES,
+  PROVIDER_VISIBILITY_OPTIONS,
+  formatProviderType,
+  formatProviderVisibility,
+} from "@/features/admin/ai-settings/transformations";
+
+export interface AiProviderFormProps {
+  provider?: AiProvider | null;
+  mode: "create" | "edit";
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  onSuccess?: () => void;
+}
+
+/** Provider 名称 zod 校验：非空字符串，1-100 字符。 */
+const providerNameSchema = z.string().min(1).max(100);
+
+/** Provider 模型 zod 校验：非空字符串，1-100 字符。 */
+const providerModelSchema = z.string().min(1).max(100);
+
+/** API Base URL zod 校验：可选，若填写必须为合法 http(s) URL。 */
+const providerApiBaseSchema = z
+  .string()
+  .trim()
+  .optional()
+  .refine(
+    (value) => {
+      if (!value) return true;
+      try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+      } catch {
+        return false;
+      }
+    },
+    { message: "invalid-url" },
+  );
+
+export function AiProviderForm({
+  provider,
+  mode,
+  open,
+  onOpenChange,
+  onSuccess,
+}: AiProviderFormProps): React.ReactElement {
+  const t = useTranslations("admin.aiSettings.form");
+  const tCommon = useTranslations("common");
+
+  const [name, setName] = useState<string>("");
+  const [type, setType] = useState<string>("openai");
+  const [scope, setScope] = useState<string>("global");
+  const [model, setModel] = useState<string>("");
+  const [apiBase, setApiBase] = useState<string>("");
+  const [apiKey, setApiKey] = useState<string>("");
+  const [isActive, setIsActive] = useState<boolean>(false);
+  const [visibility, setVisibility] = useState<string>("private");
+  const [isDefault, setIsDefault] = useState<boolean>(false);
+  const [testResult, setTestResult] = useState<{
+    ok: boolean;
+    latencyMs: number;
+    message: string;
+  } | null>(null);
+  const [nameError, setNameError] = useState<string | null>(null);
+  const [modelError, setModelError] = useState<string | null>(null);
+  const [apiBaseError, setApiBaseError] = useState<string | null>(null);
+
+  const { run: createProvider, loading: creating } = useCreateAiProvider();
+  const { run: updateProvider, loading: updating } = useUpdateAiProvider();
+  const { run: testProvider, loading: testing } = useTestAiProvider();
+
+  const handleTestConnection = async (): Promise<void> => {
+    if (!provider) return;
+    setTestResult(null);
+    try {
+      const result = await testProvider(provider.id);
+      setTestResult(result);
+      if (result.ok) {
+        notify.success(t("testSuccess", { latency: result.latencyMs }));
+      } else {
+        notify.error(t("testFailed", { message: result.message }));
+      }
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const isWorking = creating || updating;
+
+  useEffect(() => {
+    if (open) {
+      setName(provider?.name ?? "");
+      setType(provider?.type ?? "openai");
+      setScope(provider?.scope ?? "global");
+      setModel(provider?.model ?? "");
+      setApiBase(provider?.apiBase ?? "");
+      // 编辑模式下不回填 apiKey（安全考虑：服务端不返回明文 key）
+      setApiKey("");
+      setIsActive(provider?.isActive ?? false);
+      setVisibility(provider?.visibility ?? "private");
+      setIsDefault(provider?.isDefault ?? false);
+      setTestResult(null);
+      setNameError(null);
+      setModelError(null);
+      setApiBaseError(null);
+    }
+  }, [open, provider]);
+
+  const typeOptions = PROVIDER_TYPES.map((value) => ({
+    value,
+    label: formatProviderType(value),
+  }));
+
+  const handleSubmit = async (): Promise<void> => {
+    // zod 校验：name 非空、model 非空、apiBase URL 格式（可选）
+    const trimmedName = name.trim();
+    const trimmedModel = model.trim();
+    const trimmedApiBase = apiBase.trim();
+
+    const nameValidation = providerNameSchema.safeParse(trimmedName);
+    if (!nameValidation.success) {
+      setNameError(t("errorNameRequired"));
+      return;
+    }
+    setNameError(null);
+
+    const modelValidation = providerModelSchema.safeParse(trimmedModel);
+    if (!modelValidation.success) {
+      setModelError(t("errorModelRequired"));
+      return;
+    }
+    setModelError(null);
+
+    const apiBaseValidation = providerApiBaseSchema.safeParse(trimmedApiBase);
+    if (!apiBaseValidation.success) {
+      setApiBaseError(t("errorApiBaseInvalid"));
+      return;
+    }
+    setApiBaseError(null);
+
+    // 构建 config：仅当用户输入 apiKey 时写入（编辑模式留空则保留原 key）
+    const config: Record<string, unknown> = {};
+    if (apiKey.trim()) {
+      config.apiKey = apiKey.trim();
+    }
+
+    const input: AiProviderInput = {
+      name: trimmedName,
+      type,
+      scope: scope.trim() || "global",
+      model: trimmedModel,
+      apiBase: trimmedApiBase || undefined,
+      isActive,
+      isDefault,
+      visibility,
+      config: Object.keys(config).length > 0 ? config : undefined,
+    };
+
+    try {
+      if (mode === "create") {
+        await createProvider(input);
+        notify.success(t("createSuccess"));
+      } else if (provider) {
+        await updateProvider(provider.id, input);
+        notify.success(t("updateSuccess"));
+      }
+      onSuccess?.();
+      onOpenChange(false);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="max-h-[90vh] max-w-2xl overflow-y-auto">
+        <DialogHeader>
+          <DialogTitle>
+            {mode === "create" ? t("titleCreate") : t("titleEdit")}
+          </DialogTitle>
+          <DialogDescription>{t("description")}</DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-4">
+          <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
+            <div className="grid gap-2">
+              <Label htmlFor="aip-name">{t("fieldName")}</Label>
+              <Input
+                id="aip-name"
+                value={name}
+                onChange={(e) => {
+                  setName(e.target.value);
+                  if (nameError) setNameError(null);
+                }}
+                placeholder={t("fieldNamePlaceholder")}
+                aria-invalid={nameError !== null}
+              />
+              {nameError ? (
+                <p className="text-xs text-destructive">{nameError}</p>
+              ) : null}
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="aip-type">{t("fieldType")}</Label>
+              <Select
+                id="aip-type"
+                value={type}
+                onValueChange={setType}
+                options={typeOptions}
+                aria-label={t("fieldType")}
+              />
+            </div>
+          </div>
+
+          <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
+            <div className="grid gap-2">
+              <Label htmlFor="aip-scope">{t("fieldScope")}</Label>
+              <Input
+                id="aip-scope"
+                value={scope}
+                onChange={(e) => setScope(e.target.value)}
+                placeholder={t("fieldScopePlaceholder")}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="aip-model">{t("fieldModel")}</Label>
+              <Input
+                id="aip-model"
+                value={model}
+                onChange={(e) => {
+                  setModel(e.target.value);
+                  if (modelError) setModelError(null);
+                }}
+                placeholder={t("fieldModelPlaceholder")}
+                aria-invalid={modelError !== null}
+              />
+              {modelError ? (
+                <p className="text-xs text-destructive">{modelError}</p>
+              ) : null}
+            </div>
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="aip-apibase">{t("fieldApiBase")}</Label>
+            <Input
+              id="aip-apibase"
+              value={apiBase}
+              onChange={(e) => {
+                setApiBase(e.target.value);
+                if (apiBaseError) setApiBaseError(null);
+              }}
+              placeholder={t("fieldApiBasePlaceholder")}
+              aria-invalid={apiBaseError !== null}
+            />
+            {apiBaseError ? (
+              <p className="text-xs text-destructive">{apiBaseError}</p>
+            ) : null}
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="aip-apikey">{t("fieldApiKey")}</Label>
+            <Input
+              id="aip-apikey"
+              type="password"
+              value={apiKey}
+              onChange={(e) => setApiKey(e.target.value)}
+              placeholder={
+                mode === "edit"
+                  ? t("fieldApiKeyPlaceholderEdit")
+                  : t("fieldApiKeyPlaceholder")
+              }
+            />
+            <p className="text-xs text-muted-foreground">
+              {t("fieldApiKeyHint")}
+            </p>
+          </div>
+
+          <div className="flex items-center gap-3">
+            <Switch
+              id="aip-isactive"
+              checked={isActive}
+              onCheckedChange={setIsActive}
+              aria-label={t("fieldIsActive")}
+            />
+            <Label htmlFor="aip-isactive" className="cursor-pointer">
+              {t("fieldIsActive")}
+            </Label>
+          </div>
+
+          <div className="flex items-center gap-3">
+            <Switch
+              id="aip-isdefault"
+              checked={isDefault}
+              onCheckedChange={setIsDefault}
+              aria-label={t("fieldIsDefault")}
+            />
+            <Label htmlFor="aip-isdefault" className="cursor-pointer">
+              {t("fieldIsDefault")}
+            </Label>
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="aip-visibility">{t("fieldVisibility")}</Label>
+            <Select
+              id="aip-visibility"
+              value={visibility}
+              onValueChange={setVisibility}
+              options={PROVIDER_VISIBILITY_OPTIONS.map((value) => ({
+                value,
+                label: formatProviderVisibility(value),
+              }))}
+              aria-label={t("fieldVisibility")}
+            />
+          </div>
+        </div>
+
+        {mode === "edit" && provider ? (
+          <div className="rounded-md border bg-muted/30 p-3">
+            <div className="flex items-center justify-between gap-2">
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                onClick={() => void handleTestConnection()}
+                disabled={testing}
+              >
+                {testing ? t("testing") : t("testConnection")}
+              </Button>
+              {testResult ? (
+                <span
+                  className={
+                    testResult.ok
+                      ? "text-sm text-emerald-600 dark:text-emerald-400"
+                      : "text-sm text-destructive"
+                  }
+                >
+                  {testResult.ok
+                    ? t("testSuccess", { latency: testResult.latencyMs })
+                    : t("testFailed", { message: testResult.message })}
+                </span>
+              ) : null}
+            </div>
+          </div>
+        ) : null}
+
+        <DialogFooter className="gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={() => onOpenChange(false)}
+            disabled={isWorking}
+          >
+            {t("cancel")}
+          </Button>
+          <Button type="button" onClick={handleSubmit} disabled={isWorking}>
+            {isWorking ? t("saving") : t("submit")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/ai-settings/ai-settings-client.tsx b/apps/portal-shell/src/features/admin/ai-settings/ai-settings-client.tsx
index 9a622b0..dad0dfb 100644
--- a/apps/portal-shell/src/features/admin/ai-settings/ai-settings-client.tsx
+++ b/apps/portal-shell/src/features/admin/ai-settings/ai-settings-client.tsx
@@ -16,13 +16,13 @@
  */
 import { Bot, Plus, Trash2, Pencil, PlugZap } from "lucide-react";
 import { useSearchParams, useRouter } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
   useAiProviders,
   useAiUsageDashboard,
-  useDeleteAiProvider,
+  useTestAiProvider,
   type AiProvider,
 } from "@/lib/api";
 import { notify } from "@/shared/lib/notify";
@@ -46,9 +46,12 @@ import {
   formatCostCents,
   formatNumber,
   formatProviderType,
+  formatProviderVisibility,
   maskApiKey,
   truncateBaseUrl,
 } from "@/features/admin/ai-settings/transformations";
+import { AiProviderDeleteDialog } from "@/features/admin/ai-settings/ai-provider-delete-dialog";
+import { AiProviderForm } from "@/features/admin/ai-settings/ai-provider-form";
 
 /**
  * 从 Provider config 中安全提取 apiKey 字符串。未知类型守卫。
@@ -78,10 +81,17 @@ export function AiSettingsClient(): React.ReactElement {
   // @contract-pending：MSW 兜底
   const { data, loading, error, refetch } = useAiProviders(scope || null);
   const usageResult = useAiUsageDashboard(range);
-  const { run: deleteProvider } = useDeleteAiProvider();
 
   const providers = useMemo<AiProvider[]>(() => data ?? [], [data]);
 
+  const [deleteTarget, setDeleteTarget] = useState<AiProvider | null>(null);
+  const [formOpen, setFormOpen] = useState<boolean>(false);
+  const [formMode, setFormMode] = useState<"create" | "edit">("create");
+  const [editTarget, setEditTarget] = useState<AiProvider | null>(null);
+  const [testingId, setTestingId] = useState<string | null>(null);
+
+  const testProvider = useTestAiProvider();
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -94,21 +104,44 @@ export function AiSettingsClient(): React.ReactElement {
     });
   };
 
-  const handleDelete = async (id: string, name: string): Promise<void> => {
-    if (!window.confirm(t("delete") + " " + name + " ?")) {
-      return;
-    }
-    try {
-      await deleteProvider(id);
-      notify.success(t("delete") + ": " + name);
-      await refetch();
-    } catch (err) {
-      notify.error(`${t("delete")}: ${String(err)}`);
-    }
+  const handleDeleteClick = (provider: AiProvider): void => {
+    setDeleteTarget(provider);
   };
 
-  const handleTestConnection = (provider: AiProvider): void => {
-    notify.info(`${t("testConnection")}: ${provider.name}`);
+  const handleOpenCreate = (): void => {
+    setEditTarget(null);
+    setFormMode("create");
+    setFormOpen(true);
+  };
+
+  const handleOpenEdit = (provider: AiProvider): void => {
+    setEditTarget(provider);
+    setFormMode("edit");
+    setFormOpen(true);
+  };
+
+  const handleFormSuccess = async (): Promise<void> => {
+    await refetch();
+  };
+
+  const handleDeleted = async (): Promise<void> => {
+    await refetch();
+  };
+
+  const handleTestConnection = async (provider: AiProvider): Promise<void> => {
+    setTestingId(provider.id);
+    try {
+      const result = await testProvider.run(provider.id);
+      if (result.ok) {
+        notify.success(t("testSuccess", { latency: result.latencyMs }));
+      } else {
+        notify.error(t("testFailed", { message: result.message }));
+      }
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    } finally {
+      setTestingId(null);
+    }
   };
 
   const errorNode = error ? (
@@ -127,7 +160,7 @@ export function AiSettingsClient(): React.ReactElement {
       description={t("emptyDescription")}
       action={{
         label: t("emptyAction"),
-        href: "/shell/admin/ai-settings",
+        onClick: handleOpenCreate,
       }}
     />
   );
@@ -138,11 +171,9 @@ export function AiSettingsClient(): React.ReactElement {
       description={t("description")}
       icon={<Bot className="size-6" />}
       actions={
-        <Button asChild>
-          <a href="/shell/admin/ai-settings">
-            <Plus className="size-4" />
-            {t("addProviderButton")}
-          </a>
+        <Button type="button" onClick={handleOpenCreate}>
+          <Plus className="size-4" />
+          {t("addProviderButton")}
         </Button>
       }
       filters={
@@ -188,6 +219,10 @@ export function AiSettingsClient(): React.ReactElement {
               <th className="p-3 text-left font-medium">{t("colApiKey")}</th>
               <th className="p-3 text-left font-medium">{t("colBaseUrl")}</th>
               <th className="p-3 text-left font-medium">{t("colIsActive")}</th>
+              <th className="p-3 text-left font-medium">
+                {t("colVisibility")}
+              </th>
+              <th className="p-3 text-left font-medium">{t("colIsDefault")}</th>
               <th className="p-3 text-left font-medium">{t("colActions")}</th>
             </tr>
           </thead>
@@ -212,24 +247,36 @@ export function AiSettingsClient(): React.ReactElement {
                 <td className="p-3">
                   <ActiveBadge isActive={p.isActive} />
                 </td>
+                <td className="p-3 text-muted-foreground">
+                  {formatProviderVisibility(p.visibility)}
+                </td>
+                <td className="p-3">
+                  <DefaultBadge isDefault={p.isDefault} />
+                </td>
                 <td className="p-3">
                   <div className="flex items-center gap-2">
                     <Button
                       variant="ghost"
                       size="sm"
-                      onClick={() => handleTestConnection(p)}
+                      onClick={() => void handleTestConnection(p)}
+                      disabled={testingId === p.id}
                     >
                       <PlugZap className="size-4" />
-                      {t("testConnection")}
+                      {testingId === p.id ? t("testing") : t("testConnection")}
                     </Button>
-                    <Button variant="ghost" size="sm" aria-label={t("edit")}>
+                    <Button
+                      variant="ghost"
+                      size="sm"
+                      aria-label={t("edit")}
+                      onClick={() => handleOpenEdit(p)}
+                    >
                       <Pencil className="size-4" />
                     </Button>
                     <Button
                       variant="ghost"
                       size="sm"
                       aria-label={t("delete")}
-                      onClick={() => void handleDelete(p.id, p.name)}
+                      onClick={() => handleDeleteClick(p)}
                     >
                       <Trash2 className="size-4" />
                     </Button>
@@ -242,6 +289,21 @@ export function AiSettingsClient(): React.ReactElement {
       </div>
 
       <p className="text-xs text-muted-foreground">{t("mswNotice")}</p>
+
+      <AiProviderDeleteDialog
+        provider={deleteTarget}
+        open={deleteTarget !== null}
+        onClose={() => setDeleteTarget(null)}
+        onDeleted={handleDeleted}
+      />
+
+      <AiProviderForm
+        provider={editTarget}
+        mode={formMode}
+        open={formOpen}
+        onOpenChange={setFormOpen}
+        onSuccess={handleFormSuccess}
+      />
     </ListPageShell>
   );
 }
@@ -269,6 +331,39 @@ function UsageDashboardSection({
   }>;
 }): React.ReactElement {
   const t = useTranslations("admin.aiSettings.list");
+  const tCommon = useTranslations("common");
+
+  const USAGE_PAGE_SIZE = 10;
+  const [usagePage, setUsagePage] = useState<number>(1);
+
+  const usageTotalPages = Math.max(
+    1,
+    Math.ceil(byProvider.length / USAGE_PAGE_SIZE),
+  );
+  const currentUsagePage = Math.min(Math.max(1, usagePage), usageTotalPages);
+  const pagedUsageRows = byProvider.slice(
+    (currentUsagePage - 1) * USAGE_PAGE_SIZE,
+    currentUsagePage * USAGE_PAGE_SIZE,
+  );
+
+  // byProvider 列表变化时（如切换 range）重置页码
+  useEffect(() => {
+    setUsagePage(1);
+  }, [byProvider.length]);
+
+  const usagePages: Array<number | "ellipsis"> = (() => {
+    if (usageTotalPages <= 7) {
+      return Array.from({ length: usageTotalPages }, (_, i) => i + 1);
+    }
+    const result: Array<number | "ellipsis"> = [1];
+    const start = Math.max(2, currentUsagePage - 1);
+    const end = Math.min(usageTotalPages - 1, currentUsagePage + 1);
+    if (start > 2) result.push("ellipsis");
+    for (let i = start; i <= end; i++) result.push(i);
+    if (end < usageTotalPages - 1) result.push("ellipsis");
+    result.push(usageTotalPages);
+    return result;
+  })();
 
   return (
     <div className="space-y-4">
@@ -299,41 +394,87 @@ function UsageDashboardSection({
           {byProvider.length === 0 ? (
             <p className="text-sm text-muted-foreground">{t("emptyUsage")}</p>
           ) : (
-            <div className="overflow-x-auto">
-              <table className="w-full text-sm">
-                <thead className="border-b bg-muted/30">
-                  <tr>
-                    <th className="p-2 text-left font-medium">
-                      {t("colProviderName")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("colRequests")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("colTokens")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("colCostCents")}
-                    </th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y">
-                  {byProvider.map((row) => (
-                    <tr key={row.providerId} className="hover:bg-muted/30">
-                      <td className="p-2 font-medium">{row.providerName}</td>
-                      <td className="p-2 font-mono text-xs">
-                        {formatNumber(row.requests)}
-                      </td>
-                      <td className="p-2 font-mono text-xs">
-                        {formatNumber(row.tokens)}
-                      </td>
-                      <td className="p-2 font-mono text-xs">
-                        {formatCostCents(row.costCents)}
-                      </td>
+            <div className="space-y-3">
+              <div className="overflow-x-auto">
+                <table className="w-full text-sm">
+                  <thead className="border-b bg-muted/30">
+                    <tr>
+                      <th className="p-2 text-left font-medium">
+                        {t("colProviderName")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("colRequests")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("colTokens")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("colCostCents")}
+                      </th>
                     </tr>
-                  ))}
-                </tbody>
-              </table>
+                  </thead>
+                  <tbody className="divide-y">
+                    {pagedUsageRows.map((row) => (
+                      <tr key={row.providerId} className="hover:bg-muted/30">
+                        <td className="p-2 font-medium">{row.providerName}</td>
+                        <td className="p-2 font-mono text-xs">
+                          {formatNumber(row.requests)}
+                        </td>
+                        <td className="p-2 font-mono text-xs">
+                          {formatNumber(row.tokens)}
+                        </td>
+                        <td className="p-2 font-mono text-xs">
+                          {formatCostCents(row.costCents)}
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+              {byProvider.length > USAGE_PAGE_SIZE ? (
+                <div className="flex items-center justify-end gap-1 text-sm text-muted-foreground">
+                  <Button
+                    variant="outline"
+                    size="sm"
+                    disabled={currentUsagePage <= 1}
+                    onClick={() => setUsagePage(currentUsagePage - 1)}
+                  >
+                    {tCommon("prev")}
+                  </Button>
+                  {usagePages.map((p, idx) =>
+                    p === "ellipsis" ? (
+                      <span
+                        key={`usage-ellipsis-${idx}`}
+                        className="px-2 text-muted-foreground"
+                        aria-hidden="true"
+                      >
+                        …
+                      </span>
+                    ) : (
+                      <Button
+                        key={p}
+                        variant={p === currentUsagePage ? "default" : "outline"}
+                        size="sm"
+                        disabled={p === currentUsagePage}
+                        onClick={() => setUsagePage(p)}
+                        aria-current={
+                          p === currentUsagePage ? "page" : undefined
+                        }
+                      >
+                        {p}
+                      </Button>
+                    ),
+                  )}
+                  <Button
+                    variant="outline"
+                    size="sm"
+                    disabled={currentUsagePage >= usageTotalPages}
+                    onClick={() => setUsagePage(currentUsagePage + 1)}
+                  >
+                    {tCommon("next")}
+                  </Button>
+                </div>
+              ) : null}
             </div>
           )}
         </CardContent>
@@ -357,3 +498,25 @@ function ActiveBadge({ isActive }: { isActive: boolean }): React.ReactElement {
     </span>
   );
 }
+
+/**
+ * 默认 Provider 徽章（按 isDefault 渲染默认/非默认徽章）。
+ */
+function DefaultBadge({
+  isDefault,
+}: {
+  isDefault: boolean;
+}): React.ReactElement {
+  const t = useTranslations("admin.aiSettings.list");
+  const label = isDefault ? t("defaultProvider") : t("nonDefaultProvider");
+  const cls = isDefault
+    ? "bg-primary/10 text-primary"
+    : "bg-muted text-muted-foreground";
+  return (
+    <span
+      className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${cls}`}
+    >
+      {label}
+    </span>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/ai-settings/transformations.ts b/apps/portal-shell/src/features/admin/ai-settings/transformations.ts
index f4745c8..a7bcd15 100644
--- a/apps/portal-shell/src/features/admin/ai-settings/transformations.ts
+++ b/apps/portal-shell/src/features/admin/ai-settings/transformations.ts
@@ -5,22 +5,38 @@
  * 关联：ARCHITECTURE.md §11.3 DoD "数据变换/权限判断等纯函数有 vitest 单测"
  */
 
-/** AI Provider 类型标签映射 */
+/** AI Provider 类型标签映射（对齐 CICD：zhipu/openai/gemini/ollama/custom） */
 export const PROVIDER_TYPE_LABEL: Record<string, string> = {
+  zhipu: "智谱 AI",
   openai: "OpenAI",
-  anthropic: "Anthropic",
-  azure: "Azure OpenAI",
-  local: "本地模型",
+  gemini: "Google Gemini",
+  ollama: "Ollama（本地）",
+  custom: "自定义",
 };
 
 /** AI Provider 类型支持的取值列表 */
 export const PROVIDER_TYPES: readonly string[] = [
+  "zhipu",
   "openai",
-  "anthropic",
-  "azure",
-  "local",
+  "gemini",
+  "ollama",
+  "custom",
 ] as const;
 
+/** AI Provider 可见性枚举值列表（@contract-pending，MSW 兜底） */
+export const PROVIDER_VISIBILITY_OPTIONS: readonly string[] = [
+  "private",
+  "shared",
+  "public",
+] as const;
+
+/** AI Provider 可见性标签映射 */
+export const PROVIDER_VISIBILITY_LABEL: Record<string, string> = {
+  private: "仅自己可见",
+  shared: "组织共享",
+  public: "全员可见",
+};
+
 /**
  * 将 Provider 类型代码映射为展示标签。未知值回退为原始值。
  */
@@ -35,6 +51,13 @@ export function isValidProviderType(type: string): boolean {
   return PROVIDER_TYPES.includes(type);
 }
 
+/**
+ * 将 Provider 可见性代码映射为展示标签。未知值回退为原始值。
+ */
+export function formatProviderVisibility(visibility: string): string {
+  return PROVIDER_VISIBILITY_LABEL[visibility] ?? visibility;
+}
+
 /**
  * 根据 isActive 返回 Tailwind 徽章语义类名。
  */
diff --git a/apps/portal-shell/src/features/admin/announcements/announcement-create-dialog.tsx b/apps/portal-shell/src/features/admin/announcements/announcement-create-dialog.tsx
new file mode 100644
index 0000000..bd3cfc5
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/announcements/announcement-create-dialog.tsx
@@ -0,0 +1,233 @@
+"use client";
+
+/**
+ * 公告内联创建对话框（CICD admin-announcements-view 列表页内联 Dialog 对齐）
+ *
+ * 数据契约：
+ * - mutation createAnnouncement(input) ❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { Megaphone } from "lucide-react";
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+import { useTranslations } from "next-intl";
+
+import { useCreateAnnouncement, type AnnouncementInput } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/shared/components/ui/dialog";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Textarea } from "@/shared/components/ui/textarea";
+import { notify } from "@/shared/lib/notify";
+import { GradeMultiSelect } from "@/features/admin/announcements/grade-multi-select";
+
+/** 可选状态枚举（与列表筛选对齐） */
+const STATUS_OPTIONS = ["draft", "published", "archived"] as const;
+/** 可选受众枚举 */
+const AUDIENCE_OPTIONS = ["all", "teachers", "students", "parents"] as const;
+
+interface AnnouncementCreateDialogProps {
+  /** 受控打开状态（外部受控时使用） */
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  /** 触发器（默认渲染为按钮） */
+  trigger?: React.ReactNode;
+}
+
+/**
+ * 公告创建对话框。支持非受控（默认按钮触发）与受控两种模式。
+ *
+ * 创建成功后：
+ * - 关闭对话框
+ * - notify.success 提示
+ * - router.refresh() 刷新列表
+ */
+export function AnnouncementCreateDialog(
+  props: AnnouncementCreateDialogProps,
+): React.ReactElement {
+  const t = useTranslations("admin.announcements.create");
+  const tCommon = useTranslations("common");
+  const router = useRouter();
+
+  const { run: createAnnouncement, loading: submitting } =
+    useCreateAnnouncement();
+
+  const [internalOpen, setInternalOpen] = useState(false);
+  const open = props.open ?? internalOpen;
+  const setOpen = props.onOpenChange ?? setInternalOpen;
+
+  const [title, setTitle] = useState("");
+  const [content, setContent] = useState("");
+  const [status, setStatus] = useState<string>("draft");
+  const [audience, setAudience] = useState<string>("all");
+  const [grades, setGrades] = useState<string[]>([]);
+  const [formError, setFormError] = useState<string | null>(null);
+
+  const resetForm = (): void => {
+    setTitle("");
+    setContent("");
+    setStatus("draft");
+    setAudience("all");
+    setGrades([]);
+    setFormError(null);
+  };
+
+  const handleOpenChange = (next: boolean): void => {
+    setOpen(next);
+    if (!next) {
+      // 关闭时重置表单
+      resetForm();
+    }
+  };
+
+  const handleSubmit = async (e: React.FormEvent): Promise<void> => {
+    e.preventDefault();
+    setFormError(null);
+
+    if (!title.trim()) {
+      setFormError(t("errorTitleRequired"));
+      return;
+    }
+    if (!content.trim()) {
+      setFormError(t("errorContentRequired"));
+      return;
+    }
+
+    const input: AnnouncementInput = {
+      title: title.trim(),
+      content: content.trim(),
+      status,
+      audience,
+      grades,
+    };
+
+    try {
+      await createAnnouncement(input);
+      notify.success(t("submitSuccess"));
+      handleOpenChange(false);
+      router.refresh();
+    } catch (err) {
+      setFormError(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={handleOpenChange}>
+      <DialogTrigger asChild>
+        {props.trigger ?? (
+          <Button>
+            <Megaphone className="size-4" />
+            {t("triggerButton")}
+          </Button>
+        )}
+      </DialogTrigger>
+      <DialogContent className="max-h-[85vh] max-w-2xl overflow-y-auto">
+        <DialogHeader>
+          <DialogTitle>{t("title")}</DialogTitle>
+          <DialogDescription>{t("description")}</DialogDescription>
+        </DialogHeader>
+
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <div className="space-y-2">
+            <Label htmlFor="ann-title">{t("fieldTitle")}</Label>
+            <Input
+              id="ann-title"
+              value={title}
+              onChange={(e) => setTitle(e.target.value)}
+              placeholder={t("fieldTitlePlaceholder")}
+              maxLength={200}
+              required
+            />
+          </div>
+
+          <div className="space-y-2">
+            <Label htmlFor="ann-content">{t("fieldContent")}</Label>
+            <Textarea
+              id="ann-content"
+              value={content}
+              onChange={(e) => setContent(e.target.value)}
+              placeholder={t("fieldContentPlaceholder")}
+              rows={6}
+              required
+            />
+          </div>
+
+          <div className="grid grid-cols-2 gap-4">
+            <div className="space-y-2">
+              <Label htmlFor="ann-status">{t("fieldStatus")}</Label>
+              <select
+                id="ann-status"
+                value={status}
+                onChange={(e) => setStatus(e.target.value)}
+                className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+              >
+                {STATUS_OPTIONS.map((s) => (
+                  <option key={s} value={s}>
+                    {t(`statusOption_${s}`)}
+                  </option>
+                ))}
+              </select>
+            </div>
+
+            <div className="space-y-2">
+              <Label htmlFor="ann-audience">{t("fieldAudience")}</Label>
+              <select
+                id="ann-audience"
+                value={audience}
+                onChange={(e) => setAudience(e.target.value)}
+                className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+              >
+                {AUDIENCE_OPTIONS.map((a) => (
+                  <option key={a} value={a}>
+                    {t(`audienceOption_${a}`)}
+                  </option>
+                ))}
+              </select>
+            </div>
+          </div>
+
+          <div className="space-y-2">
+            <Label>{t("fieldGrades")}</Label>
+            <GradeMultiSelect
+              selectedIds={grades}
+              onChange={setGrades}
+              disabled={submitting}
+            />
+            <p className="text-xs text-muted-foreground">
+              {t("fieldGradesDescription")}
+            </p>
+          </div>
+
+          {formError ? (
+            <p className="text-sm text-destructive" role="alert">
+              {formError}
+            </p>
+          ) : null}
+
+          <DialogFooter>
+            <Button
+              type="button"
+              variant="outline"
+              onClick={() => handleOpenChange(false)}
+              disabled={submitting}
+            >
+              {tCommon("button.cancel")}
+            </Button>
+            <Button type="submit" disabled={submitting}>
+              {submitting ? t("submitting") : t("submit")}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/announcements/announcement-detail-client.tsx b/apps/portal-shell/src/features/admin/announcements/announcement-detail-client.tsx
index 5e861d5..e6a426b 100644
--- a/apps/portal-shell/src/features/admin/announcements/announcement-detail-client.tsx
+++ b/apps/portal-shell/src/features/admin/announcements/announcement-detail-client.tsx
@@ -16,6 +16,7 @@
  */
 import { Megaphone } from "lucide-react";
 import Link from "next/link";
+import { useState } from "react";
 import { useParams } from "next/navigation";
 import { useTranslations } from "next-intl";
 
@@ -24,6 +25,7 @@ import {
   useArchiveAnnouncement,
   useDeleteAnnouncement,
   usePinAnnouncement,
+  usePublishAnnouncement,
   type AnnouncementDetail,
 } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
@@ -33,6 +35,16 @@ import {
   DetailSection,
   DetailField,
 } from "@/shared/components/page-templates";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/components/ui/alert-dialog";
 import { notify } from "@/shared/lib/notify";
 import {
   announcementStatusToBadgeClass,
@@ -57,9 +69,13 @@ export function AnnouncementDetailClient(): React.ReactElement {
   const { data, loading, error } = useAdminAnnouncement(announcementId);
 
   // @contract-pending：MSW 兜底
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+
+  // @contract-pending: MSW
   const { run: archiveAnnouncement } = useArchiveAnnouncement();
   const { run: pinAnnouncement } = usePinAnnouncement();
   const { run: deleteAnnouncement } = useDeleteAnnouncement();
+  const { run: publishAnnouncement } = usePublishAnnouncement();
 
   const handleArchive = async (): Promise<void> => {
     try {
@@ -81,11 +97,20 @@ export function AnnouncementDetailClient(): React.ReactElement {
     }
   };
 
+  const handlePublish = async (): Promise<void> => {
+    try {
+      await publishAnnouncement(announcementId);
+      notify.success(t("publish"));
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
   const handleDelete = async (): Promise<void> => {
-    if (!window.confirm(t("deleteConfirm"))) return;
     try {
       await deleteAnnouncement(announcementId);
       notify.success(t("delete"));
+      setDeleteDialogOpen(false);
     } catch (err) {
       notify.error(tCommon("error.loadFailed", { message: String(err) }));
     }
@@ -123,9 +148,36 @@ export function AnnouncementDetailClient(): React.ReactElement {
                 {t("archive")}
               </Button>
             ) : null}
-            <Button variant="destructive" onClick={() => void handleDelete()}>
+            {data.status === "draft" ? (
+              <Button onClick={() => void handlePublish()}>
+                {t("publish")}
+              </Button>
+            ) : null}
+            <Button
+              variant="destructive"
+              onClick={() => setDeleteDialogOpen(true)}
+            >
               {t("delete")}
             </Button>
+            <AlertDialog
+              open={deleteDialogOpen}
+              onOpenChange={setDeleteDialogOpen}
+            >
+              <AlertDialogContent>
+                <AlertDialogHeader>
+                  <AlertDialogTitle>{t("deleteConfirm")}</AlertDialogTitle>
+                  <AlertDialogDescription>
+                    {t("deleteConfirmDesc")}
+                  </AlertDialogDescription>
+                </AlertDialogHeader>
+                <AlertDialogFooter>
+                  <AlertDialogCancel>{tCommon("cancel")}</AlertDialogCancel>
+                  <AlertDialogAction onClick={() => void handleDelete()}>
+                    {t("delete")}
+                  </AlertDialogAction>
+                </AlertDialogFooter>
+              </AlertDialogContent>
+            </AlertDialog>
           </div>
         ) : null
       }
@@ -167,6 +219,10 @@ function AnnouncementDetailBody({
           value={formatAudience(announcement.audience)}
         />
         <DetailField label={t("fieldAuthor")} value={announcement.authorName} />
+        <DetailField
+          label={t("fieldReadCount")}
+          value={String(announcement.readCount ?? 0)}
+        />
         <DetailField
           label={t("fieldPinnedAt")}
           value={formatAnnouncementDate(announcement.pinnedAt)}
diff --git a/apps/portal-shell/src/features/admin/announcements/announcement-edit-client.tsx b/apps/portal-shell/src/features/admin/announcements/announcement-edit-client.tsx
index 591a439..ec0a6d7 100644
--- a/apps/portal-shell/src/features/admin/announcements/announcement-edit-client.tsx
+++ b/apps/portal-shell/src/features/admin/announcements/announcement-edit-client.tsx
@@ -26,8 +26,16 @@ import {
   type AnnouncementInput,
 } from "@/lib/api";
 import { FormPageShell } from "@/shared/components/page-templates";
+import { Input } from "@/shared/components/ui/input";
+import { Textarea } from "@/shared/components/ui/textarea";
+import { Select } from "@/shared/components/ui/select";
 import { notify } from "@/shared/lib/notify";
-import { isAnnouncementPinned } from "@/features/admin/announcements/transformations";
+import {
+  formatAnnouncementStatus,
+  formatAudience,
+  isAnnouncementPinned,
+} from "@/features/admin/announcements/transformations";
+import { GradeMultiSelect } from "@/features/admin/announcements/grade-multi-select";
 
 /** 可选状态枚举（与列表筛选对齐） */
 const STATUS_OPTIONS = ["draft", "published", "archived"] as const;
@@ -58,6 +66,7 @@ export function AnnouncementEditClient(): React.ReactElement {
   const [audience, setAudience] = useState<string>("all");
   const [pinned, setPinned] = useState(false);
   const [originalPinned, setOriginalPinned] = useState(false);
+  const [grades, setGrades] = useState<string[]>([]);
   const [formError, setFormError] = useState<string | null>(null);
   const [initialized, setInitialized] = useState(false);
 
@@ -71,6 +80,7 @@ export function AnnouncementEditClient(): React.ReactElement {
       const isPinned = isAnnouncementPinned(data.pinnedAt);
       setPinned(isPinned);
       setOriginalPinned(isPinned);
+      setGrades(data.grades ?? []);
       setInitialized(true);
     }
   }, [data, initialized]);
@@ -92,6 +102,7 @@ export function AnnouncementEditClient(): React.ReactElement {
       content: content.trim(),
       status,
       audience,
+      grades,
     };
 
     try {
@@ -161,22 +172,20 @@ export function AnnouncementEditClient(): React.ReactElement {
     >
       {/* 标题 */}
       <FormField label={t("fieldTitle")} required>
-        <input
+        <Input
           type="text"
           value={title}
           onChange={(e) => setTitle(e.target.value)}
-          className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
           required
         />
       </FormField>
 
       {/* 内容 */}
       <FormField label={t("fieldContent")} required>
-        <textarea
+        <Textarea
           value={content}
           onChange={(e) => setContent(e.target.value)}
           rows={6}
-          className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
           required
         />
       </FormField>
@@ -184,31 +193,27 @@ export function AnnouncementEditClient(): React.ReactElement {
       {/* 状态 + 受众 */}
       <div className="grid grid-cols-2 gap-4">
         <FormField label={t("fieldStatus")}>
-          <select
+          <Select
             value={status}
-            onChange={(e) => setStatus(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-          >
-            {STATUS_OPTIONS.map((s) => (
-              <option key={s} value={s}>
-                {s}
-              </option>
-            ))}
-          </select>
+            onValueChange={setStatus}
+            options={STATUS_OPTIONS.map((s) => ({
+              value: s,
+              label: formatAnnouncementStatus(s),
+            }))}
+            aria-label={t("fieldStatus")}
+          />
         </FormField>
 
         <FormField label={t("fieldAudience")}>
-          <select
+          <Select
             value={audience}
-            onChange={(e) => setAudience(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-          >
-            {AUDIENCE_OPTIONS.map((a) => (
-              <option key={a} value={a}>
-                {a}
-              </option>
-            ))}
-          </select>
+            onValueChange={setAudience}
+            options={AUDIENCE_OPTIONS.map((a) => ({
+              value: a,
+              label: formatAudience(a),
+            }))}
+            aria-label={t("fieldAudience")}
+          />
         </FormField>
       </div>
 
@@ -224,6 +229,15 @@ export function AnnouncementEditClient(): React.ReactElement {
           <span className="text-muted-foreground">{t("fieldPinned")}</span>
         </label>
       </FormField>
+
+      {/* 关联年级（多选下拉） */}
+      <FormField label={t("fieldGrades")}>
+        <GradeMultiSelect
+          selectedIds={grades}
+          onChange={setGrades}
+          disabled={submitting}
+        />
+      </FormField>
     </FormPageShell>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/announcements/announcements-list-client.tsx b/apps/portal-shell/src/features/admin/announcements/announcements-list-client.tsx
index 87802f3..bee68d9 100644
--- a/apps/portal-shell/src/features/admin/announcements/announcements-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/announcements/announcements-list-client.tsx
@@ -13,10 +13,10 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { Megaphone } from "lucide-react";
+import { Megaphone, Plus } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useTransition } from "react";
+import { useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
@@ -24,15 +24,27 @@ import {
   useArchiveAnnouncement,
   useDeleteAnnouncement,
   usePinAnnouncement,
+  usePublishAnnouncement,
   type AnnouncementListItem,
 } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/components/ui/alert-dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
 import { notify } from "@/shared/lib/notify";
+import { AnnouncementCreateDialog } from "@/features/admin/announcements/announcement-create-dialog";
 import {
   announcementStatusToBadgeClass,
   formatAnnouncementDate,
@@ -55,6 +67,8 @@ export function AnnouncementsListClient(): React.ReactElement {
   const router = useRouter();
   const searchParams = useSearchParams();
   const [, startTransition] = useTransition();
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [deleteTargetId, setDeleteTargetId] = useState<string>("");
 
   const statusParam = searchParams.get("status") ?? "";
   const status = STATUS_OPTIONS.includes(statusParam as StatusOption)
@@ -70,6 +84,7 @@ export function AnnouncementsListClient(): React.ReactElement {
   const { run: archiveAnnouncement } = useArchiveAnnouncement();
   const { run: pinAnnouncement } = usePinAnnouncement();
   const { run: deleteAnnouncement } = useDeleteAnnouncement();
+  const { run: publishAnnouncement } = usePublishAnnouncement();
 
   const items = data?.items ?? [];
 
@@ -110,16 +125,30 @@ export function AnnouncementsListClient(): React.ReactElement {
     }
   };
 
-  const handleDelete = async (id: string): Promise<void> => {
-    if (!window.confirm(t("deleteConfirm"))) return;
+  const handlePublish = async (id: string): Promise<void> => {
     try {
-      await deleteAnnouncement(id);
-      notify.success(t("delete"));
+      await publishAnnouncement(id);
+      notify.success(t("publish"));
     } catch (err) {
       notify.error(`${tCommon("error.loadFailed", { message: String(err) })}`);
     }
   };
 
+  const handleDelete = async (): Promise<void> => {
+    try {
+      await deleteAnnouncement(deleteTargetId);
+      notify.success(t("delete"));
+      setDeleteDialogOpen(false);
+    } catch (err) {
+      notify.error(`${tCommon("error.loadFailed", { message: String(err) })}`);
+    }
+  };
+
+  const openDeleteDialog = (id: string): void => {
+    setDeleteTargetId(id);
+    setDeleteDialogOpen(true);
+  };
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -147,11 +176,14 @@ export function AnnouncementsListClient(): React.ReactElement {
       description={t("description")}
       icon={<Megaphone className="size-6" />}
       actions={
-        <Button asChild>
-          <Link href="/shell/admin/announcements/new">
-            {t("newAnnouncement")}
-          </Link>
-        </Button>
+        <AnnouncementCreateDialog
+          trigger={
+            <Button>
+              <Plus className="size-4" />
+              {t("newAnnouncement")}
+            </Button>
+          }
+        />
       }
       filters={
         <label className="flex items-center gap-2 text-sm">
@@ -175,9 +207,12 @@ export function AnnouncementsListClient(): React.ReactElement {
       emptyNode={emptyNode}
       errorNode={errorNode}
       pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: data?.total ?? 0 })}</span>
-        </div>
+        <PaginationBar
+          total={data?.total ?? 0}
+          page={page}
+          pageSize={10}
+          onNavigate={(p) => updateQuery("page", String(p))}
+        />
       }
     >
       <AnnouncementsTable
@@ -185,8 +220,25 @@ export function AnnouncementsListClient(): React.ReactElement {
         page={page}
         onArchive={handleArchive}
         onPinToggle={handlePinToggle}
-        onDelete={handleDelete}
+        onPublish={handlePublish}
+        onDelete={openDeleteDialog}
       />
+      <AlertDialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>{t("deleteConfirm")}</AlertDialogTitle>
+            <AlertDialogDescription>
+              {t("deleteConfirmDesc")}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>{tCommon("cancel")}</AlertDialogCancel>
+            <AlertDialogAction onClick={() => void handleDelete()}>
+              {t("delete")}
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
     </ListPageShell>
   );
 }
@@ -199,13 +251,15 @@ function AnnouncementsTable({
   page,
   onArchive,
   onPinToggle,
+  onPublish,
   onDelete,
 }: {
   items: AnnouncementListItem[];
   page: number;
   onArchive: (id: string) => Promise<void>;
   onPinToggle: (id: string, pinned: boolean) => Promise<void>;
-  onDelete: (id: string) => Promise<void>;
+  onPublish: (id: string) => Promise<void>;
+  onDelete: (id: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.announcements.list");
   return (
@@ -216,6 +270,7 @@ function AnnouncementsTable({
             <th className="p-3 text-left font-medium">{t("colTitle")}</th>
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
             <th className="p-3 text-left font-medium">{t("colAudience")}</th>
+            <th className="p-3 text-left font-medium">{t("colReadCount")}</th>
             <th className="p-3 text-left font-medium">{t("colPinnedAt")}</th>
             <th className="p-3 text-left font-medium">{t("colPublishedAt")}</th>
             <th className="p-3 text-right font-medium">{t("colActions")}</th>
@@ -240,6 +295,9 @@ function AnnouncementsTable({
                 <td className="p-3 text-muted-foreground">
                   {formatAudience(item.audience)}
                 </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {item.readCount}
+                </td>
                 <td className="p-3 font-mono text-xs text-muted-foreground">
                   {formatAnnouncementDate(item.pinnedAt)}
                 </td>
@@ -262,6 +320,15 @@ function AnnouncementsTable({
                         {t("edit")}
                       </Link>
                     </Button>
+                    {item.status === "draft" ? (
+                      <Button
+                        variant="ghost"
+                        size="sm"
+                        onClick={() => void onPublish(item.id)}
+                      >
+                        {t("publish")}
+                      </Button>
+                    ) : null}
                     <Button
                       variant="ghost"
                       size="sm"
@@ -279,7 +346,7 @@ function AnnouncementsTable({
                     <Button
                       variant="ghost"
                       size="sm"
-                      onClick={() => void onDelete(item.id)}
+                      onClick={() => onDelete(item.id)}
                     >
                       {t("delete")}
                     </Button>
@@ -308,3 +375,92 @@ function StatusBadge({ status }: { status: string }): React.ReactElement {
     </span>
   );
 }
+
+/**
+ * 分页条（页码按钮 + 上一页/下一页 + 总数）。
+ * 总页数 > 7 时使用窗口策略（首末页 + 当前页 ±1 + 省略号）。
+ */
+function PaginationBar({
+  total,
+  page,
+  pageSize,
+  onNavigate,
+}: {
+  total: number;
+  page: number;
+  pageSize: number;
+  onNavigate: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.announcements.list");
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const currentPage = Math.min(Math.max(1, page), totalPages);
+
+  const pages: Array<number | "ellipsis"> = (() => {
+    if (totalPages <= 7) {
+      return Array.from({ length: totalPages }, (_, i) => i + 1);
+    }
+    const result: Array<number | "ellipsis"> = [1];
+    const start = Math.max(2, currentPage - 1);
+    const end = Math.min(totalPages - 1, currentPage + 1);
+    if (start > 2) result.push("ellipsis");
+    for (let i = start; i <= end; i++) result.push(i);
+    if (end < totalPages - 1) result.push("ellipsis");
+    result.push(totalPages);
+    return result;
+  })();
+
+  if (total === 0) {
+    return (
+      <div className="flex items-center justify-end text-sm text-muted-foreground">
+        <span>{t("total", { count: 0 })}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex items-center justify-between gap-2 text-sm text-muted-foreground">
+      <span>{t("total", { count: total })}</span>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          disabled={currentPage <= 1}
+          onClick={() => onNavigate(currentPage - 1)}
+        >
+          {tCommon("prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "ellipsis" ? (
+            <span
+              key={`ellipsis-${idx}`}
+              className="px-2 text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === currentPage ? "default" : "outline"}
+              size="sm"
+              disabled={p === currentPage}
+              onClick={() => onNavigate(p)}
+              aria-current={p === currentPage ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          disabled={currentPage >= totalPages}
+          onClick={() => onNavigate(currentPage + 1)}
+        >
+          {tCommon("next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/announcements/grade-multi-select.tsx b/apps/portal-shell/src/features/admin/announcements/grade-multi-select.tsx
new file mode 100644
index 0000000..e48e0b4
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/announcements/grade-multi-select.tsx
@@ -0,0 +1,182 @@
+"use client";
+
+/**
+ * 年级多选下拉组件（CICD announcements AnnouncementForm 多选下拉对齐）
+ *
+ * 数据契约：useGrades() 来自 admin-p5.ts（@contract-pending，MSW 兜底）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5 / §11.3
+ */
+import { Check, ChevronDown, X } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import { useGrades } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+
+interface GradeMultiSelectProps {
+  selectedIds: string[];
+  onChange: (ids: string[]) => void;
+  disabled?: boolean;
+}
+
+export function GradeMultiSelect({
+  selectedIds,
+  onChange,
+  disabled = false,
+}: GradeMultiSelectProps): React.ReactElement {
+  const t = useTranslations("admin.announcements.edit.multiSelect");
+  const [open, setOpen] = useState(false);
+  const containerRef = useRef<HTMLDivElement | null>(null);
+  const { data: grades, loading, error } = useGrades();
+
+  useEffect(() => {
+    if (error) {
+      notify.error(String(error));
+    }
+  }, [error]);
+
+  // 点击外部关闭下拉
+  useEffect(() => {
+    if (!open) return;
+    const handleClickOutside = (e: MouseEvent): void => {
+      if (
+        containerRef.current &&
+        e.target instanceof Node &&
+        !containerRef.current.contains(e.target)
+      ) {
+        setOpen(false);
+      }
+    };
+    document.addEventListener("mousedown", handleClickOutside);
+    return () => {
+      document.removeEventListener("mousedown", handleClickOutside);
+    };
+  }, [open]);
+
+  const handleToggle = (gradeId: string): void => {
+    if (selectedIds.includes(gradeId)) {
+      onChange(selectedIds.filter((id) => id !== gradeId));
+    } else {
+      onChange([...selectedIds, gradeId]);
+    }
+  };
+
+  const handleRemove = (gradeId: string): void => {
+    onChange(selectedIds.filter((id) => id !== gradeId));
+  };
+
+  const handleToggleAll = (): void => {
+    if (!grades) return;
+    if (selectedIds.length === grades.length) {
+      onChange([]);
+    } else {
+      onChange(grades.map((g) => g.id));
+    }
+  };
+
+  const selectedGrades = (grades ?? []).filter((g) =>
+    selectedIds.includes(g.id),
+  );
+
+  return (
+    <div ref={containerRef} className="relative w-full">
+      {/* 已选项 Badge 列表 */}
+      {selectedGrades.length > 0 && (
+        <div className="mb-2 flex flex-wrap gap-1">
+          {selectedGrades.map((g) => (
+            <span
+              key={g.id}
+              className="inline-flex items-center gap-1 rounded-full bg-primary/10 px-2 py-0.5 text-xs text-primary"
+            >
+              {g.name}
+              <button
+                type="button"
+                onClick={() => handleRemove(g.id)}
+                disabled={disabled}
+                aria-label={t("remove", { name: g.name })}
+                className="ml-0.5 rounded-full hover:bg-primary/20 disabled:opacity-50"
+              >
+                <X className="size-3" />
+              </button>
+            </span>
+          ))}
+        </div>
+      )}
+
+      {/* 触发按钮 */}
+      <button
+        type="button"
+        onClick={() => setOpen(!open)}
+        disabled={disabled || loading}
+        aria-expanded={open}
+        className="flex h-9 w-full items-center justify-between rounded-md border border-input bg-background px-3 text-sm text-left disabled:opacity-50"
+      >
+        <span
+          className={selectedIds.length === 0 ? "text-muted-foreground" : ""}
+        >
+          {selectedIds.length === 0
+            ? t("placeholder")
+            : t("selected", { count: selectedIds.length })}
+        </span>
+        <ChevronDown
+          className={`size-4 transition-transform ${open ? "rotate-180" : ""}`}
+        />
+      </button>
+
+      {/* 下拉面板 */}
+      {open && (
+        <div className="absolute z-50 mt-1 w-full rounded-md border border-input bg-background shadow-lg">
+          {loading && (
+            <div className="p-2 text-center text-xs text-muted-foreground">
+              {t("loading")}
+            </div>
+          )}
+          {!loading && (grades?.length ?? 0) === 0 && (
+            <div className="p-2 text-center text-xs text-muted-foreground">
+              {t("empty")}
+            </div>
+          )}
+          {!loading && (grades?.length ?? 0) > 0 && (
+            <>
+              <div className="border-b border-input p-2">
+                <button
+                  type="button"
+                  onClick={handleToggleAll}
+                  className="text-xs text-primary hover:underline"
+                >
+                  {selectedIds.length === grades?.length
+                    ? t("toggle", { action: "clear" })
+                    : t("toggle", { action: "all" })}
+                </button>
+              </div>
+              <div className="max-h-60 overflow-y-auto">
+                {(grades ?? []).map((g) => {
+                  const checked = selectedIds.includes(g.id);
+                  return (
+                    <label
+                      key={g.id}
+                      className="flex cursor-pointer items-center gap-2 p-2 hover:bg-muted/30"
+                    >
+                      <input
+                        type="checkbox"
+                        checked={checked}
+                        onChange={() => handleToggle(g.id)}
+                        disabled={disabled}
+                        className="size-4 rounded border-input"
+                      />
+                      <span className="text-sm">{g.name}</span>
+                      {checked && (
+                        <Check className="ml-auto size-3 text-primary" />
+                      )}
+                    </label>
+                  );
+                })}
+              </div>
+            </>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/attendance/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/attendance/__tests__/transformations.test.ts
index 24500ce..b60a024 100644
--- a/apps/portal-shell/src/features/admin/attendance/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/attendance/__tests__/transformations.test.ts
@@ -64,6 +64,7 @@ const baseRecords: AdminAttendanceRecord[] = [
     studentName: "张三",
     classId: "cls-1",
     className: "高三(1)班",
+    gradeId: "g-1",
     date: "2026-07-22",
     status: "present",
     recordedBy: "李老师",
@@ -75,6 +76,7 @@ const baseRecords: AdminAttendanceRecord[] = [
     studentName: "李四",
     classId: "cls-2",
     className: "高三(2)班",
+    gradeId: "g-1",
     date: "2026-07-22",
     status: "absent",
     recordedBy: "李老师",
@@ -86,6 +88,7 @@ const baseRecords: AdminAttendanceRecord[] = [
     studentName: "王五",
     classId: "cls-1",
     className: "高三(1)班",
+    gradeId: "g-1",
     date: "2026-07-23",
     status: "late",
     recordedBy: "王老师",
diff --git a/apps/portal-shell/src/features/admin/attendance/_write-correlation-card.mjs b/apps/portal-shell/src/features/admin/attendance/_write-correlation-card.mjs
new file mode 100644
index 0000000..e69de29
diff --git a/apps/portal-shell/src/features/admin/attendance/admin-attendance-client.tsx b/apps/portal-shell/src/features/admin/attendance/admin-attendance-client.tsx
index 1945652..11dfe5a 100644
--- a/apps/portal-shell/src/features/admin/attendance/admin-attendance-client.tsx
+++ b/apps/portal-shell/src/features/admin/attendance/admin-attendance-client.tsx
@@ -7,8 +7,10 @@
  * - adminAttendanceStats()：❌ schema 无 → MSW 兜底（@contract-pending）
  * - attendanceGradeCorrelation()：❌ schema 无 → MSW 兜底
  * - adminClasses()：❌ schema 无 → MSW 兜底（用于班级筛选下拉）
+ * - grades()：✅ 真实 schema（用于年级筛选下拉）
+ * - classComparison()：❌ schema 无 → MSW 兜底（由 ClassComparisonCard 内部调用）
  *
- * URL 状态：?classId=xxx&status=xxx&date=xxx
+ * URL 状态：?classId=xxx&status=xxx&date=xxx&gradeId=xxx&page=xxx
  *
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
  *
@@ -23,8 +25,8 @@ import {
   useAdminAttendanceStats,
   useAdminClasses,
   useAttendanceGradeCorrelation,
+  useGrades,
 } from "@/lib/api";
-import { Card, CardContent } from "@/shared/components/ui/card";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { StatCard } from "@/shared/components/ui/stat-card";
 import {
@@ -32,21 +34,20 @@ import {
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
 import {
-  attendanceStatusToBadgeClass,
-  attendanceStatusToKey,
   computeAbnormalRate,
   computeAvgCorrelation,
   formatAbnormalRate,
-  formatAvgScore,
   formatCorrelation,
   formatRate,
   formatRecordDate,
   hasAttendanceData,
   presentRateToColorClass,
-  sortClassesByPresentRate,
   truncateNote,
   type AttendanceStatus,
 } from "@/features/admin/attendance/transformations";
+import { ClassComparisonCard } from "@/features/admin/attendance/class-comparison-card";
+import { AttendanceGradeCorrelationCard } from "@/features/admin/attendance/attendance-grade-correlation-card";
+import { AttendanceRecordsList } from "@/features/admin/attendance/attendance-records-list";
 
 /** 考勤状态选项（用于筛选下拉） */
 const STATUS_OPTIONS: readonly AttendanceStatus[] = [
@@ -70,11 +71,13 @@ export function AdminAttendanceClient(): React.ReactElement {
   const classId = searchParams.get("classId") ?? "";
   const status = searchParams.get("status") ?? "";
   const date = searchParams.get("date") ?? "";
+  const gradeId = searchParams.get("gradeId") ?? "";
 
   // @contract-pending：MSW 兜底
   const { data: stats, loading, error } = useAdminAttendanceStats();
   const { data: correlations } = useAttendanceGradeCorrelation();
   const { data: classes } = useAdminClasses();
+  const { data: grades } = useGrades();
 
   const avgCorrelation = useMemo(
     () => computeAvgCorrelation(correlations ?? []),
@@ -88,6 +91,10 @@ export function AdminAttendanceClient(): React.ReactElement {
     } else {
       params.delete(key);
     }
+    // 切换筛选时重置页码
+    if (key !== "page") {
+      params.delete("page");
+    }
     startTransition(() => {
       router.push(`/shell/admin/attendance?${params.toString()}`);
     });
@@ -122,10 +129,13 @@ export function AdminAttendanceClient(): React.ReactElement {
           classId={classId}
           status={status}
           date={date}
+          gradeId={gradeId}
           classes={classes ?? []}
+          grades={grades ?? []}
           onClassChange={(v) => updateFilter("classId", v)}
           onStatusChange={(v) => updateFilter("status", v)}
           onDateChange={(v) => updateFilter("date", v)}
+          onGradeChange={(v) => updateFilter("gradeId", v)}
         />
       }
       loading={loading}
@@ -135,40 +145,74 @@ export function AdminAttendanceClient(): React.ReactElement {
       errorNode={errorNode}
     >
       {stats ? (
-        <AttendanceContent
-          stats={stats}
-          correlations={correlations ?? []}
-          avgCorrelation={avgCorrelation}
-        />
+        <AttendanceContent stats={stats} avgCorrelation={avgCorrelation} />
       ) : null}
+      {/* 班级对比卡 + 考勤-成绩关联分析卡（并排布局，lg 以上双列） */}
+      <div className="grid grid-cols-1 gap-4 lg:grid-cols-2">
+        <ClassComparisonCard />
+        <AttendanceGradeCorrelationCard />
+      </div>
+
+      {/* 考勤记录列表：按 classId/status/date/gradeId 筛选 + URL 分页 */}
+      <AttendanceRecordsList
+        classId={classId}
+        status={status}
+        date={date}
+        gradeId={gradeId}
+      />
+
       <p className="text-xs text-muted-foreground">{t("mswNotice")}</p>
     </ListPageShell>
   );
 }
 
 /**
- * 考勤筛选栏（班级 + 状态 + 日期）。
+ * 考勤筛选栏（年级 + 班级 + 状态 + 日期）。
  */
 function AttendanceFilters({
   classId,
   status,
   date,
+  gradeId,
   classes,
+  grades,
   onClassChange,
   onStatusChange,
   onDateChange,
+  onGradeChange,
 }: {
   classId: string;
   status: string;
   date: string;
+  gradeId: string;
   classes: NonNullable<ReturnType<typeof useAdminClasses>["data"]>;
+  grades: NonNullable<ReturnType<typeof useGrades>["data"]>;
   onClassChange: (v: string) => void;
   onStatusChange: (v: string) => void;
   onDateChange: (v: string) => void;
+  onGradeChange: (v: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.attendance.list");
   return (
     <div className="flex flex-wrap items-center gap-3">
+      <div className="flex flex-col gap-1">
+        <label className="text-xs text-muted-foreground">
+          {t("gradeFilter")}
+        </label>
+        <select
+          value={gradeId}
+          onChange={(e) => onGradeChange(e.target.value)}
+          className="h-9 rounded-md border border-input bg-transparent px-3 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+        >
+          <option value="">{t("allGrades")}</option>
+          {grades.map((g) => (
+            <option key={g.id} value={g.id}>
+              {g.name}
+            </option>
+          ))}
+        </select>
+      </div>
+
       <div className="flex flex-col gap-1">
         <label className="text-xs text-muted-foreground">
           {t("classFilter")}
@@ -227,17 +271,15 @@ function AttendanceFilters({
 }
 
 /**
- * 考勤主体内容（统计卡片 + 班级对比 + 考勤-成绩关联分析）。
+ * 考勤主体内容（统计卡片）。
+ * 班级对比与考勤-成绩关联分析由独立卡片组件渲染（ClassComparisonCard /
+ * AttendanceGradeCorrelationCard），各自管理数据获取与三态。
  */
 function AttendanceContent({
   stats,
-  correlations,
   avgCorrelation,
 }: {
   stats: NonNullable<ReturnType<typeof useAdminAttendanceStats>["data"]>;
-  correlations: NonNullable<
-    ReturnType<typeof useAttendanceGradeCorrelation>["data"]
-  >;
   avgCorrelation: number;
 }): React.ReactElement {
   const t = useTranslations("admin.attendance.list");
@@ -246,7 +288,6 @@ function AttendanceContent({
     stats.lateRate,
     stats.earlyLeaveRate,
   );
-  const sortedClasses = sortClassesByPresentRate(stats);
 
   return (
     <div className="flex flex-col gap-6">
@@ -291,117 +332,6 @@ function AttendanceContent({
           valueClassName="text-sky-600 dark:text-sky-400"
         />
       </div>
-
-      {/* 班级对比 */}
-      <Card>
-        <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">
-            {t("classComparisonTitle")}
-          </h2>
-          {sortedClasses.length === 0 ? (
-            <p className="py-6 text-center text-sm text-muted-foreground">
-              {t("emptyTitle")}
-            </p>
-          ) : (
-            <div className="overflow-x-auto">
-              <table className="w-full text-sm">
-                <thead className="border-b bg-muted/30">
-                  <tr>
-                    <th className="p-2 text-left font-medium">
-                      {t("classComparisonClass")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("statsAbsentRate")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("classComparisonRate")}
-                    </th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y">
-                  {sortedClasses.map((cls) => (
-                    <tr key={cls.classId} className="hover:bg-muted/30">
-                      <td className="p-2 font-medium">{cls.className}</td>
-                      <td className="p-2 font-mono text-xs text-destructive">
-                        {formatRate(cls.absentRate)}
-                      </td>
-                      <td
-                        className={`p-2 font-mono text-xs ${presentRateToColorClass(cls.presentRate)}`}
-                      >
-                        {formatRate(cls.presentRate)}
-                      </td>
-                    </tr>
-                  ))}
-                </tbody>
-              </table>
-            </div>
-          )}
-        </CardContent>
-      </Card>
-
-      {/* 考勤-成绩关联分析 */}
-      <Card>
-        <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">
-            {t("correlationTitle")}
-          </h2>
-          {correlations.length === 0 ? (
-            <p className="py-6 text-center text-sm text-muted-foreground">
-              {t("emptyTitle")}
-            </p>
-          ) : (
-            <div className="overflow-x-auto">
-              <table className="w-full text-sm">
-                <thead className="border-b bg-muted/30">
-                  <tr>
-                    <th className="p-2 text-left font-medium">
-                      {t("classComparisonClass")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("correlationAttendance")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("correlationGrade")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("statsAvgCorrelation")}
-                    </th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y">
-                  {correlations.map((c) => {
-                    const statusKey = attendanceStatusToKey(
-                      c.presentRate >= 0.9 ? "present" : "absent",
-                    );
-                    return (
-                      <tr key={c.classId} className="hover:bg-muted/30">
-                        <td className="p-2 font-medium">{c.className}</td>
-                        <td
-                          className={`p-2 font-mono text-xs ${presentRateToColorClass(c.presentRate)}`}
-                        >
-                          {formatRate(c.presentRate)}
-                        </td>
-                        <td className="p-2 font-mono text-xs">
-                          {formatAvgScore(c.avgScore)}
-                        </td>
-                        <td className="p-2 font-mono text-xs">
-                          <span
-                            className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${attendanceStatusToBadgeClass(
-                              statusKey,
-                            )}`}
-                          >
-                            {formatCorrelation(c.correlation)}
-                          </span>
-                        </td>
-                      </tr>
-                    );
-                  })}
-                </tbody>
-              </table>
-            </div>
-          )}
-        </CardContent>
-      </Card>
     </div>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/attendance/attendance-grade-correlation-card.tsx b/apps/portal-shell/src/features/admin/attendance/attendance-grade-correlation-card.tsx
new file mode 100644
index 0000000..cf7c3a7
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/attendance/attendance-grade-correlation-card.tsx
@@ -0,0 +1,466 @@
+"use client";
+
+/**
+ * 考勤-成绩关联分析卡（ARCHITECTURE.md §9.4 / §11.3 DoD 三态）
+ *
+ * 数据契约：
+ * - attendanceGradeCorrelation()：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 三态规范（§11.3 DoD）：
+ * - loading：骨架屏
+ * - error：局部降级（EmptyState + 错误文案）
+ * - data：汇总统计 + 散点图 + 班级明细表格
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §11.3 / §11.4
+ */
+import { useEffect, useMemo } from "react";
+import { useTranslations } from "next-intl";
+import {
+  CartesianGrid,
+  Cell,
+  Scatter,
+  ScatterChart,
+  XAxis,
+  YAxis,
+  ZAxis,
+} from "recharts";
+import { TrendingUp, AlertCircle } from "lucide-react";
+
+import { useAttendanceGradeCorrelation } from "@/lib/api";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/components/ui/card";
+import { Skeleton } from "@/shared/components/ui/skeleton";
+import { EmptyState } from "@/shared/components/ui/empty-state";
+import {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/shared/components/charts";
+import { notify } from "@/shared/lib/notify";
+import { cn } from "@/shared/lib/utils";
+
+/** 散点图数据项（从 AttendanceGradeCorrelation 派生） */
+interface ScatterDataPoint {
+  classId: string;
+  className: string;
+  attendanceRate: number;
+  avgScore: number;
+  correlation: number;
+}
+
+/** recharts 内联对象常量：避免每次渲染创建新对象 */
+const SCATTER_MARGIN = { top: 16, right: 16, bottom: 32, left: 16 };
+const SCATTER_GRID_PROPS = { strokeDasharray: "4 4", strokeOpacity: 0.4 };
+const TOOLTIP_CURSOR = { strokeDasharray: "3 3" };
+const Z_AXIS_RANGE: [number, number] = [60, 60];
+const AXIS_LABEL_STYLE = { fontSize: 12, fill: "hsl(var(--muted-foreground))" };
+const SCATTER_DOMAIN: [number, number] = [0, 100];
+
+/** 相关性强弱阈值 */
+const CORRELATION_STRONG = 0.7;
+const CORRELATION_WEAK = 0.4;
+
+/** 相关性强弱等级对应的颜色（使用 CSS 变量） */
+const CORRELATION_COLORS = {
+  strong: "hsl(var(--chart-2))",
+  medium: "hsl(var(--chart-4))",
+  weak: "hsl(var(--chart-1))",
+} as const;
+
+/** 相关性强弱等级 */
+type CorrelationTier = "strong" | "medium" | "weak";
+
+const chartConfig: ChartConfig = {
+  classes: {
+    label: "Classes",
+  },
+};
+
+/**
+ * 考勤-成绩关联分析卡：展示班级出勤率与平均成绩的关联性。
+ *
+ * 内部调用 useAttendanceGradeCorrelation hook，三态：loading / error / data。
+ * 数据态展示汇总统计 + 散点图 + 班级明细表格。
+ */
+export function AttendanceGradeCorrelationCard(): React.ReactElement {
+  const t = useTranslations("admin.attendance.gradeCorrelation");
+  const { data, loading, error } = useAttendanceGradeCorrelation();
+
+  useEffect(() => {
+    if (error) {
+      notify.error(t("errorNotification"));
+    }
+  }, [error, t]);
+
+  const scatterData = useMemo<ScatterDataPoint[]>(() => {
+    if (!data) return [];
+    return data.map((item) => ({
+      classId: item.classId,
+      className: item.className,
+      attendanceRate: Math.round(item.presentRate * 100),
+      avgScore: Math.round(item.avgScore * 10) / 10,
+      correlation: item.correlation,
+    }));
+  }, [data]);
+
+  const summary = useMemo(() => {
+    if (!data || data.length === 0) {
+      return { avgCorrelation: 0, strong: 0, medium: 0, weak: 0 };
+    }
+    const valid = data.filter(
+      (c) =>
+        Number.isFinite(c.correlation) &&
+        c.correlation >= -1 &&
+        c.correlation <= 1,
+    );
+    if (valid.length === 0) {
+      return { avgCorrelation: 0, strong: 0, medium: 0, weak: 0 };
+    }
+    const sum = valid.reduce((acc, c) => acc + c.correlation, 0);
+    const avg = sum / valid.length;
+    let strong = 0;
+    let medium = 0;
+    let weak = 0;
+    for (const c of valid) {
+      const tier = correlationToTier(c.correlation);
+      if (tier === "strong") strong++;
+      else if (tier === "medium") medium++;
+      else weak++;
+    }
+    return { avgCorrelation: avg, strong, medium, weak };
+  }, [data]);
+
+  if (loading) {
+    return <CorrelationSkeleton />;
+  }
+
+  if (error || !data || data.length === 0) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2">
+            <TrendingUp className="size-5" />
+            {t("title")}
+          </CardTitle>
+          <CardDescription>{t("description")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <EmptyState
+            icon={error ? AlertCircle : TrendingUp}
+            title={error ? t("errorTitle") : t("emptyTitle")}
+            description={error ? t("errorDescription") : t("emptyDescription")}
+            className="min-h-[300px]"
+          />
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <TrendingUp className="size-5" />
+          {t("title")}
+        </CardTitle>
+        <CardDescription>{t("description")}</CardDescription>
+      </CardHeader>
+      <CardContent className="space-y-6">
+        {/* 顶部汇总指标 */}
+        <div className="grid grid-cols-2 gap-4 md:grid-cols-4">
+          <SummaryStat
+            label={t("summaryAvgCorrelation")}
+            value={summary.avgCorrelation.toFixed(3)}
+            sublabel={t("summaryAvgCorrelationDesc")}
+          />
+          <SummaryStat
+            label={t("summaryStrong")}
+            value={String(summary.strong)}
+            valueClassName="text-emerald-600 dark:text-emerald-400"
+          />
+          <SummaryStat
+            label={t("summaryMedium")}
+            value={String(summary.medium)}
+            valueClassName="text-amber-600 dark:text-amber-400"
+          />
+          <SummaryStat
+            label={t("summaryWeak")}
+            value={String(summary.weak)}
+            valueClassName="text-destructive"
+          />
+        </div>
+
+        {/* 散点图 */}
+        {scatterData.length > 0 ? (
+          <div>
+            <h4 className="mb-3 text-sm font-medium">{t("scatterTitle")}</h4>
+            <ChartContainer config={chartConfig} className="h-[320px] w-full">
+              <ScatterChart margin={SCATTER_MARGIN}>
+                <CartesianGrid {...SCATTER_GRID_PROPS} />
+                <XAxis
+                  type="number"
+                  dataKey="attendanceRate"
+                  name={t("xAxisLabel")}
+                  domain={SCATTER_DOMAIN}
+                  tickLine={false}
+                  axisLine={false}
+                  tickMargin={8}
+                  label={{
+                    value: t("xAxisLabel"),
+                    position: "bottom",
+                    offset: 16,
+                    style: AXIS_LABEL_STYLE,
+                  }}
+                />
+                <YAxis
+                  type="number"
+                  dataKey="avgScore"
+                  name={t("yAxisLabel")}
+                  domain={SCATTER_DOMAIN}
+                  tickLine={false}
+                  axisLine={false}
+                  width={40}
+                />
+                <ZAxis type="number" range={Z_AXIS_RANGE} />
+                <ChartTooltip
+                  cursor={TOOLTIP_CURSOR}
+                  content={
+                    <ChartTooltipContent hideLabel formatter={renderTooltip} />
+                  }
+                />
+                <Scatter
+                  name={t("scatterSeries")}
+                  data={scatterData}
+                  shape="circle"
+                >
+                  {scatterData.map((entry) => (
+                    <Cell
+                      key={entry.classId}
+                      fill={
+                        CORRELATION_COLORS[correlationToTier(entry.correlation)]
+                      }
+                      fillOpacity={0.7}
+                    />
+                  ))}
+                </Scatter>
+              </ScatterChart>
+            </ChartContainer>
+            {/* 相关性强弱图例 */}
+            <div className="mt-3 flex flex-wrap items-center gap-4 text-xs">
+              {(["strong", "medium", "weak"] as const).map((tier) => (
+                <div key={tier} className="flex items-center gap-1.5">
+                  <span
+                    className="inline-block h-3 w-3 rounded-full"
+                    style={{ backgroundColor: CORRELATION_COLORS[tier] }}
+                    aria-hidden="true"
+                  />
+                  <span className="text-muted-foreground">
+                    {t(
+                      `legend${tier.charAt(0).toUpperCase()}${tier.slice(1)}` as
+                        "legendStrong" | "legendMedium" | "legendWeak",
+                    )}
+                  </span>
+                </div>
+              ))}
+            </div>
+          </div>
+        ) : (
+          <EmptyState
+            icon={AlertCircle}
+            title={t("emptyTitle")}
+            description={t("emptyDescription")}
+            className="min-h-[200px]"
+          />
+        )}
+
+        {/* 班级明细表格 */}
+        {data.length > 0 && (
+          <div>
+            <h4 className="mb-3 text-sm font-medium">{t("detailsTitle")}</h4>
+            <div className="overflow-x-auto rounded-md border">
+              <table className="w-full text-sm">
+                <thead className="border-b bg-muted/30">
+                  <tr>
+                    <th className="p-2 text-left font-medium">
+                      {t("colClass")}
+                    </th>
+                    <th className="p-2 text-right font-medium">
+                      {t("colAttendanceRate")}
+                    </th>
+                    <th className="p-2 text-right font-medium">
+                      {t("colAvgScore")}
+                    </th>
+                    <th className="p-2 text-right font-medium">
+                      {t("colCorrelation")}
+                    </th>
+                    <th className="p-2 text-center font-medium">
+                      {t("colTier")}
+                    </th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y">
+                  {data.map((item) => {
+                    const tier = correlationToTier(item.correlation);
+                    return (
+                      <tr key={item.classId} className="hover:bg-muted/30">
+                        <td className="p-2 font-medium">{item.className}</td>
+                        <td className="p-2 text-right font-mono text-xs tabular-nums">
+                          {formatPercent(item.presentRate)}
+                        </td>
+                        <td className="p-2 text-right font-mono text-xs tabular-nums">
+                          {item.avgScore.toFixed(1)}
+                        </td>
+                        <td className="p-2 text-right font-mono text-xs tabular-nums">
+                          {item.correlation.toFixed(3)}
+                        </td>
+                        <td className="p-2 text-center">
+                          {renderTierBadge(tier, t)}
+                        </td>
+                      </tr>
+                    );
+                  })}
+                </tbody>
+              </table>
+            </div>
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
+/** 关联分析卡骨架屏。 */
+function CorrelationSkeleton(): React.ReactElement {
+  return (
+    <Card>
+      <CardHeader>
+        <Skeleton className="h-5 w-40" />
+        <Skeleton className="mt-2 h-4 w-64" />
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <div className="grid grid-cols-2 gap-4 md:grid-cols-4">
+          {Array.from({ length: 4 }).map((_, i) => (
+            <Skeleton key={i} className="h-20 w-full" />
+          ))}
+        </div>
+        <Skeleton className="h-[320px] w-full" />
+        <Skeleton className="h-32 w-full" />
+      </CardContent>
+    </Card>
+  );
+}
+
+/** 汇总统计项（label + value + 可选副标题/颜色）。 */
+function SummaryStat({
+  label,
+  value,
+  sublabel,
+  valueClassName,
+}: {
+  label: string;
+  value: string;
+  sublabel?: string;
+  valueClassName?: string;
+}): React.ReactElement {
+  return (
+    <div className="rounded-lg border bg-muted/30 p-4">
+      <p className="text-xs text-muted-foreground">{label}</p>
+      <p
+        className={cn(
+          "mt-2 text-2xl font-semibold tabular-nums",
+          valueClassName,
+        )}
+      >
+        {value}
+      </p>
+      {sublabel && (
+        <p className="mt-1 text-xs text-muted-foreground">{sublabel}</p>
+      )}
+    </div>
+  );
+}
+
+/**
+ * 根据相关系数返回强弱等级。
+ * - >= 0.7 → strong（强相关）
+ * - >= 0.4 → medium（中等相关）
+ * - < 0.4  → weak（弱相关）
+ */
+function correlationToTier(correlation: number): CorrelationTier {
+  if (!Number.isFinite(correlation)) return "weak";
+  if (correlation >= CORRELATION_STRONG) return "strong";
+  if (correlation >= CORRELATION_WEAK) return "medium";
+  return "weak";
+}
+
+/**
+ * 将 0-1 的比率格式化为百分比字符串。
+ * 输入无效返回 "--"。
+ */
+function formatPercent(rate: number | null | undefined): string {
+  if (rate == null || !Number.isFinite(rate) || rate < 0 || rate > 1) {
+    return "--";
+  }
+  return `${Math.round(rate * 100)}%`;
+}
+
+/**
+ * 渲染强弱等级徽章。
+ */
+function renderTierBadge(
+  tier: CorrelationTier,
+  t: ReturnType<typeof useTranslations>,
+): React.ReactNode {
+  let label: string;
+  let className: string;
+  if (tier === "strong") {
+    label = t("badgeStrong");
+    className =
+      "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border-emerald-500/30";
+  } else if (tier === "medium") {
+    label = t("badgeMedium");
+    className =
+      "bg-amber-500/10 text-amber-600 dark:text-amber-400 border-amber-500/30";
+  } else {
+    label = t("badgeWeak");
+    className = "bg-destructive/10 text-destructive border-destructive/30";
+  }
+  return (
+    <span
+      className={cn(
+        "inline-flex items-center rounded-full border px-2 py-0.5 text-xs font-semibold",
+        className,
+      )}
+    >
+      {label}
+    </span>
+  );
+}
+
+/**
+ * recharts tooltip 格式化函数（从 unknown 转换）。
+ */
+function renderTooltip(item: unknown): React.ReactNode {
+  // item is each recharts payload entry; access .payload for the original data point
+  const data = (item as { payload?: unknown } | null | undefined)?.payload as
+    ScatterDataPoint | undefined;
+  if (!data) return null;
+  return (
+    <div className="space-y-1">
+      <div className="font-medium">{data.className}</div>
+      <div className="text-xs text-muted-foreground">
+        {data.attendanceRate}%
+      </div>
+      <div className="text-xs text-muted-foreground">{data.avgScore}</div>
+      <div className="text-xs text-muted-foreground">
+        {data.correlation.toFixed(3)}
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/attendance/attendance-records-list.tsx b/apps/portal-shell/src/features/admin/attendance/attendance-records-list.tsx
new file mode 100644
index 0000000..a8924f2
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/attendance/attendance-records-list.tsx
@@ -0,0 +1,293 @@
+"use client";
+
+/**
+ * 考勤记录列表（ARCHITECTURE.md §5.4 / §9.4 / §10 P5）
+ *
+ * 基于 CICD 项目 src/modules/attendance/components/attendance-record-list.tsx
+ * 适配到 portal-shell：Server Actions → Apollo Client + MSW 兜底。
+ *
+ * 数据契约：
+ * - adminAttendanceRecords(filter, pagination)：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * URL 分页：?page=N，page 从 1 开始；切换筛选时由父组件重置 page。
+ *
+ * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3
+ */
+import { CalendarCheck } from "lucide-react";
+import { useRouter, useSearchParams } from "next/navigation";
+import { useTransition } from "react";
+import { useTranslations } from "next-intl";
+
+import { useAdminAttendanceRecords } from "@/lib/api";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import { EmptyState } from "@/shared/components/ui/empty-state";
+import { Skeleton } from "@/shared/components/ui/skeleton";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/shared/components/ui/table";
+import { cn } from "@/shared/lib/utils";
+import {
+  attendanceStatusToBadgeClass,
+  attendanceStatusToKey,
+  formatRecordDate,
+  truncateNote,
+} from "@/features/admin/attendance/transformations";
+
+const STATUS_LABEL_KEYS: Record<
+  "present" | "absent" | "late" | "leave",
+  string
+> = {
+  present: "statusPresent",
+  absent: "statusAbsent",
+  late: "statusLate",
+  leave: "statusLeave",
+};
+
+/** 每页条数 */
+const PAGE_SIZE = 10;
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
+
+export interface AttendanceRecordsListProps {
+  classId?: string;
+  status?: string;
+  date?: string;
+  gradeId?: string;
+}
+
+export function AttendanceRecordsList({
+  classId,
+  status,
+  date,
+  gradeId,
+}: AttendanceRecordsListProps): React.ReactElement {
+  const t = useTranslations("admin.attendance.list");
+  const tCommon = useTranslations("common");
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const [, startTransition] = useTransition();
+
+  const page = Number(searchParams.get("page") ?? "1") || 1;
+
+  const filter = {
+    classId: classId || null,
+    status: status || null,
+    date: date || null,
+    gradeId: gradeId || null,
+  };
+  const { data, loading, error } = useAdminAttendanceRecords(filter, {
+    limit: PAGE_SIZE,
+    offset: (page - 1) * PAGE_SIZE,
+  });
+
+  const records = data?.items ?? [];
+  const total = data?.total ?? 0;
+  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+  const safePage = Math.min(Math.max(1, page), totalPages);
+
+  const updatePage = (next: number): void => {
+    const params = new URLSearchParams(searchParams.toString());
+    if (next > 1) {
+      params.set("page", String(next));
+    } else {
+      params.delete("page");
+    }
+    startTransition(() => {
+      router.push(`/shell/admin/attendance?${params.toString()}`);
+    });
+  };
+
+  if (loading) {
+    return (
+      <div className="rounded-xl border bg-card p-4">
+        <Skeleton className="mb-4 h-6 w-48" />
+        <div className="space-y-2">
+          {Array.from({ length: 5 }).map((_, i) => (
+            <Skeleton key={i} className="h-10 w-full" />
+          ))}
+        </div>
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
+        <p className="text-sm text-destructive">
+          {tCommon("error.loadFailed", { message: String(error) })}
+        </p>
+        <p className="mt-2 text-xs text-muted-foreground">{t("mswNotice")}</p>
+      </div>
+    );
+  }
+
+  if (records.length === 0) {
+    return (
+      <div className="rounded-xl border bg-card">
+        <EmptyState
+          icon={CalendarCheck}
+          title={t("recordsEmptyTitle")}
+          description={t("recordsEmptyDescription")}
+        />
+      </div>
+    );
+  }
+
+  return (
+    <div className="rounded-xl border bg-card">
+      <div className="flex items-center justify-between border-b px-4 py-3">
+        <div>
+          <h3 className="text-sm font-semibold">{t("recordsTitle")}</h3>
+          <p className="text-xs text-muted-foreground">
+            {t("recordsDescription")}
+          </p>
+        </div>
+        <span className="text-xs text-muted-foreground">
+          {t("recordsTotal", { count: total })}
+        </span>
+      </div>
+      <Table>
+        <TableHeader>
+          <TableRow>
+            <TableHead>{t("colStudent")}</TableHead>
+            <TableHead>{t("colClass")}</TableHead>
+            <TableHead>{t("colDate")}</TableHead>
+            <TableHead>{t("colStatus")}</TableHead>
+            <TableHead>{t("colNote")}</TableHead>
+            <TableHead>{t("colRecorder")}</TableHead>
+          </TableRow>
+        </TableHeader>
+        <TableBody>
+          {records.map((r) => {
+            const statusKey = attendanceStatusToKey(r.status);
+            const statusLabelKey = STATUS_LABEL_KEYS[statusKey];
+            return (
+              <TableRow key={r.id}>
+                <TableCell className="font-medium">{r.studentName}</TableCell>
+                <TableCell className="text-muted-foreground">
+                  {r.className}
+                </TableCell>
+                <TableCell className="text-muted-foreground">
+                  {formatRecordDate(r.date)}
+                </TableCell>
+                <TableCell>
+                  <Badge
+                    className={cn(
+                      "capitalize",
+                      attendanceStatusToBadgeClass(r.status),
+                    )}
+                  >
+                    {t(
+                      statusLabelKey as
+                        | "statusPresent"
+                        | "statusAbsent"
+                        | "statusLate"
+                        | "statusLeave",
+                    )}
+                  </Badge>
+                </TableCell>
+                <TableCell className="max-w-[240px] truncate text-muted-foreground">
+                  {truncateNote(r.note)}
+                </TableCell>
+                <TableCell className="text-muted-foreground">
+                  {r.recordedBy}
+                </TableCell>
+              </TableRow>
+            );
+          })}
+        </TableBody>
+      </Table>
+      {totalPages > 1 ? (
+        <div className="flex flex-wrap items-center justify-between gap-2 border-t px-4 py-3 text-sm text-muted-foreground">
+          <div className="flex items-center gap-3">
+            <span>{t("recordsTotal", { count: total })}</span>
+            <span className="text-xs">
+              {safePage} / {totalPages}
+            </span>
+          </div>
+          <div className="flex items-center gap-1">
+            <Button
+              variant="outline"
+              size="sm"
+              onClick={() => updatePage(Math.max(1, safePage - 1))}
+              disabled={safePage <= 1}
+              aria-label={tCommon("button.prev")}
+            >
+              {tCommon("button.prev")}
+            </Button>
+            {buildPageList(safePage, totalPages, MAX_PAGE_BUTTONS).map(
+              (p, idx) =>
+                p === "..." ? (
+                  <span
+                    key={`gap-${idx}`}
+                    className="px-2 text-xs text-muted-foreground"
+                    aria-hidden="true"
+                  >
+                    …
+                  </span>
+                ) : (
+                  <Button
+                    key={p}
+                    variant={p === safePage ? "default" : "outline"}
+                    size="sm"
+                    onClick={() => updatePage(p)}
+                    aria-current={p === safePage ? "page" : undefined}
+                  >
+                    {p}
+                  </Button>
+                ),
+            )}
+            <Button
+              variant="outline"
+              size="sm"
+              onClick={() => updatePage(Math.min(totalPages, safePage + 1))}
+              disabled={safePage >= totalPages}
+              aria-label={tCommon("button.next")}
+            >
+              {tCommon("button.next")}
+            </Button>
+          </div>
+        </div>
+      ) : null}
+    </div>
+  );
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
diff --git a/apps/portal-shell/src/features/admin/attendance/class-comparison-card.tsx b/apps/portal-shell/src/features/admin/attendance/class-comparison-card.tsx
new file mode 100644
index 0000000..20dd31d
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/attendance/class-comparison-card.tsx
@@ -0,0 +1,264 @@
+"use client";
+
+/**
+ * 班级对比卡（ARCHITECTURE.md §9.4 / §11.3 DoD 三态）
+ *
+ * 数据契约：
+ * - classComparison()：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 三态规范（§11.3 DoD）：
+ * - loading：骨架屏
+ * - error：局部降级（EmptyState + 错误文案）
+ * - data：横向柱状图 + 排名表格
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §11.3 / §11.4
+ */
+import { useEffect, useMemo } from "react";
+import { useTranslations } from "next-intl";
+import { GitCompare, AlertCircle } from "lucide-react";
+
+import { useClassComparison } from "@/lib/api";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/components/ui/card";
+import { Skeleton } from "@/shared/components/ui/skeleton";
+import { EmptyState } from "@/shared/components/ui/empty-state";
+import { SimpleBarChart, type BarSeries } from "@/shared/components/charts";
+import { notify } from "@/shared/lib/notify";
+import { cn } from "@/shared/lib/utils";
+
+/** 班级对比项（与 GET_CLASS_COMPARISON_DOC 返回结构一致） */
+interface ClassComparisonItem {
+  className: string;
+  attendanceRate: number;
+  totalStudents: number;
+  presentStudents: number;
+}
+
+/** 柱状图数据项 */
+interface BarChartData {
+  name: string;
+  rate: number;
+  [key: string]: string | number;
+}
+
+/** 出勤率阈值（0-1），用于着色分级 */
+const RATE_TIER_HIGH = 0.95;
+const RATE_TIER_MID = 0.9;
+
+/**
+ * 班级对比卡：展示多个班级的出勤率对比。
+ *
+ * 内部调用 useClassComparison hook，三态：loading / error / data。
+ * 数据态展示横向柱状图 + 排名表格 + 数据更新时间。
+ */
+export function ClassComparisonCard(): React.ReactElement {
+  const t = useTranslations("admin.attendance.classComparison");
+  const { data, loading, error } = useClassComparison();
+
+  useEffect(() => {
+    if (error) {
+      notify.error(t("errorNotification"));
+    }
+  }, [error, t]);
+
+  const sorted = useMemo<ClassComparisonItem[]>(() => {
+    if (!data) return [];
+    return [...data].sort((a, b) => b.attendanceRate - a.attendanceRate);
+  }, [data]);
+
+  const chartData = useMemo<BarChartData[]>(() => {
+    return sorted.map((item) => ({
+      name: item.className,
+      rate: Math.round(item.attendanceRate * 100),
+    }));
+  }, [sorted]);
+
+  const bars: BarSeries[] = [
+    {
+      dataKey: "rate",
+      name: t("seriesRate"),
+      color: "hsl(var(--chart-1))",
+    },
+  ];
+
+  const updatedAt = useMemo(() => {
+    return new Date().toLocaleString();
+  }, [data]);
+
+  if (loading) {
+    return <ClassComparisonSkeleton />;
+  }
+
+  if (error || !data || data.length === 0) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2">
+            <GitCompare className="size-5" />
+            {t("title")}
+          </CardTitle>
+          <CardDescription>{t("description")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <EmptyState
+            icon={error ? AlertCircle : GitCompare}
+            title={error ? t("errorTitle") : t("emptyTitle")}
+            description={error ? t("errorDescription") : t("emptyDescription")}
+            className="min-h-[300px]"
+          />
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <GitCompare className="size-5" />
+          {t("title")}
+        </CardTitle>
+        <CardDescription>
+          {t("description")}
+          <span className="ml-2 text-xs text-muted-foreground">
+            {t("updatedAt", { time: updatedAt })}
+          </span>
+        </CardDescription>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <SimpleBarChart
+          data={chartData}
+          bars={bars}
+          xKey="name"
+          yDomain={[0, 100]}
+          yTickFormatter={(v) => `${v}%`}
+          heightClassName="h-[280px]"
+        />
+
+        <div className="overflow-x-auto rounded-md border">
+          <table className="w-full text-sm">
+            <thead className="border-b bg-muted/30">
+              <tr>
+                <th className="w-12 p-2 text-left font-medium">
+                  {t("colRank")}
+                </th>
+                <th className="p-2 text-left font-medium">{t("colClass")}</th>
+                <th className="p-2 text-right font-medium">{t("colTotal")}</th>
+                <th className="p-2 text-right font-medium">
+                  {t("colPresent")}
+                </th>
+                <th className="p-2 text-right font-medium">{t("colRate")}</th>
+                <th className="p-2 text-center font-medium">{t("colBadge")}</th>
+              </tr>
+            </thead>
+            <tbody className="divide-y">
+              {sorted.map((item, idx) => (
+                <tr key={item.className} className="hover:bg-muted/30">
+                  <td className="p-2 font-medium tabular-nums">{idx + 1}</td>
+                  <td className="p-2 font-medium">{item.className}</td>
+                  <td className="p-2 text-right tabular-nums">
+                    {item.totalStudents}
+                  </td>
+                  <td className="p-2 text-right tabular-nums">
+                    {item.presentStudents}
+                  </td>
+                  <td
+                    className={cn(
+                      "p-2 text-right font-mono text-xs tabular-nums",
+                      rateToColorClass(item.attendanceRate),
+                    )}
+                  >
+                    {formatPercent(item.attendanceRate)}
+                  </td>
+                  <td className="p-2 text-center">
+                    {renderRateBadge(item.attendanceRate, t)}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </CardContent>
+    </Card>
+  );
+}
+
+/** 班级对比卡骨架屏。 */
+function ClassComparisonSkeleton(): React.ReactElement {
+  return (
+    <Card>
+      <CardHeader>
+        <Skeleton className="h-5 w-40" />
+        <Skeleton className="mt-2 h-4 w-64" />
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <Skeleton className="h-[280px] w-full" />
+        <Skeleton className="h-32 w-full" />
+      </CardContent>
+    </Card>
+  );
+}
+
+/**
+ * 将 0-1 的出勤率格式化为百分比字符串。
+ * 输入无效返回 "--"。
+ */
+function formatPercent(rate: number | null | undefined): string {
+  if (rate == null || !Number.isFinite(rate) || rate < 0 || rate > 1) {
+    return "--";
+  }
+  return `${(rate * 100).toFixed(1)}%`;
+}
+
+/**
+ * 根据出勤率（0-1）返回 Tailwind 文本语义类名。
+ * - >= 0.95 → emerald（优秀）
+ * - >= 0.9  → amber（一般）
+ * - 其他    → destructive（低出勤率）
+ */
+function rateToColorClass(rate: number | null | undefined): string {
+  if (rate == null || !Number.isFinite(rate) || rate < 0 || rate > 1) {
+    return "text-muted-foreground";
+  }
+  if (rate >= RATE_TIER_HIGH) return "text-emerald-600 dark:text-emerald-400";
+  if (rate >= RATE_TIER_MID) return "text-amber-600 dark:text-amber-400";
+  return "text-destructive";
+}
+
+/**
+ * 根据出勤率渲染排名徽章。
+ */
+function renderRateBadge(
+  rate: number,
+  t: ReturnType<typeof useTranslations>,
+): React.ReactNode {
+  let label: string;
+  let className: string;
+  if (rate >= RATE_TIER_HIGH) {
+    label = t("badgeHigh");
+    className =
+      "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border-emerald-500/30";
+  } else if (rate >= RATE_TIER_MID) {
+    label = t("badgeMid");
+    className =
+      "bg-amber-500/10 text-amber-600 dark:text-amber-400 border-amber-500/30";
+  } else {
+    label = t("badgeLow");
+    className = "bg-destructive/10 text-destructive border-destructive/30";
+  }
+  return (
+    <span
+      className={cn(
+        "inline-flex items-center rounded-full border px-2 py-0.5 text-xs font-semibold",
+        className,
+      )}
+    >
+      {label}
+    </span>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-log-detail-dialog.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-log-detail-dialog.tsx
new file mode 100644
index 0000000..143af49
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-log-detail-dialog.tsx
@@ -0,0 +1,177 @@
+"use client";
+
+/**
+ * 审计日志详情对话框（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 数据契约：纯展示组件，复用列表页已加载的 AuditLog / LoginLog / DataChangeLog 数据。
+ * 不发起新查询，避免契约未就绪时的二次 MSW 兜底。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ * 迁移自 CICD src/modules/audit/components/audit-log-detail-dialog.tsx
+ */
+import { useState, type ReactNode } from "react";
+import { useTranslations } from "next-intl";
+import { Eye } from "lucide-react";
+
+import type { AuditLog, LoginLog, DataChangeLog } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/shared/components/ui/dialog";
+import {
+  auditActionToLabel,
+  auditStatusToLabel,
+  dataChangeActionToLabel,
+  formatAuditTimestamp,
+  loginActionToLabel,
+  loginStatusToLabel,
+} from "@/features/admin/audit-logs/transformations";
+
+type AuditLogItem = {
+  type: "audit";
+  item: AuditLog;
+  trigger?: ReactNode;
+};
+
+type LoginLogItem = {
+  type: "login";
+  item: LoginLog;
+  trigger?: ReactNode;
+};
+
+type DataChangeLogItem = {
+  type: "dataChange";
+  item: DataChangeLog;
+  trigger?: ReactNode;
+};
+
+export type AuditLogDetailDialogProps =
+  AuditLogItem | LoginLogItem | DataChangeLogItem;
+
+interface DetailRowProps {
+  label: string;
+  value: unknown;
+}
+
+function DetailRow({ label, value }: DetailRowProps): ReactNode {
+  const display =
+    value === null || value === undefined
+      ? "--"
+      : typeof value === "string"
+        ? value
+        : typeof value === "number" || typeof value === "boolean"
+          ? String(value)
+          : JSON.stringify(value, null, 2);
+  return (
+    <div className="grid grid-cols-3 gap-2 border-b border-border py-2 last:border-0">
+      <dt className="text-sm font-medium text-muted-foreground">{label}</dt>
+      <dd className="col-span-2 break-all text-sm">{display}</dd>
+    </div>
+  );
+}
+
+export function AuditLogDetailDialog(
+  props: AuditLogDetailDialogProps,
+): React.ReactElement {
+  const t = useTranslations("admin.auditLogs.detail");
+  const [open, setOpen] = useState<boolean>(false);
+
+  const renderRows = (): ReactNode => {
+    if (props.type === "audit") {
+      const log = props.item;
+      return (
+        <>
+          <DetailRow label={t("userId")} value={log.userId} />
+          <DetailRow label={t("userName")} value={log.userName} />
+          <DetailRow
+            label={t("action")}
+            value={auditActionToLabel(log.action)}
+          />
+          <DetailRow label={t("module")} value={log.resource} />
+          <DetailRow label={t("resourceId")} value={log.resourceId} />
+          <DetailRow label={t("ipAddress")} value={log.ip} />
+          <DetailRow
+            label={t("status")}
+            value={auditStatusToLabel(log.status ?? "")}
+          />
+          <DetailRow label={t("errorMessage")} value={log.errorMessage} />
+          <DetailRow label={t("details")} value={log.details} />
+          <DetailRow
+            label={t("createdAt")}
+            value={formatAuditTimestamp(log.timestamp)}
+          />
+        </>
+      );
+    }
+    if (props.type === "login") {
+      const log = props.item;
+      return (
+        <>
+          <DetailRow label={t("userId")} value={log.userId} />
+          <DetailRow label={t("userName")} value={log.userName} />
+          <DetailRow
+            label={t("action")}
+            value={loginActionToLabel(log.action)}
+          />
+          <DetailRow
+            label={t("status")}
+            value={loginStatusToLabel(log.status)}
+          />
+          <DetailRow label={t("ipAddress")} value={log.ip} />
+          <DetailRow label={t("userAgent")} value={log.userAgent} />
+          <DetailRow label={t("errorMessage")} value={log.errorMessage} />
+          <DetailRow
+            label={t("createdAt")}
+            value={formatAuditTimestamp(log.timestamp)}
+          />
+        </>
+      );
+    }
+    const log = props.item;
+    return (
+      <>
+        <DetailRow label={t("tableName")} value={log.tableName} />
+        <DetailRow label={t("recordId")} value={log.recordId} />
+        <DetailRow
+          label={t("action")}
+          value={dataChangeActionToLabel(log.action)}
+        />
+        <DetailRow label={t("userId")} value={log.userId} />
+        <DetailRow label={t("userName")} value={log.userName} />
+        <DetailRow label={t("changes")} value={log.changes} />
+        <DetailRow label={t("oldValue")} value={log.oldValue} />
+        <DetailRow label={t("newValue")} value={log.newValue} />
+        <DetailRow
+          label={t("createdAt")}
+          value={formatAuditTimestamp(log.timestamp)}
+        />
+      </>
+    );
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        {props.trigger ?? (
+          <Button variant="ghost" size="sm" aria-label={t("viewDetail")}>
+            <Eye className="size-4" />
+          </Button>
+        )}
+      </DialogTrigger>
+      <DialogContent className="max-h-[80vh] max-w-lg overflow-y-auto">
+        <DialogHeader>
+          <DialogTitle>{t("title")}</DialogTitle>
+          <DialogDescription className="sr-only">
+            {t("description")}
+          </DialogDescription>
+        </DialogHeader>
+        <dl className="mt-2">{renderRows()}</dl>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-log-export-button.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-log-export-button.tsx
new file mode 100644
index 0000000..11561ae
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-log-export-button.tsx
@@ -0,0 +1,72 @@
+"use client";
+
+import { Download, Loader2 } from "lucide-react";
+import { useTranslations } from "next-intl";
+import { useState } from "react";
+
+import type { ExportResult } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+import { downloadCsv } from "@/features/admin/audit-logs/transformations";
+
+interface AuditLogExportButtonProps<TFilter> {
+  runExport: (filter: TFilter) => Promise<ExportResult>;
+  filter: TFilter;
+  loading: boolean;
+  namespace: string;
+  labelKey?: string;
+}
+
+export function AuditLogExportButton<TFilter>(
+  props: AuditLogExportButtonProps<TFilter>,
+): React.ReactElement {
+  const {
+    runExport,
+    filter,
+    loading,
+    namespace,
+    labelKey = "exportCsv",
+  } = props;
+  const t = useTranslations(namespace);
+  const tCommon = useTranslations("common");
+  const [exporting, setExporting] = useState(false);
+
+  const handleExport = async (): Promise<void> => {
+    setExporting(true);
+    try {
+      const result = await runExport(filter);
+      if (result.count === 0) {
+        notify.info(t("exportEmpty"));
+        return;
+      }
+      const ok = downloadCsv(result.filename, result.csv);
+      if (ok) {
+        notify.success(t("exportSuccess", { count: result.count }));
+      } else {
+        notify.error(tCommon("error.loadFailed", { message: "" }));
+      }
+    } catch (err) {
+      notify.error(t("exportFailed", { message: String(err) }));
+    } finally {
+      setExporting(false);
+    }
+  };
+
+  const isLoading = loading || exporting;
+
+  return (
+    <Button
+      onClick={handleExport}
+      variant="outline"
+      size="sm"
+      disabled={isLoading}
+    >
+      {isLoading ? (
+        <Loader2 className="size-4 animate-spin" />
+      ) : (
+        <Download className="size-4" />
+      )}
+      {t(labelKey)}
+    </Button>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-logs-list-client.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-logs-list-client.tsx
index ec98fea..fae251f 100644
--- a/apps/portal-shell/src/features/admin/audit-logs/audit-logs-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-logs-list-client.tsx
@@ -13,12 +13,17 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { ClipboardList, Download } from "lucide-react";
+import { ClipboardList, Eye, RotateCcw } from "lucide-react";
 import { useRouter, useSearchParams } from "next/navigation";
 import { useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAuditLogs, useAuditModuleOptions } from "@/lib/api";
+import type { AuditLog } from "@/lib/api";
+import {
+  useAuditLogs,
+  useAuditModuleOptions,
+  useExportAuditLogs,
+} from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import {
@@ -29,13 +34,12 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { notify } from "@/shared/lib/notify";
+import { AuditLogDetailDialog } from "@/features/admin/audit-logs/audit-log-detail-dialog";
+import { AuditLogExportButton } from "@/features/admin/audit-logs/audit-log-export-button";
 import {
   auditActionToLabel,
-  auditLogsToCsv,
   auditStatusToBadgeClass,
   auditStatusToLabel,
-  downloadCsv,
   formatAuditTimestamp,
 } from "@/features/admin/audit-logs/transformations";
 
@@ -57,6 +61,9 @@ const ACTION_OPTIONS = [
 /** 每页条数 */
 const PAGE_SIZE = 20;
 
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
+
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
  * （useSearchParams 要求 Suspense 边界，Next.js 15 强制）。
@@ -92,6 +99,9 @@ export function AuditLogsListClient(): React.ReactElement {
 
   const items = data?.items ?? [];
 
+  // 导出 hook（@contract-pending MSW 兜底，CSV 由 MSW 构造返回）
+  const { run: runExport, loading: exporting } = useExportAuditLogs();
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -107,20 +117,20 @@ export function AuditLogsListClient(): React.ReactElement {
     });
   };
 
-  const handleExport = (): void => {
-    try {
-      const csv = auditLogsToCsv(items);
-      const ok = downloadCsv(`audit-logs-${Date.now()}.csv`, csv);
-      if (ok) {
-        notify.success(t("exportCsv"));
-      } else {
-        notify.error(tCommon("error.loadFailed", { message: "" }));
-      }
-    } catch (err) {
-      notify.error(tCommon("error.loadFailed", { message: String(err) }));
-    }
+  const resetFilters = (): void => {
+    startTransition(() => {
+      router.push("/shell/admin/audit-logs");
+    });
   };
 
+  const hasFilters =
+    Boolean(moduleFilter) ||
+    Boolean(actionFilter) ||
+    Boolean(statusFilter) ||
+    Boolean(userId) ||
+    Boolean(startDate) ||
+    Boolean(endDate);
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -148,10 +158,16 @@ export function AuditLogsListClient(): React.ReactElement {
       description={t("description")}
       icon={<ClipboardList className="size-6" />}
       actions={
-        <Button onClick={handleExport} variant="outline" size="sm">
-          <Download className="size-4" />
-          {t("exportCsv")}
-        </Button>
+        <AuditLogExportButton
+          runExport={runExport}
+          filter={{
+            userId: userId || null,
+            action: actionFilter || null,
+            resource: moduleFilter || null,
+          }}
+          loading={exporting}
+          namespace="admin.auditLogs.list"
+        />
       }
       filters={
         <FilterBar variant="wrap">
@@ -213,6 +229,18 @@ export function AuditLogsListClient(): React.ReactElement {
             aria-label={t("endDate")}
             className="h-9 rounded-md border border-input bg-background px-3 text-sm"
           />
+          {hasFilters ? (
+            <Button
+              variant="ghost"
+              size="sm"
+              onClick={resetFilters}
+              className="h-9"
+              aria-label={t("resetFilter")}
+            >
+              <RotateCcw className="size-4" />
+              {t("resetFilter")}
+            </Button>
+          ) : null}
         </FilterBar>
       }
       loading={loading}
@@ -221,9 +249,12 @@ export function AuditLogsListClient(): React.ReactElement {
       emptyNode={emptyNode}
       errorNode={errorNode}
       pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: data?.total ?? 0 })}</span>
-        </div>
+        <Pagination
+          page={page}
+          pageSize={PAGE_SIZE}
+          total={data?.total ?? 0}
+          onJump={(p) => updateQuery("page", String(p))}
+        />
       }
     >
       <AuditLogsTable items={items} />
@@ -233,21 +264,12 @@ export function AuditLogsListClient(): React.ReactElement {
 
 /**
  * 审计日志列表表格（纯展示组件，对齐 §8.2 排版规范）。
+ * 末列追加"查看详情"按钮，复用 AuditLogDetailDialog 弹窗。
  */
 function AuditLogsTable({
   items,
 }: {
-  items: ReadonlyArray<{
-    id: string;
-    userId: string;
-    userName: string;
-    action: string;
-    resource: string;
-    resourceId: string;
-    ip: string;
-    timestamp: string;
-    details: string;
-  }>;
+  items: ReadonlyArray<AuditLog>;
 }): React.ReactElement {
   const t = useTranslations("admin.auditLogs.list");
   return (
@@ -263,6 +285,7 @@ function AuditLogsTable({
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
             <th className="p-3 text-left font-medium">{t("colIp")}</th>
             <th className="p-3 text-left font-medium">{t("colDetails")}</th>
+            <th className="p-3 text-left font-medium">{t("colActions")}</th>
           </tr>
         </thead>
         <tbody className="divide-y">
@@ -278,12 +301,27 @@ function AuditLogsTable({
               <td className="p-3 text-muted-foreground">{log.resource}</td>
               <td className="p-3">{auditActionToLabel(log.action)}</td>
               <td className="p-3">
-                <StatusBadge status={log.details ? "success" : ""} />
+                <StatusBadge status={log.status} />
               </td>
               <td className="p-3 font-mono text-xs text-muted-foreground">
                 {log.ip}
               </td>
               <td className="p-3 text-muted-foreground">{log.details}</td>
+              <td className="p-3">
+                <AuditLogDetailDialog
+                  type="audit"
+                  item={log}
+                  trigger={
+                    <Button
+                      variant="ghost"
+                      size="sm"
+                      aria-label={t("colActions")}
+                    >
+                      <Eye className="size-4" />
+                    </Button>
+                  }
+                />
+              </td>
             </tr>
           ))}
         </tbody>
@@ -294,18 +332,129 @@ function AuditLogsTable({
 
 /**
  * 状态徽章（按状态色阶展示）。
- * AuditLog 类型无独立 status 字段，根据 details 是否存在做基础推断，
- * 真实契约补齐后切换为 log.status。
+ * 真实契约补齐前 status 字段可能为 undefined/null，此时显示 "--" 占位符，
+ * 不再使用 details 字段虚假推断状态（违反数据真实性原则）。
  */
-function StatusBadge({ status }: { status: string }): React.ReactElement {
-  const t = useTranslations("admin.auditLogs.list");
-  const label = status ? auditStatusToLabel(status) : "--";
-  const cls = auditStatusToBadgeClass(status || "unknown");
+function StatusBadge({
+  status,
+}: {
+  status: string | null | undefined;
+}): React.ReactElement {
+  const safeStatus = status ?? "";
+  const label = safeStatus ? auditStatusToLabel(safeStatus) : "--";
+  const cls = auditStatusToBadgeClass(safeStatus || "unknown");
   return (
     <span
       className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${cls}`}
     >
-      {label === "--" ? t("allStatuses") : label}
+      {label}
     </span>
   );
 }
+
+/**
+ * 分页组件（页码列表 + 跳转按钮 + total/totalPages 显示）。
+ * 依赖 URL ?page=N 状态，由父组件控制路由跳转。
+ * 页码按钮策略：当 totalPages ≤ MAX_PAGE_BUTTONS 时全量展示；
+ * 超过时展示首尾页 + 当前页附近的页码（含省略号占位）。
+ */
+function Pagination({
+  page,
+  pageSize,
+  total,
+  onJump,
+}: {
+  page: number;
+  pageSize: number;
+  total: number;
+  onJump: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.auditLogs.list");
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const canPrev = page > 1;
+  const canNext = page < totalPages;
+
+  const pages = buildPageList(page, totalPages, MAX_PAGE_BUTTONS);
+
+  return (
+    <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+      <div className="flex items-center gap-3">
+        <span>{t("total", { count: total })}</span>
+        <span className="text-xs">{t("pageOf", { page, totalPages })}</span>
+      </div>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.max(1, page - 1))}
+          disabled={!canPrev}
+          aria-label={tCommon("button.prev")}
+        >
+          {tCommon("button.prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "..." ? (
+            <span
+              key={`gap-${idx}`}
+              className="px-2 text-xs text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === page ? "default" : "outline"}
+              size="sm"
+              onClick={() => onJump(p)}
+              aria-current={p === page ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.min(totalPages, page + 1))}
+          disabled={!canNext}
+          aria-label={tCommon("button.next")}
+        >
+          {tCommon("button.next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-logs-pagination.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-logs-pagination.tsx
new file mode 100644
index 0000000..9f8700e
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-logs-pagination.tsx
@@ -0,0 +1,125 @@
+"use client";
+
+/**
+ * 审计日志分页组件（ARCHITECTURE.md §7.3 列表页 / §11.3 DoD）
+ *
+ * 共享分页组件，供 audit-logs / login-logs / data-changes 列表页复用。
+ * 依赖 URL ?page=N 状态，由父组件控制路由跳转。
+ *
+ * 页码按钮策略：当 totalPages ≤ MAX_PAGE_BUTTONS 时全量展示；
+ * 超过时展示首尾页 + 当前页附近的页码（含省略号占位）。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §11.3 / §11.4
+ */
+import { useTranslations } from "next-intl";
+
+import { Button } from "@/shared/components/ui/button";
+
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
+
+interface AuditLogsPaginationProps {
+  page: number;
+  pageSize: number;
+  total: number;
+  onJump: (page: number) => void;
+  /** next-intl 命名空间，需包含 total / pageOf 键 */
+  namespace: string;
+}
+
+/**
+ * 审计日志分页组件（页码列表 + 跳转按钮 + total/totalPages 显示）。
+ */
+export function AuditLogsPagination(
+  props: AuditLogsPaginationProps,
+): React.ReactElement {
+  const { page, pageSize, total, onJump, namespace } = props;
+  const t = useTranslations(namespace);
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const canPrev = page > 1;
+  const canNext = page < totalPages;
+
+  const pages = buildPageList(page, totalPages, MAX_PAGE_BUTTONS);
+
+  return (
+    <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+      <div className="flex items-center gap-3">
+        <span>{t("total", { count: total })}</span>
+        <span className="text-xs">{t("pageOf", { page, totalPages })}</span>
+      </div>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.max(1, page - 1))}
+          disabled={!canPrev}
+          aria-label={tCommon("button.prev")}
+        >
+          {tCommon("button.prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "..." ? (
+            <span
+              key={`gap-${idx}`}
+              className="px-2 text-xs text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === page ? "default" : "outline"}
+              size="sm"
+              onClick={() => onJump(p)}
+              aria-current={p === page ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.min(totalPages, page + 1))}
+          disabled={!canNext}
+          aria-label={tCommon("button.next")}
+        >
+          {tCommon("button.next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-overview-client.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-overview-client.tsx
index 2b04106..50fe429 100644
--- a/apps/portal-shell/src/features/admin/audit-logs/audit-overview-client.tsx
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-overview-client.tsx
@@ -9,11 +9,21 @@
  * - dataChangeActionStats()：❌ schema 无 → MSW 兜底
  *
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty
+ * 区块级错误边界：stats / trend / distribution / retention 各自包 SectionErrorBoundary，
+ * 单点渲染失败不影响其他区块。
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { BarChart3 } from "lucide-react";
+import Link from "next/link";
+import {
+  Activity,
+  AlertTriangle,
+  Database,
+  FileText,
+  KeyRound,
+} from "lucide-react";
 import { useTranslations } from "next-intl";
+import type { ReactNode } from "react";
 
 import {
   useAuditOverviewStats,
@@ -26,6 +36,9 @@ import {
   DetailPageShell,
   DetailPageSkeleton,
 } from "@/shared/components/page-templates";
+import { SectionErrorBoundary } from "@/shared/components/section-error-boundary";
+import { ChartCardShell } from "@/shared/components/charts/chart-card-shell";
+import { AuditRetentionSettings } from "@/features/admin/audit-logs/audit-retention-settings";
 import {
   dataChangeActionToLabel,
   formatAuditDate,
@@ -47,24 +60,18 @@ export function AuditOverviewClient(): React.ReactElement {
     loading: statsLoading,
     error: statsError,
   } = useAuditOverviewStats();
-  const { data: trend, loading: trendLoading } = useAuditTrend(7);
-  const { data: distribution, loading: distLoading } =
-    useDataChangeActionStats();
+  const {
+    data: trend,
+    loading: trendLoading,
+    error: trendError,
+  } = useAuditTrend(7);
+  const {
+    data: distribution,
+    loading: distLoading,
+    error: distError,
+  } = useDataChangeActionStats();
 
   const isLoading = statsLoading || trendLoading || distLoading;
-  const hasError = Boolean(statsError);
-
-  if (hasError) {
-    return (
-      <DetailPageShell title={t("title")} description={t("description")}>
-        <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
-          <p className="text-sm text-destructive">
-            {tCommon("error.loadFailed", { message: String(statsError) })}
-          </p>
-        </div>
-      </DetailPageShell>
-    );
-  }
 
   if (isLoading) {
     return (
@@ -78,75 +85,179 @@ export function AuditOverviewClient(): React.ReactElement {
   const distData = distribution ?? [];
   const distTotal = getDistributionTotal(distData);
   const maxCount = getMaxTrendCount(trendData);
+  const failedLoginsToday = stats?.failedLoginsToday ?? 0;
 
   return (
     <DetailPageShell title={t("title")} description={t("description")}>
-      {/* 统计卡片 */}
-      <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
-        <StatCard
-          title={t("statsTotal")}
-          value={stats?.totalLogs ?? 0}
-          icon={BarChart3}
+      {/* 统计卡片：4 张分别对应 auditEventsToday / failedLoginsToday / dataChangesToday / totalAuditLogs */}
+      <SectionErrorBoundary title={t("sectionError")}>
+        {statsError ? (
+          <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
+            <p className="text-sm text-destructive">
+              {tCommon("error.loadFailed", { message: String(statsError) })}
+            </p>
+          </div>
+        ) : (
+          <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
+            <StatCard
+              title={t("auditEventsToday")}
+              value={stats?.auditEventsToday ?? 0}
+              icon={Activity}
+              href="/shell/admin/audit-logs"
+              description={t("quickLinkAuditLogsDesc")}
+              valueClassName="text-blue-600 dark:text-blue-400"
+            />
+            <StatCard
+              title={t("failedLoginsToday")}
+              value={failedLoginsToday}
+              icon={AlertTriangle}
+              href="/shell/admin/audit-logs/login-logs"
+              description={t("quickLinkLoginLogsDesc")}
+              highlight={failedLoginsToday > 0}
+              valueClassName="text-red-600 dark:text-red-400"
+            />
+            <StatCard
+              title={t("dataChangesToday")}
+              value={stats?.dataChangesToday ?? 0}
+              icon={Database}
+              href="/shell/admin/audit-logs/data-changes"
+              description={t("quickLinkDataChangesDesc")}
+              valueClassName="text-emerald-600 dark:text-emerald-400"
+            />
+            <StatCard
+              title={t("totalAuditLogs")}
+              value={stats?.totalLogs ?? 0}
+              icon={FileText}
+              href="/shell/admin/audit-logs"
+              description={t("sectionStats")}
+              valueClassName="text-purple-600 dark:text-purple-400"
+            />
+          </div>
+        )}
+      </SectionErrorBoundary>
+
+      {/* 快捷入口卡片 */}
+      <div className="grid grid-cols-1 gap-4 md:grid-cols-3">
+        <QuickLinkCard
+          href="/shell/admin/audit-logs"
+          icon={<FileText className="size-5" />}
+          title={t("quickLinkAuditLogs")}
+          description={t("quickLinkAuditLogsDesc")}
         />
-        <StatCard
-          title={t("statsToday")}
-          value={stats?.totalToday ?? 0}
-          icon={BarChart3}
+        <QuickLinkCard
+          href="/shell/admin/audit-logs/login-logs"
+          icon={<KeyRound className="size-5" />}
+          title={t("quickLinkLoginLogs")}
+          description={t("quickLinkLoginLogsDesc")}
         />
-        <StatCard
-          title={t("statsErrors")}
-          value={stats?.totalErrors ?? 0}
-          icon={BarChart3}
-        />
-        <StatCard
-          title={t("statsUsers")}
-          value={stats?.totalUsers ?? 0}
-          icon={BarChart3}
+        <QuickLinkCard
+          href="/shell/admin/audit-logs/data-changes"
+          icon={<Database className="size-5" />}
+          title={t("quickLinkDataChanges")}
+          description={t("quickLinkDataChangesDesc")}
         />
       </div>
 
       {/* 近 7 天趋势 - 简易柱状图 */}
-      <Card>
-        <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">{t("trendTitle")}</h2>
-          {trendData.length === 0 ? (
-            <p className="py-8 text-center text-sm text-muted-foreground">
-              {t("emptyTrend")}
-            </p>
-          ) : (
+      <SectionErrorBoundary title={t("sectionError")}>
+        {trendError ? (
+          <ChartErrorCard title={t("trendTitle")} error={trendError} />
+        ) : (
+          <ChartCardShell
+            title={t("trendTitle")}
+            isEmpty={trendData.length === 0}
+            emptyTitle={t("chartEmpty")}
+            emptyDescription={t("chartEmpty")}
+          >
             <TrendBarChart
               data={trendData}
               maxCount={maxCount}
               labelLast7={t("trendLast7Days")}
             />
-          )}
-        </CardContent>
-      </Card>
+          </ChartCardShell>
+        )}
+      </SectionErrorBoundary>
 
       {/* 数据变更动作分布 - 简易饼图 */}
-      <Card>
-        <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">
-            {t("distributionTitle")}
-          </h2>
-          {distData.length === 0 ? (
-            <p className="py-8 text-center text-sm text-muted-foreground">
-              {t("emptyTrend")}
-            </p>
-          ) : (
+      <SectionErrorBoundary title={t("sectionError")}>
+        {distError ? (
+          <ChartErrorCard title={t("distributionTitle")} error={distError} />
+        ) : (
+          <ChartCardShell
+            title={t("distributionTitle")}
+            isEmpty={distData.length === 0}
+            emptyTitle={t("chartEmpty")}
+            emptyDescription={t("chartEmpty")}
+          >
             <DistributionChart
               data={distData}
               total={distTotal}
               colAction={t("distributionAction")}
               colCount={t("distributionCount")}
             />
-          )}
-        </CardContent>
-      </Card>
+          </ChartCardShell>
+        )}
+      </SectionErrorBoundary>
+
+      {/* 保留策略设置 */}
+      <SectionErrorBoundary title={t("sectionError")}>
+        <AuditRetentionSettings />
+      </SectionErrorBoundary>
     </DetailPageShell>
   );
 }
 
+/**
+ * 图表错误卡片：区块级错误时展示标题 + 错误信息。
+ * 替代旧版本地 ChartCardShell 的 error 分支。
+ */
+function ChartErrorCard({
+  title,
+  error,
+}: {
+  title: string;
+  error: unknown;
+}): React.ReactElement {
+  return (
+    <Card>
+      <CardContent className="p-6">
+        <h2 className="mb-4 text-lg font-semibold">{title}</h2>
+        <p className="py-8 text-center text-sm text-destructive">
+          {String(error)}
+        </p>
+      </CardContent>
+    </Card>
+  );
+}
+
+/**
+ * 快捷入口卡片（hover 动画）。
+ */
+function QuickLinkCard({
+  href,
+  icon,
+  title,
+  description,
+}: {
+  href: string;
+  icon: ReactNode;
+  title: string;
+  description: string;
+}): React.ReactElement {
+  return (
+    <Link
+      href={href}
+      className="group block rounded-xl border bg-card p-5 transition-all hover:border-primary/40 hover:shadow-md"
+    >
+      <div className="mb-3 inline-flex size-10 items-center justify-center rounded-lg bg-primary/10 text-primary transition-transform group-hover:scale-110">
+        {icon}
+      </div>
+      <h3 className="mb-1 text-base font-semibold">{title}</h3>
+      <p className="text-sm text-muted-foreground">{description}</p>
+    </Link>
+  );
+}
+
 /**
  * 趋势柱状图（纯 CSS 实现，不引入图表库）。
  */
diff --git a/apps/portal-shell/src/features/admin/audit-logs/audit-retention-settings.tsx b/apps/portal-shell/src/features/admin/audit-logs/audit-retention-settings.tsx
new file mode 100644
index 0000000..b4ac775
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/audit-logs/audit-retention-settings.tsx
@@ -0,0 +1,233 @@
+"use client";
+
+/**
+ * 审计日志保留期设置卡（ARCHITECTURE.md §9.4 / §10 P5）
+ *
+ * 数据契约：
+ * - getAuditRetentionConfig()：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - saveAuditRetentionConfig(input)：❌ schema 无 → MSW 兜底
+ * - purgeExpiredAuditLogs(days)：❌ schema 无 → MSW 兜底
+ *
+ * 功能：
+ * - 配置审计日志保留天数（MIN_RETENTION_DAYS ~ MAX_RETENTION_DAYS）
+ * - 配置登录日志独立保留天数（默认 365 天，用于安全取证）
+ * - 自动清理开关
+ * - 手动触发清理（含确认弹窗）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5 / §11.3 / §11.4
+ * 迁移自 CICD src/modules/audit/components/audit-retention-settings.tsx
+ */
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+import { Loader2, Save, Trash2 } from "lucide-react";
+
+import type { AuditRetentionConfig } from "@/lib/api";
+import {
+  useAuditRetentionConfig,
+  useSaveAuditRetentionConfig,
+  usePurgeExpiredAuditLogs,
+} from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/components/ui/card";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Switch } from "@/shared/components/ui/switch";
+import { notify } from "@/shared/lib/notify";
+
+export const MIN_RETENTION_DAYS = 7;
+export const MAX_RETENTION_DAYS = 3650;
+export const DEFAULT_RETENTION_DAYS = 90;
+export const DEFAULT_LOGIN_LOG_RETENTION_DAYS = 365;
+
+export function AuditRetentionSettings(): React.ReactElement {
+  const t = useTranslations("admin.auditLogs.retention");
+  const tCommon = useTranslations("common");
+
+  const { data: loadedConfig, loading: isLoading } = useAuditRetentionConfig();
+  const { run: saveConfig, loading: isSaving } = useSaveAuditRetentionConfig();
+  const { run: purgeLogs, loading: isPurging } = usePurgeExpiredAuditLogs();
+
+  const [config, setConfig] = useState<AuditRetentionConfig | null>(null);
+
+  // 同步加载的配置到本地状态
+  useEffect(() => {
+    if (loadedConfig) {
+      setConfig(loadedConfig);
+    }
+  }, [loadedConfig]);
+
+  const handleSave = async (): Promise<void> => {
+    if (!config) return;
+    try {
+      await saveConfig(config);
+      notify.success(t("saveSuccess"));
+    } catch (err: unknown) {
+      notify.error(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  const handlePurge = async (): Promise<void> => {
+    if (!config) return;
+    const confirmed = window.confirm(t("purgeConfirm"));
+    if (!confirmed) return;
+    try {
+      const result = await purgeLogs(
+        config.retentionDays,
+        config.loginLogRetentionDays,
+      );
+      notify.success(
+        t("purgeSuccess", {
+          auditLogsDeleted: result.auditLogsDeleted,
+          loginLogsDeleted: result.loginLogsDeleted,
+          dataChangeLogsDeleted: result.dataChangeLogsDeleted,
+        }),
+      );
+    } catch (err: unknown) {
+      notify.error(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  if (isLoading) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle>{t("title")}</CardTitle>
+          <CardDescription>{t("description")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="flex items-center gap-2 text-muted-foreground">
+            <Loader2 className="size-4 animate-spin" />
+          </div>
+        </CardContent>
+      </Card>
+    );
+  }
+
+  if (!config) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle>{t("title")}</CardTitle>
+          <CardDescription>{t("description")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <p className="text-sm text-muted-foreground">{t("loadFailed")}</p>
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>{t("title")}</CardTitle>
+        <CardDescription>{t("description")}</CardDescription>
+      </CardHeader>
+      <CardContent className="space-y-6">
+        {/* 审计日志保留天数 */}
+        <div className="space-y-2">
+          <Label htmlFor="retentionDays">{t("retentionDays")}</Label>
+          <Input
+            id="retentionDays"
+            type="number"
+            min={MIN_RETENTION_DAYS}
+            max={MAX_RETENTION_DAYS}
+            value={config.retentionDays}
+            onChange={(e) => {
+              const val = Number(e.target.value);
+              if (Number.isFinite(val)) {
+                setConfig({ ...config, retentionDays: val });
+              }
+            }}
+            className="w-32"
+            aria-describedby="retentionDaysHelp"
+          />
+          <p id="retentionDaysHelp" className="text-xs text-muted-foreground">
+            {t("retentionDaysDescription")}
+          </p>
+        </div>
+
+        {/* 登录日志保留天数（独立于审计日志，默认 365 天） */}
+        <div className="space-y-2">
+          <Label htmlFor="loginLogRetentionDays">
+            {t("loginLogRetentionDays")}
+          </Label>
+          <Input
+            id="loginLogRetentionDays"
+            type="number"
+            min={MIN_RETENTION_DAYS}
+            max={MAX_RETENTION_DAYS}
+            value={config.loginLogRetentionDays}
+            onChange={(e) => {
+              const val = Number(e.target.value);
+              if (Number.isFinite(val)) {
+                setConfig({ ...config, loginLogRetentionDays: val });
+              }
+            }}
+            className="w-32"
+            aria-describedby="loginLogRetentionDaysHelp"
+          />
+          <p
+            id="loginLogRetentionDaysHelp"
+            className="text-xs text-muted-foreground"
+          >
+            {t("loginLogRetentionDaysDescription")}
+          </p>
+        </div>
+
+        {/* 自动清理开关 */}
+        <div className="flex items-center justify-between rounded-lg border p-4">
+          <div className="space-y-0.5">
+            <Label htmlFor="autoCleanup">{t("autoCleanupEnabled")}</Label>
+            <p className="text-xs text-muted-foreground">
+              {t("autoCleanupEnabledDescription")}
+            </p>
+          </div>
+          <Switch
+            id="autoCleanup"
+            checked={config.autoCleanupEnabled}
+            onCheckedChange={(checked) =>
+              setConfig({ ...config, autoCleanupEnabled: checked })
+            }
+            aria-label={t("autoCleanupEnabled")}
+          />
+        </div>
+
+        {/* 操作按钮 */}
+        <div className="flex gap-3">
+          <Button
+            type="button"
+            onClick={() => void handleSave()}
+            disabled={isSaving}
+          >
+            {isSaving ? (
+              <Loader2 className="mr-2 size-4 animate-spin" />
+            ) : (
+              <Save className="mr-2 size-4" />
+            )}
+            {t("save")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            onClick={() => void handlePurge()}
+            disabled={isPurging}
+          >
+            {isPurging ? (
+              <Loader2 className="mr-2 size-4 animate-spin" />
+            ) : (
+              <Trash2 className="mr-2 size-4" />
+            )}
+            {t("purge")}
+          </Button>
+        </div>
+      </CardContent>
+    </Card>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/audit-logs/data-changes-client.tsx b/apps/portal-shell/src/features/admin/audit-logs/data-changes-client.tsx
index 63d4d81..abfc0b9 100644
--- a/apps/portal-shell/src/features/admin/audit-logs/data-changes-client.tsx
+++ b/apps/portal-shell/src/features/admin/audit-logs/data-changes-client.tsx
@@ -8,24 +8,25 @@
  * - dataChangeTableOptions()：❌ schema 无 → MSW 兜底
  * - dataChangeStats()：❌ schema 无 → MSW 兜底
  *
- * URL 状态：?page=&table=&action=&userId=
+ * URL 状态：?page=&table=&action=&userId=&startDate=&endDate=
  *
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { Database, Download } from "lucide-react";
+import { ChevronDown, ChevronRight, Database, RotateCcw } from "lucide-react";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useTransition } from "react";
+import { useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
+import type { DataChangeLog } from "@/lib/api";
 import {
   useDataChangeLogs,
   useDataChangeStats,
   useDataChangeTableOptions,
+  useExportDataChanges,
 } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
-import { Card, CardContent } from "@/shared/components/ui/card";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import {
   FilterBar,
@@ -35,12 +36,14 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { notify } from "@/shared/lib/notify";
+import { SectionErrorBoundary } from "@/shared/components/section-error-boundary";
+import { ChartCardShell } from "@/shared/components/charts/chart-card-shell";
+import { AuditLogDetailDialog } from "@/features/admin/audit-logs/audit-log-detail-dialog";
+import { AuditLogExportButton } from "@/features/admin/audit-logs/audit-log-export-button";
+import { AuditLogsPagination } from "@/features/admin/audit-logs/audit-logs-pagination";
 import {
   dataChangeActionToBadgeClass,
   dataChangeActionToLabel,
-  dataChangeLogsToCsv,
-  downloadCsv,
   formatAuditTimestamp,
 } from "@/features/admin/audit-logs/transformations";
 
@@ -68,6 +71,8 @@ export function DataChangesClient(): React.ReactElement {
   const tableFilter = searchParams.get("table") ?? "";
   const actionFilter = searchParams.get("action") ?? "";
   const userId = searchParams.get("userId") ?? "";
+  const startDate = searchParams.get("startDate") ?? "";
+  const endDate = searchParams.get("endDate") ?? "";
 
   // @contract-pending：MSW 兜底
   const { data: tableOptions } = useDataChangeTableOptions();
@@ -77,6 +82,8 @@ export function DataChangesClient(): React.ReactElement {
       tableName: tableFilter || null,
       action: actionFilter || null,
       userId: userId || null,
+      startDate: startDate || null,
+      endDate: endDate || null,
     },
     { limit: PAGE_SIZE, offset: (page - 1) * PAGE_SIZE },
   );
@@ -84,6 +91,9 @@ export function DataChangesClient(): React.ReactElement {
   const items = data?.items ?? [];
   const statsData = stats ?? [];
 
+  // 导出 hook（@contract-pending MSW 兜底，CSV 由 MSW 构造返回）
+  const { run: runExport, loading: exporting } = useExportDataChanges();
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -99,20 +109,19 @@ export function DataChangesClient(): React.ReactElement {
     });
   };
 
-  const handleExport = (): void => {
-    try {
-      const csv = dataChangeLogsToCsv(items);
-      const ok = downloadCsv(`data-change-logs-${Date.now()}.csv`, csv);
-      if (ok) {
-        notify.success(t("exportCsv"));
-      } else {
-        notify.error(tCommon("error.loadFailed", { message: "" }));
-      }
-    } catch (err) {
-      notify.error(tCommon("error.loadFailed", { message: String(err) }));
-    }
+  const resetFilters = (): void => {
+    startTransition(() => {
+      router.push("/shell/admin/audit-logs/data-changes");
+    });
   };
 
+  const hasFilters =
+    Boolean(tableFilter) ||
+    Boolean(actionFilter) ||
+    Boolean(userId) ||
+    Boolean(startDate) ||
+    Boolean(endDate);
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -140,10 +149,18 @@ export function DataChangesClient(): React.ReactElement {
       description={t("description")}
       icon={<Database className="size-6" />}
       actions={
-        <Button onClick={handleExport} variant="outline" size="sm">
-          <Download className="size-4" />
-          {t("exportCsv")}
-        </Button>
+        <AuditLogExportButton
+          runExport={runExport}
+          filter={{
+            tableName: tableFilter || null,
+            action: actionFilter || null,
+            userId: userId || null,
+            startDate: startDate || null,
+            endDate: endDate || null,
+          }}
+          loading={exporting}
+          namespace="admin.auditLogs.dataChanges"
+        />
       }
       filters={
         <FilterBar variant="wrap">
@@ -178,6 +195,32 @@ export function DataChangesClient(): React.ReactElement {
               </option>
             ))}
           </select>
+          <input
+            type="date"
+            value={startDate}
+            onChange={(e) => updateQuery("startDate", e.target.value)}
+            aria-label={t("startDate")}
+            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+          />
+          <input
+            type="date"
+            value={endDate}
+            onChange={(e) => updateQuery("endDate", e.target.value)}
+            aria-label={t("endDate")}
+            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+          />
+          {hasFilters ? (
+            <Button
+              variant="ghost"
+              size="sm"
+              onClick={resetFilters}
+              className="h-9"
+              aria-label={t("resetFilter")}
+            >
+              <RotateCcw className="size-4" />
+              {t("resetFilter")}
+            </Button>
+          ) : null}
         </FilterBar>
       }
       loading={loading}
@@ -186,16 +229,21 @@ export function DataChangesClient(): React.ReactElement {
       emptyNode={emptyNode}
       errorNode={errorNode}
       pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: data?.total ?? 0 })}</span>
-        </div>
+        <SectionErrorBoundary title={t("title")}>
+          <AuditLogsPagination
+            page={page}
+            pageSize={PAGE_SIZE}
+            total={data?.total ?? 0}
+            onJump={(p) => updateQuery("page", String(p))}
+            namespace="admin.auditLogs.dataChanges"
+          />
+        </SectionErrorBoundary>
       }
     >
-      {/* 变更统计卡片 */}
+      {/* 变更统计卡片 - 使用 ChartCardShell 统一图表容器 */}
       {statsData.length > 0 ? (
-        <Card>
-          <CardContent className="p-6">
-            <h2 className="mb-4 text-lg font-semibold">{t("statsTitle")}</h2>
+        <SectionErrorBoundary title={t("statsTitle")}>
+          <ChartCardShell title={t("statsTitle")}>
             <div className="overflow-x-auto">
               <table className="w-full text-sm">
                 <thead className="border-b bg-muted/30">
@@ -226,38 +274,39 @@ export function DataChangesClient(): React.ReactElement {
                 </tbody>
               </table>
             </div>
-          </CardContent>
-        </Card>
+          </ChartCardShell>
+        </SectionErrorBoundary>
       ) : null}
 
-      <DataChangesTable items={items} />
+      <SectionErrorBoundary title={t("title")}>
+        <DataChangesTable items={items} />
+      </SectionErrorBoundary>
     </ListPageShell>
   );
 }
 
 /**
  * 数据变更日志表格（纯展示组件）。
+ * 支持行内展开 diff（oldValue/newValue 对比），末列提供详情对话框入口。
  */
 function DataChangesTable({
   items,
 }: {
-  items: ReadonlyArray<{
-    id: string;
-    tableName: string;
-    recordId: string;
-    action: string;
-    userId: string;
-    userName: string;
-    changes: string;
-    timestamp: string;
-  }>;
+  items: ReadonlyArray<DataChangeLog>;
 }): React.ReactElement {
   const t = useTranslations("admin.auditLogs.dataChanges");
+  const [expandedId, setExpandedId] = useState<string | null>(null);
+
+  const toggleExpand = (id: string): void => {
+    setExpandedId((prev) => (prev === id ? null : id));
+  };
+
   return (
     <div className="overflow-x-auto rounded-xl border">
       <table className="w-full text-sm">
         <thead className="border-b bg-muted/30">
           <tr>
+            <th className="p-3 text-left font-medium" aria-label="expand" />
             <th className="p-3 text-left font-medium">{t("colTimestamp")}</th>
             <th className="p-3 text-left font-medium">{t("colTable")}</th>
             <th className="p-3 text-left font-medium">{t("colRecordId")}</th>
@@ -265,36 +314,144 @@ function DataChangesTable({
             <th className="p-3 text-left font-medium">{t("colUserId")}</th>
             <th className="p-3 text-left font-medium">{t("colUserName")}</th>
             <th className="p-3 text-left font-medium">{t("colChanges")}</th>
+            <th className="p-3 text-left font-medium">{t("colActions")}</th>
           </tr>
         </thead>
         <tbody className="divide-y">
-          {items.map((log) => (
-            <tr key={log.id} className="hover:bg-muted/30">
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatAuditTimestamp(log.timestamp)}
-              </td>
-              <td className="p-3 font-medium">{log.tableName}</td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {log.recordId}
-              </td>
-              <td className="p-3">
-                <DataChangeActionBadge action={log.action} />
-              </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {log.userId}
-              </td>
-              <td className="p-3">{log.userName}</td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {log.changes}
-              </td>
-            </tr>
-          ))}
+          {items.map((log) => {
+            const isExpanded = expandedId === log.id;
+            const hasDiff = Boolean(log.oldValue) || Boolean(log.newValue);
+            return (
+              <RowFragment
+                key={log.id}
+                log={log}
+                isExpanded={isExpanded}
+                hasDiff={hasDiff}
+                onToggle={toggleExpand}
+              />
+            );
+          })}
         </tbody>
       </table>
     </div>
   );
 }
 
+/**
+ * 单行 + 可选展开行（diff 对比）。
+ */
+function RowFragment({
+  log,
+  isExpanded,
+  hasDiff,
+  onToggle,
+}: {
+  log: DataChangeLog;
+  isExpanded: boolean;
+  hasDiff: boolean;
+  onToggle: (id: string) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.auditLogs.dataChanges");
+  return (
+    <>
+      <tr className="hover:bg-muted/30">
+        <td className="p-3">
+          {hasDiff ? (
+            <Button
+              variant="ghost"
+              size="sm"
+              className="h-7 w-7 p-0"
+              onClick={() => onToggle(log.id)}
+              aria-label={isExpanded ? t("collapseDetail") : t("expandDetail")}
+              aria-expanded={isExpanded}
+            >
+              {isExpanded ? (
+                <ChevronDown className="size-4" />
+              ) : (
+                <ChevronRight className="size-4" />
+              )}
+            </Button>
+          ) : null}
+        </td>
+        <td className="p-3 font-mono text-xs text-muted-foreground">
+          {formatAuditTimestamp(log.timestamp)}
+        </td>
+        <td className="p-3 font-medium">{log.tableName}</td>
+        <td className="p-3 font-mono text-xs text-muted-foreground">
+          {log.recordId}
+        </td>
+        <td className="p-3">
+          <DataChangeActionBadge action={log.action} />
+        </td>
+        <td className="p-3 font-mono text-xs text-muted-foreground">
+          {log.userId}
+        </td>
+        <td className="p-3">{log.userName}</td>
+        <td
+          className="max-w-xs truncate p-3 font-mono text-xs text-muted-foreground"
+          title={log.changes}
+        >
+          {log.changes}
+        </td>
+        <td className="p-3">
+          <AuditLogDetailDialog type="dataChange" item={log} />
+        </td>
+      </tr>
+      {isExpanded && hasDiff ? (
+        <tr className="bg-muted/20">
+          <td />
+          <td colSpan={8} className="p-3">
+            <DiffCompare
+              oldValue={log.oldValue}
+              newValue={log.newValue}
+              oldLabel={t("oldValue")}
+              newLabel={t("newValue")}
+            />
+          </td>
+        </tr>
+      ) : null}
+    </>
+  );
+}
+
+/**
+ * 变更前后对比展示（左右两栏）。
+ */
+function DiffCompare({
+  oldValue,
+  newValue,
+  oldLabel,
+  newLabel,
+}: {
+  oldValue: string | null | undefined;
+  newValue: string | null | undefined;
+  oldLabel: string;
+  newLabel: string;
+}): React.ReactElement {
+  const formatValue = (v: string | null | undefined): string => {
+    if (!v) return "--";
+    return v;
+  };
+  return (
+    <div className="grid grid-cols-1 gap-3 md:grid-cols-2">
+      <div className="rounded-md border border-destructive/30 bg-destructive/5 p-3">
+        <p className="mb-2 text-xs font-medium text-destructive">{oldLabel}</p>
+        <pre className="overflow-x-auto whitespace-pre-wrap break-all font-mono text-xs text-muted-foreground">
+          {formatValue(oldValue)}
+        </pre>
+      </div>
+      <div className="rounded-md border border-emerald-500/30 bg-emerald-500/5 p-3">
+        <p className="mb-2 text-xs font-medium text-emerald-600 dark:text-emerald-400">
+          {newLabel}
+        </p>
+        <pre className="overflow-x-auto whitespace-pre-wrap break-all font-mono text-xs text-muted-foreground">
+          {formatValue(newValue)}
+        </pre>
+      </div>
+    </div>
+  );
+}
+
 /**
  * 数据变更动作徽章。
  */
diff --git a/apps/portal-shell/src/features/admin/audit-logs/login-logs-client.tsx b/apps/portal-shell/src/features/admin/audit-logs/login-logs-client.tsx
index a4ab4b6..c01ab40 100644
--- a/apps/portal-shell/src/features/admin/audit-logs/login-logs-client.tsx
+++ b/apps/portal-shell/src/features/admin/audit-logs/login-logs-client.tsx
@@ -6,18 +6,20 @@
  * 数据契约：
  * - loginLogs(filter, pagination)：❌ schema 无 → MSW 兜底（@contract-pending）
  *
- * URL 状态：?page=&action=&status=&userId=
+ * URL 状态：?page=&action=&status=&userId=&startDate=&endDate=
  *
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ * 迁移自 CICD src/modules/audit/components/login-log-view.tsx + login-log-table.tsx
  */
-import { Download, LogIn } from "lucide-react";
+import { LogIn, RotateCcw } from "lucide-react";
 import { useRouter, useSearchParams } from "next/navigation";
 import { useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useLoginLogs } from "@/lib/api";
+import type { LoginLog } from "@/lib/api";
+import { useLoginLogs, useExportLoginLogs } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import {
@@ -28,12 +30,13 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { notify } from "@/shared/lib/notify";
+import { SectionErrorBoundary } from "@/shared/components/section-error-boundary";
+import { AuditLogDetailDialog } from "@/features/admin/audit-logs/audit-log-detail-dialog";
+import { AuditLogExportButton } from "@/features/admin/audit-logs/audit-log-export-button";
+import { AuditLogsPagination } from "@/features/admin/audit-logs/audit-logs-pagination";
 import {
-  downloadCsv,
   formatAuditTimestamp,
   loginActionToLabel,
-  loginLogsToCsv,
   loginStatusToBadgeClass,
   loginStatusToLabel,
 } from "@/features/admin/audit-logs/transformations";
@@ -68,6 +71,8 @@ export function LoginLogsClient(): React.ReactElement {
   const actionFilter = searchParams.get("action") ?? "";
   const statusFilter = searchParams.get("status") ?? "";
   const userId = searchParams.get("userId") ?? "";
+  const startDate = searchParams.get("startDate") ?? "";
+  const endDate = searchParams.get("endDate") ?? "";
 
   // @contract-pending：MSW 兜底
   const { data, loading, error } = useLoginLogs(
@@ -75,12 +80,17 @@ export function LoginLogsClient(): React.ReactElement {
       action: actionFilter || null,
       status: statusFilter || null,
       userId: userId || null,
+      startDate: startDate || null,
+      endDate: endDate || null,
     },
     { limit: PAGE_SIZE, offset: (page - 1) * PAGE_SIZE },
   );
 
   const items = data?.items ?? [];
 
+  // 导出 hook（@contract-pending MSW 兜底，CSV 由 MSW 构造返回）
+  const { run: runExport, loading: exporting } = useExportLoginLogs();
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -96,20 +106,19 @@ export function LoginLogsClient(): React.ReactElement {
     });
   };
 
-  const handleExport = (): void => {
-    try {
-      const csv = loginLogsToCsv(items);
-      const ok = downloadCsv(`login-logs-${Date.now()}.csv`, csv);
-      if (ok) {
-        notify.success(t("exportCsv"));
-      } else {
-        notify.error(tCommon("error.loadFailed", { message: "" }));
-      }
-    } catch (err) {
-      notify.error(tCommon("error.loadFailed", { message: String(err) }));
-    }
+  const resetFilters = (): void => {
+    startTransition(() => {
+      router.push("/shell/admin/audit-logs/login-logs");
+    });
   };
 
+  const hasFilters =
+    Boolean(actionFilter) ||
+    Boolean(statusFilter) ||
+    Boolean(userId) ||
+    Boolean(startDate) ||
+    Boolean(endDate);
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -137,10 +146,16 @@ export function LoginLogsClient(): React.ReactElement {
       description={t("description")}
       icon={<LogIn className="size-6" />}
       actions={
-        <Button onClick={handleExport} variant="outline" size="sm">
-          <Download className="size-4" />
-          {t("exportCsv")}
-        </Button>
+        <AuditLogExportButton
+          runExport={runExport}
+          filter={{
+            action: actionFilter || null,
+            status: statusFilter || null,
+            userId: userId || null,
+          }}
+          loading={exporting}
+          namespace="admin.auditLogs.loginLogs"
+        />
       }
       filters={
         <FilterBar variant="wrap">
@@ -175,6 +190,32 @@ export function LoginLogsClient(): React.ReactElement {
               </option>
             ))}
           </select>
+          <input
+            type="date"
+            value={startDate}
+            onChange={(e) => updateQuery("startDate", e.target.value)}
+            aria-label={t("startDate")}
+            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+          />
+          <input
+            type="date"
+            value={endDate}
+            onChange={(e) => updateQuery("endDate", e.target.value)}
+            aria-label={t("endDate")}
+            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+          />
+          {hasFilters ? (
+            <Button
+              variant="ghost"
+              size="sm"
+              onClick={resetFilters}
+              className="h-9"
+              aria-label={t("resetFilter")}
+            >
+              <RotateCcw className="size-4" />
+              {t("resetFilter")}
+            </Button>
+          ) : null}
         </FilterBar>
       }
       loading={loading}
@@ -183,32 +224,32 @@ export function LoginLogsClient(): React.ReactElement {
       emptyNode={emptyNode}
       errorNode={errorNode}
       pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: data?.total ?? 0 })}</span>
-        </div>
+        <SectionErrorBoundary title={t("title")}>
+          <AuditLogsPagination
+            page={page}
+            pageSize={PAGE_SIZE}
+            total={data?.total ?? 0}
+            onJump={(p) => updateQuery("page", String(p))}
+            namespace="admin.auditLogs.loginLogs"
+          />
+        </SectionErrorBoundary>
       }
     >
-      <LoginLogsTable items={items} />
+      <SectionErrorBoundary title={t("title")}>
+        <LoginLogsTable items={items} />
+      </SectionErrorBoundary>
     </ListPageShell>
   );
 }
 
 /**
  * 登录日志表格（纯展示组件）。
+ * userAgent 截断显示（max-w + truncate），errorMessage 行内展开显示在状态徽章下方。
  */
 function LoginLogsTable({
   items,
 }: {
-  items: ReadonlyArray<{
-    id: string;
-    userId: string;
-    userName: string;
-    action: string;
-    status: string;
-    ip: string;
-    userAgent: string;
-    timestamp: string;
-  }>;
+  items: ReadonlyArray<LoginLog>;
 }): React.ReactElement {
   const t = useTranslations("admin.auditLogs.loginLogs");
   return (
@@ -223,6 +264,7 @@ function LoginLogsTable({
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
             <th className="p-3 text-left font-medium">{t("colIp")}</th>
             <th className="p-3 text-left font-medium">{t("colUserAgent")}</th>
+            <th className="p-3 text-left font-medium">{t("colActions")}</th>
           </tr>
         </thead>
         <tbody className="divide-y">
@@ -238,13 +280,24 @@ function LoginLogsTable({
               <td className="p-3">{loginActionToLabel(log.action)}</td>
               <td className="p-3">
                 <LoginStatusBadge status={log.status} />
+                {log.errorMessage ? (
+                  <div className="mt-1 text-xs text-destructive">
+                    {log.errorMessage}
+                  </div>
+                ) : null}
               </td>
               <td className="p-3 font-mono text-xs text-muted-foreground">
                 {log.ip}
               </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
+              <td
+                className="max-w-[280px] truncate p-3 font-mono text-xs text-muted-foreground"
+                title={log.userAgent}
+              >
                 {log.userAgent}
               </td>
+              <td className="p-3">
+                <AuditLogDetailDialog type="login" item={log} />
+              </td>
             </tr>
           ))}
         </tbody>
diff --git a/apps/portal-shell/src/features/admin/course-plans/course-plan-create-client.tsx b/apps/portal-shell/src/features/admin/course-plans/course-plan-create-client.tsx
index 7b17408..3af6400 100644
--- a/apps/portal-shell/src/features/admin/course-plans/course-plan-create-client.tsx
+++ b/apps/portal-shell/src/features/admin/course-plans/course-plan-create-client.tsx
@@ -15,7 +15,7 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { ClipboardList } from "lucide-react";
+import { ClipboardList, Sparkles } from "lucide-react";
 import { useRouter } from "next/navigation";
 import { useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
@@ -26,10 +26,14 @@ import {
   useCreateCoursePlan,
   useGrades,
   useTeacherOptions,
+  type CoursePlanTemplate,
   type CreateCoursePlanInput,
 } from "@/lib/api";
 import { FormPageShell } from "@/shared/components/page-templates";
+import { Button } from "@/shared/components/ui/button";
+import { Select } from "@/shared/components/ui/select";
 import { notify } from "@/shared/lib/notify";
+import { TemplatePickerDialog } from "@/features/admin/course-plans/template-picker-dialog";
 import {
   ADMIN_COURSE_PLAN_STATUS_OPTIONS,
   formatAdminCoursePlanStatus,
@@ -43,6 +47,7 @@ export function CoursePlanCreateClient(): React.ReactElement {
   const tCommon = useTranslations("common");
   const router = useRouter();
   const [, startTransition] = useTransition();
+  const [templateOpen, setTemplateOpen] = useState(false);
 
   // @contract-pending：MSW 兜底
   const { data: grades, loading: gradesLoading } = useGrades();
@@ -60,8 +65,28 @@ export function CoursePlanCreateClient(): React.ReactElement {
   const [teacherId, setTeacherId] = useState("");
   const [academicYearId, setAcademicYearId] = useState("");
   const [status, setStatus] = useState<string>("DRAFT");
+  const [semester, setSemester] = useState("");
+  const [syllabus, setSyllabus] = useState("");
+  const [objectives, setObjectives] = useState("");
+  const [totalHours, setTotalHours] = useState("");
+  const [weeklyHours, setWeeklyHours] = useState("");
+  const [startDate, setStartDate] = useState("");
+  const [endDate, setEndDate] = useState("");
   const [formError, setFormError] = useState<string | null>(null);
 
+  const handleTemplateSelect = (template: CoursePlanTemplate): void => {
+    // 用模板数据填充表单字段（仅填充可见字段，不强制覆盖用户已填内容）
+    setTitle((prev) => (prev.trim() ? prev : template.name));
+    setDescription((prev) => (prev.trim() ? prev : template.description));
+    if (template.subject) {
+      setSubjectId(template.subject);
+    }
+    if (template.gradeLevel) {
+      setGradeId(template.gradeLevel);
+    }
+    notify.success(t("templateApplied"));
+  };
+
   const handleSubmit = async (): Promise<void> => {
     setFormError(null);
 
@@ -120,6 +145,25 @@ export function CoursePlanCreateClient(): React.ReactElement {
         ) : undefined
       }
     >
+      {/* 从模板创建 */}
+      <div className="flex items-center justify-between rounded-md border border-dashed bg-muted/30 p-3">
+        <div className="space-y-0.5">
+          <p className="text-sm font-medium">{t("fromTemplate")}</p>
+          <p className="text-xs text-muted-foreground">
+            {t("fromTemplateHint")}
+          </p>
+        </div>
+        <Button
+          type="button"
+          variant="outline"
+          size="sm"
+          onClick={() => setTemplateOpen(true)}
+        >
+          <Sparkles className="size-4" aria-hidden="true" />
+          {t("openTemplatePicker")}
+        </Button>
+      </div>
+
       {/* 标题 */}
       <FormField label={t("fieldTitle")} required>
         <input
@@ -146,42 +190,40 @@ export function CoursePlanCreateClient(): React.ReactElement {
       <div className="grid grid-cols-2 gap-4">
         {/* 年级 */}
         <FormField label={t("fieldGradeId")} required>
-          <select
+          <Select
             value={gradeId}
-            onChange={(e) => setGradeId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-            required
+            onValueChange={setGradeId}
+            options={[
+              {
+                value: "",
+                label: gradesLoading ? tCommon("loading") : t("fieldGradeId"),
+              },
+              ...(grades ?? []).map((g) => ({
+                value: g.id,
+                label: g.name,
+              })),
+            ]}
             disabled={gradesLoading}
-          >
-            <option value="">
-              {gradesLoading ? tCommon("loading") : t("fieldGradeId")}
-            </option>
-            {(grades ?? []).map((g) => (
-              <option key={g.id} value={g.id}>
-                {g.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
 
         {/* 班级 */}
         <FormField label={t("fieldClassId")} required>
-          <select
+          <Select
             value={classId}
-            onChange={(e) => setClassId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-            required
+            onValueChange={setClassId}
+            options={[
+              {
+                value: "",
+                label: classesLoading ? tCommon("loading") : t("fieldClassId"),
+              },
+              ...(classes ?? []).map((c) => ({
+                value: c.id,
+                label: c.name,
+              })),
+            ]}
             disabled={classesLoading}
-          >
-            <option value="">
-              {classesLoading ? tCommon("loading") : t("fieldClassId")}
-            </option>
-            {(classes ?? []).map((c) => (
-              <option key={c.id} value={c.id}>
-                {c.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
       </div>
 
@@ -200,62 +242,151 @@ export function CoursePlanCreateClient(): React.ReactElement {
 
         {/* 教师 */}
         <FormField label={t("fieldTeacherId")}>
-          <select
+          <Select
             value={teacherId}
-            onChange={(e) => setTeacherId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setTeacherId}
+            options={[
+              {
+                value: "",
+                label: teachersLoading
+                  ? tCommon("loading")
+                  : t("fieldTeacherId"),
+              },
+              ...(teachers ?? []).map((teacher) => ({
+                value: teacher.id,
+                label: teacher.name,
+              })),
+            ]}
             disabled={teachersLoading}
-          >
-            <option value="">
-              {teachersLoading ? tCommon("loading") : t("fieldTeacherId")}
-            </option>
-            {(teachers ?? []).map((teacher) => (
-              <option key={teacher.id} value={teacher.id}>
-                {teacher.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
       </div>
 
       <div className="grid grid-cols-2 gap-4">
         {/* 学年 */}
         <FormField label={t("fieldAcademicYearId")}>
-          <select
+          <Select
             value={academicYearId}
-            onChange={(e) => setAcademicYearId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setAcademicYearId}
+            options={[
+              {
+                value: "",
+                label: yearsLoading
+                  ? tCommon("loading")
+                  : t("fieldAcademicYearId"),
+              },
+              ...(academicYears ?? []).map((y) => ({
+                value: y.id,
+                label: y.name,
+              })),
+            ]}
             disabled={yearsLoading}
-          >
-            <option value="">
-              {yearsLoading ? tCommon("loading") : t("fieldAcademicYearId")}
-            </option>
-            {(academicYears ?? []).map((y) => (
-              <option key={y.id} value={y.id}>
-                {y.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
 
         {/* 状态 */}
         <FormField label={t("fieldStatus")}>
-          <select
+          <Select
             value={status}
-            onChange={(e) => setStatus(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-          >
-            {ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => (
-              <option key={s} value={s}>
-                {formatAdminCoursePlanStatus(s)}
-              </option>
-            ))}
-          </select>
+            onValueChange={setStatus}
+            options={ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => ({
+              value: s,
+              label: formatAdminCoursePlanStatus(s),
+            }))}
+          />
         </FormField>
       </div>
 
+      {/* 学期 */}
+      <FormField label={t("fieldSemester")}>
+        <input
+          type="text"
+          value={semester}
+          onChange={(e) => setSemester(e.target.value)}
+          className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          placeholder="2026-fall"
+        />
+      </FormField>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 总课时 */}
+        <FormField label={t("fieldTotalHours")}>
+          <input
+            type="number"
+            min={0}
+            value={totalHours}
+            onChange={(e) => setTotalHours(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="120"
+          />
+        </FormField>
+
+        {/* 周课时 */}
+        <FormField label={t("fieldWeeklyHours")}>
+          <input
+            type="number"
+            min={0}
+            value={weeklyHours}
+            onChange={(e) => setWeeklyHours(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="6"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 开始日期 */}
+        <FormField label={t("fieldStartDate")}>
+          <input
+            type="date"
+            value={startDate}
+            onChange={(e) => setStartDate(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 结束日期 */}
+        <FormField label={t("fieldEndDate")}>
+          <input
+            type="date"
+            value={endDate}
+            onChange={(e) => setEndDate(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+      </div>
+
+      {/* 教学大纲 */}
+      <FormField label={t("fieldSyllabus")}>
+        <textarea
+          value={syllabus}
+          onChange={(e) => setSyllabus(e.target.value)}
+          rows={3}
+          className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+          placeholder={t("fieldSyllabus")}
+        />
+      </FormField>
+
+      {/* 教学目标 */}
+      <FormField label={t("fieldObjectives")}>
+        <textarea
+          value={objectives}
+          onChange={(e) => setObjectives(e.target.value)}
+          rows={3}
+          className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+          placeholder={t("fieldObjectives")}
+        />
+      </FormField>
+
       {/* @contract-pending 提示 */}
       <p className="text-xs text-muted-foreground">{t("contractPending")}</p>
+
+      {/* 模板选择对话框 */}
+      <TemplatePickerDialog
+        open={templateOpen}
+        onOpenChange={setTemplateOpen}
+        onSelect={handleTemplateSelect}
+      />
     </FormPageShell>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/course-plans/course-plan-detail-client.tsx b/apps/portal-shell/src/features/admin/course-plans/course-plan-detail-client.tsx
index 71615d5..2bc2da1 100644
--- a/apps/portal-shell/src/features/admin/course-plans/course-plan-detail-client.tsx
+++ b/apps/portal-shell/src/features/admin/course-plans/course-plan-detail-client.tsx
@@ -12,18 +12,27 @@
  * - error：errorNode 局部降级
  * - notFound：data 为 null 时显示空态节点
  *
- * 与教师域 course-plan-detail-client 的差异：
- * - 管理端 scope.isAdmin=true，展示全校视角字段（班级/科目/教师/学年）
- * - 不展示教师域的"单元进度/教学目标"等教师私有字段（AdminCoursePlan 仅含 content）
+ * 周计划管理（P0-5）：
+ * - 列表展示 items（周次 / 主题 / 课时 / 章节 / 状态）
+ * - 上移/下移排序（调用 reorderCoursePlanItems mutation）
+ * - 新建/编辑/删除周计划项（CoursePlanItemEditor 对话框）
+ * - 切换完成状态（toggleCoursePlanItemCompleted mutation）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { ClipboardList } from "lucide-react";
+import { ClipboardList, Pencil, Plus, Trash2 } from "lucide-react";
 import Link from "next/link";
-import { useParams } from "next/navigation";
+import { useParams, useRouter } from "next/navigation";
+import { useMemo, useState } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAdminCoursePlan } from "@/lib/api";
+import {
+  useAdminCoursePlan,
+  useReorderCoursePlanItems,
+  type AdminCoursePlanItem,
+} from "@/lib/api";
+import { useBulkToggleCoursePlanItems } from "@/lib/api/admin-p5";
+import { useDeleteCoursePlan } from "@/lib/api/admin-p5";
 import { Button } from "@/shared/components/ui/button";
 import {
   DetailPageShell,
@@ -31,6 +40,18 @@ import {
   DetailSection,
   DetailField,
 } from "@/shared/components/page-templates";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/shared/components/ui/table";
+import { Badge } from "@/shared/components/ui/badge";
+import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog";
+import { Progress } from "@/shared/components/ui/progress";
+import { notify } from "@/shared/lib/notify";
 import {
   adminCoursePlanStatusToBadgeClass,
   displayText,
@@ -39,6 +60,7 @@ import {
   hasContent,
   isAdminCoursePlanEditable,
 } from "@/features/admin/course-plans/transformations";
+import { CoursePlanItemEditor } from "@/features/admin/course-plans/course-plan-item-editor";
 
 /**
  * 详情客户端主体。需由 server page 包裹在 <Suspense> 中。
@@ -46,11 +68,26 @@ import {
 export function CoursePlanDetailClient(): React.ReactElement {
   const t = useTranslations("admin.coursePlans.detail");
   const tCommon = useTranslations("common");
+  const router = useRouter();
   const params = useParams<{ id: string }>();
   const planId = params?.id ?? "";
 
   // @contract-pending：MSW 兜底
-  const { data, loading, error } = useAdminCoursePlan(planId);
+  const { data, loading, error, refetch } = useAdminCoursePlan(planId);
+  const { run: deletePlan, loading: deleting } = useDeleteCoursePlan();
+  const [deleteOpen, setDeleteOpen] = useState(false);
+
+  const handleDelete = async (): Promise<void> => {
+    try {
+      await deletePlan(planId);
+      notify.success(t("deleteSuccess"));
+      setDeleteOpen(false);
+      router.push("/shell/admin/course-plans");
+    } catch (err) {
+      notify.error(t("deleteFailed"));
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
 
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
@@ -67,12 +104,26 @@ export function CoursePlanDetailClient(): React.ReactElement {
       icon={<ClipboardList className="size-6" />}
       backHref="/shell/admin/course-plans"
       actions={
-        data && isAdminCoursePlanEditable(data.status) ? (
-          <Button asChild variant="outline">
-            <Link href={`/shell/admin/course-plans/${data.id}/edit`}>
-              {t("edit")}
-            </Link>
-          </Button>
+        data ? (
+          <div className="flex items-center gap-2">
+            {isAdminCoursePlanEditable(data.status) ? (
+              <Button asChild variant="outline">
+                <Link href={`/shell/admin/course-plans/${data.id}/edit`}>
+                  <Pencil className="mr-2 size-4" aria-hidden="true" />
+                  {t("edit")}
+                </Link>
+              </Button>
+            ) : null}
+            <Button
+              variant="outline"
+              className="text-destructive hover:bg-destructive/10 hover:text-destructive"
+              onClick={() => setDeleteOpen(true)}
+              disabled={deleting}
+            >
+              <Trash2 className="mr-2 size-4" aria-hidden="true" />
+              {t("delete")}
+            </Button>
+          </div>
         ) : null
       }
       loading={loading}
@@ -86,20 +137,52 @@ export function CoursePlanDetailClient(): React.ReactElement {
         ) : undefined
       }
     >
-      {data ? <CoursePlanDetailBody detail={data} /> : null}
+      {data ? (
+        <CoursePlanDetailBody
+          detail={data}
+          planId={planId}
+          onRefresh={() => void refetch()}
+        />
+      ) : null}
+
+      <ConfirmDeleteDialog
+        open={deleteOpen}
+        onOpenChange={setDeleteOpen}
+        title={t("deleteTitle")}
+        description={t("deleteDescription")}
+        confirmText={t("deleteConfirm")}
+        cancelText={t("deleteCancel")}
+        onConfirm={handleDelete}
+        isWorking={deleting}
+      />
     </DetailPageShell>
   );
 }
 
 /**
- * 详情内容区（基本信息 + 计划内容）。
+ * 详情内容区（基本信息 + 计划内容 + 周计划管理）。
  */
 function CoursePlanDetailBody({
   detail,
+  planId,
+  onRefresh,
 }: {
   detail: NonNullable<ReturnType<typeof useAdminCoursePlan>["data"]>;
+  planId: string;
+  onRefresh: () => void;
 }): React.ReactElement {
   const t = useTranslations("admin.coursePlans.detail");
+  const canManage = isAdminCoursePlanEditable(detail.status);
+
+  const totalHours =
+    typeof detail.totalHours === "number" ? detail.totalHours : 0;
+  const completedHours =
+    typeof detail.completedHours === "number" ? detail.completedHours : 0;
+  const progressPercent =
+    totalHours > 0
+      ? Math.min(Math.round((completedHours / totalHours) * 100), 100)
+      : 0;
+
   return (
     <>
       <DetailSection title={t("sectionBasic")}>
@@ -124,6 +207,10 @@ function CoursePlanDetailBody({
           label={t("fieldAcademicYear")}
           value={displayText(detail.academicYearName)}
         />
+        <DetailField
+          label={t("fieldSemester")}
+          value={displayText(detail.semester)}
+        />
         <DetailField
           label={t("fieldCreatedAt")}
           value={formatAdminCoursePlanDate(detail.createdAt)}
@@ -134,6 +221,43 @@ function CoursePlanDetailBody({
         />
       </DetailSection>
 
+      {/* 教学进度 */}
+      {totalHours > 0 ? (
+        <DetailSection title={t("fieldTotalHours")}>
+          <div className="space-y-2">
+            <div className="flex items-center justify-between text-sm">
+              <span className="text-muted-foreground">
+                {t("fieldTotalHours")}: {totalHours}
+              </span>
+              <span className="font-mono text-xs text-muted-foreground">
+                {completedHours}/{totalHours} ({progressPercent}%)
+              </span>
+            </div>
+            <Progress value={progressPercent} className="h-2" />
+          </div>
+        </DetailSection>
+      ) : null}
+
+      {/* 计划时间 */}
+      {detail.startDate || detail.endDate ? (
+        <DetailSection title={t("fieldStartDate")}>
+          <DetailField
+            label={t("fieldStartDate")}
+            value={displayText(detail.startDate)}
+          />
+          <DetailField
+            label={t("fieldEndDate")}
+            value={displayText(detail.endDate)}
+          />
+          {typeof detail.weeklyHours === "number" ? (
+            <DetailField
+              label={t("fieldWeeklyHours")}
+              value={String(detail.weeklyHours)}
+            />
+          ) : null}
+        </DetailSection>
+      ) : null}
+
       <DetailSection title={t("sectionContent")}>
         {hasContent(detail.content) ? (
           <div className="whitespace-pre-wrap text-sm">{detail.content}</div>
@@ -141,10 +265,369 @@ function CoursePlanDetailBody({
           <p className="text-sm text-muted-foreground">{t("emptyResources")}</p>
         )}
       </DetailSection>
+
+      {/* 教学大纲 */}
+      <DetailSection title={t("fieldSyllabus")}>
+        {detail.syllabus ? (
+          <div className="whitespace-pre-wrap text-sm">{detail.syllabus}</div>
+        ) : (
+          <p className="text-sm text-muted-foreground">{t("emptySyllabus")}</p>
+        )}
+      </DetailSection>
+
+      {/* 教学目标 */}
+      <DetailSection title={t("fieldObjectives")}>
+        {detail.objectives ? (
+          <div className="whitespace-pre-wrap text-sm">{detail.objectives}</div>
+        ) : (
+          <p className="text-sm text-muted-foreground">
+            {t("emptyObjectives")}
+          </p>
+        )}
+      </DetailSection>
+
+      {/* 关联链接 */}
+      {detail.textbooksHref || detail.homeworkHref ? (
+        <DetailSection title={t("sectionBasic")}>
+          <div className="flex flex-wrap gap-3">
+            {detail.textbooksHref ? (
+              <Button asChild variant="outline" size="sm">
+                <Link href={detail.textbooksHref}>{t("linkTextbooks")}</Link>
+              </Button>
+            ) : null}
+            {detail.homeworkHref ? (
+              <Button asChild variant="outline" size="sm">
+                <Link href={detail.homeworkHref}>{t("linkHomework")}</Link>
+              </Button>
+            ) : null}
+          </div>
+        </DetailSection>
+      ) : null}
+
+      <WeeklyPlansSection
+        planId={planId}
+        items={detail.items}
+        canManage={canManage}
+        onRefresh={onRefresh}
+      />
     </>
   );
 }
 
+/**
+ * 周计划管理区块（P0-5）。
+ */
+function WeeklyPlansSection({
+  planId,
+  items,
+  canManage,
+  onRefresh,
+}: {
+  planId: string;
+  items: AdminCoursePlanItem[];
+  canManage: boolean;
+  onRefresh: () => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.coursePlans.detail");
+  const tCommon = useTranslations("common");
+  const { run: reorderItems, loading: reordering } =
+    useReorderCoursePlanItems();
+  const { run: bulkToggle, loading: bulkLoading } =
+    useBulkToggleCoursePlanItems();
+
+  const [editorOpen, setEditorOpen] = useState(false);
+  const [editingItem, setEditingItem] = useState<
+    AdminCoursePlanItem | undefined
+  >(undefined);
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
+
+  // 本地排序副本（按 week 升序），便于上移/下移后立即重渲染
+  const sortedItems = useMemo(
+    () => [...items].sort((a, b) => a.week - b.week),
+    [items],
+  );
+
+  const allSelected =
+    sortedItems.length > 0 && selectedIds.size === sortedItems.length;
+
+  const toggleSelectAll = (): void => {
+    if (allSelected) {
+      setSelectedIds(new Set());
+    } else {
+      setSelectedIds(new Set(sortedItems.map((it) => it.id)));
+    }
+  };
+
+  const toggleSelect = (id: string): void => {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) {
+        next.delete(id);
+      } else {
+        next.add(id);
+      }
+      return next;
+    });
+  };
+
+  const handleBulkToggle = async (isCompleted: boolean): Promise<void> => {
+    const ids = Array.from(selectedIds);
+    if (ids.length === 0) return;
+    try {
+      await bulkToggle(planId, ids, isCompleted);
+      notify.success(t("bulkSuccess", { count: ids.length }));
+      setSelectedIds(new Set());
+      onRefresh();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const openCreateEditor = (): void => {
+    setEditingItem(undefined);
+    setEditorOpen(true);
+  };
+
+  const openEditEditor = (item: AdminCoursePlanItem): void => {
+    setEditingItem(item);
+    setEditorOpen(true);
+  };
+
+  const handleMoveUp = async (item: AdminCoursePlanItem): Promise<void> => {
+    const idx = sortedItems.findIndex((it) => it.id === item.id);
+    if (idx <= 0) return;
+    // 重新生成 week 序号，并将目标项与上一项交换位置
+    const finalOrder = sortedItems.map((it, i) => ({ id: it.id, week: i + 1 }));
+    const targetCurr = finalOrder[idx];
+    const targetPrev = finalOrder[idx - 1];
+    if (targetCurr && targetPrev) {
+      finalOrder[idx - 1] = { id: targetCurr.id, week: idx };
+      finalOrder[idx] = { id: targetPrev.id, week: idx + 1 };
+    }
+    try {
+      await reorderItems(planId, finalOrder);
+      notify.success(t("reorderSuccess"));
+      onRefresh();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleMoveDown = async (item: AdminCoursePlanItem): Promise<void> => {
+    const idx = sortedItems.findIndex((it) => it.id === item.id);
+    if (idx < 0 || idx >= sortedItems.length - 1) return;
+    const finalOrder = sortedItems.map((it, i) => ({ id: it.id, week: i + 1 }));
+    const targetCurr = finalOrder[idx];
+    const targetNext = finalOrder[idx + 1];
+    if (targetCurr && targetNext) {
+      finalOrder[idx] = { id: targetNext.id, week: idx + 1 };
+      finalOrder[idx + 1] = { id: targetCurr.id, week: idx + 2 };
+    }
+    try {
+      await reorderItems(planId, finalOrder);
+      notify.success(t("reorderSuccess"));
+      onRefresh();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <DetailSection title={t("sectionSchedule")}>
+      <div className="space-y-3">
+        <div className="flex items-center justify-between">
+          <p className="text-xs text-muted-foreground">
+            {t("weekPlansHint", { count: sortedItems.length })}
+          </p>
+          {canManage ? (
+            <Button
+              type="button"
+              size="sm"
+              onClick={openCreateEditor}
+              disabled={reordering}
+            >
+              <Plus className="mr-2 size-4" aria-hidden="true" />
+              {t("addWeekPlan")}
+            </Button>
+          ) : null}
+        </div>
+
+        {/* 批量操作工具栏 */}
+        {canManage && sortedItems.length > 0 ? (
+          <div className="flex items-center gap-2 rounded-md border bg-muted/30 p-2">
+            <Button
+              type="button"
+              variant="ghost"
+              size="sm"
+              onClick={toggleSelectAll}
+              disabled={bulkLoading}
+            >
+              {allSelected ? t("bulkClear") : t("bulkSelectAll")}
+            </Button>
+            {selectedIds.size > 0 ? (
+              <>
+                <span className="text-xs text-muted-foreground">
+                  {t("bulkSelected", { count: selectedIds.size })}
+                </span>
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={() => void handleBulkToggle(true)}
+                  disabled={bulkLoading}
+                >
+                  {t("bulkMarkComplete")}
+                </Button>
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={() => void handleBulkToggle(false)}
+                  disabled={bulkLoading}
+                >
+                  {t("bulkMarkIncomplete")}
+                </Button>
+              </>
+            ) : null}
+          </div>
+        ) : null}
+
+        {sortedItems.length === 0 ? (
+          <div className="rounded-md border p-6 text-center text-sm text-muted-foreground">
+            {t("emptyWeekPlans")}
+            {canManage ? t("emptyWeekPlansCta") : ""}
+          </div>
+        ) : (
+          <div className="rounded-md border">
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  {canManage ? (
+                    <TableHead className="w-10">
+                      <input
+                        type="checkbox"
+                        checked={allSelected}
+                        onChange={toggleSelectAll}
+                        className="size-4 rounded border-input"
+                        aria-label={t("bulkSelectAll")}
+                      />
+                    </TableHead>
+                  ) : null}
+                  <TableHead className="w-16">{t("colWeek")}</TableHead>
+                  <TableHead>{t("colTopic")}</TableHead>
+                  <TableHead className="w-20">{t("colHours")}</TableHead>
+                  <TableHead className="w-28">{t("colChapter")}</TableHead>
+                  <TableHead className="w-24">{t("colStatus")}</TableHead>
+                  {canManage ? (
+                    <TableHead className="w-32">{t("colActions")}</TableHead>
+                  ) : null}
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {sortedItems.map((item, idx) => (
+                  <TableRow key={item.id}>
+                    {canManage ? (
+                      <TableCell>
+                        <input
+                          type="checkbox"
+                          checked={selectedIds.has(item.id)}
+                          onChange={() => toggleSelect(item.id)}
+                          className="size-4 rounded border-input"
+                          aria-label={t("bulkSelectAll")}
+                        />
+                      </TableCell>
+                    ) : null}
+                    <TableCell className="font-medium">{item.week}</TableCell>
+                    <TableCell>
+                      <div className="space-y-1">
+                        <p className="font-medium">{item.topic}</p>
+                        {item.content ? (
+                          <p className="text-xs text-muted-foreground line-clamp-2">
+                            {item.content}
+                          </p>
+                        ) : null}
+                        {item.notes ? (
+                          <p className="text-xs text-muted-foreground italic">
+                            {t("notesLabel", { notes: item.notes })}
+                          </p>
+                        ) : null}
+                      </div>
+                    </TableCell>
+                    <TableCell className="text-muted-foreground">
+                      {item.hours}
+                    </TableCell>
+                    <TableCell className="text-muted-foreground">
+                      {displayText(item.textbookChapter)}
+                    </TableCell>
+                    <TableCell>
+                      <Badge
+                        variant={item.isCompleted ? "default" : "secondary"}
+                      >
+                        {item.isCompleted
+                          ? t("statusCompleted")
+                          : t("statusPending")}
+                      </Badge>
+                    </TableCell>
+                    {canManage ? (
+                      <TableCell>
+                        <div className="flex items-center gap-1">
+                          <Button
+                            type="button"
+                            variant="ghost"
+                            size="sm"
+                            className="h-7 px-2"
+                            onClick={() => void handleMoveUp(item)}
+                            disabled={reordering || idx === 0}
+                            aria-label={t("moveUpAria", { week: item.week })}
+                          >
+                            ↑
+                          </Button>
+                          <Button
+                            type="button"
+                            variant="ghost"
+                            size="sm"
+                            className="h-7 px-2"
+                            onClick={() => void handleMoveDown(item)}
+                            disabled={
+                              reordering || idx === sortedItems.length - 1
+                            }
+                            aria-label={t("moveDownAria", { week: item.week })}
+                          >
+                            ↓
+                          </Button>
+                          <Button
+                            type="button"
+                            variant="ghost"
+                            size="sm"
+                            className="h-7 px-2"
+                            onClick={() => openEditEditor(item)}
+                            disabled={reordering}
+                          >
+                            {t("editItem")}
+                          </Button>
+                        </div>
+                      </TableCell>
+                    ) : null}
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+        )}
+
+        <CoursePlanItemEditor
+          planId={planId}
+          item={editingItem}
+          mode={editingItem ? "edit" : "create"}
+          open={editorOpen}
+          onOpenChange={setEditorOpen}
+          onSuccess={onRefresh}
+        />
+      </div>
+    </DetailSection>
+  );
+}
+
 /**
  * 状态徽章（按状态色阶展示）。
  */
diff --git a/apps/portal-shell/src/features/admin/course-plans/course-plan-edit-client.tsx b/apps/portal-shell/src/features/admin/course-plans/course-plan-edit-client.tsx
index 38c35a4..9bfb1dd 100644
--- a/apps/portal-shell/src/features/admin/course-plans/course-plan-edit-client.tsx
+++ b/apps/portal-shell/src/features/admin/course-plans/course-plan-edit-client.tsx
@@ -8,13 +8,14 @@
  * - mutation updateCoursePlan(input) ❌ schema 无 Mutation 类型 → MSW 兜底（@contract-pending）
  * - 选项数据 grades / adminClasses / teacherOptions / academicYears：MSW 兜底
  * - 选项数据 subjectOptions：❌ 暂无 hook → 文本输入兜底（@contract-pending）
+ * - 周次教学进度：❌ schema 无 → 本地 state + 默认骨架（@contract-pending，保存时暂不同步）
  *
  * 三态规范（§11.3 DoD）：
  * - loading：FormPageSkeleton（加载预填数据）
  * - error：errorSummary 表单级错误
  * - success：notify.success + router.push 回详情页
  *
- * 与 course-plan-create-client 的差异：预填表单 + 调用 updateCoursePlan(input)
+ * 与 course-plan-create-client 的差异：预填表单 + 调用 updateCoursePlan(input) + 周次排序
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
@@ -34,11 +35,39 @@ import {
 } from "@/lib/api";
 import { FormPageShell } from "@/shared/components/page-templates";
 import { notify } from "@/shared/lib/notify";
+import {
+  Table,
+  TableBody,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/shared/components/ui/table";
+import { Select } from "@/shared/components/ui/select";
 import {
   ADMIN_COURSE_PLAN_STATUS_OPTIONS,
   formatAdminCoursePlanStatus,
   isAdminCoursePlanEditable,
 } from "@/features/admin/course-plans/transformations";
+import {
+  SortableWeekRow,
+  type SortableWeekItem,
+} from "@/features/admin/course-plans/sortable-week-row";
+
+/**
+ * 默认周次骨架（@contract-pending）。
+ *
+ * schema 无 weeklySchedule 字段，编辑页提供本地可排序的周次骨架，
+ * 让管理员预览进度排布；后端补齐契约后改为从详情查询初始化。
+ */
+function createDefaultWeekItems(): SortableWeekItem[] {
+  return [
+    { week: 1, topic: "集合与函数概念", hours: 4, notes: "" },
+    { week: 2, topic: "函数的基本性质", hours: 4, notes: "" },
+    { week: 3, topic: "指数函数与对数函数", hours: 6, notes: "" },
+    { week: 4, topic: "幂函数", hours: 3, notes: "" },
+    { week: 5, topic: "函数应用", hours: 3, notes: "" },
+  ];
+}
 
 /**
  * 编辑表单客户端主体。需由 server page 包裹在 <Suspense> 中。
@@ -70,9 +99,21 @@ export function CoursePlanEditClient(): React.ReactElement {
   const [teacherId, setTeacherId] = useState("");
   const [academicYearId, setAcademicYearId] = useState("");
   const [status, setStatus] = useState<string>("DRAFT");
+  const [semester, setSemester] = useState("");
+  const [syllabus, setSyllabus] = useState("");
+  const [objectives, setObjectives] = useState("");
+  const [totalHours, setTotalHours] = useState("");
+  const [weeklyHours, setWeeklyHours] = useState("");
+  const [startDate, setStartDate] = useState("");
+  const [endDate, setEndDate] = useState("");
   const [formError, setFormError] = useState<string | null>(null);
   const [initialized, setInitialized] = useState(false);
 
+  // @contract-pending：周次教学进度本地 state（schema 无 weeklySchedule 字段）
+  const [weekItems, setWeekItems] = useState<SortableWeekItem[]>(
+    createDefaultWeekItems,
+  );
+
   // 首次拿到数据时初始化表单
   // 注意：AdminCoursePlan 不含 gradeId 字段，gradeId 由用户在表单中重新选择（@contract-pending）
   useEffect(() => {
@@ -84,10 +125,51 @@ export function CoursePlanEditClient(): React.ReactElement {
       setTeacherId(data.teacherId ?? "");
       setAcademicYearId(data.academicYearId ?? "");
       setStatus(data.status ?? "DRAFT");
+      setSemester(data.semester ?? "");
+      setSyllabus(data.syllabus ?? "");
+      setObjectives(data.objectives ?? "");
+      setTotalHours(
+        typeof data.totalHours === "number" ? String(data.totalHours) : "",
+      );
+      setWeeklyHours(
+        typeof data.weeklyHours === "number" ? String(data.weeklyHours) : "",
+      );
+      setStartDate(data.startDate ?? "");
+      setEndDate(data.endDate ?? "");
       setInitialized(true);
     }
   }, [data, initialized]);
 
+  const handleMoveUp = (item: SortableWeekItem): void => {
+    setWeekItems((prev) => {
+      const idx = prev.findIndex((w) => w.week === item.week);
+      if (idx <= 0) return prev;
+      const next = [...prev];
+      const a = next[idx - 1];
+      const b = next[idx];
+      if (a && b) {
+        next[idx - 1] = b;
+        next[idx] = a;
+      }
+      return next;
+    });
+  };
+
+  const handleMoveDown = (item: SortableWeekItem): void => {
+    setWeekItems((prev) => {
+      const idx = prev.findIndex((w) => w.week === item.week);
+      if (idx < 0 || idx >= prev.length - 1) return prev;
+      const next = [...prev];
+      const a = next[idx];
+      const b = next[idx + 1];
+      if (a && b) {
+        next[idx] = b;
+        next[idx + 1] = a;
+      }
+      return next;
+    });
+  };
+
   const handleFormSubmit = async (): Promise<void> => {
     setFormError(null);
 
@@ -109,7 +191,8 @@ export function CoursePlanEditClient(): React.ReactElement {
     }
 
     // @contract-pending：UpdateCoursePlanInput 仅支持 id/name/description/objectives/status
-    // gradeId / classId / subjectId / teacherId / academicYearId 暂无对应字段，由后端补齐后扩展输入类型
+    // gradeId / classId / subjectId / teacherId / academicYearId / weekItems 暂无对应字段，
+    // 由后端补齐后扩展输入类型；周次排序仅在前端预览，保存时暂不同步
     const input: UpdateCoursePlanInput = {
       id: planId,
       name: title.trim(),
@@ -218,42 +301,40 @@ export function CoursePlanEditClient(): React.ReactElement {
       <div className="grid grid-cols-2 gap-4">
         {/* 年级 */}
         <FormField label={t("fieldGradeId")} required>
-          <select
+          <Select
             value={gradeId}
-            onChange={(e) => setGradeId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-            required
+            onValueChange={setGradeId}
+            options={[
+              {
+                value: "",
+                label: gradesLoading ? tCommon("loading") : t("fieldGradeId"),
+              },
+              ...(grades ?? []).map((g) => ({
+                value: g.id,
+                label: g.name,
+              })),
+            ]}
             disabled={gradesLoading}
-          >
-            <option value="">
-              {gradesLoading ? tCommon("loading") : t("fieldGradeId")}
-            </option>
-            {(grades ?? []).map((g) => (
-              <option key={g.id} value={g.id}>
-                {g.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
 
         {/* 班级 */}
         <FormField label={t("fieldClassId")} required>
-          <select
+          <Select
             value={classId}
-            onChange={(e) => setClassId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-            required
+            onValueChange={setClassId}
+            options={[
+              {
+                value: "",
+                label: classesLoading ? tCommon("loading") : t("fieldClassId"),
+              },
+              ...(classes ?? []).map((c) => ({
+                value: c.id,
+                label: c.name,
+              })),
+            ]}
             disabled={classesLoading}
-          >
-            <option value="">
-              {classesLoading ? tCommon("loading") : t("fieldClassId")}
-            </option>
-            {(classes ?? []).map((c) => (
-              <option key={c.id} value={c.id}>
-                {c.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
       </div>
 
@@ -272,59 +353,187 @@ export function CoursePlanEditClient(): React.ReactElement {
 
         {/* 教师 */}
         <FormField label={t("fieldTeacherId")}>
-          <select
+          <Select
             value={teacherId}
-            onChange={(e) => setTeacherId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setTeacherId}
+            options={[
+              {
+                value: "",
+                label: teachersLoading
+                  ? tCommon("loading")
+                  : t("fieldTeacherId"),
+              },
+              ...(teachers ?? []).map((teacher) => ({
+                value: teacher.id,
+                label: teacher.name,
+              })),
+            ]}
             disabled={teachersLoading}
-          >
-            <option value="">
-              {teachersLoading ? tCommon("loading") : t("fieldTeacherId")}
-            </option>
-            {(teachers ?? []).map((teacher) => (
-              <option key={teacher.id} value={teacher.id}>
-                {teacher.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
       </div>
 
       <div className="grid grid-cols-2 gap-4">
         {/* 学年 */}
         <FormField label={t("fieldAcademicYearId")}>
-          <select
+          <Select
             value={academicYearId}
-            onChange={(e) => setAcademicYearId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setAcademicYearId}
+            options={[
+              {
+                value: "",
+                label: yearsLoading
+                  ? tCommon("loading")
+                  : t("fieldAcademicYearId"),
+              },
+              ...(academicYears ?? []).map((y) => ({
+                value: y.id,
+                label: y.name,
+              })),
+            ]}
             disabled={yearsLoading}
-          >
-            <option value="">
-              {yearsLoading ? tCommon("loading") : t("fieldAcademicYearId")}
-            </option>
-            {(academicYears ?? []).map((y) => (
-              <option key={y.id} value={y.id}>
-                {y.name}
-              </option>
-            ))}
-          </select>
+          />
         </FormField>
 
         {/* 状态 */}
         <FormField label={t("fieldStatus")}>
-          <select
+          <Select
             value={status}
-            onChange={(e) => setStatus(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-          >
-            {ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => (
-              <option key={s} value={s}>
-                {formatAdminCoursePlanStatus(s)}
-              </option>
-            ))}
-          </select>
+            onValueChange={setStatus}
+            options={ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => ({
+              value: s,
+              label: formatAdminCoursePlanStatus(s),
+            }))}
+          />
         </FormField>
       </div>
+
+      {/* 学期 */}
+      <FormField label={t("fieldSemester")}>
+        <input
+          type="text"
+          value={semester}
+          onChange={(e) => setSemester(e.target.value)}
+          className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          placeholder="2026-fall"
+        />
+      </FormField>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 总课时 */}
+        <FormField label={t("fieldTotalHours")}>
+          <input
+            type="number"
+            min={0}
+            value={totalHours}
+            onChange={(e) => setTotalHours(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="120"
+          />
+        </FormField>
+
+        {/* 周课时 */}
+        <FormField label={t("fieldWeeklyHours")}>
+          <input
+            type="number"
+            min={0}
+            value={weeklyHours}
+            onChange={(e) => setWeeklyHours(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="6"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 开始日期 */}
+        <FormField label={t("fieldStartDate")}>
+          <input
+            type="date"
+            value={startDate}
+            onChange={(e) => setStartDate(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 结束日期 */}
+        <FormField label={t("fieldEndDate")}>
+          <input
+            type="date"
+            value={endDate}
+            onChange={(e) => setEndDate(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+      </div>
+
+      {/* 教学大纲 */}
+      <FormField label={t("fieldSyllabus")}>
+        <textarea
+          value={syllabus}
+          onChange={(e) => setSyllabus(e.target.value)}
+          rows={3}
+          className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+          placeholder={t("fieldSyllabus")}
+        />
+      </FormField>
+
+      {/* 教学目标 */}
+      <FormField label={t("fieldObjectives")}>
+        <textarea
+          value={objectives}
+          onChange={(e) => setObjectives(e.target.value)}
+          rows={3}
+          className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+          placeholder={t("fieldObjectives")}
+        />
+      </FormField>
+
+      {/* 教学进度（@contract-pending：周次排序为本地 state，保存时暂不同步到后端） */}
+      <div className="space-y-2">
+        <div className="flex items-center justify-between">
+          <label className="text-sm font-medium">{t("sectionSchedule")}</label>
+          <span className="text-xs text-muted-foreground">
+            {t("scheduleNotice")}
+          </span>
+        </div>
+        <div className="rounded-md border">
+          <Table>
+            <TableHeader>
+              <TableRow>
+                <TableHead className="w-16">{t("colWeek")}</TableHead>
+                <TableHead>{t("colTopic")}</TableHead>
+                <TableHead className="w-20">{t("colHours")}</TableHead>
+                <TableHead className="w-32">{t("colActions")}</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {weekItems.length === 0 ? (
+                <TableRow>
+                  <td
+                    colSpan={4}
+                    className="p-6 text-center text-sm text-muted-foreground"
+                  >
+                    {t("scheduleEmpty")}
+                  </td>
+                </TableRow>
+              ) : (
+                weekItems.map((item, idx) => (
+                  <SortableWeekRow
+                    key={item.week}
+                    item={item}
+                    canSort
+                    isFirst={idx === 0}
+                    isLast={idx === weekItems.length - 1}
+                    onMoveUp={handleMoveUp}
+                    onMoveDown={handleMoveDown}
+                  />
+                ))
+              )}
+            </TableBody>
+          </Table>
+        </div>
+      </div>
     </FormPageShell>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/course-plans/course-plan-item-editor.tsx b/apps/portal-shell/src/features/admin/course-plans/course-plan-item-editor.tsx
new file mode 100644
index 0000000..a3e2662
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/course-plans/course-plan-item-editor.tsx
@@ -0,0 +1,286 @@
+"use client";
+
+/**
+ * 周计划项编辑对话框（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 基于 CICD src/modules/course-plans/components/course-plan-item-editor.tsx 适配到 portal-shell：
+ * - Server Actions → Apollo Client mutations + MSW 兜底
+ * - 表单字段：week / topic / content / hours / textbookChapter / completedAt / notes
+ * - 支持 create / edit 双模式
+ *
+ * 数据契约：
+ * - createCoursePlanItem / updateCoursePlanItem / deleteCoursePlanItem /
+ *   toggleCoursePlanItemCompleted：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+import { Check, Trash2, X } from "lucide-react";
+
+import {
+  useCreateCoursePlanItem,
+  useDeleteCoursePlanItem,
+  useToggleCoursePlanItemCompleted,
+  useUpdateCoursePlanItem,
+  type AdminCoursePlanItem,
+  type AdminCoursePlanItemInput,
+  type AdminCoursePlanItemUpdateInput,
+} from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Textarea } from "@/shared/components/ui/textarea";
+import { notify } from "@/shared/lib/notify";
+
+export interface CoursePlanItemEditorProps {
+  planId: string;
+  item?: AdminCoursePlanItem;
+  mode: "create" | "edit";
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  onSuccess?: () => void;
+}
+
+export function CoursePlanItemEditor({
+  planId,
+  item,
+  mode,
+  open,
+  onOpenChange,
+  onSuccess,
+}: CoursePlanItemEditorProps): React.ReactElement {
+  const t = useTranslations("admin.coursePlans.itemEditor");
+  const tCommon = useTranslations("common");
+
+  const [week, setWeek] = useState<number>(1);
+  const [topic, setTopic] = useState<string>("");
+  const [content, setContent] = useState<string>("");
+  const [hours, setHours] = useState<number>(2);
+  const [textbookChapter, setTextbookChapter] = useState<string>("");
+  const [completedAt, setCompletedAt] = useState<string>("");
+  const [notes, setNotes] = useState<string>("");
+
+  const { run: createItem, loading: creating } = useCreateCoursePlanItem();
+  const { run: updateItem, loading: updating } = useUpdateCoursePlanItem();
+  const { run: deleteItem, loading: deleting } = useDeleteCoursePlanItem();
+  const { run: toggleItem, loading: toggling } =
+    useToggleCoursePlanItemCompleted();
+
+  const isWorking = creating || updating || deleting || toggling;
+
+  useEffect(() => {
+    if (open) {
+      setWeek(item?.week ?? 1);
+      setTopic(item?.topic ?? "");
+      setContent(item?.content ?? "");
+      setHours(item?.hours ?? 2);
+      setTextbookChapter(item?.textbookChapter ?? "");
+      setCompletedAt(item?.completedAt ?? "");
+      setNotes(item?.notes ?? "");
+    }
+  }, [open, item]);
+
+  const handleSubmit = async (): Promise<void> => {
+    if (!topic.trim()) {
+      notify.error(t("errorTopicRequired"));
+      return;
+    }
+
+    try {
+      if (mode === "create") {
+        const input: AdminCoursePlanItemInput = {
+          planId,
+          week,
+          topic: topic.trim(),
+          content: content.trim() || null,
+          hours,
+          textbookChapter: textbookChapter.trim() || null,
+          notes: notes.trim() || null,
+          completedAt: completedAt || null,
+        };
+        await createItem(input);
+        notify.success(t("createSuccess"));
+      } else if (item) {
+        const input: AdminCoursePlanItemUpdateInput = {
+          week,
+          topic: topic.trim(),
+          content: content.trim() || null,
+          hours,
+          textbookChapter: textbookChapter.trim() || null,
+          notes: notes.trim() || null,
+          completedAt: completedAt || null,
+        };
+        await updateItem(item.id, input);
+        notify.success(t("updateSuccess"));
+      }
+      onSuccess?.();
+      onOpenChange(false);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleDelete = async (): Promise<void> => {
+    if (!item) return;
+    try {
+      await deleteItem(item.id);
+      notify.success(t("deleteSuccess"));
+      onSuccess?.();
+      onOpenChange(false);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleToggleComplete = async (): Promise<void> => {
+    if (!item) return;
+    try {
+      await toggleItem(item.id, !item.isCompleted);
+      notify.success(t("toggleSuccess"));
+      onSuccess?.();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="max-h-[90vh] max-w-2xl overflow-y-auto">
+        <DialogHeader>
+          <DialogTitle>
+            {mode === "create" ? t("createTitle") : t("editTitle")}
+          </DialogTitle>
+        </DialogHeader>
+        <div className="space-y-4">
+          <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
+            <div className="grid gap-2">
+              <Label htmlFor="cpi-week">{t("week")}</Label>
+              <Input
+                id="cpi-week"
+                type="number"
+                min={1}
+                value={week}
+                onChange={(e) => setWeek(Number(e.target.value) || 1)}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="cpi-hours">{t("hours")}</Label>
+              <Input
+                id="cpi-hours"
+                type="number"
+                min={1}
+                value={hours}
+                onChange={(e) => setHours(Number(e.target.value) || 1)}
+              />
+            </div>
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="cpi-topic">{t("topic")}</Label>
+            <Input
+              id="cpi-topic"
+              value={topic}
+              onChange={(e) => setTopic(e.target.value)}
+              placeholder={t("topicPlaceholder")}
+            />
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="cpi-content">{t("content")}</Label>
+            <Textarea
+              id="cpi-content"
+              value={content}
+              onChange={(e) => setContent(e.target.value)}
+              placeholder={t("contentPlaceholder")}
+              className="min-h-[100px]"
+            />
+          </div>
+
+          <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
+            <div className="grid gap-2">
+              <Label htmlFor="cpi-chapter">{t("chapter")}</Label>
+              <Input
+                id="cpi-chapter"
+                value={textbookChapter}
+                onChange={(e) => setTextbookChapter(e.target.value)}
+                placeholder={t("chapterPlaceholder")}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="cpi-completedAt">{t("completedAt")}</Label>
+              <Input
+                id="cpi-completedAt"
+                type="date"
+                value={completedAt ? completedAt.slice(0, 10) : ""}
+                onChange={(e) => setCompletedAt(e.target.value)}
+              />
+            </div>
+          </div>
+
+          <div className="grid gap-2">
+            <Label htmlFor="cpi-notes">{t("notes")}</Label>
+            <Textarea
+              id="cpi-notes"
+              value={notes}
+              onChange={(e) => setNotes(e.target.value)}
+              placeholder={t("notesPlaceholder")}
+            />
+          </div>
+        </div>
+
+        <DialogFooter className="gap-2">
+          {mode === "edit" && item ? (
+            <>
+              <Button
+                type="button"
+                variant="outline"
+                onClick={handleToggleComplete}
+                disabled={isWorking}
+              >
+                {item.isCompleted ? (
+                  <>
+                    <X className="mr-2 size-4" aria-hidden="true" />
+                    {t("markIncomplete")}
+                  </>
+                ) : (
+                  <>
+                    <Check className="mr-2 size-4" aria-hidden="true" />
+                    {t("markComplete")}
+                  </>
+                )}
+              </Button>
+              <Button
+                type="button"
+                variant="destructive"
+                onClick={handleDelete}
+                disabled={isWorking}
+              >
+                <Trash2 className="mr-2 size-4" aria-hidden="true" />
+                {t("delete")}
+              </Button>
+            </>
+          ) : null}
+          <Button
+            type="button"
+            variant="outline"
+            onClick={() => onOpenChange(false)}
+            disabled={isWorking}
+          >
+            {t("cancel")}
+          </Button>
+          <Button type="button" onClick={handleSubmit} disabled={isWorking}>
+            {isWorking ? t("saving") : t("save")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/course-plans/course-plans-list-client.tsx b/apps/portal-shell/src/features/admin/course-plans/course-plans-list-client.tsx
index 86109cb..16f15a3 100644
--- a/apps/portal-shell/src/features/admin/course-plans/course-plans-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/course-plans/course-plans-list-client.tsx
@@ -17,7 +17,7 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { ClipboardList } from "lucide-react";
+import { ClipboardList, Download } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
 import { useMemo, useTransition } from "react";
@@ -25,8 +25,15 @@ import { useTranslations } from "next-intl";
 
 import { useAdminCoursePlans, type AdminCoursePlanListItem } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+import {
+  exportPlansToCsv,
+  type CoursePlanColumnLabels,
+} from "@/features/admin/course-plans/export-utils";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
+import { Progress } from "@/shared/components/ui/progress";
+import { Select } from "@/shared/components/ui/select";
 import {
   ListPageShell,
   ListPageSkeleton,
@@ -46,6 +53,7 @@ import {
 export function CoursePlansListClient(): React.ReactElement {
   const t = useTranslations("admin.coursePlans.list");
   const tCommon = useTranslations("common");
+  const tExport = useTranslations("admin.coursePlans.export");
   const router = useRouter();
   const searchParams = useSearchParams();
   const [, startTransition] = useTransition();
@@ -74,6 +82,33 @@ export function CoursePlansListClient(): React.ReactElement {
     });
   }, [data, search]);
 
+  const handleExportCsv = (): void => {
+    const items = filteredItems;
+    if (items.length === 0) {
+      notify.error(tExport("errorEmpty"));
+      return;
+    }
+    try {
+      const labels: CoursePlanColumnLabels = {
+        name: tExport("colName"),
+        className: tExport("colClass"),
+        subjectName: tExport("colSubject"),
+        teacherName: tExport("colTeacher"),
+        academicYearName: tExport("colAcademicYear"),
+        status: tExport("colStatus"),
+        createdAt: tExport("colCreatedAt"),
+        statusDraft: tExport("statusDraft"),
+        statusPublished: tExport("statusPublished"),
+        statusArchived: tExport("statusArchived"),
+      };
+      const filename = `${tExport("filename")}-${new Date().toISOString().slice(0, 10)}`;
+      exportPlansToCsv(filename, items, labels);
+      notify.success(tExport("success"));
+    } catch (err) {
+      notify.error(tExport("error", { message: String(err) }));
+    }
+  };
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -117,11 +152,22 @@ export function CoursePlansListClient(): React.ReactElement {
       description={t("description")}
       icon={<ClipboardList className="size-6" />}
       actions={
-        <Button asChild>
-          <Link href="/shell/admin/course-plans/create">
-            {t("createButton")}
-          </Link>
-        </Button>
+        <div className="flex items-center gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={handleExportCsv}
+            disabled={filteredItems.length === 0}
+          >
+            <Download className="size-4" aria-hidden="true" />
+            {tExport("button")}
+          </Button>
+          <Button asChild>
+            <Link href="/shell/admin/course-plans/create">
+              {t("createButton")}
+            </Link>
+          </Button>
+        </div>
       }
       filters={
         <>
@@ -132,19 +178,19 @@ export function CoursePlansListClient(): React.ReactElement {
           />
           <label className="flex items-center gap-2 text-sm">
             <span className="text-muted-foreground">{t("statusFilter")}</span>
-            <select
+            <Select
               value={status}
-              onChange={(e) => updateQuery("status", e.target.value)}
-              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+              onValueChange={(v) => updateQuery("status", v)}
+              options={[
+                { value: "", label: t("allStatuses") },
+                ...ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => ({
+                  value: s,
+                  label: formatAdminCoursePlanStatus(s),
+                })),
+              ]}
+              className="h-9 w-40"
               aria-label={t("statusFilter")}
-            >
-              <option value="">{t("allStatuses")}</option>
-              {ADMIN_COURSE_PLAN_STATUS_OPTIONS.map((s) => (
-                <option key={s} value={s}>
-                  {formatAdminCoursePlanStatus(s)}
-                </option>
-              ))}
-            </select>
+            />
           </label>
         </>
       }
@@ -186,6 +232,8 @@ function CoursePlansTable({
             <th className="p-3 text-left font-medium">{t("colClass")}</th>
             <th className="p-3 text-left font-medium">{t("colSubject")}</th>
             <th className="p-3 text-left font-medium">{t("colTeacher")}</th>
+            <th className="p-3 text-left font-medium">{t("colSemester")}</th>
+            <th className="p-3 text-left font-medium">{t("colProgress")}</th>
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
             <th className="p-3 text-left font-medium">{t("colUpdatedAt")}</th>
             <th className="p-3 text-right font-medium">{t("colActions")}</th>
@@ -211,6 +259,12 @@ function CoursePlansTable({
               <td className="p-3 text-muted-foreground">
                 {plan.teacherName || "-"}
               </td>
+              <td className="p-3 text-muted-foreground">
+                {plan.semester || "-"}
+              </td>
+              <td className="p-3">
+                <PlanProgress plan={plan} />
+              </td>
               <td className="p-3">
                 <StatusBadge status={plan.status} />
               </td>
@@ -243,6 +297,32 @@ function CoursePlansTable({
   );
 }
 
+/**
+ * 课程计划进度展示（进度条 + 课时文案）。
+ */
+function PlanProgress({
+  plan,
+}: {
+  plan: AdminCoursePlanListItem;
+}): React.ReactElement {
+  const t = useTranslations("admin.coursePlans.list");
+  const total = typeof plan.totalHours === "number" ? plan.totalHours : 0;
+  const completed =
+    typeof plan.completedHours === "number" ? plan.completedHours : 0;
+  if (total <= 0) {
+    return <span className="text-xs text-muted-foreground">-</span>;
+  }
+  const percent = Math.min(Math.round((completed / total) * 100), 100);
+  return (
+    <div className="flex flex-col gap-1">
+      <Progress value={percent} className="h-1.5" />
+      <span className="font-mono text-[10px] text-muted-foreground">
+        {t("progressHours", { completed, total })}
+      </span>
+    </div>
+  );
+}
+
 /**
  * 课程计划状态徽章（按状态色阶展示）。
  */
diff --git a/apps/portal-shell/src/features/admin/course-plans/export-utils.ts b/apps/portal-shell/src/features/admin/course-plans/export-utils.ts
new file mode 100644
index 0000000..df3099e
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/course-plans/export-utils.ts
@@ -0,0 +1,141 @@
+/**
+ * Admin Course Plans 导出工具（ARCHITECTURE.md §9.4 / §10 P5）
+ *
+ * 前端构造 CSV 并触发下载（@contract-pending，无后端导出契约时使用）。
+ * 后端补齐导出契约后，可改为调用后端接口获取 CSV。
+ *
+ * 设计原则：
+ * - `planToExportRows` 为纯函数，便于单测；不直接依赖 i18n，
+ *   状态文本由调用方通过 columnLabels 传入
+ * - `exportPlansToCsv` 执行客户端下载，调用方处理 notify
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import type { AdminCoursePlanListItem } from "@/lib/api";
+import { downloadBlob } from "@/shared/lib/download";
+
+/** 导出列标识（与 ExportRow 的 key 对应） */
+export type CoursePlanExportColumnKey =
+  | "name"
+  | "className"
+  | "subjectName"
+  | "teacherName"
+  | "academicYearName"
+  | "status"
+  | "createdAt";
+
+/** 列标签映射（由调用方传入已本地化的字符串） */
+export interface CoursePlanColumnLabels {
+  name: string;
+  className: string;
+  subjectName: string;
+  teacherName: string;
+  academicYearName: string;
+  status: string;
+  createdAt: string;
+  /** 状态文本：草稿 */
+  statusDraft: string;
+  /** 状态文本：已发布 */
+  statusPublished: string;
+  /** 状态文本：已归档 */
+  statusArchived: string;
+}
+
+/** 导出列定义 */
+export interface ExportColumn {
+  key: CoursePlanExportColumnKey;
+  label: string;
+}
+
+/** 导出行（键值对，键对应 ExportColumn.key） */
+export type ExportRow = Record<CoursePlanExportColumnKey, string>;
+
+/**
+ * 将管理端课程计划状态枚举映射为本地化文本。
+ * 未知状态回退为原始字符串。
+ */
+function formatStatus(status: string, labels: CoursePlanColumnLabels): string {
+  switch (status) {
+    case "DRAFT":
+      return labels.statusDraft;
+    case "PUBLISHED":
+      return labels.statusPublished;
+    case "ARCHIVED":
+      return labels.statusArchived;
+    default:
+      return status;
+  }
+}
+
+/**
+ * 构建导出列配置（按固定顺序）。
+ */
+export function buildExportColumns(
+  labels: CoursePlanColumnLabels,
+): readonly ExportColumn[] {
+  return [
+    { key: "name", label: labels.name },
+    { key: "className", label: labels.className },
+    { key: "subjectName", label: labels.subjectName },
+    { key: "teacherName", label: labels.teacherName },
+    { key: "academicYearName", label: labels.academicYearName },
+    { key: "status", label: labels.status },
+    { key: "createdAt", label: labels.createdAt },
+  ];
+}
+
+/**
+ * 将课程计划列表项转换为导出行（纯函数）。
+ *
+ * @param plan 管理端课程计划列表项
+ * @param labels 列标签 + 状态文本
+ */
+export function planToExportRows(
+  plan: AdminCoursePlanListItem,
+  labels: CoursePlanColumnLabels,
+): ExportRow {
+  return {
+    name: plan.name ?? "",
+    className: plan.className ?? "",
+    subjectName: plan.subjectName ?? "",
+    teacherName: plan.teacherName ?? "",
+    academicYearName: plan.academicYearName ?? "",
+    status: formatStatus(plan.status, labels),
+    createdAt: plan.createdAt ?? "",
+  };
+}
+
+/**
+ * 转义 CSV 字段：包含逗号 / 引号 / 换行时用双引号包裹，
+ * 内部双引号转义为两个连续双引号。
+ */
+function escapeCsvField(value: string): string {
+  if (value === "") return "";
+  const needsQuote = /[",\n\r]/.test(value);
+  const escaped = value.replace(/"/g, '""');
+  return needsQuote ? `"${escaped}"` : escaped;
+}
+
+/**
+ * 客户端导出课程计划列表为 CSV 并触发下载。
+ *
+ * @param filename 文件名（不含扩展名）
+ * @param plans 课程计划列表
+ * @param labels 列标签 + 状态文本
+ */
+export function exportPlansToCsv(
+  filename: string,
+  plans: AdminCoursePlanListItem[],
+  labels: CoursePlanColumnLabels,
+): void {
+  const columns = buildExportColumns(labels);
+  const header = columns.map((c) => escapeCsvField(c.label)).join(",");
+  const rows = plans.map((plan) => {
+    const row = planToExportRows(plan, labels);
+    return columns.map((c) => escapeCsvField(row[c.key])).join(",");
+  });
+  // 加 BOM 让 Excel 正确识别 UTF-8
+  const csv = "\uFEFF" + [header, ...rows].join("\r\n");
+  const blob = new Blob([csv], { type: "text/csv;charset=utf-8" });
+  downloadBlob(blob, `${filename}.csv`);
+}
diff --git a/apps/portal-shell/src/features/admin/course-plans/sortable-week-row.tsx b/apps/portal-shell/src/features/admin/course-plans/sortable-week-row.tsx
new file mode 100644
index 0000000..f1a9fb0
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/course-plans/sortable-week-row.tsx
@@ -0,0 +1,116 @@
+"use client";
+
+/**
+ * 可排序的周次表格行（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 设计：
+ * - 用上移 / 下移按钮替代拖拽，更稳定且对键盘 / 屏幕阅读器友好
+ * - 接收 week 数据 + onMoveUp / onMoveDown 回调，由调用方维护排序状态
+ * - 行数据形状由调用方决定（SortableWeekItem），组件不耦合具体字段
+ *
+ * 可访问性：
+ * - 上移 / 下移按钮带 aria-label
+ * - 禁用状态在首行 / 末行
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import type { JSX } from "react";
+import { useTranslations } from "next-intl";
+import { ArrowDown, ArrowUp } from "lucide-react";
+
+import { Button } from "@/shared/components/ui/button";
+import { TableCell, TableRow } from "@/shared/components/ui/table";
+import { cn } from "@/shared/lib/utils";
+
+/**
+ * 可排序的周次项数据形状（由调用方决定具体字段，至少包含 week 序号）。
+ */
+export interface SortableWeekItem {
+  /** 周次序号（1-based） */
+  week: number;
+  /** 主题（用于行展示） */
+  topic: string;
+  /** 课时数（用于行展示） */
+  hours?: number;
+  /** 备注（用于行展示） */
+  notes?: string;
+}
+
+interface SortableWeekRowProps {
+  /** 当前周次数据 */
+  item: SortableWeekItem;
+  /** 是否可排序（false 时隐藏上移 / 下移按钮） */
+  canSort: boolean;
+  /** 是否首行（禁用上移按钮） */
+  isFirst: boolean;
+  /** 是否末行（禁用下移按钮） */
+  isLast: boolean;
+  /** 上移回调 */
+  onMoveUp: (item: SortableWeekItem) => void;
+  /** 下移回调 */
+  onMoveDown: (item: SortableWeekItem) => void;
+}
+
+/**
+ * 可排序的周次表格行。
+ *
+ * 不实现 HTML5 drag-and-drop（容易出 bug 且对键盘不友好），
+ * 改用上移 / 下移按钮控制顺序，调用方维护列表状态。
+ */
+export function SortableWeekRow({
+  item,
+  canSort,
+  isFirst,
+  isLast,
+  onMoveUp,
+  onMoveDown,
+}: SortableWeekRowProps): JSX.Element {
+  const t = useTranslations("admin.coursePlans.sortableWeekRow");
+
+  return (
+    <TableRow className={cn("hover:bg-muted/30")}>
+      <TableCell className="w-16 font-medium">{item.week}</TableCell>
+      <TableCell>
+        <div className="space-y-1">
+          <p className="font-medium">{item.topic}</p>
+          {item.notes ? (
+            <p className="text-xs text-muted-foreground italic">
+              {t("notes", { notes: item.notes })}
+            </p>
+          ) : null}
+        </div>
+      </TableCell>
+      <TableCell className="w-20 text-muted-foreground">
+        {typeof item.hours === "number" ? item.hours : "—"}
+      </TableCell>
+      {canSort ? (
+        <TableCell className="w-32">
+          <div className="flex items-center gap-1">
+            <Button
+              type="button"
+              variant="ghost"
+              size="icon"
+              className="h-7 w-7"
+              onClick={() => onMoveUp(item)}
+              disabled={isFirst}
+              aria-label={t("moveUpAria", { week: item.week })}
+            >
+              <ArrowUp className="h-3.5 w-3.5" aria-hidden="true" />
+            </Button>
+            <Button
+              type="button"
+              variant="ghost"
+              size="icon"
+              className="h-7 w-7"
+              onClick={() => onMoveDown(item)}
+              disabled={isLast}
+              aria-label={t("moveDownAria", { week: item.week })}
+            >
+              <ArrowDown className="h-3.5 w-3.5" aria-hidden="true" />
+            </Button>
+          </div>
+        </TableCell>
+      ) : null}
+    </TableRow>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/course-plans/template-picker-dialog.tsx b/apps/portal-shell/src/features/admin/course-plans/template-picker-dialog.tsx
new file mode 100644
index 0000000..5220d30
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/course-plans/template-picker-dialog.tsx
@@ -0,0 +1,197 @@
+"use client";
+
+/**
+ * 课程计划模板选择对话框（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 数据契约：
+ * - 查询 coursePlanTemplates(subjectId, gradeLevel)：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 选择模板后调用 onSelect 回调，由调用方填充表单字段
+ *
+ * 设计：
+ * - 列表加载通过 useCoursePlanTemplates hook（@/lib/api）
+ * - 搜索为客户端过滤（数据量可控时性能足够）
+ * - 选择后不直接克隆，仅触发 onSelect(template)，由调用方决定如何使用
+ *
+ * 可访问性：
+ * - 对话框带 role="dialog"（由 Radix Dialog 提供）
+ * - 列表项带 aria-label 描述
+ * - 加载状态显示 aria-live="polite"
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import type { JSX } from "react";
+import { useState } from "react";
+import { useTranslations } from "next-intl";
+import { FileText, Loader2, Search } from "lucide-react";
+
+import { useCoursePlanTemplates, type CoursePlanTemplate } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { Input } from "@/shared/components/ui/input";
+import { cn } from "@/shared/lib/utils";
+
+interface TemplatePickerDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  /** 可选学科过滤 */
+  subjectId?: string;
+  /** 可选年级过滤 */
+  gradeLevel?: string;
+  /** 选中模板后的回调（由调用方决定如何使用模板数据） */
+  onSelect: (template: CoursePlanTemplate) => void;
+}
+
+/**
+ * 课程计划模板选择对话框。
+ *
+ * 列出 MSW 兜底的模板候选，支持客户端搜索过滤；
+ * 选中后调用 onSelect 回调，由调用方填充表单字段。
+ */
+export function TemplatePickerDialog({
+  open,
+  onOpenChange,
+  subjectId,
+  gradeLevel,
+  onSelect,
+}: TemplatePickerDialogProps): JSX.Element {
+  const t = useTranslations("admin.coursePlans.templates");
+  const [query, setQuery] = useState("");
+  const [selectedId, setSelectedId] = useState<string | undefined>();
+
+  // @contract-pending：MSW 兜底
+  const { data, loading } = useCoursePlanTemplates(
+    { subjectId, gradeLevel },
+    { enabled: open },
+  );
+
+  const filtered = (data ?? []).filter((tpl) => {
+    if (!query.trim()) return true;
+    const q = query.toLowerCase();
+    return (
+      tpl.name.toLowerCase().includes(q) ||
+      tpl.description.toLowerCase().includes(q) ||
+      tpl.subject.toLowerCase().includes(q) ||
+      tpl.gradeLevel.toLowerCase().includes(q)
+    );
+  });
+
+  const handleConfirm = (): void => {
+    const selected = (data ?? []).find((tpl) => tpl.id === selectedId);
+    if (!selected) {
+      notify.error(t("errorNoSelection"));
+      return;
+    }
+    try {
+      onSelect(selected);
+      onOpenChange(false);
+      setSelectedId(undefined);
+      setQuery("");
+    } catch {
+      notify.error(t("errorApply"));
+    }
+  };
+
+  const handleOpenChange = (next: boolean): void => {
+    if (!next) {
+      setSelectedId(undefined);
+      setQuery("");
+    }
+    onOpenChange(next);
+  };
+  return (
+    <Dialog open={open} onOpenChange={handleOpenChange}>
+      <DialogContent className="max-h-[80vh] max-w-2xl">
+        <DialogHeader>
+          <DialogTitle>{t("title")}</DialogTitle>
+          <DialogDescription>{t("description")}</DialogDescription>
+        </DialogHeader>
+
+        <div className="relative">
+          <Search
+            className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground"
+            aria-hidden="true"
+          />
+          <Input
+            value={query}
+            onChange={(e) => setQuery(e.target.value)}
+            placeholder={t("searchPlaceholder")}
+            className="pl-9"
+            aria-label={t("searchPlaceholder")}
+          />
+        </div>
+
+        <div className="h-80 overflow-y-auto rounded-md border">
+          {loading ? (
+            <div
+              className="flex h-full items-center justify-center gap-2 p-8 text-sm text-muted-foreground"
+              aria-live="polite"
+            >
+              <Loader2 className="h-4 w-4 animate-spin" aria-hidden="true" />
+              {t("loading")}
+            </div>
+          ) : filtered.length === 0 ? (
+            <div className="flex h-full items-center justify-center p-8 text-sm text-muted-foreground">
+              {t("empty")}
+            </div>
+          ) : (
+            <ul className="divide-y" role="listbox">
+              {filtered.map((tpl) => (
+                <li
+                  key={tpl.id}
+                  role="option"
+                  aria-selected={selectedId === tpl.id}
+                >
+                  <button
+                    type="button"
+                    onClick={() => setSelectedId(tpl.id)}
+                    className={cn(
+                      "flex w-full items-start gap-3 p-3 text-left transition-colors hover:bg-muted/50",
+                      selectedId === tpl.id && "bg-accent",
+                    )}
+                  >
+                    <FileText
+                      className="mt-0.5 h-4 w-4 shrink-0 text-muted-foreground"
+                      aria-hidden="true"
+                    />
+                    <div className="flex-1 space-y-1">
+                      <p className="font-medium">{tpl.name}</p>
+                      <p className="line-clamp-2 text-xs text-muted-foreground">
+                        {tpl.description}
+                      </p>
+                      <div className="flex flex-wrap items-center gap-1.5 pt-1">
+                        <Badge variant="outline">{tpl.subject}</Badge>
+                        <Badge variant="outline">{tpl.gradeLevel}</Badge>
+                      </div>
+                    </div>
+                  </button>
+                </li>
+              ))}
+            </ul>
+          )}
+        </div>
+
+        <DialogFooter>
+          <Button
+            variant="outline"
+            onClick={() => handleOpenChange(false)}
+            disabled={loading}
+          >
+            {t("cancel")}
+          </Button>
+          <Button onClick={handleConfirm} disabled={!selectedId || loading}>
+            {t("confirm")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/curriculum-map/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/curriculum-map/__tests__/transformations.test.ts
index 1851b7e..c357e07 100644
--- a/apps/portal-shell/src/features/admin/curriculum-map/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/curriculum-map/__tests__/transformations.test.ts
@@ -8,6 +8,7 @@ import { describe, expect, it } from "vitest";
 import type { StandardsCoverageCell } from "@/lib/api/admin-p5";
 
 import {
+  COVERAGE_CRITICAL_THRESHOLD,
   COVERAGE_HIGH_THRESHOLD,
   COVERAGE_LOW_THRESHOLD,
   COVERAGE_MEDIUM_THRESHOLD,
@@ -19,7 +20,9 @@ import {
   formatCoverageRate,
   formatLessonPlanCount,
   safeCoverageRate,
+  safeLinked,
   safeLessonPlanCount,
+  safeTotal,
 } from "../transformations";
 
 const sampleCells: StandardsCoverageCell[] = [
@@ -30,6 +33,8 @@ const sampleCells: StandardsCoverageCell[] = [
     gradeName: "高三",
     coverageRate: 0.85,
     lessonPlanCount: 8,
+    total: 10,
+    linked: 8,
   },
   {
     standardId: "std-002",
@@ -38,6 +43,8 @@ const sampleCells: StandardsCoverageCell[] = [
     gradeName: "高三",
     coverageRate: 0.4,
     lessonPlanCount: 4,
+    total: 10,
+    linked: 4,
   },
   {
     standardId: "std-001",
@@ -46,6 +53,8 @@ const sampleCells: StandardsCoverageCell[] = [
     gradeName: "高二",
     coverageRate: 0.1,
     lessonPlanCount: 1,
+    total: 10,
+    linked: 1,
   },
 ];
 
@@ -66,9 +75,13 @@ describe("coverageRateToIntensity", () => {
     expect(coverageRateToIntensity(0.49)).toBe("low");
   });
 
-  it("returns 'none' for rate < 0.2 (including 0)", () => {
+  it("returns 'critical' for 0 < rate < 0.2", () => {
+    expect(coverageRateToIntensity(0.01)).toBe("critical");
+    expect(coverageRateToIntensity(0.19)).toBe("critical");
+  });
+
+  it("returns 'none' only for rate === 0", () => {
     expect(coverageRateToIntensity(0)).toBe("none");
-    expect(coverageRateToIntensity(0.19)).toBe("none");
   });
 
   it("returns 'none' for invalid input (NaN/negative/>1)", () => {
@@ -82,24 +95,31 @@ describe("coverageRateToIntensity", () => {
     expect(COVERAGE_HIGH_THRESHOLD).toBe(0.8);
     expect(COVERAGE_MEDIUM_THRESHOLD).toBe(0.5);
     expect(COVERAGE_LOW_THRESHOLD).toBe(0.2);
+    expect(COVERAGE_CRITICAL_THRESHOLD).toBe(0.2);
   });
 });
 
 describe("coverageIntensityToCellClass", () => {
-  it("returns primary/80 class for high", () => {
+  it("returns emerald class for high", () => {
     const cls = coverageIntensityToCellClass("high");
-    expect(cls).toContain("bg-primary/80");
-    expect(cls).toContain("text-primary-foreground");
+    expect(cls).toContain("bg-emerald-500/80");
+    expect(cls).toContain("text-white");
   });
 
-  it("returns primary/40 class for medium", () => {
+  it("returns blue class for medium", () => {
     const cls = coverageIntensityToCellClass("medium");
-    expect(cls).toContain("bg-primary/40");
+    expect(cls).toContain("bg-blue-500/60");
   });
 
-  it("returns primary/15 class for low", () => {
+  it("returns amber class for low", () => {
     const cls = coverageIntensityToCellClass("low");
-    expect(cls).toContain("bg-primary/15");
+    expect(cls).toContain("bg-amber-500/70");
+  });
+
+  it("returns red class for critical", () => {
+    const cls = coverageIntensityToCellClass("critical");
+    expect(cls).toContain("bg-red-500/70");
+    expect(cls).toContain("text-white");
   });
 
   it("returns muted class for none", () => {
@@ -120,6 +140,9 @@ describe("coverageRateToCellClass", () => {
     expect(coverageRateToCellClass(0.3)).toBe(
       coverageIntensityToCellClass("low"),
     );
+    expect(coverageRateToCellClass(0.1)).toBe(
+      coverageIntensityToCellClass("critical"),
+    );
     expect(coverageRateToCellClass(0)).toBe(
       coverageIntensityToCellClass("none"),
     );
@@ -242,6 +265,8 @@ describe("buildHeatmapMatrix", () => {
     );
     expect(cellStd001Grade12?.rate).toBe(0.85);
     expect(cellStd001Grade12?.lessonPlanCount).toBe(8);
+    expect(cellStd001Grade12?.linked).toBe(8);
+    expect(cellStd001Grade12?.total).toBe(10);
   });
 
   it("fills missing combinations with rate=0", () => {
@@ -253,6 +278,8 @@ describe("buildHeatmapMatrix", () => {
     );
     expect(cellStd002Grade11?.rate).toBe(0);
     expect(cellStd002Grade11?.lessonPlanCount).toBe(0);
+    expect(cellStd002Grade11?.linked).toBe(0);
+    expect(cellStd002Grade11?.total).toBe(0);
   });
 
   it("preserves first-seen order of standards and grades", () => {
@@ -272,6 +299,7 @@ describe("buildHeatmapMatrix", () => {
         gradeName: "",
         coverageRate: 0.5,
         lessonPlanCount: 1,
+        total: 2,
       },
     ];
     const { grades } = buildHeatmapMatrix(cells);
@@ -279,6 +307,42 @@ describe("buildHeatmapMatrix", () => {
   });
 });
 
+describe("safeLinked", () => {
+  it("returns linked when present", () => {
+    expect(safeLinked({ linked: 5, lessonPlanCount: 8 })).toBe(5);
+  });
+
+  it("falls back to lessonPlanCount when linked missing", () => {
+    expect(safeLinked({ lessonPlanCount: 8 })).toBe(8);
+  });
+
+  it("returns 0 when neither field present", () => {
+    expect(safeLinked({})).toBe(0);
+  });
+
+  it("falls back to lessonPlanCount when linked is non-finite", () => {
+    expect(safeLinked({ linked: Number.NaN, lessonPlanCount: 3 })).toBe(3);
+  });
+});
+
+describe("safeTotal", () => {
+  it("returns total when present", () => {
+    expect(safeTotal({ total: 10, lessonPlanCount: 8 })).toBe(10);
+  });
+
+  it("falls back to lessonPlanCount when total missing", () => {
+    expect(safeTotal({ lessonPlanCount: 8 })).toBe(8);
+  });
+
+  it("returns 0 when neither field present", () => {
+    expect(safeTotal({})).toBe(0);
+  });
+
+  it("falls back to lessonPlanCount when total is non-finite", () => {
+    expect(safeTotal({ total: Number.NaN, lessonPlanCount: 3 })).toBe(3);
+  });
+});
+
 describe("calcAverageCoverage", () => {
   it("returns 0 for empty array", () => {
     expect(calcAverageCoverage([])).toBe(0);
@@ -299,6 +363,7 @@ describe("calcAverageCoverage", () => {
           gradeName: "高三",
           coverageRate: 0.7,
           lessonPlanCount: 1,
+          total: 2,
         },
       ]),
     ).toBe(0.7);
@@ -313,6 +378,7 @@ describe("calcAverageCoverage", () => {
         gradeName: "高三",
         coverage: 0.6,
         lessonPlanCount: 1,
+        total: 2,
       } as unknown as StandardsCoverageCell,
     ];
     expect(calcAverageCoverage(cells)).toBeCloseTo(0.6, 2);
diff --git a/apps/portal-shell/src/features/admin/curriculum-map/curriculum-map-client.tsx b/apps/portal-shell/src/features/admin/curriculum-map/curriculum-map-client.tsx
index cb5d0fa..180145f 100644
--- a/apps/portal-shell/src/features/admin/curriculum-map/curriculum-map-client.tsx
+++ b/apps/portal-shell/src/features/admin/curriculum-map/curriculum-map-client.tsx
@@ -28,6 +28,7 @@ import {
 } from "@/shared/components/page-templates";
 import {
   buildHeatmapMatrix,
+  coverageIntensityToCellClass,
   coverageRateToCellClass,
   formatCoverageRate,
   formatLessonPlanCount,
@@ -142,6 +143,9 @@ function StatsCardsGrid({
 
 /**
  * 标准覆盖热图卡片（标准 × 年级 矩阵）。
+ *
+ * 单元格显示覆盖率 + linked/total 课案数；底部附 5 档颜色图例
+ * （emerald/blue/amber/red/muted，对齐 CICD 热图分级）。
  */
 function HeatmapCard({
   matrix,
@@ -163,7 +167,12 @@ function HeatmapCard({
   return (
     <Card>
       <CardContent className="p-6">
-        <h2 className="mb-4 text-lg font-semibold">{t("list.heatmapTitle")}</h2>
+        <div className="mb-4 flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
+          <h2 className="text-lg font-semibold">{t("list.heatmapTitle")}</h2>
+          <p className="text-xs text-muted-foreground">
+            {t("list.heatmapLinkedTotalHint")}
+          </p>
+        </div>
         <div className="overflow-x-auto">
           <table className="w-full text-sm">
             <thead className="border-b bg-muted/30">
@@ -189,15 +198,20 @@ function HeatmapCard({
                       <td
                         key={`${cell.standardId}:${cell.gradeId}`}
                         className={`p-3 text-center ${cls}`}
-                        title={`${cell.standardName} / ${cell.gradeName}: ${formatCoverageRate(
-                          rate,
-                        )} (${formatLessonPlanCount(cell.lessonPlanCount)})`}
+                        title={t("list.heatmapCellTooltip", {
+                          standard: cell.standardName,
+                          grade: cell.gradeName,
+                          rate: formatCoverageRate(rate),
+                          linked: cell.linked,
+                          total: cell.total,
+                        })}
                       >
                         <div className="font-mono text-xs">
                           {formatCoverageRate(rate)}
                         </div>
-                        <div className="mt-1 text-[10px] opacity-75">
-                          {formatLessonPlanCount(cell.lessonPlanCount)}
+                        <div className="mt-1 text-[10px] opacity-80">
+                          {formatLessonPlanCount(cell.linked)}/
+                          {formatLessonPlanCount(cell.total)}
                         </div>
                       </td>
                     );
@@ -207,7 +221,36 @@ function HeatmapCard({
             </tbody>
           </table>
         </div>
+        <HeatmapLegend />
       </CardContent>
     </Card>
   );
 }
+
+/**
+ * 热图颜色图例（5 档：emerald/blue/amber/red/muted，对齐 CICD）。
+ */
+function HeatmapLegend(): React.ReactElement {
+  const t = useTranslations("admin.curriculumMap");
+  const items: Array<{ key: string; cls: string }> = [
+    { key: "legendHigh", cls: coverageIntensityToCellClass("high") },
+    { key: "legendMedium", cls: coverageIntensityToCellClass("medium") },
+    { key: "legendLow", cls: coverageIntensityToCellClass("low") },
+    { key: "legendCritical", cls: coverageIntensityToCellClass("critical") },
+    { key: "legendNone", cls: coverageIntensityToCellClass("none") },
+  ];
+  return (
+    <div className="mt-4 flex flex-wrap items-center gap-x-4 gap-y-2 text-xs text-muted-foreground">
+      <span className="font-medium">{t("list.legendTitle")}</span>
+      {items.map((item) => (
+        <div key={item.key} className="flex items-center gap-1.5">
+          <span
+            className={`inline-block size-3 rounded-sm ${item.cls}`}
+            aria-hidden="true"
+          />
+          <span>{t(`list.${item.key}`)}</span>
+        </div>
+      ))}
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/curriculum-map/transformations.ts b/apps/portal-shell/src/features/admin/curriculum-map/transformations.ts
index 96647b7..1ea7aa7 100644
--- a/apps/portal-shell/src/features/admin/curriculum-map/transformations.ts
+++ b/apps/portal-shell/src/features/admin/curriculum-map/transformations.ts
@@ -6,20 +6,23 @@
  */
 import type { StandardsCoverageCell } from "@/lib/api/admin-p5";
 
-/** 覆盖率强度等级 */
-export type CoverageIntensity = "high" | "medium" | "low" | "none";
+/** 覆盖率强度等级（5 档：none/critical/low/medium/high，对齐 CICD 热图分级） */
+export type CoverageIntensity = "high" | "medium" | "low" | "critical" | "none";
 
 /** 覆盖率百分比下限阈值（与 coverageRateToIntensity 对齐） */
 export const COVERAGE_HIGH_THRESHOLD = 0.8;
 export const COVERAGE_MEDIUM_THRESHOLD = 0.5;
 export const COVERAGE_LOW_THRESHOLD = 0.2;
+/** critical 档上界（与 low 档下界对齐，仅 0 视为 none） */
+export const COVERAGE_CRITICAL_THRESHOLD = 0.2;
 
 /**
- * 将覆盖率（0-1）映射为强度等级。
- * - >= 0.8 → high
- * - >= 0.5 → medium
- * - >= 0.2 → low
- * - < 0.2（含 0） → none
+ * 将覆盖率（0-1）映射为 5 档强度等级（对齐 CICD red/amber/blue/emerald/muted）。
+ * - >= 0.8 → high（emerald）
+ * - >= 0.5 → medium（blue）
+ * - >= 0.2 → low（amber）
+ * - > 0    → critical（red）
+ * - === 0  → none（muted）
  * 输入无效（NaN/负数/大于 1）→ none
  */
 export function coverageRateToIntensity(rate: number): CoverageIntensity {
@@ -29,26 +32,31 @@ export function coverageRateToIntensity(rate: number): CoverageIntensity {
   if (rate >= COVERAGE_HIGH_THRESHOLD) return "high";
   if (rate >= COVERAGE_MEDIUM_THRESHOLD) return "medium";
   if (rate >= COVERAGE_LOW_THRESHOLD) return "low";
+  if (rate > 0) return "critical";
   return "none";
 }
 
 /**
- * 根据覆盖率返回 Tailwind 单元格背景类名（语义色阶，避免硬编码 #hex）。
- * - high   → bg-primary/80 text-primary-foreground
- * - medium → bg-primary/40 text-foreground
- * - low    → bg-primary/15 text-foreground
- * - none   → bg-muted text-muted-foreground
+ * 根据强度返回 Tailwind 单元格背景类名（5 档语义色阶，对齐 CICD 热图）。
+ * 使用标准 Tailwind bg-* 类（非 #hex 字面量、非任意值）。
+ * - high     → bg-emerald-500/80 text-white
+ * - medium   → bg-blue-500/60 text-white
+ * - low      → bg-amber-500/70 text-foreground
+ * - critical → bg-red-500/70 text-white
+ * - none     → bg-muted text-muted-foreground
  */
 export function coverageIntensityToCellClass(
   intensity: CoverageIntensity,
 ): string {
   switch (intensity) {
     case "high":
-      return "bg-primary/80 text-primary-foreground";
+      return "bg-emerald-500/80 text-white";
     case "medium":
-      return "bg-primary/40 text-foreground";
+      return "bg-blue-500/60 text-white";
     case "low":
-      return "bg-primary/15 text-foreground";
+      return "bg-amber-500/70 text-foreground";
+    case "critical":
+      return "bg-red-500/70 text-white";
     case "none":
     default:
       return "bg-muted text-muted-foreground";
@@ -124,6 +132,34 @@ export function safeLessonPlanCount(cell: {
   return 0;
 }
 
+/**
+ * 安全读取 cell.linked（已关联教案数，对齐 CICD linked/total 口径）。
+ * linked 缺失时回退到 lessonPlanCount（两者同义）。
+ */
+export function safeLinked(cell: {
+  linked?: number;
+  lessonPlanCount?: number;
+}): number {
+  if (typeof cell.linked === "number" && Number.isFinite(cell.linked)) {
+    return cell.linked;
+  }
+  return safeLessonPlanCount(cell);
+}
+
+/**
+ * 安全读取 cell.total（应覆盖总课时数，对齐 CICD linked/total 口径）。
+ * total 缺失时回退到 lessonPlanCount（避免 0/0 显示）。
+ */
+export function safeTotal(cell: {
+  total?: number;
+  lessonPlanCount?: number;
+}): number {
+  if (typeof cell.total === "number" && Number.isFinite(cell.total)) {
+    return cell.total;
+  }
+  return safeLessonPlanCount(cell);
+}
+
 /** 热图矩阵行：标准 → 各年级的覆盖率 */
 export interface HeatmapRow {
   standardId: string;
@@ -131,7 +167,7 @@ export interface HeatmapRow {
   cells: HeatmapCell[];
 }
 
-/** 热图单元格 */
+/** 热图单元格（含 linked/total 课案数，对齐 CICD 口径） */
 export interface HeatmapCell {
   standardId: string;
   standardName: string;
@@ -139,6 +175,10 @@ export interface HeatmapCell {
   gradeName: string;
   rate: number;
   lessonPlanCount: number;
+  /** 已关联教案数（linked，对齐 CICD） */
+  linked: number;
+  /** 应覆盖总课时数（total，对齐 CICD） */
+  total: number;
 }
 
 /**
@@ -195,6 +235,8 @@ export function buildHeatmapMatrix(
         gradeName: g.gradeName,
         rate: cell ? safeCoverageRate(cell) : 0,
         lessonPlanCount: cell ? safeLessonPlanCount(cell) : 0,
+        linked: cell ? safeLinked(cell) : 0,
+        total: cell ? safeTotal(cell) : 0,
       };
     }),
   }));
diff --git a/apps/portal-shell/src/features/admin/elective/elective-create-client.tsx b/apps/portal-shell/src/features/admin/elective/elective-create-client.tsx
index ea5859b..b63bf28 100644
--- a/apps/portal-shell/src/features/admin/elective/elective-create-client.tsx
+++ b/apps/portal-shell/src/features/admin/elective/elective-create-client.tsx
@@ -20,13 +20,23 @@ import { useRouter } from "next/navigation";
 import { useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useGrades, useTeacherOptions } from "@/lib/api/admin-p5";
+import {
+  useAdminCreateElective,
+  useGrades,
+  useTeacherOptions,
+} from "@/lib/api/admin-p5";
 import { FormPageShell } from "@/shared/components/page-templates";
+import { Select } from "@/shared/components/ui/select";
 import { notify } from "@/shared/lib/notify";
-import { formatElectiveStatus } from "@/features/admin/elective/transformations";
+import {
+  formatElectiveStatus,
+  formatElectiveSelectionMode,
+} from "@/features/admin/elective/transformations";
 
 /** 状态选项（与 admin.elective.list i18n 对齐） */
 const STATUS_OPTIONS = ["DRAFT", "OPEN", "CLOSED", "FULL"] as const;
+/** 选课模式选项（@contract-pending：FIRST_COME | LOTTERY） */
+const SELECTION_MODE_OPTIONS = ["FIRST_COME", "LOTTERY"] as const;
 
 /**
  * 新建表单客户端主体。需由 server page 包裹在 <Suspense> 中。
@@ -40,6 +50,7 @@ export function ElectiveCreateClient(): React.ReactElement {
   // @contract-pending：MSW 兜底
   const { data: grades, loading: gradesLoading } = useGrades();
   const { data: teachers, loading: teachersLoading } = useTeacherOptions();
+  const { run: createElective, loading: creating } = useAdminCreateElective();
 
   const [name, setName] = useState("");
   const [description, setDescription] = useState("");
@@ -47,10 +58,16 @@ export function ElectiveCreateClient(): React.ReactElement {
   const [gradeId, setGradeId] = useState("");
   const [teacherId, setTeacherId] = useState("");
   const [capacity, setCapacity] = useState("");
+  const [credit, setCredit] = useState("");
+  const [classroom, setClassroom] = useState("");
+  const [schedule, setSchedule] = useState("");
+  const [selectionMode, setSelectionMode] = useState<string>("FIRST_COME");
   const [startDate, setStartDate] = useState("");
   const [endDate, setEndDate] = useState("");
+  const [selectionStartAt, setSelectionStartAt] = useState("");
+  const [selectionEndAt, setSelectionEndAt] = useState("");
+  const [dropDeadline, setDropDeadline] = useState("");
   const [status, setStatus] = useState<string>("DRAFT");
-  const [submitting, setSubmitting] = useState(false);
   const [formError, setFormError] = useState<string | null>(null);
 
   const handleSubmit = async (): Promise<void> => {
@@ -70,11 +87,29 @@ export function ElectiveCreateClient(): React.ReactElement {
       return;
     }
 
-    setSubmitting(true);
     try {
-      // @contract-pending：createElective mutation 契约未补齐
-      // 当前通过 MSW 兜底模拟提交成功，后端补齐后切换为真实 mutation
-      await new Promise((resolve) => setTimeout(resolve, 300));
+      const creditNum = credit ? Number.parseInt(credit, 10) : undefined;
+      await createElective({
+        name: name.trim(),
+        description: description.trim() || undefined,
+        subjectId: subjectId.trim(),
+        gradeId,
+        teacherId: teacherId || undefined,
+        capacity: capacityNum,
+        credit:
+          creditNum !== undefined && Number.isFinite(creditNum)
+            ? creditNum
+            : undefined,
+        classroom: classroom.trim() || undefined,
+        schedule: schedule.trim() || undefined,
+        selectionMode,
+        startDate: startDate || undefined,
+        endDate: endDate || undefined,
+        selectionStartAt: selectionStartAt || undefined,
+        selectionEndAt: selectionEndAt || undefined,
+        dropDeadline: dropDeadline || undefined,
+        status,
+      });
       notify.success(t("success"));
       startTransition(() => {
         router.push("/shell/admin/elective");
@@ -82,8 +117,6 @@ export function ElectiveCreateClient(): React.ReactElement {
     } catch (err) {
       setFormError(`${t("error")}: ${String(err)}`);
       notify.error(tCommon("error.loadFailed", { message: String(err) }));
-    } finally {
-      setSubmitting(false);
     }
   };
 
@@ -94,7 +127,7 @@ export function ElectiveCreateClient(): React.ReactElement {
       icon={<BookOpen className="size-6" />}
       backHref="/shell/admin/elective"
       onSubmit={handleSubmit}
-      submitting={submitting}
+      submitting={creating}
       submitLabel={t("submit")}
       cancelLabel={t("cancel")}
       errorSummary={
@@ -141,46 +174,50 @@ export function ElectiveCreateClient(): React.ReactElement {
 
         {/* 年级 */}
         <FormField label={t("fieldGradeId")}>
-          <select
+          <Select
             value={gradeId}
-            onChange={(e) => setGradeId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setGradeId}
+            options={[
+              {
+                value: "",
+                label: gradesLoading ? tCommon("loading") : t("fieldGradeId"),
+              },
+              ...(grades ?? []).map((g) => ({
+                value: g.id,
+                label: g.name,
+              })),
+            ]}
             disabled={gradesLoading}
-          >
-            <option value="">
-              {gradesLoading ? tCommon("loading") : t("fieldGradeId")}
-            </option>
-            {(grades ?? []).map((g) => (
-              <option key={g.id} value={g.id}>
-                {g.name}
-              </option>
-            ))}
-          </select>
+            className="h-9 w-full"
+          />
         </FormField>
       </div>
 
       <div className="grid grid-cols-2 gap-4">
         {/* 教师 */}
         <FormField label={t("fieldTeacherId")}>
-          <select
+          <Select
             value={teacherId}
-            onChange={(e) => setTeacherId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setTeacherId}
+            options={[
+              {
+                value: "",
+                label: teachersLoading
+                  ? tCommon("loading")
+                  : t("fieldTeacherId"),
+              },
+              ...(teachers ?? []).map((teacher) => ({
+                value: teacher.id,
+                label: teacher.name,
+              })),
+            ]}
             disabled={teachersLoading}
-          >
-            <option value="">
-              {teachersLoading ? tCommon("loading") : t("fieldTeacherId")}
-            </option>
-            {(teachers ?? []).map((teacher) => (
-              <option key={teacher.id} value={teacher.id}>
-                {teacher.name}
-              </option>
-            ))}
-          </select>
+            className="h-9 w-full"
+          />
         </FormField>
 
         {/* 容量 */}
-        <FormField label={t("fieldCapacity")}>
+        <FormField label={t("fieldCapacity")} required>
           <input
             type="number"
             min={1}
@@ -188,6 +225,59 @@ export function ElectiveCreateClient(): React.ReactElement {
             onChange={(e) => setCapacity(e.target.value)}
             className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
             placeholder="30"
+            required
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 学分 */}
+        <FormField label={t("fieldCredit")}>
+          <input
+            type="number"
+            min={0}
+            step={0.5}
+            value={credit}
+            onChange={(e) => setCredit(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="2"
+          />
+        </FormField>
+
+        {/* 选课模式 */}
+        <FormField label={t("fieldSelectionMode")}>
+          <Select
+            value={selectionMode}
+            onValueChange={setSelectionMode}
+            options={SELECTION_MODE_OPTIONS.map((m) => ({
+              value: m,
+              label: formatElectiveSelectionMode(m),
+            }))}
+            className="h-9 w-full"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 教室 */}
+        <FormField label={t("fieldClassroom")}>
+          <input
+            type="text"
+            value={classroom}
+            onChange={(e) => setClassroom(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder={t("fieldClassroom")}
+          />
+        </FormField>
+
+        {/* 上课时间 */}
+        <FormField label={t("fieldSchedule")}>
+          <input
+            type="text"
+            value={schedule}
+            onChange={(e) => setSchedule(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder={t("fieldSchedule")}
           />
         </FormField>
       </div>
@@ -214,20 +304,52 @@ export function ElectiveCreateClient(): React.ReactElement {
         </FormField>
       </div>
 
-      {/* 状态 */}
-      <FormField label={t("fieldStatus")}>
-        <select
-          value={status}
-          onChange={(e) => setStatus(e.target.value)}
-          className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-        >
-          {STATUS_OPTIONS.map((s) => (
-            <option key={s} value={s}>
-              {formatElectiveStatus(s)}
-            </option>
-          ))}
-        </select>
-      </FormField>
+      <div className="grid grid-cols-2 gap-4">
+        {/* 选课开始时间 */}
+        <FormField label={t("fieldSelectionStartAt")}>
+          <input
+            type="datetime-local"
+            value={selectionStartAt}
+            onChange={(e) => setSelectionStartAt(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 选课结束时间 */}
+        <FormField label={t("fieldSelectionEndAt")}>
+          <input
+            type="datetime-local"
+            value={selectionEndAt}
+            onChange={(e) => setSelectionEndAt(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 退课截止时间 */}
+        <FormField label={t("fieldDropDeadline")}>
+          <input
+            type="datetime-local"
+            value={dropDeadline}
+            onChange={(e) => setDropDeadline(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 状态 */}
+        <FormField label={t("fieldStatus")}>
+          <Select
+            value={status}
+            onValueChange={setStatus}
+            options={STATUS_OPTIONS.map((s) => ({
+              value: s,
+              label: formatElectiveStatus(s),
+            }))}
+            className="h-9 w-full"
+          />
+        </FormField>
+      </div>
 
       {/* @contract-pending 提示 */}
       <p className="text-xs text-muted-foreground">{t("contractPending")}</p>
diff --git a/apps/portal-shell/src/features/admin/elective/elective-detail-client.tsx b/apps/portal-shell/src/features/admin/elective/elective-detail-client.tsx
index c95cdb7..eb53389 100644
--- a/apps/portal-shell/src/features/admin/elective/elective-detail-client.tsx
+++ b/apps/portal-shell/src/features/admin/elective/elective-detail-client.tsx
@@ -13,15 +13,23 @@
  *
  * 关联：ARCHITECTURE.md §5.5 / §7.3 / §9.4 / §10 P5 / §11.3
  */
-import { BookOpen } from "lucide-react";
+import { BookOpen, Trash2 } from "lucide-react";
 import Link from "next/link";
-import { useParams } from "next/navigation";
+import { useParams, useRouter } from "next/navigation";
+import { useState } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAdminElective } from "@/lib/api/admin-p5";
+import {
+  useAdminElective,
+  useCloseElectiveSelection,
+  useDeleteElective,
+  useOpenElectiveSelection,
+  useRunElectiveLottery,
+} from "@/lib/api/admin-p5";
 import type { AdminElective } from "@/lib/api/admin-p5";
 import { Button } from "@/shared/components/ui/button";
 import { Card, CardContent } from "@/shared/components/ui/card";
+import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog";
 import {
   DetailPageShell,
   DetailPageSkeleton,
@@ -33,6 +41,8 @@ import {
   electiveStatusToBadgeClass,
   enrollmentRateToColorClass,
   formatElectiveDate,
+  formatElectiveDateOnly,
+  formatElectiveSelectionMode,
   formatElectiveStatus,
   formatEnrollmentCount,
   getEnrolledCount,
@@ -41,6 +51,7 @@ import {
   isElectiveEditable,
   type FlexibleElectiveItem,
 } from "@/features/admin/elective/transformations";
+import { notify } from "@/shared/lib/notify";
 
 /**
  * 详情客户端主体。需由 server page 包裹在 <Suspense> 中。
@@ -48,11 +59,62 @@ import {
 export function ElectiveDetailClient(): React.ReactElement {
   const t = useTranslations("admin.elective.detail");
   const tCommon = useTranslations("common");
+  const router = useRouter();
   const params = useParams<{ id: string }>();
   const electiveId = params?.id ?? "";
 
   // @contract-pending：MSW 兜底
-  const { data, loading, error } = useAdminElective(electiveId);
+  const { data, loading, error, refetch } = useAdminElective(electiveId);
+  const { run: deleteElective, loading: deleting } = useDeleteElective();
+  const { run: openSelection, loading: opening } = useOpenElectiveSelection();
+  const { run: closeSelection, loading: closing } = useCloseElectiveSelection();
+  const { run: runLottery, loading: lotterying } = useRunElectiveLottery();
+  const [deleteOpen, setDeleteOpen] = useState(false);
+
+  const handleDelete = async (): Promise<void> => {
+    try {
+      await deleteElective(electiveId);
+      notify.success(t("deleteSuccess"));
+      setDeleteOpen(false);
+      router.push("/shell/admin/elective");
+    } catch (err) {
+      notify.error(t("deleteFailed"));
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleOpen = async (): Promise<void> => {
+    try {
+      await openSelection(electiveId);
+      notify.success(t("openSuccess"));
+      void refetch();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleClose = async (): Promise<void> => {
+    try {
+      await closeSelection(electiveId);
+      notify.success(t("closeSuccess"));
+      void refetch();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleLottery = async (): Promise<void> => {
+    try {
+      await runLottery(electiveId);
+      notify.success(t("lotterySuccess"));
+      void refetch();
+    } catch (err) {
+      notify.error(t("lotteryFailed"));
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const actionLoading = opening || closing || lotterying;
 
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
@@ -62,6 +124,8 @@ export function ElectiveDetailClient(): React.ReactElement {
     </div>
   ) : undefined;
 
+  const status = data?.status ?? "";
+
   return (
     <DetailPageShell
       title={data?.name ?? t("title")}
@@ -69,12 +133,52 @@ export function ElectiveDetailClient(): React.ReactElement {
       icon={<BookOpen className="size-6" />}
       backHref="/shell/admin/elective"
       actions={
-        data && isElectiveEditable(data.status) ? (
-          <Button asChild variant="outline">
-            <Link href={`/shell/admin/elective/${data.id}/edit`}>
-              {t("edit")}
-            </Link>
-          </Button>
+        data ? (
+          <div className="flex items-center gap-2">
+            {isElectiveEditable(data.status) ? (
+              <Button asChild variant="outline">
+                <Link href={`/shell/admin/elective/${data.id}/edit`}>
+                  {t("edit")}
+                </Link>
+              </Button>
+            ) : null}
+            {status === "DRAFT" ? (
+              <Button
+                variant="outline"
+                onClick={() => void handleOpen()}
+                disabled={actionLoading}
+              >
+                {t("openSelection")}
+              </Button>
+            ) : null}
+            {status === "OPEN" || status === "FULL" ? (
+              <Button
+                variant="outline"
+                onClick={() => void handleClose()}
+                disabled={actionLoading}
+              >
+                {t("closeSelection")}
+              </Button>
+            ) : null}
+            {data.selectionMode === "LOTTERY" && status !== "DRAFT" ? (
+              <Button
+                variant="outline"
+                onClick={() => void handleLottery()}
+                disabled={actionLoading}
+              >
+                {t("runLottery")}
+              </Button>
+            ) : null}
+            <Button
+              variant="outline"
+              className="text-destructive hover:bg-destructive/10 hover:text-destructive"
+              onClick={() => setDeleteOpen(true)}
+              disabled={deleting}
+            >
+              <Trash2 className="mr-2 size-4" aria-hidden="true" />
+              {t("delete")}
+            </Button>
+          </div>
         ) : null
       }
       loading={loading}
@@ -89,6 +193,17 @@ export function ElectiveDetailClient(): React.ReactElement {
       }
     >
       {data ? <ElectiveDetailBody elective={data} /> : null}
+
+      <ConfirmDeleteDialog
+        open={deleteOpen}
+        onOpenChange={setDeleteOpen}
+        title={t("deleteTitle")}
+        description={t("deleteDescription")}
+        confirmText={t("deleteConfirm")}
+        cancelText={t("deleteCancel")}
+        onConfirm={handleDelete}
+        isWorking={deleting}
+      />
     </DetailPageShell>
   );
 }
@@ -132,6 +247,28 @@ function ElectiveDetailBody({
           label={t("fieldStatus")}
           value={<StatusBadge status={elective.status} />}
         />
+        <DetailField
+          label={t("fieldCredit")}
+          value={
+            typeof elective.credit === "number" ? String(elective.credit) : "-"
+          }
+        />
+        <DetailField
+          label={t("fieldClassroom")}
+          value={elective.classroom || "-"}
+        />
+        <DetailField
+          label={t("fieldSchedule")}
+          value={elective.schedule || "-"}
+        />
+        <DetailField
+          label={t("fieldSelectionMode")}
+          value={
+            elective.selectionMode
+              ? formatElectiveSelectionMode(elective.selectionMode)
+              : "-"
+          }
+        />
       </DetailSection>
 
       <DetailSection title={t("sectionSchedule")}>
@@ -153,6 +290,26 @@ function ElectiveDetailBody({
             </span>
           }
         />
+        <DetailField
+          label={t("fieldStartDate")}
+          value={formatElectiveDateOnly(elective.startDate)}
+        />
+        <DetailField
+          label={t("fieldEndDate")}
+          value={formatElectiveDateOnly(elective.endDate)}
+        />
+        <DetailField
+          label={t("fieldSelectionStart")}
+          value={formatElectiveDate(elective.selectionStartAt)}
+        />
+        <DetailField
+          label={t("fieldSelectionEnd")}
+          value={formatElectiveDate(elective.selectionEndAt)}
+        />
+        <DetailField
+          label={t("fieldDropDeadline")}
+          value={formatElectiveDate(elective.dropDeadline)}
+        />
       </DetailSection>
 
       <Card>
@@ -173,6 +330,9 @@ function ElectiveDetailBody({
                     <th className="p-3 text-left font-medium">
                       {t("enrollmentStudentNo")}
                     </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("enrollmentPriority")}
+                    </th>
                     <th className="p-3 text-left font-medium">
                       {t("enrollmentEnrolledAt")}
                     </th>
@@ -188,7 +348,14 @@ function ElectiveDetailBody({
                         {selection.studentId}
                       </td>
                       <td className="p-3 font-mono text-xs text-muted-foreground">
-                        {formatElectiveDate(selection.selectedAt)}
+                        {typeof selection.priority === "number"
+                          ? selection.priority
+                          : "-"}
+                      </td>
+                      <td className="p-3 font-mono text-xs text-muted-foreground">
+                        {formatElectiveDate(
+                          selection.enrolledAt ?? selection.selectedAt,
+                        )}
                       </td>
                     </tr>
                   ))}
diff --git a/apps/portal-shell/src/features/admin/elective/elective-edit-client.tsx b/apps/portal-shell/src/features/admin/elective/elective-edit-client.tsx
index 6a453b9..cc6f23a 100644
--- a/apps/portal-shell/src/features/admin/elective/elective-edit-client.tsx
+++ b/apps/portal-shell/src/features/admin/elective/elective-edit-client.tsx
@@ -21,13 +21,16 @@ import { useTranslations } from "next-intl";
 
 import {
   useAdminElective,
+  useAdminUpdateElective,
   useGrades,
   useTeacherOptions,
 } from "@/lib/api/admin-p5";
 import { FormPageShell } from "@/shared/components/page-templates";
+import { Select } from "@/shared/components/ui/select";
 import { notify } from "@/shared/lib/notify";
 import {
   formatElectiveStatus,
+  formatElectiveSelectionMode,
   getGradeName,
   getSubjectName,
   type FlexibleElectiveItem,
@@ -35,6 +38,30 @@ import {
 
 /** 状态选项（与 admin.elective.list i18n 对齐） */
 const STATUS_OPTIONS = ["DRAFT", "OPEN", "CLOSED", "FULL"] as const;
+/** 选课模式选项（@contract-pending：FIRST_COME | LOTTERY） */
+const SELECTION_MODE_OPTIONS = ["FIRST_COME", "LOTTERY"] as const;
+
+/**
+ * 将 ISO 时间字符串转换为 datetime-local input 所需的本地时间格式。
+ * 输入：2026-09-01T08:00:00.000Z 或 2026-09-01T08:00:00
+ * 输出：2026-09-01T08:00（截断到分钟）
+ * 空值或无效输入返回空字符串。
+ */
+function isoToDatetimeLocal(iso: string | undefined | null): string {
+  if (!iso || typeof iso !== "string") return "";
+  // 取到分钟：截断毫秒和时区，保留 YYYY-MM-DDTHH:mm
+  const match = iso.match(/^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2})/);
+  return match?.[1] ?? "";
+}
+
+/**
+ * 将日期 ISO 字符串转换为 date input 所需的 YYYY-MM-DD 格式。
+ */
+function isoToDate(iso: string | undefined | null): string {
+  if (!iso || typeof iso !== "string") return "";
+  const match = iso.match(/^(\d{4}-\d{2}-\d{2})/);
+  return match?.[1] ?? "";
+}
 
 /**
  * 编辑表单客户端主体。需由 server page 包裹在 <Suspense> 中。
@@ -51,6 +78,7 @@ export function ElectiveEditClient(): React.ReactElement {
   const { data, loading, error } = useAdminElective(electiveId);
   const { data: grades, loading: gradesLoading } = useGrades();
   const { data: teachers, loading: teachersLoading } = useTeacherOptions();
+  const { run: updateElective, loading: updating } = useAdminUpdateElective();
 
   const [name, setName] = useState("");
   const [description, setDescription] = useState("");
@@ -58,10 +86,16 @@ export function ElectiveEditClient(): React.ReactElement {
   const [gradeId, setGradeId] = useState("");
   const [teacherId, setTeacherId] = useState("");
   const [capacity, setCapacity] = useState("");
+  const [credit, setCredit] = useState("");
+  const [classroom, setClassroom] = useState("");
+  const [schedule, setSchedule] = useState("");
+  const [selectionMode, setSelectionMode] = useState<string>("FIRST_COME");
   const [startDate, setStartDate] = useState("");
   const [endDate, setEndDate] = useState("");
+  const [selectionStartAt, setSelectionStartAt] = useState("");
+  const [selectionEndAt, setSelectionEndAt] = useState("");
+  const [dropDeadline, setDropDeadline] = useState("");
   const [status, setStatus] = useState<string>("DRAFT");
-  const [submitting, setSubmitting] = useState(false);
   const [formError, setFormError] = useState<string | null>(null);
   const [initialized, setInitialized] = useState(false);
 
@@ -77,6 +111,15 @@ export function ElectiveEditClient(): React.ReactElement {
       setCapacity(
         typeof data.capacity === "number" ? String(data.capacity) : "",
       );
+      setCredit(typeof data.credit === "number" ? String(data.credit) : "");
+      setClassroom(data.classroom ?? "");
+      setSchedule(data.schedule ?? "");
+      setSelectionMode(data.selectionMode ?? "FIRST_COME");
+      setStartDate(isoToDate(data.startDate));
+      setEndDate(isoToDate(data.endDate));
+      setSelectionStartAt(isoToDatetimeLocal(data.selectionStartAt));
+      setSelectionEndAt(isoToDatetimeLocal(data.selectionEndAt));
+      setDropDeadline(isoToDatetimeLocal(data.dropDeadline));
       setStatus(data.status ?? "DRAFT");
       setInitialized(true);
     }
@@ -93,17 +136,41 @@ export function ElectiveEditClient(): React.ReactElement {
       setFormError(t("errorSubjectRequired"));
       return;
     }
-    const capacityNum = Number.parseInt(capacity, 10);
-    if (capacity && (!Number.isFinite(capacityNum) || capacityNum <= 0)) {
+    const capacityNum = capacity ? Number.parseInt(capacity, 10) : undefined;
+    if (
+      capacity &&
+      (capacityNum === undefined ||
+        !Number.isFinite(capacityNum) ||
+        capacityNum <= 0)
+    ) {
       setFormError(t("errorCapacityInvalid"));
       return;
     }
 
-    setSubmitting(true);
     try {
-      // @contract-pending：updateElective mutation 契约未补齐
-      // 当前通过 MSW 兜底模拟提交成功，后端补齐后切换为真实 mutation
-      await new Promise((resolve) => setTimeout(resolve, 300));
+      const creditNum = credit ? Number.parseInt(credit, 10) : undefined;
+      await updateElective({
+        id: electiveId,
+        name: name.trim(),
+        description: description.trim() || undefined,
+        subjectId: subjectId.trim(),
+        gradeId,
+        teacherId: teacherId || undefined,
+        capacity: capacityNum,
+        credit:
+          creditNum !== undefined && Number.isFinite(creditNum)
+            ? creditNum
+            : undefined,
+        classroom: classroom.trim() || undefined,
+        schedule: schedule.trim() || undefined,
+        selectionMode,
+        startDate: startDate || undefined,
+        endDate: endDate || undefined,
+        selectionStartAt: selectionStartAt || undefined,
+        selectionEndAt: selectionEndAt || undefined,
+        dropDeadline: dropDeadline || undefined,
+        status,
+      });
       notify.success(t("success"));
       startTransition(() => {
         router.push(`/shell/admin/elective/${electiveId}`);
@@ -111,8 +178,6 @@ export function ElectiveEditClient(): React.ReactElement {
     } catch (err) {
       setFormError(`${t("error")}: ${String(err)}`);
       notify.error(tCommon("error.loadFailed", { message: String(err) }));
-    } finally {
-      setSubmitting(false);
     }
   };
 
@@ -149,7 +214,7 @@ export function ElectiveEditClient(): React.ReactElement {
       icon={<BookOpen className="size-6" />}
       backHref={`/shell/admin/elective/${electiveId}`}
       onSubmit={handleSubmit}
-      submitting={submitting}
+      submitting={updating}
       submitLabel={t("submit")}
       cancelLabel={t("cancel")}
       errorSummary={
@@ -196,42 +261,46 @@ export function ElectiveEditClient(): React.ReactElement {
 
         {/* 年级 */}
         <FormField label={t("fieldGradeId")}>
-          <select
+          <Select
             value={gradeId}
-            onChange={(e) => setGradeId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setGradeId}
+            options={[
+              {
+                value: "",
+                label: gradesLoading ? tCommon("loading") : t("fieldGradeId"),
+              },
+              ...(grades ?? []).map((g) => ({
+                value: g.id,
+                label: g.name,
+              })),
+            ]}
             disabled={gradesLoading}
-          >
-            <option value="">
-              {gradesLoading ? tCommon("loading") : t("fieldGradeId")}
-            </option>
-            {(grades ?? []).map((g) => (
-              <option key={g.id} value={g.id}>
-                {g.name}
-              </option>
-            ))}
-          </select>
+            className="h-9 w-full"
+          />
         </FormField>
       </div>
 
       <div className="grid grid-cols-2 gap-4">
         {/* 教师 */}
         <FormField label={t("fieldTeacherId")}>
-          <select
+          <Select
             value={teacherId}
-            onChange={(e) => setTeacherId(e.target.value)}
-            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            onValueChange={setTeacherId}
+            options={[
+              {
+                value: "",
+                label: teachersLoading
+                  ? tCommon("loading")
+                  : t("fieldTeacherId"),
+              },
+              ...(teachers ?? []).map((teacher) => ({
+                value: teacher.id,
+                label: teacher.name,
+              })),
+            ]}
             disabled={teachersLoading}
-          >
-            <option value="">
-              {teachersLoading ? tCommon("loading") : t("fieldTeacherId")}
-            </option>
-            {(teachers ?? []).map((teacher) => (
-              <option key={teacher.id} value={teacher.id}>
-                {teacher.name}
-              </option>
-            ))}
-          </select>
+            className="h-9 w-full"
+          />
         </FormField>
 
         {/* 容量 */}
@@ -247,6 +316,58 @@ export function ElectiveEditClient(): React.ReactElement {
         </FormField>
       </div>
 
+      <div className="grid grid-cols-2 gap-4">
+        {/* 学分 */}
+        <FormField label={t("fieldCredit")}>
+          <input
+            type="number"
+            min={0}
+            step={0.5}
+            value={credit}
+            onChange={(e) => setCredit(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder="2"
+          />
+        </FormField>
+
+        {/* 选课模式 */}
+        <FormField label={t("fieldSelectionMode")}>
+          <Select
+            value={selectionMode}
+            onValueChange={setSelectionMode}
+            options={SELECTION_MODE_OPTIONS.map((m) => ({
+              value: m,
+              label: formatElectiveSelectionMode(m),
+            }))}
+            className="h-9 w-full"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 教室 */}
+        <FormField label={t("fieldClassroom")}>
+          <input
+            type="text"
+            value={classroom}
+            onChange={(e) => setClassroom(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder={t("fieldClassroom")}
+          />
+        </FormField>
+
+        {/* 上课时间 */}
+        <FormField label={t("fieldSchedule")}>
+          <input
+            type="text"
+            value={schedule}
+            onChange={(e) => setSchedule(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            placeholder={t("fieldSchedule")}
+          />
+        </FormField>
+      </div>
+
       <div className="grid grid-cols-2 gap-4">
         {/* 开始日期 */}
         <FormField label={t("fieldStartDate")}>
@@ -269,20 +390,52 @@ export function ElectiveEditClient(): React.ReactElement {
         </FormField>
       </div>
 
-      {/* 状态 */}
-      <FormField label={t("fieldStatus")}>
-        <select
-          value={status}
-          onChange={(e) => setStatus(e.target.value)}
-          className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
-        >
-          {STATUS_OPTIONS.map((s) => (
-            <option key={s} value={s}>
-              {formatElectiveStatus(s)}
-            </option>
-          ))}
-        </select>
-      </FormField>
+      <div className="grid grid-cols-2 gap-4">
+        {/* 选课开始时间 */}
+        <FormField label={t("fieldSelectionStartAt")}>
+          <input
+            type="datetime-local"
+            value={selectionStartAt}
+            onChange={(e) => setSelectionStartAt(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 选课结束时间 */}
+        <FormField label={t("fieldSelectionEndAt")}>
+          <input
+            type="datetime-local"
+            value={selectionEndAt}
+            onChange={(e) => setSelectionEndAt(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+      </div>
+
+      <div className="grid grid-cols-2 gap-4">
+        {/* 退课截止时间 */}
+        <FormField label={t("fieldDropDeadline")}>
+          <input
+            type="datetime-local"
+            value={dropDeadline}
+            onChange={(e) => setDropDeadline(e.target.value)}
+            className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+          />
+        </FormField>
+
+        {/* 状态 */}
+        <FormField label={t("fieldStatus")}>
+          <Select
+            value={status}
+            onValueChange={setStatus}
+            options={STATUS_OPTIONS.map((s) => ({
+              value: s,
+              label: formatElectiveStatus(s),
+            }))}
+            className="h-9 w-full"
+          />
+        </FormField>
+      </div>
     </FormPageShell>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/elective/elective-list-client.tsx b/apps/portal-shell/src/features/admin/elective/elective-list-client.tsx
index 9295a6a..4a61bca 100644
--- a/apps/portal-shell/src/features/admin/elective/elective-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/elective/elective-list-client.tsx
@@ -5,6 +5,8 @@
  *
  * 数据契约：
  * - 列表查询 adminElectives：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 总览统计 electiveOverviewStats：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 业务动作 open/close/lottery/delete：❌ schema 无 → MSW 兜底（@contract-pending）
  *
  * URL 状态：?search=&status=&page=
  *
@@ -12,26 +14,50 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { BookOpen } from "lucide-react";
+import { BookOpen, Layers, Sparkles, Ticket, Users } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAdminElectives } from "@/lib/api/admin-p5";
+import {
+  useAdminElectives,
+  useCloseElectiveSelection,
+  useDeleteElective,
+  useGetElectiveOverviewStats,
+  useOpenElectiveSelection,
+  useRunElectiveLottery,
+} from "@/lib/api/admin-p5";
+import type { AdminElectiveListItem } from "@/lib/api/admin-p5";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/components/ui/alert-dialog";
 import { Button } from "@/shared/components/ui/button";
+import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
+import { Select } from "@/shared/components/ui/select";
+import { StatCard } from "@/shared/components/ui/stat-card";
+import { StatsGrid } from "@/shared/components/ui/stats-grid";
+import { notify } from "@/shared/lib/notify";
 import {
   ListPageShell,
   ListPageSkeleton,
-} from "@/shared/components/page-templates";
+} from "@/shared/components/page-templates/list-page";
 import {
   calcEnrollmentRate,
   electiveStatusToBadgeClass,
   enrollmentRateToColorClass,
-  formatEnrollmentCount,
+  formatElectiveSelectionMode,
   formatElectiveStatus,
+  formatEnrollmentCount,
   getEnrolledCount,
   getGradeName,
   getSubjectName,
@@ -41,9 +67,14 @@ import {
   type FlexibleElectiveItem,
 } from "@/features/admin/elective/transformations";
 
-/** 状态筛选选项（与 admin.elective.list i18n 对齐） */
 const STATUS_OPTIONS = ["DRAFT", "OPEN", "CLOSED", "FULL"] as const;
 
+type ConfirmAction =
+  | { kind: "open"; id: string; name: string }
+  | { kind: "close"; id: string; name: string }
+  | { kind: "lottery"; id: string; name: string }
+  | null;
+
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
  * （useSearchParams 要求 Suspense 边界，Next.js 15 强制）。
@@ -63,13 +94,28 @@ export function ElectiveListClient(): React.ReactElement {
 
   // @contract-pending：MSW 兜底
   const { data, loading, error } = useAdminElectives();
+  const { data: stats, loading: statsLoading } = useGetElectiveOverviewStats();
+
+  // 业务动作 hooks
+  const { run: deleteElective, loading: deleting } = useDeleteElective();
+  const { run: openSelection, loading: opening } = useOpenElectiveSelection();
+  const { run: closeSelection, loading: closing } = useCloseElectiveSelection();
+  const { run: runLottery, loading: lotterying } = useRunElectiveLottery();
+
+  const [confirmAction, setConfirmAction] = useState<ConfirmAction>(null);
+  const [deleteTarget, setDeleteTarget] = useState<{
+    id: string;
+    name: string;
+  } | null>(null);
 
   // 客户端二次筛选（search + status）
-  const filteredItems = useMemo<FlexibleElectiveItem[]>(() => {
-    const items = (data?.items ?? []) as FlexibleElectiveItem[];
+  const filteredItems = useMemo<AdminElectiveListItem[]>(() => {
+    const items = data?.items ?? [];
     return items.filter((item) => {
+      const flexible = item as unknown as FlexibleElectiveItem;
       return (
-        matchElectiveSearch(item, search) && matchElectiveStatus(item, status)
+        matchElectiveSearch(flexible, search) &&
+        matchElectiveStatus(flexible, status)
       );
     });
   }, [data, search, status]);
@@ -81,7 +127,6 @@ export function ElectiveListClient(): React.ReactElement {
     } else {
       params.delete(key);
     }
-    // 切换筛选时重置页码
     if (key === "status" || key === "search") {
       params.delete("page");
     }
@@ -90,6 +135,45 @@ export function ElectiveListClient(): React.ReactElement {
     });
   };
 
+  const handleConfirmAction = async (): Promise<void> => {
+    if (!confirmAction) return;
+    const { kind, id } = confirmAction;
+    try {
+      if (kind === "open") {
+        await openSelection(id);
+        notify.success(t("openSuccess"));
+      } else if (kind === "close") {
+        await closeSelection(id);
+        notify.success(t("closeSuccess"));
+      } else if (kind === "lottery") {
+        await runLottery(id);
+        notify.success(t("lotterySuccess"));
+      }
+      setConfirmAction(null);
+      router.refresh();
+    } catch (err) {
+      if (kind === "lottery") {
+        notify.error(t("lotteryFailed"));
+      }
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleConfirmDelete = async (): Promise<void> => {
+    if (!deleteTarget) return;
+    try {
+      await deleteElective(deleteTarget.id);
+      notify.success(t("deleteSuccess"));
+      setDeleteTarget(null);
+      router.refresh();
+    } catch (err) {
+      notify.error(t("deleteFailed"));
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const actionLoading = opening || closing || lotterying;
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -105,7 +189,7 @@ export function ElectiveListClient(): React.ReactElement {
       title={t("emptyTitle")}
       description={t("emptyDescription")}
       action={{
-        label: t("createButton"),
+        label: t("emptyAction"),
         href: "/shell/admin/elective/create",
       }}
     />
@@ -130,19 +214,19 @@ export function ElectiveListClient(): React.ReactElement {
           />
           <label className="flex items-center gap-2 text-sm">
             <span className="text-muted-foreground">{t("statusFilter")}</span>
-            <select
+            <Select
               value={status}
-              onChange={(e) => updateQuery("status", e.target.value)}
-              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+              onValueChange={(v) => updateQuery("status", v)}
+              options={[
+                { value: "", label: t("allStatuses") },
+                ...STATUS_OPTIONS.map((s) => ({
+                  value: s,
+                  label: formatElectiveStatus(s),
+                })),
+              ]}
+              className="h-9 w-40"
               aria-label={t("statusFilter")}
-            >
-              <option value="">{t("allStatuses")}</option>
-              {STATUS_OPTIONS.map((s) => (
-                <option key={s} value={s}>
-                  {formatElectiveStatus(s)}
-                </option>
-              ))}
-            </select>
+            />
           </label>
         </>
       }
@@ -159,7 +243,105 @@ export function ElectiveListClient(): React.ReactElement {
         </div>
       }
     >
-      <ElectiveTable items={filteredItems} page={page} />
+      <div className="space-y-4">
+        <StatsGrid columns={5} className="not-print">
+          <StatCard
+            title={t("statTotalCourses")}
+            value={stats?.totalCourses ?? 0}
+            icon={BookOpen}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTotalCapacity")}
+            value={stats?.totalCapacity ?? 0}
+            icon={Layers}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTotalEnrolled")}
+            value={stats?.totalEnrolled ?? 0}
+            icon={Users}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTotalDraft")}
+            value={stats?.totalDraft ?? 0}
+            icon={Ticket}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTotalOpen")}
+            value={stats?.totalOpen ?? 0}
+            icon={Sparkles}
+            highlight
+            isLoading={statsLoading}
+          />
+        </StatsGrid>
+
+        <ElectivesTable
+          items={filteredItems}
+          page={page}
+          onOpen={(id, name) => setConfirmAction({ kind: "open", id, name })}
+          onClose={(id, name) => setConfirmAction({ kind: "close", id, name })}
+          onLottery={(id, name) =>
+            setConfirmAction({ kind: "lottery", id, name })
+          }
+          onDelete={(id, name) => setDeleteTarget({ id, name })}
+        />
+      </div>
+
+      <AlertDialog
+        open={confirmAction !== null}
+        onOpenChange={(open) => {
+          if (!open) setConfirmAction(null);
+        }}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>
+              {confirmAction?.kind === "open"
+                ? t("confirmOpenTitle")
+                : confirmAction?.kind === "close"
+                  ? t("confirmCloseTitle")
+                  : t("confirmLotteryTitle")}
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              {confirmAction?.kind === "open"
+                ? t("confirmOpenDescription")
+                : confirmAction?.kind === "close"
+                  ? t("confirmCloseDescription")
+                  : t("confirmLotteryDescription")}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel disabled={actionLoading}>
+              {t("confirmCancel")}
+            </AlertDialogCancel>
+            <AlertDialogAction
+              disabled={actionLoading}
+              onClick={(e) => {
+                e.preventDefault();
+                void handleConfirmAction();
+              }}
+            >
+              {actionLoading ? t("confirming") : t("confirmSubmit")}
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+
+      <ConfirmDeleteDialog
+        open={deleteTarget !== null}
+        onOpenChange={(open) => {
+          if (!open) setDeleteTarget(null);
+        }}
+        title={t("confirmDeleteTitle")}
+        description={t("confirmDeleteDescription")}
+        confirmText={t("delete")}
+        cancelText={t("confirmCancel")}
+        onConfirm={handleConfirmDelete}
+        isWorking={deleting}
+      />
     </ListPageShell>
   );
 }
@@ -167,12 +349,20 @@ export function ElectiveListClient(): React.ReactElement {
 /**
  * 选修课列表表格（纯展示组件，对齐 §8.2 排版规范）。
  */
-function ElectiveTable({
+function ElectivesTable({
   items,
   page,
+  onOpen,
+  onClose,
+  onLottery,
+  onDelete,
 }: {
-  items: FlexibleElectiveItem[];
+  items: AdminElectiveListItem[];
   page: number;
+  onOpen: (id: string, name: string) => void;
+  onClose: (id: string, name: string) => void;
+  onLottery: (id: string, name: string) => void;
+  onDelete: (id: string, name: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.elective.list");
   return (
@@ -185,14 +375,20 @@ function ElectiveTable({
             <th className="p-3 text-left font-medium">{t("colGrade")}</th>
             <th className="p-3 text-left font-medium">{t("colTeacher")}</th>
             <th className="p-3 text-left font-medium">{t("colEnrolled")}</th>
+            <th className="p-3 text-left font-medium">{t("colClassroom")}</th>
+            <th className="p-3 text-left font-medium">{t("colSchedule")}</th>
+            <th className="p-3 text-left font-medium">{t("colCredit")}</th>
+            <th className="p-3 text-left font-medium">
+              {t("colSelectionMode")}
+            </th>
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
             <th className="p-3 text-right font-medium">{t("colActions")}</th>
           </tr>
         </thead>
         <tbody className="divide-y">
           {items.map((item) => {
-            const id = item.id ?? "";
-            const enrolled = getEnrolledCount(item);
+            const flexible = item as unknown as FlexibleElectiveItem;
+            const enrolled = getEnrolledCount(flexible);
             const capacity =
               typeof item.capacity === "number" &&
               Number.isFinite(item.capacity)
@@ -202,59 +398,105 @@ function ElectiveTable({
               capacity,
               enrolledCount: enrolled,
             });
+            const status = item.status ?? "";
+            const selectionMode = item.selectionMode ?? "";
             return (
-              <tr key={id} className="hover:bg-muted/30">
+              <tr key={item.id} className="hover:bg-muted/30">
                 <td className="p-3">
                   <Link
-                    href={`/shell/admin/elective/${id}`}
+                    href={`/shell/admin/elective/${item.id}?page=${page}`}
                     className="font-medium hover:underline"
                   >
-                    {item.name ?? "-"}
+                    {item.name}
                   </Link>
                 </td>
                 <td className="p-3 text-muted-foreground">
-                  {getSubjectName(item)}
+                  {getSubjectName(flexible)}
                 </td>
                 <td className="p-3 text-muted-foreground">
-                  {getGradeName(item)}
+                  {getGradeName(flexible)}
                 </td>
                 <td className="p-3 text-muted-foreground">
                   {item.teacherName || "-"}
                 </td>
                 <td className="p-3">
-                  <div className="flex flex-col gap-0.5">
-                    <span
-                      className={`font-mono text-xs font-medium ${enrollmentRateToColorClass(
-                        rate,
-                      )}`}
-                    >
-                      {formatEnrollmentCount({
-                        capacity,
-                        enrolledCount: enrolled,
-                      })}
-                    </span>
-                    <span className="font-mono text-[10px] text-muted-foreground">
-                      {rate}%
-                    </span>
-                  </div>
+                  <span
+                    className={`font-mono text-xs font-medium ${enrollmentRateToColorClass(
+                      rate,
+                    )}`}
+                  >
+                    {formatEnrollmentCount({
+                      capacity,
+                      enrolledCount: enrolled,
+                    })}
+                  </span>
+                </td>
+                <td className="p-3 text-muted-foreground">
+                  {item.classroom || "-"}
+                </td>
+                <td className="p-3 text-muted-foreground">
+                  {item.schedule || "-"}
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {typeof item.credit === "number" ? item.credit : "-"}
                 </td>
                 <td className="p-3">
-                  <StatusBadge status={item.status ?? ""} />
+                  <SelectionModeBadge mode={selectionMode} />
+                </td>
+                <td className="p-3">
+                  <StatusBadge status={status} />
                 </td>
                 <td className="p-3">
                   <div className="flex items-center justify-end gap-1">
                     <Button asChild variant="ghost" size="sm">
-                      <Link href={`/shell/admin/elective/${id}?page=${page}`}>
+                      <Link
+                        href={`/shell/admin/elective/${item.id}?page=${page}`}
+                      >
                         {t("viewDetail")}
                       </Link>
                     </Button>
                     <Button asChild variant="ghost" size="sm">
                       <Link
-                        href={`/shell/admin/elective/${id}/edit?page=${page}`}
+                        href={`/shell/admin/elective/${item.id}/edit?page=${page}`}
                       >
                         {t("edit")}
                       </Link>
                     </Button>
+                    {status === "DRAFT" ? (
+                      <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => onOpen(item.id, item.name)}
+                      >
+                        {t("openSelection")}
+                      </Button>
+                    ) : null}
+                    {status === "OPEN" || status === "FULL" ? (
+                      <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => onClose(item.id, item.name)}
+                      >
+                        {t("closeSelection")}
+                      </Button>
+                    ) : null}
+                    {selectionMode === "LOTTERY" && status !== "DRAFT" ? (
+                      <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => onLottery(item.id, item.name)}
+                      >
+                        {t("runLottery")}
+                      </Button>
+                    ) : null}
+                    <Button
+                      variant="ghost"
+                      size="sm"
+                      className="text-destructive hover:bg-destructive/10 hover:text-destructive"
+                      onClick={() => onDelete(item.id, item.name)}
+                    >
+                      {t("delete")}
+                    </Button>
                   </div>
                 </td>
               </tr>
@@ -267,7 +509,28 @@ function ElectiveTable({
 }
 
 /**
- * 选修课状态徽章（按状态色阶展示）。
+ * 选课模式徽章。
+ */
+function SelectionModeBadge({ mode }: { mode: string }): React.ReactElement {
+  if (!mode) {
+    return <span className="text-xs text-muted-foreground">-</span>;
+  }
+  const label = formatElectiveSelectionMode(mode);
+  const cls =
+    mode === "LOTTERY"
+      ? "bg-violet-500/10 text-violet-600 dark:text-violet-400"
+      : "bg-sky-500/10 text-sky-600 dark:text-sky-400";
+  return (
+    <span
+      className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${cls}`}
+    >
+      {label}
+    </span>
+  );
+}
+
+/**
+ * 状态徽章（按状态色阶展示）。
  */
 function StatusBadge({ status }: { status: string }): React.ReactElement {
   const label = formatElectiveStatus(status);
diff --git a/apps/portal-shell/src/features/admin/elective/transformations.ts b/apps/portal-shell/src/features/admin/elective/transformations.ts
index 647ee2f..58aca52 100644
--- a/apps/portal-shell/src/features/admin/elective/transformations.ts
+++ b/apps/portal-shell/src/features/admin/elective/transformations.ts
@@ -40,6 +40,20 @@ export interface FlexibleElectiveItem {
   endDate?: string;
   createdAt?: string;
   updatedAt?: string;
+  /** 教室（@contract-pending，对齐 CICD 列表"教室"列） */
+  classroom?: string;
+  /** 上课时间（@contract-pending，对齐 CICD 列表"时间"列） */
+  schedule?: string;
+  /** 学分（@contract-pending，对齐 CICD 列表"学分"列） */
+  credit?: number;
+  /** 选课模式（@contract-pending：FIRST_COME | LOTTERY） */
+  selectionMode?: string;
+  /** 选课开始时间 ISO（@contract-pending） */
+  selectionStartAt?: string;
+  /** 选课结束时间 ISO（@contract-pending） */
+  selectionEndAt?: string;
+  /** 退课截止时间 ISO（@contract-pending） */
+  dropDeadline?: string;
 }
 
 /**
@@ -49,6 +63,20 @@ export interface FlexibleElectiveItem {
 export function formatElectiveStatus(status: string): string {
   return ELECTIVE_STATUS_LABEL[status] ?? status;
 }
+/** 选课模式枚举（@contract-pending） */
+export type ElectiveSelectionMode = "FIRST_COME" | "LOTTERY";
+/** 选课模式中文标签映射（与 admin.elective.list i18n 对齐） */
+export const ELECTIVE_SELECTION_MODE_LABEL: Record<string, string> = {
+  FIRST_COME: "先到先得",
+  LOTTERY: "抽签",
+};
+/**
+ * 将选课模式枚举值映射为中文标签。
+ * 未知模式回退为原始值。
+ */
+export function formatElectiveSelectionMode(mode: string): string {
+  return ELECTIVE_SELECTION_MODE_LABEL[mode] ?? mode;
+}
 
 /**
  * 根据选修课状态返回 Tailwind 徽章语义类名。
diff --git a/apps/portal-shell/src/features/admin/error-book/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/error-book/__tests__/transformations.test.ts
index 1abf179..4222e9f 100644
--- a/apps/portal-shell/src/features/admin/error-book/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/error-book/__tests__/transformations.test.ts
@@ -52,6 +52,22 @@ const baseStats: AdminErrorBookStats = {
       errorRate: 0.2,
     },
   ],
+  byClass: [
+    {
+      classId: "cls-1",
+      className: "高三(1)班",
+      errorCount: 100,
+      questionCount: 30,
+      errorRate: 0.7,
+    },
+    {
+      classId: "cls-2",
+      className: "高三(2)班",
+      errorCount: 60,
+      questionCount: 20,
+      errorRate: 0.3,
+    },
+  ],
   topStudents: [
     {
       studentId: "stu-1",
@@ -304,6 +320,7 @@ describe("hasErrorBookData", () => {
       totalErrorCount: 0,
       avgErrorRate: 0,
       bySubject: [],
+      byClass: [],
       topStudents: [],
       topWrongQuestions: [],
     };
diff --git a/apps/portal-shell/src/features/admin/error-book/error-book-client.tsx b/apps/portal-shell/src/features/admin/error-book/error-book-client.tsx
index bc1cfc5..55cbe91 100644
--- a/apps/portal-shell/src/features/admin/error-book/error-book-client.tsx
+++ b/apps/portal-shell/src/features/admin/error-book/error-book-client.tsx
@@ -5,27 +5,32 @@
  *
  * 数据契约：
  * - adminErrorBookStats()：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - exportErrorBookCsv(filter)：❌ schema 无 → MSW 兜底（@contract-pending）
  *
- * URL 状态：?subjectId=xxx
+ * URL 状态：?subjectId=xxx&page=xxx
  *
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { BookX } from "lucide-react";
+import { BookX, Download } from "lucide-react";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAdminErrorBookStats } from "@/lib/api";
+import { useAdminErrorBookStats, useExportErrorBookCsv } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
 import { Card, CardContent } from "@/shared/components/ui/card";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { StatCard } from "@/shared/components/ui/stat-card";
+import { notify } from "@/shared/lib/notify";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
 import {
+  buildPageList,
+  computeTotalPages,
   countHighFreqErrors,
   errorRateToColorClass,
   filterStatsBySubject,
@@ -35,11 +40,18 @@ import {
   getSubjectTabs,
   hasErrorBookData,
   isHighFreqError,
+  sortClassesByErrorRate,
   sortSubjectsByErrorRate,
   topWrongQuestions,
   truncateContent,
   withStudentRank,
 } from "@/features/admin/error-book/transformations";
+import { ErrorBookDetailDialog } from "@/features/admin/error-book/error-book-detail-dialog";
+
+/** 高频错题列表每页条数 */
+const PAGE_SIZE = 10;
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
 
 /**
  * 错题本分析客户端主体。需由 server page 包裹在 <Suspense> 中
@@ -51,11 +63,14 @@ export function ErrorBookClient(): React.ReactElement {
   const router = useRouter();
   const searchParams = useSearchParams();
   const [, startTransition] = useTransition();
+  const [selectedItemId, setSelectedItemId] = useState<string | null>(null);
 
   const subjectId = searchParams.get("subjectId") ?? "";
+  const page = Number(searchParams.get("page") ?? "1") || 1;
 
   // @contract-pending：MSW 兜底
   const { data: rawStats, loading, error } = useAdminErrorBookStats();
+  const { run: runExport, loading: exporting } = useExportErrorBookCsv();
 
   const stats = useMemo(
     () => filterStatsBySubject(rawStats ?? null, subjectId),
@@ -74,11 +89,48 @@ export function ErrorBookClient(): React.ReactElement {
     } else {
       params.delete("subjectId");
     }
+    // 切换学科时重置页码
+    params.delete("page");
     startTransition(() => {
       router.push(`/shell/admin/error-book?${params.toString()}`);
     });
   };
 
+  const updatePage = (next: number): void => {
+    const params = new URLSearchParams(searchParams.toString());
+    if (next > 1) {
+      params.set("page", String(next));
+    } else {
+      params.delete("page");
+    }
+    startTransition(() => {
+      router.push(`/shell/admin/error-book?${params.toString()}`);
+    });
+  };
+
+  const handleExportCsv = async (): Promise<void> => {
+    try {
+      const filter = {
+        subjectId: subjectId || null,
+        classId: null,
+      };
+      const result = await runExport(filter);
+      // 触发浏览器下载（与 audit-logs 导出模式一致）
+      const blob = new Blob([result.csv], { type: "text/csv;charset=utf-8;" });
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = url;
+      link.download = result.filename;
+      document.body.appendChild(link);
+      link.click();
+      document.body.removeChild(link);
+      URL.revokeObjectURL(url);
+      notify.success(t("exportSuccess", { count: result.count }));
+    } catch (e) {
+      notify.error(tCommon("error.loadFailed", { message: String(e) }));
+    }
+  };
+
   const hasData = hasErrorBookData(stats);
 
   const errorNode = error ? (
@@ -103,6 +155,16 @@ export function ErrorBookClient(): React.ReactElement {
       title={t("title")}
       description={t("description")}
       icon={<BookX className="size-6" />}
+      actions={
+        <Button
+          variant="outline"
+          onClick={() => void handleExportCsv()}
+          disabled={exporting || !hasData}
+        >
+          <Download className="size-4" />
+          {exporting ? t("exporting") : t("exportCsv")}
+        </Button>
+      }
       filters={
         <SubjectTabs
           subjectId={subjectId}
@@ -120,10 +182,20 @@ export function ErrorBookClient(): React.ReactElement {
       {stats ? (
         <ErrorBookContent
           stats={stats}
+          rawStats={rawStats ?? null}
           highFreqTotal={countHighFreqErrors(rawStats?.topWrongQuestions)}
+          page={page}
+          onPageChange={updatePage}
+          onViewDetail={setSelectedItemId}
         />
       ) : null}
       <p className="text-xs text-muted-foreground">{t("mswNotice")}</p>
+      <ErrorBookDetailDialog
+        itemId={selectedItemId}
+        onOpenChange={(open) => {
+          if (!open) setSelectedItemId(null);
+        }}
+      />
     </ListPageShell>
   );
 }
@@ -188,14 +260,24 @@ function TabButton({
 }
 
 /**
- * 错题本分析主体内容（统计卡片 + 学科分布 + 薄弱点 + Top 学生 + Top 错题）。
+ * 错题本分析主体内容（统计卡片 + 学科分布 + 班级分布 + 薄弱点 + Top 学生 + Top 错题）。
  */
 function ErrorBookContent({
   stats,
+  rawStats,
   highFreqTotal,
+  page,
+  onPageChange,
+  onViewDetail,
 }: {
   stats: NonNullable<ReturnType<typeof useAdminErrorBookStats>["data"]>;
+  rawStats: NonNullable<
+    ReturnType<typeof useAdminErrorBookStats>["data"]
+  > | null;
   highFreqTotal: number;
+  page: number;
+  onPageChange: (next: number) => void;
+  onViewDetail: (itemId: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.errorBook.list");
   const avgPerStudent = formatAvgPerStudent(
@@ -204,8 +286,22 @@ function ErrorBookContent({
   );
 
   const subjectDistribution = sortSubjectsByErrorRate(stats);
+  const classDistribution = sortClassesByErrorRate(rawStats);
   const rankedStudents = withStudentRank(stats.topStudents).slice(0, 50);
-  const wrongQuestions = topWrongQuestions(stats.topWrongQuestions, 10);
+
+  // 错题列表分页：基于 rawStats.topWrongQuestions 全量分页，避免学科筛选下截断
+  const allWrongQuestions = topWrongQuestions(
+    rawStats?.topWrongQuestions,
+    1000,
+  );
+  const totalWrong = allWrongQuestions.length;
+  const totalPages = computeTotalPages(totalWrong, PAGE_SIZE);
+  const safePage = Math.min(Math.max(1, page), totalPages);
+  const startIdx = (safePage - 1) * PAGE_SIZE;
+  const pagedWrongQuestions = allWrongQuestions.slice(
+    startIdx,
+    startIdx + PAGE_SIZE,
+  );
 
   return (
     <div className="flex flex-col gap-6">
@@ -224,52 +320,100 @@ function ErrorBookContent({
         />
       </div>
 
-      {/* 学科分布 */}
-      <Card>
-        <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">
-            {t("distributionTitle")}
-          </h2>
-          {subjectDistribution.length === 0 ? (
-            <p className="py-6 text-center text-sm text-muted-foreground">
-              {t("emptyTitle")}
-            </p>
-          ) : (
-            <div className="overflow-x-auto">
-              <table className="w-full text-sm">
-                <thead className="border-b bg-muted/30">
-                  <tr>
-                    <th className="p-2 text-left font-medium">
-                      {t("distributionSubject")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("distributionCount")}
-                    </th>
-                    <th className="p-2 text-left font-medium">
-                      {t("knowledgeWeaknessErrorRate")}
-                    </th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y">
-                  {subjectDistribution.map((s) => (
-                    <tr key={s.subjectId} className="hover:bg-muted/30">
-                      <td className="p-2 font-medium">{s.subjectName}</td>
-                      <td className="p-2 font-mono text-xs">
-                        {formatErrorCount(s.errorCount)}
-                      </td>
-                      <td
-                        className={`p-2 font-mono text-xs ${errorRateToColorClass(s.errorRate)}`}
-                      >
-                        {formatErrorRate(s.errorRate)}
-                      </td>
+      {/* 学科分布 + 班级分布（并排展示，lg 以上双列） */}
+      <div className="grid grid-cols-1 gap-4 lg:grid-cols-2">
+        <Card>
+          <CardContent className="p-6">
+            <h2 className="mb-4 text-lg font-semibold">
+              {t("distributionTitle")}
+            </h2>
+            {subjectDistribution.length === 0 ? (
+              <p className="py-6 text-center text-sm text-muted-foreground">
+                {t("emptyTitle")}
+              </p>
+            ) : (
+              <div className="overflow-x-auto">
+                <table className="w-full text-sm">
+                  <thead className="border-b bg-muted/30">
+                    <tr>
+                      <th className="p-2 text-left font-medium">
+                        {t("distributionSubject")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("distributionCount")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("knowledgeWeaknessErrorRate")}
+                      </th>
                     </tr>
-                  ))}
-                </tbody>
-              </table>
-            </div>
-          )}
-        </CardContent>
-      </Card>
+                  </thead>
+                  <tbody className="divide-y">
+                    {subjectDistribution.map((s) => (
+                      <tr key={s.subjectId} className="hover:bg-muted/30">
+                        <td className="p-2 font-medium">{s.subjectName}</td>
+                        <td className="p-2 font-mono text-xs">
+                          {formatErrorCount(s.errorCount)}
+                        </td>
+                        <td
+                          className={`p-2 font-mono text-xs ${errorRateToColorClass(s.errorRate)}`}
+                        >
+                          {formatErrorRate(s.errorRate)}
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )}
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="p-6">
+            <h2 className="mb-4 text-lg font-semibold">
+              {t("classDistributionTitle")}
+            </h2>
+            {classDistribution.length === 0 ? (
+              <p className="py-6 text-center text-sm text-muted-foreground">
+                {t("emptyTitle")}
+              </p>
+            ) : (
+              <div className="overflow-x-auto">
+                <table className="w-full text-sm">
+                  <thead className="border-b bg-muted/30">
+                    <tr>
+                      <th className="p-2 text-left font-medium">
+                        {t("classDistributionClass")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("classDistributionCount")}
+                      </th>
+                      <th className="p-2 text-left font-medium">
+                        {t("knowledgeWeaknessErrorRate")}
+                      </th>
+                    </tr>
+                  </thead>
+                  <tbody className="divide-y">
+                    {classDistribution.map((c) => (
+                      <tr key={c.classId} className="hover:bg-muted/30">
+                        <td className="p-2 font-medium">{c.className}</td>
+                        <td className="p-2 font-mono text-xs">
+                          {formatErrorCount(c.errorCount)}
+                        </td>
+                        <td
+                          className={`p-2 font-mono text-xs ${errorRateToColorClass(c.errorRate)}`}
+                        >
+                          {formatErrorRate(c.errorRate)}
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )}
+          </CardContent>
+        </Card>
+      </div>
 
       {/* 章节薄弱点 + 知识点薄弱点（基于当前契约数据派生） */}
       <div className="grid grid-cols-1 gap-4 lg:grid-cols-2">
@@ -328,13 +472,18 @@ function ErrorBookContent({
         </CardContent>
       </Card>
 
-      {/* Top 10 高频错题 */}
+      {/* 错题列表（分页） */}
       <Card>
         <CardContent className="p-6">
-          <h2 className="mb-4 text-lg font-semibold">
-            {t("topWrongQuestionsTitle")}
-          </h2>
-          {wrongQuestions.length === 0 ? (
+          <div className="mb-4 flex items-center justify-between">
+            <h2 className="text-lg font-semibold">
+              {t("topWrongQuestionsTitle")}
+            </h2>
+            <span className="text-xs text-muted-foreground">
+              {t("total", { count: totalWrong })}
+            </span>
+          </div>
+          {pagedWrongQuestions.length === 0 ? (
             <p className="py-6 text-center text-sm text-muted-foreground">
               {t("emptyTitle")}
             </p>
@@ -352,10 +501,13 @@ function ErrorBookContent({
                     <th className="p-2 text-left font-medium">
                       {t("knowledgeWeaknessErrorRate")}
                     </th>
+                    <th className="p-2 text-left font-medium">
+                      {t("topWrongQuestionsActions")}
+                    </th>
                   </tr>
                 </thead>
                 <tbody className="divide-y">
-                  {wrongQuestions.map((q) => (
+                  {pagedWrongQuestions.map((q) => (
                     <tr key={q.questionId} className="hover:bg-muted/30">
                       <td className="p-2">{truncateContent(q.content, 80)}</td>
                       <td className="p-2 font-mono text-xs">
@@ -371,12 +523,31 @@ function ErrorBookContent({
                           </span>
                         ) : null}
                       </td>
+                      <td className="p-2">
+                        <Button
+                          size="sm"
+                          variant="outline"
+                          className="h-7 px-2 text-xs"
+                          onClick={() => onViewDetail(q.questionId)}
+                        >
+                          {t("viewDetail")}
+                        </Button>
+                      </td>
                     </tr>
                   ))}
                 </tbody>
               </table>
             </div>
           )}
+          {/* 分页 */}
+          {totalPages > 1 ? (
+            <Pagination
+              page={safePage}
+              pageSize={PAGE_SIZE}
+              total={totalWrong}
+              onJump={onPageChange}
+            />
+          ) : null}
         </CardContent>
       </Card>
     </div>
@@ -488,3 +659,80 @@ function KnowledgeWeaknessCard({
     </Card>
   );
 }
+
+/**
+ * 分页组件（页码列表 + 跳转按钮 + total/totalPages 显示）。
+ * 依赖 URL ?page=N 状态，由父组件控制路由跳转。
+ * 页码按钮策略：当 totalPages ≤ MAX_PAGE_BUTTONS 时全量展示；
+ * 超过时展示首尾页 + 当前页附近的页码（含省略号占位）。
+ */
+function Pagination({
+  page,
+  pageSize,
+  total,
+  onJump,
+}: {
+  page: number;
+  pageSize: number;
+  total: number;
+  onJump: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.errorBook.list");
+  const tCommon = useTranslations("common");
+  const totalPages = computeTotalPages(total, pageSize);
+  const canPrev = page > 1;
+  const canNext = page < totalPages;
+  const pages = buildPageList(page, totalPages, MAX_PAGE_BUTTONS);
+
+  return (
+    <div className="mt-4 flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+      <div className="flex items-center gap-3">
+        <span>{t("total", { count: total })}</span>
+        <span className="text-xs">
+          {page} / {totalPages}
+        </span>
+      </div>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.max(1, page - 1))}
+          disabled={!canPrev}
+          aria-label={tCommon("button.prev")}
+        >
+          {tCommon("button.prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "..." ? (
+            <span
+              key={`gap-${idx}`}
+              className="px-2 text-xs text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === page ? "default" : "outline"}
+              size="sm"
+              onClick={() => onJump(p)}
+              aria-current={p === page ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.min(totalPages, page + 1))}
+          disabled={!canNext}
+          aria-label={tCommon("button.next")}
+        >
+          {tCommon("button.next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/error-book/error-book-detail-dialog.tsx b/apps/portal-shell/src/features/admin/error-book/error-book-detail-dialog.tsx
new file mode 100644
index 0000000..b0321b2
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/error-book/error-book-detail-dialog.tsx
@@ -0,0 +1,267 @@
+"use client";
+
+/**
+ * 错题详情对话框（迁移自 CICD error-book-detail-dialog.tsx）
+ *
+ * 适配 portal-shell：
+ * - 用原生轻量模态（fixed inset-0 + bg-black/50 + 卡片）替代 shadcn Dialog
+ * - 数据通过 useErrorBookDetail hook（@contract-pending MSW 兜底）拉取
+ * - 仅展示详情（无 archive/delete/saveNote 等 server action）
+ * - 错误处理走 notify.error()
+ *
+ * 关联：ARCHITECTURE.md §5.3 契约纪律 / §9.4 / §11.3 DoD
+ */
+import { useEffect } from "react";
+import { useTranslations } from "next-intl";
+import {
+  BookOpen,
+  Calendar,
+  GraduationCap,
+  Hash,
+  Lightbulb,
+  RefreshCw,
+  Target,
+  User,
+} from "lucide-react";
+
+import { useErrorBookDetail } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Button } from "@/shared/components/ui/button";
+import { Badge } from "@/shared/components/ui/badge";
+import { Separator } from "@/shared/components/ui/separator";
+
+export interface ErrorBookDetailDialogProps {
+  /** 当前选中的错题 itemId，为空时关闭对话框 */
+  itemId: string | null;
+  onOpenChange: (open: boolean) => void;
+}
+
+/**
+ * 错题详情对话框。itemId 非空时打开，按 itemId 拉取详情。
+ */
+export function ErrorBookDetailDialog({
+  itemId,
+  onOpenChange,
+}: ErrorBookDetailDialogProps): React.ReactElement {
+  const t = useTranslations("admin.errorBook.detailDialog");
+  const tCommon = useTranslations("common");
+  const open = itemId !== null && itemId.length > 0;
+
+  const { data, loading, error, refetch } = useErrorBookDetail(itemId ?? "", {
+    enabled: open,
+  });
+
+  // 查询失败时通知用户（§11.3 DoD #8：catch 块必须包含 notify.error()）
+  useEffect(() => {
+    if (error) {
+      notify.error(tCommon("error.loadFailed", { message: String(error) }));
+    }
+  }, [error, tCommon]);
+
+  // ESC 键关闭
+  useEffect(() => {
+    if (!open) return;
+    const handleKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === "Escape") onOpenChange(false);
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [open, onOpenChange]);
+
+  if (!open) return <></>;
+
+  return (
+    <div
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="error-book-detail-title"
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={() => onOpenChange(false)}
+    >
+      <div
+        className="flex max-h-[90vh] w-full max-w-2xl flex-col overflow-hidden rounded-lg border bg-card shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* 头部 */}
+        <div className="flex items-start justify-between border-b p-6 pb-4">
+          <div className="flex-1">
+            <h2
+              id="error-book-detail-title"
+              className="flex items-center gap-2 text-lg font-semibold"
+            >
+              <BookOpen className="size-5" />
+              {t("title")}
+            </h2>
+            {data ? (
+              <div className="mt-2 flex flex-wrap items-center gap-2 text-xs">
+                {data.subjectName ? (
+                  <Badge variant="outline">{data.subjectName}</Badge>
+                ) : null}
+                {data.knowledgePointTitle ? (
+                  <Badge variant="secondary">{data.knowledgePointTitle}</Badge>
+                ) : null}
+                {data.className ? (
+                  <span className="text-muted-foreground">
+                    {data.className}
+                  </span>
+                ) : null}
+              </div>
+            ) : null}
+          </div>
+          <Button
+            variant="ghost"
+            size="sm"
+            onClick={() => onOpenChange(false)}
+            aria-label={t("close")}
+          >
+            ✕
+          </Button>
+        </div>
+
+        {/* 内容区 */}
+        <div className="flex-1 overflow-y-auto p-6">
+          {loading ? (
+            <div className="space-y-3">
+              <div className="h-4 w-1/3 animate-pulse rounded bg-muted" />
+              <div className="h-20 animate-pulse rounded bg-muted" />
+              <div className="h-4 w-1/4 animate-pulse rounded bg-muted" />
+              <div className="h-16 animate-pulse rounded bg-muted" />
+            </div>
+          ) : error ? (
+            <div className="rounded-md border border-destructive/30 bg-destructive/5 p-4 text-center">
+              <p className="text-sm text-destructive">
+                {tCommon("error.loadFailed", { message: String(error) })}
+              </p>
+              <Button
+                variant="outline"
+                size="sm"
+                className="mt-3"
+                onClick={() => void refetch()}
+              >
+                <RefreshCw className="size-4" />
+                {t("retry")}
+              </Button>
+            </div>
+          ) : data ? (
+            <div className="space-y-5">
+              {/* 学生信息 */}
+              <section className="grid grid-cols-2 gap-3 text-sm sm:grid-cols-3">
+                <InfoItem
+                  icon={<User className="size-4" />}
+                  label={t("studentName")}
+                  value={data.studentName}
+                />
+                <InfoItem
+                  icon={<GraduationCap className="size-4" />}
+                  label={t("className")}
+                  value={data.className}
+                />
+                <InfoItem
+                  icon={<Hash className="size-4" />}
+                  label={t("errorCount")}
+                  value={String(data.errorCount)}
+                />
+              </section>
+
+              <Separator />
+
+              {/* 题目内容 */}
+              <section>
+                <h3 className="mb-2 text-sm font-medium">{t("question")}</h3>
+                <div className="rounded-md border bg-muted/30 p-3 text-sm">
+                  <pre className="whitespace-pre-wrap break-words font-sans">
+                    {data.content || t("noContent")}
+                  </pre>
+                </div>
+              </section>
+
+              {/* 正确答案 */}
+              {data.correctAnswer ? (
+                <section>
+                  <h3 className="mb-2 flex items-center gap-1 text-sm font-medium text-emerald-600 dark:text-emerald-400">
+                    <Target className="size-4" />
+                    {t("correctAnswer")}
+                  </h3>
+                  <div className="rounded-md border border-emerald-200 bg-emerald-50/50 p-3 text-sm dark:border-emerald-900 dark:bg-emerald-950/20">
+                    <pre className="whitespace-pre-wrap break-words font-sans">
+                      {data.correctAnswer}
+                    </pre>
+                  </div>
+                </section>
+              ) : null}
+
+              {/* 解析 */}
+              {data.analysis ? (
+                <section>
+                  <h3 className="mb-2 flex items-center gap-1 text-sm font-medium">
+                    <Lightbulb className="size-4" />
+                    {t("analysis")}
+                  </h3>
+                  <div className="rounded-md border bg-background p-3 text-sm">
+                    <pre className="whitespace-pre-wrap break-words font-sans">
+                      {data.analysis}
+                    </pre>
+                  </div>
+                </section>
+              ) : null}
+
+              {/* 元信息 */}
+              <section className="flex flex-wrap items-center gap-4 text-xs text-muted-foreground">
+                <span className="flex items-center gap-1">
+                  <Calendar className="size-3" />
+                  {t("lastErrorTime")}：{formatDateTime(data.lastErrorTime)}
+                </span>
+                {data.knowledgePointTitle ? (
+                  <span className="flex items-center gap-1">
+                    <BookOpen className="size-3" />
+                    {t("knowledgePoint")}：{data.knowledgePointTitle}
+                  </span>
+                ) : null}
+              </section>
+            </div>
+          ) : (
+            <div className="py-6 text-center text-sm text-muted-foreground">
+              {t("noData")}
+            </div>
+          )}
+        </div>
+
+        {/* 底部 */}
+        <div className="flex justify-end gap-2 border-t p-4">
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            {t("close")}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+/** 信息项（图标 + 标签 + 值）。 */
+function InfoItem({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: string;
+}): React.ReactElement {
+  return (
+    <div className="flex items-center gap-2">
+      <span className="text-muted-foreground">{icon}</span>
+      <div>
+        <p className="text-xs text-muted-foreground">{label}</p>
+        <p className="font-medium">{value || "--"}</p>
+      </div>
+    </div>
+  );
+}
+
+/** 格式化 ISO 日期为本地化展示。 */
+function formatDateTime(iso: string): string {
+  if (!iso) return "--";
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return "--";
+  return d.toLocaleString("zh-CN");
+}
diff --git a/apps/portal-shell/src/features/admin/error-book/transformations.ts b/apps/portal-shell/src/features/admin/error-book/transformations.ts
index 7c443a9..476add4 100644
--- a/apps/portal-shell/src/features/admin/error-book/transformations.ts
+++ b/apps/portal-shell/src/features/admin/error-book/transformations.ts
@@ -123,6 +123,60 @@ export function sortSubjectsByErrorRate(
   return [...stats.bySubject].sort((a, b) => b.errorRate - a.errorRate);
 }
 
+/** 班级维度统计项（从 AdminErrorBookStats.byClass 派生） */
+type ClassStat = AdminErrorBookStats["byClass"][number];
+
+/**
+ * 按错误率降序排序的班级分布列表。
+ */
+export function sortClassesByErrorRate(
+  stats: AdminErrorBookStats | null | undefined,
+): ClassStat[] {
+  if (!stats?.byClass) return [];
+  return [...stats.byClass].sort((a, b) => b.errorRate - a.errorRate);
+}
+
+/**
+ * 计算分页后的总页数。
+ * pageSize ≤ 0 视为 1，total ≤ 0 视为 0 条。
+ */
+export function computeTotalPages(total: number, pageSize: number): number {
+  const safeTotal = Math.max(0, Math.floor(total));
+  const safeSize = Math.max(1, Math.floor(pageSize));
+  return Math.max(1, Math.ceil(safeTotal / safeSize));
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+export function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
+
 /**
  * 给 topStudents 列表注入排名字段（rank 从 1 开始）。
  */
diff --git a/apps/portal-shell/src/features/admin/files/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/files/__tests__/transformations.test.ts
index 71ea8c9..7382bdf 100644
--- a/apps/portal-shell/src/features/admin/files/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/files/__tests__/transformations.test.ts
@@ -7,6 +7,8 @@ import { describe, expect, it } from "vitest";
 
 import {
   MIME_TYPE_LABEL,
+  categorizeFileByName,
+  categoryToIconColor,
   formatFileDate,
   formatFileSize,
   formatMimeType,
@@ -93,3 +95,42 @@ describe("mimeTypeToCategory", () => {
     expect(mimeTypeToCategory("/png")).toBe("unknown");
   });
 });
+
+describe("categoryToIconColor", () => {
+  it("maps image category to emerald", () => {
+    expect(categoryToIconColor("image")).toContain("emerald");
+  });
+
+  it("maps document category to blue", () => {
+    expect(categoryToIconColor("document")).toContain("blue");
+  });
+
+  it("maps video category to purple", () => {
+    expect(categoryToIconColor("video")).toContain("purple");
+  });
+
+  it("maps audio category to amber", () => {
+    expect(categoryToIconColor("audio")).toContain("amber");
+  });
+
+  it("maps other category to muted", () => {
+    expect(categoryToIconColor("other")).toBe("text-muted-foreground");
+  });
+});
+
+describe("categorizeFileByName", () => {
+  it("categorizes image files by extension", () => {
+    expect(categorizeFileByName("photo.png")).toBe("image");
+    expect(categorizeFileByName("photo.JPG")).toBe("image");
+  });
+
+  it("categorizes document files by extension", () => {
+    expect(categorizeFileByName("report.pdf")).toBe("document");
+    expect(categorizeFileByName("notes.docx")).toBe("document");
+  });
+
+  it("returns other for unknown extensions", () => {
+    expect(categorizeFileByName("archive.xyz")).toBe("other");
+    expect(categorizeFileByName("noextension")).toBe("other");
+  });
+});
diff --git a/apps/portal-shell/src/features/admin/files/file-batch-operations.tsx b/apps/portal-shell/src/features/admin/files/file-batch-operations.tsx
new file mode 100644
index 0000000..cba5ecb
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/files/file-batch-operations.tsx
@@ -0,0 +1,204 @@
+"use client";
+
+/**
+ * 文件批量操作工具栏（ARCHITECTURE.md §5.4 / §9.4 / §10 P5）
+ *
+ * 当选中行数 > 0 时显示，包含：
+ * - 全选 checkbox（含 indeterminate 态）
+ * - 已选数量提示
+ * - 清空选择按钮
+ * - 批量删除按钮（带轻量确认模态）
+ *
+ * 调用 useBatchDeleteFiles hook，删除中显示 loading 状态。
+ * 成功后通知 + 通过 onSuccess 回调触发列表刷新。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5
+ */
+import { Trash2, X } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import { useBatchDeleteFiles } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+
+export interface FileBatchOperationsProps {
+  /** 选中的文件 ID 集合 */
+  selectedIds: Set<string>;
+  /** 是否全选 */
+  allSelected: boolean;
+  /** 是否部分选中（indeterminate） */
+  someSelected: boolean;
+  /** 全选/取消全选回调 */
+  onSelectAll: () => void;
+  /** 清空选择回调 */
+  onClearSelection: () => void;
+  /** 删除成功后的回调（用于触发列表刷新） */
+  onSuccess?: () => void;
+}
+
+/**
+ * FileBatchOperations：文件批量操作工具栏。
+ *
+ * 当 selectedIds 为空时返回 null（不渲染）。
+ * 有选中项时显示工具栏，点击批量删除弹出确认模态。
+ */
+export function FileBatchOperations({
+  selectedIds,
+  allSelected,
+  someSelected,
+  onSelectAll,
+  onClearSelection,
+  onSuccess,
+}: FileBatchOperationsProps): React.ReactElement | null {
+  const t = useTranslations("admin.files.batch");
+  const [confirmOpen, setConfirmOpen] = useState(false);
+  const { run: batchDelete, loading } = useBatchDeleteFiles();
+  const checkboxRef = useRef<HTMLInputElement | null>(null);
+
+  const count = selectedIds.size;
+
+  useEffect(() => {
+    if (checkboxRef.current) {
+      checkboxRef.current.indeterminate = someSelected;
+    }
+  }, [someSelected]);
+
+  if (count === 0) return null;
+
+  const handleDelete = async (): Promise<void> => {
+    const ids = Array.from(selectedIds);
+    try {
+      const result = await batchDelete(ids);
+      notify.success(t("deleteSuccess", { count: result.deletedCount }));
+      setConfirmOpen(false);
+      onClearSelection();
+      onSuccess?.();
+    } catch (err) {
+      notify.error(String(err));
+      setConfirmOpen(false);
+    }
+  };
+
+  return (
+    <>
+      <div className="flex items-center gap-3 rounded-lg border bg-muted/30 px-4 py-2">
+        <label className="flex items-center gap-2 text-sm">
+          <input
+            ref={checkboxRef}
+            type="checkbox"
+            checked={allSelected}
+            onChange={onSelectAll}
+            className="size-4 cursor-pointer rounded border-input"
+            aria-label={t("selectAll")}
+          />
+          <span>{t("selectAll")}</span>
+        </label>
+        <span className="text-sm font-medium">
+          {t("selectedCount", { count })}
+        </span>
+        <Button variant="ghost" size="sm" onClick={onClearSelection}>
+          {t("clearSelection")}
+        </Button>
+        <div className="flex-1" />
+        <Button
+          variant="destructive"
+          size="sm"
+          onClick={() => setConfirmOpen(true)}
+          disabled={loading}
+        >
+          <Trash2 className="size-4" />
+          {loading ? t("confirming") : t("batchDelete")}
+        </Button>
+      </div>
+
+      {confirmOpen ? (
+        <ConfirmDialog
+          title={t("confirmTitle")}
+          description={t("confirmDescription", { count })}
+          cancelLabel={t("confirmCancel")}
+          submitLabel={t("confirmSubmit")}
+          confirmingLabel={t("confirming")}
+          loading={loading}
+          onCancel={() => setConfirmOpen(false)}
+          onConfirm={handleDelete}
+        />
+      ) : null}
+    </>
+  );
+}
+
+interface ConfirmDialogProps {
+  title: string;
+  description: string;
+  cancelLabel: string;
+  submitLabel: string;
+  confirmingLabel: string;
+  loading: boolean;
+  onCancel: () => void;
+  onConfirm: () => void;
+}
+
+/**
+ * 轻量确认模态（自实现，避免引入额外 dialog 依赖）。
+ *
+ * - 点击遮罩或按 ESC 关闭（loading 期间禁用关闭）
+ * - destructive 风格确认按钮
+ */
+function ConfirmDialog({
+  title,
+  description,
+  cancelLabel,
+  submitLabel,
+  confirmingLabel,
+  loading,
+  onCancel,
+  onConfirm,
+}: ConfirmDialogProps): React.ReactElement {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent): void => {
+      if (e.key === "Escape" && !loading) onCancel();
+    };
+    window.addEventListener("keydown", handler);
+    return () => window.removeEventListener("keydown", handler);
+  }, [loading, onCancel]);
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50"
+      onClick={() => {
+        if (!loading) onCancel();
+      }}
+      role="dialog"
+      aria-modal="true"
+      aria-label={title}
+    >
+      <div
+        className="w-full max-w-md rounded-lg bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="flex items-start justify-between gap-4">
+          <h2 className="text-lg font-semibold">{title}</h2>
+          <button
+            type="button"
+            onClick={onCancel}
+            disabled={loading}
+            className="text-muted-foreground hover:text-foreground"
+            aria-label={cancelLabel}
+          >
+            <X className="size-5" />
+          </button>
+        </div>
+        <p className="mt-3 text-sm text-muted-foreground">{description}</p>
+        <div className="mt-6 flex justify-end gap-2">
+          <Button variant="outline" onClick={onCancel} disabled={loading}>
+            {cancelLabel}
+          </Button>
+          <Button variant="destructive" onClick={onConfirm} disabled={loading}>
+            {loading ? confirmingLabel : submitLabel}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/files/file-preview-dialog.tsx b/apps/portal-shell/src/features/admin/files/file-preview-dialog.tsx
new file mode 100644
index 0000000..b1a611c
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/files/file-preview-dialog.tsx
@@ -0,0 +1,515 @@
+"use client";
+
+/**
+ * 文件预览对话框（ARCHITECTURE.md §5.4 / §9.4 / §10 P5）
+ *
+ * 基于 CICD 项目 src/modules/files/components/file-preview-dialog.tsx 适配
+ * 到 portal-shell：Server Actions → Apollo Client + MSW 兜底。
+ *
+ * 组件层次：
+ * - FilePreviewDialog：Dialog 外壳，触发按钮 + 标题 + 内容容器
+ * - FilePreview：根据 mimeType 渲染不同预览体（image/pdf/text/office/other）
+ * - FileIcon：根据 mimeType 渲染分类图标
+ *
+ * 内部 hooks：
+ * - useFilePreview：fetch 文本内容（懒加载，错误重试）
+ * - useImageZoom：图片缩放控制
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5
+ */
+import {
+  Download,
+  Eye,
+  File as FileLucide,
+  FileImage,
+  FileArchive,
+  FileSpreadsheet,
+  FileText,
+  FileType,
+  Presentation,
+  ZoomIn,
+  ZoomOut,
+} from "lucide-react";
+import { useCallback, useState } from "react";
+import { useTranslations } from "next-intl";
+import type { ComponentType, ReactNode } from "react";
+
+import type { FileAttachment } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/shared/components/ui/dialog";
+import { cn } from "@/shared/lib/utils";
+
+import { formatFileSize, formatMimeType } from "./transformations";
+
+// ============================================================
+// FileIcon：根据 mimeType 渲染分类图标
+// ============================================================
+
+type FileCategory =
+  | "image"
+  | "pdf"
+  | "word"
+  | "excel"
+  | "powerpoint"
+  | "text"
+  | "archive"
+  | "other";
+
+const ICON_MAP: Record<FileCategory, ComponentType<{ className?: string }>> = {
+  image: FileImage,
+  pdf: FileText,
+  word: FileText,
+  excel: FileSpreadsheet,
+  powerpoint: Presentation,
+  text: FileType,
+  archive: FileArchive,
+  other: FileLucide,
+};
+
+const COLOR_MAP: Record<FileCategory, string> = {
+  image: "text-pink-600",
+  pdf: "text-red-600",
+  word: "text-blue-600",
+  excel: "text-green-600",
+  powerpoint: "text-orange-600",
+  text: "text-muted-foreground",
+  archive: "text-yellow-600",
+  other: "text-muted-foreground",
+};
+
+function resolveCategory(mimeType: string): FileCategory {
+  if (mimeType.startsWith("image/")) return "image";
+  if (mimeType === "application/pdf") return "pdf";
+  if (
+    mimeType === "application/msword" ||
+    mimeType ===
+      "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+  ) {
+    return "word";
+  }
+  if (
+    mimeType === "application/vnd.ms-excel" ||
+    mimeType ===
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+  ) {
+    return "excel";
+  }
+  if (
+    mimeType === "application/vnd.ms-powerpoint" ||
+    mimeType ===
+      "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+  ) {
+    return "powerpoint";
+  }
+  if (mimeType === "text/plain" || mimeType === "text/markdown") return "text";
+  if (
+    mimeType === "application/zip" ||
+    mimeType === "application/x-rar-compressed"
+  ) {
+    return "archive";
+  }
+  return "other";
+}
+
+export function FileIcon({
+  mimeType,
+  className,
+}: {
+  mimeType: string;
+  className?: string;
+}): ReactNode {
+  const category = resolveCategory(mimeType);
+  const Icon = ICON_MAP[category];
+  return (
+    <Icon
+      className={cn("size-5", COLOR_MAP[category], className)}
+      aria-hidden="true"
+    />
+  );
+}
+
+// ============================================================
+// Hooks：文本预览 & 图片缩放
+// ============================================================
+
+export interface UseFilePreviewReturn {
+  content: string | null;
+  error: string | null;
+  loading: boolean;
+  load: (url: string) => Promise<void>;
+}
+
+/**
+ * 文本文件预览 hook：封装 fetch + 错误处理 + 状态机。
+ * 错误消息保留原始字符串，由组件层用 i18n 翻译。
+ */
+export function useFilePreview(): UseFilePreviewReturn {
+  const [content, setContent] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  const load = useCallback(async (url: string): Promise<void> => {
+    setLoading(true);
+    setError(null);
+    try {
+      const res = await fetch(url);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const text = await res.text();
+      setContent(text);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : "Failed to load text");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  return { content, error, loading, load };
+}
+
+/**
+ * 图片预览缩放控制 hook
+ */
+export function useImageZoom(
+  initial = 1,
+  min = 0.25,
+  max = 4,
+): {
+  zoom: number;
+  zoomIn: () => void;
+  zoomOut: () => void;
+  canZoomIn: boolean;
+  canZoomOut: boolean;
+} {
+  const [zoom, setZoom] = useState(initial);
+  const zoomIn = useCallback(
+    () => setZoom((z) => Math.min(max, z + 0.25)),
+    [max],
+  );
+  const zoomOut = useCallback(
+    () => setZoom((z) => Math.max(min, z - 0.25)),
+    [min],
+  );
+  return {
+    zoom,
+    zoomIn,
+    zoomOut,
+    canZoomIn: zoom < max,
+    canZoomOut: zoom > min,
+  };
+}
+
+// ============================================================
+// FilePreview：根据 mimeType 渲染不同预览体
+// ============================================================
+
+type PreviewKind = "image" | "pdf" | "text" | "office" | "other";
+
+const TEXT_MIME_TYPES = new Set([
+  "text/plain",
+  "text/markdown",
+  "text/csv",
+  "application/json",
+  "text/html",
+  "text/css",
+  "text/javascript",
+]);
+
+const OFFICE_MIME_TYPES = new Set([
+  "application/msword",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  "application/vnd.ms-excel",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "application/vnd.ms-powerpoint",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+]);
+
+function classify(mimeType: string): PreviewKind {
+  if (mimeType.startsWith("image/")) return "image";
+  if (mimeType === "application/pdf") return "pdf";
+  if (TEXT_MIME_TYPES.has(mimeType)) return "text";
+  if (OFFICE_MIME_TYPES.has(mimeType)) return "office";
+  return "other";
+}
+
+interface FilePreviewProps {
+  file: FileAttachment;
+  className?: string;
+}
+
+export function FilePreview({ file, className }: FilePreviewProps): ReactNode {
+  const t = useTranslations("admin.files.preview");
+  const kind = classify(file.mimeType);
+  const url = file.url ?? "#";
+
+  return (
+    <div className={className}>
+      <div className="mb-3 flex items-center justify-between gap-3">
+        <div className="flex min-w-0 items-center gap-2">
+          <FileIcon mimeType={file.mimeType} className="size-5" />
+          <div className="min-w-0">
+            <p className="truncate text-sm font-medium" title={file.name}>
+              {file.name}
+            </p>
+            <p className="text-xs text-muted-foreground">
+              {formatFileSize(file.size)} · {formatMimeType(file.mimeType)}
+            </p>
+          </div>
+        </div>
+        <Button asChild variant="outline" size="sm">
+          <a
+            href={url}
+            download={file.name}
+            target="_blank"
+            rel="noopener noreferrer"
+            aria-label={`${t("download")} ${file.name}`}
+          >
+            <Download className="mr-2 size-4" aria-hidden="true" />
+            {t("download")}
+          </a>
+        </Button>
+      </div>
+
+      <PreviewBody kind={kind} file={file} url={url} />
+    </div>
+  );
+}
+
+function PreviewBody({
+  kind,
+  file,
+  url,
+}: {
+  kind: PreviewKind;
+  file: FileAttachment;
+  url: string;
+}): ReactNode {
+  if (kind === "image") {
+    return <ImagePreview url={url} alt={file.name} />;
+  }
+
+  if (kind === "pdf") {
+    return (
+      <iframe
+        src={url}
+        title={file.name}
+        aria-label={`PDF preview: ${file.name}`}
+        className="h-[70vh] w-full rounded-md border"
+      />
+    );
+  }
+
+  if (kind === "text") {
+    return <TextPreview url={url} />;
+  }
+
+  return <OtherPreview kind={kind} file={file} url={url} />;
+}
+
+function ImagePreview({ url, alt }: { url: string; alt: string }): ReactNode {
+  const t = useTranslations("admin.files.preview");
+  const { zoom, zoomIn, zoomOut, canZoomIn, canZoomOut } = useImageZoom();
+
+  return (
+    <div className="space-y-2">
+      <div className="flex items-center justify-end gap-2">
+        <Button
+          type="button"
+          variant="outline"
+          size="icon"
+          className="size-8"
+          onClick={zoomOut}
+          disabled={!canZoomOut}
+          aria-label={t("zoomOut")}
+        >
+          <ZoomOut className="size-4" aria-hidden="true" />
+        </Button>
+        <span
+          className="w-12 text-center text-xs text-muted-foreground"
+          aria-live="polite"
+        >
+          {Math.round(zoom * 100)}%
+        </span>
+        <Button
+          type="button"
+          variant="outline"
+          size="icon"
+          className="size-8"
+          onClick={zoomIn}
+          disabled={!canZoomIn}
+          aria-label={t("zoomIn")}
+        >
+          <ZoomIn className="size-4" aria-hidden="true" />
+        </Button>
+      </div>
+      <div
+        className="overflow-auto rounded-md border bg-muted/30 p-2"
+        style={{ maxHeight: "70vh" }}
+      >
+        <img
+          src={url}
+          alt={alt}
+          style={{ transform: `scale(${zoom})`, transformOrigin: "top left" }}
+          className="mx-auto max-w-full transition-transform"
+        />
+      </div>
+    </div>
+  );
+}
+
+function TextPreview({ url }: { url: string }): ReactNode {
+  const t = useTranslations("admin.files.preview.text");
+  const { content, error, loading, load } = useFilePreview();
+
+  if (content === null && !error && !loading) {
+    return (
+      <div className="flex flex-col items-center justify-center rounded-md border border-dashed p-12 text-center">
+        <FileText
+          className="size-12 text-muted-foreground"
+          aria-hidden="true"
+        />
+        <p className="mt-3 text-sm font-medium">{t("title")}</p>
+        <p className="mt-1 text-xs text-muted-foreground">{t("hint")}</p>
+        <Button
+          variant="outline"
+          size="sm"
+          className="mt-4"
+          onClick={() => void load(url)}
+        >
+          {t("load")}
+        </Button>
+      </div>
+    );
+  }
+
+  if (loading) {
+    return (
+      <div
+        role="status"
+        className="rounded-md border bg-muted/30 p-12 text-center text-sm text-muted-foreground"
+      >
+        {t("loading")}
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div
+        role="alert"
+        className="flex flex-col items-center justify-center gap-3 rounded-md border border-destructive/40 bg-destructive/10 p-4 text-sm text-destructive"
+      >
+        <span>{t("error", { message: error })}</span>
+        <Button variant="outline" size="sm" onClick={() => void load(url)}>
+          {t("load")}
+        </Button>
+      </div>
+    );
+  }
+
+  return (
+    <pre className="max-h-[70vh] overflow-auto rounded-md border bg-background p-4 text-xs leading-relaxed">
+      <code>{content}</code>
+    </pre>
+  );
+}
+
+function OtherPreview({
+  kind,
+  file,
+  url,
+}: {
+  kind: PreviewKind;
+  file: FileAttachment;
+  url: string;
+}): ReactNode {
+  const t = useTranslations("admin.files.preview");
+  const isOffice = kind === "office";
+  const title = isOffice ? t("office.title") : t("other.title");
+  const hint = isOffice ? t("office.hint") : t("other.hint");
+
+  return (
+    <div className="flex flex-col items-center justify-center rounded-md border border-dashed p-12 text-center">
+      <FileIcon mimeType={file.mimeType} className="size-12" />
+      <p className="mt-3 text-sm font-medium">{title}</p>
+      <p className="mt-1 text-xs text-muted-foreground">{hint}</p>
+      <Button asChild variant="outline" size="sm" className="mt-4">
+        <a
+          href={url}
+          download={file.name}
+          target="_blank"
+          rel="noopener noreferrer"
+          aria-label={`${t("download")} ${file.name}`}
+        >
+          <Download className="mr-2 size-4" aria-hidden="true" />
+          {t("download")}
+        </a>
+      </Button>
+    </div>
+  );
+}
+
+// ============================================================
+// FilePreviewDialog：Dialog 外壳
+// ============================================================
+
+interface FilePreviewDialogProps {
+  file: FileAttachment;
+  trigger?: ReactNode;
+  triggerLabel?: string;
+  triggerVariant?:
+    "default" | "outline" | "secondary" | "ghost" | "destructive";
+  triggerSize?: "default" | "sm" | "lg" | "icon";
+}
+
+export function FilePreviewDialog({
+  file,
+  trigger,
+  triggerLabel,
+  triggerVariant = "ghost",
+  triggerSize = "sm",
+}: FilePreviewDialogProps): ReactNode {
+  const t = useTranslations("admin.files.preview");
+
+  return (
+    <Dialog>
+      <DialogTrigger asChild>
+        {trigger ?? (
+          <Button
+            type="button"
+            variant={triggerVariant}
+            size={triggerSize}
+            aria-label={t("trigger")}
+          >
+            <Eye
+              className={triggerLabel ? "mr-2 size-4" : "size-4"}
+              aria-hidden="true"
+            />
+            {triggerLabel ? (
+              <span>{triggerLabel}</span>
+            ) : (
+              <span className="sr-only">{t("trigger")}</span>
+            )}
+          </Button>
+        )}
+      </DialogTrigger>
+      <DialogContent className="max-h-[90vh] max-w-5xl overflow-hidden">
+        <DialogHeader>
+          <DialogTitle className="truncate">{file.name}</DialogTitle>
+          <DialogDescription>
+            {t("title")} · {formatMimeType(file.mimeType)}
+          </DialogDescription>
+        </DialogHeader>
+        <div className="max-h-[75vh] overflow-auto">
+          <FilePreview file={file} />
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/files/file-upload-button.tsx b/apps/portal-shell/src/features/admin/files/file-upload-button.tsx
new file mode 100644
index 0000000..d4e0b89
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/files/file-upload-button.tsx
@@ -0,0 +1,187 @@
+"use client";
+
+/**
+ * 文件上传按钮组件（ARCHITECTURE.md §5.4 / §9.4 / §10 P5）
+ *
+ * 对齐 CICD 项目：
+ * - 隐藏的 file input + 触发按钮
+ * - 拖拽上传区域（drag-and-drop）
+ * - 上传进度条（模拟进度，GraphQL mutation 不暴露真实 progress）
+ *
+ * 调用 useUploadFile hook，上传中显示 loading 状态与进度条。
+ * 成功后通过 onSuccess 回调通知父组件刷新列表。
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §9.4 / §10 P5
+ */
+import { UploadCloud } from "lucide-react";
+import { useCallback, useRef, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import { useUploadFile, type UploadFileInput } from "@/lib/api";
+import { Progress } from "@/shared/components/ui/progress";
+import { cn } from "@/shared/lib/utils";
+import { notify } from "@/shared/lib/notify";
+
+export interface FileUploadButtonProps {
+  /** 上传成功后的回调（用于触发列表刷新） */
+  onSuccess?: () => void;
+}
+
+const PROGRESS_INTERVAL_MS = 200;
+const PROGRESS_INCREMENT = 10;
+const PROGRESS_CAP = 90;
+
+/**
+ * FileUploadButton：单文件上传触发器（支持拖拽 + 进度条）。
+ *
+ * 点击按钮打开系统文件选择器，或将文件拖拽到按钮区域。
+ * 选中后构造 UploadFileInput 调用 useUploadFile。
+ * 上传期间按钮禁用并显示进度条。
+ */
+export function FileUploadButton({
+  onSuccess,
+}: FileUploadButtonProps): React.ReactElement {
+  const t = useTranslations("admin.files.upload");
+  const inputRef = useRef<HTMLInputElement | null>(null);
+  const [uploading, setUploading] = useState(false);
+  const [progress, setProgress] = useState(0);
+  const [dragActive, setDragActive] = useState(false);
+  const [fileName, setFileName] = useState<string>("");
+  const { run: uploadFile, loading: hookLoading } = useUploadFile();
+
+  const startProgress = useCallback((): (() => void) => {
+    setProgress(0);
+    const timer = setInterval(() => {
+      setProgress((prev) => {
+        if (prev >= PROGRESS_CAP) return prev;
+        return Math.min(prev + PROGRESS_INCREMENT, PROGRESS_CAP);
+      });
+    }, PROGRESS_INTERVAL_MS);
+    return () => clearInterval(timer);
+  }, []);
+
+  const handleFile = useCallback(
+    async (file: File): Promise<void> => {
+      const input: UploadFileInput = {
+        filename: file.name,
+        mimeType: file.type,
+        size: file.size,
+      };
+      setFileName(file.name);
+      setUploading(true);
+      const stopProgress = startProgress();
+      try {
+        await uploadFile(input);
+        setProgress(100);
+        notify.success(t("success"));
+        onSuccess?.();
+      } catch (err) {
+        notify.error(String(err));
+      } finally {
+        stopProgress();
+        setUploading(false);
+        // 延迟重置进度条，让用户看到 100% 完成态
+        setTimeout(() => {
+          setProgress(0);
+          setFileName("");
+        }, 600);
+        // 重置 input value 以便重复选择同一文件
+        if (inputRef.current) {
+          inputRef.current.value = "";
+        }
+      }
+    },
+    [onSuccess, startProgress, t, uploadFile],
+  );
+
+  const handleFileSelect = async (
+    e: React.ChangeEvent<HTMLInputElement>,
+  ): Promise<void> => {
+    const file = e.target.files?.[0];
+    if (!file) return;
+    await handleFile(file);
+  };
+
+  const handleClick = (): void => {
+    inputRef.current?.click();
+  };
+
+  const handleDragEnter = (e: React.DragEvent<HTMLDivElement>): void => {
+    e.preventDefault();
+    e.stopPropagation();
+    setDragActive(true);
+  };
+
+  const handleDragLeave = (e: React.DragEvent<HTMLDivElement>): void => {
+    e.preventDefault();
+    e.stopPropagation();
+    setDragActive(false);
+  };
+
+  const handleDragOver = (e: React.DragEvent<HTMLDivElement>): void => {
+    e.preventDefault();
+    e.stopPropagation();
+  };
+
+  const handleDrop = async (
+    e: React.DragEvent<HTMLDivElement>,
+  ): Promise<void> => {
+    e.preventDefault();
+    e.stopPropagation();
+    setDragActive(false);
+    if (uploading || hookLoading) return;
+    const file = e.dataTransfer.files?.[0];
+    if (!file) return;
+    await handleFile(file);
+  };
+
+  const isLoading = uploading || hookLoading;
+
+  return (
+    <div className="flex flex-col gap-2">
+      <input
+        ref={inputRef}
+        type="file"
+        className="hidden"
+        onChange={handleFileSelect}
+        disabled={isLoading}
+        aria-label={t("ariaLabel")}
+      />
+      <div
+        role="button"
+        tabIndex={0}
+        onClick={handleClick}
+        onKeyDown={(e) => {
+          if (e.key === "Enter" || e.key === " ") {
+            e.preventDefault();
+            handleClick();
+          }
+        }}
+        onDragEnter={handleDragEnter}
+        onDragLeave={handleDragLeave}
+        onDragOver={handleDragOver}
+        onDrop={handleDrop}
+        className={cn(
+          "flex cursor-pointer items-center gap-2 rounded-md border border-dashed px-4 py-2 text-sm transition-colors",
+          dragActive
+            ? "border-primary bg-primary/5 text-primary"
+            : "border-input bg-background hover:bg-muted/40",
+          isLoading && "cursor-not-allowed opacity-70",
+        )}
+        aria-label={t("dragDrop")}
+      >
+        <UploadCloud className="size-4" />
+        <span>{isLoading ? t("uploading") : t("dragDrop")}</span>
+      </div>
+      {isLoading ? (
+        <div className="flex flex-col gap-1" aria-live="polite">
+          <Progress value={progress} />
+          <span className="text-xs text-muted-foreground">
+            {t("progress", { percent: progress })}
+            {fileName ? ` · ${fileName}` : ""}
+          </span>
+        </div>
+      ) : null}
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/files/files-list-client.tsx b/apps/portal-shell/src/features/admin/files/files-list-client.tsx
index 6d2ba05..dce00f1 100644
--- a/apps/portal-shell/src/features/admin/files/files-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/files/files-list-client.tsx
@@ -1,24 +1,11 @@
 "use client";
 
-/**
- * 文件管理列表页 - 客户端组件（ARCHITECTURE.md §7.3 列表页 / §9.4 / §10 P5）
- *
- * 数据契约：
- * - 列表查询 fileAttachments(filter) ❌ schema 无 → MSW 兜底（@contract-pending）
- * - 统计查询 fileStats ❌ schema 无 → MSW 兜底
- *
- * URL 状态：无（搜索为客户端过滤，mimeType 筛选可通过扩展支持）
- *
- * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState + 行动按钮）
- *
- * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
- */
 import { FileText, Files } from "lucide-react";
-import { useMemo, useState } from "react";
+import { useSearchParams, useRouter } from "next/navigation";
+import { useCallback, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import { useFileAttachments, useFileStats } from "@/lib/api";
-import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import {
@@ -26,207 +13,362 @@ import {
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
 import { StatCard } from "@/shared/components/ui/stat-card";
-import { notify } from "@/shared/lib/notify";
 import {
+  categorizeFileByName,
+  categoryToIconColor,
   formatFileDate,
   formatFileSize,
   formatMimeType,
+  type FileTypeCategory,
 } from "@/features/admin/files/transformations";
+import { FileUploadButton } from "@/features/admin/files/file-upload-button";
+import { FileBatchOperations } from "@/features/admin/files/file-batch-operations";
+import { FilePreviewDialog } from "@/features/admin/files/file-preview-dialog";
+import { SectionErrorBoundary } from "@/shared/components/section-error-boundary";
+import { cn } from "@/shared/lib/utils";
 
-/** 默认拉取条数（FileFilter.limit） */
 const DEFAULT_LIMIT = 100;
 
-/**
- * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
- * （useSearchParams 不使用，但 StatCard 等组件为 client-only）。
- */
+/** 文件类型筛选选项（value 为空表示全部） */
+const FILE_TYPE_OPTIONS: Array<{
+  value: string;
+  category: FileTypeCategory | null;
+}> = [
+  { value: "", category: null },
+  { value: "image", category: "image" },
+  { value: "document", category: "document" },
+  { value: "video", category: "video" },
+  { value: "audio", category: "audio" },
+  { value: "other", category: "other" },
+];
+
+interface FileItem {
+  id: string;
+  name: string;
+  size: number;
+  mimeType: string;
+  url: string;
+  uploadedBy: string;
+  uploadedAt: string;
+}
+
 export function FilesListClient(): React.ReactElement {
   const t = useTranslations("admin.files.list");
-  const tCommon = useTranslations("common");
+  const tError = useTranslations("admin.files.error");
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const [, startTransition] = useTransition();
   const [search, setSearch] = useState("");
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
 
-  // @contract-pending：MSW 兜底
-  const { data, loading, error } = useFileAttachments({
+  const fileType = searchParams.get("fileType") ?? "";
+
+  const updateFileType = useCallback(
+    (value: string): void => {
+      const params = new URLSearchParams(searchParams.toString());
+      if (value) {
+        params.set("fileType", value);
+      } else {
+        params.delete("fileType");
+      }
+      startTransition(() => {
+        router.push(`/shell/admin/files?${params.toString()}`);
+      });
+    },
+    [router, searchParams],
+  );
+
+  const { data, loading, error, refetch } = useFileAttachments({
     limit: DEFAULT_LIMIT,
   });
-  // @contract-pending：MSW 兜底
   const { data: stats, loading: statsLoading } = useFileStats();
 
-  const allItems = data?.items ?? [];
+  const allItems: FileItem[] = data?.items ?? [];
   const filteredItems = useMemo(() => {
-    if (!search.trim()) return allItems;
-    const q = search.trim().toLowerCase();
-    return allItems.filter((f) => f.name.toLowerCase().includes(q));
-  }, [allItems, search]);
+    let items = allItems;
+    if (search.trim()) {
+      const q = search.trim().toLowerCase();
+      items = items.filter((f) => f.name.toLowerCase().includes(q));
+    }
+    if (fileType) {
+      const targetCategory = FILE_TYPE_OPTIONS.find(
+        (opt) => opt.value === fileType,
+      )?.category;
+      if (targetCategory) {
+        items = items.filter(
+          (f) => categorizeFileByName(f.name) === targetCategory,
+        );
+      }
+    }
+    return items;
+  }, [allItems, search, fileType]);
 
-  const errorNode = error ? (
-    <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
-      <p className="text-sm text-destructive">
-        {tCommon("error.loadFailed", { message: String(error) })}
-      </p>
-      <p className="mt-2 text-xs text-muted-foreground">{t("mswNotice")}</p>
-    </div>
-  ) : undefined;
+  const allSelected =
+    filteredItems.length > 0 &&
+    filteredItems.every((item) => selectedIds.has(item.id));
+  const someSelected = selectedIds.size > 0 && !allSelected;
 
-  const emptyNode = (
-    <EmptyState
-      icon={Files}
-      title={t("emptyTitle")}
-      description={t("emptyDescription")}
-      action={{
-        label: t("emptyAction"),
-        href: "/shell/admin/files",
-      }}
-    />
+  const toggleAll = useCallback((): void => {
+    setSelectedIds((prev) => {
+      if (filteredItems.length === 0) return prev;
+      const allIn = filteredItems.every((item) => prev.has(item.id));
+      const next = new Set(prev);
+      if (allIn) {
+        for (const item of filteredItems) {
+          next.delete(item.id);
+        }
+      } else {
+        for (const item of filteredItems) {
+          next.add(item.id);
+        }
+      }
+      return next;
+    });
+  }, [filteredItems]);
+
+  const toggleOne = useCallback((id: string): void => {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) {
+        next.delete(id);
+      } else {
+        next.add(id);
+      }
+      return next;
+    });
+  }, []);
+
+  const clearSelection = useCallback((): void => {
+    setSelectedIds(new Set());
+  }, []);
+
+  const handleUploadSuccess = useCallback((): void => {
+    clearSelection();
+    void refetch();
+  }, [clearSelection, refetch]);
+
+  const handleBatchDeleteSuccess = useCallback((): void => {
+    void refetch();
+  }, [refetch]);
+
+  const totalFiles = stats?.totalFiles ?? 0;
+  const totalSize = stats?.totalSize ?? 0;
+  const byTypeCount = stats?.byType ? Object.keys(stats.byType).length : 0;
+
+  const topTypes = stats?.byType
+    ? Object.entries(stats.byType)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 2)
+        .map(([type, count]) => formatMimeType(type) + ": " + count)
+        .join(", ")
+    : "--";
+
+  const filters = (
+    <>
+      <FilterSearchInput
+        value={search}
+        onChange={setSearch}
+        placeholder={t("searchPlaceholder")}
+      />
+      <select
+        value={fileType}
+        onChange={(e) => updateFileType(e.target.value)}
+        aria-label={t("fileTypeFilter")}
+        className="h-9 w-40 rounded-md border border-input bg-background px-3 text-sm"
+      >
+        <option value="">{t("allTypes")}</option>
+        <option value="image">{t("typeImage")}</option>
+        <option value="document">{t("typeDocument")}</option>
+        <option value="video">{t("typeVideo")}</option>
+        <option value="audio">{t("typeAudio")}</option>
+        <option value="other">{t("typeOther")}</option>
+      </select>
+    </>
   );
 
+  const actions = <FileUploadButton onSuccess={handleUploadSuccess} />;
+
+  if (loading) {
+    return (
+      <ListPageShell
+        title={t("title")}
+        description={t("description")}
+        icon={<Files className="size-6" />}
+        actions={actions}
+        filters={filters}
+        loading
+      >
+        <ListPageSkeleton />
+      </ListPageShell>
+    );
+  }
+
+  if (error) {
+    return (
+      <ListPageShell
+        title={t("title")}
+        description={t("description")}
+        icon={<Files className="size-6" />}
+        actions={actions}
+        filters={filters}
+        errorNode={
+          <EmptyState title={tError("title")} description={tError("unknown")} />
+        }
+      />
+    );
+  }
+
   return (
     <ListPageShell
       title={t("title")}
       description={t("description")}
       icon={<Files className="size-6" />}
-      actions={
-        <Button onClick={() => notify.info(t("mswNotice"))}>
-          {t("uploadButton")}
-        </Button>
-      }
-      filters={
-        <FilterSearchInput
-          placeholder={t("searchPlaceholder")}
-          value={search}
-          onChange={setSearch}
+      actions={actions}
+      filters={filters}
+      empty={filteredItems.length === 0}
+      emptyNode={
+        <EmptyState
+          title={t("emptyTitle")}
+          description={t("emptyDescription")}
         />
       }
-      loading={loading}
-      loadingNode={<ListPageSkeleton rows={5} />}
-      empty={filteredItems.length === 0 && !loading}
-      emptyNode={emptyNode}
-      errorNode={errorNode}
-      pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: filteredItems.length })}</span>
-        </div>
-      }
     >
-      <div className="flex flex-col gap-6">
-        <FilesStatsCards stats={stats} loading={statsLoading} />
-        <FilesTable items={filteredItems} />
+      <SectionErrorBoundary title={t("sectionStats")}>
+        <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+          <StatCard
+            title={t("statTotalFiles")}
+            value={totalFiles}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTotalSize")}
+            value={formatFileSize(totalSize)}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statByType")}
+            value={byTypeCount}
+            isLoading={statsLoading}
+          />
+          <StatCard
+            title={t("statTopType")}
+            value={topTypes}
+            description={t("statTopTypeHint")}
+            isLoading={statsLoading}
+          />
+        </div>
+      </SectionErrorBoundary>
+
+      <FileBatchOperations
+        selectedIds={selectedIds}
+        allSelected={allSelected}
+        someSelected={someSelected}
+        onSelectAll={toggleAll}
+        onClearSelection={clearSelection}
+        onSuccess={handleBatchDeleteSuccess}
+      />
+
+      <div className="overflow-x-auto rounded-xl border bg-card">
+        <table className="w-full text-sm">
+          <thead className="border-b bg-muted/30">
+            <tr>
+              <th className="w-10 px-3 py-3 text-left">
+                <input
+                  type="checkbox"
+                  checked={allSelected}
+                  onChange={toggleAll}
+                  className="size-4 cursor-pointer rounded border-input"
+                  aria-label={t("selectAll")}
+                  disabled={filteredItems.length === 0}
+                />
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colName")}
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colSize")}
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colMimeType")}
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colUploadedBy")}
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colUploadedAt")}
+              </th>
+              <th className="px-3 py-3 text-left font-medium">
+                {t("colActions")}
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            {filteredItems.map((file) => {
+              const isSelected = selectedIds.has(file.id);
+              return (
+                <tr
+                  key={file.id}
+                  className={
+                    isSelected
+                      ? "border-b bg-muted/40"
+                      : "border-b hover:bg-muted/20"
+                  }
+                >
+                  <td className="px-3 py-3">
+                    <input
+                      type="checkbox"
+                      checked={isSelected}
+                      onChange={() => toggleOne(file.id)}
+                      className="size-4 cursor-pointer rounded border-input"
+                      aria-label={t("selectRow")}
+                    />
+                  </td>
+                  <td className="px-3 py-3">
+                    <div className="flex items-center gap-2">
+                      <FileText
+                        className={cn(
+                          "size-4",
+                          categoryToIconColor(categorizeFileByName(file.name)),
+                        )}
+                      />
+                      <span className="font-medium">{file.name}</span>
+                    </div>
+                  </td>
+                  <td className="px-3 py-3 text-muted-foreground">
+                    {formatFileSize(file.size)}
+                  </td>
+                  <td className="px-3 py-3 text-muted-foreground">
+                    {formatMimeType(file.mimeType)}
+                  </td>
+                  <td className="px-3 py-3 text-muted-foreground">
+                    {file.uploadedBy}
+                  </td>
+                  <td className="px-3 py-3 text-muted-foreground">
+                    {formatFileDate(file.uploadedAt)}
+                  </td>
+                  <td className="px-3 py-3">
+                    <div className="flex items-center gap-2">
+                      <FilePreviewDialog file={file} />
+                      <a
+                        href={file.url}
+                        target="_blank"
+                        rel="noreferrer"
+                        className="text-primary hover:underline"
+                      >
+                        {t("download")}
+                      </a>
+                    </div>
+                  </td>
+                </tr>
+              );
+            })}
+          </tbody>
+        </table>
+      </div>
+
+      <div className="text-sm text-muted-foreground">
+        {t("total", { count: filteredItems.length })}
       </div>
     </ListPageShell>
   );
 }
-
-/**
- * 统计卡片组（总文件数 + 总大小 + 类型分布）。
- */
-function FilesStatsCards({
-  stats,
-  loading,
-}: {
-  stats:
-    | { totalFiles: number; totalSize: number; byType: Record<string, number> }
-    | null
-    | undefined;
-  loading: boolean;
-}): React.ReactElement {
-  const t = useTranslations("admin.files.list");
-  const totalFiles = stats?.totalFiles ?? 0;
-  const totalSize = stats?.totalSize ?? 0;
-  const byType = stats?.byType ?? {};
-  const typeCount = Object.keys(byType).length;
-  const typeBreakdown = Object.entries(byType)
-    .map(([type, count]) => `${formatMimeType(type)}: ${count}`)
-    .join("，");
-
-  return (
-    <div className="grid grid-cols-1 gap-4 md:grid-cols-3">
-      <StatCard
-        title={t("statTotalFiles")}
-        value={totalFiles}
-        icon={FileText}
-        isLoading={loading}
-      />
-      <StatCard
-        title={t("statTotalSize")}
-        value={formatFileSize(totalSize)}
-        icon={Files}
-        isLoading={loading}
-      />
-      <StatCard
-        title={t("statByType")}
-        value={typeCount}
-        description={typeBreakdown || undefined}
-        icon={FileText}
-        isLoading={loading}
-      />
-    </div>
-  );
-}
-
-/**
- * 文件列表表格（纯展示组件，对齐 §8.2 排版规范）。
- */
-function FilesTable({
-  items,
-}: {
-  items: Array<{
-    id: string;
-    name: string;
-    size: number;
-    mimeType: string;
-    url: string;
-    uploadedBy: string;
-    uploadedAt: string;
-  }>;
-}): React.ReactElement {
-  const t = useTranslations("admin.files.list");
-  return (
-    <div className="overflow-x-auto rounded-xl border">
-      <table className="w-full text-sm">
-        <thead className="border-b bg-muted/30">
-          <tr>
-            <th className="p-3 text-left font-medium">{t("colName")}</th>
-            <th className="p-3 text-left font-medium">{t("colSize")}</th>
-            <th className="p-3 text-left font-medium">{t("colMimeType")}</th>
-            <th className="p-3 text-left font-medium">{t("colUploadedBy")}</th>
-            <th className="p-3 text-left font-medium">{t("colUploadedAt")}</th>
-            <th className="p-3 text-right font-medium">{t("colActions")}</th>
-          </tr>
-        </thead>
-        <tbody className="divide-y">
-          {items.map((item) => (
-            <tr key={item.id} className="hover:bg-muted/30">
-              <td className="p-3 font-medium">{item.name}</td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatFileSize(item.size)}
-              </td>
-              <td className="p-3 text-muted-foreground">
-                {formatMimeType(item.mimeType)}
-              </td>
-              <td className="p-3 text-muted-foreground">{item.uploadedBy}</td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatFileDate(item.uploadedAt)}
-              </td>
-              <td className="p-3">
-                <div className="flex items-center justify-end gap-1">
-                  <Button asChild variant="ghost" size="sm">
-                    <a href={item.url} target="_blank" rel="noreferrer">
-                      {t("download")}
-                    </a>
-                  </Button>
-                  <Button
-                    variant="ghost"
-                    size="sm"
-                    onClick={() => notify.warning(t("mswNotice"))}
-                  >
-                    {t("delete")}
-                  </Button>
-                </div>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-    </div>
-  );
-}
diff --git a/apps/portal-shell/src/features/admin/files/transformations.ts b/apps/portal-shell/src/features/admin/files/transformations.ts
index f33176a..1dbcf82 100644
--- a/apps/portal-shell/src/features/admin/files/transformations.ts
+++ b/apps/portal-shell/src/features/admin/files/transformations.ts
@@ -83,3 +83,71 @@ export function mimeTypeToCategory(mimeType: string): string {
   if (slashIndex <= 0) return "unknown";
   return mimeType.slice(0, slashIndex);
 }
+
+/** 文件类型分类（按扩展名聚合，用于列表筛选） */
+export type FileTypeCategory =
+  "image" | "document" | "video" | "audio" | "other";
+
+const EXTENSION_TO_CATEGORY: Record<string, FileTypeCategory> = {
+  jpg: "image",
+  jpeg: "image",
+  png: "image",
+  gif: "image",
+  webp: "image",
+  svg: "image",
+  pdf: "document",
+  doc: "document",
+  docx: "document",
+  xls: "document",
+  xlsx: "document",
+  ppt: "document",
+  pptx: "document",
+  txt: "document",
+  md: "document",
+  mp4: "video",
+  avi: "video",
+  mov: "video",
+  wmv: "video",
+  flv: "video",
+  webm: "video",
+  mp3: "audio",
+  wav: "audio",
+  ogg: "audio",
+  flac: "audio",
+  aac: "audio",
+};
+
+/**
+ * 从文件名提取小写扩展名（不含点）。无扩展名返回空字符串。
+ */
+export function extractFileExtension(fileName: string): string {
+  if (!fileName) return "";
+  const dotIndex = fileName.lastIndexOf(".");
+  if (dotIndex <= 0 || dotIndex === fileName.length - 1) return "";
+  return fileName.slice(dotIndex + 1).toLowerCase();
+}
+
+/**
+ * 根据文件名扩展名归类到 image / document / video / audio / other。
+ * 用于列表"文件类型"筛选。
+ */
+export function categorizeFileByName(fileName: string): FileTypeCategory {
+  const ext = extractFileExtension(fileName);
+  return EXTENSION_TO_CATEGORY[ext] ?? "other";
+}
+
+/** 文件分类 → 图标颜色 Tailwind 类名（对齐 CICD 分类着色） */
+export function categoryToIconColor(category: FileTypeCategory): string {
+  switch (category) {
+    case "image":
+      return "text-emerald-500";
+    case "document":
+      return "text-blue-500";
+    case "video":
+      return "text-purple-500";
+    case "audio":
+      return "text-amber-500";
+    default:
+      return "text-muted-foreground";
+  }
+}
diff --git a/apps/portal-shell/src/features/admin/invitation-codes/generate-invitation-codes-dialog.tsx b/apps/portal-shell/src/features/admin/invitation-codes/generate-invitation-codes-dialog.tsx
new file mode 100644
index 0000000..df42507
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/invitation-codes/generate-invitation-codes-dialog.tsx
@@ -0,0 +1,367 @@
+"use client";
+
+/**
+ * 批量生成邀请码对话框（迁移自 CICD GenerateInvitationCodesDialog）
+ *
+ * 流程：
+ * 1. 用户填写表单（批次名、数量、角色、有效期、用途）
+ * 2. 提交调用 useGenerateInvitationCodes
+ * 3. 成功后切换到「生成结果」视图，展示成功/失败统计 + 明文邀请码 + CSV 下载
+ * 4. 关闭对话框时通过 onGenerated 回调通知父组件刷新
+ *
+ * 设计：
+ * - 使用 shadcn Dialog 组件（对齐 @/shared/components/ui/dialog）
+ * - 单对话框内两个状态（form / result），避免叠加多个 Dialog
+ * - result 视图仅此一次展示明文，关闭后无法再获取
+ *
+ * 关联：ARCHITECTURE.md §7.3 / §9.4 / §10 P5
+ */
+import { useState } from "react";
+import { useTranslations } from "next-intl";
+
+import {
+  useGenerateInvitationCodes,
+  type GeneratedInvitationCode,
+} from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Textarea } from "@/shared/components/ui/textarea";
+import { Select } from "@/shared/components/ui/select";
+import { notify } from "@/shared/lib/notify";
+
+/** 角色选项（与 IAM 角色对齐） */
+const ROLE_OPTIONS = ["teacher", "student", "parent", "admin"] as const;
+
+/** 过期天数选项（对齐任务需求 7/30/90 天） */
+const EXPIRE_DAYS_OPTIONS = [7, 30, 90] as const;
+
+/** 默认数量 */
+const DEFAULT_COUNT = "10";
+/** 默认过期天数 */
+const DEFAULT_EXPIRE_DAYS = 30;
+/** 默认角色 */
+const DEFAULT_ROLE = "teacher";
+/** CSV 列分隔符 */
+const CSV_LINE_SEPARATOR = "\n";
+
+interface GenerateInvitationCodesDialogProps {
+  open: boolean;
+  onClose: () => void;
+  onGenerated: () => void;
+}
+
+type ViewState = "form" | "result";
+
+/**
+ * 批量生成邀请码对话框。open 控制显隐，onGenerated 在成功后触发父组件刷新。
+ */
+export function GenerateInvitationCodesDialog({
+  open,
+  onClose,
+  onGenerated,
+}: GenerateInvitationCodesDialogProps): React.ReactElement {
+  const t = useTranslations("admin.invitationCodes.generateDialog");
+  const tCommon = useTranslations("common");
+  const generateMutation = useGenerateInvitationCodes();
+
+  const [view, setView] = useState<ViewState>("form");
+  const [batchName, setBatchName] = useState<string>("");
+  const [count, setCount] = useState<string>(DEFAULT_COUNT);
+  const [role, setRole] = useState<string>(DEFAULT_ROLE);
+  const [expireDays, setExpireDays] = useState<number>(DEFAULT_EXPIRE_DAYS);
+  const [purpose, setPurpose] = useState<string>("");
+  const [result, setResult] = useState<GeneratedInvitationCode[] | null>(null);
+  const [requestedCount, setRequestedCount] = useState<number>(0);
+
+  const resetForm = (): void => {
+    setBatchName("");
+    setCount(DEFAULT_COUNT);
+    setRole(DEFAULT_ROLE);
+    setExpireDays(DEFAULT_EXPIRE_DAYS);
+    setPurpose("");
+    setResult(null);
+    setView("form");
+  };
+
+  const handleClose = (): void => {
+    if (view === "result") {
+      onGenerated();
+    }
+    onClose();
+  };
+
+  const handleOpenChange = (next: boolean): void => {
+    if (!next) {
+      handleClose();
+      // 延迟重置以便关闭动画完成
+      setTimeout(() => {
+        resetForm();
+      }, 200);
+    }
+  };
+
+  const handleSubmit = async (
+    e: React.FormEvent<HTMLFormElement>,
+  ): Promise<void> => {
+    e.preventDefault();
+    const countNum = Number(count);
+    if (!Number.isFinite(countNum) || countNum < 1 || countNum > 100) {
+      notify.error(t("errorCountRange"));
+      return;
+    }
+    setRequestedCount(countNum);
+    try {
+      const res = await generateMutation.run({
+        count: countNum,
+        role,
+        batchName: batchName.trim() || undefined,
+        expireDays,
+        purpose: purpose.trim() || undefined,
+      });
+      notify.success(t("success", { count: res.generated.length }));
+      setResult(res.generated);
+      setView("result");
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleCopyAll = async (): Promise<void> => {
+    if (!result || result.length === 0) return;
+    const text = result.map((c) => c.code).join(CSV_LINE_SEPARATOR);
+    try {
+      await navigator.clipboard.writeText(text);
+      notify.success(t("copyAll"));
+    } catch {
+      notify.error(t("copyFailed"));
+    }
+  };
+
+  const handleDownloadCsv = (): void => {
+    if (!result || result.length === 0) return;
+    const header = "code,role,expiresAt,batchName,purpose";
+    const rows = result.map((c) =>
+      [
+        c.code,
+        c.role,
+        c.expiresAt,
+        batchName.trim() || "",
+        purpose.trim() || "",
+      ]
+        .map((field) => escapeCsvField(field))
+        .join(","),
+    );
+    const csv = [header, ...rows].join(CSV_LINE_SEPARATOR);
+    const blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = `invitation-codes-${batchName.trim() || "batch"}.csv`;
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+  };
+
+  const successCount = result?.length ?? 0;
+  const failedCount = Math.max(0, requestedCount - successCount);
+
+  return (
+    <Dialog open={open} onOpenChange={handleOpenChange}>
+      <DialogContent className="max-h-[90vh] max-w-2xl overflow-y-auto">
+        {view === "form" ? (
+          <>
+            <DialogHeader>
+              <DialogTitle>{t("title")}</DialogTitle>
+              <DialogDescription>{t("description")}</DialogDescription>
+            </DialogHeader>
+            <form onSubmit={handleSubmit} className="space-y-4">
+              <div className="space-y-2">
+                <Label htmlFor="inv-batchName">{t("fieldBatchName")}</Label>
+                <Input
+                  id="inv-batchName"
+                  value={batchName}
+                  onChange={(e) => setBatchName(e.target.value)}
+                  placeholder={t("fieldBatchNamePlaceholder")}
+                  maxLength={100}
+                />
+                <p className="text-xs text-muted-foreground">
+                  {t("fieldBatchNameHint")}
+                </p>
+              </div>
+
+              <div className="grid grid-cols-2 gap-4">
+                <div className="space-y-2">
+                  <Label htmlFor="inv-count">{t("fieldCount")}</Label>
+                  <Input
+                    id="inv-count"
+                    type="number"
+                    min={1}
+                    max={100}
+                    value={count}
+                    onChange={(e) => setCount(e.target.value)}
+                    required
+                  />
+                  <p className="text-xs text-muted-foreground">
+                    {t("countHint")}
+                  </p>
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="inv-role">{t("fieldRole")}</Label>
+                  <Select
+                    id="inv-role"
+                    value={role}
+                    onValueChange={setRole}
+                    options={ROLE_OPTIONS.map((r) => ({
+                      value: r,
+                      label: t(`roles.${r}`),
+                    }))}
+                    aria-label={t("fieldRole")}
+                  />
+                </div>
+              </div>
+
+              <div className="space-y-2">
+                <Label htmlFor="inv-expireDays">{t("fieldExpireDays")}</Label>
+                <Select
+                  id="inv-expireDays"
+                  value={String(expireDays)}
+                  onValueChange={(v) => setExpireDays(Number(v))}
+                  options={EXPIRE_DAYS_OPTIONS.map((d) => ({
+                    value: String(d),
+                    label: t("expireDaysOption", { days: d }),
+                  }))}
+                  aria-label={t("fieldExpireDays")}
+                />
+              </div>
+
+              <div className="space-y-2">
+                <Label htmlFor="inv-purpose">{t("fieldPurpose")}</Label>
+                <Textarea
+                  id="inv-purpose"
+                  value={purpose}
+                  onChange={(e) => setPurpose(e.target.value)}
+                  placeholder={t("fieldPurposePlaceholder")}
+                  maxLength={500}
+                  rows={2}
+                />
+                <p className="text-xs text-muted-foreground">
+                  {t("fieldPurposeHint")}
+                </p>
+              </div>
+
+              <DialogFooter>
+                <Button
+                  type="button"
+                  variant="outline"
+                  onClick={handleClose}
+                  disabled={generateMutation.loading}
+                >
+                  {t("cancel")}
+                </Button>
+                <Button type="submit" disabled={generateMutation.loading}>
+                  {generateMutation.loading ? t("generating") : t("submit")}
+                </Button>
+              </DialogFooter>
+            </form>
+          </>
+        ) : (
+          <>
+            <DialogHeader>
+              <DialogTitle>{t("resultTitle")}</DialogTitle>
+              <DialogDescription>{t("resultDescription")}</DialogDescription>
+            </DialogHeader>
+            <div className="space-y-4">
+              {/* 成功/失败统计 */}
+              <div className="grid grid-cols-2 gap-3">
+                <div className="rounded-md border bg-emerald-500/5 p-3 text-center">
+                  <p className="text-xs text-muted-foreground">
+                    {t("statsSuccess")}
+                  </p>
+                  <p className="text-2xl font-semibold text-emerald-600 dark:text-emerald-400">
+                    {successCount}
+                  </p>
+                </div>
+                <div className="rounded-md border bg-destructive/5 p-3 text-center">
+                  <p className="text-xs text-muted-foreground">
+                    {t("statsFailed")}
+                  </p>
+                  <p className="text-2xl font-semibold text-destructive">
+                    {failedCount}
+                  </p>
+                </div>
+              </div>
+
+              {/* 明文邀请码列表 */}
+              <div className="max-h-48 space-y-2 overflow-y-auto rounded-md border p-2">
+                {result?.map((code, idx) => (
+                  <div
+                    key={idx}
+                    className="flex items-center justify-between rounded-md bg-muted/30 px-3 py-2"
+                  >
+                    <code className="font-mono text-sm">{code.code}</code>
+                    <Button
+                      type="button"
+                      variant="ghost"
+                      size="sm"
+                      onClick={() => {
+                        void navigator.clipboard.writeText(code.code);
+                        notify.success(t("copyCode"));
+                      }}
+                    >
+                      {t("copyCode")}
+                    </Button>
+                  </div>
+                ))}
+              </div>
+
+              <div className="flex flex-wrap justify-end gap-2">
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={() => void handleCopyAll()}
+                >
+                  {t("copyAll")}
+                </Button>
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={handleDownloadCsv}
+                >
+                  {t("downloadCsv")}
+                </Button>
+              </div>
+            </div>
+            <DialogFooter>
+              <Button type="button" onClick={handleClose}>
+                {t("done")}
+              </Button>
+            </DialogFooter>
+          </>
+        )}
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+/**
+ * 转义 CSV 字段（含逗号、引号、换行时用双引号包裹并转义内部引号）。
+ */
+function escapeCsvField(value: string): string {
+  if (/[",\n]/.test(value)) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
diff --git a/apps/portal-shell/src/features/admin/invitation-codes/invitation-codes-list-client.tsx b/apps/portal-shell/src/features/admin/invitation-codes/invitation-codes-list-client.tsx
index edd4743..f498fc2 100644
--- a/apps/portal-shell/src/features/admin/invitation-codes/invitation-codes-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/invitation-codes/invitation-codes-list-client.tsx
@@ -14,25 +14,35 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { Copy, KeyRound, RefreshCw } from "lucide-react";
+import { Copy, KeyRound } from "lucide-react";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useState, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
-  useCreateInvitationCode,
+  useDeleteInvitationCodes,
   useInvitationCodes,
   useRevokeInvitationCode,
   type InvitationCode,
 } from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
-import { Card, CardContent } from "@/shared/components/ui/card";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/components/ui/alert-dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterBar } from "@/shared/components/ui/filter-bar";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import { StatCard } from "@/shared/components/ui/stat-card";
 import { notify } from "@/shared/lib/notify";
 import {
   formatInvitationTimestamp,
@@ -43,16 +53,13 @@ import {
   isInvitationRevocable,
   roleToLabel,
 } from "@/features/admin/invitation-codes/transformations";
+import { GenerateInvitationCodesDialog } from "@/features/admin/invitation-codes/generate-invitation-codes-dialog";
 
 /** 状态筛选选项（与后端 status 字段对齐） */
 const STATUS_OPTIONS = ["active", "used", "expired", "revoked"] as const;
 
-/** 角色选项（与 IAM 角色对齐） */
-const ROLE_OPTIONS = ["admin", "teacher", "student", "parent"] as const;
-
-/** 默认生成参数 */
-const DEFAULT_MAX_USES = 10;
-const DEFAULT_TTL_HOURS = 72;
+/** 每页条数（客户端分页） */
+const PAGE_SIZE = 10;
 
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
@@ -66,16 +73,46 @@ export function InvitationCodesListClient(): React.ReactElement {
   const [, startTransition] = useTransition();
 
   const statusFilter = searchParams.get("status") ?? "";
+  const pageParam = searchParams.get("page") ?? "1";
+  const page = Math.max(1, Number.parseInt(pageParam, 10) || 1);
 
   // @contract-pending：MSW 兜底
-  const { data, loading, error } = useInvitationCodes(statusFilter || null);
-  const createInvitation = useCreateInvitationCode();
+  const { data, loading, error, refetch } = useInvitationCodes(
+    statusFilter || null,
+  );
   const revokeInvitation = useRevokeInvitationCode();
+  const deleteCodes = useDeleteInvitationCodes();
 
-  const [showGenerateForm, setShowGenerateForm] = useState(false);
+  const [showGenerateDialog, setShowGenerateDialog] = useState(false);
   const [pendingRevokeId, setPendingRevokeId] = useState<string | null>(null);
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+
+  // 服务端 page.tsx 注入 now（避免 client 端 Date.now() 导致 hydration mismatch）
+  // 见 ARCHITECTURE.md §11.3 DoD "纯函数不调用 Date.now()"
+  const now = Number(searchParams.get("now") ?? Date.now());
 
   const items = data ?? [];
+  const totalPages = Math.max(1, Math.ceil(items.length / PAGE_SIZE));
+  const currentPage = Math.min(page, totalPages);
+  const pagedItems = items.slice(
+    (currentPage - 1) * PAGE_SIZE,
+    currentPage * PAGE_SIZE,
+  );
+
+  // 统计：基于 effectiveStatus 前端聚合（无需新查询），依赖 now 判断过期
+  const stats = useMemo(() => {
+    let used = 0;
+    let unused = 0;
+    let expired = 0;
+    for (const item of items) {
+      const status = getEffectiveStatus(item, now);
+      if (status === "used") used += 1;
+      else if (status === "expired") expired += 1;
+      else if (status === "active") unused += 1;
+    }
+    return { total: items.length, used, unused, expired };
+  }, [items, now]);
 
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
@@ -84,6 +121,10 @@ export function InvitationCodesListClient(): React.ReactElement {
     } else {
       params.delete(key);
     }
+    // 切换筛选时重置页码
+    if (key === "status") {
+      params.delete("page");
+    }
     startTransition(() => {
       router.push(`/shell/admin/invitation-codes?${params.toString()}`);
     });
@@ -110,6 +151,38 @@ export function InvitationCodesListClient(): React.ReactElement {
     }
   };
 
+  const toggleSelect = (id: string): void => {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) {
+        next.delete(id);
+      } else {
+        next.add(id);
+      }
+      return next;
+    });
+  };
+
+  const toggleSelectAll = (): void => {
+    if (selectedIds.size === items.length) {
+      setSelectedIds(new Set());
+    } else {
+      setSelectedIds(new Set(items.map((i) => i.id)));
+    }
+  };
+
+  const handleDeleteSelected = async (): Promise<void> => {
+    try {
+      await deleteCodes.run(Array.from(selectedIds));
+      notify.success(t("deleteSuccess"));
+      setSelectedIds(new Set());
+      setDeleteDialogOpen(false);
+      void refetch();
+    } catch (e) {
+      notify.error(tCommon("error.loadFailed", { message: String(e) }));
+    }
+  };
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -137,14 +210,26 @@ export function InvitationCodesListClient(): React.ReactElement {
       description={t("description")}
       icon={<KeyRound className="size-6" />}
       actions={
-        <Button
-          onClick={() => setShowGenerateForm((v) => !v)}
-          variant="default"
-          size="sm"
-        >
-          <KeyRound className="size-4" />
-          {t("generateButton")}
-        </Button>
+        <>
+          <Button
+            onClick={() => setShowGenerateDialog(true)}
+            variant="default"
+            size="sm"
+          >
+            <KeyRound className="size-4" />
+            {t("generateButton")}
+          </Button>
+          {selectedIds.size > 0 ? (
+            <Button
+              onClick={() => setDeleteDialogOpen(true)}
+              variant="destructive"
+              size="sm"
+              disabled={deleteCodes.loading}
+            >
+              {t("deleteSelected", { count: selectedIds.size })}
+            </Button>
+          ) : null}
+        </>
       }
       filters={
         <FilterBar variant="wrap">
@@ -169,142 +254,97 @@ export function InvitationCodesListClient(): React.ReactElement {
       emptyNode={emptyNode}
       errorNode={errorNode}
       pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: items.length })}</span>
-        </div>
+        <PaginationBar
+          total={items.length}
+          page={currentPage}
+          pageSize={PAGE_SIZE}
+          onNavigate={(p) => updateQuery("page", String(p))}
+        />
       }
     >
-      <div className="flex flex-col gap-4">
-        {showGenerateForm ? (
-          <GenerateForm
-            loading={createInvitation.loading}
-            onSubmit={async (role, maxUses, ttlHours) => {
-              try {
-                await createInvitation.run({ role, maxUses, ttlHours });
-                notify.success(t("generateButton"));
-                setShowGenerateForm(false);
-              } catch (e) {
-                notify.error(
-                  tCommon("error.loadFailed", { message: String(e) }),
-                );
-              }
-            }}
-            onCancel={() => setShowGenerateForm(false)}
-          />
-        ) : null}
-        <InvitationCodesTable
-          items={items}
-          pendingRevokeId={pendingRevokeId}
-          onCopy={handleCopy}
-          onRevoke={handleRevoke}
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+        <StatCard
+          title={t("statsTotal")}
+          value={stats.total}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsUsed")}
+          value={stats.used}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsUnused")}
+          value={stats.unused}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsExpired")}
+          value={stats.expired}
+          isLoading={loading}
         />
       </div>
+      <div className="flex flex-col gap-4">
+        <InvitationCodesTable
+          items={pagedItems}
+          pendingRevokeId={pendingRevokeId}
+          selectedIds={selectedIds}
+          onToggleSelect={toggleSelect}
+          onToggleSelectAll={toggleSelectAll}
+          onCopy={handleCopy}
+          onRevoke={handleRevoke}
+          now={now}
+        />
+      </div>
+      <GenerateInvitationCodesDialog
+        open={showGenerateDialog}
+        onClose={() => setShowGenerateDialog(false)}
+        onGenerated={() => void refetch()}
+      />
+      <AlertDialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>{t("deleteConfirmTitle")}</AlertDialogTitle>
+            <AlertDialogDescription>
+              {t("deleteConfirmDesc", { count: selectedIds.size })}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>{tCommon("cancel")}</AlertDialogCancel>
+            <AlertDialogAction
+              onClick={() => void handleDeleteSelected()}
+              disabled={deleteCodes.loading}
+            >
+              {t("confirmDelete")}
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
     </ListPageShell>
   );
 }
 
-/**
- * 生成邀请码表单（内联展开，对齐 §7.3 列表页 + 行内操作）。
- */
-function GenerateForm({
-  loading,
-  onSubmit,
-  onCancel,
-}: {
-  loading: boolean;
-  onSubmit: (role: string, maxUses: number, ttlHours: number) => Promise<void>;
-  onCancel: () => void;
-}): React.ReactElement {
-  const tForm = useTranslations("admin.invitationCodes.generateForm");
-  const [role, setRole] = useState<string>("teacher");
-  const [maxUses, setMaxUses] = useState<number>(DEFAULT_MAX_USES);
-  const [ttlHours, setTtlHours] = useState<number>(DEFAULT_TTL_HOURS);
-
-  const handleSubmit = (e: React.FormEvent<HTMLFormElement>): void => {
-    e.preventDefault();
-    void onSubmit(role, maxUses, ttlHours);
-  };
-
-  return (
-    <Card>
-      <CardContent className="p-4">
-        <h3 className="mb-3 text-sm font-semibold">{tForm("title")}</h3>
-        <form
-          onSubmit={handleSubmit}
-          className="flex flex-wrap items-end gap-3"
-        >
-          <label className="flex flex-col gap-1 text-xs">
-            <span className="text-muted-foreground">{tForm("fieldRole")}</span>
-            <select
-              value={role}
-              onChange={(e) => setRole(e.target.value)}
-              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
-            >
-              {ROLE_OPTIONS.map((r) => (
-                <option key={r} value={r}>
-                  {roleToLabel(r)}
-                </option>
-              ))}
-            </select>
-          </label>
-          <label className="flex flex-col gap-1 text-xs">
-            <span className="text-muted-foreground">
-              {tForm("fieldMaxUses")}
-            </span>
-            <input
-              type="number"
-              min={1}
-              value={maxUses}
-              onChange={(e) => setMaxUses(Number(e.target.value) || 1)}
-              className="h-9 w-24 rounded-md border border-input bg-background px-3 text-sm"
-            />
-          </label>
-          <label className="flex flex-col gap-1 text-xs">
-            <span className="text-muted-foreground">
-              {tForm("fieldTtlHours")}
-            </span>
-            <input
-              type="number"
-              min={1}
-              value={ttlHours}
-              onChange={(e) => setTtlHours(Number(e.target.value) || 1)}
-              className="h-9 w-24 rounded-md border border-input bg-background px-3 text-sm"
-            />
-          </label>
-          <div className="flex gap-2">
-            <Button type="submit" size="sm" disabled={loading}>
-              <RefreshCw className="size-4" />
-              {tForm("submit")}
-            </Button>
-            <Button
-              type="button"
-              variant="outline"
-              size="sm"
-              onClick={onCancel}
-              disabled={loading}
-            >
-              {tForm("cancel")}
-            </Button>
-          </div>
-        </form>
-      </CardContent>
-    </Card>
-  );
-}
-
 /**
  * 邀请码列表表格（纯展示组件，对齐 §8.2 排版规范）。
  */
 function InvitationCodesTable({
   items,
   pendingRevokeId,
+  selectedIds,
+  onToggleSelect,
+  onToggleSelectAll,
   onCopy,
   onRevoke,
+  now,
 }: {
   items: InvitationCode[];
   pendingRevokeId: string | null;
+  selectedIds: Set<string>;
+  onToggleSelect: (id: string) => void;
+  onToggleSelectAll: () => void;
   onCopy: (code: string) => void;
   onRevoke: (id: string) => void;
+  now: number;
 }): React.ReactElement {
   const t = useTranslations("admin.invitationCodes.list");
   return (
@@ -312,6 +352,15 @@ function InvitationCodesTable({
       <table className="w-full text-sm">
         <thead className="border-b bg-muted/30">
           <tr>
+            <th className="p-3 text-left">
+              <input
+                type="checkbox"
+                checked={items.length > 0 && selectedIds.size === items.length}
+                onChange={onToggleSelectAll}
+                aria-label="select all"
+                className="size-4 rounded border-input"
+              />
+            </th>
             <th className="p-3 text-left font-medium">{t("colCode")}</th>
             <th className="p-3 text-left font-medium">{t("colRole")}</th>
             <th className="p-3 text-left font-medium">{t("colStatus")}</th>
@@ -324,10 +373,19 @@ function InvitationCodesTable({
         </thead>
         <tbody className="divide-y">
           {items.map((item) => {
-            const effectiveStatus = getEffectiveStatus(item);
-            const canRevoke = isInvitationRevocable(item);
+            const effectiveStatus = getEffectiveStatus(item, now);
+            const canRevoke = isInvitationRevocable(item, now);
             return (
               <tr key={item.id} className="hover:bg-muted/30">
+                <td className="p-3">
+                  <input
+                    type="checkbox"
+                    checked={selectedIds.has(item.id)}
+                    onChange={() => onToggleSelect(item.id)}
+                    aria-label="select"
+                    className="size-4 rounded border-input"
+                  />
+                </td>
                 <td className="p-3 font-mono text-xs">{item.code}</td>
                 <td className="p-3 text-muted-foreground">
                   {roleToLabel(item.role)}
@@ -391,3 +449,92 @@ function StatusBadge({ status }: { status: string }): React.ReactElement {
     </span>
   );
 }
+
+/**
+ * 分页条（页码按钮 + 上一页/下一页 + 总数）。
+ * 总页数 > 7 时使用窗口策略（首末页 + 当前页 ±1 + 省略号）。
+ */
+function PaginationBar({
+  total,
+  page,
+  pageSize,
+  onNavigate,
+}: {
+  total: number;
+  page: number;
+  pageSize: number;
+  onNavigate: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.invitationCodes.list");
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const currentPage = Math.min(Math.max(1, page), totalPages);
+
+  const pages: Array<number | "ellipsis"> = (() => {
+    if (totalPages <= 7) {
+      return Array.from({ length: totalPages }, (_, i) => i + 1);
+    }
+    const result: Array<number | "ellipsis"> = [1];
+    const start = Math.max(2, currentPage - 1);
+    const end = Math.min(totalPages - 1, currentPage + 1);
+    if (start > 2) result.push("ellipsis");
+    for (let i = start; i <= end; i++) result.push(i);
+    if (end < totalPages - 1) result.push("ellipsis");
+    result.push(totalPages);
+    return result;
+  })();
+
+  if (total === 0) {
+    return (
+      <div className="flex items-center justify-end text-sm text-muted-foreground">
+        <span>{t("total", { count: 0 })}</span>
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex items-center justify-between gap-2 text-sm text-muted-foreground">
+      <span>{t("total", { count: total })}</span>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          disabled={currentPage <= 1}
+          onClick={() => onNavigate(currentPage - 1)}
+        >
+          {tCommon("prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "ellipsis" ? (
+            <span
+              key={`ellipsis-${idx}`}
+              className="px-2 text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === currentPage ? "default" : "outline"}
+              size="sm"
+              disabled={p === currentPage}
+              onClick={() => onNavigate(p)}
+              aria-current={p === currentPage ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          disabled={currentPage >= totalPages}
+          onClick={() => onNavigate(currentPage + 1)}
+        >
+          {tCommon("next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/invitation-codes/transformations.ts b/apps/portal-shell/src/features/admin/invitation-codes/transformations.ts
index f2bf9e6..331f9ae 100644
--- a/apps/portal-shell/src/features/admin/invitation-codes/transformations.ts
+++ b/apps/portal-shell/src/features/admin/invitation-codes/transformations.ts
@@ -92,22 +92,36 @@ export function invitationStatusToBadgeClass(status: string): string {
 /**
  * 判断邀请码是否已过期（基于 expiresAt 与当前时间比较）。
  * 已撤销或已用完的码不算过期。
+ *
+ * @param code 邀请码对象
+ * @param now  当前时间戳（ms），由调用方注入以避免纯函数内调用 Date.now()，
+ *             避免 SSR/CSR 时间漂移导致 hydration mismatch。
+ *             默认值 Date.now() 仅为兼容旧调用方，新代码应显式注入。
  */
-export function isInvitationExpired(code: InvitationCode): boolean {
+export function isInvitationExpired(
+  code: InvitationCode,
+  now: number = Date.now(),
+): boolean {
   if (code.status === "expired") return true;
   if (code.status === "used" || code.status === "revoked") return false;
   if (!code.expiresAt) return false;
   const d = new Date(code.expiresAt);
   if (Number.isNaN(d.getTime())) return false;
-  return d.getTime() < Date.now();
+  return d.getTime() < now;
 }
 
 /**
  * 获取邀请码的有效显示状态。
  * 优先返回数据库 status，若数据库为 active 但已过期则返回 "expired"。
+ *
+ * @param code 邀请码对象
+ * @param now  当前时间戳（ms），由调用方注入（推荐从 server page.tsx 传入避免 client Date.now）
  */
-export function getEffectiveStatus(code: InvitationCode): string {
-  if (code.status === "active" && isInvitationExpired(code)) {
+export function getEffectiveStatus(
+  code: InvitationCode,
+  now: number = Date.now(),
+): string {
+  if (code.status === "active" && isInvitationExpired(code, now)) {
     return "expired";
   }
   return code.status;
@@ -135,9 +149,15 @@ export function isInvitationUsedUp(code: InvitationCode): boolean {
 
 /**
  * 判断邀请码是否可撤销（仅 active 状态可撤销）。
+ *
+ * @param code 邀请码对象
+ * @param now  当前时间戳（ms），由调用方注入（推荐从 server page.tsx 传入避免 client Date.now）
  */
-export function isInvitationRevocable(code: InvitationCode): boolean {
-  return getEffectiveStatus(code) === "active";
+export function isInvitationRevocable(
+  code: InvitationCode,
+  now: number = Date.now(),
+): boolean {
+  return getEffectiveStatus(code, now) === "active";
 }
 
 // ============================================================
diff --git a/apps/portal-shell/src/features/admin/lesson-plans/__tests__/transformations.test.ts b/apps/portal-shell/src/features/admin/lesson-plans/__tests__/transformations.test.ts
index 340391f..6c8a7b5 100644
--- a/apps/portal-shell/src/features/admin/lesson-plans/__tests__/transformations.test.ts
+++ b/apps/portal-shell/src/features/admin/lesson-plans/__tests__/transformations.test.ts
@@ -5,130 +5,35 @@
  */
 import { describe, expect, it } from "vitest";
 
-import {
-  LESSON_PLAN_STATUS_LABEL,
-  formatLessonPlanDate,
-  formatLessonPlanStatus,
-  isLessonPlanArchived,
-  isLessonPlanEditable,
-  isLessonPlanPublished,
-  lessonPlanStatusToBadgeClass,
-  toAdminLessonPlanListItem,
-} from "../transformations";
+import { formatCount } from "../transformations";
 
-describe("formatLessonPlanStatus", () => {
-  it("maps known statuses to Chinese labels", () => {
-    expect(formatLessonPlanStatus("DRAFT")).toBe("草稿");
-    expect(formatLessonPlanStatus("PUBLISHED")).toBe("已发布");
-    expect(formatLessonPlanStatus("ARCHIVED")).toBe("已归档");
-    expect(formatLessonPlanStatus("SUBMITTED")).toBe("已提交");
+describe("formatCount", () => {
+  it("returns string representation for non-negative finite numbers", () => {
+    expect(formatCount(0)).toBe("0");
+    expect(formatCount(1)).toBe("1");
+    expect(formatCount(42)).toBe("42");
+    expect(formatCount(1000)).toBe("1000");
   });
 
-  it("returns original value for unknown status", () => {
-    expect(formatLessonPlanStatus("UNKNOWN")).toBe("UNKNOWN");
-    expect(formatLessonPlanStatus("")).toBe("");
+  it("returns '0' for null", () => {
+    expect(formatCount(null)).toBe("0");
   });
 
-  it("LESSON_PLAN_STATUS_LABEL covers 4 standard statuses", () => {
-    expect(Object.keys(LESSON_PLAN_STATUS_LABEL)).toHaveLength(4);
-  });
-});
-
-describe("formatLessonPlanDate", () => {
-  it("formats valid ISO date string", () => {
-    const result = formatLessonPlanDate("2026-07-22T10:30:00Z");
-    expect(result).toContain("2026");
-    expect(result).toContain("07");
-  });
-
-  it("returns placeholder for null/undefined/empty", () => {
-    expect(formatLessonPlanDate(null)).toBe("--");
-    expect(formatLessonPlanDate(undefined)).toBe("--");
-    expect(formatLessonPlanDate("")).toBe("--");
-  });
-
-  it("returns placeholder for invalid date", () => {
-    expect(formatLessonPlanDate("not-a-date")).toBe("--");
-  });
-});
-
-describe("isLessonPlanEditable", () => {
-  it("returns true for DRAFT and PUBLISHED", () => {
-    expect(isLessonPlanEditable("DRAFT")).toBe(true);
-    expect(isLessonPlanEditable("PUBLISHED")).toBe(true);
-  });
-
-  it("returns false for ARCHIVED and unknown", () => {
-    expect(isLessonPlanEditable("ARCHIVED")).toBe(false);
-    expect(isLessonPlanEditable("UNKNOWN")).toBe(false);
-  });
-});
-
-describe("isLessonPlanPublished", () => {
-  it("returns true only for PUBLISHED", () => {
-    expect(isLessonPlanPublished("PUBLISHED")).toBe(true);
-    expect(isLessonPlanPublished("DRAFT")).toBe(false);
-    expect(isLessonPlanPublished("ARCHIVED")).toBe(false);
-  });
-});
-
-describe("isLessonPlanArchived", () => {
-  it("returns true only for ARCHIVED", () => {
-    expect(isLessonPlanArchived("ARCHIVED")).toBe(true);
-    expect(isLessonPlanArchived("PUBLISHED")).toBe(false);
-    expect(isLessonPlanArchived("DRAFT")).toBe(false);
-  });
-});
-
-describe("toAdminLessonPlanListItem", () => {
-  it("extracts list fields from full detail and drops extra fields", () => {
-    const detail = {
-      id: "lp-001",
-      title: "集合的概念",
-      subjectId: "sub-math",
-      subjectName: "数学",
-      teacherId: "usr-001",
-      teacherName: "张老师",
-      classId: "cls-001",
-      className: "高三(1)班",
-      status: "PUBLISHED",
-      createdAt: "2026-07-10T00:00:00Z",
-      updatedAt: "2026-07-15T00:00:00Z",
-    };
-
-    const item = toAdminLessonPlanListItem(detail);
-    expect(item.id).toBe("lp-001");
-    expect(item.title).toBe("集合的概念");
-    expect(item.subjectName).toBe("数学");
-    expect(item.teacherName).toBe("张老师");
-    expect(item.className).toBe("高三(1)班");
-    expect(item.status).toBe("PUBLISHED");
-    expect(item).not.toHaveProperty("textbookId");
-    expect(item).not.toHaveProperty("content");
-  });
-});
-
-describe("lessonPlanStatusToBadgeClass", () => {
-  it("returns primary class for PUBLISHED", () => {
-    expect(lessonPlanStatusToBadgeClass("PUBLISHED")).toContain("primary");
-  });
-
-  it("returns amber class for SUBMITTED", () => {
-    expect(lessonPlanStatusToBadgeClass("SUBMITTED")).toContain("amber");
-  });
-
-  it("returns muted class for DRAFT and ARCHIVED", () => {
-    expect(lessonPlanStatusToBadgeClass("DRAFT")).toBe(
-      "bg-muted text-muted-foreground",
-    );
-    expect(lessonPlanStatusToBadgeClass("ARCHIVED")).toBe(
-      "bg-muted text-muted-foreground",
-    );
-  });
-
-  it("returns muted class for unknown status", () => {
-    expect(lessonPlanStatusToBadgeClass("UNKNOWN")).toBe(
-      "bg-muted text-muted-foreground",
-    );
+  it("returns '0' for undefined", () => {
+    expect(formatCount(undefined)).toBe("0");
+  });
+
+  it("returns '0' for NaN", () => {
+    expect(formatCount(Number.NaN)).toBe("0");
+  });
+
+  it("returns '0' for Infinity", () => {
+    expect(formatCount(Number.POSITIVE_INFINITY)).toBe("0");
+    expect(formatCount(Number.NEGATIVE_INFINITY)).toBe("0");
+  });
+
+  it("returns '0' for negative numbers", () => {
+    expect(formatCount(-1)).toBe("0");
+    expect(formatCount(-100)).toBe("0");
   });
 });
diff --git a/apps/portal-shell/src/features/admin/lesson-plans/delete-confirm-dialog.tsx b/apps/portal-shell/src/features/admin/lesson-plans/delete-confirm-dialog.tsx
new file mode 100644
index 0000000..f0d2700
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/lesson-plans/delete-confirm-dialog.tsx
@@ -0,0 +1,106 @@
+"use client";
+
+/**
+ * 教案软删除确认对话框（轻量自实现模态，ARCHITECTURE.md §7.3 / §9.4）
+ *
+ * 用于 admin/lesson-plans 列表页与详情页的删除确认。
+ * 结构：fixed inset-0 + bg-black/50 + 居中卡片。
+ * 交互：ESC 关闭、点击遮罩关闭、确认按钮 destructive 变体。
+ *
+ * 关联：ARCHITECTURE.md §7.3 详情/列表页 / §9.4 / §11.3
+ */
+import { AlertTriangle, Loader2 } from "lucide-react";
+import { useTranslations } from "next-intl";
+import { useEffect } from "react";
+
+import { Button } from "@/shared/components/ui/button";
+
+export interface DeleteConfirmDialogProps {
+  /** 是否打开 */
+  open: boolean;
+  /** 确认删除回调 */
+  onConfirm: () => void;
+  /** 取消回调（点击遮罩 / ESC / 取消按钮） */
+  onCancel: () => void;
+  /** 删除进行中（禁用按钮、隐藏 spinner） */
+  loading?: boolean;
+}
+
+/**
+ * 教案软删除确认对话框。
+ *
+ * 文案来自 admin.lessonPlans.delete.* 命名空间。
+ */
+export function DeleteConfirmDialog({
+  open,
+  onConfirm,
+  onCancel,
+  loading = false,
+}: DeleteConfirmDialogProps): React.ReactElement | null {
+  const t = useTranslations("admin.lessonPlans.delete");
+
+  useEffect(() => {
+    if (!open) return;
+    const handler = (e: KeyboardEvent): void => {
+      if (e.key === "Escape" && !loading) {
+        onCancel();
+      }
+    };
+    window.addEventListener("keydown", handler);
+    return () => window.removeEventListener("keydown", handler);
+  }, [open, loading, onCancel]);
+
+  if (!open) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={loading ? undefined : onCancel}
+      role="dialog"
+      aria-modal="true"
+      aria-label={t("title")}
+    >
+      <div
+        className="w-full max-w-md rounded-xl border bg-card p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="flex items-start gap-3">
+          <span className="flex size-10 shrink-0 items-center justify-center rounded-full bg-destructive/10 text-destructive">
+            <AlertTriangle className="size-5" />
+          </span>
+          <div className="flex-1">
+            <h2 className="text-lg font-semibold">{t("title")}</h2>
+            <p className="mt-1 text-sm text-muted-foreground">
+              {t("description")}
+            </p>
+          </div>
+        </div>
+        <div className="mt-6 flex justify-end gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={onCancel}
+            disabled={loading}
+          >
+            {t("cancel")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            onClick={onConfirm}
+            disabled={loading}
+          >
+            {loading ? (
+              <>
+                <Loader2 className="size-4 animate-spin" />
+                {t("confirm")}
+              </>
+            ) : (
+              t("confirm")
+            )}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/lesson-plans/lesson-plan-view-client.tsx b/apps/portal-shell/src/features/admin/lesson-plans/lesson-plan-view-client.tsx
index ae06b03..0345fe3 100644
--- a/apps/portal-shell/src/features/admin/lesson-plans/lesson-plan-view-client.tsx
+++ b/apps/portal-shell/src/features/admin/lesson-plans/lesson-plan-view-client.tsx
@@ -13,21 +13,25 @@
  *
  * 关联：ARCHITECTURE.md §5.5 / §7.3 / §9.4 / §10 P5 / §11.3
  */
-import { BookOpen } from "lucide-react";
-import { useParams } from "next/navigation";
+import { BookOpen, Trash2 } from "lucide-react";
+import Link from "next/link";
+import { useParams, useRouter } from "next/navigation";
 import { useTranslations } from "next-intl";
-import { useEffect } from "react";
+import { useEffect, useState } from "react";
 
 import {
   useAdminLessonPlan,
+  useSoftDeleteLessonPlan,
   type AdminLessonPlan as AdminLessonPlanData,
 } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
 import {
   DetailPageShell,
   DetailPageSkeleton,
   DetailSection,
   DetailField,
 } from "@/shared/components/page-templates";
+import { DeleteConfirmDialog } from "@/features/admin/lesson-plans/delete-confirm-dialog";
 import { notify } from "@/shared/lib/notify";
 import {
   formatLessonPlanDate,
@@ -41,18 +45,47 @@ import {
 export function AdminLessonPlanViewClient(): React.ReactElement {
   const t = useTranslations("admin.lessonPlans.detail");
   const tCommon = useTranslations("common");
+  const tDelete = useTranslations("admin.lessonPlans.delete");
+  const router = useRouter();
   const params = useParams<{ planId: string }>();
   const planId = params?.planId ?? "";
 
   // @contract-pending：MSW 兜底
   const { data, loading, error } = useAdminLessonPlan(planId);
 
+  // 软删除 mutation（@contract-pending，MSW 兜底）
+  const { run: runSoftDelete, loading: deleteLoading } =
+    useSoftDeleteLessonPlan();
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+
   useEffect(() => {
     if (error) {
       notify.error(tCommon("error.loadFailed", { message: String(error) }));
     }
   }, [error, tCommon]);
 
+  const handleDeleteClick = (): void => {
+    setDeleteDialogOpen(true);
+  };
+
+  const handleDeleteConfirm = async (): Promise<void> => {
+    if (!planId) return;
+    try {
+      await runSoftDelete(planId);
+      notify.success(tDelete("success"));
+      setDeleteDialogOpen(false);
+      // 删除成功后返回列表页
+      router.push("/shell/admin/lesson-plans");
+    } catch {
+      notify.error(tDelete("error"));
+    }
+  };
+
+  const handleDeleteCancel = (): void => {
+    if (deleteLoading) return;
+    setDeleteDialogOpen(false);
+  };
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -68,18 +101,47 @@ export function AdminLessonPlanViewClient(): React.ReactElement {
       </div>
     ) : undefined;
 
+  const isArchived = data?.status === "ARCHIVED";
+
+  const actions = (
+    <div className="flex items-center gap-2">
+      <Button asChild variant="outline">
+        <Link href="/shell/admin/lesson-plans">{t("backToList")}</Link>
+      </Button>
+      <Button
+        type="button"
+        variant="destructive"
+        onClick={handleDeleteClick}
+        disabled={isArchived || deleteLoading || loading || !data}
+        aria-label={tDelete("button")}
+      >
+        <Trash2 className="size-4" />
+        {tDelete("button")}
+      </Button>
+    </div>
+  );
+
   return (
-    <DetailPageShell
-      title={data?.title ?? t("title")}
-      icon={<BookOpen className="size-6" />}
-      backHref="/shell/admin/lesson-plans"
-      loading={loading}
-      loadingNode={<DetailPageSkeleton />}
-      errorNode={errorNode}
-      emptyNode={emptyNode}
-    >
-      {data ? <AdminLessonPlanViewBody plan={data} /> : null}
-    </DetailPageShell>
+    <>
+      <DetailPageShell
+        title={data?.title ?? t("title")}
+        icon={<BookOpen className="size-6" />}
+        backHref="/shell/admin/lesson-plans"
+        actions={actions}
+        loading={loading}
+        loadingNode={<DetailPageSkeleton />}
+        errorNode={errorNode}
+        emptyNode={emptyNode}
+      >
+        {data ? <AdminLessonPlanViewBody plan={data} /> : null}
+      </DetailPageShell>
+      <DeleteConfirmDialog
+        open={deleteDialogOpen}
+        onConfirm={handleDeleteConfirm}
+        onCancel={handleDeleteCancel}
+        loading={deleteLoading}
+      />
+    </>
   );
 }
 
diff --git a/apps/portal-shell/src/features/admin/lesson-plans/lesson-plans-list-client.tsx b/apps/portal-shell/src/features/admin/lesson-plans/lesson-plans-list-client.tsx
index 1c7a6e4..5722f98 100644
--- a/apps/portal-shell/src/features/admin/lesson-plans/lesson-plans-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/lesson-plans/lesson-plans-list-client.tsx
@@ -13,21 +13,29 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { BookOpen } from "lucide-react";
+import { Archive, BookOpen, CheckCircle, FileEdit, Trash2 } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useAdminLessonPlans, type AdminLessonPlanListItem } from "@/lib/api";
+import {
+  useAdminLessonPlans,
+  useSoftDeleteLessonPlan,
+  type AdminLessonPlanListItem,
+} from "@/lib/api";
 import { Button } from "@/shared/components/ui/button";
+import { DeleteConfirmDialog } from "@/features/admin/lesson-plans/delete-confirm-dialog";
+import { notify } from "@/shared/lib/notify";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
+import { StatCard } from "@/shared/components/ui/stat-card";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
 import {
+  formatCount,
   formatLessonPlanDate,
   formatLessonPlanStatus,
   lessonPlanStatusToBadgeClass,
@@ -37,6 +45,11 @@ import {
 const STATUS_OPTIONS = ["DRAFT", "PUBLISHED", "ARCHIVED", "SUBMITTED"] as const;
 type StatusOption = (typeof STATUS_OPTIONS)[number];
 
+/** 每页条数 */
+const PAGE_SIZE = 10;
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
+
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
  * （useSearchParams 要求 Suspense 边界，Next.js 15 强制）。
@@ -53,10 +66,18 @@ export function AdminLessonPlansListClient(): React.ReactElement {
     ? (statusParam as StatusOption)
     : "";
   const q = searchParams.get("q") ?? "";
+  const page = Number(searchParams.get("page") ?? "1") || 1;
 
   // @contract-pending：MSW 兜底
   const { data, loading, error } = useAdminLessonPlans();
 
+  // 软删除 mutation（@contract-pending，MSW 兜底）
+  const { run: runSoftDelete, loading: deleteLoading } =
+    useSoftDeleteLessonPlan();
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [pendingDeleteId, setPendingDeleteId] = useState<string | null>(null);
+  const tDelete = useTranslations("admin.lessonPlans.delete");
+
   // 客户端二次筛选（status + q）—— 后端补齐列表查询后改服务端筛选
   const filteredItems = useMemo<AdminLessonPlanListItem[]>(() => {
     const items = data?.items ?? [];
@@ -71,6 +92,39 @@ export function AdminLessonPlansListClient(): React.ReactElement {
     });
   }, [data, status, q]);
 
+  const total = filteredItems.length;
+  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+  const safePage = Math.min(Math.max(1, page), totalPages);
+  const pagedItems = useMemo<AdminLessonPlanListItem[]>(() => {
+    const start = (safePage - 1) * PAGE_SIZE;
+    return filteredItems.slice(start, start + PAGE_SIZE);
+  }, [filteredItems, safePage]);
+
+  const handleDeleteClick = (planId: string): void => {
+    setPendingDeleteId(planId);
+    setDeleteDialogOpen(true);
+  };
+
+  const handleDeleteConfirm = async (): Promise<void> => {
+    if (!pendingDeleteId) return;
+    try {
+      await runSoftDelete(pendingDeleteId);
+      notify.success(tDelete("success"));
+      setDeleteDialogOpen(false);
+      setPendingDeleteId(null);
+      // 刷新列表（MSW 已就地修改 mock 数据，重新拉取即可反映状态变化）
+      router.refresh();
+    } catch {
+      notify.error(tDelete("error"));
+    }
+  };
+
+  const handleDeleteCancel = (): void => {
+    if (deleteLoading) return;
+    setDeleteDialogOpen(false);
+    setPendingDeleteId(null);
+  };
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -78,8 +132,8 @@ export function AdminLessonPlansListClient(): React.ReactElement {
     } else {
       params.delete(key);
     }
-    // 切换筛选时重置页码（暂无分页，保留兼容入口）
-    if (key === "status") {
+    // 切换筛选时重置页码
+    if (key !== "page") {
       params.delete("page");
     }
     startTransition(() => {
@@ -109,49 +163,121 @@ export function AdminLessonPlansListClient(): React.ReactElement {
   );
 
   return (
-    <ListPageShell
-      title={t("title")}
-      description={t("description")}
-      icon={<BookOpen className="size-6" />}
-      actions={
-        <Button asChild>
-          <Link href="/shell/admin/lesson-plans">{t("createButton")}</Link>
-        </Button>
-      }
-      filters={
-        <>
-          <FilterSearchInput
-            placeholder={t("searchPlaceholder")}
-            value={q}
-            onChange={(v) => updateQuery("q", v)}
+    <>
+      <ListPageShell
+        title={t("title")}
+        description={t("description")}
+        icon={<BookOpen className="size-6" />}
+        actions={
+          <Button asChild>
+            <Link href="/shell/admin/lesson-plans">{t("createButton")}</Link>
+          </Button>
+        }
+        filters={
+          <>
+            <FilterSearchInput
+              placeholder={t("searchPlaceholder")}
+              value={q}
+              onChange={(v) => updateQuery("q", v)}
+            />
+            <select
+              value={status}
+              onChange={(e) => updateQuery("status", e.target.value)}
+              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+              aria-label={t("statusFilter")}
+            >
+              <option value="">{t("allStatuses")}</option>
+              <option value="DRAFT">{t("statusDraft")}</option>
+              <option value="PUBLISHED">{t("statusPublished")}</option>
+              <option value="ARCHIVED">{t("statusArchived")}</option>
+              <option value="SUBMITTED">{t("statusSubmitted")}</option>
+            </select>
+          </>
+        }
+        loading={loading}
+        loadingNode={<ListPageSkeleton rows={5} />}
+        empty={filteredItems.length === 0 && !loading}
+        emptyNode={emptyNode}
+        errorNode={errorNode}
+        pagination={
+          <Pagination
+            page={safePage}
+            pageSize={PAGE_SIZE}
+            total={total}
+            onJump={(p) => updateQuery("page", String(p))}
+          />
+        }
+      >
+        <div className="flex flex-col gap-6">
+          <LessonPlansStatsCards items={filteredItems} loading={loading} />
+          <AdminLessonPlansTable
+            items={pagedItems}
+            onDelete={handleDeleteClick}
           />
-          <select
-            value={status}
-            onChange={(e) => updateQuery("status", e.target.value)}
-            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
-            aria-label={t("statusFilter")}
-          >
-            <option value="">{t("allStatuses")}</option>
-            <option value="DRAFT">{t("statusDraft")}</option>
-            <option value="PUBLISHED">{t("statusPublished")}</option>
-            <option value="ARCHIVED">{t("statusArchived")}</option>
-            <option value="SUBMITTED">{t("statusSubmitted")}</option>
-          </select>
-        </>
-      }
-      loading={loading}
-      loadingNode={<ListPageSkeleton rows={5} />}
-      empty={filteredItems.length === 0 && !loading}
-      emptyNode={emptyNode}
-      errorNode={errorNode}
-      pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>{t("total", { count: filteredItems.length })}</span>
         </div>
-      }
-    >
-      <AdminLessonPlansTable items={filteredItems} />
-    </ListPageShell>
+      </ListPageShell>
+      <DeleteConfirmDialog
+        open={deleteDialogOpen}
+        onConfirm={handleDeleteConfirm}
+        onCancel={handleDeleteCancel}
+        loading={deleteLoading}
+      />
+    </>
+  );
+}
+
+/**
+ * 教案统计概览卡片组（总数 / 已发布 / 草稿 / 已归档）。
+ *
+ * 对齐 CICD admin/lesson-plans/page.tsx 的"4 卡"契约。
+ * 三态：loading 时 StatCard isLoading=true 显示骨架。
+ */
+function LessonPlansStatsCards({
+  items,
+  loading,
+}: {
+  items: AdminLessonPlanListItem[];
+  loading: boolean;
+}): React.ReactElement {
+  const t = useTranslations("admin.lessonPlans.list");
+
+  const total = items.length;
+  const published = items.filter((i) => i.status === "PUBLISHED").length;
+  const draft = items.filter((i) => i.status === "DRAFT").length;
+  const archived = items.filter((i) => i.status === "ARCHIVED").length;
+
+  return (
+    <section aria-label={t("statsTitle")}>
+      <h3 className="mb-3 text-sm font-medium text-muted-foreground">
+        {t("statsTitle")}
+      </h3>
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+        <StatCard
+          title={t("statsTotal")}
+          value={formatCount(total)}
+          icon={BookOpen}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsPublished")}
+          value={formatCount(published)}
+          icon={CheckCircle}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsDraft")}
+          value={formatCount(draft)}
+          icon={FileEdit}
+          isLoading={loading}
+        />
+        <StatCard
+          title={t("statsArchived")}
+          value={formatCount(archived)}
+          icon={Archive}
+          isLoading={loading}
+        />
+      </div>
+    </section>
   );
 }
 
@@ -160,10 +286,13 @@ export function AdminLessonPlansListClient(): React.ReactElement {
  */
 function AdminLessonPlansTable({
   items,
+  onDelete,
 }: {
   items: AdminLessonPlanListItem[];
+  onDelete: (planId: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.lessonPlans.list");
+  const tDelete = useTranslations("admin.lessonPlans.delete");
   return (
     <div className="overflow-x-auto rounded-xl border">
       <table className="w-full text-sm">
@@ -201,12 +330,25 @@ function AdminLessonPlansTable({
                 {formatLessonPlanDate(plan.updatedAt)}
               </td>
               <td className="p-3 text-right">
-                <Link
-                  href={`/shell/admin/lesson-plans/${plan.id}/view`}
-                  className="text-xs text-muted-foreground hover:text-foreground"
-                >
-                  {t("viewDetail")}
-                </Link>
+                <div className="flex items-center justify-end gap-1">
+                  <Link
+                    href={`/shell/admin/lesson-plans/${plan.id}/view`}
+                    className="text-xs text-muted-foreground hover:text-foreground"
+                  >
+                    {t("viewDetail")}
+                  </Link>
+                  <Button
+                    type="button"
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onDelete(plan.id)}
+                    disabled={plan.status === "ARCHIVED"}
+                    aria-label={tDelete("button")}
+                    title={tDelete("button")}
+                  >
+                    <Trash2 className="size-4" />
+                  </Button>
+                </div>
               </td>
             </tr>
           ))}
@@ -234,3 +376,111 @@ function LessonPlanStatusBadge({
     </span>
   );
 }
+
+/**
+ * 分页组件（页码列表 + 跳转按钮 + total/totalPages 显示）。
+ * 依赖 URL ?page=N 状态，由父组件控制路由跳转。
+ * 页码按钮策略：当 totalPages ≤ MAX_PAGE_BUTTONS 时全量展示；
+ * 超过时展示首尾页 + 当前页附近的页码（含省略号占位）。
+ */
+function Pagination({
+  page,
+  pageSize,
+  total,
+  onJump,
+}: {
+  page: number;
+  pageSize: number;
+  total: number;
+  onJump: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.lessonPlans.list");
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const canPrev = page > 1;
+  const canNext = page < totalPages;
+  const pages = buildPageList(page, totalPages, MAX_PAGE_BUTTONS);
+
+  return (
+    <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+      <div className="flex items-center gap-3">
+        <span>{t("total", { count: total })}</span>
+        <span className="text-xs">
+          {page} / {totalPages}
+        </span>
+      </div>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.max(1, page - 1))}
+          disabled={!canPrev}
+          aria-label={tCommon("button.prev")}
+        >
+          {tCommon("button.prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "..." ? (
+            <span
+              key={`gap-${idx}`}
+              className="px-2 text-xs text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === page ? "default" : "outline"}
+              size="sm"
+              onClick={() => onJump(p)}
+              aria-current={p === page ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.min(totalPages, page + 1))}
+          disabled={!canNext}
+          aria-label={tCommon("button.next")}
+        >
+          {tCommon("button.next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
diff --git a/apps/portal-shell/src/features/admin/lesson-plans/transformations.ts b/apps/portal-shell/src/features/admin/lesson-plans/transformations.ts
index 2f8f00e..c25964a 100644
--- a/apps/portal-shell/src/features/admin/lesson-plans/transformations.ts
+++ b/apps/portal-shell/src/features/admin/lesson-plans/transformations.ts
@@ -96,6 +96,16 @@ export function toAdminLessonPlanListItem(detail: {
   };
 }
 
+/**
+ * 格式化数量为展示字符串。
+ * 输入无效（null/undefined/NaN/负数）返回 "0"。
+ */
+export function formatCount(count: number | null | undefined): string {
+  if (count === null || count === undefined) return "0";
+  if (!Number.isFinite(count) || count < 0) return "0";
+  return `${count}`;
+}
+
 /**
  * 根据教案状态返回 Tailwind 徽章语义类名。
  */
diff --git a/apps/portal-shell/src/features/admin/organization/organization-tree-client.tsx b/apps/portal-shell/src/features/admin/organization/organization-tree-client.tsx
index 810062c..4d8bed5 100644
--- a/apps/portal-shell/src/features/admin/organization/organization-tree-client.tsx
+++ b/apps/portal-shell/src/features/admin/organization/organization-tree-client.tsx
@@ -11,17 +11,18 @@
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 import { Building2 } from "lucide-react";
-import Link from "next/link";
 import { useMemo, useState } from "react";
 import { useTranslations } from "next-intl";
 
 import { useOrganizationTree } from "@/lib/api/admin-p5";
 import type { OrgNode } from "@/lib/api/admin-p5";
+import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import { notify } from "@/shared/lib/notify";
 import {
   collectNodeIds,
   formatMemberCount,
@@ -205,12 +206,13 @@ function OrgNodeRow({
         </td>
         <td className="p-3 text-muted-foreground">{node.children.length}</td>
         <td className="p-3">
-          <Link
-            href={`/shell/admin/organization/${node.id}`}
-            className="text-sm text-primary hover:underline"
+          <Button
+            variant="ghost"
+            size="sm"
+            onClick={() => notify.info(t("list.mswNotice"))}
           >
             {t("list.viewDetail")}
-          </Link>
+          </Button>
         </td>
       </tr>
       {!isCollapsed &&
diff --git a/apps/portal-shell/src/features/admin/permissions/permissions-list-client.tsx b/apps/portal-shell/src/features/admin/permissions/permissions-list-client.tsx
index e41b6c7..584c9b6 100644
--- a/apps/portal-shell/src/features/admin/permissions/permissions-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/permissions/permissions-list-client.tsx
@@ -156,6 +156,9 @@ function PermissionsGrouped({
                   <th className="p-3 text-left font-medium">
                     {t("list.colPermission")}
                   </th>
+                  <th className="p-3 text-left font-medium">
+                    {t("list.colValue")}
+                  </th>
                   <th className="p-3 text-left font-medium">
                     {t("list.colAction")}
                   </th>
@@ -173,6 +176,9 @@ function PermissionsGrouped({
                       className="hover:bg-muted/30"
                     >
                       <td className="p-3 font-medium">{perm.name}</td>
+                      <td className="p-3 font-mono text-xs text-muted-foreground">
+                        {perm.value ?? "--"}
+                      </td>
                       <td className="p-3 font-mono text-xs text-muted-foreground">
                         {perm.action}
                       </td>
diff --git a/apps/portal-shell/src/features/admin/questions/batch-operations.tsx b/apps/portal-shell/src/features/admin/questions/batch-operations.tsx
new file mode 100644
index 0000000..239086a
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/questions/batch-operations.tsx
@@ -0,0 +1,168 @@
+"use client";
+
+/**
+ * 题库批量操作工具栏（迁移自 CICD questions 模块）
+ *
+ * 流程：
+ * 1. 父组件维护 selectedIds 集合，传入本组件
+ * 2. 当 selectedIds 非空时，本组件展示工具栏（含计数 + 批量删除按钮）
+ * 3. 用户点击「批量删除」→ 弹出确认对话框 → 调用 useBatchDeleteQuestions
+ * 4. 成功后通知 + 触发父组件刷新 + 清空选中
+ *
+ * 设计：
+ * - 轻量模态确认（对齐 create-question-dialog.tsx 的轻量模式）
+ * - 工具栏样式对齐 ListPageShell actions 区
+ *
+ * 数据契约：
+ * - batchDeleteQuestions(ids) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#batch-delete-questions-mutation
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §7.3 / §9.4 / §10 P5 / §11.4
+ */
+import { useState } from "react";
+import { useTranslations } from "next-intl";
+
+import { useBatchDeleteQuestions } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+
+interface BatchOperationsProps {
+  selectedIds: string[];
+  onClear: () => void;
+  onDeleted: () => void;
+}
+
+/**
+ * 批量操作工具栏。
+ *
+ * - selectedIds 为空时不渲染
+ * - 非空时展示：选中数量 + 批量删除按钮 + 清空选择按钮
+ * - 点击批量删除弹出确认模态
+ *
+ * @param selectedIds 当前选中的题目 id 列表
+ * @param onClear 清空选中（父组件清空 selectedIds）
+ * @param onDeleted 删除成功后的回调（父组件刷新列表 + 清空选中）
+ */
+export function BatchOperations({
+  selectedIds,
+  onClear,
+  onDeleted,
+}: BatchOperationsProps): React.ReactElement | null {
+  const t = useTranslations("admin.questions.batch");
+  const tCommon = useTranslations("common");
+  const deleteMutation = useBatchDeleteQuestions();
+  const [confirmOpen, setConfirmOpen] = useState(false);
+
+  if (selectedIds.length === 0) return null;
+
+  const handleDeleteClick = (): void => {
+    setConfirmOpen(true);
+  };
+
+  const handleConfirmDelete = async (): Promise<void> => {
+    try {
+      const result = await deleteMutation.run(selectedIds);
+      notify.success(
+        t("deleteSuccess", { deleted: result.deleted, failed: result.failed }),
+      );
+      onDeleted();
+      setConfirmOpen(false);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleCancelDelete = (): void => {
+    setConfirmOpen(false);
+  };
+
+  return (
+    <>
+      <div className="flex items-center gap-3 rounded-lg border bg-muted/30 px-4 py-2 text-sm">
+        <span className="font-medium">
+          {t("selectedCount", { count: selectedIds.length })}
+        </span>
+        <div className="ml-auto flex items-center gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            size="sm"
+            onClick={onClear}
+            disabled={deleteMutation.loading}
+          >
+            {t("clearSelection")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            size="sm"
+            onClick={handleDeleteClick}
+            disabled={deleteMutation.loading}
+          >
+            {t("batchDelete")}
+          </Button>
+        </div>
+      </div>
+
+      {confirmOpen ? (
+        <ConfirmDeleteDialog
+          count={selectedIds.length}
+          loading={deleteMutation.loading}
+          onConfirm={handleConfirmDelete}
+          onCancel={handleCancelDelete}
+        />
+      ) : null}
+    </>
+  );
+}
+
+/**
+ * 批量删除确认对话框（轻量模态，对齐 create-question-dialog 的轻量模式）。
+ */
+function ConfirmDeleteDialog({
+  count,
+  loading,
+  onConfirm,
+  onCancel,
+}: {
+  count: number;
+  loading: boolean;
+  onConfirm: () => void;
+  onCancel: () => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.questions.batch");
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={onCancel}
+    >
+      <div
+        className="w-full max-w-md rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h2 className="mb-2 text-lg font-semibold">{t("confirmTitle")}</h2>
+        <p className="mb-4 text-sm text-muted-foreground">
+          {t("confirmDescription", { count })}
+        </p>
+        <div className="flex justify-end gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={onCancel}
+            disabled={loading}
+          >
+            {t("confirmCancel")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            onClick={onConfirm}
+            disabled={loading}
+          >
+            {loading ? t("confirming") : t("confirmSubmit")}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/questions/create-question-dialog.tsx b/apps/portal-shell/src/features/admin/questions/create-question-dialog.tsx
new file mode 100644
index 0000000..f51d127
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/questions/create-question-dialog.tsx
@@ -0,0 +1,266 @@
+"use client";
+
+/**
+ * 创建题目对话框（迁移自 CICD questions 模块）
+ *
+ * 流程：
+ * 1. 用户填写表单（题型、内容、答案、解析、难度、知识点）
+ * 2. 提交调用 useCreateQuestion
+ * 3. 成功后通知 + 触发父组件刷新 + 关闭对话框
+ *
+ * 设计：
+ * - 轻量模态（portal-shell 自实现，无 radix Dialog 依赖）
+ * - 对齐 generate-invitation-codes-dialog.tsx 的 FormField / 轻量模态模式
+ *
+ * 数据契约：
+ * - createQuestion(input) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#create-question-mutation
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §7.3 / §9.4 / §10 P5 / §11.4
+ */
+import { useState } from "react";
+import { useTranslations } from "next-intl";
+
+import { useCreateQuestion } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import { notify } from "@/shared/lib/notify";
+
+/** 题型选项（与 schema Question.type 字符串语义对齐） */
+const TYPE_OPTIONS = [
+  "single_choice",
+  "multiple_choice",
+  "fill_blank",
+  "short_answer",
+  "essay",
+  "true_false",
+] as const;
+
+/** 难度选项（数值与 schema Question.difficulty Float 对齐，0~1） */
+const DIFFICULTY_OPTIONS = [
+  { value: 0.3, labelKey: "difficultyEasy" },
+  { value: 0.5, labelKey: "difficultyMedium" },
+  { value: 0.8, labelKey: "difficultyHard" },
+] as const;
+
+const DEFAULT_TYPE = "single_choice";
+const DEFAULT_DIFFICULTY = 0.5;
+
+interface CreateQuestionDialogProps {
+  open: boolean;
+  onClose: () => void;
+  onCreated: () => void;
+}
+
+/**
+ * 创建题目对话框。open 控制显隐，onCreated 在成功后触发父组件刷新。
+ */
+export function CreateQuestionDialog({
+  open,
+  onClose,
+  onCreated,
+}: CreateQuestionDialogProps): React.ReactElement | null {
+  const t = useTranslations("admin.questions.createDialog");
+  const tCommon = useTranslations("common");
+  const createMutation = useCreateQuestion();
+
+  const [type, setType] = useState<string>(DEFAULT_TYPE);
+  const [content, setContent] = useState<string>("");
+  const [answer, setAnswer] = useState<string>("");
+  const [explanation, setExplanation] = useState<string>("");
+  const [difficulty, setDifficulty] = useState<number>(DEFAULT_DIFFICULTY);
+  const [knowledgePointId, setKnowledgePointId] = useState<string>("");
+  const [source, setSource] = useState<string>("");
+
+  if (!open) return null;
+
+  const resetForm = (): void => {
+    setType(DEFAULT_TYPE);
+    setContent("");
+    setAnswer("");
+    setExplanation("");
+    setDifficulty(DEFAULT_DIFFICULTY);
+    setKnowledgePointId("");
+    setSource("");
+  };
+
+  const handleClose = (): void => {
+    onClose();
+  };
+
+  const handleSubmit = async (
+    e: React.FormEvent<HTMLFormElement>,
+  ): Promise<void> => {
+    e.preventDefault();
+    const trimmedContent = content.trim();
+    const trimmedAnswer = answer.trim();
+    if (!trimmedContent) {
+      notify.error(t("errorContentRequired"));
+      return;
+    }
+    if (!trimmedAnswer) {
+      notify.error(t("errorAnswerRequired"));
+      return;
+    }
+    if (!knowledgePointId.trim()) {
+      notify.error(t("errorKnowledgePointRequired"));
+      return;
+    }
+    try {
+      await createMutation.run({
+        type,
+        content: trimmedContent,
+        answer: trimmedAnswer,
+        explanation: explanation.trim() || undefined,
+        difficulty,
+        knowledgePointId: knowledgePointId.trim(),
+        source: source.trim() || undefined,
+      });
+      notify.success(t("success"));
+      onCreated();
+      resetForm();
+      onClose();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={handleClose}
+    >
+      <div
+        className="max-h-[90vh] w-full max-w-lg overflow-y-auto rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h2 className="mb-2 text-lg font-semibold">{t("title")}</h2>
+        <p className="mb-4 text-sm text-muted-foreground">{t("description")}</p>
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <FormField label={t("fieldType")} required>
+            <select
+              value={type}
+              onChange={(e) => setType(e.target.value)}
+              aria-label={t("fieldType")}
+              className="h-9 w-full rounded-md border border-input bg-transparent px-3 text-sm outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+            >
+              {TYPE_OPTIONS.map((opt) => (
+                <option key={opt} value={opt}>
+                  {t(`types.${opt}`)}
+                </option>
+              ))}
+            </select>
+          </FormField>
+
+          <FormField label={t("fieldContent")} required>
+            <textarea
+              value={content}
+              onChange={(e) => setContent(e.target.value)}
+              maxLength={2000}
+              rows={4}
+              required
+              aria-label={t("fieldContent")}
+              className="flex w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none transition-[color,box-shadow] focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+            />
+          </FormField>
+
+          <FormField label={t("fieldAnswer")} required>
+            <textarea
+              value={answer}
+              onChange={(e) => setAnswer(e.target.value)}
+              maxLength={1000}
+              rows={2}
+              required
+              aria-label={t("fieldAnswer")}
+              className="flex w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none transition-[color,box-shadow] focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+            />
+          </FormField>
+
+          <FormField label={t("fieldExplanation")}>
+            <textarea
+              value={explanation}
+              onChange={(e) => setExplanation(e.target.value)}
+              maxLength={1000}
+              rows={2}
+              aria-label={t("fieldExplanation")}
+              className="flex w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none transition-[color,box-shadow] focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+            />
+          </FormField>
+
+          <div className="grid grid-cols-2 gap-4">
+            <FormField label={t("fieldDifficulty")} required>
+              <select
+                value={difficulty}
+                onChange={(e) => setDifficulty(Number(e.target.value))}
+                aria-label={t("fieldDifficulty")}
+                className="h-9 w-full rounded-md border border-input bg-transparent px-3 text-sm outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]"
+              >
+                {DIFFICULTY_OPTIONS.map((opt) => (
+                  <option key={opt.value} value={opt.value}>
+                    {t(opt.labelKey)}
+                  </option>
+                ))}
+              </select>
+            </FormField>
+
+            <FormField label={t("fieldKnowledgePoint")} required>
+              <Input
+                type="text"
+                value={knowledgePointId}
+                onChange={(e) => setKnowledgePointId(e.target.value)}
+                placeholder={t("fieldKnowledgePointPlaceholder")}
+                required
+              />
+            </FormField>
+          </div>
+
+          <FormField label={t("fieldSource")}>
+            <Input
+              type="text"
+              value={source}
+              onChange={(e) => setSource(e.target.value)}
+              placeholder={t("fieldSourcePlaceholder")}
+            />
+          </FormField>
+
+          <div className="flex justify-end gap-2">
+            <Button
+              type="button"
+              variant="outline"
+              onClick={handleClose}
+              disabled={createMutation.loading}
+            >
+              {t("cancel")}
+            </Button>
+            <Button type="submit" disabled={createMutation.loading}>
+              {createMutation.loading ? t("submitting") : t("submit")}
+            </Button>
+          </div>
+        </form>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * 表单字段容器（label + children）。对齐 generate-invitation-codes-dialog.tsx 的 FormField 模式。
+ */
+function FormField({
+  label,
+  required,
+  children,
+}: {
+  label: string;
+  required?: boolean;
+  children: React.ReactNode;
+}): React.ReactElement {
+  return (
+    <div className="space-y-2">
+      <label className="text-sm font-medium">
+        {label}
+        {required ? <span className="ml-1 text-destructive">*</span> : null}
+      </label>
+      {children}
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/questions/import-export-buttons.tsx b/apps/portal-shell/src/features/admin/questions/import-export-buttons.tsx
new file mode 100644
index 0000000..b1b3833
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/questions/import-export-buttons.tsx
@@ -0,0 +1,214 @@
+"use client";
+
+/**
+ * 题库导入/导出按钮（迁移自 CICD questions 模块）
+ *
+ * 流程：
+ * - 导入：选择 CSV/JSON 文件 → 读取文件内容 → 调用 useImportQuestions → 展示结果
+ * - 导出：调用 useExportQuestions 触发 refetch → 将 items 转为 CSV 下载
+ *
+ * 数据契约：
+ * - importQuestions(input) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - exportQuestions(filter) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 契约工单：docs/architecture/issues/contracts/core-edu_contract.md
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §7.3 / §9.4 / §10 P5 / §11.4
+ */
+import { Download, Loader2, Upload } from "lucide-react";
+import { useRef, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import {
+  useExportQuestions,
+  useImportQuestions,
+  type ExportQuestionItem,
+  type QuestionsListFilter,
+} from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+
+interface ImportExportButtonsProps {
+  filter: QuestionsListFilter;
+  onImported: () => void;
+}
+
+/**
+ * 导入/导出按钮组。
+ *
+ * - 导入按钮：触发隐藏 file input，选择文件后调用 mutation
+ * - 导出按钮：触发查询 refetch，拿到结果后下载 CSV
+ *
+ * @param filter 当前列表筛选条件（用于导出查询）
+ * @param onImported 导入成功后的回调（父组件刷新列表）
+ */
+export function ImportExportButtons({
+  filter,
+  onImported,
+}: ImportExportButtonsProps): React.ReactElement {
+  const t = useTranslations("admin.questions.importExport");
+  const tCommon = useTranslations("common");
+  const importMutation = useImportQuestions();
+  const exportQuery = useExportQuestions(filter);
+  const fileInputRef = useRef<HTMLInputElement>(null);
+  const [exporting, setExporting] = useState(false);
+
+  const handleImportClick = (): void => {
+    fileInputRef.current?.click();
+  };
+
+  const handleFileChange = async (
+    e: React.ChangeEvent<HTMLInputElement>,
+  ): Promise<void> => {
+    const file = e.target.files?.[0];
+    if (!file) return;
+    const format = file.name.toLowerCase().endsWith(".json") ? "json" : "csv";
+    try {
+      const payload = await file.text();
+      const result = await importMutation.run({ payload, format });
+      notify.success(
+        t("importSuccess", {
+          imported: result.imported,
+          skipped: result.skipped,
+        }),
+      );
+      onImported();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    } finally {
+      e.target.value = "";
+    }
+  };
+
+  const handleExportClick = async (): Promise<void> => {
+    setExporting(true);
+    try {
+      const data = await exportQuery.refetch();
+      if (!data || data.items.length === 0) {
+        notify.info(t("exportEmpty"));
+        return;
+      }
+      const csv = convertQuestionsToCsv(data.items);
+      const ok = downloadCsv("questions-export.csv", csv);
+      if (ok) {
+        notify.success(t("exportSuccess", { count: data.total }));
+      } else {
+        notify.error(t("exportFailed"));
+      }
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    } finally {
+      setExporting(false);
+    }
+  };
+
+  const isExporting = exporting || exportQuery.loading;
+
+  return (
+    <div className="flex items-center gap-2">
+      <input
+        ref={fileInputRef}
+        type="file"
+        accept=".csv,.json"
+        disabled={importMutation.loading}
+        onChange={handleFileChange}
+        className="hidden"
+      />
+      <Button
+        type="button"
+        variant="outline"
+        size="sm"
+        onClick={handleImportClick}
+        disabled={importMutation.loading}
+      >
+        {importMutation.loading ? (
+          <Loader2 className="size-4 animate-spin" />
+        ) : (
+          <Upload className="size-4" />
+        )}
+        {t("import")}
+      </Button>
+      <Button
+        type="button"
+        variant="outline"
+        size="sm"
+        onClick={handleExportClick}
+        disabled={isExporting}
+      >
+        {isExporting ? (
+          <Loader2 className="size-4 animate-spin" />
+        ) : (
+          <Download className="size-4" />
+        )}
+        {t("export")}
+      </Button>
+    </div>
+  );
+}
+
+/**
+ * 将题目列表转为 CSV 字符串（含 BOM 以兼容 Excel 中文）。
+ *
+ * 纯函数，便于单测。对齐 audit-logs/transformations.ts 的 downloadCsv 模式。
+ */
+function convertQuestionsToCsv(items: ExportQuestionItem[]): string {
+  const headers = [
+    "id",
+    "type",
+    "content",
+    "difficulty",
+    "answer",
+    "explanation",
+    "knowledgePointId",
+    "subjectId",
+    "source",
+    "status",
+    "createdAt",
+  ];
+  const escapeCell = (value: string | null | undefined): string => {
+    if (value === null || value === undefined) return "";
+    const s = String(value);
+    if (s.includes(",") || s.includes("\n") || s.includes('"')) {
+      return `"${s.replace(/"/g, '""')}"`;
+    }
+    return s;
+  };
+  const rows = items.map((item) =>
+    [
+      item.id,
+      item.type,
+      item.content,
+      item.difficulty,
+      item.answer,
+      item.explanation ?? "",
+      item.knowledgePointId,
+      item.subjectId,
+      item.source,
+      item.status,
+      item.createdAt,
+    ]
+      .map(escapeCell)
+      .join(","),
+  );
+  return `\uFEFF${headers.join(",")}\n${rows.join("\n")}`;
+}
+
+/**
+ * 触发浏览器下载 CSV 文件。返回是否成功。
+ */
+function downloadCsv(filename: string, csv: string): boolean {
+  if (typeof window === "undefined") return false;
+  try {
+    const blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
diff --git a/apps/portal-shell/src/features/admin/questions/question-detail-dialog.tsx b/apps/portal-shell/src/features/admin/questions/question-detail-dialog.tsx
new file mode 100644
index 0000000..92d5e97
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/questions/question-detail-dialog.tsx
@@ -0,0 +1,307 @@
+"use client";
+
+/**
+ * 题目详情对话框（ARCHITECTURE.md §5.4 / §9.4 / §10 P5）
+ *
+ * 数据契约：
+ * - adminQuestion(id)：❌ schema 无 → MSW 兜底（@contract-pending）
+ *
+ * 适配 portal-shell：
+ * - 用原生轻量模态（fixed inset-0 + bg-black/50 + 卡片）替代 shadcn Dialog
+ * - 数据通过 useAdminQuestion hook 拉取
+ * - 错误处理走 notify.error()
+ *
+ * 关联：ARCHITECTURE.md §5.3 契约纪律 / §9.4 / §11.3 DoD
+ */
+import { useEffect } from "react";
+import { useTranslations } from "next-intl";
+import {
+  BookOpen,
+  Calendar,
+  FileText,
+  Hash,
+  HelpCircle,
+  Lightbulb,
+  RefreshCw,
+  Target,
+  User,
+} from "lucide-react";
+
+import { useAdminQuestion } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import { Separator } from "@/shared/components/ui/separator";
+import {
+  difficultyToColorClass,
+  formatDifficulty,
+  formatQuestionDate,
+  formatQuestionStatus,
+  formatQuestionType,
+  questionStatusToBadgeClass,
+} from "@/features/admin/questions/transformations";
+
+export interface QuestionDetailDialogProps {
+  /** 当前选中的题目 id，为空时关闭对话框 */
+  questionId: string | null;
+  onOpenChange: (open: boolean) => void;
+}
+
+/**
+ * 题目详情对话框。questionId 非空时打开，按 id 拉取详情。
+ */
+export function QuestionDetailDialog({
+  questionId,
+  onOpenChange,
+}: QuestionDetailDialogProps): React.ReactElement {
+  const t = useTranslations("admin.questions.detailDialog");
+  const tCommon = useTranslations("common");
+  const open = questionId !== null && questionId.length > 0;
+
+  const { data, loading, error, refetch } = useAdminQuestion(questionId ?? "", {
+    enabled: open,
+  });
+
+  // 查询失败时通知用户（§11.3 DoD #8：catch 块必须包含 notify.error()）
+  useEffect(() => {
+    if (error) {
+      notify.error(tCommon("error.loadFailed", { message: String(error) }));
+    }
+  }, [error, tCommon]);
+
+  // ESC 键关闭
+  useEffect(() => {
+    if (!open) return;
+    const handleKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === "Escape") onOpenChange(false);
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [open, onOpenChange]);
+
+  if (!open) return <></>;
+
+  return (
+    <div
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="question-detail-title"
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={() => onOpenChange(false)}
+    >
+      <div
+        className="flex max-h-[90vh] w-full max-w-2xl flex-col overflow-hidden rounded-lg border bg-card shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* 头部 */}
+        <div className="flex items-start justify-between border-b p-6 pb-4">
+          <div className="flex-1">
+            <h2
+              id="question-detail-title"
+              className="flex items-center gap-2 text-lg font-semibold"
+            >
+              <HelpCircle className="size-5" />
+              {t("title")}
+            </h2>
+            {data ? (
+              <div className="mt-2 flex flex-wrap items-center gap-2 text-xs">
+                <Badge variant="outline">{formatQuestionType(data.type)}</Badge>
+                <Badge variant="secondary">
+                  {formatQuestionStatus(data.status)}
+                </Badge>
+                {data.subjectName ? (
+                  <span className="text-muted-foreground">
+                    {data.subjectName}
+                  </span>
+                ) : null}
+              </div>
+            ) : null}
+          </div>
+          <Button
+            variant="ghost"
+            size="sm"
+            onClick={() => onOpenChange(false)}
+            aria-label={t("close")}
+          >
+            ✕
+          </Button>
+        </div>
+
+        {/* 内容区 */}
+        <div className="flex-1 overflow-y-auto p-6">
+          {loading ? (
+            <div className="space-y-3">
+              <div className="h-4 w-1/3 animate-pulse rounded bg-muted" />
+              <div className="h-20 animate-pulse rounded bg-muted" />
+              <div className="h-4 w-1/4 animate-pulse rounded bg-muted" />
+              <div className="h-16 animate-pulse rounded bg-muted" />
+            </div>
+          ) : error ? (
+            <div className="rounded-md border border-destructive/30 bg-destructive/5 p-4 text-center">
+              <p className="text-sm text-destructive">
+                {tCommon("error.loadFailed", { message: String(error) })}
+              </p>
+              <Button
+                variant="outline"
+                size="sm"
+                className="mt-3"
+                onClick={() => void refetch()}
+              >
+                <RefreshCw className="size-4" />
+                {t("retry")}
+              </Button>
+            </div>
+          ) : data ? (
+            <div className="space-y-5">
+              {/* 元信息 */}
+              <section className="grid grid-cols-2 gap-3 text-sm sm:grid-cols-3">
+                <InfoItem
+                  icon={<Hash className="size-4" />}
+                  label={t("type")}
+                  value={formatQuestionType(data.type)}
+                />
+                <InfoItem
+                  icon={<Target className="size-4" />}
+                  label={t("difficulty")}
+                  value={
+                    <span
+                      className={`text-xs font-medium ${difficultyToColorClass(data.difficulty)}`}
+                    >
+                      {formatDifficulty(data.difficulty)}
+                    </span>
+                  }
+                />
+                <InfoItem
+                  icon={<FileText className="size-4" />}
+                  label={t("status")}
+                  value={
+                    <span
+                      className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${questionStatusToBadgeClass(data.status)}`}
+                    >
+                      {formatQuestionStatus(data.status)}
+                    </span>
+                  }
+                />
+                <InfoItem
+                  icon={<BookOpen className="size-4" />}
+                  label={t("subject")}
+                  value={data.subjectName || data.subjectId || "--"}
+                />
+                <InfoItem
+                  icon={<BookOpen className="size-4" />}
+                  label={t("textbook")}
+                  value={data.textbookTitle || data.textbookId || "--"}
+                />
+                <InfoItem
+                  icon={<Lightbulb className="size-4" />}
+                  label={t("knowledgePoint")}
+                  value={
+                    data.knowledgePointTitle || data.knowledgePointId || "--"
+                  }
+                />
+              </section>
+
+              <Separator />
+
+              {/* 题目内容 */}
+              <section>
+                <h3 className="mb-2 text-sm font-medium">{t("content")}</h3>
+                <div className="rounded-md border bg-muted/30 p-3 text-sm">
+                  <pre className="whitespace-pre-wrap break-words font-sans">
+                    {data.content || t("noContent")}
+                  </pre>
+                </div>
+              </section>
+
+              {/* 正确答案 */}
+              {data.answer ? (
+                <section>
+                  <h3 className="mb-2 flex items-center gap-1 text-sm font-medium text-emerald-600 dark:text-emerald-400">
+                    <Target className="size-4" />
+                    {t("answer")}
+                  </h3>
+                  <div className="rounded-md border border-emerald-200 bg-emerald-50/50 p-3 text-sm dark:border-emerald-900 dark:bg-emerald-950/20">
+                    <pre className="whitespace-pre-wrap break-words font-sans">
+                      {data.answer}
+                    </pre>
+                  </div>
+                </section>
+              ) : null}
+
+              {/* 解析 */}
+              {data.explanation ? (
+                <section>
+                  <h3 className="mb-2 flex items-center gap-1 text-sm font-medium">
+                    <Lightbulb className="size-4" />
+                    {t("explanation")}
+                  </h3>
+                  <div className="rounded-md border bg-background p-3 text-sm">
+                    <pre className="whitespace-pre-wrap break-words font-sans">
+                      {data.explanation}
+                    </pre>
+                  </div>
+                </section>
+              ) : null}
+
+              {/* 来源 */}
+              {data.source ? (
+                <section>
+                  <h3 className="mb-2 text-sm font-medium">{t("source")}</h3>
+                  <p className="text-sm text-muted-foreground">{data.source}</p>
+                </section>
+              ) : null}
+
+              {/* 元信息 */}
+              <section className="flex flex-wrap items-center gap-4 text-xs text-muted-foreground">
+                <span className="flex items-center gap-1">
+                  <User className="size-3" />
+                  {t("createdBy")}：{data.createdBy || "--"}
+                </span>
+                <span className="flex items-center gap-1">
+                  <Calendar className="size-3" />
+                  {t("createdAt")}：{formatQuestionDate(data.createdAt)}
+                </span>
+                <span className="flex items-center gap-1">
+                  <Calendar className="size-3" />
+                  {t("updatedAt")}：{formatQuestionDate(data.updatedAt)}
+                </span>
+              </section>
+            </div>
+          ) : (
+            <div className="py-6 text-center text-sm text-muted-foreground">
+              {t("noData")}
+            </div>
+          )}
+        </div>
+
+        {/* 底部 */}
+        <div className="flex justify-end gap-2 border-t p-4">
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            {t("close")}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+/** 信息项（图标 + 标签 + 值）。 */
+function InfoItem({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: React.ReactNode;
+}): React.ReactElement {
+  return (
+    <div className="flex items-center gap-2">
+      <span className="text-muted-foreground">{icon}</span>
+      <div>
+        <p className="text-xs text-muted-foreground">{label}</p>
+        <p className="font-medium">{value || "--"}</p>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/questions/questions-list-client.tsx b/apps/portal-shell/src/features/admin/questions/questions-list-client.tsx
index 98f127d..1a37335 100644
--- a/apps/portal-shell/src/features/admin/questions/questions-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/questions/questions-list-client.tsx
@@ -5,6 +5,7 @@
  *
  * 数据契约：
  * - 列表查询 adminQuestions(filter) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * - 创建/导入/导出/批量删除：均 ❌ schema 未就绪 → MSW 兜底（@contract-pending）
  * - 契约工单：docs/architecture/issues/contracts/core-edu_contract.md
  *
  * URL 状态：?type=&difficulty=&subjectId=&q=
@@ -14,9 +15,8 @@
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 import { HelpCircle } from "lucide-react";
-import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import { useAdminQuestions, type AdminQuestionListItem } from "@/lib/api";
@@ -37,6 +37,15 @@ import {
   questionTypeToBadgeClass,
   truncateContent,
 } from "@/features/admin/questions/transformations";
+import { CreateQuestionDialog } from "@/features/admin/questions/create-question-dialog";
+import { ImportExportButtons } from "@/features/admin/questions/import-export-buttons";
+import { BatchOperations } from "@/features/admin/questions/batch-operations";
+import { QuestionDetailDialog } from "@/features/admin/questions/question-detail-dialog";
+
+/** 每页条数 */
+const PAGE_SIZE = 10;
+/** 分页组件最多展示的页码按钮数（奇数，便于左右对称） */
+const MAX_PAGE_BUTTONS = 7;
 
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
@@ -53,9 +62,16 @@ export function AdminQuestionsListClient(): React.ReactElement {
   const difficultyFilter = searchParams.get("difficulty") ?? "";
   const subjectId = searchParams.get("subjectId") ?? "";
   const q = searchParams.get("q") ?? "";
+  const page = Number(searchParams.get("page") ?? "1") || 1;
+
+  const [createDialogOpen, setCreateDialogOpen] = useState(false);
+  const [selectedIds, setSelectedIds] = useState<string[]>([]);
+  const [selectedQuestionId, setSelectedQuestionId] = useState<string | null>(
+    null,
+  );
 
   // @contract-pending：MSW 兜底
-  const { data, loading, error } = useAdminQuestions({
+  const { data, loading, error, refetch } = useAdminQuestions({
     type: typeFilter || null,
     difficulty: difficultyFilter || null,
     subjectId: subjectId || null,
@@ -70,6 +86,14 @@ export function AdminQuestionsListClient(): React.ReactElement {
     return items.filter((item) => item.content.toLowerCase().includes(lower));
   }, [data, q]);
 
+  const total = data?.total ?? filteredItems.length;
+  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+  const safePage = Math.min(Math.max(1, page), totalPages);
+  const pagedItems = useMemo<AdminQuestionListItem[]>(() => {
+    const start = (safePage - 1) * PAGE_SIZE;
+    return filteredItems.slice(start, start + PAGE_SIZE);
+  }, [filteredItems, safePage]);
+
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
     if (value) {
@@ -77,6 +101,10 @@ export function AdminQuestionsListClient(): React.ReactElement {
     } else {
       params.delete(key);
     }
+    // 切换筛选时重置页码
+    if (key !== "page") {
+      params.delete("page");
+    }
     startTransition(() => {
       router.push(`/shell/admin/questions?${params.toString()}`);
     });
@@ -103,89 +131,194 @@ export function AdminQuestionsListClient(): React.ReactElement {
     />
   );
 
+  const handleCreateClick = (): void => {
+    setCreateDialogOpen(true);
+  };
+
+  const handleCreated = (): void => {
+    void refetch();
+  };
+
+  const handleImported = (): void => {
+    void refetch();
+  };
+
+  const handleClearSelection = (): void => {
+    setSelectedIds([]);
+  };
+
+  const handleBatchDeleted = (): void => {
+    setSelectedIds([]);
+    void refetch();
+  };
+
+  const handleSelectItem = (id: string, checked: boolean): void => {
+    setSelectedIds((prev) =>
+      checked ? [...prev, id] : prev.filter((x) => x !== id),
+    );
+  };
+
+  const handleSelectAll = (checked: boolean): void => {
+    setSelectedIds(checked ? pagedItems.map((item) => item.id) : []);
+  };
+
+  const exportFilter = {
+    type: typeFilter || undefined,
+    difficulty: difficultyFilter || undefined,
+    subjectId: subjectId || undefined,
+    q: q || undefined,
+  };
+
   return (
-    <ListPageShell
-      title={t("title")}
-      description={t("description")}
-      icon={<HelpCircle className="size-6" />}
-      actions={
-        <Button asChild>
-          <Link href="/shell/admin/questions">{t("createButton")}</Link>
-        </Button>
-      }
-      filters={
-        <>
-          <FilterSearchInput
-            placeholder={t("searchPlaceholder")}
-            value={q}
-            onChange={(v) => updateQuery("q", v)}
+    <>
+      <CreateQuestionDialog
+        open={createDialogOpen}
+        onClose={() => setCreateDialogOpen(false)}
+        onCreated={handleCreated}
+      />
+      <QuestionDetailDialog
+        questionId={selectedQuestionId}
+        onOpenChange={(open) => {
+          if (!open) setSelectedQuestionId(null);
+        }}
+      />
+      <ListPageShell
+        title={t("title")}
+        description={t("description")}
+        icon={<HelpCircle className="size-6" />}
+        actions={
+          <div className="flex items-center gap-2">
+            <Button onClick={handleCreateClick}>{t("createButton")}</Button>
+            <ImportExportButtons
+              filter={exportFilter}
+              onImported={handleImported}
+            />
+          </div>
+        }
+        filters={
+          <>
+            <FilterSearchInput
+              placeholder={t("searchPlaceholder")}
+              value={q}
+              onChange={(v) => updateQuery("q", v)}
+            />
+            <select
+              value={typeFilter}
+              onChange={(e) => updateQuery("type", e.target.value)}
+              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+              aria-label={t("filterType")}
+            >
+              <option value="">{t("typeAll")}</option>
+              <option value="single_choice">{t("typeSingle")}</option>
+              <option value="multiple_choice">{t("typeMultiple")}</option>
+              <option value="fill_blank">{t("typeFill")}</option>
+              <option value="essay">{t("typeEssay")}</option>
+              <option value="true_false">{t("typeTrueFalse")}</option>
+            </select>
+            <select
+              value={difficultyFilter}
+              onChange={(e) => updateQuery("difficulty", e.target.value)}
+              className="h-9 rounded-md border border-input bg-background px-3 text-sm"
+              aria-label={t("filterDifficulty")}
+            >
+              <option value="">{t("difficultyAll")}</option>
+              <option value="easy">{t("difficultyEasy")}</option>
+              <option value="medium">{t("difficultyMedium")}</option>
+              <option value="hard">{t("difficultyHard")}</option>
+            </select>
+            <input
+              type="text"
+              value={subjectId}
+              onChange={(e) => updateQuery("subjectId", e.target.value)}
+              placeholder={t("filterSubject")}
+              className="h-9 w-40 rounded-md border border-input bg-background px-3 text-sm"
+              aria-label={t("filterSubject")}
+            />
+          </>
+        }
+        loading={loading}
+        loadingNode={<ListPageSkeleton rows={5} />}
+        empty={filteredItems.length === 0 && !loading}
+        emptyNode={emptyNode}
+        errorNode={errorNode}
+        pagination={
+          <Pagination
+            page={safePage}
+            pageSize={PAGE_SIZE}
+            total={total}
+            onJump={(p) => updateQuery("page", String(p))}
           />
-          <select
-            value={typeFilter}
-            onChange={(e) => updateQuery("type", e.target.value)}
-            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
-            aria-label={t("filterType")}
-          >
-            <option value="">{t("typeAll")}</option>
-            <option value="single_choice">{t("typeSingle")}</option>
-            <option value="multiple_choice">{t("typeMultiple")}</option>
-            <option value="fill_blank">{t("typeFill")}</option>
-            <option value="essay">{t("typeEssay")}</option>
-            <option value="true_false">{t("typeTrueFalse")}</option>
-          </select>
-          <select
-            value={difficultyFilter}
-            onChange={(e) => updateQuery("difficulty", e.target.value)}
-            className="h-9 rounded-md border border-input bg-background px-3 text-sm"
-            aria-label={t("filterDifficulty")}
-          >
-            <option value="">{t("difficultyAll")}</option>
-            <option value="easy">{t("difficultyEasy")}</option>
-            <option value="medium">{t("difficultyMedium")}</option>
-            <option value="hard">{t("difficultyHard")}</option>
-          </select>
-          <input
-            type="text"
-            value={subjectId}
-            onChange={(e) => updateQuery("subjectId", e.target.value)}
-            placeholder={t("filterSubject")}
-            className="h-9 w-40 rounded-md border border-input bg-background px-3 text-sm"
-            aria-label={t("filterSubject")}
+        }
+      >
+        <div className="flex flex-col gap-3">
+          {selectedIds.length > 0 ? (
+            <BatchOperations
+              selectedIds={selectedIds}
+              onClear={handleClearSelection}
+              onDeleted={handleBatchDeleted}
+            />
+          ) : null}
+          <AdminQuestionsTable
+            items={pagedItems}
+            selectedIds={selectedIds}
+            onSelectItem={handleSelectItem}
+            onSelectAll={handleSelectAll}
+            onViewDetail={setSelectedQuestionId}
           />
-        </>
-      }
-      loading={loading}
-      loadingNode={<ListPageSkeleton rows={5} />}
-      empty={filteredItems.length === 0 && !loading}
-      emptyNode={emptyNode}
-      errorNode={errorNode}
-      pagination={
-        <div className="flex items-center justify-end gap-2 text-sm text-muted-foreground">
-          <span>
-            {t("total", { count: data?.total ?? filteredItems.length })}
-          </span>
         </div>
-      }
-    >
-      <AdminQuestionsTable items={filteredItems} />
-    </ListPageShell>
+      </ListPageShell>
+    </>
   );
 }
 
 /**
  * 题目列表表格（纯展示组件，对齐 §8.2 排版规范）。
+ *
+ * - 第一列为 checkbox（支持单选 / 全选）
+ * - 选中态由父组件维护（selectedIds），本组件仅展示与回调
+ * - 当题目数超过 100 时启用虚拟滚动优化（CSS content-visibility: auto，
+ *   浏览器自动跳过视口外行的渲染，降低首次绘制与滚动开销，无需引入新依赖）
  */
 function AdminQuestionsTable({
   items,
+  selectedIds,
+  onSelectItem,
+  onSelectAll,
+  onViewDetail,
 }: {
   items: AdminQuestionListItem[];
+  selectedIds: string[];
+  onSelectItem: (id: string, checked: boolean) => void;
+  onSelectAll: (checked: boolean) => void;
+  onViewDetail: (id: string) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.questions.list");
+  const allChecked =
+    items.length > 0 && items.every((item) => selectedIds.includes(item.id));
+  const someChecked = items.some((item) => selectedIds.includes(item.id));
+  // 当题目数超过 100 时启用虚拟滚动优化（CSS content-visibility）
+  const enableVirtualScroll = items.length > 100;
+  const rowStyle = enableVirtualScroll
+    ? { contentVisibility: "auto" as const, containIntrinsicSize: "0 80px" }
+    : undefined;
+
   return (
     <div className="overflow-x-auto rounded-xl border">
       <table className="w-full text-sm">
         <thead className="border-b bg-muted/30">
           <tr>
+            <th className="w-10 p-3 text-left">
+              <input
+                type="checkbox"
+                checked={allChecked}
+                ref={(el) => {
+                  if (el) el.indeterminate = !allChecked && someChecked;
+                }}
+                onChange={(e) => onSelectAll(e.target.checked)}
+                aria-label={t("selectAll")}
+                className="size-4 cursor-pointer rounded border-input"
+              />
+            </th>
             <th className="p-3 text-left font-medium">{t("colContent")}</th>
             <th className="p-3 text-left font-medium">{t("colType")}</th>
             <th className="p-3 text-left font-medium">{t("colDifficulty")}</th>
@@ -197,45 +330,59 @@ function AdminQuestionsTable({
           </tr>
         </thead>
         <tbody className="divide-y">
-          {items.map((q) => (
-            <tr key={q.id} className="hover:bg-muted/30">
-              <td className="max-w-xs p-3">
-                <span className="font-medium">
-                  {truncateContent(q.content)}
-                </span>
-              </td>
-              <td className="p-3">
-                <QuestionTypeBadge type={q.type} />
-              </td>
-              <td className="p-3">
-                <span
-                  className={`text-xs font-medium ${difficultyToColorClass(q.difficulty)}`}
-                >
-                  {formatDifficulty(q.difficulty)}
-                </span>
-              </td>
-              <td className="p-3 text-xs text-muted-foreground">
-                {q.subjectName || q.subjectId || "-"}
-              </td>
-              <td className="p-3">
-                <QuestionStatusBadge status={q.status} />
-              </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatQuestionDate(q.createdAt)}
-              </td>
-              <td className="p-3 text-xs text-muted-foreground">
-                {q.createdBy || "-"}
-              </td>
-              <td className="p-3 text-right">
-                <Link
-                  href={`/shell/admin/questions?id=${q.id}`}
-                  className="text-xs text-muted-foreground hover:text-foreground"
-                >
-                  {t("viewDetail")}
-                </Link>
-              </td>
-            </tr>
-          ))}
+          {items.map((q) => {
+            const checked = selectedIds.includes(q.id);
+            return (
+              <tr key={q.id} className="hover:bg-muted/30" style={rowStyle}>
+                <td className="p-3">
+                  <input
+                    type="checkbox"
+                    checked={checked}
+                    onChange={(e) => onSelectItem(q.id, e.target.checked)}
+                    aria-label={t("selectRow")}
+                    className="size-4 cursor-pointer rounded border-input"
+                  />
+                </td>
+                <td className="max-w-xs p-3">
+                  <span className="font-medium">
+                    {truncateContent(q.content)}
+                  </span>
+                </td>
+                <td className="p-3">
+                  <QuestionTypeBadge type={q.type} />
+                </td>
+                <td className="p-3">
+                  <span
+                    className={`text-xs font-medium ${difficultyToColorClass(q.difficulty)}`}
+                  >
+                    {formatDifficulty(q.difficulty)}
+                  </span>
+                </td>
+                <td className="p-3 text-xs text-muted-foreground">
+                  {q.subjectName || q.subjectId || "-"}
+                </td>
+                <td className="p-3">
+                  <QuestionStatusBadge status={q.status} />
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {formatQuestionDate(q.createdAt)}
+                </td>
+                <td className="p-3 text-xs text-muted-foreground">
+                  {q.createdBy || "-"}
+                </td>
+                <td className="p-3 text-right">
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    className="h-7 px-2 text-xs text-muted-foreground hover:text-foreground"
+                    onClick={() => onViewDetail(q.id)}
+                  >
+                    {t("viewDetail")}
+                  </Button>
+                </td>
+              </tr>
+            );
+          })}
         </tbody>
       </table>
     </div>
@@ -275,3 +422,111 @@ function QuestionStatusBadge({
     </span>
   );
 }
+
+/**
+ * 分页组件（页码列表 + 跳转按钮 + total/totalPages 显示）。
+ * 依赖 URL ?page=N 状态，由父组件控制路由跳转。
+ * 页码按钮策略：当 totalPages ≤ MAX_PAGE_BUTTONS 时全量展示；
+ * 超过时展示首尾页 + 当前页附近的页码（含省略号占位）。
+ */
+function Pagination({
+  page,
+  pageSize,
+  total,
+  onJump,
+}: {
+  page: number;
+  pageSize: number;
+  total: number;
+  onJump: (page: number) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.questions.list");
+  const tCommon = useTranslations("common");
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const canPrev = page > 1;
+  const canNext = page < totalPages;
+  const pages = buildPageList(page, totalPages, MAX_PAGE_BUTTONS);
+
+  return (
+    <div className="flex flex-wrap items-center justify-between gap-2 text-sm text-muted-foreground">
+      <div className="flex items-center gap-3">
+        <span>{t("total", { count: total })}</span>
+        <span className="text-xs">
+          {page} / {totalPages}
+        </span>
+      </div>
+      <div className="flex items-center gap-1">
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.max(1, page - 1))}
+          disabled={!canPrev}
+          aria-label={tCommon("button.prev")}
+        >
+          {tCommon("button.prev")}
+        </Button>
+        {pages.map((p, idx) =>
+          p === "..." ? (
+            <span
+              key={`gap-${idx}`}
+              className="px-2 text-xs text-muted-foreground"
+              aria-hidden="true"
+            >
+              …
+            </span>
+          ) : (
+            <Button
+              key={p}
+              variant={p === page ? "default" : "outline"}
+              size="sm"
+              onClick={() => onJump(p)}
+              aria-current={p === page ? "page" : undefined}
+            >
+              {p}
+            </Button>
+          ),
+        )}
+        <Button
+          variant="outline"
+          size="sm"
+          onClick={() => onJump(Math.min(totalPages, page + 1))}
+          disabled={!canNext}
+          aria-label={tCommon("button.next")}
+        >
+          {tCommon("button.next")}
+        </Button>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * 构造页码列表：当总页数不超过 maxButtons 时全部展示；
+ * 否则展示首尾页与当前页附近页码，省略位置用 "..." 占位。
+ */
+function buildPageList(
+  current: number,
+  total: number,
+  maxButtons: number,
+): Array<number | "..."> {
+  if (total <= maxButtons) {
+    return Array.from({ length: total }, (_, i) => i + 1);
+  }
+  const half = Math.floor(maxButtons / 2);
+  const start = Math.max(2, current - half + 1);
+  const end = Math.min(total - 1, start + maxButtons - 4);
+  const adjustedStart =
+    end - start < maxButtons - 4 ? Math.max(2, end - (maxButtons - 5)) : start;
+  const result: Array<number | "..."> = [1];
+  if (adjustedStart > 2) {
+    result.push("...");
+  }
+  for (let p = adjustedStart; p <= end; p += 1) {
+    result.push(p);
+  }
+  if (end < total - 1) {
+    result.push("...");
+  }
+  result.push(total);
+  return result;
+}
diff --git a/apps/portal-shell/src/features/admin/roles/_write-role-form-dialog.ps1 b/apps/portal-shell/src/features/admin/roles/_write-role-form-dialog.ps1
new file mode 100644
index 0000000..e69de29
diff --git a/apps/portal-shell/src/features/admin/roles/role-detail-client.tsx b/apps/portal-shell/src/features/admin/roles/role-detail-client.tsx
index 81eb929..998c8ab 100644
--- a/apps/portal-shell/src/features/admin/roles/role-detail-client.tsx
+++ b/apps/portal-shell/src/features/admin/roles/role-detail-client.tsx
@@ -19,6 +19,7 @@ import { useParams } from "next/navigation";
 import { useTranslations } from "next-intl";
 
 import { useRole, type RoleDetail } from "@/lib/api";
+import { RolePermissionMatrix } from "./role-permission-matrix";
 import {
   DetailPageShell,
   DetailPageSkeleton,
@@ -103,6 +104,15 @@ function RoleDetailBody({ role }: { role: RoleDetail }): React.ReactElement {
           <PermissionsMatrix permissions={role.permissions} />
         )}
       </DetailSection>
+
+      <DetailSection title={t("sectionPermissionMatrix")}>
+        <RolePermissionMatrix
+          roleId={role.id}
+          roleName={role.name}
+          isLocked={locked}
+          userCount={role.userCount}
+        />
+      </DetailSection>
     </>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/roles/role-form-dialog.tsx b/apps/portal-shell/src/features/admin/roles/role-form-dialog.tsx
new file mode 100644
index 0000000..62b1ec4
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/roles/role-form-dialog.tsx
@@ -0,0 +1,213 @@
+"use client";
+
+/**
+ * Role create/edit dialog - lightweight modal (ARCHITECTURE.md 9.4 / 10 P5)
+ *
+ * Features:
+ * - Create mode: new role, refresh list on submit
+ * - Edit mode: edit existing role name and description
+ * - Zod pattern validation for role name (^[a-z0-9_]+$)
+ * - Value field (optional human-readable label)
+ *
+ * Data contract:
+ * - mutation createRole / updateRole: schema pending -> MSW fallback (@contract-pending)
+ *
+ * Related: ARCHITECTURE.md 5.4 / 9.4 / 10 P5 / 11.3
+ */
+import { Shield } from "lucide-react";
+import { useRouter } from "next/navigation";
+import { useEffect, useState, type FormEvent } from "react";
+import { useTranslations } from "next-intl";
+import { z } from "zod";
+
+import { useCreateRole, useUpdateRole, type Role } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import { Label } from "@/shared/components/ui/label";
+import { Textarea } from "@/shared/components/ui/textarea";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { notify } from "@/shared/lib/notify";
+
+/** 角色名称 zod 校验：小写字母、数字、下划线，2-50 字符。 */
+const roleNameSchema = z
+  .string()
+  .min(2)
+  .max(50)
+  .regex(/^[a-z0-9_]+$/);
+
+export interface RoleFormDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  editRole?: Role | null;
+}
+
+export function RoleFormDialog({
+  open,
+  onOpenChange,
+  editRole,
+}: RoleFormDialogProps): React.ReactElement | null {
+  const t = useTranslations("admin.roles.createDialog");
+  const tCommon = useTranslations("common");
+  const router = useRouter();
+  const isEdit = Boolean(editRole);
+  const isLocked = editRole?.isLocked ?? false;
+
+  const { run: createRole, loading: creating } = useCreateRole();
+  const { run: updateRole, loading: updating } = useUpdateRole();
+
+  const [name, setName] = useState("");
+  const [value, setValue] = useState("");
+  const [description, setDescription] = useState("");
+  const [nameError, setNameError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (open) {
+      setName(editRole?.name ?? "");
+      setValue(editRole?.value ?? "");
+      setDescription(editRole?.description ?? "");
+      setNameError(null);
+    }
+  }, [open, editRole]);
+
+  const isWorking = creating || updating;
+
+  const handleClose = (): void => {
+    onOpenChange(false);
+  };
+
+  const handleSubmit = async (e: FormEvent<HTMLFormElement>): Promise<void> => {
+    e.preventDefault();
+    const trimmedName = name.trim();
+    if (!trimmedName) {
+      setNameError(t("errorNameRequired"));
+      return;
+    }
+    const nameValidation = roleNameSchema.safeParse(trimmedName);
+    if (!nameValidation.success) {
+      setNameError(t("errorNamePattern"));
+      return;
+    }
+    setNameError(null);
+
+    const trimmedValue = value.trim();
+    const input = {
+      name: trimmedName,
+      value: trimmedValue || undefined,
+      description: description.trim() || undefined,
+      permissionIds: editRole?.permissions?.map((p) => p.id) ?? [],
+    };
+
+    try {
+      if (isEdit && editRole) {
+        await updateRole(editRole.id, input);
+        notify.success(t("successUpdated"));
+      } else {
+        await createRole(input);
+        notify.success(t("successCreated"));
+      }
+      onOpenChange(false);
+      router.refresh();
+    } catch (err) {
+      notify.error(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  if (!open) {
+    return null;
+  }
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle className="flex items-center gap-2">
+            <Shield className="size-5 text-primary" />
+            {isEdit ? t("titleEdit") : t("titleCreate")}
+          </DialogTitle>
+          <DialogDescription>
+            {isEdit ? t("descriptionEdit") : t("descriptionCreate")}
+          </DialogDescription>
+        </DialogHeader>
+
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <div className="space-y-2">
+            <Label htmlFor="role-name">{t("fieldName")}</Label>
+            <Input
+              id="role-name"
+              value={name}
+              onChange={(e) => {
+                setName(e.target.value);
+                if (nameError) setNameError(null);
+              }}
+              placeholder={t("fieldNamePlaceholder")}
+              disabled={isLocked || isWorking}
+              required
+              minLength={2}
+              maxLength={50}
+              pattern="^[a-z0-9_]+$"
+              title={t("namePatternTitle")}
+              aria-invalid={nameError ? true : undefined}
+            />
+            {nameError ? (
+              <p className="text-xs text-destructive">{nameError}</p>
+            ) : null}
+            {isLocked ? (
+              <p className="text-xs text-muted-foreground">
+                {t("lockedNameNotice")}
+              </p>
+            ) : null}
+          </div>
+
+          <div className="space-y-2">
+            <Label htmlFor="role-value">{t("fieldValue")}</Label>
+            <Input
+              id="role-value"
+              value={value}
+              onChange={(e) => setValue(e.target.value)}
+              placeholder={t("fieldValuePlaceholder")}
+              disabled={isLocked || isWorking}
+              maxLength={100}
+            />
+          </div>
+
+          <div className="space-y-2">
+            <Label htmlFor="role-description">{t("fieldDescription")}</Label>
+            <Textarea
+              id="role-description"
+              value={description}
+              onChange={(e) => setDescription(e.target.value)}
+              placeholder={t("fieldDescriptionPlaceholder")}
+              disabled={isWorking}
+              maxLength={255}
+              rows={3}
+            />
+          </div>
+
+          <DialogFooter>
+            <Button
+              type="button"
+              variant="outline"
+              onClick={handleClose}
+              disabled={isWorking}
+            >
+              {t("cancel")}
+            </Button>
+            <Button type="submit" disabled={isWorking}>
+              {isWorking
+                ? t("submitting")
+                : isEdit
+                  ? t("submitEdit")
+                  : t("submitCreate")}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/roles/role-permission-matrix.tsx b/apps/portal-shell/src/features/admin/roles/role-permission-matrix.tsx
new file mode 100644
index 0000000..de2aee3
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/roles/role-permission-matrix.tsx
@@ -0,0 +1,348 @@
+"use client";
+
+/**
+ * Role permission matrix - CRUD actions per permission point (ARCHITECTURE.md 9.4 / 10 P5)
+ *
+ * Features:
+ * - Table with rows = permission points (grouped by module)
+ * - Columns = CRUD actions (read, create, update, delete)
+ * - Cells = checkboxes to toggle actions
+ * - Save button to persist changes
+ * - Locked roles are read-only
+ * - Search filter (by permission label / module)
+ * - Collapse/expand per module group
+ * - User-impact Alert when role has associated users
+ *
+ * Data contract:
+ * - query rolePermissions / mutation updateRolePermissionActions: schema pending -> MSW fallback (@contract-pending)
+ *
+ * Related: ARCHITECTURE.md 5.4 / 9.4 / 10 P5 / 11.3
+ */
+import {
+  AlertTriangle,
+  ChevronDown,
+  ChevronRight,
+  Lock,
+  Save,
+  Search,
+} from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import { useTranslations } from "next-intl";
+
+import {
+  useRolePermissions,
+  useUpdateRolePermissionActions,
+  type PermissionActions,
+  type RolePermissionMatrixItem,
+} from "@/lib/api";
+import { Alert, AlertDescription } from "@/shared/components/ui/alert";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import { notify } from "@/shared/lib/notify";
+
+export interface RolePermissionMatrixProps {
+  roleId: string;
+  roleName: string;
+  isLocked: boolean;
+  /** 关联用户数（用于展示用户影响 Alert，@contract-pending MSW 兜底） */
+  userCount?: number;
+}
+
+const ACTION_KEYS: Array<{ key: keyof PermissionActions; labelKey: string }> = [
+  { key: "read", labelKey: "actionRead" },
+  { key: "create", labelKey: "actionCreate" },
+  { key: "update", labelKey: "actionUpdate" },
+  { key: "delete", labelKey: "actionDelete" },
+];
+
+export function RolePermissionMatrix({
+  roleId,
+  roleName,
+  isLocked,
+  userCount,
+}: RolePermissionMatrixProps): React.ReactElement {
+  const t = useTranslations("admin.roles.matrix");
+  const tCommon = useTranslations("common");
+
+  const { data, loading, error } = useRolePermissions(roleId);
+  const { run: updateActions, loading: saving } =
+    useUpdateRolePermissionActions();
+
+  const [permissions, setPermissions] = useState<RolePermissionMatrixItem[]>(
+    [],
+  );
+  const [search, setSearch] = useState("");
+  const [collapsed, setCollapsed] = useState<Set<string>>(new Set());
+
+  useEffect(() => {
+    setPermissions(data ?? []);
+  }, [data]);
+
+  // 搜索过滤：按权限点 label 或 module 命中（大小写不敏感）
+  const filteredPermissions = useMemo<RolePermissionMatrixItem[]>(() => {
+    const q = search.trim().toLowerCase();
+    if (!q) return permissions;
+    return permissions.filter((p) => {
+      if (p.label.toLowerCase().includes(q)) return true;
+      if (p.module.toLowerCase().includes(q)) return true;
+      return false;
+    });
+  }, [permissions, search]);
+
+  const grouped = useMemo(
+    () => groupByModule(filteredPermissions),
+    [filteredPermissions],
+  );
+
+  const hasChanges = useMemo(
+    () => JSON.stringify(permissions) !== JSON.stringify(data ?? []),
+    [permissions, data],
+  );
+
+  const handleToggle = (
+    permissionId: string,
+    action: keyof PermissionActions,
+  ): void => {
+    setPermissions((prev) =>
+      prev.map((p) => {
+        if (p.permissionId !== permissionId) return p;
+        return {
+          ...p,
+          actions: {
+            ...p.actions,
+            [action]: !p.actions[action],
+          },
+        };
+      }),
+    );
+  };
+
+  const handleToggleCollapse = (module: string): void => {
+    setCollapsed((prev) => {
+      const next = new Set(prev);
+      if (next.has(module)) {
+        next.delete(module);
+      } else {
+        next.add(module);
+      }
+      return next;
+    });
+  };
+
+  const handleSave = async (): Promise<void> => {
+    try {
+      await updateActions(
+        roleId,
+        permissions.map((p) => ({
+          permissionId: p.permissionId,
+          actions: p.actions,
+        })),
+      );
+      notify.success(t("successSaved"));
+    } catch (err) {
+      notify.error(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="rounded-xl border p-6">
+        <p className="text-sm text-muted-foreground">{t("loading")}</p>
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
+        <p className="text-sm text-destructive">
+          {tCommon("error.loadFailed", { message: String(error) })}
+        </p>
+      </div>
+    );
+  }
+
+  if (permissions.length === 0) {
+    return (
+      <div className="rounded-xl border p-6 text-center">
+        <p className="text-sm text-muted-foreground">{t("empty")}</p>
+      </div>
+    );
+  }
+
+  const showUserImpactAlert = !isLocked && (userCount ?? 0) > 0;
+
+  return (
+    <div className="space-y-4">
+      <div className="flex flex-wrap items-center justify-between gap-2">
+        <div className="flex items-center gap-2">
+          <h3 className="text-base font-semibold">
+            {t("title", { roleName })}
+          </h3>
+          {isLocked ? (
+            <Badge variant="secondary">
+              <Lock className="mr-1 size-3" />
+              {t("locked")}
+            </Badge>
+          ) : null}
+          <Badge variant="outline">
+            {t("permissionCount", { count: permissions.length })}
+          </Badge>
+        </div>
+        {!isLocked ? (
+          <Button
+            onClick={handleSave}
+            disabled={!hasChanges || saving}
+            size="sm"
+          >
+            <Save className="size-4" />
+            {saving ? t("saving") : t("save")}
+          </Button>
+        ) : null}
+      </div>
+
+      {showUserImpactAlert ? (
+        <Alert className="border-amber-500/50 bg-amber-500/10 text-amber-700 dark:text-amber-400">
+          <AlertTriangle className="size-4" />
+          <AlertDescription>
+            {t("userImpactNotice", { count: userCount ?? 0 })}
+          </AlertDescription>
+        </Alert>
+      ) : null}
+
+      <div className="relative">
+        <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+        <Input
+          type="search"
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          placeholder={t("searchPlaceholder")}
+          className="pl-9"
+          aria-label={t("searchPlaceholder")}
+        />
+      </div>
+
+      <div className="overflow-x-auto rounded-xl border">
+        <table className="w-full text-sm">
+          <thead className="border-b bg-muted/30">
+            <tr>
+              <th className="p-3 text-left font-medium">
+                {t("colPermission")}
+              </th>
+              {ACTION_KEYS.map((action) => (
+                <th key={action.key} className="p-3 text-center font-medium">
+                  {t(action.labelKey)}
+                </th>
+              ))}
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {grouped.size === 0 ? (
+              <tr>
+                <td
+                  colSpan={ACTION_KEYS.length + 1}
+                  className="p-6 text-center text-sm text-muted-foreground"
+                >
+                  {tCommon("empty.searchResult")}
+                </td>
+              </tr>
+            ) : (
+              Array.from(grouped.entries()).map(([module, perms]) => (
+                <MatrixGroup
+                  key={module}
+                  module={module}
+                  permissions={perms}
+                  isLocked={isLocked}
+                  isCollapsed={collapsed.has(module)}
+                  onToggleCollapse={handleToggleCollapse}
+                  onToggle={handleToggle}
+                />
+              ))
+            )}
+          </tbody>
+        </table>
+      </div>
+    </div>
+  );
+}
+
+/**
+ * Matrix group - renders a collapsible module header row and permission rows.
+ */
+function MatrixGroup({
+  module,
+  permissions,
+  isLocked,
+  isCollapsed,
+  onToggleCollapse,
+  onToggle,
+}: {
+  module: string;
+  permissions: RolePermissionMatrixItem[];
+  isLocked: boolean;
+  isCollapsed: boolean;
+  onToggleCollapse: (module: string) => void;
+  onToggle: (permissionId: string, action: keyof PermissionActions) => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.roles.matrix");
+  return (
+    <>
+      <tr className="bg-muted/20">
+        <td colSpan={5} className="p-0">
+          <button
+            type="button"
+            onClick={() => onToggleCollapse(module)}
+            className="flex w-full items-center gap-2 px-3 py-2 text-left text-xs font-semibold uppercase text-muted-foreground hover:bg-muted/40"
+            aria-expanded={!isCollapsed}
+            aria-label={isCollapsed ? t("expand") : t("collapse")}
+          >
+            {isCollapsed ? (
+              <ChevronRight className="size-3.5" />
+            ) : (
+              <ChevronDown className="size-3.5" />
+            )}
+            {t("moduleLabel", { module })}
+            <Badge variant="outline" className="ml-1">
+              {permissions.length}
+            </Badge>
+          </button>
+        </td>
+      </tr>
+      {!isCollapsed
+        ? permissions.map((perm) => (
+            <tr key={perm.permissionId} className="hover:bg-muted/30">
+              <td className="p-3">{perm.label}</td>
+              {ACTION_KEYS.map((action) => (
+                <td key={action.key} className="p-3 text-center">
+                  <input
+                    type="checkbox"
+                    checked={perm.actions[action.key]}
+                    onChange={() => onToggle(perm.permissionId, action.key)}
+                    disabled={isLocked}
+                    className="size-4 rounded border-input accent-primary"
+                    aria-label={`${perm.label} ${t(action.labelKey)}`}
+                  />
+                </td>
+              ))}
+            </tr>
+          ))
+        : null}
+    </>
+  );
+}
+
+/**
+ * Group permissions by module.
+ */
+function groupByModule(
+  permissions: RolePermissionMatrixItem[],
+): Map<string, RolePermissionMatrixItem[]> {
+  const groups = new Map<string, RolePermissionMatrixItem[]>();
+  for (const perm of permissions) {
+    const group = groups.get(perm.module) ?? [];
+    group.push(perm);
+    groups.set(perm.module, group);
+  }
+  return groups;
+}
diff --git a/apps/portal-shell/src/features/admin/roles/roles-list-client.tsx b/apps/portal-shell/src/features/admin/roles/roles-list-client.tsx
index 5245641..4c28162 100644
--- a/apps/portal-shell/src/features/admin/roles/roles-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/roles/roles-list-client.tsx
@@ -13,13 +13,23 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { ShieldCheck } from "lucide-react";
+import { Plus, Power, Shield, ShieldCheck, Trash2 } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
-import { useRoles, type Role } from "@/lib/api";
+import {
+  useDeleteRole,
+  useRoles,
+  useToggleRoleEnabled,
+  type Role,
+} from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import { RoleFormDialog } from "./role-form-dialog";
+import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import {
@@ -29,12 +39,15 @@ import {
 import {
   countRolePermissions,
   formatPermissionCount,
+  formatRoleDate,
   formatRoleDescription,
   isRoleLocked,
-  lockedToBadgeClass,
   matchRoleSearch,
 } from "@/features/admin/roles/transformations";
 
+/** 新建角色 URL 参数标记 */
+const NEW_ROLE_PARAM = "new";
+
 /**
  * 列表客户端主体。需由 server page 包裹在 <Suspense> 中
  * （useSearchParams 要求 Suspense 边界，Next.js 15 强制）。
@@ -45,6 +58,83 @@ export function RolesListClient(): React.ReactElement {
   const router = useRouter();
   const searchParams = useSearchParams();
   const [, startTransition] = useTransition();
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [editRole, setEditRole] = useState<Role | null>(null);
+  const [deleteTarget, setDeleteTarget] = useState<Role | null>(null);
+  const [pendingId, setPendingId] = useState<string | null>(null);
+
+  const deleteRole = useDeleteRole();
+  const toggleRoleEnabled = useToggleRoleEnabled();
+
+  const handleEdit = (role: Role): void => {
+    setEditRole(role);
+    setDialogOpen(true);
+  };
+
+  const handleDelete = async (): Promise<void> => {
+    if (!deleteTarget) return;
+    setPendingId(deleteTarget.id);
+    try {
+      await deleteRole.run(deleteTarget.id);
+      notify.success(t("list.deleted"));
+      setDeleteTarget(null);
+      router.refresh();
+    } catch (e) {
+      notify.error(String(e));
+    } finally {
+      setPendingId(null);
+    }
+  };
+
+  const handleToggleEnabled = async (role: Role): Promise<void> => {
+    if (isRoleLocked(role)) {
+      notify.warning(t("list.lockedRoleToggleWarn"));
+      return;
+    }
+    const nextEnabled = !(role.isEnabled ?? true);
+    setPendingId(role.id);
+    try {
+      await toggleRoleEnabled.run(role.id, nextEnabled);
+      notify.success(
+        nextEnabled ? t("list.enabledSuccess") : t("list.disabledSuccess"),
+      );
+      router.refresh();
+    } catch (e) {
+      notify.error(String(e));
+    } finally {
+      setPendingId(null);
+    }
+  };
+
+  // ?new=1 时自动打开创建对话框
+  useEffect(() => {
+    if (searchParams.get(NEW_ROLE_PARAM) === "1" && !dialogOpen) {
+      setEditRole(null);
+      setDialogOpen(true);
+    }
+    // 仅在 new 参数首次进入时触发
+  }, [searchParams]);
+
+  const handleDialogOpenChange = (open: boolean): void => {
+    setDialogOpen(open);
+    if (!open) {
+      // 关闭对话框时清理 URL 上的 new 参数
+      const params = new URLSearchParams(searchParams.toString());
+      if (params.has(NEW_ROLE_PARAM)) {
+        params.delete(NEW_ROLE_PARAM);
+        startTransition(() => {
+          const qs = params.toString();
+          router.push(qs ? `/shell/admin/roles?${qs}` : "/shell/admin/roles");
+        });
+      }
+    }
+  };
+
+  const triggerCreateViaUrl = (): void => {
+    startTransition(() => {
+      router.push("/shell/admin/roles?new=1");
+    });
+  };
 
   const search = searchParams.get("search") ?? "";
 
@@ -86,55 +176,111 @@ export function RolesListClient(): React.ReactElement {
       description={t("list.emptyDescription")}
       action={{
         label: t("list.emptyAction"),
-        // 新建功能未开放，指向当前页占位（避免死链）
-        href: "/shell/admin/roles",
+        // 通过 URL 参数触发对话框打开，保证状态可被分享/刷新
+        onClick: triggerCreateViaUrl,
       }}
     />
   );
 
   return (
-    <ListPageShell
-      title={t("list.title")}
-      description={t("list.description")}
-      icon={<ShieldCheck className="size-6" />}
-      filters={
-        <FilterSearchInput
-          placeholder={t("list.searchPlaceholder")}
-          value={search}
-          onChange={(v) => updateQuery("search", v)}
+    <>
+      <ListPageShell
+        title={t("list.title")}
+        description={t("list.description")}
+        icon={<ShieldCheck className="size-6" />}
+        actions={
+          <>
+            <Badge variant="secondary" className="tabular-nums">
+              {t("list.totalBadge", { count: data?.length ?? 0 })}
+            </Badge>
+            <Button onClick={triggerCreateViaUrl} size="sm">
+              <Plus className="size-4" />
+              {t("list.createButton")}
+            </Button>
+          </>
+        }
+        filters={
+          <FilterSearchInput
+            placeholder={t("list.searchPlaceholder")}
+            value={search}
+            onChange={(v) => updateQuery("search", v)}
+          />
+        }
+        loading={loading}
+        loadingNode={<ListPageSkeleton rows={5} />}
+        empty={filteredItems.length === 0 && !loading}
+        emptyNode={emptyNode}
+        errorNode={errorNode}
+      >
+        <RolesTable
+          items={filteredItems}
+          onEdit={handleEdit}
+          onDelete={(r) => setDeleteTarget(r)}
+          onToggleEnabled={handleToggleEnabled}
+          pendingId={pendingId}
         />
-      }
-      loading={loading}
-      loadingNode={<ListPageSkeleton rows={5} />}
-      empty={filteredItems.length === 0 && !loading}
-      emptyNode={emptyNode}
-      errorNode={errorNode}
-    >
-      <RolesTable items={filteredItems} />
-    </ListPageShell>
+      </ListPageShell>
+      <RoleFormDialog
+        open={dialogOpen}
+        onOpenChange={handleDialogOpenChange}
+        editRole={editRole}
+      />
+      <ConfirmDeleteDialog
+        open={!!deleteTarget}
+        onOpenChange={(v) => !v && setDeleteTarget(null)}
+        title={t("list.deleteConfirmTitle")}
+        description={t("list.deleteConfirmDescription", {
+          name: deleteTarget?.name ?? "",
+          count: deleteTarget?.userCount ?? 0,
+        })}
+        confirmText={t("list.confirmDelete")}
+        cancelText={tCommon("button.cancel")}
+        onConfirm={handleDelete}
+        isWorking={pendingId === deleteTarget?.id}
+      />
+    </>
   );
 }
 
 /**
  * 角色列表表格（纯展示组件，对齐 §8.2 排版规范）。
  */
-function RolesTable({ items }: { items: Role[] }): React.ReactElement {
+function RolesTable({
+  items,
+  onEdit,
+  onDelete,
+  onToggleEnabled,
+  pendingId,
+}: {
+  items: Role[];
+  onEdit: (role: Role) => void;
+  onDelete: (role: Role) => void;
+  onToggleEnabled: (role: Role) => void;
+  pendingId: string | null;
+}): React.ReactElement {
   const t = useTranslations("admin.roles");
   return (
     <div className="overflow-x-auto rounded-xl border">
       <table className="w-full text-sm">
+        <caption className="sr-only">{t("list.tableCaption")}</caption>
         <thead className="border-b bg-muted/30">
           <tr>
             <th className="p-3 text-left font-medium">{t("list.colName")}</th>
+            <th className="p-3 text-left font-medium">{t("list.colValue")}</th>
             <th className="p-3 text-left font-medium">
               {t("list.colDescription")}
             </th>
+            <th className="p-3 text-left font-medium">{t("list.colType")}</th>
+            <th className="p-3 text-left font-medium">{t("list.colStatus")}</th>
             <th className="p-3 text-left font-medium">
-              {t("list.colIsLocked")}
+              {t("list.colUserCount")}
             </th>
             <th className="p-3 text-left font-medium">
               {t("list.colPermissions")}
             </th>
+            <th className="p-3 text-left font-medium">
+              {t("list.colUpdatedAt")}
+            </th>
             <th className="p-3 text-left font-medium">
               {t("list.colActions")}
             </th>
@@ -144,18 +290,32 @@ function RolesTable({ items }: { items: Role[] }): React.ReactElement {
           {items.map((r) => {
             const locked = isRoleLocked(r);
             const permCount = countRolePermissions(r);
+            const enabled = r.isEnabled ?? true;
+            const userCount = r.userCount ?? 0;
             return (
               <tr key={r.id} className="hover:bg-muted/30">
                 <td className="p-3 font-medium">{r.name}</td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {r.value ?? "--"}
+                </td>
                 <td className="p-3 text-muted-foreground">
                   {formatRoleDescription(r.description)}
                 </td>
                 <td className="p-3">
-                  <LockedBadge locked={locked} />
+                  <TypeBadge locked={locked} />
+                </td>
+                <td className="p-3">
+                  <EnabledBadge enabled={enabled} />
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {t("list.userCountValue", { count: userCount })}
                 </td>
                 <td className="p-3 font-mono text-xs text-muted-foreground">
                   {formatPermissionCount(permCount)}
                 </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {formatRoleDate(r.updatedAt)}
+                </td>
                 <td className="p-3">
                   <div className="flex items-center gap-2">
                     <Link
@@ -164,12 +324,43 @@ function RolesTable({ items }: { items: Role[] }): React.ReactElement {
                     >
                       {t("list.viewDetail")}
                     </Link>
-                    <Link
-                      href={`/shell/admin/roles/${r.id}`}
+                    <button
+                      type="button"
+                      onClick={() => onEdit(r)}
                       className="inline-flex h-8 items-center rounded-md border border-input bg-background px-2 text-xs transition-colors hover:bg-accent"
                     >
-                      {t("list.editPermissions")}
-                    </Link>
+                      {t("list.editRole")}
+                    </button>
+                    <button
+                      type="button"
+                      onClick={() => onToggleEnabled(r)}
+                      disabled={locked || pendingId === r.id}
+                      aria-label={
+                        enabled ? t("list.disableRole") : t("list.enableRole")
+                      }
+                      title={
+                        locked
+                          ? t("list.lockedRole")
+                          : enabled
+                            ? t("list.disableRole")
+                            : t("list.enableRole")
+                      }
+                      className="inline-flex h-8 items-center rounded-md border border-input bg-background px-2 text-xs transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-40"
+                    >
+                      <Power className="size-3.5" />
+                    </button>
+                    <button
+                      type="button"
+                      onClick={() => onDelete(r)}
+                      disabled={locked || pendingId === r.id}
+                      aria-label={t("list.deleteRole")}
+                      title={
+                        locked ? t("list.lockedRole") : t("list.deleteRole")
+                      }
+                      className="inline-flex h-8 items-center rounded-md border border-input bg-background px-2 text-xs text-destructive transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-40"
+                    >
+                      <Trash2 className="size-3.5" />
+                    </button>
                   </div>
                 </td>
               </tr>
@@ -182,16 +373,39 @@ function RolesTable({ items }: { items: Role[] }): React.ReactElement {
 }
 
 /**
- * 系统锁定徽章。
+ * 类型徽章：系统角色显示 ShieldCheck 实心徽章，自定义角色显示 Shield 轮廓徽章。
  */
-function LockedBadge({ locked }: { locked: boolean }): React.ReactElement {
+function TypeBadge({ locked }: { locked: boolean }): React.ReactElement {
   const t = useTranslations("admin.roles");
-  const cls = lockedToBadgeClass(locked);
+  if (locked) {
+    return (
+      <span className="inline-flex h-6 items-center gap-1 rounded-full bg-amber-500/10 px-2 text-xs font-medium text-amber-600 dark:text-amber-400">
+        <ShieldCheck className="size-3" />
+        {t("list.typeSystem")}
+      </span>
+    );
+  }
+  return (
+    <span className="inline-flex h-6 items-center gap-1 rounded-full border border-input px-2 text-xs font-medium text-muted-foreground">
+      <Shield className="size-3" />
+      {t("list.typeCustom")}
+    </span>
+  );
+}
+
+/**
+ * 启用/停用状态徽章。
+ */
+function EnabledBadge({ enabled }: { enabled: boolean }): React.ReactElement {
+  const t = useTranslations("admin.roles");
+  const cls = enabled
+    ? "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400"
+    : "bg-muted text-muted-foreground";
   return (
     <span
       className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${cls}`}
     >
-      {locked ? t("list.lockedRole") : "--"}
+      {enabled ? t("list.enabled") : t("list.disabled")}
     </span>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/roles/transformations.ts b/apps/portal-shell/src/features/admin/roles/transformations.ts
index 5ce688e..0f03606 100644
--- a/apps/portal-shell/src/features/admin/roles/transformations.ts
+++ b/apps/portal-shell/src/features/admin/roles/transformations.ts
@@ -95,6 +95,23 @@ export function formatRoleDescription(
   return description;
 }
 
+/**
+ * 格式化角色更新时间 ISO 字符串为本地化展示（zh-CN，含年月日时分）。
+ * 输入无效时返回占位符。
+ */
+export function formatRoleDate(isoDate: string | null | undefined): string {
+  if (!isoDate) return "--";
+  const d = new Date(isoDate);
+  if (Number.isNaN(d.getTime())) return "--";
+  return d.toLocaleString("zh-CN", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
 /**
  * 模糊匹配角色搜索关键字（按 name / description 命中，大小写不敏感）。
  * 关键字为空时返回 true。
diff --git a/apps/portal-shell/src/features/admin/school/academic-year-client.tsx b/apps/portal-shell/src/features/admin/school/academic-year-client.tsx
index fe9107b..70e5f2f 100644
--- a/apps/portal-shell/src/features/admin/school/academic-year-client.tsx
+++ b/apps/portal-shell/src/features/admin/school/academic-year-client.tsx
@@ -13,7 +13,7 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { Calendar, Pencil, Plus, Trash2 } from "lucide-react";
+import { Calendar, CheckCircle2, Pencil, Plus, Trash2 } from "lucide-react";
 import { useSearchParams, useRouter } from "next/navigation";
 import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
@@ -29,7 +29,23 @@ import {
   type SchoolListItem,
 } from "@/lib/api";
 import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
 import { Button } from "@/shared/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/components/ui/card";
+import { Checkbox } from "@/shared/components/ui/checkbox";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import { Input } from "@/shared/components/ui/input";
@@ -37,6 +53,14 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/shared/components/ui/table";
 import {
   activeToBadgeClass,
   formatSchoolDay,
@@ -207,15 +231,21 @@ export function AcademicYearClient(): React.ReactElement {
         </div>
       }
     >
-      <AcademicYearTable
-        items={filteredItems}
-        schoolNameMap={schoolNameMap}
-        onEdit={(y) => {
-          setEditTarget(y);
-          setFormOpen(true);
-        }}
-        onDelete={(y) => setDeleteTarget(y)}
-      />
+      <div className="grid gap-6 lg:grid-cols-3">
+        <ActiveYearSidebarCard
+          items={filteredItems}
+          schoolNameMap={schoolNameMap}
+        />
+        <AcademicYearTableCard
+          items={filteredItems}
+          schoolNameMap={schoolNameMap}
+          onEdit={(y) => {
+            setEditTarget(y);
+            setFormOpen(true);
+          }}
+          onDelete={(y) => setDeleteTarget(y)}
+        />
+      </div>
       {formOpen ? (
         <AcademicYearFormDialog
           editTarget={editTarget}
@@ -244,9 +274,114 @@ export function AcademicYearClient(): React.ReactElement {
 }
 
 /**
- * 学年列表表格。
+ * 当前激活学年的侧栏卡片（lg:col-span-1）。
+ * 若列表中存在 isActive=true 的项则展示该卡片，
+ * 否则展示"暂无激活学年"的空态提示。
  */
-function AcademicYearTable({
+function ActiveYearSidebarCard({
+  items,
+  schoolNameMap,
+}: {
+  items: AcademicYear[];
+  schoolNameMap: Map<string, string>;
+}): React.ReactElement {
+  const t = useTranslations("admin.school.academicYear");
+  const activeYear = items.find((y) => y.isActive) ?? null;
+
+  if (!activeYear) {
+    return (
+      <Card className="lg:col-span-1 shadow-none">
+        <CardHeader className="flex flex-row items-center justify-between space-y-0">
+          <div className="space-y-1">
+            <CardTitle className="text-base">
+              {t("activeYearCardTitle")}
+            </CardTitle>
+            <CardDescription>{t("activeYearCardDescription")}</CardDescription>
+          </div>
+          <CheckCircle2
+            className="size-5 text-muted-foreground"
+            aria-hidden="true"
+          />
+        </CardHeader>
+        <CardContent>
+          <p className="py-2 text-sm text-muted-foreground">
+            {t("activeYearCardEmpty")}
+          </p>
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card className="lg:col-span-1 shadow-none">
+      <CardHeader className="flex flex-row items-center justify-between space-y-0">
+        <div className="space-y-1">
+          <CardTitle className="text-base">
+            {t("activeYearCardTitle")}
+          </CardTitle>
+          <CardDescription>{t("activeYearCardDescription")}</CardDescription>
+        </div>
+        <CheckCircle2
+          className="size-5 text-emerald-600 dark:text-emerald-400"
+          aria-hidden="true"
+        />
+      </CardHeader>
+      <CardContent>
+        <div className="space-y-3">
+          <div className="space-y-1">
+            <div className="text-xs text-muted-foreground">{t("colName")}</div>
+            <div className="text-lg font-semibold">
+              {truncateText(activeYear.name)}
+            </div>
+          </div>
+          <div className="space-y-1">
+            <div className="text-xs text-muted-foreground">
+              {t("colSchool")}
+            </div>
+            <div className="text-sm text-muted-foreground">
+              {schoolNameMap.get(activeYear.schoolId) ?? activeYear.schoolId}
+            </div>
+          </div>
+          <div className="grid grid-cols-2 gap-3">
+            <div className="space-y-1">
+              <div className="text-xs text-muted-foreground">
+                {t("colStartDate")}
+              </div>
+              <div className="font-mono text-xs text-muted-foreground">
+                {formatSchoolDay(activeYear.startDate)}
+              </div>
+            </div>
+            <div className="space-y-1">
+              <div className="text-xs text-muted-foreground">
+                {t("colEndDate")}
+              </div>
+              <div className="font-mono text-xs text-muted-foreground">
+                {formatSchoolDay(activeYear.endDate)}
+              </div>
+            </div>
+          </div>
+          <div>
+            <Badge
+              variant={activeYear.isActive ? "secondary" : "outline"}
+              className={
+                activeYear.isActive
+                  ? activeToBadgeClass(activeYear.isActive)
+                  : ""
+              }
+            >
+              {activeYear.isActive ? t("active") : t("inactive")}
+            </Badge>
+          </div>
+        </div>
+      </CardContent>
+    </Card>
+  );
+}
+
+/**
+ * 学年列表表格卡片（lg:col-span-2），与侧栏激活学年卡片并排展示。
+ */
+function AcademicYearTableCard({
   items,
   schoolNameMap,
   onEdit,
@@ -259,65 +394,85 @@ function AcademicYearTable({
 }): React.ReactElement {
   const t = useTranslations("admin.school.academicYear");
   return (
-    <div className="overflow-x-auto rounded-xl border">
-      <table className="w-full text-sm">
-        <thead className="border-b bg-muted/30">
-          <tr>
-            <th className="p-3 text-left font-medium">{t("colName")}</th>
-            <th className="p-3 text-left font-medium">{t("colSchool")}</th>
-            <th className="p-3 text-left font-medium">{t("colStartDate")}</th>
-            <th className="p-3 text-left font-medium">{t("colEndDate")}</th>
-            <th className="p-3 text-left font-medium">{t("colIsActive")}</th>
-            <th className="p-3 text-right font-medium">{t("colActions")}</th>
-          </tr>
-        </thead>
-        <tbody className="divide-y">
-          {items.map((y) => (
-            <tr key={y.id} className="hover:bg-muted/30">
-              <td className="p-3 font-medium">{truncateText(y.name)}</td>
-              <td className="p-3 text-muted-foreground">
-                {schoolNameMap.get(y.schoolId) ?? y.schoolId}
-              </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatSchoolDay(y.startDate)}
-              </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatSchoolDay(y.endDate)}
-              </td>
-              <td className="p-3">
-                <span
-                  className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${activeToBadgeClass(
-                    y.isActive,
-                  )}`}
-                >
-                  {y.isActive ? t("active") : t("inactive")}
-                </span>
-              </td>
-              <td className="p-3 text-right">
-                <div className="flex justify-end gap-1">
-                  <Button
-                    variant="ghost"
-                    size="sm"
-                    onClick={() => onEdit(y)}
-                    aria-label={t("edit")}
-                  >
-                    <Pencil className="size-4" />
-                  </Button>
-                  <Button
-                    variant="ghost"
-                    size="sm"
-                    onClick={() => onDelete(y)}
-                    aria-label={t("delete")}
-                  >
-                    <Trash2 className="size-4" />
-                  </Button>
-                </div>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-    </div>
+    <Card className="lg:col-span-2 shadow-none">
+      <CardHeader className="flex flex-row items-center justify-between space-y-0">
+        <CardTitle className="text-base">{t("title")}</CardTitle>
+        <Badge variant="secondary" className="tabular-nums">
+          {items.length}
+        </Badge>
+      </CardHeader>
+      <CardContent>
+        {items.length === 0 ? (
+          <p className="py-6 text-center text-sm text-muted-foreground">
+            {t("emptyTitle")}
+          </p>
+        ) : (
+          <div className="overflow-x-auto rounded-md border">
+            <Table>
+              <TableHeader>
+                <TableRow className="bg-muted/50">
+                  <TableHead>{t("colName")}</TableHead>
+                  <TableHead>{t("colSchool")}</TableHead>
+                  <TableHead>{t("colStartDate")}</TableHead>
+                  <TableHead>{t("colEndDate")}</TableHead>
+                  <TableHead>{t("colIsActive")}</TableHead>
+                  <TableHead className="text-right">
+                    {t("colActions")}
+                  </TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {items.map((y) => (
+                  <TableRow key={y.id}>
+                    <TableCell className="font-medium">
+                      {truncateText(y.name)}
+                    </TableCell>
+                    <TableCell className="text-muted-foreground">
+                      {schoolNameMap.get(y.schoolId) ?? y.schoolId}
+                    </TableCell>
+                    <TableCell className="font-mono text-xs text-muted-foreground">
+                      {formatSchoolDay(y.startDate)}
+                    </TableCell>
+                    <TableCell className="font-mono text-xs text-muted-foreground">
+                      {formatSchoolDay(y.endDate)}
+                    </TableCell>
+                    <TableCell>
+                      <span
+                        className={`inline-flex h-6 items-center rounded-full px-2 text-xs font-medium ${activeToBadgeClass(
+                          y.isActive,
+                        )}`}
+                      >
+                        {y.isActive ? t("active") : t("inactive")}
+                      </span>
+                    </TableCell>
+                    <TableCell className="text-right">
+                      <div className="flex justify-end gap-1">
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => onEdit(y)}
+                          aria-label={t("edit")}
+                        >
+                          <Pencil className="size-4" />
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => onDelete(y)}
+                          aria-label={t("delete")}
+                        >
+                          <Trash2 className="size-4" />
+                        </Button>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+        )}
+      </CardContent>
+    </Card>
   );
 }
 
@@ -373,17 +528,13 @@ function AcademicYearFormDialog({
   };
 
   return (
-    <div
-      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
-      onClick={onClose}
-    >
-      <div
-        className="w-full max-w-md rounded-xl border bg-background p-6 shadow-lg"
-        onClick={(e) => e.stopPropagation()}
-      >
-        <h2 className="mb-4 text-lg font-semibold">
-          {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
-        </h2>
+    <Dialog open onOpenChange={onClose}>
+      <DialogContent className="max-w-md">
+        <DialogHeader>
+          <DialogTitle>
+            {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
+          </DialogTitle>
+        </DialogHeader>
         <form onSubmit={handleSubmit} className="space-y-4">
           <FormField label={t("form.fieldName")} required>
             <Input
@@ -425,23 +576,27 @@ function AcademicYearFormDialog({
             />
           </FormField>
           <FormField label={t("form.fieldIsActive")}>
-            <input
-              type="checkbox"
-              checked={isActive}
-              onChange={(e) => setIsActive(e.target.checked)}
-              className="size-4 cursor-pointer"
-            />
+            <label className="flex items-center gap-2 text-sm">
+              <Checkbox
+                checked={isActive}
+                onCheckedChange={(checked) => setIsActive(checked)}
+                aria-label={t("form.fieldIsActive")}
+              />
+              <span className="text-muted-foreground">
+                {t("form.fieldIsActiveHint")}
+              </span>
+            </label>
           </FormField>
-          <div className="flex justify-end gap-2">
+          <DialogFooter>
             <Button type="button" variant="outline" onClick={onClose}>
               {t("form.cancel")}
             </Button>
             <Button type="submit" disabled={loading}>
               {t("form.submit")}
             </Button>
-          </div>
+          </DialogFooter>
         </form>
-      </div>
-    </div>
+      </DialogContent>
+    </Dialog>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/school/admin-classes-client.tsx b/apps/portal-shell/src/features/admin/school/admin-classes-client.tsx
index a708825..ff793de 100644
--- a/apps/portal-shell/src/features/admin/school/admin-classes-client.tsx
+++ b/apps/portal-shell/src/features/admin/school/admin-classes-client.tsx
@@ -6,6 +6,7 @@
  * 数据契约：
  * - 列表查询 adminClasses()：❌ schema 无 → MSW 兜底（@contract-pending）
  * - 班级 CRUD 契约未就绪，本页为只读列表（@contract-pending）
+ * - 课表 CRUD / 邀请码管理：❌ schema 无 → MSW 兜底（@contract-pending）
  *
  * URL 状态：?schoolId=&gradeId=&q=
  *
@@ -13,24 +14,49 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { School } from "lucide-react";
+import { Calendar, Pencil, Plus, School, Ticket, Trash2 } from "lucide-react";
 import { useSearchParams, useRouter } from "next/navigation";
-import { useMemo, useTransition } from "react";
+import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
   useAdminClasses,
+  useCreateAdminClass,
+  useDeleteAdminClass,
+  useUpdateAdminClass,
   useGrades,
   useSchools,
+  useTeacherOptions,
+  type AdminClassInput,
   type AdminClassListItem,
+  type SchoolListItem,
 } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
+import { Input } from "@/shared/components/ui/input";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { truncateText } from "@/features/admin/school/transformations";
+import {
+  formatSchoolDate,
+  truncateText,
+} from "@/features/admin/school/transformations";
+import {
+  DeleteConfirmDialog,
+  FormField,
+} from "@/features/admin/school/schools-client";
+import { ScheduleManagerDialog } from "@/features/admin/school/class-schedule-dialog";
+import { ClassInvitationManagerDialog } from "@/features/admin/school/class-invitation-manager";
 
 /**
  * 班级列表客户端主体。需由 server page 包裹在 <Suspense> 中
@@ -48,9 +74,32 @@ export function AdminClassesClient(): React.ReactElement {
   const gradeId = searchParams.get("gradeId") ?? "";
 
   // @contract-pending：MSW 兜底
-  const { data, loading, error } = useAdminClasses();
+  const { data, loading, error, refetch } = useAdminClasses();
   const { data: schools } = useSchools();
   const { data: grades } = useGrades();
+  const { data: teacherOptions } = useTeacherOptions();
+  const createMutation = useCreateAdminClass();
+  const updateMutation = useUpdateAdminClass();
+  const deleteMutation = useDeleteAdminClass();
+
+  // 课表管理 / 邀请码管理 / 新建编辑 / 删除对话框状态
+  const [scheduleTarget, setScheduleTarget] =
+    useState<AdminClassListItem | null>(null);
+  const [invitationTarget, setInvitationTarget] =
+    useState<AdminClassListItem | null>(null);
+  const [formOpen, setFormOpen] = useState(false);
+  const [editTarget, setEditTarget] = useState<AdminClassListItem | null>(null);
+  const [deleteTarget, setDeleteTarget] = useState<AdminClassListItem | null>(
+    null,
+  );
+
+  const teacherNameMap = useMemo<Map<string, string>>(() => {
+    const map = new Map<string, string>();
+    for (const t of teacherOptions ?? []) {
+      map.set(t.id, t.name);
+    }
+    return map;
+  }, [teacherOptions]);
 
   const filteredItems = useMemo<AdminClassListItem[]>(() => {
     const items = data ?? [];
@@ -59,16 +108,18 @@ export function AdminClassesClient(): React.ReactElement {
       if (gradeId && c.gradeId !== gradeId) return false;
       if (q) {
         const lower = q.toLowerCase();
+        const headTeacherName =
+          teacherNameMap.get(c.headTeacherId) ?? c.headTeacherName;
         if (
           !c.name.toLowerCase().includes(lower) &&
-          !c.headTeacherName.toLowerCase().includes(lower)
+          !headTeacherName.toLowerCase().includes(lower)
         ) {
           return false;
         }
       }
       return true;
     });
-  }, [data, q, schoolId, gradeId]);
+  }, [data, q, schoolId, gradeId, teacherNameMap]);
 
   const updateQuery = (key: string, value: string): void => {
     const params = new URLSearchParams(searchParams.toString());
@@ -82,6 +133,37 @@ export function AdminClassesClient(): React.ReactElement {
     });
   };
 
+  const handleSubmit = async (
+    id: string | null,
+    input: AdminClassInput,
+  ): Promise<void> => {
+    try {
+      if (id) {
+        await updateMutation.run(id, input);
+      } else {
+        await createMutation.run(input);
+      }
+      await refetch();
+      notify.success(id ? t("form.titleEdit") : t("form.titleCreate"));
+      setFormOpen(false);
+      setEditTarget(null);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleDelete = async (): Promise<void> => {
+    if (!deleteTarget) return;
+    try {
+      await deleteMutation.run(deleteTarget.id);
+      await refetch();
+      notify.success(t("deleteConfirm.title"));
+      setDeleteTarget(null);
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -98,7 +180,10 @@ export function AdminClassesClient(): React.ReactElement {
       description={t("emptyDescription")}
       action={{
         label: t("emptyAction"),
-        href: "/shell/admin/school/classes",
+        onClick: () => {
+          setEditTarget(null);
+          setFormOpen(true);
+        },
       }}
     />
   );
@@ -108,6 +193,17 @@ export function AdminClassesClient(): React.ReactElement {
       title={t("title")}
       description={t("description")}
       icon={<School className="size-6" />}
+      actions={
+        <Button
+          onClick={() => {
+            setEditTarget(null);
+            setFormOpen(true);
+          }}
+        >
+          <Plus className="mr-1 size-4" />
+          {t("createButton")}
+        </Button>
+      }
       filters={
         <>
           <FilterSearchInput
@@ -154,7 +250,58 @@ export function AdminClassesClient(): React.ReactElement {
         </div>
       }
     >
-      <ClassesTable items={filteredItems} />
+      <ClassesTable
+        items={filteredItems}
+        teacherNameMap={teacherNameMap}
+        onEdit={(c) => {
+          setEditTarget(c);
+          setFormOpen(true);
+        }}
+        onDelete={(c) => setDeleteTarget(c)}
+        onManageSchedule={(c) => setScheduleTarget(c)}
+        onManageInvitation={(c) => setInvitationTarget(c)}
+      />
+      {formOpen ? (
+        <ClassFormDialog
+          editTarget={editTarget}
+          schools={schools ?? []}
+          grades={grades ?? []}
+          teacherOptions={teacherOptions ?? []}
+          loading={createMutation.loading || updateMutation.loading}
+          onClose={() => {
+            setFormOpen(false);
+            setEditTarget(null);
+          }}
+          onSubmit={(id, input) => handleSubmit(id, input)}
+        />
+      ) : null}
+      {deleteTarget ? (
+        <DeleteConfirmDialog
+          title={t("deleteConfirm.title")}
+          message={t("deleteConfirm.message", { name: deleteTarget.name })}
+          confirmLabel={t("deleteConfirm.confirm")}
+          cancelLabel={t("deleteConfirm.cancel")}
+          loading={deleteMutation.loading}
+          onCancel={() => setDeleteTarget(null)}
+          onConfirm={() => void handleDelete()}
+        />
+      ) : null}
+      {scheduleTarget ? (
+        <ScheduleManagerDialog
+          open={scheduleTarget !== null}
+          classId={scheduleTarget.id}
+          className={scheduleTarget.name}
+          onClose={() => setScheduleTarget(null)}
+        />
+      ) : null}
+      {invitationTarget ? (
+        <ClassInvitationManagerDialog
+          open={invitationTarget !== null}
+          classId={invitationTarget.id}
+          className={invitationTarget.name}
+          onClose={() => setInvitationTarget(null)}
+        />
+      ) : null}
     </ListPageShell>
   );
 }
@@ -164,8 +311,18 @@ export function AdminClassesClient(): React.ReactElement {
  */
 function ClassesTable({
   items,
+  teacherNameMap,
+  onEdit,
+  onDelete,
+  onManageSchedule,
+  onManageInvitation,
 }: {
   items: AdminClassListItem[];
+  teacherNameMap: Map<string, string>;
+  onEdit: (c: AdminClassListItem) => void;
+  onDelete: (c: AdminClassListItem) => void;
+  onManageSchedule: (c: AdminClassListItem) => void;
+  onManageInvitation: (c: AdminClassListItem) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.school.classes");
   return (
@@ -174,30 +331,91 @@ function ClassesTable({
         <thead className="border-b bg-muted/30">
           <tr>
             <th className="p-3 text-left font-medium">{t("colName")}</th>
+            <th className="p-3 text-left font-medium">
+              {t("colHomeroomLabel")}
+            </th>
             <th className="p-3 text-left font-medium">{t("colGrade")}</th>
             <th className="p-3 text-left font-medium">{t("colSchool")}</th>
             <th className="p-3 text-left font-medium">{t("colHeadTeacher")}</th>
+            <th className="p-3 text-left font-medium">{t("colRoom")}</th>
+            <th className="p-3 text-left font-medium">
+              {t("colSubjectTeachers")}
+            </th>
             <th className="p-3 text-right font-medium">
               {t("colStudentCount")}
             </th>
             <th className="p-3 text-right font-medium">
               {t("colSubjectCount")}
             </th>
+            <th className="p-3 text-left font-medium">{t("colUpdatedAt")}</th>
+            <th className="p-3 text-right font-medium">{t("colActions")}</th>
           </tr>
         </thead>
         <tbody className="divide-y">
           {items.map((c) => (
             <tr key={c.id} className="hover:bg-muted/30">
               <td className="p-3 font-medium">{truncateText(c.name)}</td>
+              <td className="p-3 text-muted-foreground">
+                {c.homeroomLabel ?? "--"}
+              </td>
               <td className="p-3 text-muted-foreground">{c.gradeName}</td>
               <td className="p-3 text-muted-foreground">{c.schoolName}</td>
-              <td className="p-3 text-muted-foreground">{c.headTeacherName}</td>
+              <td className="p-3 text-muted-foreground">
+                {teacherNameMap.get(c.headTeacherId) ??
+                  c.headTeacherName ??
+                  "-"}
+              </td>
+              <td className="p-3 text-muted-foreground">{c.room ?? "--"}</td>
+              <td className="max-w-xs p-3 text-muted-foreground">
+                {truncateText(c.subjectTeachers ?? "--", 30)}
+              </td>
               <td className="p-3 text-right font-mono text-xs text-muted-foreground">
                 {c.studentCount}
               </td>
               <td className="p-3 text-right font-mono text-xs text-muted-foreground">
                 {c.subjectCount}
               </td>
+              <td className="p-3 font-mono text-xs text-muted-foreground">
+                {c.updatedAt ? formatSchoolDate(c.updatedAt) : "--"}
+              </td>
+              <td className="p-3 text-right">
+                <div className="flex flex-wrap justify-end gap-1">
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onEdit(c)}
+                    aria-label={t("edit")}
+                  >
+                    <Pencil className="size-4" />
+                  </Button>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onManageSchedule(c)}
+                    aria-label={t("manageSchedule")}
+                  >
+                    <Calendar className="mr-1 size-4" />
+                    {t("manageSchedule")}
+                  </Button>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onManageInvitation(c)}
+                    aria-label={t("manageInvitation")}
+                  >
+                    <Ticket className="mr-1 size-4" />
+                    {t("manageInvitation")}
+                  </Button>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onDelete(c)}
+                    aria-label={t("delete")}
+                  >
+                    <Trash2 className="size-4" />
+                  </Button>
+                </div>
+              </td>
             </tr>
           ))}
         </tbody>
@@ -205,3 +423,171 @@ function ClassesTable({
     </div>
   );
 }
+
+/**
+ * 班级新建/编辑对话框。
+ */
+function ClassFormDialog({
+  editTarget,
+  schools,
+  grades,
+  teacherOptions,
+  loading,
+  onClose,
+  onSubmit,
+}: {
+  editTarget: AdminClassListItem | null;
+  schools: SchoolListItem[];
+  grades: Array<{ id: string; name: string }>;
+  teacherOptions: Array<{ id: string; name: string }>;
+  loading: boolean;
+  onClose: () => void;
+  onSubmit: (id: string | null, input: AdminClassInput) => Promise<void>;
+}): React.ReactElement {
+  const t = useTranslations("admin.school.classes");
+  const [name, setName] = useState("");
+  const [schoolId, setSchoolId] = useState("");
+  const [gradeId, setGradeId] = useState("");
+  const [headTeacherId, setHeadTeacherId] = useState("");
+  const [homeroomLabel, setHomeroomLabel] = useState("");
+  const [room, setRoom] = useState("");
+  const [homeroom, setHomeroom] = useState("");
+
+  useEffect(() => {
+    if (editTarget) {
+      setName(editTarget.name);
+      setSchoolId(editTarget.schoolId);
+      setGradeId(editTarget.gradeId);
+      setHeadTeacherId(editTarget.headTeacherId);
+      setHomeroomLabel(editTarget.homeroomLabel ?? "");
+      setRoom(editTarget.room ?? "");
+      setHomeroom(editTarget.homeroom ?? "");
+    } else {
+      setName("");
+      setSchoolId("");
+      setGradeId("");
+      setHeadTeacherId("");
+      setHomeroomLabel("");
+      setRoom("");
+      setHomeroom("");
+    }
+  }, [editTarget]);
+
+  const handleSubmit = (e: React.FormEvent<HTMLFormElement>): void => {
+    e.preventDefault();
+    if (!name.trim() || !schoolId || !gradeId) return;
+    void onSubmit(editTarget?.id ?? null, {
+      name: name.trim(),
+      gradeId,
+      schoolId,
+      headTeacherId: headTeacherId.trim() || undefined,
+      homeroomLabel: homeroomLabel.trim() || undefined,
+      room: room.trim() || undefined,
+      homeroom: homeroom.trim() || undefined,
+    });
+  };
+
+  return (
+    <Dialog open onOpenChange={onClose}>
+      <DialogContent className="max-w-md">
+        <DialogHeader>
+          <DialogTitle>
+            {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
+          </DialogTitle>
+        </DialogHeader>
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <FormField label={t("form.fieldName")} required>
+            <Input
+              type="text"
+              value={name}
+              onChange={(e) => setName(e.target.value)}
+              required
+            />
+          </FormField>
+          <FormField label={t("form.fieldSchool")} required>
+            <select
+              value={schoolId}
+              onChange={(e) => setSchoolId(e.target.value)}
+              required
+              className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            >
+              <option value="">--</option>
+              {schools.map((s) => (
+                <option key={s.id} value={s.id}>
+                  {s.name}
+                </option>
+              ))}
+            </select>
+          </FormField>
+          <FormField label={t("form.fieldGrade")} required>
+            <select
+              value={gradeId}
+              onChange={(e) => setGradeId(e.target.value)}
+              required
+              className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            >
+              <option value="">--</option>
+              {grades.map((g) => (
+                <option key={g.id} value={g.id}>
+                  {g.name}
+                </option>
+              ))}
+            </select>
+          </FormField>
+          <FormField label={t("form.fieldHeadTeacher")}>
+            <select
+              value={headTeacherId}
+              onChange={(e) => setHeadTeacherId(e.target.value)}
+              className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            >
+              <option value="">--</option>
+              {teacherOptions.map((t) => (
+                <option key={t.id} value={t.id}>
+                  {t.name}
+                </option>
+              ))}
+            </select>
+          </FormField>
+          <FormField label={t("form.fieldHomeroomLabel")}>
+            <Input
+              type="text"
+              value={homeroomLabel}
+              onChange={(e) => setHomeroomLabel(e.target.value)}
+              placeholder={t("form.fieldHomeroomLabelPlaceholder")}
+            />
+          </FormField>
+          <FormField label={t("form.fieldRoom")}>
+            <Input
+              type="text"
+              value={room}
+              onChange={(e) => setRoom(e.target.value)}
+              placeholder={t("form.fieldRoomPlaceholder")}
+            />
+          </FormField>
+          <FormField label={t("form.fieldHomeroom")}>
+            <select
+              value={homeroom}
+              onChange={(e) => setHomeroom(e.target.value)}
+              className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            >
+              <option value="">--</option>
+              {teacherOptions.map((t) => (
+                <option key={t.id} value={t.id}>
+                  {t.name}
+                </option>
+              ))}
+            </select>
+          </FormField>
+          <DialogFooter>
+            <Button type="button" variant="outline" onClick={onClose}>
+              {t("form.cancel")}
+            </Button>
+            <Button type="submit" disabled={loading}>
+              {t("form.submit")}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/school/class-invitation-manager.tsx b/apps/portal-shell/src/features/admin/school/class-invitation-manager.tsx
new file mode 100644
index 0000000..e1a370f
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/school/class-invitation-manager.tsx
@@ -0,0 +1,408 @@
+"use client";
+
+/**
+ * 班级邀请码管理 - 客户端组件（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 数据契约：
+ * - useClassInvitationCodes / useGenerateClassInvitationCode / useRevokeClassInvitationCode
+ *   ❌ schema 无对应根字段 → MSW 兜底（@contract-pending）
+ *
+ * 功能：
+ * - 列出班级所有邀请码（含状态/有效期/使用次数）
+ * - 生成自定义邀请码（可选有效期/次数/备注）
+ * - 撤销邀请码（软删除）
+ * - 复制邀请码到剪贴板
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { useState } from "react";
+import { Ban, Copy, Plus } from "lucide-react";
+import { useTranslations } from "next-intl";
+
+import {
+  useGenerateClassInvitationCode,
+  useRevokeClassInvitationCode,
+  useClassInvitationCodes,
+  type ClassInvitationCode,
+} from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import { FormField } from "@/features/admin/school/schools-client";
+
+// ── ClassInvitationManagerDialog ────────────────────────────────
+
+/**
+ * 班级邀请码管理对话框。
+ *
+ * - 列表查询：useClassInvitationCodes(classId)
+ * - 生成：useGenerateClassInvitationCode，自定义有效期/次数/备注
+ * - 撤销：useRevokeClassInvitationCode，软删除
+ * - 复制：navigator.clipboard.writeText
+ *
+ * 子对话框：GenerateCodeDialog（生成新邀请码）
+ */
+export function ClassInvitationManagerDialog({
+  open,
+  classId,
+  className,
+  onClose,
+}: {
+  open: boolean;
+  classId: string;
+  className: string;
+  onClose: () => void;
+}): React.ReactElement | null {
+  const t = useTranslations("admin.school.classes.invitation");
+  const tCommon = useTranslations("common");
+  const {
+    data: codes,
+    loading,
+    error,
+    refetch,
+  } = useClassInvitationCodes(classId);
+  const revokeMutation = useRevokeClassInvitationCode();
+
+  const [generateOpen, setGenerateOpen] = useState(false);
+  const [revokeTarget, setRevokeTarget] = useState<ClassInvitationCode | null>(
+    null,
+  );
+
+  const handleCopy = async (code: string): Promise<void> => {
+    try {
+      await navigator.clipboard.writeText(code);
+      notify.success(t("copied"));
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleRevoke = async (): Promise<void> => {
+    if (!revokeTarget) return;
+    try {
+      await revokeMutation.run(revokeTarget.id);
+      notify.success(t("revokeSuccess"));
+      setRevokeTarget(null);
+      void refetch();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  const handleGenerated = (): void => {
+    void refetch();
+  };
+
+  if (!open) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={onClose}
+    >
+      <div
+        className="flex max-h-[90vh] w-full max-w-3xl flex-col rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="mb-4 flex items-center justify-between">
+          <div>
+            <h2 className="text-lg font-semibold">{t("title")}</h2>
+            {className ? (
+              <p className="mt-1 text-xs text-muted-foreground">
+                {t("classLabel")}: {className}
+              </p>
+            ) : null}
+          </div>
+          <Button size="sm" onClick={() => setGenerateOpen(true)}>
+            <Plus className="mr-1.5 size-4" />
+            {t("generate")}
+          </Button>
+        </div>
+
+        <div className="flex-1 overflow-y-auto">
+          {loading ? (
+            <div className="py-12 text-center text-sm text-muted-foreground">
+              {tCommon("loading")}
+            </div>
+          ) : error ? (
+            <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
+              <p className="text-sm text-destructive">
+                {tCommon("error.loadFailed", { message: String(error) })}
+              </p>
+            </div>
+          ) : codes && codes.length > 0 ? (
+            <div className="overflow-x-auto rounded-xl border">
+              <table className="w-full text-sm">
+                <thead className="border-b bg-muted/30">
+                  <tr>
+                    <th className="p-3 text-left font-medium">
+                      {t("colCode")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("colStatus")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("colUsedCount")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("colExpiresAt")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("colNote")}
+                    </th>
+                    <th className="p-3 text-right font-medium">
+                      {t("colActions")}
+                    </th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y">
+                  {codes.map((record) => (
+                    <tr key={record.id} className="hover:bg-muted/30">
+                      <td className="p-3 font-mono font-medium tracking-wider">
+                        {record.code}
+                      </td>
+                      <td className="p-3">
+                        <InvitationStatusBadge status={record.status} />
+                      </td>
+                      <td className="p-3 text-sm">
+                        {record.usedCount}
+                        {record.maxUses !== null ? ` / ${record.maxUses}` : ""}
+                      </td>
+                      <td className="p-3 text-sm text-muted-foreground">
+                        {record.expiresAt
+                          ? new Date(record.expiresAt).toLocaleString()
+                          : t("neverExpires")}
+                      </td>
+                      <td className="max-w-[200px] truncate p-3 text-sm text-muted-foreground">
+                        {record.note ?? "-"}
+                      </td>
+                      <td className="p-3 text-right">
+                        <div className="flex justify-end gap-1">
+                          <Button
+                            variant="ghost"
+                            size="sm"
+                            onClick={() => void handleCopy(record.code)}
+                            aria-label={t("copy")}
+                          >
+                            <Copy className="size-4" />
+                          </Button>
+                          {record.status === "active" ? (
+                            <Button
+                              variant="ghost"
+                              size="sm"
+                              onClick={() => setRevokeTarget(record)}
+                              aria-label={t("revoke")}
+                            >
+                              <Ban className="size-4" />
+                            </Button>
+                          ) : null}
+                        </div>
+                      </td>
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+          ) : (
+            <div className="py-12 text-center text-sm text-muted-foreground">
+              {t("empty")}
+            </div>
+          )}
+        </div>
+
+        <div className="mt-4 flex justify-end">
+          <Button variant="outline" onClick={onClose}>
+            {tCommon("form.close")}
+          </Button>
+        </div>
+
+        <GenerateCodeDialog
+          open={generateOpen}
+          classId={classId}
+          onClose={() => setGenerateOpen(false)}
+          onCreated={handleGenerated}
+        />
+
+        {revokeTarget ? (
+          <div
+            className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+            onClick={() => setRevokeTarget(null)}
+          >
+            <div
+              className="w-full max-w-sm rounded-xl border bg-background p-6 shadow-lg"
+              onClick={(e) => e.stopPropagation()}
+            >
+              <h2 className="mb-2 text-lg font-semibold">{t("revoke")}</h2>
+              <p className="mb-4 text-sm text-muted-foreground">
+                {t("revokeConfirm")}
+              </p>
+              <div className="flex justify-end gap-2">
+                <Button
+                  type="button"
+                  variant="outline"
+                  onClick={() => setRevokeTarget(null)}
+                  disabled={revokeMutation.loading}
+                >
+                  {tCommon("form.cancel")}
+                </Button>
+                <Button
+                  type="button"
+                  variant="destructive"
+                  disabled={revokeMutation.loading}
+                  onClick={() => void handleRevoke()}
+                >
+                  {revokeMutation.loading
+                    ? tCommon("form.processing")
+                    : t("revoke")}
+                </Button>
+              </div>
+            </div>
+          </div>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+// ── InvitationStatusBadge ───────────────────────────────────────
+
+/**
+ * 邀请码状态徽章。
+ *
+ * - active：默认变体（primary 色）
+ * - 其他（used/expired/revoked）：secondary 变体
+ */
+function InvitationStatusBadge({
+  status,
+}: {
+  status: string;
+}): React.ReactElement {
+  const t = useTranslations("admin.school.classes.invitation");
+  const variant = status === "active" ? "default" : "secondary";
+  const label =
+    status === "active" ||
+    status === "used" ||
+    status === "expired" ||
+    status === "revoked"
+      ? t(`status.${status}`)
+      : status;
+  return <Badge variant={variant}>{label}</Badge>;
+}
+
+// ── GenerateCodeDialog ──────────────────────────────────────────
+
+/**
+ * 生成新邀请码对话框。
+ *
+ * 字段：有效期（小时）/ 最大使用次数 / 备注
+ * 全部可选，留空则生成无限制邀请码。
+ */
+function GenerateCodeDialog({
+  open,
+  classId,
+  onClose,
+  onCreated,
+}: {
+  open: boolean;
+  classId: string;
+  onClose: () => void;
+  onCreated: () => void;
+}): React.ReactElement | null {
+  const t = useTranslations("admin.school.classes.invitation");
+  const tCommon = useTranslations("common");
+  const generateMutation = useGenerateClassInvitationCode();
+
+  const [expiresInHours, setExpiresInHours] = useState<string>("");
+  const [maxUses, setMaxUses] = useState<string>("");
+  const [note, setNote] = useState<string>("");
+
+  const handleSubmit = async (
+    e: React.FormEvent<HTMLFormElement>,
+  ): Promise<void> => {
+    e.preventDefault();
+    if (!classId) return;
+
+    try {
+      await generateMutation.run({
+        classId,
+        expiresInHours: expiresInHours ? Number(expiresInHours) : null,
+        maxUses: maxUses ? Number(maxUses) : null,
+        note: note.trim() || null,
+      });
+      notify.success(t("generateSuccess"));
+      setExpiresInHours("");
+      setMaxUses("");
+      setNote("");
+      onCreated();
+      onClose();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  if (!open) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={onClose}
+    >
+      <div
+        className="w-full max-w-md rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h2 className="mb-1 text-lg font-semibold">
+          {t("generateWithCustom")}
+        </h2>
+        <p className="mb-4 text-xs text-muted-foreground">
+          {t("defaultDuration")} · {t("defaultMaxUses")}
+        </p>
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <FormField label={t("expiresInHours")}>
+            <Input
+              type="number"
+              min="1"
+              value={expiresInHours}
+              onChange={(e) => setExpiresInHours(e.target.value)}
+              placeholder={t("defaultDuration")}
+            />
+          </FormField>
+          <FormField label={t("maxUsesLabel")}>
+            <Input
+              type="number"
+              min="1"
+              value={maxUses}
+              onChange={(e) => setMaxUses(e.target.value)}
+              placeholder={t("defaultMaxUses")}
+            />
+          </FormField>
+          <FormField label={t("customNote")}>
+            <Input
+              type="text"
+              value={note}
+              onChange={(e) => setNote(e.target.value)}
+              placeholder={t("customNotePlaceholder")}
+              maxLength={255}
+            />
+          </FormField>
+          <div className="flex justify-end gap-2">
+            <Button
+              type="button"
+              variant="outline"
+              onClick={onClose}
+              disabled={generateMutation.loading}
+            >
+              {tCommon("form.cancel")}
+            </Button>
+            <Button type="submit" disabled={generateMutation.loading}>
+              {generateMutation.loading
+                ? tCommon("form.processing")
+                : t("generate")}
+            </Button>
+          </div>
+        </form>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/school/class-schedule-dialog.tsx b/apps/portal-shell/src/features/admin/school/class-schedule-dialog.tsx
new file mode 100644
index 0000000..c08c914
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/school/class-schedule-dialog.tsx
@@ -0,0 +1,509 @@
+"use client";
+
+/**
+ * 班级课表 CRUD 对话框 - 客户端组件（ARCHITECTURE.md §7.3 / §9.4 / §10 P5）
+ *
+ * 数据契约：useClassSchedules / useCreateClassSchedule / useUpdateClassSchedule / useDeleteClassSchedule
+ * ❌ schema 无对应根字段 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { useEffect, useState } from "react";
+import { Pencil, Plus, Trash2 } from "lucide-react";
+import { useTranslations } from "next-intl";
+
+import {
+  useCreateClassSchedule,
+  useDeleteClassSchedule,
+  useClassSchedules,
+  useUpdateClassSchedule,
+  type ClassScheduleInput,
+  type ClassScheduleItem,
+} from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Button } from "@/shared/components/ui/button";
+import { Input } from "@/shared/components/ui/input";
+import { FormField } from "@/features/admin/school/schools-client";
+
+/** 星期 1-7 */
+const WEEKDAY_OPTIONS = [1, 2, 3, 4, 5, 6, 7] as const;
+
+/** 节次 1-12 */
+const PERIOD_OPTIONS = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12] as const;
+
+// ── ScheduleManagerDialog ──────────────────────────────────────
+
+/**
+ * 班级课表管理对话框。
+ *
+ * - 列表查询：useClassSchedules(classId)
+ * - 新增/编辑：ScheduleFormDialog（mode 切换）
+ * - 删除：ScheduleDeleteDialog
+ */
+export function ScheduleManagerDialog({
+  open,
+  classId,
+  className,
+  onClose,
+}: {
+  open: boolean;
+  classId: string;
+  className: string;
+  onClose: () => void;
+}): React.ReactElement | null {
+  const t = useTranslations("admin.school.classes.schedule");
+  const tCommon = useTranslations("common");
+  const {
+    data: schedules,
+    loading,
+    error,
+    refetch,
+  } = useClassSchedules(classId);
+
+  const [formOpen, setFormOpen] = useState(false);
+  const [formMode, setFormMode] = useState<"create" | "edit">("create");
+  const [editTarget, setEditTarget] = useState<ClassScheduleItem | null>(null);
+  const [deleteTarget, setDeleteTarget] = useState<ClassScheduleItem | null>(
+    null,
+  );
+
+  const handleAdd = (): void => {
+    setFormMode("create");
+    setEditTarget(null);
+    setFormOpen(true);
+  };
+
+  const handleEdit = (item: ClassScheduleItem): void => {
+    setFormMode("edit");
+    setEditTarget(item);
+    setFormOpen(true);
+  };
+
+  const handleSubmitted = (): void => {
+    void refetch();
+  };
+
+  const handleDeleted = (): void => {
+    void refetch();
+  };
+
+  if (!open) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
+      onClick={onClose}
+    >
+      <div
+        className="flex max-h-[90vh] w-full max-w-4xl flex-col rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="mb-4 flex items-center justify-between">
+          <div>
+            <h2 className="text-lg font-semibold">{t("manager.title")}</h2>
+            {className ? (
+              <p className="mt-1 text-xs text-muted-foreground">
+                {t("form.classLabel")}: {className}
+              </p>
+            ) : null}
+          </div>
+          <Button size="sm" onClick={handleAdd}>
+            <Plus className="mr-1.5 size-4" />
+            {t("manager.add")}
+          </Button>
+        </div>
+
+        <div className="flex-1 overflow-y-auto">
+          {loading ? (
+            <div className="py-12 text-center text-sm text-muted-foreground">
+              {tCommon("status.loading")}
+            </div>
+          ) : error ? (
+            <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
+              <p className="text-sm text-destructive">
+                {tCommon("error.loadFailed", { message: String(error) })}
+              </p>
+            </div>
+          ) : schedules && schedules.length > 0 ? (
+            <div className="overflow-x-auto rounded-xl border">
+              <table className="w-full text-sm">
+                <thead className="border-b bg-muted/30">
+                  <tr>
+                    <th className="p-3 text-left font-medium">
+                      {t("form.fieldWeekday")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("manager.colPeriod")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("manager.colSubject")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("manager.colTeacher")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("manager.colClassroom")}
+                    </th>
+                    <th className="p-3 text-left font-medium">
+                      {t("manager.colTime")}
+                    </th>
+                    <th className="p-3 text-right font-medium">
+                      {t("manager.colActions")}
+                    </th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y">
+                  {schedules.map((item) => (
+                    <tr key={item.id} className="hover:bg-muted/30">
+                      <td className="p-3">{t(`weekday.${item.weekday}`)}</td>
+                      <td className="p-3">
+                        {t("form.periodN", { n: item.period })}
+                      </td>
+                      <td className="p-3 font-medium">{item.subjectName}</td>
+                      <td className="p-3 text-muted-foreground">
+                        {item.teacherName}
+                      </td>
+                      <td className="p-3 text-muted-foreground">
+                        {item.classroom ?? "-"}
+                      </td>
+                      <td className="p-3 text-xs text-muted-foreground">
+                        {item.startTime} - {item.endTime}
+                      </td>
+                      <td className="p-3 text-right">
+                        <div className="flex justify-end gap-1">
+                          <Button
+                            variant="ghost"
+                            size="sm"
+                            onClick={() => handleEdit(item)}
+                            aria-label={tCommon("button.edit")}
+                          >
+                            <Pencil className="size-4" />
+                          </Button>
+                          <Button
+                            variant="ghost"
+                            size="sm"
+                            onClick={() => setDeleteTarget(item)}
+                            aria-label={tCommon("button.delete")}
+                          >
+                            <Trash2 className="size-4" />
+                          </Button>
+                        </div>
+                      </td>
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+          ) : (
+            <div className="py-12 text-center text-sm text-muted-foreground">
+              {t("manager.empty")}
+            </div>
+          )}
+        </div>
+
+        <div className="mt-4 flex justify-end">
+          <Button variant="outline" onClick={onClose}>
+            {tCommon("button.cancel")}
+          </Button>
+        </div>
+
+        <ScheduleFormDialog
+          open={formOpen}
+          mode={formMode}
+          classId={classId}
+          className={className}
+          initialData={editTarget}
+          onClose={() => setFormOpen(false)}
+          onSubmitted={handleSubmitted}
+        />
+
+        {deleteTarget ? (
+          <ScheduleDeleteDialog
+            target={deleteTarget}
+            onClose={() => setDeleteTarget(null)}
+            onDeleted={handleDeleted}
+          />
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+// ── ScheduleFormDialog ─────────────────────────────────────────
+
+/**
+ * 课表条目新增/编辑表单对话框（mode 切换）。
+ *
+ * 字段：星期 / 节次 / 学科 / 教师 / 教室 / 起止时间
+ */
+function ScheduleFormDialog({
+  open,
+  mode,
+  classId,
+  className,
+  initialData,
+  onClose,
+  onSubmitted,
+}: {
+  open: boolean;
+  mode: "create" | "edit";
+  classId: string;
+  className: string;
+  initialData: ClassScheduleItem | null;
+  onClose: () => void;
+  onSubmitted?: (item: ClassScheduleItem) => void;
+}): React.ReactElement | null {
+  const t = useTranslations("admin.school.classes.schedule");
+  const tCommon = useTranslations("common");
+  const createMutation = useCreateClassSchedule();
+  const updateMutation = useUpdateClassSchedule();
+
+  const [weekday, setWeekday] = useState<number>(1);
+  const [period, setPeriod] = useState<number>(1);
+  const [subjectName, setSubjectName] = useState<string>("");
+  const [teacherName, setTeacherName] = useState<string>("");
+  const [classroom, setClassroom] = useState<string>("");
+  const [startTime, setStartTime] = useState<string>("08:00");
+  const [endTime, setEndTime] = useState<string>("08:45");
+
+  useEffect(() => {
+    if (!open) return;
+    if (mode === "edit" && initialData) {
+      setWeekday(initialData.weekday);
+      setPeriod(initialData.period);
+      setSubjectName(initialData.subjectName);
+      setTeacherName(initialData.teacherName);
+      setClassroom(initialData.classroom ?? "");
+      setStartTime(initialData.startTime);
+      setEndTime(initialData.endTime);
+    } else {
+      setWeekday(1);
+      setPeriod(1);
+      setSubjectName("");
+      setTeacherName("");
+      setClassroom("");
+      setStartTime("08:00");
+      setEndTime("08:45");
+    }
+  }, [open, mode, initialData]);
+
+  const loading = createMutation.loading || updateMutation.loading;
+
+  const handleSubmit = async (
+    e: React.FormEvent<HTMLFormElement>,
+  ): Promise<void> => {
+    e.preventDefault();
+    if (!classId) return;
+    if (!subjectName.trim() || !teacherName.trim()) return;
+
+    const input: ClassScheduleInput = {
+      classId,
+      weekday,
+      period,
+      subjectName: subjectName.trim(),
+      teacherName: teacherName.trim(),
+      classroom: classroom.trim() || null,
+      startTime,
+      endTime,
+    };
+
+    try {
+      let result: ClassScheduleItem;
+      if (mode === "edit" && initialData) {
+        result = await updateMutation.run(initialData.id, input);
+        notify.success(t("form.editSuccess"));
+      } else {
+        result = await createMutation.run(input);
+        notify.success(t("form.createSuccess"));
+      }
+      onSubmitted?.(result);
+      onClose();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  if (!open) return null;
+
+  const title = mode === "edit" ? t("form.titleEdit") : t("form.titleCreate");
+
+  return (
+    <div
+      className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50 p-4"
+      onClick={onClose}
+    >
+      <div
+        className="max-h-[90vh] w-full max-w-lg overflow-y-auto rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h2 className="mb-4 text-lg font-semibold">{title}</h2>
+        {className ? (
+          <p className="mb-4 text-xs text-muted-foreground">
+            {t("form.classLabel")}: {className}
+          </p>
+        ) : null}
+
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <div className="grid grid-cols-2 gap-4">
+            <FormField label={t("form.fieldWeekday")} required>
+              <select
+                value={weekday}
+                onChange={(e) => setWeekday(Number(e.target.value))}
+                className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+                required
+              >
+                {WEEKDAY_OPTIONS.map((w) => (
+                  <option key={w} value={w}>
+                    {t(`weekday.${w}`)}
+                  </option>
+                ))}
+              </select>
+            </FormField>
+            <FormField label={t("form.fieldPeriod")} required>
+              <select
+                value={period}
+                onChange={(e) => setPeriod(Number(e.target.value))}
+                className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+                required
+              >
+                {PERIOD_OPTIONS.map((p) => (
+                  <option key={p} value={p}>
+                    {t("form.periodN", { n: p })}
+                  </option>
+                ))}
+              </select>
+            </FormField>
+          </div>
+
+          <FormField label={t("form.fieldSubject")} required>
+            <Input
+              value={subjectName}
+              onChange={(e) => setSubjectName(e.target.value)}
+              placeholder={t("form.subjectPlaceholder")}
+              required
+            />
+          </FormField>
+
+          <FormField label={t("form.fieldTeacher")} required>
+            <Input
+              value={teacherName}
+              onChange={(e) => setTeacherName(e.target.value)}
+              placeholder={t("form.teacherPlaceholder")}
+              required
+            />
+          </FormField>
+
+          <FormField label={t("form.fieldClassroom")}>
+            <Input
+              value={classroom}
+              onChange={(e) => setClassroom(e.target.value)}
+              placeholder={t("form.classroomPlaceholder")}
+            />
+          </FormField>
+
+          <div className="grid grid-cols-2 gap-4">
+            <FormField label={t("form.fieldStartTime")} required>
+              <Input
+                type="time"
+                value={startTime}
+                onChange={(e) => setStartTime(e.target.value)}
+                required
+              />
+            </FormField>
+            <FormField label={t("form.fieldEndTime")} required>
+              <Input
+                type="time"
+                value={endTime}
+                onChange={(e) => setEndTime(e.target.value)}
+                required
+              />
+            </FormField>
+          </div>
+
+          <div className="flex justify-end gap-2 pt-2">
+            <Button
+              type="button"
+              variant="outline"
+              onClick={onClose}
+              disabled={loading}
+            >
+              {tCommon("button.cancel")}
+            </Button>
+            <Button type="submit" disabled={loading}>
+              {mode === "edit" ? t("form.save") : t("form.create")}
+            </Button>
+          </div>
+        </form>
+      </div>
+    </div>
+  );
+}
+
+// ── ScheduleDeleteDialog ───────────────────────────────────────
+
+/**
+ * 课表条目删除确认对话框。
+ */
+function ScheduleDeleteDialog({
+  target,
+  onClose,
+  onDeleted,
+}: {
+  target: ClassScheduleItem;
+  onClose: () => void;
+  onDeleted?: () => void;
+}): React.ReactElement {
+  const t = useTranslations("admin.school.classes.schedule");
+  const tCommon = useTranslations("common");
+  const deleteMutation = useDeleteClassSchedule();
+
+  const handleDelete = async (): Promise<void> => {
+    try {
+      await deleteMutation.run(target.id);
+      notify.success(t("form.deleteSuccess"));
+      onDeleted?.();
+      onClose();
+    } catch (err) {
+      notify.error(tCommon("error.loadFailed", { message: String(err) }));
+    }
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50 p-4"
+      onClick={onClose}
+    >
+      <div
+        className="w-full max-w-sm rounded-xl border bg-background p-6 shadow-lg"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <h2 className="mb-2 text-lg font-semibold">{t("form.deleteTitle")}</h2>
+        <p className="mb-4 text-sm text-muted-foreground">
+          {t("form.deleteMessage", {
+            weekday: t(`weekday.${target.weekday}`),
+            period: target.period,
+            subject: target.subjectName,
+          })}
+        </p>
+        <div className="flex justify-end gap-2">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={onClose}
+            disabled={deleteMutation.loading}
+          >
+            {tCommon("button.cancel")}
+          </Button>
+          <Button
+            type="button"
+            variant="destructive"
+            disabled={deleteMutation.loading}
+            onClick={() => void handleDelete()}
+          >
+            {t("form.deleteConfirm")}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/school/departments-client.tsx b/apps/portal-shell/src/features/admin/school/departments-client.tsx
index 0237e0c..4f09df6 100644
--- a/apps/portal-shell/src/features/admin/school/departments-client.tsx
+++ b/apps/portal-shell/src/features/admin/school/departments-client.tsx
@@ -37,7 +37,10 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { truncateText } from "@/features/admin/school/transformations";
+import {
+  formatSchoolDate,
+  truncateText,
+} from "@/features/admin/school/transformations";
 import {
   DeleteConfirmDialog,
   FormField,
@@ -267,9 +270,11 @@ function DepartmentsTable({
             <th className="p-3 text-left font-medium">{t("colName")}</th>
             <th className="p-3 text-left font-medium">{t("colSchool")}</th>
             <th className="p-3 text-left font-medium">{t("colHead")}</th>
+            <th className="p-3 text-left font-medium">{t("colDescription")}</th>
             <th className="p-3 text-right font-medium">
               {t("colMemberCount")}
             </th>
+            <th className="p-3 text-left font-medium">{t("colUpdatedAt")}</th>
             <th className="p-3 text-right font-medium">{t("colActions")}</th>
           </tr>
         </thead>
@@ -281,9 +286,15 @@ function DepartmentsTable({
                 {schoolNameMap.get(d.schoolId) ?? d.schoolId}
               </td>
               <td className="p-3 text-muted-foreground">{d.headName}</td>
+              <td className="max-w-xs p-3 text-muted-foreground">
+                {truncateText(d.description ?? "--", 30)}
+              </td>
               <td className="p-3 text-right font-mono text-xs text-muted-foreground">
                 {d.memberCount}
               </td>
+              <td className="p-3 font-mono text-xs text-muted-foreground">
+                {formatSchoolDate(d.updatedAt)}
+              </td>
               <td className="p-3 text-right">
                 <div className="flex justify-end gap-1">
                   <Button
@@ -332,16 +343,19 @@ function DepartmentFormDialog({
   const [name, setName] = useState("");
   const [schoolId, setSchoolId] = useState("");
   const [headId, setHeadId] = useState("");
+  const [description, setDescription] = useState("");
 
   useEffect(() => {
     if (editTarget) {
       setName(editTarget.name);
       setSchoolId(editTarget.schoolId);
       setHeadId(editTarget.headId);
+      setDescription(editTarget.description ?? "");
     } else {
       setName("");
       setSchoolId("");
       setHeadId("");
+      setDescription("");
     }
   }, [editTarget]);
 
@@ -352,6 +366,7 @@ function DepartmentFormDialog({
       name: name.trim(),
       schoolId,
       headId: headId.trim() || undefined,
+      description: description.trim() || undefined,
     });
   };
 
@@ -398,6 +413,13 @@ function DepartmentFormDialog({
               onChange={(e) => setHeadId(e.target.value)}
             />
           </FormField>
+          <FormField label={t("form.fieldDescription")}>
+            <Input
+              type="text"
+              value={description}
+              onChange={(e) => setDescription(e.target.value)}
+            />
+          </FormField>
           <div className="flex justify-end gap-2">
             <Button type="button" variant="outline" onClick={onClose}>
               {t("form.cancel")}
diff --git a/apps/portal-shell/src/features/admin/school/grade-insights-client.tsx b/apps/portal-shell/src/features/admin/school/grade-insights-client.tsx
new file mode 100644
index 0000000..0822650
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/school/grade-insights-client.tsx
@@ -0,0 +1,495 @@
+"use client";
+
+/**
+ * 年级洞察页 - 客户端组件（ARCHITECTURE.md §7.3 / §9.4 管理域 / §10 P5）
+ *
+ * 数据契约：
+ * - 全校年级成绩汇总 schoolWideGradeSummary()：❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 年级列表 grades()：❌ schema 无 → MSW 兜底（@contract-pending），用于 ChipNav 年级筛选
+ *
+ * URL 状态：?gradeId=（空或 "all" 表示全部）
+ *
+ * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState）
+ *
+ * 页面结构：
+ * 1. 全校汇总统计卡片（4 个 StatCard：平均分 / 及格率 / 优秀率 / 参考人数）
+ * 2. 年级筛选（ChipNav，URL 驱动，无整页刷新）
+ * 3. 最近作业表（recentAssignments[]，含提交率徽章）
+ * 4. 班级排名表（合并 grades[].classRankings，含 delta 涨跌徽章）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import {
+  Award,
+  BarChart3,
+  CheckCircle2,
+  TrendingDown,
+  TrendingUp,
+  Users,
+} from "lucide-react";
+import Link from "next/link";
+import { useSearchParams } from "next/navigation";
+import { useEffect, useMemo, useTransition } from "react";
+import { useTranslations } from "next-intl";
+
+import { useGrades, useSchoolWideGradeSummary } from "@/lib/api";
+import type { SchoolWideOverallStats } from "@/lib/api";
+import { notify } from "@/shared/lib/notify";
+import { Badge } from "@/shared/components/ui/badge";
+import { Button } from "@/shared/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/components/ui/card";
+import { ChipNav } from "@/shared/components/ui/chip-nav";
+import { EmptyState } from "@/shared/components/ui/empty-state";
+import { StatCard } from "@/shared/components/ui/stat-card";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/shared/components/ui/table";
+import {
+  ListPageShell,
+  ListPageSkeleton,
+} from "@/shared/components/page-templates";
+import {
+  formatCount,
+  formatSchoolDate,
+  formatScore,
+} from "@/features/admin/school/transformations";
+
+/**
+ * 年级洞察客户端主体。需由 server page 包裹在 <Suspense> 中。
+ */
+export function GradeInsightsClient(): React.ReactElement {
+  const t = useTranslations("admin.school.grades.insights");
+  const tCommon = useTranslations("common");
+  const searchParams = useSearchParams();
+  const [, startTransition] = useTransition();
+
+  const gradeIdParam = searchParams.get("gradeId") ?? "";
+  const selectedGradeId =
+    gradeIdParam && gradeIdParam !== "all" ? gradeIdParam : "";
+
+  // @contract-pending：MSW 兜底，用于 ChipNav 年级选项
+  const { data: gradeOptions } = useGrades();
+  // @contract-pending：MSW 兜底，用于全校汇总 + 班级排名 + 最近作业
+  const { data, loading, error, refetch } =
+    useSchoolWideGradeSummary(selectedGradeId);
+
+  // 错误降级：query 出错时弹出通知（§11.3 DoD：catch 块必须包含 notify.error）
+  useEffect(() => {
+    if (error) {
+      notify.error(
+        tCommon("error.loadFailed", {
+          message: error instanceof Error ? error.message : String(error),
+        }),
+      );
+    }
+  }, [error, tCommon]);
+
+  const chipNavOptions = useMemo(
+    () =>
+      (gradeOptions ?? []).map((g) => ({
+        id: g.id,
+        name: g.name,
+      })),
+    [gradeOptions],
+  );
+
+  const buildHref = (gId: string): string => {
+    if (!gId || gId === "all") {
+      return "/shell/admin/school/grades/insights";
+    }
+    return `/shell/admin/school/grades/insights?gradeId=${encodeURIComponent(gId)}`;
+  };
+
+  const handleRetry = (): void => {
+    startTransition(() => {
+      void refetch();
+    });
+  };
+
+  // 合并各年级的班级排名（保留所属年级信息）
+  const classRankings = useMemo(() => {
+    if (!data?.grades?.length) return [];
+    const merged: Array<{
+      gradeName: string;
+      classId: string;
+      className: string;
+      averageScore: number;
+      passRate: number;
+      studentCount: number;
+      rank: number;
+      delta: number;
+    }> = [];
+    for (const g of data.grades) {
+      for (const c of g.classRankings ?? []) {
+        merged.push({
+          gradeName: g.gradeName,
+          classId: c.classId,
+          className: c.className,
+          averageScore: c.averageScore,
+          passRate: c.passRate,
+          studentCount: c.studentCount,
+          rank: c.rank,
+          delta: c.delta,
+        });
+      }
+    }
+    return merged;
+  }, [data]);
+
+  // 加载态：复用 ListPageSkeleton
+  if (loading && !data) {
+    return <ListPageSkeleton rows={6} />;
+  }
+
+  // 错误态：局部降级 EmptyState + 重试按钮
+  if (error && !data) {
+    return (
+      <ListPageShell
+        title={t("title")}
+        description={t("description")}
+        icon={<BarChart3 className="size-5" aria-hidden="true" />}
+        actions={
+          <Button asChild variant="outline">
+            <Link href="/shell/admin/school/grades">{t("manageGrades")}</Link>
+          </Button>
+        }
+      >
+        <EmptyState
+          icon={BarChart3}
+          title={t("error.title")}
+          description={t("error.unknown")}
+          action={{
+            label: tCommon("button.retry"),
+            onClick: handleRetry,
+            variant: "outline",
+          }}
+        />
+      </ListPageShell>
+    );
+  }
+
+  const overall = data?.overallStats;
+  const assignments = data?.recentAssignments ?? [];
+
+  return (
+    <ListPageShell
+      title={t("title")}
+      description={t("description")}
+      icon={<BarChart3 className="size-5" aria-hidden="true" />}
+      actions={
+        <Button asChild variant="outline">
+          <Link href="/shell/admin/school/grades">{t("manageGrades")}</Link>
+        </Button>
+      }
+      filters={
+        <ChipNav
+          options={chipNavOptions}
+          currentId={selectedGradeId || "all"}
+          buildHref={buildHref}
+          allOption={{ id: "all", label: t("allGrades") }}
+          ariaLabel={t("filterByGrade")}
+        />
+      }
+    >
+      <div className="flex flex-col gap-6">
+        {/* 1. 全校汇总统计卡片 */}
+        <SchoolWideSummaryCard overall={overall} />
+
+        {/* 2. 最近作业表 */}
+        <Card className="shadow-none">
+          <CardHeader className="flex flex-row items-center justify-between space-y-0">
+            <div className="space-y-1">
+              <CardTitle className="text-base">
+                {t("assignments.title")}
+              </CardTitle>
+              <CardDescription>{t("assignments.description")}</CardDescription>
+            </div>
+            <Badge variant="secondary" className="tabular-nums">
+              {formatCount(assignments.length)}
+            </Badge>
+          </CardHeader>
+          <CardContent>
+            {assignments.length === 0 ? (
+              <p className="py-6 text-center text-sm text-muted-foreground">
+                {t("assignments.empty")}
+              </p>
+            ) : (
+              <div className="rounded-md border">
+                <Table>
+                  <TableHeader>
+                    <TableRow className="bg-muted/50">
+                      <TableHead>{t("assignments.colTitle")}</TableHead>
+                      <TableHead>{t("assignments.colSubject")}</TableHead>
+                      <TableHead>{t("assignments.colGrade")}</TableHead>
+                      <TableHead className="text-right">
+                        {t("assignments.colAverage")}
+                      </TableHead>
+                      <TableHead className="text-right">
+                        {t("assignments.colSubmitCount")}
+                      </TableHead>
+                      <TableHead>{t("assignments.colStatus")}</TableHead>
+                      <TableHead>{t("assignments.colCreatedAt")}</TableHead>
+                    </TableRow>
+                  </TableHeader>
+                  <TableBody>
+                    {assignments.map((a) => {
+                      const submitRate =
+                        a.totalStudents > 0
+                          ? (a.submitCount / a.totalStudents) * 100
+                          : 0;
+                      return (
+                        <TableRow key={a.assignmentId}>
+                          <TableCell className="font-medium">
+                            {a.title}
+                          </TableCell>
+                          <TableCell>{a.subjectName}</TableCell>
+                          <TableCell className="text-muted-foreground">
+                            {a.gradeName}
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums font-medium">
+                            {formatScore(a.averageScore)}
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums">
+                            <span>{formatCount(a.submitCount)}</span>
+                            <span className="text-muted-foreground">
+                              {" "}
+                              / {formatCount(a.totalStudents)}
+                            </span>
+                            <Badge
+                              variant={
+                                submitRate >= 95
+                                  ? "default"
+                                  : submitRate >= 80
+                                    ? "secondary"
+                                    : "outline"
+                              }
+                              className="ml-2 tabular-nums"
+                            >
+                              {formatScore(submitRate)}%
+                            </Badge>
+                          </TableCell>
+                          <TableCell>
+                            <Badge
+                              variant={
+                                a.status === "graded" ? "secondary" : "outline"
+                              }
+                              className="capitalize"
+                            >
+                              {assignmentStatusToLabel(a.status, t)}
+                            </Badge>
+                          </TableCell>
+                          <TableCell className="text-muted-foreground">
+                            {formatSchoolDate(a.createdAt)}
+                          </TableCell>
+                        </TableRow>
+                      );
+                    })}
+                  </TableBody>
+                </Table>
+              </div>
+            )}
+          </CardContent>
+        </Card>
+
+        {/* 3. 班级排名表 */}
+        <Card className="shadow-none">
+          <CardHeader className="flex flex-row items-center justify-between space-y-0">
+            <div className="space-y-1">
+              <CardTitle className="text-base">
+                {t("classRanking.title")}
+              </CardTitle>
+              <CardDescription>{t("classRanking.description")}</CardDescription>
+            </div>
+            <Badge variant="secondary" className="tabular-nums">
+              {formatCount(classRankings.length)}
+            </Badge>
+          </CardHeader>
+          <CardContent>
+            {classRankings.length === 0 ? (
+              <EmptyState
+                icon={BarChart3}
+                title={t("classRanking.empty")}
+                description={t("classRanking.emptyDescription")}
+                className="min-h-[240px] bg-transparent"
+              />
+            ) : (
+              <div className="rounded-md border">
+                <Table>
+                  <TableHeader>
+                    <TableRow className="bg-muted/50">
+                      <TableHead>{t("classRanking.colGrade")}</TableHead>
+                      <TableHead>{t("classRanking.colClass")}</TableHead>
+                      <TableHead className="text-right">
+                        {t("classRanking.colRank")}
+                      </TableHead>
+                      <TableHead className="text-right">
+                        {t("classRanking.colAverage")}
+                      </TableHead>
+                      <TableHead className="text-right">
+                        {t("classRanking.colPassRate")}
+                      </TableHead>
+                      <TableHead className="text-right">
+                        {t("classRanking.colStudentCount")}
+                      </TableHead>
+                      <TableHead className="text-right">
+                        {t("classRanking.colDelta")}
+                      </TableHead>
+                    </TableRow>
+                  </TableHeader>
+                  <TableBody>
+                    {classRankings.map((c) => {
+                      const isUp = c.delta > 0;
+                      const isDown = c.delta < 0;
+                      const DeltaIcon = isUp
+                        ? TrendingUp
+                        : isDown
+                          ? TrendingDown
+                          : null;
+                      return (
+                        <TableRow key={c.classId}>
+                          <TableCell className="text-muted-foreground">
+                            {c.gradeName}
+                          </TableCell>
+                          <TableCell className="font-medium">
+                            {c.className}
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums">
+                            <Badge
+                              variant={c.rank === 1 ? "default" : "secondary"}
+                              className="tabular-nums"
+                            >
+                              #{c.rank}
+                            </Badge>
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums font-medium">
+                            {formatScore(c.averageScore)}
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums">
+                            <Badge
+                              variant={
+                                c.passRate >= 90
+                                  ? "default"
+                                  : c.passRate >= 75
+                                    ? "secondary"
+                                    : "outline"
+                              }
+                              className="tabular-nums"
+                            >
+                              {formatScore(c.passRate)}%
+                            </Badge>
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums">
+                            {formatCount(c.studentCount)}
+                          </TableCell>
+                          <TableCell className="text-right tabular-nums">
+                            {DeltaIcon ? (
+                              <span
+                                className={
+                                  isUp
+                                    ? "inline-flex items-center gap-1 text-emerald-600 dark:text-emerald-400"
+                                    : "inline-flex items-center gap-1 text-rose-600 dark:text-rose-400"
+                                }
+                              >
+                                <DeltaIcon
+                                  className="size-3"
+                                  aria-hidden="true"
+                                />
+                                {isUp ? "+" : ""}
+                                {formatScore(c.delta)}
+                              </span>
+                            ) : (
+                              <span className="text-muted-foreground">0.0</span>
+                            )}
+                          </TableCell>
+                        </TableRow>
+                      );
+                    })}
+                  </TableBody>
+                </Table>
+              </div>
+            )}
+          </CardContent>
+        </Card>
+      </div>
+    </ListPageShell>
+  );
+}
+
+/**
+ * 全校汇总卡片（对齐 CICD SchoolWideSummaryCard）。
+ *
+ * 由 4 张 StatCard 组成：平均分 / 及格率 / 优秀率 / 参考人数。
+ * 入参 overall 为空时各指标回退占位符（§11.3 DoD 三态规范）。
+ */
+function SchoolWideSummaryCard({
+  overall,
+}: {
+  overall: SchoolWideOverallStats | null | undefined;
+}): React.ReactElement {
+  const t = useTranslations("admin.school.grades.insights");
+  return (
+    <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-4">
+      <StatCard
+        title={t("stats.averageScore")}
+        value={formatScore(overall?.averageScore)}
+        icon={TrendingUp}
+        description={t("stats.averageScoreHint")}
+        valueClassName="tabular-nums"
+      />
+      <StatCard
+        title={t("stats.passRate")}
+        value={`${formatScore(overall?.passRate)}%`}
+        icon={CheckCircle2}
+        description={t("stats.passRateHint")}
+        valueClassName="tabular-nums"
+      />
+      <StatCard
+        title={t("stats.excellenceRate")}
+        value={`${formatScore(overall?.excellenceRate)}%`}
+        icon={Award}
+        description={t("stats.excellenceRateHint")}
+        valueClassName="tabular-nums"
+      />
+      <StatCard
+        title={t("stats.totalParticipants")}
+        value={formatCount(overall?.totalParticipants)}
+        icon={Users}
+        description={t("stats.totalParticipantsHint")}
+        valueClassName="tabular-nums"
+      />
+    </div>
+  );
+}
+
+/**
+ * 作业状态 → i18n 标签。
+ * 已知状态走 i18n key，未知状态回退为原始字符串（避免 next-intl 抛 MISSING_MESSAGE 错误）。
+ */
+function assignmentStatusToLabel(
+  status: string,
+  t: ReturnType<typeof useTranslations>,
+): string {
+  switch (status) {
+    case "graded":
+      return t("assignments.status.graded");
+    case "submitted":
+      return t("assignments.status.submitted");
+    case "pending":
+      return t("assignments.status.pending");
+    case "draft":
+      return t("assignments.status.draft");
+    default:
+      return status;
+  }
+}
diff --git a/apps/portal-shell/src/features/admin/school/grades-client.tsx b/apps/portal-shell/src/features/admin/school/grades-client.tsx
index 2fcef1c..417dc03 100644
--- a/apps/portal-shell/src/features/admin/school/grades-client.tsx
+++ b/apps/portal-shell/src/features/admin/school/grades-client.tsx
@@ -14,10 +14,18 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { GraduationCap, Pencil, Plus, Trash2, Users } from "lucide-react";
+import {
+  BarChart3,
+  GraduationCap,
+  Pencil,
+  Plus,
+  Trash2,
+  Users,
+} from "lucide-react";
 import { useSearchParams, useRouter } from "next/navigation";
 import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
+import Link from "next/link";
 
 // 直接从 admin-p5 导入，避免与 ./grades 的 GradeListItem/useCreateGrade 命名冲突
 import {
@@ -26,14 +34,24 @@ import {
   useGradeOverviewStats,
   useGrades,
   useSchools,
+  useStaffOptions,
   useUpdateGrade,
   type AdminGradeListItem,
   type GradeInput,
   type GradeOverviewStat,
+  type OptionItem,
   type SchoolListItem,
 } from "@/lib/api/admin-p5";
 import { notify } from "@/shared/lib/notify";
 import { Button } from "@/shared/components/ui/button";
+import { Card, CardContent } from "@/shared/components/ui/card";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import { Input } from "@/shared/components/ui/input";
@@ -70,6 +88,8 @@ export function GradesClient(): React.ReactElement {
   // @contract-pending：MSW 兜底
   const { data: stats, loading: statsLoading } = useGradeOverviewStats();
   const { data: schools } = useSchools();
+  // @contract-pending：MSW 兜底
+  const { data: staffOptions } = useStaffOptions();
   const createMutation = useAdminCreateGrade();
   const updateMutation = useUpdateGrade();
   const deleteMutation = useDeleteGrade();
@@ -88,6 +108,14 @@ export function GradesClient(): React.ReactElement {
     return map;
   }, [schools]);
 
+  const statsMap = useMemo<Map<string, GradeOverviewStat>>(() => {
+    const map = new Map<string, GradeOverviewStat>();
+    for (const s of stats ?? []) {
+      map.set(s.gradeId, s);
+    }
+    return map;
+  }, [stats]);
+
   const filteredItems = useMemo<AdminGradeListItem[]>(() => {
     const items = data ?? [];
     return items.filter((g) => {
@@ -178,15 +206,23 @@ export function GradesClient(): React.ReactElement {
       description={t("description")}
       icon={<GraduationCap className="size-6" />}
       actions={
-        <Button
-          onClick={() => {
-            setEditTarget(null);
-            setFormOpen(true);
-          }}
-        >
-          <Plus className="mr-1 size-4" />
-          {t("createButton")}
-        </Button>
+        <div className="flex gap-2">
+          <Button asChild variant="outline">
+            <Link href="/shell/admin/school/grades/insights">
+              <BarChart3 className="mr-1 size-4" />
+              {t("insights")}
+            </Link>
+          </Button>
+          <Button
+            onClick={() => {
+              setEditTarget(null);
+              setFormOpen(true);
+            }}
+          >
+            <Plus className="mr-1 size-4" />
+            {t("createButton")}
+          </Button>
+        </div>
       }
       filters={
         <>
@@ -223,6 +259,15 @@ export function GradesClient(): React.ReactElement {
     >
       <div className="flex flex-col gap-6">
         <GradesStatsCards stats={stats} loading={statsLoading} />
+        <GradeOverviewCards
+          items={filteredItems}
+          statsMap={statsMap}
+          onEdit={(g) => {
+            setEditTarget(g);
+            setFormOpen(true);
+          }}
+          onDelete={(g) => setDeleteTarget(g)}
+        />
         <GradesTable
           items={filteredItems}
           schoolNameMap={schoolNameMap}
@@ -237,6 +282,7 @@ export function GradesClient(): React.ReactElement {
         <GradeFormDialog
           editTarget={editTarget}
           schools={schools ?? []}
+          staffOptions={staffOptions ?? []}
           loading={createMutation.loading || updateMutation.loading}
           onClose={() => {
             setFormOpen(false);
@@ -324,6 +370,143 @@ function GradesStatsCards({
   );
 }
 
+/**
+ * 年级概览卡片视图（对齐 CICD GradeOverviewCards）。
+ *
+ * 以卡片网格展示前 8 个年级，每张卡片包含年级名称、所属学校、
+ * 班级/学生统计、平均分、年级组长以及"查看洞察"快捷入口。
+ */
+function GradeOverviewCards({
+  items,
+  statsMap,
+  onEdit,
+  onDelete,
+}: {
+  items: AdminGradeListItem[];
+  statsMap: Map<string, GradeOverviewStat>;
+  onEdit: (grade: AdminGradeListItem) => void;
+  onDelete: (grade: AdminGradeListItem) => void;
+}): React.ReactElement | null {
+  const t = useTranslations("admin.school.grades");
+  if (items.length === 0) return null;
+
+  return (
+    <section aria-label={t("gradeOverviewSection")}>
+      <h3 className="mb-3 text-sm font-medium text-muted-foreground">
+        {t("gradeOverviewSection")}
+      </h3>
+      <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
+        {items.slice(0, 8).map((g) => {
+          const stats = statsMap.get(g.id);
+          const schoolName = g.schoolName || t("notSet");
+          return (
+            <Card key={g.id} className="shadow-none">
+              <CardContent className="space-y-3 p-4">
+                <div className="flex items-start justify-between gap-2">
+                  <div className="min-w-0 flex-1">
+                    <div className="truncate text-sm font-semibold">
+                      {truncateText(g.name)}
+                    </div>
+                    <div className="truncate text-xs text-muted-foreground">
+                      {schoolName}
+                    </div>
+                  </div>
+                  <div className="flex shrink-0 gap-1">
+                    <Button
+                      variant="ghost"
+                      size="icon"
+                      className="size-7"
+                      onClick={() => onEdit(g)}
+                      aria-label={t("edit")}
+                    >
+                      <Pencil className="size-3.5" />
+                    </Button>
+                    <Button
+                      variant="ghost"
+                      size="icon"
+                      className="size-7"
+                      onClick={() => onDelete(g)}
+                      aria-label={t("delete")}
+                    >
+                      <Trash2 className="size-3.5" />
+                    </Button>
+                  </div>
+                </div>
+
+                <div className="grid grid-cols-3 gap-2 text-center">
+                  <div className="rounded-md bg-muted/50 p-2">
+                    <div className="flex items-center justify-center text-muted-foreground">
+                      <GraduationCap className="size-3" aria-hidden="true" />
+                    </div>
+                    <div className="mt-0.5 text-sm font-semibold tabular-nums">
+                      {formatCount(stats?.classCount ?? g.classCount)}
+                    </div>
+                    <div className="text-[10px] text-muted-foreground">
+                      {t("statsClassCount")}
+                    </div>
+                  </div>
+                  <div className="rounded-md bg-muted/50 p-2">
+                    <div className="flex items-center justify-center text-muted-foreground">
+                      <Users className="size-3" aria-hidden="true" />
+                    </div>
+                    <div className="mt-0.5 text-sm font-semibold tabular-nums">
+                      {formatCount(stats?.studentCount ?? g.studentCount)}
+                    </div>
+                    <div className="text-[10px] text-muted-foreground">
+                      {t("statsStudentCount")}
+                    </div>
+                  </div>
+                  <div className="rounded-md bg-muted/50 p-2">
+                    <div className="flex items-center justify-center text-muted-foreground">
+                      <BarChart3 className="size-3" aria-hidden="true" />
+                    </div>
+                    <div className="mt-0.5 text-sm font-semibold tabular-nums">
+                      {formatScore(stats?.avgScore ?? null)}
+                    </div>
+                    <div className="text-[10px] text-muted-foreground">
+                      {t("statsAvgScore")}
+                    </div>
+                  </div>
+                </div>
+
+                <div className="space-y-1 border-t pt-2 text-xs">
+                  <div className="flex items-center justify-between">
+                    <span className="text-muted-foreground">
+                      {t("colHeadStaff")}
+                    </span>
+                    <span className="truncate font-medium">
+                      {g.headStaffName || t("notSet")}
+                    </span>
+                  </div>
+                  {g.teachingHeadName ? (
+                    <div className="flex items-center justify-between">
+                      <span className="text-muted-foreground">
+                        {t("colTeachingHead")}
+                      </span>
+                      <span className="truncate font-medium">
+                        {g.teachingHeadName}
+                      </span>
+                    </div>
+                  ) : null}
+                </div>
+
+                <Button asChild variant="outline" size="sm" className="w-full">
+                  <Link
+                    href={`/shell/admin/school/grades/insights?gradeId=${encodeURIComponent(g.id)}`}
+                  >
+                    <BarChart3 className="mr-1.5 size-3.5" />
+                    {t("insights")}
+                  </Link>
+                </Button>
+              </CardContent>
+            </Card>
+          );
+        })}
+      </div>
+    </section>
+  );
+}
+
 /**
  * 年级列表表格。
  */
@@ -402,12 +585,14 @@ function GradesTable({
 function GradeFormDialog({
   editTarget,
   schools,
+  staffOptions,
   loading,
   onClose,
   onSubmit,
 }: {
   editTarget: AdminGradeListItem | null;
   schools: SchoolListItem[];
+  staffOptions: OptionItem[];
   loading: boolean;
   onClose: () => void;
   onSubmit: (id: string | null, input: GradeInput) => Promise<void>;
@@ -440,17 +625,13 @@ function GradeFormDialog({
   };
 
   return (
-    <div
-      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
-      onClick={onClose}
-    >
-      <div
-        className="w-full max-w-md rounded-xl border bg-background p-6 shadow-lg"
-        onClick={(e) => e.stopPropagation()}
-      >
-        <h2 className="mb-4 text-lg font-semibold">
-          {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
-        </h2>
+    <Dialog open onOpenChange={onClose}>
+      <DialogContent className="max-w-md">
+        <DialogHeader>
+          <DialogTitle>
+            {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
+          </DialogTitle>
+        </DialogHeader>
         <form onSubmit={handleSubmit} className="space-y-4">
           <FormField label={t("form.fieldName")} required>
             <Input
@@ -476,22 +657,29 @@ function GradeFormDialog({
             </select>
           </FormField>
           <FormField label={t("form.fieldHeadStaff")}>
-            <Input
-              type="text"
+            <select
               value={headStaffId}
               onChange={(e) => setHeadStaffId(e.target.value)}
-            />
+              className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+            >
+              <option value="">--</option>
+              {staffOptions.map((s) => (
+                <option key={s.id} value={s.id}>
+                  {s.name}
+                </option>
+              ))}
+            </select>
           </FormField>
-          <div className="flex justify-end gap-2">
+          <DialogFooter>
             <Button type="button" variant="outline" onClick={onClose}>
               {t("form.cancel")}
             </Button>
             <Button type="submit" disabled={loading}>
               {t("form.submit")}
             </Button>
-          </div>
+          </DialogFooter>
         </form>
-      </div>
-    </div>
+      </DialogContent>
+    </Dialog>
   );
 }
diff --git a/apps/portal-shell/src/features/admin/school/schools-client.tsx b/apps/portal-shell/src/features/admin/school/schools-client.tsx
index 1b43c72..7395bfa 100644
--- a/apps/portal-shell/src/features/admin/school/schools-client.tsx
+++ b/apps/portal-shell/src/features/admin/school/schools-client.tsx
@@ -13,12 +13,13 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { Building2, Plus, Trash2 } from "lucide-react";
+import { Building2, Pencil, Plus, Trash2 } from "lucide-react";
 import { useSearchParams, useRouter } from "next/navigation";
-import { useMemo, useState, useTransition } from "react";
+import { useEffect, useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
+  useAdminUpdateSchool,
   useCreateSchool,
   useDeleteSchool,
   useSchools,
@@ -26,7 +27,24 @@ import {
   type SchoolInput,
 } from "@/lib/api";
 import { notify } from "@/shared/lib/notify";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/components/ui/alert-dialog";
 import { Button } from "@/shared/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import { Input } from "@/shared/components/ui/input";
@@ -34,7 +52,10 @@ import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
-import { truncateText } from "@/features/admin/school/transformations";
+import {
+  formatSchoolDate,
+  truncateText,
+} from "@/features/admin/school/transformations";
 
 /**
  * 学校列表客户端主体。需由 server page 包裹在 <Suspense> 中
@@ -52,9 +73,11 @@ export function SchoolsClient(): React.ReactElement {
   // @contract-pending：MSW 兜底
   const { data, loading, error, refetch } = useSchools();
   const createMutation = useCreateSchool();
+  const updateMutation = useAdminUpdateSchool();
   const deleteMutation = useDeleteSchool();
 
-  const [createOpen, setCreateOpen] = useState(false);
+  const [formOpen, setFormOpen] = useState(false);
+  const [editTarget, setEditTarget] = useState<SchoolListItem | null>(null);
   const [deleteTarget, setDeleteTarget] = useState<SchoolListItem | null>(null);
 
   const filteredItems = useMemo<SchoolListItem[]>(() => {
@@ -80,11 +103,20 @@ export function SchoolsClient(): React.ReactElement {
     });
   };
 
-  const handleCreated = async (): Promise<void> => {
+  const handleSubmit = async (
+    id: string | null,
+    input: SchoolInput,
+  ): Promise<void> => {
     try {
+      if (id) {
+        await updateMutation.run(id, input);
+      } else {
+        await createMutation.run(input);
+      }
       await refetch();
-      notify.success(t("form.titleCreate"));
-      setCreateOpen(false);
+      notify.success(id ? t("form.titleEdit") : t("form.titleCreate"));
+      setFormOpen(false);
+      setEditTarget(null);
     } catch (err) {
       notify.error(tCommon("error.loadFailed", { message: String(err) }));
     }
@@ -118,7 +150,10 @@ export function SchoolsClient(): React.ReactElement {
       description={t("emptyDescription")}
       action={{
         label: t("emptyAction"),
-        onClick: () => setCreateOpen(true),
+        onClick: () => {
+          setEditTarget(null);
+          setFormOpen(true);
+        },
       }}
     />
   );
@@ -129,7 +164,12 @@ export function SchoolsClient(): React.ReactElement {
       description={t("description")}
       icon={<Building2 className="size-6" />}
       actions={
-        <Button onClick={() => setCreateOpen(true)}>
+        <Button
+          onClick={() => {
+            setEditTarget(null);
+            setFormOpen(true);
+          }}
+        >
           <Plus className="mr-1 size-4" />
           {t("createButton")}
         </Button>
@@ -154,22 +194,21 @@ export function SchoolsClient(): React.ReactElement {
     >
       <SchoolsTable
         items={filteredItems}
+        onEdit={(s) => {
+          setEditTarget(s);
+          setFormOpen(true);
+        }}
         onDelete={(s) => setDeleteTarget(s)}
       />
-      {createOpen ? (
-        <CreateSchoolDialog
-          loading={createMutation.loading}
-          onClose={() => setCreateOpen(false)}
-          onSubmit={async (input) => {
-            try {
-              await createMutation.run(input);
-              await handleCreated();
-            } catch (err) {
-              notify.error(
-                tCommon("error.loadFailed", { message: String(err) }),
-              );
-            }
+      {formOpen ? (
+        <SchoolFormDialog
+          editTarget={editTarget}
+          loading={createMutation.loading || updateMutation.loading}
+          onClose={() => {
+            setFormOpen(false);
+            setEditTarget(null);
           }}
+          onSubmit={(id, input) => handleSubmit(id, input)}
         />
       ) : null}
       {deleteTarget ? (
@@ -192,9 +231,11 @@ export function SchoolsClient(): React.ReactElement {
  */
 function SchoolsTable({
   items,
+  onEdit,
   onDelete,
 }: {
   items: SchoolListItem[];
+  onEdit: (school: SchoolListItem) => void;
   onDelete: (school: SchoolListItem) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.school.schools");
@@ -204,11 +245,13 @@ function SchoolsTable({
         <thead className="border-b bg-muted/30">
           <tr>
             <th className="p-3 text-left font-medium">{t("colName")}</th>
+            <th className="p-3 text-left font-medium">{t("colCode")}</th>
             <th className="p-3 text-left font-medium">{t("colAddress")}</th>
             <th className="p-3 text-left font-medium">{t("colPhone")}</th>
             <th className="p-3 text-left font-medium">{t("colEmail")}</th>
             <th className="p-3 text-left font-medium">{t("colCurrentYear")}</th>
             <th className="p-3 text-left font-medium">{t("colCurrentTerm")}</th>
+            <th className="p-3 text-left font-medium">{t("colUpdatedAt")}</th>
             <th className="p-3 text-right font-medium">{t("colActions")}</th>
           </tr>
         </thead>
@@ -216,6 +259,9 @@ function SchoolsTable({
           {items.map((s) => (
             <tr key={s.id} className="hover:bg-muted/30">
               <td className="p-3 font-medium">{truncateText(s.name)}</td>
+              <td className="p-3 font-mono text-xs text-muted-foreground">
+                {s.code ?? "--"}
+              </td>
               <td className="max-w-xs p-3 text-muted-foreground">
                 {truncateText(s.address, 20)}
               </td>
@@ -229,15 +275,28 @@ function SchoolsTable({
                 {s.currentAcademicYear}
               </td>
               <td className="p-3 text-muted-foreground">{s.currentTerm}</td>
+              <td className="p-3 font-mono text-xs text-muted-foreground">
+                {formatSchoolDate(s.updatedAt)}
+              </td>
               <td className="p-3 text-right">
-                <Button
-                  variant="ghost"
-                  size="sm"
-                  onClick={() => onDelete(s)}
-                  aria-label={t("delete")}
-                >
-                  <Trash2 className="size-4" />
-                </Button>
+                <div className="flex justify-end gap-1">
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onEdit(s)}
+                    aria-label={t("edit")}
+                  >
+                    <Pencil className="size-4" />
+                  </Button>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => onDelete(s)}
+                    aria-label={t("delete")}
+                  >
+                    <Trash2 className="size-4" />
+                  </Button>
+                </div>
               </td>
             </tr>
           ))}
@@ -248,30 +307,55 @@ function SchoolsTable({
 }
 
 /**
- * 新建学校对话框（轻量模态，无额外依赖）。
+ * 学校新建/编辑对话框（轻量模态，无额外依赖）。
+ * editTarget 为 null 时新建，非 null 时编辑并回填字段。
  */
-function CreateSchoolDialog({
+function SchoolFormDialog({
+  editTarget,
   loading,
   onClose,
   onSubmit,
 }: {
+  editTarget: SchoolListItem | null;
   loading: boolean;
   onClose: () => void;
-  onSubmit: (input: SchoolInput) => Promise<void>;
+  onSubmit: (id: string | null, input: SchoolInput) => Promise<void>;
 }): React.ReactElement {
   const t = useTranslations("admin.school.schools");
   const [name, setName] = useState("");
+  const [code, setCode] = useState("");
   const [address, setAddress] = useState("");
   const [phone, setPhone] = useState("");
   const [email, setEmail] = useState("");
   const [currentAcademicYear, setCurrentAcademicYear] = useState("");
   const [currentTerm, setCurrentTerm] = useState("");
 
+  useEffect(() => {
+    if (editTarget) {
+      setName(editTarget.name);
+      setCode(editTarget.code ?? "");
+      setAddress(editTarget.address);
+      setPhone(editTarget.phone);
+      setEmail(editTarget.email);
+      setCurrentAcademicYear(editTarget.currentAcademicYear);
+      setCurrentTerm(editTarget.currentTerm);
+    } else {
+      setName("");
+      setCode("");
+      setAddress("");
+      setPhone("");
+      setEmail("");
+      setCurrentAcademicYear("");
+      setCurrentTerm("");
+    }
+  }, [editTarget]);
+
   const handleSubmit = (e: React.FormEvent<HTMLFormElement>): void => {
     e.preventDefault();
     if (!name.trim()) return;
-    void onSubmit({
+    void onSubmit(editTarget?.id ?? null, {
       name: name.trim(),
+      code: code.trim() || undefined,
       address: address.trim() || undefined,
       phone: phone.trim() || undefined,
       email: email.trim() || undefined,
@@ -281,15 +365,13 @@ function CreateSchoolDialog({
   };
 
   return (
-    <div
-      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
-      onClick={onClose}
-    >
-      <div
-        className="w-full max-w-md rounded-xl border bg-background p-6 shadow-lg"
-        onClick={(e) => e.stopPropagation()}
-      >
-        <h2 className="mb-4 text-lg font-semibold">{t("form.titleCreate")}</h2>
+    <Dialog open onOpenChange={onClose}>
+      <DialogContent className="max-w-md">
+        <DialogHeader>
+          <DialogTitle>
+            {editTarget ? t("form.titleEdit") : t("form.titleCreate")}
+          </DialogTitle>
+        </DialogHeader>
         <form onSubmit={handleSubmit} className="space-y-4">
           <FormField label={t("form.fieldName")} required>
             <Input
@@ -299,6 +381,14 @@ function CreateSchoolDialog({
               required
             />
           </FormField>
+          <FormField label={t("form.fieldCode")}>
+            <Input
+              type="text"
+              value={code}
+              onChange={(e) => setCode(e.target.value)}
+              placeholder="SCH-XXX"
+            />
+          </FormField>
           <FormField label={t("form.fieldAddress")}>
             <Input
               type="text"
@@ -336,22 +426,23 @@ function CreateSchoolDialog({
               placeholder="1"
             />
           </FormField>
-          <div className="flex justify-end gap-2">
+          <DialogFooter>
             <Button type="button" variant="outline" onClick={onClose}>
               {t("form.cancel")}
             </Button>
             <Button type="submit" disabled={loading}>
               {t("form.submit")}
             </Button>
-          </div>
+          </DialogFooter>
         </form>
-      </div>
-    </div>
+      </DialogContent>
+    </Dialog>
   );
 }
 
 /**
  * 删除确认对话框（通用，复用于各子页面）。
+ * 基于 shadcn AlertDialog（§7.3 列表页模板 / §11.3 DoD）。
  */
 export function DeleteConfirmDialog({
   title,
@@ -370,32 +461,27 @@ export function DeleteConfirmDialog({
   onCancel: () => void;
   onConfirm: () => void;
 }): React.ReactElement {
+  const handleConfirm = (e: React.MouseEvent): void => {
+    e.preventDefault();
+    onConfirm();
+  };
   return (
-    <div
-      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4"
-      onClick={onCancel}
-    >
-      <div
-        className="w-full max-w-sm rounded-xl border bg-background p-6 shadow-lg"
-        onClick={(e) => e.stopPropagation()}
-      >
-        <h2 className="mb-2 text-lg font-semibold">{title}</h2>
-        <p className="mb-4 text-sm text-muted-foreground">{message}</p>
-        <div className="flex justify-end gap-2">
-          <Button type="button" variant="outline" onClick={onCancel}>
+    <AlertDialog open onOpenChange={onCancel}>
+      <AlertDialogContent>
+        <AlertDialogHeader>
+          <AlertDialogTitle>{title}</AlertDialogTitle>
+          <AlertDialogDescription>{message}</AlertDialogDescription>
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel disabled={loading} onClick={onCancel}>
             {cancelLabel}
-          </Button>
-          <Button
-            type="button"
-            variant="destructive"
-            disabled={loading}
-            onClick={onConfirm}
-          >
+          </AlertDialogCancel>
+          <AlertDialogAction onClick={handleConfirm} disabled={loading}>
             {confirmLabel}
-          </Button>
-        </div>
-      </div>
-    </div>
+          </AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
   );
 }
 
diff --git a/apps/portal-shell/src/features/admin/students/students-list-client.tsx b/apps/portal-shell/src/features/admin/students/students-list-client.tsx
index ebc57c7..ae0570d 100644
--- a/apps/portal-shell/src/features/admin/students/students-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/students/students-list-client.tsx
@@ -14,7 +14,6 @@
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 import { GraduationCap } from "lucide-react";
-import Link from "next/link";
 import { useSearchParams, useRouter } from "next/navigation";
 import { useMemo, useTransition } from "react";
 import { useTranslations } from "next-intl";
@@ -25,12 +24,14 @@ import {
   useGrades,
 } from "@/lib/api/admin-p5";
 import type { AdminStudent } from "@/lib/api/admin-p5";
+import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import { notify } from "@/shared/lib/notify";
 import {
   formatStudentDate,
   formatStudentStatus,
@@ -272,12 +273,13 @@ function StudentsTable({
                 {formatStudentDate(s.enrolledAt)}
               </td>
               <td className="p-3">
-                <Link
-                  href={`/shell/admin/students/${s.id}`}
-                  className="text-sm text-primary hover:underline"
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  onClick={() => notify.info(t("list.mswNotice"))}
                 >
                   {t("list.viewDetail")}
-                </Link>
+                </Button>
               </td>
             </tr>
           ))}
diff --git a/apps/portal-shell/src/features/admin/teachers/teachers-list-client.tsx b/apps/portal-shell/src/features/admin/teachers/teachers-list-client.tsx
index dc5e669..4589ef6 100644
--- a/apps/portal-shell/src/features/admin/teachers/teachers-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/teachers/teachers-list-client.tsx
@@ -14,19 +14,20 @@
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
 import { School } from "lucide-react";
-import Link from "next/link";
 import { useSearchParams, useRouter } from "next/navigation";
 import { useMemo, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import { useAdminTeachers, useDepartments } from "@/lib/api/admin-p5";
 import type { AdminTeacher } from "@/lib/api/admin-p5";
+import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import { notify } from "@/shared/lib/notify";
 import {
   formatTeacherStatus,
   matchTeacherSearch,
@@ -242,12 +243,13 @@ function TeachersTable({
               </td>
               <td className="p-3 text-muted-foreground">{tc.classCount}</td>
               <td className="p-3">
-                <Link
-                  href={`/shell/admin/teachers/${tc.id}`}
-                  className="text-sm text-primary hover:underline"
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  onClick={() => notify.info(t("list.mswNotice"))}
                 >
                   {t("list.viewDetail")}
-                </Link>
+                </Button>
               </td>
             </tr>
           ))}
diff --git a/apps/portal-shell/src/features/admin/users/user-role-assign-dialog.tsx b/apps/portal-shell/src/features/admin/users/user-role-assign-dialog.tsx
new file mode 100644
index 0000000..2b090b6
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/users/user-role-assign-dialog.tsx
@@ -0,0 +1,227 @@
+"use client";
+
+/**
+ * 用户多角色分配对话框（ARCHITECTURE.md §9.4 B5 / §11.3）
+ *
+ * 数据契约：
+ * - mutation assignUserRoles(userId, roleNames) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 替换语义：传入完整角色名数组，覆盖原有角色
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ * 对齐 CICD：src/modules/rbac/components/user-role-assign-dialog.tsx
+ */
+import { UserCog } from "lucide-react";
+import { useEffect, useState } from "react";
+import { useRouter } from "next/navigation";
+import { useTranslations } from "next-intl";
+
+import { useAssignUserRoles } from "@/lib/api";
+import { Button } from "@/shared/components/ui/button";
+import { notify } from "@/shared/lib/notify";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/components/ui/dialog";
+import { Alert, AlertDescription } from "@/shared/components/ui/alert";
+
+/** 可分配角色条目（与 roles 列表对齐） */
+export interface AssignableRole {
+  id: string;
+  name: string;
+  description: string;
+  isSystem: boolean;
+  isEnabled: boolean;
+}
+
+export interface UserRoleAssignDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  userId: string;
+  userName: string;
+  userEmail: string;
+  /** 所有可用角色（仅 isEnabled=true 的可分配） */
+  allRoles: AssignableRole[];
+  /** 当前用户已分配的角色名列表 */
+  currentRoleNames: string[];
+}
+
+/**
+ * 多角色分配对话框。展示所有启用角色的复选框列表，
+ * 保存时按替换语义覆盖原有角色。
+ */
+export function UserRoleAssignDialog({
+  open,
+  onOpenChange,
+  userId,
+  userName,
+  userEmail,
+  allRoles,
+  currentRoleNames,
+}: UserRoleAssignDialogProps): React.ReactElement | null {
+  const t = useTranslations("admin.users.assignDialog");
+  const tCommon = useTranslations("common");
+  const router = useRouter();
+  const assignRoles = useAssignUserRoles();
+
+  const [selected, setSelected] = useState<Set<string>>(
+    new Set(currentRoleNames),
+  );
+
+  // 打开时同步当前角色
+  useEffect(() => {
+    if (open) {
+      setSelected(new Set(currentRoleNames));
+    }
+  }, [open, currentRoleNames]);
+
+  const handleToggle = (roleName: string, checked: boolean): void => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (checked) {
+        next.add(roleName);
+      } else {
+        next.delete(roleName);
+      }
+      return next;
+    });
+  };
+
+  const handleSave = async (): Promise<void> => {
+    try {
+      await assignRoles.run(userId, Array.from(selected));
+      notify.success(t("success"));
+      onOpenChange(false);
+      router.refresh();
+    } catch (err) {
+      notify.error(tCommon("error.operationFailed", { message: String(err) }));
+    }
+  };
+
+  // 仅启用的角色可分配；禁用但已分配的展示在底部
+  const enabledRoles = allRoles.filter((r) => r.isEnabled);
+  const disabledAssignedRoles = allRoles.filter(
+    (r) => !r.isEnabled && selected.has(r.name),
+  );
+
+  if (!open) {
+    return null;
+  }
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle className="flex items-center gap-2">
+            <UserCog className="size-5" />
+            {t("title")}
+          </DialogTitle>
+          <DialogDescription>
+            {t("description", { name: userName || userEmail })}
+          </DialogDescription>
+        </DialogHeader>
+
+        {selected.has("admin") ? (
+          <Alert className="border-amber-500/50 bg-amber-500/10 text-amber-700 dark:text-amber-400">
+            <AlertDescription>
+              <strong className="font-medium">{t("adminWarningTitle")}</strong>
+              {t("adminWarning")}
+            </AlertDescription>
+          </Alert>
+        ) : null}
+
+        <div
+          className="max-h-96 space-y-3 overflow-y-auto"
+          role="group"
+          aria-label={t("listAriaLabel", { name: userName || userEmail })}
+        >
+          {enabledRoles.length === 0 ? (
+            <p className="py-4 text-center text-sm text-muted-foreground">
+              {t("noEnabledRoles")}
+            </p>
+          ) : null}
+
+          {enabledRoles.map((role) => {
+            const isChecked = selected.has(role.name);
+            const isAdmin = role.name === "admin";
+            return (
+              <label
+                key={role.id}
+                htmlFor={`role-${role.id}`}
+                className="flex cursor-pointer items-start gap-3 rounded-md border p-3 hover:bg-accent"
+              >
+                <input
+                  id={`role-${role.id}`}
+                  type="checkbox"
+                  checked={isChecked}
+                  onChange={(e) => handleToggle(role.name, e.target.checked)}
+                  disabled={assignRoles.loading}
+                  className="mt-0.5 size-4 rounded border-input accent-primary"
+                />
+                <div className="min-w-0 flex-1 space-y-0.5">
+                  <div className="flex items-center gap-2">
+                    <span className="text-sm font-medium">{role.name}</span>
+                    {role.isSystem ? (
+                      <span className="inline-flex h-5 items-center rounded-full bg-muted px-2 text-xs">
+                        {t("system")}
+                      </span>
+                    ) : null}
+                    {isAdmin ? (
+                      <span className="inline-flex h-5 items-center rounded-full bg-destructive/15 px-2 text-xs text-destructive">
+                        {t("locked")}
+                      </span>
+                    ) : null}
+                  </div>
+                  {role.description ? (
+                    <p className="text-xs text-muted-foreground">
+                      {role.description}
+                    </p>
+                  ) : null}
+                </div>
+              </label>
+            );
+          })}
+
+          {disabledAssignedRoles.length > 0 ? (
+            <div className="space-y-1 border-t pt-2">
+              <p className="text-xs text-muted-foreground">
+                {t("disabledAssignedLabel")}
+              </p>
+              {disabledAssignedRoles.map((role) => (
+                <div key={role.id} className="flex items-center gap-2 text-xs">
+                  <span className="inline-flex h-5 items-center rounded-full border px-2">
+                    {role.name}
+                  </span>
+                  <span className="text-muted-foreground">
+                    {t("disabledLabel")}
+                  </span>
+                </div>
+              ))}
+            </div>
+          ) : null}
+        </div>
+
+        <DialogFooter>
+          <Button
+            type="button"
+            variant="outline"
+            onClick={() => onOpenChange(false)}
+            disabled={assignRoles.loading}
+          >
+            {tCommon("button.cancel")}
+          </Button>
+          <Button
+            type="button"
+            onClick={handleSave}
+            disabled={assignRoles.loading}
+          >
+            {assignRoles.loading ? t("saving") : t("save")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/users/users-import-client.tsx b/apps/portal-shell/src/features/admin/users/users-import-client.tsx
index 8f5c6b5..79ddc59 100644
--- a/apps/portal-shell/src/features/admin/users/users-import-client.tsx
+++ b/apps/portal-shell/src/features/admin/users/users-import-client.tsx
@@ -11,7 +11,14 @@
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
  */
-import { CheckCircle2, Download, Upload, XCircle } from "lucide-react";
+import {
+  CheckCircle2,
+  Download,
+  Loader2,
+  RotateCcw,
+  Upload,
+  XCircle,
+} from "lucide-react";
 import { useState } from "react";
 import { useTranslations } from "next-intl";
 
@@ -50,6 +57,9 @@ const TEMPLATE_HEADERS = [
   "inviteCode",
 ] as const;
 
+/** 预览最大行数 */
+const PREVIEW_MAX_ROWS = 50;
+
 /**
  * 生成并下载 CSV 模板（纯客户端，无契约依赖）。
  */
@@ -66,6 +76,28 @@ function downloadTemplate(): void {
   URL.revokeObjectURL(url);
 }
 
+/**
+ * 解析文件文本为预览行（仅前 PREVIEW_MAX_ROWS 行）。
+ * 支持 CSV 简易分割；Excel 二进制文件回退为按行文本展示。
+ */
+function parsePreviewRows(file: File): Promise<string[][]> {
+  return new Promise((resolve) => {
+    const reader = new FileReader();
+    reader.onload = () => {
+      const text = String(reader.result ?? "");
+      const lines = text.split(/\r?\n/).filter((line) => line.trim() !== "");
+      const rows = lines.slice(0, PREVIEW_MAX_ROWS).map((line) =>
+        // 简易 CSV 分割，不处理引号嵌套（预览用途足够）
+        line.split(",").map((cell) => cell.trim()),
+      );
+      resolve(rows);
+    };
+    reader.onerror = () => resolve([]);
+    // Excel 文件读取为文本会有乱码，但仅用于展示前几行结构
+    reader.readAsText(file);
+  });
+}
+
 /**
  * 导入客户端主体。
  */
@@ -74,6 +106,8 @@ export function UsersImportClient(): React.ReactElement {
   const { run, loading } = useImportUsers();
   const [selectedFile, setSelectedFile] = useState<File | null>(null);
   const [result, setResult] = useState<ImportResult | null>(null);
+  const [previewRows, setPreviewRows] = useState<string[][]>([]);
+  const [importing, setImporting] = useState(false);
 
   const handleDownload = (): void => {
     try {
@@ -89,19 +123,43 @@ export function UsersImportClient(): React.ReactElement {
     const file = e.target.files?.[0];
     if (!file) return;
     setSelectedFile(file);
+    setResult(null);
     try {
-      const r = await run(file);
-      setResult(r);
-      notify.success(t("imported"));
-    } catch (e) {
-      notify.error(String(e));
+      const rows = await parsePreviewRows(file);
+      setPreviewRows(rows);
+    } catch {
+      setPreviewRows([]);
     } finally {
       // 允许重复选择同一文件触发 onChange
       e.target.value = "";
     }
   };
 
+  const handleReselect = (): void => {
+    setSelectedFile(null);
+    setResult(null);
+    setPreviewRows([]);
+  };
+
+  const handleConfirmImport = async (): Promise<void> => {
+    if (!selectedFile) return;
+    setImporting(true);
+    try {
+      const r = await run(selectedFile);
+      setResult(r);
+      setPreviewRows([]);
+      notify.success(t("imported"));
+    } catch (e) {
+      notify.error(String(e));
+    } finally {
+      setImporting(false);
+    }
+  };
+
   const steps = [t("step1"), t("step2"), t("step3"), t("step4")];
+  const showPreview =
+    selectedFile && previewRows.length > 0 && !result && !importing;
+  const showImporting = importing || (loading && !!selectedFile && !result);
 
   return (
     <div className="flex flex-col gap-6">
@@ -187,25 +245,81 @@ export function UsersImportClient(): React.ReactElement {
               {t("uploadButton")}
               <input
                 type="file"
-                accept=".csv"
-                disabled={loading}
+                accept=".csv,.xlsx,.xls"
+                disabled={showImporting}
                 onChange={handleFileChange}
                 className="hidden"
               />
             </label>
             <p className="text-xs text-muted-foreground">{t("uploadHint")}</p>
             {selectedFile ? (
-              <p className="text-xs text-muted-foreground">
-                {selectedFile.name}（{selectedFile.size} bytes）
-              </p>
+              <div className="flex flex-wrap items-center gap-3">
+                <p className="text-xs text-muted-foreground">
+                  {selectedFile.name}（{selectedFile.size} bytes）
+                </p>
+                <Button
+                  type="button"
+                  variant="outline"
+                  size="sm"
+                  onClick={handleReselect}
+                  disabled={showImporting}
+                >
+                  <RotateCcw className="size-3" />
+                  {t("reselect")}
+                </Button>
+              </div>
             ) : null}
-            {loading ? (
-              <p className="text-xs text-muted-foreground">...</p>
+            {showImporting ? (
+              <p className="inline-flex items-center gap-2 text-xs text-muted-foreground">
+                <Loader2 className="size-4 animate-spin" />
+                {t("importStatus")}
+              </p>
             ) : null}
           </div>
         </CardContent>
       </Card>
 
+      {/* 文件预览（前 50 行） */}
+      {showPreview ? (
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-base">
+              {t("filesPreview", { count: previewRows.length })}
+            </CardTitle>
+          </CardHeader>
+          <CardContent>
+            <div className="overflow-x-auto rounded-lg border">
+              <table className="w-full text-sm">
+                <tbody className="divide-y">
+                  {previewRows.map((row, idx) => (
+                    <tr
+                      key={idx}
+                      className={idx === 0 ? "bg-muted/30 font-medium" : ""}
+                    >
+                      {row.map((cell, j) => (
+                        <td key={j} className="p-2 font-mono text-xs">
+                          {cell}
+                        </td>
+                      ))}
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+            <div className="mt-3 flex justify-end">
+              <Button
+                type="button"
+                onClick={handleConfirmImport}
+                disabled={showImporting}
+              >
+                <Upload className="size-4" />
+                {t("confirmImport")}
+              </Button>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
       {/* 步骤 4：查看结果 */}
       {result ? (
         <Card>
diff --git a/apps/portal-shell/src/features/admin/users/users-list-client.tsx b/apps/portal-shell/src/features/admin/users/users-list-client.tsx
index ff010b4..7d24d85 100644
--- a/apps/portal-shell/src/features/admin/users/users-list-client.tsx
+++ b/apps/portal-shell/src/features/admin/users/users-list-client.tsx
@@ -5,7 +5,7 @@
  *
  * 数据契约：
  * - 列表查询 users(role, limit, offset) ❌ schema 无此字段 → MSW 兜底（@contract-pending）
- * - 变更 updateUserStatus / updateUserRole ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - 变更 updateUserStatus / updateUserRole / deleteUser / assignUserRoles ❌ schema 无 → MSW 兜底（@contract-pending）
  * - 契约工单：docs/architecture/issues/contracts/iam_contract.md#users
  *
  * URL 状态：?search=&role=&page=
@@ -13,25 +13,49 @@
  * 三态规范（§11.3 DoD）：loading（骨架）/ error（局部降级）/ empty（EmptyState + 行动按钮）
  *
  * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ * 对齐 CICD：src/modules/users/components/admin-users-view.tsx
  */
-import { Users } from "lucide-react";
+import {
+  Users,
+  Upload,
+  MoreHorizontal,
+  Trash2,
+  Pencil,
+  UserCog,
+  RotateCcw,
+} from "lucide-react";
+import Link from "next/link";
 import { useSearchParams, useRouter } from "next/navigation";
 import { useMemo, useState, useTransition } from "react";
 import { useTranslations } from "next-intl";
 
 import {
+  useDeleteUser,
+  useRoles,
   useUpdateUserRole,
   useUpdateUserStatus,
   useUsers,
   type User,
 } from "@/lib/api";
 import { notify } from "@/shared/lib/notify";
+import { Button } from "@/shared/components/ui/button";
 import { EmptyState } from "@/shared/components/ui/empty-state";
 import { FilterSearchInput } from "@/shared/components/ui/filter-bar";
 import {
   ListPageShell,
   ListPageSkeleton,
 } from "@/shared/components/page-templates";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/shared/components/ui/dropdown-menu";
+import { ConfirmDeleteDialog } from "@/shared/components/ui/confirm-delete-dialog";
+import {
+  UserRoleAssignDialog,
+  type AssignableRole,
+} from "@/features/admin/users/user-role-assign-dialog";
 import {
   USER_ROLE_OPTIONS,
   formatUserDate,
@@ -71,15 +95,35 @@ export function UsersListClient(): React.ReactElement {
     offset,
   });
 
+  // 拉取角色列表供多角色分配对话框使用
+  const { data: rolesData } = useRoles();
+
   const updateUserStatus = useUpdateUserStatus();
   const updateUserRole = useUpdateUserRole();
+  const deleteUser = useDeleteUser();
   const [pendingId, setPendingId] = useState<string | null>(null);
+  const [deleteTarget, setDeleteTarget] = useState<User | null>(null);
+  const [assignTarget, setAssignTarget] = useState<User | null>(null);
 
   const filteredItems = useMemo<User[]>(() => {
     const items = data?.items ?? [];
     return items.filter((u) => matchUserSearch(u, search));
   }, [data, search]);
 
+  // 将 roles 数据映射为 AssignableRole（兼容旧 Role 结构）
+  const assignableRoles: AssignableRole[] = useMemo(() => {
+    if (!rolesData) {
+      return [];
+    }
+    return rolesData.map((r) => ({
+      id: r.id,
+      name: r.name,
+      description: r.description ?? "",
+      isSystem: r.isLocked ?? false,
+      isEnabled: true,
+    }));
+  }, [rolesData]);
+
   const total = data?.total ?? filteredItems.length;
   const hasNext = page * PAGE_SIZE < total;
   const hasPrev = page > 1;
@@ -111,6 +155,12 @@ export function UsersListClient(): React.ReactElement {
     });
   };
 
+  const handleReset = (): void => {
+    startTransition(() => {
+      router.push("/shell/admin/users");
+    });
+  };
+
   const handleRoleChange = async (
     user: User,
     newRole: string,
@@ -140,6 +190,21 @@ export function UsersListClient(): React.ReactElement {
     }
   };
 
+  const handleDelete = async (): Promise<void> => {
+    if (!deleteTarget) return;
+    setPendingId(deleteTarget.id);
+    try {
+      await deleteUser.run(deleteTarget.id);
+      notify.success(t("list.deleted"));
+      setDeleteTarget(null);
+      router.refresh();
+    } catch (e) {
+      notify.error(String(e));
+    } finally {
+      setPendingId(null);
+    }
+  };
+
   const errorNode = error ? (
     <div className="rounded-xl border border-destructive/30 bg-destructive/5 p-6 text-center">
       <p className="text-sm text-destructive">
@@ -168,6 +233,14 @@ export function UsersListClient(): React.ReactElement {
       title={t("list.title")}
       description={t("list.description")}
       icon={<Users className="size-6" />}
+      actions={
+        <Button asChild>
+          <Link href="/shell/admin/users/import">
+            <Upload className="mr-2 size-4" />
+            {t("list.importButton")}
+          </Link>
+        </Button>
+      }
       filters={
         <>
           <FilterSearchInput
@@ -188,6 +261,17 @@ export function UsersListClient(): React.ReactElement {
               </option>
             ))}
           </select>
+          {(search || role) && (
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              onClick={handleReset}
+            >
+              <RotateCcw className="mr-1 size-3" />
+              {t("list.reset")}
+            </Button>
+          )}
         </>
       }
       loading={loading}
@@ -197,7 +281,7 @@ export function UsersListClient(): React.ReactElement {
       errorNode={errorNode}
       pagination={
         <div className="flex items-center justify-end gap-3 text-sm text-muted-foreground">
-          <span>{t("list.total", { count: filteredItems.length })}</span>
+          <span>{t("list.total", { count: total })}</span>
           <div className="flex gap-1">
             <button
               type="button"
@@ -225,26 +309,63 @@ export function UsersListClient(): React.ReactElement {
         pendingId={pendingId}
         onRoleChange={handleRoleChange}
         onToggleStatus={handleToggleStatus}
+        onAssignRoles={(u) => setAssignTarget(u)}
+        onDelete={(u) => setDeleteTarget(u)}
       />
+
+      <ConfirmDeleteDialog
+        open={!!deleteTarget}
+        onOpenChange={(v) => !v && setDeleteTarget(null)}
+        title={t("list.deleteConfirmTitle")}
+        description={t("list.deleteConfirmDescription", {
+          name: deleteTarget?.name ?? "",
+          email: deleteTarget?.email ?? "",
+        })}
+        confirmText={t("list.confirmDelete")}
+        cancelText={tCommon("button.cancel")}
+        onConfirm={handleDelete}
+        isWorking={pendingId === deleteTarget?.id}
+      />
+
+      {assignTarget && assignableRoles.length > 0 ? (
+        <UserRoleAssignDialog
+          open={!!assignTarget}
+          onOpenChange={(v) => !v && setAssignTarget(null)}
+          userId={assignTarget.id}
+          userName={assignTarget.name}
+          userEmail={assignTarget.email}
+          allRoles={assignableRoles}
+          currentRoleNames={
+            assignTarget.roles && assignTarget.roles.length > 0
+              ? assignTarget.roles
+              : [assignTarget.role]
+          }
+        />
+      ) : null}
     </ListPageShell>
   );
 }
 
 /**
- * 用户列表表格（纯展示组件，对齐 §8.2 排版规范）。
+ * 用户列表表格（含下拉菜单操作）。
  */
 function UsersTable({
   items,
   pendingId,
   onRoleChange,
   onToggleStatus,
+  onAssignRoles,
+  onDelete,
 }: {
   items: User[];
   pendingId: string | null;
   onRoleChange: (user: User, newRole: string) => void;
   onToggleStatus: (user: User) => void;
+  onAssignRoles: (user: User) => void;
+  onDelete: (user: User) => void;
 }): React.ReactElement {
   const t = useTranslations("admin.users");
+  const router = useRouter();
   return (
     <div className="overflow-x-auto rounded-xl border">
       <table className="w-full text-sm">
@@ -253,60 +374,112 @@ function UsersTable({
             <th className="p-3 text-left font-medium">{t("list.colName")}</th>
             <th className="p-3 text-left font-medium">{t("list.colEmail")}</th>
             <th className="p-3 text-left font-medium">{t("list.colRole")}</th>
+            <th className="p-3 text-left font-medium">{t("list.colPhone")}</th>
             <th className="p-3 text-left font-medium">{t("list.colStatus")}</th>
             <th className="p-3 text-left font-medium">
               {t("list.colCreatedAt")}
             </th>
+            <th className="p-3 text-left font-medium">
+              {t("list.colUpdatedAt")}
+            </th>
             <th className="p-3 text-left font-medium">
               {t("list.colActions")}
             </th>
           </tr>
         </thead>
         <tbody className="divide-y">
-          {items.map((u) => (
-            <tr key={u.id} className="hover:bg-muted/30">
-              <td className="p-3 font-medium">{truncateUserName(u.name)}</td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {u.email}
-              </td>
-              <td className="p-3">
-                <RoleBadge role={u.role} />
-              </td>
-              <td className="p-3">
-                <StatusBadge status={u.status} />
-              </td>
-              <td className="p-3 font-mono text-xs text-muted-foreground">
-                {formatUserDate(u.createdAt)}
-              </td>
-              <td className="p-3">
-                <div className="flex items-center gap-2">
-                  <select
-                    value={u.role}
-                    aria-label={t("list.editRole")}
-                    disabled={pendingId === u.id}
-                    onChange={(e) => onRoleChange(u, e.target.value)}
-                    className="h-8 rounded-md border border-input bg-background px-2 text-xs disabled:opacity-50"
-                  >
-                    {USER_ROLE_OPTIONS.map((opt) => (
-                      <option key={opt.value} value={opt.value}>
-                        {opt.label}
-                      </option>
+          {items.map((u) => {
+            const roleList = u.roles && u.roles.length > 0 ? u.roles : [u.role];
+            return (
+              <tr key={u.id} className="hover:bg-muted/30">
+                <td className="p-3 font-medium">
+                  <div className="flex items-center gap-2">
+                    <span>{truncateUserName(u.name)}</span>
+                    {u.userType ? (
+                      <UserTypeBadge userType={u.userType} />
+                    ) : null}
+                  </div>
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {u.email}
+                </td>
+                <td className="p-3">
+                  <div className="flex flex-wrap gap-1">
+                    {roleList.map((r) => (
+                      <RoleBadge key={r} role={r} />
                     ))}
-                  </select>
-                  <button
-                    type="button"
-                    disabled={pendingId === u.id}
-                    onClick={() => onToggleStatus(u)}
-                    className="h-8 rounded-md border border-input bg-background px-2 text-xs transition-colors hover:bg-accent disabled:opacity-50"
-                  >
-                    {isUserActive(u)
-                      ? t("list.deactivate")
-                      : t("list.activate")}
-                  </button>
-                </div>
-              </td>
-            </tr>
-          ))}
+                  </div>
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {u.phone ?? "-"}
+                </td>
+                <td className="p-3">
+                  <StatusBadge status={u.status} />
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {formatUserDate(u.createdAt)}
+                </td>
+                <td className="p-3 font-mono text-xs text-muted-foreground">
+                  {formatUserDate(u.updatedAt)}
+                </td>
+                <td className="p-3">
+                  <DropdownMenu>
+                    <DropdownMenuTrigger asChild>
+                      <Button
+                        variant="ghost"
+                        size="sm"
+                        disabled={pendingId === u.id}
+                        aria-label={t("list.actionsMenu")}
+                      >
+                        <MoreHorizontal className="size-4" />
+                      </Button>
+                    </DropdownMenuTrigger>
+                    <DropdownMenuContent align="end">
+                      <DropdownMenuItem
+                        onClick={() =>
+                          router.push(`/shell/admin/users/${u.id}`)
+                        }
+                      >
+                        <Pencil className="mr-2 size-4" />
+                        {t("list.editUser")}
+                      </DropdownMenuItem>
+                      <DropdownMenuItem
+                        onClick={() => onToggleStatus(u)}
+                        disabled={pendingId === u.id}
+                      >
+                        <Pencil className="mr-2 size-4" />
+                        {isUserActive(u)
+                          ? t("list.deactivate")
+                          : t("list.activate")}
+                      </DropdownMenuItem>
+                      <DropdownMenuItem
+                        onClick={() => onAssignRoles(u)}
+                        disabled={pendingId === u.id}
+                      >
+                        <UserCog className="mr-2 size-4" />
+                        {t("list.assignRoles")}
+                      </DropdownMenuItem>
+                      <DropdownMenuItem
+                        onClick={() => onRoleChange(u, "teacher")}
+                        disabled={pendingId === u.id}
+                      >
+                        <UserCog className="mr-2 size-4" />
+                        {t("list.quickSetTeacher")}
+                      </DropdownMenuItem>
+                      <DropdownMenuItem
+                        onClick={() => onDelete(u)}
+                        disabled={pendingId === u.id}
+                        className="text-destructive"
+                      >
+                        <Trash2 className="mr-2 size-4" />
+                        {t("list.delete")}
+                      </DropdownMenuItem>
+                    </DropdownMenuContent>
+                  </DropdownMenu>
+                </td>
+              </tr>
+            );
+          })}
         </tbody>
       </table>
     </div>
@@ -342,3 +515,25 @@ function StatusBadge({ status }: { status: string }): React.ReactElement {
     </span>
   );
 }
+
+/**
+ * 用户类型徽章（internal/external）。
+ */
+function UserTypeBadge({ userType }: { userType: string }): React.ReactElement {
+  const t = useTranslations("admin.users");
+  const isInternal = userType === "internal";
+  const label = isInternal
+    ? t("list.userTypeInternal")
+    : t("list.userTypeExternal");
+  const cls = isInternal
+    ? "bg-primary/10 text-primary"
+    : "bg-muted text-muted-foreground";
+  return (
+    <span
+      className={`inline-flex h-5 items-center rounded-full px-2 text-xs font-medium ${cls}`}
+      aria-label={label}
+    >
+      {label}
+    </span>
+  );
+}
diff --git a/apps/portal-shell/src/features/admin/viewports/viewports-client.tsx b/apps/portal-shell/src/features/admin/viewports/viewports-client.tsx
index d3f86bb..6ea25db 100644
--- a/apps/portal-shell/src/features/admin/viewports/viewports-client.tsx
+++ b/apps/portal-shell/src/features/admin/viewports/viewports-client.tsx
@@ -245,6 +245,7 @@ function ViewportEditDialog({
   onSave: (input: ViewportInput) => Promise<void>;
 }): React.ReactElement {
   const t = useTranslations("admin.viewports.list");
+  const tCommon = useTranslations("common");
 
   const [name, setName] = useState("");
   const [route, setRoute] = useState("");
@@ -332,7 +333,7 @@ function ViewportEditDialog({
           </FormField>
           <div className="flex justify-end gap-2 border-t pt-4">
             <Button variant="outline" onClick={onClose}>
-              {tCommon0("button.cancel")}
+              {tCommon("button.cancel")}
             </Button>
             <Button onClick={handleSubmit} disabled={submitting}>
               {t("saveButton")}
@@ -344,17 +345,6 @@ function ViewportEditDialog({
   );
 }
 
-/**
- * 模拟 useTranslations("common") 在编辑对话框内的访问。
- * 注：因该组件嵌套较深，使用辅助函数避免在子组件内重复声明。
- */
-function tCommon0(key: string): string {
-  // 简化处理：直接返回 key 的最后一段作为兜底文案。
-  // 真实场景应通过 useTranslations("common") 获取。
-  void key;
-  return "取消";
-}
-
 /**
  * 表单字段容器（label + children）。
  */
diff --git a/apps/portal-shell/src/lib/api/admin-p5.ts b/apps/portal-shell/src/lib/api/admin-p5.ts
index 438a8ba..5c3aec1 100644
--- a/apps/portal-shell/src/lib/api/admin-p5.ts
+++ b/apps/portal-shell/src/lib/api/admin-p5.ts
@@ -22,14 +22,17 @@ import { useWidgetQuery } from "@/lib/useWidgetQuery";
 import { useWidgetMutation } from "@/lib/useWidgetMutation";
 import { ApiError } from "./errors";
 import type { PaginatedResult, Pagination, UseQueryResult } from "./types";
-import type { Role, SchoolInput } from "./admin";
+import type { AuditLogFilter, Role, SchoolInput } from "./admin";
 import {
   IMPORT_USERS_DOC,
   GET_ROLE_DOC,
   CREATE_ROLE_DOC,
   UPDATE_ROLE_DOC,
   DELETE_ROLE_DOC,
+  TOGGLE_ROLE_ENABLED_DOC,
   GET_PERMISSION_ROLE_COUNTS_DOC,
+  GET_ROLE_PERMISSIONS_DOC,
+  UPDATE_ROLE_PERMISSION_ACTIONS_DOC,
   GET_AUDIT_OVERVIEW_STATS_DOC,
   GET_AUDIT_TREND_DOC,
   GET_DATA_CHANGE_ACTION_STATS_DOC,
@@ -38,8 +41,12 @@ import {
   GET_DATA_CHANGE_TABLE_OPTIONS_DOC,
   GET_DATA_CHANGE_STATS_DOC,
   GET_AUDIT_MODULE_OPTIONS_DOC,
+  EXPORT_AUDIT_LOGS_DOC,
+  EXPORT_LOGIN_LOGS_DOC,
+  EXPORT_DATA_CHANGES_DOC,
   GET_SCHOOLS_DOC,
   CREATE_SCHOOL_DOC,
+  ADMIN_UPDATE_SCHOOL_DOC,
   DELETE_SCHOOL_DOC,
   GET_DEPARTMENTS_DOC,
   CREATE_DEPARTMENT_DOC,
@@ -55,6 +62,9 @@ import {
   UPDATE_GRADE_DOC,
   DELETE_GRADE_DOC,
   GET_ADMIN_CLASSES_DOC,
+  CREATE_ADMIN_CLASS_DOC,
+  UPDATE_ADMIN_CLASS_DOC,
+  DELETE_ADMIN_CLASS_DOC,
   GET_TEACHER_OPTIONS_DOC,
   GET_STAFF_OPTIONS_DOC,
   GET_ADMIN_ANNOUNCEMENTS_DOC,
@@ -64,12 +74,16 @@ import {
   DELETE_ANNOUNCEMENT_DOC,
   ARCHIVE_ANNOUNCEMENT_DOC,
   PIN_ANNOUNCEMENT_DOC,
+  PUBLISH_ANNOUNCEMENT_DOC,
   GET_FILE_ATTACHMENTS_DOC,
   GET_FILE_STATS_DOC,
+  UPLOAD_FILE_DOC,
+  BATCH_DELETE_FILES_DOC,
   GET_AI_PROVIDERS_DOC,
   CREATE_AI_PROVIDER_DOC,
   UPDATE_AI_PROVIDER_DOC,
   DELETE_AI_PROVIDER_DOC,
+  TEST_AI_PROVIDER_DOC,
   GET_AI_USAGE_DASHBOARD_DOC,
   GET_SYSTEM_SETTINGS_DOC,
   UPDATE_SYSTEM_SETTINGS_DOC,
@@ -85,9 +99,11 @@ import {
   GET_ADMIN_ELECTIVES_DOC,
   GET_ADMIN_ELECTIVE_DOC,
   GET_ADMIN_QUESTIONS_DOC,
+  GET_ADMIN_QUESTION_DOC,
   GET_ADMIN_LESSON_PLANS_DOC,
   GET_ADMIN_LESSON_PLAN_DOC,
   GET_ADMIN_ERROR_BOOK_STATS_DOC,
+  EXPORT_ERROR_BOOK_CSV_DOC,
   GET_ADMIN_SCHEDULE_CHANGES_DOC,
   GET_ADMIN_SCHEDULE_ENTRIES_DOC,
   ADMIN_GET_SCHEDULING_RULES_DOC,
@@ -98,7 +114,28 @@ import {
   GET_ADMIN_ATTENDANCE_STATS_DOC,
   GET_ADMIN_ATTENDANCE_RECORDS_DOC,
   GET_ATTENDANCE_GRADE_CORRELATION_DOC,
+  GET_AUDIT_RETENTION_CONFIG_DOC,
+  SAVE_AUDIT_RETENTION_CONFIG_DOC,
+  PURGE_EXPIRED_AUDIT_LOGS_DOC,
+  CREATE_COURSE_PLAN_ITEM_DOC,
+  UPDATE_COURSE_PLAN_ITEM_DOC,
+  DELETE_COURSE_PLAN_ITEM_DOC,
+  TOGGLE_COURSE_PLAN_ITEM_COMPLETED_DOC,
+  REORDER_COURSE_PLAN_ITEMS_DOC,
+  DELETE_COURSE_PLAN_DOC,
+  BULK_TOGGLE_COURSE_PLAN_ITEMS_DOC,
+  DELETE_ELECTIVE_DOC,
+  OPEN_ELECTIVE_SELECTION_DOC,
+  CLOSE_ELECTIVE_SELECTION_DOC,
+  RUN_ELECTIVE_LOTTERY_DOC,
+  GET_ELECTIVE_OVERVIEW_STATS_DOC,
 } from "./operations/admin.graphql";
+import {
+  CREATE_ELECTIVE_DOC,
+  UPDATE_ELECTIVE_DOC,
+} from "./operations/elective.graphql";
+
+import { SOFT_DELETE_LESSON_PLAN_DOC } from "./operations/lesson-plans.graphql";
 
 // ============================================================
 // Types: Users import
@@ -122,6 +159,41 @@ export interface RoleInput {
   name: string;
   description?: string;
   permissionIds: string[];
+  /**
+   * 角色值（如 `role:teacher`，@contract-pending：schema 未就绪，MSW 兜底）。
+   * 缺省视为未知，UI 用 `-` 占位。
+   */
+  value?: string;
+}
+
+// ============================================================
+// Types: RBAC role permission matrix (CRUD actions per permission point)
+// ============================================================
+export interface PermissionActions {
+  read: boolean;
+  create: boolean;
+  update: boolean;
+  delete: boolean;
+}
+
+/**
+ * 权限矩阵中的一个权限点条目（按模块分组，每行一个权限点，列为 CRUD 动作）。
+ *
+ * 命名说明：admin.ts 已定义 RolePermission（id/name/resource/action，
+ * 用于 Role.permissions 列表）。本类型为矩阵视图的独立结构，故显式命名为
+ * RolePermissionMatrixItem 以避免 barrel 导出冲突。
+ */
+export interface RolePermissionMatrixItem {
+  permissionId: string;
+  label: string;
+  module: string;
+  actions: PermissionActions;
+}
+
+// Input for UpdateRolePermissionActions mutation (one entry per permission point)
+export interface PermissionActionUpdate {
+  permissionId: string;
+  actions: PermissionActions;
 }
 
 // Role/RolePermission/Permission 类型由 ./admin.ts 提供（barrel 统一导出）
@@ -142,6 +214,12 @@ export interface AuditOverviewStats {
   totalToday: number;
   totalErrors: number;
   totalUsers: number;
+  /** @contract-pending 今日审计事件数（与 totalToday 含义区分，强调事件维度） */
+  auditEventsToday: number;
+  /** @contract-pending 今日失败登录次数（用于失败登录卡片高亮） */
+  failedLoginsToday: number;
+  /** @contract-pending 今日数据变更次数 */
+  dataChangesToday: number;
 }
 
 export interface AuditTrendPoint {
@@ -163,6 +241,8 @@ export interface LoginLog {
   ip: string;
   userAgent: string;
   timestamp: string;
+  /** @contract-pending 失败原因（仅 status=failure/error 时有值），MSW 兜底 */
+  errorMessage?: string | null;
 }
 
 export interface LoginLogFilter {
@@ -182,6 +262,10 @@ export interface DataChangeLog {
   userName: string;
   changes: string;
   timestamp: string;
+  /** @contract-pending 变更前快照（JSON 字符串或对象），MSW 兜底，用于行内展开对比 */
+  oldValue?: string | null;
+  /** @contract-pending 变更后快照（JSON 字符串或对象），MSW 兜底，用于行内展开对比 */
+  newValue?: string | null;
 }
 
 export interface DataChangeLogFilter {
@@ -198,6 +282,17 @@ export interface DataChangeStat {
   lastChangeAt: string;
 }
 
+/**
+ * 导出结果（CSV 字符串由 MSW 用 transformations 纯函数构造）。
+ * @contract-pending schema 未就绪，MSW 兜底返回 csv 字符串。
+ */
+export interface ExportResult {
+  success: boolean;
+  count: number;
+  filename: string;
+  csv: string;
+}
+
 // ============================================================
 // Types: School CRUD
 // ============================================================
@@ -209,6 +304,10 @@ export interface SchoolListItem {
   email: string;
   currentAcademicYear: string;
   currentTerm: string;
+  /** 学校编码（@contract-pending，MSW 兜底） */
+  code?: string;
+  /** 更新时间 ISO 字符串（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
 }
 
 export interface Department {
@@ -218,12 +317,17 @@ export interface Department {
   headId: string;
   headName: string;
   memberCount: number;
+  /** 部门描述（@contract-pending，MSW 兜底） */
+  description?: string;
+  /** 更新时间 ISO 字符串（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
 }
 
 export interface DepartmentInput {
   name: string;
   schoolId: string;
   headId?: string;
+  description?: string;
 }
 
 export interface AcademicYear {
@@ -252,6 +356,14 @@ export interface AdminGradeListItem {
   headStaffName: string;
   classCount: number;
   studentCount: number;
+  /** 年级序号（@contract-pending，MSW 兜底） */
+  order?: number;
+  /** 教学主任 ID（@contract-pending，MSW 兜底） */
+  teachingHead?: string;
+  /** 教学主任姓名（@contract-pending，MSW 兜底） */
+  teachingHeadName?: string;
+  /** 更新时间 ISO 字符串（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
 }
 
 export interface GradeInput {
@@ -279,6 +391,29 @@ export interface AdminClassListItem {
   headTeacherName: string;
   studentCount: number;
   subjectCount: number;
+  /** 班号（@contract-pending，MSW 兜底） */
+  homeroomLabel?: string;
+  /** 教室（@contract-pending，MSW 兜底） */
+  room?: string;
+  /** 班主任 ID（@contract-pending，MSW 兜底） */
+  homeroom?: string;
+  /** 班主任姓名（@contract-pending，MSW 兜底） */
+  homeroomName?: string;
+  /** 任课教师列表（@contract-pending，MSW 兜底） */
+  subjectTeachers?: string;
+  /** 更新时间 ISO 字符串（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
+}
+
+/** 班级 CRUD 输入类型（@contract-pending，MSW 兜底） */
+export interface AdminClassInput {
+  name: string;
+  gradeId: string;
+  schoolId: string;
+  headTeacherId?: string;
+  homeroomLabel?: string;
+  room?: string;
+  homeroom?: string;
 }
 
 export interface OptionItem {
@@ -300,6 +435,7 @@ export interface AnnouncementListItem {
   createdAt: string;
   updatedAt: string;
   authorName: string;
+  readCount: number;
 }
 
 export interface AnnouncementDetail extends AnnouncementListItem {
@@ -340,6 +476,23 @@ export interface FileStats {
   byType: Record<string, number>;
 }
 
+export interface UploadFileInput {
+  filename: string;
+  mimeType: string;
+  size: number;
+}
+
+export interface UploadFileResult {
+  id: string;
+  url: string;
+  filename: string;
+}
+
+export interface BatchDeleteFilesResult {
+  success: boolean;
+  deletedCount: number;
+}
+
 // ============================================================
 // Types: AI settings
 // ============================================================
@@ -350,6 +503,8 @@ export interface AiProvider {
   scope: string;
   ownerId: string;
   isActive: boolean;
+  isDefault: boolean;
+  visibility: string;
   model: string;
   apiBase: string;
   config: Record<string, unknown>;
@@ -363,6 +518,8 @@ export interface AiProviderInput {
   model: string;
   apiBase?: string;
   isActive?: boolean;
+  isDefault?: boolean;
+  visibility?: string;
   config?: Record<string, unknown>;
 }
 
@@ -485,11 +642,79 @@ export interface AdminCoursePlanListItem {
   academicYearName: string;
   status: string;
   createdAt: string;
+  /** 学期（@contract-pending，MSW 兜底，对齐 CICD 列表"学期"列） */
+  semester?: string;
+  /** 总课时（@contract-pending，MSW 兜底，用于进度条 totalHours） */
+  totalHours?: number;
+  /** 已完成课时（@contract-pending，MSW 兜底，用于进度条 completedHours） */
+  completedHours?: number;
+  /** 更新时间 ISO 字符串（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
+}
+
+/** 管理端课程计划周计划项（@contract-pending，MSW 兜底） */
+export interface AdminCoursePlanItem {
+  id: string;
+  planId: string;
+  week: number;
+  topic: string;
+  content: string | null;
+  hours: number;
+  textbookChapter: string | null;
+  notes: string | null;
+  isCompleted: boolean;
+  completedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
 }
 
 export interface AdminCoursePlan extends AdminCoursePlanListItem {
   content: string;
+  items: AdminCoursePlanItem[];
   updatedAt: string;
+  /** 教学大纲（@contract-pending，MSW 兜底，对齐 CICD 详情"教学大纲"区） */
+  syllabus?: string;
+  /** 教学目标（@contract-pending，MSW 兜底，对齐 CICD 详情"教学目标"区） */
+  objectives?: string;
+  /** 周课时（@contract-pending，MSW 兜底） */
+  weeklyHours?: number;
+  /** 计划开始日期（@contract-pending，MSW 兜底） */
+  startDate?: string;
+  /** 计划结束日期（@contract-pending，MSW 兜底） */
+  endDate?: string;
+  /** 教材链接（@contract-pending，MSW 兜底） */
+  textbooksHref?: string;
+  /** 作业链接（@contract-pending，MSW 兜底） */
+  homeworkHref?: string;
+}
+
+/** 创建/更新周计划项的输入类型（@contract-pending） */
+export interface AdminCoursePlanItemInput {
+  planId: string;
+  week: number;
+  topic: string;
+  content?: string | null;
+  hours?: number;
+  textbookChapter?: string | null;
+  notes?: string | null;
+  completedAt?: string | null;
+}
+
+/** 更新周计划项的输入类型（不含 planId，@contract-pending） */
+export interface AdminCoursePlanItemUpdateInput {
+  week?: number;
+  topic?: string;
+  content?: string | null;
+  hours?: number;
+  textbookChapter?: string | null;
+  notes?: string | null;
+  completedAt?: string | null;
+}
+
+/** 重排序周计划项的输入条目（@contract-pending） */
+export interface ReorderCoursePlanItemInput {
+  id: string;
+  week: number;
 }
 
 export interface StandardsCoverageCell {
@@ -499,6 +724,13 @@ export interface StandardsCoverageCell {
   gradeName: string;
   coverageRate: number;
   lessonPlanCount: number;
+  /**
+   * 该标准 × 年级下已关联教案的课时数（@contract-pending，MSW 兜底）。
+   * 与 lessonPlanCount 区分：lessonPlanCount 为教案条目数，total 为应覆盖总课时数。
+   */
+  total: number;
+  /** 已关联教案数别名（与 lessonPlanCount 同义，对齐 CICD linked/total 口径） */
+  linked?: number;
 }
 
 export interface GlobalLessonPlanStats {
@@ -521,6 +753,30 @@ export interface AdminElectiveListItem {
   capacity: number;
   selectedCount: number;
   status: string;
+  /** 教室（@contract-pending，MSW 兜底，对齐 CICD 列表"教室"列） */
+  classroom?: string;
+  /** 上课时间（@contract-pending，MSW 兜底，对齐 CICD 列表"时间"列） */
+  schedule?: string;
+  /** 学分（@contract-pending，MSW 兜底，对齐 CICD 列表"学分"列） */
+  credit?: number;
+  /** 选课模式（@contract-pending，MSW 兜底：FIRST_COME | LOTTERY） */
+  selectionMode?: string;
+  /** 选课开始时间 ISO（@contract-pending，MSW 兜底） */
+  selectionStartAt?: string;
+  /** 选课结束时间 ISO（@contract-pending，MSW 兜底） */
+  selectionEndAt?: string;
+  /** 退课截止时间 ISO（@contract-pending，MSW 兜底） */
+  dropDeadline?: string;
+  /** 描述（@contract-pending，MSW 兜底，列表展示用 line-clamp） */
+  description?: string;
+  /** 开始日期（@contract-pending，MSW 兜底） */
+  startDate?: string;
+  /** 结束日期（@contract-pending，MSW 兜底） */
+  endDate?: string;
+  /** 创建时间 ISO（@contract-pending，MSW 兜底） */
+  createdAt?: string;
+  /** 更新时间 ISO（@contract-pending，MSW 兜底） */
+  updatedAt?: string;
 }
 
 export interface AdminElective extends AdminElectiveListItem {
@@ -529,9 +785,104 @@ export interface AdminElective extends AdminElectiveListItem {
     studentId: string;
     studentName: string;
     selectedAt: string;
+    /** 选课状态（@contract-pending，MSW 兜底：confirmed | pending | cancelled） */
+    status?: string;
+    /** 优先级（@contract-pending，MSW 兜底，对齐 CICD 详情"优先级"列） */
+    priority?: number;
+    /** 选课时间别名（@contract-pending，MSW 兜底，与 selectedAt 同义） */
+    enrolledAt?: string;
   }>;
 }
 
+/** 创建课程计划输入（@contract-pending，MSW 兜底，扩展 course-plans.ts 的基础输入） */
+export interface AdminCreateCoursePlanInput {
+  name: string;
+  gradeId: string;
+  classId?: string;
+  subjectId: string;
+  teacherId?: string;
+  academicYearId?: string;
+  semester?: string;
+  description?: string;
+  objectives?: string;
+  syllabus?: string;
+  totalHours?: number;
+  weeklyHours?: number;
+  startDate?: string;
+  endDate?: string;
+  status?: string;
+}
+
+/** 更新课程计划输入（@contract-pending，MSW 兜底） */
+export interface AdminUpdateCoursePlanInput {
+  id: string;
+  name?: string;
+  gradeId?: string;
+  classId?: string;
+  subjectId?: string;
+  teacherId?: string;
+  academicYearId?: string;
+  semester?: string;
+  description?: string;
+  objectives?: string;
+  syllabus?: string;
+  totalHours?: number;
+  weeklyHours?: number;
+  startDate?: string;
+  endDate?: string;
+  status?: string;
+}
+
+/** 创建选修课输入（@contract-pending，MSW 兜底，扩展 elective.ts 的基础输入） */
+export interface AdminCreateElectiveInput {
+  name: string;
+  description?: string;
+  subjectId: string;
+  gradeId: string;
+  teacherId?: string;
+  capacity: number;
+  credit?: number;
+  classroom?: string;
+  schedule?: string;
+  selectionMode?: string;
+  startDate?: string;
+  endDate?: string;
+  selectionStartAt?: string;
+  selectionEndAt?: string;
+  dropDeadline?: string;
+  status?: string;
+}
+
+/** 更新选修课输入（@contract-pending，MSW 兜底） */
+export interface AdminUpdateElectiveInput {
+  id: string;
+  name?: string;
+  description?: string;
+  subjectId?: string;
+  gradeId?: string;
+  teacherId?: string;
+  capacity?: number;
+  credit?: number;
+  classroom?: string;
+  schedule?: string;
+  selectionMode?: string;
+  startDate?: string;
+  endDate?: string;
+  selectionStartAt?: string;
+  selectionEndAt?: string;
+  dropDeadline?: string;
+  status?: string;
+}
+
+/** 选修课总览统计（@contract-pending，MSW 兜底） */
+export interface ElectiveOverviewStats {
+  totalCourses: number;
+  totalCapacity: number;
+  totalEnrolled: number;
+  totalDraft: number;
+  totalOpen: number;
+}
+
 export interface AdminQuestionListItem {
   id: string;
   type: string;
@@ -545,6 +896,32 @@ export interface AdminQuestionListItem {
   createdBy: string;
 }
 
+/**
+ * 题目详情（管理域视角，@contract-pending，MSW 兜底）。
+ *
+ * 与 AdminQuestionListItem 的差异：包含 answer / explanation / knowledgePointId /
+ * knowledgePointTitle / updatedAt 等详情字段，供详情对话框展示。
+ */
+export interface AdminQuestionDetail {
+  id: string;
+  type: string;
+  content: string;
+  difficulty: string;
+  subjectId: string;
+  subjectName: string;
+  textbookId: string;
+  textbookTitle: string;
+  knowledgePointId: string;
+  knowledgePointTitle: string;
+  status: string;
+  answer: string;
+  explanation: string | null;
+  source: string | null;
+  createdAt: string;
+  updatedAt: string;
+  createdBy: string;
+}
+
 export interface QuestionFilter {
   type?: string | null;
   difficulty?: string | null;
@@ -586,6 +963,17 @@ export interface AdminErrorBookStats {
     questionCount: number;
     errorRate: number;
   }>;
+  /**
+   * 按班级分组的错题统计（@contract-pending，MSW 兜底）。
+   * 用于"按班级分组"卡片展示，与 bySubject 互补。
+   */
+  byClass: Array<{
+    classId: string;
+    className: string;
+    errorCount: number;
+    questionCount: number;
+    errorRate: number;
+  }>;
   topStudents: Array<{
     studentId: string;
     studentName: string;
@@ -655,6 +1043,8 @@ export interface AdminAttendanceRecord {
   studentName: string;
   classId: string;
   className: string;
+  /** 年级 ID（@contract-pending，MSW 兜底，用于年级筛选） */
+  gradeId: string;
   date: string;
   status: string;
   recordedBy: string;
@@ -665,6 +1055,8 @@ export interface AttendanceFilter {
   classId?: string | null;
   status?: string | null;
   date?: string | null;
+  /** 年级筛选（@contract-pending，MSW 兜底）。与 classId 互不冲突，可同时设置。 */
+  gradeId?: string | null;
 }
 
 export interface AttendanceGradeCorrelation {
@@ -784,6 +1176,86 @@ export function useDeleteRole(): {
   return { run, loading, error };
 }
 
+/**
+ * 启用/停用角色（@contract-pending MSW 兜底）。
+ * 系统锁定角色（isLocked=true）禁止切换。
+ */
+export function useToggleRoleEnabled(): {
+  run: (
+    id: string,
+    isEnabled: boolean,
+  ) => Promise<{ id: string; isEnabled: boolean }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { toggleRoleEnabled: { id: string; isEnabled: boolean } },
+    { id: string; isEnabled: boolean }
+  >(TOGGLE_ROLE_ENABLED_DOC);
+  const run = async (
+    id: string,
+    isEnabled: boolean,
+  ): Promise<{ id: string; isEnabled: boolean }> => {
+    const data = await rawRun({ id, isEnabled });
+    if (!data?.toggleRoleEnabled) {
+      throw new ApiError("Failed to toggle role enabled", "INTERNAL_ERROR");
+    }
+    return data.toggleRoleEnabled;
+  };
+  return { run, loading, error };
+}
+
+// ============================================================
+// Hooks: RBAC role permission matrix (CRUD actions per permission point)
+// ============================================================
+export function useRolePermissions(
+  roleId: string,
+): UseQueryResult<RolePermissionMatrixItem[]> {
+  const result = useWidgetQuery<
+    { rolePermissions: RolePermissionMatrixItem[] },
+    { roleId: string }
+  >(GET_ROLE_PERMISSIONS_DOC, { roleId });
+  return { ...result, data: result.data?.rolePermissions ?? [] };
+}
+
+export function useUpdateRolePermissionActions(): {
+  run: (
+    roleId: string,
+    permissionUpdates: PermissionActionUpdate[],
+  ) => Promise<{ id: string; updatedCount: number }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { updateRolePermissionActions: { id: string; updatedCount: number } },
+    {
+      roleId: string;
+      permissionUpdates: PermissionActionUpdate[];
+    }
+  >(UPDATE_ROLE_PERMISSION_ACTIONS_DOC);
+  const run = async (
+    roleId: string,
+    permissionUpdates: PermissionActionUpdate[],
+  ): Promise<{ id: string; updatedCount: number }> => {
+    const data = await rawRun({ roleId, permissionUpdates });
+    if (!data?.updateRolePermissionActions) {
+      throw new ApiError(
+        "Failed to update role permission actions",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.updateRolePermissionActions;
+  };
+  return { run, loading, error };
+}
 export function usePermissionRoleCounts(): UseQueryResult<
   PermissionRoleCount[]
 > {
@@ -877,6 +1349,78 @@ export function useAuditModuleOptions(): UseQueryResult<string[]> {
   return { ...result, data: result.data?.auditModuleOptions };
 }
 
+// ============================================================
+// Hooks: Audit / Login / DataChange - export (CSV)
+// ============================================================
+export function useExportAuditLogs(): {
+  run: (filter: AuditLogFilter) => Promise<ExportResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { exportAuditLogs: ExportResult },
+    { filter: AuditLogFilter }
+  >(EXPORT_AUDIT_LOGS_DOC);
+  const run = async (filter: AuditLogFilter): Promise<ExportResult> => {
+    const data = await rawRun({ filter });
+    if (!data?.exportAuditLogs) {
+      throw new ApiError("Failed to export audit logs", "INTERNAL_ERROR");
+    }
+    return data.exportAuditLogs;
+  };
+  return { run, loading, error };
+}
+
+export function useExportLoginLogs(): {
+  run: (filter: LoginLogFilter) => Promise<ExportResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { exportLoginLogs: ExportResult },
+    { filter: LoginLogFilter }
+  >(EXPORT_LOGIN_LOGS_DOC);
+  const run = async (filter: LoginLogFilter): Promise<ExportResult> => {
+    const data = await rawRun({ filter });
+    if (!data?.exportLoginLogs) {
+      throw new ApiError("Failed to export login logs", "INTERNAL_ERROR");
+    }
+    return data.exportLoginLogs;
+  };
+  return { run, loading, error };
+}
+
+export function useExportDataChanges(): {
+  run: (filter: DataChangeLogFilter) => Promise<ExportResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { exportDataChanges: ExportResult },
+    { filter: DataChangeLogFilter }
+  >(EXPORT_DATA_CHANGES_DOC);
+  const run = async (filter: DataChangeLogFilter): Promise<ExportResult> => {
+    const data = await rawRun({ filter });
+    if (!data?.exportDataChanges) {
+      throw new ApiError("Failed to export data changes", "INTERNAL_ERROR");
+    }
+    return data.exportDataChanges;
+  };
+  return { run, loading, error };
+}
+
 // ============================================================
 // Hooks: School CRUD
 // ============================================================
@@ -913,6 +1457,35 @@ export function useCreateSchool(): {
   return { run, loading, error };
 }
 
+export function useAdminUpdateSchool(): {
+  run: (
+    id: string,
+    input: SchoolInput,
+  ) => Promise<{ id: string; name: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { updateSchool: { id: string; name: string } },
+    { id: string; input: SchoolInput }
+  >(ADMIN_UPDATE_SCHOOL_DOC);
+  const run = async (
+    id: string,
+    input: SchoolInput,
+  ): Promise<{ id: string; name: string }> => {
+    const data = await rawRun({ id, input });
+    if (!data?.updateSchool) {
+      throw new ApiError("Failed to update school", "INTERNAL_ERROR");
+    }
+    return data.updateSchool;
+  };
+  return { run, loading, error };
+}
+
 export function useDeleteSchool(): {
   run: (id: string) => Promise<{ id: string }>;
   loading: boolean;
@@ -1220,6 +1793,94 @@ export function useStaffOptions(): UseQueryResult<OptionItem[]> {
   return { ...result, data: result.data?.staffOptions };
 }
 
+/**
+ * 创建班级（@contract-pending，MSW 兜底）。
+ * 用于 admin/school/classes 列表页 ClassFormDialog 新建模式。
+ */
+export function useCreateAdminClass(): {
+  run: (input: AdminClassInput) => Promise<{ id: string; name: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { createAdminClass: { id: string; name: string } },
+    { input: AdminClassInput }
+  >(CREATE_ADMIN_CLASS_DOC);
+  const run = async (
+    input: AdminClassInput,
+  ): Promise<{ id: string; name: string }> => {
+    const data = await rawRun({ input });
+    if (!data?.createAdminClass) {
+      throw new ApiError("Failed to create admin class", "INTERNAL_ERROR");
+    }
+    return data.createAdminClass;
+  };
+  return { run, loading, error };
+}
+
+/**
+ * 更新班级（@contract-pending，MSW 兜底）。
+ * 用于 admin/school/classes 列表页 ClassFormDialog 编辑模式。
+ */
+export function useUpdateAdminClass(): {
+  run: (
+    id: string,
+    input: AdminClassInput,
+  ) => Promise<{ id: string; name: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { updateAdminClass: { id: string; name: string } },
+    { id: string; input: AdminClassInput }
+  >(UPDATE_ADMIN_CLASS_DOC);
+  const run = async (
+    id: string,
+    input: AdminClassInput,
+  ): Promise<{ id: string; name: string }> => {
+    const data = await rawRun({ id, input });
+    if (!data?.updateAdminClass) {
+      throw new ApiError("Failed to update admin class", "INTERNAL_ERROR");
+    }
+    return data.updateAdminClass;
+  };
+  return { run, loading, error };
+}
+
+/**
+ * 删除班级（@contract-pending，MSW 兜底）。
+ * 用于 admin/school/classes 列表页 ClassDeleteDialog。
+ */
+export function useDeleteAdminClass(): {
+  run: (id: string) => Promise<{ id: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<{ deleteAdminClass: { id: string } }, { id: string }>(
+    DELETE_ADMIN_CLASS_DOC,
+  );
+  const run = async (id: string): Promise<{ id: string }> => {
+    const data = await rawRun({ id });
+    if (!data?.deleteAdminClass) {
+      throw new ApiError("Failed to delete admin class", "INTERNAL_ERROR");
+    }
+    return data.deleteAdminClass;
+  };
+  return { run, loading, error };
+}
+
 // ============================================================
 // Hooks: Announcements
 // ============================================================
@@ -1365,6 +2026,35 @@ export function usePinAnnouncement(): {
   return { run, loading, error };
 }
 
+export function usePublishAnnouncement(): {
+  run: (
+    id: string,
+  ) => Promise<{ id: string; status: string; publishedAt: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    {
+      publishAnnouncement: { id: string; status: string; publishedAt: string };
+    },
+    { id: string }
+  >(PUBLISH_ANNOUNCEMENT_DOC);
+  const run = async (
+    id: string,
+  ): Promise<{ id: string; status: string; publishedAt: string }> => {
+    const data = await rawRun({ id });
+    if (!data?.publishAnnouncement) {
+      throw new ApiError("Failed to publish announcement", "INTERNAL_ERROR");
+    }
+    return data.publishAnnouncement;
+  };
+  return { run, loading, error };
+}
+
 // ============================================================
 // Hooks: Files
 // ============================================================
@@ -1386,6 +2076,52 @@ export function useFileStats(): UseQueryResult<FileStats | null> {
   return { ...result, data: result.data?.fileStats ?? null };
 }
 
+export function useUploadFile(): {
+  run: (input: UploadFileInput) => Promise<UploadFileResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { uploadFile: UploadFileResult },
+    { input: UploadFileInput }
+  >(UPLOAD_FILE_DOC);
+  const run = async (input: UploadFileInput): Promise<UploadFileResult> => {
+    const data = await rawRun({ input });
+    if (!data?.uploadFile) {
+      throw new ApiError("Failed to upload file", "INTERNAL_ERROR");
+    }
+    return data.uploadFile;
+  };
+  return { run, loading, error };
+}
+
+export function useBatchDeleteFiles(): {
+  run: (fileIds: string[]) => Promise<BatchDeleteFilesResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { batchDeleteFiles: BatchDeleteFilesResult },
+    { fileIds: string[] }
+  >(BATCH_DELETE_FILES_DOC);
+  const run = async (fileIds: string[]): Promise<BatchDeleteFilesResult> => {
+    const data = await rawRun({ fileIds });
+    if (!data?.batchDeleteFiles) {
+      throw new ApiError("Failed to batch delete files", "INTERNAL_ERROR");
+    }
+    return data.batchDeleteFiles;
+  };
+  return { run, loading, error };
+}
+
 // ============================================================
 // Hooks: AI settings
 // ============================================================
@@ -1475,6 +2211,33 @@ export function useDeleteAiProvider(): {
   return { run, loading, error };
 }
 
+export function useTestAiProvider(): {
+  run: (
+    id: string,
+  ) => Promise<{ ok: boolean; latencyMs: number; message: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { testAiProvider: { ok: boolean; latencyMs: number; message: string } },
+    { id: string }
+  >(TEST_AI_PROVIDER_DOC);
+  const run = async (
+    id: string,
+  ): Promise<{ ok: boolean; latencyMs: number; message: string }> => {
+    const data = await rawRun({ id });
+    if (!data?.testAiProvider) {
+      throw new ApiError("Failed to test AI provider", "INTERNAL_ERROR");
+    }
+    return data.testAiProvider;
+  };
+  return { run, loading, error };
+}
+
 export function useAiUsageDashboard(
   range: string,
 ): UseQueryResult<AiUsageDashboard | null> {
@@ -1674,6 +2437,24 @@ export function useAdminQuestions(
   return { ...result, data: result.data?.adminQuestions };
 }
 
+/**
+ * 题库单条详情 hook（@contract-pending，MSW 兜底）。
+ *
+ * 用于详情对话框按 id 拉取题目明细（answer/explanation/knowledgePointTitle 等）。
+ * id 为空时不发请求（对话框关闭时跳过）。
+ */
+export function useAdminQuestion(
+  id: string,
+  options?: { enabled?: boolean },
+): UseQueryResult<AdminQuestionDetail | null> {
+  const enabled = options?.enabled ?? true;
+  const result = useWidgetQuery<
+    { adminQuestion: AdminQuestionDetail | null },
+    { id: string }
+  >(GET_ADMIN_QUESTION_DOC, { id }, { enabled });
+  return { ...result, data: result.data?.adminQuestion ?? null };
+}
+
 // Lesson plans
 export function useAdminLessonPlans(): UseQueryResult<
   PaginatedResult<AdminLessonPlanListItem>
@@ -1695,6 +2476,45 @@ export function useAdminLessonPlan(
   return { ...result, data: result.data?.adminLessonPlan ?? null };
 }
 
+/** 软删除教案 mutation 响应（@contract-pending） */
+interface SoftDeleteLessonPlanResponse {
+  softDeleteLessonPlan: { success: boolean; deletedAt: string } | null;
+}
+
+/**
+ * 软删除教案 mutation（@contract-pending，MSW 兜底）。
+ *
+ * 对齐 CICD softDeleteLessonPlan：将 status 置为 archived，返回 { success, deletedAt }。
+ * 用于管理端 admin/lesson-plans 列表/详情页删除按钮。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useSoftDeleteLessonPlan(): {
+  run: (planId: string) => Promise<{ success: boolean; deletedAt: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<SoftDeleteLessonPlanResponse, { planId: string }>(
+    SOFT_DELETE_LESSON_PLAN_DOC,
+  );
+
+  const run = async (
+    planId: string,
+  ): Promise<{ success: boolean; deletedAt: string }> => {
+    const data = await rawRun({ planId });
+    if (!data?.softDeleteLessonPlan) {
+      throw new ApiError("Failed to soft delete lesson plan", "INTERNAL_ERROR");
+    }
+    return data.softDeleteLessonPlan;
+  };
+
+  return { run, loading, error };
+}
+
 // Error book
 export function useAdminErrorBookStats(): UseQueryResult<AdminErrorBookStats | null> {
   const result = useWidgetQuery<
@@ -1704,6 +2524,58 @@ export function useAdminErrorBookStats(): UseQueryResult<AdminErrorBookStats | n
   return { ...result, data: result.data?.adminErrorBookStats ?? null };
 }
 
+/**
+ * 导出错题本 CSV mutation（@contract-pending，MSW 兜底）。
+ *
+ * CSV 由 MSW 用纯函数构造，返回 { success, count, filename, csv } 字符串。
+ * 前端拿到 csv 字符串后直接触发下载（与 EXPORT_AUDIT_LOGS_DOC 模式一致）。
+ */
+export function useExportErrorBookCsv(): {
+  run: (filter: {
+    subjectId?: string | null;
+    classId?: string | null;
+  }) => Promise<{
+    success: boolean;
+    count: number;
+    filename: string;
+    csv: string;
+  }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    {
+      exportErrorBookCsv: {
+        success: boolean;
+        count: number;
+        filename: string;
+        csv: string;
+      };
+    },
+    { filter: { subjectId?: string | null; classId?: string | null } }
+  >(EXPORT_ERROR_BOOK_CSV_DOC);
+  const run = async (filter: {
+    subjectId?: string | null;
+    classId?: string | null;
+  }): Promise<{
+    success: boolean;
+    count: number;
+    filename: string;
+    csv: string;
+  }> => {
+    const data = await rawRun({ filter });
+    if (!data?.exportErrorBookCsv) {
+      throw new ApiError("Failed to export error book CSV", "INTERNAL_ERROR");
+    }
+    return data.exportErrorBookCsv;
+  };
+  return { run, loading, error };
+}
+
 // Scheduling
 export function useAdminScheduleChanges(): UseQueryResult<
   PaginatedResult<ScheduleChange>
@@ -1881,3 +2753,629 @@ export function useAttendanceGradeCorrelation(): UseQueryResult<
   >(GET_ATTENDANCE_GRADE_CORRELATION_DOC, {});
   return { ...result, data: result.data?.attendanceGradeCorrelation };
 }
+
+// ============================================================
+// Types & Hooks: Audit retention config + purge（@contract-pending，MSW 兜底）
+// ============================================================
+export interface AuditRetentionConfig {
+  retentionDays: number;
+  loginLogRetentionDays: number;
+  autoCleanupEnabled: boolean;
+}
+
+export interface PurgeResult {
+  auditLogsDeleted: number;
+  loginLogsDeleted: number;
+  dataChangeLogsDeleted: number;
+}
+
+export interface AuditRetentionConfigInput {
+  retentionDays: number;
+  loginLogRetentionDays: number;
+  autoCleanupEnabled: boolean;
+}
+
+export function useAuditRetentionConfig(): UseQueryResult<AuditRetentionConfig | null> {
+  const result = useWidgetQuery<
+    { auditRetentionConfig: AuditRetentionConfig | null },
+    Record<string, never>
+  >(GET_AUDIT_RETENTION_CONFIG_DOC, {});
+  return { ...result, data: result.data?.auditRetentionConfig ?? null };
+}
+
+export function useSaveAuditRetentionConfig(): {
+  run: (input: AuditRetentionConfigInput) => Promise<AuditRetentionConfig>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { saveAuditRetentionConfig: AuditRetentionConfig },
+    { input: AuditRetentionConfigInput }
+  >(SAVE_AUDIT_RETENTION_CONFIG_DOC);
+  const run = async (
+    input: AuditRetentionConfigInput,
+  ): Promise<AuditRetentionConfig> => {
+    const data = await rawRun({ input });
+    if (!data?.saveAuditRetentionConfig) {
+      throw new ApiError(
+        "Failed to save audit retention config",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.saveAuditRetentionConfig;
+  };
+  return { run, loading, error };
+}
+
+export function usePurgeExpiredAuditLogs(): {
+  run: (
+    retentionDays: number,
+    loginLogRetentionDays?: number,
+  ) => Promise<PurgeResult>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { purgeExpiredAuditLogs: PurgeResult },
+    { retentionDays: number; loginLogRetentionDays?: number | null }
+  >(PURGE_EXPIRED_AUDIT_LOGS_DOC);
+  const run = async (
+    retentionDays: number,
+    loginLogRetentionDays?: number,
+  ): Promise<PurgeResult> => {
+    const data = await rawRun(
+      loginLogRetentionDays !== undefined
+        ? { retentionDays, loginLogRetentionDays }
+        : { retentionDays, loginLogRetentionDays: null },
+    );
+    if (!data?.purgeExpiredAuditLogs) {
+      throw new ApiError(
+        "Failed to purge expired audit logs",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.purgeExpiredAuditLogs;
+  };
+  return { run, loading, error };
+}
+// ============================================================
+// Hooks: Course plan items CRUD（@contract-pending，MSW 兜底）
+// ============================================================
+export function useCreateCoursePlanItem(): {
+  run: (input: AdminCoursePlanItemInput) => Promise<AdminCoursePlanItem>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { createCoursePlanItem: AdminCoursePlanItem },
+    { input: AdminCoursePlanItemInput }
+  >(CREATE_COURSE_PLAN_ITEM_DOC);
+  const run = async (
+    input: AdminCoursePlanItemInput,
+  ): Promise<AdminCoursePlanItem> => {
+    const data = await rawRun({ input });
+    if (!data?.createCoursePlanItem) {
+      throw new ApiError("Failed to create course plan item", "INTERNAL_ERROR");
+    }
+    return data.createCoursePlanItem;
+  };
+  return { run, loading, error };
+}
+
+export function useUpdateCoursePlanItem(): {
+  run: (
+    id: string,
+    input: AdminCoursePlanItemUpdateInput,
+  ) => Promise<AdminCoursePlanItem>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { updateCoursePlanItem: AdminCoursePlanItem },
+    { id: string; input: AdminCoursePlanItemUpdateInput }
+  >(UPDATE_COURSE_PLAN_ITEM_DOC);
+  const run = async (
+    id: string,
+    input: AdminCoursePlanItemUpdateInput,
+  ): Promise<AdminCoursePlanItem> => {
+    const data = await rawRun({ id, input });
+    if (!data?.updateCoursePlanItem) {
+      throw new ApiError("Failed to update course plan item", "INTERNAL_ERROR");
+    }
+    return data.updateCoursePlanItem;
+  };
+  return { run, loading, error };
+}
+export function useDeleteCoursePlanItem(): {
+  run: (id: string) => Promise<{ id: string; success: boolean }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    { deleteCoursePlanItem: { id: string; success: boolean } },
+    { id: string }
+  >(DELETE_COURSE_PLAN_ITEM_DOC);
+  const run = async (id: string): Promise<{ id: string; success: boolean }> => {
+    const data = await rawRun({ id });
+    if (!data?.deleteCoursePlanItem) {
+      throw new ApiError("Failed to delete course plan item", "INTERNAL_ERROR");
+    }
+    return data.deleteCoursePlanItem;
+  };
+  return { run, loading, error };
+}
+
+export function useToggleCoursePlanItemCompleted(): {
+  run: (
+    id: string,
+    isCompleted: boolean,
+  ) => Promise<{
+    id: string;
+    isCompleted: boolean;
+    completedAt: string | null;
+    updatedAt: string;
+  }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    {
+      toggleCoursePlanItemCompleted: {
+        id: string;
+        isCompleted: boolean;
+        completedAt: string | null;
+        updatedAt: string;
+      };
+    },
+    { id: string; isCompleted: boolean }
+  >(TOGGLE_COURSE_PLAN_ITEM_COMPLETED_DOC);
+  const run = async (
+    id: string,
+    isCompleted: boolean,
+  ): Promise<{
+    id: string;
+    isCompleted: boolean;
+    completedAt: string | null;
+    updatedAt: string;
+  }> => {
+    const data = await rawRun({ id, isCompleted });
+    if (!data?.toggleCoursePlanItemCompleted) {
+      throw new ApiError(
+        "Failed to toggle course plan item completed",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.toggleCoursePlanItemCompleted;
+  };
+  return { run, loading, error };
+}
+
+export function useReorderCoursePlanItems(): {
+  run: (
+    planId: string,
+    items: ReorderCoursePlanItemInput[],
+  ) => Promise<Array<{ id: string; week: number; updatedAt: string }>>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    {
+      reorderCoursePlanItems: Array<{
+        id: string;
+        week: number;
+        updatedAt: string;
+      }>;
+    },
+    { planId: string; items: ReorderCoursePlanItemInput[] }
+  >(REORDER_COURSE_PLAN_ITEMS_DOC);
+  const run = async (
+    planId: string,
+    items: ReorderCoursePlanItemInput[],
+  ): Promise<Array<{ id: string; week: number; updatedAt: string }>> => {
+    const data = await rawRun({ planId, items });
+    if (!data?.reorderCoursePlanItems) {
+      throw new ApiError(
+        "Failed to reorder course plan items",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.reorderCoursePlanItems;
+  };
+  return { run, loading, error };
+}
+
+// ============================================================
+// Hooks: 课程计划 CRUD + 批量操作（@contract-pending，MSW 兜底）
+// ============================================================
+
+/** 删除课程计划 mutation 响应（@contract-pending） */
+interface DeleteCoursePlanResponse {
+  deleteCoursePlan: { id: string; success: boolean } | null;
+}
+
+/**
+ * 删除课程计划（@contract-pending，MSW 兜底）。
+ * 用于详情页/列表页删除按钮，调用后建议 refetch 列表。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useDeleteCoursePlan(): {
+  run: (id: string) => Promise<{ id: string; success: boolean }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<DeleteCoursePlanResponse, { id: string }>(
+    DELETE_COURSE_PLAN_DOC,
+  );
+  const run = async (id: string): Promise<{ id: string; success: boolean }> => {
+    const data = await rawRun({ id });
+    if (!data?.deleteCoursePlan) {
+      throw new ApiError("Failed to delete course plan", "INTERNAL_ERROR");
+    }
+    return data.deleteCoursePlan;
+  };
+  return { run, loading, error };
+}
+
+/** 批量切换周计划项完成状态 mutation 响应（@contract-pending） */
+interface BulkToggleCoursePlanItemsResponse {
+  bulkToggleCoursePlanItems: Array<{
+    id: string;
+    isCompleted: boolean;
+    completedAt: string | null;
+    updatedAt: string;
+  }>;
+}
+
+/**
+ * 批量切换周计划项完成状态（@contract-pending，MSW 兜底）。
+ * 用于详情页批量"标记完成/取消完成"操作。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useBulkToggleCoursePlanItems(): {
+  run: (
+    planId: string,
+    itemIds: string[],
+    isCompleted: boolean,
+  ) => Promise<
+    Array<{
+      id: string;
+      isCompleted: boolean;
+      completedAt: string | null;
+      updatedAt: string;
+    }>
+  >;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    BulkToggleCoursePlanItemsResponse,
+    { planId: string; itemIds: string[]; isCompleted: boolean }
+  >(BULK_TOGGLE_COURSE_PLAN_ITEMS_DOC);
+  const run = async (
+    planId: string,
+    itemIds: string[],
+    isCompleted: boolean,
+  ): Promise<
+    Array<{
+      id: string;
+      isCompleted: boolean;
+      completedAt: string | null;
+      updatedAt: string;
+    }>
+  > => {
+    const data = await rawRun({ planId, itemIds, isCompleted });
+    if (!data?.bulkToggleCoursePlanItems) {
+      throw new ApiError(
+        "Failed to bulk toggle course plan items",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.bulkToggleCoursePlanItems;
+  };
+  return { run, loading, error };
+}
+
+// ============================================================
+// Hooks: 选修课 CRUD + 业务动作（@contract-pending，MSW 兜底）
+// ============================================================
+
+/** 创建选修课 mutation 响应（@contract-pending） */
+interface AdminCreateElectiveResponse {
+  createElective: { id: string } | null;
+}
+
+/**
+ * 创建选修课（@contract-pending，MSW 兜底，admin scope）。
+ * 与 elective.ts 的 useCreateElective 区别：本 hook 走 admin scope，
+ * 支持扩展字段（classroom / schedule / credit / selectionMode 等）。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useAdminCreateElective(): {
+  run: (input: AdminCreateElectiveInput) => Promise<{ id: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    AdminCreateElectiveResponse,
+    { input: AdminCreateElectiveInput }
+  >(CREATE_ELECTIVE_DOC);
+  const run = async (
+    input: AdminCreateElectiveInput,
+  ): Promise<{ id: string }> => {
+    const data = await rawRun({ input });
+    if (!data?.createElective) {
+      throw new ApiError("Failed to create elective", "INTERNAL_ERROR");
+    }
+    return data.createElective;
+  };
+  return { run, loading, error };
+}
+
+/** 更新选修课 mutation 响应（@contract-pending） */
+interface AdminUpdateElectiveResponse {
+  updateElective: { id: string } | null;
+}
+
+/**
+ * 更新选修课（@contract-pending，MSW 兜底，admin scope）。
+ * 与 elective.ts 的 useUpdateElective 区别：本 hook 走 admin scope，
+ * 支持扩展字段。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useAdminUpdateElective(): {
+  run: (input: AdminUpdateElectiveInput) => Promise<{ id: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<
+    AdminUpdateElectiveResponse,
+    { input: AdminUpdateElectiveInput }
+  >(UPDATE_ELECTIVE_DOC);
+  const run = async (
+    input: AdminUpdateElectiveInput,
+  ): Promise<{ id: string }> => {
+    const data = await rawRun({ input });
+    if (!data?.updateElective) {
+      throw new ApiError("Failed to update elective", "INTERNAL_ERROR");
+    }
+    return data.updateElective;
+  };
+  return { run, loading, error };
+}
+
+/** 删除选修课 mutation 响应（@contract-pending） */
+interface DeleteElectiveResponse {
+  deleteElective: { id: string; success: boolean } | null;
+}
+
+/**
+ * 删除选修课（@contract-pending，MSW 兜底）。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useDeleteElective(): {
+  run: (id: string) => Promise<{ id: string; success: boolean }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<DeleteElectiveResponse, { id: string }>(
+    DELETE_ELECTIVE_DOC,
+  );
+  const run = async (id: string): Promise<{ id: string; success: boolean }> => {
+    const data = await rawRun({ id });
+    if (!data?.deleteElective) {
+      throw new ApiError("Failed to delete elective", "INTERNAL_ERROR");
+    }
+    return data.deleteElective;
+  };
+  return { run, loading, error };
+}
+
+/** 开放选课 mutation 响应（@contract-pending） */
+interface OpenElectiveSelectionResponse {
+  openElectiveSelection: {
+    id: string;
+    status: string;
+    updatedAt: string;
+  } | null;
+}
+
+/**
+ * 开放选课（@contract-pending，MSW 兜底）。
+ * 将选修课状态从 DRAFT 切换为 OPEN。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useOpenElectiveSelection(): {
+  run: (
+    id: string,
+  ) => Promise<{ id: string; status: string; updatedAt: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<OpenElectiveSelectionResponse, { id: string }>(
+    OPEN_ELECTIVE_SELECTION_DOC,
+  );
+  const run = async (
+    id: string,
+  ): Promise<{ id: string; status: string; updatedAt: string }> => {
+    const data = await rawRun({ id });
+    if (!data?.openElectiveSelection) {
+      throw new ApiError("Failed to open elective selection", "INTERNAL_ERROR");
+    }
+    return data.openElectiveSelection;
+  };
+  return { run, loading, error };
+}
+
+/** 关闭选课 mutation 响应（@contract-pending） */
+interface CloseElectiveSelectionResponse {
+  closeElectiveSelection: {
+    id: string;
+    status: string;
+    updatedAt: string;
+  } | null;
+}
+
+/**
+ * 关闭选课（@contract-pending，MSW 兜底）。
+ * 将选修课状态从 OPEN 切换为 CLOSED。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useCloseElectiveSelection(): {
+  run: (
+    id: string,
+  ) => Promise<{ id: string; status: string; updatedAt: string }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<CloseElectiveSelectionResponse, { id: string }>(
+    CLOSE_ELECTIVE_SELECTION_DOC,
+  );
+  const run = async (
+    id: string,
+  ): Promise<{ id: string; status: string; updatedAt: string }> => {
+    const data = await rawRun({ id });
+    if (!data?.closeElectiveSelection) {
+      throw new ApiError(
+        "Failed to close elective selection",
+        "INTERNAL_ERROR",
+      );
+    }
+    return data.closeElectiveSelection;
+  };
+  return { run, loading, error };
+}
+
+/** 运行选课抽签 mutation 响应（@contract-pending） */
+interface RunElectiveLotteryResponse {
+  runElectiveLottery: {
+    id: string;
+    status: string;
+    selectedCount: number;
+    updatedAt: string;
+  } | null;
+}
+
+/**
+ * 运行选课抽签（@contract-pending，MSW 兜底）。
+ * 对 LOTTERY 模式的选修课执行抽签，返回最终中选人数。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useRunElectiveLottery(): {
+  run: (id: string) => Promise<{
+    id: string;
+    status: string;
+    selectedCount: number;
+    updatedAt: string;
+  }>;
+  loading: boolean;
+  error: unknown;
+} {
+  const {
+    run: rawRun,
+    loading,
+    error,
+  } = useWidgetMutation<RunElectiveLotteryResponse, { id: string }>(
+    RUN_ELECTIVE_LOTTERY_DOC,
+  );
+  const run = async (
+    id: string,
+  ): Promise<{
+    id: string;
+    status: string;
+    selectedCount: number;
+    updatedAt: string;
+  }> => {
+    const data = await rawRun({ id });
+    if (!data?.runElectiveLottery) {
+      throw new ApiError("Failed to run elective lottery", "INTERNAL_ERROR");
+    }
+    return data.runElectiveLottery;
+  };
+  return { run, loading, error };
+}
+
+/** 选修课总览统计查询响应（@contract-pending） */
+interface ElectiveOverviewStatsResponse {
+  electiveOverviewStats: ElectiveOverviewStats | null;
+}
+
+/**
+ * 查询选修课总览统计（@contract-pending，MSW 兜底）。
+ * 用于列表页 StatsGrid 顶部统计卡片（总数 / 容量 / 已选 / 草稿 / 报名中）。
+ *
+ * 关联：ARCHITECTURE.md §5.4 / §9.4 / §11.4 契约工单
+ */
+export function useGetElectiveOverviewStats(): UseQueryResult<ElectiveOverviewStats | null> {
+  const result = useWidgetQuery<
+    ElectiveOverviewStatsResponse,
+    Record<string, never>
+  >(GET_ELECTIVE_OVERVIEW_STATS_DOC, {});
+  return {
+    ...result,
+    data: result.data?.electiveOverviewStats ?? null,
+  };
+}
diff --git a/apps/portal-shell/src/lib/api/admin.ts b/apps/portal-shell/src/lib/api/admin.ts
index 056bb69..3f545f1 100644
--- a/apps/portal-shell/src/lib/api/admin.ts
+++ b/apps/portal-shell/src/lib/api/admin.ts
@@ -105,6 +105,12 @@ export interface AuditLog {
   ip: string;
   timestamp: string;
   details: string;
+  /**
+   * 审计日志状态（success/failure/error/pending）。
+   * @contract-pending 当前 schema 未提供此字段，MSW 兜底时为 undefined，
+   * 列表 StatusBadge 显示 "--" 占位；契约补齐后切换为真实值。
+   */
+  status?: string | null;
 }
 
 export interface AuditLogFilter {
diff --git a/apps/portal-shell/src/lib/api/operations/admin.graphql.ts b/apps/portal-shell/src/lib/api/operations/admin.graphql.ts
index 48b0cd6..35f3d8c 100644
--- a/apps/portal-shell/src/lib/api/operations/admin.graphql.ts
+++ b/apps/portal-shell/src/lib/api/operations/admin.graphql.ts
@@ -476,6 +476,17 @@ export const DELETE_SCHOOL_DOC = gql`
   }
 `;
 
+// P5 多校 CRUD：按 ID 更新学校（区别于 school-settings 的单校 UpdateSchool($input!)）
+// operationName 用 AdminUpdateSchool 避免与 school-settings 的 UpdateSchool 重名导致 codegen 重复声明
+export const ADMIN_UPDATE_SCHOOL_DOC = gql`
+  mutation AdminUpdateSchool($id: ID!, $input: SchoolInput!) {
+    updateSchool(id: $id, input: $input) {
+      id
+      name
+    }
+  }
+`;
+
 // ── School: departments ──
 export const GET_DEPARTMENTS_DOC = gql`
   query GetDepartments {
@@ -585,7 +596,7 @@ export const GET_GRADE_OVERVIEW_STATS_DOC = gql`
 `;
 
 export const ADMIN_CREATE_GRADE_DOC = gql`
-  mutation CreateGrade($input: GradeInput!) {
+  mutation AdminCreateGrade($input: GradeInput!) {
     createGrade(input: $input) {
       id
       name
@@ -1186,7 +1197,7 @@ export const GET_ADMIN_SCHEDULE_ENTRIES_DOC = gql`
 `;
 
 export const ADMIN_GET_SCHEDULING_RULES_DOC = gql`
-  query GetSchedulingRules {
+  query AdminGetSchedulingRules {
     schedulingRules {
       id
       name
diff --git a/apps/portal-shell/src/messages/en.json b/apps/portal-shell/src/messages/en.json
index 6d39198..e75d522 100644
--- a/apps/portal-shell/src/messages/en.json
+++ b/apps/portal-shell/src/messages/en.json
@@ -6,10 +6,13 @@
       "cancel": "Cancel",
       "edit": "Edit",
       "export": "Export",
+      "import": "Import",
       "search": "Search",
       "delete": "Delete",
       "retry": "Retry",
-      "back": "Back"
+      "back": "Back",
+      "prev": "Previous",
+      "next": "Next"
     },
     "label": {
       "search": "Search",
@@ -30,6 +33,7 @@
     },
     "error": {
       "loadFailed": "Failed to load: {message}",
+      "operationFailed": "Operation failed: {message}",
       "pageError": "Something went wrong"
     },
     "nav": {
@@ -45,7 +49,8 @@
     },
     "empty": {
       "title": "No data",
-      "description": "Adjust filters and retry, or create your first record"
+      "description": "Adjust filters and retry, or create your first record",
+      "searchResult": "No matching permission points"
     },
     "navLabel": {
       "dashboard": "Dashboard",
@@ -120,11 +125,16 @@
     "subtitle": "{email} · Roles: {roles} · Data scope: {dataScope}",
     "subtitleNoRoles": "None",
     "error": {
-      "loadFailed": "Dashboard failed to load: {message}"
+      "loadFailed": "Dashboard failed to load: {message}",
+      "loadFailedGeneric": "Load Failed",
+      "loadFailedDesc": "Data could not be loaded. Please retry.",
+      "retry": "Retry"
     },
     "empty": {
       "title": "No data",
-      "description": "Dashboard data is not ready yet"
+      "description": "Dashboard data is not ready yet",
+      "noNotifications": "No Notifications",
+      "noNotificationsDesc": "New notifications will appear here"
     },
     "stats": {
       "classes": "Total Classes",
@@ -145,6 +155,11 @@
       "title": "Teacher Dashboard",
       "description": "Today's teaching overview",
       "loadFailed": "Dashboard data failed to load. Please try again later.",
+      "greeting": {
+        "morning": "Good morning",
+        "afternoon": "Good afternoon",
+        "evening": "Good evening"
+      },
       "stats": {
         "totalClasses": "Total Classes",
         "totalStudents": "Total Students",
@@ -164,6 +179,74 @@
         "currentValue": "Current",
         "threshold": "Threshold"
       }
+    },
+    "teacherCards": {
+      "quickActions": {
+        "createAssignment": "Create Assignment",
+        "grade": "Grade",
+        "myClasses": "My Classes"
+      },
+      "todo": {
+        "title": "To-Do",
+        "empty": "No to-dos today"
+      },
+      "classes": {
+        "title": "My Classes",
+        "viewAll": "View All",
+        "emptyTitle": "No Classes Yet",
+        "emptyDescription": "Please contact admin to assign classes",
+        "createClass": "Manage Classes",
+        "homeroom": "Homeroom",
+        "room": "Room"
+      },
+      "homework": {
+        "title": "Homework",
+        "createNewAssignment": "Create new assignment",
+        "emptyTitle": "No Assignments",
+        "emptyDescription": "Click + to create your first assignment",
+        "create": "Create Assignment",
+        "noDueDate": "No due date",
+        "viewAllAssignments": "View all assignments"
+      },
+      "schedule": {
+        "title": "Today's Schedule",
+        "emptyTitle": "No Classes Today",
+        "emptyDescription": "Enjoy a free day",
+        "viewSchedule": "View Schedule",
+        "live": "LIVE",
+        "scrollForMore": "Scroll for more",
+        "noMoreClasses": "No more classes today"
+      },
+      "gradeTrends": {
+        "title": "Class Performance",
+        "description": "Average score across last {count} assignments",
+        "emptyTitle": "No Data Yet",
+        "emptyDescription": "Trends will appear after grading",
+        "averageScorePercent": "Average Score (%)",
+        "submittedCount": "Submitted {submitted}/{total}"
+      },
+      "recentSubmissions": {
+        "title": "Recent Submissions",
+        "viewAll": "View All",
+        "emptyTitle": "No New Submissions",
+        "emptyDescription": "All graded",
+        "colStudent": "Student",
+        "colAssignment": "Assignment",
+        "colSubmitted": "Submitted",
+        "colAction": "Action",
+        "late": "Late",
+        "grade": "Grade"
+      }
+    },
+    "timeRange": {
+      "label": "Time Range",
+      "today": "Today",
+      "week": "This Week",
+      "month": "This Month"
+    },
+    "sections": {
+      "notifications": "Notifications",
+      "viewAllNotifications": "View All"
     }
   },
   "classes": {
@@ -430,7 +513,106 @@
     "error": {
       "title": "Exams page error",
       "unknown": "Unknown error",
-      "retry": "Retry"
+      "retry": "Retry",
+      "createdSuccess": "Question created successfully",
+      "updatedSuccess": "Question updated successfully",
+      "unexpected": "An unexpected error occurred"
+    },
+    "actions": {
+      "view": "View",
+      "build": "Build",
+      "analytics": "Analytics",
+      "delete": "Delete",
+      "confirmDelete": "Confirm Delete",
+      "cancel": "Cancel",
+      "deleteSuccess": "Deleted successfully",
+      "deleteFailed": "Delete failed: {message}",
+      "readOnly": "Read only"
+    },
+    "table": {
+      "selectAll": "Select all",
+      "selectRow": "Select row",
+      "selectedCount": "{selected}/{total} rows selected",
+      "noResults": "No results"
+    },
+    "viewer": {
+      "section": "Section",
+      "group": "Group",
+      "unknown": "Unknown type",
+      "scoreLabel": "Score: {score}",
+      "noQuestions": "No questions"
+    },
+    "paper": {
+      "section": "Section",
+      "group": "Group",
+      "scoreWithUnit": "({score} pts)",
+      "subject": "Subject",
+      "grade": "Grade",
+      "time": "Duration",
+      "minutes": "min",
+      "total": "Total",
+      "pts": "pts",
+      "class": "Class",
+      "name": "Name",
+      "no": "No.",
+      "empty": "No questions"
+    },
+    "editor": {
+      "contentPlaceholder": "Start typing exam content...",
+      "loading": "Loading editor..."
+    },
+    "richEditor": {
+      "bold": "Bold",
+      "italic": "Italic",
+      "strike": "Strikethrough",
+      "dotted": "Dotted",
+      "bulletList": "Bullet List",
+      "orderedList": "Ordered List",
+      "quote": "Quote",
+      "undo": "Undo",
+      "redo": "Redo",
+      "markBlank": "Mark Blank"
+    },
+    "selectionToolbar": {
+      "ariaLabel": "Selection toolbar",
+      "blankShortAnswer": "Short Answer",
+      "composite": "Composite",
+      "defaultGroupTitle": "Group",
+      "defaultSectionTitle": "Section",
+      "groupLabel": "Group",
+      "image": "Image",
+      "sectionLabel": "Section",
+      "singleChoice": "Single Choice"
+    },
+    "richForm": {
+      "titlePlaceholder": "Enter exam title",
+      "classIdPlaceholder": "Class ID",
+      "subjectIdPlaceholder": "Subject ID",
+      "difficulty": "Difficulty",
+      "difficultyLevel1": "1 star",
+      "difficultyLevel2": "2 stars",
+      "difficultyLevel3": "3 stars",
+      "difficultyLevel4": "4 stars",
+      "difficultyLevel5": "5 stars",
+      "totalScore": "Total Score",
+      "durationMin": "Duration (min)",
+      "examDate": "Exam Date",
+      "back": "Back",
+      "save": "Save",
+      "saving": "Saving...",
+      "emptyContent": "Editor content is empty",
+      "titleRequired": "Please enter exam title",
+      "missingExamId": "Missing exam ID",
+      "classSubjectRequired": "Please enter class and subject",
+      "examDateRequired": "Please select exam date",
+      "saveSuccess": "Saved successfully",
+      "saveFailed": "Save failed: {message}",
+      "createSuccess": "Created successfully",
+      "createFailed": "Create failed: {message}",
+      "editorArea": "Editor",
+      "previewArea": "Preview",
+      "previewSummary": "{count} questions · {total} pts",
+      "emptyPreview": "Type in the editor on the left to see the preview here"
     }
   },
   "homework": {
@@ -638,10 +820,184 @@
       "suggestedScore": "Suggested",
       "confidence": "Confidence"
     },
+    "scanUploader": {
+      "scanTitle": "Upload Scans",
+      "dragDropHint": "Drag and drop images here to upload",
+      "fileTypesHint": "Supports JPG / PNG / WebP / PDF",
+      "uploading": "Uploading...",
+      "uploadFailed": "Upload failed",
+      "uploadSuccess": "Uploaded {count} scan images",
+      "selectImageFiles": "Please select image or PDF files",
+      "pageLabel": "Page {page}",
+      "moveUp": "Move Up",
+      "moveDown": "Move Down",
+      "deleteScan": "Delete Scan",
+      "noScans": "No scans"
+    },
+    "scanViewer": {
+      "noImages": "No scan images",
+      "noImagesHint": "Please upload student answer scans first",
+      "zoomIn": "Zoom In",
+      "zoomOut": "Zoom Out",
+      "rotate": "Rotate",
+      "fullscreen": "Fullscreen",
+      "pageIndicator": "Page {current}/{total}",
+      "answerImageAlt": "Answer image page {page}",
+      "thumbnailAlt": "Thumbnail page {page}"
+    },
+    "result": {
+      "scoreRate": "Score Rate",
+      "fullyGraded": "All questions have been graded",
+      "partiallyGraded": "Some questions are still pending grading",
+      "correctCount": "Correct",
+      "incorrectCount": "Incorrect",
+      "partialCount": "Partial",
+      "pendingCount": "Pending",
+      "wrongAnswersTitle": "Wrong Answers Preview",
+      "wrongAnswersDesc": "Below are incorrect or partially correct answers",
+      "backToList": "Back to List",
+      "viewErrorBook": "View Error Book",
+      "yourAnswer": "Your Answer",
+      "correctAnswer": "Correct Answer",
+      "teacherFeedback": "Teacher Feedback",
+      "correctAnswerTrue": "True",
+      "correctAnswerFalse": "False"
+    },
     "error": {
       "title": "Homework page error",
       "unknown": "Unknown error",
       "retry": "Retry"
+    },
+    "review": {
+      "gradedReport": "Graded Report",
+      "submissionDetails": "Submission Details",
+      "questionsUnit": "Questions",
+      "backToList": "Back to List",
+      "assignmentInfo": "Assignment Info",
+      "status": "Status",
+      "description": "Description",
+      "noDescription": "No description",
+      "totalScore": "Total Score",
+      "questionBreakdown": "Question Breakdown",
+      "responseSummary": "Response Summary"
+    },
+    "grade": {
+      "correct": "Correct",
+      "partial": "Partial",
+      "incorrect": "Incorrect"
+    },
+    "take": {
+      "back": "Back",
+      "questions": "Questions",
+      "notStarted": "Not Started",
+      "timedExam": "Timed Exam: {minutes} min",
+      "starting": "Starting...",
+      "startAssignment": "Start Assignment",
+      "timeRemaining": "Time Remaining",
+      "submitting": "Submitting...",
+      "submitAssignment": "Submit Assignment",
+      "saveFailed": "Save failed",
+      "startSuccess": "Assignment started",
+      "startFailed": "Failed to start",
+      "saved": "Saved",
+      "submitSuccess": "Submitted",
+      "submitFailed": "Failed to submit",
+      "timeUpAutoSubmit": "Time is up. Auto-submitted.",
+      "readyToStart": "Ready to Start",
+      "readyDescription": "Click the button below to start.",
+      "startNow": "Start Now",
+      "confirmSubmit": "Confirm Submit",
+      "unansweredWarning": "{count} question(s) unanswered",
+      "confirmSubmitDescription": "Are you sure you want to submit? You cannot modify after submission.",
+      "cancel": "Cancel",
+      "confirmSubmitAction": "Confirm Submit",
+      "assignmentInfo": "Assignment Info",
+      "status": "Status",
+      "dueDate": "Due Date",
+      "overdue": "Overdue",
+      "lessThanOneHour": "Less than 1 hour",
+      "hoursLeft": "{hours} hours left",
+      "attempts": "Attempts",
+      "attemptsUsed": "{used}/{max} used",
+      "attemptsRemaining": "{remaining} remaining",
+      "description": "Description",
+      "noDescription": "No description",
+      "progress": "Progress",
+      "jumpToQuestion": "Jump to question {index}",
+      "answered": "Answered",
+      "unanswered": "Unanswered",
+      "submitAll": "Submit All",
+      "makeSureAnswered": "Make sure all questions are answered",
+      "saveAnswer": "Save Answer",
+      "scanTitle": "Scan Upload",
+      "scanDescription": "Upload handwritten homework scans"
+    }
+  },
+  "examHomework": {
+    "homework": {
+      "analytics": {
+        "examContent": "Exam Content",
+        "questionPreview": "Question Preview",
+        "errorAnalysis": "Error Analysis",
+        "errorRateOverview": "Error Rate Overview",
+        "errorRateAriaLabel": "Error rate {rate}%",
+        "question": "Question",
+        "errors": "Errors",
+        "errorRateLabel": "Error Rate",
+        "wrongAnswersWithCount": "Wrong Answers ({count})",
+        "wrongAnswers": "Wrong Answers",
+        "noWrongAnswers": "No wrong answers recorded.",
+        "studentAnswer": "Student Answer",
+        "studentCount": "{count} student(s)",
+        "notAnswered": "Not answered",
+        "selectQuestionHint": "Select a question from the left",
+        "selectQuestionHintDesc": "to view error analysis",
+        "noGradedSubmissions": "No graded submissions yet."
+      },
+      "take": {
+        "true": "True",
+        "false": "False"
+      },
+      "excellent": {
+        "title": "Excellent Submissions",
+        "description": "Top submissions scoring {minPercentage}% or above in this assignment.",
+        "empty": "No excellent submissions yet.",
+        "emptyHint": "They will appear here after grading is complete.",
+        "studentAnon": "Student",
+        "rank": "Rank {rank}",
+        "lateTag": "Late",
+        "submittedAt": "Submitted on {date}",
+        "scoreValue": "{score} / {max}",
+        "percentage": "{value}%"
+      },
+      "form": {
+        "createTitle": "Create Assignment",
+        "quickMode": "Quick Assignment",
+        "quickModeDescription": "Enter title and description directly, no questions needed",
+        "examMode": "Exam-based Assignment",
+        "examModeDescription": "Derive assignment from an existing exam",
+        "class": "Class",
+        "selectClass": "Select a class",
+        "sourceExam": "Source Exam",
+        "selectExam": "Select an exam",
+        "assignmentTitle": "Assignment Title",
+        "titlePlaceholderQuick": "e.g. Recite Lesson 3",
+        "titlePlaceholderExam": "Defaults to exam title",
+        "description": "Description (optional)",
+        "descriptionPlaceholderQuick": "Enter assignment requirements, question content, or instructions...",
+        "availableAt": "Available At (optional)",
+        "dueAt": "Due At (optional)",
+        "allowLate": "Allow late submissions",
+        "lateDueAt": "Late Due At (optional)",
+        "maxAttempts": "Max Attempts",
+        "submit": "Create Assignment",
+        "submitting": "Creating...",
+        "creating": "Creating assignment...",
+        "selectExamRequired": "Please select an exam",
+        "titleRequired": "Please enter a title",
+        "selectClassRequired": "Please select a class",
+        "createFailed": "Failed to create"
+      }
     }
   },
   "grades": {
@@ -733,7 +1089,18 @@
       "colMinScore": "Min",
       "colPassRate": "Pass Rate",
       "colPassCount": "Pass Count",
-      "colFailCount": "Fail Count"
+      "colFailCount": "Fail Count",
+      "noData": "No data",
+      "average": "Average",
+      "median": "Median",
+      "max": "Max",
+      "min": "Min",
+      "stdDev": "Std Dev",
+      "stdDevHint": "Reflects score dispersion",
+      "passRateHint": "Pass rate (>=60)",
+      "excellentRate": "Excellent Rate",
+      "excellentRateHint": "Excellent rate (>=85)",
+      "count": "Count"
     },
     "reportCard": {
       "title": "Report Card",
@@ -762,7 +1129,53 @@
     "error": {
       "title": "Grades page error",
       "unknown": "Unknown error",
-      "retry": "Retry"
+      "retry": "Retry",
+      "createdSuccess": "Question created successfully",
+      "updatedSuccess": "Question updated successfully",
+      "unexpected": "An unexpected error occurred"
+    },
+    "classReport": {
+      "studentCountInfo": "Expected {studentCount} students · {recordCount} records entered",
+      "noDataTitle": "No class grade data",
+      "noDataDescription": "Please enter grades before viewing the class report",
+      "classRanking": "Class Ranking",
+      "caption": "Class grade ranking table",
+      "rankColumn": "Rank",
+      "recordsColumn": "Records"
+    },
+    "growthArchive": {
+      "title": "Student Growth Archive",
+      "description": "Covering {years} academic years · {records} records · {subjects} subjects",
+      "descriptionEmpty": "No growth archive data",
+      "emptyTitle": "No growth data",
+      "emptyDescription": "At least two semesters of grade data are needed to show growth trends",
+      "deltaUp": "Up {delta} points from last period",
+      "deltaDown": "Down {delta} points from last period",
+      "deltaStable": "Stable compared to last period",
+      "overallAverage": "Overall average {score}",
+      "averageScore": "Average Score",
+      "ariaLabelNonEmpty": "Growth trend chart with {count} data points",
+      "ariaLabelEmpty": "Growth trend chart is empty",
+      "statsAverage": "Average {score}",
+      "statsPassRate": "Pass rate {rate}%",
+      "statsRecords": "{count} records"
+    },
+    "knowledgePointMastery": {
+      "title": "Knowledge Point Mastery",
+      "description": "{count} knowledge points · average mastery {avg}%",
+      "descriptionEmpty": "No knowledge point mastery data",
+      "emptyTitle": "No mastery data",
+      "emptyDescription": "Practice or exam data is needed to calculate mastery",
+      "viewDetail": "View Details",
+      "ariaLabel": "Knowledge point mastery bar chart with {count} points",
+      "averageMastery": "Average Mastery",
+      "tooltipMastery": "Mastery: {value}%",
+      "tooltipStudents": "Mastered {mastered} / {total} students",
+      "weakPointsAriaLabel": "Weak knowledge points list",
+      "weakPointsTitle": "Weak Knowledge Points"
+    },
+    "summary": {
+      "averageScore": "Average Score"
     }
   },
   "analytics": {
@@ -1001,7 +1414,261 @@
     "error": {
       "title": "AI module page error",
       "unknown": "AI module encountered an unknown error",
-      "retry": "Retry"
+      "retry": "Retry",
+      "invalidInput": "Invalid input data",
+      "chatFailed": "AI request failed",
+      "suggestionFailed": "AI suggestion failed",
+      "gradingFailed": "AI grading failed",
+      "contentFailed": "Content generation failed",
+      "variantFailed": "Question variant generation failed",
+      "analysisFailed": "Weakness analysis failed",
+      "statsFailed": "AI usage stats query failed",
+      "boundaryTitle": "AI Feature Error",
+      "boundaryDescription": "An error occurred while processing AI request. Please try again.",
+      "unauthorized": "You do not have permission to use AI features",
+      "providerNotConfigured": "AI provider not configured. Please contact administrator."
+    },
+    "chat": {
+      "title": "AI Assistant",
+      "placeholder": "Ask anything...",
+      "inputLabel": "Message input",
+      "send": "Send",
+      "thinking": "AI is thinking...",
+      "streaming": "AI is typing...",
+      "stopGeneration": "Stop generating",
+      "maxReached": "Maximum messages reached",
+      "clear": "Clear conversation",
+      "clearConfirm": "Clear all messages?",
+      "copy": "Copy",
+      "copied": "Copied!",
+      "suggestedPrompts": {
+        "title": "Try asking...",
+        "teacher": [
+          "Help me grade this question",
+          "Generate a classroom activity",
+          "Create a quiz question"
+        ],
+        "student": [
+          "Explain this concept",
+          "Give me a practice question",
+          "Help me study"
+        ],
+        "parent": [
+          "How is my child doing?",
+          "What should I focus on at home?"
+        ],
+        "admin": [
+          "Show AI usage stats",
+          "Which teachers use AI most?"
+        ],
+        "context": {
+          "teacherGrading": [
+            "What are common mistakes in this type of question?",
+            "How should I give constructive feedback?"
+          ],
+          "teacherLesson": [
+            "Suggest a hook for this lesson",
+            "What are some differentiation strategies?"
+          ],
+          "teacherExam": [
+            "Generate a question on this topic",
+            "Analyze the difficulty distribution"
+          ],
+          "studentHomework": [
+            "Give me a hint, not the answer",
+            "Help me understand this concept"
+          ]
+        }
+      },
+      "contextMessage": {
+        "teacherGrading": "Current page: Homework grading view",
+        "teacherLesson": "Current page: Lesson plan editor",
+        "teacherExam": "Current page: Exam builder",
+        "studentErrorBook": "Current page: Error book (student view)",
+        "studentHomework": "Current page: Student homework view",
+        "parent": "Current page: Parent dashboard",
+        "admin": "Current page: Admin dashboard"
+      }
+    },
+    "provider": {
+      "label": "AI Provider",
+      "placeholder": "Select provider",
+      "loading": "Loading providers...",
+      "default": "Default",
+      "description": "Select the AI configuration for this operation.",
+      "manage": "Manage",
+      "manageTitle": "AI Provider Settings",
+      "manageDescription": "Create a new provider or update existing configuration."
+    },
+    "suggestion": {
+      "title": "AI Suggestions",
+      "generate": "Generate Suggestions",
+      "regenerate": "Regenerate",
+      "loading": "AI is thinking...",
+      "empty": "No suggestions available",
+      "error": "Failed to generate suggestions",
+      "loaded": "Suggestions loaded",
+      "selected": "Suggestion selected",
+      "select": "Select",
+      "difficulty": "Difficulty",
+      "practiceNow": "Practice Now",
+      "addAll": "Add All"
+    },
+    "grading": {
+      "title": "AI Grading Suggestion",
+      "description": "AI-powered scoring and feedback for subjective questions",
+      "suggestedScore": "Suggested Score",
+      "confidence": "Confidence",
+      "feedback": "Feedback",
+      "reasoning": "Reasoning",
+      "applyScore": "Apply Score",
+      "applyFeedback": "Apply Feedback",
+      "loading": "AI is grading...",
+      "error": "AI grading failed",
+      "notAvailable": "AI grading not available for this question type",
+      "batchTitle": "Batch AI Grading",
+      "batchDescription": "Generate AI suggestions for all subjective questions at once",
+      "batchGenerate": "Generate All Suggestions",
+      "batchProgress": "Processing {done}/{total}",
+      "currentScore": "Current Score",
+      "scoreDifference": "Difference"
+    },
+    "errorBook": {
+      "similarQuestions": "Similar Questions",
+      "weaknessAnalysis": "Weakness Analysis",
+      "studyPlan": "Study Plan",
+      "recommendedResources": "Recommended Resources",
+      "weakAreas": "Weak Areas",
+      "severity": {
+        "high": "High",
+        "medium": "Medium",
+        "low": "Low"
+      }
+    },
+    "lessonPrep": {
+      "generateContent": "Generate Content",
+      "description": "AI-powered teaching content generation",
+      "generateActivity": "Suggest Activity",
+      "generateAssessment": "Generate Assessment",
+      "generateQuestion": "Generate Discussion Question",
+      "loading": "Generating...",
+      "error": "Content generation failed",
+      "additionalContext": "Additional context",
+      "additionalContextPlaceholder": "Add any specific requirements or context...",
+      "insertContent": "Insert Content",
+      "editBeforeInsert": "Edit before insert",
+      "history": "Generation History",
+      "clearHistory": "Clear history"
+    },
+    "exam": {
+      "generate": "Generate",
+      "generating": "Generating...",
+      "preview": "Preview",
+      "queue": "Add to Queue",
+      "queueRunning": "Running",
+      "queueQueued": "Queued",
+      "backgroundTasks": "Background Tasks",
+      "taskStatus": {
+        "queued": "Queued",
+        "running": "Running",
+        "success": "Completed",
+        "failed": "Failed"
+      },
+      "openPreview": "Open Preview",
+      "sourceText": "Source Exam Text",
+      "sourceTextPlaceholder": "Paste the full exam text to parse into questions.",
+      "sourceTextDesc": "AI will extract questions and structure from this text.",
+      "generationTitle": "AI Generation",
+      "generationDesc": "Paste the exam text and generate a structured preview.",
+      "variantType": {
+        "label": "Variant type",
+        "same_knowledge_point": "Same knowledge point, different context",
+        "different_difficulty": "Different difficulty level",
+        "different_format": "Different question format"
+      },
+      "targetDifficulty": "Target difficulty",
+      "addVariant": "Add Variant"
+    },
+    "parent": {
+      "summary": "AI Learning Summary",
+      "summaryDescription": "AI-generated overview of your child's learning progress",
+      "generateSummary": "Generate Summary",
+      "weaknessHint": "Areas to focus on",
+      "suggestion": "Family tutoring suggestion",
+      "loading": "Generating summary...",
+      "error": "Failed to generate summary"
+    },
+    "admin": {
+      "usageDashboard": "AI Usage Dashboard",
+      "dashboardDescription": "Monitor AI usage across the school",
+      "totalCalls": "Total AI Calls",
+      "activeUsers": "Active Users",
+      "costEstimate": "Estimated Cost",
+      "topUsers": "Top Users",
+      "byCapability": "By Capability",
+      "byRole": "By Role",
+      "recentActivity": "Recent Activity",
+      "noData": "No AI usage data available",
+      "callsToday": "Calls today",
+      "callsThisWeek": "Calls this week",
+      "errorRate": "Error rate",
+      "avgDuration": "Avg duration",
+      "settings": {
+        "title": "AI Settings",
+        "description": "Manage AI providers, API keys, and usage statistics.",
+        "descriptionAdmin": "Manage AI providers, API keys, and usage statistics (Admin view).",
+        "descriptionUser": "Manage your AI providers and API keys."
+      }
+    },
+    "studyPath": {
+      "title": "Your Learning Path",
+      "description": "AI-personalized learning recommendations",
+      "nextSteps": "Recommended Next Steps",
+      "mastered": "Mastered",
+      "inProgress": "In Progress",
+      "needsWork": "Needs Work",
+      "generate": "Generate Learning Path",
+      "loading": "Generating learning path...",
+      "error": "Failed to generate learning path",
+      "startLearning": "Start Learning"
+    },
+    "widget": {
+      "title": "AI Assistant",
+      "open": "Open AI Assistant",
+      "close": "Close",
+      "contextAware": "Context-aware",
+      "dragHint": "Drag to move · Long press edge to hide",
+      "hidden": "Hidden",
+      "show": "Show",
+      "hide": "Hide",
+      "resetPosition": "Reset position",
+      "welcome": "Hi, I'm your AI Assistant",
+      "welcomeDesc": "How can I help you today?",
+      "newChat": "New chat",
+      "history": "History",
+      "online": "Online",
+      "tokens": "{count} chars"
+    },
+    "safety": {
+      "blocked": "Your message was blocked by the safety filter. Please keep the conversation educational.",
+      "dailyLimit": "Daily AI usage limit reached. Please try again tomorrow.",
+      "studentMode": "AI is in student mode. It will guide you to find the answer.",
+      "contentFiltered": "Inappropriate content was filtered from the AI response."
+    },
+    "capability": {
+      "chat": "AI Chat",
+      "examGenerate": "AI Exam Generation",
+      "gradingAssist": "AI Grading Assist",
+      "lessonContent": "AI Lesson Content",
+      "questionVariant": "AI Question Variant",
+      "similarQuestion": "AI Similar Questions",
+      "weaknessAnalysis": "AI Weakness Analysis",
+      "childSummary": "AI Child Summary",
+      "studyPath": "AI Study Path",
+      "explainError": "AI Error Explanation"
+    },
+    "chart": {
+      "parseError": "Chart data format error, cannot render"
     }
   },
   "attendance": {
@@ -1030,7 +1697,12 @@
       "colStatus": "Status",
       "colRemark": "Remark",
       "colRecordedBy": "Recorded by",
-      "colUpdatedAt": "Updated"
+      "colUpdatedAt": "Updated",
+      "columns": {
+        "student": "Student",
+        "reason": "Reason",
+        "status": "Status"
+      }
     },
     "sheet": {
       "title": "Attendance Sheet",
@@ -1049,7 +1721,14 @@
       "errorNoEntries": "No entries to save",
       "success": "Sheet saved successfully",
       "error": "Save failed",
-      "loadFailed": "Load failed: {message}"
+      "loadFailed": "Load failed: {message}",
+      "selectClass": "Please select a class",
+      "reasonPlaceholder": "Enter reason",
+      "saved": "Attendance sheet saved",
+      "saving": "Saving...",
+      "noStudents": "No students in this class",
+      "confirmClassSwitch": "Switching class will discard unsaved changes. Confirm?",
+      "confirmClassSwitchAction": "Confirm switch"
     },
     "report": {
       "title": "Attendance Report",
@@ -1070,7 +1749,31 @@
       "colAbsent": "Absent",
       "colLate": "Late",
       "colLeave": "Leave",
-      "colAttendanceRate": "Attendance rate"
+      "colAttendanceRate": "Attendance rate",
+      "printing": "Printing...",
+      "relationship": "Relationship",
+      "period": "Period",
+      "parentSignature": "Parent signature",
+      "type": "Report type",
+      "noData": "No report data",
+      "controls": "Report controls",
+      "noDataDescription": "Adjust filters and try again",
+      "parentComment": "Parent comments",
+      "studentDetails": "Student details",
+      "footer": "This report is auto-generated by the system, for reference only.",
+      "generatedAt": "Generated at",
+      "signature": "Signature",
+      "parentName": "Parent name",
+      "summary": "Summary",
+      "startDate": "Start date",
+      "endDate": "End date",
+      "print": "Print",
+      "parentSignatureNotice": "Please review the attendance records above and sign to confirm.",
+      "signDate": "Sign date",
+      "types": {
+        "weekly": "Weekly",
+        "monthly": "Monthly"
+      }
     },
     "stats": {
       "title": "Attendance Stats",
@@ -1095,7 +1798,45 @@
     "error": {
       "title": "Attendance module error",
       "unknown": "Unknown attendance module error",
-      "retry": "Retry"
+      "retry": "Retry",
+      "createdSuccess": "Question created successfully",
+      "updatedSuccess": "Question updated successfully",
+      "unexpected": "An unexpected error occurred"
+    },
+    "filters": {
+      "class": "Class",
+      "date": "Date"
+    },
+    "description": {
+      "teacherRecords": "Teachers record student daily attendance"
+    },
+    "actions": {
+      "cancel": "Cancel",
+      "save": "Save",
+      "markAllPresent": "Mark all present"
+    },
+    "errors": {
+      "invalidForm": "Form has invalid fields",
+      "unexpected": "Operation failed, please try again later"
+    },
+    "period": {
+      "label": "Period",
+      "full_day": "Full day",
+      "morning_reading": "Morning reading",
+      "morning": "Morning",
+      "afternoon": "Afternoon",
+      "evening": "Evening"
+    },
+    "rules": {
+      "title": "Attendance Rules",
+      "lateThreshold": "Late threshold (minutes)",
+      "earlyLeaveThreshold": "Early leave threshold (minutes)",
+      "enableAutoMark": "Enable auto mark",
+      "attendanceRateThreshold": "Attendance rate threshold (%)",
+      "attendanceRateThresholdHint": "Alert triggered below this threshold",
+      "consecutiveAbsenceThreshold": "Consecutive absence threshold (count)",
+      "consecutiveAbsenceThresholdHint": "Alert triggered above this count",
+      "saved": "Rules saved"
     }
   },
   "questions": {
@@ -1137,7 +1878,121 @@
     "error": {
       "title": "Question page error",
       "unknown": "Unknown error",
-      "retry": "Retry"
+      "retry": "Retry",
+      "createdSuccess": "Question created successfully",
+      "updatedSuccess": "Question updated successfully",
+      "unexpected": "An unexpected error occurred"
+    },
+    "content": {
+      "empty": "No question content",
+      "answer": "Answer",
+      "explanation": "Explanation"
+    },
+    "actions": {
+      "menuLabel": "Actions",
+      "viewDetails": "View Details",
+      "delete": "Delete",
+      "deleteConfirmTitle": "Confirm Delete",
+      "deleteConfirmDesc": "Are you sure you want to delete this question? This action cannot be undone.",
+      "deleteConfirmCancel": "Cancel",
+      "deleting": "Deleting...",
+      "deleteSuccess": "Deleted successfully",
+      "deleteFailed": "Delete failed",
+      "copyId": "Copy ID",
+      "copyIdSuccess": "Copied to clipboard",
+      "copyIdFailed": "Copy failed",
+      "close": "Close",
+      "detailsTitle": "Question Details",
+      "detailsId": "Question ID",
+      "detailsType": "Type",
+      "detailsDifficulty": "Difficulty",
+      "detailsContent": "Content"
+    },
+    "batch": {
+      "selected": "{count} selected",
+      "delete": "Batch Delete",
+      "deleteConfirmTitle": "Confirm Batch Delete",
+      "deleteConfirmDesc": "Are you sure you want to delete the selected {count} question(s)? This action cannot be undone.",
+      "deleting": "Deleting...",
+      "deleteSuccess": "Batch delete successful",
+      "deleteFailed": "Batch delete failed",
+      "cancel": "Cancel",
+      "clear": "Clear selection",
+      "deleteConfirmAction": "Confirm Delete"
+    },
+    "cascade": {
+      "textbook": "Textbook",
+      "textbookAll": "All textbooks",
+      "chapter": "Chapter",
+      "chapterAll": "All chapters",
+      "knowledgePoint": "Knowledge Point",
+      "knowledgePointAll": "All knowledge points",
+      "loading": "Loading..."
+    },
+    "importExport": {
+      "import": "Import",
+      "export": "Export",
+      "importing": "Importing...",
+      "exporting": "Exporting...",
+      "importSuccess": "Import successful",
+      "importFailed": "Import failed",
+      "exportSuccess": "Export successful",
+      "exportFailed": "Export failed",
+      "confirmTitle": "Confirm Import",
+      "confirmDesc": "This will overwrite existing questions. Continue?",
+      "cancel": "Cancel",
+      "invalidFile": "Invalid file format",
+      "readFailed": "Failed to read file",
+      "confirmImport": "Confirm Import"
+    },
+    "table": {
+      "type": "Type",
+      "content": "Content",
+      "difficulty": "Difficulty",
+      "knowledgePoints": "Knowledge Points",
+      "created": "Created At",
+      "noResults": "No results"
+    },
+    "dialog": {
+      "editTitle": "Edit Question",
+      "createTitle": "Create Question",
+      "editDesc": "Edit the question details below.",
+      "createDesc": "Fill in the question details below.",
+      "questionType": "Question Type",
+      "difficulty": "Difficulty",
+      "questionContent": "Question Content",
+      "contentPlaceholder": "Enter question content...",
+      "answer": "Answer",
+      "explanation": "Explanation",
+      "cancel": "Cancel",
+      "updating": "Updating...",
+      "creating": "Creating...",
+      "update": "Update",
+      "create": "Create",
+      "addOption": "Add Option",
+      "markCorrect": "Mark as Correct",
+      "options": "Options",
+      "loading": "Loading...",
+      "knowledgePoints": "Knowledge Points",
+      "knowledgePointsOptional": "Knowledge Points (optional)",
+      "knowledgePointsSelected": "{count} knowledge points selected",
+      "noKnowledgePoints": "No knowledge points",
+      "searchKnowledgePoints": "Search knowledge points...",
+      "optionPlaceholder": "Option {index}"
+    },
+    "type": {
+      "single_choice": "Single Choice",
+      "multiple_choice": "Multiple Choice",
+      "judgment": "True / False",
+      "text": "Short Answer",
+      "composite": "Composite"
+    },
+    "difficulty": {
+      "1": "Easy",
+      "2": "Medium",
+      "3": "Hard",
+      "4": "Very Hard",
+      "5": "Expert"
     }
   },
   "textbooks": {
@@ -1185,12 +2040,151 @@
       "colChapterStatus": "Status",
       "noChapters": "No chapters",
       "noChaptersAction": "Back to textbook list",
-      "chaptersMswNotice": "Chapter list query contract pending, currently served by MSW."
+      "chaptersMswNotice": "Chapter list query contract pending, currently served by MSW.",
+      "sectionKnowledgeGraph": "Knowledge Graph"
     },
     "error": {
       "title": "Textbook page error",
       "unknown": "Unknown error",
       "retry": "Retry"
+    },
+    "graph": {
+      "viewModeStructure": "Structure",
+      "viewModeStudentMastery": "Student Mastery",
+      "viewModeClassMastery": "Class Mastery",
+      "searchPlaceholder": "Search knowledge point name...",
+      "resetView": "Reset View",
+      "refreshing": "Refreshing...",
+      "refresh": "Refresh",
+      "edit": "Edit",
+      "delete": "Delete",
+      "createQuestion": "Create Question",
+      "questionCount": "{count} question(s)",
+      "layout": {
+        "hierarchical": "Hierarchical",
+        "force": "Force-directed"
+      },
+      "error": {
+        "loadFailed": "Failed to load knowledge graph"
+      },
+      "node": {
+        "questions": "Questions",
+        "mastery": "Mastery",
+        "prerequisite": "Prerequisites",
+        "successor": "Successors"
+      },
+      "detail": {
+        "title": "Knowledge Point Detail",
+        "close": "Close",
+        "description": "Description",
+        "noDescription": "No description",
+        "correctRate": "Correct Rate",
+        "masteryNotAssessed": "Not assessed",
+        "totalQuestions": "Total Questions",
+        "viewAllQuestions": "View all questions",
+        "addPrerequisite": "Add prerequisite",
+        "removePrerequisite": "Remove prerequisite",
+        "noPrerequisites": "No prerequisites",
+        "noSuccessors": "No successors",
+        "prerequisiteRemoveFailed": "Failed to remove prerequisite"
+      }
+    },
+    "knowledge": {
+      "title": "Knowledge Points",
+      "create": "Create Knowledge Point",
+      "empty": "No knowledge points",
+      "difficulty": "Difficulty {level}"
+    },
+    "card": {
+      "gradeNA": "N/A",
+      "version": "v{version}",
+      "moreOptions": "More options",
+      "editContent": "Edit Content",
+      "delete": "Delete"
+    },
+    "reader": {
+      "contents": "Contents",
+      "noChapters": "No chapters",
+      "selectChapter": "Select a chapter to read",
+      "chapters": "Chapters",
+      "deleteFailed": "Failed to delete textbook",
+      "emptyKnowledge": "No knowledge points",
+      "emptyKnowledgeDesc": "No knowledge points have been entered for this textbook yet. Please create knowledge points under chapters first.",
+      "loadingKnowledge": "Loading knowledge points..."
+    },
+    "action": {
+      "updateNotSupported": "Update not supported (contract pending).",
+      "kpCreateNotSupported": "Creating knowledge points not supported (contract pending).",
+      "deleteNotSupported": "Delete not supported (contract pending).",
+      "updateFailedGeneric": "Update failed",
+      "deleteFailed": "Delete failed",
+      "errorOccurred": "An error occurred",
+      "prerequisiteAddNotSupported": "Adding prerequisites not supported (dialog pending migration).",
+      "prerequisiteDeleteNotSupported": "Deleting prerequisites not supported (mutation pending)."
+    },
+    "dialog": {
+      "chapter": {
+        "createTitle": "Create Chapter",
+        "titlePlaceholder": "Chapter title...",
+        "cancel": "Cancel",
+        "create": "Create",
+        "cannotDeleteWithSubchapters": "Cannot delete a chapter that has subchapters. Please delete subchapters first."
+      },
+      "knowledge": {
+        "editTitle": "Edit Knowledge Point",
+        "nameLabel": "Name",
+        "cancel": "Cancel",
+        "saving": "Saving...",
+        "save": "Save",
+        "deleteTitle": "Delete Knowledge Point",
+        "deleteDesc": "Are you sure you want to delete this textbook? This action cannot be undone.",
+        "delete": "Delete"
+      },
+      "settings": {
+        "title": "Textbook Settings",
+        "save": "Save",
+        "deleteConfirmTitle": "Confirm Delete",
+        "deleteConfirmDesc": "Are you sure you want to delete this textbook? This action cannot be undone.",
+        "processing": "Processing...",
+        "delete": "Delete"
+      },
+      "textbook": {
+        "titleLabel": "Title",
+        "titlePlaceholder": "Enter textbook title...",
+        "subjectLabel": "Subject",
+        "subjectPlaceholder": "Select subject",
+        "gradeLabel": "Grade",
+        "gradePlaceholder": "Select grade",
+        "versionLabel": "Version",
+        "versionPlaceholder": "Enter version...",
+        "editTitle": "Edit Textbook",
+        "createTitle": "Create Textbook",
+        "save": "Save"
+      }
+    },
+    "subject": {
+      "chinese": "Chinese",
+      "mathematics": "Mathematics",
+      "physics": "Physics",
+      "chemistry": "Chemistry",
+      "biology": "Biology",
+      "english": "English",
+      "history": "History",
+      "geography": "Geography"
+    },
+    "grade": {
+      "grade1": "Grade 1",
+      "grade2": "Grade 2",
+      "grade3": "Grade 3",
+      "grade4": "Grade 4",
+      "grade5": "Grade 5",
+      "grade6": "Grade 6",
+      "grade7": "Grade 7",
+      "grade8": "Grade 8",
+      "grade9": "Grade 9",
+      "grade10": "Grade 10",
+      "grade11": "Grade 11",
+      "grade12": "Grade 12"
     }
   },
   "lessonPlans": {
@@ -1309,7 +2303,184 @@
     "error": {
       "title": "Lesson plan page error",
       "unknown": "An unknown error occurred",
-      "retry": "Retry"
+      "retry": "Retry",
+      "createdSuccess": "Question created successfully",
+      "updatedSuccess": "Question updated successfully",
+      "unexpected": "An unexpected error occurred"
+    },
+    "action": {
+      "close": "Close",
+      "cancel": "Cancel",
+      "confirm": "Confirm",
+      "delete": "Delete"
+    },
+    "attachment": {
+      "title": "Attachment Library",
+      "add": "Upload Attachment",
+      "libraryLabel": "Library",
+      "loading": "Loading...",
+      "empty": "No attachments",
+      "delete": "Delete",
+      "uploadFailed": "Upload failed",
+      "uploadSuccess": "Upload success",
+      "type": {
+        "material": "Material",
+        "resource": "Resource",
+        "other": "Other"
+      }
+    },
+    "knowledgePoint": {
+      "title": "Select Knowledge Points",
+      "empty": "No knowledge points"
+    },
+    "consistency": {
+      "title": "Consistency Check",
+      "loading": "Checking...",
+      "allPassed": "All passed",
+      "hasErrors": "Has errors",
+      "hasWarnings": "Has warnings"
+    },
+    "aiDifferentiation": {
+      "title": "AI Differentiated Instruction",
+      "loading": "AI analyzing...",
+      "empty": "No suggestions",
+      "covered": "{count} covered",
+      "missed": "{count} missed",
+      "tabs": {
+        "differentiation": "Differentiation",
+        "curriculum": "Curriculum Alignment",
+        "assessment": "Assessment"
+      },
+      "level": {
+        "basic": "Basic",
+        "intermediate": "Intermediate",
+        "advanced": "Advanced"
+      }
+    },
+    "feedback": {
+      "title": "AI Feedback",
+      "loading": "AI analyzing...",
+      "empty": "No feedback",
+      "apply": "Apply",
+      "category": {
+        "strengths": "Strengths",
+        "improvements": "Improvements",
+        "alignment": "Alignment",
+        "differentiation": "Differentiation"
+      }
+    },
+    "banner": {
+      "anchorMigration": "Legacy anchor data detected, automatically migrated to new format."
+    },
+    "exercise": {
+      "difficulty": "Difficulty",
+      "contentPlaceholder": "Enter question content...",
+      "questionId": "Question #{id}",
+      "inlineQuestion": "Inline Question",
+      "questionType": {
+        "single_choice": "Single Choice",
+        "multiple_choice": "Multiple Choice",
+        "text": "Text",
+        "judgment": "Judgment",
+        "composite": "Composite"
+      }
+    },
+    "detail": {
+      "selectNodeHint": "Select a node on the left to view details",
+      "aiAssist": "AI Assistant",
+      "aiGenerateLayered": "Generate Layered Exercises",
+      "aiFillExpected": "Fill Expected Answers",
+      "aiOptimizeFollowup": "Optimize Follow-up",
+      "aiGenerate": "AI Generate",
+      "aiOptimize": "AI Optimize",
+      "aiDifferentiation": "AI Differentiation",
+      "designIntent": "Design Intent",
+      "qaDialog": "Q&A Dialog",
+      "addTurn": "Add Turn",
+      "turnTeacher": "Teacher",
+      "turnStudent": "Student",
+      "round": "Round {n}",
+      "turnContentPlaceholder": "Enter content...",
+      "expectedAnswer": "Expected answer...",
+      "stageLabel": "Stage",
+      "differentiationLabel": "Differentiation Level",
+      "titleLabel": "Title",
+      "stageNone": "(none)",
+      "typeLabel": "Type",
+      "stage": {
+        "import": "Import",
+        "new_teaching": "New Teaching",
+        "consolidation": "Consolidation",
+        "summary": "Summary"
+      }
+    },
+    "version": {
+      "historyTitle": "Version History",
+      "empty": "No history versions",
+      "auto": "Auto-save",
+      "revert": "Revert",
+      "compare": "Compare",
+      "diffCount": "{count} differences"
+    },
+    "dialog": {
+      "versions": "Version History",
+      "print": "Print Preview",
+      "schedule": "Schedule",
+      "consistency": "Consistency Check",
+      "aiFeedback": "AI Feedback",
+      "aiDifferentiation": "AI Differentiation"
+    },
+    "homework": {
+      "type": {
+        "exercise": "Exercise",
+        "reading": "Reading",
+        "writing": "Writing"
+      }
+    },
+    "blackboard": {
+      "layout": {
+        "structure": "Structure",
+        "mindmap": "Mind Map",
+        "text": "Text"
+      }
+    },
+    "keyPoint": {
+      "type": {
+        "key": "Key Point",
+        "difficult": "Difficult Point"
+      }
+    },
+    "import": {
+      "method": {
+        "question": "Question",
+        "situation": "Situation",
+        "review": "Review",
+        "other": "Other"
+      }
+    },
+    "objective": {
+      "dimension": {
+        "knowledge": "Knowledge & Skills",
+        "process": "Process & Methods",
+        "emotion": "Emotional Attitudes & Values"
+      }
+    },
+    "reflection": {
+      "aspect": {
+        "effectiveness": "Effectiveness",
+        "problems": "Problems",
+        "improvements": "Improvements"
+      }
+    },
+    "newTeaching": {
+      "pointIndex": "Point {index}"
+    },
+    "paper": {
+      "textbookHeader": "Textbook Content",
+      "textbookPlaceholder": "Enter textbook content...",
+      "expandedCount": "Expanded: {count} nodes",
+      "insertNode": "Insert Node",
+      "consistencyCheck": "Consistency Check"
     }
   },
   "coursePlans": {
@@ -1333,7 +2504,113 @@
       "colUpdatedAt": "Updated",
       "colActions": "Actions",
       "viewDetail": "View Detail →",
-      "mswNotice": "List query contract pending; ensure NEXT_PUBLIC_MSW=1 is enabled."
+      "mswNotice": "List query contract pending; ensure NEXT_PUBLIC_MSW=1 is enabled.",
+      "new": "New Plan",
+      "empty": "No course plans",
+      "emptyFiltered": "No matching plans",
+      "noClass": "Unassigned class",
+      "unknownSubject": "Unknown subject",
+      "semester": "Semester {semester}",
+      "created": "Created on {date}"
+    },
+    "progress": {
+      "label": "Progress",
+      "hours": "{completed}/{total} hours · {percent}%",
+      "weekPlansCompleted": "{completed}/{total} week plans completed"
+    },
+    "status": {
+      "planning": "Planning",
+      "active": "Active",
+      "completed": "Completed",
+      "paused": "Paused"
+    },
+    "filter": {
+      "placeholder": "Filter by status",
+      "all": "All statuses"
+    },
+    "calendar": {
+      "title": "Teaching Calendar",
+      "weekShort": [
+        "Mon",
+        "Tue",
+        "Wed",
+        "Thu",
+        "Fri",
+        "Sat",
+        "Sun"
+      ],
+      "monthTitle": "{month} {year}",
+      "prevMonth": "Previous month",
+      "nextMonth": "Next month",
+      "today": "Today",
+      "week": "Week {week}",
+      "hours": "{hours} hours",
+      "completed": "Completed",
+      "pending": "Pending",
+      "noStartDate": "Course plan has no start date, calendar view unavailable",
+      "noPlans": "No teaching plans this month"
+    },
+    "form": {
+      "new": "New Course Plan",
+      "edit": "Edit Course Plan",
+      "class": "Class",
+      "selectClass": "Select class",
+      "subject": "Subject",
+      "selectSubject": "Select subject",
+      "teacher": "Teacher",
+      "selectTeacher": "Select teacher",
+      "academicYear": "Academic Year",
+      "optional": "Optional",
+      "semester": "Semester",
+      "semester1": "First Semester",
+      "semester2": "Second Semester",
+      "status": "Status",
+      "selectStatus": "Select status",
+      "totalHours": "Total Hours",
+      "weeklyHours": "Weekly Hours",
+      "startDate": "Start Date",
+      "endDate": "End Date",
+      "syllabus": "Syllabus",
+      "syllabusPlaceholder": "Syllabus and scope...",
+      "objectives": "Objectives",
+      "objectivesPlaceholder": "Teaching objectives and expected outcomes...",
+      "cancel": "Cancel",
+      "create": "Create",
+      "save": "Save",
+      "saving": "Saving...",
+      "invalidState": "Invalid form state",
+      "saveFailed": "Save failed"
+    },
+    "templates": {
+      "title": "Create from Template",
+      "createFromTemplate": "Copy from existing plan",
+      "searchPlaceholder": "Search by class, subject, or teacher...",
+      "empty": "No templates available",
+      "cancel": "Cancel",
+      "confirm": "Copy",
+      "cloning": "Cloning...",
+      "cloneSuccess": "New plan created from template",
+      "cloneFailed": "Clone failed"
+    },
+    "export": {
+      "csv": "Export CSV",
+      "filename": "{subject}_{className}_CoursePlan",
+      "content": "Content",
+      "notes": "Notes",
+      "exported": "Exported",
+      "exportFailed": "Export failed"
+    },
+    "toast": {
+      "deleted": "Course plan deleted",
+      "deleteFailed": "Delete failed",
+      "bulkMarked": "Bulk marked {count} items",
+      "bulkFailed": "Bulk operation failed"
+    },
+    "bulk": {
+      "markComplete": "Bulk mark complete"
+    },
+    "loading": {
+      "title": "Loading..."
     },
     "detail": {
       "title": "Course Plan Detail",
@@ -1359,7 +2636,71 @@
       "colUnitOrder": "#",
       "colUnitTitle": "Unit Title",
       "colUnitProgress": "Progress",
-      "colUnitStatus": "Status"
+      "colUnitStatus": "Status",
+      "back": "Back",
+      "heading": "Course Plan Details",
+      "edit": "Edit",
+      "delete": "Delete",
+      "deleteTitle": "Delete Course Plan",
+      "deleteDescription": "Are you sure you want to delete this course plan? This action cannot be undone.",
+      "week": "Week",
+      "topic": "Topic",
+      "hours": "Hours",
+      "chapter": "Textbook Chapter",
+      "statusCol": "Status",
+      "weekPlans": "Weekly Plans",
+      "addWeekPlan": "Add Weekly Plan",
+      "emptyWeekPlans": "No weekly plans",
+      "emptyWeekPlansCta": ". Click the button above to add",
+      "reorderSaved": "Reorder saved",
+      "reorderFailed": "Reorder failed",
+      "noClass": "Unassigned class",
+      "unknownSubject": "Unknown subject",
+      "unknownSubjectHeading": "Unknown Subject",
+      "semester": "Semester {semester}",
+      "teacher": "Teacher: {name}",
+      "unassigned": "Unassigned teacher",
+      "created": "Created on {date}",
+      "startDate": "Starts on {date}",
+      "endDate": "Ends on {date}",
+      "syllabus": "Syllabus",
+      "objectives": "Objectives",
+      "completed": "Completed",
+      "pending": "Pending",
+      "selectWeekAria": "Select week {week}",
+      "viewHomeworkAria": "View homework",
+      "viewTextbookAria": "View textbook chapter {chapter}",
+      "dragHandle": "Drag to reorder",
+      "notes": "Notes: {notes}"
+    },
+    "item": {
+      "addTitle": "New Week Plan",
+      "editTitle": "Edit Week Plan",
+      "week": "Week",
+      "hours": "Hours",
+      "topic": "Topic",
+      "topicPlaceholder": "Enter this week's topic",
+      "content": "Content",
+      "contentPlaceholder": "Enter this week's teaching content",
+      "chapter": "Textbook Chapter",
+      "chapterPlaceholder": "e.g., Chapter 3",
+      "completedAt": "Completed Date",
+      "notes": "Notes",
+      "notesPlaceholder": "Optional notes",
+      "cancel": "Cancel",
+      "save": "Save",
+      "saving": "Saving...",
+      "delete": "Delete",
+      "markComplete": "Mark Complete",
+      "markIncomplete": "Mark Incomplete",
+      "invalidState": "Invalid form state",
+      "saveFailed": "Save failed",
+      "deleteFailed": "Delete failed",
+      "updateFailed": "Update failed",
+      "createSuccess": "Week plan created",
+      "updateSuccess": "Week plan updated",
+      "deleteSuccess": "Week plan deleted",
+      "toggleSuccess": "Completion status updated"
     },
     "error": {
       "title": "Course Plans module error",
@@ -1441,11 +2782,458 @@
     "error": {
       "title": "Diagnostic page error",
       "unknown": "An unknown error occurred in the diagnostic module",
-      "retry": "Retry"
+      "retry": "Retry",
+      "generateClassFailed": "Failed to generate class diagnostic report",
+      "loadFailed": "Data loading failed"
+    },
+    "classDiagnostic": {
+      "noClassDataTitle": "No Class Diagnostic Data",
+      "heatmapDescription": "Darker colors indicate lower mastery. Click a cell for details.",
+      "heatmapAriaLabel": "Knowledge point mastery heatmap, {count} knowledge points",
+      "heatmapCellAriaLabel": "{name}: {level}%, {label}, {mastered} mastered / {total} total",
+      "masteryLevelExcellent": "Excellent",
+      "masteryLevelGood": "Good",
+      "masteryLevelNeedsImprovement": "Needs Improvement",
+      "masteryLevelWeak": "Weak",
+      "legendLabel": "Legend:",
+      "filterByKpTitle": "Filter Students by Knowledge Point",
+      "filterByKpDescription": "Select a knowledge point to view all students mastery of it",
+      "kpFilterLabel": "Knowledge Point",
+      "kpFilterPlaceholder": "Select a knowledge point",
+      "kpFilterAll": "All Knowledge Points",
+      "filtering": "Filtering...",
+      "avgMasteryColumn": "Average Mastery",
+      "totalQuestionsColumn": "Total Questions",
+      "correctQuestionsColumn": "Correct Answers",
+      "statusColumn": "Status",
+      "needsAttention": "Needs Attention",
+      "mastered": "Mastered",
+      "viewAriaLabel": "View {studentName} diagnostic detail",
+      "viewAction": "View",
+      "noStudentsForKp": "No student data for this knowledge point",
+      "knowledgePointColumn": "Knowledge Point",
+      "masteredColumn": "Mastered Count",
+      "notMasteredColumn": "Not Mastered Count",
+      "noRankingData": "No ranking data",
+      "studentsNeedingAttentionTitle": "Students Needing Attention",
+      "studentsNeedingAttentionDescription": "Students with mastery below threshold",
+      "allStudentsAboveThreshold": "All students mastery above threshold",
+      "weakPointsColumn": "Weak Points Count",
+      "generateDescription": "Select period and generate class diagnostic report",
+      "periodLabel": "Period",
+      "generating": "Generating...",
+      "generateButton": "Generate Report"
+    },
+    "empty": {
+      "noClassData": "No class assigned or no diagnostic data for the class",
+      "noData": "No diagnostic data"
+    },
+    "summary": {
+      "class": "Class",
+      "students": "Students",
+      "avgMastery": "Average Mastery",
+      "needAttention": "Need Attention",
+      "student": "Student",
+      "overallMastery": "Overall Mastery",
+      "strengths": "Strengths",
+      "weaknesses": "Weaknesses"
+    },
+    "chart": {
+      "heatmapTitle": "Knowledge Point Mastery Heatmap",
+      "rankingTitle": "Knowledge Point Mastery Ranking",
+      "radarTitle": "Knowledge Point Mastery Radar",
+      "radarDescriptionNonEmpty": "Student score vs class average",
+      "radarEmptyTitle": "No Mastery Data",
+      "radarAriaLabelEmpty": "Radar chart is empty, no mastery data for student",
+      "radarAriaLabelNonEmpty": "Radar chart, {count} knowledge points{withClassAverage}",
+      "withClassAverage": "(including class average)",
+      "studentSeries": "Student",
+      "classAvgSeries": "Class Average",
+      "noMasteryDataForStudent": "No mastery data for this student"
+    },
+    "strengths": {
+      "title": "Strength Knowledge Points"
+    },
+    "weaknesses": {
+      "title": "Weak Knowledge Points",
+      "practice": "Practice"
+    },
+    "status": {
+      "draft": "Draft",
+      "published": "Published",
+      "archived": "Archived"
+    },
+    "type": {
+      "individual": "Individual",
+      "class": "Class",
+      "grade": "Grade"
+    },
+    "report": {
+      "generateClass": "Generate Class Diagnostic Report",
+      "recommendations": "Recommendations",
+      "history": "Historical Reports"
+    },
+    "reportList": {
+      "actionsColumn": "Actions",
+      "allStatuses": "All Statuses",
+      "allTypes": "All Types",
+      "cancel": "Cancel",
+      "caption": "Diagnostic Reports List",
+      "classReportPlaceholder": "Class Report",
+      "confidenceColumn": "Confidence",
+      "confidenceHigh": "High Confidence",
+      "confidenceInsufficient": "Insufficient Data",
+      "confidenceLow": "Low Confidence",
+      "confidenceMedium": "Medium Confidence",
+      "confidenceHighHint": "Sufficient sample data, high reliability",
+      "confidenceMediumHint": "Average sample data, for reference only",
+      "confidenceLowHint": "Insufficient sample data, recommend gathering more data",
+      "confidenceAriaLabel": "Confidence: {level}",
+      "dateColumn": "Generated At",
+      "deleteAction": "Delete",
+      "deleteConfirmation": "Confirm delete this diagnostic report? This action cannot be undone.",
+      "deleteSuccess": "Diagnostic report deleted",
+      "deleteTitle": "Delete Report",
+      "deleting": "Deleting...",
+      "emptyNoReports": "No Diagnostic Reports",
+      "exportAction": "Export",
+      "exportPending": "Export contract not ready (@contract-pending), will be wired via GraphQL later",
+      "filterReportType": "Filter by Type",
+      "filterStatus": "Filter by Status",
+      "generatedByColumn": "Generated By",
+      "gradeReportPlaceholder": "Grade Report",
+      "noReportsDescription": "Diagnostic reports will appear here after students complete homework or exams",
+      "periodColumn": "Period",
+      "publishAction": "Publish",
+      "publishConfirmation": "Confirm publish this diagnostic report? It will be visible to related users after publishing.",
+      "publishing": "Publishing...",
+      "publishSuccess": "Diagnostic report published",
+      "publishTitle": "Publish Report",
+      "reportType": "Report Type",
+      "scoreColumn": "Score",
+      "status": "Status",
+      "statusColumn": "Status",
+      "studentTargetColumn": "Target",
+      "typeColumn": "Type"
+    },
+    "studentDiagnostic": {
+      "noDataDescription": "No diagnostic data for this student. Please complete related homework or exams first",
+      "strengthsDescription": "Knowledge points with mastery >= 80%",
+      "noStrengths": "No strength knowledge points",
+      "strengthsListAriaLabel": "Strength knowledge points list",
+      "weaknessesDescription": "Knowledge points with mastery < 80%, click practice to reinforce",
+      "noWeaknesses": "No weak knowledge points",
+      "weaknessesListAriaLabel": "Weak knowledge points list",
+      "practiceAriaLabel": "Practice knowledge point {name}",
+      "diagnosticReportTitle": "Diagnostic Report",
+      "reportMeta": "Period: {period} · Score: {score}",
+      "recommendationsListAriaLabel": "Recommendations list",
+      "historyDescription": "Historical diagnostic reports list",
+      "untitledPeriod": "Untitled Period",
+      "historyReportMeta": "Generated at {date} · Score: {score}"
     }
   },
   "errorBook": {
     "title": "Error Book",
+    "description": "Automatically collect wrong answers from exams and homework, review scientifically",
+    "stats": {
+      "total": "Total Errors",
+      "new": "New",
+      "learning": "Learning",
+      "mastered": "Mastered",
+      "dueReview": "Due Review",
+      "masteredRate": "Mastery Rate",
+      "totalDesc": "Total collected errors",
+      "newDesc": "Not yet reviewed",
+      "learningDesc": "Being reviewed",
+      "masteredDesc": "Mastery rate {rate}%",
+      "dueReviewDesc": "Due today",
+      "totalErrorQuestions": "Total Error Questions",
+      "totalErrorCount": "Total Error Count",
+      "recent7dErrors": "Recent 7d Errors",
+      "knowledgePointCount": "Knowledge Points"
+    },
+    "status": {
+      "new": "New",
+      "learning": "Learning",
+      "mastered": "Mastered",
+      "archived": "Archived"
+    },
+    "source": {
+      "exam": "Exam",
+      "homework": "Homework",
+      "manual": "Manual"
+    },
+    "review": {
+      "again": "Again",
+      "hard": "Hard",
+      "good": "Good",
+      "easy": "Easy",
+      "againDesc": "Don't know, review tomorrow",
+      "hardDesc": "Barely correct, review in 2 days",
+      "goodDesc": "Correct, review in 4 days",
+      "easyDesc": "Easy, review in 7 days"
+    },
+    "actions": {
+      "add": "Add Manually",
+      "viewDetail": "View Details",
+      "saveNote": "Save Note",
+      "archive": "Archive",
+      "delete": "Delete",
+      "collect": "Collect Errors",
+      "cancel": "Cancel",
+      "adding": "Adding..."
+    },
+    "fields": {
+      "question": "Select Question",
+      "note": "Study Note",
+      "errorTags": "Error Reason Tags",
+      "masteryLevel": "Mastery Level",
+      "reviewCount": "Review Count",
+      "nextReview": "Next Review",
+      "createdAt": "Added At",
+      "student": "Student",
+      "className": "Class"
+    },
+    "masteryLevel": {
+      "0": "Not Started",
+      "1": "Beginner",
+      "2": "Familiar",
+      "3": "Proficient",
+      "4": "Skilled",
+      "5": "Mastered"
+    },
+    "questionType": {
+      "single_choice": "Single Choice",
+      "multiple_choice": "Multiple Choice",
+      "judgment": "True/False",
+      "text": "Short Answer",
+      "composite": "Composite"
+    },
+    "errorTags": {
+      "concept": "Concept Gap",
+      "calculation": "Calculation Error",
+      "careless": "Careless",
+      "misread": "Misread Question",
+      "method": "Wrong Method",
+      "memory": "Memory Error",
+      "time": "Out of Time"
+    },
+    "itemCard": {
+      "questionDeleted": "Question deleted",
+      "questionContent": "Question content",
+      "difficulty": "Difficulty {level}",
+      "mastery": "Mastery: {level}",
+      "reviewTimes": "Reviewed {count} times",
+      "needReview": "Needs review",
+      "nextReview": "Next {date}",
+      "addedAt": "Added on {date}",
+      "masteryOutOf": "Mastery: {level}/5"
+    },
+    "detailDialog": {
+      "question": "Question",
+      "myAnswer": "My Answer",
+      "correctAnswer": "Correct Answer",
+      "aiAnalysis": "AI Analysis",
+      "reviewSelf": "Self Review",
+      "studyNote": "Study Note",
+      "notePlaceholder": "Record your reflections, solutions, common mistakes...",
+      "errorTagsLabel": "Error Reason Tags",
+      "reviewHistory": "Review History",
+      "questionDeleted": "Question deleted",
+      "variantPractice": "Variant Practice",
+      "variantPracticeDesc": "Practice with variants from this error"
+    },
+    "filters": {
+      "searchPlaceholder": "Search notes...",
+      "status": "Status",
+      "source": "Source",
+      "review": "Review",
+      "allStatus": "All Status",
+      "allSource": "All Sources",
+      "allErrors": "All Errors",
+      "dueOnly": "Due Only"
+    },
+    "addDialog": {
+      "title": "Add Error",
+      "description": "Select a question from the question bank to add to your error book. Errors are also auto-collected after completing homework/exams.",
+      "selectQuestion": "Select Question",
+      "selectPlaceholder": "Select from bank...",
+      "noteLabel": "Study Note (optional)",
+      "notePlaceholder": "Record error reasons, solutions...",
+      "errorTagsLabel": "Error Reason Tags",
+      "questionPreview": "Question"
+    },
+    "empty": {
+      "title": "Error book is empty",
+      "description": "Wrong answers from exams and homework will be collected here automatically. You can also add manually."
+    },
+    "teacher": {
+      "title": "Error Analysis",
+      "description": "View class error statistics and weak knowledge points to support precision teaching",
+      "descriptionShort": "View class error statistics and weak knowledge points by subject.",
+      "coverage": "Student Coverage",
+      "totalErrors": "Total Errors",
+      "avgMastery": "Avg Mastery Rate",
+      "weakPoints": "Weak Knowledge Points",
+      "subjectDist": "Subject Distribution",
+      "studentDetail": "Student Error Details",
+      "topWrong": "Top Wrong Questions",
+      "noClass": "No classes assigned",
+      "noClassDesc": "You have not been assigned to any class. Unable to view error analysis data.",
+      "noStudent": "No students in class",
+      "noStudentDesc": "There are no students in the class. Unable to view error analysis data.",
+      "noChapterDataTitle": "No Chapter Error Data",
+      "noChapterDataDesc": "Knowledge points have not been linked to chapters. Unable to display chapter-level statistics.",
+      "noKpDataTitle": "No Knowledge Point Data",
+      "noKpDataDesc": "Errors have not been linked to knowledge points. Unable to display weak point statistics.",
+      "noStudentErrorsTitle": "No Student Errors",
+      "noStudentErrorsDesc": "No student error data for the selected range.",
+      "studentsCount": "{total} students total, {withErrors} with errors"
+    },
+    "parent": {
+      "title": "Child Error Book",
+      "description": "View your child's error statistics and learning progress",
+      "noChild": "No children linked",
+      "noChildDesc": "Your account is not linked to any children yet. Please contact the school administrator.",
+      "unknown": "Unknown",
+      "totalErrors": "Total Errors",
+      "dueReview": "Due Review",
+      "newItems": "New",
+      "mastered": "Mastered",
+      "mastery": "{rate}% Mastery",
+      "weakPoints": "Weak Knowledge Points",
+      "errorsAndMastery": "{count} errors · {rate}% mastery"
+    },
+    "admin": {
+      "title": "School-wide Error Analysis",
+      "description": "School-wide error statistics and weak point analysis for teaching decisions",
+      "description2": "View school-wide error statistics and weak knowledge points by subject.",
+      "noPermissionTitle": "Insufficient Permissions",
+      "noPermissionDescription": "You do not have permission to view school-wide error analysis data.",
+      "noStudentsTitle": "No Student Data",
+      "noStudentsDescription": "No student users in the system. Unable to display error analysis.",
+      "topStudents": "Top 50 Students with Most Errors",
+      "studentsWithErrors": "{count} students with errors",
+      "noChapterDataTitle": "No Chapter Error Data",
+      "noChapterDataDescription": "Knowledge points have not been linked to chapters. Unable to display chapter-level statistics.",
+      "noKnowledgePointDataTitle": "No Knowledge Point Data",
+      "noKnowledgePointDataDescription": "Errors have not been linked to knowledge points. Unable to display weak point statistics.",
+      "noStudentErrorsTitle": "No Student Errors",
+      "noStudentErrorsDescription": "No student error data for the selected subject."
+    },
+    "analyticsStats": {
+      "coverage": "Coverage",
+      "coverageSub": "/ {total}",
+      "totalErrors": "Total Errors",
+      "totalErrorsSub": "{avg} per student",
+      "avgMastery": "Avg Mastery",
+      "avgMasteryGood": "Good",
+      "avgMasteryNeedImprove": "Needs improvement",
+      "dueReview": "Due Review",
+      "dueReviewNeedAttention": "Needs attention",
+      "dueReviewNone": "None due",
+      "knowledgePoints": "Knowledge Points",
+      "knowledgePointsWide": "Wide range",
+      "knowledgePointsFocused": "Focused"
+    },
+    "subjectTabs": {
+      "all": "All Subjects",
+      "dueReview": "Due {count}"
+    },
+    "classFilter": {
+      "all": "All Classes",
+      "errorCount": "{count} errors",
+      "dueReview": "{count} due"
+    },
+    "topWrong": {
+      "title": "Top Wrong Questions",
+      "topTitle": "Top 10 Wrong Questions",
+      "emptyTitle": "No frequent wrong questions",
+      "emptyDesc": "After students complete homework or exams, frequency statistics will appear here.",
+      "errorCount": "{count} students wrong",
+      "masteredCount": "{count} mastered",
+      "masteryRate": "Mastery rate {rate}%"
+    },
+    "weaknessChart": {
+      "title": "Weak Knowledge Points Top {count}",
+      "errorCount": "Errors",
+      "chapterLabel": "Chapter: {title}",
+      "masteredLabel": "Mastered",
+      "masteryRateLabel": "Mastery Rate",
+      "unclassified": "Unclassified"
+    },
+    "chapterChart": {
+      "title": "Chapter Error Distribution",
+      "errorCount": "Errors",
+      "masteredLabel": "Mastered",
+      "masteryRateLabel": "Mastery Rate",
+      "knowledgePointCount": "Knowledge Points",
+      "weakKpsLabel": "Weak points:",
+      "knowledgePointBadge": "{count} knowledge points"
+    },
+    "classErrorBar": {
+      "title": "Class Error Comparison",
+      "errorCount": "Total Errors",
+      "studentCount": "Students",
+      "avgPerStudent": "Avg per student",
+      "avgMastery": "Avg Mastery",
+      "dueReview": "Due Review"
+    },
+    "subjectDistChart": {
+      "title": "Subject Error Distribution",
+      "errorCount": "Errors",
+      "masteredLabel": "Mastered",
+      "masteryRateLabel": "Mastery Rate"
+    },
+    "groupedTable": {
+      "unclassified": "Unclassified",
+      "studentCount": "{count}",
+      "studentsWithErrors": "{count} with errors",
+      "totalErrors": "Total Errors",
+      "avgMastery": "Avg Mastery",
+      "student": "Student",
+      "new": "New",
+      "learning": "Learning",
+      "mastered": "Mastered",
+      "dueReview": "Due",
+      "masteryRate": "Mastery Rate",
+      "unknown": "Unknown"
+    },
+    "classOverview": {
+      "coverage": "Coverage",
+      "coverageDesc": "Students with error records",
+      "totalErrors": "Total Errors",
+      "totalErrorsDesc": "Class cumulative errors",
+      "avgMastery": "Avg Mastery",
+      "avgMasteryDesc": "Mastered error ratio",
+      "weakPoints": "Weak Points",
+      "weakPointsDesc": "Needs focus",
+      "weakPointsTitle": "Weak Knowledge Points Top 10",
+      "subjectDist": "Subject Distribution",
+      "noData": "No data",
+      "errorsAndMastery": "{count} errors · {rate}% mastery",
+      "noStudentData": "No student error data",
+      "noStudentDataDesc": "After students complete homework or exams, error data will be summarized here."
+    },
+    "messages": {
+      "added": "Error added",
+      "noteSaved": "Note saved",
+      "reviewRecorded": "Review recorded",
+      "archived": "Error archived",
+      "deleted": "Error deleted",
+      "collected": "Collected {count} errors",
+      "noNewErrors": "No new errors to collect",
+      "addFailed": "Failed to add error",
+      "saveFailed": "Save failed",
+      "deleteFailed": "Delete failed",
+      "archiveFailed": "Archive failed",
+      "collectFailed": "Failed to collect errors",
+      "notFound": "Error not found or access denied",
+      "selectQuestion": "Please select a question",
+      "recordFailed": "Record failed",
+      "addedShort": "Added"
+    },
     "list": {
       "title": "Error Book",
       "description": "View student error records and knowledge point stats",
@@ -1459,12 +3247,6 @@
       "colContent": "Content",
       "noContent": "No content"
     },
-    "stats": {
-      "totalErrorQuestions": "Total Error Questions",
-      "totalErrorCount": "Total Error Count",
-      "recent7dErrors": "Recent 7d Errors",
-      "knowledgePointCount": "Knowledge Points"
-    },
     "error": {
       "title": "Error Book page error",
       "unknown": "An unknown error occurred in the error book module",
@@ -1473,6 +3255,19 @@
   },
   "practice": {
     "title": "Practice",
+    "tabs": {
+      "assignments": "Assignments",
+      "adaptive": "Adaptive Practice"
+    },
+    "adaptive": {
+      "description": "Choose knowledge points and question types to start a targeted adaptive practice. Your practice history is shown below.",
+      "starterSection": "Start Practice",
+      "historySection": "Practice History",
+      "knowledgePointsLoading": "Loading knowledge points...",
+      "knowledgePointsEmpty": "No knowledge points available; cannot start practice",
+      "historyLoading": "Loading practice history...",
+      "historyError": "Failed to load practice history"
+    },
     "list": {
       "title": "Practice Analysis",
       "description": "View and manage all practice assignments",
@@ -1504,6 +3299,92 @@
       "title": "Practice page error",
       "unknown": "Practice module encountered an unknown error",
       "retry": "Retry"
+    },
+    "starter": {
+      "title": "Start Adaptive Practice",
+      "description": "Select knowledge points and question type to begin a targeted practice",
+      "type": "Practice Type",
+      "knowledgePoints": "Knowledge Points",
+      "difficulty": "Difficulty",
+      "anyDifficulty": "Any difficulty",
+      "questionCount": "Question Count",
+      "start": "Start Practice",
+      "creating": "Creating..."
+    },
+    "types": {
+      "error_variant": "Error Variant",
+      "knowledge_point": "Knowledge Point",
+      "weak_chapter": "Weak Chapter",
+      "ai_recommended": "AI Recommended"
+    },
+    "status": {
+      "in_progress": "In Progress",
+      "completed": "Completed",
+      "abandoned": "Abandoned"
+    },
+    "toasts": {
+      "created": "Practice session created",
+      "createFailed": "Failed to create practice session",
+      "selectKnowledgePoint": "Please select at least one knowledge point",
+      "selectWeakKnowledgePoint": "Please select at least one weak knowledge point",
+      "submitted": "Answer submitted",
+      "submitFailed": "Failed to submit answer",
+      "completed": "Practice completed",
+      "completeFailed": "Failed to complete practice",
+      "abandoned": "Practice abandoned",
+      "abandonFailed": "Failed to abandon practice"
+    },
+    "errors": {
+      "SESSION_NOT_FOUND": "Practice session not found",
+      "SESSION_NOT_IN_PROGRESS": "Practice session is not in progress",
+      "ANSWER_NOT_FOUND": "Answer record not found",
+      "QUESTION_NOT_FOUND": "Question not found",
+      "INSUFFICIENT_QUESTIONS": "Insufficient questions available",
+      "INVALID_INPUT": "Invalid input",
+      "UNAUTHORIZED": "You are not authorized to operate this practice session"
+    },
+    "session": {
+      "progress": "Progress",
+      "previous": "Previous",
+      "next": "Next",
+      "abandon": "Abandon",
+      "abandonConfirm": "Confirm abandon?",
+      "abandonDescription": "Submitted answers will be retained, but you cannot continue answering after abandoning.",
+      "cancel": "Cancel",
+      "confirmAbandon": "Confirm Abandon",
+      "complete": "Complete",
+      "empty": "No questions in this practice",
+      "question": "Question",
+      "difficulty": "Difficulty",
+      "variant": "Variant",
+      "skip": "Skip",
+      "retry": "Retry",
+      "submit": "Submit",
+      "submitting": "Submitting...",
+      "submitFailedDescription": "Submission failed. Please retry or check your network connection.",
+      "true": "True",
+      "false": "False",
+      "textPlaceholder": "Enter your answer...",
+      "correct": "Correct",
+      "incorrect": "Incorrect",
+      "pendingReview": "Pending Review",
+      "skipped": "Skipped",
+      "yourAnswer": "Your Answer"
+    },
+    "result": {
+      "title": "Practice Result",
+      "answered": "Answered",
+      "correct": "Correct",
+      "accuracy": "Accuracy",
+      "review": "Question Review"
+    },
+    "history": {
+      "empty": "No practice history"
+    },
+    "reasons": {
+      "student_initiated": "Student Initiated",
+      "teacher_assigned": "Teacher Assigned",
+      "parent_suggested": "Parent Suggested"
     }
   },
   "elective": {
@@ -1528,7 +3409,11 @@
       "colUpdatedAt": "Updated",
       "colActions": "Actions",
       "edit": "Edit",
-      "mswNotice": "List query contract pending; ensure NEXT_PUBLIC_MSW=1 is enabled."
+      "mswNotice": "List query contract pending; ensure NEXT_PUBLIC_MSW=1 is enabled.",
+      "adminList": "elective courses",
+      "empty": "No elective courses",
+      "emptyDescription": "Click the create button to add the first elective course",
+      "emptyStudent": "No courses available for selection"
     },
     "create": {
       "title": "New Elective",
@@ -1572,6 +3457,118 @@
       "title": "Elective module error",
       "unknown": "An unknown error occurred in the Elective module",
       "retry": "Retry"
+    },
+    "errors": {
+      "unexpected": "An unexpected error occurred, please try again later",
+      "notFound": "Course not found"
+    },
+    "actions": {
+      "create": "Create",
+      "edit": "Edit",
+      "delete": "Delete",
+      "openSelection": "Open Selection",
+      "closeSelection": "Close Selection",
+      "runLottery": "Run Lottery",
+      "select": "Select",
+      "drop": "Drop",
+      "cancel": "Cancel"
+    },
+    "fields": {
+      "credit": "Credit",
+      "teacher": "Teacher",
+      "selectionMode": "Selection Mode",
+      "capacity": "Capacity",
+      "classroom": "Classroom",
+      "schedule": "Schedule",
+      "subject": "Subject",
+      "grade": "Grade",
+      "startDate": "Start Date",
+      "endDate": "End Date",
+      "selectionStart": "Selection Start",
+      "selectionEnd": "Selection End",
+      "description": "Description",
+      "enrolled": "Enrolled",
+      "dropReason": "Drop Reason"
+    },
+    "status": {
+      "draft": "Draft",
+      "open": "Open",
+      "closed": "Closed",
+      "cancelled": "Cancelled"
+    },
+    "selectionMode": {
+      "fcfs": "First Come First Served",
+      "lottery": "Lottery"
+    },
+    "selectionStatus": {
+      "selected": "Selected",
+      "enrolled": "Enrolled",
+      "waitlist": "Waitlist",
+      "dropped": "Dropped",
+      "rejected": "Rejected"
+    },
+    "student": {
+      "capacityFull": "Full",
+      "mySelections": "My Selections",
+      "availableCourses": "Available Courses",
+      "selected": "Selected",
+      "selectSuccess": "Course selected successfully",
+      "dropSuccess": "Course dropped successfully",
+      "confirmDrop": "Confirm drop?",
+      "dropReasonPlaceholder": "Enter drop reason (optional)"
+    },
+    "parent": {
+      "noRecordsTitle": "No selection records",
+      "noRecordsDescription": "This student has not selected any courses"
+    },
+    "description": {
+      "detail": "Elective Course Details",
+      "student": "Elective Selection"
+    },
+    "detail": {
+      "back": "Back",
+      "editCourse": "Edit Course",
+      "studentsTitle": "Enrolled Students",
+      "noStudents": "No students",
+      "noStudentsDescription": "No students have selected this course",
+      "studentName": "Student",
+      "priority": "Priority",
+      "selectedAt": "Selected At",
+      "enrolledAt": "Enrolled At"
+    },
+    "export": {
+      "statusHeader": "Status",
+      "selectedAtHeader": "Selected At"
+    },
+    "form": {
+      "createTitle": "Create Elective",
+      "editTitle": "Edit Elective",
+      "nameLabel": "Name",
+      "subjectLabel": "Subject",
+      "selectSubjectPlaceholder": "Select subject",
+      "gradeLabel": "Grade",
+      "selectGradePlaceholder": "Select grade",
+      "teacherLabel": "Teacher",
+      "selectTeacherPlaceholder": "Select teacher",
+      "capacityLabel": "Capacity",
+      "classroomLabel": "Classroom",
+      "scheduleLabel": "Schedule",
+      "schedulePlaceholder": "e.g. Monday periods 3-4",
+      "creditLabel": "Credit",
+      "startDateLabel": "Start Date",
+      "endDateLabel": "End Date",
+      "selectionStartLabel": "Selection Start Time",
+      "selectionEndLabel": "Selection End Time",
+      "dropDeadlineLabel": "Drop Deadline",
+      "dropDeadlineHint": "Students cannot drop after this time; leave empty for no limit",
+      "descriptionLabel": "Description",
+      "descriptionPlaceholder": "Course summary, target audience, etc.",
+      "cancelButton": "Cancel",
+      "createButton": "Create",
+      "saveButton": "Save",
+      "savingButton": "Saving...",
+      "invalidFormState": "Invalid form state",
+      "saveFailed": "Save failed"
     }
   },
   "leave": {
@@ -1634,6 +3631,7 @@
       "emptyTitle": "No schedule changes",
       "emptyDescription": "Adjust filters or submit your first request",
       "emptyAction": "Clear filters",
+      "createAction": "New Request",
       "mswNotice": "Schedule changes list query contract pending, ensure NEXT_PUBLIC_MSW=1 is enabled.",
       "colSummary": "Summary",
       "colClassName": "Class",
@@ -1643,7 +3641,134 @@
       "colReason": "Reason",
       "colStatus": "Status",
       "colApplicant": "Applicant",
-      "colCreatedAt": "Created At"
+      "colCreatedAt": "Created At",
+      "colActions": "Actions"
+    },
+    "form": {
+      "title": "Schedule Change Request",
+      "dialogTitle": "Submit Schedule Change Request",
+      "dialogDescription": "Fill in the form to submit a reschedule, cancel, substitute, or merge request",
+      "classLabel": "Class",
+      "classPlaceholder": "Select a class",
+      "typeLabel": "Change Type",
+      "typeReschedule": "Reschedule",
+      "typeCancel": "Cancel",
+      "typeSubstitute": "Substitute",
+      "typeMerge": "Merge",
+      "originalLessonLabel": "Original Lesson",
+      "originalLessonPlaceholder": "Enter original lesson name",
+      "originalTeacherLabel": "Original Teacher",
+      "originalTeacherPlaceholder": "Select original teacher",
+      "substituteTeacherLabel": "Substitute Teacher",
+      "substituteTeacherPlaceholder": "Select substitute teacher",
+      "originalDateLabel": "Original Date",
+      "newDateLabel": "New Date",
+      "newStartLabel": "New Start Time",
+      "newEndLabel": "New End Time",
+      "reasonLabel": "Reason",
+      "reasonPlaceholder": "Explain the reason for this schedule change...",
+      "cancel": "Cancel",
+      "submit": "Submit Request",
+      "submitting": "Submitting...",
+      "createSuccess": "Schedule change request submitted",
+      "errors": {
+        "classRequired": "Please select a class",
+        "originalLessonRequired": "Please enter original lesson",
+        "reasonRequired": "Reason is required",
+        "submitFailed": "Failed to submit request"
+      }
+    },
+    "review": {
+      "approve": "Approve",
+      "reject": "Reject",
+      "approveTitle": "Approve Schedule Change",
+      "rejectTitle": "Reject Schedule Change",
+      "approveDescription": "Are you sure you want to approve this schedule change request?",
+      "rejectDescription": "Please provide a reason for rejecting this request (optional)",
+      "commentLabel": "Review Comment",
+      "commentPlaceholder": "Enter review comment...",
+      "commentRequired": "Comment is required when rejecting",
+      "cancel": "Cancel",
+      "stubSuccess": "Review processed (stub)",
+      "errors": {
+        "submitFailed": "Failed to submit review"
+      }
+    },
+    "grid": {
+      "title": "Schedule Grid",
+      "emptyClasses": "No classes available. Please create a class first.",
+      "selectClass": "Select a class",
+      "periodColumn": "Period",
+      "periodLabel": "Period {n}",
+      "legend": "Legend"
+    },
+    "conflicts": {
+      "title": "Conflict Detection",
+      "classLabel": "Class",
+      "classPlaceholder": "Select a class",
+      "checkButton": "Check Conflicts",
+      "checking": "Checking...",
+      "resultsTitle": "Results",
+      "conflictCount": "{count} conflict(s)",
+      "noConflicts": "No conflicts detected",
+      "typeTeacherOverlap": "Teacher Overlap",
+      "typeClassroomOverlap": "Classroom Overlap",
+      "typeClassOverlap": "Class Overlap",
+      "typeRuleViolation": "Rule Violation",
+      "errors": {
+        "classRequired": "Please select a class",
+        "checkFailed": "Failed to check conflicts"
+      }
+    },
+    "rules": {
+      "title": "Scheduling Rules",
+      "classLabel": "Class",
+      "classPlaceholder": "Select a class",
+      "maxDailyHours": "Max Daily Hours",
+      "maxContinuousHours": "Max Continuous Hours",
+      "morningStart": "Morning Start",
+      "afternoonEnd": "Afternoon End",
+      "lunchBreakStart": "Lunch Break Start",
+      "lunchBreakEnd": "Lunch Break End",
+      "avoidBackToBack": "Avoid back-to-back sessions",
+      "balancedSubjects": "Balance subjects across the week",
+      "cancel": "Cancel",
+      "save": "Save Rules",
+      "saving": "Saving...",
+      "errors": {
+        "classRequired": "Please select a class",
+        "saveFailed": "Failed to save rules"
+      }
+    },
+    "auto": {
+      "title": "Auto Schedule",
+      "classLabel": "Class",
+      "classPlaceholder": "Select a class",
+      "previewButton": "Preview Schedule",
+      "previewing": "Generating...",
+      "applyButton": "Apply to Class",
+      "applying": "Applying...",
+      "previewSummary": "Generated {scheduled} sessions, {conflicts} conflicts",
+      "applySuccess": "Schedule applied successfully",
+      "errors": {
+        "classRequired": "Please select a class",
+        "previewFailed": "Failed to generate schedule",
+        "applyFailed": "Failed to apply schedule"
+      }
+    },
+    "autoResult": {
+      "title": "Generated Schedule",
+      "sessionCount": "{count} sessions",
+      "conflictCount": "{count} conflicts",
+      "noSessions": "No sessions generated.",
+      "colDay": "Day",
+      "colStart": "Start",
+      "colEnd": "End",
+      "colCourse": "Course",
+      "colLocation": "Location",
+      "conflictsTitle": "Conflicts & Warnings",
+      "readyToApply": "No conflicts detected. The schedule is ready to apply.",
+      "unknownDay": "Day {n}"
     },
     "error": {
       "title": "Schedule changes page error",
@@ -1778,7 +3903,64 @@
         "labelScoreValue": "{score} pts",
         "emptyWeakPoints": "No weak knowledge point data",
         "emptyTrends": "No trend data",
-        "loadFailed": "Failed to load dashboard data, please try again later."
+        "loadFailed": "Failed to load dashboard data, please try again later.",
+        "statEnrolledClasses": "Enrolled Classes",
+        "descActiveEnrollments": "Active enrollments",
+        "statGraded": "Graded",
+        "descCompletedAssignments": "Completed assignments",
+        "statDueSoon": "Due Soon",
+        "descNext7Days": "Next 7 days",
+        "statOverdue": "Overdue",
+        "descNeedsAttention": "Needs attention",
+        "descOverallPerformance": "Overall performance",
+        "descNoGradesYet": "No grades yet",
+        "descCurrentPosition": "Current position",
+        "descNoRankingYet": "No ranking yet",
+        "sectionUpcomingAssignments": "Upcoming Assignments",
+        "sectionRecentGrades": "Recent Grades",
+        "sectionTodaySchedule": "Today's Schedule",
+        "emptyNoAssignments": "No upcoming assignments",
+        "emptyNoAssignmentsDesc": "No assignments to complete",
+        "emptyNoGradedWork": "No graded work",
+        "emptyNoGradedWorkDesc": "No graded assignments yet",
+        "emptyNoClassesToday": "No classes today",
+        "emptyNoClassesTodayDesc": "No classes scheduled for today",
+        "colTitle": "Title",
+        "colSubject": "Subject",
+        "colStatus": "Status",
+        "colDue": "Due",
+        "colScore": "Score",
+        "colAction": "Action",
+        "colAssignment": "Assignment",
+        "colWhen": "When",
+        "colClass": "Class",
+        "colTime": "Time",
+        "colLocation": "Location",
+        "actionViewAll": "View All",
+        "actionViewSchedule": "View Schedule",
+        "actionStart": "Start",
+        "actionContinue": "Continue",
+        "actionReview": "Review",
+        "badgeInProgress": "In Progress",
+        "badgeUpNext": "Up Next",
+        "badgeLate": "Late",
+        "badgeGraded": "Graded",
+        "badgeSubmitted": "Submitted",
+        "badgeNotStarted": "Not Started",
+        "labelLatest": "Latest",
+        "labelPoints": "Points",
+        "labelNoGrades": "No grades",
+        "greetingMorning": "Good morning",
+        "greetingNoon": "Good noon",
+        "greetingAfternoon": "Good afternoon",
+        "greetingEvening": "Good evening",
+        "greetingNight": "Late night",
+        "greetingWithName": "{greeting}, {name}",
+        "sectionGradeTrend": "Grade Trend",
+        "legendScore": "My Score",
+        "legendClassAvg": "Class Average",
+        "emptyGradeTrend": "No grade trend data",
+        "labelUrgent": "Urgent"
       },
       "trend": {
         "title": "Learning Trend",
@@ -1809,6 +3991,38 @@
         "practiceNow": "Practice Now"
       }
     },
+    "diagnostic": {
+      "title": "Student Diagnostic Report",
+      "description": "View personal learning diagnostics, knowledge mastery distribution, and historical reports",
+      "statStudentName": "Student Name",
+      "statOverallMastery": "Overall Mastery",
+      "statStrengthCount": "Strength Subjects",
+      "statWeaknessCount": "Weakness Subjects",
+      "sectionMasteryRadar": "Knowledge Mastery Distribution",
+      "sectionStrengths": "Strength Knowledge Points",
+      "sectionWeakness": "Weak Knowledge Points",
+      "sectionLatestReport": "Latest Diagnostic Report",
+      "sectionHistoryReports": "Historical Reports",
+      "emptyDiagnostic": "No diagnostic data",
+      "emptyStrengths": "No strength knowledge points",
+      "emptyWeaknessPoints": "No weak knowledge points",
+      "emptyReports": "No historical reports",
+      "colKnowledgePoint": "Knowledge Point",
+      "colMastery": "Mastery",
+      "colActions": "Actions",
+      "practiceNow": "Practice Now",
+      "badgePublished": "Published",
+      "badgeArchived": "Archived",
+      "badgeDraft": "Draft",
+      "badgeGenerated": "Generated",
+      "fieldPeriod": "Period",
+      "fieldScore": "Score",
+      "fieldSummary": "Summary",
+      "fieldRecommendations": "Recommendations",
+      "confidenceLabel": "Confidence",
+      "confidenceTooltip": "Confidence reflects the reliability of the diagnostic conclusion, range 0-1, higher is more reliable",
+      "mswNotice": "Diagnostic data contract is @contract-pending, currently served by MSW. Will switch to real data after backend contract is ready."
+    },
     "grades": {
       "list": {
         "title": "My Grades",
@@ -1818,6 +4032,11 @@
         "allSubjects": "All subjects",
         "typeFilter": "Filter by type",
         "allTypes": "All types",
+        "semesterFilter": "Filter by semester",
+        "allSemesters": "All semesters",
+        "semester1": "Semester 1",
+        "semester2": "Semester 2",
+        "resetFilters": "Reset",
         "total": "{count} records",
         "colSubject": "Subject",
         "colType": "Type",
@@ -1829,7 +4048,59 @@
         "colActions": "Actions",
         "viewReportCard": "View report card →",
         "emptyTitle": "No grade records",
-        "mswNotice": "Grades list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "emptyDescription": "Adjust filters or wait for grades to be entered",
+        "mswNotice": "Grades list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "sectionSummary": "Grade Summary",
+        "fieldTotalRecords": "Total records",
+        "fieldAverageScore": "Average rate",
+        "fieldPassRate": "Pass rate",
+        "fieldExcellentRate": "Excellent rate",
+        "sectionTrend": "Grade Trend",
+        "sectionRankingTrend": "Ranking Trend",
+        "sectionDistribution": "Class Distribution",
+        "sectionGrowthArchive": "Growth Archive",
+        "trendEmptyTitle": "No trend data",
+        "trendEmptyDescription": "At least 1 grade record is required to plot the trend",
+        "trendScorePercent": "Score rate (%)",
+        "trendClassAverage": "Class average",
+        "trendRangeAll": "All",
+        "trendRangeDays7": "Last 7 days",
+        "trendRangeDays30": "Last 30 days",
+        "trendRangeDays90": "Last 90 days",
+        "rankingEmptyTitle": "No ranking data",
+        "rankingEmptyDescription": "Ranking data will appear once backend contract is ready",
+        "distributionEmptyTitle": "No distribution data",
+        "distributionEmptyDescription": "Class distribution will appear once backend contract is ready",
+        "distributionYourPosition": "Your position: score {score}, in {bucket} bucket",
+        "growthEmptyTitle": "No growth archive",
+        "growthEmptyDescription": "Cross-semester growth archive will appear once backend contract is ready",
+        "rankingLegend": "Class rank (lower is better)",
+        "rankingTotalStudents": "{total} students in class",
+        "rankingCurrentRank": "Currently rank {rank}",
+        "distributionXAxis": "Score range",
+        "distributionYAxis": "Count",
+        "distributionBucketCount": "{count} students",
+        "distributionStudentPosition": "You're in {bucket} bucket, rank {rank} in class",
+        "growthArchiveXAxis": "Semester",
+        "growthArchiveYAxis": "Score",
+        "growthArchiveSubjectLabel": "Subject",
+        "subjects": {
+          "chinese": "Chinese",
+          "math": "Math",
+          "english": "English",
+          "physics": "Physics",
+          "chemistry": "Chemistry",
+          "biology": "Biology",
+          "history": "History",
+          "geography": "Geography",
+          "politics": "Politics"
+        },
+        "types": {
+          "exam": "Exam",
+          "homework": "Homework",
+          "quiz": "Quiz",
+          "comprehensive": "Comprehensive"
+        }
       },
       "reportCard": {
         "title": "Report Card",
@@ -1845,20 +4116,65 @@
         "colScoreRate": "Rate",
         "colLevel": "Level",
         "colTeacherComment": "Teacher comment",
-        "emptyTitle": "No report card data"
+        "emptyTitle": "No report card data",
+        "emptyDescription": "Switch academic year/semester or wait for grades",
+        "schoolName": "School",
+        "reportCardTitle": "Semester Report Card",
+        "periodLabel": "Year {year} · {semester}",
+        "allSemesters": "All semesters",
+        "studentNameLabel": "Student name",
+        "classNameLabel": "Class",
+        "generatedAtLabel": "Generated at",
+        "gradesSectionTitle": "Subject Grades",
+        "summarySectionTitle": "Summary",
+        "overallAverage": "Overall average",
+        "overallRank": "Overall rank",
+        "passRate": "Pass rate",
+        "excellentRate": "Excellent rate",
+        "commentsTitle": "Teacher comments",
+        "commentsPlaceholder": "(Teacher comments pending)",
+        "signatureClassTeacher": "Class teacher signature",
+        "signatureParent": "Parent signature",
+        "signaturePrincipal": "Principal signature",
+        "footerNote": "This report card was generated on {date}",
+        "academicYearsCount": "{count} academic years available",
+        "periodSelectorTitle": "Academic Year / Semester",
+        "allAcademicYears": "All academic years",
+        "semester1": "Semester 1",
+        "semester2": "Semester 2",
+        "resetFilters": "Reset",
+        "subjectCount": "Subjects",
+        "signaturesTitle": "Signatures",
+        "summaryRowLabel": "Total",
+        "classTeacherLabel": "Class teacher",
+        "studentInfoTitle": "Student information",
+        "colAssessment": "Assessment",
+        "colType": "Type",
+        "colRank": "Rank",
+        "colRemark": "Remark",
+        "typeExam": "Exam",
+        "typeHomework": "Homework",
+        "typeQuiz": "Quiz",
+        "subjectAvgLabel": "Subject avg",
+        "noRecords": "No records",
+        "preparing": "Preparing...",
+        "errorPrint": "Print failed, please retry",
+        "commentsAriaLabel": "Teacher comments area",
+        "rankFormat": "{rank} / {total}",
+        "classTotalStudentsLabel": "Class size"
       }
     },
     "exams": {
       "list": {
         "title": "My Exams",
-        "description": "View upcoming and ended exams",
+        "description": "View all exams by status. Exams in progress can be entered directly.",
         "statusFilter": "Filter by status",
         "allStatus": "All status",
         "statusUpcoming": "Upcoming",
         "statusInProgress": "In progress",
         "statusEnded": "Ended",
         "statusScored": "Scored",
-        "total": "{count} records",
+        "total": "{count} exam(s)",
         "colTitle": "Exam title",
         "colSubject": "Subject",
         "colExamDate": "Exam date",
@@ -1871,7 +4187,28 @@
         "takeExam": "Take exam →",
         "viewResult": "View result →",
         "emptyTitle": "No exams",
-        "mswNotice": "Student exams list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Student exams list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "statusNotStarted": "Not started",
+        "statusExpired": "Ended",
+        "subjectFilter": "Filter by subject",
+        "allSubjects": "All subjects",
+        "groupInProgress": "In progress",
+        "groupInProgressDesc": "Click to start",
+        "groupUpcoming": "Upcoming",
+        "groupUpcomingDesc": "Waiting to start",
+        "groupSubmitted": "Submitted",
+        "groupSubmittedDesc": "Awaiting grading",
+        "groupScored": "Scored",
+        "groupScoredDesc": "View results",
+        "groupEnded": "Ended",
+        "groupEndedDesc": "Exam ended",
+        "countdownStartsIn": "Starts in {n} day(s)",
+        "countdownHoursLeft": "Starts in {n} hour(s)",
+        "countdownStarted": "Already started",
+        "countdownUrgent": "Starting soon",
+        "colQuestionCount": "Questions",
+        "colTotalScore": "Total score",
+        "emptyDesc": "When teachers publish exams, the schedule and entry will appear here."
       },
       "result": {
         "title": "Exam Result",
@@ -1883,7 +4220,7 @@
         "fieldTotalScore": "Total",
         "fieldRank": "Class rank",
         "fieldClassAvg": "Class avg",
-        "fieldDuration": "Duration",
+        "fieldDuration": "Duration (min)",
         "colQuestionNo": "No",
         "colQuestion": "Question",
         "colYourAnswer": "Your answer",
@@ -1894,7 +4231,15 @@
         "colMastery": "Mastery",
         "addToErrorBook": "Add to error book",
         "emptyQuestions": "No question data",
-        "notFound": "Exam result not found"
+        "notFound": "Exam result not found",
+        "sectionStats": "Answer stats",
+        "sectionWrongQuestions": "Wrong questions",
+        "statsTotal": "Total",
+        "statsCorrect": "Correct",
+        "statsWrong": "Wrong",
+        "statsUnanswered": "Unanswered",
+        "noWrongQuestions": "No wrong questions in this exam",
+        "colQuestionType": "Type"
       },
       "take": {
         "title": "Take Exam",
@@ -1908,19 +4253,37 @@
         "unanswered": "Unanswered",
         "marked": "Marked",
         "notFound": "Exam not found or ended",
-        "submitError": "Submission failed, please retry"
+        "submitError": "Submission failed, please retry",
+        "totalScore": "Total score",
+        "back": "Back to list",
+        "submitting": "Submitting…",
+        "confirmSubmit": "Confirm submit",
+        "confirmSubmitDescription": "You cannot change answers after submission. Please verify all answers.",
+        "unansweredWarning": "{count} question(s) unanswered. Are you sure to submit?",
+        "confirmSubmitAction": "Confirm submission",
+        "autoSaveSaving": "Saving…",
+        "autoSaveIdle": "Not saved",
+        "timeUpAutoSubmit": "Time is up. Auto-submitted.",
+        "questionUnit": "Q",
+        "makeSureAnswered": "Please verify all answers before submitting",
+        "questionType": "Type",
+        "score": "Score",
+        "prevQuestion": "Previous",
+        "nextQuestion": "Next",
+        "jumpToQuestion": "Jump to question {no}"
       }
     },
     "homework": {
       "list": {
         "title": "My Homework",
-        "description": "View homework list grouped by subject",
+        "description": "View homework grouped by subject. Pending homework links to the submit page.",
         "statusFilter": "Filter by status",
         "allStatus": "All status",
         "statusPending": "Pending",
         "statusSubmitted": "Submitted",
         "statusGraded": "Graded",
-        "total": "{count} records",
+        "statusOverdue": "Overdue",
+        "total": "{count} assignment(s)",
         "colTitle": "Homework title",
         "colSubject": "Subject",
         "colDueDate": "Due date",
@@ -1930,7 +4293,38 @@
         "submitHomework": "Submit →",
         "viewAnalysis": "View analysis →",
         "emptyTitle": "No homework",
-        "mswNotice": "Student homework list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Student homework list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "subjectFilter": "Filter by subject",
+        "allSubjects": "All subjects",
+        "searchPlaceholder": "Search homework title…",
+        "groupPending": "Pending",
+        "groupPendingDesc": "Click to submit",
+        "groupOverdue": "Overdue",
+        "groupOverdueDesc": "Please submit as soon as possible",
+        "groupSubmitted": "Submitted",
+        "groupSubmittedDesc": "Awaiting grading",
+        "groupGraded": "Graded",
+        "groupGradedDesc": "View score",
+        "bucketActive": "To do",
+        "bucketDone": "Done",
+        "urgent24h": "Due within 24h",
+        "overdueTag": "Overdue",
+        "emptyDesc": "When teachers assign homework, the list and entry will appear here.",
+        "viewCard": "Card view",
+        "viewTable": "Table view",
+        "attempts": "Attempts",
+        "attemptsValue": "{used} / {max}",
+        "latestScore": "Latest score",
+        "actionStart": "Start",
+        "actionContinue": "Continue",
+        "actionView": "View",
+        "actionReview": "Review",
+        "overdueBadge": "Overdue",
+        "groupUnanswered": "Unanswered",
+        "groupAnswered": "Answered",
+        "noResults": "No matching homework found",
+        "statusInProgress": "In progress",
+        "statusNotStarted": "Not started"
       },
       "submit": {
         "title": "Submit Homework",
@@ -1939,7 +4333,39 @@
         "submitSuccess": "Homework submitted",
         "autoSaveTip": "Answers auto-saved",
         "notFound": "Homework not found or closed",
-        "submitError": "Submission failed, please retry"
+        "submitError": "Submission failed, please retry",
+        "questionNav": "Question Nav",
+        "answerPlaceholder": "Enter your answer...",
+        "submitPanelTitle": "Submit",
+        "answerProgress": "Answer Progress",
+        "storageRestoreFailed": "Local storage corrupted, fell back to backend data",
+        "storageSaveFailed": "Local storage write failed, does not affect answering",
+        "reviewTitle": "Homework review",
+        "takeMode": "Take mode",
+        "reviewMode": "Read-only review",
+        "description": "Description",
+        "attemptsUsed": "Attempts",
+        "attemptsValue": "{used} / {max}",
+        "back": "Back to list",
+        "submitting": "Submitting…",
+        "confirmSubmit": "Confirm submit",
+        "confirmSubmitDescription": "You cannot change answers after submission. Please verify all answers.",
+        "unansweredWarning": "{count} question(s) unanswered. Are you sure to submit?",
+        "confirmSubmitAction": "Confirm submission",
+        "autoSaveSaving": "Saving…",
+        "autoSaveIdle": "Not saved",
+        "questionType": "Type",
+        "fieldTitle": "Title",
+        "fieldDueDate": "Due date",
+        "fieldSubmittedAt": "Submitted at",
+        "fieldStatus": "Status",
+        "fieldScore": "Score",
+        "fieldTotalScore": "Total score",
+        "viewAnalysis": "View analysis",
+        "teacherComment": "Teacher comment",
+        "noComment": "No comment",
+        "questionStem": "Question",
+        "maxAttempts": "Max attempts"
       },
       "analysis": {
         "title": "Homework Analysis",
@@ -1954,7 +4380,13 @@
         "colCorrectAnswer": "Correct answer",
         "colScore": "Score",
         "colIsCorrect": "Result",
-        "notFound": "Homework analysis not found"
+        "notFound": "Homework analysis not found",
+        "sectionStats": "Answer stats",
+        "sectionWrongQuestions": "Wrong questions",
+        "statsTotal": "Total",
+        "statsCorrect": "Correct",
+        "statsWrong": "Wrong",
+        "noWrongQuestions": "No wrong questions in this homework"
       }
     },
     "schedule": {
@@ -1968,23 +4400,51 @@
       "colClassroom": "Classroom",
       "colTime": "Time",
       "emptyTitle": "No schedule data",
-      "mswNotice": "Student schedule contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      "mswNotice": "Student schedule contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+      "weekdays": {
+        "monday": "Mon",
+        "tuesday": "Tue",
+        "wednesday": "Wed",
+        "thursday": "Thu",
+        "friday": "Fri",
+        "saturday": "Sat",
+        "sunday": "Sun"
+      },
+      "emptyDescription": "No schedule data available, please try again later or contact admin",
+      "today": "Today",
+      "noClasses": "No classes today",
+      "noStudentTitle": "No student identity",
+      "noStudentDesc": "Please sign in with a student account or contact admin to set up student identity"
     },
     "attendance": {
       "title": "Attendance",
       "description": "View personal attendance summary and details",
       "sectionSummary": "Summary",
+      "fieldStudentName": "Student name",
+      "fieldTotalRecords": "Total records",
+      "fieldPresentCount": "Present count",
       "fieldAttendanceRate": "Attendance rate",
+      "fieldLateRate": "Late rate",
       "fieldLateCount": "Late count",
       "fieldEarlyLeaveCount": "Early leave count",
       "fieldLeaveCount": "Leave count",
       "fieldAbsentCount": "Absent count",
+      "fieldSchoolActivityCount": "School activity count",
       "sectionRecords": "Records",
       "colDate": "Date",
+      "colClass": "Class",
       "colStatus": "Status",
       "colRemark": "Remark",
       "emptyTitle": "No attendance records",
-      "mswNotice": "Student attendance contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      "mswNotice": "Student attendance contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+      "status": {
+        "present": "Present",
+        "late": "Late",
+        "early_leave": "Early leave",
+        "leave": "Leave",
+        "absent": "Absent",
+        "school_activity": "School activity"
+      }
     },
     "classes": {
       "title": "My Classes",
@@ -2016,7 +4476,32 @@
         "colActions": "Actions",
         "viewDetail": "View detail →",
         "emptyTitle": "No courses",
-        "mswNotice": "Student courses list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Student courses list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "viewModeLabel": "View mode",
+        "viewCard": "Card view",
+        "viewTable": "Table view",
+        "joinClass": "Join class",
+        "joinClassTitle": "Join class by invitation code",
+        "joinClassDescription": "Enter the 6-digit invitation code provided by your teacher",
+        "joinClassCodeLabel": "Invitation code",
+        "joinClassCodePlaceholder": "Enter 6-digit invitation code",
+        "joinClassCodeHint": "The invitation code is 6 digits. Ask your teacher if you don't have one.",
+        "joinClassSubmit": "Join",
+        "joinClassSubmitting": "Joining...",
+        "joinClassCancel": "Cancel",
+        "joinClassSuccess": "Joined class successfully",
+        "joinClassFailed": "Failed to join: {message}",
+        "joinClassCodeRequired": "Please enter the invitation code",
+        "joinClassCodeInvalid": "Invitation code must be 6 digits",
+        "statusActive": "Active",
+        "statusInactive": "Concluded",
+        "cardTeacher": "Teacher",
+        "cardSchool": "School",
+        "cardHeadTeacher": "Head teacher",
+        "cardGrade": "Grade",
+        "sendEmail": "Send email",
+        "colRoom": "Room",
+        "colGrade": "Grade"
       },
       "detail": {
         "title": "Course Detail",
@@ -2033,6 +4518,18 @@
         "sectionSchedule": "Class Schedule",
         "viewFullSchedule": "View full schedule",
         "viewHomework": "View homework",
+        "colWeekday": "Weekday",
+        "colPeriod": "Period",
+        "colSubject": "Subject",
+        "colTime": "Time",
+        "colCourse": "Course",
+        "weekdayMon": "Mon",
+        "weekdayTue": "Tue",
+        "weekdayWed": "Wed",
+        "weekdayThu": "Thu",
+        "weekdayFri": "Fri",
+        "weekdaySat": "Sat",
+        "weekdaySun": "Sun",
         "notFound": "Course not found"
       }
     },
@@ -2041,11 +4538,24 @@
         "title": "Course Plans",
         "description": "View course plans",
         "total": "{count} records",
+        "searchPlaceholder": "Search plan/subject/class/teacher...",
+        "filterByStatus": "Filter by status",
+        "statusAll": "All statuses",
+        "statusActive": "In progress",
+        "statusCompleted": "Completed",
+        "statusPlanning": "Planning",
+        "statusPaused": "Paused",
         "colTitle": "Plan name",
         "colSubject": "Subject",
         "colGrade": "Grade",
         "colStatus": "Status",
         "colActions": "Actions",
+        "colClass": "Class",
+        "colTeacher": "Teacher",
+        "colSemester": "Semester",
+        "colCreated": "Created at",
+        "fieldProgress": "Progress",
+        "progressHours": "{completed} / {total} hours ({percent}%)",
         "viewDetail": "View detail →",
         "emptyTitle": "No course plans",
         "mswNotice": "Student course plans list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
@@ -2053,13 +4563,49 @@
       "detail": {
         "title": "Course Plan Detail",
         "backToList": "Back to list",
+        "notFound": "Course plan not found",
+        "mswNotice": "Detail query contract pending (@contract-pending).",
+        "headerTitle": "Course Plan Detail",
+        "badgeClass": "Class",
+        "badgeSubject": "Subject",
+        "badgeStatus": "Status",
+        "badgeSemester": "Semester",
+        "badgeNoClass": "No class",
+        "badgeUnknownSubject": "Unknown subject",
+        "fieldTeacher": "Teacher",
+        "fieldUnassigned": "Unassigned",
+        "fieldCreatedAt": "Created on {date}",
+        "fieldStartDate": "Starts on {date}",
+        "fieldEndDate": "Ends on {date}",
+        "fieldSemester": "Semester {semester}",
         "sectionBasic": "Basic Info",
         "fieldTitle": "Title",
         "fieldSubject": "Subject",
         "fieldGrade": "Grade",
         "fieldDescription": "Description",
         "sectionTextbooks": "Related Textbooks",
-        "notFound": "Course plan not found"
+        "sectionProgress": "Progress",
+        "progressLabel": "Completion progress",
+        "progressHours": "{completed} / {total} hours ({percent}%)",
+        "progressItems": "{completed} / {total} week plans completed",
+        "sectionSyllabus": "Syllabus",
+        "sectionObjectives": "Objectives",
+        "emptyText": "None",
+        "sectionWeekPlans": "Weekly Plans",
+        "emptyWeekPlans": "No weekly plans",
+        "colWeek": "Week",
+        "colTopic": "Topic",
+        "colHours": "Hours",
+        "colChapter": "Chapter",
+        "colStatus": "Status",
+        "statusPlanned": "Planned",
+        "statusInProgress": "In progress",
+        "statusCompleted": "Completed",
+        "statusSkipped": "Skipped",
+        "statusUnknown": "Unknown",
+        "exportCsv": "Export CSV",
+        "toastExported": "Exported",
+        "toastExportFailed": "Export failed"
       }
     },
     "lessonPlans": {
@@ -2073,15 +4619,23 @@
         "colUpdatedAt": "Updated at",
         "colActions": "Actions",
         "viewDetail": "View lesson plan →",
+        "subjectFilter": "Filter by subject",
+        "allSubjects": "All subjects",
         "emptyTitle": "No lesson plans",
         "mswNotice": "Student lesson plans list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       },
       "view": {
         "title": "Lesson Plan View",
         "backToList": "Back to list",
+        "sectionBasic": "Basic Information",
         "sectionContent": "Lesson Content",
+        "fieldSubject": "Subject",
+        "fieldGrade": "Grade",
+        "fieldTextbook": "Textbook",
+        "fieldChapter": "Chapter",
         "notFound": "Lesson plan not found or not published",
-        "outOfScope": "Lesson plan is out of your grade scope"
+        "outOfScope": "Lesson plan is out of your grade scope",
+        "notPublished": "This lesson plan has not been published and cannot be viewed"
       }
     },
     "textbooks": {
@@ -2100,14 +4654,43 @@
         "colActions": "Actions",
         "viewChapters": "View chapters →",
         "emptyTitle": "No textbooks",
-        "mswNotice": "Student textbooks list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "emptyFilteredTitle": "No matching textbooks",
+        "emptyFilteredDescription": "Try adjusting filters or clear them to retry.",
+        "clearFilters": "Clear filters",
+        "gradeNotSetTitle": "Student grade not set",
+        "gradeNotSetDescription": "No active class is linked, so textbooks cannot be filtered by grade. Please contact your teacher or administrator to complete class information.",
+        "mswNotice": "Student textbooks list contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "subjects": {
+          "chinese": "Chinese",
+          "math": "Math",
+          "english": "English",
+          "physics": "Physics",
+          "chemistry": "Chemistry",
+          "biology": "Biology"
+        },
+        "grades": {
+          "grade1": "Grade 1",
+          "grade2": "Grade 2",
+          "grade3": "Grade 3",
+          "grade7": "Grade 7",
+          "grade8": "Grade 8",
+          "grade9": "Grade 9"
+        }
       },
       "chapters": {
         "title": "Textbook Reader",
         "backToList": "Back to textbooks",
         "sectionChapters": "Chapter List",
         "sectionContent": "Reading Area",
-        "notFound": "Textbook not found or grade mismatch"
+        "notFound": "Textbook not found or grade mismatch",
+        "mswNotice": "Chapter content contract pending. Currently served via MSW.",
+        "subjectBadge": "Subject",
+        "gradeBadge": "Grade",
+        "gradeMismatchWarning": "Textbook grade ({grade}) does not match your grade. For reference reading only.",
+        "prevChapter": "Previous",
+        "nextChapter": "Next",
+        "emptyChapters": "No chapter content available",
+        "chapterLabel": "Chapter {n}"
       }
     },
     "errorBook": {
@@ -2130,6 +4713,7 @@
       "sourceFilter": "Filter by source",
       "allSources": "All sources",
       "dueOnlyFilter": "Show only to-review",
+      "resetFilters": "Reset",
       "total": "{count} records",
       "colQuestion": "Question",
       "colSubject": "Subject",
@@ -2140,8 +4724,18 @@
       "colActions": "Actions",
       "markMastered": "Mark as mastered",
       "emptyTitle": "No errors",
+      "emptyDescription": "Adjust filters or add your first error",
       "markSuccess": "Marked as mastered",
-      "markError": "Mark failed"
+      "markError": "Mark failed",
+      "fieldTotalDesc": "All error records",
+      "fieldNewDesc": "Not yet reviewed",
+      "fieldLearningDesc": "Reviewing, not yet mastered",
+      "fieldMasteredDesc": "Mastery rate {rate}%",
+      "fieldToReviewDesc": "Due for review",
+      "sourceExam": "Exam",
+      "sourceHomework": "Homework",
+      "sourcePractice": "Practice",
+      "sourceManual": "Manual"
     },
     "learning": {
       "title": "Learning Center",
@@ -2157,7 +4751,12 @@
       "cardErrorBook": "Error Book",
       "cardErrorBookDesc": "Errors to review",
       "enter": "Enter →",
-      "emptyTitle": "No learning resources"
+      "emptyTitle": "No learning resources",
+      "statCourses": "Enrolled in {count} classes",
+      "statHomework": "Pending {pending} · Due soon {dueSoon}",
+      "statTextbooks": "{count} textbooks available",
+      "noStudentTitle": "No student identity found",
+      "noStudentDesc": "Please confirm you have joined a class or contact admin"
     },
     "learningPath": {
       "title": "Learning Path",
@@ -2192,7 +4791,28 @@
         "colActions": "Actions",
         "viewDetail": "View detail →",
         "emptyTitle": "No practice records",
-        "mswNotice": "Student practice contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "starterDescription": "Select knowledge points and question count to start",
+        "starterQuestionCount": "Question count",
+        "starterCreating": "Creating...",
+        "starterSelectKnowledgePoint": "Please select at least one knowledge point",
+        "starterCreated": "Practice session created",
+        "starterCreateFailed": "Create failed: {message}",
+        "mswNotice": "Student practice contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "knowledgePointLoading": "Loading knowledge points...",
+        "knowledgePointLoadFailed": "Failed to load knowledge points: {message}",
+        "knowledgePointEmpty": "No knowledge points available",
+        "subjectFilterAll": "All subjects",
+        "subjectFilterLabel": "Subject filter",
+        "selectedCount": "{count} knowledge point(s) selected",
+        "difficultyEasy": "Easy",
+        "difficultyMedium": "Medium",
+        "difficultyHard": "Hard",
+        "subjectMath": "Math",
+        "subjectChinese": "Chinese",
+        "subjectEnglish": "English",
+        "subjectPhysics": "Physics",
+        "subjectChemistry": "Chemistry",
+        "knowledgePointDescription": "Description"
       },
       "session": {
         "title": "Practice Session",
@@ -2225,6 +4845,37 @@
         "enroll": "Enroll",
         "drop": "Drop",
         "viewDetail": "View detail →",
+        "filterByStatus": "Filter by status",
+        "filterBySelectionMode": "Filter by selection mode",
+        "statusAll": "All statuses",
+        "statusOpen": "Open",
+        "statusClosed": "Closed",
+        "statusInProgress": "In progress",
+        "statusCompleted": "Completed",
+        "modeAll": "All modes",
+        "modeFcfs": "First come first served",
+        "modeLottery": "Lottery",
+        "badgeStatusOpen": "Open",
+        "badgeStatusClosed": "Closed",
+        "badgeStatusInProgress": "In progress",
+        "badgeStatusCompleted": "Completed",
+        "badgeModeFcfs": "FCFS",
+        "badgeModeLottery": "Lottery",
+        "fieldSubject": "Subject",
+        "fieldSchedule": "Schedule",
+        "fieldCredits": "Credits",
+        "fieldCapacity": "Capacity",
+        "fieldEnrolledCount": "Enrolled",
+        "fieldCategory": "Category",
+        "capacityFull": "Full",
+        "enrolledCount": "{enrolled}/{capacity}",
+        "dropDialogTitle": "Confirm drop",
+        "dropDialogDescription": "Are you sure you want to drop {courseName}? This cannot be undone.",
+        "dropDialogReasonLabel": "Reason (optional)",
+        "dropDialogReasonPlaceholder": "Please enter the reason...",
+        "dropDialogCancel": "Cancel",
+        "dropDialogConfirm": "Confirm drop",
+        "dropDialogLoading": "Processing...",
         "emptyMySelections": "No selected courses",
         "emptyAvailable": "No available courses",
         "enrollSuccess": "Enrolled successfully",
@@ -2237,14 +4888,30 @@
         "title": "Elective Detail",
         "backToList": "Back to elective list",
         "sectionBasic": "Course Info",
+        "sectionDescription": "Description",
+        "sectionSchedule": "Schedule",
         "fieldName": "Name",
         "fieldTeacher": "Teacher",
         "fieldCapacity": "Capacity",
         "fieldEnrolled": "Enrolled",
-        "fieldSchedule": "Schedule",
         "fieldCredits": "Credits",
         "fieldCategory": "Category",
-        "notFound": "Course not found"
+        "fieldSubject": "Subject",
+        "fieldGrade": "Grade",
+        "fieldClassroom": "Classroom",
+        "fieldSelectionMode": "Selection Mode",
+        "fieldStartDate": "Start Date",
+        "fieldEndDate": "End Date",
+        "fieldSelectionStartAt": "Selection Start",
+        "fieldSelectionEndAt": "Selection End",
+        "statusDraft": "Draft",
+        "statusOpen": "Open",
+        "statusClosed": "Closed",
+        "statusCancelled": "Cancelled",
+        "selectionModeFcfs": "First come first served",
+        "selectionModeLottery": "Lottery",
+        "notFound": "Course not found",
+        "mswNotice": "Elective detail contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       }
     },
     "leave": {
@@ -2274,7 +4941,20 @@
       "statusRejected": "Rejected",
       "emptyTitle": "No leave records",
       "noActiveClass": "No active class, cannot submit leave request",
-      "mswNotice": "Student leave contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      "backToDashboard": "Back to student home",
+      "mswNotice": "Student leave contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+      "validation": {
+        "selectClass": "Please select a class",
+        "selectStartDate": "Please select a start date",
+        "selectEndDate": "Please select an end date",
+        "selectType": "Please select a leave type",
+        "fillReason": "Please fill in the leave reason",
+        "endDateBeforeStart": "End date cannot be earlier than start date"
+      },
+      "paginationRange": "Showing {start}-{end} of {total}",
+      "paginationPage": "Page {page}/{totalPages}",
+      "paginationPrev": "Previous",
+      "paginationNext": "Next"
     },
     "aiTutor": {
       "title": "AI Tutor",
@@ -2334,6 +5014,110 @@
       "retry": "Retry"
     }
   },
+  "shared": {
+    "profile": {
+      "title": "Profile",
+      "description": "View your profile and role-specific overview",
+      "editProfile": "Edit Profile",
+      "sectionPersonal": "Personal Information",
+      "sectionAccount": "Account Information",
+      "sectionRoleOverview": "Role Overview",
+      "fieldName": "Name",
+      "fieldGender": "Gender",
+      "fieldAge": "Age",
+      "fieldPhone": "Phone",
+      "fieldAddress": "Address",
+      "fieldEmail": "Email",
+      "fieldRole": "Role",
+      "fieldCreatedAt": "Registered At",
+      "fieldOnboardedAt": "Onboarded At",
+      "fieldClassName": "Class",
+      "fieldGrade": "Grade",
+      "fieldHeadTeacher": "Head Teacher",
+      "fieldAvgScore": "Average Score",
+      "fieldClassRank": "Class Rank",
+      "fieldClassCount": "Class Count",
+      "fieldStudentCount": "Student Count",
+      "fieldCourses": "Courses",
+      "rankValue": "No. {rank} / {total}",
+      "genderMale": "Male",
+      "genderFemale": "Female",
+      "genderOther": "Other",
+      "roleAdmin": "Admin",
+      "roleTeacher": "Teacher",
+      "roleStudent": "Student",
+      "roleParent": "Parent",
+      "noRoleOverview": "No role-specific overview available for current role",
+      "mswNotice": "User profile contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+    },
+    "messages": {
+      "detail": {
+        "title": "Message Detail",
+        "backToList": "Back to messages",
+        "reply": "Reply",
+        "delete": "Delete",
+        "deleteConfirm": "Delete this message?",
+        "deleteSuccess": "Deleted",
+        "deleteError": "Delete failed",
+        "cancel": "Cancel",
+        "fieldFrom": "From",
+        "fieldTo": "To",
+        "fieldSubject": "Subject",
+        "fieldDate": "Date",
+        "fieldStatus": "Status",
+        "fieldBody": "Body",
+        "fieldStarred": "Starred",
+        "statusRead": "Read",
+        "statusUnread": "Unread",
+        "starredYes": "Yes",
+        "starredNo": "No",
+        "notFound": "Message not found",
+        "mswNotice": "Message detail contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      },
+      "compose": {
+        "title": "Compose Message",
+        "description": "Fill in recipient, subject and body",
+        "backToList": "Back to messages",
+        "fieldTo": "To",
+        "fieldSubject": "Subject",
+        "fieldBody": "Body",
+        "toPlaceholder": "Select recipient",
+        "subjectPlaceholder": "Enter subject",
+        "bodyPlaceholder": "Enter body",
+        "send": "Send",
+        "sending": "Sending...",
+        "cancel": "Cancel",
+        "selectRecipient": "Please select a recipient",
+        "subjectRequired": "Subject is required",
+        "bodyRequired": "Body is required",
+        "sendSuccess": "Sent successfully",
+        "sendError": "Send failed, please retry",
+        "noRecipients": "No recipients available",
+        "mswNotice": "Recipients and send-message contracts pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      },
+      "groupCompose": {
+        "title": "Group Message",
+        "description": "Send one message to multiple recipients",
+        "backToList": "Back to messages",
+        "fieldTo": "Recipients (multiple)",
+        "fieldSubject": "Subject",
+        "fieldBody": "Body",
+        "subjectPlaceholder": "Enter subject",
+        "bodyPlaceholder": "Enter body",
+        "send": "Send",
+        "sending": "Sending...",
+        "cancel": "Cancel",
+        "selectAtLeastOne": "Select at least one recipient",
+        "subjectRequired": "Subject is required",
+        "bodyRequired": "Body is required",
+        "sendSuccess": "Sent to {count} recipients",
+        "sendError": "Group send failed, please retry",
+        "noRecipients": "No recipients available",
+        "selectedCount": "{count} selected",
+        "mswNotice": "Recipients and send-message contracts pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+      }
+    }
+  },
   "admin": {
     "users": {
       "list": {
@@ -2346,10 +5130,16 @@
         "colName": "Name",
         "colEmail": "Email",
         "colRole": "Role",
+        "colPhone": "Phone",
         "colStatus": "Status",
         "colCreatedAt": "Created at",
+        "colUpdatedAt": "Updated at",
+        "colUserType": "User type",
         "colActions": "Actions",
         "editRole": "Edit role",
+        "editUser": "Edit user",
+        "userTypeInternal": "Internal",
+        "userTypeExternal": "External",
         "activate": "Activate",
         "deactivate": "Deactivate",
         "emptyTitle": "No users",
@@ -2383,7 +5173,7 @@
         "required": "Required",
         "optional": "Optional",
         "uploadButton": "Select file to upload",
-        "uploadHint": "Supports .csv files, up to 500 records per upload",
+        "uploadHint": "Supports .csv / .xlsx / .xls files, up to 500 records per upload",
         "noticeTitle": "Notes",
         "notice1": "Email format must be valid",
         "notice2": "Role can only be teacher / student / parent / admin",
@@ -2395,7 +5185,26 @@
         "resultTotal": "Total rows",
         "resultSuccess": "Success",
         "resultFailed": "Failed",
-        "resultErrors": "Error details"
+        "resultErrors": "Error details",
+        "filesPreview": "File preview (first {count} rows)",
+        "importStatus": "Importing...",
+        "reselect": "Reselect",
+        "confirmImport": "Confirm import"
+      },
+      "assignDialog": {
+        "title": "Assign roles",
+        "description": "Assign roles to {name}. Changes take effect immediately after saving.",
+        "listAriaLabel": "Assignable roles for {name}",
+        "noEnabledRoles": "No assignable roles available",
+        "system": "System",
+        "locked": "Locked",
+        "disabledAssignedLabel": "The following roles are disabled but still assigned to this user:",
+        "disabledLabel": "Disabled",
+        "save": "Save",
+        "saving": "Saving...",
+        "success": "Roles assigned",
+        "adminWarningTitle": "Administrator role",
+        "adminWarning": "Administrators have the highest system privileges. Assigning this role grants the user full management capabilities. Proceed with caution."
       },
       "error": {
         "title": "User module error",
@@ -2409,16 +5218,38 @@
         "description": "Manage roles and permission assignments",
         "newRole": "New role",
         "createButton": "New role",
+        "totalBadge": "{count} roles",
+        "searchPlaceholder": "Search role name/description...",
+        "tableCaption": "Role list with name, description, type, status, user count, permission count, updated time and actions",
         "colName": "Role name",
         "colDescription": "Description",
         "colIsLocked": "System locked",
+        "colType": "Type",
+        "colStatus": "Status",
+        "colUserCount": "Users",
         "colPermissions": "Permission count",
+        "colValue": "Role value",
+        "colUpdatedAt": "Updated at",
         "colActions": "Actions",
         "viewDetail": "View detail",
         "editRole": "Edit",
         "editPermissions": "Edit permissions",
         "deleteRole": "Delete",
+        "enableRole": "Enable",
+        "disableRole": "Disable",
+        "enabled": "Enabled",
+        "disabled": "Disabled",
+        "userCountValue": "{count}",
+        "typeSystem": "System",
+        "typeCustom": "Custom",
+        "deleteConfirmTitle": "Delete role",
+        "deleteConfirmDescription": "Are you sure you want to delete role \"{name}\"? This role is currently associated with {count} users; deletion will revoke their permissions. This action cannot be undone.",
+        "confirmDelete": "Delete",
+        "deleted": "Role deleted",
+        "enabledSuccess": "Role enabled",
+        "disabledSuccess": "Role disabled",
         "lockedRole": "System role (cannot be deleted)",
+        "lockedRoleToggleWarn": "System locked role cannot be toggled",
         "emptyTitle": "No roles",
         "emptyDescription": "Create your first role to start managing permissions",
         "emptyAction": "New role",
@@ -2428,16 +5259,19 @@
       "detail": {
         "title": "Role Detail",
         "edit": "Edit",
+        "editRole": "Edit role",
         "notFound": "Role not found",
         "backToList": "Back to roles",
         "sectionBasic": "Basic information",
         "sectionPermissions": "Permission matrix",
         "lockedNotice": "This is a built-in system role. Some fields cannot be modified.",
+        "adminLockedWarn": "admin is the highest-privilege system role. Adjusting its permissions may affect overall system availability. Proceed with caution.",
         "fieldName": "Role name",
         "fieldDescription": "Description",
         "fieldIsLocked": "System locked",
         "fieldPermissions": "Permission list",
-        "noPermissions": "No permissions assigned to this role yet"
+        "noPermissions": "No permissions assigned to this role yet",
+        "sectionPermissionMatrix": "Permission action matrix"
       },
       "form": {
         "titleCreate": "New role",
@@ -2446,7 +5280,50 @@
         "fieldDescription": "Role description",
         "fieldPermissions": "Permission assignments",
         "submit": "Save",
-        "cancel": "Cancel"
+        "cancel": "Cancel",
+        "namePatternTitle": "Only lowercase letters, digits and underscores are allowed"
+      },
+      "createDialog": {
+        "titleCreate": "New role",
+        "titleEdit": "Edit role",
+        "descriptionCreate": "Create a new role. You can assign detailed action permissions via the matrix after creation.",
+        "descriptionEdit": "Update role name and description. Adjust permission points in the permission action matrix.",
+        "fieldName": "Role name",
+        "fieldNamePlaceholder": "e.g. Homeroom Teacher, Grade Lead",
+        "fieldDescription": "Role description",
+        "fieldDescriptionPlaceholder": "Briefly describe the responsibilities of this role (optional)",
+        "fieldValue": "Role value",
+        "fieldValuePlaceholder": "e.g. role:teacher",
+        "lockedNameNotice": "Built-in system role name cannot be modified",
+        "cancel": "Cancel",
+        "submitting": "Submitting...",
+        "submitCreate": "Create role",
+        "submitEdit": "Save changes",
+        "successCreated": "Role created successfully",
+        "successUpdated": "Role updated",
+        "errorNameRequired": "Please enter a role name",
+        "namePatternTitle": "Only lowercase letters, digits and underscores are allowed",
+        "errorNamePattern": "Role name can only contain lowercase letters, digits and underscores"
+      },
+      "matrix": {
+        "title": "{roleName} · Permission action matrix",
+        "locked": "Locked",
+        "permissionCount": "{count} permission points",
+        "loading": "Loading permission matrix...",
+        "empty": "No configurable permission points for this role",
+        "colPermission": "Permission point",
+        "actionRead": "View",
+        "actionCreate": "Create",
+        "actionUpdate": "Edit",
+        "actionDelete": "Delete",
+        "moduleLabel": "Module: {module}",
+        "save": "Save matrix",
+        "saving": "Saving...",
+        "successSaved": "Permission matrix saved",
+        "searchPlaceholder": "Search permission/module...",
+        "collapse": "Collapse",
+        "expand": "Expand",
+        "userImpactNotice": "This role is currently associated with {count} users. Permission changes will affect them immediately."
       },
       "error": {
         "title": "Role module error",
@@ -2463,8 +5340,11 @@
         "colPermission": "Permission point",
         "colResource": "Resource",
         "colAction": "Action",
+        "colValue": "Permission value",
+        "colKey": "Key",
         "colRoleCount": "Associated roles",
         "groupResource": "Group by resource",
+        "countLabel": "{count} items",
         "emptyTitle": "No permission points",
         "emptyDescription": "Permission catalog will be displayed after syncing with IAM service",
         "mswNotice": "Permission catalog query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
@@ -2495,6 +5375,9 @@
         "allStatuses": "All statuses",
         "export": "Export CSV",
         "exportCsv": "Export CSV",
+        "exportSuccess": "Successfully exported {count} records",
+        "exportEmpty": "No data to export",
+        "exportFailed": "Export failed: {message}",
         "colTimestamp": "Time",
         "colUser": "User",
         "colUserId": "User ID",
@@ -2506,7 +5389,10 @@
         "colResourceId": "Resource ID",
         "colIp": "IP",
         "colDetails": "Details",
+        "colActions": "Actions",
         "total": "{count} records",
+        "resetFilter": "Reset",
+        "pageOf": "Page {page} / {totalPages}",
         "emptyTitle": "No audit logs",
         "emptyDescription": "Adjust filters or change the date range and retry",
         "mswNotice": "Audit log query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
@@ -2525,6 +5411,19 @@
         "statsToday": "Today's logs",
         "statsErrors": "Error logs",
         "statsUsers": "Active users",
+        "auditEventsToday": "Today's audit events",
+        "failedLoginsToday": "Today's failed logins",
+        "dataChangesToday": "Today's data changes",
+        "totalAuditLogs": "Total audit logs",
+        "sectionError": "Section failed to load",
+        "sectionRetry": "Retry",
+        "chartEmpty": "No data",
+        "quickLinkAuditLogs": "Audit Logs",
+        "quickLinkAuditLogsDesc": "View all user action audit records",
+        "quickLinkLoginLogs": "Login Logs",
+        "quickLinkLoginLogsDesc": "View signin/signout/signup records",
+        "quickLinkDataChanges": "Data Changes",
+        "quickLinkDataChangesDesc": "View table change records and stats",
         "trendTitle": "Last 7 days trend",
         "trendLast7Days": "Last 7 days",
         "distributionTitle": "Data change action distribution",
@@ -2542,6 +5441,9 @@
         "filterAction": "Filter by action",
         "filterStatus": "Filter by status",
         "filterUser": "Filter by user",
+        "filterDateRange": "Date range",
+        "startDate": "Start date",
+        "endDate": "End date",
         "actionFilter": "Filter by action",
         "statusFilter": "Filter by status",
         "allActions": "All actions",
@@ -2553,15 +5455,22 @@
         "statusFailure": "Failed",
         "export": "Export CSV",
         "exportCsv": "Export CSV",
+        "exportSuccess": "Successfully exported {count} records",
+        "exportEmpty": "No data to export",
+        "exportFailed": "Export failed: {message}",
         "colTimestamp": "Time",
         "colUser": "User",
         "colUserId": "User ID",
         "colUserName": "Username",
         "colAction": "Action",
         "colStatus": "Status",
+        "colErrorMessage": "Failure reason",
         "colIp": "IP",
         "colUserAgent": "User Agent",
+        "colActions": "Actions",
         "total": "{count} records",
+        "resetFilter": "Reset",
+        "pageOf": "Page {page} / {totalPages}",
         "emptyTitle": "No login logs",
         "emptyDescription": "Adjust filters and retry",
         "mswNotice": "Login log query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
@@ -2573,6 +5482,9 @@
         "filterTable": "Filter by table",
         "filterAction": "Filter by action",
         "filterUser": "Filter by user",
+        "filterDateRange": "Date range",
+        "startDate": "Start date",
+        "endDate": "End date",
         "tableFilter": "Filter by table",
         "actionFilter": "Filter by action",
         "allTables": "All tables",
@@ -2582,11 +5494,19 @@
         "actionDelete": "Delete",
         "export": "Export CSV",
         "exportCsv": "Export CSV",
+        "exportSuccess": "Successfully exported {count} records",
+        "exportEmpty": "No data to export",
+        "exportFailed": "Export failed: {message}",
         "sectionStats": "Change statistics",
         "statsTitle": "Change statistics",
         "statsAction": "Action",
         "statsCount": "Count",
         "statsLastChange": "Last change",
+        "topTables": "Top 8 tables",
+        "expandDetail": "View change diff",
+        "collapseDetail": "Collapse change diff",
+        "oldValue": "Before",
+        "newValue": "After",
         "colTimestamp": "Time",
         "colTable": "Table",
         "colRecordId": "Record ID",
@@ -2595,11 +5515,51 @@
         "colUserId": "User ID",
         "colUserName": "Username",
         "colChanges": "Changes",
+        "colActions": "Actions",
         "total": "{count} records",
+        "resetFilter": "Reset",
+        "pageOf": "Page {page} / {totalPages}",
         "emptyTitle": "No data change logs",
         "emptyDescription": "Adjust filters and retry",
         "mswNotice": "Data change log query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       },
+      "detail": {
+        "title": "Audit Log Detail",
+        "description": "View audit log details",
+        "viewDetail": "View detail",
+        "userId": "User ID",
+        "userName": "Username",
+        "action": "Action",
+        "module": "Module",
+        "resourceId": "Resource ID",
+        "tableName": "Table",
+        "recordId": "Record ID",
+        "changes": "Changes",
+        "oldValue": "Before",
+        "newValue": "After",
+        "errorMessage": "Failure reason",
+        "ipAddress": "IP Address",
+        "userAgent": "User Agent",
+        "status": "Status",
+        "details": "Details",
+        "createdAt": "Created At"
+      },
+      "retention": {
+        "title": "Audit Log Retention Settings",
+        "description": "Configure retention days and auto cleanup",
+        "retentionDays": "Audit log retention days",
+        "retentionDaysDescription": "Range 7-3650 days, default 90",
+        "loginLogRetentionDays": "Login log retention days",
+        "loginLogRetentionDaysDescription": "Range 7-3650 days, default 365",
+        "autoCleanupEnabled": "Enable auto cleanup",
+        "autoCleanupEnabledDescription": "Auto clean expired logs by retention",
+        "save": "Save",
+        "purge": "Purge now",
+        "saveSuccess": "Retention config saved",
+        "purgeConfirm": "Purge expired logs? Cannot undo.",
+        "purgeSuccess": "Purged: {auditLogsDeleted} audit, {loginLogsDeleted} login, {dataChangeLogsDeleted} data change logs",
+        "loadFailed": "Failed to load retention config"
+      },
       "error": {
         "title": "Audit log module error",
         "unknown": "Unknown error in audit log module",
@@ -2626,6 +5586,10 @@
         "copyCode": "Copy",
         "allStatuses": "All statuses",
         "total": "{count} records",
+        "statsTotal": "Total codes",
+        "statsUsed": "Used",
+        "statsUnused": "Unused",
+        "statsExpired": "Expired",
         "statusActive": "Active",
         "statusUnused": "Unused",
         "statusUsed": "Used up",
@@ -2634,7 +5598,12 @@
         "emptyTitle": "No invitation codes",
         "emptyDescription": "Generate your first invitation code to invite users",
         "emptyAction": "Generate invitation code",
-        "mswNotice": "Invitation code list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Invitation code list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "deleteSelected": "Delete selected ({count})",
+        "deleteSuccess": "Deleted {count} invitation codes",
+        "deleteConfirmTitle": "Confirm batch delete",
+        "deleteConfirmDesc": "About to delete {count} invitation codes. This action cannot be undone.",
+        "confirmDelete": "Confirm delete"
       },
       "generateForm": {
         "title": "Generate invitation code",
@@ -2644,6 +5613,35 @@
         "submit": "Generate",
         "cancel": "Cancel"
       },
+      "generateDialog": {
+        "title": "Generate invitation codes in batch",
+        "description": "Generate multiple invitation codes at once to invite teachers, students, or parents to join the system.",
+        "fieldCount": "Count",
+        "countHint": "Up to 100 codes per batch",
+        "fieldRole": "Role",
+        "roles": {
+          "teacher": "Teacher",
+          "student": "Student",
+          "parent": "Parent",
+          "admin": "Admin"
+        },
+        "fieldExpireDays": "Validity (days)",
+        "expireDaysOption": "{days} days",
+        "fieldNote": "Note",
+        "noteHint": "Optional, used only to record the purpose of this batch, up to 500 characters",
+        "cancel": "Cancel",
+        "submit": "Generate",
+        "generating": "Generating…",
+        "success": "Successfully generated {count} invitation codes",
+        "errorCountRange": "Count must be between 1 and 100",
+        "fieldEmail": "Recipient email",
+        "fieldEmailPlaceholder": "e.g. teacher@example.com (optional)",
+        "fieldClassId": "Linked class",
+        "fieldClassIdPlaceholder": "e.g. cls-001 (optional)",
+        "resultTitle": "Generated results",
+        "copyCode": "Copy",
+        "done": "Done"
+      },
       "error": {
         "title": "Invitation code module error",
         "unknown": "Unknown error in invitation code module",
@@ -2772,7 +5770,8 @@
           "fieldCurrentYear": "Current academic year",
           "fieldCurrentTerm": "Current term",
           "submit": "Save",
-          "cancel": "Cancel"
+          "cancel": "Cancel",
+          "fieldCode": "School code"
         },
         "deleteConfirm": {
           "title": "Delete school",
@@ -2784,7 +5783,9 @@
           "title": "School module error",
           "unknown": "Unknown error in school module",
           "retry": "Retry"
-        }
+        },
+        "colCode": "School code",
+        "colUpdatedAt": "Updated at"
       },
       "classes": {
         "title": "Class Management",
@@ -2814,6 +5815,111 @@
           "title": "Class module error",
           "unknown": "Unknown error in class module",
           "retry": "Retry"
+        },
+        "manageSchedule": "Manage schedule",
+        "manageInvitation": "Invitation",
+        "schedule": {
+          "form": {
+            "titleCreate": "New schedule entry",
+            "titleEdit": "Edit schedule entry",
+            "classLabel": "Class",
+            "fieldWeekday": "Weekday",
+            "fieldPeriod": "Period",
+            "fieldSubject": "Subject",
+            "fieldTeacher": "Teacher",
+            "fieldClassroom": "Classroom",
+            "fieldStartTime": "Start time",
+            "fieldEndTime": "End time",
+            "subjectPlaceholder": "e.g. Math",
+            "teacherPlaceholder": "e.g. Mr. Smith",
+            "classroomPlaceholder": "e.g. Room 301",
+            "periodN": "Period {n}",
+            "save": "Save",
+            "create": "Create",
+            "createSuccess": "Schedule entry created",
+            "editSuccess": "Schedule entry updated",
+            "deleteTitle": "Delete schedule entry",
+            "deleteMessage": "Delete {weekday} period {period} {subject}?",
+            "deleteConfirm": "Delete",
+            "deleteSuccess": "Schedule entry deleted"
+          },
+          "manager": {
+            "title": "Schedule management",
+            "add": "Add entry",
+            "colPeriod": "Period",
+            "colSubject": "Subject",
+            "colTeacher": "Teacher",
+            "colClassroom": "Classroom",
+            "colTime": "Time",
+            "colActions": "Actions",
+            "empty": "No schedule entries"
+          },
+          "weekday": {
+            "1": "Mon",
+            "2": "Tue",
+            "3": "Wed",
+            "4": "Thu",
+            "5": "Fri",
+            "6": "Sat",
+            "7": "Sun"
+          }
+        },
+        "invitation": {
+          "title": "Invitation code management",
+          "classLabel": "Class",
+          "generate": "Generate invitation code",
+          "generateWithCustom": "Custom invitation code",
+          "generateSuccess": "Invitation code generated",
+          "defaultDuration": "Leave empty for no expiration",
+          "defaultMaxUses": "Leave empty for unlimited uses",
+          "expiresInHours": "Validity (hours)",
+          "maxUsesLabel": "Max uses",
+          "customNote": "Note",
+          "customNotePlaceholder": "e.g. Summer course invitation",
+          "copy": "Copy",
+          "copied": "Copied to clipboard",
+          "revoke": "Revoke",
+          "revokeSuccess": "Invitation code revoked",
+          "revokeConfirm": "Revoke this invitation code? This cannot be undone.",
+          "neverExpires": "Never expires",
+          "empty": "No invitation codes",
+          "colCode": "Code",
+          "colStatus": "Status",
+          "colUsedCount": "Used count",
+          "colExpiresAt": "Expires at",
+          "colNote": "Note",
+          "colActions": "Actions",
+          "status": {
+            "active": "Active",
+            "used": "Used up",
+            "expired": "Expired",
+            "revoked": "Revoked"
+          }
+        },
+        "colHomeroomLabel": "Homeroom label",
+        "colRoom": "Classroom",
+        "colSubjectTeachers": "Subject teachers",
+        "colUpdatedAt": "Updated at",
+        "form": {
+          "titleCreate": "New class",
+          "titleEdit": "Edit class",
+          "fieldName": "Class name",
+          "fieldSchool": "School",
+          "fieldGrade": "Grade",
+          "fieldHeadTeacher": "Head teacher",
+          "fieldHomeroomLabel": "Homeroom label",
+          "fieldHomeroomLabelPlaceholder": "e.g. Class 1, Class 2",
+          "fieldRoom": "Classroom",
+          "fieldRoomPlaceholder": "e.g. Room 301",
+          "fieldHomeroom": "Homeroom teacher",
+          "submit": "Save",
+          "cancel": "Cancel"
+        },
+        "deleteConfirm": {
+          "title": "Delete class",
+          "message": "Are you sure you want to delete class \"{name}\"? This action cannot be undone.",
+          "confirm": "Confirm delete",
+          "cancel": "Cancel"
         }
       },
       "departments": {
@@ -2842,7 +5948,8 @@
           "fieldSchool": "School",
           "fieldHead": "Head ID (optional)",
           "submit": "Save",
-          "cancel": "Cancel"
+          "cancel": "Cancel",
+          "fieldDescription": "Description"
         },
         "deleteConfirm": {
           "title": "Delete department",
@@ -2854,7 +5961,9 @@
           "title": "Department module error",
           "unknown": "Unknown error in department module",
           "retry": "Retry"
-        }
+        },
+        "colDescription": "Description",
+        "colUpdatedAt": "Updated at"
       },
       "academicYear": {
         "title": "Academic Year Management",
@@ -2887,7 +5996,8 @@
           "fieldEndDate": "End date",
           "fieldIsActive": "Set as currently active",
           "submit": "Save",
-          "cancel": "Cancel"
+          "cancel": "Cancel",
+          "fieldIsActiveHint": "Once activated, this academic year will be the current academic year"
         },
         "deleteConfirm": {
           "title": "Delete academic year",
@@ -2899,7 +6009,10 @@
           "title": "Academic year module error",
           "unknown": "Unknown error in academic year module",
           "retry": "Retry"
-        }
+        },
+        "activeYearCardTitle": "Currently active academic year",
+        "activeYearCardDescription": "Shows the currently activated academic year information",
+        "activeYearCardEmpty": "No active academic year"
       },
       "grades": {
         "title": "Grade Management",
@@ -2945,7 +6058,11 @@
           "title": "Grade module error",
           "unknown": "Unknown error in grade module",
           "retry": "Retry"
-        }
+        },
+        "insights": "Grade insights",
+        "gradeOverviewSection": "Grade overview cards",
+        "colTeachingHead": "Teaching head",
+        "notSet": "Not set"
       }
     },
     "announcements": {
@@ -2975,7 +6092,8 @@
         "emptyTitle": "No announcements",
         "emptyDescription": "Adjust filters or create your first announcement",
         "emptyAction": "New announcement",
-        "mswNotice": "Announcement list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Announcement list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "pageIndicator": "Page {page} of {total}"
       },
       "detail": {
         "title": "Announcement Detail",
@@ -3002,7 +6120,9 @@
         "delete": "Delete",
         "deleteConfirm": "Are you sure you want to delete this announcement? This action cannot be undone.",
         "fieldGrades": "Grade",
-        "fieldClasses": "Class"
+        "fieldClasses": "Class",
+        "fieldReadCount": "Read count",
+        "deleteConfirmDesc": "This action cannot be undone. The announcement will be permanently deleted."
       },
       "form": {
         "titleCreate": "New announcement",
@@ -3028,8 +6148,18 @@
         "fieldStatus": "Status",
         "fieldAudience": "Audience",
         "fieldPinned": "Pin",
+        "fieldGrades": "Associated grades",
+        "fieldGradesHint": "Separate multiple grade IDs with commas (e.g., grade-1,grade-2)",
         "errorTitleRequired": "Please enter a title",
-        "errorContentRequired": "Please enter the content"
+        "errorContentRequired": "Please enter the content",
+        "multiSelect": {
+          "placeholder": "Select grades",
+          "selected": "{count} selected",
+          "toggle": "Toggle dropdown",
+          "loading": "Loading...",
+          "empty": "No grades available",
+          "remove": "Remove {name}"
+        }
       },
       "error": {
         "title": "Announcement module error",
@@ -3047,6 +6177,13 @@
         "statByType": "By type",
         "uploadButton": "Upload file",
         "searchPlaceholder": "Search file name...",
+        "fileTypeFilter": "Filter by file type",
+        "allTypes": "All types",
+        "typeImage": "Image",
+        "typeDocument": "Document",
+        "typeVideo": "Video",
+        "typeAudio": "Audio",
+        "typeOther": "Other",
         "colName": "File name",
         "colSize": "Size",
         "colMimeType": "Type",
@@ -3060,7 +6197,57 @@
         "emptyTitle": "No files",
         "emptyDescription": "Adjust filters or upload new files",
         "emptyAction": "Upload file",
-        "mswNotice": "File list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "File list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "selectAll": "Select all",
+        "selectRow": "Select row",
+        "statTopType": "Top 2 types",
+        "statTopTypeHint": "By file count"
+      },
+      "upload": {
+        "button": "Upload file",
+        "uploading": "Uploading...",
+        "success": "Upload succeeded",
+        "ariaLabel": "Select a file to upload",
+        "dragDrop": "Drag files here or click to select",
+        "dropHere": "Drop to upload",
+        "progress": "Upload progress {percent}%",
+        "dragActive": "Drag active",
+        "multiUpload": "{count} files selected",
+        "remaining": "{count} remaining"
+      },
+      "batch": {
+        "selectAll": "Select all",
+        "selectedCount": "{count} selected",
+        "clearSelection": "Clear selection",
+        "batchDelete": "Batch delete",
+        "confirming": "Processing...",
+        "deleteSuccess": "Deleted {count} files",
+        "confirmTitle": "Confirm batch delete",
+        "confirmDescription": "About to delete {count} files. This action cannot be undone.",
+        "confirmCancel": "Cancel",
+        "confirmSubmit": "Confirm delete"
+      },
+      "preview": {
+        "trigger": "Preview",
+        "title": "File preview",
+        "download": "Download",
+        "zoomIn": "Zoom in",
+        "zoomOut": "Zoom out",
+        "text": {
+          "title": "Text preview",
+          "hint": "Click the button below to load text content",
+          "load": "Load content",
+          "loading": "Loading...",
+          "error": "Failed to load: {message}"
+        },
+        "office": {
+          "title": "Online preview is not supported for Office files",
+          "hint": "Please download to view"
+        },
+        "other": {
+          "title": "Online preview is not supported for this file type",
+          "hint": "Please download to view"
+        }
       },
       "error": {
         "title": "File module error",
@@ -3087,8 +6274,15 @@
         "edit": "Edit",
         "delete": "Delete",
         "testConnection": "Test connection",
+        "testing": "Testing...",
+        "testSuccess": "Connected, latency {latency} ms",
+        "testFailed": "Connection failed: {message}",
         "active": "Enable",
         "inactive": "Disable",
+        "colVisibility": "Visibility",
+        "colIsDefault": "Default",
+        "defaultProvider": "Default",
+        "nonDefaultProvider": "Not default",
         "emptyTitle": "No AI providers",
         "emptyDescription": "Add your first AI provider to enable AI capabilities",
         "emptyAction": "New provider",
@@ -3110,17 +6304,52 @@
         "colDate": "Date",
         "mswNotice": "AI settings query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       },
+      "deleteDialog": {
+        "title": "Delete AI Provider",
+        "warning": "This action is irreversible. All configuration for provider \"{name}\" will be permanently lost.",
+        "confirmPrompt": "Type the provider name \"{name}\" to confirm deletion:",
+        "confirmInputPlaceholder": "Enter provider name",
+        "confirmInputHint": "The entered name must exactly match the name shown above.",
+        "cancel": "Cancel",
+        "confirm": "Delete",
+        "deleting": "Deleting...",
+        "success": "Deleted provider \"{name}\""
+      },
       "form": {
         "titleCreate": "New AI Provider",
         "titleEdit": "Edit AI Provider",
+        "description": "Configure AI Provider connection parameters. Fields marked with * are required.",
         "fieldName": "Name",
+        "fieldNamePlaceholder": "e.g. Default OpenAI",
         "fieldType": "Type",
         "fieldScope": "Scope",
+        "fieldScopePlaceholder": "e.g. global / school_<id>",
         "fieldModel": "Model",
+        "fieldModelPlaceholder": "e.g. gpt-4o-mini",
         "fieldApiBase": "API Base",
-        "fieldIsActive": "Enable",
+        "fieldApiBasePlaceholder": "e.g. https://api.openai.com/v1 (optional)",
+        "fieldApiKey": "API Key",
+        "fieldApiKeyPlaceholder": "Enter API key",
+        "fieldApiKeyPlaceholderEdit": "Leave empty to keep existing key",
+        "fieldApiKeyHint": "In edit mode, leaving this empty keeps the existing key.",
+        "fieldIsActive": "Enable this provider",
         "submit": "Save",
-        "cancel": "Cancel"
+        "saving": "Saving...",
+        "cancel": "Cancel",
+        "errorNameRequired": "Name is required",
+        "errorModelRequired": "Model is required",
+        "errorApiBaseInvalid": "API Base must be a valid http(s) URL",
+        "createSuccess": "AI provider created",
+        "updateSuccess": "AI provider updated",
+        "fieldVisibility": "Visibility",
+        "fieldIsDefault": "Set as default provider",
+        "visibilityPrivate": "Private",
+        "visibilityShared": "Shared",
+        "visibilityPublic": "Public",
+        "testConnection": "Test connection",
+        "testing": "Testing...",
+        "testSuccess": "Connected, latency {latency} ms",
+        "testFailed": "Connection failed: {message}"
       },
       "error": {
         "title": "AI settings module error",
@@ -3355,7 +6584,65 @@
         "sectionContent": "Plan content",
         "fieldStatus": "Status",
         "fieldCreatedAt": "Created at",
-        "fieldUpdatedAt": "Updated at"
+        "fieldUpdatedAt": "Updated at",
+        "sectionBasic": "Basic info",
+        "sectionSchedule": "Teaching schedule",
+        "sectionGoals": "Objectives",
+        "sectionResources": "Resources",
+        "fieldTitle": "Title",
+        "fieldDescription": "Description",
+        "fieldGrade": "Grade",
+        "fieldClass": "Class",
+        "fieldSubject": "Subject",
+        "fieldTeacher": "Teacher",
+        "fieldAcademicYear": "Academic year",
+        "edit": "Edit",
+        "notFound": "Course plan not found",
+        "emptySchedule": "No schedule data",
+        "emptyGoals": "No objectives",
+        "emptyResources": "No resources",
+        "weekPlansHint": "{count} weekly plans",
+        "addWeekPlan": "Add weekly plan",
+        "emptyWeekPlans": "No weekly plans",
+        "emptyWeekPlansCta": ", click the button above to create the first weekly plan",
+        "colWeek": "Week",
+        "colTopic": "Topic",
+        "colHours": "Hours",
+        "colChapter": "Chapter",
+        "colActions": "Actions",
+        "statusCompleted": "Completed",
+        "statusPending": "Pending",
+        "notesLabel": "Notes: {notes}",
+        "moveUpAria": "Move week {week} up",
+        "moveDownAria": "Move week {week} down",
+        "editItem": "Edit",
+        "reorderSuccess": "Order updated"
+      },
+      "itemEditor": {
+        "createTitle": "New weekly plan",
+        "editTitle": "Edit weekly plan",
+        "week": "Week",
+        "hours": "Hours",
+        "topic": "Topic",
+        "topicPlaceholder": "Enter weekly topic",
+        "content": "Content",
+        "contentPlaceholder": "Enter weekly teaching content",
+        "chapter": "Textbook chapter",
+        "chapterPlaceholder": "e.g. Chapter 3",
+        "completedAt": "Completed date",
+        "notes": "Notes",
+        "notesPlaceholder": "Optional notes",
+        "cancel": "Cancel",
+        "save": "Save",
+        "saving": "Saving...",
+        "delete": "Delete",
+        "markComplete": "Mark complete",
+        "markIncomplete": "Mark incomplete",
+        "errorTopicRequired": "Topic is required",
+        "createSuccess": "Weekly plan created",
+        "updateSuccess": "Weekly plan updated",
+        "deleteSuccess": "Weekly plan deleted",
+        "toggleSuccess": "Completion status updated"
       },
       "create": {
         "title": "New course plan",
@@ -3366,12 +6653,101 @@
         "fieldAcademicYear": "Academic year",
         "fieldContent": "Content",
         "submit": "Create",
-        "cancel": "Cancel"
+        "cancel": "Cancel",
+        "description": "Fill in basic course plan information",
+        "success": "Course plan created",
+        "error": "Failed to create course plan",
+        "fieldTitle": "Title",
+        "fieldDescription": "Description",
+        "fieldGradeId": "Grade",
+        "fieldClassId": "Class",
+        "fieldSubjectId": "Subject",
+        "fieldTeacherId": "Teacher",
+        "fieldAcademicYearId": "Academic year",
+        "fieldStatus": "Status",
+        "errorTitleRequired": "Title is required",
+        "errorGradeRequired": "Grade is required",
+        "errorClassRequired": "Class is required",
+        "errorSubjectRequired": "Subject is required",
+        "contractPending": "Course plan create contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "fromTemplate": "From template",
+        "fromTemplateHint": "Pick a template to prefill form fields",
+        "openTemplatePicker": "Choose template",
+        "templateApplied": "Template applied",
+        "fieldSemester": "Semester",
+        "fieldSyllabus": "Syllabus",
+        "fieldObjectives": "Objectives",
+        "fieldTotalHours": "Total hours",
+        "fieldWeeklyHours": "Weekly hours",
+        "fieldStartDate": "Start date",
+        "fieldEndDate": "End date"
       },
       "error": {
         "title": "Course plan module error",
         "unknown": "Unknown error in course plan module",
         "retry": "Retry"
+      },
+      "edit": {
+        "title": "Edit course plan",
+        "description": "Modify course plan content and status",
+        "submit": "Save",
+        "cancel": "Cancel",
+        "success": "Course plan updated",
+        "error": "Failed to update course plan",
+        "fieldTitle": "Title",
+        "fieldDescription": "Description",
+        "fieldGradeId": "Grade",
+        "fieldClassId": "Class",
+        "fieldSubjectId": "Subject",
+        "fieldTeacherId": "Teacher",
+        "fieldAcademicYearId": "Academic year",
+        "fieldStatus": "Status",
+        "errorTitleRequired": "Title is required",
+        "errorGradeRequired": "Grade is required",
+        "errorClassRequired": "Class is required",
+        "errorSubjectRequired": "Subject is required",
+        "notFound": "Course plan not found",
+        "backToDetail": "Back to detail",
+        "sectionSchedule": "Teaching schedule",
+        "scheduleNotice": "Schedule reordering is local only; not synced on save",
+        "scheduleEmpty": "No schedule data",
+        "colWeek": "Week",
+        "colTopic": "Topic",
+        "colHours": "Hours",
+        "colActions": "Actions"
+      },
+      "sortableWeekRow": {
+        "notes": "Notes: {notes}",
+        "moveUpAria": "Move week {week} up",
+        "moveDownAria": "Move week {week} down"
+      },
+      "templates": {
+        "title": "Create from template",
+        "description": "Pick a template to prefill form fields",
+        "searchPlaceholder": "Search templates...",
+        "loading": "Loading templates...",
+        "empty": "No templates available",
+        "cancel": "Cancel",
+        "confirm": "Apply template",
+        "errorNoSelection": "Please select a template first",
+        "errorApply": "Failed to apply template"
+      },
+      "export": {
+        "button": "Export CSV",
+        "filename": "course-plans",
+        "colName": "Name",
+        "colClass": "Class",
+        "colSubject": "Subject",
+        "colTeacher": "Teacher",
+        "colAcademicYear": "Academic year",
+        "colStatus": "Status",
+        "colCreatedAt": "Created at",
+        "statusDraft": "Draft",
+        "statusPublished": "Published",
+        "statusArchived": "Archived",
+        "success": "Export succeeded",
+        "error": "Export failed: {message}",
+        "errorEmpty": "No data to export"
       }
     },
     "curriculumMap": {
@@ -3385,11 +6761,30 @@
         "statPublished": "Published",
         "statSubmitted": "Submitted",
         "statStandardsLinked": "Linked standards",
+        "statsTeachers": "Total teachers",
+        "statsLessonPlans": "Total lesson plans",
+        "statsPublished": "Published",
+        "statsSubmitted": "Submitted",
+        "statsLinkedStandards": "Linked standards",
         "colStandard": "Standard",
         "colGrade": "Grade",
         "colCoverageRate": "Coverage rate",
         "colLessonPlanCount": "Lesson plans",
+        "heatmapTitle": "Standard coverage heatmap",
+        "heatmapStandards": "Standard",
+        "heatmapGrades": "Grade",
+        "heatmapCoverage": "Coverage rate",
+        "heatmapLinkedTotalHint": "Cell shows coverage rate and linked/total lesson plans",
+        "heatmapCellTooltip": "{standard} / {grade}: {rate} ({linked}/{total})",
+        "legendTitle": "Legend",
+        "legendHigh": "High (≥80%)",
+        "legendMedium": "Medium (50-80%)",
+        "legendLow": "Low (20-50%)",
+        "legendCritical": "Very low (<20%)",
+        "legendNone": "No coverage",
         "emptyHeatmap": "No coverage data",
+        "emptyTitle": "No coverage data",
+        "emptyDescription": "No standard coverage data yet. Try again later or check contract status.",
         "mswNotice": "Curriculum map query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       },
       "error": {
@@ -3480,7 +6875,79 @@
         "emptyTitle": "No questions",
         "emptyDescription": "Adjust filters or create the first question.",
         "emptyAction": "New Question",
-        "mswNotice": "Question bank list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "mswNotice": "Question bank list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "selectAll": "Select all on this page",
+        "selectRow": "Select this row"
+      },
+      "detailDialog": {
+        "title": "Question detail",
+        "close": "Close",
+        "retry": "Retry",
+        "type": "Type",
+        "difficulty": "Difficulty",
+        "status": "Status",
+        "subject": "Subject",
+        "textbook": "Textbook",
+        "knowledgePoint": "Knowledge point",
+        "content": "Question content",
+        "noContent": "No content available",
+        "answer": "Correct answer",
+        "explanation": "Explanation",
+        "source": "Source",
+        "createdBy": "Created by",
+        "createdAt": "Created at",
+        "updatedAt": "Updated at",
+        "noData": "No detail data"
+      },
+      "createDialog": {
+        "title": "New Question",
+        "description": "Fill in the question content, answer, and explanation. It will appear in the question bank after submission.",
+        "fieldType": "Type",
+        "fieldContent": "Content",
+        "fieldAnswer": "Answer",
+        "fieldExplanation": "Explanation",
+        "fieldDifficulty": "Difficulty",
+        "fieldKnowledgePoint": "Knowledge point ID",
+        "fieldKnowledgePointPlaceholder": "e.g. kp-001",
+        "fieldSource": "Source",
+        "fieldSourcePlaceholder": "e.g. PEP compulsory 1 (optional)",
+        "types": {
+          "single_choice": "Single choice",
+          "multiple_choice": "Multiple choice",
+          "fill_blank": "Fill in the blank",
+          "short_answer": "Short answer",
+          "essay": "Essay",
+          "true_false": "True / False"
+        },
+        "difficultyEasy": "Easy",
+        "difficultyMedium": "Medium",
+        "difficultyHard": "Hard",
+        "cancel": "Cancel",
+        "submit": "Submit",
+        "submitting": "Submitting...",
+        "success": "Question created successfully",
+        "errorContentRequired": "Question content is required",
+        "errorAnswerRequired": "Answer is required",
+        "errorKnowledgePointRequired": "Knowledge point ID is required"
+      },
+      "importExport": {
+        "import": "Import",
+        "export": "Export",
+        "importSuccess": "Imported {imported} records, skipped {skipped}",
+        "exportEmpty": "No questions to export under current filters",
+        "exportSuccess": "Exported {count} questions",
+        "exportFailed": "Export failed, please retry"
+      },
+      "batch": {
+        "selectedCount": "{count} selected",
+        "clearSelection": "Clear selection",
+        "batchDelete": "Batch delete",
+        "confirmTitle": "Confirm batch delete",
+        "confirmDescription": "You are about to delete {count} questions. This action cannot be undone. Continue?",
+        "confirmCancel": "Cancel",
+        "confirmSubmit": "Confirm delete",
+        "confirming": "Deleting...",
+        "deleteSuccess": "Deleted {deleted} records, {failed} failed"
       },
       "error": {
         "title": "Question bank module error",
@@ -3500,7 +6967,8 @@
         "statusPublished": "Published",
         "statusArchived": "Archived",
         "statusSubmitted": "Submitted",
-        "statsTotal": "Total lesson plans",
+        "statsTitle": "Lesson Plan Statistics Overview",
+        "statsTotal": "Total",
         "statsPublished": "Published",
         "statsDraft": "Draft",
         "statsArchived": "Archived",
@@ -3543,6 +7011,15 @@
         "emptyMaterials": "No teaching materials",
         "contractPending": "Resource fields contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
       },
+      "delete": {
+        "button": "Delete",
+        "title": "Delete lesson plan",
+        "description": "Are you sure you want to delete this lesson plan? It will be marked as archived and no longer shown.",
+        "confirm": "Confirm delete",
+        "cancel": "Cancel",
+        "success": "Lesson plan deleted",
+        "error": "Failed to delete lesson plan, please retry later"
+      },
       "error": {
         "title": "Lesson plan module error",
         "unknown": "Unknown error in lesson plan module",
@@ -3553,23 +7030,56 @@
       "list": {
         "title": "Error Book Analysis",
         "description": "School-wide error book aggregate analysis (limited to 500 students)",
-        "sectionStats": "Statistics overview",
-        "statTotalStudents": "Total students",
-        "statTotalErrorQuestions": "Total error questions",
-        "statTotalErrorCount": "Error count",
-        "statAvgErrorRate": "Average error rate",
-        "sectionBySubject": "By subject distribution",
-        "sectionTopStudents": "Top 50 students",
-        "sectionTopWrongQuestions": "Top 10 high-frequency error questions",
-        "colSubject": "Subject",
-        "colErrorCount": "Error count",
-        "colQuestionCount": "Questions",
-        "colErrorRate": "Error rate",
-        "colStudent": "Student",
-        "colClass": "Class",
-        "colQuestion": "Question",
+        "statsTotalStudents": "Total students",
+        "statsTotalErrors": "Total errors",
+        "statsAvgPerStudent": "Avg per student",
+        "statsHighFreqErrors": "High-freq errors",
+        "statsTotalErrorQuestions": "Total error questions",
+        "subjectTabsAll": "All",
+        "subjectTabs": "Subject",
+        "distributionTitle": "Subject distribution",
+        "distributionSubject": "Subject",
+        "distributionCount": "Error count",
+        "chapterWeaknessTitle": "Chapter weaknesses",
+        "chapterWeaknessChapter": "Chapter",
+        "chapterWeaknessErrorRate": "Error rate",
+        "knowledgeWeaknessTitle": "Knowledge point weaknesses",
+        "knowledgeWeaknessPoint": "Knowledge point",
+        "knowledgeWeaknessErrorRate": "Error rate",
+        "topStudentsTitle": "Top 50 students",
+        "topStudentsRank": "Rank",
+        "topStudentsName": "Student",
+        "topStudentsErrorCount": "Error count",
+        "topWrongQuestionsTitle": "Top 10 high-frequency error questions",
+        "topWrongQuestionsContent": "Question content",
+        "topWrongQuestionsErrorCount": "Error count",
         "emptyTitle": "No error data",
-        "mswNotice": "Error book analysis query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "emptyDescription": "No error book stats loaded yet. Please retry later or adjust filters.",
+        "mswNotice": "Error book analysis query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "topWrongQuestionsActions": "Actions",
+        "viewDetail": "View detail",
+        "classDistributionTitle": "Class distribution",
+        "classDistributionClass": "Class",
+        "classDistributionCount": "Error count",
+        "exportCsv": "Export CSV",
+        "exporting": "Exporting...",
+        "exportSuccess": "Exported {count} error records",
+        "total": "{count} records"
+      },
+      "detailDialog": {
+        "title": "Error Detail",
+        "close": "Close",
+        "retry": "Retry",
+        "studentName": "Student",
+        "className": "Class",
+        "errorCount": "Error Count",
+        "question": "Question",
+        "noContent": "No content available",
+        "correctAnswer": "Correct Answer",
+        "analysis": "Analysis",
+        "lastErrorTime": "Last Error Time",
+        "knowledgePoint": "Knowledge Point",
+        "noData": "No detail data"
       },
       "error": {
         "title": "Error book analysis module error",
@@ -3631,35 +7141,278 @@
       "list": {
         "title": "Attendance Management",
         "description": "School-wide attendance aggregate analysis",
-        "sectionStats": "Statistics overview",
-        "statTotalRecords": "Total records",
-        "statPresentRate": "Attendance rate",
-        "statAbsentRate": "Absentee rate",
-        "statLateRate": "Late rate",
-        "statEarlyLeaveRate": "Early leave rate",
-        "sectionByClass": "Class comparison",
-        "sectionCorrelation": "Attendance-score correlation analysis",
-        "filterClass": "Filter by class",
-        "filterStatus": "Filter by status",
-        "filterDate": "Filter by date",
-        "colClass": "Class",
-        "colPresentRate": "Attendance rate",
-        "colAbsentRate": "Absentee rate",
-        "colAvgScore": "Average score",
-        "colCorrelation": "Correlation coefficient",
+        "gradeFilter": "Filter by grade",
+        "classFilter": "Filter by class",
+        "statusFilter": "Filter by status",
+        "dateFilter": "Filter by date",
+        "allGrades": "All grades",
+        "allClasses": "All classes",
+        "allStatuses": "All statuses",
+        "statusPresent": "Present",
+        "statusAbsent": "Absent",
+        "statusLate": "Late",
+        "statusLeave": "Leave",
+        "statsTotalRecords": "Total records",
+        "statsPresentRate": "Attendance rate",
+        "statsAbsentRate": "Absentee rate",
+        "statsLateRate": "Late rate",
+        "statsEarlyLeaveRate": "Early leave rate",
+        "statsAbnormalRate": "Abnormal rate",
+        "statsAvgCorrelation": "Avg correlation",
+        "recordsTitle": "Attendance records",
+        "recordsDescription": "Attendance details by filters",
+        "recordsTotal": "{count} records",
+        "recordsEmptyTitle": "No attendance records",
+        "recordsEmptyDescription": "No attendance records loaded. Please retry later or adjust filters.",
         "colStudent": "Student",
+        "colClass": "Class",
         "colDate": "Date",
         "colStatus": "Status",
-        "colRecordedBy": "Recorded by",
-        "total": "{count} records",
+        "colNote": "Note",
+        "colRecorder": "Recorder",
+        "classComparisonTitle": "Class comparison",
+        "classComparisonClass": "Class",
+        "classComparisonRate": "Attendance rate",
+        "correlationTitle": "Attendance-grade correlation analysis",
+        "correlationAttendance": "Attendance rate",
+        "correlationGrade": "Average score",
         "emptyTitle": "No attendance data",
-        "mswNotice": "Attendance statistics query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled."
+        "emptyDescription": "No attendance stats loaded yet. Please retry later or adjust filters.",
+        "mswNotice": "Attendance statistics query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "total": "{count} records"
+      },
+      "classComparison": {
+        "title": "Class Attendance Comparison",
+        "description": "Cross-class attendance rate comparison and ranking",
+        "updatedAt": "Updated at {time}",
+        "errorNotification": "Failed to load class comparison data",
+        "errorTitle": "Load failed",
+        "errorDescription": "Failed to load class comparison data. Please retry later.",
+        "emptyTitle": "No class comparison data",
+        "emptyDescription": "No class comparison data available. Please retry later.",
+        "seriesRate": "Attendance rate",
+        "colRank": "Rank",
+        "colClass": "Class",
+        "colTotal": "Total students",
+        "colPresent": "Present students",
+        "colRate": "Attendance rate",
+        "colBadge": "Tier",
+        "badgeHigh": "Excellent",
+        "badgeMid": "Average",
+        "badgeLow": "Low"
+      },
+      "gradeCorrelation": {
+        "title": "Attendance-Grade Correlation Analysis",
+        "description": "Correlation analysis between class attendance rate and average score",
+        "errorNotification": "Failed to load attendance-grade correlation data",
+        "errorTitle": "Load failed",
+        "errorDescription": "Failed to load attendance-grade correlation data. Please retry later.",
+        "emptyTitle": "No correlation data",
+        "emptyDescription": "No attendance-grade correlation data available. Please retry later.",
+        "summaryAvgCorrelation": "Avg. correlation",
+        "summaryAvgCorrelationDesc": "Linear correlation between attendance and grades",
+        "summaryStrong": "Strong correlation classes",
+        "summaryMedium": "Medium correlation classes",
+        "summaryWeak": "Weak correlation classes",
+        "scatterTitle": "Attendance-Score scatter plot",
+        "xAxisLabel": "Attendance rate",
+        "yAxisLabel": "Average score",
+        "scatterSeries": "Classes",
+        "legendStrong": "Strong (≥0.7)",
+        "legendMedium": "Medium (0.4-0.7)",
+        "legendWeak": "Weak (<0.4)",
+        "detailsTitle": "Class details",
+        "colClass": "Class",
+        "colAttendanceRate": "Attendance rate",
+        "colAvgScore": "Average score",
+        "colCorrelation": "Correlation",
+        "colTier": "Correlation tier",
+        "badgeStrong": "Strong",
+        "badgeMedium": "Medium",
+        "badgeWeak": "Weak"
       },
       "error": {
         "title": "Attendance management module error",
         "unknown": "Unknown error in attendance management module",
         "retry": "Retry"
       }
+    },
+    "elective": {
+      "list": {
+        "title": "Elective Management",
+        "description": "School-wide elective aggregate view",
+        "createButton": "New Elective",
+        "searchPlaceholder": "Search course name...",
+        "statusFilter": "Filter by status",
+        "allStatuses": "All statuses",
+        "statusDraft": "Draft",
+        "statusOpen": "Open",
+        "statusClosed": "Closed",
+        "statusFull": "Full",
+        "total": "{count} records",
+        "colName": "Name",
+        "colSubject": "Subject",
+        "colGrade": "Grade",
+        "colTeacher": "Teacher",
+        "colCapacity": "Capacity",
+        "colEnrolled": "Enrolled",
+        "colStatus": "Status",
+        "colActions": "Actions",
+        "viewDetail": "View",
+        "edit": "Edit",
+        "emptyTitle": "No electives",
+        "emptyDescription": "Adjust filters or create the first elective",
+        "emptyAction": "New Elective",
+        "mswNotice": "Elective list query contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "statTotalCourses": "Total courses",
+        "statTotalCapacity": "Total capacity",
+        "statTotalEnrolled": "Total enrolled",
+        "statTotalDraft": "Draft count",
+        "statTotalOpen": "Open count",
+        "statsTitle": "Elective overview",
+        "colClassroom": "Classroom",
+        "colSchedule": "Schedule",
+        "colCredit": "Credit",
+        "colSelectionMode": "Selection mode",
+        "openSelection": "Open selection",
+        "closeSelection": "Close selection",
+        "runLottery": "Run lottery",
+        "delete": "Delete",
+        "deleteSuccess": "Elective deleted",
+        "deleteFailed": "Delete failed",
+        "openSuccess": "Selection opened",
+        "closeSuccess": "Selection closed",
+        "lotterySuccess": "Lottery completed",
+        "lotteryFailed": "Lottery failed",
+        "confirmOpenTitle": "Confirm open selection",
+        "confirmOpenDescription": "Students can start selecting after opening. Continue?",
+        "confirmCloseTitle": "Confirm close selection",
+        "confirmCloseDescription": "Students cannot select after closing. Continue?",
+        "confirmLotteryTitle": "Confirm lottery",
+        "confirmLotteryDescription": "Lottery will assign spots to all applicants. This cannot be undone. Continue?",
+        "confirmDeleteTitle": "Delete elective",
+        "confirmDeleteDescription": "Are you sure you want to delete this elective? This action cannot be undone.",
+        "confirmCancel": "Cancel",
+        "confirmSubmit": "Confirm",
+        "confirming": "Processing...",
+        "selectionModeFcfs": "First come first served",
+        "selectionModeLottery": "Lottery"
+      },
+      "create": {
+        "title": "New Elective",
+        "description": "Fill in elective basic information",
+        "submit": "Save",
+        "cancel": "Cancel",
+        "success": "Elective created",
+        "error": "Creation failed",
+        "fieldName": "Name",
+        "fieldDescription": "Description",
+        "fieldSubjectId": "Subject",
+        "fieldGradeId": "Grade",
+        "fieldTeacherId": "Teacher",
+        "fieldCapacity": "Capacity",
+        "fieldStartDate": "Start date",
+        "fieldEndDate": "End date",
+        "fieldStatus": "Status",
+        "errorNameRequired": "Name is required",
+        "errorSubjectRequired": "Please select a subject",
+        "errorCapacityInvalid": "Capacity must be a positive integer",
+        "contractPending": "Elective creation contract pending. Ensure NEXT_PUBLIC_MSW=1 is enabled.",
+        "fieldCredit": "Credit",
+        "fieldClassroom": "Classroom",
+        "fieldSchedule": "Schedule",
+        "fieldSelectionMode": "Selection mode",
+        "fieldSelectionStartAt": "Selection start time",
+        "fieldSelectionEndAt": "Selection end time",
+        "fieldDropDeadline": "Drop deadline",
+        "selectionModeFcfs": "First come first served",
+        "selectionModeLottery": "Lottery"
+      },
+      "detail": {
+        "title": "Elective Detail",
+        "edit": "Edit",
+        "notFound": "Elective not found",
+        "backToList": "Back to list",
+        "sectionBasic": "Basic information",
+        "sectionSchedule": "Schedule",
+        "sectionEnrollment": "Enrollment records",
+        "fieldName": "Name",
+        "fieldDescription": "Description",
+        "fieldSubject": "Subject",
+        "fieldGrade": "Grade",
+        "fieldTeacher": "Teacher",
+        "fieldCapacity": "Capacity",
+        "fieldEnrolled": "Enrolled",
+        "fieldStatus": "Status",
+        "fieldStartDate": "Start date",
+        "fieldEndDate": "End date",
+        "enrollmentTitle": "Enrolled students",
+        "enrollmentStudentName": "Student name",
+        "enrollmentStudentNo": "Student No.",
+        "enrollmentEnrolledAt": "Enrolled at",
+        "emptyEnrollment": "No students enrolled",
+        "fieldClassroom": "Classroom",
+        "fieldSchedule": "Schedule",
+        "fieldCredit": "Credit",
+        "fieldSelectionMode": "Selection mode",
+        "fieldSelectionStart": "Selection start time",
+        "fieldSelectionEnd": "Selection end time",
+        "fieldDropDeadline": "Drop deadline",
+        "fieldPriority": "Priority",
+        "selectionModeFcfs": "First come first served",
+        "selectionModeLottery": "Lottery",
+        "enrollmentPriority": "Priority",
+        "delete": "Delete",
+        "deleteTitle": "Delete elective",
+        "deleteDescription": "Are you sure you want to delete this elective? This action cannot be undone.",
+        "deleteConfirm": "Confirm delete",
+        "deleteCancel": "Cancel",
+        "deleteSuccess": "Elective deleted",
+        "deleteFailed": "Delete failed",
+        "openSelection": "Open selection",
+        "closeSelection": "Close selection",
+        "runLottery": "Run lottery",
+        "openSuccess": "Selection opened",
+        "closeSuccess": "Selection closed",
+        "lotterySuccess": "Lottery completed",
+        "lotteryFailed": "Lottery failed"
+      },
+      "edit": {
+        "title": "Edit Elective",
+        "description": "Modify elective information",
+        "submit": "Save",
+        "cancel": "Cancel",
+        "success": "Elective updated",
+        "error": "Update failed",
+        "fieldName": "Name",
+        "fieldDescription": "Description",
+        "fieldSubjectId": "Subject",
+        "fieldGradeId": "Grade",
+        "fieldTeacherId": "Teacher",
+        "fieldCapacity": "Capacity",
+        "fieldStartDate": "Start date",
+        "fieldEndDate": "End date",
+        "fieldStatus": "Status",
+        "errorNameRequired": "Name is required",
+        "errorSubjectRequired": "Please select a subject",
+        "errorCapacityInvalid": "Capacity must be a positive integer",
+        "notFound": "Elective not found",
+        "backToDetail": "Back to detail",
+        "fieldCredit": "Credit",
+        "fieldClassroom": "Classroom",
+        "fieldSchedule": "Schedule",
+        "fieldSelectionMode": "Selection mode",
+        "fieldSelectionStartAt": "Selection start time",
+        "fieldSelectionEndAt": "Selection end time",
+        "fieldDropDeadline": "Drop deadline",
+        "selectionModeFcfs": "First come first served",
+        "selectionModeLottery": "Lottery"
+      },
+      "error": {
+        "title": "Elective module error",
+        "unknown": "Unknown error in elective module",
+        "retry": "Retry"
+      }
     }
   }
 }
diff --git a/apps/portal-shell/src/messages/zh-CN.json b/apps/portal-shell/src/messages/zh-CN.json
index f414253..9d10ad3 100644
--- a/apps/portal-shell/src/messages/zh-CN.json
+++ b/apps/portal-shell/src/messages/zh-CN.json
@@ -6,10 +6,13 @@
       "cancel": "取消",
       "edit": "编辑",
       "export": "导出",
+      "import": "导入",
       "search": "搜索",
       "delete": "删除",
       "retry": "重试",
-      "back": "返回"
+      "back": "返回",
+      "prev": "上一页",
+      "next": "下一页"
     },
     "label": {
       "search": "搜索",
@@ -30,6 +33,7 @@
     },
     "error": {
       "loadFailed": "加载失败：{message}",
+      "operationFailed": "操作失败：{message}",
       "pageError": "页面出错了"
     },
     "nav": {
@@ -45,7 +49,8 @@
     },
     "empty": {
       "title": "暂无数据",
-      "description": "调整筛选条件后重试，或新建第一条记录"
+      "description": "调整筛选条件后重试，或新建第一条记录",
+      "searchResult": "没有匹配的权限点"
     },
     "navLabel": {
       "dashboard": "仪表盘",
@@ -120,11 +125,16 @@
     "subtitle": "{email} · 角色：{roles} · 数据范围：{dataScope}",
     "subtitleNoRoles": "无",
     "error": {
-      "loadFailed": "仪表盘加载失败：{message}"
+      "loadFailed": "仪表盘加载失败：{message}",
+      "loadFailedGeneric": "加载失败",
+      "loadFailedDesc": "数据暂时无法加载，请重试",
+      "retry": "重试"
     },
     "empty": {
       "title": "暂无数据",
-      "description": "仪表盘数据尚未就绪"
+      "description": "仪表盘数据尚未就绪",
+      "noNotifications": "暂无通知",
+      "noNotificationsDesc": "新通知将显示在这里"
     },
     "stats": {
       "classes": "班级总数",
@@ -145,6 +155,11 @@
       "title": "教师仪表盘",
       "description": "今日教学概览",
       "loadFailed": "仪表盘数据加载失败，请稍后重试。",
+      "greeting": {
+        "morning": "早上好",
+        "afternoon": "下午好",
+        "evening": "晚上好"
+      },
       "stats": {
         "totalClasses": "班级总数",
         "totalStudents": "学生总数",
@@ -164,6 +179,74 @@
         "currentValue": "当前值",
         "threshold": "阈值"
       }
+    },
+    "teacherCards": {
+      "quickActions": {
+        "createAssignment": "创建作业",
+        "grade": "批改作业",
+        "myClasses": "我的班级"
+      },
+      "todo": {
+        "title": "待办",
+        "empty": "今日无待办"
+      },
+      "classes": {
+        "title": "我的班级",
+        "viewAll": "查看全部",
+        "emptyTitle": "暂无班级",
+        "emptyDescription": "请联系管理员分配班级",
+        "createClass": "管理班级",
+        "homeroom": "班主任",
+        "room": "教室"
+      },
+      "homework": {
+        "title": "作业",
+        "createNewAssignment": "新建作业",
+        "emptyTitle": "暂无作业",
+        "emptyDescription": "点击 + 创建首个作业",
+        "create": "创建作业",
+        "noDueDate": "无截止日期",
+        "viewAllAssignments": "查看全部作业"
+      },
+      "schedule": {
+        "title": "今日课表",
+        "emptyTitle": "今日无课",
+        "emptyDescription": "享受空闲的一天",
+        "viewSchedule": "查看课表",
+        "live": "进行中",
+        "scrollForMore": "向下滚动查看更多",
+        "noMoreClasses": "今日无更多课程"
+      },
+      "gradeTrends": {
+        "title": "班级成绩趋势",
+        "description": "近 {count} 次作业平均得分率",
+        "emptyTitle": "暂无成绩数据",
+        "emptyDescription": "完成批改后将展示趋势",
+        "averageScorePercent": "平均得分率",
+        "submittedCount": "提交 {submitted}/{total}"
+      },
+      "recentSubmissions": {
+        "title": "最近提交",
+        "viewAll": "查看全部",
+        "emptyTitle": "暂无新提交",
+        "emptyDescription": "全部已批改完成",
+        "colStudent": "学生",
+        "colAssignment": "作业",
+        "colSubmitted": "提交时间",
+        "colAction": "操作",
+        "late": "迟到",
+        "grade": "批改"
+      }
+    },
+    "timeRange": {
+      "label": "时间范围",
+      "today": "今天",
+      "week": "本周",
+      "month": "本月"
+    },
+    "sections": {
+      "notifications": "通知",
+      "viewAllNotifications": "查看全部通知"
     }
   },
   "classes": {
@@ -431,6 +514,102 @@
       "title": "考试页面出错了",
       "unknown": "未知错误",
       "retry": "重试"
+    },
+    "actions": {
+      "view": "查看",
+      "build": "组卷",
+      "analytics": "分析",
+      "delete": "删除",
+      "confirmDelete": "确认删除",
+      "cancel": "取消",
+      "deleteSuccess": "删除成功",
+      "deleteFailed": "删除失败：{message}",
+      "readOnly": "只读"
+    },
+    "table": {
+      "selectAll": "全选",
+      "selectRow": "选择此行",
+      "selectedCount": "已选 {selected}/{total} 行",
+      "noResults": "暂无数据"
+    },
+    "viewer": {
+      "section": "大题",
+      "group": "小题",
+      "unknown": "未知题型",
+      "scoreLabel": "分值：{score}",
+      "noQuestions": "暂无题目"
+    },
+    "paper": {
+      "section": "大题",
+      "group": "小题",
+      "scoreWithUnit": "（{score}分）",
+      "subject": "科目",
+      "grade": "年级",
+      "time": "时长",
+      "minutes": "分钟",
+      "total": "总分",
+      "pts": "分",
+      "class": "班级",
+      "name": "姓名",
+      "no": "考号",
+      "empty": "暂无题目"
+    },
+    "editor": {
+      "contentPlaceholder": "开始输入试卷内容...",
+      "loading": "编辑器加载中..."
+    },
+    "richEditor": {
+      "bold": "加粗",
+      "italic": "斜体",
+      "strike": "删除线",
+      "dotted": "加点字",
+      "bulletList": "无序列表",
+      "orderedList": "有序列表",
+      "quote": "引用",
+      "undo": "撤销",
+      "redo": "重做",
+      "markBlank": "标记填空"
+    },
+    "selectionToolbar": {
+      "ariaLabel": "选区快捷工具栏",
+      "blankShortAnswer": "简答题",
+      "composite": "复合题",
+      "defaultGroupTitle": "大题",
+      "defaultSectionTitle": "分卷",
+      "groupLabel": "分组",
+      "image": "图片",
+      "sectionLabel": "分卷",
+      "singleChoice": "单选题"
+    },
+    "richForm": {
+      "titlePlaceholder": "请输入试卷标题",
+      "classIdPlaceholder": "班级 ID",
+      "subjectIdPlaceholder": "科目 ID",
+      "difficulty": "难度",
+      "difficultyLevel1": "1星",
+      "difficultyLevel2": "2星",
+      "difficultyLevel3": "3星",
+      "difficultyLevel4": "4星",
+      "difficultyLevel5": "5星",
+      "totalScore": "满分",
+      "durationMin": "时长(分钟)",
+      "examDate": "考试日期",
+      "back": "返回",
+      "save": "保存",
+      "saving": "保存中...",
+      "emptyContent": "编辑器内容为空",
+      "titleRequired": "请填写试卷标题",
+      "missingExamId": "缺少考试 ID",
+      "classSubjectRequired": "请填写班级和科目",
+      "examDateRequired": "请选择考试日期",
+      "saveSuccess": "保存成功",
+      "saveFailed": "保存失败：{message}",
+      "createSuccess": "创建成功",
+      "createFailed": "创建失败：{message}",
+      "editorArea": "编辑区",
+      "previewArea": "预览区",
+      "previewSummary": "共 {count} 题 · 总分 {total}",
+      "emptyPreview": "在左侧编辑器中输入内容后，这里将显示预览"
     }
   },
   "homework": {
@@ -638,10 +817,184 @@
       "suggestedScore": "建议分数",
       "confidence": "置信度"
     },
+    "scanUploader": {
+      "scanTitle": "上传扫描图",
+      "dragDropHint": "拖拽图片到此处上传",
+      "fileTypesHint": "支持 JPG / PNG / WebP / PDF",
+      "uploading": "上传中...",
+      "uploadFailed": "上传失败",
+      "uploadSuccess": "已上传 {count} 张扫描图",
+      "selectImageFiles": "请选择图片或 PDF 文件",
+      "pageLabel": "第 {page} 页",
+      "moveUp": "上移",
+      "moveDown": "下移",
+      "deleteScan": "删除扫描图",
+      "noScans": "暂无扫描图"
+    },
+    "scanViewer": {
+      "noImages": "暂无扫描图",
+      "noImagesHint": "请先上传学生答题扫描图",
+      "zoomIn": "放大",
+      "zoomOut": "缩小",
+      "rotate": "旋转",
+      "fullscreen": "全屏",
+      "pageIndicator": "第 {current}/{total} 页",
+      "answerImageAlt": "第 {page} 页答题图",
+      "thumbnailAlt": "第 {page} 页缩略图"
+    },
+    "result": {
+      "scoreRate": "得分率",
+      "fullyGraded": "所有题目已批改完成",
+      "partiallyGraded": "部分题目仍待批改",
+      "correctCount": "答对",
+      "incorrectCount": "答错",
+      "partialCount": "部分正确",
+      "pendingCount": "待批改",
+      "wrongAnswersTitle": "错题预览",
+      "wrongAnswersDesc": "以下是答错或部分正确的题目",
+      "backToList": "返回列表",
+      "viewErrorBook": "查看错题本",
+      "yourAnswer": "你的答案",
+      "correctAnswer": "正确答案",
+      "teacherFeedback": "教师反馈",
+      "correctAnswerTrue": "正确",
+      "correctAnswerFalse": "错误"
+    },
     "error": {
       "title": "作业页面出错了",
       "unknown": "未知错误",
       "retry": "重试"
+    },
+    "review": {
+      "gradedReport": "批改报告",
+      "submissionDetails": "提交详情",
+      "questionsUnit": "题",
+      "backToList": "返回列表",
+      "assignmentInfo": "作业信息",
+      "status": "状态",
+      "description": "说明",
+      "noDescription": "无说明",
+      "totalScore": "总分",
+      "questionBreakdown": "题目分布",
+      "responseSummary": "作答概览"
+    },
+    "grade": {
+      "correct": "正确",
+      "partial": "部分正确",
+      "incorrect": "错误"
+    },
+    "take": {
+      "back": "返回",
+      "questions": "题",
+      "notStarted": "未开始",
+      "timedExam": "限时考试：{minutes} 分钟",
+      "starting": "开始中...",
+      "startAssignment": "开始作答",
+      "timeRemaining": "剩余时间",
+      "submitting": "提交中...",
+      "submitAssignment": "提交作业",
+      "saveFailed": "保存失败",
+      "startSuccess": "已开始作答",
+      "startFailed": "开始失败",
+      "saved": "已保存",
+      "submitSuccess": "已提交",
+      "submitFailed": "提交失败",
+      "timeUpAutoSubmit": "时间到，已自动提交",
+      "readyToStart": "准备开始",
+      "readyDescription": "点击下方按钮开始作答",
+      "startNow": "立即开始",
+      "confirmSubmit": "确认提交",
+      "unansweredWarning": "还有 {count} 题未作答",
+      "confirmSubmitDescription": "确认要提交作业吗？提交后将无法修改。",
+      "cancel": "取消",
+      "confirmSubmitAction": "确认提交",
+      "assignmentInfo": "作业信息",
+      "status": "状态",
+      "dueDate": "截止时间",
+      "overdue": "已逾期",
+      "lessThanOneHour": "不足 1 小时",
+      "hoursLeft": "剩余 {hours} 小时",
+      "attempts": "尝试次数",
+      "attemptsUsed": "已用 {used}/{max} 次",
+      "attemptsRemaining": "剩余 {remaining} 次",
+      "description": "说明",
+      "noDescription": "无说明",
+      "progress": "作答进度",
+      "jumpToQuestion": "跳转到第 {index} 题",
+      "answered": "已答",
+      "unanswered": "未答",
+      "submitAll": "提交全部",
+      "makeSureAnswered": "请确认所有题目已作答",
+      "saveAnswer": "保存答案",
+      "scanTitle": "扫描上传",
+      "scanDescription": "上传手写作业扫描件"
+    }
+  },
+  "examHomework": {
+    "homework": {
+      "analytics": {
+        "examContent": "考试内容",
+        "questionPreview": "题目预览",
+        "errorAnalysis": "错误分析",
+        "errorRateOverview": "错误率概览",
+        "errorRateAriaLabel": "错误率 {rate}%",
+        "question": "题目",
+        "errors": "错误数",
+        "errorRateLabel": "错误率",
+        "wrongAnswersWithCount": "错答 ({count})",
+        "wrongAnswers": "错答",
+        "noWrongAnswers": "暂无错答记录。",
+        "studentAnswer": "学生答案",
+        "studentCount": "{count} 名学生",
+        "notAnswered": "未作答",
+        "selectQuestionHint": "请从左侧选择题目",
+        "selectQuestionHintDesc": "查看错误分析",
+        "noGradedSubmissions": "暂无已批改的提交。"
+      },
+      "take": {
+        "true": "正确",
+        "false": "错误"
+      },
+      "excellent": {
+        "title": "优秀作业展示",
+        "description": "本作业中得分率达到 {minPercentage}% 及以上的优秀样例。",
+        "empty": "暂无符合条件的优秀作业。",
+        "emptyHint": "完成批改后将自动汇总展示。",
+        "studentAnon": "同学",
+        "rank": "第 {rank} 名",
+        "lateTag": "迟交",
+        "submittedAt": "提交于 {date}",
+        "scoreValue": "{score} / {max}",
+        "percentage": "{value}%"
+      },
+      "form": {
+        "createTitle": "创建作业",
+        "quickMode": "快速作业",
+        "quickModeDescription": "直接输入标题和描述，无需建题",
+        "examMode": "考试派生作业",
+        "examModeDescription": "从已有考试派生作业",
+        "class": "班级",
+        "selectClass": "选择班级",
+        "sourceExam": "来源考试",
+        "selectExam": "选择考试",
+        "assignmentTitle": "作业标题",
+        "titlePlaceholderQuick": "例如：背诵第三课课文",
+        "titlePlaceholderExam": "默认使用考试标题",
+        "description": "描述（可选）",
+        "descriptionPlaceholderQuick": "输入作业要求、题目内容或说明...",
+        "availableAt": "开放时间（可选）",
+        "dueAt": "截止时间（可选）",
+        "allowLate": "允许迟交",
+        "lateDueAt": "迟交截止时间（可选）",
+        "maxAttempts": "最大尝试次数",
+        "submit": "创建作业",
+        "submitting": "创建中...",
+        "creating": "正在创建作业...",
+        "selectExamRequired": "请选择考试",
+        "titleRequired": "请输入标题",
+        "selectClassRequired": "请选择班级",
+        "createFailed": "创建失败"
+      }
     }
   },
   "grades": {
@@ -733,7 +1086,18 @@
       "colMinScore": "最低分",
       "colPassRate": "及格率",
       "colPassCount": "及格人数",
-      "colFailCount": "不及格人数"
+      "colFailCount": "不及格人数",
+      "noData": "暂无数据",
+      "average": "平均分",
+      "median": "中位数",
+      "max": "最高分",
+      "min": "最低分",
+      "stdDev": "标准差",
+      "stdDevHint": "反映成绩离散程度",
+      "passRateHint": "及格率（≥60分）",
+      "excellentRate": "优秀率",
+      "excellentRateHint": "优秀率（≥85分）",
+      "count": "记录数"
     },
     "reportCard": {
       "title": "学生成绩单",
@@ -763,6 +1127,49 @@
       "title": "成绩页面出错了",
       "unknown": "未知错误",
       "retry": "重试"
+    },
+    "classReport": {
+      "studentCountInfo": "应参加 {studentCount} 人 · 已录入 {recordCount} 条",
+      "noDataTitle": "暂无班级成绩数据",
+      "noDataDescription": "请先录入成绩后再查看班级报告",
+      "classRanking": "班级排名",
+      "caption": "班级成绩排名表",
+      "rankColumn": "名次",
+      "recordsColumn": "记录数"
+    },
+    "growthArchive": {
+      "title": "学生成长档案",
+      "description": "覆盖 {years} 个学年 · {records} 条记录 · {subjects} 个学科",
+      "descriptionEmpty": "暂无成长档案数据",
+      "emptyTitle": "暂无成长数据",
+      "emptyDescription": "至少需要两个学期的成绩数据才能展示成长趋势",
+      "deltaUp": "较上期提升 {delta} 分",
+      "deltaDown": "较上期下降 {delta} 分",
+      "deltaStable": "与上期持平",
+      "overallAverage": "总体均分 {score}",
+      "averageScore": "平均分",
+      "ariaLabelNonEmpty": "成长趋势图，共 {count} 个数据点",
+      "ariaLabelEmpty": "成长趋势图为空",
+      "statsAverage": "平均分 {score}",
+      "statsPassRate": "及格率 {rate}%",
+      "statsRecords": "{count} 条记录"
+    },
+    "knowledgePointMastery": {
+      "title": "知识点掌握度",
+      "description": "共 {count} 个知识点 · 平均掌握度 {avg}%",
+      "descriptionEmpty": "暂无知识点掌握度数据",
+      "emptyTitle": "暂无掌握度数据",
+      "emptyDescription": "需要先有练习或考试数据才能统计掌握度",
+      "viewDetail": "查看详情",
+      "ariaLabel": "知识点掌握度柱状图，共 {count} 个知识点",
+      "averageMastery": "平均掌握度",
+      "tooltipMastery": "掌握度：{value}%",
+      "tooltipStudents": "已掌握 {mastered} / {total} 人",
+      "weakPointsAriaLabel": "薄弱知识点列表",
+      "weakPointsTitle": "薄弱知识点"
+    },
+    "summary": {
+      "averageScore": "平均分"
     }
   },
   "analytics": {
@@ -1001,7 +1408,261 @@
     "error": {
       "title": "AI 模块页面出错了",
       "unknown": "AI 模块发生未知错误",
-      "retry": "重试"
+      "retry": "重试",
+      "invalidInput": "输入数据无效",
+      "chatFailed": "AI 请求失败",
+      "suggestionFailed": "AI 建议失败",
+      "gradingFailed": "AI 批改失败",
+      "contentFailed": "内容生成失败",
+      "variantFailed": "题目变体生成失败",
+      "analysisFailed": "薄弱点分析失败",
+      "statsFailed": "AI 使用统计查询失败",
+      "boundaryTitle": "AI 功能错误",
+      "boundaryDescription": "处理 AI 请求时发生错误，请重试。",
+      "unauthorized": "您没有使用 AI 功能的权限",
+      "providerNotConfigured": "AI 服务商未配置，请联系管理员。"
+    },
+    "chat": {
+      "title": "AI 助手",
+      "placeholder": "请输入您的问题...",
+      "inputLabel": "消息输入",
+      "send": "发送",
+      "thinking": "AI 正在思考...",
+      "streaming": "AI 正在输入...",
+      "stopGeneration": "停止生成",
+      "maxReached": "已达到最大消息数",
+      "clear": "清空对话",
+      "clearConfirm": "确认清空所有消息？",
+      "copy": "复制",
+      "copied": "已复制！",
+      "suggestedPrompts": {
+        "title": "试试问我...",
+        "teacher": [
+          "帮我批改这道题",
+          "生成一个课堂活动",
+          "创建一道测验题"
+        ],
+        "student": [
+          "解释这个概念",
+          "给我一道练习题",
+          "帮我复习"
+        ],
+        "parent": [
+          "我孩子学得怎么样？",
+          "在家应该关注什么？"
+        ],
+        "admin": [
+          "显示 AI 使用统计",
+          "哪些老师最常使用 AI？"
+        ],
+        "context": {
+          "teacherGrading": [
+            "这类题目常见错误有哪些？",
+            "如何给出建设性反馈？"
+          ],
+          "teacherLesson": [
+            "为这节课建议一个导入",
+            "有哪些分层教学策略？"
+          ],
+          "teacherExam": [
+            "生成一道相关题目",
+            "分析难度分布"
+          ],
+          "studentHomework": [
+            "给我提示，不要答案",
+            "帮我理解这个概念"
+          ]
+        }
+      },
+      "contextMessage": {
+        "teacherGrading": "当前页面：作业批改视图",
+        "teacherLesson": "当前页面：备课编辑器",
+        "teacherExam": "当前页面：试卷组卷",
+        "studentErrorBook": "当前页面：错题本（学生视图）",
+        "studentHomework": "当前页面：学生作业视图",
+        "parent": "当前页面：家长面板",
+        "admin": "当前页面：管理员面板"
+      }
+    },
+    "provider": {
+      "label": "AI 服务商",
+      "placeholder": "选择服务商",
+      "loading": "加载服务商中...",
+      "default": "默认",
+      "description": "选择本次操作使用的 AI 配置。",
+      "manage": "管理",
+      "manageTitle": "AI 服务商设置",
+      "manageDescription": "新建服务商或更新已有配置。"
+    },
+    "suggestion": {
+      "title": "AI 建议",
+      "generate": "生成建议",
+      "regenerate": "重新生成",
+      "loading": "AI 思考中...",
+      "empty": "暂无建议",
+      "error": "生成建议失败",
+      "loaded": "建议已加载",
+      "selected": "已选择建议",
+      "select": "选择",
+      "difficulty": "难度",
+      "practiceNow": "立即练习",
+      "addAll": "全部添加"
+    },
+    "grading": {
+      "title": "AI 批改建议",
+      "description": "AI 驱动的主观题评分与反馈",
+      "suggestedScore": "建议分数",
+      "confidence": "置信度",
+      "feedback": "反馈",
+      "reasoning": "评分依据",
+      "applyScore": "应用分数",
+      "applyFeedback": "应用反馈",
+      "loading": "AI 批改中...",
+      "error": "AI 批改失败",
+      "notAvailable": "此题型不支持 AI 批改",
+      "batchTitle": "批量 AI 批改",
+      "batchDescription": "一次性为所有主观题生成 AI 建议",
+      "batchGenerate": "生成全部建议",
+      "batchProgress": "处理中 {done}/{total}",
+      "currentScore": "当前分数",
+      "scoreDifference": "差值"
+    },
+    "errorBook": {
+      "similarQuestions": "相似题目",
+      "weaknessAnalysis": "薄弱点分析",
+      "studyPlan": "学习计划",
+      "recommendedResources": "推荐资源",
+      "weakAreas": "薄弱领域",
+      "severity": {
+        "high": "高",
+        "medium": "中",
+        "low": "低"
+      }
+    },
+    "lessonPrep": {
+      "generateContent": "生成内容",
+      "description": "AI 驱动的教学内容生成",
+      "generateActivity": "建议活动",
+      "generateAssessment": "生成评估",
+      "generateQuestion": "生成讨论题",
+      "loading": "生成中...",
+      "error": "内容生成失败",
+      "additionalContext": "附加上下文",
+      "additionalContextPlaceholder": "添加特定要求或上下文信息...",
+      "insertContent": "插入内容",
+      "editBeforeInsert": "插入前编辑",
+      "history": "生成历史",
+      "clearHistory": "清空历史"
+    },
+    "exam": {
+      "generate": "生成",
+      "generating": "生成中...",
+      "preview": "预览",
+      "queue": "加入队列",
+      "queueRunning": "运行中",
+      "queueQueued": "排队中",
+      "backgroundTasks": "后台任务",
+      "taskStatus": {
+        "queued": "排队中",
+        "running": "生成中",
+        "success": "已完成",
+        "failed": "失败"
+      },
+      "openPreview": "打开预览",
+      "sourceText": "试卷原文",
+      "sourceTextPlaceholder": "粘贴试卷文本以解析为题目",
+      "sourceTextDesc": "AI 将从文本中提取题目和结构。",
+      "generationTitle": "AI 生成",
+      "generationDesc": "粘贴试卷文本并生成结构化预览。",
+      "variantType": {
+        "label": "变体类型",
+        "same_knowledge_point": "同知识点，不同情境",
+        "different_difficulty": "不同难度",
+        "different_format": "不同题型"
+      },
+      "targetDifficulty": "目标难度",
+      "addVariant": "添加变体"
+    },
+    "parent": {
+      "summary": "AI 学情摘要",
+      "summaryDescription": "AI 生成的子女学习进度概览",
+      "generateSummary": "生成摘要",
+      "weaknessHint": "需关注领域",
+      "suggestion": "家庭辅导建议",
+      "loading": "生成摘要中...",
+      "error": "生成摘要失败"
+    },
+    "admin": {
+      "usageDashboard": "AI 使用仪表盘",
+      "dashboardDescription": "监控全校 AI 使用情况",
+      "totalCalls": "AI 调用总数",
+      "activeUsers": "活跃用户",
+      "costEstimate": "预估成本",
+      "topUsers": "高频用户",
+      "byCapability": "按能力分类",
+      "byRole": "按角色分类",
+      "recentActivity": "最近活动",
+      "noData": "暂无 AI 使用数据",
+      "callsToday": "今日调用",
+      "callsThisWeek": "本周调用",
+      "errorRate": "错误率",
+      "avgDuration": "平均耗时",
+      "settings": {
+        "title": "AI 配置",
+        "description": "统一管理 AI 服务商、API 密钥与使用统计。",
+        "descriptionAdmin": "统一管理 AI 服务商、API 密钥与使用统计（管理员视图）。",
+        "descriptionUser": "管理你的 AI 服务商与 API 密钥。"
+      }
+    },
+    "studyPath": {
+      "title": "你的学习路径",
+      "description": "AI 个性化学习建议",
+      "nextSteps": "推荐下一步",
+      "mastered": "已掌握",
+      "inProgress": "学习中",
+      "needsWork": "需要加强",
+      "generate": "生成学习路径",
+      "loading": "生成学习路径中...",
+      "error": "生成学习路径失败",
+      "startLearning": "开始学习"
+    },
+    "widget": {
+      "title": "AI 助手",
+      "open": "打开 AI 助手",
+      "close": "关闭",
+      "contextAware": "上下文感知",
+      "dragHint": "拖动移动 · 长按边缘隐藏",
+      "hidden": "已隐藏",
+      "show": "显示",
+      "hide": "隐藏",
+      "resetPosition": "重置位置",
+      "welcome": "你好，我是 AI 助手",
+      "welcomeDesc": "有什么可以帮你的吗？",
+      "newChat": "新对话",
+      "history": "历史记录",
+      "online": "在线",
+      "tokens": "{count} 字"
+    },
+    "safety": {
+      "blocked": "您的消息被安全过滤器拦截，请保持教育性对话。",
+      "dailyLimit": "今日 AI 使用次数已达上限，请明天再试。",
+      "studentMode": "AI 处于学生模式，将引导你自主找到答案。",
+      "contentFiltered": "AI 回复中的不当内容已被过滤。"
+    },
+    "capability": {
+      "chat": "AI 对话",
+      "examGenerate": "AI 出题",
+      "gradingAssist": "AI 辅助批改",
+      "lessonContent": "AI 备课内容",
+      "questionVariant": "AI 题目变体",
+      "similarQuestion": "AI 相似题",
+      "weaknessAnalysis": "AI 薄弱点分析",
+      "childSummary": "AI 子女摘要",
+      "studyPath": "AI 学习路径",
+      "explainError": "AI 错题解释"
+    },
+    "chart": {
+      "parseError": "图表数据格式错误，无法渲染"
     }
   },
   "attendance": {
@@ -1030,7 +1691,12 @@
       "colStatus": "状态",
       "colRemark": "备注",
       "colRecordedBy": "记录人",
-      "colUpdatedAt": "更新时间"
+      "colUpdatedAt": "更新时间",
+      "columns": {
+        "student": "学生",
+        "reason": "原因",
+        "status": "状态"
+      }
     },
     "sheet": {
       "title": "点名表",
@@ -1049,7 +1715,14 @@
       "errorNoEntries": "无考勤条目可保存",
       "success": "点名表保存成功",
       "error": "保存失败",
-      "loadFailed": "加载失败：{message}"
+      "loadFailed": "加载失败：{message}",
+      "selectClass": "请选择班级",
+      "reasonPlaceholder": "请输入原因",
+      "saved": "点名表已保存",
+      "saving": "保存中...",
+      "noStudents": "该班级暂无学生",
+      "confirmClassSwitch": "切换班级将丢失未保存的修改，确认切换？",
+      "confirmClassSwitchAction": "确认切换"
     },
     "report": {
       "title": "考勤报表",
@@ -1070,7 +1743,31 @@
       "colAbsent": "缺勤",
       "colLate": "迟到",
       "colLeave": "请假",
-      "colAttendanceRate": "出勤率"
+      "colAttendanceRate": "出勤率",
+      "printing": "打印中...",
+      "relationship": "与学生关系",
+      "period": "统计周期",
+      "parentSignature": "家长签字单",
+      "type": "报表类型",
+      "noData": "暂无报表数据",
+      "controls": "报表控制",
+      "noDataDescription": "请调整筛选条件后重试",
+      "parentComment": "家长意见",
+      "studentDetails": "学生明细",
+      "footer": "本报表由系统自动生成，仅供参考。",
+      "generatedAt": "生成日期",
+      "signature": "签字",
+      "parentName": "家长姓名",
+      "summary": "汇总统计",
+      "startDate": "开始日期",
+      "endDate": "结束日期",
+      "print": "打印",
+      "parentSignatureNotice": "请家长仔细核对以上考勤记录，并签字确认。",
+      "signDate": "签字日期",
+      "types": {
+        "weekly": "周报",
+        "monthly": "月报"
+      }
     },
     "stats": {
       "title": "考勤统计",
@@ -1096,6 +1793,41 @@
       "title": "考勤模块出错了",
       "unknown": "考勤模块发生未知错误",
       "retry": "重试"
+    },
+    "filters": {
+      "class": "班级",
+      "date": "日期"
+    },
+    "description": {
+      "teacherRecords": "教师记录学生每日出勤"
+    },
+    "actions": {
+      "cancel": "取消",
+      "save": "保存",
+      "markAllPresent": "全部标记为出勤"
+    },
+    "errors": {
+      "invalidForm": "表单填写有误",
+      "unexpected": "操作失败，请稍后重试"
+    },
+    "period": {
+      "label": "节次",
+      "full_day": "全天",
+      "morning_reading": "早读",
+      "morning": "上午",
+      "afternoon": "下午",
+      "evening": "晚上"
+    },
+    "rules": {
+      "title": "考勤规则",
+      "lateThreshold": "迟到阈值（分钟）",
+      "earlyLeaveThreshold": "早退阈值（分钟）",
+      "enableAutoMark": "启用自动标记",
+      "attendanceRateThreshold": "出勤率阈值（%）",
+      "attendanceRateThresholdHint": "低于此阈值将触发预警",
+      "consecutiveAbsenceThreshold": "连续缺勤阈值（次）",
+      "consecutiveAbsenceThresholdHint": "超过此次数将触发预警",
+      "saved": "规则已保存"
     }
   },
   "questions": {
@@ -1137,7 +1869,121 @@
     "error": {
       "title": "题库页面出错了",
       "unknown": "未知错误",
-      "retry": "重试"
+      "retry": "重试",
+      "createdSuccess": "题目创建成功",
+      "updatedSuccess": "题目更新成功",
+      "unexpected": "发生未知错误"
+    },
+    "content": {
+      "empty": "暂无题干内容",
+      "answer": "答案",
+      "explanation": "解析"
+    },
+    "actions": {
+      "menuLabel": "操作菜单",
+      "viewDetails": "查看详情",
+      "delete": "删除",
+      "deleteConfirmTitle": "确认删除",
+      "deleteConfirmDesc": "确定要删除此题目吗？此操作不可撤销。",
+      "deleteConfirmCancel": "取消",
+      "deleting": "删除中...",
+      "deleteSuccess": "删除成功",
+      "deleteFailed": "删除失败",
+      "copyId": "复制 ID",
+      "copyIdSuccess": "已复制到剪贴板",
+      "copyIdFailed": "复制失败",
+      "close": "关闭",
+      "detailsTitle": "题目详情",
+      "detailsId": "题目 ID",
+      "detailsType": "题型",
+      "detailsDifficulty": "难度",
+      "detailsContent": "题干"
+    },
+    "batch": {
+      "selected": "已选 {count} 项",
+      "delete": "批量删除",
+      "deleteConfirmTitle": "确认批量删除",
+      "deleteConfirmDesc": "确定要删除选中的 {count} 道题目吗？此操作不可撤销。",
+      "deleting": "删除中...",
+      "deleteSuccess": "批量删除成功",
+      "deleteFailed": "批量删除失败",
+      "cancel": "取消",
+      "clear": "清除选择",
+      "deleteConfirmAction": "确认删除"
+    },
+    "cascade": {
+      "textbook": "教材",
+      "textbookAll": "全部教材",
+      "chapter": "章节",
+      "chapterAll": "全部章节",
+      "knowledgePoint": "知识点",
+      "knowledgePointAll": "全部知识点",
+      "loading": "加载中..."
+    },
+    "importExport": {
+      "import": "导入",
+      "export": "导出",
+      "importing": "导入中...",
+      "exporting": "导出中...",
+      "importSuccess": "导入成功",
+      "importFailed": "导入失败",
+      "exportSuccess": "导出成功",
+      "exportFailed": "导出失败",
+      "confirmTitle": "确认导入",
+      "confirmDesc": "将覆盖现有题目，确定继续？",
+      "cancel": "取消",
+      "invalidFile": "无效的文件格式",
+      "readFailed": "文件读取失败",
+      "confirmImport": "确认导入"
+    },
+    "table": {
+      "type": "题型",
+      "content": "题干",
+      "difficulty": "难度",
+      "knowledgePoints": "知识点",
+      "created": "创建时间",
+      "noResults": "暂无结果"
+    },
+    "type": {
+      "single_choice": "单选题",
+      "multiple_choice": "多选题",
+      "judgment": "判断题",
+      "text": "简答题",
+      "composite": "复合题"
+    },
+    "difficulty": {
+      "1": "简单",
+      "2": "中等",
+      "3": "困难",
+      "4": "较难",
+      "5": "很难"
+    },
+    "dialog": {
+      "editTitle": "编辑题目",
+      "createTitle": "新建题目",
+      "editDesc": "编辑以下题目信息。",
+      "createDesc": "填写以下题目信息。",
+      "questionType": "题型",
+      "difficulty": "难度",
+      "questionContent": "题干",
+      "contentPlaceholder": "输入题干内容...",
+      "answer": "答案",
+      "explanation": "解析",
+      "cancel": "取消",
+      "updating": "更新中...",
+      "creating": "创建中...",
+      "update": "更新",
+      "create": "创建",
+      "addOption": "添加选项",
+      "markCorrect": "标记为正确答案",
+      "options": "选项",
+      "loading": "加载中...",
+      "knowledgePoints": "知识点",
+      "knowledgePointsOptional": "知识点（可选）",
+      "knowledgePointsSelected": "已选 {count} 个知识点",
+      "noKnowledgePoints": "暂无知识点",
+      "searchKnowledgePoints": "搜索知识点...",
+      "optionPlaceholder": "选项 {index}"
     }
   },
   "textbooks": {
@@ -1185,12 +2031,151 @@
       "colChapterStatus": "状态",
       "noChapters": "暂无章节",
       "noChaptersAction": "返回教材列表",
-      "chaptersMswNotice": "章节列表查询契约待补齐，当前通过 MSW 兜底。"
+      "chaptersMswNotice": "章节列表查询契约待补齐，当前通过 MSW 兜底。",
+      "sectionKnowledgeGraph": "知识图谱"
     },
     "error": {
       "title": "教材页面出错了",
       "unknown": "未知错误",
       "retry": "重试"
+    },
+    "graph": {
+      "viewModeStructure": "结构视图",
+      "viewModeStudentMastery": "学生掌握度",
+      "viewModeClassMastery": "班级掌握度",
+      "searchPlaceholder": "搜索知识点名称...",
+      "resetView": "重置视图",
+      "refreshing": "刷新中...",
+      "refresh": "刷新",
+      "edit": "编辑",
+      "delete": "删除",
+      "createQuestion": "创建题目",
+      "questionCount": "{count} 道题目",
+      "layout": {
+        "hierarchical": "分层布局",
+        "force": "力导向布局"
+      },
+      "error": {
+        "loadFailed": "知识图谱加载失败"
+      },
+      "node": {
+        "questions": "题目",
+        "mastery": "掌握度",
+        "prerequisite": "前置知识点",
+        "successor": "后置知识点"
+      },
+      "detail": {
+        "title": "知识点详情",
+        "close": "关闭",
+        "description": "描述",
+        "noDescription": "暂无描述",
+        "correctRate": "正确率",
+        "masteryNotAssessed": "未测评",
+        "totalQuestions": "总题数",
+        "viewAllQuestions": "查看全部题目",
+        "addPrerequisite": "添加前置",
+        "removePrerequisite": "移除前置依赖",
+        "noPrerequisites": "暂无前置知识点",
+        "noSuccessors": "暂无后置知识点",
+        "prerequisiteRemoveFailed": "移除前置依赖失败"
+      }
+    },
+    "knowledge": {
+      "title": "知识点",
+      "create": "新建知识点",
+      "empty": "暂无知识点",
+      "difficulty": "难度 {level}"
+    },
+    "card": {
+      "gradeNA": "未设置",
+      "version": "v{version}",
+      "moreOptions": "更多操作",
+      "editContent": "编辑内容",
+      "delete": "删除"
+    },
+    "reader": {
+      "contents": "目录",
+      "noChapters": "暂无章节",
+      "selectChapter": "请选择章节阅读",
+      "chapters": "章节",
+      "deleteFailed": "删除教材失败",
+      "emptyKnowledge": "暂无知识点",
+      "emptyKnowledgeDesc": "该教材尚未录入知识点，请先在章节下创建知识点。",
+      "loadingKnowledge": "正在加载知识点..."
+    },
+    "action": {
+      "updateNotSupported": "更新功能尚未支持（契约待补齐）。",
+      "kpCreateNotSupported": "创建知识点尚未支持（契约待补齐）。",
+      "deleteNotSupported": "删除功能尚未支持（契约待补齐）。",
+      "updateFailedGeneric": "更新失败",
+      "deleteFailed": "删除失败",
+      "errorOccurred": "发生错误",
+      "prerequisiteAddNotSupported": "添加前置依赖暂未支持（对话框待迁移）。",
+      "prerequisiteDeleteNotSupported": "删除前置依赖暂未支持（mutation 待补齐）。"
+    },
+    "dialog": {
+      "chapter": {
+        "createTitle": "新建章节",
+        "titlePlaceholder": "章节标题...",
+        "cancel": "取消",
+        "create": "创建",
+        "cannotDeleteWithSubchapters": "无法删除含有子章节的章节，请先删除子章节。"
+      },
+      "knowledge": {
+        "editTitle": "编辑知识点",
+        "nameLabel": "名称",
+        "cancel": "取消",
+        "saving": "保存中...",
+        "save": "保存",
+        "deleteTitle": "删除知识点",
+        "deleteDesc": "确定要删除“{name}”吗？此操作不可撤销。",
+        "delete": "删除"
+      },
+      "settings": {
+        "title": "教材设置",
+        "save": "保存",
+        "deleteConfirmTitle": "确认删除",
+        "deleteConfirmDesc": "确定要删除此教材吗？此操作不可撤销。",
+        "processing": "处理中...",
+        "delete": "删除"
+      },
+      "textbook": {
+        "titleLabel": "书名",
+        "titlePlaceholder": "输入教材名称...",
+        "subjectLabel": "学科",
+        "subjectPlaceholder": "选择学科",
+        "gradeLabel": "年级",
+        "gradePlaceholder": "选择年级",
+        "versionLabel": "版本",
+        "versionPlaceholder": "输入版本...",
+        "editTitle": "编辑教材",
+        "createTitle": "新建教材",
+        "save": "保存"
+      }
+    },
+    "subject": {
+      "chinese": "语文",
+      "mathematics": "数学",
+      "physics": "物理",
+      "chemistry": "化学",
+      "biology": "生物",
+      "english": "英语",
+      "history": "历史",
+      "geography": "地理"
+    },
+    "grade": {
+      "grade1": "一年级",
+      "grade2": "二年级",
+      "grade3": "三年级",
+      "grade4": "四年级",
+      "grade5": "五年级",
+      "grade6": "六年级",
+      "grade7": "七年级",
+      "grade8": "八年级",
+      "grade9": "九年级",
+      "grade10": "高一",
+      "grade11": "高二",
+      "grade12": "高三"
     }
   },
   "lessonPlans": {
@@ -1310,56 +2295,357 @@
       "title": "教案页面出错了",
       "unknown": "发生未知错误",
       "retry": "重试"
+    },
+    "action": {
+      "close": "关闭",
+      "cancel": "取消",
+      "confirm": "确认",
+      "delete": "删除"
+    },
+    "attachment": {
+      "title": "素材库",
+      "add": "上传附件",
+      "libraryLabel": "素材库",
+      "loading": "加载中...",
+      "empty": "暂无素材",
+      "delete": "删除",
+      "uploadFailed": "上传失败",
+      "uploadSuccess": "上传成功",
+      "type": {
+        "material": "教材",
+        "resource": "资源",
+        "other": "其他"
+      }
+    },
+    "knowledgePoint": {
+      "title": "选择知识点",
+      "empty": "暂无知识点"
+    },
+    "consistency": {
+      "title": "一致性校验",
+      "loading": "正在校验...",
+      "allPassed": "全部通过",
+      "hasErrors": "存在错误",
+      "hasWarnings": "存在警告"
+    },
+    "aiDifferentiation": {
+      "title": "AI 差异化教学",
+      "loading": "AI 分析中...",
+      "empty": "暂无建议",
+      "covered": "已覆盖 {count} 个",
+      "missed": "未覆盖 {count} 个",
+      "tabs": {
+        "differentiation": "差异化建议",
+        "curriculum": "课标核对",
+        "assessment": "可解释评估"
+      },
+      "level": {
+        "basic": "基础",
+        "intermediate": "进阶",
+        "advanced": "拓展"
+      }
+    },
+    "feedback": {
+      "title": "AI 反馈",
+      "loading": "AI 分析中...",
+      "empty": "暂无反馈",
+      "apply": "应用",
+      "category": {
+        "strengths": "优点",
+        "improvements": "改进建议",
+        "alignment": "目标对齐",
+        "differentiation": "差异化教学"
+      }
+    },
+    "banner": {
+      "anchorMigration": "检测到旧版锚点数据，已自动迁移到新格式。"
+    },
+    "exercise": {
+      "difficulty": "难度",
+      "contentPlaceholder": "输入题目内容...",
+      "questionId": "题目 #{id}",
+      "inlineQuestion": "内联题目",
+      "questionType": {
+        "single_choice": "单选题",
+        "multiple_choice": "多选题",
+        "text": "填空题",
+        "judgment": "判断题",
+        "composite": "复合题"
+      }
+    },
+    "detail": {
+      "selectNodeHint": "选择左侧节点查看详情",
+      "aiAssist": "AI 助手",
+      "aiGenerateLayered": "生成分层练习",
+      "aiFillExpected": "填充预期答案",
+      "aiOptimizeFollowup": "优化追问",
+      "aiGenerate": "AI 生成",
+      "aiOptimize": "AI 优化",
+      "aiDifferentiation": "AI 差异化",
+      "designIntent": "设计意图",
+      "qaDialog": "问答对话",
+      "addTurn": "添加问答",
+      "turnTeacher": "教师",
+      "turnStudent": "学生",
+      "round": "第 {n} 轮",
+      "turnContentPlaceholder": "输入发言内容...",
+      "expectedAnswer": "预期答案...",
+      "stageLabel": "教学阶段",
+      "differentiationLabel": "差异化层级",
+      "titleLabel": "标题",
+      "stageNone": "（未分组）",
+      "typeLabel": "类型",
+      "stage": {
+        "import": "导入",
+        "new_teaching": "新授",
+        "consolidation": "巩固",
+        "summary": "小结"
+      }
+    },
+    "version": {
+      "historyTitle": "版本历史",
+      "empty": "暂无历史版本",
+      "auto": "自动保存",
+      "revert": "回滚",
+      "compare": "对比",
+      "diffCount": "{count} 处差异"
+    },
+    "dialog": {
+      "versions": "版本历史",
+      "print": "打印预览",
+      "schedule": "排期",
+      "consistency": "一致性校验",
+      "aiFeedback": "AI 反馈",
+      "aiDifferentiation": "AI 差异化"
+    },
+    "homework": {
+      "type": {
+        "exercise": "练习",
+        "reading": "阅读",
+        "writing": "写作"
+      }
+    },
+    "blackboard": {
+      "layout": {
+        "structure": "结构式",
+        "mindmap": "思维导图",
+        "text": "文本"
+      }
+    },
+    "keyPoint": {
+      "type": {
+        "key": "重点",
+        "difficult": "难点"
+      }
+    },
+    "import": {
+      "method": {
+        "question": "提问导入",
+        "situation": "情境导入",
+        "review": "复习导入",
+        "other": "其他"
+      }
+    },
+    "objective": {
+      "dimension": {
+        "knowledge": "知识与技能",
+        "process": "过程与方法",
+        "emotion": "情感态度价值观"
+      }
+    },
+    "reflection": {
+      "aspect": {
+        "effectiveness": "教学效果",
+        "problems": "存在问题",
+        "improvements": "改进措施"
+      }
+    },
+    "newTeaching": {
+      "pointIndex": "知识点 {index}"
+    },
+    "paper": {
+      "textbookHeader": "教材正文",
+      "textbookPlaceholder": "输入教材正文...",
+      "expandedCount": "已展开 {count} 个节点",
+      "insertNode": "插入节点",
+      "consistencyCheck": "一致性检查"
     }
   },
   "coursePlans": {
     "title": "课程计划",
     "list": {
-      "title": "课程计划",
-      "description": "查看和管理所有课程计划",
-      "searchPlaceholder": "搜索计划名称...",
-      "gradePlaceholder": "年级 ID",
-      "subjectPlaceholder": "科目 ID",
-      "statusFilter": "按状态筛选",
-      "statusAll": "全部状态",
-      "statusDraft": "草稿",
-      "statusInProgress": "进行中",
-      "statusCompleted": "已完成",
-      "statusArchived": "已归档",
-      "total": "共 {count} 条",
-      "colName": "名称",
-      "colSemester": "学期",
-      "colStatus": "状态",
-      "colUpdatedAt": "更新时间",
-      "colActions": "操作",
-      "viewDetail": "查看详情 →",
-      "mswNotice": "列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      "new": "新建计划",
+      "empty": "暂无课程计划",
+      "emptyFiltered": "无符合条件的计划",
+      "noClass": "未分配班级",
+      "unknownSubject": "未知学科",
+      "semester": "第 {semester} 学期",
+      "created": "创建于 {date}"
     },
     "detail": {
-      "title": "课程计划详情",
-      "notFound": "未找到课程计划，可能已被删除",
-      "backToList": "返回列表",
-      "createdAtPrefix": "创建于 {date}",
-      "mswNotice": "详情查询契约待补齐（@contract-pending）。",
-      "sectionBasic": "基本信息",
-      "sectionUnits": "单元列表",
-      "noUnits": "暂无单元",
-      "fieldName": "名称",
-      "fieldGradeId": "年级 ID",
-      "fieldSubjectId": "科目 ID",
-      "fieldSemester": "学期",
-      "fieldStatus": "状态",
-      "fieldProgress": "总体进度",
-      "fieldDescription": "描述",
-      "noDescription": "暂无描述",
-      "fieldObjectives": "教学目标",
-      "noObjectives": "暂无目标",
-      "fieldCreatedAt": "创建时间",
-      "fieldUpdatedAt": "更新时间",
-      "colUnitOrder": "序号",
-      "colUnitTitle": "单元标题",
-      "colUnitProgress": "进度",
-      "colUnitStatus": "状态"
+      "back": "返回",
+      "heading": "课程计划详情",
+      "edit": "编辑",
+      "delete": "删除",
+      "deleteTitle": "删除课程计划",
+      "deleteDescription": "确定要删除此课程计划吗？此操作不可撤销。",
+      "week": "周次",
+      "topic": "主题",
+      "hours": "课时",
+      "chapter": "教材章节",
+      "statusCol": "状态",
+      "weekPlans": "周计划",
+      "addWeekPlan": "添加周计划",
+      "emptyWeekPlans": "暂无周计划",
+      "emptyWeekPlansCta": "，点击上方按钮添加",
+      "reorderSaved": "排序已保存",
+      "reorderFailed": "排序保存失败",
+      "noClass": "未分配班级",
+      "unknownSubject": "未知学科",
+      "unknownSubjectHeading": "未知学科",
+      "semester": "第 {semester} 学期",
+      "teacher": "教师：{name}",
+      "unassigned": "未分配教师",
+      "created": "创建于 {date}",
+      "startDate": "开始于 {date}",
+      "endDate": "结束于 {date}",
+      "syllabus": "教学大纲",
+      "objectives": "教学目标",
+      "completed": "已完成",
+      "pending": "待完成",
+      "selectWeekAria": "选择第 {week} 周",
+      "viewHomeworkAria": "查看作业",
+      "viewTextbookAria": "查看教材章节 {chapter}",
+      "dragHandle": "拖拽排序",
+      "notes": "备注：{notes}"
+    },
+    "progress": {
+      "label": "进度",
+      "hours": "{completed}/{total} 课时 · {percent}%",
+      "weekPlansCompleted": "{completed}/{total} 周计划已完成"
+    },
+    "status": {
+      "planning": "规划中",
+      "active": "进行中",
+      "completed": "已完成",
+      "paused": "已暂停"
+    },
+    "filter": {
+      "placeholder": "按状态筛选",
+      "all": "全部状态"
+    },
+    "calendar": {
+      "title": "教学日历",
+      "weekShort": [
+        "一",
+        "二",
+        "三",
+        "四",
+        "五",
+        "六",
+        "日"
+      ],
+      "monthTitle": "{year} 年 {month} 月",
+      "prevMonth": "上一月",
+      "nextMonth": "下一月",
+      "today": "今天",
+      "week": "第 {week} 周",
+      "hours": "{hours} 课时",
+      "completed": "已完成",
+      "pending": "待完成",
+      "noStartDate": "课程计划未设置起始日期，无法显示日历视图",
+      "noPlans": "本月无教学计划"
+    },
+    "form": {
+      "new": "新建课程计划",
+      "edit": "编辑课程计划",
+      "class": "班级",
+      "selectClass": "选择班级",
+      "subject": "学科",
+      "selectSubject": "选择学科",
+      "teacher": "教师",
+      "selectTeacher": "选择教师",
+      "academicYear": "学年",
+      "optional": "可选",
+      "semester": "学期",
+      "semester1": "第一学期",
+      "semester2": "第二学期",
+      "status": "状态",
+      "selectStatus": "选择状态",
+      "totalHours": "总课时",
+      "weeklyHours": "周课时",
+      "startDate": "开始日期",
+      "endDate": "结束日期",
+      "syllabus": "教学大纲",
+      "syllabusPlaceholder": "教学大纲与范围...",
+      "objectives": "教学目标",
+      "objectivesPlaceholder": "教学目标与预期成果...",
+      "cancel": "取消",
+      "create": "创建",
+      "save": "保存",
+      "saving": "保存中...",
+      "invalidState": "表单状态无效",
+      "saveFailed": "保存失败"
+    },
+    "templates": {
+      "title": "从模板创建",
+      "createFromTemplate": "从现有计划复制",
+      "searchPlaceholder": "搜索班级、学科或教师...",
+      "empty": "无可用模板",
+      "cancel": "取消",
+      "confirm": "复制",
+      "cloning": "复制中...",
+      "cloneSuccess": "已从模板创建新计划",
+      "cloneFailed": "复制失败"
+    },
+    "export": {
+      "csv": "导出 CSV",
+      "filename": "{subject}_{className}_课程计划",
+      "content": "教学内容",
+      "notes": "备注",
+      "exported": "已导出",
+      "exportFailed": "导出失败"
+    },
+    "toast": {
+      "deleted": "课程计划已删除",
+      "deleteFailed": "删除失败",
+      "bulkMarked": "已批量标记 {count} 条",
+      "bulkFailed": "批量操作失败"
+    },
+    "bulk": {
+      "markComplete": "批量标记完成"
+    },
+    "loading": {
+      "title": "加载中..."
+    },
+    "item": {
+      "addTitle": "新建周计划",
+      "editTitle": "编辑周计划",
+      "week": "周次",
+      "hours": "课时",
+      "topic": "主题",
+      "topicPlaceholder": "请输入本周主题",
+      "content": "内容",
+      "contentPlaceholder": "请输入本周教学内容",
+      "chapter": "教材章节",
+      "chapterPlaceholder": "如：第3章",
+      "completedAt": "完成日期",
+      "notes": "备注",
+      "notesPlaceholder": "可选备注信息",
+      "cancel": "取消",
+      "save": "保存",
+      "saving": "保存中...",
+      "delete": "删除",
+      "markComplete": "标记完成",
+      "markIncomplete": "取消完成",
+      "invalidState": "表单状态无效",
+      "saveFailed": "保存失败",
+      "deleteFailed": "删除失败",
+      "updateFailed": "更新失败",
+      "createSuccess": "周计划已创建",
+      "updateSuccess": "周计划已更新",
+      "deleteSuccess": "周计划已删除",
+      "toggleSuccess": "完成状态已更新"
     },
     "error": {
       "title": "课程计划模块出错了",
@@ -1441,11 +2727,458 @@
     "error": {
       "title": "诊断报告页面出错了",
       "unknown": "诊断报告模块发生未知错误",
-      "retry": "重试"
+      "retry": "重试",
+      "generateClassFailed": "生成班级诊断报告失败",
+      "loadFailed": "数据加载失败"
+    },
+    "classDiagnostic": {
+      "noClassDataTitle": "暂无班级诊断数据",
+      "heatmapDescription": "颜色越深表示掌握度越低，可点击单元格查看明细",
+      "heatmapAriaLabel": "知识点掌握度热力图，共 {count} 个知识点",
+      "heatmapCellAriaLabel": "{name}：{level}%，{label}，已掌握 {mastered} 人 / 共 {total} 人",
+      "masteryLevelExcellent": "优秀",
+      "masteryLevelGood": "良好",
+      "masteryLevelNeedsImprovement": "待提升",
+      "masteryLevelWeak": "薄弱",
+      "legendLabel": "图例：",
+      "filterByKpTitle": "按知识点筛选学生",
+      "filterByKpDescription": "选择知识点查看该知识点上所有学生的掌握度",
+      "kpFilterLabel": "知识点",
+      "kpFilterPlaceholder": "请选择知识点",
+      "kpFilterAll": "全部知识点",
+      "filtering": "正在筛选...",
+      "avgMasteryColumn": "平均掌握度",
+      "totalQuestionsColumn": "总题数",
+      "correctQuestionsColumn": "答对题数",
+      "statusColumn": "状态",
+      "needsAttention": "需关注",
+      "mastered": "已掌握",
+      "viewAriaLabel": "查看 {studentName} 的诊断详情",
+      "viewAction": "查看",
+      "noStudentsForKp": "该知识点下暂无学生数据",
+      "knowledgePointColumn": "知识点",
+      "masteredColumn": "已掌握人数",
+      "notMasteredColumn": "未掌握人数",
+      "noRankingData": "暂无排名数据",
+      "studentsNeedingAttentionTitle": "需重点关注的学生",
+      "studentsNeedingAttentionDescription": "掌握度低于阈值的学生列表",
+      "allStudentsAboveThreshold": "所有学生掌握度均达到阈值",
+      "weakPointsColumn": "薄弱知识点数",
+      "generateDescription": "选择周期并生成班级诊断报告",
+      "periodLabel": "周期",
+      "generating": "生成中...",
+      "generateButton": "生成报告"
+    },
+    "empty": {
+      "noClassData": "尚未分配班级或班级暂无诊断数据",
+      "noData": "暂无诊断数据"
+    },
+    "summary": {
+      "class": "班级",
+      "students": "学生数",
+      "avgMastery": "平均掌握度",
+      "needAttention": "需关注",
+      "student": "学生",
+      "overallMastery": "总体掌握度",
+      "strengths": "强项",
+      "weaknesses": "弱项"
+    },
+    "chart": {
+      "heatmapTitle": "知识点掌握度热力图",
+      "rankingTitle": "知识点掌握度排名",
+      "radarTitle": "知识点掌握度雷达图",
+      "radarDescriptionNonEmpty": "学生分数与班级平均对比",
+      "radarEmptyTitle": "暂无掌握度数据",
+      "radarAriaLabelEmpty": "雷达图为空，学生暂无掌握度数据",
+      "radarAriaLabelNonEmpty": "雷达图，共 {count} 个知识点{withClassAverage}",
+      "withClassAverage": "（含班级平均）",
+      "studentSeries": "学生",
+      "classAvgSeries": "班级平均",
+      "noMasteryDataForStudent": "该学生暂无掌握度数据"
+    },
+    "strengths": {
+      "title": "强项知识点"
+    },
+    "weaknesses": {
+      "title": "薄弱知识点",
+      "practice": "练习"
+    },
+    "status": {
+      "draft": "草稿",
+      "published": "已发布",
+      "archived": "已归档"
+    },
+    "type": {
+      "individual": "个人",
+      "class": "班级",
+      "grade": "年级"
+    },
+    "report": {
+      "generateClass": "生成班级诊断报告",
+      "recommendations": "学习建议",
+      "history": "历史报告"
+    },
+    "reportList": {
+      "actionsColumn": "操作",
+      "allStatuses": "全部状态",
+      "allTypes": "全部类型",
+      "cancel": "取消",
+      "caption": "诊断报告列表",
+      "classReportPlaceholder": "班级报告",
+      "confidenceColumn": "置信度",
+      "confidenceHigh": "高置信度",
+      "confidenceInsufficient": "数据不足",
+      "confidenceLow": "低置信度",
+      "confidenceMedium": "中置信度",
+      "confidenceHighHint": "数据样本充足，结论可信度高",
+      "confidenceMediumHint": "数据样本一般，结论仅供参考",
+      "confidenceLowHint": "数据样本不足，建议补充数据后复查",
+      "confidenceAriaLabel": "置信度：{level}",
+      "dateColumn": "生成时间",
+      "deleteAction": "删除",
+      "deleteConfirmation": "确认删除该诊断报告？此操作不可撤销。",
+      "deleteSuccess": "诊断报告已删除",
+      "deleteTitle": "删除报告",
+      "deleting": "删除中...",
+      "emptyNoReports": "暂无诊断报告",
+      "exportAction": "导出",
+      "exportPending": "导出契约未就绪（@contract-pending），稍后通过 GraphQL 接入",
+      "filterReportType": "按类型筛选",
+      "filterStatus": "按状态筛选",
+      "generatedByColumn": "生成人",
+      "gradeReportPlaceholder": "年级报告",
+      "noReportsDescription": "学生完成作业或考试后，诊断报告会显示在这里",
+      "periodColumn": "周期",
+      "publishAction": "发布",
+      "publishConfirmation": "确认发布该诊断报告？发布后将对相关用户可见。",
+      "publishing": "发布中...",
+      "publishSuccess": "诊断报告已发布",
+      "publishTitle": "发布报告",
+      "reportType": "报告类型",
+      "scoreColumn": "分数",
+      "status": "状态",
+      "statusColumn": "状态",
+      "studentTargetColumn": "对象",
+      "typeColumn": "类型"
+    },
+    "studentDiagnostic": {
+      "noDataDescription": "该学生暂无诊断数据，请先完成相关作业或考试",
+      "strengthsDescription": "掌握度 ≥ 80% 的知识点",
+      "noStrengths": "暂无强项知识点",
+      "strengthsListAriaLabel": "强项知识点列表",
+      "weaknessesDescription": "掌握度 < 80% 的知识点，可点击练习强化",
+      "noWeaknesses": "暂无薄弱知识点",
+      "weaknessesListAriaLabel": "薄弱知识点列表",
+      "practiceAriaLabel": "练习知识点 {name}",
+      "diagnosticReportTitle": "诊断报告",
+      "reportMeta": "周期：{period} · 分数：{score}",
+      "recommendationsListAriaLabel": "学习建议列表",
+      "historyDescription": "历史诊断报告列表",
+      "untitledPeriod": "未命名周期",
+      "historyReportMeta": "生成于 {date} · 分数：{score}"
     }
   },
   "errorBook": {
     "title": "错题本",
+    "description": "自动收录考试与作业中的错题，科学复习，攻克薄弱点",
+    "stats": {
+      "total": "错题总数",
+      "new": "待学习",
+      "learning": "学习中",
+      "mastered": "已掌握",
+      "dueReview": "待复习",
+      "masteredRate": "掌握率",
+      "totalDesc": "累计收录的错题",
+      "newDesc": "尚未开始复习",
+      "learningDesc": "正在复习掌握",
+      "masteredDesc": "掌握率 {rate}%",
+      "dueReviewDesc": "今日到期复习",
+      "totalErrorQuestions": "错题总数",
+      "totalErrorCount": "错误次数",
+      "recent7dErrors": "近 7 天错误",
+      "knowledgePointCount": "知识点数"
+    },
+    "status": {
+      "new": "待学习",
+      "learning": "学习中",
+      "mastered": "已掌握",
+      "archived": "已归档"
+    },
+    "source": {
+      "exam": "考试",
+      "homework": "作业",
+      "manual": "手动添加"
+    },
+    "review": {
+      "again": "重来",
+      "hard": "困难",
+      "good": "良好",
+      "easy": "简单",
+      "againDesc": "完全不会，明天再复习",
+      "hardDesc": "勉强答对，2 天后复习",
+      "goodDesc": "正常答对，4 天后复习",
+      "easyDesc": "轻松答对，7 天后复习"
+    },
+    "actions": {
+      "add": "手动添加",
+      "viewDetail": "查看详情",
+      "saveNote": "保存笔记",
+      "archive": "归档",
+      "delete": "删除",
+      "collect": "采集错题",
+      "cancel": "取消",
+      "adding": "添加中..."
+    },
+    "fields": {
+      "question": "选择题目",
+      "note": "学习笔记",
+      "errorTags": "错误原因标签",
+      "masteryLevel": "掌握度",
+      "reviewCount": "复习次数",
+      "nextReview": "下次复习",
+      "createdAt": "添加时间",
+      "student": "学生",
+      "className": "班级"
+    },
+    "masteryLevel": {
+      "0": "未学习",
+      "1": "入门",
+      "2": "了解",
+      "3": "熟悉",
+      "4": "熟练",
+      "5": "掌握"
+    },
+    "questionType": {
+      "single_choice": "单选",
+      "multiple_choice": "多选",
+      "judgment": "判断",
+      "text": "简答",
+      "composite": "复合"
+    },
+    "errorTags": {
+      "concept": "概念不清",
+      "calculation": "计算错误",
+      "careless": "粗心大意",
+      "misread": "审题不清",
+      "method": "方法不当",
+      "memory": "记忆错误",
+      "time": "时间不足"
+    },
+    "itemCard": {
+      "questionDeleted": "题目已删除",
+      "questionContent": "题目内容",
+      "difficulty": "难度 {level}",
+      "mastery": "掌握度: {level}",
+      "reviewTimes": "复习 {count} 次",
+      "needReview": "需复习",
+      "nextReview": "下次 {date}",
+      "addedAt": "添加于 {date}",
+      "masteryOutOf": "掌握度: {level}/5"
+    },
+    "detailDialog": {
+      "question": "题目",
+      "myAnswer": "我的答案",
+      "correctAnswer": "正确答案",
+      "aiAnalysis": "AI 智能分析",
+      "reviewSelf": "复习自评",
+      "studyNote": "学习笔记",
+      "notePlaceholder": "记录你的反思、解题思路、易错点...",
+      "errorTagsLabel": "错误原因标签",
+      "reviewHistory": "复习历史",
+      "questionDeleted": "题目已删除",
+      "variantPractice": "错题变式练习",
+      "variantPracticeDesc": "从当前错题出发，进行针对性练习"
+    },
+    "filters": {
+      "searchPlaceholder": "搜索笔记内容...",
+      "status": "状态",
+      "source": "来源",
+      "review": "复习",
+      "allStatus": "全部状态",
+      "allSource": "全部来源",
+      "allErrors": "全部错题",
+      "dueOnly": "仅看待复习"
+    },
+    "addDialog": {
+      "title": "添加错题",
+      "description": "从题库中选择题目，添加到你的错题本。你也可以在完成作业/考试后自动采集。",
+      "selectQuestion": "选择题目",
+      "selectPlaceholder": "从题库中选择...",
+      "noteLabel": "学习笔记（可选）",
+      "notePlaceholder": "记录错误原因、解题思路...",
+      "errorTagsLabel": "错误原因标签",
+      "questionPreview": "题目"
+    },
+    "empty": {
+      "title": "错题本为空",
+      "description": "完成考试或作业后，错题会自动收录到这里。你也可以手动添加错题。"
+    },
+    "teacher": {
+      "title": "错题分析",
+      "description": "按学科、班级查看学生的错题统计与薄弱知识点，辅助精准教学",
+      "descriptionShort": "按学科、班级查看学生的错题统计与薄弱知识点。",
+      "coverage": "覆盖学生",
+      "totalErrors": "错题总数",
+      "avgMastery": "平均掌握率",
+      "weakPoints": "薄弱知识点",
+      "subjectDist": "学科错题分布",
+      "studentDetail": "学生错题详情",
+      "topWrong": "高频错题",
+      "noClass": "暂无可查看的班级",
+      "noClassDesc": "您还未被分配到任何班级，无法查看错题分析数据。",
+      "noStudent": "班级暂无学生",
+      "noStudentDesc": "班级中没有学生，无法查看错题分析数据。",
+      "noChapterDataTitle": "暂无章节错题数据",
+      "noChapterDataDesc": "尚未关联知识点到章节，无法显示章节维度统计。",
+      "noKpDataTitle": "暂无知识点数据",
+      "noKpDataDesc": "错题尚未关联知识点，无法显示薄弱知识点统计。",
+      "noStudentErrorsTitle": "暂无学生错题",
+      "noStudentErrorsDesc": "所选范围内没有学生错题数据。",
+      "studentsCount": "共 {total} 名学生，{withErrors} 名有错题"
+    },
+    "parent": {
+      "title": "子女错题本",
+      "description": "查看子女的错题情况与学习进度",
+      "noChild": "暂无子女关联",
+      "noChildDesc": "您的账号尚未关联子女，请联系学校管理员进行关联。",
+      "unknown": "未知",
+      "totalErrors": "错题总数",
+      "dueReview": "待复习",
+      "newItems": "待学习",
+      "mastered": "已掌握",
+      "mastery": "{rate}% 掌握",
+      "weakPoints": "薄弱知识点",
+      "errorsAndMastery": "{count} 错 · {rate}% 掌握"
+    },
+    "admin": {
+      "title": "全校错题分析",
+      "description": "全校错题统计与薄弱知识点分析，辅助教学决策",
+      "description2": "按学科查看全校学生的错题统计与薄弱知识点。",
+      "noPermissionTitle": "权限不足",
+      "noPermissionDescription": "您没有权限查看全校错题分析数据。",
+      "noStudentsTitle": "暂无学生数据",
+      "noStudentsDescription": "系统中还没有学生用户，无法查看错题分析。",
+      "topStudents": "错题最多的学生 Top 50",
+      "studentsWithErrors": "共 {count} 名学生有错题",
+      "noChapterDataTitle": "暂无章节错题数据",
+      "noChapterDataDescription": "尚未关联知识点到章节，无法显示章节维度统计。",
+      "noKnowledgePointDataTitle": "暂无知识点数据",
+      "noKnowledgePointDataDescription": "错题尚未关联知识点，无法显示薄弱知识点统计。",
+      "noStudentErrorsTitle": "暂无学生错题",
+      "noStudentErrorsDescription": "所选学科下没有学生错题数据。"
+    },
+    "analyticsStats": {
+      "coverage": "覆盖学生",
+      "coverageSub": "/ {total} 人",
+      "totalErrors": "错题总数",
+      "totalErrorsSub": "人均 {avg} 题",
+      "avgMastery": "平均掌握率",
+      "avgMasteryGood": "整体良好",
+      "avgMasteryNeedImprove": "需加强",
+      "dueReview": "待复习",
+      "dueReviewNeedAttention": "需要关注",
+      "dueReviewNone": "无到期",
+      "knowledgePoints": "涉及知识点",
+      "knowledgePointsWide": "范围较广",
+      "knowledgePointsFocused": "集中"
+    },
+    "subjectTabs": {
+      "all": "全部学科",
+      "dueReview": "待复习 {count}"
+    },
+    "classFilter": {
+      "all": "全部班级",
+      "errorCount": "{count} 错题",
+      "dueReview": "{count} 待复习"
+    },
+    "topWrong": {
+      "title": "高频错题",
+      "topTitle": "高频错题 Top 10",
+      "emptyTitle": "暂无高频错题",
+      "emptyDesc": "学生完成作业或考试后，错频统计会显示在这里。",
+      "errorCount": "{count} 人错",
+      "masteredCount": "{count} 人已掌握",
+      "masteryRate": "掌握率 {rate}%"
+    },
+    "weaknessChart": {
+      "title": "薄弱知识点 Top {count}",
+      "errorCount": "错题数",
+      "chapterLabel": "所属章节：{title}",
+      "masteredLabel": "已掌握",
+      "masteryRateLabel": "掌握率",
+      "unclassified": "未分类"
+    },
+    "chapterChart": {
+      "title": "章节错题分布（哪些课在错）",
+      "errorCount": "错题数",
+      "masteredLabel": "已掌握",
+      "masteryRateLabel": "掌握率",
+      "knowledgePointCount": "知识点数",
+      "weakKpsLabel": "薄弱知识点：",
+      "knowledgePointBadge": "{count} 个知识点"
+    },
+    "classErrorBar": {
+      "title": "各班级错题数对比",
+      "errorCount": "错题总数",
+      "studentCount": "学生数",
+      "avgPerStudent": "人均错题",
+      "avgMastery": "平均掌握率",
+      "dueReview": "待复习"
+    },
+    "subjectDistChart": {
+      "title": "各学科错题分布",
+      "errorCount": "错题数",
+      "masteredLabel": "已掌握",
+      "masteryRateLabel": "掌握率"
+    },
+    "groupedTable": {
+      "unclassified": "未分班",
+      "studentCount": "{count} 人",
+      "studentsWithErrors": "{count} 人有错题",
+      "totalErrors": "错题总数",
+      "avgMastery": "平均掌握率",
+      "student": "学生",
+      "new": "待学习",
+      "learning": "学习中",
+      "mastered": "已掌握",
+      "dueReview": "待复习",
+      "masteryRate": "掌握率",
+      "unknown": "未知"
+    },
+    "classOverview": {
+      "coverage": "覆盖学生",
+      "coverageDesc": "有错题记录的学生数",
+      "totalErrors": "错题总数",
+      "totalErrorsDesc": "班级累计错题",
+      "avgMastery": "平均掌握率",
+      "avgMasteryDesc": "已掌握错题占比",
+      "weakPoints": "薄弱知识点",
+      "weakPointsDesc": "需重点讲解",
+      "weakPointsTitle": "薄弱知识点 Top 10",
+      "subjectDist": "学科错题分布",
+      "noData": "暂无数据",
+      "errorsAndMastery": "{count} 错 · {rate}% 掌握",
+      "noStudentData": "暂无学生错题数据",
+      "noStudentDataDesc": "学生完成作业或考试后，错题数据会自动汇总到这里。"
+    },
+    "messages": {
+      "added": "错题已添加",
+      "noteSaved": "笔记已保存",
+      "reviewRecorded": "复习结果已记录",
+      "archived": "错题已归档",
+      "deleted": "错题已删除",
+      "collected": "已采集 {count} 道错题",
+      "noNewErrors": "没有新的错题需要采集",
+      "addFailed": "添加错题失败",
+      "saveFailed": "保存失败",
+      "deleteFailed": "删除失败",
+      "archiveFailed": "归档失败",
+      "collectFailed": "采集错题失败",
+      "notFound": "错题不存在或无权访问",
+      "selectQuestion": "请选择题目",
+      "recordFailed": "记录失败",
+      "addedShort": "已添加"
+    },
     "list": {
       "title": "错题本",
       "description": "查看学生的错题记录与知识点统计",
@@ -1459,12 +3192,6 @@
       "colContent": "内容",
       "noContent": "无内容"
     },
-    "stats": {
-      "totalErrorQuestions": "错题总数",
-      "totalErrorCount": "错误次数",
-      "recent7dErrors": "近 7 天错误",
-      "knowledgePointCount": "知识点数"
-    },
     "error": {
       "title": "错题本页面出错了",
       "unknown": "错题本模块发生未知错误",
@@ -1473,6 +3200,19 @@
   },
   "practice": {
     "title": "练习分析",
+    "tabs": {
+      "assignments": "练习与作业",
+      "adaptive": "自适应练习"
+    },
+    "adaptive": {
+      "description": "选择知识点与题型，发起一次针对性自适应练习；下方为本人的练习历史。",
+      "starterSection": "发起练习",
+      "historySection": "练习历史",
+      "knowledgePointsLoading": "知识点加载中...",
+      "knowledgePointsEmpty": "暂无知识点，无法发起练习",
+      "historyLoading": "练习历史加载中...",
+      "historyError": "练习历史加载失败"
+    },
     "list": {
       "title": "练习分析",
       "description": "查看和管理所有练习与作业",
@@ -1504,6 +3244,92 @@
       "title": "练习分析页面出错了",
       "unknown": "练习分析模块发生未知错误",
       "retry": "重试"
+    },
+    "starter": {
+      "title": "发起专项练习",
+      "description": "选择知识点与题型，开始一次针对性练习",
+      "type": "练习类型",
+      "knowledgePoints": "知识点",
+      "difficulty": "难度",
+      "anyDifficulty": "不限难度",
+      "questionCount": "题目数量",
+      "start": "开始练习",
+      "creating": "创建中..."
+    },
+    "types": {
+      "error_variant": "错题变式",
+      "knowledge_point": "知识点专项",
+      "weak_chapter": "薄弱章节",
+      "ai_recommended": "AI 推荐"
+    },
+    "status": {
+      "in_progress": "进行中",
+      "completed": "已完成",
+      "abandoned": "已放弃"
+    },
+    "toasts": {
+      "created": "练习会话已创建",
+      "createFailed": "创建练习会话失败",
+      "selectKnowledgePoint": "请至少选择一个知识点",
+      "selectWeakKnowledgePoint": "请至少选择一个薄弱知识点",
+      "submitted": "答案已提交",
+      "submitFailed": "提交答案失败",
+      "completed": "练习已完成",
+      "completeFailed": "完成练习失败",
+      "abandoned": "练习已放弃",
+      "abandonFailed": "放弃练习失败"
+    },
+    "errors": {
+      "SESSION_NOT_FOUND": "练习会话不存在",
+      "SESSION_NOT_IN_PROGRESS": "练习会话不在进行中",
+      "ANSWER_NOT_FOUND": "答题记录不存在",
+      "QUESTION_NOT_FOUND": "题目不存在",
+      "INSUFFICIENT_QUESTIONS": "题目数量不足",
+      "INVALID_INPUT": "输入参数不合法",
+      "UNAUTHORIZED": "无权操作此练习会话"
+    },
+    "session": {
+      "progress": "进度",
+      "previous": "上一题",
+      "next": "下一题",
+      "abandon": "放弃",
+      "abandonConfirm": "确认放弃练习？",
+      "abandonDescription": "放弃后已答内容将保留，但不能再继续答题。",
+      "cancel": "取消",
+      "confirmAbandon": "确认放弃",
+      "complete": "完成练习",
+      "empty": "本次练习暂无题目",
+      "question": "题目",
+      "difficulty": "难度",
+      "variant": "变式",
+      "skip": "跳过",
+      "retry": "重试",
+      "submit": "提交",
+      "submitting": "提交中...",
+      "submitFailedDescription": "提交失败，请重试或检查网络连接。",
+      "true": "正确",
+      "false": "错误",
+      "textPlaceholder": "请输入答案...",
+      "correct": "回答正确",
+      "incorrect": "回答错误",
+      "pendingReview": "待批阅",
+      "skipped": "已跳过",
+      "yourAnswer": "你的答案"
+    },
+    "result": {
+      "title": "练习结果",
+      "answered": "已答题数",
+      "correct": "正确数",
+      "accuracy": "正确率",
+      "review": "逐题回顾"
+    },
+    "history": {
+      "empty": "暂无练习历史"
+    },
+    "reasons": {
+      "student_initiated": "学生自主发起",
+      "teacher_assigned": "教师布置",
+      "parent_suggested": "家长建议"
     }
   },
   "elective": {
@@ -1528,7 +3354,11 @@
       "colUpdatedAt": "更新时间",
       "colActions": "操作",
       "edit": "编辑",
-      "mswNotice": "列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      "mswNotice": "列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+      "adminList": "门选修课",
+      "empty": "暂无选修课",
+      "emptyDescription": "点击新建按钮创建第一门选修课",
+      "emptyStudent": "暂无可选课程"
     },
     "create": {
       "title": "新建选修课",
@@ -1572,6 +3402,118 @@
       "title": "选修课模块出错了",
       "unknown": "选修课模块发生未知错误",
       "retry": "重试"
+    },
+    "errors": {
+      "unexpected": "发生未知错误，请稍后重试",
+      "notFound": "未找到课程"
+    },
+    "actions": {
+      "create": "新建",
+      "edit": "编辑",
+      "delete": "删除",
+      "openSelection": "开放选课",
+      "closeSelection": "关闭选课",
+      "runLottery": "运行抽签",
+      "select": "选课",
+      "drop": "退课",
+      "cancel": "取消"
+    },
+    "fields": {
+      "credit": "学分",
+      "teacher": "任课老师",
+      "selectionMode": "选课模式",
+      "capacity": "容量",
+      "classroom": "教室",
+      "schedule": "上课时间",
+      "subject": "科目",
+      "grade": "年级",
+      "startDate": "开始日期",
+      "endDate": "结束日期",
+      "selectionStart": "选课开始",
+      "selectionEnd": "选课结束",
+      "description": "描述",
+      "enrolled": "已报名",
+      "dropReason": "退课理由"
+    },
+    "status": {
+      "draft": "草稿",
+      "open": "报名中",
+      "closed": "已关闭",
+      "cancelled": "已取消"
+    },
+    "selectionMode": {
+      "fcfs": "先到先得",
+      "lottery": "抽签"
+    },
+    "selectionStatus": {
+      "selected": "已选",
+      "enrolled": "已录取",
+      "waitlist": "候补",
+      "dropped": "已退",
+      "rejected": "已拒绝"
+    },
+    "student": {
+      "capacityFull": "已满",
+      "mySelections": "我的选课",
+      "availableCourses": "可选课程",
+      "selected": "已选",
+      "selectSuccess": "选课成功",
+      "dropSuccess": "退课成功",
+      "confirmDrop": "确认退课？",
+      "dropReasonPlaceholder": "请输入退课理由（可选）"
+    },
+    "parent": {
+      "noRecordsTitle": "暂无选课记录",
+      "noRecordsDescription": "该学生尚未选课"
+    },
+    "description": {
+      "detail": "选修课详情",
+      "student": "选修课选课"
+    },
+    "detail": {
+      "back": "返回",
+      "editCourse": "编辑课程",
+      "studentsTitle": "选课名单",
+      "noStudents": "暂无学生",
+      "noStudentsDescription": "暂无学生选课",
+      "studentName": "学生",
+      "priority": "优先级",
+      "selectedAt": "选课时间",
+      "enrolledAt": "录取时间"
+    },
+    "export": {
+      "statusHeader": "状态",
+      "selectedAtHeader": "选课时间"
+    },
+    "form": {
+      "createTitle": "新建选修课",
+      "editTitle": "编辑选修课",
+      "nameLabel": "名称",
+      "subjectLabel": "科目",
+      "selectSubjectPlaceholder": "选择科目",
+      "gradeLabel": "年级",
+      "selectGradePlaceholder": "选择年级",
+      "teacherLabel": "任课老师",
+      "selectTeacherPlaceholder": "选择老师",
+      "capacityLabel": "容量",
+      "classroomLabel": "教室",
+      "scheduleLabel": "上课时间",
+      "schedulePlaceholder": "例如：周一 3-4 节",
+      "creditLabel": "学分",
+      "startDateLabel": "开始日期",
+      "endDateLabel": "结束日期",
+      "selectionStartLabel": "选课开始时间",
+      "selectionEndLabel": "选课结束时间",
+      "dropDeadlineLabel": "退课截止时间",
+      "dropDeadlineHint": "超过此时间后学生无法退课，留空表示不限制",
+      "descriptionLabel": "描述",
+      "descriptionPlaceholder": "课程简介、适用人群等",
+      "cancelButton": "取消",
+      "createButton": "创建",
+      "saveButton": "保存",
+      "savingButton": "保存中...",
+      "invalidFormState": "表单状态无效",
+      "saveFailed": "保存失败"
     }
   },
   "leave": {
@@ -1634,6 +3576,7 @@
       "emptyTitle": "暂无调课申请",
       "emptyDescription": "调整筛选条件后重试，或发起第一条申请",
       "emptyAction": "清空筛选",
+      "createAction": "发起调课",
       "mswNotice": "调课列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
       "colSummary": "摘要",
       "colClassName": "班级",
@@ -1643,7 +3586,134 @@
       "colReason": "事由",
       "colStatus": "状态",
       "colApplicant": "申请人",
-      "colCreatedAt": "创建时间"
+      "colCreatedAt": "创建时间",
+      "colActions": "操作"
+    },
+    "form": {
+      "title": "调课申请",
+      "dialogTitle": "发起调课申请",
+      "dialogDescription": "填写表单发起调课、停课、代课或合课申请",
+      "classLabel": "班级",
+      "classPlaceholder": "选择班级",
+      "typeLabel": "调课类型",
+      "typeReschedule": "调课",
+      "typeCancel": "停课",
+      "typeSubstitute": "代课",
+      "typeMerge": "合课",
+      "originalLessonLabel": "原课程",
+      "originalLessonPlaceholder": "请输入原课程名称",
+      "originalTeacherLabel": "原任课教师",
+      "originalTeacherPlaceholder": "选择原任课教师",
+      "substituteTeacherLabel": "代课教师",
+      "substituteTeacherPlaceholder": "选择代课教师",
+      "originalDateLabel": "原日期",
+      "newDateLabel": "新日期",
+      "newStartLabel": "新开始时间",
+      "newEndLabel": "新结束时间",
+      "reasonLabel": "事由",
+      "reasonPlaceholder": "请说明调课原因...",
+      "cancel": "取消",
+      "submit": "提交申请",
+      "submitting": "提交中...",
+      "createSuccess": "调课申请提交成功",
+      "errors": {
+        "classRequired": "请选择班级",
+        "originalLessonRequired": "请输入原课程",
+        "reasonRequired": "请填写事由",
+        "submitFailed": "提交失败"
+      }
+    },
+    "review": {
+      "approve": "批准",
+      "reject": "驳回",
+      "approveTitle": "批准调课申请",
+      "rejectTitle": "驳回调课申请",
+      "approveDescription": "确认要批准此调课申请吗？",
+      "rejectDescription": "请提供驳回原因（可选）",
+      "commentLabel": "审批意见",
+      "commentPlaceholder": "请输入审批意见...",
+      "commentRequired": "驳回时审批意见必填",
+      "cancel": "取消",
+      "stubSuccess": "审批已处理（stub）",
+      "errors": {
+        "submitFailed": "审批失败"
+      }
+    },
+    "grid": {
+      "title": "课表网格",
+      "emptyClasses": "暂无可用班级，请先创建班级。",
+      "selectClass": "选择班级",
+      "periodColumn": "节次",
+      "periodLabel": "第 {n} 节",
+      "legend": "图例"
+    },
+    "conflicts": {
+      "title": "冲突检测",
+      "classLabel": "班级",
+      "classPlaceholder": "选择班级",
+      "checkButton": "检测冲突",
+      "checking": "检测中...",
+      "resultsTitle": "检测结果",
+      "conflictCount": "{count} 个冲突",
+      "noConflicts": "未检测到冲突",
+      "typeTeacherOverlap": "教师冲突",
+      "typeClassroomOverlap": "教室冲突",
+      "typeClassOverlap": "班级冲突",
+      "typeRuleViolation": "规则违反",
+      "errors": {
+        "classRequired": "请选择班级",
+        "checkFailed": "检测失败"
+      }
+    },
+    "rules": {
+      "title": "排课规则",
+      "classLabel": "班级",
+      "classPlaceholder": "选择班级",
+      "maxDailyHours": "每日最大课时",
+      "maxContinuousHours": "最大连续课时",
+      "morningStart": "上午开始",
+      "afternoonEnd": "下午结束",
+      "lunchBreakStart": "午休开始",
+      "lunchBreakEnd": "午休结束",
+      "avoidBackToBack": "避免连续排课",
+      "balancedSubjects": "科目均衡分布",
+      "cancel": "取消",
+      "save": "保存规则",
+      "saving": "保存中...",
+      "errors": {
+        "classRequired": "请选择班级",
+        "saveFailed": "保存失败"
+      }
+    },
+    "auto": {
+      "title": "自动排课",
+      "classLabel": "班级",
+      "classPlaceholder": "选择班级",
+      "previewButton": "预览排课",
+      "previewing": "生成中...",
+      "applyButton": "应用到班级",
+      "applying": "应用中...",
+      "previewSummary": "已生成 {scheduled} 节，{conflicts} 个冲突",
+      "applySuccess": "排课已应用",
+      "errors": {
+        "classRequired": "请选择班级",
+        "previewFailed": "预览失败",
+        "applyFailed": "应用失败"
+      }
+    },
+    "autoResult": {
+      "title": "生成课表",
+      "sessionCount": "{count} 节",
+      "conflictCount": "{count} 个冲突",
+      "noSessions": "未生成任何课程",
+      "colDay": "星期",
+      "colStart": "开始",
+      "colEnd": "结束",
+      "colCourse": "课程",
+      "colLocation": "教室",
+      "conflictsTitle": "冲突与警告",
+      "readyToApply": "未检测到冲突，排课可应用",
+      "unknownDay": "第 {n} 天"
     },
     "error": {
       "title": "调课申请页面出错了",
@@ -1778,7 +3848,64 @@
         "labelScoreValue": "{score} 分",
         "emptyWeakPoints": "暂无薄弱知识点数据",
         "emptyTrends": "暂无趋势数据",
-        "loadFailed": "仪表盘数据加载失败，请稍后重试。"
+        "loadFailed": "仪表盘数据加载失败，请稍后重试。",
+        "statEnrolledClasses": "已加入班级",
+        "descActiveEnrollments": "进行中的课程",
+        "statGraded": "已评分",
+        "descCompletedAssignments": "已完成作业",
+        "statDueSoon": "即将到期",
+        "descNext7Days": "未来 7 天",
+        "statOverdue": "已逾期",
+        "descNeedsAttention": "需要关注",
+        "descOverallPerformance": "整体表现",
+        "descNoGradesYet": "暂无成绩",
+        "descCurrentPosition": "当前位置",
+        "descNoRankingYet": "暂无排名",
+        "sectionUpcomingAssignments": "待办作业",
+        "sectionRecentGrades": "近期成绩",
+        "sectionTodaySchedule": "今日课表",
+        "emptyNoAssignments": "暂无待办作业",
+        "emptyNoAssignmentsDesc": "暂无需要完成的作业",
+        "emptyNoGradedWork": "暂无评分记录",
+        "emptyNoGradedWorkDesc": "暂无已评分的作业",
+        "emptyNoClassesToday": "今日无课程",
+        "emptyNoClassesTodayDesc": "今天没有安排课程",
+        "colTitle": "标题",
+        "colSubject": "学科",
+        "colStatus": "状态",
+        "colDue": "截止时间",
+        "colScore": "得分",
+        "colAction": "操作",
+        "colAssignment": "作业",
+        "colWhen": "时间",
+        "colClass": "班级",
+        "colTime": "时间",
+        "colLocation": "地点",
+        "actionViewAll": "查看全部",
+        "actionViewSchedule": "查看课表",
+        "actionStart": "开始",
+        "actionContinue": "继续",
+        "actionReview": "查看",
+        "badgeInProgress": "进行中",
+        "badgeUpNext": "下一节",
+        "badgeLate": "逾期",
+        "badgeGraded": "已评分",
+        "badgeSubmitted": "已提交",
+        "badgeNotStarted": "未开始",
+        "labelLatest": "最近",
+        "labelPoints": "得分",
+        "labelNoGrades": "暂无成绩",
+        "greetingMorning": "早上好",
+        "greetingNoon": "中午好",
+        "greetingAfternoon": "下午好",
+        "greetingEvening": "晚上好",
+        "greetingNight": "夜深了",
+        "greetingWithName": "{greeting}，{name}",
+        "sectionGradeTrend": "成绩趋势",
+        "legendScore": "我的成绩",
+        "legendClassAvg": "班级均分",
+        "emptyGradeTrend": "暂无成绩趋势数据",
+        "labelUrgent": "紧急"
       },
       "trend": {
         "title": "学习趋势",
@@ -1809,6 +3936,38 @@
         "practiceNow": "去练习"
       }
     },
+    "diagnostic": {
+      "title": "学生诊断报告",
+      "description": "查看个人学习诊断、知识点掌握分布与历史报告",
+      "statStudentName": "学生姓名",
+      "statOverallMastery": "总体掌握率",
+      "statStrengthCount": "优势学科数",
+      "statWeaknessCount": "弱势学科数",
+      "sectionMasteryRadar": "知识点掌握度分布",
+      "sectionStrengths": "优势知识点",
+      "sectionWeakness": "弱势知识点",
+      "sectionLatestReport": "最新诊断报告",
+      "sectionHistoryReports": "历史报告",
+      "emptyDiagnostic": "暂无诊断数据",
+      "emptyStrengths": "暂无优势知识点",
+      "emptyWeaknessPoints": "暂无弱势知识点",
+      "emptyReports": "暂无历史报告",
+      "colKnowledgePoint": "知识点",
+      "colMastery": "掌握度",
+      "colActions": "操作",
+      "practiceNow": "去练习",
+      "badgePublished": "已发布",
+      "badgeArchived": "已归档",
+      "badgeDraft": "草稿",
+      "badgeGenerated": "已生成",
+      "fieldPeriod": "报告期",
+      "fieldScore": "得分",
+      "fieldSummary": "摘要",
+      "fieldRecommendations": "推荐建议",
+      "confidenceLabel": "置信度",
+      "confidenceTooltip": "置信度反映诊断结论的可信程度，0-1 区间，越高越可信",
+      "mswNotice": "诊断数据契约为 @contract-pending，当前通过 MSW 兜底。后端补齐后将切换为真实数据。"
+    },
     "grades": {
       "list": {
         "title": "我的成绩",
@@ -1818,6 +3977,11 @@
         "allSubjects": "全部学科",
         "typeFilter": "按类型筛选",
         "allTypes": "全部类型",
+        "semesterFilter": "按学期筛选",
+        "allSemesters": "全部学期",
+        "semester1": "第一学期",
+        "semester2": "第二学期",
+        "resetFilters": "重置",
         "total": "共 {count} 条",
         "colSubject": "学科",
         "colType": "类型",
@@ -1829,7 +3993,59 @@
         "colActions": "操作",
         "viewReportCard": "查看报告卡 →",
         "emptyTitle": "暂无成绩记录",
-        "mswNotice": "成绩列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "emptyDescription": "调整筛选条件或等待成绩录入",
+        "mswNotice": "成绩列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "sectionSummary": "成绩汇总",
+        "fieldTotalRecords": "成绩记录数",
+        "fieldAverageScore": "平均得分率",
+        "fieldPassRate": "及格率",
+        "fieldExcellentRate": "优秀率",
+        "sectionTrend": "成绩趋势",
+        "sectionRankingTrend": "排名趋势",
+        "sectionDistribution": "班级分布",
+        "sectionGrowthArchive": "成长档案",
+        "trendEmptyTitle": "暂无趋势数据",
+        "trendEmptyDescription": "至少需要 1 条成绩记录才能绘制趋势",
+        "trendScorePercent": "得分率(%)",
+        "trendClassAverage": "班级平均",
+        "trendRangeAll": "全部",
+        "trendRangeDays7": "近 7 天",
+        "trendRangeDays30": "近 30 天",
+        "trendRangeDays90": "近 90 天",
+        "rankingEmptyTitle": "暂无排名数据",
+        "rankingEmptyDescription": "排名数据待后端契约补齐后展示",
+        "distributionEmptyTitle": "暂无分布数据",
+        "distributionEmptyDescription": "班级分布数据待后端契约补齐后展示",
+        "distributionYourPosition": "你的位置：得分 {score}，位于 {bucket} 段",
+        "growthEmptyTitle": "暂无成长档案",
+        "growthEmptyDescription": "跨学期成长档案数据待后端契约补齐后展示",
+        "rankingLegend": "班级排名（越小越好）",
+        "rankingTotalStudents": "全班 {total} 人",
+        "rankingCurrentRank": "当前第 {rank} 名",
+        "distributionXAxis": "分数段",
+        "distributionYAxis": "人数",
+        "distributionBucketCount": "{count} 人",
+        "distributionStudentPosition": "你在 {bucket} 段，全班第 {rank} 名",
+        "growthArchiveXAxis": "学期",
+        "growthArchiveYAxis": "得分",
+        "growthArchiveSubjectLabel": "学科",
+        "subjects": {
+          "chinese": "语文",
+          "math": "数学",
+          "english": "英语",
+          "physics": "物理",
+          "chemistry": "化学",
+          "biology": "生物",
+          "history": "历史",
+          "geography": "地理",
+          "politics": "政治"
+        },
+        "types": {
+          "exam": "考试",
+          "homework": "作业",
+          "quiz": "测验",
+          "comprehensive": "综合"
+        }
       },
       "reportCard": {
         "title": "成绩报告卡",
@@ -1845,20 +4061,65 @@
         "colScoreRate": "得分率",
         "colLevel": "等级",
         "colTeacherComment": "教师评语",
-        "emptyTitle": "暂无报告卡数据"
+        "emptyTitle": "暂无报告卡数据",
+        "emptyDescription": "请切换学年/学期或等待成绩录入",
+        "schoolName": "学校",
+        "reportCardTitle": "学期成绩报告卡",
+        "periodLabel": "学年 {year} · {semester}",
+        "allSemesters": "全部学期",
+        "studentNameLabel": "学生姓名",
+        "classNameLabel": "所在班级",
+        "generatedAtLabel": "生成时间",
+        "gradesSectionTitle": "各科成绩明细",
+        "summarySectionTitle": "综合统计",
+        "overallAverage": "总平均分",
+        "overallRank": "总排名",
+        "passRate": "及格率",
+        "excellentRate": "优秀率",
+        "commentsTitle": "教师评语",
+        "commentsPlaceholder": "（教师评语待录入）",
+        "signatureClassTeacher": "班主任签名",
+        "signatureParent": "家长签名",
+        "signaturePrincipal": "校长签名",
+        "footerNote": "本报告卡生成于 {date}",
+        "academicYearsCount": "共 {count} 个学年可选",
+        "periodSelectorTitle": "学年/学期切换",
+        "allAcademicYears": "全部学年",
+        "semester1": "第一学期",
+        "semester2": "第二学期",
+        "resetFilters": "重置",
+        "subjectCount": "科目数",
+        "signaturesTitle": "签名区",
+        "summaryRowLabel": "合计",
+        "classTeacherLabel": "班主任",
+        "studentInfoTitle": "学生基本信息",
+        "colAssessment": "评估名称",
+        "colType": "类型",
+        "colRank": "排名",
+        "colRemark": "备注",
+        "typeExam": "考试",
+        "typeHomework": "作业",
+        "typeQuiz": "测验",
+        "subjectAvgLabel": "学科平均",
+        "noRecords": "暂无记录",
+        "preparing": "准备中…",
+        "errorPrint": "打印失败，请重试",
+        "commentsAriaLabel": "教师评语区",
+        "rankFormat": "{rank} / {total}",
+        "classTotalStudentsLabel": "班级人数"
       }
     },
     "exams": {
       "list": {
         "title": "我的考试",
-        "description": "查看即将到来的考试与已结束考试",
+        "description": "按状态查看所有考试，进行中的考试可直接进入作答",
         "statusFilter": "按状态筛选",
         "allStatus": "全部状态",
         "statusUpcoming": "即将开始",
         "statusInProgress": "进行中",
         "statusEnded": "已结束",
         "statusScored": "已出分",
-        "total": "共 {count} 条",
+        "total": "共 {count} 场",
         "colTitle": "考试名称",
         "colSubject": "学科",
         "colExamDate": "考试时间",
@@ -1871,7 +4132,28 @@
         "takeExam": "进入考试 →",
         "viewResult": "查看结果 →",
         "emptyTitle": "暂无考试",
-        "mswNotice": "学生考试列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "学生考试列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "statusNotStarted": "未开始",
+        "statusExpired": "已结束",
+        "subjectFilter": "按学科筛选",
+        "allSubjects": "全部学科",
+        "groupInProgress": "进行中",
+        "groupInProgressDesc": "点击进入作答",
+        "groupUpcoming": "即将开始",
+        "groupUpcomingDesc": "等待开考",
+        "groupSubmitted": "已提交",
+        "groupSubmittedDesc": "等待批改",
+        "groupScored": "已出分",
+        "groupScoredDesc": "查看成绩",
+        "groupEnded": "已结束",
+        "groupEndedDesc": "考试已结束",
+        "countdownStartsIn": "{n} 天后开考",
+        "countdownHoursLeft": "{n} 小时后开考",
+        "countdownStarted": "已开考",
+        "countdownUrgent": "即将开考",
+        "colQuestionCount": "题量",
+        "colTotalScore": "满分",
+        "emptyDesc": "当老师发布考试后，这里会显示考试日程与作答入口"
       },
       "result": {
         "title": "考试结果",
@@ -1883,7 +4165,7 @@
         "fieldTotalScore": "满分",
         "fieldRank": "班级排名",
         "fieldClassAvg": "班级均分",
-        "fieldDuration": "用时",
+        "fieldDuration": "用时（分钟）",
         "colQuestionNo": "题号",
         "colQuestion": "题目",
         "colYourAnswer": "你的答案",
@@ -1894,7 +4176,15 @@
         "colMastery": "掌握度",
         "addToErrorBook": "加入错题本",
         "emptyQuestions": "暂无题目数据",
-        "notFound": "未找到考试结果"
+        "notFound": "未找到考试结果",
+        "sectionStats": "答题统计",
+        "sectionWrongQuestions": "错题预览",
+        "statsTotal": "总题数",
+        "statsCorrect": "答对",
+        "statsWrong": "答错",
+        "statsUnanswered": "未答",
+        "noWrongQuestions": "本次考试无错题",
+        "colQuestionType": "题型"
       },
       "take": {
         "title": "考试作答",
@@ -1908,19 +4198,37 @@
         "unanswered": "未答",
         "marked": "已标记",
         "notFound": "未找到考试或考试已结束",
-        "submitError": "提交失败，请重试"
+        "submitError": "提交失败，请重试",
+        "totalScore": "满分",
+        "back": "返回列表",
+        "submitting": "提交中…",
+        "confirmSubmit": "确认提交",
+        "confirmSubmitDescription": "提交后无法修改，请确认所有题目已检查完毕。",
+        "unansweredWarning": "还有 {count} 题未作答，确定要提交吗？",
+        "confirmSubmitAction": "确认提交",
+        "autoSaveSaving": "正在保存…",
+        "autoSaveIdle": "未保存",
+        "timeUpAutoSubmit": "时间到，已自动提交",
+        "questionUnit": "题",
+        "makeSureAnswered": "提交前请确认所有题目已作答",
+        "questionType": "题型",
+        "score": "分值",
+        "prevQuestion": "上一题",
+        "nextQuestion": "下一题",
+        "jumpToQuestion": "跳转到第 {no} 题"
       }
     },
     "homework": {
       "list": {
         "title": "我的作业",
-        "description": "按学科分组查看作业列表",
+        "description": "按学科分组查看作业，待提交的作业可直接进入提交页面",
         "statusFilter": "按状态筛选",
         "allStatus": "全部状态",
         "statusPending": "待提交",
         "statusSubmitted": "已提交",
         "statusGraded": "已批改",
-        "total": "共 {count} 条",
+        "statusOverdue": "已逾期",
+        "total": "共 {count} 份",
         "colTitle": "作业标题",
         "colSubject": "学科",
         "colDueDate": "截止时间",
@@ -1930,7 +4238,38 @@
         "submitHomework": "去提交 →",
         "viewAnalysis": "查看分析 →",
         "emptyTitle": "暂无作业",
-        "mswNotice": "学生作业列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "学生作业列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "subjectFilter": "按学科筛选",
+        "allSubjects": "全部学科",
+        "searchPlaceholder": "搜索作业标题…",
+        "groupPending": "待提交",
+        "groupPendingDesc": "点击进入提交",
+        "groupOverdue": "已逾期",
+        "groupOverdueDesc": "请尽快提交",
+        "groupSubmitted": "已提交",
+        "groupSubmittedDesc": "等待批改",
+        "groupGraded": "已批改",
+        "groupGradedDesc": "查看得分",
+        "bucketActive": "待处理",
+        "bucketDone": "已完成",
+        "urgent24h": "24h 内截止",
+        "overdueTag": "已逾期",
+        "emptyDesc": "当老师布置作业后，这里会显示作业列表与提交入口",
+        "viewCard": "卡片视图",
+        "viewTable": "表格视图",
+        "attempts": "尝试次数",
+        "attemptsValue": "{used} / {max}",
+        "latestScore": "最新成绩",
+        "actionStart": "开始",
+        "actionContinue": "继续",
+        "actionView": "查看",
+        "actionReview": "复核",
+        "overdueBadge": "已逾期",
+        "groupUnanswered": "未答",
+        "groupAnswered": "已答",
+        "noResults": "未找到匹配的作业",
+        "statusInProgress": "进行中",
+        "statusNotStarted": "未开始"
       },
       "submit": {
         "title": "作业作答",
@@ -1939,7 +4278,39 @@
         "submitSuccess": "作业已提交",
         "autoSaveTip": "答案已自动保存",
         "notFound": "未找到作业或作业已截止",
-        "submitError": "提交失败，请重试"
+        "submitError": "提交失败，请重试",
+        "questionNav": "题目导航",
+        "answerPlaceholder": "请输入答案...",
+        "submitPanelTitle": "提交",
+        "answerProgress": "答题进度",
+        "storageRestoreFailed": "本地暂存数据已损坏，已回退到后端数据",
+        "storageSaveFailed": "本地暂存写入失败，不影响作答",
+        "reviewTitle": "作业复盘",
+        "takeMode": "作答模式",
+        "reviewMode": "只读复盘",
+        "description": "作业说明",
+        "attemptsUsed": "尝试次数",
+        "attemptsValue": "{used} / {max}",
+        "back": "返回列表",
+        "submitting": "提交中…",
+        "confirmSubmit": "确认提交",
+        "confirmSubmitDescription": "提交后无法修改，请确认所有题目已检查完毕。",
+        "unansweredWarning": "还有 {count} 题未作答，确定要提交吗？",
+        "confirmSubmitAction": "确认提交",
+        "autoSaveSaving": "正在保存…",
+        "autoSaveIdle": "未保存",
+        "questionType": "题型",
+        "fieldTitle": "作业标题",
+        "fieldDueDate": "截止时间",
+        "fieldSubmittedAt": "提交时间",
+        "fieldStatus": "状态",
+        "fieldScore": "得分",
+        "fieldTotalScore": "满分",
+        "viewAnalysis": "查看分析",
+        "teacherComment": "教师评语",
+        "noComment": "暂无评语",
+        "questionStem": "题干",
+        "maxAttempts": "最大尝试次数"
       },
       "analysis": {
         "title": "作业分析",
@@ -1954,7 +4325,13 @@
         "colCorrectAnswer": "参考答案",
         "colScore": "得分",
         "colIsCorrect": "对错",
-        "notFound": "未找到作业分析数据"
+        "notFound": "未找到作业分析数据",
+        "sectionStats": "答题统计",
+        "sectionWrongQuestions": "错题预览",
+        "statsTotal": "总题数",
+        "statsCorrect": "答对",
+        "statsWrong": "答错",
+        "noWrongQuestions": "本次作业无错题"
       }
     },
     "schedule": {
@@ -1968,7 +4345,21 @@
       "colClassroom": "教室",
       "colTime": "时间",
       "emptyTitle": "暂无课表数据",
-      "mswNotice": "学生课表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      "mswNotice": "学生课表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+      "weekdays": {
+        "monday": "周一",
+        "tuesday": "周二",
+        "wednesday": "周三",
+        "thursday": "周四",
+        "friday": "周五",
+        "saturday": "周六",
+        "sunday": "周日"
+      },
+      "emptyDescription": "尚未获取到课表数据，请稍后再试或联系管理员",
+      "today": "今天",
+      "noClasses": "今日无课",
+      "noStudentTitle": "未获取到学生身份",
+      "noStudentDesc": "请先登录学生账号或联系管理员补全学生身份信息"
     },
     "attendance": {
       "title": "考勤记录",
@@ -1984,7 +4375,14 @@
       "colStatus": "状态",
       "colRemark": "备注",
       "emptyTitle": "暂无考勤记录",
-      "mswNotice": "学生考勤查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      "mswNotice": "学生考勤查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+      "status": {
+        "present": "出勤",
+        "late": "迟到",
+        "early_leave": "早退",
+        "leave": "请假",
+        "absent": "缺勤"
+      }
     },
     "classes": {
       "title": "我的班级",
@@ -2016,7 +4414,32 @@
         "colActions": "操作",
         "viewDetail": "查看详情 →",
         "emptyTitle": "暂无课程",
-        "mswNotice": "学生课程列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "学生课程列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "viewModeLabel": "视图模式",
+        "viewCard": "卡片视图",
+        "viewTable": "表格视图",
+        "joinClass": "加入班级",
+        "joinClassTitle": "通过邀请码加入班级",
+        "joinClassDescription": "请输入教师提供的 6 位数字邀请码",
+        "joinClassCodeLabel": "邀请码",
+        "joinClassCodePlaceholder": "请输入 6 位数字邀请码",
+        "joinClassCodeHint": "邀请码由 6 位数字组成，可向任课教师索取。",
+        "joinClassSubmit": "加入",
+        "joinClassSubmitting": "加入中...",
+        "joinClassCancel": "取消",
+        "joinClassSuccess": "加入班级成功",
+        "joinClassFailed": "加入失败：{message}",
+        "joinClassCodeRequired": "请输入邀请码",
+        "joinClassCodeInvalid": "邀请码必须是 6 位数字",
+        "statusActive": "活跃",
+        "statusInactive": "已结课",
+        "cardTeacher": "任课教师",
+        "cardSchool": "学校",
+        "cardHeadTeacher": "班主任",
+        "cardGrade": "年级",
+        "sendEmail": "发送邮件",
+        "colRoom": "教室",
+        "colGrade": "年级"
       },
       "detail": {
         "title": "课程详情",
@@ -2033,6 +4456,18 @@
         "sectionSchedule": "本班课表",
         "viewFullSchedule": "查看完整课表",
         "viewHomework": "查看作业",
+        "colWeekday": "星期",
+        "colPeriod": "节次",
+        "colSubject": "科目",
+        "colTime": "时间",
+        "colCourse": "课程",
+        "weekdayMon": "周一",
+        "weekdayTue": "周二",
+        "weekdayWed": "周三",
+        "weekdayThu": "周四",
+        "weekdayFri": "周五",
+        "weekdaySat": "周六",
+        "weekdaySun": "周日",
         "notFound": "未找到课程"
       }
     },
@@ -2041,11 +4476,24 @@
         "title": "课程计划",
         "description": "查看课程计划列表",
         "total": "共 {count} 条",
+        "searchPlaceholder": "搜索计划名称/学科/班级/教师...",
+        "filterByStatus": "按状态筛选",
+        "statusAll": "全部状态",
+        "statusActive": "进行中",
+        "statusCompleted": "已完成",
+        "statusPlanning": "计划中",
+        "statusPaused": "已暂停",
         "colTitle": "计划名称",
         "colSubject": "学科",
         "colGrade": "年级",
         "colStatus": "状态",
         "colActions": "操作",
+        "colClass": "班级",
+        "colTeacher": "教师",
+        "colSemester": "学期",
+        "colCreated": "创建时间",
+        "fieldProgress": "完成进度",
+        "progressHours": "{completed} / {total} 学时（{percent}%）",
         "viewDetail": "查看详情 →",
         "emptyTitle": "暂无课程计划",
         "mswNotice": "学生课程计划列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
@@ -2053,13 +4501,49 @@
       "detail": {
         "title": "课程计划详情",
         "backToList": "返回列表",
+        "notFound": "未找到课程计划",
+        "mswNotice": "详情查询契约待补齐（@contract-pending）。",
+        "headerTitle": "课程计划详情",
+        "badgeClass": "班级",
+        "badgeSubject": "学科",
+        "badgeStatus": "状态",
+        "badgeSemester": "学期",
+        "badgeNoClass": "未分班",
+        "badgeUnknownSubject": "未知学科",
+        "fieldTeacher": "教师",
+        "fieldUnassigned": "未分配",
+        "fieldCreatedAt": "创建于 {date}",
+        "fieldStartDate": "开始于 {date}",
+        "fieldEndDate": "结束于 {date}",
+        "fieldSemester": "第 {semester} 学期",
         "sectionBasic": "基本信息",
         "fieldTitle": "标题",
         "fieldSubject": "学科",
         "fieldGrade": "年级",
         "fieldDescription": "描述",
         "sectionTextbooks": "关联教材",
-        "notFound": "未找到课程计划"
+        "sectionProgress": "完成进度",
+        "progressLabel": "完成进度",
+        "progressHours": "{completed} / {total} 学时（{percent}%）",
+        "progressItems": "{completed} / {total} 周计划已完成",
+        "sectionSyllabus": "教学大纲",
+        "sectionObjectives": "教学目标",
+        "emptyText": "暂无",
+        "sectionWeekPlans": "周计划",
+        "emptyWeekPlans": "暂无周计划",
+        "colWeek": "周次",
+        "colTopic": "主题",
+        "colHours": "学时",
+        "colChapter": "章节",
+        "colStatus": "状态",
+        "statusPlanned": "已计划",
+        "statusInProgress": "进行中",
+        "statusCompleted": "已完成",
+        "statusSkipped": "已跳过",
+        "statusUnknown": "未知",
+        "exportCsv": "导出 CSV",
+        "toastExported": "导出成功",
+        "toastExportFailed": "导出失败"
       }
     },
     "lessonPlans": {
@@ -2073,15 +4557,23 @@
         "colUpdatedAt": "更新时间",
         "colActions": "操作",
         "viewDetail": "查看教案 →",
+        "subjectFilter": "按学科筛选",
+        "allSubjects": "全部学科",
         "emptyTitle": "暂无教案",
         "mswNotice": "学生教案列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       },
       "view": {
         "title": "教案查看",
         "backToList": "返回列表",
+        "sectionBasic": "基本信息",
         "sectionContent": "教案内容",
+        "fieldSubject": "学科",
+        "fieldGrade": "年级",
+        "fieldTextbook": "教材",
+        "fieldChapter": "章节",
         "notFound": "未找到教案或教案未发布",
-        "outOfScope": "该教案不在你的年级范围内"
+        "outOfScope": "该教案不在你的年级范围内",
+        "notPublished": "该教案尚未发布，无法查看"
       }
     },
     "textbooks": {
@@ -2100,14 +4592,43 @@
         "colActions": "操作",
         "viewChapters": "查看章节 →",
         "emptyTitle": "暂无教材",
-        "mswNotice": "学生教材列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "emptyFilteredTitle": "未找到匹配的教材",
+        "emptyFilteredDescription": "请尝试调整筛选条件或清除筛选后重试。",
+        "clearFilters": "清除筛选",
+        "gradeNotSetTitle": "未设置学生年级",
+        "gradeNotSetDescription": "尚未关联活跃班级，无法按年级筛选教材，请联系老师或管理员补全班级信息。",
+        "mswNotice": "学生教材列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "subjects": {
+          "chinese": "语文",
+          "math": "数学",
+          "english": "英语",
+          "physics": "物理",
+          "chemistry": "化学",
+          "biology": "生物"
+        },
+        "grades": {
+          "grade1": "一年级",
+          "grade2": "二年级",
+          "grade3": "三年级",
+          "grade7": "七年级",
+          "grade8": "八年级",
+          "grade9": "九年级"
+        }
       },
       "chapters": {
         "title": "教材阅读器",
         "backToList": "返回教材列表",
         "sectionChapters": "章节列表",
         "sectionContent": "阅读区",
-        "notFound": "未找到教材或教材年级不匹配"
+        "notFound": "未找到教材或教材年级不匹配",
+        "mswNotice": "章节内容契约待补齐，当前通过 MSW 兜底。",
+        "subjectBadge": "学科",
+        "gradeBadge": "年级",
+        "gradeMismatchWarning": "教材年级（{grade}）与你的年级不匹配，仅作参考阅读",
+        "prevChapter": "上一章",
+        "nextChapter": "下一章",
+        "emptyChapters": "暂无章节内容",
+        "chapterLabel": "第 {n} 章"
       }
     },
     "errorBook": {
@@ -2130,6 +4651,7 @@
       "sourceFilter": "按来源筛选",
       "allSources": "全部来源",
       "dueOnlyFilter": "仅看待复习",
+      "resetFilters": "重置",
       "total": "共 {count} 条",
       "colQuestion": "题目",
       "colSubject": "学科",
@@ -2140,8 +4662,44 @@
       "colActions": "操作",
       "markMastered": "标记已掌握",
       "emptyTitle": "暂无错题",
+      "emptyDescription": "调整筛选条件或录入第一道错题",
       "markSuccess": "已标记为已掌握",
-      "markError": "标记失败"
+      "markError": "标记失败",
+      "fieldTotalDesc": "全部错题记录",
+      "fieldNewDesc": "尚未开始复习",
+      "fieldLearningDesc": "复习中尚未掌握",
+      "fieldMasteredDesc": "掌握率 {rate}%",
+      "fieldToReviewDesc": "已到复习节点",
+      "sourceExam": "考试",
+      "sourceHomework": "作业",
+      "sourcePractice": "练习",
+      "sourceManual": "手动添加",
+      "statusArchived": "已归档",
+      "difficultyEasy": "简单",
+      "difficultyMedium": "中等",
+      "difficultyHard": "困难",
+      "viewCard": "卡片视图",
+      "viewTable": "表格视图",
+      "reviewCount": "复习次数",
+      "masteryLevel": "掌握度",
+      "nextReviewAt": "下次复习",
+      "overdue": "逾期",
+      "viewDetail": "查看详情",
+      "detailTitle": "错题详情",
+      "close": "关闭",
+      "correctAnswer": "正确答案",
+      "note": "笔记",
+      "editNote": "编辑笔记",
+      "createdAt": "创建时间",
+      "variantPractice": "变式练习",
+      "practiceStarted": "练习已开始",
+      "practiceStartError": "开始练习失败",
+      "noteEditPending": "笔记编辑功能待开放",
+      "aiAnalysisTitle": "AI 分析",
+      "aiErrorCategory": "错因分类",
+      "aiKnowledgePoint": "关联知识点",
+      "aiLearningPath": "学习路径建议",
+      "aiLearningPathDesc": "建议结合变式练习巩固薄弱知识点"
     },
     "learning": {
       "title": "学习中心",
@@ -2157,7 +4715,12 @@
       "cardErrorBook": "错题本",
       "cardErrorBookDesc": "待复习错题",
       "enter": "进入 →",
-      "emptyTitle": "暂无学习资源"
+      "emptyTitle": "暂无学习资源",
+      "statCourses": "已报名 {count} 个班级",
+      "statHomework": "待交 {pending} · 即将到期 {dueSoon}",
+      "statTextbooks": "可用 {count} 本教材",
+      "noStudentTitle": "未找到学生身份",
+      "noStudentDesc": "请确认你已加入班级或联系管理员"
     },
     "learningPath": {
       "title": "学习路径",
@@ -2192,7 +4755,28 @@
         "colActions": "操作",
         "viewDetail": "查看详情 →",
         "emptyTitle": "暂无练习记录",
-        "mswNotice": "学生练习查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "starterDescription": "选择知识点与题目数量开始练习",
+        "starterQuestionCount": "题目数量",
+        "starterCreating": "创建中...",
+        "starterSelectKnowledgePoint": "请至少选择一个知识点",
+        "starterCreated": "练习会话已创建",
+        "starterCreateFailed": "创建失败：{message}",
+        "mswNotice": "学生练习查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "knowledgePointLoading": "知识点加载中...",
+        "knowledgePointLoadFailed": "知识点加载失败：{message}",
+        "knowledgePointEmpty": "暂无可选知识点",
+        "subjectFilterAll": "全部学科",
+        "subjectFilterLabel": "学科筛选",
+        "selectedCount": "已选 {count} 个知识点",
+        "difficultyEasy": "简单",
+        "difficultyMedium": "中等",
+        "difficultyHard": "困难",
+        "subjectMath": "数学",
+        "subjectChinese": "语文",
+        "subjectEnglish": "英语",
+        "subjectPhysics": "物理",
+        "subjectChemistry": "化学",
+        "knowledgePointDescription": "描述"
       },
       "session": {
         "title": "练习会话",
@@ -2225,6 +4809,37 @@
         "enroll": "选课",
         "drop": "退课",
         "viewDetail": "查看详情 →",
+        "filterByStatus": "状态筛选",
+        "filterBySelectionMode": "选课模式筛选",
+        "statusAll": "全部状态",
+        "statusOpen": "开放中",
+        "statusClosed": "已关闭",
+        "statusInProgress": "进行中",
+        "statusCompleted": "已结束",
+        "modeAll": "全部模式",
+        "modeFcfs": "先到先得",
+        "modeLottery": "抽签",
+        "badgeStatusOpen": "开放中",
+        "badgeStatusClosed": "已关闭",
+        "badgeStatusInProgress": "进行中",
+        "badgeStatusCompleted": "已结束",
+        "badgeModeFcfs": "先到先得",
+        "badgeModeLottery": "抽签",
+        "fieldSubject": "学科",
+        "fieldSchedule": "上课时间",
+        "fieldCredits": "学分",
+        "fieldCapacity": "容量",
+        "fieldEnrolledCount": "报名情况",
+        "fieldCategory": "分类",
+        "capacityFull": "已满",
+        "enrolledCount": "{enrolled}/{capacity}",
+        "dropDialogTitle": "确认退课",
+        "dropDialogDescription": "确认要退选 {courseName} 吗？退课后无法恢复。",
+        "dropDialogReasonLabel": "退课原因（可选）",
+        "dropDialogReasonPlaceholder": "请填写退课原因...",
+        "dropDialogCancel": "取消",
+        "dropDialogConfirm": "确认退课",
+        "dropDialogLoading": "处理中...",
         "emptyMySelections": "暂无已选课程",
         "emptyAvailable": "暂无可选课程",
         "enrollSuccess": "选课成功",
@@ -2237,14 +4852,30 @@
         "title": "选课详情",
         "backToList": "返回选课列表",
         "sectionBasic": "课程信息",
+        "sectionDescription": "课程描述",
+        "sectionSchedule": "上课时间",
         "fieldName": "名称",
         "fieldTeacher": "教师",
         "fieldCapacity": "容量",
         "fieldEnrolled": "已选",
-        "fieldSchedule": "上课时间",
         "fieldCredits": "学分",
         "fieldCategory": "分类",
-        "notFound": "未找到课程"
+        "fieldSubject": "学科",
+        "fieldGrade": "年级",
+        "fieldClassroom": "教室",
+        "fieldSelectionMode": "选课模式",
+        "fieldStartDate": "开始日期",
+        "fieldEndDate": "结束日期",
+        "fieldSelectionStartAt": "选课开始时间",
+        "fieldSelectionEndAt": "选课结束时间",
+        "statusDraft": "草稿",
+        "statusOpen": "开放中",
+        "statusClosed": "已关闭",
+        "statusCancelled": "已取消",
+        "selectionModeFcfs": "先到先得",
+        "selectionModeLottery": "抽签",
+        "notFound": "未找到课程",
+        "mswNotice": "选课详情查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       }
     },
     "leave": {
@@ -2274,7 +4905,16 @@
       "statusRejected": "已驳回",
       "emptyTitle": "暂无请假记录",
       "noActiveClass": "暂无活跃班级，无法提交请假申请",
-      "mswNotice": "学生请假查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      "backToDashboard": "返回学生主页",
+      "mswNotice": "学生请假查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+      "validation": {
+        "selectClass": "请选择班级",
+        "selectStartDate": "请选择开始日期",
+        "selectEndDate": "请选择结束日期",
+        "selectType": "请选择请假类型",
+        "fillReason": "请填写请假原因",
+        "endDateBeforeStart": "结束日期不能早于开始日期"
+      }
     },
     "aiTutor": {
       "title": "AI 辅导",
@@ -2334,6 +4974,110 @@
       "retry": "重试"
     }
   },
+  "shared": {
+    "profile": {
+      "title": "个人资料",
+      "description": "查看个人资料与角色专属概览",
+      "editProfile": "编辑资料",
+      "sectionPersonal": "个人信息",
+      "sectionAccount": "账户信息",
+      "sectionRoleOverview": "角色概览",
+      "fieldName": "姓名",
+      "fieldGender": "性别",
+      "fieldAge": "年龄",
+      "fieldPhone": "电话",
+      "fieldAddress": "地址",
+      "fieldEmail": "邮箱",
+      "fieldRole": "角色",
+      "fieldCreatedAt": "注册时间",
+      "fieldOnboardedAt": "入职时间",
+      "fieldClassName": "班级",
+      "fieldGrade": "年级",
+      "fieldHeadTeacher": "班主任",
+      "fieldAvgScore": "平均分",
+      "fieldClassRank": "班级排名",
+      "fieldClassCount": "班级数",
+      "fieldStudentCount": "学生数",
+      "fieldCourses": "教授课程",
+      "rankValue": "第 {rank} / {total} 名",
+      "genderMale": "男",
+      "genderFemale": "女",
+      "genderOther": "其他",
+      "roleAdmin": "管理员",
+      "roleTeacher": "教师",
+      "roleStudent": "学生",
+      "roleParent": "家长",
+      "noRoleOverview": "当前角色暂无专属概览信息",
+      "mswNotice": "用户资料查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+    },
+    "messages": {
+      "detail": {
+        "title": "消息详情",
+        "backToList": "返回消息列表",
+        "reply": "回复",
+        "delete": "删除",
+        "deleteConfirm": "确认删除这条消息吗？",
+        "deleteSuccess": "已删除",
+        "deleteError": "删除失败",
+        "cancel": "取消",
+        "fieldFrom": "发件人",
+        "fieldTo": "收件人",
+        "fieldSubject": "主题",
+        "fieldDate": "日期",
+        "fieldStatus": "状态",
+        "fieldBody": "正文",
+        "fieldStarred": "星标",
+        "statusRead": "已读",
+        "statusUnread": "未读",
+        "starredYes": "是",
+        "starredNo": "否",
+        "notFound": "未找到消息",
+        "mswNotice": "消息详情查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      },
+      "compose": {
+        "title": "撰写消息",
+        "description": "填写收件人、主题与正文",
+        "backToList": "返回消息列表",
+        "fieldTo": "收件人",
+        "fieldSubject": "主题",
+        "fieldBody": "正文",
+        "toPlaceholder": "请选择收件人",
+        "subjectPlaceholder": "请输入主题",
+        "bodyPlaceholder": "请输入正文",
+        "send": "发送",
+        "sending": "发送中...",
+        "cancel": "取消",
+        "selectRecipient": "请选择收件人",
+        "subjectRequired": "主题不能为空",
+        "bodyRequired": "正文不能为空",
+        "sendSuccess": "发送成功",
+        "sendError": "发送失败，请重试",
+        "noRecipients": "暂无可用收件人",
+        "mswNotice": "收件人列表与发送消息契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      },
+      "groupCompose": {
+        "title": "群发消息",
+        "description": "选择多位收件人发送同一条消息",
+        "backToList": "返回消息列表",
+        "fieldTo": "收件人（多选）",
+        "fieldSubject": "主题",
+        "fieldBody": "正文",
+        "subjectPlaceholder": "请输入主题",
+        "bodyPlaceholder": "请输入正文",
+        "send": "发送",
+        "sending": "发送中...",
+        "cancel": "取消",
+        "selectAtLeastOne": "请至少选择一位收件人",
+        "subjectRequired": "主题不能为空",
+        "bodyRequired": "正文不能为空",
+        "sendSuccess": "群发成功（{count} 人）",
+        "sendError": "群发失败，请重试",
+        "noRecipients": "暂无可用收件人",
+        "selectedCount": "已选 {count} 人",
+        "mswNotice": "收件人列表与发送消息契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+      }
+    }
+  },
   "admin": {
     "users": {
       "list": {
@@ -2346,10 +5090,16 @@
         "colName": "姓名",
         "colEmail": "邮箱",
         "colRole": "角色",
+        "colPhone": "电话",
         "colStatus": "状态",
         "colCreatedAt": "创建时间",
+        "colUpdatedAt": "更新时间",
+        "colUserType": "用户类型",
         "colActions": "操作",
         "editRole": "修改角色",
+        "editUser": "编辑用户",
+        "userTypeInternal": "内部",
+        "userTypeExternal": "外部",
         "activate": "启用",
         "deactivate": "停用",
         "emptyTitle": "暂无用户",
@@ -2383,7 +5133,7 @@
         "required": "必填",
         "optional": "可选",
         "uploadButton": "选择文件上传",
-        "uploadHint": "支持 .csv 文件，单次最多 500 条",
+        "uploadHint": "支持 .csv / .xlsx / .xls 文件，单次最多 500 条",
         "noticeTitle": "注意事项",
         "notice1": "邮箱格式必须正确",
         "notice2": "角色只能是 teacher / student / parent / admin",
@@ -2395,7 +5145,26 @@
         "resultTotal": "总行数",
         "resultSuccess": "成功",
         "resultFailed": "失败",
-        "resultErrors": "错误明细"
+        "resultErrors": "错误明细",
+        "filesPreview": "文件预览（前 {count} 行）",
+        "importStatus": "导入中...",
+        "reselect": "重新选择",
+        "confirmImport": "确认导入"
+      },
+      "assignDialog": {
+        "title": "分配角色",
+        "description": "为 {name} 分配角色，保存后将立即生效。",
+        "listAriaLabel": "{name} 的可分配角色列表",
+        "noEnabledRoles": "暂无可分配的角色",
+        "system": "系统",
+        "locked": "锁定",
+        "disabledAssignedLabel": "以下角色已禁用但仍分配给该用户：",
+        "disabledLabel": "已禁用",
+        "save": "保存",
+        "saving": "保存中…",
+        "success": "角色已分配",
+        "adminWarningTitle": "管理员角色",
+        "adminWarning": "管理员拥有系统最高权限，分配后该用户将获得全部管理能力，请谨慎操作。"
       },
       "error": {
         "title": "用户模块出错了",
@@ -2409,17 +5178,38 @@
         "description": "管理角色与权限分配",
         "newRole": "新建角色",
         "createButton": "新建角色",
+        "totalBadge": "共 {count} 个角色",
         "searchPlaceholder": "搜索角色名称/描述...",
+        "tableCaption": "角色列表，包含名称、描述、类型、状态、用户数、权限数、更新时间与操作",
         "colName": "角色名称",
         "colDescription": "描述",
         "colIsLocked": "系统锁定",
+        "colType": "类型",
+        "colStatus": "状态",
+        "colUserCount": "用户数",
         "colPermissions": "权限数",
+        "colValue": "角色值",
+        "colUpdatedAt": "更新时间",
         "colActions": "操作",
         "viewDetail": "查看详情",
         "editRole": "编辑",
         "editPermissions": "编辑权限",
         "deleteRole": "删除",
+        "enableRole": "启用",
+        "disableRole": "停用",
+        "enabled": "已启用",
+        "disabled": "已停用",
+        "userCountValue": "{count} 个",
+        "typeSystem": "系统",
+        "typeCustom": "自定义",
+        "deleteConfirmTitle": "确认删除角色",
+        "deleteConfirmDescription": "确定要删除角色「{name}」吗？该角色当前关联 {count} 个用户，删除后这些用户将失去对应权限。此操作不可撤销。",
+        "confirmDelete": "确认删除",
+        "deleted": "角色已删除",
+        "enabledSuccess": "角色已启用",
+        "disabledSuccess": "角色已停用",
         "lockedRole": "系统角色（不可删除）",
+        "lockedRoleToggleWarn": "系统锁定角色不支持启停切换",
         "emptyTitle": "暂无角色",
         "emptyDescription": "新建第一个角色以开始管理权限",
         "emptyAction": "新建角色",
@@ -2429,16 +5219,19 @@
       "detail": {
         "title": "角色详情",
         "edit": "编辑",
+        "editRole": "编辑角色",
         "notFound": "未找到该角色",
         "backToList": "返回角色列表",
         "sectionBasic": "基本信息",
         "sectionPermissions": "权限矩阵",
         "lockedNotice": "此为系统内置角色，部分字段不可修改",
+        "adminLockedWarn": "admin 是系统最高权限角色，对其权限的修改可能影响系统整体可用性。请谨慎调整。",
         "fieldName": "角色名称",
         "fieldDescription": "描述",
         "fieldIsLocked": "系统锁定",
         "fieldPermissions": "权限列表",
-        "noPermissions": "该角色暂未分配任何权限"
+        "noPermissions": "该角色暂未分配任何权限",
+        "sectionPermissionMatrix": "权限操作矩阵"
       },
       "form": {
         "titleCreate": "新建角色",
@@ -2447,7 +5240,50 @@
         "fieldDescription": "角色描述",
         "fieldPermissions": "权限分配",
         "submit": "保存",
-        "cancel": "取消"
+        "cancel": "取消",
+        "namePatternTitle": "只允许小写字母、数字与下划线"
+      },
+      "createDialog": {
+        "titleCreate": "新建角色",
+        "titleEdit": "编辑角色",
+        "descriptionCreate": "创建一个新角色，可在创建后通过权限矩阵分配具体操作权限。",
+        "descriptionEdit": "修改角色名称与描述。权限点请在权限操作矩阵中调整。",
+        "fieldName": "角色名称",
+        "fieldNamePlaceholder": "如：班主任、年级组长",
+        "fieldDescription": "角色描述",
+        "fieldDescriptionPlaceholder": "简要描述该角色的职责范围（可选）",
+        "fieldValue": "角色值",
+        "fieldValuePlaceholder": "如：role:teacher",
+        "lockedNameNotice": "系统内置角色名称不可修改",
+        "cancel": "取消",
+        "submitting": "提交中…",
+        "submitCreate": "创建角色",
+        "submitEdit": "保存修改",
+        "successCreated": "角色创建成功",
+        "successUpdated": "角色已更新",
+        "errorNameRequired": "请填写角色名称",
+        "namePatternTitle": "只允许小写字母、数字与下划线",
+        "errorNamePattern": "角色名称只允许小写字母、数字与下划线"
+      },
+      "matrix": {
+        "title": "{roleName} · 权限操作矩阵",
+        "locked": "已锁定",
+        "permissionCount": "共 {count} 个权限点",
+        "loading": "正在加载权限矩阵...",
+        "empty": "该角色暂无可配置的权限点",
+        "colPermission": "权限点",
+        "actionRead": "查看",
+        "actionCreate": "新建",
+        "actionUpdate": "编辑",
+        "actionDelete": "删除",
+        "moduleLabel": "模块：{module}",
+        "save": "保存矩阵",
+        "saving": "保存中…",
+        "successSaved": "权限矩阵已保存",
+        "searchPlaceholder": "搜索权限点/模块...",
+        "collapse": "收起",
+        "expand": "展开",
+        "userImpactNotice": "该角色当前关联 {count} 个用户，调整权限将立即影响这些用户。"
       },
       "error": {
         "title": "角色模块出错了",
@@ -2464,8 +5300,11 @@
         "colPermission": "权限点",
         "colResource": "资源",
         "colAction": "动作",
+        "colValue": "权限值",
+        "colKey": "标识",
         "colRoleCount": "关联角色数",
         "groupResource": "按资源分组",
+        "countLabel": "共 {count} 项",
         "emptyTitle": "暂无权限点",
         "emptyDescription": "权限目录将由 IAM 服务同步后展示",
         "mswNotice": "权限目录查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
@@ -2496,6 +5335,9 @@
         "allStatuses": "全部状态",
         "export": "导出 CSV",
         "exportCsv": "导出 CSV",
+        "exportSuccess": "成功导出 {count} 条记录",
+        "exportEmpty": "没有可导出的数据",
+        "exportFailed": "导出失败：{message}",
         "colTimestamp": "时间",
         "colUser": "用户",
         "colUserId": "用户 ID",
@@ -2507,7 +5349,10 @@
         "colResourceId": "资源 ID",
         "colIp": "IP",
         "colDetails": "详情",
+        "colActions": "操作",
         "total": "共 {count} 条",
+        "resetFilter": "重置",
+        "pageOf": "第 {page} / {totalPages} 页",
         "emptyTitle": "暂无审计日志",
         "emptyDescription": "调整筛选条件或更换时间范围后重试",
         "mswNotice": "审计日志查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
@@ -2526,6 +5371,19 @@
         "statsToday": "今日日志",
         "statsErrors": "错误日志",
         "statsUsers": "活跃用户",
+        "auditEventsToday": "今日审计事件",
+        "failedLoginsToday": "今日失败登录",
+        "dataChangesToday": "今日数据变更",
+        "totalAuditLogs": "审计日志总数",
+        "sectionError": "区块加载失败",
+        "sectionRetry": "重试",
+        "chartEmpty": "暂无数据",
+        "quickLinkAuditLogs": "审计日志",
+        "quickLinkAuditLogsDesc": "查看所有用户操作审计记录",
+        "quickLinkLoginLogs": "登录日志",
+        "quickLinkLoginLogsDesc": "查看登录/登出/注册记录",
+        "quickLinkDataChanges": "数据变更",
+        "quickLinkDataChangesDesc": "查看数据表变更记录与统计",
         "trendTitle": "近 7 天趋势",
         "trendLast7Days": "近 7 天",
         "distributionTitle": "数据变更动作分布",
@@ -2543,6 +5401,9 @@
         "filterAction": "按动作筛选",
         "filterStatus": "按状态筛选",
         "filterUser": "按用户筛选",
+        "filterDateRange": "时间范围",
+        "startDate": "开始日期",
+        "endDate": "结束日期",
         "actionFilter": "按动作筛选",
         "statusFilter": "按状态筛选",
         "allActions": "全部动作",
@@ -2554,15 +5415,22 @@
         "statusFailure": "失败",
         "export": "导出 CSV",
         "exportCsv": "导出 CSV",
+        "exportSuccess": "成功导出 {count} 条记录",
+        "exportEmpty": "没有可导出的数据",
+        "exportFailed": "导出失败：{message}",
         "colTimestamp": "时间",
         "colUser": "用户",
         "colUserId": "用户 ID",
         "colUserName": "用户名",
         "colAction": "动作",
         "colStatus": "状态",
+        "colErrorMessage": "失败原因",
         "colIp": "IP",
         "colUserAgent": "User Agent",
+        "colActions": "操作",
         "total": "共 {count} 条",
+        "resetFilter": "重置",
+        "pageOf": "第 {page} / {totalPages} 页",
         "emptyTitle": "暂无登录日志",
         "emptyDescription": "调整筛选条件后重试",
         "mswNotice": "登录日志查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
@@ -2574,6 +5442,9 @@
         "filterTable": "按表筛选",
         "filterAction": "按动作筛选",
         "filterUser": "按用户筛选",
+        "filterDateRange": "时间范围",
+        "startDate": "开始日期",
+        "endDate": "结束日期",
         "tableFilter": "按表筛选",
         "actionFilter": "按动作筛选",
         "allTables": "全部表",
@@ -2583,11 +5454,19 @@
         "actionDelete": "删除",
         "export": "导出 CSV",
         "exportCsv": "导出 CSV",
+        "exportSuccess": "成功导出 {count} 条记录",
+        "exportEmpty": "没有可导出的数据",
+        "exportFailed": "导出失败：{message}",
         "sectionStats": "变更统计",
         "statsTitle": "变更统计",
         "statsAction": "动作",
         "statsCount": "次数",
         "statsLastChange": "最近变更",
+        "topTables": "热门表 Top 8",
+        "expandDetail": "查看变更对比",
+        "collapseDetail": "收起变更对比",
+        "oldValue": "变更前",
+        "newValue": "变更后",
         "colTimestamp": "时间",
         "colTable": "表名",
         "colRecordId": "记录 ID",
@@ -2596,11 +5475,51 @@
         "colUserId": "用户 ID",
         "colUserName": "用户名",
         "colChanges": "变更内容",
+        "colActions": "操作",
         "total": "共 {count} 条",
+        "resetFilter": "重置",
+        "pageOf": "第 {page} / {totalPages} 页",
         "emptyTitle": "暂无数据变更日志",
         "emptyDescription": "调整筛选条件后重试",
         "mswNotice": "数据变更日志查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       },
+      "detail": {
+        "title": "审计日志详情",
+        "description": "查看审计日志详细信息",
+        "viewDetail": "查看详情",
+        "userId": "用户 ID",
+        "userName": "用户名",
+        "action": "动作",
+        "module": "模块",
+        "resourceId": "资源 ID",
+        "tableName": "表名",
+        "recordId": "记录 ID",
+        "changes": "变更内容",
+        "oldValue": "变更前",
+        "newValue": "变更后",
+        "errorMessage": "失败原因",
+        "ipAddress": "IP 地址",
+        "userAgent": "User Agent",
+        "status": "状态",
+        "details": "详情",
+        "createdAt": "创建时间"
+      },
+      "retention": {
+        "title": "审计日志保留期设置",
+        "description": "配置审计日志与登录日志的保留天数及自动清理",
+        "retentionDays": "审计日志保留天数",
+        "retentionDaysDescription": "范围 7-3650 天，默认 90 天",
+        "loginLogRetentionDays": "登录日志保留天数",
+        "loginLogRetentionDaysDescription": "范围 7-3650 天，默认 365 天",
+        "autoCleanupEnabled": "启用自动清理",
+        "autoCleanupEnabledDescription": "开启后系统将按保留天数自动清理过期日志",
+        "save": "保存配置",
+        "purge": "立即清理",
+        "saveSuccess": "保留期配置已保存",
+        "purgeConfirm": "确定要立即清理过期日志吗？此操作不可撤销。",
+        "purgeSuccess": "已清理：审计日志 {auditLogsDeleted} 条，登录日志 {loginLogsDeleted} 条，数据变更日志 {dataChangeLogsDeleted} 条",
+        "loadFailed": "加载保留期配置失败"
+      },
       "error": {
         "title": "审计日志模块出错了",
         "unknown": "审计日志模块发生未知错误",
@@ -2627,6 +5546,10 @@
         "copyCode": "复制",
         "allStatuses": "全部状态",
         "total": "共 {count} 条",
+        "statsTotal": "总邀请码数",
+        "statsUsed": "已使用数",
+        "statsUnused": "未使用数",
+        "statsExpired": "已过期数",
         "statusActive": "有效",
         "statusUnused": "未使用",
         "statusUsed": "已用完",
@@ -2635,7 +5558,12 @@
         "emptyTitle": "暂无邀请码",
         "emptyDescription": "生成第一个邀请码以邀请用户加入",
         "emptyAction": "生成邀请码",
-        "mswNotice": "邀请码列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "邀请码列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "deleteSelected": "删除选中 ({count})",
+        "deleteSuccess": "已删除 {count} 个邀请码",
+        "deleteConfirmTitle": "确认批量删除",
+        "deleteConfirmDesc": "即将删除 {count} 个邀请码，此操作不可撤销。",
+        "confirmDelete": "确认删除"
       },
       "generateForm": {
         "title": "生成邀请码",
@@ -2645,6 +5573,41 @@
         "submit": "生成",
         "cancel": "取消"
       },
+      "generateDialog": {
+        "title": "批量生成邀请码",
+        "description": "一次生成多个邀请码，可用于批量邀请教师、学生或家长加入系统。",
+        "fieldBatchName": "批次名",
+        "fieldBatchNamePlaceholder": "如：2026秋季新教师批次（可选）",
+        "fieldBatchNameHint": "用于标识本次生成批次，便于后续管理",
+        "fieldCount": "生成数量",
+        "countHint": "单次最多生成 100 个",
+        "fieldRole": "角色",
+        "roles": {
+          "teacher": "教师",
+          "student": "学生",
+          "parent": "家长",
+          "admin": "管理员"
+        },
+        "fieldExpireDays": "有效期（天）",
+        "expireDaysOption": "{days} 天",
+        "fieldPurpose": "用途",
+        "fieldPurposePlaceholder": "如：新教师入职邀请（可选）",
+        "fieldPurposeHint": "说明本次生成邀请码的用途，不超过 500 字",
+        "cancel": "取消",
+        "submit": "生成",
+        "generating": "生成中…",
+        "success": "已成功生成 {count} 个邀请码",
+        "errorCountRange": "生成数量需在 1 至 100 之间",
+        "resultTitle": "生成结果",
+        "resultDescription": "请及时复制或下载生成的邀请码，关闭后无法再次查看明文。",
+        "statsSuccess": "成功生成",
+        "statsFailed": "失败数量",
+        "copyCode": "复制",
+        "copyAll": "全部复制",
+        "copyFailed": "复制失败",
+        "downloadCsv": "下载 CSV",
+        "done": "完成"
+      },
       "error": {
         "title": "邀请码模块出错了",
         "unknown": "邀请码模块发生未知错误",
@@ -2773,7 +5736,8 @@
           "fieldCurrentYear": "当前学年",
           "fieldCurrentTerm": "当前学期",
           "submit": "保存",
-          "cancel": "取消"
+          "cancel": "取消",
+          "fieldCode": "学校代码"
         },
         "deleteConfirm": {
           "title": "删除学校",
@@ -2785,7 +5749,9 @@
           "title": "学校模块出错了",
           "unknown": "学校模块发生未知错误",
           "retry": "重试"
-        }
+        },
+        "colCode": "学校代码",
+        "colUpdatedAt": "更新时间"
       },
       "classes": {
         "title": "班级管理",
@@ -2815,6 +5781,111 @@
           "title": "班级模块出错了",
           "unknown": "班级模块发生未知错误",
           "retry": "重试"
+        },
+        "manageSchedule": "管理课表",
+        "manageInvitation": "邀请码",
+        "schedule": {
+          "form": {
+            "titleCreate": "新增课表条目",
+            "titleEdit": "编辑课表条目",
+            "classLabel": "班级",
+            "fieldWeekday": "星期",
+            "fieldPeriod": "节次",
+            "fieldSubject": "学科",
+            "fieldTeacher": "教师",
+            "fieldClassroom": "教室",
+            "fieldStartTime": "开始时间",
+            "fieldEndTime": "结束时间",
+            "subjectPlaceholder": "如：数学",
+            "teacherPlaceholder": "如：张老师",
+            "classroomPlaceholder": "如：301 教室",
+            "periodN": "第 {n} 节",
+            "save": "保存",
+            "create": "新增",
+            "createSuccess": "课表条目创建成功",
+            "editSuccess": "课表条目更新成功",
+            "deleteTitle": "删除课表条目",
+            "deleteMessage": "确认删除 {weekday} 第 {period} 节 {subject}？",
+            "deleteConfirm": "删除",
+            "deleteSuccess": "课表条目删除成功"
+          },
+          "manager": {
+            "title": "课表管理",
+            "add": "新增条目",
+            "colPeriod": "节次",
+            "colSubject": "学科",
+            "colTeacher": "教师",
+            "colClassroom": "教室",
+            "colTime": "时间",
+            "colActions": "操作",
+            "empty": "暂无课表条目"
+          },
+          "weekday": {
+            "1": "周一",
+            "2": "周二",
+            "3": "周三",
+            "4": "周四",
+            "5": "周五",
+            "6": "周六",
+            "7": "周日"
+          }
+        },
+        "invitation": {
+          "title": "邀请码管理",
+          "classLabel": "班级",
+          "generate": "生成邀请码",
+          "generateWithCustom": "自定义邀请码",
+          "generateSuccess": "邀请码生成成功",
+          "defaultDuration": "留空表示不限制有效期",
+          "defaultMaxUses": "留空表示不限制使用次数",
+          "expiresInHours": "有效期（小时）",
+          "maxUsesLabel": "最大使用次数",
+          "customNote": "备注",
+          "customNotePlaceholder": "如：暑期班邀请码",
+          "copy": "复制",
+          "copied": "已复制到剪贴板",
+          "revoke": "撤销",
+          "revokeSuccess": "邀请码已撤销",
+          "revokeConfirm": "确认撤销此邀请码？撤销后无法恢复。",
+          "neverExpires": "永不过期",
+          "empty": "暂无邀请码",
+          "colCode": "邀请码",
+          "colStatus": "状态",
+          "colUsedCount": "使用次数",
+          "colExpiresAt": "过期时间",
+          "colNote": "备注",
+          "colActions": "操作",
+          "status": {
+            "active": "可用",
+            "used": "已用完",
+            "expired": "已过期",
+            "revoked": "已撤销"
+          }
+        },
+        "colHomeroomLabel": "班级标签",
+        "colRoom": "教室",
+        "colSubjectTeachers": "任课教师",
+        "colUpdatedAt": "更新时间",
+        "form": {
+          "titleCreate": "新建班级",
+          "titleEdit": "编辑班级",
+          "fieldName": "班级名称",
+          "fieldSchool": "所属学校",
+          "fieldGrade": "所属年级",
+          "fieldHeadTeacher": "班主任",
+          "fieldHomeroomLabel": "班级标签",
+          "fieldHomeroomLabelPlaceholder": "如：1班、2班",
+          "fieldRoom": "教室",
+          "fieldRoomPlaceholder": "如：301教室",
+          "fieldHomeroom": "班主任",
+          "submit": "保存",
+          "cancel": "取消"
+        },
+        "deleteConfirm": {
+          "title": "删除班级",
+          "message": "确定要删除班级 \"{name}\" 吗？此操作不可撤销。",
+          "confirm": "确认删除",
+          "cancel": "取消"
         }
       },
       "departments": {
@@ -2843,7 +5914,8 @@
           "fieldSchool": "所属学校",
           "fieldHead": "负责人 ID（可选）",
           "submit": "保存",
-          "cancel": "取消"
+          "cancel": "取消",
+          "fieldDescription": "描述"
         },
         "deleteConfirm": {
           "title": "删除部门",
@@ -2855,7 +5927,9 @@
           "title": "部门模块出错了",
           "unknown": "部门模块发生未知错误",
           "retry": "重试"
-        }
+        },
+        "colDescription": "描述",
+        "colUpdatedAt": "更新时间"
       },
       "academicYear": {
         "title": "学年管理",
@@ -2888,7 +5962,8 @@
           "fieldEndDate": "结束日期",
           "fieldIsActive": "设为当前激活",
           "submit": "保存",
-          "cancel": "取消"
+          "cancel": "取消",
+          "fieldIsActiveHint": "激活后该学年将作为当前学年"
         },
         "deleteConfirm": {
           "title": "删除学年",
@@ -2900,7 +5975,10 @@
           "title": "学年模块出错了",
           "unknown": "学年模块发生未知错误",
           "retry": "重试"
-        }
+        },
+        "activeYearCardTitle": "当前激活学年",
+        "activeYearCardDescription": "展示当前设为激活的学年信息",
+        "activeYearCardEmpty": "暂无激活学年"
       },
       "grades": {
         "title": "年级管理",
@@ -2946,7 +6024,11 @@
           "title": "年级模块出错了",
           "unknown": "年级模块发生未知错误",
           "retry": "重试"
-        }
+        },
+        "insights": "年级洞察",
+        "gradeOverviewSection": "年级概览卡片",
+        "colTeachingHead": "教学主任",
+        "notSet": "未设置"
       }
     },
     "announcements": {
@@ -2963,10 +6045,12 @@
         "colAudience": "受众",
         "colPinnedAt": "置顶时间",
         "colPublishedAt": "发布时间",
+        "colReadCount": "阅读数",
         "colAuthor": "作者",
         "colActions": "操作",
         "viewDetail": "查看",
         "edit": "编辑",
+        "publish": "发布",
         "archive": "归档",
         "pin": "置顶",
         "unpin": "取消置顶",
@@ -2976,7 +6060,8 @@
         "emptyTitle": "暂无公告",
         "emptyDescription": "调整筛选条件或新建第一条公告",
         "emptyAction": "新建公告",
-        "mswNotice": "公告列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "公告列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "pageIndicator": "第 {page} / {total} 页"
       },
       "detail": {
         "title": "公告详情",
@@ -3003,7 +6088,34 @@
         "delete": "删除",
         "deleteConfirm": "确认删除该公告？此操作不可撤销。",
         "fieldGrades": "年级",
-        "fieldClasses": "班级"
+        "fieldClasses": "班级",
+        "fieldReadCount": "阅读数",
+        "deleteConfirmDesc": "此操作不可撤销，公告将被永久删除。"
+      },
+      "create": {
+        "title": "新建公告",
+        "description": "创建一条新的学校公告",
+        "triggerButton": "新建公告",
+        "fieldTitle": "标题",
+        "fieldTitlePlaceholder": "请输入公告标题",
+        "fieldContent": "内容",
+        "fieldContentPlaceholder": "请输入公告内容",
+        "fieldStatus": "状态",
+        "fieldAudience": "受众",
+        "fieldGrades": "关联年级",
+        "fieldGradesDescription": "选择公告关联的年级（可选）",
+        "statusOption_draft": "草稿",
+        "statusOption_published": "已发布",
+        "statusOption_archived": "已归档",
+        "audienceOption_all": "全校",
+        "audienceOption_teachers": "教师",
+        "audienceOption_students": "学生",
+        "audienceOption_parents": "家长",
+        "errorTitleRequired": "请填写标题",
+        "errorContentRequired": "请填写内容",
+        "submit": "创建",
+        "submitting": "创建中…",
+        "submitSuccess": "公告已创建"
       },
       "form": {
         "titleCreate": "新建公告",
@@ -3029,8 +6141,18 @@
         "fieldStatus": "状态",
         "fieldAudience": "受众",
         "fieldPinned": "置顶",
+        "fieldGrades": "关联年级",
+        "fieldGradesHint": "多个年级 ID 用英文逗号分隔（如：grade-1,grade-2）",
         "errorTitleRequired": "请填写标题",
-        "errorContentRequired": "请填写内容"
+        "errorContentRequired": "请填写内容",
+        "multiSelect": {
+          "placeholder": "请选择年级",
+          "selected": "已选 {count} 项",
+          "toggle": "切换下拉",
+          "loading": "加载中...",
+          "empty": "暂无年级数据",
+          "remove": "移除 {name}"
+        }
       },
       "error": {
         "title": "公告模块出错了",
@@ -3048,6 +6170,13 @@
         "statByType": "按类型分布",
         "uploadButton": "上传文件",
         "searchPlaceholder": "搜索文件名...",
+        "fileTypeFilter": "按文件类型筛选",
+        "allTypes": "全部类型",
+        "typeImage": "图片",
+        "typeDocument": "文档",
+        "typeVideo": "视频",
+        "typeAudio": "音频",
+        "typeOther": "其他",
         "colName": "文件名",
         "colSize": "大小",
         "colMimeType": "类型",
@@ -3061,7 +6190,57 @@
         "emptyTitle": "暂无文件",
         "emptyDescription": "调整筛选条件或上传新文件",
         "emptyAction": "上传文件",
-        "mswNotice": "文件列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "文件列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "selectAll": "全选",
+        "selectRow": "选择此行",
+        "statTopType": "热门类型 Top 2",
+        "statTopTypeHint": "按文件数量排序"
+      },
+      "upload": {
+        "button": "上传文件",
+        "uploading": "上传中...",
+        "success": "上传成功",
+        "ariaLabel": "选择文件上传",
+        "dragDrop": "拖拽文件到此处或点击选择",
+        "dropHere": "释放鼠标以上传",
+        "progress": "上传进度 {percent}%",
+        "dragActive": "拖拽激活中",
+        "multiUpload": "已选 {count} 个文件",
+        "remaining": "剩余 {count} 个"
+      },
+      "batch": {
+        "selectAll": "全选",
+        "selectedCount": "已选 {count} 项",
+        "clearSelection": "清空选择",
+        "batchDelete": "批量删除",
+        "confirming": "处理中...",
+        "deleteSuccess": "成功删除 {count} 个文件",
+        "confirmTitle": "确认批量删除",
+        "confirmDescription": "即将删除 {count} 个文件，此操作不可撤销。",
+        "confirmCancel": "取消",
+        "confirmSubmit": "确认删除"
+      },
+      "preview": {
+        "trigger": "预览",
+        "title": "文件预览",
+        "download": "下载",
+        "zoomIn": "放大",
+        "zoomOut": "缩小",
+        "text": {
+          "title": "文本预览",
+          "hint": "点击下方按钮加载文本内容",
+          "load": "加载内容",
+          "loading": "加载中...",
+          "error": "加载失败：{message}"
+        },
+        "office": {
+          "title": "Office 文件暂不支持在线预览",
+          "hint": "请下载后查看"
+        },
+        "other": {
+          "title": "此文件类型暂不支持在线预览",
+          "hint": "请下载后查看"
+        }
       },
       "error": {
         "title": "文件模块出错了",
@@ -3088,8 +6267,15 @@
         "edit": "编辑",
         "delete": "删除",
         "testConnection": "测试连接",
+        "testing": "测试中...",
+        "testSuccess": "连接成功，延迟 {latency} ms",
+        "testFailed": "连接失败：{message}",
         "active": "启用",
         "inactive": "停用",
+        "colVisibility": "可见性",
+        "colIsDefault": "默认",
+        "defaultProvider": "默认",
+        "nonDefaultProvider": "非默认",
         "emptyTitle": "暂无 AI Provider",
         "emptyDescription": "新增第一个 AI Provider 以启用 AI 能力",
         "emptyAction": "新建 Provider",
@@ -3111,17 +6297,52 @@
         "colDate": "日期",
         "mswNotice": "AI 配置查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       },
+      "deleteDialog": {
+        "title": "删除 AI Provider",
+        "warning": "此操作不可逆。删除后，Provider \"{name}\" 的所有配置将永久丢失。",
+        "confirmPrompt": "请输入 Provider 名称 \"{name}\" 以确认删除：",
+        "confirmInputPlaceholder": "输入 Provider 名称",
+        "confirmInputHint": "输入的名称必须与上方显示的完全一致。",
+        "cancel": "取消",
+        "confirm": "删除",
+        "deleting": "删除中...",
+        "success": "已删除 Provider \"{name}\""
+      },
       "form": {
         "titleCreate": "新建 AI Provider",
         "titleEdit": "编辑 AI Provider",
+        "description": "配置 AI Provider 连接参数。带 * 的字段为必填。",
         "fieldName": "名称",
+        "fieldNamePlaceholder": "如：默认 OpenAI",
         "fieldType": "类型",
         "fieldScope": "作用域",
+        "fieldScopePlaceholder": "如：global / school_<id>",
         "fieldModel": "模型",
+        "fieldModelPlaceholder": "如：gpt-4o-mini",
         "fieldApiBase": "API Base",
-        "fieldIsActive": "启用",
+        "fieldApiBasePlaceholder": "如：https://api.openai.com/v1（可选）",
+        "fieldApiKey": "API Key",
+        "fieldApiKeyPlaceholder": "输入 API Key",
+        "fieldApiKeyPlaceholderEdit": "留空表示不修改原有 Key",
+        "fieldApiKeyHint": "编辑模式下留空将保留原有 Key，不会清空。",
+        "fieldIsActive": "启用此 Provider",
         "submit": "保存",
-        "cancel": "取消"
+        "saving": "保存中...",
+        "cancel": "取消",
+        "errorNameRequired": "请填写名称",
+        "errorModelRequired": "请填写模型名称",
+        "errorApiBaseInvalid": "API Base 必须为合法的 http(s) URL",
+        "createSuccess": "AI Provider 已创建",
+        "updateSuccess": "AI Provider 已更新",
+        "fieldVisibility": "可见性",
+        "fieldIsDefault": "设为默认 Provider",
+        "visibilityPrivate": "仅自己可见",
+        "visibilityShared": "组织共享",
+        "visibilityPublic": "全员可见",
+        "testConnection": "测试连接",
+        "testing": "测试中...",
+        "testSuccess": "连接成功，延迟 {latency} ms",
+        "testFailed": "连接失败：{message}"
       },
       "error": {
         "title": "AI 配置模块出错了",
@@ -3387,6 +6608,10 @@
         "colCreatedAt": "创建时间",
         "colUpdatedAt": "更新时间",
         "colActions": "操作",
+        "colSemester": "学期",
+        "colProgress": "进度",
+        "progressHours": "{completed}/{total} 课时",
+        "progressPercent": "{percent}%",
         "viewDetail": "查看",
         "edit": "编辑",
         "emptyTitle": "暂无课程计划",
@@ -3416,7 +6641,77 @@
         "fieldUpdatedAt": "更新时间",
         "emptySchedule": "暂无教学进度数据",
         "emptyGoals": "暂无教学目标",
-        "emptyResources": "暂无教学资源"
+        "emptyResources": "暂无教学资源",
+        "weekPlansHint": "共 {count} 条周计划",
+        "addWeekPlan": "新建周计划",
+        "emptyWeekPlans": "暂无周计划数据",
+        "emptyWeekPlansCta": "，点击右上角新建第一条周计划",
+        "colWeek": "周次",
+        "colTopic": "主题",
+        "colHours": "课时",
+        "colChapter": "教材章节",
+        "colStatus": "状态",
+        "colActions": "操作",
+        "statusCompleted": "已完成",
+        "statusPending": "待完成",
+        "notesLabel": "备注：{notes}",
+        "moveUpAria": "上移第 {week} 周",
+        "moveDownAria": "下移第 {week} 周",
+        "editItem": "编辑",
+        "reorderSuccess": "排序已更新",
+        "delete": "删除",
+        "deleteTitle": "删除课程计划",
+        "deleteDescription": "确定要删除此课程计划吗？此操作不可撤销。",
+        "deleteConfirm": "确认删除",
+        "deleteCancel": "取消",
+        "deleteSuccess": "课程计划已删除",
+        "deleteFailed": "删除失败",
+        "fieldSemester": "学期",
+        "fieldSyllabus": "教学大纲",
+        "fieldObjectives": "教学目标",
+        "fieldTotalHours": "总课时",
+        "fieldWeeklyHours": "周课时",
+        "fieldStartDate": "开始日期",
+        "fieldEndDate": "结束日期",
+        "emptySyllabus": "暂无教学大纲",
+        "emptyObjectives": "暂无教学目标",
+        "linkTextbooks": "查看教材",
+        "linkHomework": "查看作业",
+        "bulkSelectAll": "全选",
+        "bulkMarkComplete": "批量标记完成",
+        "bulkMarkIncomplete": "批量取消完成",
+        "bulkSelected": "已选 {count} 项",
+        "bulkClear": "清空选择",
+        "bulkSuccess": "已批量更新 {count} 项",
+        "exportCsv": "导出 CSV",
+        "exportSuccess": "导出成功",
+        "exportFailed": "导出失败"
+      },
+      "itemEditor": {
+        "createTitle": "新建周计划",
+        "editTitle": "编辑周计划",
+        "week": "周次",
+        "hours": "课时",
+        "topic": "主题",
+        "topicPlaceholder": "请输入本周主题",
+        "content": "内容",
+        "contentPlaceholder": "请输入本周教学内容",
+        "chapter": "教材章节",
+        "chapterPlaceholder": "如：第3章",
+        "completedAt": "完成日期",
+        "notes": "备注",
+        "notesPlaceholder": "可选备注信息",
+        "cancel": "取消",
+        "save": "保存",
+        "saving": "保存中...",
+        "delete": "删除",
+        "markComplete": "标记完成",
+        "markIncomplete": "取消完成",
+        "errorTopicRequired": "请填写主题",
+        "createSuccess": "周计划已创建",
+        "updateSuccess": "周计划已更新",
+        "deleteSuccess": "周计划已删除",
+        "toggleSuccess": "完成状态已更新"
       },
       "create": {
         "title": "新建课程计划",
@@ -3443,7 +6738,11 @@
         "errorGradeRequired": "请选择年级",
         "errorClassRequired": "请选择班级",
         "errorSubjectRequired": "请选择科目",
-        "contractPending": "课程计划创建契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "contractPending": "课程计划创建契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "fromTemplate": "从模板创建",
+        "fromTemplateHint": "选择模板可快速填充表单字段",
+        "openTemplatePicker": "选择模板",
+        "templateApplied": "已应用模板内容"
       },
       "edit": {
         "title": "编辑课程计划",
@@ -3465,12 +6764,59 @@
         "errorClassRequired": "请选择班级",
         "errorSubjectRequired": "请选择科目",
         "notFound": "未找到该课程计划",
-        "backToDetail": "返回详情"
+        "backToDetail": "返回详情",
+        "sectionSchedule": "教学进度",
+        "scheduleNotice": "进度排序为本地编辑，保存时暂不同步到后端",
+        "scheduleEmpty": "暂无教学进度数据",
+        "colWeek": "周次",
+        "colTopic": "主题",
+        "colHours": "课时",
+        "colActions": "操作",
+        "fieldSemester": "学期",
+        "fieldSyllabus": "教学大纲",
+        "fieldObjectives": "教学目标",
+        "fieldTotalHours": "总课时",
+        "fieldWeeklyHours": "周课时",
+        "fieldStartDate": "开始日期",
+        "fieldEndDate": "结束日期"
       },
       "error": {
         "title": "课程计划模块出错了",
         "unknown": "课程计划模块发生未知错误",
         "retry": "重试"
+      },
+      "sortableWeekRow": {
+        "notes": "备注：{notes}",
+        "moveUpAria": "上移第 {week} 周",
+        "moveDownAria": "下移第 {week} 周"
+      },
+      "templates": {
+        "title": "从模板创建课程计划",
+        "description": "选择一个模板快速填充表单字段",
+        "searchPlaceholder": "搜索模板...",
+        "loading": "加载模板中...",
+        "empty": "暂无可用模板",
+        "cancel": "取消",
+        "confirm": "应用模板",
+        "errorNoSelection": "请先选择一个模板",
+        "errorApply": "应用模板失败"
+      },
+      "export": {
+        "button": "导出 CSV",
+        "filename": "课程计划",
+        "colName": "名称",
+        "colClass": "班级",
+        "colSubject": "科目",
+        "colTeacher": "教师",
+        "colAcademicYear": "学年",
+        "colStatus": "状态",
+        "colCreatedAt": "创建时间",
+        "statusDraft": "草稿",
+        "statusPublished": "已发布",
+        "statusArchived": "已归档",
+        "success": "导出成功",
+        "error": "导出失败：{message}",
+        "errorEmpty": "没有可导出的数据"
       }
     },
     "curriculumMap": {
@@ -3497,6 +6843,14 @@
         "heatmapStandards": "标准",
         "heatmapGrades": "年级",
         "heatmapCoverage": "覆盖率",
+        "heatmapLinkedTotalHint": "单元格显示覆盖率与已关联/总课时数",
+        "heatmapCellTooltip": "{standard} / {grade}：{rate}（{linked}/{total}）",
+        "legendTitle": "图例",
+        "legendHigh": "高（≥80%）",
+        "legendMedium": "中（50-80%）",
+        "legendLow": "低（20-50%）",
+        "legendCritical": "极低（<20%）",
+        "legendNone": "无覆盖",
         "emptyHeatmap": "暂无覆盖数据",
         "emptyTitle": "暂无覆盖数据",
         "emptyDescription": "暂无标准覆盖数据，请稍后再试或检查契约状态",
@@ -3534,7 +6888,40 @@
         "emptyTitle": "暂无选修课",
         "emptyDescription": "调整筛选条件或新建第一条选修课",
         "emptyAction": "新建选修课",
-        "mswNotice": "选修课列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "选修课列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "statTotalCourses": "课程总数",
+        "statTotalCapacity": "总容量",
+        "statTotalEnrolled": "已选人数",
+        "statTotalDraft": "草稿数",
+        "statTotalOpen": "报名中数",
+        "statsTitle": "选修课概览",
+        "colClassroom": "教室",
+        "colSchedule": "时间",
+        "colCredit": "学分",
+        "colSelectionMode": "选课模式",
+        "openSelection": "开放报名",
+        "closeSelection": "关闭报名",
+        "runLottery": "抽签",
+        "delete": "删除",
+        "deleteSuccess": "选修课已删除",
+        "deleteFailed": "删除失败",
+        "openSuccess": "已开放报名",
+        "closeSuccess": "已关闭报名",
+        "lotterySuccess": "抽签已完成",
+        "lotteryFailed": "抽签失败",
+        "confirmOpenTitle": "确认开放报名",
+        "confirmOpenDescription": "开放后学生可以开始选课，是否继续？",
+        "confirmCloseTitle": "确认关闭报名",
+        "confirmCloseDescription": "关闭后学生将无法选课，是否继续？",
+        "confirmLotteryTitle": "确认抽签",
+        "confirmLotteryDescription": "将对所有报名学生进行抽签分配，此操作不可撤销，是否继续？",
+        "confirmDeleteTitle": "删除选修课",
+        "confirmDeleteDescription": "确定要删除此选修课吗？此操作不可撤销。",
+        "confirmCancel": "取消",
+        "confirmSubmit": "确认",
+        "confirming": "处理中...",
+        "selectionModeFcfs": "先到先得",
+        "selectionModeLottery": "抽签"
       },
       "create": {
         "title": "新建选修课",
@@ -3555,7 +6942,16 @@
         "errorNameRequired": "名称不能为空",
         "errorSubjectRequired": "请选择科目",
         "errorCapacityInvalid": "容量必须为大于 0 的整数",
-        "contractPending": "选修课创建契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "contractPending": "选修课创建契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "fieldCredit": "学分",
+        "fieldClassroom": "教室",
+        "fieldSchedule": "上课时间",
+        "fieldSelectionMode": "选课模式",
+        "fieldSelectionStartAt": "选课开始时间",
+        "fieldSelectionEndAt": "选课结束时间",
+        "fieldDropDeadline": "退课截止时间",
+        "selectionModeFcfs": "先到先得",
+        "selectionModeLottery": "抽签"
       },
       "detail": {
         "title": "选修课详情",
@@ -3579,7 +6975,32 @@
         "enrollmentStudentName": "学生姓名",
         "enrollmentStudentNo": "学号",
         "enrollmentEnrolledAt": "选课时间",
-        "emptyEnrollment": "暂无学生选课"
+        "emptyEnrollment": "暂无学生选课",
+        "fieldClassroom": "教室",
+        "fieldSchedule": "上课时间",
+        "fieldCredit": "学分",
+        "fieldSelectionMode": "选课模式",
+        "fieldSelectionStart": "选课开始时间",
+        "fieldSelectionEnd": "选课结束时间",
+        "fieldDropDeadline": "退课截止时间",
+        "fieldPriority": "优先级",
+        "selectionModeFcfs": "先到先得",
+        "selectionModeLottery": "抽签",
+        "enrollmentPriority": "优先级",
+        "delete": "删除",
+        "deleteTitle": "删除选修课",
+        "deleteDescription": "确定要删除此选修课吗？此操作不可撤销。",
+        "deleteConfirm": "确认删除",
+        "deleteCancel": "取消",
+        "deleteSuccess": "选修课已删除",
+        "deleteFailed": "删除失败",
+        "openSelection": "开放报名",
+        "closeSelection": "关闭报名",
+        "runLottery": "抽签",
+        "openSuccess": "已开放报名",
+        "closeSuccess": "已关闭报名",
+        "lotterySuccess": "抽签已完成",
+        "lotteryFailed": "抽签失败"
       },
       "edit": {
         "title": "编辑选修课",
@@ -3601,7 +7022,16 @@
         "errorSubjectRequired": "请选择科目",
         "errorCapacityInvalid": "容量必须为大于 0 的整数",
         "notFound": "未找到该选修课",
-        "backToDetail": "返回详情"
+        "backToDetail": "返回详情",
+        "fieldCredit": "学分",
+        "fieldClassroom": "教室",
+        "fieldSchedule": "上课时间",
+        "fieldSelectionMode": "选课模式",
+        "fieldSelectionStartAt": "选课开始时间",
+        "fieldSelectionEndAt": "选课结束时间",
+        "fieldDropDeadline": "退课截止时间",
+        "selectionModeFcfs": "先到先得",
+        "selectionModeLottery": "抽签"
       },
       "error": {
         "title": "选修课模块出错了",
@@ -3691,7 +7121,79 @@
         "emptyTitle": "暂无题目",
         "emptyDescription": "调整筛选条件后重试，或新建第一条题目。",
         "emptyAction": "新建题目",
-        "mswNotice": "题库列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "题库列表查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "selectAll": "全选当前页",
+        "selectRow": "选择此行"
+      },
+      "detailDialog": {
+        "title": "题目详情",
+        "close": "关闭",
+        "retry": "重试",
+        "type": "题型",
+        "difficulty": "难度",
+        "status": "状态",
+        "subject": "学科",
+        "textbook": "教材",
+        "knowledgePoint": "知识点",
+        "content": "题目内容",
+        "noContent": "暂无题目内容",
+        "answer": "正确答案",
+        "explanation": "解析",
+        "source": "来源",
+        "createdBy": "创建者",
+        "createdAt": "创建时间",
+        "updatedAt": "更新时间",
+        "noData": "暂无详情数据"
+      },
+      "createDialog": {
+        "title": "新建题目",
+        "description": "填写题目内容、答案、解析等信息，提交后即可在题库中查看。",
+        "fieldType": "题型",
+        "fieldContent": "题干",
+        "fieldAnswer": "答案",
+        "fieldExplanation": "解析",
+        "fieldDifficulty": "难度",
+        "fieldKnowledgePoint": "知识点 ID",
+        "fieldKnowledgePointPlaceholder": "如 kp-001",
+        "fieldSource": "来源",
+        "fieldSourcePlaceholder": "如 人教版必修一（可选）",
+        "types": {
+          "single_choice": "单选题",
+          "multiple_choice": "多选题",
+          "fill_blank": "填空题",
+          "short_answer": "简答题",
+          "essay": "论述题",
+          "true_false": "判断题"
+        },
+        "difficultyEasy": "简单",
+        "difficultyMedium": "中等",
+        "difficultyHard": "困难",
+        "cancel": "取消",
+        "submit": "提交",
+        "submitting": "提交中…",
+        "success": "题目创建成功",
+        "errorContentRequired": "请填写题干内容",
+        "errorAnswerRequired": "请填写答案",
+        "errorKnowledgePointRequired": "请填写知识点 ID"
+      },
+      "importExport": {
+        "import": "导入",
+        "export": "导出",
+        "importSuccess": "已成功导入 {imported} 条，跳过 {skipped} 条",
+        "exportEmpty": "当前筛选条件下没有可导出的题目",
+        "exportSuccess": "已导出 {count} 条题目",
+        "exportFailed": "导出失败，请重试"
+      },
+      "batch": {
+        "selectedCount": "已选 {count} 项",
+        "clearSelection": "清空选择",
+        "batchDelete": "批量删除",
+        "confirmTitle": "确认批量删除",
+        "confirmDescription": "即将删除 {count} 条题目，此操作不可撤销，是否继续？",
+        "confirmCancel": "取消",
+        "confirmSubmit": "确认删除",
+        "confirming": "删除中…",
+        "deleteSuccess": "已删除 {deleted} 条，失败 {failed} 条"
       },
       "error": {
         "title": "题库模块出错了",
@@ -3711,6 +7213,7 @@
         "statusPublished": "已发布",
         "statusArchived": "已归档",
         "statusSubmitted": "已提交",
+        "statsTitle": "教案统计概览",
         "statsTotal": "教案总数",
         "statsPublished": "已发布",
         "statsDraft": "草稿",
@@ -3753,6 +7256,15 @@
         "emptyMaterials": "暂无教学材料",
         "contractPending": "资源字段契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       },
+      "delete": {
+        "button": "删除",
+        "title": "删除教案",
+        "description": "确定要删除此教案吗？删除后将标记为已归档，不再在前台展示。",
+        "confirm": "确认删除",
+        "cancel": "取消",
+        "success": "教案已删除",
+        "error": "删除教案失败，请稍后重试"
+      },
       "error": {
         "title": "教案模块出错了",
         "unknown": "教案模块发生未知错误",
@@ -3788,7 +7300,30 @@
         "topWrongQuestionsErrorCount": "错误次数",
         "emptyTitle": "暂无错题数据",
         "emptyDescription": "暂未加载到错题本统计数据，请稍后重试或调整筛选条件。",
-        "mswNotice": "错题本分析查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
+        "mswNotice": "错题本分析查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。",
+        "topWrongQuestionsActions": "操作",
+        "viewDetail": "查看详情",
+        "classDistributionTitle": "班级分布",
+        "classDistributionClass": "班级",
+        "classDistributionCount": "错误次数",
+        "exportCsv": "导出 CSV",
+        "exporting": "导出中...",
+        "exportSuccess": "已导出 {count} 条错题"
+      },
+      "detailDialog": {
+        "title": "错题详情",
+        "close": "关闭",
+        "retry": "重试",
+        "studentName": "学生姓名",
+        "className": "班级",
+        "errorCount": "错误次数",
+        "question": "题目内容",
+        "noContent": "暂无题目内容",
+        "correctAnswer": "正确答案",
+        "analysis": "解析",
+        "lastErrorTime": "最近错误时间",
+        "knowledgePoint": "知识点",
+        "noData": "暂无详情数据"
       },
       "error": {
         "title": "错题本分析模块出错了",
@@ -3874,9 +7409,11 @@
       "list": {
         "title": "考勤管理",
         "description": "全校考勤聚合分析",
+        "gradeFilter": "按年级筛选",
         "classFilter": "按班级筛选",
         "statusFilter": "按状态筛选",
         "dateFilter": "按日期筛选",
+        "allGrades": "全部年级",
         "allClasses": "全部班级",
         "allStatuses": "全部状态",
         "statusPresent": "出勤",
@@ -3890,6 +7427,17 @@
         "statsEarlyLeaveRate": "早退率",
         "statsAbnormalRate": "异常率",
         "statsAvgCorrelation": "平均相关系数",
+        "recordsTitle": "考勤记录",
+        "recordsDescription": "按筛选条件展示考勤明细",
+        "recordsTotal": "共 {count} 条记录",
+        "recordsEmptyTitle": "暂无考勤记录",
+        "recordsEmptyDescription": "暂未加载到考勤记录，请稍后重试或调整筛选条件。",
+        "colStudent": "学生",
+        "colClass": "班级",
+        "colDate": "日期",
+        "colStatus": "状态",
+        "colNote": "备注",
+        "colRecorder": "记录人",
         "classComparisonTitle": "班级对比",
         "classComparisonClass": "班级",
         "classComparisonRate": "出勤率",
@@ -3900,6 +7448,56 @@
         "emptyDescription": "暂未加载到考勤统计数据，请稍后重试或调整筛选条件。",
         "mswNotice": "考勤统计查询契约待补齐，请确认 NEXT_PUBLIC_MSW=1 已启用。"
       },
+      "classComparison": {
+        "title": "班级出勤率对比",
+        "description": "各班级出勤率横向对比与排名",
+        "updatedAt": "更新于 {time}",
+        "errorNotification": "加载班级对比数据失败",
+        "errorTitle": "加载失败",
+        "errorDescription": "班级对比数据加载失败，请稍后重试。",
+        "emptyTitle": "暂无班级对比数据",
+        "emptyDescription": "暂未加载到班级对比数据，请稍后重试。",
+        "seriesRate": "出勤率",
+        "colRank": "排名",
+        "colClass": "班级",
+        "colTotal": "总人数",
+        "colPresent": "出勤人数",
+        "colRate": "出勤率",
+        "colBadge": "等级",
+        "badgeHigh": "优秀",
+        "badgeMid": "一般",
+        "badgeLow": "偏低"
+      },
+      "gradeCorrelation": {
+        "title": "考勤-成绩关联分析",
+        "description": "班级出勤率与平均成绩的关联性分析",
+        "errorNotification": "加载考勤-成绩关联数据失败",
+        "errorTitle": "加载失败",
+        "errorDescription": "考勤-成绩关联数据加载失败，请稍后重试。",
+        "emptyTitle": "暂无关联数据",
+        "emptyDescription": "暂未加载到考勤-成绩关联数据，请稍后重试。",
+        "summaryAvgCorrelation": "平均相关系数",
+        "summaryAvgCorrelationDesc": "出勤率与成绩的线性相关程度",
+        "summaryStrong": "强相关班级",
+        "summaryMedium": "中等相关班级",
+        "summaryWeak": "弱相关班级",
+        "scatterTitle": "出勤率-成绩散点图",
+        "xAxisLabel": "出勤率",
+        "yAxisLabel": "平均成绩",
+        "scatterSeries": "班级",
+        "legendStrong": "强相关 (>=0.7)",
+        "legendMedium": "中等相关 (0.4-0.7)",
+        "legendWeak": "弱相关 (<0.4)",
+        "detailsTitle": "班级明细",
+        "colClass": "班级",
+        "colAttendanceRate": "出勤率",
+        "colAvgScore": "平均成绩",
+        "colCorrelation": "相关系数",
+        "colTier": "关联等级",
+        "badgeStrong": "强相关",
+        "badgeMedium": "中等",
+        "badgeWeak": "弱相关"
+      },
       "error": {
         "title": "考勤管理模块出错了",
         "unknown": "考勤管理模块发生未知错误",
diff --git a/apps/portal-shell/src/mocks/graphql-data.ts b/apps/portal-shell/src/mocks/graphql-data.ts
index 7eafcf1..40aea20 100644
--- a/apps/portal-shell/src/mocks/graphql-data.ts
+++ b/apps/portal-shell/src/mocks/graphql-data.ts
@@ -151,6 +151,8 @@ const mockUsers = {
       name: "张老师",
       email: "zhang@edu.cn",
       role: "teacher",
+      roles: ["teacher"],
+      phone: "13800000001",
       status: "active",
       createdAt: "2026-06-01T00:00:00Z",
     },
@@ -159,6 +161,8 @@ const mockUsers = {
       name: "李老师",
       email: "li@edu.cn",
       role: "teacher",
+      roles: ["teacher", "parent"],
+      phone: "13800000002",
       status: "active",
       createdAt: "2026-06-15T00:00:00Z",
     },
@@ -167,6 +171,8 @@ const mockUsers = {
       name: "管理员",
       email: "admin@edu.cn",
       role: "admin",
+      roles: ["admin"],
+      phone: "13800000003",
       status: "active",
       createdAt: "2026-05-01T00:00:00Z",
     },
@@ -175,6 +181,8 @@ const mockUsers = {
       name: "王同学",
       email: "wang@edu.cn",
       role: "student",
+      roles: ["student"],
+      phone: "13800000004",
       status: "active",
       createdAt: "2026-07-01T00:00:00Z",
     },
@@ -183,6 +191,8 @@ const mockUsers = {
       name: "赵家长",
       email: "zhao@edu.cn",
       role: "parent",
+      roles: ["parent"],
+      phone: "13800000005",
       status: "suspended",
       createdAt: "2026-07-10T00:00:00Z",
     },
@@ -243,6 +253,8 @@ const mockSchools = [
     email: "admin@no1.edu.cn",
     currentAcademicYear: "2026-2027",
     currentTerm: "第一学期",
+    code: "SCH-001",
+    updatedAt: "2026-07-15T10:30:00Z",
   },
   {
     id: "sch-002",
@@ -252,6 +264,8 @@ const mockSchools = [
     email: "admin@no2.edu.cn",
     currentAcademicYear: "2026-2027",
     currentTerm: "第一学期",
+    code: "SCH-002",
+    updatedAt: "2026-07-14T08:20:00Z",
   },
 ];
 
@@ -264,6 +278,8 @@ const mockDepartments = [
     headId: "usr-001",
     headName: "张老师",
     memberCount: 12,
+    description: "负责全校数学课程教学与教研活动",
+    updatedAt: "2026-07-10T14:00:00Z",
   },
   {
     id: "dept-002",
@@ -272,6 +288,8 @@ const mockDepartments = [
     headId: "usr-002",
     headName: "李老师",
     memberCount: 10,
+    description: "负责全校语文课程教学与教研活动",
+    updatedAt: "2026-07-09T09:30:00Z",
   },
   {
     id: "dept-003",
@@ -280,6 +298,8 @@ const mockDepartments = [
     headId: "usr-006",
     headName: "陈老师",
     memberCount: 8,
+    description: "负责全校英语课程教学与教研活动",
+    updatedAt: "2026-07-08T16:00:00Z",
   },
 ];
 
@@ -314,6 +334,10 @@ const mockAdminGrades = [
     headStaffName: "王主任",
     classCount: 8,
     studentCount: 320,
+    order: 10,
+    teachingHead: "staff-004",
+    teachingHeadName: "孙教学主任",
+    updatedAt: "2026-07-12T11:00:00Z",
   },
   {
     id: "grade-11",
@@ -324,6 +348,10 @@ const mockAdminGrades = [
     headStaffName: "刘主任",
     classCount: 8,
     studentCount: 315,
+    order: 11,
+    teachingHead: "staff-005",
+    teachingHeadName: "周教学主任",
+    updatedAt: "2026-07-11T15:30:00Z",
   },
   {
     id: "grade-12",
@@ -334,6 +362,10 @@ const mockAdminGrades = [
     headStaffName: "赵主任",
     classCount: 6,
     studentCount: 240,
+    order: 12,
+    teachingHead: "",
+    teachingHeadName: "",
+    updatedAt: "2026-07-10T09:00:00Z",
   },
 ];
 
@@ -350,6 +382,12 @@ const mockAdminClasses = [
     headTeacherName: "张老师",
     studentCount: 38,
     subjectCount: 9,
+    homeroomLabel: "1班",
+    room: "301",
+    homeroom: "usr-001",
+    homeroomName: "张老师",
+    subjectTeachers: "张老师、李老师、陈老师",
+    updatedAt: "2026-07-12T10:00:00Z",
   },
   {
     id: "cls-002",
@@ -362,6 +400,12 @@ const mockAdminClasses = [
     headTeacherName: "李老师",
     studentCount: 40,
     subjectCount: 9,
+    homeroomLabel: "2班",
+    room: "302",
+    homeroom: "usr-002",
+    homeroomName: "李老师",
+    subjectTeachers: "李老师、王老师、刘老师",
+    updatedAt: "2026-07-12T10:30:00Z",
   },
   {
     id: "cls-003",
@@ -374,6 +418,12 @@ const mockAdminClasses = [
     headTeacherName: "陈老师",
     studentCount: 42,
     subjectCount: 9,
+    homeroomLabel: "1班",
+    room: "201",
+    homeroom: "usr-006",
+    homeroomName: "陈老师",
+    subjectTeachers: "陈老师、赵老师、孙老师",
+    updatedAt: "2026-07-11T16:00:00Z",
   },
 ];
 
@@ -404,6 +454,7 @@ const mockAdminAnnouncements = {
       createdAt: "2026-07-19T10:00:00Z",
       updatedAt: "2026-07-20T08:00:00Z",
       authorName: "王主任",
+      readCount: 128,
     },
     {
       id: "ann-002",
@@ -416,6 +467,7 @@ const mockAdminAnnouncements = {
       createdAt: "2026-07-18T15:30:00Z",
       updatedAt: "2026-07-18T15:30:00Z",
       authorName: "刘主任",
+      readCount: 0,
     },
     {
       id: "ann-003",
@@ -428,11 +480,72 @@ const mockAdminAnnouncements = {
       createdAt: "2026-07-04T14:00:00Z",
       updatedAt: "2026-07-18T10:00:00Z",
       authorName: "赵主任",
+      readCount: 256,
     },
   ],
   total: 3,
 };
 
+// mockInvitationCodes: 邀请码列表
+const mockInvitationCodes = [
+  {
+    id: "inv-001",
+    code: "EDU-TEACHER-001",
+    role: "teacher",
+    roleName: "教师",
+    classId: null,
+    className: null,
+    email: null,
+    batchId: "batch-001",
+    status: "unused",
+    usedCount: 0,
+    maxUses: 1,
+    usedBy: null,
+    usedByName: null,
+    usedAt: null,
+    expiresAt: "2026-08-31T23:59:59Z",
+    createdAt: "2026-07-20T10:00:00Z",
+    createdBy: "管理员",
+  },
+  {
+    id: "inv-002",
+    code: "EDU-STUDENT-002",
+    role: "student",
+    roleName: "学生",
+    classId: "cls-001",
+    className: "高一(1)班",
+    email: null,
+    batchId: "batch-001",
+    status: "used",
+    usedCount: 1,
+    maxUses: 1,
+    usedBy: "usr-101",
+    usedByName: "张学生",
+    usedAt: "2026-07-21T14:30:00Z",
+    expiresAt: "2026-08-31T23:59:59Z",
+    createdAt: "2026-07-20T10:00:00Z",
+    createdBy: "管理员",
+  },
+  {
+    id: "inv-003",
+    code: "EDU-TEACHER-003",
+    role: "teacher",
+    roleName: "教师",
+    classId: null,
+    className: null,
+    email: "teacher@example.com",
+    batchId: "batch-002",
+    status: "unused",
+    usedCount: 0,
+    maxUses: 1,
+    usedBy: null,
+    usedByName: null,
+    usedAt: null,
+    expiresAt: "2026-09-15T23:59:59Z",
+    createdAt: "2026-07-22T09:00:00Z",
+    createdBy: "管理员",
+  },
+];
 // mockFileAttachments：文件附件列表
 const mockFileAttachments = {
   items: [
@@ -491,11 +604,11 @@ const mockFileAttachments = {
 const mockAiProviders = [
   {
     id: "aip-001",
-    name: "豆包大模型",
-    type: "doubao",
+    name: "智谱 GLM",
+    type: "zhipu",
     scope: "school",
-    private: false,
-    public: true,
+    visibility: "school",
+    isDefault: true,
     ownerId: "sch-001",
     isActive: true,
     model: "doubao-pro-4k",
@@ -505,11 +618,11 @@ const mockAiProviders = [
   },
   {
     id: "aip-002",
-    name: "DeepSeek",
-    type: "deepseek",
+    name: "OpenAI GPT",
+    type: "openai",
     scope: "personal",
-    private: true,
-    public: false,
+    visibility: "private",
+    isDefault: false,
     ownerId: "usr-001",
     isActive: true,
     model: "deepseek-chat",
@@ -519,11 +632,11 @@ const mockAiProviders = [
   },
   {
     id: "aip-003",
-    name: "通义千问",
-    type: "qwen",
+    name: "Google Gemini",
+    type: "gemini",
     scope: "global",
-    private: false,
-    public: true,
+    visibility: "public",
+    isDefault: false,
     ownerId: "system",
     isActive: false,
     model: "qwen-max",
@@ -766,10 +879,26 @@ const mockAdminCoursePlans = {
       id: "cp-001",
       name: "高三数学复习计划",
       gradeId: "grade-12",
+      classId: "cls-001",
+      className: "高三(1)班",
       subjectId: "sub-math",
+      subjectName: "数学",
+      teacherId: "usr-001",
+      teacherName: "张老师",
+      academicYearId: "ay-2026",
+      academicYearName: "2026-2027 学年",
       semester: "2026-fall",
       status: "PUBLISHED",
       description: "覆盖函数、导数、概率统计三大模块",
+      totalHours: 120,
+      completedHours: 48,
+      weeklyHours: 6,
+      startDate: "2026-09-01",
+      endDate: "2027-01-15",
+      syllabus: "函数与导数、三角函数、数列、立体几何、解析几何、概率统计",
+      objectives: "掌握高考数学核心考点，能综合应用解题",
+      textbooksHref: "/shell/admin/textbooks?subject=sub-math",
+      homeworkHref: "/shell/admin/homework?classId=cls-001",
       createdAt: "2026-07-01T00:00:00Z",
       updatedAt: "2026-07-15T00:00:00Z",
     },
@@ -777,10 +906,26 @@ const mockAdminCoursePlans = {
       id: "cp-002",
       name: "高二数学教学计划",
       gradeId: "grade-11",
+      classId: "cls-002",
+      className: "高二(1)班",
       subjectId: "sub-math",
+      subjectName: "数学",
+      teacherId: "usr-002",
+      teacherName: "李老师",
+      academicYearId: "ay-2026",
+      academicYearName: "2026-2027 学年",
       semester: "2026-fall",
       status: "DRAFT",
       description: "立体几何与解析几何",
+      totalHours: 96,
+      completedHours: 0,
+      weeklyHours: 5,
+      startDate: "2026-09-01",
+      endDate: "2027-01-15",
+      syllabus: "立体几何、解析几何、概率初步",
+      objectives: "建立空间想象力与代数推理能力",
+      textbooksHref: "/shell/admin/textbooks?subject=sub-math",
+      homeworkHref: "/shell/admin/homework?classId=cls-002",
       createdAt: "2026-07-05T00:00:00Z",
       updatedAt: "2026-07-18T00:00:00Z",
     },
@@ -788,10 +933,26 @@ const mockAdminCoursePlans = {
       id: "cp-003",
       name: "高三语文教学计划",
       gradeId: "grade-12",
+      classId: "cls-003",
+      className: "高三(2)班",
       subjectId: "sub-chinese",
+      subjectName: "语文",
+      teacherId: "usr-003",
+      teacherName: "王老师",
+      academicYearId: "ay-2026",
+      academicYearName: "2026-2027 学年",
       semester: "2026-fall",
       status: "PUBLISHED",
       description: "古诗文与现代文阅读",
+      totalHours: 108,
+      completedHours: 36,
+      weeklyHours: 5,
+      startDate: "2026-09-01",
+      endDate: "2027-01-15",
+      syllabus: "古诗文鉴赏、现代文阅读、写作训练、语言文字应用",
+      objectives: "提升文本解读能力与写作表达能力",
+      textbooksHref: "/shell/admin/textbooks?subject=sub-chinese",
+      homeworkHref: "/shell/admin/homework?classId=cls-003",
       createdAt: "2026-06-20T00:00:00Z",
       updatedAt: "2026-07-10T00:00:00Z",
     },
@@ -799,10 +960,26 @@ const mockAdminCoursePlans = {
       id: "cp-004",
       name: "高二英语教学计划",
       gradeId: "grade-11",
+      classId: "cls-004",
+      className: "高二(2)班",
       subjectId: "sub-english",
+      subjectName: "英语",
+      teacherId: "usr-006",
+      teacherName: "陈老师",
+      academicYearId: "ay-2026",
+      academicYearName: "2026-2027 学年",
       semester: "2026-fall",
       status: "PUBLISHED",
       description: "听说读写综合训练",
+      totalHours: 100,
+      completedHours: 24,
+      weeklyHours: 5,
+      startDate: "2026-09-01",
+      endDate: "2027-01-15",
+      syllabus: "听力训练、口语表达、阅读理解、写作技巧、语法专题",
+      objectives: "全面提升英语综合应用能力",
+      textbooksHref: "/shell/admin/textbooks?subject=sub-english",
+      homeworkHref: "/shell/admin/homework?classId=cls-004",
       createdAt: "2026-06-25T00:00:00Z",
       updatedAt: "2026-07-12T00:00:00Z",
     },
@@ -810,6 +987,133 @@ const mockAdminCoursePlans = {
   total: 4,
 };
 
+// mockAdminCoursePlanItems：管理端课程计划周计划项（in-memory store，可被 mutation 修改）
+const mockAdminCoursePlanItems: Record<
+  string,
+  Array<{
+    id: string;
+    planId: string;
+    week: number;
+    topic: string;
+    content: string | null;
+    hours: number;
+    textbookChapter: string | null;
+    notes: string | null;
+    isCompleted: boolean;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+  }>
+> = {
+  "cp-001": [
+    {
+      id: "cpi-001-1",
+      planId: "cp-001",
+      week: 1,
+      topic: "集合与函数概念",
+      content: "集合的表示、函数的定义域与值域",
+      hours: 4,
+      textbookChapter: "第1章",
+      notes: "建议结合实例引入",
+      isCompleted: true,
+      completedAt: "2026-07-05T00:00:00Z",
+      createdAt: "2026-07-01T00:00:00Z",
+      updatedAt: "2026-07-05T00:00:00Z",
+    },
+    {
+      id: "cpi-001-2",
+      planId: "cp-001",
+      week: 2,
+      topic: "函数的基本性质",
+      content: "单调性、奇偶性、周期性",
+      hours: 4,
+      textbookChapter: "第2章",
+      notes: null,
+      isCompleted: true,
+      completedAt: "2026-07-12T00:00:00Z",
+      createdAt: "2026-07-01T00:00:00Z",
+      updatedAt: "2026-07-12T00:00:00Z",
+    },
+    {
+      id: "cpi-001-3",
+      planId: "cp-001",
+      week: 3,
+      topic: "指数函数与对数函数",
+      content: "指数运算、对数运算、图像与性质",
+      hours: 6,
+      textbookChapter: "第3章",
+      notes: "重点突破图像变换",
+      isCompleted: false,
+      completedAt: null,
+      createdAt: "2026-07-01T00:00:00Z",
+      updatedAt: "2026-07-15T00:00:00Z",
+    },
+  ],
+};
+
+function getCoursePlanItems(planId: string): Array<{
+  id: string;
+  planId: string;
+  week: number;
+  topic: string;
+  content: string | null;
+  hours: number;
+  textbookChapter: string | null;
+  notes: string | null;
+  isCompleted: boolean;
+  completedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}> {
+  if (!mockAdminCoursePlanItems[planId]) {
+    mockAdminCoursePlanItems[planId] = [
+      {
+        id: planId + "-cpi-1",
+        planId,
+        week: 1,
+        topic: "模块一 导入",
+        content: null,
+        hours: 2,
+        textbookChapter: null,
+        notes: null,
+        isCompleted: false,
+        completedAt: null,
+        createdAt: "2026-07-22T00:00:00Z",
+        updatedAt: "2026-07-22T00:00:00Z",
+      },
+      {
+        id: planId + "-cpi-2",
+        planId,
+        week: 2,
+        topic: "模块二 基础",
+        content: null,
+        hours: 3,
+        textbookChapter: null,
+        notes: null,
+        isCompleted: false,
+        completedAt: null,
+        createdAt: "2026-07-22T00:00:00Z",
+        updatedAt: "2026-07-22T00:00:00Z",
+      },
+      {
+        id: planId + "-cpi-3",
+        planId,
+        week: 3,
+        topic: "模块三 进阶",
+        content: null,
+        hours: 3,
+        textbookChapter: null,
+        notes: null,
+        isCompleted: false,
+        completedAt: null,
+        createdAt: "2026-07-22T00:00:00Z",
+        updatedAt: "2026-07-22T00:00:00Z",
+      },
+    ];
+  }
+  return [...mockAdminCoursePlanItems[planId]].sort((a, b) => a.week - b.week);
+}
+
 // mockAdminLessonPlans：管理端教案列表
 const mockAdminLessonPlans = {
   items: [
@@ -866,12 +1170,26 @@ const mockAdminElectives = {
       description: "通过游戏化方式学习数学",
       capacity: 30,
       enrolledCount: 25,
+      selectedCount: 25,
       semester: "2026-fall",
       gradeLevel: "grade-10",
+      gradeId: "grade-10",
+      gradeName: "高一",
       subject: "数学",
+      subjectId: "sub-math",
+      subjectName: "数学",
       teacherId: "usr-001",
       teacherName: "张老师",
-      status: "PUBLISHED",
+      classroom: "A-301",
+      schedule: "周三下午 7-8 节",
+      credit: 2,
+      selectionMode: "FIRST_COME",
+      selectionStartAt: "2026-09-05T00:00:00Z",
+      selectionEndAt: "2026-09-15T23:59:59Z",
+      dropDeadline: "2026-09-20T23:59:59Z",
+      startDate: "2026-09-22",
+      endDate: "2027-01-15",
+      status: "OPEN",
       createdAt: "2026-06-15T00:00:00Z",
       updatedAt: "2026-07-10T00:00:00Z",
     },
@@ -881,12 +1199,26 @@ const mockAdminElectives = {
       description: "沉浸式英语口语训练",
       capacity: 20,
       enrolledCount: 18,
+      selectedCount: 18,
       semester: "2026-fall",
       gradeLevel: "grade-10",
+      gradeId: "grade-10",
+      gradeName: "高一",
       subject: "英语",
+      subjectId: "sub-english",
+      subjectName: "英语",
       teacherId: "usr-006",
       teacherName: "陈老师",
-      status: "PUBLISHED",
+      classroom: "B-205",
+      schedule: "周四下午 7-8 节",
+      credit: 2,
+      selectionMode: "FIRST_COME",
+      selectionStartAt: "2026-09-05T00:00:00Z",
+      selectionEndAt: "2026-09-15T23:59:59Z",
+      dropDeadline: "2026-09-20T23:59:59Z",
+      startDate: "2026-09-22",
+      endDate: "2027-01-15",
+      status: "FULL",
       createdAt: "2026-06-18T00:00:00Z",
       updatedAt: "2026-07-12T00:00:00Z",
     },
@@ -896,11 +1228,25 @@ const mockAdminElectives = {
       description: "动手实验理解物理原理",
       capacity: 25,
       enrolledCount: 0,
+      selectedCount: 0,
       semester: "2026-fall",
       gradeLevel: "grade-11",
+      gradeId: "grade-11",
+      gradeName: "高二",
       subject: "物理",
+      subjectId: "sub-physics",
+      subjectName: "物理",
       teacherId: "usr-008",
       teacherName: "吴老师",
+      classroom: "实验楼 C-101",
+      schedule: "周二下午 7-8 节",
+      credit: 3,
+      selectionMode: "LOTTERY",
+      selectionStartAt: "2026-09-05T00:00:00Z",
+      selectionEndAt: "2026-09-15T23:59:59Z",
+      dropDeadline: "2026-09-20T23:59:59Z",
+      startDate: "2026-09-22",
+      endDate: "2027-01-15",
       status: "DRAFT",
       createdAt: "2026-07-01T00:00:00Z",
       updatedAt: "2026-07-15T00:00:00Z",
@@ -1049,7 +1395,8 @@ const mockSchedulingRules = [
   },
 ];
 
-// mockAdminAttendanceRecords：管理端考勤记录列表
+// mockAdminAttendanceRecords：管理端考勤记录列表（含 gradeId 字段以支持年级筛选，
+// 字段名对齐 AdminAttendanceRecord 类型：note/recordedBy，便于分页与筛选演示）
 const mockAdminAttendanceRecords = {
   items: [
     {
@@ -1058,10 +1405,11 @@ const mockAdminAttendanceRecords = {
       studentName: "张明",
       classId: "cls-001",
       className: "高三(1)班",
+      gradeId: "grade-12",
       date: "2026-07-22",
       status: "present",
-      remark: "",
-      recordedAt: "2026-07-22T08:10:00Z",
+      note: "",
+      recordedBy: "张老师",
     },
     {
       id: "att-002",
@@ -1069,10 +1417,11 @@ const mockAdminAttendanceRecords = {
       studentName: "李华",
       classId: "cls-001",
       className: "高三(1)班",
+      gradeId: "grade-12",
       date: "2026-07-22",
       status: "late",
-      remark: "迟到 10 分钟",
-      recordedAt: "2026-07-22T08:20:00Z",
+      note: "迟到 10 分钟",
+      recordedBy: "张老师",
     },
     {
       id: "att-003",
@@ -1080,10 +1429,11 @@ const mockAdminAttendanceRecords = {
       studentName: "王芳",
       classId: "cls-001",
       className: "高三(1)班",
+      gradeId: "grade-12",
       date: "2026-07-22",
       status: "absent",
-      remark: "病假",
-      recordedAt: "2026-07-22T08:00:00Z",
+      note: "病假",
+      recordedBy: "张老师",
     },
     {
       id: "att-004",
@@ -1091,10 +1441,11 @@ const mockAdminAttendanceRecords = {
       studentName: "赵六",
       classId: "cls-002",
       className: "高三(2)班",
+      gradeId: "grade-12",
       date: "2026-07-22",
-      status: "early_leave",
-      remark: "家中有事早退",
-      recordedAt: "2026-07-22T15:30:00Z",
+      status: "leave",
+      note: "事假",
+      recordedBy: "李老师",
     },
     {
       id: "att-005",
@@ -1102,13 +1453,134 @@ const mockAdminAttendanceRecords = {
       studentName: "钱七",
       classId: "cls-003",
       className: "高二(1)班",
+      gradeId: "grade-11",
       date: "2026-07-22",
       status: "present",
-      remark: "",
-      recordedAt: "2026-07-22T08:05:00Z",
+      note: "",
+      recordedBy: "王老师",
+    },
+    {
+      id: "att-006",
+      studentId: "stu-006",
+      studentName: "孙八",
+      classId: "cls-003",
+      className: "高二(1)班",
+      gradeId: "grade-11",
+      date: "2026-07-22",
+      status: "late",
+      note: "迟到 5 分钟",
+      recordedBy: "王老师",
+    },
+    {
+      id: "att-007",
+      studentId: "stu-007",
+      studentName: "周九",
+      classId: "cls-004",
+      className: "高二(2)班",
+      gradeId: "grade-11",
+      date: "2026-07-22",
+      status: "absent",
+      note: "旷课",
+      recordedBy: "陈老师",
+    },
+    {
+      id: "att-008",
+      studentId: "stu-008",
+      studentName: "吴十",
+      classId: "cls-005",
+      className: "高一(1)班",
+      gradeId: "grade-10",
+      date: "2026-07-22",
+      status: "present",
+      note: "",
+      recordedBy: "刘老师",
+    },
+    {
+      id: "att-009",
+      studentId: "stu-009",
+      studentName: "郑一",
+      classId: "cls-005",
+      className: "高一(1)班",
+      gradeId: "grade-10",
+      date: "2026-07-22",
+      status: "leave",
+      note: "事假",
+      recordedBy: "刘老师",
+    },
+    {
+      id: "att-010",
+      studentId: "stu-010",
+      studentName: "王二",
+      classId: "cls-001",
+      className: "高三(1)班",
+      gradeId: "grade-12",
+      date: "2026-07-23",
+      status: "present",
+      note: "",
+      recordedBy: "张老师",
+    },
+    {
+      id: "att-011",
+      studentId: "stu-011",
+      studentName: "冯三",
+      classId: "cls-002",
+      className: "高三(2)班",
+      gradeId: "grade-12",
+      date: "2026-07-23",
+      status: "late",
+      note: "迟到 8 分钟",
+      recordedBy: "李老师",
+    },
+    {
+      id: "att-012",
+      studentId: "stu-012",
+      studentName: "陈四",
+      classId: "cls-003",
+      className: "高二(1)班",
+      gradeId: "grade-11",
+      date: "2026-07-23",
+      status: "present",
+      note: "",
+      recordedBy: "王老师",
+    },
+    {
+      id: "att-013",
+      studentId: "stu-013",
+      studentName: "褚五",
+      classId: "cls-004",
+      className: "高二(2)班",
+      gradeId: "grade-11",
+      date: "2026-07-23",
+      status: "absent",
+      note: "病假",
+      recordedBy: "陈老师",
+    },
+    {
+      id: "att-014",
+      studentId: "stu-014",
+      studentName: "卫六",
+      classId: "cls-005",
+      className: "高一(1)班",
+      gradeId: "grade-10",
+      date: "2026-07-23",
+      status: "present",
+      note: "",
+      recordedBy: "刘老师",
+    },
+    {
+      id: "att-015",
+      studentId: "stu-015",
+      studentName: "蒋七",
+      classId: "cls-001",
+      className: "高三(1)班",
+      gradeId: "grade-12",
+      date: "2026-07-23",
+      status: "leave",
+      note: "事假",
+      recordedBy: "张老师",
     },
   ],
-  total: 5,
+  total: 15,
 };
 
 // mockLoginLogs：登录日志（分页）
@@ -1123,6 +1595,7 @@ const mockLoginLogs = {
       ip: "192.168.1.10",
       userAgent: "Mozilla/5.0 (Windows NT 10.0)",
       timestamp: "2026-07-22T08:00:00Z",
+      errorMessage: null,
     },
     {
       id: "log-002",
@@ -1133,6 +1606,7 @@ const mockLoginLogs = {
       ip: "192.168.1.11",
       userAgent: "Mozilla/5.0 (Macintosh)",
       timestamp: "2026-07-22T08:15:00Z",
+      errorMessage: "密码错误，剩余 3 次尝试机会",
     },
     {
       id: "log-003",
@@ -1143,6 +1617,7 @@ const mockLoginLogs = {
       ip: "10.0.0.1",
       userAgent: "Mozilla/5.0 (X11; Linux)",
       timestamp: "2026-07-22T09:00:00Z",
+      errorMessage: null,
     },
     {
       id: "log-004",
@@ -1153,6 +1628,7 @@ const mockLoginLogs = {
       ip: "192.168.1.10",
       userAgent: "Mozilla/5.0 (Windows NT 10.0)",
       timestamp: "2026-07-22T17:30:00Z",
+      errorMessage: null,
     },
     {
       id: "log-005",
@@ -1163,6 +1639,7 @@ const mockLoginLogs = {
       ip: "192.168.1.20",
       userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS)",
       timestamp: "2026-07-22T10:00:00Z",
+      errorMessage: null,
     },
   ],
   total: 5,
@@ -1180,6 +1657,8 @@ const mockDataChangeLogs = {
       userName: "管理员",
       changes: { status: "active", role: "teacher" },
       timestamp: "2026-07-22T10:00:00Z",
+      oldValue: JSON.stringify({ status: "inactive", role: "student" }),
+      newValue: JSON.stringify({ status: "active", role: "teacher" }),
     },
     {
       id: "dcl-002",
@@ -1190,6 +1669,8 @@ const mockDataChangeLogs = {
       userName: "管理员",
       changes: { name: "teacher", permissions: ["perm-003"] },
       timestamp: "2026-07-22T11:00:00Z",
+      oldValue: null,
+      newValue: JSON.stringify({ name: "teacher", permissions: ["perm-003"] }),
     },
     {
       id: "dcl-003",
@@ -1200,6 +1681,12 @@ const mockDataChangeLogs = {
       userName: "管理员",
       changes: null,
       timestamp: "2026-07-22T14:00:00Z",
+      oldValue: JSON.stringify({
+        id: "cls-003",
+        name: "高三(2)班",
+        grade: "12",
+      }),
+      newValue: null,
     },
     {
       id: "dcl-004",
@@ -1210,6 +1697,14 @@ const mockDataChangeLogs = {
       userName: "张老师",
       changes: { headStaffId: "staff-003", headStaffName: "赵主任" },
       timestamp: "2026-07-22T15:30:00Z",
+      oldValue: JSON.stringify({
+        headStaffId: "staff-001",
+        headStaffName: "钱主任",
+      }),
+      newValue: JSON.stringify({
+        headStaffId: "staff-003",
+        headStaffName: "赵主任",
+      }),
     },
     {
       id: "dcl-005",
@@ -1220,6 +1715,11 @@ const mockDataChangeLogs = {
       userName: "王主任",
       changes: { title: "2026 年秋季开学通知", status: "published" },
       timestamp: "2026-07-20T08:00:00Z",
+      oldValue: null,
+      newValue: JSON.stringify({
+        title: "2026 年秋季开学通知",
+        status: "published",
+      }),
     },
   ],
   total: 5,
@@ -4713,34 +5213,55 @@ const mockStudentPracticeSession = {
   },
 };
 
-const mockStudentLeave = {
-  studentLeave: {
-    items: [
-      {
-        id: "sl-001",
-        startDate: "2026-07-21",
-        endDate: "2026-07-21",
-        type: "personal",
-        reason: "家中有事",
-        status: "approved",
-      },
-      {
-        id: "sl-002",
-        startDate: "2026-06-15",
-        endDate: "2026-06-16",
-        type: "sick",
-        reason: "感冒发烧",
-        status: "approved",
-      },
-      {
-        id: "sl-003",
-        startDate: "2026-07-28",
-        endDate: "2026-07-28",
-        type: "personal",
-        reason: "参加竞赛",
-        status: "pending",
-      },
-    ],
+const mockStudentLeaveItems = [
+  {
+    id: "sl-001",
+    startDate: "2026-07-21",
+    endDate: "2026-07-21",
+    type: "personal",
+    reason: "家中有事",
+    status: "approved",
+  },
+  {
+    id: "sl-002",
+    startDate: "2026-06-15",
+    endDate: "2026-06-16",
+    type: "sick",
+    reason: "感冒发烧",
+    status: "approved",
+  },
+  {
+    id: "sl-003",
+    startDate: "2026-07-28",
+    endDate: "2026-07-28",
+    type: "personal",
+    reason: "参加竞赛",
+    status: "pending",
+  },
+];
+
+const mockUserProfile = {
+  userProfile: {
+    id: "dev-user-001",
+    name: "张老师",
+    email: "teacher@edu.example.com",
+    phone: "13812345678",
+    avatar: "",
+    role: "teacher",
+    gender: "male",
+    age: 35,
+    address: "北京市海淀区中关村大街 1 号",
+    createdAt: "2024-09-01T08:00:00Z",
+    onboardedAt: "2024-09-02T10:30:00Z",
+    student: null,
+    teacher: {
+      courses: [
+        { id: "course-001", name: "高中数学", subject: "数学" },
+        { id: "course-002", name: "高中物理", subject: "物理" },
+      ],
+      classCount: 3,
+      studentCount: 120,
+    },
   },
 };
 
@@ -5020,6 +5541,19 @@ export interface GraphQLRequestBody {
   variables?: Record<string, unknown>;
 }
 
+/**
+ * CSV 字段转义纯函数（RFC 4180 简化版）。
+ * 含逗号/引号/换行的字段用双引号包裹，内部双引号转义为两个双引号。
+ */
+function escapeCsvField(value: string | null | undefined): string {
+  if (value == null) return "";
+  const str = String(value);
+  if (/[",\n\r]/.test(str)) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}
+
 /**
  * 根据 operationName + variables 返回 mock GraphQL 响应。
  *
@@ -5083,6 +5617,26 @@ export function graphqlResponse(
       };
     case "UpdateUserRole":
       return { data: { updateUserRole: { id: "usr-001", role: "admin" } } };
+    case "DeleteUser":
+      return {
+        data: {
+          deleteUser: {
+            id: (variables as { id?: string }).id ?? "usr-001",
+            success: true,
+          },
+        },
+      };
+    case "AssignUserRoles":
+      return {
+        data: {
+          assignUserRoles: {
+            userId: (variables as { userId?: string }).userId ?? "usr-001",
+            roleNames: (variables as { roleNames?: string[] }).roleNames ?? [
+              "teacher",
+            ],
+          },
+        },
+      };
     case "GetRoles":
       return {
         data: {
@@ -5090,6 +5644,11 @@ export function graphqlResponse(
             {
               id: "role-001",
               name: "admin",
+              description: "系统管理员（锁定）",
+              isLocked: true,
+              isEnabled: true,
+              userCount: 2,
+              updatedAt: "2026-07-20T08:00:00Z",
               permissions: [
                 {
                   id: "perm-001",
@@ -5108,6 +5667,11 @@ export function graphqlResponse(
             {
               id: "role-002",
               name: "teacher",
+              description: "教师角色",
+              isLocked: false,
+              isEnabled: true,
+              userCount: 18,
+              updatedAt: "2026-07-18T15:30:00Z",
               permissions: [
                 {
                   id: "perm-003",
@@ -5117,6 +5681,33 @@ export function graphqlResponse(
                 },
               ],
             },
+            {
+              id: "role-003",
+              name: "student",
+              description: "学生角色",
+              isLocked: false,
+              isEnabled: true,
+              userCount: 245,
+              updatedAt: "2026-07-15T10:00:00Z",
+              permissions: [
+                {
+                  id: "perm-004",
+                  name: "course.read",
+                  resource: "course",
+                  action: "read",
+                },
+              ],
+            },
+            {
+              id: "role-004",
+              name: "parent",
+              description: "家长角色（已停用）",
+              isLocked: false,
+              isEnabled: false,
+              userCount: 0,
+              updatedAt: "2026-07-10T09:00:00Z",
+              permissions: [],
+            },
           ],
         },
       };
@@ -5207,12 +5798,12 @@ export function graphqlResponse(
     }
     // UpdateQuestion($id, $input)：mutation 兜底
     case "UpdateQuestion": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateQuestion: { id } } };
     }
     // DeleteQuestion($id)：mutation 兜底
     case "DeleteQuestion": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteQuestion: { id } } };
     }
 
@@ -5276,7 +5867,7 @@ export function graphqlResponse(
     }
     // UpdateTextbook($id, $input)：mutation 兜底
     case "UpdateTextbook": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateTextbook: { id } } };
     }
     // ── Legacy widget 兜底（P2 迁移后重命名，保留旧 widget 契约）──
@@ -5612,6 +6203,67 @@ export function graphqlResponse(
       return { data: { recordGrade: { gradeId } } };
     }
 
+    // ── 学生作答流程（@contract-pending 全 MSW）──
+    // StartHomeworkSubmission：开始作答 mutation 兜底
+    case "StartHomeworkSubmission": {
+      const input = (variables?.input ?? {}) as Record<string, unknown>;
+      const assignmentId = (input.assignmentId as string) ?? "hw-unknown";
+      const submissionId = `sub-${assignmentId}-${Date.now()}`;
+      return { data: { startHomeworkSubmission: { submissionId } } };
+    }
+
+    // SaveHomeworkAnswer：保存单题答案 mutation 兜底
+    case "SaveHomeworkAnswer": {
+      const input = (variables?.input ?? {}) as Record<string, unknown>;
+      const submissionId = (input.submissionId as string) ?? "sub-001";
+      const questionId = (input.questionId as string) ?? "q-001";
+      return {
+        data: { saveHomeworkAnswer: { submissionId, questionId } },
+      };
+    }
+
+    // SubmitHomework：提交作业 mutation 兜底
+    case "SubmitHomework": {
+      const input = (variables?.input ?? {}) as Record<string, unknown>;
+      const submissionId = (input.submissionId as string) ?? "sub-001";
+      return {
+        data: {
+          submitHomework: { submissionId, totalScore: null },
+        },
+      };
+    }
+
+    // GetScans：查询某次提交的扫描图
+    case "GetScans": {
+      const submissionId =
+        (variables?.submissionId as string | undefined) ?? "";
+      void submissionId;
+      return { data: { scans: [] } };
+    }
+
+    // DeleteScan：删除扫描图 mutation 兜底
+    case "DeleteScan": {
+      const input = (variables?.input ?? {}) as Record<string, unknown>;
+      const fileId = (input.fileId as string) ?? "file-unknown";
+      return { data: { deleteScan: { fileId, success: true } } };
+    }
+
+    // BatchAutoGrade：批量自动批改 mutation 兜底
+    case "BatchAutoGrade": {
+      const input = (variables?.input ?? {}) as Record<string, unknown>;
+      const submissionIds = (input.submissionIds as string[]) ?? [];
+      const processedCount = submissionIds.length;
+      return {
+        data: {
+          batchAutoGrade: {
+            processedCount,
+            successCount: processedCount,
+            failedCount: 0,
+          },
+        },
+      };
+    }
+
     // ── Grades 域（教师域 P2 迁移，@contract-pending）──
     // GetGrade($id)：按 id 单查（真实 schema 可用，MSW 也兜底）
     case "GetGrade": {
@@ -6109,6 +6761,68 @@ export function graphqlResponse(
       const eleId = (input.id as string) ?? "ele-001";
       return { data: { updateElective: { id: eleId } } };
     }
+    // DeleteElective($id)
+    case "DeleteElective": {
+      const eleId = (variables?.id as string) ?? "";
+      const idx = mockAdminElectives.items.findIndex((e) => e.id === eleId);
+      if (idx >= 0) mockAdminElectives.items.splice(idx, 1);
+      mockAdminElectives.total = mockAdminElectives.items.length;
+      return { data: { deleteElective: { id: eleId, success: true } } };
+    }
+    // OpenElectiveSelection($id)
+    case "OpenElectiveSelection": {
+      const eleId = (variables?.id as string) ?? "";
+      const item = mockAdminElectives.items.find((e) => e.id === eleId);
+      if (item) (item as Record<string, unknown>).status = "OPEN";
+      return { data: { openElectiveSelection: { id: eleId, success: true } } };
+    }
+    // CloseElectiveSelection($id)
+    case "CloseElectiveSelection": {
+      const eleId = (variables?.id as string) ?? "";
+      const item = mockAdminElectives.items.find((e) => e.id === eleId);
+      if (item) (item as Record<string, unknown>).status = "CLOSED";
+      return { data: { closeElectiveSelection: { id: eleId, success: true } } };
+    }
+    // RunElectiveLottery($id)
+    case "RunElectiveLottery": {
+      const eleId = (variables?.id as string) ?? "";
+      return { data: { runElectiveLottery: { id: eleId, success: true } } };
+    }
+    // DeleteCoursePlan($id)
+    case "DeleteCoursePlan": {
+      const cpId = (variables?.id as string) ?? "";
+      const idx = mockAdminCoursePlans.items.findIndex((e) => e.id === cpId);
+      if (idx >= 0) mockAdminCoursePlans.items.splice(idx, 1);
+      mockAdminCoursePlans.total = mockAdminCoursePlans.items.length;
+      return { data: { deleteCoursePlan: { id: cpId, success: true } } };
+    }
+    // BulkToggleCoursePlanItems
+    case "BulkToggleCoursePlanItems": {
+      const planId = (variables?.planId as string) ?? "";
+      const itemIds = (variables?.itemIds as string[]) ?? [];
+      const isCompleted = (variables?.isCompleted as boolean) ?? false;
+      const arr = mockAdminCoursePlanItems[planId] ?? [];
+      const now = new Date().toISOString();
+      for (const it of arr) {
+        if (itemIds.includes(it.id)) {
+          it.isCompleted = isCompleted;
+          it.completedAt = isCompleted ? now : null;
+          it.updatedAt = now;
+        }
+      }
+      return {
+        data: {
+          bulkToggleCoursePlanItems: arr
+            .filter((it) => itemIds.includes(it.id))
+            .map((it) => ({
+              id: it.id,
+              isCompleted: it.isCompleted,
+              completedAt: it.completedAt,
+              updatedAt: it.updatedAt,
+            })),
+        },
+      };
+    }
 
     // ── Error Book 域（教师域 B2 迁移，✅ 真实查询 MSW 兜底）──
     // schema: errorBookItems: [ErrorBookList!]!（无参数）
@@ -6695,7 +7409,7 @@ export function graphqlResponse(
     }
     // MarkNotificationRead($id)：标记单条已读 mutation 兜底
     case "MarkNotificationRead": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       const target = mockNotifications.find((n) => n.id === id);
       if (target) target.isRead = true;
       return {
@@ -6815,14 +7529,20 @@ export function graphqlResponse(
       return { data: { createRole: { id: "role-new", name: "newrole" } } };
     // UpdateRole($id, $input)：mutation 兜底
     case "UpdateRole": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateRole: { id, name: "updated" } } };
     }
     // DeleteRole($id)：mutation 兜底
     case "DeleteRole": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteRole: { id } } };
     }
+    // ToggleRoleEnabled($id, $isEnabled)：mutation 兜底
+    case "ToggleRoleEnabled": {
+      const _id = (variables?.id as string) ?? "";
+      const isEnabled = (variables?.isEnabled as boolean) ?? true;
+      return { data: { toggleRoleEnabled: { id, isEnabled } } };
+    }
 
     // GetPermissionRoleCounts：权限-角色数聚合
     case "GetPermissionRoleCounts":
@@ -6877,6 +7597,9 @@ export function graphqlResponse(
             totalToday: 23,
             totalErrors: 5,
             totalUsers: 48,
+            auditEventsToday: 23,
+            failedLoginsToday: 3,
+            dataChangesToday: 12,
           },
         },
       };
@@ -6973,15 +7696,265 @@ export function graphqlResponse(
         },
       };
 
+    // GetAuditRetentionConfig：审计日志保留期配置（@contract-pending MSW 兜底）
+    case "GetAuditRetentionConfig":
+      return {
+        data: {
+          auditRetentionConfig: {
+            retentionDays: 90,
+            loginLogRetentionDays: 365,
+            autoCleanupEnabled: false,
+          },
+        },
+      };
+
+    // SaveAuditRetentionConfig：保存保留期配置（返回传入 input）
+    case "SaveAuditRetentionConfig": {
+      const input = (variables?.input as {
+        retentionDays: number;
+        loginLogRetentionDays: number;
+        autoCleanupEnabled: boolean;
+      }) ?? {
+        retentionDays: 90,
+        loginLogRetentionDays: 365,
+        autoCleanupEnabled: false,
+      };
+      return { data: { saveAuditRetentionConfig: input } };
+    }
+
+    // PurgeExpiredAuditLogs：手动清理过期日志
+    case "PurgeExpiredAuditLogs":
+      return {
+        data: {
+          purgeExpiredAuditLogs: {
+            auditLogsDeleted: 5,
+            loginLogsDeleted: 2,
+            dataChangeLogsDeleted: 1,
+          },
+        },
+      };
+
+    // ── 课程计划周计划项 CRUD（@contract-pending，MSW 兜底）──
+
+    // CreateCoursePlanItem：创建周计划项
+    case "CreateCoursePlanItem": {
+      const input = (variables?.input ?? {}) as {
+        planId: string;
+        week: number;
+        topic: string;
+        content?: string | null;
+        hours?: number;
+        textbookChapter?: string | null;
+        notes?: string | null;
+        completedAt?: string | null;
+      };
+      const planId = input.planId || "cp-unknown";
+      const now = new Date().toISOString();
+      const newItem = {
+        id: `cpi-${planId}-${Date.now()}`,
+        planId,
+        week: input.week ?? 1,
+        topic: input.topic ?? "",
+        content: input.content ?? null,
+        hours: input.hours ?? 2,
+        textbookChapter: input.textbookChapter ?? null,
+        notes: input.notes ?? null,
+        isCompleted: Boolean(input.completedAt),
+        completedAt: input.completedAt ?? null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      if (!mockAdminCoursePlanItems[planId]) {
+        getCoursePlanItems(planId);
+      }
+      const arr = mockAdminCoursePlanItems[planId];
+      if (arr) {
+        arr.push(newItem);
+      }
+      return { data: { createCoursePlanItem: newItem } };
+    }
+
+    // UpdateCoursePlanItem：更新周计划项
+    case "UpdateCoursePlanItem": {
+      const _id = (variables?.id as string) ?? "";
+      const input = (variables?.input ?? {}) as {
+        week?: number;
+        topic?: string;
+        content?: string | null;
+        hours?: number;
+        textbookChapter?: string | null;
+        notes?: string | null;
+        completedAt?: string | null;
+      };
+      for (const planId of Object.keys(mockAdminCoursePlanItems)) {
+        const arr = mockAdminCoursePlanItems[planId];
+        if (!arr) continue;
+        const idx = arr.findIndex((it) => it.id === id);
+        if (idx >= 0) {
+          const existing = arr[idx];
+          if (!existing) continue;
+          const updated = {
+            id: existing.id,
+            planId: existing.planId,
+            week: input.week ?? existing.week,
+            topic: input.topic ?? existing.topic,
+            content: input.content ?? existing.content,
+            hours: input.hours ?? existing.hours,
+            textbookChapter: input.textbookChapter ?? existing.textbookChapter,
+            notes: input.notes ?? existing.notes,
+            isCompleted: existing.isCompleted,
+            completedAt: input.completedAt ?? existing.completedAt,
+            createdAt: existing.createdAt,
+            updatedAt: new Date().toISOString(),
+          };
+          arr[idx] = updated;
+          return { data: { updateCoursePlanItem: updated } };
+        }
+      }
+      return {
+        data: {
+          updateCoursePlanItem: {
+            id,
+            planId: "",
+            week: input.week ?? 0,
+            topic: input.topic ?? "",
+            content: input.content ?? null,
+            hours: input.hours ?? 0,
+            textbookChapter: input.textbookChapter ?? null,
+            notes: input.notes ?? null,
+            isCompleted: false,
+            completedAt: input.completedAt ?? null,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+          },
+        },
+      };
+    }
+
+    // DeleteCoursePlanItem：删除周计划项
+    case "DeleteCoursePlanItem": {
+      const _id = (variables?.id as string) ?? "";
+      for (const planId of Object.keys(mockAdminCoursePlanItems)) {
+        const arr = mockAdminCoursePlanItems[planId];
+        if (!arr) continue;
+        const idx = arr.findIndex((it) => it.id === id);
+        if (idx >= 0) {
+          arr.splice(idx, 1);
+          break;
+        }
+      }
+      return { data: { deleteCoursePlanItem: { id, success: true } } };
+    }
+
+    // ToggleCoursePlanItemCompleted：切换周计划项完成状态
+    case "ToggleCoursePlanItemCompleted": {
+      const _id = (variables?.id as string) ?? "";
+      const isCompleted = (variables?.isCompleted as boolean) ?? false;
+      const now = new Date().toISOString();
+      for (const planId of Object.keys(mockAdminCoursePlanItems)) {
+        const arr = mockAdminCoursePlanItems[planId];
+        if (!arr) continue;
+        const idx = arr.findIndex((it) => it.id === id);
+        if (idx >= 0) {
+          const existing = arr[idx];
+          if (!existing) continue;
+          const updated = {
+            id: existing.id,
+            planId: existing.planId,
+            week: existing.week,
+            topic: existing.topic,
+            content: existing.content,
+            hours: existing.hours,
+            textbookChapter: existing.textbookChapter,
+            notes: existing.notes,
+            isCompleted,
+            completedAt: isCompleted ? now : null,
+            createdAt: existing.createdAt,
+            updatedAt: now,
+          };
+          arr[idx] = updated;
+          return {
+            data: {
+              toggleCoursePlanItemCompleted: {
+                id,
+                isCompleted,
+                completedAt: updated.completedAt,
+                updatedAt: now,
+              },
+            },
+          };
+        }
+      }
+      return {
+        data: {
+          toggleCoursePlanItemCompleted: {
+            id,
+            isCompleted,
+            completedAt: isCompleted ? now : null,
+            updatedAt: now,
+          },
+        },
+      };
+    }
+
+    // ReorderCoursePlanItems：批量重排序周计划项
+    case "ReorderCoursePlanItems": {
+      const planId = (variables?.planId as string) ?? "";
+      const items = (variables?.items ?? []) as Array<{
+        id: string;
+        week: number;
+      }>;
+      const now = new Date().toISOString();
+      const arr = mockAdminCoursePlanItems[planId];
+      if (arr) {
+        for (const reorderItem of items) {
+          const idx = arr.findIndex((it) => it.id === reorderItem.id);
+          if (idx >= 0) {
+            const existing = arr[idx];
+            if (!existing) continue;
+            arr[idx] = {
+              id: existing.id,
+              planId: existing.planId,
+              week: reorderItem.week,
+              topic: existing.topic,
+              content: existing.content,
+              hours: existing.hours,
+              textbookChapter: existing.textbookChapter,
+              notes: existing.notes,
+              isCompleted: existing.isCompleted,
+              completedAt: existing.completedAt,
+              createdAt: existing.createdAt,
+              updatedAt: now,
+            };
+          }
+        }
+        return {
+          data: {
+            reorderCoursePlanItems: arr.map((it) => ({
+              id: it.id,
+              week: it.week,
+              updatedAt: it.updatedAt,
+            })),
+          },
+        };
+      }
+      return { data: { reorderCoursePlanItems: [] } };
+    }
+
     // GetSchools：学校列表
     case "GetSchools":
       return { data: { schools: mockSchools } };
     // CreateSchool($input)：mutation 兜底
     case "CreateSchool":
       return { data: { createSchool: { id: "sch-new", name: "新学校" } } };
+    // AdminUpdateSchool($id, $input)：mutation 兜底（admin-p5 useAdminUpdateSchool）
+    case "AdminUpdateSchool": {
+      const _id = (variables?.id as string) ?? "";
+      return { data: { updateSchool: { id, name: "updated" } } };
+    }
     // DeleteSchool($id)：mutation 兜底
     case "DeleteSchool": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteSchool: { id } } };
     }
 
@@ -6995,12 +7968,12 @@ export function graphqlResponse(
       };
     // UpdateDepartment($id, $input)：mutation 兜底
     case "UpdateDepartment": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateDepartment: { id, name: "updated" } } };
     }
     // DeleteDepartment($id)：mutation 兜底
     case "DeleteDepartment": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteDepartment: { id } } };
     }
 
@@ -7014,12 +7987,12 @@ export function graphqlResponse(
       };
     // UpdateAcademicYear($id, $input)：mutation 兜底
     case "UpdateAcademicYear": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateAcademicYear: { id, name: "updated" } } };
     }
     // DeleteAcademicYear($id)：mutation 兜底
     case "DeleteAcademicYear": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteAcademicYear: { id } } };
     }
 
@@ -7058,20 +8031,138 @@ export function graphqlResponse(
           ],
         },
       };
+    // AdminCreateGrade($input)：mutation 兜底（admin-p5 useAdminCreateGrade）
+    case "AdminCreateGrade":
+      return { data: { createGrade: { id: "grade-new", name: "新年级" } } };
     // UpdateGrade($id, $input)：mutation 兜底
     case "UpdateGrade": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateGrade: { id, name: "updated" } } };
     }
     // DeleteGrade($id)：mutation 兜底
     case "DeleteGrade": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteGrade: { id } } };
     }
 
+    // GetSchoolWideGradeSummary($gradeId)：全校年级成绩洞察（@contract-pending）
+    // 用于 /shell/admin/school/grades/insights 年级洞察页
+    case "GetSchoolWideGradeSummary": {
+      const gId = (variables?.gradeId as string | undefined) ?? "";
+      const grades = mockAdminGrades
+        .filter((g) => !gId || g.id === gId)
+        .map((g, idx) => {
+          const baseScore = 70 + ((idx * 7) % 20);
+          return {
+            gradeId: g.id,
+            gradeName: g.name,
+            averageScore: baseScore + 5.4,
+            passRate: 0.86 + (idx % 3) * 0.03,
+            excellenceRate: 0.22 + (idx % 2) * 0.05,
+            participantCount: g.studentCount,
+            classRankings: mockAdminClasses
+              .filter((c) => c.gradeId === g.id)
+              .map((c, ci) => ({
+                classId: c.id,
+                className: c.name,
+                averageScore: baseScore + 3 + ci * 1.2,
+                passRate: 0.82 + ci * 0.04,
+                studentCount: c.studentCount,
+                rank: ci + 1,
+                delta: ci === 0 ? 1.8 : ci === 1 ? -0.6 : 0.4,
+                prevAvg: baseScore + 3 + ci * 1.2 - 1.2,
+                overallAvg: baseScore + 5.4,
+              })),
+          };
+        });
+      const allRankings = grades.flatMap((g) => g.classRankings);
+      const overallAvg =
+        allRankings.length > 0
+          ? allRankings.reduce((s, c) => s + c.averageScore, 0) /
+            allRankings.length
+          : 0;
+      return {
+        data: {
+          schoolWideGradeSummary: {
+            overallStats: {
+              averageScore: overallAvg,
+              passRate: 0.87,
+              excellenceRate: 0.25,
+              totalParticipants: mockAdminGrades.reduce(
+                (s, g) => s + g.studentCount,
+                0,
+              ),
+              classes: mockAdminClasses.length,
+              students: mockAdminGrades.reduce((s, g) => s + g.studentCount, 0),
+              overallAvg,
+              latestAvg: overallAvg - 0.8,
+            },
+            grades,
+            recentAssignments: [
+              {
+                assignmentId: "asg-001",
+                title: "月度数学测验",
+                subjectName: "数学",
+                gradeName: "高三",
+                averageScore: 82.5,
+                submitCount: 38,
+                totalStudents: 40,
+                status: "graded",
+                createdAt: "2026-07-20T09:00:00Z",
+                targeted: 40,
+                graded: 38,
+                median: 81.0,
+              },
+              {
+                assignmentId: "asg-002",
+                title: "语文阅读理解练习",
+                subjectName: "语文",
+                gradeName: "高二",
+                averageScore: 76.8,
+                submitCount: 41,
+                totalStudents: 42,
+                status: "graded",
+                createdAt: "2026-07-19T14:30:00Z",
+                targeted: 42,
+                graded: 41,
+                median: 77.5,
+              },
+              {
+                assignmentId: "asg-003",
+                title: "英语听力训练",
+                subjectName: "英语",
+                gradeName: "高一",
+                averageScore: 85.2,
+                submitCount: 35,
+                totalStudents: 38,
+                status: "submitted",
+                createdAt: "2026-07-18T10:00:00Z",
+                targeted: 38,
+                graded: 0,
+                median: 0,
+              },
+            ],
+          },
+        },
+      };
+    }
+
     // GetAdminClasses：管理端班级列表
     case "GetAdminClasses":
       return { data: { adminClasses: mockAdminClasses } };
+    // CreateAdminClass($input)：mutation 兜底（admin-p5 useCreateAdminClass）
+    case "CreateAdminClass":
+      return { data: { createAdminClass: { id: "cls-new", name: "新班级" } } };
+    // UpdateAdminClass($id, $input)：mutation 兜底（admin-p5 useUpdateAdminClass）
+    case "UpdateAdminClass": {
+      const _id = (variables?.id as string) ?? "";
+      return { data: { updateAdminClass: { id, name: "updated" } } };
+    }
+    // DeleteAdminClass($id)：mutation 兜底（admin-p5 useDeleteAdminClass）
+    case "DeleteAdminClass": {
+      const _id = (variables?.id as string) ?? "";
+      return { data: { deleteAdminClass: { id } } };
+    }
 
     // GetTeacherOptions：教师下拉选项
     case "GetTeacherOptions":
@@ -7114,6 +8205,7 @@ export function graphqlResponse(
                 createdAt: "2026-07-22T00:00:00Z",
                 updatedAt: "2026-07-22T00:00:00Z",
                 authorName: "管理员",
+                readCount: 0,
                 grades: [],
                 classes: [],
               },
@@ -7127,27 +8219,101 @@ export function graphqlResponse(
       };
     // UpdateAnnouncement($id, $input)：mutation 兜底
     case "UpdateAnnouncement": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateAnnouncement: { id, title: "updated" } } };
     }
     // DeleteAnnouncement($id)：mutation 兜底
     case "DeleteAnnouncement": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteAnnouncement: { id } } };
     }
     // ArchiveAnnouncement($id)：归档公告 mutation 兜底
     case "ArchiveAnnouncement": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { archiveAnnouncement: { id, status: "archived" } } };
     }
     // PinAnnouncement($id)：置顶公告 mutation 兜底
     case "PinAnnouncement": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return {
         data: { pinAnnouncement: { id, pinnedAt: "2026-07-22T10:00:00Z" } },
       };
     }
+    // PublishAnnouncement($id): 发布公告 mutation 兜底
+    case "PublishAnnouncement": {
+      const _id = (variables?.id as string) ?? "";
+      return {
+        data: {
+          publishAnnouncement: {
+            id,
+            status: "published",
+            publishedAt: new Date().toISOString(),
+          },
+        },
+      };
+    }
 
+    // GetInvitationCodes: 邀请码列表
+    case "GetInvitationCodes":
+      return { data: { invitationCodes: mockInvitationCodes } };
+    // CreateInvitationCode($input): mutation 兜底
+    case "CreateInvitationCode":
+      return {
+        data: {
+          createInvitationCode: {
+            id: "inv-new",
+            code:
+              "EDU-NEW-" + Math.random().toString(36).slice(2, 8).toUpperCase(),
+            role: "teacher",
+            roleName: "教师",
+            classId: null,
+            className: null,
+            email: null,
+            batchId: "batch-new",
+            status: "unused",
+            usedCount: 0,
+            maxUses: 1,
+            usedBy: null,
+            usedByName: null,
+            usedAt: null,
+            expiresAt: "2026-08-31T23:59:59Z",
+            createdAt: new Date().toISOString(),
+            createdBy: "管理员",
+          },
+        },
+      };
+    // RevokeInvitationCode($id): mutation 兜底
+    case "RevokeInvitationCode": {
+      const _id = (variables?.id as string) ?? "";
+      return { data: { revokeInvitationCode: { id, status: "revoked" } } };
+    }
+    // GenerateInvitationCodes($input): 批量生成邀请码 mutation 兜底
+    case "GenerateInvitationCodes": {
+      const input = (variables?.input ?? {}) as { count?: number };
+      const count = input.count ?? 1;
+      const generated = Array.from({ length: count }, (_, i) => ({
+        id: "inv-gen-" + (i + 1),
+        code: "EDU-GEN-" + Math.random().toString(36).slice(2, 8).toUpperCase(),
+        status: "unused",
+        maxUses: 1,
+        usedCount: 0,
+        expiresAt: "2026-08-31T23:59:59Z",
+      }));
+      return {
+        data: {
+          generateInvitationCodes: {
+            success: true,
+            generatedCount: count,
+            generated,
+          },
+        },
+      };
+    }
+    // DeleteInvitationCodes($ids): 批量删除邀请码 mutation 兜底
+    case "DeleteInvitationCodes": {
+      const ids = (variables?.ids as string[]) ?? [];
+      return { data: { deleteInvitationCodes: ids.length } };
+    }
     // GetFileAttachments：文件附件分页列表
     case "GetFileAttachments":
       return { data: { fileAttachments: mockFileAttachments } };
@@ -7177,14 +8343,27 @@ export function graphqlResponse(
       };
     // UpdateAiProvider($id, $input)：mutation 兜底
     case "UpdateAiProvider": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateAiProvider: { id, name: "updated" } } };
     }
     // DeleteAiProvider($id)：mutation 兜底
     case "DeleteAiProvider": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { deleteAiProvider: { id } } };
     }
+    // TestAiProvider($id): 测试 AI Provider 连通性 mutation 兜底
+    case "TestAiProvider": {
+      const _id = (variables?.id as string) ?? "";
+      return {
+        data: {
+          testAiProvider: {
+            ok: true,
+            latencyMs: 128,
+            message: "连接成功",
+          },
+        },
+      };
+    }
 
     // GetAiUsageDashboard：AI 用量看板
     case "GetAiUsageDashboard":
@@ -7237,7 +8416,7 @@ export function graphqlResponse(
       return { data: { viewports: mockViewports } };
     // UpdateViewport($id, $input)：mutation 兜底
     case "UpdateViewport": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { updateViewport: { id, name: "updated" } } };
     }
 
@@ -7255,10 +8434,11 @@ export function graphqlResponse(
     // GetAdminCoursePlans：管理端课程计划分页列表
     case "GetAdminCoursePlans":
       return { data: { adminCoursePlans: mockAdminCoursePlans } };
-    // GetAdminCoursePlan($id)：单条课程计划详情（含 content）
+    // GetAdminCoursePlan($id)：单条课程计划详情（含 content + items 周计划）
     case "GetAdminCoursePlan": {
       const cpId = (variables?.id as string | undefined) ?? "";
       const listMatch = mockAdminCoursePlans.items.find((c) => c.id === cpId);
+      const items = getCoursePlanItems(cpId);
       return {
         data: {
           adminCoursePlan: listMatch
@@ -7268,12 +8448,7 @@ export function graphqlResponse(
                   "# " +
                   listMatch.name +
                   "\n\n本课程计划涵盖本学期主要教学模块，按周拆分进度。",
-                objectives: "掌握核心知识点并能综合应用",
-                weeklySchedule: [
-                  { week: 1, topic: "模块一 导入", hours: 2 },
-                  { week: 2, topic: "模块二 基础", hours: 3 },
-                  { week: 3, topic: "模块三 进阶", hours: 3 },
-                ],
+                items,
               }
             : {
                 id: cpId,
@@ -7285,7 +8460,7 @@ export function graphqlResponse(
                 description: "",
                 content: "",
                 objectives: "",
-                weeklySchedule: [],
+                items,
                 createdAt: "2026-07-22T00:00:00Z",
                 updatedAt: "2026-07-22T00:00:00Z",
               },
@@ -7302,37 +8477,81 @@ export function graphqlResponse(
               standardId: "std-001",
               standardName: "集合",
               gradeId: "grade-12",
-              coverage: 0.85,
+              gradeName: "高三",
+              coverageRate: 0.85,
+              lessonPlanCount: 17,
+              total: 20,
+              linked: 17,
             },
             {
               standardId: "std-002",
               standardName: "函数",
               gradeId: "grade-12",
-              coverage: 0.92,
+              gradeName: "高三",
+              coverageRate: 0.92,
+              lessonPlanCount: 23,
+              total: 25,
+              linked: 23,
             },
             {
               standardId: "std-003",
               standardName: "导数",
               gradeId: "grade-12",
-              coverage: 0.78,
+              gradeName: "高三",
+              coverageRate: 0.78,
+              lessonPlanCount: 14,
+              total: 18,
+              linked: 14,
             },
             {
               standardId: "std-004",
               standardName: "概率统计",
               gradeId: "grade-12",
-              coverage: 0.65,
+              gradeName: "高三",
+              coverageRate: 0.65,
+              lessonPlanCount: 13,
+              total: 20,
+              linked: 13,
             },
             {
               standardId: "std-005",
               standardName: "立体几何",
               gradeId: "grade-11",
-              coverage: 0.88,
+              gradeName: "高二",
+              coverageRate: 0.88,
+              lessonPlanCount: 22,
+              total: 25,
+              linked: 22,
             },
             {
               standardId: "std-006",
               standardName: "解析几何",
               gradeId: "grade-11",
-              coverage: 0.72,
+              gradeName: "高二",
+              coverageRate: 0.72,
+              lessonPlanCount: 18,
+              total: 25,
+              linked: 18,
+            },
+            {
+              standardId: "std-001",
+              standardName: "集合",
+              gradeId: "grade-11",
+              gradeName: "高二",
+              coverageRate: 0.1,
+              lessonPlanCount: 2,
+              total: 20,
+              linked: 2,
+            },
+            {
+              standardId: "std-007",
+              standardName: "三角函数",
+              gradeId: "grade-10",
+              gradeName: "高一",
+              coverageRate: 0,
+              lessonPlanCount: 0,
+              total: 15,
+              linked: 0,
             },
           ],
         },
@@ -7352,6 +8571,29 @@ export function graphqlResponse(
         },
       };
 
+    // GetElectiveOverviewStats：选修课总览统计
+    case "GetElectiveOverviewStats":
+      return {
+        data: {
+          electiveOverviewStats: {
+            totalCourses: mockAdminElectives.items.length,
+            totalCapacity: mockAdminElectives.items.reduce(
+              (s, e) => s + (e.capacity ?? 0),
+              0,
+            ),
+            totalEnrolled: mockAdminElectives.items.reduce(
+              (s, e) => s + (e.enrolledCount ?? 0),
+              0,
+            ),
+            totalDraft: mockAdminElectives.items.filter(
+              (e) => e.status === "DRAFT",
+            ).length,
+            totalOpen: mockAdminElectives.items.filter(
+              (e) => e.status === "OPEN" || e.status === "PUBLISHED",
+            ).length,
+          },
+        },
+      };
     // GetAdminElectives：管理端选修课分页列表
     case "GetAdminElectives":
       return { data: { adminElectives: mockAdminElectives } };
@@ -7369,19 +8611,25 @@ export function graphqlResponse(
                     studentId: "stu-001",
                     studentName: "张明",
                     selectedAt: "2026-07-10T10:00:00Z",
+                    enrolledAt: "2026-07-10T10:00:00Z",
                     status: "confirmed",
+                    priority: 1,
                   },
                   {
                     studentId: "stu-002",
                     studentName: "李华",
                     selectedAt: "2026-07-11T14:00:00Z",
+                    enrolledAt: "2026-07-11T14:00:00Z",
                     status: "confirmed",
+                    priority: 2,
                   },
                   {
                     studentId: "stu-003",
                     studentName: "王芳",
                     selectedAt: "2026-07-12T09:30:00Z",
+                    enrolledAt: "2026-07-12T09:30:00Z",
                     status: "pending",
+                    priority: 3,
                   },
                 ],
               }
@@ -7409,6 +8657,37 @@ export function graphqlResponse(
     case "GetAdminQuestions":
       return { data: { adminQuestions: mockAdminQuestions } };
 
+    // GetAdminQuestion($id)：管理端题目单条详情（@contract-pending MSW 兜底）
+    // 列表项中缺少 answer/explanation/knowledgePointTitle/textbookTitle 等字段，
+    // 在此根据列表项 id 派生完整详情；找不到时返回兜底详情。
+    case "GetAdminQuestion": {
+      const qId = (variables?.id as string | undefined) ?? "";
+      const listMatch = mockAdminQuestions.items.find((q) => q.id === qId);
+      return {
+        data: {
+          adminQuestion: {
+            id: qId,
+            type: listMatch?.type ?? "single_choice",
+            content: listMatch?.content ?? "",
+            difficulty: listMatch?.difficulty ?? "medium",
+            subjectId: "sub-math",
+            subjectName: "数学",
+            textbookId: "tb-001",
+            textbookTitle: "高中数学必修一",
+            knowledgePointId: "kp-001",
+            knowledgePointTitle: "集合与函数概念",
+            status: listMatch?.status ?? "DRAFT",
+            answer: "1/2",
+            explanation: "sin(30°) = 1/2，是三角函数中的基础恒等式。",
+            source: listMatch?.source ?? null,
+            createdAt: listMatch?.createdAt ?? "2026-07-15T08:00:00Z",
+            updatedAt: listMatch?.createdAt ?? "2026-07-15T08:00:00Z",
+            createdBy: listMatch?.authorName ?? "张老师",
+          },
+        },
+      };
+    }
+
     // GetAdminLessonPlans：管理端教案分页列表
     case "GetAdminLessonPlans":
       return { data: { adminLessonPlans: mockAdminLessonPlans } };
@@ -7484,6 +8763,43 @@ export function graphqlResponse(
                 errorRate: 0.22,
               },
             ],
+            byClass: [
+              {
+                classId: "cls-001",
+                className: "高三(1)班",
+                errorCount: 1280,
+                questionCount: 510,
+                errorRate: 0.38,
+              },
+              {
+                classId: "cls-002",
+                className: "高三(2)班",
+                errorCount: 1120,
+                questionCount: 470,
+                errorRate: 0.35,
+              },
+              {
+                classId: "cls-003",
+                className: "高二(1)班",
+                errorCount: 980,
+                questionCount: 420,
+                errorRate: 0.31,
+              },
+              {
+                classId: "cls-004",
+                className: "高二(2)班",
+                errorCount: 860,
+                questionCount: 380,
+                errorRate: 0.28,
+              },
+              {
+                classId: "cls-005",
+                className: "高一(1)班",
+                errorCount: 720,
+                questionCount: 320,
+                errorRate: 0.25,
+              },
+            ],
             topStudents: [
               {
                 studentId: "stu-004",
@@ -7523,11 +8839,207 @@ export function graphqlResponse(
                 errorCount: 118,
                 errorRate: 0.68,
               },
+              {
+                questionId: "q-012",
+                content: "求函数 y=log₂(x-1) 的定义域。",
+                errorCount: 112,
+                errorRate: 0.65,
+              },
+              {
+                questionId: "q-015",
+                content: "已知向量 a=(1,2)，b=(3,1)，求 a·b。",
+                errorCount: 108,
+                errorRate: 0.63,
+              },
+              {
+                questionId: "q-019",
+                content: "等差数列前 n 项和公式推导。",
+                errorCount: 102,
+                errorRate: 0.61,
+              },
+              {
+                questionId: "q-022",
+                content: "求极限 lim(x→0) sin(x)/x 的值。",
+                errorCount: 98,
+                errorRate: 0.59,
+              },
+              {
+                questionId: "q-025",
+                content: "已知复数 z=1+i，求 z² 的值。",
+                errorCount: 95,
+                errorRate: 0.57,
+              },
+              {
+                questionId: "q-028",
+                content: "二项式定理 (a+b)⁵ 展开式中 a³b² 的系数。",
+                errorCount: 92,
+                errorRate: 0.55,
+              },
+              {
+                questionId: "q-031",
+                content: "三角函数 sin²θ + cos²θ = ?",
+                errorCount: 88,
+                errorRate: 0.52,
+              },
+              {
+                questionId: "q-034",
+                content: "求抛物线 y²=4x 的焦点坐标。",
+                errorCount: 85,
+                errorRate: 0.5,
+              },
+              {
+                questionId: "q-037",
+                content: "已知椭圆方程 x²/9 + y²/4 = 1，求离心率。",
+                errorCount: 80,
+                errorRate: 0.48,
+              },
+              {
+                questionId: "q-040",
+                content: "排列组合：从 5 人中选 3 人参加活动的方案数。",
+                errorCount: 76,
+                errorRate: 0.45,
+              },
+              {
+                questionId: "q-043",
+                content: "导数应用：求函数 y=x³-3x+1 的极值点。",
+                errorCount: 72,
+                errorRate: 0.43,
+              },
+              {
+                questionId: "q-046",
+                content:
+                  "概率题：袋中有 3 红 2 白球，任取 2 球均为红色的概率。",
+                errorCount: 68,
+                errorRate: 0.4,
+              },
+              {
+                questionId: "q-049",
+                content: "立体几何：求正方体对角线长度（边长为 a）。",
+                errorCount: 64,
+                errorRate: 0.38,
+              },
+              {
+                questionId: "q-052",
+                content: "三角恒等变换：cos(α-β) 的展开式。",
+                errorCount: 60,
+                errorRate: 0.36,
+              },
+              {
+                questionId: "q-055",
+                content: "数列：已知 a₁=1，aₙ₊₁=2aₙ+1，求通项公式。",
+                errorCount: 56,
+                errorRate: 0.34,
+              },
+              {
+                questionId: "q-058",
+                content: "不等式：解 |x-2| + |x+1| < 5。",
+                errorCount: 52,
+                errorRate: 0.31,
+              },
+              {
+                questionId: "q-061",
+                content: "圆锥曲线：双曲线 x²/4 - y²/9 = 1 的渐近线方程。",
+                errorCount: 48,
+                errorRate: 0.29,
+              },
+              {
+                questionId: "q-064",
+                content: "三角函数图像：y=sin(2x+π/3) 的周期与振幅。",
+                errorCount: 44,
+                errorRate: 0.27,
+              },
+              {
+                questionId: "q-067",
+                content: "对数运算：log₃81 + log₃9 的值。",
+                errorCount: 40,
+                errorRate: 0.24,
+              },
+              {
+                questionId: "q-070",
+                content: "向量运算：已知 |a|=3，|b|=4，a⊥b，求 |a+b|。",
+                errorCount: 36,
+                errorRate: 0.22,
+              },
+              {
+                questionId: "q-073",
+                content: "微积分：∫(2x+1)dx 的不定积分。",
+                errorCount: 32,
+                errorRate: 0.19,
+              },
+              {
+                questionId: "q-076",
+                content: "矩阵运算：2×2 矩阵的乘法示例。",
+                errorCount: 28,
+                errorRate: 0.17,
+              },
             ],
           },
         },
       };
 
+    // ExportErrorBookCsv($filter)：错题本 CSV 导出 mutation（@contract-pending MSW 兜底）
+    // 按当前 mock stats 数据构造 CSV 字符串，支持 subjectId/classId 过滤。
+    case "ExportErrorBookCsv": {
+      const filter =
+        (variables?.filter as
+          | {
+              subjectId?: string | null;
+              classId?: string | null;
+            }
+          | undefined) ?? {};
+      const statsResult = graphqlResponse("GetAdminErrorBookStats", {}) as {
+        data?: { adminErrorBookStats?: Record<string, unknown> };
+      };
+      const stats = statsResult.data?.adminErrorBookStats;
+      const byClass = (
+        stats?.byClass as Array<{
+          classId: string;
+          className: string;
+          errorCount: number;
+          questionCount: number;
+          errorRate: number;
+        }>
+      ).filter((c) => !filter.classId || c.classId === filter.classId);
+      const bySubject = (
+        stats?.bySubject as Array<{
+          subjectId: string;
+          subjectName: string;
+          errorCount: number;
+          questionCount: number;
+          errorRate: number;
+        }>
+      ).filter((s) => !filter.subjectId || s.subjectId === filter.subjectId);
+      const header =
+        "class_id,class_name,subject_id,subject_name,error_count,question_count,error_rate";
+      const rows: string[] = [];
+      for (const cls of byClass) {
+        for (const subj of bySubject) {
+          rows.push(
+            [
+              cls.classId,
+              escapeCsvField(cls.className),
+              subj.subjectId,
+              escapeCsvField(subj.subjectName),
+              String(cls.errorCount),
+              String(subj.questionCount),
+              String(subj.errorRate),
+            ].join(","),
+          );
+        }
+      }
+      const csv = `${header}\n${rows.join("\n")}`;
+      return {
+        data: {
+          exportErrorBookCsv: {
+            success: true,
+            count: rows.length,
+            filename: `error-book-${new Date().toISOString().slice(0, 10)}.csv`,
+            csv,
+          },
+        },
+      };
+    }
+
     // GetAdminScheduleChanges：管理端课表变更分页列表
     case "GetAdminScheduleChanges":
       return { data: { adminScheduleChanges: mockAdminScheduleChanges } };
@@ -7603,12 +9115,12 @@ export function graphqlResponse(
     }
     // ApproveScheduleChange($id)：审批通过 mutation 兜底
     case "ApproveScheduleChange": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { approveScheduleChange: { id, status: "approved" } } };
     }
     // RejectScheduleChange($id)：审批驳回 mutation 兜底
     case "RejectScheduleChange": {
-      const id = (variables?.id as string) ?? "";
+      const _id = (variables?.id as string) ?? "";
       return { data: { rejectScheduleChange: { id, status: "rejected" } } };
     }
     // AutoSchedule($classId)：自动排课 mutation 兜底
@@ -7665,9 +9177,36 @@ export function graphqlResponse(
         },
       };
 
-    // GetAdminAttendanceRecords：管理端考勤记录分页列表
-    case "GetAdminAttendanceRecords":
-      return { data: { adminAttendanceRecords: mockAdminAttendanceRecords } };
+    // GetAdminAttendanceRecords：管理端考勤记录分页列表（支持 classId/status/date/gradeId 过滤 + limit/offset 分页）
+    case "GetAdminAttendanceRecords": {
+      const filter =
+        (variables?.filter as
+          | {
+              classId?: string | null;
+              status?: string | null;
+              date?: string | null;
+              gradeId?: string | null;
+            }
+          | undefined) ?? {};
+      const limit = (variables?.limit as number | undefined) ?? 100;
+      const offset = (variables?.offset as number | undefined) ?? 0;
+      const filtered = mockAdminAttendanceRecords.items.filter((r) => {
+        if (filter.classId && r.classId !== filter.classId) return false;
+        if (filter.status && r.status !== filter.status) return false;
+        if (filter.date && r.date !== filter.date) return false;
+        if (filter.gradeId && r.gradeId !== filter.gradeId) return false;
+        return true;
+      });
+      const paged = filtered.slice(offset, offset + Math.max(0, limit));
+      return {
+        data: {
+          adminAttendanceRecords: {
+            items: paged,
+            total: filtered.length,
+          },
+        },
+      };
+    }
 
     // GetAttendanceGradeCorrelation：考勤-成绩相关性
     case "GetAttendanceGradeCorrelation":
@@ -7759,8 +9298,25 @@ export function graphqlResponse(
       return { data: mockStudentPractice };
     case "GetStudentPracticeSession":
       return { data: mockStudentPracticeSession };
-    case "GetStudentLeave":
-      return { data: mockStudentLeave };
+    case "GetStudentLeave": {
+      const page = (variables?.page as number | undefined) ?? 1;
+      const pageSize = (variables?.pageSize as number | undefined) ?? 20;
+      const start = (page - 1) * pageSize;
+      const end = start + pageSize;
+      const pagedItems = mockStudentLeaveItems.slice(start, end);
+      return {
+        data: {
+          studentLeave: {
+            items: pagedItems,
+            total: mockStudentLeaveItems.length,
+            page,
+            pageSize,
+          },
+        },
+      };
+    }
+    case "GetUserProfile":
+      return { data: mockUserProfile };
     case "GetStudentMessages":
       return { data: mockStudentMessages };
     case "GetStudentAnnouncements":
diff --git a/docs/troubleshooting/known-issues.md b/docs/troubleshooting/known-issues.md
index e6c04d7..4fa3d09 100644
--- a/docs/troubleshooting/known-issues.md
+++ b/docs/troubleshooting/known-issues.md
@@ -767,3 +767,12 @@
 | React 19 use() + Suspense jsdom 测试    | `use(promise)` 在 jsdom 中 promise resolve 后不自动触发重新渲染；需用 `await act(async () => { render(...); await Promise.resolve(); })` 包裹 render，并设置 `globalThis.IS_REACT_ACT_ENVIRONMENT = true`（setup 文件）                                                                                                 |
 | 前端错误上报生产端点                    | api-gateway 在 `/api/v1/log` 直接处理（不代理到下游），slog 结构化 JSON 日志，64KB body 限制，返回 204；`useErrorReport` 按 `process.env.NODE_ENV` 切换：production→`/api/v1/log`，development→`/api/log`（Next.js API route mock）                                                                                     |
 | vitest setup 文件配置                   | `vitest.config.ts` 的 `setupFiles: ["src/__tests__/setup.ts"]` 注册 `@testing-library/jest-dom/vitest` matchers + 设置 `IS_REACT_ACT_ENVIRONMENT`；`declare global { var IS_REACT_ACT_ENVIRONMENT: boolean \| undefined }` 补类型签名                                                                                   |
+| 管理域 GraphQL operation 命名冲突       | admin.graphql.ts 与 grades.graphql.ts/school-settings.graphql.ts 同名 mutation（CreateGrade/UpdateSchool 等）导致 codegen 重复声明；前缀化命名 `AdminCreateGrade`/`AdminUpdateSchool`/`AdminGetSchedulingRules` 区分                                                                                                    |
+| 管理域 invitation-codes 纯函数时间漂移  | 纯函数 `isInvitationExpired`/`getEffectiveStatus`/`isInvitationRevocable` 调用 `Date.now()` 会造成 SSR/CSR hydration mismatch；参数化注入 `now: number` 由 server page 传入                                                                                                                                             |
+| 管理域 StatusBadge 虚假推断状态         | `audit-logs` StatusBadge 用 `log.details ? "success" : ""` 推断 status 违反数据真实性原则；改用 schema 字段 `log.status`，未就绪时显示 "--" 占位符                                                                                                                                                                      |
+| 管理域未实现功能降级模式                | 未实现的 CRUD（如 questions 创建/导入导出、students/teachers/organization 详情）改为按钮 + `notify.info(t("mswNotice"))` 占位，避免死链；不创建实际路由                                                                                                                                                                 |
+| 管理域 @contract-pending 契约标注规则   | schema 未就绪字段在文件头注释 `@contract-pending: <工单>` + `§11.4 登记`；禁止在代码注释中声称 schema 已就绪而实际走 MSW 兜底（plugins 模块原标注造假已修正）                                                                                                                                                           |
+| 管理域 announcements grades 关联编辑    | AnnouncementInput.grades 字段已有 schema 定义；edit 表单用逗号分隔文本输入（简化版），避免下拉多选依赖 useGrades hook；提交时 `split(",").map(trim).filter(Boolean)` 解析                                                                                                                                               |
+| 管理域 audit-logs 分页                  | ListPageShell pagination slot 支持 prev/next 按钮 + 当前页/总页数显示；URL 状态 `?page=N`，由 `updateQuery("page", ...)` 控制；总页数 `Math.ceil(total / pageSize)`                                                                                                                                                     |
+| 管理域 ai-settings 双权限注释           | AI_CHAT（普通用户访问 private provider）+ AI_CONFIGURE（管理员访问 public/他人 provider）；admin 路由仅放行 ["admin"]，管理员隐含 AI_CONFIGURE；普通用户 AI_CHAT 走 `/shell/ai-settings`（非 admin 域）                                                                                                                 |
+| 管理域 viewports DataScope 注释         | 视口配置属管理员全局视角（DataScope = "all"），不随班级/年级范围收窄；route-permissions.ts 仅放行 ["admin"]；无需 ctx.dataScope 上下文                                                                                                                                                                                  |