;
}
-// Baseline as of P2 B3 (2026-07-22, error-book + diagnostic + analytics modules added).
+// Baseline as of B2 末 教师域 (2026-07-24, proctoring + student-diagnostic
+// added: 2 new pages).
// Update when adding pages.
const BASELINE: Baseline = {
- total: 58,
+ total: 69,
categories: {
dashboards: {
pattern: "shell/{admin,teacher,student,parent}/page.tsx",
diff --git a/apps/portal-shell/src/__tests__/e2e/security-boundaries.test.ts b/apps/portal-shell/src/__tests__/e2e/security-boundaries.test.ts
index e58ba52..737b8d2 100644
--- a/apps/portal-shell/src/__tests__/e2e/security-boundaries.test.ts
+++ b/apps/portal-shell/src/__tests__/e2e/security-boundaries.test.ts
@@ -206,7 +206,7 @@ describe("E2E: 三层安全边界", () => {
it("teacher 有 QUESTION_READ → 访问题库放行（OR 语义）", () => {
const result = checkRoutePermission(
- "/shell/teacher/question-bank",
+ "/shell/teacher/questions",
TEACHER_USER.bitmap,
TEACHER_USER.role,
);
@@ -250,7 +250,7 @@ describe("E2E: 三层安全边界", () => {
it("student 有 ELECTIVE_SELECT → 访问选修课选择放行（OR 语义）", () => {
const result = checkRoutePermission(
- "/shell/student/electives",
+ "/shell/student/elective",
STUDENT_USER.bitmap,
STUDENT_USER.role,
);
@@ -263,7 +263,7 @@ describe("E2E: 三层安全边界", () => {
"DASHBOARD_READ",
]);
const result = checkRoutePermission(
- "/shell/student/electives",
+ "/shell/student/elective",
noElective,
"student",
);
@@ -313,7 +313,7 @@ describe("E2E: 三层安全边界", () => {
const teacherRoutes = [
"/shell/teacher",
"/shell/teacher/lesson-plans",
- "/shell/teacher/question-bank",
+ "/shell/teacher/questions",
];
const results = batchCheckRoutePermission(
teacherRoutes,
diff --git a/apps/portal-shell/src/app/shell/admin/ai-settings/error.tsx b/apps/portal-shell/src/app/shell/admin/ai-settings/error.tsx
new file mode 100644
index 0000000..c5f18e5
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/admin/ai-settings/error.tsx
@@ -0,0 +1,38 @@
+"use client";
+
+/**
+ * AI 配置路由错误边界（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment error.tsx，捕获子树未处理异常。
+ */
+import { useEffect } from "react";
+
+import { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function AiSettingsError({
+ error,
+ reset,
+}: {
+ error: Error & { digest?: string };
+ reset: () => void;
+}): React.ReactElement {
+ const t = useTranslations("admin.aiSettings");
+
+ useEffect(() => {
+ console.error("[portal-shell] ai-settings route error:", error);
+ }, [error]);
+
+ return (
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
- } />
- {children}
-
-
+
+
+
+
+ } />
+ {children}
+
+
+
);
}
diff --git a/apps/portal-shell/src/app/shell/messages/page.tsx b/apps/portal-shell/src/app/shell/messages/page.tsx
new file mode 100644
index 0000000..3dc4dc4
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/messages/page.tsx
@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { MessagesListClient } from "@/features/shared/messages/messages-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 消息中心页（共享路由，ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P5 B3 末）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 MessagesListClient（client component）中。
+ *
+ * 数据契约：studentMessages ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P5 / §11.3 / §11.4
+ */
+export default function MessagesPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/notifications/error.tsx b/apps/portal-shell/src/app/shell/notifications/error.tsx
new file mode 100644
index 0000000..791d363
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/notifications/error.tsx
@@ -0,0 +1,38 @@
+"use client";
+
+/**
+ * 通知中心路由错误边界（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment error.tsx，捕获子树未处理异常。
+ */
+import { useEffect } from "react";
+
+import { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function NotificationsError({
+ error,
+ reset,
+}: {
+ error: Error & { digest?: string };
+ reset: () => void;
+}): React.ReactElement {
+ const t = useTranslations("notifications");
+
+ useEffect(() => {
+ console.error("[portal-shell] notifications route error:", error);
+ }, [error]);
+
+ return (
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
{t("title")}
+
+ {error.message || t("unknown")}
+
+
+
{Array.from({ length: 4 }).map((_, i) => (
@@ -33,10 +35,10 @@ export default function StudentDashboardPage(): React.ReactElement {
if (error || !data) {
return (
-
+
- 仪表盘数据加载失败，请稍后重试。
+ {t("loadFailed")}
@@ -45,22 +47,22 @@ export default function StudentDashboardPage(): React.ReactElement {
return (
0}
@@ -68,7 +70,7 @@ export default function StudentDashboardPage(): React.ReactElement {
}
>
-
+
{data.weak_points ? (
@@ -76,30 +78,37 @@ export default function StudentDashboardPage(): React.ReactElement {
{data.weak_points.title ?? "--"}
- 掌握度 {data.weak_points.mastery?.toFixed(1) ?? "--"}%
+ {t("labelMastery")}{" "}
+ {data.weak_points.mastery?.toFixed(1) ?? "--"}%
- 错误次数：{data.weak_points.error_count ?? 0}
+ {t("labelErrorCount", {
+ count: data.weak_points.error_count ?? 0,
+ })}
) : (
- 暂无薄弱知识点数据
+
+ {t("emptyWeakPoints")}
+
)}
-
+
{data.recent_trends ? (
- {data.recent_trends.date ?? "--"}：
+ {t("labelScoreOnDate", { date: data.recent_trends.date ?? "--" })}
- {data.recent_trends.score?.toFixed(1) ?? "--"} 分
+ {t("labelScoreValue", {
+ score: data.recent_trends.score?.toFixed(1) ?? "--",
+ })}
) : (
- 暂无趋势数据
+ {t("emptyTrends")}
)}
diff --git a/apps/portal-shell/src/app/shell/student/practice/[sessionId]/page.tsx b/apps/portal-shell/src/app/shell/student/practice/[sessionId]/page.tsx
new file mode 100644
index 0000000..4e6e0a5
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/practice/[sessionId]/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { StudentPracticeSessionClient } from "@/features/student/practice/practice-session-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生练习会话详情页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P3）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 StudentPracticeSessionClient（client component）中。
+ *
+ * 数据契约：studentPracticeSession ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#student-practice
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P3 / §11.3 / §11.4
+ */
+export default function StudentPracticeSessionPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/practice/page.tsx b/apps/portal-shell/src/app/shell/student/practice/page.tsx
new file mode 100644
index 0000000..1983a0e
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/practice/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { StudentPracticeListClient } from "@/features/student/practice/practice-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生自适应练习首页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P3）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 StudentPracticeListClient（client component）中。
+ *
+ * 数据契约：studentPractice ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#student-practice
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P3 / §11.3 / §11.4
+ */
+export default function StudentPracticePage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/schedule/page.tsx b/apps/portal-shell/src/app/shell/student/schedule/page.tsx
new file mode 100644
index 0000000..7528dcf
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/schedule/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { StudentScheduleListClient } from "@/features/student/schedule/schedule-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生课表页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 StudentScheduleListClient（client component）中。
+ *
+ * 数据契约：studentSchedule ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md#student-schedule
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function StudentSchedulePage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/textbooks/[id]/chapters/page.tsx b/apps/portal-shell/src/app/shell/student/textbooks/[id]/chapters/page.tsx
new file mode 100644
index 0000000..e6bd022
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/textbooks/[id]/chapters/page.tsx
@@ -0,0 +1,24 @@
+// @contract-pending：studentTextbookChapters schema 未实现，全 MSW 兜底
+import { Suspense } from "react";
+
+import { StudentTextbookChaptersClient } from "@/features/student/textbooks/textbook-chapters-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生教材章节阅读器页（ARCHITECTURE.md §7.3 详情页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 StudentTextbookChaptersClient（client component）中。
+ *
+ * 数据契约：studentTextbookChapters ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function StudentTextbookChaptersPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/textbooks/page.tsx b/apps/portal-shell/src/app/shell/student/textbooks/page.tsx
new file mode 100644
index 0000000..a80892c
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/textbooks/page.tsx
@@ -0,0 +1,24 @@
+// @contract-pending：studentTextbooks schema 未实现，全 MSW 兜底
+import { Suspense } from "react";
+
+import { StudentTextbooksListClient } from "@/features/student/textbooks/textbooks-list-client";
+import { ListPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生教材列表页（ARCHITECTURE.md §7.3 列表页 / §9.1 / §10 P2）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹（useSearchParams 要求）。
+ * 业务逻辑在 StudentTextbooksListClient（client component）中。
+ *
+ * 数据契约：studentTextbooks ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/core-edu_contract.md
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 / §11.3 / §11.4
+ */
+export default function StudentTextbooksListPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/trend/page.tsx b/apps/portal-shell/src/app/shell/student/trend/page.tsx
new file mode 100644
index 0000000..c5010c9
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/trend/page.tsx
@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { StudentTrendClient } from "@/features/student/dashboard/trend-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生学习趋势详情页（ARCHITECTURE.md §7.3 详情页 / §9.2 / §10 P3）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 StudentTrendClient（client component）中。
+ *
+ * 数据契约：studentTrend ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.2 / §10 P3 / §11.3 / §11.4
+ */
+export default function StudentTrendPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/student/weakness/page.tsx b/apps/portal-shell/src/app/shell/student/weakness/page.tsx
new file mode 100644
index 0000000..0539200
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/student/weakness/page.tsx
@@ -0,0 +1,22 @@
+import { Suspense } from "react";
+
+import { StudentWeaknessClient } from "@/features/student/dashboard/weakness-client";
+import { DetailPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * 学生薄弱知识点详情页（ARCHITECTURE.md §7.3 详情页 / §9.2 / §10 P3）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 StudentWeaknessClient（client component）中。
+ *
+ * 数据契约：studentWeakness ❌ schema 无此字段 → MSW 兜底（@contract-pending）
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.2 / §10 P3 / §11.3 / §11.4
+ */
+export default function StudentWeaknessPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/teacher/ai/ai-assist/page.tsx b/apps/portal-shell/src/app/shell/teacher/ai/ai-assist/page.tsx
new file mode 100644
index 0000000..60c79c1
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/teacher/ai/ai-assist/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { AiAssistClient } from "@/features/teacher/ai/ai-assist-client";
+import { WorkbenchPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * AI 助手工作台页（ARCHITECTURE.md §7.3 工作台页 / §9.1 / §10 P2 B2 末）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 AiAssistClient（client component）中。
+ *
+ * 数据契约：全 ❌ MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/ai_contract.md#ai-assist
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 B2 末 / §11.3 / §11.4
+ */
+export default function AiAssistPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/teacher/ai/ai-lesson-plan/page.tsx b/apps/portal-shell/src/app/shell/teacher/ai/ai-lesson-plan/page.tsx
new file mode 100644
index 0000000..fe4cba1
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/teacher/ai/ai-lesson-plan/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { AiLessonPlanClient } from "@/features/teacher/ai/ai-lesson-plan-client";
+import { WorkbenchPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * AI 教案生成工作台页（ARCHITECTURE.md §7.3 工作台页 / §9.1 / §10 P2 B2 末）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 AiLessonPlanClient（client component）中。
+ *
+ * 数据契约：generateLessonPlan(input) ❌ MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/ai_contract.md#ai-lesson-plan
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 B2 末 / §11.3 / §11.4
+ */
+export default function AiLessonPlanPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/teacher/ai/ai-report/page.tsx b/apps/portal-shell/src/app/shell/teacher/ai/ai-report/page.tsx
new file mode 100644
index 0000000..78bb560
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/teacher/ai/ai-report/page.tsx
@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+
+import { AiReportClient } from "@/features/teacher/ai/ai-report-client";
+import { WorkbenchPageSkeleton } from "@/shared/components/page-templates";
+
+/**
+ * AI 学情报告工作台页（ARCHITECTURE.md §7.3 工作台页 / §9.1 / §10 P2 B2 末）
+ *
+ * Server Component 入口：仅负责 Suspense 边界包裹。
+ * 业务逻辑在 AiReportClient（client component）中。
+ *
+ * 数据契约：generateStudentReport(input) ❌ MSW 兜底（@contract-pending）
+ * 契约工单：docs/architecture/issues/contracts/ai_contract.md#ai-report
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.1 / §10 P2 B2 末 / §11.3 / §11.4
+ */
+export default function AiReportPage(): React.ReactElement {
+ return (
+ }>
+
+
+ );
+}
diff --git a/apps/portal-shell/src/app/shell/teacher/ai/error.tsx b/apps/portal-shell/src/app/shell/teacher/ai/error.tsx
new file mode 100644
index 0000000..5486327
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/teacher/ai/error.tsx
@@ -0,0 +1,38 @@
+"use client";
+
+/**
+ * AI 路由错误边界（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment error.tsx，捕获子树未处理异常。
+ */
+import { useEffect } from "react";
+
+import { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function AiError({
+ error,
+ reset,
+}: {
+ error: Error & { digest?: string };
+ reset: () => void;
+}): React.ReactElement {
+ const t = useTranslations("ai");
+
+ useEffect(() => {
+ console.error("[portal-shell] ai route error:", error);
+ }, [error]);
+
+ return (
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("studentDetail.errorTitle")}
+
+
+ {error.message || t("studentDetail.errorUnknown")}
+
+
+
+
+ {t("proctoring.errorTitle")}
+
+
+ {error.message || t("proctoring.errorUnknown")}
+
+
+
-
考试页面出错了
+
+ {t("error.title")}
+
- {error.message || "未知错误"}
+ {error.message || t("error.unknown")}
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
{Array.from({ length: 4 }).map((_, i) => (
@@ -33,10 +35,10 @@ export default function TeacherDashboardPage(): React.ReactElement {
if (error || !data) {
return (
-
+
- 仪表盘数据加载失败，请稍后重试。
+ {t("loadFailed")}
@@ -45,27 +47,27 @@ export default function TeacherDashboardPage(): React.ReactElement {
return (
0}
@@ -73,7 +75,7 @@ export default function TeacherDashboardPage(): React.ReactElement {
}
>
-
+
{data.classes ? (
@@ -81,17 +83,24 @@ export default function TeacherDashboardPage(): React.ReactElement {
{data.classes.class_name ?? "--"}
- {data.classes.student_count ?? 0} 人 · 均分{" "}
- {data.classes.average_score?.toFixed(1) ?? "--"}
+ {t("classesOverview.studentCount", {
+ count: data.classes.student_count ?? 0,
+ })}{" "}
+ ·{" "}
+ {t("classesOverview.avgScore", {
+ score: data.classes.average_score?.toFixed(1) ?? "--",
+ })}
) : (
- 暂无班级数据
+
+ {t("classesOverview.empty")}
+
)}
-
+
{data.recent_warnings ? (
@@ -103,13 +112,15 @@ export default function TeacherDashboardPage(): React.ReactElement {
- 类型：{data.recent_warnings.warning_type ?? "--"} · 当前值{" "}
- {data.recent_warnings.current_value?.toFixed(1) ?? "--"} / 阈值{" "}
+ {t("warnings.type")}：{data.recent_warnings.warning_type ?? "--"}{" "}
+ · {t("warnings.currentValue")}{" "}
+ {data.recent_warnings.current_value?.toFixed(1) ?? "--"} /{" "}
+ {t("warnings.threshold")}{" "}
{data.recent_warnings.threshold?.toFixed(1) ?? "--"}
) : (
- 暂无预警
+ {t("warnings.empty")}
)}
diff --git a/apps/portal-shell/src/app/shell/teacher/practice/error.tsx b/apps/portal-shell/src/app/shell/teacher/practice/error.tsx
new file mode 100644
index 0000000..078fdca
--- /dev/null
+++ b/apps/portal-shell/src/app/shell/teacher/practice/error.tsx
@@ -0,0 +1,38 @@
+"use client";
+
+/**
+ * 练习分析路由错误边界（ARCHITECTURE.md §7.4 三态规范 / §11.3 DoD）。
+ * Next.js Route Segment error.tsx，捕获子树未处理异常。
+ */
+import { useEffect } from "react";
+
+import { Button } from "@/shared/components/ui/button";
+import { useTranslations } from "next-intl";
+
+export default function PracticeError({
+ error,
+ reset,
+}: {
+ error: Error & { digest?: string };
+ reset: () => void;
+}): React.ReactElement {
+ const t = useTranslations("practice");
+
+ useEffect(() => {
+ console.error("[portal-shell] practice route error:", error);
+ }, [error]);
+
+ return (
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {t("error.title")}
+
+
+ {error.message || t("error.unknown")}
+
+
+
+
+ {tCommon("error.loadFailed", { message: String(error) })}
+
+
{t("mswNotice")}
+
+
+
+
+ | {t("colName")} |
+ {t("colType")} |
+ {t("colApiKey")} |
+ {t("colBaseUrl")} |
+ {t("colIsActive")} |
+ {t("colActions")} |
+
+
+
+ {providers.map((p) => (
+
+ |
+ {p.name}
+
+ {p.model}
+
+ |
+
+ {formatProviderType(p.type)}
+ |
+
+ {maskApiKey(extractApiKey(p.config))}
+ |
+
+ {truncateBaseUrl(p.apiBase)}
+ |
+
+
+ |
+
+
+
+
+
+ |
+
+ ))}
+
+
+
{t("mswNotice")}
+
+ );
+}
+
+/**
+ * AI 用量仪表盘分区（StatCard 总览 + 按 Provider 明细）。
+ */
+function UsageDashboardSection({
+ loading,
+ totalRequests,
+ totalTokens,
+ totalCostCents,
+ byProvider,
+}: {
+ loading: boolean;
+ totalRequests: number;
+ totalTokens: number;
+ totalCostCents: number;
+ byProvider: Array<{
+ providerId: string;
+ providerName: string;
+ requests: number;
+ tokens: number;
+ costCents: number;
+ }>;
+}): React.ReactElement {
+ const t = useTranslations("admin.aiSettings.list");
+
+ return (
+
+
{t("usageTitle")}
+
+
+
+
+
+
+
+
+ {t("usageByProvider")}
+
+
+ {byProvider.length === 0 ? (
+ {t("emptyUsage")}
+ ) : (
+
+
+
+
+ |
+ {t("colProviderName")}
+ |
+
+ {t("colRequests")}
+ |
+
+ {t("colTokens")}
+ |
+
+ {t("colCostCents")}
+ |
+
+
+
+ {byProvider.map((row) => (
+
+ | {row.providerName} |
+
+ {formatNumber(row.requests)}
+ |
+
+ {formatNumber(row.tokens)}
+ |
+
+ {formatCostCents(row.costCents)}
+ |
+
+ ))}
+
+
+
+
+
+ {tCommon("error.loadFailed", { message: String(error) })}
+
+
+
+
+ {isAnnouncementArchivable(data.status) ? (
+
+ ) : null}
+
+
+ ) : null
+ }
+ loading={loading}
+ loadingNode={}
+ errorNode={errorNode}
+ emptyNode={
+ !loading && !error && !data ? (
+
+ {t("notFound")}
+
+ ) : undefined
+ }
+ >
+ {data ? : null}
+
+ );
+}
+
+/**
+ * 详情内容区（基本信息 + 公告内容 + 发布范围）。
+ */
+function AnnouncementDetailBody({
+ announcement,
+}: {
+ announcement: AnnouncementDetail;
+}): React.ReactElement {
+ const t = useTranslations("admin.announcements.detail");
+ return (
+ <>
+
+
+ }
+ />
+
+
+
+
+
+
+
+
+
+
+ {announcement.content}
+
+
+
+
+
+ 0
+ ? announcement.grades.join(", ")
+ : "-"
+ }
+ />
+ 0
+ ? announcement.classes.join(", ")
+ : "-"
+ }
+ />
+
+
+ );
+}
+
+/**
+ * 状态徽章（按状态色阶展示）。
+ */
+function StatusBadge({ status }: { status: string }): React.ReactElement {
+ const label = formatAnnouncementStatus(status);
+ const cls = announcementStatusToBadgeClass(status);
+ return (
+
+ {label}
+
+ );
+}
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
new file mode 100644
index 0000000..591a439
--- /dev/null
+++ b/apps/portal-shell/src/features/admin/announcements/announcement-edit-client.tsx
@@ -0,0 +1,252 @@
+"use client";
+
+/**
+ * 公告编辑表单页 - 客户端组件（ARCHITECTURE.md §7.3 表单页 / §9.4 / §10 P5）
+ *
+ * 数据契约：
+ * - 单查 adminAnnouncement(id: ID!) ❌ schema 无 → MSW 兜底（@contract-pending）
+ * - mutation updateAnnouncement(id, input) ❌ → MSW 兜底
+ *
+ * 三态规范（§11.3 DoD）：
+ * - loading：FormPageSkeleton（初始数据加载）
+ * - error：errorSummary 表单级错误
+ * - success：notify.success + router.push 回详情页
+ *
+ * 关联：ARCHITECTURE.md §5.3 / §5.4 / §7.3 / §9.4 / §10 P5 / §11.3 / §11.4
+ */
+import { Megaphone } from "lucide-react";
+import { useParams, useRouter } from "next/navigation";
+import { useEffect, useState, useTransition } from "react";
+import { useTranslations } from "next-intl";
+
+import {
+ useAdminAnnouncement,
+ usePinAnnouncement,
+ useUpdateAnnouncement,
+ type AnnouncementInput,
+} from "@/lib/api";
+import { FormPageShell } from "@/shared/components/page-templates";
+import { notify } from "@/shared/lib/notify";
+import { isAnnouncementPinned } from "@/features/admin/announcements/transformations";
+
+/** 可选状态枚举（与列表筛选对齐） */
+const STATUS_OPTIONS = ["draft", "published", "archived"] as const;
+/** 可选受众枚举 */
+const AUDIENCE_OPTIONS = ["all", "teachers", "students", "parents"] as const;
+
+/**
+ * 编辑表单客户端主体。需由 server page 包裹在 中。
+ */
+export function AnnouncementEditClient(): React.ReactElement {
+ const t = useTranslations("admin.announcements.edit");
+ const tCommon = useTranslations("common");
+ const router = useRouter();
+ const params = useParams<{ id: string }>();
+ const announcementId = params?.id ?? "";
+ const [, startTransition] = useTransition();
+
+ // @contract-pending：MSW 兜底
+ const { data, loading, error } = useAdminAnnouncement(announcementId);
+ // @contract-pending：MSW 兜底
+ const { run: updateAnnouncement, loading: submitting } =
+ useUpdateAnnouncement();
+ const { run: pinAnnouncement } = usePinAnnouncement();
+
+ const [title, setTitle] = useState("");
+ const [content, setContent] = useState("");
+ const [status, setStatus] = useState("draft");
+ const [audience, setAudience] = useState("all");
+ const [pinned, setPinned] = useState(false);
+ const [originalPinned, setOriginalPinned] = useState(false);
+ const [formError, setFormError] = useState(null);
+ const [initialized, setInitialized] = useState(false);
+
+ // 数据到达后预填表单
+ useEffect(() => {
+ if (data && !initialized) {
+ setTitle(data.title);
+ setContent(data.content);
+ setStatus(data.status);
+ setAudience(data.audience);
+ const isPinned = isAnnouncementPinned(data.pinnedAt);
+ setPinned(isPinned);
+ setOriginalPinned(isPinned);
+ setInitialized(true);
+ }
+ }, [data, initialized]);
+
+ const handleFormSubmit = async (): Promise => {
+ 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,
+ };
+
+ try {
+ await updateAnnouncement(announcementId, input);
+ // 若置顶状态变更，同步调用 pin（后端按 toggle 处理）
+ if (pinned !== originalPinned) {
+ try {
+ await pinAnnouncement(announcementId);
+ } catch (pinErr) {
+ notify.error(
+ tCommon("error.loadFailed", { message: String(pinErr) }),
+ );
+ }
+ }
+ notify.success(t("success"));
+ startTransition(() => {
+ router.push(`/shell/admin/announcements/${announcementId}`);
+ });
+ } catch (err) {
+ setFormError(`${t("error")}: ${String(err)}`);
+ }
+ };
+
+ if (loading) {
+ return (
+ }
+ backHref={`/shell/admin/announcements/${announcementId}`}
+ loading
+ />
+ );
+ }
+
+ if (error || (!data && !loading)) {
+ return (
+ }
+ backHref={`/shell/admin/announcements/${announcementId}`}
+ errorSummary={
+
+ {tCommon("error.loadFailed", { message: String(error ?? "") })}
+
+ }
+ />
+ );
+ }
+
+ return (
+ }
+ backHref={`/shell/admin/announcements/${announcementId}`}
+ onSubmit={handleFormSubmit}
+ submitting={submitting}
+ submitLabel={t("submit")}
+ cancelLabel={t("cancel")}
+ errorSummary={
+ formError ? (
+ {formError}
+ ) : undefined
+ }
+ >
+ {/* 标题 */}
+
+ setTitle(e.target.value)}
+ className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm"
+ required
+ />
+
+
+ {/* 内容 */}
+
+