From c2a81209d70ad246bdd6cd48c69adce89c7274a4 Mon Sep 17 00:00:00 2001
From: yuetsh <517252939@qq.com>
Date: Tue, 25 Aug 2026 13:44:24 -0600
Subject: [PATCH] =?UTF-8?q?refactor(=E5=89=8D=E7=AB=AF):=20=E6=8B=86?=
 =?UTF-8?q?=E6=8E=89=20camelCase=E2=86=92snake=5Fcase=20=E8=BD=AC=E6=8D=A2?=
 =?UTF-8?q?=E5=B1=82=EF=BC=8C=E5=A5=91=E7=BA=A6=E6=88=90=E4=B8=BA=E5=94=AF?=
 =?UTF-8?q?=E4=B8=80=E7=9C=9F=E7=9B=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

utils/legacy.ts 是迁移期的临时层：新后端一律 camelCase，而组件读的还是
旧 Django 的 snake_case，于是在 api 层做一次递归键名重写。它自己的注释就
写了「迁移完成后这一层应当整体拆掉」。现在拆了。

代价不只是那 96 处包装：每个响应都要递归遍历整个对象重写一遍键名，而且
utils/types.ts 和 packages/contract 是两份真相 —— 手抄的那份还抄歪了好几处。

做法是按域推进，每域都用 vue-tsc 相对基线做差，确认零新增错误后再往下走。
前端的类型现在一律以契约为准，只在必要处窄化（比如 languages/template 的键
窄化成 LANGUAGE），删掉的重复定义包括 WebsiteConfig、LoginSummary、
AchievementSummary、ProblemSet、Contest、User、Profile、AdminTag、
StuckProblem 等等，其中 ClassComparison 有两个组件各手抄了一份。

## 顺带修掉的真 bug

- 管理端公告列表的「可见」开关每次都 400：列表响应被契约 omit 掉了 content，
  而更新接口要求 content 必填，toggleVisible 把列表行原样回传。而且是乐观
  翻转、不 await 不 catch，管理员看到开关动了、实际没存也没有提示。
  改成先 GET 整条再 PUT，加失败提示。

- 删有提交的题时只显示笼统的「删除失败」：前端还在 match 旧 Django 的英文
  文案，而后端返回的是 problem-has-submissions + 中文。连同另外 8 处同类
  匹配一起改成判错误码 —— 文案是后端随时能改的，match 文案改一个字就静默失效。

- SubmissionStatus.time_limit_exceeded 写成 `1 | 2`，TS 按位或算成 3，和
  memory_limit_exceeded 撞了同一个值。后端 judge/status.ts 里这是分开的
  两个码，按后端拆成 cpu_/real_ 两项。当前没有代码读这两个成员，但
  CLAUDE.md 明确要求判题状态码三处同步。

- 流程图历史翻到没有提交的那一页会直接抛：契约里 submission 是 nullable，
  被 any 掩盖成看起来非空。补了 null 分支。

## 契约里被逼出来的三处不诚实

- grade 写成 z.string()，但 averageGrade() 在没有可用数据时返回空串，
  前端三张图表拿它查 Record<Grade,...> 会查出 undefined。按实际收紧成
  z.enum([...,""])，四个查表点都补了「无评级」分支。

- difficulty 写成 z.string()。核对过生产库 dump：956 道题只有
  Low/Mid/High 三个值（761/149/46）。收紧成枚举。

- topReaction 写成 z.string()，既对不上前端渲染的 {type,count}，也对不上
  旧后端 get_top_reactions 下发的形状。改成正确形状并注明当前恒传 null。

## 明确保留 snake_case 的 54 处

判题沙箱原始输出（cpu_time/exit_code/output_md5/compile_output）、
statistic_info 内容（err_info/time_cost/ast_results）、submission_info
JSONB（is_ac/ac_time/error_number，回滚时旧后端还要读）、SQL 判题引擎的
total_rows/order_sensitive/changed_tables、WebSocket 的 submission_id、
以及数据库选项键 enable_maxkb。每一处都在类型定义旁写了为什么不能改。

language 没有跟着收紧契约 —— 它是配置项、随时可能加语言，收紧会让新语言
在后端 parse 时直接抛。改在 api 边界一处窄化。

## 另外

- utils/http.ts 整个模块已是死代码（四处引用全是 import type），删除。
- profile 的 blog/github/school/major/language 五个字段全链路空转，没有
  任何组件读，从契约到类型一并摘除（数据库列不动）。
- admin/account.ts 往 user_profile 塞的 totalScore 是 OI 模式遗留，表里
  没这一列。Drizzle 按表定义拼列名会把它静默丢弃，所以没出过错，是死代码。

验证：vue-tsc 143 → 54 条且无新增，apps/api tsc、check:routes、web build
全通过；各域响应形状逐条打接口核对过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 apps/api/src/routes/account.ts                |   5 -
 apps/api/src/routes/admin/account.ts          |   1 -
 apps/api/src/routes/auth.ts                   |  40 +-
 apps/api/src/services/profile.ts              |   5 -
 .../components/AchievementModal.vue           |   5 +-
 apps/web/src/admin/achievement/list.vue       |   4 +-
 apps/web/src/admin/ai/list.vue                |  37 +-
 apps/web/src/admin/announcement/list.vue      |  49 +-
 apps/web/src/admin/api.ts                     | 564 ++++++-------
 apps/web/src/admin/contest/detail.vue         |  32 +-
 apps/web/src/admin/contest/helper.vue         |  48 +-
 apps/web/src/admin/contest/list.vue           |   4 +-
 apps/web/src/admin/problem/Stuck.vue          |  20 +-
 apps/web/src/admin/problem/TopACTrend.vue     |  28 +-
 .../src/admin/problem/components/Actions.vue  |   6 +-
 .../admin/problem/components/AddButton.vue    |   4 +-
 .../problem/components/BatchTagModal.vue      |   4 +-
 .../problem/components/SQLTestcaseEditor.vue  |   6 +-
 apps/web/src/admin/problem/detail.vue         | 146 ++--
 apps/web/src/admin/problem/list.vue           |  10 +-
 apps/web/src/admin/problem/tags.vue           |   6 +-
 .../problemset/components/AddBadgeModal.vue   |   2 +-
 .../problemset/components/BadgeManagement.vue |   6 +-
 .../problemset/components/EditBadgeModal.vue  |   6 +-
 .../components/EditProblemModal.vue           |   2 +-
 .../components/ProblemManagement.vue          |   2 +-
 .../problemset/components/ProblemSetInfo.vue  |   6 +-
 .../components/ProgressManagement.vue         |   6 +-
 apps/web/src/admin/problemset/edit.vue        |  10 +-
 apps/web/src/admin/problemset/list.vue        |  10 +-
 apps/web/src/admin/setting/config.vue         |  61 +-
 apps/web/src/admin/setting/home.vue           |   8 +-
 apps/web/src/admin/transforms.ts              |  21 +-
 .../tutorial/components/ExerciseManager.vue   |   2 +-
 apps/web/src/admin/tutorial/detail.vue        |   8 +-
 apps/web/src/admin/tutorial/list.vue          |  30 +-
 .../web/src/admin/user/components/Actions.vue |   6 +-
 apps/web/src/admin/user/components/Name.vue   |  14 +-
 apps/web/src/admin/user/list.vue              |  51 +-
 apps/web/src/oj/achievement/api.ts            |  20 +-
 .../components/AchievementCard.vue            |  12 +-
 apps/web/src/oj/achievement/index.vue         |  19 +-
 .../oj/ai/components/DifficultyGradeChart.vue |   1 +
 .../src/oj/ai/components/DurationChart.vue    |   4 +-
 .../src/oj/ai/components/EfficiencyChart.vue  |   4 +-
 apps/web/src/oj/ai/components/Grade.vue       |   4 +-
 apps/web/src/oj/ai/components/Overview.vue    |   5 +-
 .../src/oj/ai/components/ProgressChart.vue    |   3 +-
 .../ai/components/RankDistributionChart.vue   |   6 +-
 apps/web/src/oj/ai/components/SolvedTable.vue |  26 +-
 apps/web/src/oj/ai/components/TagTitle.vue    |  12 +-
 .../oj/ai/components/TimeActivityHeatmap.vue  |   2 +-
 apps/web/src/oj/announcement/list.vue         |   6 +-
 apps/web/src/oj/api.ts                        | 493 ++++-------
 apps/web/src/oj/class/pk.vue                  | 187 ++---
 .../oj/contest/components/AcAndSubmission.vue |   4 +-
 .../src/oj/contest/components/ContestInfo.vue |   8 +-
 .../src/oj/contest/components/LineChart.vue   |   4 +-
 apps/web/src/oj/contest/list.vue              |  14 +-
 apps/web/src/oj/contest/pages/rank.vue        |  10 +-
 apps/web/src/oj/problem/components/Form.vue   |   4 +-
 .../oj/problem/components/ProblemContent.vue  |  24 +-
 .../problem/components/ProblemFlowchart.vue   |   4 +-
 .../src/oj/problem/components/ProblemInfo.vue |  16 +-
 .../problem/components/ProblemListTitle.vue   |   6 +-
 .../oj/problem/components/ProblemReaction.vue |   2 +-
 .../problem/components/ProblemSubmission.vue  |  20 +-
 .../problem/components/ProblemYearlyChart.vue |   4 +-
 .../problem/components/SubmissionResult.vue   |  12 +-
 .../src/oj/problem/components/SubmitCode.vue  |  10 +-
 .../oj/problem/components/SubmitFlowchart.vue |  42 +-
 apps/web/src/oj/problem/detail.vue            |  10 +-
 .../components/ProblemSetHeader.vue           |   5 +-
 .../components/ProblemSetProblemsList.vue     |   4 +-
 .../components/UserProgressView.vue           |  26 +-
 apps/web/src/oj/problemset/detail.vue         |   8 +-
 apps/web/src/oj/problemset/list.vue           |  35 +-
 apps/web/src/oj/rank/components/Chart.vue     |   4 +-
 apps/web/src/oj/rank/list.vue                 | 121 +--
 apps/web/src/oj/store/ai.ts                   |  11 +-
 apps/web/src/oj/store/contest.ts              |  14 +-
 apps/web/src/oj/store/problem.ts              |   2 +-
 .../components/FlowchartScoreDetail.vue       |  46 +-
 .../src/oj/submission/components/Grade.vue    |   1 +
 .../submission/components/SubmissionLink.vue  |   4 +-
 apps/web/src/oj/submission/detail.vue         |  10 +-
 apps/web/src/oj/submission/list.vue           |  25 +-
 apps/web/src/oj/transforms.ts                 |  36 +-
 apps/web/src/oj/user/index.vue                |  10 +-
 apps/web/src/oj/user/message.vue              |   2 +-
 apps/web/src/oj/user/setting.vue              |   4 +-
 apps/web/src/shared/api.ts                    |  33 +-
 .../src/shared/components/AuthorSelect.vue    |  10 +-
 .../src/shared/components/ContestTitle.vue    |   6 +-
 .../web/src/shared/components/ContestType.vue |   6 +-
 apps/web/src/shared/components/Header.vue     |   4 +-
 apps/web/src/shared/components/Login.vue      |  11 +-
 .../shared/components/LoginSummaryModal.vue   |  12 +-
 apps/web/src/shared/components/Signup.vue     |   4 +-
 apps/web/src/shared/components/UserBadge.vue  |  10 +-
 apps/web/src/shared/composables/maxkb.ts      |   6 +-
 .../src/shared/extensions/autocompletion.ts   |   2 +-
 apps/web/src/shared/store/achievement.ts      |  12 +-
 apps/web/src/shared/store/config.ts           |  18 +-
 apps/web/src/shared/store/loginSummary.ts     |  23 +-
 apps/web/src/shared/store/user.ts             |  24 +-
 apps/web/src/utils/api2.ts                    |  25 +-
 apps/web/src/utils/constants.ts               |  10 +-
 apps/web/src/utils/functions.ts               |   2 +-
 apps/web/src/utils/http.ts                    |  79 --
 apps/web/src/utils/legacy.ts                  |  27 -
 apps/web/src/utils/permissions.ts             |   6 +-
 apps/web/src/utils/types.ts                   | 762 +++++++-----------
 packages/contract/src/account.ts              |  22 +-
 packages/contract/src/achievement.ts          |  30 +-
 packages/contract/src/admin.ts                |  41 +-
 packages/contract/src/ai.ts                   |  21 +-
 packages/contract/src/auth.ts                 |   5 -
 packages/contract/src/classroom.ts            |   5 +
 packages/contract/src/content.ts              |   4 +
 packages/contract/src/contest.ts              |   5 +
 packages/contract/src/flowchart.ts            |   7 +
 packages/contract/src/problem.ts              |  17 +-
 packages/contract/src/problemset.ts           |   9 +
 packages/contract/src/submission.ts           |   5 +
 125 files changed, 1651 insertions(+), 2253 deletions(-)
 delete mode 100644 apps/web/src/utils/http.ts
 delete mode 100644 apps/web/src/utils/legacy.ts

diff --git a/apps/api/src/routes/account.ts b/apps/api/src/routes/account.ts
index df0360d..fb98c85 100644
--- a/apps/api/src/routes/account.ts
+++ b/apps/api/src/routes/account.ts
@@ -84,15 +84,10 @@ accountRoutes.post("/users", async (c) => {
       userId: created.id,
       acmProblemsStatus: {},
       avatar: `${config.avatarUriPrefix}/default.png`,
-      blog: null,
       mood: null,
       acceptedNumber: 0,
       submissionNumber: 0,
-      github: null,
-      school: null,
-      major: null,
       realName: null,
-      language: null,
     })
   })
   return success(c, { ok: true }, 201)
diff --git a/apps/api/src/routes/admin/account.ts b/apps/api/src/routes/admin/account.ts
index 0228932..db31310 100644
--- a/apps/api/src/routes/admin/account.ts
+++ b/apps/api/src/routes/admin/account.ts
@@ -227,7 +227,6 @@ adminAccountRoutes.post("/users", requireSuperAdmin, async (c) => {
       acmProblemsStatus: {},
       submissionNumber: 0,
       acceptedNumber: 0,
-      totalScore: 0,
     })))
     return users.length
   })
diff --git a/apps/api/src/routes/auth.ts b/apps/api/src/routes/auth.ts
index 2b3477c..18aa090 100644
--- a/apps/api/src/routes/auth.ts
+++ b/apps/api/src/routes/auth.ts
@@ -1,9 +1,5 @@
-import {
-  loginRequestSchema,
-  sessionUserSchema,
-  userProfileSchema,
-} from "@oj2/contract"
-import { and, eq, sql } from "drizzle-orm"
+import { loginRequestSchema } from "@oj2/contract"
+import { eq, sql } from "drizzle-orm"
 import { Hono } from "hono"
 
 import { optionalAuth, type AppEnv } from "../auth/middleware"
@@ -17,21 +13,31 @@ import { getUserProfileById } from "../services/profile"
 export const authRoutes = new Hono<AppEnv>()
 
 authRoutes.post("/auth/login", async (c) => {
-  const parsed = loginRequestSchema.safeParse(await c.req.json().catch(() => null))
+  const parsed = loginRequestSchema.safeParse(
+    await c.req.json().catch(() => null),
+  )
   if (!parsed.success) {
-    return failure(c, 400, "invalid-request", "Username and password are required")
+    return failure(
+      c,
+      400,
+      "invalid-request",
+      "Username and password are required",
+    )
   }
 
   const [user] = await db
     .select()
     .from(schema.user)
-    .where(
-      sql`lower(${schema.user.username}) = lower(${parsed.data.username})`,
-    )
+    .where(sql`lower(${schema.user.username}) = lower(${parsed.data.username})`)
     .limit(1)
 
   if (!user) {
-    return failure(c, 401, "invalid-credentials", "Invalid username or password")
+    return failure(
+      c,
+      401,
+      "invalid-credentials",
+      "Invalid username or password",
+    )
   }
   if (user.isDisabled) {
     return failure(c, 403, "account-disabled", "Your account has been disabled")
@@ -39,7 +45,12 @@ authRoutes.post("/auth/login", async (c) => {
 
   const password = await verifyPassword(parsed.data.password, user.password)
   if (!password.valid) {
-    return failure(c, 401, "invalid-credentials", "Invalid username or password")
+    return failure(
+      c,
+      401,
+      "invalid-credentials",
+      "Invalid username or password",
+    )
   }
 
   const now = new Date().toISOString()
@@ -67,6 +78,7 @@ authRoutes.get("/me", optionalAuth, async (c) => {
   if (!authUser) return success(c, null)
 
   const data = await getUserProfileById(authUser.id, true)
-  if (!data) return failure(c, 404, "profile-not-found", "User profile does not exist")
+  if (!data)
+    return failure(c, 404, "profile-not-found", "User profile does not exist")
   return success(c, data)
 })
diff --git a/apps/api/src/services/profile.ts b/apps/api/src/services/profile.ts
index 718a5d7..7b1f6e5 100644
--- a/apps/api/src/services/profile.ts
+++ b/apps/api/src/services/profile.ts
@@ -29,12 +29,7 @@ export async function getUserProfileById(userId: number, showRealName: boolean)
     realName: showRealName ? row.profile.realName : null,
     acmProblemsStatus: row.profile.acmProblemsStatus,
     avatar: row.profile.avatar,
-    blog: row.profile.blog,
     mood: row.profile.mood,
-    github: row.profile.github,
-    school: row.profile.school,
-    major: row.profile.major,
-    language: row.profile.language,
     acceptedNumber: row.profile.acceptedNumber,
     submissionNumber: row.profile.submissionNumber,
   })
diff --git a/apps/web/src/admin/achievement/components/AchievementModal.vue b/apps/web/src/admin/achievement/components/AchievementModal.vue
index 676ba19..d6481fb 100644
--- a/apps/web/src/admin/achievement/components/AchievementModal.vue
+++ b/apps/web/src/admin/achievement/components/AchievementModal.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import type { AchievementRarity } from "utils/types"
 import {
   createAchievement,
   getMetricOptions,
@@ -29,7 +30,7 @@ function emptyForm() {
     name: "",
     description: "",
     icon: "noto:trophy",
-    rarity: "bronze",
+    rarity: "bronze" as AchievementRarity,
     hidden: false,
     metric: "",
     operator: "gte" as "gte" | "lte",
@@ -46,7 +47,7 @@ const metricOptions = computed(() =>
 )
 
 const metricHelp = computed(
-  () => metrics.value.find((m) => m.key === form.value.metric)?.help_text ?? "",
+  () => metrics.value.find((m) => m.key === form.value.metric)?.helpText ?? "",
 )
 
 watch(
diff --git a/apps/web/src/admin/achievement/list.vue b/apps/web/src/admin/achievement/list.vue
index db6d265..bb111a7 100644
--- a/apps/web/src/admin/achievement/list.vue
+++ b/apps/web/src/admin/achievement/list.vue
@@ -74,7 +74,7 @@ const columns: DataTableColumn<AdminAchievement>[] = [
     width: 90,
     render: (row) => RARITY_LABEL[row.rarity] ?? row.rarity,
   },
-  { title: "指标", key: "metric_name" },
+  { title: "指标", key: "metricName" },
   {
     title: "条件",
     key: "threshold",
@@ -93,7 +93,7 @@ const columns: DataTableColumn<AdminAchievement>[] = [
     width: 70,
     render: (row) => (row.visible ? "是" : "否"),
   },
-  { title: "已解锁人数", key: "unlock_count", width: 110 },
+  { title: "已解锁人数", key: "unlockCount", width: 110 },
   {
     title: "操作",
     key: "actions",
diff --git a/apps/web/src/admin/ai/list.vue b/apps/web/src/admin/ai/list.vue
index c0c7e5e..36ecfee 100644
--- a/apps/web/src/admin/ai/list.vue
+++ b/apps/web/src/admin/ai/list.vue
@@ -49,10 +49,10 @@
             detail.username
           }}</n-descriptions-item>
           <n-descriptions-item label="班级">{{
-            detail.class_name || "-"
+            detail.className || "-"
           }}</n-descriptions-item>
           <n-descriptions-item label="时间" :span="2">{{
-            parseTime(detail.create_time, "YYYY-MM-DD HH:mm:ss")
+            parseTime(detail.createTime, "YYYY-MM-DD HH:mm:ss")
           }}</n-descriptions-item>
         </n-descriptions>
         <n-scrollbar style="max-height: 60vh; margin-top: 12px">
@@ -75,19 +75,10 @@ import {
   getPinnedAIReports,
 } from "../api"
 import { NButton, NTag } from "naive-ui"
+import type { AdminAiReport, AdminAiReportListItem } from "utils/types"
 
-interface ReportItem {
-  id: number
-  create_time: string
-  username: string
-  analysis_excerpt: string
-  is_pinned: boolean
-}
-
-interface ReportDetail extends ReportItem {
-  analysis: string
-  class_name: string | null
-}
+type ReportItem = AdminAiReportListItem
+type ReportDetail = AdminAiReport
 
 const reports = ref<ReportItem[]>([])
 const total = ref(0)
@@ -105,29 +96,25 @@ const columns: DataTableColumn<ReportItem>[] = [
     key: "username",
     width: 150,
     render: (row) =>
-      h(
-        "span",
-        { style: row.is_pinned ? "font-weight:600" : "" },
-        row.username,
-      ),
+      h("span", { style: row.isPinned ? "font-weight:600" : "" }, row.username),
   },
   {
     title: "AI 分析内容",
     key: "analysis_excerpt",
-    render: (row) => row.analysis_excerpt || "-",
+    render: (row) => row.analysisExcerpt || "-",
   },
   {
     title: "生成时间",
     key: "create_time",
     width: 200,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "PIN 状态",
     key: "is_pinned",
     width: 100,
     render: (row) =>
-      row.is_pinned
+      row.isPinned
         ? h(NTag, { type: "warning", size: "small" }, () => "已锁定")
         : null,
   },
@@ -146,10 +133,10 @@ const columns: DataTableColumn<ReportItem>[] = [
           NButton,
           {
             size: "small",
-            type: row.is_pinned ? "error" : "default",
+            type: row.isPinned ? "error" : "default",
             onClick: () => togglePin(row),
           },
-          () => (row.is_pinned ? "取消 PIN" : "PIN"),
+          () => (row.isPinned ? "取消 PIN" : "PIN"),
         ),
       ]),
   },
@@ -157,7 +144,7 @@ const columns: DataTableColumn<ReportItem>[] = [
 
 async function loadPinnedReports() {
   const res = await getPinnedAIReports()
-  pinnedReports.value = res.data
+  pinnedReports.value = res.data.results
 }
 
 async function togglePin(row: ReportItem) {
diff --git a/apps/web/src/admin/announcement/list.vue b/apps/web/src/admin/announcement/list.vue
index a4ca45f..4f23823 100644
--- a/apps/web/src/admin/announcement/list.vue
+++ b/apps/web/src/admin/announcement/list.vue
@@ -2,18 +2,19 @@
 import { NSwitch } from "naive-ui"
 import Pagination from "shared/components/Pagination.vue"
 import { parseTime } from "utils/functions"
-import type { Announcement } from "utils/types"
-import { editAnnouncement, getAnnouncementList } from "../api"
+import type { AnnouncementListItem } from "utils/types"
+import { editAnnouncement, getAnnouncement, getAnnouncementList } from "../api"
 import Actions from "./components/Actions.vue"
 
+const message = useMessage()
 const total = ref(0)
 const query = reactive({
   limit: 10,
   page: 1,
 })
-const announcements = ref<Announcement[]>([])
+const announcements = ref<AnnouncementListItem[]>([])
 
-const columns: DataTableColumn<Announcement>[] = [
+const columns: DataTableColumn<AnnouncementListItem>[] = [
   { title: "ID", key: "id", width: 60 },
   { title: "标题", key: "title", minWidth: 300 },
   { title: "标签", key: "tag", width: 80 },
@@ -25,20 +26,20 @@ const columns: DataTableColumn<Announcement>[] = [
   },
   {
     title: "创建时间",
-    key: "create_time",
+    key: "createTime",
     width: 180,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "上次更新时间",
-    key: "last_update_time",
+    key: "lastUpdateTime",
     width: 180,
-    render: (row) => parseTime(row.last_update_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.lastUpdateTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "作者",
-    key: "created_by",
-    render: (row) => row.created_by.username,
+    key: "createdBy",
+    render: (row) => row.createdBy.username,
     width: 80,
   },
   {
@@ -61,16 +62,24 @@ const columns: DataTableColumn<Announcement>[] = [
   },
 ]
 
-async function toggleVisible(announcement: Announcement) {
-  announcement.visible = !announcement.visible
-  editAnnouncement({
-    id: announcement.id,
-    title: announcement.title,
-    tag: announcement.tag,
-    content: announcement.content,
-    visible: announcement.visible,
-    top: announcement.top,
-  })
+// 列表响应不含 content（正文是 8MB 上限的富文本），而更新接口要求 content 必填 ——
+// 拿列表里那行直接回传会 400。所以先取回整条再改。
+async function toggleVisible(announcement: AnnouncementListItem) {
+  const next = !announcement.visible
+  try {
+    const { data: full } = await getAnnouncement(announcement.id)
+    await editAnnouncement({
+      id: full.id,
+      title: full.title,
+      tag: full.tag,
+      content: full.content,
+      visible: next,
+      top: full.top,
+    })
+    announcement.visible = next
+  } catch {
+    message.error("修改可见性失败")
+  }
 }
 
 async function listAnnouncements() {
diff --git a/apps/web/src/admin/api.ts b/apps/web/src/admin/api.ts
index 1eb6572..e9a6d70 100644
--- a/apps/web/src/admin/api.ts
+++ b/apps/web/src/admin/api.ts
@@ -1,32 +1,53 @@
 import api2 from "utils/api2"
-import { legacyResponse } from "utils/legacy"
 import { toProblemListItem } from "admin/transforms"
 import type {
+  AcTrend,
+  BatchProblemTagResponse,
+  GenerateSqlTestCaseResponse,
+  RenameTagResponse,
+  SqlTestCaseScript,
+  AcmHelperItem,
+  AdminAiReport,
+  AdminAiReportList,
+  StuckProblem,
+  AdminContestList,
+  AdminUser,
+  AdminUserList,
+  DashboardInfo,
+  JudgeServerList,
+  OrphanTestCase,
   AdminProblem,
+  AdminProblemList,
   AdminTag,
   Announcement,
   AnnouncementEdit,
+  AnnouncementListItem,
   BlankContest,
   BlankProblem,
   Contest,
   Exercise,
   ExerciseType,
-  Server,
   SQLDisplay,
   TestcaseUploadedReturns,
   Tutorial,
   User,
   WebsiteConfig,
+  ProblemSet,
+  ProblemSetBadge,
+  ProblemSetList,
+  ProblemSetProblem,
+  ProblemSetProgressList,
+  TutorialListItem,
 } from "utils/types"
 
 export function getBaseInfo() {
-  return legacyResponse(api2.get("admin/dashboard"))
+  return api2.get<DashboardInfo>("admin/dashboard")
 }
 
 export function randomUser10(classroom: string) {
-  return legacyResponse(
-    api2.get("admin/random-usernames", { params: { classroom } }),
-  )
+  return api2.get<string[]>("admin/random-usernames", {
+    params: { classroom },
+  })
 }
 
 export async function getProblemList(
@@ -40,10 +61,9 @@ export async function getProblemList(
   const endpoint = contestID
     ? `admin/contests/${contestID}/problems`
     : "admin/problems"
-  const res = await legacyResponse<{
-    results: AdminProblem[]
-    total: number
-  }>(api2.get(endpoint, { params: { offset, limit, keyword, author, tagId } }))
+  const res = await api2.get<AdminProblemList>(endpoint, {
+    params: { offset, limit, keyword, author, tagId },
+  })
   return {
     results: res.data.results.map(toProblemListItem),
     total: res.data.total,
@@ -60,53 +80,46 @@ export function deleteContestProblem(id: number) {
 }
 
 export function editProblem(problem: AdminProblem | BlankProblem) {
-  return legacyResponse(
-    api2.put(
-      `admin/problems/${(problem as AdminProblem).id}`,
-      toProblemBody(problem),
-    ),
+  return api2.put<AdminProblem>(
+    `admin/problems/${(problem as AdminProblem).id}`,
+    toProblemBody(problem),
   )
 }
 
 export function toggleProblemVisible(problemID: number) {
-  return legacyResponse(api2.put(`admin/problems/${problemID}/visibility`))
+  return api2.put<{ visible: boolean }>(
+    `admin/problems/${problemID}/visibility`,
+  )
 }
 
 export function generateFlowchartFromPythonCode(python: string) {
-  return legacyResponse(api2.post("admin/problems/flowchart", { python }))
+  return api2.post<{ flowchart: string }>("admin/problems/flowchart", {
+    python,
+  })
 }
 
 export function editContestProblem(problem: AdminProblem | BlankProblem) {
-  return legacyResponse(
-    api2.put(
-      `admin/problems/${(problem as AdminProblem).id}`,
-      toProblemBody(problem),
-    ),
+  return api2.put<AdminProblem>(
+    `admin/problems/${(problem as AdminProblem).id}`,
+    toProblemBody(problem),
   )
 }
 
 export function getProblem(id: string | number) {
-  return legacyResponse<AdminProblem>(api2.get(`admin/problems/${id}`))
+  return api2.get<AdminProblem>(`admin/problems/${id}`)
 }
 
 export function getContestProblem(id: number) {
-  return legacyResponse<AdminProblem>(api2.get(`admin/problems/${id}`))
+  return api2.get<AdminProblem>(`admin/problems/${id}`)
 }
 
 // 标签管理
 export function getTagAdminList(keyword = "") {
-  return legacyResponse<AdminTag[]>(
-    api2.get("admin/problem-tags", { params: { keyword } }),
-  )
+  return api2.get<AdminTag[]>("admin/problem-tags", { params: { keyword } })
 }
 
 export function renameTag(id: number, name: string) {
-  return legacyResponse<{
-    merged: boolean
-    id: number
-    name: string
-    affected_count: number
-  }>(api2.put(`admin/problem-tags/${id}`, { name }))
+  return api2.put<RenameTagResponse>(`admin/problem-tags/${id}`, { name })
 }
 
 export function deleteTag(id: number) {
@@ -118,13 +131,11 @@ export function batchTagProblems(
   tagNames: string[],
   action: "add" | "remove",
 ) {
-  return legacyResponse<{ problem_count: number; tag_count: number }>(
-    api2.post("admin/problems/batch-tag", {
-      problemIds,
-      tagNames,
-      action,
-    }),
-  )
+  return api2.post<BatchProblemTagResponse>("admin/problems/batch-tag", {
+    problemIds,
+    tagNames,
+    action,
+  })
 }
 
 // 用户列表
@@ -135,34 +146,30 @@ export function getUserList(
   keyword: string,
   orderBy = "",
 ) {
-  return legacyResponse(
-    api2.get("admin/users", {
-      // 旧接口的 order_by 只有 "-last_login" 一个取值
-      params: {
-        offset,
-        limit,
-        keyword,
-        type,
-        orderBy: orderBy === "-last_login" ? "-lastLogin" : orderBy,
-      },
-    }),
-  )
+  return api2.get<AdminUserList>("admin/users", {
+    // 旧接口的 order_by 只有 "-last_login" 一个取值
+    params: {
+      offset,
+      limit,
+      keyword,
+      type,
+      orderBy: orderBy === "-last_login" ? "-lastLogin" : orderBy,
+    },
+  })
 }
 
 // 编辑用户
 export function editUser(user: User) {
-  return legacyResponse(
-    api2.put(`admin/users/${user.id}`, {
-      username: user.username,
-      email: user.email,
-      adminType: user.admin_type,
-      problemPermission: user.problem_permission,
-      realName: user.real_name ?? null,
-      isDisabled: user.is_disabled,
-      openApi: user.open_api,
-      password: user.password ?? "",
-    }),
-  )
+  return api2.put<AdminUser>(`admin/users/${user.id}`, {
+    username: user.username,
+    email: user.email,
+    adminType: user.adminType,
+    problemPermission: user.problemPermission,
+    realName: user.realName ?? null,
+    isDisabled: user.isDisabled,
+    openApi: user.openApi,
+    password: user.password ?? "",
+  })
 }
 
 // 重置用户密码。调用方直接用 res.data 当密码字符串（旧后端返回的就是裸字符串），
@@ -185,9 +192,9 @@ export function deleteUsers(userIDs: number[]) {
 }
 
 export function getContestList(offset = 0, limit = 10, keyword: string) {
-  return legacyResponse(
-    api2.get("admin/contests", { params: { offset, limit, keyword } }),
-  )
+  return api2.get<AdminContestList>("admin/contests", {
+    params: { offset, limit, keyword },
+  })
 }
 
 // 上传图片
@@ -218,53 +225,45 @@ export function uploadTestcases(file: File, options: { sql?: boolean } = {}) {
 
 // SQL 题测试点预览：后端跑一遍初始化脚本+标准答案，返回数据表和期望结果展示数据
 export function previewSQLTestcase(data: {
-  init_sql: string
-  ref_sql: string
+  initSql: string
+  refSql: string
   mode: "query" | "modify"
 }) {
-  return legacyResponse<SQLDisplay>(
-    api2.post("admin/sql-test-cases/preview", {
-      initSql: data.init_sql,
-      refSql: data.ref_sql,
-      mode: data.mode,
-    }),
-  )
+  return api2.post<SQLDisplay>("admin/sql-test-cases/preview", data)
 }
 
 // 回显已上传的 SQL 测试点脚本内容（按 1.sql, 2.sql... 排序）
 export function getSQLTestcaseScripts(problemId: number) {
-  return legacyResponse<{ name: string; content: string }[]>(
-    api2.get(`admin/problems/${problemId}/sql-scripts`),
+  return api2.get<SqlTestCaseScript[]>(
+    `admin/problems/${problemId}/sql-scripts`,
   )
 }
 
 // AI 根据标准答案生成一个 SQL 测试点初始化脚本
 export function generateSQLTestcase(data: {
-  ref_sql: string
+  refSql: string
   mode: "query" | "modify"
 }) {
-  return legacyResponse<{ sql: string }>(
-    api2.post("admin/sql-test-cases/generate", {
-      refSql: data.ref_sql,
-      mode: data.mode,
-    }),
+  return api2.post<GenerateSqlTestCaseResponse>(
+    "admin/sql-test-cases/generate",
+    data,
   )
 }
 
-/** 组件里的题目对象是 snake_case，出站转成新后端要的 camelCase */
+/** 出站补默认值。字段名两边已经一致，不再做键名转换 */
 function toProblemBody(problem: AdminProblem | BlankProblem) {
-  const p = problem as Record<string, any>
+  const p = problem as Partial<AdminProblem>
   return {
     _id: p._id,
     title: p.title,
     description: p.description,
-    inputDescription: p.input_description ?? "",
-    outputDescription: p.output_description ?? "",
+    inputDescription: p.inputDescription ?? "",
+    outputDescription: p.outputDescription ?? "",
     samples: p.samples ?? [],
-    testCaseId: p.test_case_id,
-    testCaseScore: p.test_case_score ?? [],
-    timeLimit: p.time_limit,
-    memoryLimit: p.memory_limit,
+    testCaseId: p.testCaseId,
+    testCaseScore: p.testCaseScore ?? [],
+    timeLimit: p.timeLimit,
+    memoryLimit: p.memoryLimit,
     languages: p.languages ?? [],
     template: p.template ?? {},
     visible: p.visible,
@@ -274,25 +273,25 @@ function toProblemBody(problem: AdminProblem | BlankProblem) {
     source: p.source ?? null,
     prompt: p.prompt ?? null,
     answers: p.answers ?? [],
-    shareSubmission: p.share_submission ?? false,
-    allowFlowchart: p.allow_flowchart ?? false,
-    showFlowchart: p.show_flowchart ?? false,
-    mermaidCode: p.mermaid_code ?? null,
-    flowchartHint: p.flowchart_hint ?? null,
-    astRules: p.ast_rules ?? null,
-    sqlConfig: p.sql_config ?? null,
+    shareSubmission: p.shareSubmission ?? false,
+    allowFlowchart: p.allowFlowchart ?? false,
+    showFlowchart: p.showFlowchart ?? false,
+    mermaidCode: p.mermaidCode ?? null,
+    flowchartHint: p.flowchartHint ?? null,
+    astRules: p.astRules ?? null,
+    sqlConfig: p.sqlConfig ?? null,
   }
 }
 
 export function createProblem(problem: BlankProblem) {
-  return legacyResponse(api2.post("admin/problems", toProblemBody(problem)))
+  return api2.post<AdminProblem>("admin/problems", toProblemBody(problem))
 }
 
 export function createContestProblem(problem: BlankProblem) {
-  // contest_id 由 detail.vue 在提交前写进 problem 对象
-  const contestID = (problem as Record<string, any>).contest_id
-  return legacyResponse(
-    api2.post(`admin/contests/${contestID}/problems`, toProblemBody(problem)),
+  // contestId 由 detail.vue 在提交前写进 problem 对象
+  return api2.post<AdminProblem>(
+    `admin/contests/${problem.contestId}/problems`,
+    toProblemBody(problem),
   )
 }
 
@@ -302,35 +301,31 @@ function toContestBody(contest: Contest | BlankContest) {
     title: contest.title,
     description: contest.description,
     tag: contest.tag,
-    startTime: contest.start_time,
-    endTime: contest.end_time,
+    startTime: contest.startTime,
+    endTime: contest.endTime,
     password: contest.password || null,
     visible: contest.visible,
-    allowedIpRanges: contest.allowed_ip_ranges ?? [],
+    allowedIpRanges: contest.allowedIpRanges ?? [],
   }
 }
 
 export function createContest(contest: BlankContest) {
-  return legacyResponse(api2.post("admin/contests", toContestBody(contest)))
+  return api2.post<Contest>("admin/contests", toContestBody(contest))
 }
 
 export function editContest(contest: Contest | BlankContest) {
-  return legacyResponse(
-    api2.put(
-      `admin/contests/${(contest as Contest).id}`,
-      toContestBody(contest),
-    ),
+  return api2.put<Contest>(
+    `admin/contests/${(contest as Contest).id}`,
+    toContestBody(contest),
   )
 }
 
-export function cloneContest(contest_id: number) {
-  return legacyResponse(api2.post(`admin/contests/${contest_id}/clone`))
+export function cloneContest(contestId: number) {
+  return api2.post<Contest>(`admin/contests/${contestId}/clone`)
 }
 
 export function getContest(id: string) {
-  return legacyResponse<Contest & { password: string }>(
-    api2.get(`admin/contests/${id}`),
-  )
+  return api2.get<Contest>(`admin/contests/${id}`)
 }
 
 export function addProblemForContest(
@@ -338,33 +333,22 @@ export function addProblemForContest(
   problemID: number,
   displayID: string,
 ) {
-  return legacyResponse(
-    api2.post(`admin/contests/${contestID}/problems/from-public`, {
-      problemId: problemID,
-      displayId: displayID,
-    }),
+  return api2.post<AdminProblem>(
+    `admin/contests/${contestID}/problems/from-public`,
+    { problemId: problemID, displayId: displayID },
   )
 }
 
 export function getWebsite() {
-  return legacyResponse<WebsiteConfig>(api2.get("admin/website"))
+  return api2.get<WebsiteConfig>("admin/website")
 }
 
 export function editWebsite(data: WebsiteConfig) {
-  return api2.post("admin/website", {
-    websiteBaseUrl: data.website_base_url,
-    websiteName: data.website_name,
-    websiteNameShortcut: data.website_name_shortcut,
-    websiteFooter: data.website_footer,
-    allowRegister: data.allow_register,
-    submissionListShowAll: data.submission_list_show_all,
-    classList: data.class_list,
-    enableMaxkb: data.enable_maxkb,
-  })
+  return api2.post<WebsiteConfig>("admin/website", data)
 }
 
 export function listInvalidTestcases() {
-  return legacyResponse(api2.get("admin/orphan-test-cases"))
+  return api2.get<OrphanTestCase[]>("admin/orphan-test-cases")
 }
 
 export function pruneInvalidTestcases(id?: string) {
@@ -372,9 +356,7 @@ export function pruneInvalidTestcases(id?: string) {
 }
 
 export function getJudgeServer() {
-  return legacyResponse<{ token: string; servers: Server[] }>(
-    api2.get("admin/judge-servers"),
-  )
+  return api2.get<JudgeServerList>("admin/judge-servers")
 }
 
 export function deleteJudgeServer(hostname: string) {
@@ -382,15 +364,14 @@ export function deleteJudgeServer(hostname: string) {
 }
 
 export function getAnnouncementList(offset = 0, limit = 10) {
-  return legacyResponse(
-    api2.get("admin/announcements", {
-      params: { offset, limit },
-    }),
+  return api2.get<{ results: AnnouncementListItem[]; total: number }>(
+    "admin/announcements",
+    { params: { offset, limit } },
   )
 }
 
 export function getAnnouncement(id: number) {
-  return legacyResponse<Announcement>(api2.get(`admin/announcements/${id}`))
+  return api2.get<Announcement>(`admin/announcements/${id}`)
 }
 
 export function deleteAnnouncement(id: number) {
@@ -399,48 +380,46 @@ export function deleteAnnouncement(id: number) {
 
 export function editAnnouncement(announcement: AnnouncementEdit) {
   const { id, ...body } = announcement
-  return legacyResponse(api2.put(`admin/announcements/${id}`, body))
+  return api2.put<Announcement>(`admin/announcements/${id}`, body)
 }
 
 export function createAnnouncement(announcement: AnnouncementEdit) {
   const { id: _id, ...body } = announcement
-  return legacyResponse(api2.post("admin/announcements", body))
-}
-
-/** 组件里的 Tutorial 仍是 snake_case，出站时转成新后端要的 camelCase */
-function toTutorialBody(data: Partial<Tutorial>) {
-  return {
-    title: data.title,
-    content: data.content,
-    code: data.code ?? null,
-    isPublic: data.is_public ?? false,
-    order: data.order ?? 0,
-    type: data.type,
-  }
+  return api2.post<Announcement>("admin/announcements", body)
 }
 
 export async function getTutorialList() {
-  const res = await legacyResponse<{ [key: string]: Tutorial[] }>(
-    api2.get("admin/tutorials"),
+  const res = await api2.get<{ [key: string]: TutorialListItem[] }>(
+    "admin/tutorials",
   )
   return res.data
 }
 
 export async function getTutorial(id: number) {
-  const res = await legacyResponse<Tutorial>(api2.get(`admin/tutorials/${id}`))
+  const res = await api2.get<Tutorial>(`admin/tutorials/${id}`)
   return res.data
 }
 
+function toTutorialBody(data: Partial<Tutorial>) {
+  return {
+    title: data.title,
+    content: data.content,
+    code: data.code ?? null,
+    isPublic: data.isPublic ?? false,
+    order: data.order ?? 0,
+    type: data.type,
+  }
+}
+
 export async function createTutorial(data: Partial<Tutorial>) {
-  const res = await legacyResponse<Tutorial>(
-    api2.post("admin/tutorials", toTutorialBody(data)),
-  )
+  const res = await api2.post<Tutorial>("admin/tutorials", toTutorialBody(data))
   return res.data
 }
 
 export async function updateTutorial(data: Partial<Tutorial>) {
-  const res = await legacyResponse<Tutorial>(
-    api2.put(`admin/tutorials/${data.id}`, toTutorialBody(data)),
+  const res = await api2.put<Tutorial>(
+    `admin/tutorials/${data.id}`,
+    toTutorialBody(data),
   )
   return res.data
 }
@@ -449,33 +428,24 @@ export function deleteTutorial(id: number) {
   return api2.delete(`admin/tutorials/${id}`)
 }
 
-export function setTutorialVisibility(id: number, is_public: boolean) {
-  return legacyResponse(
-    api2.put(`admin/tutorials/${id}/visibility`, { isPublic: is_public }),
-  )
+export function setTutorialVisibility(id: number, isPublic: boolean) {
+  return api2.put<Tutorial>(`admin/tutorials/${id}/visibility`, { isPublic })
 }
 
 export async function getAdminExercises(tutorialId: number) {
-  const res = await legacyResponse<Exercise[]>(
-    api2.get(`admin/tutorials/${tutorialId}/exercises`),
+  const res = await api2.get<Exercise[]>(
+    `admin/tutorials/${tutorialId}/exercises`,
   )
   return res.data
 }
 
 export async function createExercise(data: {
-  tutorial_id: number
+  tutorialId: number
   type: ExerciseType
   data: object
   order: number
 }) {
-  const res = await legacyResponse<Exercise>(
-    api2.post("admin/exercises", {
-      tutorialId: data.tutorial_id,
-      type: data.type,
-      data: data.data,
-      order: data.order,
-    }),
-  )
+  const res = await api2.post<Exercise>("admin/exercises", data)
   return res.data
 }
 
@@ -485,13 +455,11 @@ export async function updateExercise(data: {
   data: object
   order: number
 }) {
-  const res = await legacyResponse<Exercise>(
-    api2.put(`admin/exercises/${data.id}`, {
-      type: data.type,
-      data: data.data,
-      order: data.order,
-    }),
-  )
+  const res = await api2.put<Exercise>(`admin/exercises/${data.id}`, {
+    type: data.type,
+    data: data.data,
+    order: data.order,
+  })
   return res.data
 }
 
@@ -500,15 +468,15 @@ export function deleteExercise(id: number) {
 }
 
 // 将竞赛题目转为公开题目
-export function makeProblemPublic(id: number, display_id: string) {
-  return legacyResponse(
-    api2.post(`admin/problems/${id}/make-public`, { displayId: display_id }),
-  )
+export function makeProblemPublic(id: number, displayId: string) {
+  return api2.post<AdminProblem>(`admin/problems/${id}/make-public`, {
+    displayId,
+  })
 }
 
 // 比赛辅助检查
-export function getACMHelperList(contest_id: number) {
-  return legacyResponse(api2.get(`admin/contests/${contest_id}/acm-helper`))
+export function getACMHelperList(contestId: number) {
+  return api2.get<AcmHelperItem[]>(`admin/contests/${contestId}/acm-helper`)
 }
 
 export function updateACMHelperChecked(
@@ -532,57 +500,44 @@ export function getProblemSetList(
   difficulty = "",
   status = "",
 ) {
-  return legacyResponse(
-    api2.get("admin/problem-sets", {
-      params: { offset, limit, keyword, difficulty, status },
-    }),
-  )
+  return api2.get<ProblemSetList>("admin/problem-sets", {
+    params: { offset, limit, keyword, difficulty, status },
+  })
 }
 
 export function getProblemSetDetail(id: number) {
-  return legacyResponse(api2.get(`admin/problem-sets/${id}`))
+  return api2.get<ProblemSet>(`admin/problem-sets/${id}`)
 }
 
-/** 组件传的是 snake_case，出站转成新后端要的 camelCase */
-function toProblemSetBody(data: {
+interface ProblemSetBody {
   title?: string
   description?: string
-  difficulty?: string
-  status?: string
-  end_time?: Date | null
+  difficulty?: ProblemSet["difficulty"]
+  status?: ProblemSet["status"]
+  // 表单里是 Date，出站要 ISO 串
+  endTime?: Date | null
   visible?: boolean
-}) {
+}
+
+function toProblemSetBody(data: ProblemSetBody) {
   return {
     title: data.title,
     description: data.description ?? "",
     difficulty: data.difficulty ?? "Easy",
     status: data.status ?? "active",
-    endTime: data.end_time ? new Date(data.end_time).toISOString() : null,
+    endTime: data.endTime ? new Date(data.endTime).toISOString() : null,
     visible: data.visible ?? true,
   }
 }
 
-export function createProblemSet(data: {
-  title: string
-  description: string
-  difficulty: string
-  status: string
-  end_time?: Date | null
-}) {
-  return legacyResponse(api2.post("admin/problem-sets", toProblemSetBody(data)))
+export function createProblemSet(data: ProblemSetBody) {
+  return api2.post<ProblemSet>("admin/problem-sets", toProblemSetBody(data))
 }
 
-export function editProblemSet(data: {
-  id: number
-  title?: string
-  description?: string
-  difficulty?: string
-  status?: string
-  end_time?: Date | null
-  visible?: boolean
-}) {
-  return legacyResponse(
-    api2.put(`admin/problem-sets/${data.id}`, toProblemSetBody(data)),
+export function editProblemSet(data: ProblemSetBody & { id: number }) {
+  return api2.put<ProblemSet>(
+    `admin/problem-sets/${data.id}`,
+    toProblemSetBody(data),
   )
 }
 
@@ -591,32 +546,34 @@ export function deleteProblemSet(id: number) {
 }
 
 export function toggleProblemSetVisible(id: number) {
-  return legacyResponse(api2.put(`admin/problem-sets/${id}/visibility`))
+  return api2.put<ProblemSet>(`admin/problem-sets/${id}/visibility`)
 }
 
 export function updateProblemSetStatus(id: number, status: string) {
-  return legacyResponse(api2.put(`admin/problem-sets/${id}/status`, { status }))
+  return api2.put<ProblemSet>(`admin/problem-sets/${id}/status`, { status })
 }
 
 // 题单题目管理 API
 export function getProblemSetProblems(problemSetId: number) {
-  return legacyResponse(api2.get(`admin/problem-sets/${problemSetId}/problems`))
+  return api2.get<ProblemSetProblem[]>(
+    `admin/problem-sets/${problemSetId}/problems`,
+  )
 }
 
 export function addProblemToSet(
   problemSetId: number,
   data: {
-    problem_id: string
+    problemId: string
     order?: number
-    is_required?: boolean
+    isRequired?: boolean
     score?: number
     hint?: string
   },
 ) {
   return api2.post(`admin/problem-sets/${problemSetId}/problems`, {
-    problemId: data.problem_id,
+    problemId: data.problemId,
     order: data.order ?? 0,
-    isRequired: data.is_required ?? true,
+    isRequired: data.isRequired ?? true,
     score: data.score ?? 0,
     hint: data.hint ?? "",
   })
@@ -627,19 +584,14 @@ export function editProblemInSet(
   problemSetProblemId: number,
   data: {
     order?: number
-    is_required?: boolean
+    isRequired?: boolean
     score?: number
     hint?: string
   },
 ) {
   return api2.put(
     `admin/problem-sets/${problemSetId}/problems/${problemSetProblemId}`,
-    {
-      order: data.order,
-      isRequired: data.is_required,
-      score: data.score,
-      hint: data.hint,
-    },
+    data,
   )
 }
 
@@ -654,58 +606,44 @@ export function removeProblemFromSet(
 
 // 题单奖章管理 API
 export function getProblemSetBadges(problemSetId: number) {
-  return legacyResponse(api2.get(`admin/problem-sets/${problemSetId}/badges`))
+  return api2.get<ProblemSetBadge[]>(
+    `admin/problem-sets/${problemSetId}/badges`,
+  )
 }
 
-function toBadgeBody(data: {
+interface BadgeBody {
   name?: string
   description?: string
   icon?: string
-  condition_type?: string
-  condition_value?: number
-}) {
+  conditionType?: ProblemSetBadge["conditionType"]
+  conditionValue?: number
+}
+
+function toBadgeBody(data: BadgeBody) {
   return {
     name: data.name,
     description: data.description ?? "",
     icon: data.icon ?? "",
-    conditionType: data.condition_type,
-    conditionValue: data.condition_value ?? 0,
+    conditionType: data.conditionType,
+    conditionValue: data.conditionValue ?? 0,
   }
 }
 
-export function createProblemSetBadge(
-  problemSetId: number,
-  data: {
-    name: string
-    description: string
-    icon: string
-    condition_type: string
-    condition_value: number
-    level?: number
-  },
-) {
-  return legacyResponse(
-    api2.post(`admin/problem-sets/${problemSetId}/badges`, toBadgeBody(data)),
+export function createProblemSetBadge(problemSetId: number, data: BadgeBody) {
+  return api2.post<ProblemSetBadge>(
+    `admin/problem-sets/${problemSetId}/badges`,
+    toBadgeBody(data),
   )
 }
 
 export function editProblemSetBadge(
   problemSetId: number,
   badgeId: number,
-  data: {
-    name?: string
-    description?: string
-    icon?: string
-    condition_type?: string
-    condition_value?: number
-    level?: number
-  },
+  data: BadgeBody,
 ) {
-  return legacyResponse(
-    api2.put(
-      `admin/problem-sets/${problemSetId}/badges/${badgeId}`,
-      toBadgeBody(data),
-    ),
+  return api2.put<ProblemSetBadge>(
+    `admin/problem-sets/${problemSetId}/badges/${badgeId}`,
+    toBadgeBody(data),
   )
 }
 
@@ -715,7 +653,9 @@ export function deleteProblemSetBadge(problemSetId: number, badgeId: number) {
 
 // 题单进度管理 API
 export function getProblemSetProgress(problemSetId: number) {
-  return legacyResponse(api2.get(`admin/problem-sets/${problemSetId}/progress`))
+  return api2.get<ProblemSetProgressList>(
+    `admin/problem-sets/${problemSetId}/progress`,
+  )
 }
 
 export function removeUserFromProblemSet(problemSetId: number, userId: number) {
@@ -724,74 +664,46 @@ export function removeUserFromProblemSet(problemSetId: number, userId: number) {
 
 // 学生卡点分析
 export function getStuckProblems() {
-  return legacyResponse(api2.get("admin/problem-analytics/stuck"))
+  return api2.get<StuckProblem[]>("admin/problem-analytics/stuck")
 }
 
 export function getTopACTrend(params: {
-  since_year: number
-  until_year: number
-  min_per_year: number
+  sinceYear: number
+  untilYear: number
+  minPerYear: number
 }) {
-  return legacyResponse(
-    api2.get("admin/problem-analytics/ac-trend", {
-      params: {
-        sinceYear: params.since_year,
-        untilYear: params.until_year,
-        minPerYear: params.min_per_year,
-      },
-    }),
-  )
+  return api2.get<AcTrend[]>("admin/problem-analytics/ac-trend", { params })
 }
 
 // AI 学习分析报告
 export function getAIReportList(offset = 0, limit = 10, username = "") {
-  return legacyResponse(
-    api2.get("admin/ai/reports", {
-      params: { offset, limit, username: username || undefined },
-    }),
-  )
+  return api2.get<AdminAiReportList>("admin/ai/reports", {
+    params: { offset, limit, username: username || undefined },
+  })
 }
 
 export function getAIReportDetail(id: number) {
-  return legacyResponse(api2.get(`admin/ai/reports/${id}`))
+  return api2.get<AdminAiReport>(`admin/ai/reports/${id}`)
 }
 
 export function pinAIReport(id: number) {
-  return legacyResponse(api2.post(`admin/ai/reports/${id}/pin`))
+  return api2.post<{ isPinned: boolean }>(`admin/ai/reports/${id}/pin`)
 }
 
 export function getPinnedAIReports() {
-  return legacyResponse(
-    api2.get("admin/ai/reports", { params: { pinnedOnly: "true" } }),
-  )
+  return api2.get<AdminAiReportList>("admin/ai/reports", {
+    params: { pinnedOnly: "true" },
+  })
 }
 
 // ==================== 成就 ====================
 
-export interface AdminAchievement {
-  id: number
-  name: string
-  description: string
-  icon: string
-  rarity: string
-  hidden: boolean
-  metric: string
-  metric_name: string
-  operator: "gte" | "lte"
-  threshold: number
-  visible: boolean
-  unlock_count: number
-  order: number
-  create_time: string
-}
+import type {
+  AdminAchievement,
+  AchievementMetric as MetricOption,
+} from "@oj2/contract"
+export type { AdminAchievement, MetricOption }
 
-export interface MetricOption {
-  key: string
-  name: string
-  help_text: string
-}
-
-/** 组件里的成就对象是 snake_case，出站转成新后端要的 camelCase */
 function toAchievementBody(data: Partial<AdminAchievement>) {
   return {
     name: data.name,
@@ -808,22 +720,24 @@ function toAchievementBody(data: Partial<AdminAchievement>) {
 }
 
 export function getAdminAchievements() {
-  return legacyResponse<AdminAchievement[]>(api2.get("admin/achievements"))
+  return api2.get<AdminAchievement[]>("admin/achievements")
 }
 
 export function getMetricOptions() {
-  return legacyResponse<MetricOption[]>(api2.get("admin/achievement-metrics"))
+  return api2.get<MetricOption[]>("admin/achievement-metrics")
 }
 
 export function createAchievement(data: Partial<AdminAchievement>) {
-  return legacyResponse<AdminAchievement>(
-    api2.post("admin/achievements", toAchievementBody(data)),
+  return api2.post<AdminAchievement>(
+    "admin/achievements",
+    toAchievementBody(data),
   )
 }
 
 export function updateAchievement(data: Partial<AdminAchievement>) {
-  return legacyResponse<AdminAchievement>(
-    api2.put(`admin/achievements/${data.id}`, toAchievementBody(data)),
+  return api2.put<AdminAchievement>(
+    `admin/achievements/${data.id}`,
+    toAchievementBody(data),
   )
 }
 
diff --git a/apps/web/src/admin/contest/detail.vue b/apps/web/src/admin/contest/detail.vue
index 4aa66f2..55342a5 100644
--- a/apps/web/src/admin/contest/detail.vue
+++ b/apps/web/src/admin/contest/detail.vue
@@ -23,8 +23,8 @@ const durationMins = ref(10) // 比赛默认时长10分钟
 
 watch([waitMins, durationMins], () => {
   const times = getTimes()
-  contest.start_time = formatISO(times[0])
-  contest.end_time = formatISO(times[1])
+  contest.startTime = formatISO(times[0])
+  contest.endTime = formatISO(times[1])
 })
 
 // 编辑的时候
@@ -32,8 +32,8 @@ const startTime = ref(0)
 const endTime = ref(0)
 
 watch([startTime, endTime], (values) => {
-  contest.start_time = formatISO(values[0])
-  contest.end_time = formatISO(values[1])
+  contest.startTime = formatISO(values[0])
+  contest.endTime = formatISO(values[1])
 })
 
 const route = useRoute()
@@ -54,18 +54,18 @@ const contest = reactive<BlankContest & { id: number }>({
   title: "",
   description: "",
   tag: "练习",
-  start_time: "",
-  end_time: "",
+  startTime: "",
+  endTime: "",
   password: "",
   visible: false,
-  allowed_ip_ranges: [],
+  allowedIpRanges: [],
 })
 
 async function getContestDetail() {
   if (!props.contestID) {
     const times = getTimes()
-    contest.start_time = formatISO(times[0])
-    contest.end_time = formatISO(times[1])
+    contest.startTime = formatISO(times[0])
+    contest.endTime = formatISO(times[1])
     toggleReady(true)
     return
   }
@@ -75,15 +75,15 @@ async function getContestDetail() {
   contest.title = data.title
   contest.description = data.description
   contest.tag = data.tag
-  contest.start_time = data.start_time
-  contest.end_time = data.end_time
+  contest.startTime = data.startTime
+  contest.endTime = data.endTime
   contest.password = data.password
   contest.visible = data.visible
-  contest.allowed_ip_ranges = []
+  contest.allowedIpRanges = []
 
   // 显示
-  startTime.value = Date.parse(data.start_time)
-  endTime.value = Date.parse(data.end_time)
+  startTime.value = Date.parse(data.startTime)
+  endTime.value = Date.parse(data.endTime)
 }
 
 async function submit() {
@@ -118,12 +118,12 @@ onMounted(getContestDetail)
     <template v-if="!props.contestID">
       <n-alert type="success">
         <template #header>
-          开始时间 {{ parseTime(contest.start_time, "YYYY年M月D日 HH:mm:ss") }}
+          开始时间 {{ parseTime(contest.startTime, "YYYY年M月D日 HH:mm:ss") }}
         </template>
       </n-alert>
       <n-alert type="warning">
         <template #header>
-          结束时间 {{ parseTime(contest.end_time, "YYYY年M月D日 HH:mm:ss") }}
+          结束时间 {{ parseTime(contest.endTime, "YYYY年M月D日 HH:mm:ss") }}
         </template>
       </n-alert>
     </template>
diff --git a/apps/web/src/admin/contest/helper.vue b/apps/web/src/admin/contest/helper.vue
index 0dbd966..79524ad 100644
--- a/apps/web/src/admin/contest/helper.vue
+++ b/apps/web/src/admin/contest/helper.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import type { AcmHelperItem, SubmissionInfo } from "utils/types"
 import { NButton, NCheckbox, NSelect, NTag } from "naive-ui"
 import { parseTime } from "utils/functions"
 import { getACMHelperList, getContest, updateACMHelperChecked } from "../api"
@@ -10,19 +11,12 @@ interface Props {
   contestID: string
 }
 
-interface HelperItem {
-  id: number
-  username: string
-  real_name: string
-  problem_id: string
-  problem_display_id: string
-  ac_info: {
-    is_ac: boolean
-    ac_time: number
-    error_number: number
-    checked?: boolean
-  }
-  checked: boolean
+/**
+ * ACM 助手行。`acInfo` 的**内容**是 acm_contest_rank.submission_info 的 JSONB 原文，
+ * 键名保持 snake_case —— 回滚时旧后端还要读。
+ */
+type HelperItem = Omit<AcmHelperItem, "acInfo"> & {
+  acInfo: SubmissionInfo
 }
 
 const props = defineProps<Props>()
@@ -65,12 +59,12 @@ async function toggleChecked(item: HelperItem) {
     await updateACMHelperChecked(
       Number(props.contestID),
       item.id,
-      item.problem_id,
+      item.problemId,
       newChecked,
     )
     // 更新本地状态
     item.checked = newChecked
-    item.ac_info.checked = newChecked
+    item.acInfo.checked = newChecked
 
     // 强制触发响应式更新
     submissions.value = [...submissions.value]
@@ -95,11 +89,11 @@ async function markAllAsChecked() {
       await updateACMHelperChecked(
         Number(props.contestID),
         item.id,
-        item.problem_id,
+        item.problemId,
         true,
       )
       item.checked = true
-      item.ac_info.checked = true
+      item.acInfo.checked = true
     }
 
     // 强制触发响应式更新
@@ -117,7 +111,7 @@ async function markAllAsChecked() {
 const filteredSubmissions = computed(() => {
   return submissions.value.filter((item) => {
     if (query.username && !item.username.includes(query.username)) return false
-    if (query.problemId && !item.problem_display_id.includes(query.problemId))
+    if (query.problemId && !item.problemDisplayId.includes(query.problemId))
       return false
     if (query.checked === "checked" && !item.checked) return false
     if (query.checked === "unchecked" && item.checked) return false
@@ -139,8 +133,8 @@ async function viewSubmission(item: HelperItem) {
     // 查询该用户在该竞赛该题目的 AC 提交
     const res = await getSubmissions({
       username: item.username,
-      problem_id: item.problem_display_id,
-      contest_id: props.contestID,
+      problemId: item.problemDisplayId,
+      contestId: props.contestID,
       result: "0", // ACCEPTED
       language: "",
       page: 1,
@@ -161,7 +155,7 @@ async function viewSubmission(item: HelperItem) {
     currentSubmission.value = {
       ...detailRes.data,
       contest: Number(props.contestID),
-      problem_display_id: item.problem_display_id,
+      problem_display_id: item.problemDisplayId,
     }
 
     toggleCodePanel(true)
@@ -175,7 +169,7 @@ async function loadData() {
   try {
     // 先获取比赛信息，获取开始时间
     const contestRes = await getContest(props.contestID)
-    contestStartTime.value = new Date(contestRes.data.start_time)
+    contestStartTime.value = new Date(contestRes.data.startTime)
 
     // 再获取 AC 提交列表
     const { data } = await getACMHelperList(Number(props.contestID))
@@ -195,13 +189,13 @@ const columns: DataTableColumn<HelperItem>[] = [
     title: "题目",
     key: "problem_display_id",
     width: 100,
-    render: (row) => h(NTag, { type: "info" }, () => row.problem_display_id),
+    render: (row) => h(NTag, { type: "info" }, () => row.problemDisplayId),
   },
   {
     title: "AC时间",
     key: "ac_time",
     width: 180,
-    render: (row) => formatACTime(row.ac_info.ac_time),
+    render: (row) => formatACTime(row.acInfo.ac_time),
   },
   {
     title: "错误次数",
@@ -211,10 +205,10 @@ const columns: DataTableColumn<HelperItem>[] = [
       h(
         NTag,
         {
-          type: row.ac_info.error_number > 0 ? "warning" : "success",
+          type: row.acInfo.error_number > 0 ? "warning" : "success",
           size: "small",
         },
-        () => row.ac_info.error_number,
+        () => row.acInfo.error_number,
       ),
   },
   {
@@ -310,7 +304,7 @@ onMounted(loadData)
       <SubmissionDetail
         v-if="currentSubmission"
         :submission="currentSubmission"
-        :problemID="currentSubmission.problem_display_id"
+        :problemID="currentSubmission.problemDisplayId"
         :submissionID="currentSubmission.id"
         hideList
         @copied="toggleCodePanel(false)"
diff --git a/apps/web/src/admin/contest/list.vue b/apps/web/src/admin/contest/list.vue
index 4d16ae0..fa58c06 100644
--- a/apps/web/src/admin/contest/list.vue
+++ b/apps/web/src/admin/contest/list.vue
@@ -56,13 +56,13 @@ const columns: DataTableColumn<Contest>[] = [
     title: "创建者",
     key: "created_by",
     width: 120,
-    render: (row) => row.created_by.username,
+    render: (row) => row.createdBy.username,
   },
   {
     title: "创建时间",
     key: "create_time",
     width: 160,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm"),
   },
   {
     title: "可见",
diff --git a/apps/web/src/admin/problem/Stuck.vue b/apps/web/src/admin/problem/Stuck.vue
index 37824f2..67c1210 100644
--- a/apps/web/src/admin/problem/Stuck.vue
+++ b/apps/web/src/admin/problem/Stuck.vue
@@ -1,36 +1,28 @@
 <script setup lang="ts">
 import { getStuckProblems } from "admin/api"
-
-interface StuckProblem {
-  problem_id: string
-  problem_title: string
-  total: number
-  failed: number
-  failed_users: number
-  ac_rate: number
-}
+import type { StuckProblem } from "utils/types"
 
 const loading = ref(true)
 const data = ref<StuckProblem[]>([])
 
 const columns: DataTableColumn<StuckProblem>[] = [
-  { title: "题目 ID", key: "problem_id", width: 100 },
-  { title: "题目名称", key: "problem_title", minWidth: 200 },
+  { title: "题目 ID", key: "problemId", width: 100 },
+  { title: "题目名称", key: "problemTitle", minWidth: 200 },
   { title: "总提交", key: "total", width: 100, sorter: "default" },
   { title: "失败次数", key: "failed", width: 100, sorter: "default" },
   {
     title: "卡住学生数",
-    key: "failed_users",
+    key: "failedUsers",
     width: 120,
     sorter: "default",
     defaultSortOrder: "descend",
   },
   {
     title: "AC 率",
-    key: "ac_rate",
+    key: "acRate",
     width: 100,
     sorter: "default",
-    render: (row) => `${row.ac_rate}%`,
+    render: (row) => `${row.acRate}%`,
   },
 ]
 
diff --git a/apps/web/src/admin/problem/TopACTrend.vue b/apps/web/src/admin/problem/TopACTrend.vue
index d9f3046..59839c7 100644
--- a/apps/web/src/admin/problem/TopACTrend.vue
+++ b/apps/web/src/admin/problem/TopACTrend.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import type { AcTrend } from "utils/types"
 import { Line } from "vue-chartjs"
 import {
   Chart as ChartJS,
@@ -22,18 +23,7 @@ ChartJS.register(
   Tooltip,
 )
 
-interface YearlyEntry {
-  year: number
-  total: number
-  accepted: number
-  ac_rate: number
-}
-
-interface ProblemTrend {
-  problem_id: string
-  problem_title: string
-  yearly: YearlyEntry[]
-}
+type ProblemTrend = AcTrend
 
 const currentYear = new Date().getFullYear()
 const yearOptions = Array.from({ length: currentYear - 2022 + 1 }, (_, i) => ({
@@ -79,7 +69,7 @@ function getChartData(problem: ProblemTrend) {
     datasets: [
       {
         label: "AC 率",
-        data: problem.yearly.map((y) => y.ac_rate),
+        data: problem.yearly.map((y) => y.acRate),
         fill: true,
         tension: 0.3,
         backgroundColor: "rgba(99, 179, 237, 0.2)",
@@ -98,14 +88,14 @@ function getChartOptions(problem: ProblemTrend) {
     plugins: {
       title: {
         display: true,
-        text: `${problem.problem_id} · ${problem.problem_title}`,
+        text: `${problem.problemId} · ${problem.problemTitle}`,
         font: { size: 14 },
       },
       tooltip: {
         callbacks: {
           label: (ctx: any) => {
             const entry = problem.yearly[ctx.dataIndex]
-            return `AC 率: ${entry.ac_rate}% (${entry.accepted}/${entry.total})`
+            return `AC 率: ${entry.acRate}% (${entry.accepted}/${entry.total})`
           },
         },
       },
@@ -127,9 +117,9 @@ async function fetchData() {
   loading.value = true
   try {
     const res = await getTopACTrend({
-      since_year: sinceYear.value,
-      until_year: untilYear.value,
-      min_per_year: minPerYear.value,
+      sinceYear: sinceYear.value,
+      untilYear: untilYear.value,
+      minPerYear: minPerYear.value,
     })
     data.value = res.data
   } finally {
@@ -174,7 +164,7 @@ onMounted(fetchData)
       暂无数据
     </div>
     <div v-else class="grid">
-      <div v-for="problem in data" :key="problem.problem_id" class="chart-card">
+      <div v-for="problem in data" :key="problem.problemId" class="chart-card">
         <Line
           :data="getChartData(problem)"
           :options="getChartOptions(problem)"
diff --git a/apps/web/src/admin/problem/components/Actions.vue b/apps/web/src/admin/problem/components/Actions.vue
index 9837e86..9068cc4 100644
--- a/apps/web/src/admin/problem/components/Actions.vue
+++ b/apps/web/src/admin/problem/components/Actions.vue
@@ -34,7 +34,7 @@ async function handleDeleteProblem() {
     message.success("删除成功")
     emit("updated")
   } catch (err: any) {
-    if (err.data === "Can't delete the problem as it has submissions") {
+    if (err.error === "problem-has-submissions") {
       message.error("这道题有提交之后，就不能被删除")
     } else {
       message.error("删除失败")
@@ -82,9 +82,9 @@ async function handleMakePublic() {
     showMakePublicModal.value = false
     emit("updated") // 刷新列表
   } catch (err: any) {
-    if (err.data === "Duplicate display ID") {
+    if (err.error === "display-id-exists") {
       message.error("该题目编号已存在，请使用其他编号")
-    } else if (err.data === "Already be a public problem") {
+    } else if (err.error === "already-public") {
       message.error("该题目已经是公开题目")
     } else {
       message.error("转换失败：" + (err.data || "未知错误"))
diff --git a/apps/web/src/admin/problem/components/AddButton.vue b/apps/web/src/admin/problem/components/AddButton.vue
index f80e089..bda9d67 100644
--- a/apps/web/src/admin/problem/components/AddButton.vue
+++ b/apps/web/src/admin/problem/components/AddButton.vue
@@ -23,9 +23,9 @@ async function addProblem() {
     )
     emit("added")
   } catch (err: any) {
-    if (err.data === "Duplicate display id in this contest") {
+    if (err.error === "display-id-exists") {
       message.error("显示编号重复了，请重新写一个")
-    } else if (err.data === "Contest has ended") {
+    } else if (err.error === "contest-ended") {
       message.error("这场比赛已经结束了，不能添加题目")
     } else {
       message.error(err.data)
diff --git a/apps/web/src/admin/problem/components/BatchTagModal.vue b/apps/web/src/admin/problem/components/BatchTagModal.vue
index 1e780db..6125d42 100644
--- a/apps/web/src/admin/problem/components/BatchTagModal.vue
+++ b/apps/web/src/admin/problem/components/BatchTagModal.vue
@@ -60,7 +60,7 @@ async function submit() {
   )
   const verb = props.action === "add" ? "添加" : "移除"
   message.success(
-    `已为 ${res.data.problem_count} 道题${verb} ${res.data.tag_count} 个标签`,
+    `已为 ${res.data.problemCount} 道题${verb} ${res.data.tagCount} 个标签`,
   )
   close()
   emit("done")
@@ -96,7 +96,7 @@ watch(
           :checked="selectedSet.has(tag.name)"
           @update:checked="toggleTag(tag.name)"
         >
-          {{ tag.name }}（{{ tag.problem_count }}）
+          {{ tag.name }}（{{ tag.problemCount }}）
         </n-tag>
       </n-flex>
       <n-dynamic-tags v-if="action === 'add'" v-model:value="newTags" />
diff --git a/apps/web/src/admin/problem/components/SQLTestcaseEditor.vue b/apps/web/src/admin/problem/components/SQLTestcaseEditor.vue
index 17324c0..7717ecd 100644
--- a/apps/web/src/admin/problem/components/SQLTestcaseEditor.vue
+++ b/apps/web/src/admin/problem/components/SQLTestcaseEditor.vue
@@ -125,7 +125,7 @@ async function generate() {
     blanks.map(async (s) => {
       try {
         const res = await generateSQLTestcase({
-          ref_sql: refSQL.value,
+          refSql: refSQL.value,
           mode: props.mode,
         })
         s.sql = res.data.sql
@@ -154,8 +154,8 @@ async function preview() {
       s.stale = false
       try {
         const res = await previewSQLTestcase({
-          init_sql: s.sql,
-          ref_sql: refSQL.value,
+          initSql: s.sql,
+          refSql: refSQL.value,
           mode: props.mode,
         })
         s.display = res.data
diff --git a/apps/web/src/admin/problem/detail.vue b/apps/web/src/admin/problem/detail.vue
index af3fdc1..53a09fa 100644
--- a/apps/web/src/admin/problem/detail.vue
+++ b/apps/web/src/admin/problem/detail.vue
@@ -11,13 +11,7 @@ import {
 } from "utils/constants"
 import download from "utils/download"
 import { unique } from "utils/functions"
-import type {
-  BlankProblem,
-  LANGUAGE,
-  SQLConfig,
-  Tag,
-  Testcase,
-} from "utils/types"
+import type { BlankProblem, LANGUAGE, Tag, Testcase } from "utils/types"
 import {
   createContestProblem,
   createProblem,
@@ -62,13 +56,13 @@ const problem = useLocalStorage<BlankProblem>(STORAGE_KEY.ADMIN_PROBLEM, {
   _id: "",
   title: "",
   description: "",
-  input_description: "",
-  output_description: "",
-  time_limit: 1000,
-  memory_limit: 64,
-  difficulty: "Low" as "Low" | "Mid" | "High",
+  inputDescription: "",
+  outputDescription: "",
+  timeLimit: 1000,
+  memoryLimit: 64,
+  difficulty: "Low",
   visible: false,
-  share_submission: false,
+  shareSubmission: false,
   tags: [],
   languages: ["Python3", "C"] as LANGUAGE[],
   template: {} as { [key in LANGUAGE]?: string },
@@ -77,20 +71,20 @@ const problem = useLocalStorage<BlankProblem>(STORAGE_KEY.ADMIN_PROBLEM, {
     { input: "", output: "" },
     { input: "", output: "" },
   ],
-  test_case_id: "",
-  test_case_score: [] as Testcase[],
+  testCaseId: "",
+  testCaseScore: [] as Testcase[],
   hint: "",
   source: "",
   prompt: "",
   answers: [] as { language: LANGUAGE; code: string }[],
-  contest_id: "",
-  allow_flowchart: false,
-  mermaid_code: "",
-  flowchart_data: {},
-  flowchart_hint: "",
-  show_flowchart: false,
-  ast_rules: null as { [key: string]: any[] } | null,
-  sql_config: null as SQLConfig | null,
+  contestId: null,
+  allowFlowchart: false,
+  showFlowchart: false,
+  mermaidCode: "",
+  flowchartHint: "",
+  astRules: null,
+  sqlConfig: null,
+  sqlDisplay: null,
 })
 
 // 从服务器来的tag列表
@@ -189,19 +183,19 @@ watch(
         return
       }
       needTemplate.value = false
-      if (!problem.value.sql_config) {
-        problem.value.sql_config = { mode: "query", order_sensitive: false }
+      if (!problem.value.sqlConfig) {
+        problem.value.sqlConfig = { mode: "query", order_sensitive: false }
       }
       currentActiveAnswer.value = "SQL"
       // 代码规则检查基于 Python/C 的 AST 解析，对 SQL 没有意义，清空避免脏数据
-      if (problem.value.ast_rules) {
-        problem.value.ast_rules = null
+      if (problem.value.astRules) {
+        problem.value.astRules = null
       }
       // 流程图依赖 Python 答案生成，对 SQL 没有意义
-      problem.value.allow_flowchart = false
-      problem.value.show_flowchart = false
-    } else if (problem.value.sql_config) {
-      problem.value.sql_config = null
+      problem.value.allowFlowchart = false
+      problem.value.showFlowchart = false
+    } else if (problem.value.sqlConfig) {
+      problem.value.sqlConfig = null
     }
   },
   { immediate: true },
@@ -219,32 +213,31 @@ async function getProblemDetail() {
     problem.value._id = data._id
     problem.value.title = data.title
     problem.value.description = data.description
-    problem.value.input_description = data.input_description
-    problem.value.output_description = data.output_description
-    problem.value.time_limit = data.time_limit
-    problem.value.memory_limit = data.memory_limit
-    problem.value.memory_limit = data.memory_limit
+    problem.value.inputDescription = data.inputDescription
+    problem.value.outputDescription = data.outputDescription
+    problem.value.timeLimit = data.timeLimit
+    problem.value.memoryLimit = data.memoryLimit
+    problem.value.memoryLimit = data.memoryLimit
     problem.value.difficulty = data.difficulty
     problem.value.visible = data.visible
-    problem.value.share_submission = data.share_submission
+    problem.value.shareSubmission = data.shareSubmission
     problem.value.tags = normalizeTagNames(data.tags)
     problem.value.languages = data.languages
     problem.value.template = data.template
     problem.value.samples = data.samples
     problem.value.samples = data.samples
-    problem.value.test_case_id = data.test_case_id
-    problem.value.test_case_score = data.test_case_score
-    problem.value.hint = data.hint
+    problem.value.testCaseId = data.testCaseId
+    problem.value.testCaseScore = data.testCaseScore
+    problem.value.hint = data.hint ?? ""
     problem.value.source = data.source
     problem.value.prompt = data.prompt
     // 流程图相关字段
-    problem.value.allow_flowchart = data.allow_flowchart
-    problem.value.show_flowchart = data.show_flowchart
-    problem.value.mermaid_code = data.mermaid_code ?? ""
-    problem.value.flowchart_hint = data.flowchart_hint ?? ""
-    problem.value.flowchart_data = data.flowchart_data
-    problem.value.ast_rules = data.ast_rules ?? null
-    problem.value.sql_config = data.sql_config ?? null
+    problem.value.allowFlowchart = data.allowFlowchart
+    problem.value.showFlowchart = data.showFlowchart
+    problem.value.mermaidCode = data.mermaidCode ?? ""
+    problem.value.flowchartHint = data.flowchartHint ?? ""
+    problem.value.astRules = data.astRules ?? null
+    problem.value.sqlConfig = data.sqlConfig ?? null
     if (data.answers && data.answers.length) {
       problem.value.answers = data.answers
     } else {
@@ -253,8 +246,8 @@ async function getProblemDetail() {
         code: "",
       }))
     }
-    if (problem.value.contest_id) {
-      problem.value.contest_id = problem.value.contest_id
+    if (problem.value.contestId) {
+      problem.value.contestId = problem.value.contestId
     }
 
     // 下面是用来显示的：
@@ -305,8 +298,8 @@ async function handleUploadTestcases({ file }: UploadCustomRequestOptions) {
     for (let file of testcases) {
       file.score = (100 / testcases.length).toFixed(0)
     }
-    problem.value.test_case_score = testcases
-    problem.value.test_case_id = res.data.id
+    problem.value.testCaseScore = testcases
+    problem.value.testCaseId = res.data.id
   } catch (err) {
     message.error("上传测试用例失败")
   }
@@ -338,7 +331,7 @@ async function validateProblem() {
   else if (
     !problem.value.description ||
     (!isSQLProblem.value &&
-      (!problem.value.input_description || !problem.value.output_description))
+      (!problem.value.inputDescription || !problem.value.outputDescription))
   ) {
     message.error("题目或输入或输出没有填写")
     hasErrors = true
@@ -359,7 +352,7 @@ async function validateProblem() {
     hasErrors = true
   }
   // 测试用例
-  else if (problem.value.test_case_score.length === 0) {
+  else if (problem.value.testCaseScore.length === 0) {
     message.error("测试用例没有上传")
     hasErrors = true
   } else if (problem.value.languages.length === 0) {
@@ -367,7 +360,7 @@ async function validateProblem() {
     hasErrors = true
   }
   // SQL 题验证
-  else if (isSQLProblem.value && !problem.value.sql_config?.mode) {
+  else if (isSQLProblem.value && !problem.value.sqlConfig?.mode) {
     message.error("SQL 题需要选择题型（查询题/增删改题）")
     hasErrors = true
   } else if (
@@ -380,11 +373,8 @@ async function validateProblem() {
     hasErrors = true
   }
   // 流程图验证
-  else if (problem.value.show_flowchart || problem.value.allow_flowchart) {
-    if (
-      !problem.value.mermaid_code ||
-      problem.value.mermaid_code.trim() === ""
-    ) {
+  else if (problem.value.showFlowchart || problem.value.allowFlowchart) {
+    if (!problem.value.mermaidCode || problem.value.mermaidCode.trim() === "") {
       message.error("启用了流程图功能，但流程图代码为空")
       hasErrors = true
     } else if (!mermaidRenderSuccess.value) {
@@ -449,7 +439,7 @@ async function submit() {
     route.name === "admin contest problem create" ||
     route.name === "admin contest problem edit"
   ) {
-    problem.value.contest_id = props.contestID
+    problem.value.contestId = Number(props.contestID)
   }
   try {
     await api!(problem.value)
@@ -474,7 +464,7 @@ async function submit() {
       })
     }
   } catch (err: any) {
-    if (err.data === "Display ID already exists") {
+    if (err.error === "display-id-exists") {
       message.error("显示编号重复了，请换一个显示编号")
     } else {
       message.error(err.data)
@@ -503,7 +493,7 @@ async function generateMermaid() {
   )
   isAIGenerating.value = false
   message.warning("如果渲染不成功，请复制到外部 AI 网站检查语法")
-  problem.value.mermaid_code = res.data.flowchart
+  problem.value.mermaidCode = res.data.flowchart
 }
 
 const showGeneratorModal = ref(false)
@@ -512,8 +502,8 @@ function handleTestcasesGenerated(
   testCaseId: string,
   testCaseScore: Testcase[],
 ) {
-  problem.value.test_case_id = testCaseId
-  problem.value.test_case_score = testCaseScore
+  problem.value.testCaseId = testCaseId
+  problem.value.testCaseScore = testCaseScore
   showGeneratorModal.value = false
 }
 
@@ -593,12 +583,12 @@ watch(
   />
   <TextEditor
     v-if="ready && !isSQLProblem"
-    v-model:value="problem.input_description"
+    v-model:value="problem.inputDescription"
     title="输入的描述"
   />
   <TextEditor
     v-if="ready && !isSQLProblem"
-    v-model:value="problem.output_description"
+    v-model:value="problem.outputDescription"
     title="输出的描述"
   />
   <template v-if="!isSQLProblem">
@@ -686,12 +676,12 @@ watch(
   </n-form>
 
   <n-form
-    v-if="isSQLProblem && problem.sql_config"
+    v-if="isSQLProblem && problem.sqlConfig"
     inline
     label-placement="left"
   >
     <n-form-item label="SQL 题型">
-      <n-radio-group v-model:value="problem.sql_config.mode">
+      <n-radio-group v-model:value="problem.sqlConfig.mode">
         <n-radio-button value="query">查询题（比对查询结果）</n-radio-button>
         <n-radio-button value="modify">
           增删改题（比对执行后的表数据）
@@ -699,7 +689,7 @@ watch(
       </n-radio-group>
     </n-form-item>
     <n-form-item label="严格比对行顺序">
-      <n-switch v-model:value="problem.sql_config.order_sensitive" />
+      <n-switch v-model:value="problem.sqlConfig.order_sensitive" />
       <n-text depth="3" style="margin-left: 12px">
         题目要求 ORDER BY 时开启；关闭则按无序集合比对
       </n-text>
@@ -766,7 +756,7 @@ watch(
   <n-grid v-if="!isSQLProblem" :cols="2">
     <n-gi :span="1">
       <AstRulesEditor
-        v-model="problem.ast_rules!"
+        v-model="problem.astRules!"
         :languages="problem.languages"
       />
     </n-gi>
@@ -802,22 +792,22 @@ watch(
   <SQLTestcaseEditor
     v-if="isSQLProblem"
     :answers="problem.answers"
-    :mode="problem.sql_config?.mode ?? 'query'"
+    :mode="problem.sqlConfig?.mode ?? 'query'"
     :problem-id="problem.id"
     @uploaded="handleTestcasesGenerated"
   />
 
   <n-alert
     class="box"
-    v-if="problem.test_case_score.length"
+    v-if="problem.testCaseScore.length"
     :show-icon="false"
     type="info"
   >
     <template #header>
       <n-flex align="center">
         <div>
-          测试组编号 {{ problem.test_case_id.slice(0, 12) }} 共有
-          {{ problem.test_case_score.length }}
+          测试组编号 {{ problem.testCaseId.slice(0, 12) }} 共有
+          {{ problem.testCaseScore.length }}
           条测试用例
         </div>
         <n-button
@@ -870,23 +860,23 @@ watch(
         </n-button>
       </n-form-item>
       <n-form-item label="允许提交流程图">
-        <n-switch v-model:value="problem.allow_flowchart" />
+        <n-switch v-model:value="problem.allowFlowchart" />
       </n-form-item>
       <n-form-item label="显示标准流程图">
-        <n-switch v-model:value="problem.show_flowchart" />
+        <n-switch v-model:value="problem.showFlowchart" />
       </n-form-item>
     </n-form>
 
     <n-form>
       <n-form-item>
         <MermaidEditor
-          v-model="problem.mermaid_code"
+          v-model="problem.mermaidCode"
           @render-success="onMermaidRenderSuccess"
         />
       </n-form-item>
       <n-form-item label="流程图提示信息（选填）">
         <n-input
-          v-model:value="problem.flowchart_hint"
+          v-model:value="problem.flowchartHint"
           placeholder="请输入流程图相关的提示信息，帮助学生理解题目要求"
         />
       </n-form-item>
diff --git a/apps/web/src/admin/problem/list.vue b/apps/web/src/admin/problem/list.vue
index 94161a8..bba2fd0 100644
--- a/apps/web/src/admin/problem/list.vue
+++ b/apps/web/src/admin/problem/list.vue
@@ -113,20 +113,20 @@ const baseColumns: DataTableColumn<AdminProblemFiltered>[] = [
     width: 80,
     render: (row) =>
       h(NFlex, { size: 4, align: "center" }, () => [
-        row.allow_flowchart
+        row.allowFlowchart
           ? h(Icon, {
               width: 18,
               icon: "vscode-icons:file-type-drawio",
               title: "绘图",
             })
-          : row.show_flowchart
+          : row.showFlowchart
             ? h(Icon, {
                 width: 18,
                 icon: "vscode-icons:file-type-graphql",
                 title: "流程图",
               })
             : null,
-        row.has_ast_rules
+        row.hasAstRules
           ? h(Icon, {
               width: 18,
               icon: "vscode-icons:file-type-light-todo",
@@ -140,7 +140,7 @@ const baseColumns: DataTableColumn<AdminProblemFiltered>[] = [
     key: "top_reaction",
     width: 60,
     render: (row) => {
-      const top = row.top_reaction
+      const top = row.topReaction
       if (!top) return null
       const reaction = REACTIONS.find((it) => it.key === top.type)
       if (!reaction) return null
@@ -155,7 +155,7 @@ const baseColumns: DataTableColumn<AdminProblemFiltered>[] = [
     title: "创建时间",
     key: "create_time",
     width: 200,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "可见",
diff --git a/apps/web/src/admin/problem/tags.vue b/apps/web/src/admin/problem/tags.vue
index 9b0befe..a4f57dc 100644
--- a/apps/web/src/admin/problem/tags.vue
+++ b/apps/web/src/admin/problem/tags.vue
@@ -57,7 +57,7 @@ const columns: DataTableColumn<AdminTag>[] = [
       h(
         NButton,
         { text: true, type: "primary", onClick: () => openTagProblems(row) },
-        () => String(row.problem_count),
+        () => String(row.problemCount),
       ),
   },
   {
@@ -123,7 +123,7 @@ async function saveTag(tag: AdminTag) {
   const res = await renameTag(tag.id, name)
   if (res.data.merged) {
     message.success(
-      `已合并到「${res.data.name}」，影响 ${res.data.affected_count} 道题`,
+      `已合并到「${res.data.name}」，影响 ${res.data.affectedCount} 道题`,
     )
   } else {
     message.success("已重命名")
@@ -135,7 +135,7 @@ async function saveTag(tag: AdminTag) {
 function confirmDelete(tag: AdminTag) {
   dialog.warning({
     title: "删除标签",
-    content: `确定删除标签「${tag.name}」吗？当前有 ${tag.problem_count} 道题在使用它，删除后这些题目会失去该标签。`,
+    content: `确定删除标签「${tag.name}」吗？当前有 ${tag.problemCount} 道题在使用它，删除后这些题目会失去该标签。`,
     positiveText: "删除",
     negativeText: "取消",
     onPositiveClick: async () => {
diff --git a/apps/web/src/admin/problemset/components/AddBadgeModal.vue b/apps/web/src/admin/problemset/components/AddBadgeModal.vue
index a7a0f60..5213901 100644
--- a/apps/web/src/admin/problemset/components/AddBadgeModal.vue
+++ b/apps/web/src/admin/problemset/components/AddBadgeModal.vue
@@ -54,7 +54,7 @@ function handleConfirm() {
 
   // 只有非"完成所有题目"时才添加条件值
   if (newBadgeConditionType.value !== "all_problems") {
-    data.condition_value = newBadgeConditionValue.value
+    data.conditionValue = newBadgeConditionValue.value
   }
 
   emit("confirm", data)
diff --git a/apps/web/src/admin/problemset/components/BadgeManagement.vue b/apps/web/src/admin/problemset/components/BadgeManagement.vue
index 91e4677..b6a81c4 100644
--- a/apps/web/src/admin/problemset/components/BadgeManagement.vue
+++ b/apps/web/src/admin/problemset/components/BadgeManagement.vue
@@ -48,16 +48,16 @@ defineEmits<Emits>()
               problem_count: '完成指定数量题目',
               score: '达到指定分数',
             }
-            return typeMap[row.condition_type] || row.condition_type
+            return typeMap[row.conditionType] || row.conditionType
           },
         },
         {
           title: '条件值',
           key: 'condition_value',
           render: (row) => {
-            return row.condition_type === 'all_problems'
+            return row.conditionType === 'all_problems'
               ? '-'
-              : row.condition_value
+              : row.conditionValue
           },
         },
         { title: '描述', key: 'description' },
diff --git a/apps/web/src/admin/problemset/components/EditBadgeModal.vue b/apps/web/src/admin/problemset/components/EditBadgeModal.vue
index 7a0a938..7b5c4fd 100644
--- a/apps/web/src/admin/problemset/components/EditBadgeModal.vue
+++ b/apps/web/src/admin/problemset/components/EditBadgeModal.vue
@@ -58,7 +58,7 @@ function handleConfirm() {
 
   // 只有非"完成所有题目"时才添加条件值
   if (editBadgeConditionType.value !== "all_problems") {
-    data.condition_value = editBadgeConditionValue.value
+    data.conditionValue = editBadgeConditionValue.value
   }
 
   emit("confirm", data)
@@ -76,8 +76,8 @@ watch(
       editBadgeName.value = newBadge.name
       editBadgeDescription.value = newBadge.description
       editBadgeIcon.value = newBadge.icon
-      editBadgeConditionType.value = newBadge.condition_type
-      editBadgeConditionValue.value = newBadge.condition_value
+      editBadgeConditionType.value = newBadge.conditionType
+      editBadgeConditionValue.value = newBadge.conditionValue
     }
   },
   { immediate: true },
diff --git a/apps/web/src/admin/problemset/components/EditProblemModal.vue b/apps/web/src/admin/problemset/components/EditProblemModal.vue
index 6709334..57e7034 100644
--- a/apps/web/src/admin/problemset/components/EditProblemModal.vue
+++ b/apps/web/src/admin/problemset/components/EditProblemModal.vue
@@ -46,7 +46,7 @@ watch(
   (newProblem) => {
     if (newProblem) {
       editProblemOrder.value = newProblem.order
-      editProblemRequired.value = newProblem.is_required
+      editProblemRequired.value = newProblem.isRequired
       editProblemScore.value = newProblem.score
       editProblemHint.value = newProblem.hint || ""
     }
diff --git a/apps/web/src/admin/problemset/components/ProblemManagement.vue b/apps/web/src/admin/problemset/components/ProblemManagement.vue
index 2c337a8..ed067d8 100644
--- a/apps/web/src/admin/problemset/components/ProblemManagement.vue
+++ b/apps/web/src/admin/problemset/components/ProblemManagement.vue
@@ -34,7 +34,7 @@ defineEmits<Emits>()
           title: '必做',
           key: 'is_required',
           width: 80,
-          render: (row) => (row.is_required ? '是' : '否'),
+          render: (row) => (row.isRequired ? '是' : '否'),
         },
         { title: '分数', key: 'score', width: 80 },
         { title: '提示', key: 'hint', minWidth: 200 },
diff --git a/apps/web/src/admin/problemset/components/ProblemSetInfo.vue b/apps/web/src/admin/problemset/components/ProblemSetInfo.vue
index ccbc88a..178de5f 100644
--- a/apps/web/src/admin/problemset/components/ProblemSetInfo.vue
+++ b/apps/web/src/admin/problemset/components/ProblemSetInfo.vue
@@ -16,7 +16,7 @@ defineProps<Props>()
         {{ problemSet.description }}
       </n-descriptions-item>
       <n-descriptions-item label="创建者">
-        {{ problemSet.created_by.username }}
+        {{ problemSet.createdBy.username }}
       </n-descriptions-item>
       <n-descriptions-item label="难度">
         <n-tag
@@ -60,10 +60,10 @@ defineProps<Props>()
         {{ problemSet.visible ? "是" : "否" }}
       </n-descriptions-item>
       <n-descriptions-item label="题目数量">
-        {{ problemSet.problems_count }}
+        {{ problemSet.problemsCount }}
       </n-descriptions-item>
       <n-descriptions-item label="创建时间">
-        {{ parseTime(problemSet.create_time, "YYYY-MM-DD HH:mm:ss") }}
+        {{ parseTime(problemSet.createTime, "YYYY-MM-DD HH:mm:ss") }}
       </n-descriptions-item>
     </n-descriptions>
   </n-card>
diff --git a/apps/web/src/admin/problemset/components/ProgressManagement.vue b/apps/web/src/admin/problemset/components/ProgressManagement.vue
index 4db070a..30d5a06 100644
--- a/apps/web/src/admin/problemset/components/ProgressManagement.vue
+++ b/apps/web/src/admin/problemset/components/ProgressManagement.vue
@@ -23,7 +23,7 @@ const progressColumns = [
     key: "join_time",
     width: 180,
     render: (row: ProblemSetProgress) =>
-      parseTime(row.join_time, "YYYY-MM-DD HH:mm:ss"),
+      parseTime(row.joinTime, "YYYY-MM-DD HH:mm:ss"),
   },
   { title: "已完成", key: "completed_problems_count", width: 100 },
   { title: "总题目", key: "total_problems_count", width: 100 },
@@ -32,13 +32,13 @@ const progressColumns = [
     key: "progress_percentage",
     width: 100,
     render: (row: ProblemSetProgress) =>
-      `${row.progress_percentage.toFixed(0)}%`,
+      `${row.progressPercentage.toFixed(0)}%`,
   },
   {
     title: "是否完成",
     key: "is_completed",
     width: 100,
-    render: (row: ProblemSetProgress) => (row.is_completed ? "是" : "否"),
+    render: (row: ProblemSetProgress) => (row.isCompleted ? "是" : "否"),
   },
   {
     title: "操作",
diff --git a/apps/web/src/admin/problemset/edit.vue b/apps/web/src/admin/problemset/edit.vue
index 157046b..6d89b87 100644
--- a/apps/web/src/admin/problemset/edit.vue
+++ b/apps/web/src/admin/problemset/edit.vue
@@ -15,16 +15,14 @@ const formData = ref<CreateProblemSetData & Partial<EditProblemSetData>>({
   difficulty: "Easy",
   status: "draft",
   visible: false,
-  end_time: null,
+  endTime: null,
 })
 
 const endTimeTimestamp = computed({
   get: () =>
-    formData.value.end_time
-      ? new Date(formData.value.end_time).getTime()
-      : null,
+    formData.value.endTime ? new Date(formData.value.endTime).getTime() : null,
   set: (val: number | null) => {
-    formData.value.end_time = val ? new Date(val) : null
+    formData.value.endTime = val ? new Date(val) : null
   },
 })
 
@@ -55,7 +53,7 @@ async function loadProblemSetDetail() {
       difficulty: data.difficulty,
       status: data.status,
       visible: data.visible,
-      end_time: data.end_time ? new Date(data.end_time) : null,
+      endTime: data.endTime ? new Date(data.endTime) : null,
     }
   } catch (err: any) {
     message.error("加载题单详情失败：" + (err.data || "未知错误"))
diff --git a/apps/web/src/admin/problemset/list.vue b/apps/web/src/admin/problemset/list.vue
index 736ed6b..5a9c656 100644
--- a/apps/web/src/admin/problemset/list.vue
+++ b/apps/web/src/admin/problemset/list.vue
@@ -2,13 +2,13 @@
 import Pagination from "shared/components/Pagination.vue"
 import { usePagination } from "shared/composables/pagination"
 import { parseTime } from "utils/functions"
-import type { ProblemSetList } from "utils/types"
+import type { ProblemSet } from "utils/types"
 import { getProblemSetList, toggleProblemSetVisible } from "../api"
 import Actions from "./components/Actions.vue"
 import { NTag, NSwitch } from "naive-ui"
 
 const total = ref(0)
-const problemSets = ref<ProblemSetList[]>([])
+const problemSets = ref<ProblemSet[]>([])
 
 interface ProblemSetQuery {
   keyword: string
@@ -37,7 +37,7 @@ const statusOptions = [
   { label: "草稿", value: "draft" },
 ]
 
-const columns: DataTableColumn<ProblemSetList>[] = [
+const columns: DataTableColumn<ProblemSet>[] = [
   { title: "ID", key: "id", width: 80 },
   { title: "标题", key: "title", minWidth: 200 },
   { title: "描述", key: "description", minWidth: 300, ellipsis: true },
@@ -45,7 +45,7 @@ const columns: DataTableColumn<ProblemSetList>[] = [
     title: "创建者",
     key: "created_by",
     width: 120,
-    render: (row) => row.created_by.username,
+    render: (row) => row.createdBy.username,
   },
   {
     title: "难度",
@@ -87,7 +87,7 @@ const columns: DataTableColumn<ProblemSetList>[] = [
     title: "创建时间",
     key: "create_time",
     width: 180,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "可见",
diff --git a/apps/web/src/admin/setting/config.vue b/apps/web/src/admin/setting/config.vue
index 23fdc42..925d739 100644
--- a/apps/web/src/admin/setting/config.vue
+++ b/apps/web/src/admin/setting/config.vue
@@ -94,7 +94,7 @@ const serverColumns: DataTableColumn<Server>[] = [
   {
     title: "内存占用",
     key: "memory_usage",
-    render: (row) => row.memory_usage + "%",
+    render: (row) => row.memoryUsage + "%",
     width: 100,
   },
   { title: "IP", key: "ip", width: 140 },
@@ -103,13 +103,13 @@ const serverColumns: DataTableColumn<Server>[] = [
   {
     title: "上一次心跳",
     key: "last_heartbeat",
-    render: (row) => parseTime(row.last_heartbeat, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.lastHeartbeat, "YYYY-MM-DD HH:mm:ss"),
     width: 120,
   },
   {
     title: "创建时间",
     key: "create_time",
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
     width: 120,
   },
 ]
@@ -122,32 +122,32 @@ const abnormalServers = computed(() =>
 )
 
 const websiteConfig = reactive({
-  website_base_url: import.meta.env.PUBLIC_OJ_URL,
-  website_name: "判题狗",
-  website_name_shortcut: "判题狗",
-  website_footer: "所有权归属于徐越，感谢青岛大学开源 OJ 系统，感谢开源社区",
-  allow_register: true,
-  submission_list_show_all: true,
-  class_list: [],
-  enable_maxkb: true,
+  websiteBaseUrl: import.meta.env.PUBLIC_OJ_URL,
+  websiteName: "判题狗",
+  websiteNameShortcut: "判题狗",
+  websiteFooter: "所有权归属于徐越，感谢青岛大学开源 OJ 系统，感谢开源社区",
+  allowRegister: true,
+  submissionListShowAll: true,
+  classList: [],
+  enableMaxkb: true,
 })
 
 async function getWebsiteConfig() {
   const res = await getWebsite()
-  websiteConfig.website_base_url = res.data.website_base_url
-  websiteConfig.website_name = res.data.website_name
-  websiteConfig.website_name_shortcut = res.data.website_name_shortcut
-  websiteConfig.website_footer = res.data.website_footer
-  websiteConfig.allow_register = res.data.allow_register
-  websiteConfig.submission_list_show_all = res.data.submission_list_show_all
-  websiteConfig.class_list = res.data.class_list
-  websiteConfig.enable_maxkb = res.data.enable_maxkb
+  websiteConfig.websiteBaseUrl = res.data.websiteBaseUrl
+  websiteConfig.websiteName = res.data.websiteName
+  websiteConfig.websiteNameShortcut = res.data.websiteNameShortcut
+  websiteConfig.websiteFooter = res.data.websiteFooter
+  websiteConfig.allowRegister = res.data.allowRegister
+  websiteConfig.submissionListShowAll = res.data.submissionListShowAll
+  websiteConfig.classList = res.data.classList
+  websiteConfig.enableMaxkb = res.data.enableMaxkb
 }
 
 async function saveWebsiteConfig() {
   // 班级号要和用户名里 ks 后面那段对得上，位数不对登录页会查不到该班学生。
   // 后端 CreateEditWebsiteConfigSerializer 也会拦，这里先报更明确的错
-  const invalid = websiteConfig.class_list.filter((c) => !CLASS_NAME_RE.test(c))
+  const invalid = websiteConfig.classList.filter((c) => !CLASS_NAME_RE.test(c))
   if (invalid.length) {
     message.error(
       `班级号 ${invalid.join("、")} 必须是 ${CLASS_NAME_MIN_DIGITS}~${CLASS_NAME_MAX_DIGITS} 位数字`,
@@ -165,11 +165,8 @@ async function saveWebsiteConfig() {
   configStore.getConfig()
 
   // 通过 WebSocket 广播配置变化，实现实时切换
-  updateConfig("enable_maxkb", websiteConfig.enable_maxkb)
-  updateConfig(
-    "submission_list_show_all",
-    websiteConfig.submission_list_show_all,
-  )
+  updateConfig("enable_maxkb", websiteConfig.enableMaxkb)
+  updateConfig("submission_list_show_all", websiteConfig.submissionListShowAll)
 }
 
 async function deleteTestcase(id?: string) {
@@ -222,19 +219,19 @@ onMounted(() => {
     </template>
     <n-form inline label-placement="left">
       <n-form-item label="网站 URL">
-        <n-input class="url" v-model:value="websiteConfig.website_base_url" />
+        <n-input class="url" v-model:value="websiteConfig.websiteBaseUrl" />
       </n-form-item>
       <n-form-item label="网站名">
-        <n-input v-model:value="websiteConfig.website_name" />
+        <n-input v-model:value="websiteConfig.websiteName" />
       </n-form-item>
       <n-form-item label="网站简称">
-        <n-input v-model:value="websiteConfig.website_name_shortcut" />
+        <n-input v-model:value="websiteConfig.websiteNameShortcut" />
       </n-form-item>
     </n-form>
     <n-form label-placement="left">
       <n-form-item label="班级列表">
         <n-flex vertical size="small">
-          <n-dynamic-tags v-model:value="websiteConfig.class_list" />
+          <n-dynamic-tags v-model:value="websiteConfig.classList" />
           <n-text depth="3" style="font-size: 12px">
             填 {{ CLASS_NAME_MIN_DIGITS }}~{{ CLASS_NAME_MAX_DIGITS }}
             位数字，如 251、2510，要和用户名里 ks 后面那段一致
@@ -245,15 +242,15 @@ onMounted(() => {
     <n-flex align="center">
       <n-flex align="center">
         <span>是否允许注册</span>
-        <n-switch v-model:value="websiteConfig.allow_register" />
+        <n-switch v-model:value="websiteConfig.allowRegister" />
       </n-flex>
       <n-flex align="center">
         <span>显示所有提交</span>
-        <n-switch v-model:value="websiteConfig.submission_list_show_all" />
+        <n-switch v-model:value="websiteConfig.submissionListShowAll" />
       </n-flex>
       <n-flex align="center">
         <span>启用AI小助手</span>
-        <n-switch v-model:value="websiteConfig.enable_maxkb" />
+        <n-switch v-model:value="websiteConfig.enableMaxkb" />
       </n-flex>
     </n-flex>
   </n-card>
diff --git a/apps/web/src/admin/setting/home.vue b/apps/web/src/admin/setting/home.vue
index 5a8dbc6..4e950ff 100644
--- a/apps/web/src/admin/setting/home.vue
+++ b/apps/web/src/admin/setting/home.vue
@@ -59,15 +59,15 @@ const columns: DataTableColumn<Rank>[] = [
     title: "正确率",
     key: "rate",
     width: 100,
-    render: (row) => getACRate(row.accepted_number, row.submission_number),
+    render: (row) => getACRate(row.acceptedNumber, row.submissionNumber),
   },
 ]
 
 onMounted(async () => {
   const res = await getBaseInfo()
-  userCount.value = res.data.user_count
-  submissionCount.value = res.data.today_submission_count
-  contestCount.value = res.data.recent_contest_count
+  userCount.value = res.data.userCount
+  submissionCount.value = res.data.todaySubmissionCount
+  contestCount.value = res.data.recentContestCount
 })
 
 async function listRanks() {
diff --git a/apps/web/src/admin/transforms.ts b/apps/web/src/admin/transforms.ts
index 63e99b6..03e8176 100644
--- a/apps/web/src/admin/transforms.ts
+++ b/apps/web/src/admin/transforms.ts
@@ -1,20 +1,23 @@
-import type { AdminProblem } from "utils/types"
+import type { AdminProblemFiltered, AdminProblemListItem } from "utils/types"
 
-// 把后端的 AdminProblem 塑形成管理端列表项，与请求逻辑解耦。
-export function toProblemListItem(result: AdminProblem) {
+// 把后端的列表项塑形成管理端列表行，与请求逻辑解耦。
+export function toProblemListItem(
+  result: AdminProblemListItem,
+): AdminProblemFiltered {
   return {
     id: result.id,
     _id: result._id,
     title: result.title,
-    username: result.created_by.username,
-    create_time: result.create_time,
+    username: result.createdBy.username,
+    createTime: result.createTime,
     visible: result.visible,
     difficulty: result.difficulty,
     tags: result.tags,
-    has_ast_rules: result.has_ast_rules,
-    allow_flowchart: result.allow_flowchart,
-    show_flowchart: result.show_flowchart,
+    hasAstRules: result.hasAstRules,
+    allowFlowchart: result.allowFlowchart,
+    showFlowchart: result.showFlowchart,
     // 比赛题目列表接口不返回这个字段
-    top_reaction: result.top_reaction ?? null,
+    topReaction: (result.topReaction ??
+      null) as AdminProblemFiltered["topReaction"],
   }
 }
diff --git a/apps/web/src/admin/tutorial/components/ExerciseManager.vue b/apps/web/src/admin/tutorial/components/ExerciseManager.vue
index 9c572bd..6197073 100644
--- a/apps/web/src/admin/tutorial/components/ExerciseManager.vue
+++ b/apps/web/src/admin/tutorial/components/ExerciseManager.vue
@@ -284,7 +284,7 @@ async function save() {
       message.success("练习题已更新")
     } else {
       await createExercise({
-        tutorial_id: props.tutorialId,
+        tutorialId: props.tutorialId,
         type: formType.value,
         data,
         order: formOrder.value,
diff --git a/apps/web/src/admin/tutorial/detail.vue b/apps/web/src/admin/tutorial/detail.vue
index a60b058..953ab9a 100644
--- a/apps/web/src/admin/tutorial/detail.vue
+++ b/apps/web/src/admin/tutorial/detail.vue
@@ -19,7 +19,7 @@ const tutorial = reactive<Tutorial>({
   title: "",
   content: "",
   code: "",
-  is_public: false,
+  isPublic: false,
   order: 0,
   type: "python", // 默认选择 Python
 })
@@ -39,7 +39,7 @@ async function init() {
   tutorial.title = data.title
   tutorial.content = data.content
   tutorial.code = data.code || ""
-  tutorial.is_public = data.is_public
+  tutorial.isPublic = data.isPublic
   tutorial.order = data.order
   tutorial.type = data.type || "python"
 }
@@ -55,7 +55,7 @@ async function submit() {
         title: tutorial.title,
         content: tutorial.content,
         code: tutorial.code,
-        is_public: tutorial.is_public,
+        isPublic: tutorial.isPublic,
         order: tutorial.order,
         type: tutorial.type,
       })
@@ -94,7 +94,7 @@ onMounted(init)
       />
     </n-form-item>
     <n-form-item label="可见">
-      <n-switch v-model:value="tutorial.is_public" />
+      <n-switch v-model:value="tutorial.isPublic" />
     </n-form-item>
     <n-form-item>
       <n-button type="primary" @click="submit">保存</n-button>
diff --git a/apps/web/src/admin/tutorial/list.vue b/apps/web/src/admin/tutorial/list.vue
index 1b1581a..21ed067 100644
--- a/apps/web/src/admin/tutorial/list.vue
+++ b/apps/web/src/admin/tutorial/list.vue
@@ -1,18 +1,18 @@
 <script setup lang="ts">
 import { NSwitch } from "naive-ui"
 import { parseTime } from "utils/functions"
-import type { Tutorial } from "utils/types"
+import type { TutorialListItem } from "utils/types"
 import { getTutorialList, setTutorialVisibility } from "../api"
 import Actions from "./components/Actions.vue"
 
-const tutorials = ref<{ [key: string]: Tutorial[] }>({
+const tutorials = ref<{ [key: string]: TutorialListItem[] }>({
   python: [],
   c: [],
 })
 const message = useMessage()
 const activeTab = ref("python")
 
-const columns: DataTableColumn<Tutorial>[] = [
+const columns: DataTableColumn<TutorialListItem>[] = [
   {
     title: "顺序",
     key: "order",
@@ -21,29 +21,29 @@ const columns: DataTableColumn<Tutorial>[] = [
   { title: "标题", key: "title", minWidth: 200 },
   {
     title: "作者",
-    key: "created_by",
-    render: (row) => row.created_by?.username,
+    key: "createdBy",
+    render: (row) => row.createdBy?.username,
     width: 80,
   },
   {
     title: "创建时间",
-    key: "created_at",
+    key: "createdAt",
     width: 180,
-    render: (row) => parseTime(row.created_at!, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createdAt!, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "更新时间",
-    key: "updated_at",
+    key: "updatedAt",
     width: 180,
-    render: (row) => parseTime(row.updated_at!, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.updatedAt!, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "可见",
-    key: "is_public",
+    key: "isPublic",
     width: 100,
     render: (row) =>
       h(NSwitch, {
-        value: row.is_public,
+        value: row.isPublic,
         size: "small",
         rubberBand: false,
         onUpdateValue: () => toggleVisible(row),
@@ -58,14 +58,14 @@ const columns: DataTableColumn<Tutorial>[] = [
   },
 ]
 
-async function toggleVisible(tutorial: Tutorial) {
-  tutorial.is_public = !tutorial.is_public
+async function toggleVisible(tutorial: TutorialListItem) {
+  tutorial.isPublic = !tutorial.isPublic
   try {
-    await setTutorialVisibility(tutorial.id, tutorial.is_public)
+    await setTutorialVisibility(tutorial.id, tutorial.isPublic)
     message.success("更新成功")
   } catch (err: any) {
     message.error(err.data)
-    tutorial.is_public = !tutorial.is_public
+    tutorial.isPublic = !tutorial.isPublic
   }
 }
 
diff --git a/apps/web/src/admin/user/components/Actions.vue b/apps/web/src/admin/user/components/Actions.vue
index e64fe7d..1332515 100644
--- a/apps/web/src/admin/user/components/Actions.vue
+++ b/apps/web/src/admin/user/components/Actions.vue
@@ -14,7 +14,7 @@ const emit = defineEmits<{
 }>()
 
 async function banUser() {
-  props.user.is_disabled = !props.user.is_disabled
+  props.user.isDisabled = !props.user.isDisabled
   await editUser(props.user)
   emit("userBanned", props.user)
 }
@@ -40,10 +40,10 @@ async function banUser() {
     <n-button
       size="small"
       secondary
-      :type="props.user.is_disabled ? 'info' : 'error'"
+      :type="props.user.isDisabled ? 'info' : 'error'"
       @click="banUser"
     >
-      {{ props.user.is_disabled ? "解封" : "封号" }}
+      {{ props.user.isDisabled ? "解封" : "封号" }}
     </n-button>
     <n-popconfirm @positive-click="$emit('deleteUser', [props.user.id])">
       <template #trigger>
diff --git a/apps/web/src/admin/user/components/Name.vue b/apps/web/src/admin/user/components/Name.vue
index 72462ac..a99f142 100644
--- a/apps/web/src/admin/user/components/Name.vue
+++ b/apps/web/src/admin/user/components/Name.vue
@@ -9,30 +9,30 @@ interface Props {
 }
 const props = defineProps<Props>()
 const isNotRegularUser = computed(
-  () => props.user.admin_type !== USER_TYPE.REGULAR_USER,
+  () => props.user.adminType !== USER_TYPE.REGULAR_USER,
 )
 </script>
 <template>
   <n-flex align="center">
-    <n-tag v-if="props.user.is_disabled" type="error" size="small">
+    <n-tag v-if="props.user.isDisabled" type="error" size="small">
       封号中
     </n-tag>
     <n-tag
       v-if="isNotRegularUser"
-      :type="getUserRole(props.user.admin_type).type"
+      :type="getUserRole(props.user.adminType).type"
       size="small"
     >
-      {{ getUserRole(props.user.admin_type).label }}
+      {{ getUserRole(props.user.adminType).label }}
     </n-tag>
     <n-tag
       size="small"
       v-if="
-        props.user.admin_type === USER_TYPE.STUDENT_ADMIN ||
-        props.user.admin_type === USER_TYPE.TEACHER_ADMIN
+        props.user.adminType === USER_TYPE.STUDENT_ADMIN ||
+        props.user.adminType === USER_TYPE.TEACHER_ADMIN
       "
     >
       {{
-        props.user.problem_permission === PROBLEM_PERMISSION.ALL
+        props.user.problemPermission === PROBLEM_PERMISSION.ALL
           ? "全部"
           : "仅自己"
       }}
diff --git a/apps/web/src/admin/user/list.vue b/apps/web/src/admin/user/list.vue
index bc49bae..f210236 100644
--- a/apps/web/src/admin/user/list.vue
+++ b/apps/web/src/admin/user/list.vue
@@ -66,28 +66,29 @@ const columns: DataTableColumn<User>[] = [
     title: "密码",
     key: "raw_password",
     width: 100,
-    render: (row) => h(TextCopy, () => row.raw_password),
+    render: (row) => h(TextCopy, () => row.rawPassword),
   },
   {
     title: "创建时间",
     key: "create_time",
     width: 200,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) =>
+      row.createTime ? parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss") : "",
   },
   {
     title: "上次登录",
     key: "last_login",
     width: 200,
     render: (row) =>
-      row.last_login
-        ? parseTime(row.last_login, "YYYY-MM-DD HH:mm:ss")
+      row.lastLogin
+        ? parseTime(row.lastLogin, "YYYY-MM-DD HH:mm:ss")
         : "从未登录",
   },
   {
     title: "真名",
     key: "real_name",
     width: 100,
-    render: (row) => h(TextCopy, () => row.real_name),
+    render: (row) => h(TextCopy, () => row.realName),
   },
   { title: "邮箱", key: "email", width: 200 },
   {
@@ -145,8 +146,8 @@ async function onResetPassword(user: User) {
   const res = await resetPassword(user.id)
   message.success(`【${user.username}】的密码已重置成【${res.data}】`)
   users.value = users.value.map((it) => {
-    if (it.id === user.id && user.admin_type === USER_TYPE.REGULAR_USER) {
-      it.raw_password = res.data
+    if (it.id === user.id && user.adminType === USER_TYPE.REGULAR_USER) {
+      it.rawPassword = res.data
     }
     return it
   })
@@ -155,7 +156,7 @@ async function onResetPassword(user: User) {
 async function onUserBanned(user: User) {
   users.value = users.value.map((it) => {
     if (it.id === user.id) {
-      it.is_disabled = user.is_disabled
+      it.isDisabled = user.isDisabled
     }
     return it
   })
@@ -166,14 +167,16 @@ function createNewUser() {
   userEditing.value = {
     id: 0,
     username: "",
-    real_name: "",
+    realName: "",
     email: "",
-    admin_type: "Student Admin",
-    problem_permission: "None",
-    create_time: new Date(),
-    last_login: new Date(),
-    open_api: false,
-    is_disabled: false,
+    adminType: "Student Admin",
+    problemPermission: "None",
+    createTime: null,
+    lastLogin: null,
+    openApi: false,
+    isDisabled: false,
+    rawPassword: null,
+    className: null,
     password: "",
   }
   password.value = ""
@@ -204,8 +207,8 @@ async function handleEditUser() {
         [
           userEditing.value.username,
           password.value,
-          userEditing.value.email,
-          userEditing.value.real_name,
+          userEditing.value.email ?? "",
+          userEditing.value.realName ?? "",
         ],
       ]
       await importUsers(newUser)
@@ -303,16 +306,16 @@ watch(() => [query.page, query.limit, query.type, query.orderBy], listUsers)
           <n-input v-model:value="userEditing.username" />
         </n-form-item-gi>
         <n-form-item-gi :span="1" label="真名">
-          <n-input v-model:value="userEditing.real_name" />
+          <n-input v-model:value="userEditing.realName" />
         </n-form-item-gi>
         <n-form-item-gi v-if="!create" :span="1" label="班级">
-          <n-input v-model:value="userEditing.class_name" />
+          <n-input v-model:value="userEditing.className" />
         </n-form-item-gi>
         <n-form-item-gi :span="1" label="邮箱">
           <n-input v-model:value="userEditing.email" />
         </n-form-item-gi>
         <n-form-item-gi v-if="!create" :span="1" label="类型">
-          <n-select v-model:value="userEditing.admin_type" :options="options" />
+          <n-select v-model:value="userEditing.adminType" :options="options" />
         </n-form-item-gi>
         <n-form-item-gi
           :span="1"
@@ -324,20 +327,20 @@ watch(() => [query.page, query.limit, query.type, query.orderBy], listUsers)
         <n-form-item-gi
           v-if="
             !create &&
-            (userEditing.admin_type === USER_TYPE.STUDENT_ADMIN ||
-              userEditing.admin_type === USER_TYPE.TEACHER_ADMIN)
+            (userEditing.adminType === USER_TYPE.STUDENT_ADMIN ||
+              userEditing.adminType === USER_TYPE.TEACHER_ADMIN)
           "
           :span="1"
           label="出题权限"
         >
           <n-select
-            v-model:value="userEditing.problem_permission"
+            v-model:value="userEditing.problemPermission"
             :options="problemPermissionOptions"
           />
         </n-form-item-gi>
 
         <n-form-item-gi v-if="!create" :span="1" label="是否封禁">
-          <n-switch v-model:value="userEditing.is_disabled">封号</n-switch>
+          <n-switch v-model:value="userEditing.isDisabled">封号</n-switch>
         </n-form-item-gi>
       </n-grid>
       <n-flex justify="end">
diff --git a/apps/web/src/oj/achievement/api.ts b/apps/web/src/oj/achievement/api.ts
index b224c81..169aad4 100644
--- a/apps/web/src/oj/achievement/api.ts
+++ b/apps/web/src/oj/achievement/api.ts
@@ -1,26 +1,14 @@
 import api2 from "utils/api2"
 import type {
-  Achievement,
+  AchievementList,
   AchievementSummary,
   PendingAchievement,
 } from "utils/types"
 
 export function getAchievements(name?: string) {
-  return api2
-    .get<any>("achievements", { params: name ? { username: name } : {} })
-    .then((response) => ({
-      ...response,
-      data: {
-        username: response.data.username,
-        achievements: response.data.achievements.map(
-          (item: any): Achievement => ({
-            ...item,
-            unlock_time: item.unlockTime,
-            unlock_rate: item.unlockRate,
-          }),
-        ),
-      },
-    }))
+  return api2.get<AchievementList>("achievements", {
+    params: name ? { username: name } : {},
+  })
 }
 
 export function getAchievementSummary(name?: string) {
diff --git a/apps/web/src/oj/achievement/components/AchievementCard.vue b/apps/web/src/oj/achievement/components/AchievementCard.vue
index 05b846a..e615ad4 100644
--- a/apps/web/src/oj/achievement/components/AchievementCard.vue
+++ b/apps/web/src/oj/achievement/components/AchievementCard.vue
@@ -17,7 +17,7 @@ const masked = computed(
 
 // 获得率低于 5% 的加稀有闪光边框
 const isRare = computed(
-  () => props.achievement.unlock_rate > 0 && props.achievement.unlock_rate < 5,
+  () => props.achievement.unlockRate > 0 && props.achievement.unlockRate < 5,
 )
 
 // 只有"越多越好"的成就画进度条。lte 类（如最短 AC 代码 ≤ 50 字符）
@@ -45,10 +45,10 @@ const percent = computed(() => {
 })
 
 const unlockDate = computed(() => {
-  const { unlock_time, backfilled } = props.achievement
+  const { unlockTime, backfilled } = props.achievement
   // 补发的记录不显示具体日期：一次补发会给几百人盖上同一个时间戳
-  if (backfilled || !unlock_time) return "已获得"
-  return `${new Date(unlock_time).toLocaleDateString()} 获得`
+  if (backfilled || !unlockTime) return "已获得"
+  return `${new Date(unlockTime).toLocaleDateString()} 获得`
 })
 </script>
 
@@ -86,7 +86,7 @@ const unlockDate = computed(() => {
         <template v-if="achievement.unlocked">
           <n-text depth="3" class="nowrap">{{ unlockDate }}</n-text>
           <n-text depth="3" class="nowrap">
-            仅 {{ achievement.unlock_rate }}% 的人获得
+            仅 {{ achievement.unlockRate }}% 的人获得
           </n-text>
         </template>
 
@@ -113,7 +113,7 @@ const unlockDate = computed(() => {
         </template>
 
         <n-text v-else depth="3" class="nowrap">
-          仅 {{ achievement.unlock_rate }}% 的人获得
+          仅 {{ achievement.unlockRate }}% 的人获得
         </n-text>
       </n-flex>
     </n-thing>
diff --git a/apps/web/src/oj/achievement/index.vue b/apps/web/src/oj/achievement/index.vue
index 4b54628..f11d5e1 100644
--- a/apps/web/src/oj/achievement/index.vue
+++ b/apps/web/src/oj/achievement/index.vue
@@ -7,25 +7,10 @@ import type {
   Achievement,
   AchievementRarity,
   AchievementSummary,
+  UserBadge,
 } from "utils/types"
 import AchievementCard from "./components/AchievementCard.vue"
 
-interface UserBadge {
-  id: number
-  earned_time: string
-  badge: {
-    id: number
-    name: string
-    description: string
-    icon: string
-  }
-  // 奖章来自哪个题单，接口在 UserBadgeSerializer 里带出来
-  problemset: {
-    id: number
-    title: string
-  } | null
-}
-
 const route = useRoute()
 const name = computed(() => (route.query.name as string) || undefined)
 
@@ -72,7 +57,7 @@ async function load() {
     // http 客户端返回 ApiResponse<T>，真实载荷在 .data 里
     achievements.value = list.data.achievements
     summary.value = sum.data
-    badges.value = (badgeRes.data ?? []) as UserBadge[]
+    badges.value = badgeRes.data ?? []
   } finally {
     loading.value = false
   }
diff --git a/apps/web/src/oj/ai/components/DifficultyGradeChart.vue b/apps/web/src/oj/ai/components/DifficultyGradeChart.vue
index 6add8be..b21aa4b 100644
--- a/apps/web/src/oj/ai/components/DifficultyGradeChart.vue
+++ b/apps/web/src/oj/ai/components/DifficultyGradeChart.vue
@@ -83,6 +83,7 @@ const data = computed(() => {
 // 根据等级返回对应的颜色
 function getGradeColor(grade: Grade): string {
   const colors: { [key in Grade]: string } = {
+    "": "#C9CDD4", // 无评级：后端在没有可用数据时下发空串
     S: "#FF6384",
     A: "#FFCE56",
     B: "#36A2EB",
diff --git a/apps/web/src/oj/ai/components/DurationChart.vue b/apps/web/src/oj/ai/components/DurationChart.vue
index 502d7ca..7331939 100644
--- a/apps/web/src/oj/ai/components/DurationChart.vue
+++ b/apps/web/src/oj/ai/components/DurationChart.vue
@@ -73,14 +73,14 @@ const data = computed<ChartData<"bar" | "line">>(() => {
       {
         type: "bar",
         label: "完成题目数",
-        data: aiStore.durationData.map((duration) => duration.problem_count),
+        data: aiStore.durationData.map((duration) => duration.problemCount),
         yAxisID: "y",
         order: 2,
       },
       {
         type: "bar",
         label: "总提交次数",
-        data: aiStore.durationData.map((duration) => duration.submission_count),
+        data: aiStore.durationData.map((duration) => duration.submissionCount),
         yAxisID: "y",
         order: 2,
       },
diff --git a/apps/web/src/oj/ai/components/EfficiencyChart.vue b/apps/web/src/oj/ai/components/EfficiencyChart.vue
index 8b74bf4..1659a98 100644
--- a/apps/web/src/oj/ai/components/EfficiencyChart.vue
+++ b/apps/web/src/oj/ai/components/EfficiencyChart.vue
@@ -59,8 +59,8 @@ const show = computed(() => {
 // 计算提交效率数据
 const efficiencyData = computed(() => {
   return aiStore.durationData.map((duration) => {
-    const problemCount = duration.problem_count || 0
-    const submissionCount = duration.submission_count || 0
+    const problemCount = duration.problemCount || 0
+    const submissionCount = duration.submissionCount || 0
 
     // 计算效率：提交次数/完成题目数
     // 值越接近1，说明一次AC率越高
diff --git a/apps/web/src/oj/ai/components/Grade.vue b/apps/web/src/oj/ai/components/Grade.vue
index b5096d1..19ee246 100644
--- a/apps/web/src/oj/ai/components/Grade.vue
+++ b/apps/web/src/oj/ai/components/Grade.vue
@@ -28,8 +28,10 @@
   </div>
 </template>
 <script setup lang="ts">
+import type { Grade } from "utils/types"
 const props = defineProps<{
-  grade: "S" | "A" | "B" | "C"
+  // 空串是「无评级」，四张图都不渲染 —— 后端没有可用数据时会下发它
+  grade: Grade
 }>()
 </script>
 <style scoped>
diff --git a/apps/web/src/oj/ai/components/Overview.vue b/apps/web/src/oj/ai/components/Overview.vue
index 4355f4d..85c832f 100644
--- a/apps/web/src/oj/ai/components/Overview.vue
+++ b/apps/web/src/oj/ai/components/Overview.vue
@@ -8,9 +8,9 @@
     <span>你一共解决 </span>
     <b class="charming"> {{ aiStore.detailsData.solved.length }} </b>
     <span> 道题</span>
-    <span v-if="aiStore.detailsData.contest_count > 0">
+    <span v-if="aiStore.detailsData.contestCount > 0">
       ，并且参加
-      <b class="charming"> {{ aiStore.detailsData.contest_count }} </b>
+      <b class="charming"> {{ aiStore.detailsData.contestCount }} </b>
       次比赛
     </span>
     <span>，综合评价给到</span>
@@ -49,6 +49,7 @@ const durationLabel = computed(() => {
 
 const greeting = computed(() => {
   return {
+    "": "还没有足够的数据来评级",
     S: "要不试试高难度题目？",
     A: "你很棒，继续保持！",
     B: "请再接再厉！",
diff --git a/apps/web/src/oj/ai/components/ProgressChart.vue b/apps/web/src/oj/ai/components/ProgressChart.vue
index 3f55eed..e3a92f8 100644
--- a/apps/web/src/oj/ai/components/ProgressChart.vue
+++ b/apps/web/src/oj/ai/components/ProgressChart.vue
@@ -44,6 +44,7 @@ const aiStore = useAIStore()
 
 const gradeOrder = ["C", "B", "A", "S"] as const
 const gradeColors: Record<Grade, string> = {
+  "": "#C9CDD4", // 无评级：后端在没有可用数据时下发空串
   C: "#95F204",
   B: "#36A2EB",
   A: "#FFCE56",
@@ -74,7 +75,7 @@ const progressData = computed(() => {
   let totalProblems = 0 // 累计题目总数
 
   return aiStore.durationData.map((duration) => {
-    const problemCount = duration.problem_count || 0
+    const problemCount = duration.problemCount || 0
     cumulativeCount += problemCount
 
     // 计算本期等级的权重值
diff --git a/apps/web/src/oj/ai/components/RankDistributionChart.vue b/apps/web/src/oj/ai/components/RankDistributionChart.vue
index db51802..38d25a8 100644
--- a/apps/web/src/oj/ai/components/RankDistributionChart.vue
+++ b/apps/web/src/oj/ai/components/RankDistributionChart.vue
@@ -38,8 +38,8 @@ const rankDistribution = computed(() => {
   }))
 
   aiStore.detailsData.solved.forEach((item) => {
-    const rank = item.period_rank
-    const acCount = item.period_ac_count
+    const rank = item.periodRank
+    const acCount = item.periodAcCount
 
     if (rank && acCount && acCount > 0) {
       const percentile = (rank / acCount) * 100
@@ -52,7 +52,7 @@ const rankDistribution = computed(() => {
       if (rangeIndex !== -1) {
         distribution[rangeIndex].count++
         distribution[rangeIndex].problems.push(
-          `${item.problem.display_id}: ${item.problem.title}`,
+          `${item.problem.displayId}: ${item.problem.title}`,
         )
       }
     }
diff --git a/apps/web/src/oj/ai/components/SolvedTable.vue b/apps/web/src/oj/ai/components/SolvedTable.vue
index 60ef450..56c7bea 100644
--- a/apps/web/src/oj/ai/components/SolvedTable.vue
+++ b/apps/web/src/oj/ai/components/SolvedTable.vue
@@ -58,40 +58,40 @@ const columns: DataTableColumn<SolvedProblem>[] = [
         {
           text: true,
           onClick: () => {
-            if (row.problem.contest_id) {
+            if (row.problem.contestId) {
               router.push(
                 "/contest/" +
-                  row.problem.contest_id +
+                  row.problem.contestId +
                   "/problem/" +
-                  row.problem.display_id,
+                  row.problem.displayId,
               )
             } else {
-              router.push("/problem/" + row.problem.display_id)
+              router.push("/problem/" + row.problem.displayId)
             }
           },
         },
         () => {
-          if (row.problem.contest_id) {
+          if (row.problem.contestId) {
             return h(TagTitle, { problem: row.problem })
           } else {
-            return row.problem.display_id + " " + row.problem.title
+            return row.problem.displayId + " " + row.problem.title
           }
         },
       ),
   },
   {
-    title: () => (aiStore.detailsData.class_name ? "班级排名" : "全服排名"),
+    title: () => (aiStore.detailsData.className ? "班级排名" : "全服排名"),
     key: "rank",
     width: 100,
     align: "center",
-    render: (row) => row.rank + " / " + row.ac_count,
+    render: (row) => row.rank + " / " + row.acCount,
   },
   {
     title: "同期排名",
     key: "period_rank",
     width: 100,
     align: "center",
-    render: (row) => row.period_rank + " / " + row.period_ac_count,
+    render: (row) => row.periodRank + " / " + row.periodAcCount,
   },
   {
     title: () =>
@@ -128,10 +128,10 @@ const flowchartsColumns: DataTableColumn<FlowchartSummary>[] = [
         {
           text: true,
           onClick: () => {
-            router.push("/problem/" + row.problem__id)
+            router.push("/problem/" + row.problemId)
           },
         },
-        () => `${row.problem__id} ${row.problem_title}`,
+        () => `${row.problemId} ${row.problemTitle}`,
       ),
   },
   { title: "提交次数", key: "submission_count", width: 100, align: "center" },
@@ -140,14 +140,14 @@ const flowchartsColumns: DataTableColumn<FlowchartSummary>[] = [
     key: "best",
     width: 100,
     align: "center",
-    render: (row) => `${row.best_score} (${row.best_grade})`,
+    render: (row) => `${row.bestScore} (${row.bestGrade})`,
   },
   {
     title: "最新提交时间",
     key: "latest_submission_time",
     width: 200,
     align: "center",
-    render: (row) => parseTime(row.latest_submission_time),
+    render: (row) => parseTime(row.latestSubmissionTime),
   },
   { title: "平均分", key: "avg_score", width: 100, align: "center" },
 ]
diff --git a/apps/web/src/oj/ai/components/TagTitle.vue b/apps/web/src/oj/ai/components/TagTitle.vue
index 48d91e3..08ec43c 100644
--- a/apps/web/src/oj/ai/components/TagTitle.vue
+++ b/apps/web/src/oj/ai/components/TagTitle.vue
@@ -2,19 +2,15 @@
   <n-flex vertical align="start">
     <n-flex align="center">
       <n-tag type="info" size="small" :bordered="false">比赛</n-tag>
-      <span>{{ problem.contest_title }}</span>
+      <span>{{ problem.contestTitle }}</span>
     </n-flex>
-    <span>{{ problem.display_id }} {{ problem.title }}</span>
+    <span>{{ problem.displayId }} {{ problem.title }}</span>
   </n-flex>
 </template>
 <script setup lang="ts">
+import type { SolvedProblem } from "utils/types"
 interface Props {
-  problem: {
-    title: string
-    display_id: string
-    contest_title: string
-    contest_id: number
-  }
+  problem: SolvedProblem["problem"]
 }
 
 const props = defineProps<Props>()
diff --git a/apps/web/src/oj/ai/components/TimeActivityHeatmap.vue b/apps/web/src/oj/ai/components/TimeActivityHeatmap.vue
index 9711864..daa85ad 100644
--- a/apps/web/src/oj/ai/components/TimeActivityHeatmap.vue
+++ b/apps/web/src/oj/ai/components/TimeActivityHeatmap.vue
@@ -50,7 +50,7 @@ const activityMatrix = computed(() => {
 
   // 统计数据
   aiStore.detailsData.solved.forEach((item) => {
-    const date = new Date(item.ac_time)
+    const date = new Date(item.acTime)
     const weekday = date.getDay() // 0-6，0是周日
     const hour = date.getHours() // 0-23
 
diff --git a/apps/web/src/oj/announcement/list.vue b/apps/web/src/oj/announcement/list.vue
index a849691..d5c40e5 100644
--- a/apps/web/src/oj/announcement/list.vue
+++ b/apps/web/src/oj/announcement/list.vue
@@ -33,15 +33,15 @@ const columns: DataTableColumn<Announcement>[] = [
     render: (row) => h(NTag, () => row.tag || "公告"),
   },
   {
-    key: "create_time",
+    key: "createTime",
     title: renderTableTitle("发布时间", "fluent-emoji-flat:eight-oclock"),
-    render: (row) => parseTime(row.create_time),
+    render: (row) => parseTime(row.createTime),
     width: 180,
   },
   {
     key: "username",
     title: renderTableTitle("发布人", "streamline-emojis:ghost"),
-    render: (row) => row.created_by.username,
+    render: (row) => row.createdBy.username,
     width: 120,
   },
 ]
diff --git a/apps/web/src/oj/api.ts b/apps/web/src/oj/api.ts
index 4da036e..18b97ec 100644
--- a/apps/web/src/oj/api.ts
+++ b/apps/web/src/oj/api.ts
@@ -1,15 +1,46 @@
 import {
-  createSubmissionResponseSchema,
+  type AiAnalysisRecord,
+  type Contest as OjContest,
+  type ContestList,
+  type ActivityRankItem,
+  type ClassComparisonResponse,
+  type ClassRankItem,
+  type ClassUserRank,
+  type ContestRank,
+  type UserRank,
+  type ProblemRank,
+  type CreateSubmissionResponse,
+  type ProblemAuthor,
+  type ProblemListItem,
+  type YearlyAc,
+  type ProblemList,
+  type CreateFlowchartResponse,
+  type FlowchartCurrent,
+  type FlowchartDetail,
+  type FlowchartList,
+  type FlowchartSubmission,
+  type AiDetail,
+  type DurationData,
+  type HeatmapItem,
+  type LoginSummary,
+  type ProblemSet,
+  type ProblemSetBadge,
+  type ProblemSetList,
+  type ProblemSetProblem,
+  type ProblemSetProgressList,
+  type UserBadge,
   problemDetailSchema,
   submissionDetailSchema,
   type FlowchartStatistics,
   type SubmissionStatistics,
 } from "@oj2/contract"
 import api2 from "utils/api2"
-import { legacyResponse, toLegacy } from "utils/legacy"
-import type { ApiResponse } from "utils/http"
 import { filterResult } from "oj/transforms"
 import type {
+  Announcement,
+  Profile,
+  Message,
+  SubmissionListItem,
   Exercise,
   Problem,
   ReactionKey,
@@ -18,97 +49,39 @@ import type {
   SubmissionListPayload,
   SubmitCodePayload,
   WebsiteConfig,
+  Tutorial,
 } from "utils/types"
 
-function listProblem(value: any): Problem {
-  return {
-    id: value.id,
-    _id: value._id,
-    title: value.title,
-    difficulty: value.difficulty,
-    submission_number: value.submissionNumber,
-    accepted_number: value.acceptedNumber,
-    created_by: toLegacy(value.createdBy),
-    tags: value.tags,
-    contest: value.contestId,
-    allow_flowchart: value.allowFlowchart,
-    show_flowchart: value.showFlowchart,
-    has_ast_rules: value.hasAstRules,
-    my_status: value.myStatus,
-  } as Problem
-}
-
+/**
+ * 题目详情。走契约的 zod 解析，形状即契约 —— 之前这里手抄了一份 camel→snake 的
+ * 键名映射，抄漏一个字段就是静默 undefined。
+ */
 function detailProblem(value: unknown): Problem {
-  const problem = problemDetailSchema.parse(value)
-  return {
-    id: problem.id,
-    _id: problem._id,
-    title: problem.title,
-    description: problem.description,
-    input_description: problem.inputDescription,
-    output_description: problem.outputDescription,
-    samples: problem.samples,
-    hint: problem.hint ?? "",
-    languages: problem.languages,
-    template: problem.template,
-    create_time: problem.createTime,
-    last_update_time: problem.lastUpdateTime,
-    time_limit: problem.timeLimit,
-    memory_limit: problem.memoryLimit,
-    difficulty: problem.difficulty,
-    source: problem.source ?? "",
-    prompt: problem.prompt ?? "",
-    answers: [],
-    submission_number: problem.submissionNumber,
-    accepted_number: problem.acceptedNumber,
-    statistic_info: problem.statisticInfo,
-    share_submission: problem.shareSubmission,
-    contest: problem.contestId,
-    tags: problem.tags,
-    created_by: {
-      id: problem.createdBy.id,
-      username: problem.createdBy.username,
-      real_name: problem.createdBy.realName,
-    },
-    my_status: problem.myStatus,
-    my_failed_count: problem.myFailedCount,
-    visible: true,
-    allow_flowchart: problem.allowFlowchart,
-    show_flowchart: problem.showFlowchart,
-    mermaid_code: problem.mermaidCode ?? undefined,
-    flowchart_data: problem.flowchartData ?? undefined,
-    flowchart_hint: problem.flowchartHint ?? undefined,
-    sql_config: problem.sqlConfig as Problem["sql_config"],
-    sql_display: problem.sqlDisplay as Problem["sql_display"],
-  } as Problem
+  return problemDetailSchema.parse(value) as Problem
 }
 
 export function getWebsiteConfig() {
-  return legacyResponse<WebsiteConfig>(api2.get("site"))
+  return api2.get<WebsiteConfig>("site")
 }
 
 export async function getProblemList(
   offset = 0,
   limit = 10,
-  searchParams: any = {},
+  searchParams: Record<string, unknown> = {},
 ) {
-  const res = await api2.get<{ results: any[]; total: number }>("problems", {
+  const res = await api2.get<ProblemList>("problems", {
     params: { paging: true, offset, limit, ...searchParams },
   })
   return {
-    results: res.data.results.map(listProblem).map(filterResult),
+    results: res.data.results.map(filterResult),
     total: res.data.total,
   }
 }
 
 export function getAuthors(all = false) {
-  return legacyResponse(
-    api2.get("problem-authors", {
-      params: {
-        all: all ? "1" : "0",
-      },
-    }),
-  )
+  return api2.get<ProblemAuthor[]>("problem-authors", {
+    params: { all: all ? "1" : "0" },
+  })
 }
 
 export function getRandomProblemID() {
@@ -131,41 +104,14 @@ export async function getSubmission(id: string) {
   const response = await api2.get<unknown>(
     `submissions/${encodeURIComponent(id)}`,
   )
-  const submission = submissionDetailSchema.parse(response.data)
   return {
     error: null,
-    data: {
-      id: submission.id,
-      create_time: submission.createTime,
-      user_id: submission.userId,
-      username: submission.username,
-      code: submission.code,
-      result: submission.result,
-      info: submission.info,
-      language: submission.language,
-      shared: submission.shared,
-      show_link: submission.showLink,
-      statistic_info: submission.statisticInfo,
-      ip: submission.ip,
-      contest: submission.contestId,
-      problem: submission.problemId,
-      can_unshare: submission.canUnshare,
-    } as Submission,
+    data: submissionDetailSchema.parse(response.data) as Submission,
   }
 }
 
-export async function submitCode(data: SubmitCodePayload) {
-  const response = await api2.post<unknown>("submissions", {
-    problemId: data.problem_id,
-    language: data.language,
-    code: data.code,
-    contestId: data.contest_id,
-  })
-  const created = createSubmissionResponseSchema.parse(response.data)
-  return {
-    error: null,
-    data: { submission_id: created.submissionId },
-  }
+export function submitCode(data: SubmitCodePayload) {
+  return api2.post<CreateSubmissionResponse>("submissions", data)
 }
 
 export function formatCode(data: { code: string; language: string }) {
@@ -182,30 +128,23 @@ export function formatCode(data: { code: string; language: string }) {
 }
 
 export function getSubmissions(params: Partial<SubmissionListPayload>) {
-  const endpoint = params.contest_id
-    ? `contests/${encodeURIComponent(params.contest_id)}/submissions`
+  const endpoint = params.contestId
+    ? `contests/${encodeURIComponent(params.contestId)}/submissions`
     : "submissions"
-  return legacyResponse(
-    api2.get(endpoint, {
-      params: {
-        ...params,
-        problemId: params.problem_id,
-        contest_id: undefined,
-        problem_id: undefined,
-        page: undefined,
-      },
-    }),
-  )
+  // 契约里 language 是 z.string()（语言是配置项，随时可能加，收紧成枚举会让
+  // 新加的语言在后端 parse 时直接抛），前端在这一处收窄成 LANGUAGE
+  return api2.get<{ results: SubmissionListItem[]; total: number }>(endpoint, {
+    // contestId 走的是路径，page 只有前端分页器用
+    params: { ...params, contestId: undefined, page: undefined },
+  })
 }
 
-export function getRankOfProblem(problem_id: string) {
-  return legacyResponse(
-    api2.get(`problems/${encodeURIComponent(problem_id)}/rank`),
-  )
+export function getRankOfProblem(problemId: string) {
+  return api2.get<ProblemRank>(`problems/${encodeURIComponent(problemId)}/rank`)
 }
 
 export function getTodaySubmissionCount(language?: string) {
-  return api2.get("submissions/today-count", { params: { language } })
+  return api2.get<number>("submissions/today-count", { params: { language } })
 }
 
 export function adminRejudge(id: string) {
@@ -228,25 +167,19 @@ export function getRank(
   n: number,
   username?: string,
 ) {
-  return legacyResponse(
-    api2.get("rankings/users", {
-      params: { offset, limit, username, top: n },
-    }),
-  )
+  return api2.get<UserRank>("rankings/users", {
+    params: { offset, limit, username, top: n },
+  })
 }
 
 export function getActivityRank(start: string) {
-  return api2.get("rankings/activity", {
+  return api2.get<ActivityRankItem[]>("rankings/activity", {
     params: { start },
   })
 }
 
 export function getClassRank(grade?: number | null) {
-  return legacyResponse(
-    api2.get("rankings/classes", {
-      params: { grade },
-    }),
-  )
+  return api2.get<ClassRankItem[]>("rankings/classes", { params: { grade } })
 }
 
 export function getUserClassRank(
@@ -254,9 +187,9 @@ export function getUserClassRank(
   offset?: number,
   limit?: number,
 ) {
-  return legacyResponse(
-    api2.get("me/class-rank", { params: { scope, offset, limit } }),
-  )
+  return api2.get<ClassUserRank>("me/class-rank", {
+    params: { scope, offset, limit },
+  })
 }
 
 export function getClassPK(
@@ -264,16 +197,11 @@ export function getClassPK(
   startTime?: string,
   endTime?: string,
 ) {
-  const payload: any = {
+  return api2.post<ClassComparisonResponse>("classes/comparison", {
     classNames,
-  }
-  if (startTime) {
-    payload.startTime = startTime
-  }
-  if (endTime) {
-    payload.endTime = endTime
-  }
-  return legacyResponse(api2.post("classes/comparison", payload))
+    ...(startTime ? { startTime } : {}),
+    ...(endTime ? { endTime } : {}),
+  })
 }
 
 export function getContestList(query: {
@@ -283,11 +211,11 @@ export function getContestList(query: {
   status: string
   tag: string
 }) {
-  return legacyResponse(api2.get("contests", { params: query }))
+  return api2.get<ContestList>("contests", { params: query })
 }
 
 export function getContest(id: string) {
-  return legacyResponse(api2.get(`contests/${encodeURIComponent(id)}`))
+  return api2.get<OjContest>(`contests/${encodeURIComponent(id)}`)
 }
 
 export function getContestAccess(id: string) {
@@ -301,30 +229,20 @@ export function checkContestPassword(contestID: string, password: string) {
 }
 
 export async function getContestProblems(contestID: string) {
-  const res = await api2.get<any[]>(
+  const res = await api2.get<ProblemListItem[]>(
     `contests/${encodeURIComponent(contestID)}/problems`,
   )
-  return res.data.map(listProblem).map(filterResult)
+  return res.data.map(filterResult)
 }
 
 export function getContestRank(
   contestID: string,
   query: { limit: number; offset: number },
 ) {
-  return legacyResponse<any>(
-    api2.get(`contests/${encodeURIComponent(contestID)}/rank`, {
-      params: query,
-    }),
-  ).then((response) => ({
-    ...response,
-    data: {
-      ...response.data,
-      results: response.data.results.map((item: any) => ({
-        ...item,
-        contest: item.contest_id,
-      })),
-    },
-  }))
+  return api2.get<ContestRank>(
+    `contests/${encodeURIComponent(contestID)}/rank`,
+    { params: query },
+  )
 }
 
 export function uploadAvatar(file: File) {
@@ -335,23 +253,18 @@ export function uploadAvatar(file: File) {
   })
 }
 
-export function updateProfile(data: { real_name: string; mood: string }) {
-  return legacyResponse(
-    api2.put("me/profile", {
-      realName: data.real_name,
-      mood: data.mood,
-    }),
-  )
+export function updateProfile(data: { realName: string; mood: string }) {
+  return api2.put<Profile>("me/profile", data)
 }
 
 export function getAnnouncementList(offset = 0, limit = 10) {
-  return legacyResponse(
-    api2.get("announcements", { params: { limit, offset } }),
-  )
+  return api2.get<{ results: Announcement[]; total: number }>("announcements", {
+    params: { limit, offset },
+  })
 }
 
 export function getAnnouncement(id: number) {
-  return legacyResponse(api2.get(`announcements/${id}`))
+  return api2.get<Announcement>(`announcements/${id}`)
 }
 
 export function createMessage(data: {
@@ -367,7 +280,10 @@ export function createMessage(data: {
 }
 
 export function getMessageList(offset = 0, limit = 10) {
-  return legacyResponse(api2.get("messages", { params: { limit, offset } }))
+  // language 的收窄同 getSubmissions，见那里的说明
+  return api2.get<{ results: Message[]; total: number }>("messages", {
+    params: { limit, offset },
+  })
 }
 
 export function getReaction(problemID: number) {
@@ -388,7 +304,7 @@ export function getMetrics(userid: number) {
 }
 
 export function getTutorial(id: number) {
-  return legacyResponse(api2.get(`tutorials/${id}`))
+  return api2.get<Tutorial>(`tutorials/${id}`)
 }
 
 export function getTutorials(type: "python" | "c") {
@@ -396,19 +312,7 @@ export function getTutorials(type: "python" | "c") {
 }
 
 export function getAIDetailData(start: string, end: string, username?: string) {
-  return legacyResponse<any>(
-    api2.get("ai/detail", { params: { start, end, username } }),
-  ).then((response) => ({
-    ...response,
-    data: {
-      ...response.data,
-      flowcharts:
-        response.data.flowcharts?.map((item: any) => ({
-          ...item,
-          problem__id: item.problem_id,
-        })) ?? [],
-    },
-  }))
+  return api2.get<AiDetail>("ai/detail", { params: { start, end, username } })
 }
 
 export function getAIDurationData(
@@ -416,95 +320,68 @@ export function getAIDurationData(
   duration: string,
   username?: string,
 ) {
-  return legacyResponse(
-    api2.get("ai/duration", { params: { end, duration, username } }),
-  )
+  return api2.get<DurationData[]>("ai/duration", {
+    params: { end, duration, username },
+  })
 }
 
 export function getAIHeatmapData(username?: string) {
-  return api2.get("ai/heatmap", { params: username ? { username } : {} })
+  return api2.get<HeatmapItem[]>("ai/heatmap", {
+    params: username ? { username } : {},
+  })
 }
 
 export function getAILoginSummary() {
-  return legacyResponse(api2.get("ai/login-summary"))
+  return api2.get<LoginSummary>("ai/login-summary")
 }
 
 export function getAIPinnedReport() {
-  return legacyResponse(api2.get("ai/pinned"))
+  return api2.get<AiAnalysisRecord | null>("ai/pinned")
 }
 
 // ==================== 相似题目推荐 ====================
 
 export function getSimilarProblems(problemId: string) {
   return api2
-    .get<any[]>(`problems/${encodeURIComponent(problemId)}/similar`)
+    .get<ProblemListItem[]>(`problems/${encodeURIComponent(problemId)}/similar`)
     .then((response) => ({
       ...response,
-      data: response.data.map(listProblem).map(filterResult),
+      data: response.data.map(filterResult),
     }))
 }
 
-export interface YearlyACData {
-  year: number
-  total: number
-  accepted: number
-  ac_rate: number
-}
+export type { YearlyAc as YearlyACData } from "@oj2/contract"
 
 export function getProblemYearlyAC(problemId: string) {
-  return legacyResponse<YearlyACData[]>(
-    api2.get(`problems/${encodeURIComponent(problemId)}/yearly-ac`),
+  return api2.get<YearlyAc[]>(
+    `problems/${encodeURIComponent(problemId)}/yearly-ac`,
   )
 }
 
 // ==================== 流程图相关API ====================
 
 export function submitFlowchart(data: {
-  problem_id: number
-  mermaid_code: string
-  flowchart_data: any // 这个是压缩之后的，元数据太长了
+  problemId: number
+  mermaidCode: string
+  flowchartData: Record<string, unknown> // 压缩之后的，元数据太长了
 }) {
-  return legacyResponse(
-    api2.post("flowcharts", {
-      problemId: data.problem_id,
-      mermaidCode: data.mermaid_code,
-      flowchartData: data.flowchart_data,
-    }),
-  )
+  return api2.post<CreateFlowchartResponse>("flowcharts", data)
 }
 
-function legacyFlowchart(value: unknown) {
-  const item = toLegacy<any>(value)
-  return {
-    ...item,
-    user: item.user_id ?? 0,
-    problem: item.problem_id,
-  }
-}
-
-export async function getFlowchartSubmission(id: string) {
-  const response = await api2.get(`flowcharts/${encodeURIComponent(id)}`)
-  return { ...response, data: legacyFlowchart(response.data) }
+export function getFlowchartSubmission(id: string) {
+  return api2.get<FlowchartSubmission>(`flowcharts/${encodeURIComponent(id)}`)
 }
 
 export function getFlowchartSubmissions(params: {
   username?: string
-  problem_id?: string
+  problemId?: string
   myself?: string
   offset?: number
   limit?: number
   today?: string
   grade?: string
 }) {
-  return legacyResponse<any>(
-    api2.get("flowcharts", {
-      params: {
-        ...params,
-        problemId: params.problem_id,
-        problem_id: undefined,
-      },
-    }),
-  )
+  return api2.get<FlowchartList>("flowcharts", { params })
 }
 
 export function getFlowchartStatistics(
@@ -518,32 +395,19 @@ export function getFlowchartStatistics(
 }
 
 export function retryFlowchartSubmission(submissionId: string) {
-  return legacyResponse(
-    api2.post(`flowcharts/${encodeURIComponent(submissionId)}/retry`),
+  return api2.post<{ status: string }>(
+    `flowcharts/${encodeURIComponent(submissionId)}/retry`,
   )
 }
 
 export function getCurrentProblemFlowchartSubmission(problemId: number) {
-  return api2.get(`problems/${problemId}/flowchart/current`)
+  return api2.get<FlowchartCurrent>(`problems/${problemId}/flowchart/current`)
 }
 
-export async function getFlowchartSubmissionDetail(
-  problemId: number,
-  page = 0,
-) {
-  const response = await api2.get<any>(
-    `problems/${problemId}/flowchart/history`,
-    { params: { page } },
-  )
-  return {
-    ...response,
-    data: {
-      ...response.data,
-      submission: response.data.submission
-        ? legacyFlowchart(response.data.submission)
-        : null,
-    },
-  }
+export function getFlowchartSubmissionDetail(problemId: number, page = 0) {
+  return api2.get<FlowchartDetail>(`problems/${problemId}/flowchart/history`, {
+    params: { page },
+  })
 }
 
 // ==================== 题单相关API ====================
@@ -555,64 +419,17 @@ export function getProblemSetList(
   difficulty = "",
   status = "",
 ) {
-  return legacyResponse<any>(
-    api2.get("problem-sets", {
-      params: {
-        offset,
-        limit,
-        keyword,
-        difficulty,
-        status,
-      },
-    }),
-  ).then(mapProblemSetResponse)
+  return api2.get<ProblemSetList>("problem-sets", {
+    params: { offset, limit, keyword, difficulty, status },
+  })
 }
 
 export function getProblemSetDetail(id: number) {
-  return legacyResponse<any>(api2.get(`problem-sets/${id}`)).then(
-    (response) => ({
-      ...response,
-      data: legacyProblemSet(response.data),
-    }),
-  )
+  return api2.get<ProblemSet>(`problem-sets/${id}`)
 }
 
-function legacyBadge(value: any) {
-  return { ...value, problemset: value.problemset_id }
-}
-
-function legacyProblemSet(value: any) {
-  return {
-    ...value,
-    badges: value.badges?.map(legacyBadge),
-  }
-}
-
-function mapProblemSetResponse(response: ApiResponse<any>) {
-  return {
-    ...response,
-    data: {
-      ...response.data,
-      results: response.data.results.map(legacyProblemSet),
-    },
-  }
-}
-
-export async function getProblemSetProblems(problemSetId: number) {
-  const response = await legacyResponse<any[]>(
-    api2.get(`problem-sets/${problemSetId}/problems`),
-  )
-  return {
-    ...response,
-    data: response.data.map((item) => ({
-      ...item,
-      problemset: item.problemset_id,
-      problem: {
-        ...item.problem,
-        contest: item.problem.contest_id,
-      },
-    })),
-  }
+export function getProblemSetProblems(problemSetId: number) {
+  return api2.get<ProblemSetProblem[]>(`problem-sets/${problemSetId}/problems`)
 }
 
 export function joinProblemSet(problemSetId: number) {
@@ -624,57 +441,35 @@ export function updateProblemSetProgress(
   problemId: number,
   submissionId: string,
 ) {
-  return legacyResponse(
-    api2.put("problem-set-progress", {
-      problemSetId,
-      problemId,
-      submissionId,
-    }),
+  return api2.put("problem-set-progress", {
+    problemSetId,
+    problemId,
+    submissionId,
+  })
+}
+
+export function getUserBadges(username?: string) {
+  return api2.get<UserBadge[]>(
+    `users/${encodeURIComponent(username ?? "me")}/badges`,
   )
 }
 
-// 获取用户徽章列表
-export async function getUserBadges(username?: string) {
-  const response = await legacyResponse<any[]>(
-    api2.get(`users/${encodeURIComponent(username ?? "me")}/badges`),
-  )
-  return {
-    ...response,
-    data: response.data.map((item) => ({
-      ...item,
-      user: item.user_id,
-      badge: legacyBadge(item.badge),
-    })),
-  }
+export function getProblemSetBadges(problemSetId: number) {
+  return api2.get<ProblemSetBadge[]>(`problem-sets/${problemSetId}/badges`)
 }
 
-// 获取题单徽章列表
-export async function getProblemSetBadges(problemSetId: number) {
-  const response = await legacyResponse<any[]>(
-    api2.get(`problem-sets/${problemSetId}/badges`),
-  )
-  return { ...response, data: response.data.map(legacyBadge) }
-}
-
-// 获取题单用户进度列表
 export function getProblemSetUserProgress(
   problemSetId: number,
   params?: {
     limit?: number
     offset?: number
-    class_name?: string
-    completion_status?: "" | "completed" | "in_progress" | "not_started"
+    className?: string
+    completionStatus?: "" | "completed" | "in_progress" | "not_started"
   },
 ) {
-  return legacyResponse(
-    api2.get(`problem-sets/${problemSetId}/user-progress`, {
-      params: {
-        limit: params?.limit,
-        offset: params?.offset,
-        className: params?.class_name,
-        completionStatus: params?.completion_status,
-      },
-    }),
+  return api2.get<ProblemSetProgressList>(
+    `problem-sets/${problemSetId}/user-progress`,
+    { params },
   )
 }
 
diff --git a/apps/web/src/oj/class/pk.vue b/apps/web/src/oj/class/pk.vue
index eaf3cd2..6b987f5 100644
--- a/apps/web/src/oj/class/pk.vue
+++ b/apps/web/src/oj/class/pk.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import type { ClassComparison } from "utils/types"
 import { h } from "vue"
 import { formatISO, sub, type Duration } from "date-fns"
 import { getClassPK } from "oj/api"
@@ -46,32 +47,6 @@ const { isTeacherOrAbove } = useUserStore()
 const message = useMessage()
 const { isDesktop } = useBreakpoints()
 
-interface ClassComparison {
-  class_name: string
-  user_count: number
-  total_ac: number
-  total_submission: number
-  avg_ac: number
-  median_ac: number
-  q1_ac: number
-  q3_ac: number
-  iqr: number
-  std_dev: number
-  top10_avg: number
-  middle80_avg: number
-  bottom10_avg: number
-  excellent_rate: number
-  pass_rate: number
-  active_rate: number
-  ac_rate: number
-  composite_score: number
-  recent_total_ac?: number
-  recent_avg_ac?: number
-  recent_median_ac?: number
-  recent_top10_avg?: number
-  recent_active_count?: number
-}
-
 const selectedClasses = ref<string[]>([])
 const comparisons = ref<ClassComparison[]>([])
 const duration = ref<string>("")
@@ -129,7 +104,7 @@ function getTimeRange(): {
 
 const classOptions = computed(() => {
   return (
-    configStore.config?.class_list.map((item) => ({
+    configStore.config?.classList.map((item) => ({
       label: `${item.slice(0, 2)}计算机${item.slice(2)}班`,
       value: item,
     })) ?? []
@@ -148,7 +123,7 @@ async function compare() {
 
     const res = await getClassPK(selectedClasses.value, startTime, endTime)
     comparisons.value = res.data.comparisons
-    hasTimeRange.value = res.data.has_time_range || false
+    hasTimeRange.value = res.data.hasTimeRange || false
   } catch (error) {
     message.error("获取数据失败")
   } finally {
@@ -252,11 +227,11 @@ function getClassColor(index: number) {
 const compositeScoreChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "综合分",
-      data: comparisons.value.map((c) => c.composite_score),
+      data: comparisons.value.map((c) => c.compositeScore),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -270,11 +245,11 @@ const compositeScoreChartData = computed(() => {
 const totalAcChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "总AC数",
-      data: comparisons.value.map((c) => c.total_ac),
+      data: comparisons.value.map((c) => c.totalAc),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -288,11 +263,11 @@ const totalAcChartData = computed(() => {
 const avgAcChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "平均AC数",
-      data: comparisons.value.map((c) => c.avg_ac),
+      data: comparisons.value.map((c) => c.avgAc),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -306,11 +281,11 @@ const avgAcChartData = computed(() => {
 const medianAcChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "中位数AC数",
-      data: comparisons.value.map((c) => c.median_ac),
+      data: comparisons.value.map((c) => c.medianAc),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -324,11 +299,11 @@ const medianAcChartData = computed(() => {
 const excellentRateChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "优秀率",
-      data: comparisons.value.map((c) => c.excellent_rate),
+      data: comparisons.value.map((c) => c.excellentRate),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -342,11 +317,11 @@ const excellentRateChartData = computed(() => {
 const passRateChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "及格率",
-      data: comparisons.value.map((c) => c.pass_rate),
+      data: comparisons.value.map((c) => c.passRate),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -360,11 +335,11 @@ const passRateChartData = computed(() => {
 const activeRateChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "参与度",
-      data: comparisons.value.map((c) => c.active_rate),
+      data: comparisons.value.map((c) => c.activeRate),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -378,11 +353,11 @@ const activeRateChartData = computed(() => {
 const top10AvgChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "前10%平均",
-      data: comparisons.value.map((c) => c.top10_avg),
+      data: comparisons.value.map((c) => c.top10Avg),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -396,11 +371,11 @@ const top10AvgChartData = computed(() => {
 const bottom10AvgChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "后10%平均",
-      data: comparisons.value.map((c) => c.bottom10_avg),
+      data: comparisons.value.map((c) => c.bottom10Avg),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -414,11 +389,11 @@ const bottom10AvgChartData = computed(() => {
 const middle80AvgChartData = computed(() => {
   if (comparisons.value.length === 0) return null
 
-  const labels = comparisons.value.map((c) => c.class_name)
+  const labels = comparisons.value.map((c) => c.className)
   const datasets = [
     {
       label: "中间80%均值",
-      data: comparisons.value.map((c) => c.middle80_avg),
+      data: comparisons.value.map((c) => c.middle80Avg),
       backgroundColor: comparisons.value.map((_, i) => getClassColor(i).bg),
       borderColor: comparisons.value.map((_, i) => getClassColor(i).border),
       borderWidth: 2,
@@ -449,18 +424,18 @@ const radarChartData = computed(() => {
 
   // 计算每个指标的最大最小值
   const maxValues = [
-    Math.max(...comparisons.value.map((c) => c.total_ac)),
-    Math.max(...comparisons.value.map((c) => c.avg_ac)),
-    Math.max(...comparisons.value.map((c) => c.median_ac)),
+    Math.max(...comparisons.value.map((c) => c.totalAc)),
+    Math.max(...comparisons.value.map((c) => c.avgAc)),
+    Math.max(...comparisons.value.map((c) => c.medianAc)),
     100, // 优秀率最大值
     100, // 及格率最大值
     100, // 参与度最大值
   ]
 
   const minValues = [
-    Math.min(...comparisons.value.map((c) => c.total_ac)),
-    Math.min(...comparisons.value.map((c) => c.avg_ac)),
-    Math.min(...comparisons.value.map((c) => c.median_ac)),
+    Math.min(...comparisons.value.map((c) => c.totalAc)),
+    Math.min(...comparisons.value.map((c) => c.avgAc)),
+    Math.min(...comparisons.value.map((c) => c.medianAc)),
     0,
     0,
     0,
@@ -469,22 +444,22 @@ const radarChartData = computed(() => {
   const datasets = comparisons.value.map((c, index) => {
     const color = getClassColor(index)
     const rawData = [
-      c.total_ac,
-      c.avg_ac,
-      c.median_ac,
-      c.excellent_rate,
-      c.pass_rate,
-      c.active_rate,
+      c.totalAc,
+      c.avgAc,
+      c.medianAc,
+      c.excellentRate,
+      c.passRate,
+      c.activeRate,
     ]
     return {
-      label: c.class_name,
+      label: c.className,
       data: [
-        normalize(c.total_ac, maxValues[0], minValues[0]),
-        normalize(c.avg_ac, maxValues[1], minValues[1]),
-        normalize(c.median_ac, maxValues[2], minValues[2]),
-        c.excellent_rate,
-        c.pass_rate,
-        c.active_rate,
+        normalize(c.totalAc, maxValues[0], minValues[0]),
+        normalize(c.avgAc, maxValues[1], minValues[1]),
+        normalize(c.medianAc, maxValues[2], minValues[2]),
+        c.excellentRate,
+        c.passRate,
+        c.activeRate,
       ],
       rawData,
       backgroundColor: color.bg,
@@ -584,14 +559,14 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
             fontSize: "15px",
           },
         },
-        row.composite_score.toFixed(1),
+        row.compositeScore.toFixed(1),
       ),
   },
   {
     title: "班级",
     key: "class_name",
     render: (row) =>
-      `${row.class_name.slice(0, 2)}计算机${row.class_name.slice(2)}班`,
+      `${row.className.slice(0, 2)}计算机${row.className.slice(2)}班`,
     width: 160,
   },
   {
@@ -602,7 +577,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#1890ff", fontWeight: "600" } },
-        row.user_count,
+        row.userCount,
       ),
   },
   {
@@ -613,7 +588,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#ff4d4f", fontWeight: "600" } },
-        row.total_ac,
+        row.totalAc,
       ),
   },
   {
@@ -624,7 +599,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#52c41a", fontWeight: "600" } },
-        row.avg_ac.toFixed(2),
+        row.avgAc.toFixed(2),
       ),
   },
   {
@@ -635,7 +610,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#fa8c16", fontWeight: "600" } },
-        row.median_ac.toFixed(2),
+        row.medianAc.toFixed(2),
       ),
   },
   {
@@ -646,7 +621,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#cf1322", fontWeight: "600" } },
-        row.top10_avg.toFixed(2),
+        row.top10Avg.toFixed(2),
       ),
   },
   {
@@ -657,7 +632,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#389e0d", fontWeight: "600" } },
-        row.middle80_avg.toFixed(2),
+        row.middle80Avg.toFixed(2),
       ),
   },
   {
@@ -668,7 +643,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#096dd9", fontWeight: "500" } },
-        row.bottom10_avg.toFixed(2),
+        row.bottom10Avg.toFixed(2),
       ),
   },
   {
@@ -679,7 +654,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#faad14", fontWeight: "600" } },
-        row.excellent_rate.toFixed(1) + "%",
+        row.excellentRate.toFixed(1) + "%",
       ),
   },
   {
@@ -690,7 +665,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#52c41a", fontWeight: "600" } },
-        row.pass_rate.toFixed(1) + "%",
+        row.passRate.toFixed(1) + "%",
       ),
   },
   {
@@ -701,7 +676,7 @@ const tableColumns: DataTableColumn<ClassComparison>[] = [
       h(
         "span",
         { style: { color: "#1890ff", fontWeight: "600" } },
-        row.active_rate.toFixed(1) + "%",
+        row.activeRate.toFixed(1) + "%",
       ),
   },
 ]
@@ -827,11 +802,11 @@ const radarChartOptions = {
       <n-grid v-if="comparisons.length > 0" :cols="2" :x-gap="16" :y-gap="16">
         <n-gi
           v-for="(classData, index) in comparisons"
-          :key="classData.class_name"
+          :key="classData.className"
           :span="isDesktop ? 1 : 2"
         >
           <n-card
-            :title="`${classData.class_name.slice(0, 2)}计算机${classData.class_name.slice(2)}班`"
+            :title="`${classData.className.slice(0, 2)}计算机${classData.className.slice(2)}班`"
             :bordered="true"
             hoverable
             :style="{
@@ -842,7 +817,7 @@ const radarChartOptions = {
               <n-tag :type="getRankColor(index).type" size="large">
                 #{{ getRankColor(index).text }}
                 <span style="margin-left: 6px; font-size: 12px; opacity: 0.85">
-                  {{ classData.composite_score }} 分
+                  {{ classData.compositeScore }} 分
                 </span>
               </n-tag>
             </template>
@@ -854,7 +829,7 @@ const radarChartOptions = {
                 <n-gi>
                   <n-statistic
                     label="总AC数"
-                    :value="classData.total_ac"
+                    :value="classData.totalAc"
                     size="large"
                     class="stat-total-ac"
                   >
@@ -866,7 +841,7 @@ const radarChartOptions = {
                 <n-gi>
                   <n-statistic
                     label="平均AC数"
-                    :value="classData.avg_ac.toFixed(2)"
+                    :value="classData.avgAc.toFixed(2)"
                     size="large"
                     class="stat-avg-ac"
                   >
@@ -881,7 +856,7 @@ const radarChartOptions = {
                 <n-gi>
                   <n-statistic
                     label="中位数AC数"
-                    :value="classData.median_ac.toFixed(2)"
+                    :value="classData.medianAc.toFixed(2)"
                     size="large"
                     class="stat-median-ac"
                   >
@@ -896,7 +871,7 @@ const radarChartOptions = {
                 <n-gi>
                   <n-statistic
                     label="总提交数"
-                    :value="classData.total_submission"
+                    :value="classData.totalSubmission"
                     size="large"
                     class="stat-total-submission"
                   >
@@ -911,7 +886,7 @@ const radarChartOptions = {
                 <n-gi>
                   <n-statistic
                     label="AC率"
-                    :value="classData.ac_rate.toFixed(1) + '%'"
+                    :value="classData.acRate.toFixed(1) + '%'"
                     size="large"
                     class="stat-ac-rate"
                   >
@@ -934,12 +909,12 @@ const radarChartOptions = {
                 <!-- 分位数统计 -->
                 <n-descriptions-item label="第一四分位数(Q1)">
                   <span style="color: #9254de; font-weight: 500">{{
-                    classData.q1_ac.toFixed(2)
+                    classData.q1Ac.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
                 <n-descriptions-item label="第三四分位数(Q3)">
                   <span style="color: #f759ab; font-weight: 500">{{
-                    classData.q3_ac.toFixed(2)
+                    classData.q3Ac.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
                 <n-descriptions-item label="四分位距(IQR)">
@@ -949,31 +924,31 @@ const radarChartOptions = {
                 </n-descriptions-item>
                 <n-descriptions-item label="标准差">
                   <span style="color: #fa8c16; font-weight: 500">{{
-                    classData.std_dev.toFixed(2)
+                    classData.stdDev.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
 
                 <!-- 分层统计 -->
                 <n-descriptions-item label="前10%均值">
                   <span style="color: #cf1322; font-weight: 600">{{
-                    classData.top10_avg.toFixed(2)
+                    classData.top10Avg.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
                 <n-descriptions-item label="中间80%均值">
                   <span style="color: #389e0d; font-weight: 600">{{
-                    classData.middle80_avg.toFixed(2)
+                    classData.middle80Avg.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
                 <n-descriptions-item label="后10%均值">
                   <span style="color: #096dd9; font-weight: 500">{{
-                    classData.bottom10_avg.toFixed(2)
+                    classData.bottom10Avg.toFixed(2)
                   }}</span>
                 </n-descriptions-item>
 
                 <!-- 人数 -->
                 <n-descriptions-item label="人数">
                   <span style="color: #1890ff; font-weight: 600">{{
-                    classData.user_count
+                    classData.userCount
                   }}</span>
                 </n-descriptions-item>
               </n-descriptions>
@@ -988,34 +963,34 @@ const radarChartOptions = {
                 <n-space vertical :size="10">
                   <n-progress
                     type="line"
-                    :percentage="classData.excellent_rate"
+                    :percentage="classData.excellentRate"
                     :show-indicator="true"
                     :border-radius="4"
                   >
                     <template #default>
-                      优秀率: {{ classData.excellent_rate.toFixed(1) }}%
+                      优秀率: {{ classData.excellentRate.toFixed(1) }}%
                     </template>
                   </n-progress>
                   <n-progress
                     type="line"
-                    :percentage="classData.pass_rate"
+                    :percentage="classData.passRate"
                     :show-indicator="true"
                     :border-radius="4"
                     status="success"
                   >
                     <template #default>
-                      及格率: {{ classData.pass_rate.toFixed(1) }}%
+                      及格率: {{ classData.passRate.toFixed(1) }}%
                     </template>
                   </n-progress>
                   <n-progress
                     type="line"
-                    :percentage="classData.active_rate"
+                    :percentage="classData.activeRate"
                     :show-indicator="true"
                     :border-radius="4"
                     status="info"
                   >
                     <template #default>
-                      参与度: {{ classData.active_rate.toFixed(1) }}%
+                      参与度: {{ classData.activeRate.toFixed(1) }}%
                     </template>
                   </n-progress>
                 </n-space>
@@ -1023,7 +998,7 @@ const radarChartOptions = {
 
               <!-- 时间段统计（如果有） -->
               <template
-                v-if="hasTimeRange && classData.recent_total_ac !== undefined"
+                v-if="hasTimeRange && classData.recentTotalAc !== undefined"
               >
                 <n-descriptions
                   bordered
@@ -1034,27 +1009,27 @@ const radarChartOptions = {
                 >
                   <n-descriptions-item label="时间段总AC">
                     <span style="color: #ff7875; font-weight: 600">{{
-                      classData.recent_total_ac
+                      classData.recentTotalAc
                     }}</span>
                   </n-descriptions-item>
                   <n-descriptions-item label="时间段平均AC">
                     <span style="color: #73d13d; font-weight: 600">{{
-                      classData.recent_avg_ac?.toFixed(2)
+                      classData.recentAvgAc?.toFixed(2)
                     }}</span>
                   </n-descriptions-item>
                   <n-descriptions-item label="时间段中位数AC">
                     <span style="color: #ffc53d; font-weight: 600">{{
-                      classData.recent_median_ac?.toFixed(2)
+                      classData.recentMedianAc?.toFixed(2)
                     }}</span>
                   </n-descriptions-item>
                   <n-descriptions-item label="时间段前10名平均">
                     <span style="color: #ff4d4f; font-weight: 600">{{
-                      classData.recent_top10_avg?.toFixed(2)
+                      classData.recentTop10Avg?.toFixed(2)
                     }}</span>
                   </n-descriptions-item>
                   <n-descriptions-item label="活跃学生数" :span="2">
                     <span style="color: #1890ff; font-weight: 600">{{
-                      classData.recent_active_count
+                      classData.recentActiveCount
                     }}</span>
                   </n-descriptions-item>
                 </n-descriptions>
diff --git a/apps/web/src/oj/contest/components/AcAndSubmission.vue b/apps/web/src/oj/contest/components/AcAndSubmission.vue
index 4f99a36..4014e93 100644
--- a/apps/web/src/oj/contest/components/AcAndSubmission.vue
+++ b/apps/web/src/oj/contest/components/AcAndSubmission.vue
@@ -16,9 +16,9 @@ function goto() {
 </script>
 
 <template>
-  {{ rank.accepted_number }} /
+  {{ rank.acceptedNumber }} /
   <n-button text type="primary" @click="goto">
-    {{ rank.submission_number }}
+    {{ rank.submissionNumber }}
   </n-button>
 </template>
 
diff --git a/apps/web/src/oj/contest/components/ContestInfo.vue b/apps/web/src/oj/contest/components/ContestInfo.vue
index 4f85d38..4aeae7e 100644
--- a/apps/web/src/oj/contest/components/ContestInfo.vue
+++ b/apps/web/src/oj/contest/components/ContestInfo.vue
@@ -24,18 +24,16 @@ const contestStore = useContestStore()
     <div v-html="contestStore.contest.description"></div>
     <n-descriptions bordered label-placement="left" :column="1">
       <n-descriptions-item label="开始时间">
-        {{
-          parseTime(contestStore.contest.start_time, "YYYY年M月D日 HH:mm:ss")
-        }}
+        {{ parseTime(contestStore.contest.startTime, "YYYY年M月D日 HH:mm:ss") }}
       </n-descriptions-item>
       <n-descriptions-item label="结束时间">
-        {{ parseTime(contestStore.contest.end_time, "YYYY年M月D日 HH:mm:ss") }}
+        {{ parseTime(contestStore.contest.endTime, "YYYY年M月D日 HH:mm:ss") }}
       </n-descriptions-item>
       <n-descriptions-item label="比赛类型">
         <ContestType :contest="contestStore.contest" />
       </n-descriptions-item>
       <n-descriptions-item label="发起人">
-        {{ contestStore.contest.created_by.username }}
+        {{ contestStore.contest.createdBy.username }}
       </n-descriptions-item>
     </n-descriptions>
   </n-popover>
diff --git a/apps/web/src/oj/contest/components/LineChart.vue b/apps/web/src/oj/contest/components/LineChart.vue
index ca65dd9..a086287 100644
--- a/apps/web/src/oj/contest/components/LineChart.vue
+++ b/apps/web/src/oj/contest/components/LineChart.vue
@@ -78,7 +78,7 @@ const chartData = computed(() => {
   // 收集所有AC事件并按时间排序
   const events: AcEvent[] = []
   topUsers.forEach((rank, userIndex) => {
-    Object.entries(rank.submission_info).forEach(([problemId, info]) => {
+    Object.entries(rank.submissionInfo).forEach(([problemId, info]) => {
       if (info.is_ac) {
         events.push({ time: info.ac_time, userIndex, problemId })
       }
@@ -100,7 +100,7 @@ const chartData = computed(() => {
   // 用于记录每个用户每道题的错误次数
   const userErrors: Map<string, number>[] = topUsers.map(() => new Map())
   topUsers.forEach((rank, i) => {
-    Object.entries(rank.submission_info).forEach(([problemId, info]) => {
+    Object.entries(rank.submissionInfo).forEach(([problemId, info]) => {
       if (info.error_number > 0) {
         userErrors[i].set(problemId, info.error_number)
       }
diff --git a/apps/web/src/oj/contest/list.vue b/apps/web/src/oj/contest/list.vue
index f71a0ef..28d7b30 100644
--- a/apps/web/src/oj/contest/list.vue
+++ b/apps/web/src/oj/contest/list.vue
@@ -3,7 +3,7 @@ import { useRouteQuery } from "@vueuse/router"
 import { NTag } from "naive-ui"
 import { getContestList } from "oj/api"
 import { duration, parseTime } from "utils/functions"
-import type { Contest } from "utils/types"
+import type { OjContest } from "utils/types"
 import ContestTitle from "shared/components/ContestTitle.vue"
 import Pagination from "shared/components/Pagination.vue"
 import { useAuthModalStore } from "shared/store/authModal"
@@ -29,7 +29,7 @@ const { query, clearQuery } = usePagination<ContestQuery>({
   tag: useRouteQuery("tag", "").value,
 })
 
-const data = ref<Contest[]>([])
+const data = ref<OjContest[]>([])
 const total = ref(0)
 
 const options: SelectOption[] = [
@@ -46,7 +46,7 @@ const tags: SelectOption[] = [
   { label: "期末", value: "期末" },
 ]
 
-const columns: DataTableColumn<Contest>[] = [
+const columns: DataTableColumn<OjContest>[] = [
   {
     title: renderTableTitle("状态", "streamline-emojis:collision"),
     key: "status",
@@ -74,13 +74,13 @@ const columns: DataTableColumn<Contest>[] = [
     title: renderTableTitle("开始时间", "fluent-emoji-flat:eleven-thirty"),
     key: "start_time",
     width: 180,
-    render: (row) => parseTime(row.start_time),
+    render: (row) => parseTime(row.startTime),
   },
   {
     title: renderTableTitle("比赛时长", "streamline-emojis:fishing-pole"),
     key: "duration",
     width: 180,
-    render: (row) => duration(row.start_time, row.end_time),
+    render: (row) => duration(row.startTime, row.endTime),
   },
 ]
 
@@ -116,11 +116,11 @@ watchDebounced(() => query.keyword, listContests, {
 // 监听其他查询条件变化
 watch(() => [query.page, query.limit, query.status, query.tag], listContests)
 
-function rowProps(row: Contest) {
+function rowProps(row: OjContest) {
   return {
     style: "cursor: pointer",
     onClick() {
-      if (!userStore.isAuthed && row.contest_type === ContestType.private) {
+      if (!userStore.isAuthed && row.contestType === ContestType.private) {
         authStore.openLoginModal()
       } else {
         router.push("/contest/" + row.id)
diff --git a/apps/web/src/oj/contest/pages/rank.vue b/apps/web/src/oj/contest/pages/rank.vue
index 46d0748..2fb4443 100644
--- a/apps/web/src/oj/contest/pages/rank.vue
+++ b/apps/web/src/oj/contest/pages/rank.vue
@@ -87,7 +87,7 @@ const columns = ref<DataTableColumn<ContestRank>[]>([
     key: "total_time",
     width: 120,
     align: "center",
-    render: (row) => secondsToDuration(row.total_time),
+    render: (row) => secondsToDuration(row.totalTime),
   },
 ])
 
@@ -129,8 +129,8 @@ async function addColumns() {
             () => problem.title,
           ),
         render: (row) => {
-          if (row.submission_info[problem.id]) {
-            const status = row.submission_info[problem.id]
+          if (row.submissionInfo[problem.id]) {
+            const status = row.submissionInfo[problem.id]
             let acTime
             let errorNumber
             if (status.is_ac) {
@@ -162,8 +162,8 @@ async function addColumns() {
         cellProps: (row) => {
           let backgroundColor = ""
           let color = theme.value.textColorBase
-          if (row.submission_info[problem.id]) {
-            const status = row.submission_info[problem.id]
+          if (row.submissionInfo[problem.id]) {
+            const status = row.submissionInfo[problem.id]
             if (status.is_first_ac) {
               backgroundColor = theme.value.primaryColor
               color = theme.value.baseColor
diff --git a/apps/web/src/oj/problem/components/Form.vue b/apps/web/src/oj/problem/components/Form.vue
index 7cecaef..7f183de 100644
--- a/apps/web/src/oj/problem/components/Form.vue
+++ b/apps/web/src/oj/problem/components/Form.vue
@@ -185,8 +185,8 @@ const goSubmissions = () => {
 }
 
 const goEdit = () => {
-  const url = problem.value!.contest
-    ? `/admin/contest/${problem.value!.contest}/problem/edit/${problem.value!.id}`
+  const url = problem.value!.contestId
+    ? `/admin/contest/${problem.value!.contestId}/problem/edit/${problem.value!.id}`
     : `/admin/problem/edit/${problem.value!.id}`
   window.open(router.resolve(url).href, "_blank")
 }
diff --git a/apps/web/src/oj/problem/components/ProblemContent.vue b/apps/web/src/oj/problem/components/ProblemContent.vue
index afcafe7..3bf0384 100644
--- a/apps/web/src/oj/problem/components/ProblemContent.vue
+++ b/apps/web/src/oj/problem/components/ProblemContent.vue
@@ -32,8 +32,8 @@ const { problem } = storeToRefs(problemStore)
 const problemSetId = computed(() => route.params.problemSetId)
 
 // SQL 题：隐藏输入/输出/例子，改为渲染数据表与期望结果
-const isSQL = computed(() => !!problem.value?.sql_config)
-const sqlDisplay = computed(() => problem.value?.sql_display ?? null)
+const isSQL = computed(() => !!problem.value?.sqlConfig)
+const sqlDisplay = computed(() => problem.value?.sqlDisplay ?? null)
 const sqlExpectedQuery = computed(() => {
   const exp = sqlDisplay.value?.expected
   return exp && "columns" in exp ? exp : null
@@ -71,7 +71,7 @@ watch(
 
 // AC 或失败次数 >= 3 时加载推荐
 watch(
-  () => [problem.value?._id, problem.value?.my_status, problemStore.failCount],
+  () => [problem.value?._id, problem.value?.myStatus, problemStore.failCount],
   ([, status, failCount]) => {
     if (status === 0 || (failCount as number) >= 3) {
       loadSimilarProblems()
@@ -82,9 +82,9 @@ watch(
 
 const hasTriedButNotPassed = computed(() => {
   return (
-    problem.value?.my_status !== undefined &&
-    problem.value?.my_status !== null &&
-    problem.value?.my_status !== 0
+    problem.value?.myStatus !== undefined &&
+    problem.value?.myStatus !== null &&
+    problem.value?.myStatus !== 0
   )
 })
 
@@ -177,8 +177,8 @@ function ruleTagType(engine: string): "error" | "success" | "info" {
 }
 
 const astRulesForDisplay = computed(() => {
-  if (!problem.value?.ast_rules) return []
-  return Object.entries(problem.value.ast_rules).filter(
+  if (!problem.value?.astRules) return []
+  return Object.entries(problem.value.astRules).filter(
     ([, rules]) => rules.length > 0,
   )
 })
@@ -249,7 +249,7 @@ function type(status: ProblemStatus) {
       <!-- 已通过 -->
       <n-alert
         class="status-alert"
-        v-if="problem.my_status === 0"
+        v-if="problem.myStatus === 0"
         type="success"
         title="🎉 本 题 已 经 被 你 解 决 啦"
       >
@@ -291,7 +291,7 @@ function type(status: ProblemStatus) {
       </p>
       <MdPreview
         preview-theme="vuepress"
-        :model-value="problem.input_description"
+        :model-value="problem.inputDescription"
         :theme="isDark ? 'dark' : 'light'"
       />
 
@@ -303,7 +303,7 @@ function type(status: ProblemStatus) {
       </p>
       <MdPreview
         preview-theme="vuepress"
-        :model-value="problem.output_description"
+        :model-value="problem.outputDescription"
         :theme="isDark ? 'dark' : 'light'"
       />
     </template>
@@ -338,7 +338,7 @@ function type(status: ProblemStatus) {
           :total-rows="sqlExpectedQuery.total_rows"
           :truncated="sqlExpectedQuery.truncated"
         />
-        <p v-if="!problem.sql_config?.order_sensitive" class="sqlNote">
+        <p v-if="!problem.sqlConfig?.order_sensitive" class="sqlNote">
           结果顺序不限
         </p>
       </template>
diff --git a/apps/web/src/oj/problem/components/ProblemFlowchart.vue b/apps/web/src/oj/problem/components/ProblemFlowchart.vue
index 0ec970d..c61f7a8 100644
--- a/apps/web/src/oj/problem/components/ProblemFlowchart.vue
+++ b/apps/web/src/oj/problem/components/ProblemFlowchart.vue
@@ -11,13 +11,13 @@ const { renderError, renderFlowchart } = useMermaid()
 const renderProblemFlowchart = async () => {
   await renderFlowchart(
     mermaidContainer.value,
-    problem.value?.mermaid_code ?? "",
+    problem.value?.mermaidCode ?? "",
   )
 }
 
 onMounted(renderProblemFlowchart)
 
-watch(() => problem.value?.mermaid_code, renderProblemFlowchart)
+watch(() => problem.value?.mermaidCode, renderProblemFlowchart)
 </script>
 
 <template>
diff --git a/apps/web/src/oj/problem/components/ProblemInfo.vue b/apps/web/src/oj/problem/components/ProblemInfo.vue
index dc7d3b2..ef571e9 100644
--- a/apps/web/src/oj/problem/components/ProblemInfo.vue
+++ b/apps/web/src/oj/problem/components/ProblemInfo.vue
@@ -30,7 +30,7 @@ const beatRate = ref("0")
 const yearlyACData = ref<YearlyACData[]>([])
 
 const data = computed(() => {
-  const status = problem.value!.statistic_info
+  const status = problem.value!.statisticInfo
   const labels = []
   for (let i in status) {
     if (status[i] !== 0) {
@@ -50,14 +50,14 @@ const numbers = computed(() => {
   return [
     {
       icon: "streamline-ultimate-color:checklist",
-      title: problem.value?.submission_number ?? 0,
+      title: problem.value?.submissionNumber ?? 0,
       content: "总提交",
       int: true,
       suffix: "",
     },
     {
       icon: "streamline-emojis:woman-raising-hand-2",
-      title: problem.value?.accepted_number ?? 0,
+      title: problem.value?.acceptedNumber ?? 0,
       content: "通过数",
       int: true,
       suffix: "",
@@ -65,8 +65,8 @@ const numbers = computed(() => {
     {
       icon: "fluent-emoji:chart-increasing",
       title: getACRateNumber(
-        problem.value?.accepted_number ?? 0,
-        problem.value?.submission_number ?? 0,
+        problem.value?.acceptedNumber ?? 0,
+        problem.value?.submissionNumber ?? 0,
       ),
       content: "通过率",
       int: false,
@@ -115,10 +115,10 @@ onMounted(() => {
       {{ problem._id }}
     </n-descriptions-item>
     <n-descriptions-item label="出题人">
-      {{ problem.created_by.username }}
+      {{ problem.createdBy.username }}
     </n-descriptions-item>
     <n-descriptions-item label="创建时间">
-      {{ parseTime(problem.create_time) }}
+      {{ parseTime(problem.createTime) }}
     </n-descriptions-item>
     <n-descriptions-item label="难度">
       <n-tag :type="getTagColor(problem.difficulty)">
@@ -150,7 +150,7 @@ onMounted(() => {
       </n-card>
     </n-gi>
   </n-grid>
-  <div class="pie" v-if="problem && problem.submission_number > 0">
+  <div class="pie" v-if="problem && problem.submissionNumber > 0">
     <Pie :data="data" :options="options" />
   </div>
   <ProblemYearlyChart :data="yearlyACData" />
diff --git a/apps/web/src/oj/problem/components/ProblemListTitle.vue b/apps/web/src/oj/problem/components/ProblemListTitle.vue
index 345b7c4..1ea5a68 100644
--- a/apps/web/src/oj/problem/components/ProblemListTitle.vue
+++ b/apps/web/src/oj/problem/components/ProblemListTitle.vue
@@ -10,17 +10,17 @@ defineProps<{
   <n-flex align="center">
     <span>{{ problem.title }}</span>
     <Icon
-      v-if="problem.allow_flowchart"
+      v-if="problem.allowFlowchart"
       width="18"
       icon="vscode-icons:file-type-drawio"
     />
     <Icon
-      v-else-if="problem.show_flowchart"
+      v-else-if="problem.showFlowchart"
       width="18"
       icon="vscode-icons:file-type-graphql"
     />
     <Icon
-      v-if="problem.has_ast_rules"
+      v-if="problem.hasAstRules"
       width="18"
       icon="vscode-icons:file-type-light-todo"
     />
diff --git a/apps/web/src/oj/problem/components/ProblemReaction.vue b/apps/web/src/oj/problem/components/ProblemReaction.vue
index 23a4344..4673c5f 100644
--- a/apps/web/src/oj/problem/components/ProblemReaction.vue
+++ b/apps/web/src/oj/problem/components/ProblemReaction.vue
@@ -80,7 +80,7 @@ const wheelItems = REACTIONS.map((item, index) => ({
   style: getWheelItemStyle(index),
 }))
 
-const solved = computed(() => problem.value?.my_status === 0)
+const solved = computed(() => problem.value?.myStatus === 0)
 const locked = computed(() => mine.value !== null)
 const canInteract = computed(
   () =>
diff --git a/apps/web/src/oj/problem/components/ProblemSubmission.vue b/apps/web/src/oj/problem/components/ProblemSubmission.vue
index 1a70976..9627122 100644
--- a/apps/web/src/oj/problem/components/ProblemSubmission.vue
+++ b/apps/web/src/oj/problem/components/ProblemSubmission.vue
@@ -8,7 +8,7 @@ import { useUserStore } from "shared/store/user"
 import { JUDGE_STATUS, LANGUAGE_SHOW_VALUE } from "utils/constants"
 import { parseTime } from "utils/functions"
 import { renderTableTitle } from "utils/renders"
-import type { Submission } from "utils/types"
+import type { SubmissionListItem } from "utils/types"
 import SubmissionDetail from "oj/submission/detail.vue"
 import { useBreakpoints } from "shared/composables/breakpoints"
 
@@ -29,19 +29,19 @@ function showCodePanel(id: string, problem: string) {
   toggleCodePanel(true)
 }
 
-const columns: DataTableColumn<Submission>[] = [
+const columns: DataTableColumn<SubmissionListItem>[] = [
   {
     title: renderTableTitle("提交时间", "fluent-emoji:seven-oclock"),
     key: "create_time",
     width: 200,
-    render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+    render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: renderTableTitle("编号", "fluent-emoji-flat:input-numbers"),
     key: "id",
     minWidth: 160,
     render: (row) => {
-      if (!row.show_link)
+      if (!row.showLink)
         return h(NFlex, { align: "center" }, () => [
           h("span", row.id.slice(0, 12)),
           h(
@@ -90,7 +90,7 @@ const class_ac_count = ref(0)
 const all_ac_count = ref(0)
 const loading = ref(false)
 
-const submissions = ref<Submission[]>([])
+const submissions = ref<SubmissionListItem[]>([])
 const total = ref(0)
 const query = reactive({
   limit: 10,
@@ -126,8 +126,8 @@ async function listSubmissions() {
     ...query,
     myself: "1",
     offset,
-    problem_id: (route.params.problemID as string) ?? "",
-    contest_id: (route.params.contestID as string) ?? "",
+    problemId: (route.params.problemID as string) ?? "",
+    contestId: (route.params.contestID as string) ?? "",
   })
   submissions.value = res.data.results
   total.value = res.data.total
@@ -138,10 +138,10 @@ async function getRankOfThisProblem() {
   const res = await getRankOfProblem((route.params.problemID as string) ?? "")
   loading.value = false
 
-  class_name.value = res.data.class_name
+  class_name.value = res.data.className
   rank.value = res.data.rank
-  class_ac_count.value = res.data.class_ac_count
-  all_ac_count.value = res.data.all_ac_count
+  class_ac_count.value = res.data.classAcCount
+  all_ac_count.value = res.data.allAcCount
 }
 
 onMounted(() => {
diff --git a/apps/web/src/oj/problem/components/ProblemYearlyChart.vue b/apps/web/src/oj/problem/components/ProblemYearlyChart.vue
index 240f49f..9da531d 100644
--- a/apps/web/src/oj/problem/components/ProblemYearlyChart.vue
+++ b/apps/web/src/oj/problem/components/ProblemYearlyChart.vue
@@ -35,7 +35,7 @@ const chartData = computed(() => ({
   datasets: [
     {
       label: "AC 率",
-      data: props.data.map((d) => d.ac_rate),
+      data: props.data.map((d) => d.acRate),
       fill: true,
       tension: 0.3,
       backgroundColor: "rgba(99, 179, 237, 0.2)",
@@ -58,7 +58,7 @@ const chartOptions = computed(() => ({
       callbacks: {
         label: (context: any) => {
           const d = props.data[context.dataIndex]
-          return [`AC 率: ${d.ac_rate}%`, `通过: ${d.accepted} / ${d.total}`]
+          return [`AC 率: ${d.acRate}%`, `通过: ${d.accepted} / ${d.total}`]
         },
       },
     },
diff --git a/apps/web/src/oj/problem/components/SubmissionResult.vue b/apps/web/src/oj/problem/components/SubmissionResult.vue
index dc8bf66..4429968 100644
--- a/apps/web/src/oj/problem/components/SubmissionResult.vue
+++ b/apps/web/src/oj/problem/components/SubmissionResult.vue
@@ -47,9 +47,9 @@ const msg = computed(() => {
 
   if (
     result !== SubmissionStatus.ast_check_failed &&
-    props.submission.statistic_info?.err_info
+    props.submission.statisticInfo?.err_info
   ) {
-    msg += props.submission.statistic_info.err_info
+    msg += props.submission.statisticInfo.err_info
   }
 
   return msg
@@ -161,15 +161,13 @@ const columns: DataTableColumn<Submission["info"]["data"][number]>[] = [
     <n-flex
       vertical
       v-if="
-        msg ||
-        infoTable.length ||
-        submission.statistic_info?.ast_results?.length
+        msg || infoTable.length || submission.statisticInfo?.ast_results?.length
       "
     >
-      <n-card v-if="submission.statistic_info?.ast_results?.length" embedded>
+      <n-card v-if="submission.statisticInfo?.ast_results?.length" embedded>
         <n-flex vertical :size="8">
           <n-flex
-            v-for="(rule, i) in submission.statistic_info.ast_results"
+            v-for="(rule, i) in submission.statisticInfo.ast_results"
             :key="i"
             align="center"
             :size="6"
diff --git a/apps/web/src/oj/problem/components/SubmitCode.vue b/apps/web/src/oj/problem/components/SubmitCode.vue
index 136d6c3..2192dfd 100644
--- a/apps/web/src/oj/problem/components/SubmitCode.vue
+++ b/apps/web/src/oj/problem/components/SubmitCode.vue
@@ -130,22 +130,22 @@ async function submit() {
 
   // 1. 构建提交数据
   const data: SubmitCodePayload = {
-    problem_id: problem.value!.id,
+    problemId: problem.value!.id,
     language: codeStore.code.language,
     code: codeStore.code.value,
   }
   if (contestID) {
-    data.contest_id = parseInt(contestID)
+    data.contestId = parseInt(contestID)
   }
   // 2. 提交代码到后端
   isSubmittingRequest.value = true
   try {
     const res = await submitCode(data)
-    console.log(`[Submit] 代码已提交: ID=${res.data.submission_id}`)
+    console.log(`[Submit] 代码已提交: ID=${res.data.submissionId}`)
 
     // 3. 启动冷却 + 监控
     startCooldown()
-    startMonitoring(res.data.submission_id)
+    startMonitoring(res.data.submissionId)
     showResult.value = true
   } finally {
     isSubmittingRequest.value = false
@@ -183,7 +183,7 @@ watch(
       return
 
     // 1. 刷新题目状态
-    problem.value!.my_status = 0
+    problem.value!.myStatus = 0
 
     // 2. 创建ProblemSetSubmission记录，更新题单进度
     if (problemSetId) {
diff --git a/apps/web/src/oj/problem/components/SubmitFlowchart.vue b/apps/web/src/oj/problem/components/SubmitFlowchart.vue
index 94910db..26e7013 100644
--- a/apps/web/src/oj/problem/components/SubmitFlowchart.vue
+++ b/apps/web/src/oj/problem/components/SubmitFlowchart.vue
@@ -135,16 +135,16 @@ async function submitFlowchartData() {
 
   try {
     const response = await submitFlowchart({
-      problem_id: problem.value!.id,
-      mermaid_code: mermaidCode,
-      flowchart_data: {
+      problemId: problem.value!.id,
+      mermaidCode,
+      flowchartData: {
         compressed: true,
         data: compressed,
       },
     })
 
     // 获取提交ID并订阅更新
-    const submissionId = response.data.submission_id
+    const submissionId = response.data.submissionId
 
     if (submissionId) {
       subscribeToSubmission(submissionId)
@@ -183,18 +183,34 @@ async function getSubmission(submissionPage = 0) {
   )
   submissionCount.value = data.count
   const submission = data.submission
-  myFlowchartZippedStr.value = submission.flowchart_data.data
-  myMermaidCode.value = submission.mermaid_code || ""
+  // 翻到没有提交的页时后端返回 null（契约里 submission 是 nullable）——
+  // 原来的 any 让这里看起来非空，真翻到那一页会直接抛
+  if (!submission) {
+    myFlowchartZippedStr.value = ""
+    myMermaidCode.value = ""
+    modalRating.value = { score: 0, grade: "" }
+    evaluation.value = {
+      score: 0,
+      grade: "",
+      feedback: "",
+      suggestions: "",
+      criteria_details: {},
+    }
+    return
+  }
+  myFlowchartZippedStr.value = String(submission.flowchartData.data ?? "")
+  myMermaidCode.value = submission.mermaidCode || ""
   modalRating.value = {
-    score: submission.ai_score,
-    grade: submission.ai_grade,
+    score: submission.aiScore ?? 0,
+    grade: (submission.aiGrade ?? "") as Rating["grade"],
   }
   evaluation.value = {
-    score: submission.ai_score,
-    grade: submission.ai_grade,
-    feedback: submission.ai_feedback,
-    suggestions: submission.ai_suggestions,
-    criteria_details: submission.ai_criteria_details,
+    score: submission.aiScore ?? 0,
+    grade: (submission.aiGrade ?? "") as Rating["grade"],
+    feedback: submission.aiFeedback ?? "",
+    suggestions: submission.aiSuggestions ?? "",
+    criteria_details:
+      submission.aiCriteriaDetails as Evaluation["criteria_details"],
   }
 }
 
diff --git a/apps/web/src/oj/problem/detail.vue b/apps/web/src/oj/problem/detail.vue
index 3b1a667..3568b04 100644
--- a/apps/web/src/oj/problem/detail.vue
+++ b/apps/web/src/oj/problem/detail.vue
@@ -55,7 +55,7 @@ const { isMobile, isDesktop } = useBreakpoints()
 
 const tabOptions = computed(() => {
   const options: string[] = ["content"]
-  if (problem.value?.show_flowchart) {
+  if (problem.value?.showFlowchart) {
     options.push("flowchart")
   }
 
@@ -113,7 +113,7 @@ async function init() {
     problem.value = res.data
   } catch (err: any) {
     problem.value = null
-    if (err.data === "Contest has not started yet.") {
+    if (err.error === "contest-not-started") {
       errMsg.value = "比赛还没有开始"
     }
   }
@@ -159,7 +159,7 @@ watch(
               <ProblemContent />
             </n-tab-pane>
             <n-tab-pane
-              v-if="problem.show_flowchart && problem.mermaid_code"
+              v-if="problem.showFlowchart && problem.mermaidCode"
               name="flowchart"
               tab="流程图表"
             >
@@ -211,7 +211,7 @@ watch(
             <ProblemContent />
           </n-tab-pane>
           <n-tab-pane
-            v-if="problem.show_flowchart && problem.mermaid_code"
+            v-if="problem.showFlowchart && problem.mermaidCode"
             name="flowchart"
             tab="流程图表"
           >
@@ -251,7 +251,7 @@ watch(
       <n-tab-pane name="content" tab="描述">
         <ProblemContent />
       </n-tab-pane>
-      <n-tab-pane v-if="problem.show_flowchart" name="flowchart" tab="流程">
+      <n-tab-pane v-if="problem.showFlowchart" name="flowchart" tab="流程">
         <ProblemFlowchart />
       </n-tab-pane>
       <n-tab-pane name="editor" tab="代码">
diff --git a/apps/web/src/oj/problemset/components/ProblemSetHeader.vue b/apps/web/src/oj/problemset/components/ProblemSetHeader.vue
index 7d1762f..8eaf331 100644
--- a/apps/web/src/oj/problemset/components/ProblemSetHeader.vue
+++ b/apps/web/src/oj/problemset/components/ProblemSetHeader.vue
@@ -35,7 +35,8 @@ function getDifficultyTag(difficulty: string) {
 function getProgressPercentage() {
   if (!props.problemSet) return 0
   return Math.round(
-    (props.problemSet.completed_count / props.problemSet.problems_count) * 100,
+    ((props.problemSet.completedCount ?? 0) / props.problemSet.problemsCount) *
+      100,
   )
 }
 
@@ -78,7 +79,7 @@ function handleJoin() {
         <n-flex align="center" v-if="isJoined">
           <n-text strong>完成进度</n-text>
           <n-text>
-            {{ problemSet.completed_count }} / {{ problemSet.problems_count }}
+            {{ problemSet.completedCount }} / {{ problemSet.problemsCount }}
           </n-text>
         </n-flex>
         <n-progress
diff --git a/apps/web/src/oj/problemset/components/ProblemSetProblemsList.vue b/apps/web/src/oj/problemset/components/ProblemSetProblemsList.vue
index c720b2b..e419691 100644
--- a/apps/web/src/oj/problemset/components/ProblemSetProblemsList.vue
+++ b/apps/web/src/oj/problemset/components/ProblemSetProblemsList.vue
@@ -41,7 +41,7 @@ function handleProblemClick(problemId: string) {
               style="margin-right: 10px"
               width="48"
               icon="fluent-emoji:check-mark-button"
-              v-if="problemSetProblem.is_completed"
+              v-if="problemSetProblem.isCompleted"
             />
 
             <n-flex vertical style="flex: 1">
@@ -60,7 +60,7 @@ function handleProblemClick(problemId: string) {
                   {{ DIFFICULTY[problemSetProblem.problem.difficulty] }}
                 </n-tag>
                 <n-text type="info">分数：{{ problemSetProblem.score }}</n-text>
-                <n-text v-if="!problemSetProblem.is_required">（选做）</n-text>
+                <n-text v-if="!problemSetProblem.isRequired">（选做）</n-text>
               </n-flex>
             </n-flex>
           </n-flex>
diff --git a/apps/web/src/oj/problemset/components/UserProgressView.vue b/apps/web/src/oj/problemset/components/UserProgressView.vue
index 6acd4fb..39962fb 100644
--- a/apps/web/src/oj/problemset/components/UserProgressView.vue
+++ b/apps/web/src/oj/problemset/components/UserProgressView.vue
@@ -16,7 +16,7 @@ const total = ref(0)
 const statistics = ref<{
   total: number
   completed: number
-  avg_progress: number
+  avgProgress: number
 } | null>(null)
 const classFilter = ref<string>("")
 const completionFilter = ref<"" | "completed" | "in_progress" | "not_started">(
@@ -42,17 +42,17 @@ async function loadUserProgress() {
   const params: {
     limit?: number
     offset?: number
-    class_name?: string
-    completion_status?: "" | "completed" | "in_progress" | "not_started"
+    className?: string
+    completionStatus?: "" | "completed" | "in_progress" | "not_started"
   } = {
     limit: query.limit,
     offset,
   }
   if (classFilter.value.trim()) {
-    params.class_name = classFilter.value.trim()
+    params.className = classFilter.value.trim()
   }
   if (completionFilter.value) {
-    params.completion_status = completionFilter.value
+    params.completionStatus = completionFilter.value
   }
   const res = await getProblemSetUserProgress(problemSetId.value, params)
 
@@ -92,7 +92,7 @@ const stats = computed(() => {
     return {
       total: statistics.value.total,
       completed: statistics.value.completed,
-      avgProgress: Math.round(statistics.value.avg_progress),
+      avgProgress: Math.round(statistics.value.avgProgress),
     }
   }
   // 如果后端还没有返回统计数据，使用默认值
@@ -128,7 +128,7 @@ const progressColumns = [
     key: "join_time",
     width: 180,
     render: (row: ProblemSetProgress) =>
-      parseTime(row.join_time, "YYYY-MM-DD HH:mm:ss"),
+      parseTime(row.joinTime, "YYYY-MM-DD HH:mm:ss"),
   },
   {
     title: "已完成数量",
@@ -140,12 +140,12 @@ const progressColumns = [
     key: "completed_problems",
     width: 300,
     render: (row: ProblemSetProgress) => {
-      if (row.progress_percentage === 100) {
+      if (row.progressPercentage === 100) {
         return "全部题目已完成"
       }
-      if (row.progress_percentage > 50 && row.progress_percentage < 100) {
+      if (row.progressPercentage > 50 && row.progressPercentage < 100) {
         const completedProblemIds = new Set(
-          row.completed_problems.map((p: any) => p.id),
+          row.completedProblems.map((p: any) => p.id),
         )
         const incompleteProblems = allProblems.value.filter(
           (p) => !completedProblemIds.has(p.id),
@@ -164,7 +164,7 @@ const progressColumns = [
       }
       return h("div", { style: "max-height: 120px; overflow-y: auto" }, [
         h(NFlex, {}, () =>
-          row.completed_problems.map((problem: any) =>
+          row.completedProblems.map((problem: any) =>
             h(
               NTag,
               {
@@ -184,7 +184,7 @@ const progressColumns = [
     key: "progress_percentage",
     width: 120,
     render: (row: ProblemSetProgress) => {
-      return `${row.progress_percentage.toFixed(0)}%`
+      return `${row.progressPercentage.toFixed(0)}%`
     },
   },
   {
@@ -192,7 +192,7 @@ const progressColumns = [
     key: "is_completed",
     width: 100,
     render: (row: ProblemSetProgress) => {
-      if (row.is_completed) {
+      if (row.isCompleted) {
         return h(NTag, { type: "success" }, () => "已完成")
       } else {
         return h(NTag, { type: "warning" }, () => "进行中")
diff --git a/apps/web/src/oj/problemset/detail.vue b/apps/web/src/oj/problemset/detail.vue
index ab0d1c0..71994a3 100644
--- a/apps/web/src/oj/problemset/detail.vue
+++ b/apps/web/src/oj/problemset/detail.vue
@@ -35,7 +35,7 @@ const activeTab = ref("problems")
 async function loadProblemSetDetail() {
   const res = await getProblemSetDetail(problemSetId.value)
   problemSet.value = res.data
-  isJoined.value = res.data.user_progress?.is_joined || false
+  isJoined.value = res.data.userProgress?.isJoined || false
 }
 
 async function loadProblems() {
@@ -48,14 +48,14 @@ async function loadUserBadges() {
 
   const res = await getUserBadges()
   userBadges.value = res.data.filter(
-    (badge: UserBadgeType) => badge.badge.problemset === problemSetId.value,
+    (badge: UserBadgeType) => badge.badge.problemsetId === problemSetId.value,
   )
 }
 
 async function init() {
   await Promise.all([loadProblemSetDetail(), loadProblems()])
   if (isJoined.value) {
-    if (problemSet.value?.user_progress?.is_completed) {
+    if (problemSet.value?.userProgress?.isCompleted) {
       celebrate()
     }
     loadUserBadges()
@@ -100,7 +100,7 @@ async function handleJoinProblemSet() {
 const showTabs = computed(
   () =>
     userStore.isSuperAdmin ||
-    (isJoined.value && problemSet.value?.user_progress?.is_completed),
+    (isJoined.value && problemSet.value?.userProgress?.isCompleted),
 )
 
 onMounted(init)
diff --git a/apps/web/src/oj/problemset/list.vue b/apps/web/src/oj/problemset/list.vue
index b1e21f7..71be698 100644
--- a/apps/web/src/oj/problemset/list.vue
+++ b/apps/web/src/oj/problemset/list.vue
@@ -3,7 +3,7 @@ import { Icon } from "@iconify/vue"
 import { useRouteQuery } from "@vueuse/router"
 import { getProblemSetList } from "../api"
 import { parseTime } from "utils/functions"
-import type { ProblemSetList } from "utils/types"
+import type { ProblemSet } from "utils/types"
 import Pagination from "shared/components/Pagination.vue"
 import { usePagination } from "shared/composables/pagination"
 import { useBreakpoints } from "shared/composables/breakpoints"
@@ -12,7 +12,7 @@ const router = useRouter()
 const { isDesktop } = useBreakpoints()
 
 const total = ref(0)
-const problemSets = ref<ProblemSetList[]>([])
+const problemSets = ref<ProblemSet[]>([])
 
 interface ProblemSetQuery {
   keyword: string
@@ -164,27 +164,25 @@ watch(
             <n-flex justify="space-between" align="center">
               <n-flex>
                 <Icon width="20" icon="streamline-emojis:blossom" />
-                <n-text>{{ problemSet.problems_count }} 道题目</n-text>
+                <n-text>{{ problemSet.problemsCount }} 道题目</n-text>
               </n-flex>
 
               <n-flex align="center" style="height: 28px">
                 <!-- 用户进度显示 -->
                 <n-progress
                   v-if="
-                    problemSet.user_progress?.is_joined &&
-                    !problemSet.user_progress?.is_completed
+                    problemSet.userProgress?.isJoined &&
+                    !problemSet.userProgress?.isCompleted
                   "
                   type="line"
                   :percentage="
-                    Math.round(problemSet.user_progress.progress_percentage)
+                    Math.round(problemSet.userProgress.progressPercentage)
                   "
                   :height="4"
                   :border-radius="2"
                   style="width: 100px"
                   :color="
-                    getProgressColor(
-                      problemSet.user_progress.progress_percentage,
-                    )
+                    getProgressColor(problemSet.userProgress.progressPercentage)
                   "
                 />
                 <n-tag type="warning" v-if="problemSet.status === 'archived'">
@@ -192,17 +190,14 @@ watch(
                 </n-tag>
                 <n-tag
                   v-if="
-                    problemSet.user_progress?.is_joined &&
-                    !problemSet.user_progress?.is_completed
+                    problemSet.userProgress?.isJoined &&
+                    !problemSet.userProgress?.isCompleted
                   "
                   type="warning"
                 >
                   已加入
                 </n-tag>
-                <n-tag
-                  v-if="problemSet.user_progress?.is_completed"
-                  type="error"
-                >
+                <n-tag v-if="problemSet.userProgress?.isCompleted" type="error">
                   已完成
                 </n-tag>
               </n-flex>
@@ -212,7 +207,7 @@ watch(
             <n-flex align="center" justify="space-between">
               <n-text depth="3">
                 创建于
-                {{ parseTime(problemSet.create_time, "YYYY-MM-DD") }}
+                {{ parseTime(problemSet.createTime, "YYYY-MM-DD") }}
               </n-text>
               <n-flex>
                 <n-tooltip
@@ -227,7 +222,7 @@ watch(
                       width="24"
                       height="24"
                       object-fit="cover"
-                      :class="{ 'earned-badge': badge.is_earned }"
+                      :class="{ 'earned-badge': badge.isEarned }"
                     />
                   </template>
                   <n-flex vertical size="small">
@@ -238,12 +233,12 @@ watch(
                       获取条件:
                       {{
                         getConditionText(
-                          badge.condition_type,
-                          badge.condition_value,
+                          badge.conditionType,
+                          badge.conditionValue,
                         )
                       }}
                     </span>
-                    <n-text type="primary" v-if="badge.is_earned">
+                    <n-text type="primary" v-if="badge.isEarned">
                       ✓ 已获得
                     </n-text>
                   </n-flex>
diff --git a/apps/web/src/oj/rank/components/Chart.vue b/apps/web/src/oj/rank/components/Chart.vue
index 73f33cd..4a9a59a 100644
--- a/apps/web/src/oj/rank/components/Chart.vue
+++ b/apps/web/src/oj/rank/components/Chart.vue
@@ -31,7 +31,7 @@ const data = computed(() => {
   const datasets: any[] = [
     {
       label: props.type === ChartType.Rank ? "已解决" : "做题数",
-      data: props.rankData.map((rank) => rank.accepted_number),
+      data: props.rankData.map((rank) => rank.acceptedNumber),
       backgroundColor: [
         "rgba(255, 99, 132, 0.2)",
         "rgba(255, 159, 64, 0.2)",
@@ -87,7 +87,7 @@ const data = computed(() => {
   if (props.type === ChartType.Rank) {
     datasets.push({
       label: "总提交数",
-      data: props.rankData.map((rank) => rank.submission_number),
+      data: props.rankData.map((rank) => rank.submissionNumber),
       hidden: true,
     })
   }
diff --git a/apps/web/src/oj/rank/list.vue b/apps/web/src/oj/rank/list.vue
index 14e94c3..08f9c28 100644
--- a/apps/web/src/oj/rank/list.vue
+++ b/apps/web/src/oj/rank/list.vue
@@ -1,4 +1,10 @@
 <script setup lang="ts">
+import type {
+  ClassComparison,
+  ClassRankItem as ClassRank,
+  ClassUserRank,
+  Rank,
+} from "utils/types"
 import { formatISO, sub, type Duration } from "date-fns"
 import { NButton, NFlex } from "naive-ui"
 import {
@@ -10,7 +16,6 @@ import {
 } from "oj/api"
 import { useBreakpoints } from "shared/composables/breakpoints"
 import { getACRate, getCSRFToken } from "utils/functions"
-import type { Rank } from "utils/types"
 import Pagination from "shared/components/Pagination.vue"
 import { ChartType } from "utils/constants"
 import { renderTableTitle } from "utils/renders"
@@ -39,6 +44,7 @@ const query = reactive({
   limit: 10,
   page: 1,
 })
+const message = useMessage()
 const rankChart = ref<Rank[]>([])
 const activityChart = ref<Rank[]>([])
 const duration = ref("months:1")
@@ -46,7 +52,7 @@ const classData = ref<ClassRank[]>([])
 const classQuery = reactive({
   grade: gradeOptions[0].value,
 })
-const myClassData = ref<UserRank[]>([])
+const myClassData = ref<ClassUserRank["ranks"]>([])
 const myRank = ref(-1)
 const myClassName = ref("")
 const myClassScope = ref<"window" | "all">("window")
@@ -137,44 +143,6 @@ async function analyzeSingleClassWithAI() {
   }
 }
 
-interface ClassRank {
-  rank: number
-  class_name: string
-  user_count: number
-  total_ac: number
-  total_submission: number
-  avg_ac: number
-  ac_rate: number
-}
-
-interface ClassComparison {
-  class_name: string
-  user_count: number
-  total_ac: number
-  total_submission: number
-  avg_ac: number
-  median_ac: number
-  q1_ac: number
-  q3_ac: number
-  iqr: number
-  std_dev: number
-  top10_avg: number
-  middle80_avg: number
-  bottom10_avg: number
-  excellent_rate: number
-  pass_rate: number
-  active_rate: number
-  ac_rate: number
-  composite_score: number
-}
-
-interface UserRank {
-  rank: number
-  username: string
-  accepted_number: number
-  submission_number: number
-}
-
 async function init() {
   const offset = (query.page - 1) * query.limit
   const res = await getRank(offset, query.limit, 100)
@@ -251,7 +219,7 @@ const columns: DataTableColumn<Rank>[] = [
     key: "rate",
     width: 120,
     align: "center",
-    render: (row) => getACRate(row.accepted_number, row.submission_number),
+    render: (row) => getACRate(row.acceptedNumber, row.submissionNumber),
   },
 ]
 
@@ -269,15 +237,14 @@ async function listActivity() {
   const current = Date.now()
   const start = formatISO(sub(current, subOptions.value))
   const res = await getActivityRank(start)
-  activityChart.value = res.data.map(
-    (d: { username: string; count: number }) => ({
-      user: {
-        username: d.username,
-      },
-      accepted_number: d.count,
-      submission_number: 0,
-    }),
-  )
+  // 活动榜只有「用户名 + 做题数」，塞进榜单图表复用的 Rank 形状里
+  activityChart.value = res.data.map((d, index) => ({
+    id: index,
+    user: { id: index, username: d.username, realName: null },
+    acceptedNumber: d.count,
+    submissionNumber: 0,
+    mood: null,
+  }))
 }
 
 async function listRank() {
@@ -321,7 +288,7 @@ const classColumns: DataTableColumn<ClassRank>[] = [
     title: "班级",
     key: "class_name",
     render: (row) =>
-      `${row.class_name.slice(0, 2)}计算机${row.class_name.slice(2)}班`,
+      `${row.className.slice(0, 2)}计算机${row.className.slice(2)}班`,
     minWidth: 120,
     titleAlign: "center",
     align: "center",
@@ -360,7 +327,7 @@ const classColumns: DataTableColumn<ClassRank>[] = [
     width: 90,
     titleAlign: "center",
     align: "center",
-    render: (row) => `${row.ac_rate}%`,
+    render: (row) => `${row.acRate}%`,
   },
   {
     title: "详情",
@@ -374,14 +341,14 @@ const classColumns: DataTableColumn<ClassRank>[] = [
         {
           text: true,
           type: "info",
-          onClick: () => loadClassDetail(row.class_name),
+          onClick: () => loadClassDetail(row.className),
         },
         () => "查看",
       ),
   },
 ]
 
-const myClassColumns: DataTableColumn<UserRank>[] = [
+const myClassColumns: DataTableColumn<ClassUserRank["ranks"][number]>[] = [
   {
     title: "排名",
     key: "rank",
@@ -448,7 +415,7 @@ async function listClassRank() {
   if (!userStore.user) {
     await userStore.getMyProfile()
   }
-  const className = userStore.user?.class_name
+  const className = userStore.user?.className
   if (className) {
     classQuery.grade = parseInt(className.slice(0, 2))
   }
@@ -464,8 +431,8 @@ async function listMyClassRank() {
         : 0
     const limit = myClassScope.value === "all" ? myClassQuery.limit : undefined
     const res = await getUserClassRank(myClassScope.value, offset, limit)
-    myRank.value = res.data.my_rank
-    myClassName.value = res.data.class_name
+    myRank.value = res.data.myRank
+    myClassName.value = res.data.className
     myClassData.value = res.data.ranks
     myClassTotal.value = res.data.total ?? res.data.ranks.length
     if (myClassScope.value === "window") {
@@ -610,7 +577,7 @@ watch(
     preset="card"
     :title="
       classDetailData
-        ? `${classDetailData.class_name.slice(0, 2)}计算机${classDetailData.class_name.slice(2)}班`
+        ? `${classDetailData.className.slice(0, 2)}计算机${classDetailData.className.slice(2)}班`
         : '班级详情'
     "
     :style="{ width: '700px', maxWidth: '95vw' }"
@@ -621,7 +588,7 @@ watch(
           <n-gi>
             <n-statistic
               label="总AC数"
-              :value="classDetailData.total_ac"
+              :value="classDetailData.totalAc"
               size="large"
               class="stat-total-ac"
             >
@@ -633,7 +600,7 @@ watch(
           <n-gi>
             <n-statistic
               label="平均AC数"
-              :value="classDetailData.avg_ac.toFixed(2)"
+              :value="classDetailData.avgAc.toFixed(2)"
               size="large"
               class="stat-avg-ac"
             >
@@ -648,7 +615,7 @@ watch(
           <n-gi>
             <n-statistic
               label="中位数AC数"
-              :value="classDetailData.median_ac.toFixed(2)"
+              :value="classDetailData.medianAc.toFixed(2)"
               size="large"
               class="stat-median-ac"
             >
@@ -663,7 +630,7 @@ watch(
           <n-gi>
             <n-statistic
               label="总提交数"
-              :value="classDetailData.total_submission"
+              :value="classDetailData.totalSubmission"
               size="large"
               class="stat-total-submission"
             >
@@ -678,7 +645,7 @@ watch(
           <n-gi>
             <n-statistic
               label="AC率"
-              :value="classDetailData.ac_rate.toFixed(1) + '%'"
+              :value="classDetailData.acRate.toFixed(1) + '%'"
               size="large"
               class="stat-ac-rate"
             >
@@ -699,12 +666,12 @@ watch(
         >
           <n-descriptions-item label="第一四分位数(Q1)">
             <span style="color: #9254de; font-weight: 500">{{
-              classDetailData.q1_ac.toFixed(2)
+              classDetailData.q1Ac.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="第三四分位数(Q3)">
             <span style="color: #f759ab; font-weight: 500">{{
-              classDetailData.q3_ac.toFixed(2)
+              classDetailData.q3Ac.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="四分位距(IQR)">
@@ -714,27 +681,27 @@ watch(
           </n-descriptions-item>
           <n-descriptions-item label="标准差">
             <span style="color: #fa8c16; font-weight: 500">{{
-              classDetailData.std_dev.toFixed(2)
+              classDetailData.stdDev.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="前10%均值">
             <span style="color: #cf1322; font-weight: 600">{{
-              classDetailData.top10_avg.toFixed(2)
+              classDetailData.top10Avg.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="中间80%均值">
             <span style="color: #389e0d; font-weight: 600">{{
-              classDetailData.middle80_avg.toFixed(2)
+              classDetailData.middle80Avg.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="后10%均值">
             <span style="color: #096dd9; font-weight: 500">{{
-              classDetailData.bottom10_avg.toFixed(2)
+              classDetailData.bottom10Avg.toFixed(2)
             }}</span>
           </n-descriptions-item>
           <n-descriptions-item label="人数">
             <span style="color: #1890ff; font-weight: 600">{{
-              classDetailData.user_count
+              classDetailData.userCount
             }}</span>
           </n-descriptions-item>
         </n-descriptions>
@@ -743,35 +710,35 @@ watch(
           <n-space vertical :size="10">
             <n-progress
               type="line"
-              :percentage="classDetailData.excellent_rate"
+              :percentage="classDetailData.excellentRate"
               :show-indicator="true"
               :border-radius="4"
             >
               <template #default
                 >优秀率:
-                {{ classDetailData.excellent_rate.toFixed(1) }}%</template
+                {{ classDetailData.excellentRate.toFixed(1) }}%</template
               >
             </n-progress>
             <n-progress
               type="line"
-              :percentage="classDetailData.pass_rate"
+              :percentage="classDetailData.passRate"
               :show-indicator="true"
               :border-radius="4"
               status="success"
             >
               <template #default
-                >及格率: {{ classDetailData.pass_rate.toFixed(1) }}%</template
+                >及格率: {{ classDetailData.passRate.toFixed(1) }}%</template
               >
             </n-progress>
             <n-progress
               type="line"
-              :percentage="classDetailData.active_rate"
+              :percentage="classDetailData.activeRate"
               :show-indicator="true"
               :border-radius="4"
               status="info"
             >
               <template #default
-                >参与度: {{ classDetailData.active_rate.toFixed(1) }}%</template
+                >参与度: {{ classDetailData.activeRate.toFixed(1) }}%</template
               >
             </n-progress>
           </n-space>
@@ -784,7 +751,7 @@ watch(
           style="margin-top: 12px"
         >
           <n-tag type="success" size="large">
-            综合分: {{ classDetailData.composite_score.toFixed(1) }}
+            综合分: {{ classDetailData.compositeScore.toFixed(1) }}
           </n-tag>
           <n-button
             type="info"
diff --git a/apps/web/src/oj/store/ai.ts b/apps/web/src/oj/store/ai.ts
index 2e66c95..e947deb 100644
--- a/apps/web/src/oj/store/ai.ts
+++ b/apps/web/src/oj/store/ai.ts
@@ -13,13 +13,14 @@ export const useAIStore = defineStore("ai", () => {
   const targetUsername = ref("")
   const durationData = ref<DurationData[]>([])
   const detailsData = reactive<DetailsData>({
+    user: "",
     start: "",
     end: "",
-    grade: "B",
-    class_name: "",
+    grade: "",
+    className: null,
     tags: {},
     difficulty: {},
-    contest_count: 0,
+    contestCount: 0,
     solved: [],
     flowcharts: [],
   })
@@ -44,10 +45,10 @@ export const useAIStore = defineStore("ai", () => {
     detailsData.end = res.data.end
     detailsData.solved = res.data.solved
     detailsData.grade = res.data.grade
-    detailsData.class_name = res.data.class_name
+    detailsData.className = res.data.className
     detailsData.tags = res.data.tags
     detailsData.difficulty = res.data.difficulty
-    detailsData.contest_count = res.data.contest_count
+    detailsData.contestCount = res.data.contestCount
     detailsData.flowcharts = res.data.flowcharts
   }
 
diff --git a/apps/web/src/oj/store/contest.ts b/apps/web/src/oj/store/contest.ts
index bd58561..5a56d04 100644
--- a/apps/web/src/oj/store/contest.ts
+++ b/apps/web/src/oj/store/contest.ts
@@ -21,8 +21,8 @@ export const useContestStore = defineStore("contest", () => {
 
   const contestStatus = computed<ContestStatus>(() => {
     if (!contest.value) return ContestStatus.initial
-    const start = getTime(parseISO(contest.value.start_time.toString()))
-    const end = getTime(parseISO(contest.value.end_time.toString()))
+    const start = getTime(parseISO(contest.value.startTime.toString()))
+    const end = getTime(parseISO(contest.value.endTime.toString()))
     if (start > now.value) {
       return ContestStatus.not_started
     } else if (end < now.value) {
@@ -36,10 +36,10 @@ export const useContestStore = defineStore("contest", () => {
     if (contestStatus.value === ContestStatus.finished) {
       return "已结束"
     } else if (contestStatus.value === ContestStatus.not_started) {
-      const d = duration(formatISO(now.value), contest.value!.start_time, true)
+      const d = duration(formatISO(now.value), contest.value!.startTime, true)
       return "距离比赛开始 " + d
     } else {
-      const d = duration(formatISO(now.value), contest.value!.end_time, true)
+      const d = duration(formatISO(now.value), contest.value!.endTime, true)
       return "距离比赛结束 " + d
     }
   })
@@ -48,11 +48,11 @@ export const useContestStore = defineStore("contest", () => {
     () =>
       userStore.isSuperAdmin ||
       (userStore.isAuthed &&
-        contest.value?.created_by.id === userStore.user!.id),
+        contest.value?.createdBy.id === userStore.user!.id),
   )
 
   const isPrivate = computed(
-    () => contest.value!.contest_type === ContestType.private,
+    () => contest.value!.contestType === ContestType.private,
   )
 
   async function init(contestID: string) {
@@ -65,7 +65,7 @@ export const useContestStore = defineStore("contest", () => {
         now.value = now.value + 1000
       }, 1000)
     }
-    if (contest.value?.contest_type === ContestType.private) {
+    if (contest.value?.contestType === ContestType.private) {
       const res = await getContestAccess(contestID)
       toggleAccess(res.data.access)
     }
diff --git a/apps/web/src/oj/store/problem.ts b/apps/web/src/oj/store/problem.ts
index ead60ec..40295b5 100644
--- a/apps/web/src/oj/store/problem.ts
+++ b/apps/web/src/oj/store/problem.ts
@@ -8,7 +8,7 @@ export const useProblemStore = defineStore("problem", () => {
   const failCount = ref(0)
 
   const languages = computed<LANGUAGE[]>(() => {
-    if (route.name === "problem" && problem.value?.allow_flowchart) {
+    if (route.name === "problem" && problem.value?.allowFlowchart) {
       return ["Flowchart", ...problem.value?.languages]
     }
     return problem.value?.languages ?? []
diff --git a/apps/web/src/oj/submission/components/FlowchartScoreDetail.vue b/apps/web/src/oj/submission/components/FlowchartScoreDetail.vue
index 9303ae4..57816bb 100644
--- a/apps/web/src/oj/submission/components/FlowchartScoreDetail.vue
+++ b/apps/web/src/oj/submission/components/FlowchartScoreDetail.vue
@@ -5,7 +5,7 @@
       <n-card title="流程图预览">
         <template #header-extra>
           <n-button
-            v-if="!renderError && submission?.mermaid_code"
+            v-if="!renderError && submission?.mermaidCode"
             quaternary
             size="small"
             @click="showLargeImage = true"
@@ -42,12 +42,12 @@
     <n-gi :span="2">
       <!-- AI反馈 -->
       <n-card
-        v-if="submission.ai_feedback"
+        v-if="submission.aiFeedback"
         size="small"
         title="AI反馈"
         style="margin-bottom: 16px"
       >
-        <n-text>{{ submission.ai_feedback }}</n-text>
+        <n-text>{{ submission.aiFeedback }}</n-text>
       </n-card>
 
       <!-- 改进建议 -->
@@ -69,15 +69,12 @@
 
       <!-- 详细评分 -->
       <n-card
-        v-if="
-          submission.ai_criteria_details &&
-          Object.keys(submission.ai_criteria_details).length > 0
-        "
+        v-if="Object.keys(criteriaDetails).length > 0"
         size="small"
         title="详细评分"
       >
         <div
-          v-for="(detail, key) in submission.ai_criteria_details"
+          v-for="(detail, key) in criteriaDetails"
           :key="key"
           style="margin-bottom: 12px"
         >
@@ -121,11 +118,38 @@ const mermaidContainer = useTemplateRef<HTMLElement>("mermaidContainer")
 const { renderError, renderFlowchart } = useMermaid()
 
 const submission = ref<FlowchartSubmission | null>(null)
+
+/**
+ * 评分项明细。契约里是 `Record<string, unknown>` —— 内容是 AI 模型原样吐出的 JSON，
+ * 后端不校验形状，所以这里只能按约定断言，字段缺失时用 0 / 空串兜底。
+ */
+const criteriaDetails = computed<
+  Record<string, { score: number; max: number; comment: string }>
+>(() => {
+  const raw = submission.value?.aiCriteriaDetails ?? {}
+  return Object.fromEntries(
+    Object.entries(raw).map(([key, value]) => {
+      const item = (value ?? {}) as Partial<{
+        score: number
+        max: number
+        comment: string
+      }>
+      return [
+        key,
+        {
+          score: item.score ?? 0,
+          max: item.max ?? 0,
+          comment: item.comment ?? "",
+        },
+      ]
+    }),
+  )
+})
 const loading = ref(false)
 const rendering = ref(false)
 const showLargeImage = ref(false)
 const suggestionLines = computed(() =>
-  splitSuggestionLines(submission.value?.ai_suggestions),
+  splitSuggestionLines(submission.value?.aiSuggestions),
 )
 
 function splitSuggestionLines(suggestions?: string | null) {
@@ -154,12 +178,12 @@ async function loadSubmission() {
     submission.value = res.data
 
     // 渲染流程图
-    if (submission.value?.mermaid_code) {
+    if (submission.value?.mermaidCode) {
       rendering.value = true
       await nextTick()
       await renderFlowchart(
         mermaidContainer.value,
-        submission.value.mermaid_code,
+        submission.value.mermaidCode,
       )
       rendering.value = false
     }
diff --git a/apps/web/src/oj/submission/components/Grade.vue b/apps/web/src/oj/submission/components/Grade.vue
index 3e89ad1..c8e4d2d 100644
--- a/apps/web/src/oj/submission/components/Grade.vue
+++ b/apps/web/src/oj/submission/components/Grade.vue
@@ -14,6 +14,7 @@ defineProps<{
 function gradeType(grade: Grade) {
   return (
     {
+      "": "default",
       S: "success",
       A: "info",
       B: "warning",
diff --git a/apps/web/src/oj/submission/components/SubmissionLink.vue b/apps/web/src/oj/submission/components/SubmissionLink.vue
index ced3704..fbf18d1 100644
--- a/apps/web/src/oj/submission/components/SubmissionLink.vue
+++ b/apps/web/src/oj/submission/components/SubmissionLink.vue
@@ -1,5 +1,5 @@
 <template>
-  <n-flex v-if="props.submission.show_link" align="center">
+  <n-flex v-if="props.submission.showLink" align="center">
     <n-button text type="info" @click="$emit('showCode')">
       {{ props.submission.id.slice(0, 12) }}
     </n-button>
@@ -43,7 +43,7 @@ defineEmits(["showCode"])
 
 const userStore = useUserStore()
 const isOwnSubmission = computed(
-  () => userStore.profile?.user?.id === props.submission.user_id,
+  () => userStore.profile?.user?.id === props.submission.userId,
 )
 
 function goto() {
diff --git a/apps/web/src/oj/submission/detail.vue b/apps/web/src/oj/submission/detail.vue
index db7ef00..9e755a1 100644
--- a/apps/web/src/oj/submission/detail.vue
+++ b/apps/web/src/oj/submission/detail.vue
@@ -77,10 +77,10 @@ function copyToCat() {
 }
 
 function copyToProblem() {
-  const { code, language, contest } = submission.value!
+  const { code, language, contestId } = submission.value!
   // 编辑器的 storageKey 用 display id（problem._id），等于 props.problemID，
   // 而非 submission.problem（内部数字 id）
-  const contestIDForKey = contest || null
+  const contestIDForKey = contestId || null
   const storageKey = `problem_${props.problemID}_contest_${contestIDForKey}_lang_${language}`
   storage.set(storageKey, code)
   // 设置语言 + 代码：localStorage 覆盖全新挂载的编辑器，
@@ -89,10 +89,10 @@ function copyToProblem() {
   codeStore.setCode(code)
 
   const problemSetId = (route.params.problemSetId as string) ?? ""
-  if (contest) {
+  if (contestId) {
     router.push({
       name: "contest problem",
-      params: { contestID: String(contest), problemID: props.problemID },
+      params: { contestID: String(contestId), problemID: props.problemID },
     })
   } else if (problemSetId) {
     router.push({
@@ -121,7 +121,7 @@ onMounted(init)
         :title="JUDGE_STATUS[submission.result]['title']"
       >
         <n-flex>
-          <span>提交时间：{{ parseTime(submission.create_time) }}</span>
+          <span>提交时间：{{ parseTime(submission.createTime) }}</span>
           <span>编程语言：{{ LANGUAGE_SHOW_VALUE[submission.language] }}</span>
           <span>用户：{{ submission.username }}</span>
         </n-flex>
diff --git a/apps/web/src/oj/submission/list.vue b/apps/web/src/oj/submission/list.vue
index d15f77d..b6dab23 100644
--- a/apps/web/src/oj/submission/list.vue
+++ b/apps/web/src/oj/submission/list.vue
@@ -9,6 +9,7 @@ import {
   retryFlowchartSubmission,
 } from "oj/api"
 import { parseTime } from "utils/functions"
+import type { Grade as GradeValue } from "utils/types"
 import type {
   FlowchartSubmissionListItem,
   LANGUAGE,
@@ -101,7 +102,7 @@ async function listSubmissions() {
   if (query.language === "Flowchart") {
     const res = await getFlowchartSubmissions({
       username: query.username,
-      problem_id: query.problem,
+      problemId: query.problem,
       myself: query.myself,
       offset,
       limit: query.limit,
@@ -114,8 +115,8 @@ async function listSubmissions() {
     const res = await getSubmissions({
       ...query,
       offset,
-      problem_id: query.problem,
-      contest_id: (route.params.contestID as string) ?? "",
+      problemId: query.problem,
+      contestId: (route.params.contestID as string) ?? "",
       language: query.language,
       today: query.today,
     })
@@ -233,7 +234,7 @@ const columns = computed(() => {
       title: renderTableTitle("提交时间", "fluent-emoji:seven-oclock"),
       key: "create_time",
       minWidth: 200,
-      render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+      render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
     },
     {
       title: renderTableTitle("提交编号", "fluent-emoji-flat:input-numbers"),
@@ -263,7 +264,7 @@ const columns = computed(() => {
             onClick: () => problemClicked(row),
             onSearch: () => (query.problem = row.problem),
           },
-          () => `${row.problem} ${row.problem_title}`,
+          () => `${row.problem} ${row.problemTitle}`,
         ),
     },
     {
@@ -318,7 +319,7 @@ const flowchartColumns = computed(() => {
     {
       title: renderTableTitle("提交时间", "fluent-emoji:seven-oclock"),
       key: "create_time",
-      render: (row) => parseTime(row.create_time, "YYYY-MM-DD HH:mm:ss"),
+      render: (row) => parseTime(row.createTime, "YYYY-MM-DD HH:mm:ss"),
     },
     {
       title: renderTableTitle("提交编号", "fluent-emoji-flat:input-numbers"),
@@ -340,7 +341,7 @@ const flowchartColumns = computed(() => {
             onClick: () => problemClicked(row),
             onSearch: () => (query.problem = row.problem),
           },
-          () => `${row.problem} ${row.problem_title}`,
+          () => `${row.problem} ${row.problemTitle}`,
         ),
     },
     {
@@ -349,7 +350,11 @@ const flowchartColumns = computed(() => {
         "streamline-ultimate-color:analytics-bars-3d",
       ),
       key: "ai_score",
-      render: (row) => h(Grade, { score: row.ai_score, grade: row.ai_grade }),
+      render: (row) =>
+        h(Grade, {
+          score: row.aiScore ?? 0,
+          grade: (row.aiGrade ?? "") as GradeValue,
+        }),
     },
     {
       title: renderTableTitle(
@@ -545,9 +550,9 @@ const flowchartColumns = computed(() => {
         <n-text>流程图评分详情</n-text>
         <n-text
           v-if="selectedFlowchart"
-          :type="getGradeType(selectedFlowchart.ai_grade)"
+          :type="getGradeType(selectedFlowchart.aiGrade ?? '')"
         >
-          {{ selectedFlowchart.ai_score }}分 {{ selectedFlowchart.ai_grade }}级
+          {{ selectedFlowchart.aiScore }}分 {{ selectedFlowchart.aiGrade }}级
         </n-text>
       </n-flex>
     </template>
diff --git a/apps/web/src/oj/transforms.ts b/apps/web/src/oj/transforms.ts
index 80f8ac7..38504e9 100644
--- a/apps/web/src/oj/transforms.ts
+++ b/apps/web/src/oj/transforms.ts
@@ -1,29 +1,27 @@
 import { DIFFICULTY } from "utils/constants"
 import { getACRate } from "utils/functions"
-import type { Problem } from "utils/types"
+import type { ProblemFiltered, ProblemListItem } from "utils/types"
 
-// 把后端的 Problem 塑形成列表项需要的形状，与请求逻辑解耦。
-export function filterResult(result: Problem) {
-  const newResult = {
+// 把后端的列表项塑形成列表页需要的形状，与请求逻辑解耦。
+export function filterResult(result: ProblemListItem): ProblemFiltered {
+  return {
     id: result.id,
     _id: result._id,
     title: result.title,
     difficulty: DIFFICULTY[result.difficulty],
     tags: result.tags,
-    submission: result.submission_number,
-    rate: getACRate(result.accepted_number, result.submission_number),
-    status: "",
-    author: result.created_by.username,
-    allow_flowchart: result.allow_flowchart,
-    show_flowchart: result.show_flowchart,
-    has_ast_rules: result.has_ast_rules,
+    submission: result.submissionNumber,
+    rate: getACRate(result.acceptedNumber, result.submissionNumber),
+    // null / undefined 都表示「没做过」
+    status:
+      result.myStatus === null || result.myStatus === undefined
+        ? "not_test"
+        : result.myStatus === 0
+          ? "passed"
+          : "failed",
+    author: result.createdBy.username,
+    allowFlowchart: result.allowFlowchart,
+    showFlowchart: result.showFlowchart,
+    hasAstRules: result.hasAstRules,
   }
-  if (result.my_status === null || result.my_status === undefined) {
-    newResult.status = "not_test"
-  } else if (result.my_status === 0) {
-    newResult.status = "passed"
-  } else {
-    newResult.status = "failed"
-  }
-  return newResult
 }
diff --git a/apps/web/src/oj/user/index.vue b/apps/web/src/oj/user/index.vue
index 6898961..4b19ea7 100644
--- a/apps/web/src/oj/user/index.vue
+++ b/apps/web/src/oj/user/index.vue
@@ -64,7 +64,7 @@ async function init() {
   try {
     const res = await getProfile(route.query.name as string)
     profile.value = res.data
-    const acm = res.data.acm_problems_status.problems || {}
+    const acm = res.data!.acmProblemsStatus.problems || {}
     const ac: string[] = []
     Object.keys(acm).forEach((id) => {
       if (acm[id]["status"] === 0) {
@@ -74,7 +74,7 @@ async function init() {
     ac.sort()
     problems.value = ac
 
-    if (profile.value.submission_number > 0) {
+    if (profile.value.submissionNumber > 0) {
       const metricsRes = await getMetrics(profile.value.user.id)
       firstSubmissionAt.value = parseTime(metricsRes.data.first)
       latestSubmissionAt.value = parseTime(metricsRes.data.latest)
@@ -130,13 +130,13 @@ const metrics = computed(() => {
     },
     {
       icon: "fluent-emoji:candy",
-      title: profile.value?.accepted_number ?? 0,
+      title: profile.value?.acceptedNumber ?? 0,
       content: "已解决的题目数量",
       animate: true,
     },
     {
       icon: "fluent-emoji:thinking-face",
-      title: profile.value?.submission_number ?? 0,
+      title: profile.value?.submissionNumber ?? 0,
       content: "总提交数量",
       animate: true,
     },
@@ -186,7 +186,7 @@ onMounted(() => {
   </n-flex>
 
   <n-grid
-    v-if="profile && profile.submission_number > 0"
+    v-if="profile && profile.submissionNumber > 0"
     class="wrapper"
     :cols="isDesktop ? 2 : 1"
     :x-gap="10"
diff --git a/apps/web/src/oj/user/message.vue b/apps/web/src/oj/user/message.vue
index 02997b6..b042b79 100644
--- a/apps/web/src/oj/user/message.vue
+++ b/apps/web/src/oj/user/message.vue
@@ -8,7 +8,7 @@
       <n-flex size="large" vertical>
         <n-flex align="center">
           <div>发送时间</div>
-          <div>{{ parseTime(item.create_time, "YYYY年M月D日 HH:mm:ss") }}</div>
+          <div>{{ parseTime(item.createTime, "YYYY年M月D日 HH:mm:ss") }}</div>
           <div>发送者</div>
           <div>{{ item.sender.username }}</div>
         </n-flex>
diff --git a/apps/web/src/oj/user/setting.vue b/apps/web/src/oj/user/setting.vue
index 06be145..42bae46 100644
--- a/apps/web/src/oj/user/setting.vue
+++ b/apps/web/src/oj/user/setting.vue
@@ -30,7 +30,7 @@ async function upload({ file }: UploadCustomRequestOptions) {
 async function saveProfile() {
   try {
     await updateProfile({
-      real_name: userStore.profile?.real_name ?? "",
+      realName: userStore.profile?.realName ?? "",
       mood: userStore.profile?.mood ?? "",
     })
     message.success("更改成功")
@@ -55,7 +55,7 @@ async function saveProfile() {
         </n-upload>
       </n-form-item>
       <!-- <n-form-item label="真名">
-        <n-input v-model:value="userStore.profile.real_name" />
+        <n-input v-model:value="userStore.profile.realName" />
       </n-form-item> -->
       <n-form-item label="个性签名">
         <n-input v-model:value="userStore.profile.mood" />
diff --git a/apps/web/src/shared/api.ts b/apps/web/src/shared/api.ts
index 7f3997c..e82b542 100644
--- a/apps/web/src/shared/api.ts
+++ b/apps/web/src/shared/api.ts
@@ -1,6 +1,6 @@
 import { userProfileSchema } from "@oj2/contract"
 import api2 from "utils/api2"
-import type { ApiResponse } from "utils/http"
+import type { ApiResponse } from "utils/api2"
 import type { Profile, Tag } from "utils/types"
 
 export function login(data: { username: string; password: string }) {
@@ -26,37 +26,10 @@ export async function getProfile(
     username ? `profiles/${encodeURIComponent(username)}` : "me",
   )
   if (response.data === null) return { error: null, data: null }
-  const profile = userProfileSchema.parse(response.data)
+  // 形状与契约一致，不再逐字段搬运；zod 解析仍保留，形状对不上要当场炸
   return {
     error: null,
-    data: {
-      id: profile.id,
-      user: {
-        id: profile.user.id,
-        username: profile.user.username,
-        real_name: profile.realName ?? "",
-        email: profile.user.email ?? "",
-        admin_type: profile.user.adminType as Profile["user"]["admin_type"],
-        problem_permission: profile.user.problemPermission,
-        create_time: profile.user.createTime as unknown as Date,
-        last_login: profile.user.lastLogin as unknown as Date,
-        open_api: profile.user.openApi,
-        is_disabled: profile.user.isDisabled,
-        class_name: profile.user.className,
-      },
-      real_name: profile.realName ?? "",
-      acm_problems_status:
-        profile.acmProblemsStatus as Profile["acm_problems_status"],
-      avatar: profile.avatar,
-      blog: profile.blog as null,
-      mood: profile.mood ?? "",
-      github: profile.github ?? "",
-      school: profile.school ?? "",
-      major: profile.major ?? "",
-      language: profile.language ?? "",
-      accepted_number: profile.acceptedNumber,
-      submission_number: profile.submissionNumber,
-    },
+    data: userProfileSchema.parse(response.data) as Profile,
   }
 }
 
diff --git a/apps/web/src/shared/components/AuthorSelect.vue b/apps/web/src/shared/components/AuthorSelect.vue
index e2b2345..e6f5551 100644
--- a/apps/web/src/shared/components/AuthorSelect.vue
+++ b/apps/web/src/shared/components/AuthorSelect.vue
@@ -24,12 +24,10 @@ const authorOptions = ref([{ label: "全部", value: "" }])
 async function getAuthorOptions() {
   authorOptions.value = [{ label: "全部", value: "" }]
   const res = await getAuthors(all)
-  const remotes = res.data.map(
-    (item: { username: string; problem_count: number }) => ({
-      label: `${item.username} (${item.problem_count})`,
-      value: item.username,
-    }),
-  )
+  const remotes = res.data.map((item) => ({
+    label: `${item.username} (${item.problemCount})`,
+    value: item.username,
+  }))
   authorOptions.value = [...authorOptions.value, ...remotes]
 }
 </script>
diff --git a/apps/web/src/shared/components/ContestTitle.vue b/apps/web/src/shared/components/ContestTitle.vue
index ba70df9..47f8a26 100644
--- a/apps/web/src/shared/components/ContestTitle.vue
+++ b/apps/web/src/shared/components/ContestTitle.vue
@@ -1,14 +1,14 @@
 <script setup lang="ts">
 import { Icon } from "@iconify/vue"
 import { ContestType } from "utils/constants"
-import type { Contest } from "utils/types"
+import type { Contest, OjContest } from "utils/types"
 
-defineProps<{ contest: Contest }>()
+defineProps<{ contest: Contest | OjContest }>()
 </script>
 <template>
   <n-flex>
     <Icon
-      v-if="contest.contest_type === ContestType.private"
+      v-if="contest.contestType === ContestType.private"
       :height="24"
       icon="streamline-ultimate-color:shield-lock"
     ></Icon>
diff --git a/apps/web/src/shared/components/ContestType.vue b/apps/web/src/shared/components/ContestType.vue
index c2a98dc..8056805 100644
--- a/apps/web/src/shared/components/ContestType.vue
+++ b/apps/web/src/shared/components/ContestType.vue
@@ -1,16 +1,16 @@
 <script setup lang="ts">
 import { ContestType } from "utils/constants"
-import type { Contest } from "utils/types"
+import type { Contest, OjContest } from "utils/types"
 
 interface Props {
-  contest: Contest
+  contest: Contest | OjContest
   size?: "small"
 }
 
 const props = defineProps<Props>()
 
 const isPrivate = computed(
-  () => props.contest.contest_type === ContestType.private,
+  () => props.contest.contestType === ContestType.private,
 )
 </script>
 
diff --git a/apps/web/src/shared/components/Header.vue b/apps/web/src/shared/components/Header.vue
index 4e4db69..cefa154 100644
--- a/apps/web/src/shared/components/Header.vue
+++ b/apps/web/src/shared/components/Header.vue
@@ -278,7 +278,7 @@ function handleMenuSelect(key: string) {
     <n-flex align="center">
       <n-flex align="center" class="title" @click="goHome">
         <Icon icon="streamline-emojis:dog" :height="30"></Icon>
-        <div>{{ configStore.config?.website_name }}</div>
+        <div>{{ configStore.config?.websiteName }}</div>
         <div v-if="showEnvVersion">({{ envVersion }})</div>
       </n-flex>
       <div>
@@ -331,7 +331,7 @@ function handleMenuSelect(key: string) {
           </n-button>
           <n-button
             tertiary
-            v-if="configStore.config?.allow_register"
+            v-if="configStore.config?.allowRegister"
             @click="authStore.openSignupModal()"
           >
             注册
diff --git a/apps/web/src/shared/components/Login.vue b/apps/web/src/shared/components/Login.vue
index 2d3922f..2a0f197 100644
--- a/apps/web/src/shared/components/Login.vue
+++ b/apps/web/src/shared/components/Login.vue
@@ -22,7 +22,7 @@ const isClassLogin = computed(() => Boolean(form.value.class))
 const classList = computed<SelectOption[]>(() => {
   const defaults = [{ label: "没有我所在的班级", value: "" }]
   const configs =
-    configStore.config?.class_list.map((item) => ({
+    configStore.config?.classList.map((item) => ({
       label: `${item.slice(0, 2)}计算机${item.slice(2)}班`,
       value: `ks${item}`,
     })) ?? []
@@ -53,9 +53,10 @@ async function submit() {
         }
         await login(merged)
       } catch (err: any) {
-        if (err.data === "Your account has been disabled") {
+        // 判错误码而不是错误文案：文案在后端，改一个字这里就静默掉进「无法登录」
+        if (err.error === "account-disabled") {
           authStore.setLoginError("此账号已被封禁")
-        } else if (err.data === "Invalid username or password") {
+        } else if (err.error === "invalid-credentials") {
           authStore.setLoginError("用户名或密码不正确")
         } else {
           authStore.setLoginError("无法登录")
@@ -177,12 +178,12 @@ onMounted(() => {
             :loading="isLoading"
             @click="submit"
             :style="{
-              flex: configStore.config?.allow_register ? '0 0 auto' : '1',
+              flex: configStore.config?.allowRegister ? '0 0 auto' : '1',
             }"
           >
             登录
           </n-button>
-          <n-button v-if="configStore.config?.allow_register" @click="goSignup">
+          <n-button v-if="configStore.config?.allowRegister" @click="goSignup">
             没有账号？立即注册
           </n-button>
         </n-flex>
diff --git a/apps/web/src/shared/components/LoginSummaryModal.vue b/apps/web/src/shared/components/LoginSummaryModal.vue
index be3083b..de5fa6b 100644
--- a/apps/web/src/shared/components/LoginSummaryModal.vue
+++ b/apps/web/src/shared/components/LoginSummaryModal.vue
@@ -33,33 +33,31 @@ const hasAnalysis = computed(() => !!loginSummaryStore.analysis)
           <n-gi>
             <n-statistic
               label="新增题目"
-              :value="loginSummaryStore.summary?.new_problem_count ?? 0"
+              :value="loginSummaryStore.summary?.newProblemCount ?? 0"
             />
           </n-gi>
           <n-gi>
             <n-statistic
               label="提交次数"
-              :value="loginSummaryStore.summary?.submission_count ?? 0"
+              :value="loginSummaryStore.summary?.submissionCount ?? 0"
             />
           </n-gi>
           <n-gi>
             <n-statistic
               label="AC 次数"
-              :value="loginSummaryStore.summary?.accepted_count ?? 0"
+              :value="loginSummaryStore.summary?.acceptedCount ?? 0"
             />
           </n-gi>
           <n-gi>
             <n-statistic
               label="AC 题目数"
-              :value="loginSummaryStore.summary?.solved_count ?? 0"
+              :value="loginSummaryStore.summary?.solvedCount ?? 0"
             />
           </n-gi>
           <n-gi>
             <n-statistic
               label="流程图提交"
-              :value="
-                loginSummaryStore.summary?.flowchart_submission_count ?? 0
-              "
+              :value="loginSummaryStore.summary?.flowchartSubmissionCount ?? 0"
             />
           </n-gi>
         </n-grid>
diff --git a/apps/web/src/shared/components/Signup.vue b/apps/web/src/shared/components/Signup.vue
index 99c3ce3..c68600d 100644
--- a/apps/web/src/shared/components/Signup.vue
+++ b/apps/web/src/shared/components/Signup.vue
@@ -48,9 +48,9 @@ function submit() {
           password: form.value.password,
         })
       } catch (err: any) {
-        if (err.data === "Username already exists") {
+        if (err.error === "username-exists") {
           authStore.setSignupError("用户名已存在")
-        } else if (err.data === "Email already exists") {
+        } else if (err.error === "email-exists") {
           authStore.setSignupError("邮箱已存在")
         } else {
           authStore.setSignupError("无法注册")
diff --git a/apps/web/src/shared/components/UserBadge.vue b/apps/web/src/shared/components/UserBadge.vue
index 9688acb..3122934 100644
--- a/apps/web/src/shared/components/UserBadge.vue
+++ b/apps/web/src/shared/components/UserBadge.vue
@@ -15,7 +15,7 @@
         <n-text strong>{{ badge.badge.name }}</n-text>
         <n-tag type="info"> 获得条件：{{ getConditionText() }} </n-tag>
         <n-text depth="3">
-          获得时间：{{ parseTime(badge.earned_time, "YYYY-MM-DD HH:mm:ss") }}
+          获得时间：{{ parseTime(badge.earnedTime, "YYYY-MM-DD HH:mm:ss") }}
         </n-text>
       </n-flex>
     </n-card>
@@ -38,15 +38,15 @@ function handleImageError(event: Event) {
 }
 
 function getConditionText() {
-  const { condition_type, condition_value } = props.badge.badge
+  const { conditionType, conditionValue } = props.badge.badge
 
-  switch (condition_type) {
+  switch (conditionType) {
     case "all_problems":
       return "完成所有题目"
     case "problem_count":
-      return `完成 ${condition_value} 道题目`
+      return `完成 ${conditionValue} 道题目`
     case "score":
-      return `获得 ${condition_value} 分`
+      return `获得 ${conditionValue} 分`
     default:
       return "未知条件"
   }
diff --git a/apps/web/src/shared/composables/maxkb.ts b/apps/web/src/shared/composables/maxkb.ts
index a84f909..d6d70df 100644
--- a/apps/web/src/shared/composables/maxkb.ts
+++ b/apps/web/src/shared/composables/maxkb.ts
@@ -38,9 +38,9 @@ export function useMaxKB() {
   )
 
   const loadMaxKBScript = () => {
-    const { enable_maxkb } = configStore.config
+    const { enableMaxkb } = configStore.config
 
-    if (!enable_maxkb) {
+    if (!enableMaxkb) {
       return
     }
 
@@ -113,7 +113,7 @@ export function useMaxKB() {
   })
 
   watch(
-    () => configStore.config.enable_maxkb,
+    () => configStore.config.enableMaxkb,
     (enabled) => {
       if (enabled) {
         loadMaxKBScript()
diff --git a/apps/web/src/shared/extensions/autocompletion.ts b/apps/web/src/shared/extensions/autocompletion.ts
index ba77d68..7b7081a 100644
--- a/apps/web/src/shared/extensions/autocompletion.ts
+++ b/apps/web/src/shared/extensions/autocompletion.ts
@@ -25,7 +25,7 @@ const chineseAnnotations: Record<string, ChineseCompletion[]> = {
 
 // SQL 题：当前题目的表名和字段名补全，数据来自 sql_display
 function sqlSchemaCompletions(): Completion[] {
-  const tables = useProblemStore().problem?.sql_display?.tables ?? []
+  const tables = useProblemStore().problem?.sqlDisplay?.tables ?? []
   return tables.flatMap((table) => [
     {
       label: table.name,
diff --git a/apps/web/src/shared/store/achievement.ts b/apps/web/src/shared/store/achievement.ts
index 75086d5..a563dc9 100644
--- a/apps/web/src/shared/store/achievement.ts
+++ b/apps/web/src/shared/store/achievement.ts
@@ -2,7 +2,7 @@ import {
   getPendingAchievements,
   markAchievementsRead,
 } from "oj/achievement/api"
-import type { PendingAchievement } from "utils/types"
+import type { QueuedAchievement } from "utils/types"
 
 /**
  * 成就解锁弹窗队列。
@@ -15,16 +15,16 @@ import type { PendingAchievement } from "utils/types"
  * 才建连，纯推会丢消息（尤其是题单奖章，那些页面根本没建连接）。
  */
 export const useAchievementStore = defineStore("achievement", () => {
-  const queue = ref<PendingAchievement[]>([])
-  const current = ref<PendingAchievement | null>(null)
+  const queue = ref<QueuedAchievement[]>([])
+  const current = ref<QueuedAchievement | null>(null)
 
   // 成就和题单奖章的 id 来自两张不同的表，数值会重叠，
   // 只按 id 去重会让奖章 5 把成就 5 挤掉
-  function keyOf(item: PendingAchievement) {
+  function keyOf(item: QueuedAchievement) {
     return `${item.kind ?? "achievement"}:${item.id}`
   }
 
-  function enqueue(items: PendingAchievement[]) {
+  function enqueue(items: QueuedAchievement[]) {
     if (!items?.length) return
     // 去重：WebSocket 推来的和 pending 拉来的可能是同一批
     const known = new Set([
@@ -49,7 +49,7 @@ export const useAchievementStore = defineStore("achievement", () => {
     return current.value
   }
 
-  async function markRead(item: PendingAchievement) {
+  async function markRead(item: QueuedAchievement) {
     // 奖章不在 UserAchievement 表里，它的 id 传给标记接口会被当成成就 id，
     // 把一个恰好同号、还没弹过的成就静默标记为已弹——那个奖杯就再也不会出现
     if (item.kind === "badge") return
diff --git a/apps/web/src/shared/store/config.ts b/apps/web/src/shared/store/config.ts
index b317895..eae5aa8 100644
--- a/apps/web/src/shared/store/config.ts
+++ b/apps/web/src/shared/store/config.ts
@@ -3,19 +3,19 @@ import type { WebsiteConfig } from "utils/types"
 
 export const useConfigStore = defineStore("config", () => {
   const config = ref<WebsiteConfig>({
-    website_base_url: "",
-    website_name: "",
-    website_name_shortcut: "",
-    website_footer: "",
-    submission_list_show_all: true,
-    allow_register: false,
-    class_list: [],
-    enable_maxkb: true,
+    websiteBaseUrl: "",
+    websiteName: "",
+    websiteNameShortcut: "",
+    websiteFooter: "",
+    submissionListShowAll: true,
+    allowRegister: false,
+    classList: [],
+    enableMaxkb: true,
   })
   async function getConfig() {
     const res = await getWebsiteConfig()
     config.value = res.data
-    document.title = res.data.website_name
+    document.title = res.data.websiteName
   }
   return {
     config,
diff --git a/apps/web/src/shared/store/loginSummary.ts b/apps/web/src/shared/store/loginSummary.ts
index 36c1cad..1a5ff05 100644
--- a/apps/web/src/shared/store/loginSummary.ts
+++ b/apps/web/src/shared/store/loginSummary.ts
@@ -1,14 +1,7 @@
+import type { LoginSummary as ContractLoginSummary } from "@oj2/contract"
 import { getAILoginSummary } from "oj/api"
 
-interface LoginSummary {
-  start: string
-  end: string
-  new_problem_count: number
-  submission_count: number
-  accepted_count: number
-  solved_count: number
-  flowchart_submission_count: number
-}
+type LoginSummary = ContractLoginSummary["summary"]
 
 export const useLoginSummaryStore = defineStore("loginSummary", () => {
   const show = ref(false)
@@ -22,11 +15,11 @@ export const useLoginSummaryStore = defineStore("loginSummary", () => {
       return false
     }
     const values = [
-      nextSummary.new_problem_count,
-      nextSummary.submission_count,
-      nextSummary.accepted_count,
-      nextSummary.solved_count,
-      nextSummary.flowchart_submission_count,
+      nextSummary.newProblemCount,
+      nextSummary.submissionCount,
+      nextSummary.acceptedCount,
+      nextSummary.solvedCount,
+      nextSummary.flowchartSubmissionCount,
     ]
     const zeroCount = values.filter((value) => value === 0).length
     return zeroCount < Math.floor(values.length / 2) + 1
@@ -40,7 +33,7 @@ export const useLoginSummaryStore = defineStore("loginSummary", () => {
       const res = await getAILoginSummary()
       summary.value = res.data.summary
       analysis.value = res.data.analysis || ""
-      analysisError.value = res.data.analysis_error || ""
+      analysisError.value = res.data.analysisError || ""
     } catch (err) {
       analysisError.value = "获取登录统计失败，请稍后再试"
     } finally {
diff --git a/apps/web/src/shared/store/user.ts b/apps/web/src/shared/store/user.ts
index f19c39d..4936dad 100644
--- a/apps/web/src/shared/store/user.ts
+++ b/apps/web/src/shared/store/user.ts
@@ -1,6 +1,6 @@
 import { PROBLEM_PERMISSION, STORAGE_KEY, USER_TYPE } from "utils/constants"
 import storage from "utils/storage"
-import type { Profile, User } from "utils/types"
+import type { Profile, SessionUser } from "utils/types"
 import { getProfile } from "../api"
 import { useConfigStore } from "./config"
 
@@ -9,7 +9,7 @@ export const useUserStore = defineStore("user", () => {
 
   const profile = ref<Profile | null>(null)
   const [isFinished] = useToggle(false)
-  const user = computed<User | null>(() => profile.value?.user ?? null)
+  const user = computed<SessionUser | null>(() => profile.value?.user ?? null)
   const isAuthed = computed(() => !!user.value?.email)
 
   // 演示模式：超管临时把界面伪装成普通学生，方便上课投屏
@@ -18,33 +18,33 @@ export const useUserStore = defineStore("user", () => {
   // 不受伪装影响的真实身份，只用于判断能否切换演示模式。
   // 若这里用被伪装后的 isSuperAdmin，一进入演示模式入口就消失了，退不出来。
   const realIsSuperAdmin = computed(
-    () => user.value?.admin_type === USER_TYPE.SUPER_ADMIN,
+    () => user.value?.adminType === USER_TYPE.SUPER_ADMIN,
   )
 
   const isAdminRole = computed(
     () =>
       !demoMode.value &&
-      (user.value?.admin_type === USER_TYPE.STUDENT_ADMIN ||
-        user.value?.admin_type === USER_TYPE.TEACHER_ADMIN ||
-        user.value?.admin_type === USER_TYPE.SUPER_ADMIN),
+      (user.value?.adminType === USER_TYPE.STUDENT_ADMIN ||
+        user.value?.adminType === USER_TYPE.TEACHER_ADMIN ||
+        user.value?.adminType === USER_TYPE.SUPER_ADMIN),
   )
   const isStudentAdmin = computed(
-    () => !demoMode.value && user.value?.admin_type === USER_TYPE.STUDENT_ADMIN,
+    () => !demoMode.value && user.value?.adminType === USER_TYPE.STUDENT_ADMIN,
   )
   const isTeacherAdmin = computed(
-    () => !demoMode.value && user.value?.admin_type === USER_TYPE.TEACHER_ADMIN,
+    () => !demoMode.value && user.value?.adminType === USER_TYPE.TEACHER_ADMIN,
   )
   const isTeacherOrAbove = computed(
     () =>
       !demoMode.value &&
-      (user.value?.admin_type === USER_TYPE.TEACHER_ADMIN ||
-        user.value?.admin_type === USER_TYPE.SUPER_ADMIN),
+      (user.value?.adminType === USER_TYPE.TEACHER_ADMIN ||
+        user.value?.adminType === USER_TYPE.SUPER_ADMIN),
   )
   const isSuperAdmin = computed(() => !demoMode.value && realIsSuperAdmin.value)
   const hasProblemPermission = computed(
     () =>
       !demoMode.value &&
-      user.value?.problem_permission !== PROBLEM_PERMISSION.NONE,
+      user.value?.problemPermission !== PROBLEM_PERMISSION.NONE,
   )
 
   const canToggleDemoMode = computed(() => realIsSuperAdmin.value)
@@ -55,7 +55,7 @@ export const useUserStore = defineStore("user", () => {
   }
 
   const showSubmissions = computed(() => {
-    let flag = configStore.config.submission_list_show_all
+    let flag = configStore.config.submissionListShowAll
     if (isAdminRole.value) flag = true
     return flag
   })
diff --git a/apps/web/src/utils/api2.ts b/apps/web/src/utils/api2.ts
index 761b026..8749b5c 100644
--- a/apps/web/src/utils/api2.ts
+++ b/apps/web/src/utils/api2.ts
@@ -2,11 +2,17 @@ import axios, { type AxiosRequestConfig } from "axios"
 import { createDiscreteApi } from "naive-ui"
 import { useAuthModalStore } from "shared/store/authModal"
 import { STORAGE_KEY } from "./constants"
-import type { ApiResponse } from "./http"
 import storage from "./storage"
 
 const { message: toast } = createDiscreteApi(["message"])
 
+// 后端统一返回 { error, data } 信封；拦截器剥掉 axios 外层后，
+// 调用方拿到的就是这个信封，data 才是真正的业务数据。
+export interface ApiResponse<T = any> {
+  error: string | null
+  data: T
+}
+
 interface Api2Error {
   error?: {
     code?: string
@@ -51,15 +57,10 @@ instance.interceptors.response.use(
     const payload = error.response?.data as Api2Error | undefined
     const code = payload?.error?.code ?? "network-error"
     const message = payload?.error?.message ?? "Request failed"
-    const legacyMessage =
-      code === "invalid-credentials"
-        ? "Invalid username or password"
-        : code === "account-disabled"
-          ? "Your account has been disabled"
-          : message
 
-    // 与 utils/http.ts 的拦截器保持一致：这两种错误全站都是同样的处理，
-    // 不放在这里的话每个调用点都得自己 catch，漏一个就是「点了没反应」。
+    // 这几种错误全站都是同样的处理，不放在这里的话每个调用点都得自己 catch，
+    // 漏一个就是「点了没反应」。需要分支处理的调用方一律判 `err.error` 里的
+    // 错误码，**不要**去 match `err.data` 的文案 —— 文案是后端可以随时改的。
     if (code === "login-required") {
       storage.remove(STORAGE_KEY.AUTHED)
       useAuthModalStore().openLoginModal()
@@ -68,12 +69,12 @@ instance.interceptors.response.use(
       // 学生会陷入「弹框 → 登录 → 又弹框」的死循环，且看不出发生了什么。
       // 清掉登录态并明确告知，会话在中途被禁用时也走这一支。
       storage.remove(STORAGE_KEY.AUTHED)
-      toast.error(legacyMessage || "账号已被禁用，请联系老师")
+      toast.error("账号已被禁用，请联系老师")
     } else if (code === "permission-denied") {
-      toast.error(legacyMessage || "权限不足")
+      toast.error(message || "权限不足")
     }
 
-    return Promise.reject({ error: code, data: legacyMessage })
+    return Promise.reject({ error: code, data: message })
   },
 )
 
diff --git a/apps/web/src/utils/constants.ts b/apps/web/src/utils/constants.ts
index fe0b84c..46d1641 100644
--- a/apps/web/src/utils/constants.ts
+++ b/apps/web/src/utils/constants.ts
@@ -1,16 +1,22 @@
 import type { AchievementRarity, SUBMISSION_RESULT, ReactionKey } from "./types"
 
+// 与后端 judge/status.ts 的 JudgeStatus 逐条对齐（submitting 除外，见下）。
+// 注意：原来 time_limit_exceeded 写成 `1 | 2`，TS 按位或算成 3，和
+// memory_limit_exceeded 撞了同一个值 —— 后端这两个是分开的两个码。
 export enum SubmissionStatus {
   compile_error = -2,
   wrong_answer = -1,
   accepted = 0,
-  time_limit_exceeded = 1 | 2,
+  cpu_time_limit_exceeded = 1,
+  real_time_limit_exceeded = 2,
   memory_limit_exceeded = 3,
   runtime_error = 4,
   system_error = 5,
   pending = 6,
   judging = 7,
   partial_accepted = 8,
+  // 前端自造的伪状态：点了提交、还没拿到判题结果时本地先填 9。
+  // 后端永远不会下发它，所以契约的 judgeStatusSchema 里没有。
   submitting = 9,
   ast_check_failed = 10,
 }
@@ -157,7 +163,7 @@ export const DIFFICULTY = {
   Low: "简单",
   Mid: "中等",
   High: "困难",
-}
+} as const
 
 const cSource =
   "#include<stdio.h>\r\n\r\nint main()\r\n{\r\n    \r\n    return 0;\r\n}"
diff --git a/apps/web/src/utils/functions.ts b/apps/web/src/utils/functions.ts
index 3ec9c7d..f9f3047 100644
--- a/apps/web/src/utils/functions.ts
+++ b/apps/web/src/utils/functions.ts
@@ -139,7 +139,7 @@ export function debounce<T extends (...args: any[]) => any>(
   }
 }
 
-export function getUserRole(role: User["admin_type"]): {
+export function getUserRole(role: User["adminType"]): {
   type: "default" | "info" | "warning" | "error"
   label: "普通" | "学生管理员" | "教师管理员" | "超管"
 } {
diff --git a/apps/web/src/utils/http.ts b/apps/web/src/utils/http.ts
deleted file mode 100644
index 40d90be..0000000
--- a/apps/web/src/utils/http.ts
+++ /dev/null
@@ -1,79 +0,0 @@
-import axios, { type AxiosRequestConfig } from "axios"
-import { createDiscreteApi } from "naive-ui"
-import { useAuthModalStore } from "shared/store/authModal"
-import storage from "./storage"
-import { STORAGE_KEY } from "./constants"
-
-const { message } = createDiscreteApi(["message"])
-
-// 后端统一返回 { error, data } 信封；拦截器剥掉 axios 外层后，
-// 调用方拿到的就是这个信封，data 才是真正的业务数据。
-export interface ApiResponse<T = any> {
-  error: string | null
-  data: T
-}
-
-// 让 http.get<T>() 的类型真实反映"解包后返回信封"这件事，
-// 调用方 res.data 直接拿到带类型的 T，不再依赖 axios 的 AxiosResponse 巧合对齐。
-interface Http {
-  get<T = any>(
-    url: string,
-    config?: AxiosRequestConfig,
-  ): Promise<ApiResponse<T>>
-  delete<T = any>(
-    url: string,
-    config?: AxiosRequestConfig,
-  ): Promise<ApiResponse<T>>
-  post<T = any>(
-    url: string,
-    data?: unknown,
-    config?: AxiosRequestConfig,
-  ): Promise<ApiResponse<T>>
-  put<T = any>(
-    url: string,
-    data?: unknown,
-    config?: AxiosRequestConfig,
-  ): Promise<ApiResponse<T>>
-}
-
-const instance = axios.create({
-  baseURL: "/api",
-  xsrfHeaderName: "X-CSRFToken",
-  xsrfCookieName: "csrftoken",
-})
-
-// 统一剥掉空字符串 / null / undefined 的 query 参数，
-// 各 api 函数不必再手写过滤逻辑（保留 0、false）。
-instance.interceptors.request.use((config) => {
-  if (config.params) {
-    config.params = Object.fromEntries(
-      Object.entries(config.params).filter(
-        ([, v]) => v !== "" && v !== null && v !== undefined,
-      ),
-    )
-  }
-  return config
-})
-
-instance.interceptors.response.use(
-  (res) => {
-    if (res.data.error) {
-      if (res.data.error === "login-required") {
-        storage.remove(STORAGE_KEY.AUTHED)
-        useAuthModalStore().openLoginModal()
-      } else if (res.data.error === "permission-denied") {
-        message.error(res.data.data || "权限不足")
-      }
-      return Promise.reject(res.data)
-    } else {
-      return Promise.resolve(res.data)
-    }
-  },
-  (err) => {
-    return Promise.reject(err)
-  },
-)
-
-const http = instance as unknown as Http
-
-export default http
diff --git a/apps/web/src/utils/legacy.ts b/apps/web/src/utils/legacy.ts
deleted file mode 100644
index a1e0c46..0000000
--- a/apps/web/src/utils/legacy.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-import type { ApiResponse } from "./http"
-
-/**
- * 新后端一律 camelCase，而现存组件读的都是旧 Django 的 snake_case。
- * 迁移期在 api 层做一次键名转换，组件不动 —— 否则每搬一个端点就要顺带改一堆 .vue，
- * 改动面大到没法一个个验。
- *
- * 迁移完成后这一层应当整体拆掉，届时组件改成 camelCase 是一次性的机械替换。
- */
-function snakeKey(key: string) {
-  return key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
-}
-
-export function toLegacy<T>(value: unknown): T {
-  if (Array.isArray(value)) return value.map((item) => toLegacy(item)) as T
-  if (!value || typeof value !== "object") return value as T
-  return Object.fromEntries(
-    Object.entries(value).map(([key, item]) => [snakeKey(key), toLegacy(item)]),
-  ) as T
-}
-
-export async function legacyResponse<T>(
-  request: Promise<ApiResponse<unknown>>,
-): Promise<ApiResponse<T>> {
-  const response = await request
-  return { error: response.error, data: toLegacy<T>(response.data) }
-}
diff --git a/apps/web/src/utils/permissions.ts b/apps/web/src/utils/permissions.ts
index 861529d..34921e6 100644
--- a/apps/web/src/utils/permissions.ts
+++ b/apps/web/src/utils/permissions.ts
@@ -23,11 +23,11 @@ export function usePermissions() {
 
     canManageAllProblems: computed(
       () =>
-        userStore.user?.problem_permission === "All" || userStore.isSuperAdmin,
+        userStore.user?.problemPermission === "All" || userStore.isSuperAdmin,
     ),
     canManageOwnProblems: computed(
       () =>
-        userStore.user?.problem_permission === "Own" && !userStore.isSuperAdmin,
+        userStore.user?.problemPermission === "Own" && !userStore.isSuperAdmin,
     ),
 
     getUserPermissionLevel: computed(() => {
@@ -39,7 +39,7 @@ export function usePermissions() {
 
     getProblemPermissionLevel: computed(() => {
       if (!userStore.user) return "无权限"
-      switch (userStore.user.problem_permission) {
+      switch (userStore.user.problemPermission) {
         case "All":
           return "管理所有题目"
         case "Own":
diff --git a/apps/web/src/utils/types.ts b/apps/web/src/utils/types.ts
index 4ab9426..b8bd6d8 100644
--- a/apps/web/src/utils/types.ts
+++ b/apps/web/src/utils/types.ts
@@ -1,45 +1,47 @@
-import { ContestStatus, ContestType, LANGUAGE_SHOW_VALUE } from "./constants"
+import { LANGUAGE_SHOW_VALUE } from "./constants"
+import type {
+  AdminProblem as ContractAdminProblem,
+  SubmissionDetail,
+  SubmissionListItem as ContractSubmissionListItem,
+  AdminContest,
+  AdminUser,
+  RankProfile,
+  SessionUser,
+  UserProfile,
+  EmbeddedSubmission as ContractEmbeddedSubmission,
+  Grade,
+  ProblemDetail,
+  ProblemDifficulty,
+} from "@oj2/contract"
 
-export interface Profile {
-  id: number
-  user: User
-  real_name: string
-  acm_problems_status: {
-    problems: {
-      [key: string]: {
-        _id: string
-        status: number
-      }
-    }
+/**
+ * 个人主页数据。`acmProblemsStatus` 的**内容**保持 snake_case ——
+ * 它是 user_profile.acm_problems_status 的 JSONB 原文，回滚时旧后端还要读。
+ */
+export type Profile = Omit<UserProfile, "user" | "acmProblemsStatus"> & {
+  user: SessionUser
+  acmProblemsStatus: AcmProblemsStatus
+}
+
+export interface AcmProblemsStatus {
+  problems?: {
+    [key: string]: { _id: string; status: number }
+  }
+  contest_problems?: {
+    [key: string]: { [key: string]: { _id: string; status: number } }
   }
-  avatar: string
-  blog: null
-  mood: string
-  github: string
-  school: string
-  major: string
-  language: string
-  accepted_number: number
-  submission_number: number
 }
 
 export type UserAdminType =
   "Regular User" | "Student Admin" | "Teacher Admin" | "Super Admin"
 
-export interface User {
-  id: number
-  username: string
-  real_name: string
-  email: string
-  admin_type: UserAdminType
-  problem_permission: string
-  create_time: Date
-  last_login: Date
-  open_api: boolean
-  is_disabled: boolean
+/**
+ * 后台用户管理里的用户。`rawPassword` 是明文密码，只有超管专属接口下发 ——
+ * 老师要能查学生密码，见契约 adminUserSchema 的注释。
+ */
+export type User = AdminUser & {
+  // 编辑表单里临时填的新密码，不在响应里
   password?: string
-  raw_password?: string
-  class_name?: string | null
 }
 
 export type LANGUAGE =
@@ -95,7 +97,7 @@ export type ProblemStatus = "passed" | "failed" | "not_test"
 interface SampleUser {
   id: number
   username: string
-  real_name: string | null
+  realName: string | null
 }
 
 export interface Tag {
@@ -103,11 +105,13 @@ export interface Tag {
   name: string
 }
 
-export interface AdminTag {
-  id: number
-  name: string
-  problem_count: number
-}
+export type {
+  AdminTag,
+  RenameTagResponse,
+  BatchProblemTagResponse,
+  SqlTestCaseScript,
+  GenerateSqlTestCaseResponse,
+} from "@oj2/contract"
 
 export interface TestcaseUploadedReturns {
   id: string
@@ -120,88 +124,89 @@ export interface Testcase {
   score: string
 }
 
-export interface Problem {
-  _id: string
-  id: number
-  tags: string[]
-  created_by: SampleUser
+/**
+ * 题目详情。以契约的 ProblemDetail 为准，只在这里补两处前端自己的窄化：
+ * - `languages` / `template` 的键窄化成 LANGUAGE，组件按语言查模板要靠它
+ * - `astRules` / `sqlConfig` / `sqlDisplay` 契约里是 Record<string, unknown>，
+ *   这里给出组件实际读的形状
+ */
+export type Problem = Omit<
+  ProblemDetail,
+  "languages" | "template" | "sqlConfig" | "sqlDisplay"
+> & {
+  languages: LANGUAGE[]
   template: { [key in LANGUAGE]?: string }
-  title: string
-  description: string
-  input_description: string
-  output_description: string
-  samples: {
-    input: string
-    output: string
-  }[]
-  hint: string
-  languages: Array<LANGUAGE>
-  create_time: Date
-  last_update_time: null
-  time_limit: number
-  memory_limit: number
-  difficulty: "Low" | "Mid" | "High"
-  source: string
-  prompt: string
-  answers: { language: LANGUAGE; code: string }[]
-  submission_number: number
-  accepted_number: number
-  statistic_info: { [key: string]: number }
-  share_submission: boolean
-  contest: number
-  my_status: number
-  my_failed_count?: number
-  visible: boolean
-
-  // 流程图相关字段
-  allow_flowchart: boolean
-  mermaid_code?: string
-  flowchart_data?: Record<string, any>
-  flowchart_hint?: string
-  show_flowchart?: boolean
-  ast_rules?: {
-    [key: string]: {
-      engine: string
-      target?: string
-      min?: number
-      max?: number
-      message: string
-    }[]
-  } | null
-  has_ast_rules?: boolean
-
-  // SQL 题配置（非 SQL 题为 null）
-  sql_config?: SQLConfig | null
-
-  // SQL 题展示数据（后端保存题目时自动生成）
-  sql_display?: SQLDisplay | null
+  sqlConfig?: SQLConfig | null
+  sqlDisplay?: SQLDisplay | null
+  astRules?: AstRules | null
+  hasAstRules?: boolean
+  visible?: boolean
+  answers?: { language: LANGUAGE; code: string }[]
 }
 
-export type AdminProblem = Problem &
-  AlterProblem & {
-    // 后台题目列表接口附带的最高票评价，比赛题目列表不返回
-    top_reaction?: { type: ReactionKey; count: number } | null
-  }
+export type AstRules = {
+  [key: string]: {
+    engine: string
+    target?: string
+    min?: number
+    max?: number
+    message: string
+  }[]
+}
 
-interface AlterProblem {
-  test_case_id: string
-  test_case_score: Testcase[]
-  contest_id?: string
+export type {
+  ProblemDetail,
+  ProblemListItem,
+  AdminProblemListItem,
+  AdminProblemList,
+} from "@oj2/contract"
+
+/** 后台题目详情：比 oj 侧多 answers / testCase* / astRules */
+export type AdminProblem = Omit<
+  ContractAdminProblem,
+  | "languages"
+  | "template"
+  | "testCaseScore"
+  | "sqlConfig"
+  | "sqlDisplay"
+  | "samples"
+  | "answers"
+  | "astRules"
+> & {
+  languages: LANGUAGE[]
+  template: { [key in LANGUAGE]?: string }
+  // 测试点条目的键名由判题沙箱定，保持 snake_case
+  testCaseScore: Testcase[]
+  samples: { input: string; output: string }[]
+  answers: { language: LANGUAGE; code: string }[]
+  sqlConfig?: SQLConfig | null
+  sqlDisplay?: SQLDisplay | null
+  astRules?: AstRules | null
 }
 
 type ExcludeKeys =
   | "id"
-  | "created_by"
-  | "create_time"
-  | "last_update_time"
-  | "my_status"
-  | "contest"
-  | "statistic_info"
-  | "accepted_number"
-  | "submission_number"
+  | "createdBy"
+  | "createTime"
+  | "lastUpdateTime"
+  | "statisticInfo"
+  | "acceptedNumber"
+  | "submissionNumber"
+  | "isPublic"
+  | "contestId"
 
-export type BlankProblem = Omit<Problem, ExcludeKeys> &
-  AlterProblem & { id?: number }
+export type BlankProblem = Omit<
+  AdminProblem,
+  ExcludeKeys | "hint" | "mermaidCode"
+> & {
+  id?: number
+  // 新建比赛题时由 detail.vue 在提交前写进来
+  contestId?: number | null
+  // 表单里恒为字符串：初值 ""，从服务器载入时归一化。
+  // v-model 要的是 lvalue，模板里没法 ?? 兜底，所以在类型上就收掉 null
+  hint: string
+  mermaidCode: string
+}
 
 export interface ProblemFiltered {
   _id: string
@@ -213,9 +218,9 @@ export interface ProblemFiltered {
   rate: string
   status: "not_test" | "passed" | "failed"
   author: string
-  allow_flowchart: boolean
-  show_flowchart: boolean
-  has_ast_rules: boolean
+  allowFlowchart: boolean
+  showFlowchart: boolean
+  hasAstRules: boolean
 }
 
 export interface AdminProblemFiltered {
@@ -224,112 +229,35 @@ export interface AdminProblemFiltered {
   title: string
   visible: boolean
   username: string
-  create_time: string
-  difficulty: "Low" | "Mid" | "High"
+  createTime: string
+  difficulty: ProblemDifficulty
   tags: string[]
-  has_ast_rules: boolean
-  allow_flowchart: boolean
-  show_flowchart: boolean
+  hasAstRules: boolean
+  allowFlowchart: boolean
+  showFlowchart: boolean
   // 比赛题目列表接口不返回这个字段
-  top_reaction?: { type: ReactionKey; count: number } | null
+  topReaction?: { type: ReactionKey; count: number } | null
 }
 
 // 题单相关类型
-export interface ProblemSet {
-  id: number
-  title: string
-  description: string
-  created_by: SampleUser
-  create_time: Date
-  difficulty: "Easy" | "Medium" | "Hard"
-  status: "active" | "archived" | "draft"
-  end_time: Date | null
-  visible: boolean
-  problems_count: number
-  completed_count: number
-  user_progress: {
-    is_joined: boolean
-    progress_percentage: number
-    completed_count: number
-    total_count: number
-    is_completed: boolean
-  }
-}
+export type {
+  ProblemSet,
+  ProblemSetList,
+  ProblemSetBadge,
+  ProblemSetProblem,
+  ProblemSetProgress,
+  ProblemSetProgressList,
+  UserBadge,
+} from "@oj2/contract"
 
-export interface ProblemSetList {
-  id: number
-  title: string
-  description: string
-  created_by: SampleUser
-  create_time: Date
-  difficulty: "Easy" | "Medium" | "Hard"
-  status: "active" | "archived" | "draft"
-  end_time: Date | null
-  problems_count: number
-  visible: boolean
-  user_progress: {
-    is_joined: boolean
-    progress_percentage: number
-    completed_count: number
-    total_count: number
-    is_completed: boolean
-  }
-  badges: ProblemSetBadge[]
-}
-
-export interface ProblemSetProblem {
-  id: number
-  problemset: number
-  problem: Problem
-  order: number
-  is_required: boolean
-  score: number
-  hint: string
-  is_completed: boolean
-}
-
-export interface ProblemSetBadge {
-  id: number
-  problemset: number
-  name: string
-  description: string
-  icon: string
-  condition_type: "all_problems" | "problem_count" | "score"
-  condition_value: number
-  is_earned?: boolean
-}
-
-export interface UserBadge {
-  id: number
-  user: number
-  badge: ProblemSetBadge
-  earned_time: Date
-}
-
-export interface CompletedProblem {
-  id: number
-  _id: string
-  title: string
-}
-
-export interface ProblemSetProgress {
-  id: number
-  problemset: ProblemSetList
-  user: SampleUser
-  join_time: Date
-  completed_problems_count: number
-  total_problems_count: number
-  progress_percentage: number
-  is_completed: boolean
-  completed_problems: CompletedProblem[]
-}
+export type { CompletedProblem } from "@oj2/contract"
 
 export interface CreateProblemSetData {
   title: string
   description: string
   difficulty: "Easy" | "Medium" | "Hard"
   status: "active" | "archived" | "draft"
-  end_time?: Date | null
+  endTime?: Date | null
 }
 
 export interface EditProblemSetData {
@@ -338,7 +266,7 @@ export interface EditProblemSetData {
   description?: string
   difficulty?: "Easy" | "Medium" | "Hard"
   status?: "active" | "archived" | "draft"
-  end_time?: Date | null
+  endTime?: Date | null
   visible?: boolean
 }
 
@@ -348,10 +276,10 @@ export interface Code {
 }
 
 export interface SubmitCodePayload {
-  problem_id: number
+  problemId: number
   language: LANGUAGE
   code: string
-  contest_id?: number
+  contestId?: number
 }
 
 // ==================== 流程图相关类型 ====================
@@ -363,47 +291,17 @@ export const FlowchartSubmissionStatus = {
   FAILED: 3, // 评分失败
 } as const
 
-export interface FlowchartSubmission {
-  id: string
-  user: number
-  problem: number
-  mermaid_code: string
-  flowchart_data: Record<string, any>
-  status: number
-  create_time: string
-  ai_score?: number
-  ai_grade?: string
-  ai_feedback?: string
-  ai_suggestions?: string
-  ai_criteria_details: Record<string, any>
-  ai_provider?: string
-  ai_model?: string
-  processing_time?: number
-  evaluation_time?: string
-}
+export type {
+  FlowchartSubmission,
+  FlowchartListItem as FlowchartSubmissionListItem,
+} from "@oj2/contract"
 
-// 列表接口返回的字段（包含 username 和 problem_title）
-export interface FlowchartSubmissionListItem {
-  id: string
-  create_time: string
-  evaluation_time: string
-  ai_score: number
-  ai_grade: Grade
-  ai_model: string
-  ai_provider: string
-  processing_time: number
-  status: number
-  username: string
-  problem_title: string
-  problem: string
-  show_link: boolean
-}
-export interface SubmitFlowchartPayload {
-  problem_id: number
-  mermaid_code: string
-  flowchart_data?: Record<string, any>
-}
+export type { CreateFlowchartRequest as SubmitFlowchartPayload } from "@oj2/contract"
 
+/**
+ * 判题机原始输出。契约里是 `info: z.unknown()` —— 后端不校验沙箱产物，
+ * 这些键名是沙箱定的，**保持 snake_case**，不要跟着响应字段一起改名。
+ */
 interface Info {
   err: string | null
   data: {
@@ -420,53 +318,57 @@ interface Info {
   }[]
 }
 
-export interface Submission {
-  id: string
-  create_time: Date
-  user_id: number
-  username: string
-  code: string
-  result: SUBMISSION_RESULT
-  info: Info
-  language: LANGUAGE
-  shared: boolean
-  show_link: boolean
-  statistic_info: {
-    score?: number
-    err_info?: string
-    time_cost?: number
-    memory_cost?: number
-    ast_results?: Array<{ description: string; passed: boolean }>
-  }
-  ip: string
-  contest: number
-  problem: number // 不是 display_id
-  can_unshare: boolean
+/**
+ * 判题产出的统计。**键名保持 snake_case** —— 这是 submission.statistic_info
+ * JSONB 的原文，判题机写进去、回滚时旧后端还要读，不能跟着响应字段一起改名。
+ */
+export interface StatisticInfo {
+  score?: number
+  err_info?: string
+  time_cost?: number
+  memory_cost?: number
+  ast_results?: Array<{ description: string; passed: boolean }>
 }
 
-export interface SubmissionListItem {
-  id: string
-  problem: string
-  problem_title: string
-  show_link: boolean
-  create_time: string
-  user_id: number
-  username: string
-  result: SUBMISSION_RESULT
+/**
+ * 提交详情。以契约的 SubmissionDetail 为准，只窄化两处 unknown：
+ * `info` 是判题沙箱原始输出，`statisticInfo` 是判题写的 JSONB —— 两者内部都是 snake。
+ */
+export type Submission = Omit<
+  SubmissionDetail,
+  "info" | "statisticInfo" | "language" | "result"
+> & {
+  info: Info
+  statisticInfo: StatisticInfo
+  language: LANGUAGE
+  // 比契约多一个 9：点了提交、还没拿到结果时前端本地先填这个伪状态，
+  // 见 constants.ts 的 SubmissionStatus.submitting
+  result: SUBMISSION_RESULT
+}
+
+/** 站内信里嵌的提交：problem 是展示题号而非数字 id，且不含 info / ip / contestId */
+export type EmbeddedSubmission = Omit<
+  ContractEmbeddedSubmission,
+  "statisticInfo" | "language"
+> & {
+  statisticInfo: StatisticInfo
+  language: LANGUAGE
+}
+
+export type SubmissionListItem = Omit<
+  ContractSubmissionListItem,
+  "statisticInfo" | "language"
+> & {
+  statisticInfo: StatisticInfo
   language: LANGUAGE
-  shared: boolean
-  statistic_info: {
-    time_cost: number
-    memory_cost: number
-  }
 }
 
 export interface SubmissionListPayload {
   myself?: "1" | "0"
   result?: string
   username?: string
-  contest_id?: string
-  problem_id?: string
+  contestId?: string
+  problemId?: string
   language: LANGUAGE | ""
   today?: "1" | "0"
   page: number
@@ -474,59 +376,37 @@ export interface SubmissionListPayload {
   offset: number
 }
 
-export interface Rank {
-  id: number
-  user: SampleUser
-  acm_problems_status: {
-    problems: {
-      [key: string]: {
-        _id: string
-        status: number
-      }
-    }
-    contest_problems?: {
-      [key: string]: {
-        [key: string]: {
-          _id: string
-          status: number
-        }
-      }
-    }
-  }
-  real_name: null | string
-  avatar: string
-  blog: null
-  mood: null | string
-  github: null
-  school: null | string
-  major: null | string
-  language: null | string
-  accepted_number: number
-  submission_number: number
-}
+export type { SessionUser } from "@oj2/contract"
 
-export interface Contest extends BlankContest {
-  id: number
-  created_by: SampleUser
-  status: ContestStatus
-  contest_type: ContestType
-  create_time: string
-  now: string
-  last_update_time: string
-}
+export type Rank = RankProfile
 
-export interface BlankContest {
-  title: string
-  description: string
-  tag: string
-  start_time: string
-  end_time: string
-  password: string
-  visible: boolean
-  allowed_ip_ranges: { value: string }[]
-}
+export type {
+  ClassComparison,
+  ClassRankItem,
+  ClassUserRank,
+} from "@oj2/contract"
 
-interface SubmissionInfo {
+/** 后台比赛。oj 侧的 contestSchema 永远不含 password，后台要能看到（告诉学生） */
+export type Contest = AdminContest
+
+/** 学生侧的比赛：不含 password / visible / allowedIpRanges */
+export type { Contest as OjContest } from "@oj2/contract"
+
+export type BlankContest = Omit<
+  AdminContest,
+  | "id"
+  | "createdBy"
+  | "createTime"
+  | "lastUpdateTime"
+  | "status"
+  | "contestType"
+>
+
+/**
+ * acm_contest_rank.submission_info 的 JSONB 内容。**键名保持 snake_case** ——
+ * 判题写进去、回滚时旧后端还要读，不能跟着响应字段一起改名。
+ */
+export interface SubmissionInfo {
   is_ac: boolean
   ac_time: number
   is_first_ac: boolean
@@ -534,42 +414,34 @@ interface SubmissionInfo {
   checked?: boolean
 }
 
-export interface ContestRank {
-  id: number
-  user: SampleUser
-  submission_number: number
-  accepted_number: number
-  total_time: number
-  submission_info: { [key: string]: SubmissionInfo }
-  contest: number
+/**
+ * 榜单行。`submissionInfo` 的**内容**仍是 snake_case —— 它是 acm_contest_rank
+ * 表的 JSONB 原文，回滚时旧后端还要读，见 SubmissionInfo。
+ */
+export type ContestRank = Omit<
+  import("@oj2/contract").ContestRankItem,
+  "submissionInfo"
+> & {
+  submissionInfo: { [key: string]: SubmissionInfo }
 }
 
-export interface WebsiteConfig {
-  website_base_url: string
-  website_name: string
-  website_name_shortcut: string
-  website_footer: string
-  allow_register: boolean
-  submission_list_show_all: boolean
-  class_list: string[] & never[]
-  enable_maxkb: boolean
-}
+export type { WebsiteConfig } from "@oj2/contract"
 
-export interface Server {
-  id: number
-  status: "abnormal" | "normal"
-  hostname: string
-  ip: string
-  judger_version: string
-  cpu_core: number
-  memory_usage: number
-  cpu_usage: number
-  last_heartbeat: Date
-  create_time: Date
-  task_number: number
-  service_url: string
-  is_disabled: boolean
-}
+export type {
+  JudgeServer as Server,
+  JudgeServerList,
+  DashboardInfo,
+  OrphanTestCase,
+  AdminUser,
+  AdminUserList,
+  AcmHelperItem,
+  AdminContestList,
+  AdminAiReport,
+  AdminAiReportListItem,
+  AdminAiReportList,
+  StuckProblem,
+  AcTrend,
+} from "@oj2/contract"
 
 export interface AnnouncementEdit {
   id: number
@@ -581,16 +453,20 @@ export interface AnnouncementEdit {
 }
 
 export interface Announcement extends AnnouncementEdit {
-  created_by: SampleUser
-  create_time: Date
-  last_update_time: Date
+  createdBy: SampleUser
+  createTime: string
+  lastUpdateTime: string
 }
 
+/** 列表不下发正文：公告是 8MB 上限的富文本，列表页只显示标题 */
+export type AnnouncementListItem = Omit<Announcement, "content">
+
 export interface Message {
-  sender: User
-  create_time: Date
+  id: number
+  sender: SampleUser
+  createTime: string
   message: string
-  submission: Submission
+  submission: EmbeddedSubmission
 }
 
 export interface CreateMessage {
@@ -621,14 +497,17 @@ export interface Tutorial {
   title: string
   content: string
   code: string
-  is_public: boolean
+  isPublic: boolean
   order: number
   type: "python" | "c"
-  created_by?: User
-  updated_at?: Date
-  created_at?: Date
+  createdBy?: User
+  updatedAt?: string
+  createdAt?: string
 }
 
+/** 后台教程列表不下发正文：教程正文是整篇 markdown，列表只排序和切换可见性 */
+export type TutorialListItem = Omit<Tutorial, "content">
+
 export interface ExerciseMcqData {
   question: string
   options: string[]
@@ -689,102 +568,33 @@ export interface Exercise {
   order: number
 }
 
-export interface DurationData {
-  unit: string
-  index: number
-  start: string
-  end: string
-  grade: Grade
-  problem_count: number
-  submission_count: number
-}
+export type {
+  DurationData,
+  FlowchartSummary,
+  SolvedProblem,
+  AiDetail as DetailsData,
+} from "@oj2/contract"
 
-export interface SolvedProblem {
-  problem: {
-    title: string
-    display_id: string
-    contest_title: string
-    contest_id: number
-  }
-  ac_time: string
-  rank: number
-  ac_count: number
-  grade: Grade
-  period_rank: number
-  period_ac_count: number
-  difficulty: string
-}
-
-export interface FlowchartSummary {
-  problem__id: string
-  problem_title: string
-  submission_count: number
-  best_score: number
-  best_grade: string
-  latest_submission_time: string
-  avg_score: number
-}
-
-export interface DetailsData {
-  start: string
-  end: string
-  grade: Grade
-  class_name: string
-  tags: { [key: string]: number }
-  difficulty: { [key: string]: number }
-  contest_count: number
-  solved: SolvedProblem[]
-  flowcharts: FlowchartSummary[]
-}
-
-export type Grade = "S" | "A" | "B" | "C"
+// 评级。空串是「无评级」，后端在没有可用数据时真会下发，见契约 gradeSchema
+export type { Grade, ProblemDifficulty }
 
 // ==================== 成就相关类型 ====================
 
-export type AchievementRarity = "bronze" | "silver" | "gold" | "platinum"
+import type { AchievementNotification, PendingAchievement } from "@oj2/contract"
 
-export interface Achievement {
-  id: number
-  name: string
-  description: string
-  icon: string
-  rarity: AchievementRarity
-  hidden: boolean
-  // 隐藏成就未解锁时，后端已做掩码处理，以下四个字段为 null
-  metric: string | null
-  operator: "gte" | "lte" | null
-  threshold: number | null
-  unlocked: boolean
-  unlock_time: string | null
-  backfilled: boolean
-  progress: number | null
-  unlock_rate: number
-}
+export type {
+  Achievement,
+  AchievementList,
+  AchievementRarity,
+  AchievementRarityStat,
+  AchievementSummary,
+  AchievementNotification,
+  PendingAchievement,
+} from "@oj2/contract"
 
-export interface AchievementRarityStat {
-  rarity: AchievementRarity
-  label: string
-  total: number
-  unlocked: number
-}
-
-export interface PendingAchievement {
-  id: number
-  name: string
-  description: string
-  icon: string
-  rarity: AchievementRarity
-  // 弹窗队列里混着两种东西：全站成就和题单奖章。它们的 id 来自两张不同的表，
-  // 数值会重叠，所以去重和标记已读都必须带上 kind 一起判断。
-  // pending 接口只返回成就，不带这个字段，缺省按 achievement 处理。
-  kind?: "achievement" | "badge"
-}
-
-export interface AchievementSummary {
-  username: string
-  total: number
-  unlocked: number
-  percent: number
-  rarity: AchievementRarityStat[]
-  recent: PendingAchievement[]
-}
+/**
+ * 弹窗队列里的条目。`/achievements/pending` 拉来的没有 kind，
+ * WebSocket 推来的有 —— 两个来源会汇进同一个队列。
+ */
+export type QueuedAchievement = PendingAchievement &
+  Partial<Pick<AchievementNotification, "kind">>
diff --git a/packages/contract/src/account.ts b/packages/contract/src/account.ts
index c6c65ce..0aab40b 100644
--- a/packages/contract/src/account.ts
+++ b/packages/contract/src/account.ts
@@ -9,28 +9,10 @@ export const registerRequestSchema = z.object({
   password: z.string().min(6).max(20),
 })
 
-/**
- * 对齐旧后端 `account/serializers.py:125,127` 的 `serializers.URLField`：
- * 这两个字段会被前端渲染成可点击链接，放任自由字符串等于允许写入
- * `javascript:` 一类的伪协议。只放行 http/https，空串与 null 表示「清空」。
- */
-const linkField = z
-  .string()
-  .max(256)
-  .refine(
-    (value) => value === "" || /^https?:\/\/\S+$/i.test(value),
-    "必须是以 http:// 或 https:// 开头的网址",
-  )
-
 export const updateProfileRequestSchema = z.object({
   realName: z.string().max(32).nullable().optional(),
   avatar: z.string().max(256).optional(),
-  blog: linkField.nullable().optional(),
   mood: z.string().max(256).nullable().optional(),
-  github: linkField.nullable().optional(),
-  school: z.string().max(64).nullable().optional(),
-  major: z.string().max(64).nullable().optional(),
-  language: z.string().max(32).nullable().optional(),
 })
 
 export const metricsSchema = z.object({
@@ -65,3 +47,7 @@ export const publicProfileSchema = userProfileSchema
 
 export type RegisterRequest = z.infer<typeof registerRequestSchema>
 export type UpdateProfileRequest = z.infer<typeof updateProfileRequestSchema>
+export type ProblemRank = z.infer<typeof problemRankSchema>
+export type RankProfile = z.infer<typeof rankProfileSchema>
+export type UserRank = z.infer<typeof userRankSchema>
+export type ActivityRankItem = z.infer<typeof activityRankItemSchema>
diff --git a/packages/contract/src/achievement.ts b/packages/contract/src/achievement.ts
index f29d7fa..1466c94 100644
--- a/packages/contract/src/achievement.ts
+++ b/packages/contract/src/achievement.ts
@@ -32,20 +32,38 @@ export const pendingAchievementSchema = z.object({
   rarity: achievementRaritySchema,
 })
 
+export const achievementRarityStatSchema = z.object({
+  rarity: achievementRaritySchema,
+  label: z.string(),
+  total: z.number().int(),
+  unlocked: z.number().int(),
+})
+
+/**
+ * WebSocket 推来的解锁通知。比 `/achievements/pending` 多一个 `kind` ——
+ * 题单奖章和成就来自两张表、id 会重叠，前端靠它区分（见 events.ts 的 publishAchievementNotification）。
+ */
+export const achievementNotificationSchema = pendingAchievementSchema.extend({
+  kind: z.enum(["achievement", "badge"]),
+})
+
 export const achievementSummarySchema = z.object({
   username: z.string(),
   total: z.number().int(),
   unlocked: z.number().int(),
   percent: z.number(),
-  rarity: z.array(z.object({
-    rarity: achievementRaritySchema,
-    label: z.string(),
-    total: z.number().int(),
-    unlocked: z.number().int(),
-  })),
+  rarity: z.array(achievementRarityStatSchema),
   recent: z.array(pendingAchievementSchema),
 })
 
 export const markAchievementsReadSchema = z.object({
   ids: z.array(z.number().int()),
 })
+
+export type Achievement = z.infer<typeof achievementSchema>
+export type AchievementList = z.infer<typeof achievementListSchema>
+export type PendingAchievement = z.infer<typeof pendingAchievementSchema>
+export type AchievementSummary = z.infer<typeof achievementSummarySchema>
+export type AchievementRarity = z.infer<typeof achievementRaritySchema>
+export type AchievementRarityStat = z.infer<typeof achievementRarityStatSchema>
+export type AchievementNotification = z.infer<typeof achievementNotificationSchema>
diff --git a/packages/contract/src/admin.ts b/packages/contract/src/admin.ts
index 4eefabf..28a3440 100644
--- a/packages/contract/src/admin.ts
+++ b/packages/contract/src/admin.ts
@@ -2,6 +2,7 @@ import { z } from "zod"
 
 import { achievementRaritySchema } from "./achievement"
 import { paginatedSchema, sampleUserSchema } from "./common"
+import { problemDifficultySchema } from "./problem"
 
 /**
  * 后台侧的契约。与 oj 侧分开放：同一张表在两侧下发的字段集通常不同
@@ -497,12 +498,16 @@ export const adminProblemListItemSchema = z.object({
   createdBy: sampleUserSchema,
   visible: z.boolean(),
   createTime: z.string(),
-  difficulty: z.string(),
+  difficulty: problemDifficultySchema,
   tags: z.array(z.string()),
   hasAstRules: z.boolean(),
   allowFlowchart: z.boolean(),
   showFlowchart: z.boolean(),
-  topReaction: z.string().nullable(),
+  // 最高票评价 {type, count}。**当前后端恒传 null** —— 旧后端的
+  // reaction/services.py:get_top_reactions 没有跟着迁过来，这一列现在是空的。
+  topReaction: z
+    .object({ type: z.string(), count: z.number().int() })
+    .nullable(),
 })
 
 export const adminProblemListSchema = paginatedSchema(adminProblemListItemSchema)
@@ -526,7 +531,7 @@ export const adminProblemSchema = z.object({
   timeLimit: z.number().int(),
   memoryLimit: z.number().int(),
   visible: z.boolean(),
-  difficulty: z.string(),
+  difficulty: problemDifficultySchema,
   source: z.string().nullable(),
   submissionNumber: z.number().int(),
   acceptedNumber: z.number().int(),
@@ -621,3 +626,33 @@ export const generateSqlTestCaseRequestSchema = z.object({
 })
 
 export const generateSqlTestCaseResponseSchema = z.object({ sql: z.string() })
+
+export type AdminAchievement = z.infer<typeof adminAchievementSchema>
+export type AchievementMetric = z.infer<typeof achievementMetricSchema>
+
+export type AdminProblem = z.infer<typeof adminProblemSchema>
+export type AdminProblemListItem = z.infer<typeof adminProblemListItemSchema>
+export type AdminProblemList = z.infer<typeof adminProblemListSchema>
+export type CreateProblemRequest = z.infer<typeof createProblemRequestSchema>
+
+export type AdminContest = z.infer<typeof adminContestSchema>
+export type AdminContestList = z.infer<typeof adminContestListSchema>
+export type AcmHelperItem = z.infer<typeof acmHelperItemSchema>
+export type AdminUser = z.infer<typeof adminUserSchema>
+export type AdminUserList = z.infer<typeof adminUserListSchema>
+export type JudgeServer = z.infer<typeof judgeServerSchema>
+export type DashboardInfo = z.infer<typeof dashboardInfoSchema>
+export type JudgeServerList = z.infer<typeof judgeServerListSchema>
+export type OrphanTestCase = z.infer<typeof orphanTestCaseSchema>
+
+export type AdminAiReportListItem = z.infer<typeof adminAiReportListItemSchema>
+export type AdminAiReport = z.infer<typeof adminAiReportSchema>
+export type AdminAiReportList = z.infer<typeof adminAiReportListSchema>
+export type StuckProblem = z.infer<typeof stuckProblemSchema>
+export type AcTrend = z.infer<typeof acTrendSchema>
+
+export type AdminTag = z.infer<typeof adminTagSchema>
+export type RenameTagResponse = z.infer<typeof renameTagResponseSchema>
+export type BatchProblemTagResponse = z.infer<typeof batchProblemTagResponseSchema>
+export type SqlTestCaseScript = z.infer<typeof sqlTestCaseScriptSchema>
+export type GenerateSqlTestCaseResponse = z.infer<typeof generateSqlTestCaseResponseSchema>
diff --git a/packages/contract/src/ai.ts b/packages/contract/src/ai.ts
index 00c3167..e4da332 100644
--- a/packages/contract/src/ai.ts
+++ b/packages/contract/src/ai.ts
@@ -1,11 +1,17 @@
 import { z } from "zod"
 
+/**
+ * 评级。`grade()` 返回 S/A/B/C，`averageGrade()` 在没有可用数据时返回空串 ——
+ * 空串是真会下发的值，别把它从这里去掉，前端要按「无评级」处理。
+ */
+export const gradeSchema = z.enum(["S", "A", "B", "C", ""])
+
 export const durationDataSchema = z.object({
   unit: z.string(),
   index: z.number().int(),
   start: z.string(),
   end: z.string(),
-  grade: z.string(),
+  grade: gradeSchema,
   problemCount: z.number().int(),
   submissionCount: z.number().int(),
 })
@@ -20,7 +26,7 @@ export const solvedProblemSchema = z.object({
   acTime: z.string(),
   rank: z.number().int().nullable(),
   acCount: z.number().int(),
-  grade: z.string(),
+  grade: gradeSchema,
   periodRank: z.number().int().nullable(),
   periodAcCount: z.number().int(),
   difficulty: z.string(),
@@ -43,7 +49,7 @@ export const aiDetailSchema = z.object({
   end: z.string(),
   solved: z.array(solvedProblemSchema),
   flowcharts: z.array(flowchartSummarySchema),
-  grade: z.string(),
+  grade: gradeSchema,
   tags: z.record(z.string(), z.number().int()),
   difficulty: z.record(z.string(), z.number().int()),
   contestCount: z.number().int(),
@@ -94,3 +100,12 @@ export const loginSummarySchema = z.object({
   analysis: z.string(),
   analysisError: z.string().optional(),
 })
+
+export type Grade = z.infer<typeof gradeSchema>
+export type DurationData = z.infer<typeof durationDataSchema>
+export type SolvedProblem = z.infer<typeof solvedProblemSchema>
+export type FlowchartSummary = z.infer<typeof flowchartSummarySchema>
+export type AiDetail = z.infer<typeof aiDetailSchema>
+export type HeatmapItem = z.infer<typeof heatmapItemSchema>
+export type AiAnalysisRecord = z.infer<typeof aiAnalysisRecordSchema>
+export type LoginSummary = z.infer<typeof loginSummarySchema>
diff --git a/packages/contract/src/auth.ts b/packages/contract/src/auth.ts
index 11f2353..57a42c5 100644
--- a/packages/contract/src/auth.ts
+++ b/packages/contract/src/auth.ts
@@ -24,12 +24,7 @@ export const userProfileSchema = z.object({
   realName: z.string().nullable(),
   acmProblemsStatus: z.record(z.string(), z.unknown()),
   avatar: z.string(),
-  blog: z.string().nullable(),
   mood: z.string().nullable(),
-  github: z.string().nullable(),
-  school: z.string().nullable(),
-  major: z.string().nullable(),
-  language: z.string().nullable(),
   acceptedNumber: z.number().int(),
   submissionNumber: z.number().int(),
 })
diff --git a/packages/contract/src/classroom.ts b/packages/contract/src/classroom.ts
index 0636c9f..059f3ec 100644
--- a/packages/contract/src/classroom.ts
+++ b/packages/contract/src/classroom.ts
@@ -62,3 +62,8 @@ export const classComparisonResponseSchema = z.object({
   comparisons: z.array(classComparisonSchema),
   hasTimeRange: z.boolean(),
 })
+
+export type ClassRankItem = z.infer<typeof classRankItemSchema>
+export type ClassUserRank = z.infer<typeof classUserRankSchema>
+export type ClassComparison = z.infer<typeof classComparisonSchema>
+export type ClassComparisonResponse = z.infer<typeof classComparisonResponseSchema>
diff --git a/packages/contract/src/content.ts b/packages/contract/src/content.ts
index 9b666b4..aee9784 100644
--- a/packages/contract/src/content.ts
+++ b/packages/contract/src/content.ts
@@ -72,3 +72,7 @@ export const exerciseSchema = z.object({
   data: z.record(z.string(), z.unknown()),
   order: z.number().int(),
 })
+
+export type Message = z.infer<typeof messageSchema>
+export type MessageList = z.infer<typeof messageListSchema>
+export type Announcement = z.infer<typeof announcementSchema>
diff --git a/packages/contract/src/contest.ts b/packages/contract/src/contest.ts
index 6fe9529..89b0eec 100644
--- a/packages/contract/src/contest.ts
+++ b/packages/contract/src/contest.ts
@@ -40,3 +40,8 @@ export const contestRankItemSchema = z.object({
 })
 
 export const contestRankSchema = paginatedSchema(contestRankItemSchema)
+
+export type Contest = z.infer<typeof contestSchema>
+export type ContestList = z.infer<typeof contestListSchema>
+export type ContestRankItem = z.infer<typeof contestRankItemSchema>
+export type ContestRank = z.infer<typeof contestRankSchema>
diff --git a/packages/contract/src/flowchart.ts b/packages/contract/src/flowchart.ts
index e698255..b0afe06 100644
--- a/packages/contract/src/flowchart.ts
+++ b/packages/contract/src/flowchart.ts
@@ -89,3 +89,10 @@ export const flowchartUpdateSchema = z.object({
 
 export type FlowchartUpdate = z.infer<typeof flowchartUpdateSchema>
 export type FlowchartStatistics = z.infer<typeof flowchartStatisticsSchema>
+export type FlowchartSubmission = z.infer<typeof flowchartSubmissionSchema>
+export type FlowchartListItem = z.infer<typeof flowchartListItemSchema>
+export type FlowchartList = z.infer<typeof flowchartListSchema>
+export type FlowchartCurrent = z.infer<typeof flowchartCurrentSchema>
+export type FlowchartDetail = z.infer<typeof flowchartDetailSchema>
+export type CreateFlowchartResponse = z.infer<typeof createFlowchartResponseSchema>
+export type CreateFlowchartRequest = z.infer<typeof createFlowchartRequestSchema>
diff --git a/packages/contract/src/problem.ts b/packages/contract/src/problem.ts
index a533302..ed18e35 100644
--- a/packages/contract/src/problem.ts
+++ b/packages/contract/src/problem.ts
@@ -2,6 +2,12 @@ import { z } from "zod"
 
 import { paginatedSchema, sampleUserSchema } from "./common"
 
+/**
+ * 题目难度。生产库 956 道题只有这三个值（旧 Django 的 Problem.difficulty choices
+ * 也是这三个），前端的 DIFFICULTY 映射表按它建 —— 写成 z.string() 的话
+ * 多出来的值会静默渲染成 undefined。
+ */
+export const problemDifficultySchema = z.enum(["Low", "Mid", "High"])
 export const problemDetailSchema = z.object({
   id: z.number().int(),
   _id: z.string(),
@@ -22,7 +28,7 @@ export const problemDetailSchema = z.object({
   lastUpdateTime: z.string().nullable(),
   timeLimit: z.number().int(),
   memoryLimit: z.number().int(),
-  difficulty: z.string(),
+  difficulty: problemDifficultySchema,
   source: z.string().nullable(),
   prompt: z.string().nullable(),
   submissionNumber: z.number().int(),
@@ -55,7 +61,7 @@ export const problemListItemSchema = z.object({
   title: z.string(),
   submissionNumber: z.number().int(),
   acceptedNumber: z.number().int(),
-  difficulty: z.string(),
+  difficulty: problemDifficultySchema,
   createdBy: sampleUserSchema,
   tags: z.array(z.string()),
   contestId: z.number().int().nullable(),
@@ -84,3 +90,10 @@ export const yearlyAcSchema = z.object({
   accepted: z.number().int().nonnegative(),
   acRate: z.number(),
 })
+
+export type ProblemDifficulty = z.infer<typeof problemDifficultySchema>
+export type ProblemListItem = z.infer<typeof problemListItemSchema>
+export type ProblemList = z.infer<typeof problemListSchema>
+export type Tag = z.infer<typeof tagSchema>
+export type ProblemAuthor = z.infer<typeof problemAuthorSchema>
+export type YearlyAc = z.infer<typeof yearlyAcSchema>
diff --git a/packages/contract/src/problemset.ts b/packages/contract/src/problemset.ts
index fcb5025..38c8ec6 100644
--- a/packages/contract/src/problemset.ts
+++ b/packages/contract/src/problemset.ts
@@ -98,3 +98,12 @@ export const userBadgeSchema = z.object({
   earnedTime: z.string(),
   problemset: z.object({ id: z.number().int(), title: z.string() }),
 })
+
+export type ProblemSet = z.infer<typeof problemSetSchema>
+export type ProblemSetList = z.infer<typeof problemSetListSchema>
+export type ProblemSetBadge = z.infer<typeof problemSetBadgeSchema>
+export type ProblemSetProblem = z.infer<typeof problemSetProblemSchema>
+export type ProblemSetProgress = z.infer<typeof problemSetProgressSchema>
+export type ProblemSetProgressList = z.infer<typeof problemSetProgressListSchema>
+export type UserBadge = z.infer<typeof userBadgeSchema>
+export type CompletedProblem = z.infer<typeof completedProblemSchema>
diff --git a/packages/contract/src/submission.ts b/packages/contract/src/submission.ts
index 0ed8ff2..64f6e7d 100644
--- a/packages/contract/src/submission.ts
+++ b/packages/contract/src/submission.ts
@@ -140,3 +140,8 @@ export type SubmissionStatisticsUser = z.infer<
   typeof submissionStatisticsUserSchema
 >
 export type UnacceptedStudent = z.infer<typeof unacceptedStudentSchema>
+
+export type SubmissionListItem = z.infer<typeof submissionListItemSchema>
+export type SubmissionList = z.infer<typeof submissionListSchema>
+export type EmbeddedSubmission = z.infer<typeof embeddedSubmissionSchema>
+export type CreateSubmissionResponse = z.infer<typeof createSubmissionResponseSchema>