From e8a20d12f93adf4cbfe7a58fda2530762d61fe27 Mon Sep 17 00:00:00 2001
From: yuetsh <517252939@qq.com>
Date: Fri, 16 Oct 2026 15:11:21 +0800
Subject: [PATCH] =?UTF-8?q?refactor(=E5=89=8D=E7=AB=AF):=20shared=20/=20ut?=
 =?UTF-8?q?ils=20=E4=B8=8D=E5=86=8D=20import=20oj=20=E5=92=8C=20admin=20?=
 =?UTF-8?q?=E4=B8=8B=E7=9A=84=E4=BB=BB=E4=BD=95=E4=B8=9C=E8=A5=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

依赖方向原来是反的：顶栏、登录框、举手列表这些 shared 组件从 oj/ 里拿东西。
- 跨端的接口挪进 shared/api.ts（按 apps/web/CLAUDE.md 的分法）：学生端题目列表、
  出题人列表、这节课的题、待弹的成就
- 这节课的 store → shared/store/lesson.ts；头像 RankAvatar → shared/components
- 纯函数挪进 utils/：举手列表的错法归类 errorKind、它依赖的答案错误分类 wrongAnswer
  和 Python 报错翻译 pythonError、题目列表行的 toProblemRow
- 只有后台在用的出题人下拉 AuthorSelect 挪回 admin/components

纯搬家。首页、题目列表、题目页、排名、课堂看板、后台题目列表打开无报错，
顶栏题号框敲 1001 回车直达题目页。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../components/AuthorSelect.vue               |  2 +-
 apps/web/src/admin/problem/list.vue           |  2 +-
 apps/web/src/oj/achievement/api.ts            | 11 +----
 apps/web/src/oj/api.ts                        | 31 +------------
 apps/web/src/oj/classroom/board.vue           |  2 +-
 apps/web/src/oj/home/dashboard.vue            |  2 +-
 .../src/oj/learn/components/CodeRunBlock.vue  |  2 +-
 .../components/CompileErrorExplain.vue        |  2 +-
 .../src/oj/problem/components/ContextBar.vue  |  2 +-
 .../src/oj/problem/components/LessonNext.vue  |  2 +-
 .../oj/problem/components/ProblemEditor.vue   |  2 +-
 .../problem/components/SubmissionEffects.vue  |  2 +-
 .../problem/components/SubmissionResult.vue   |  2 +-
 .../problem/components/WrongAnswerExplain.vue |  7 +--
 apps/web/src/oj/problem/list.vue              |  3 +-
 apps/web/src/oj/problem/utils/cError.ts       |  2 +-
 .../oj/problem/utils/chinesePunctuation.ts    |  2 +-
 .../src/oj/rank/components/ChampionList.vue   |  2 +-
 .../oj/rank/components/ClassDetailDrawer.vue  |  2 +-
 apps/web/src/oj/rank/components/RankMe.vue    |  2 +-
 .../web/src/oj/rank/components/RankPodium.vue |  2 +-
 apps/web/src/oj/rank/components/RankTrack.vue |  2 +-
 apps/web/src/oj/rank/components/WeekTop.vue   |  2 +-
 .../src/oj/submission/composables/explain.ts  |  2 +-
 .../oj/user/components/AvatarCropModal.vue    |  2 +-
 .../src/oj/user/components/ProfileCard.vue    |  2 +-
 apps/web/src/shared/api.ts                    | 44 ++++++++++++++++++-
 .../src/shared/components/HelpRequestList.vue |  2 +-
 apps/web/src/shared/components/Login.vue      |  2 +-
 .../src/shared/components/ProblemJumpBox.vue  |  2 +-
 .../rank => shared}/components/RankAvatar.vue |  0
 .../web/src/shared/composables/problemJump.ts |  2 +-
 apps/web/src/shared/store/achievement.ts      |  2 +-
 apps/web/src/{oj => shared}/store/lesson.ts   |  2 +-
 .../src/{oj/classroom => utils}/errorKind.ts  |  2 +-
 .../src/{oj/problem => }/utils/pythonError.ts |  0
 apps/web/src/{oj => utils}/transforms.ts      |  0
 .../src/{oj/problem => }/utils/wrongAnswer.ts |  2 +-
 38 files changed, 78 insertions(+), 78 deletions(-)
 rename apps/web/src/{shared => admin}/components/AuthorSelect.vue (94%)
 rename apps/web/src/{oj/rank => shared}/components/RankAvatar.vue (100%)
 rename apps/web/src/{oj => shared}/store/lesson.ts (98%)
 rename apps/web/src/{oj/classroom => utils}/errorKind.ts (98%)
 rename apps/web/src/{oj/problem => }/utils/pythonError.ts (100%)
 rename apps/web/src/{oj => utils}/transforms.ts (100%)
 rename apps/web/src/{oj/problem => }/utils/wrongAnswer.ts (99%)

diff --git a/apps/web/src/shared/components/AuthorSelect.vue b/apps/web/src/admin/components/AuthorSelect.vue
similarity index 94%
rename from apps/web/src/shared/components/AuthorSelect.vue
rename to apps/web/src/admin/components/AuthorSelect.vue
index ff6df95..dc01fc1 100644
--- a/apps/web/src/shared/components/AuthorSelect.vue
+++ b/apps/web/src/admin/components/AuthorSelect.vue
@@ -9,7 +9,7 @@
 </template>
 
 <script setup lang="ts">
-import { getAuthors } from "oj/api"
+import { getAuthors } from "shared/api"
 
 interface Props {
   all?: boolean
diff --git a/apps/web/src/admin/problem/list.vue b/apps/web/src/admin/problem/list.vue
index 8487c79..075c7ce 100644
--- a/apps/web/src/admin/problem/list.vue
+++ b/apps/web/src/admin/problem/list.vue
@@ -9,7 +9,7 @@ import { batchSetProblemVisible, getProblemList, toggleProblemVisible } from "..
 import Actions from "./components/Actions.vue"
 import AddFromLibraryModal from "./components/AddFromLibraryModal.vue"
 import { useRouteQuery } from "@vueuse/router"
-import AuthorSelect from "shared/components/AuthorSelect.vue"
+import AuthorSelect from "admin/components/AuthorSelect.vue"
 import type { DataTableRowKey } from "naive-ui"
 import BatchTagModal from "./components/BatchTagModal.vue"
 import CreateProblemMenu from "./components/CreateProblemMenu.vue"
diff --git a/apps/web/src/oj/achievement/api.ts b/apps/web/src/oj/achievement/api.ts
index 2147975..ba158ec 100644
--- a/apps/web/src/oj/achievement/api.ts
+++ b/apps/web/src/oj/achievement/api.ts
@@ -1,17 +1,8 @@
-import type { MarkAchievementsRead } from "@oj2/contract"
 import api from "utils/api"
-import type { AchievementList, PendingAchievement } from "utils/types"
+import type { AchievementList } from "utils/types"
 
 export function getAchievements(name?: string) {
   return api.get<AchievementList>("achievements", {
     params: name ? { username: name } : {},
   })
 }
-
-export function getPendingAchievements() {
-  return api.get<PendingAchievement[]>("achievements/pending")
-}
-
-export function markAchievementsRead(ids: number[]) {
-  return api.post("achievements/pending/read", { ids } satisfies MarkAchievementsRead)
-}
diff --git a/apps/web/src/oj/api.ts b/apps/web/src/oj/api.ts
index 17667e6..e117cc5 100644
--- a/apps/web/src/oj/api.ts
+++ b/apps/web/src/oj/api.ts
@@ -23,7 +23,6 @@ import {
   type ProfileOverview,
   type TutorialSummary,
   type Tutorial,
-  type ClassActivity,
   type ClassToday,
   type LastVisit,
   type ClassBoard,
@@ -40,10 +39,8 @@ import {
   type WeeklyRank,
   type ProblemRank,
   type CreateSubmissionResponse,
-  type ProblemAuthor,
   type ProblemListItem,
   type ProblemStats,
-  type ProblemList,
   type ProblemProgress,
   type CreateFlowchartResponse,
   type FlowchartScores,
@@ -64,7 +61,7 @@ import {
 } from "@oj2/contract"
 import api from "utils/api"
 import { contract } from "utils/contract"
-import { toProblemRow } from "oj/transforms"
+import { toProblemRow } from "utils/transforms"
 import type {
   Announcement,
   AnnouncementListItem,
@@ -82,26 +79,12 @@ import type {
 
 /**
  * 题目详情 / 提交详情的 schema 按需加载，和请求并行发出。静态 import 会把 zod
- * 运行时带进首页 —— 题目列表的 getProblemList 也在这个文件里。
+ * 运行时带进首页 —— 首页、题目列表都 import 这个文件。
  * 闸门本身仍是同步的（等 schema 到了再返回），submissionDetailSchema 有 `.catch()`，
  * 放行原文和解析结果不等价，所以不能像 /me 那样改成 contractDeferred。
  */
 const loadDetailSchemas = () => import("./detailSchemas")
 
-export async function getProblemList(
-  offset = 0,
-  limit = 10,
-  searchParams: Record<string, unknown> = {},
-) {
-  const res = await api.get<ProblemList>("problems", {
-    params: { paging: true, offset, limit, ...searchParams },
-  })
-  return {
-    results: res.results.map(toProblemRow),
-    total: res.total,
-  }
-}
-
 /** 题目列表顶上那行和左栏的进度；没登录是 null */
 export function getProblemProgress() {
   return api.get<ProblemProgress | null>("problems/progress")
@@ -115,12 +98,6 @@ export function getRandomProblem(params: { tag: string; type: string; language:
   return api.get<string>("problems/random", { params })
 }
 
-export function getAuthors(all = false) {
-  return api.get<ProblemAuthor[]>("problem-authors", {
-    params: { all: all ? "1" : "0" },
-  })
-}
-
 export async function getProblem(problemID: string, contestID: string) {
   const endpoint = contestID
     ? `contests/${encodeURIComponent(contestID)}/problems/${encodeURIComponent(problemID)}`
@@ -316,10 +293,6 @@ export function getKnowledgeMap() {
   return api.get<KnowledgeMap>("me/knowledge")
 }
 
-export function getClassActivity() {
-  return api.get<ClassActivity>("me/class-activity")
-}
-
 /** 老师首页「今天的课」：今天在上课的每个班 */
 export function getClassToday() {
   return api.get<ClassToday>("classroom/today")
diff --git a/apps/web/src/oj/classroom/board.vue b/apps/web/src/oj/classroom/board.vue
index 69f5f26..6fcb477 100644
--- a/apps/web/src/oj/classroom/board.vue
+++ b/apps/web/src/oj/classroom/board.vue
@@ -15,7 +15,7 @@ import { LANGUAGE_SHOW_VALUE } from "utils/constants"
 import { parseTime } from "utils/functions"
 import type { ClassBoard, ClassBoardCell, ClassBoardProblem, ClassBoardStudent } from "utils/types"
 import ExplainModal, { type ExplainPerson } from "./components/ExplainModal.vue"
-import { errorKind, type ErrorKind } from "./errorKind"
+import { errorKind, type ErrorKind } from "utils/errorKind"
 
 /**
  * 课堂看板（老师，设计稿「课堂看板重设计」A+B）：这个班、今天、这节课的几道题 × 全班学生。
diff --git a/apps/web/src/oj/home/dashboard.vue b/apps/web/src/oj/home/dashboard.vue
index 928d629..8e54518 100644
--- a/apps/web/src/oj/home/dashboard.vue
+++ b/apps/web/src/oj/home/dashboard.vue
@@ -3,7 +3,6 @@ import { continueStep, doneCount, lessonPath, splitTitle, type TutorialType } fr
 import { Icon } from "@iconify/vue"
 import {
   getAnnouncementList,
-  getClassActivity,
   getKnowledgeMap,
   getContestList,
   getLastVisit,
@@ -12,6 +11,7 @@ import {
   getTutorials,
   getWeeklyRank,
 } from "oj/api"
+import { getClassActivity } from "shared/api"
 import SubmissionResultTag from "shared/components/SubmissionResultTag.vue"
 import { pickHeadline, type Headline } from "oj/user/knowledge"
 import { useUserStore } from "shared/store/user"
diff --git a/apps/web/src/oj/learn/components/CodeRunBlock.vue b/apps/web/src/oj/learn/components/CodeRunBlock.vue
index 85fcd9c..2013a93 100644
--- a/apps/web/src/oj/learn/components/CodeRunBlock.vue
+++ b/apps/web/src/oj/learn/components/CodeRunBlock.vue
@@ -5,7 +5,7 @@ import { errorMessage } from "utils/api"
 import { SubmissionStatus } from "utils/constants"
 import { trialRun } from "utils/judge"
 import { explainCCompileError } from "oj/problem/utils/cError"
-import { explainPythonCompileError } from "oj/problem/utils/pythonError"
+import { explainPythonCompileError } from "utils/pythonError"
 import { explainRuntimeError } from "oj/problem/utils/runtimeError"
 import { useAuthModalStore } from "shared/store/authModal"
 import { useUserStore } from "shared/store/user"
diff --git a/apps/web/src/oj/problem/components/CompileErrorExplain.vue b/apps/web/src/oj/problem/components/CompileErrorExplain.vue
index 3947a62..a70ca7c 100644
--- a/apps/web/src/oj/problem/components/CompileErrorExplain.vue
+++ b/apps/web/src/oj/problem/components/CompileErrorExplain.vue
@@ -10,7 +10,7 @@ import {
   showPunctuationMarks,
 } from "oj/problem/utils/errorMark"
 import { explainCCompileError } from "oj/problem/utils/cError"
-import { explainPythonCompileError } from "oj/problem/utils/pythonError"
+import { explainPythonCompileError } from "utils/pythonError"
 
 /**
  * 编译错误的中文说明卡片：Python 的语法错误走 pythonError.ts，C / C++ 的 gcc 报错走
diff --git a/apps/web/src/oj/problem/components/ContextBar.vue b/apps/web/src/oj/problem/components/ContextBar.vue
index 6359980..b79ac3a 100644
--- a/apps/web/src/oj/problem/components/ContextBar.vue
+++ b/apps/web/src/oj/problem/components/ContextBar.vue
@@ -4,7 +4,7 @@ import type { RouteLocationRaw } from "vue-router"
 import { getProblemSetDetail, getProblemSetProblems, joinProblemSet } from "oj/api"
 import { useContestStore } from "oj/store/contest"
 import { isFlowchartPass, useFlowchartStore } from "oj/store/flowchart"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 import { useProblemStore } from "oj/store/problem"
 import { useUserStore } from "shared/store/user"
 import { useBreakpoints } from "shared/composables/breakpoints"
diff --git a/apps/web/src/oj/problem/components/LessonNext.vue b/apps/web/src/oj/problem/components/LessonNext.vue
index c3a903e..b8e596f 100644
--- a/apps/web/src/oj/problem/components/LessonNext.vue
+++ b/apps/web/src/oj/problem/components/LessonNext.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { useThemeVars } from "naive-ui"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 
 /**
  * 通过之后告诉学生「这节课的下一题是哪道」。
diff --git a/apps/web/src/oj/problem/components/ProblemEditor.vue b/apps/web/src/oj/problem/components/ProblemEditor.vue
index dbbbaa3..fed7307 100644
--- a/apps/web/src/oj/problem/components/ProblemEditor.vue
+++ b/apps/web/src/oj/problem/components/ProblemEditor.vue
@@ -18,7 +18,7 @@ import { useCollabHere, useTeacherCollab } from "../composables/teacherCollab"
 import { useProblemPageContext } from "../composables/problemPageContext"
 import CollabBar from "./CollabBar.vue"
 import { useFlowchartStore } from "oj/store/flowchart"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 
 const FlowchartEditor = defineAsyncComponent(
   () => import("shared/components/FlowchartEditor/index.vue"),
diff --git a/apps/web/src/oj/problem/components/SubmissionEffects.vue b/apps/web/src/oj/problem/components/SubmissionEffects.vue
index 399a5ed..044e0c5 100644
--- a/apps/web/src/oj/problem/components/SubmissionEffects.vue
+++ b/apps/web/src/oj/problem/components/SubmissionEffects.vue
@@ -5,7 +5,7 @@ import { getReaction } from "oj/api"
 import { useProblemStore } from "oj/store/problem"
 import { useSubmissionStore } from "oj/store/submission"
 import { useFireworks } from "oj/problem/composables/useFireworks"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 import { isFlowchartPass, useFlowchartStore } from "oj/store/flowchart"
 import { SubmissionStatus } from "utils/constants"
 import { useProblemPageContext } from "../composables/problemPageContext"
diff --git a/apps/web/src/oj/problem/components/SubmissionResult.vue b/apps/web/src/oj/problem/components/SubmissionResult.vue
index 238a999..4129920 100644
--- a/apps/web/src/oj/problem/components/SubmissionResult.vue
+++ b/apps/web/src/oj/problem/components/SubmissionResult.vue
@@ -21,7 +21,7 @@ import WrongAnswerExplain from "./WrongAnswerExplain.vue"
 import LessonNext from "./LessonNext.vue"
 import ResultHeader from "./ResultHeader.vue"
 import SimilarProblems from "./SimilarProblems.vue"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 import { useProblemPageContext } from "../composables/problemPageContext"
 import Markdown from "shared/components/Markdown.vue"
 
diff --git a/apps/web/src/oj/problem/components/WrongAnswerExplain.vue b/apps/web/src/oj/problem/components/WrongAnswerExplain.vue
index 79a9ef1..37c0ba4 100644
--- a/apps/web/src/oj/problem/components/WrongAnswerExplain.vue
+++ b/apps/web/src/oj/problem/components/WrongAnswerExplain.vue
@@ -5,12 +5,7 @@ import { useThemeVars } from "naive-ui"
 import { useProblemStore } from "oj/store/problem"
 import { markdownToText } from "oj/problem/utils/plainText"
 import { JUDGE_STATUS, SubmissionStatus } from "utils/constants"
-import {
-  classifyDiff,
-  explainDiff,
-  firstDifferentLine,
-  type SampleCheck,
-} from "oj/problem/utils/wrongAnswer"
+import { classifyDiff, explainDiff, firstDifferentLine, type SampleCheck } from "utils/wrongAnswer"
 
 /**
  * 答案错误时的样例对比（数据见后端 judge/run.ts 的 checkSamples）。
diff --git a/apps/web/src/oj/problem/list.vue b/apps/web/src/oj/problem/list.vue
index d555ed1..0fb2f33 100644
--- a/apps/web/src/oj/problem/list.vue
+++ b/apps/web/src/oj/problem/list.vue
@@ -3,7 +3,8 @@ import { Icon } from "@iconify/vue"
 import type { ProblemProgress, ProblemTypeFilter, Tag } from "@oj2/contract"
 import { useRouteQuery } from "@vueuse/router"
 import { useThemeVars } from "naive-ui"
-import { getAuthors, getProblemList, getProblemProgress, getRandomProblem } from "oj/api"
+import { getProblemProgress, getRandomProblem } from "oj/api"
+import { getAuthors, getProblemList } from "shared/api"
 import { useCodeStore } from "oj/store/code"
 import { useTone } from "shared/composables/tone"
 import { STORAGE_KEY } from "utils/constants"
diff --git a/apps/web/src/oj/problem/utils/cError.ts b/apps/web/src/oj/problem/utils/cError.ts
index 8e9658e..80f54b9 100644
--- a/apps/web/src/oj/problem/utils/cError.ts
+++ b/apps/web/src/oj/problem/utils/cError.ts
@@ -1,5 +1,5 @@
 import { findChinesePunctuation } from "./chinesePunctuation"
-import { PUNCTUATION_NAMES, type PythonErrorExplanation } from "./pythonError"
+import { PUNCTUATION_NAMES, type PythonErrorExplanation } from "utils/pythonError"
 
 /**
  * 把 C / C++ 的编译错误（gcc 的原文）翻成中文，和 pythonError.ts 同一个思路：
diff --git a/apps/web/src/oj/problem/utils/chinesePunctuation.ts b/apps/web/src/oj/problem/utils/chinesePunctuation.ts
index cbe8315..6f8bf60 100644
--- a/apps/web/src/oj/problem/utils/chinesePunctuation.ts
+++ b/apps/web/src/oj/problem/utils/chinesePunctuation.ts
@@ -1,4 +1,4 @@
-import { PUNCTUATION_MAP } from "./pythonError"
+import { PUNCTUATION_MAP } from "utils/pythonError"
 
 export interface PunctuationFix {
   from: number
diff --git a/apps/web/src/oj/rank/components/ChampionList.vue b/apps/web/src/oj/rank/components/ChampionList.vue
index 1b4be8c..a579293 100644
--- a/apps/web/src/oj/rank/components/ChampionList.vue
+++ b/apps/web/src/oj/rank/components/ChampionList.vue
@@ -3,7 +3,7 @@ import type { RankRow, WeeklyChampion } from "@oj2/contract"
 import { useThemeVars } from "naive-ui"
 import UserName from "shared/components/UserName.vue"
 import { parseTime } from "utils/functions"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 /** 本班最近几周的每周冠军，底下再挂这张榜上「进步最大」的那个人 */
 defineProps<{
diff --git a/apps/web/src/oj/rank/components/ClassDetailDrawer.vue b/apps/web/src/oj/rank/components/ClassDetailDrawer.vue
index a37debc..8654cba 100644
--- a/apps/web/src/oj/rank/components/ClassDetailDrawer.vue
+++ b/apps/web/src/oj/rank/components/ClassDetailDrawer.vue
@@ -9,7 +9,7 @@ import { useBackClose } from "shared/composables/backClose"
 import { useBreakpoints } from "shared/composables/breakpoints"
 import { parseTime } from "utils/functions"
 import { useRankPalette } from "../palette"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 // Markdown 连着整套代码高亮（两百多 KB），这里要等点开 / AI 写完才用得上，别让它拖慢页面
 const Markdown = defineAsyncComponent(() => import("shared/components/Markdown.vue"))
diff --git a/apps/web/src/oj/rank/components/RankMe.vue b/apps/web/src/oj/rank/components/RankMe.vue
index 2d7e602..c48b2fe 100644
--- a/apps/web/src/oj/rank/components/RankMe.vue
+++ b/apps/web/src/oj/rank/components/RankMe.vue
@@ -4,7 +4,7 @@ import { useThemeVars } from "naive-ui"
 import UserName from "shared/components/UserName.vue"
 import { gapText, toPass } from "../utils"
 import MoodPopover from "./MoodPopover.vue"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 export interface MiniRank {
   label: string
diff --git a/apps/web/src/oj/rank/components/RankPodium.vue b/apps/web/src/oj/rank/components/RankPodium.vue
index 1c74a4b..572ef0d 100644
--- a/apps/web/src/oj/rank/components/RankPodium.vue
+++ b/apps/web/src/oj/rank/components/RankPodium.vue
@@ -4,7 +4,7 @@ import { useThemeVars } from "naive-ui"
 import { useBreakpoints } from "shared/composables/breakpoints"
 import UserName from "shared/components/UserName.vue"
 import { useRankPalette } from "../palette"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 /**
  * 领奖台：前三名站在台阶上，第一名戴皇冠。赛道从第 4 名接着排，前三不再出现第二遍。
diff --git a/apps/web/src/oj/rank/components/RankTrack.vue b/apps/web/src/oj/rank/components/RankTrack.vue
index b5687a4..c8e431e 100644
--- a/apps/web/src/oj/rank/components/RankTrack.vue
+++ b/apps/web/src/oj/rank/components/RankTrack.vue
@@ -5,7 +5,7 @@ import UserName from "shared/components/UserName.vue"
 import { useBreakpoints } from "shared/composables/breakpoints"
 import { useRankPalette } from "../palette"
 import MoodPopover from "./MoodPopover.vue"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 /**
  * 赛道：每人一根条，条越长做对越多，一样长的先做到的排前面（设计稿 G1 / G2）。
diff --git a/apps/web/src/oj/rank/components/WeekTop.vue b/apps/web/src/oj/rank/components/WeekTop.vue
index a9cf660..36fd423 100644
--- a/apps/web/src/oj/rank/components/WeekTop.vue
+++ b/apps/web/src/oj/rank/components/WeekTop.vue
@@ -3,7 +3,7 @@ import type { RankRow } from "@oj2/contract"
 import { useThemeVars } from "naive-ui"
 import UserName from "shared/components/UserName.vue"
 import { useRankPalette } from "../palette"
-import RankAvatar from "./RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 
 /** 这周本班前 5 名（做对过新题的），每周一清零 */
 const props = defineProps<{ rows: RankRow[]; meId?: number; loaded: boolean }>()
diff --git a/apps/web/src/oj/submission/composables/explain.ts b/apps/web/src/oj/submission/composables/explain.ts
index c8a7b3b..93a7ffe 100644
--- a/apps/web/src/oj/submission/composables/explain.ts
+++ b/apps/web/src/oj/submission/composables/explain.ts
@@ -1,5 +1,5 @@
 import { explainCCompileError } from "oj/problem/utils/cError"
-import { explainPythonCompileError } from "oj/problem/utils/pythonError"
+import { explainPythonCompileError } from "utils/pythonError"
 import { explainRuntimeError } from "oj/problem/utils/runtimeError"
 import { SubmissionStatus } from "utils/constants"
 import type { Submission } from "utils/types"
diff --git a/apps/web/src/oj/user/components/AvatarCropModal.vue b/apps/web/src/oj/user/components/AvatarCropModal.vue
index 091f98c..2a7a915 100644
--- a/apps/web/src/oj/user/components/AvatarCropModal.vue
+++ b/apps/web/src/oj/user/components/AvatarCropModal.vue
@@ -2,7 +2,7 @@
 import { Icon } from "@iconify/vue"
 import { useThemeVars } from "naive-ui"
 import { resetAvatar, uploadAvatar } from "oj/api"
-import RankAvatar from "oj/rank/components/RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 import { useUserStore } from "shared/store/user"
 
 /**
diff --git a/apps/web/src/oj/user/components/ProfileCard.vue b/apps/web/src/oj/user/components/ProfileCard.vue
index 8f2becd..11725b6 100644
--- a/apps/web/src/oj/user/components/ProfileCard.vue
+++ b/apps/web/src/oj/user/components/ProfileCard.vue
@@ -3,7 +3,7 @@ import { MOOD_MAX, STUDENT_ROLES, type ProfileOverview } from "@oj2/contract"
 import { Icon } from "@iconify/vue"
 import { useThemeVars } from "naive-ui"
 import { clearMood, setRankHidden, updateProfile } from "oj/api"
-import RankAvatar from "oj/rank/components/RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 import { classLabel } from "utils/classes"
 import UserName from "shared/components/UserName.vue"
 import { useUserStore } from "shared/store/user"
diff --git a/apps/web/src/shared/api.ts b/apps/web/src/shared/api.ts
index 89b7b16..5e6f0f3 100644
--- a/apps/web/src/shared/api.ts
+++ b/apps/web/src/shared/api.ts
@@ -1,8 +1,16 @@
 import type { LoginRequest, RegisterRequest } from "@oj2/contract"
-import type { Quote, WebsiteConfig } from "@oj2/contract"
+import type {
+  ClassActivity,
+  MarkAchievementsRead,
+  ProblemAuthor,
+  ProblemList,
+  Quote,
+  WebsiteConfig,
+} from "@oj2/contract"
 import api from "utils/api"
 import { contractDeferred } from "utils/contract"
-import type { Profile, Tag } from "utils/types"
+import { toProblemRow } from "utils/transforms"
+import type { PendingAchievement, Profile, Tag } from "utils/types"
 
 export function login(data: { username: string; password: string }) {
   return api.post("auth/login", data satisfies LoginRequest)
@@ -51,3 +59,35 @@ export function getClassUsernames(classroom: string) {
 export function getWebsiteConfig() {
   return api.get<WebsiteConfig>("site")
 }
+
+export async function getProblemList(
+  offset = 0,
+  limit = 10,
+  searchParams: Record<string, unknown> = {},
+) {
+  const res = await api.get<ProblemList>("problems", {
+    params: { paging: true, offset, limit, ...searchParams },
+  })
+  return {
+    results: res.results.map(toProblemRow),
+    total: res.total,
+  }
+}
+
+export function getAuthors(all = false) {
+  return api.get<ProblemAuthor[]>("problem-authors", {
+    params: { all: all ? "1" : "0" },
+  })
+}
+
+export function getClassActivity() {
+  return api.get<ClassActivity>("me/class-activity")
+}
+
+export function getPendingAchievements() {
+  return api.get<PendingAchievement[]>("achievements/pending")
+}
+
+export function markAchievementsRead(ids: number[]) {
+  return api.post("achievements/pending/read", { ids } satisfies MarkAchievementsRead)
+}
diff --git a/apps/web/src/shared/components/HelpRequestList.vue b/apps/web/src/shared/components/HelpRequestList.vue
index 25d885f..75d9608 100644
--- a/apps/web/src/shared/components/HelpRequestList.vue
+++ b/apps/web/src/shared/components/HelpRequestList.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { Icon } from "@iconify/vue"
-import { errorKind } from "oj/classroom/errorKind"
+import { errorKind } from "utils/errorKind"
 import { useBreakpoints } from "shared/composables/breakpoints"
 import { useTeacherHelp } from "shared/composables/teacherHelp"
 import { useCollabStore } from "shared/store/collab"
diff --git a/apps/web/src/shared/components/Login.vue b/apps/web/src/shared/components/Login.vue
index 66ac4b6..a4bceff 100644
--- a/apps/web/src/shared/components/Login.vue
+++ b/apps/web/src/shared/components/Login.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { Icon } from "@iconify/vue"
 import { useThemeVars } from "naive-ui"
-import RankAvatar from "oj/rank/components/RankAvatar.vue"
+import RankAvatar from "shared/components/RankAvatar.vue"
 import { classLabel, groupClassOptions } from "utils/classes"
 import { errorCode } from "utils/api"
 import { STORAGE_KEY } from "utils/constants"
diff --git a/apps/web/src/shared/components/ProblemJumpBox.vue b/apps/web/src/shared/components/ProblemJumpBox.vue
index cfc55f3..ec63c31 100644
--- a/apps/web/src/shared/components/ProblemJumpBox.vue
+++ b/apps/web/src/shared/components/ProblemJumpBox.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { Icon } from "@iconify/vue"
 import { useThemeVars } from "naive-ui"
-import { useLessonStore } from "oj/store/lesson"
+import { useLessonStore } from "shared/store/lesson"
 import { useProblemJump } from "shared/composables/problemJump"
 import { useUserStore } from "shared/store/user"
 import type { ClassActivityProblem } from "utils/types"
diff --git a/apps/web/src/oj/rank/components/RankAvatar.vue b/apps/web/src/shared/components/RankAvatar.vue
similarity index 100%
rename from apps/web/src/oj/rank/components/RankAvatar.vue
rename to apps/web/src/shared/components/RankAvatar.vue
diff --git a/apps/web/src/shared/composables/problemJump.ts b/apps/web/src/shared/composables/problemJump.ts
index 3d9bbcb..c3ca480 100644
--- a/apps/web/src/shared/composables/problemJump.ts
+++ b/apps/web/src/shared/composables/problemJump.ts
@@ -1,4 +1,4 @@
-import { getProblemList } from "oj/api"
+import { getProblemList } from "shared/api"
 
 /**
  * 按题号直达。课上老师报一个题号、全班去找，是非比赛提交最主要的来路，
diff --git a/apps/web/src/shared/store/achievement.ts b/apps/web/src/shared/store/achievement.ts
index 02dd4d1..40e3a59 100644
--- a/apps/web/src/shared/store/achievement.ts
+++ b/apps/web/src/shared/store/achievement.ts
@@ -1,4 +1,4 @@
-import { getPendingAchievements, markAchievementsRead } from "oj/achievement/api"
+import { getPendingAchievements, markAchievementsRead } from "shared/api"
 import type { QueuedAchievement } from "utils/types"
 
 /**
diff --git a/apps/web/src/oj/store/lesson.ts b/apps/web/src/shared/store/lesson.ts
similarity index 98%
rename from apps/web/src/oj/store/lesson.ts
rename to apps/web/src/shared/store/lesson.ts
index b220e97..bc0e17b 100644
--- a/apps/web/src/oj/store/lesson.ts
+++ b/apps/web/src/shared/store/lesson.ts
@@ -1,5 +1,5 @@
 import { defineStore } from "pinia"
-import { getClassActivity } from "oj/api"
+import { getClassActivity } from "shared/api"
 import { LANGUAGE_SHOW_VALUE } from "utils/constants"
 import type { ClassActivity, ClassActivityProblem } from "utils/types"
 
diff --git a/apps/web/src/oj/classroom/errorKind.ts b/apps/web/src/utils/errorKind.ts
similarity index 98%
rename from apps/web/src/oj/classroom/errorKind.ts
rename to apps/web/src/utils/errorKind.ts
index 2f131fa..4446a6b 100644
--- a/apps/web/src/oj/classroom/errorKind.ts
+++ b/apps/web/src/utils/errorKind.ts
@@ -1,4 +1,4 @@
-import { classifyDiff, type DiffKind } from "oj/problem/utils/wrongAnswer"
+import { classifyDiff, type DiffKind } from "utils/wrongAnswer"
 import { JUDGE_STATUS, SubmissionStatus } from "utils/constants"
 import type { ClassBoardCell } from "utils/types"
 
diff --git a/apps/web/src/oj/problem/utils/pythonError.ts b/apps/web/src/utils/pythonError.ts
similarity index 100%
rename from apps/web/src/oj/problem/utils/pythonError.ts
rename to apps/web/src/utils/pythonError.ts
diff --git a/apps/web/src/oj/transforms.ts b/apps/web/src/utils/transforms.ts
similarity index 100%
rename from apps/web/src/oj/transforms.ts
rename to apps/web/src/utils/transforms.ts
diff --git a/apps/web/src/oj/problem/utils/wrongAnswer.ts b/apps/web/src/utils/wrongAnswer.ts
similarity index 99%
rename from apps/web/src/oj/problem/utils/wrongAnswer.ts
rename to apps/web/src/utils/wrongAnswer.ts
index eca877a..da90d16 100644
--- a/apps/web/src/oj/problem/utils/wrongAnswer.ts
+++ b/apps/web/src/utils/wrongAnswer.ts
@@ -1,5 +1,5 @@
 import type { StatisticInfo } from "@oj2/contract"
-import { PUNCTUATION_MAP, PUNCTUATION_NAMES } from "./pythonError"
+import { PUNCTUATION_MAP, PUNCTUATION_NAMES } from "utils/pythonError"
 
 /**
  * 答案错误时，比较学生在**公开样例**上的输出和正确输出，归一类、给一句中文提示。