From c1cd908fa2ca0a00c95a7d054be612c2567d6002 Mon Sep 17 00:00:00 2001
From: yuetsh <517252939@qq.com>
Date: Tue, 13 Oct 2026 19:00:23 +0800
Subject: [PATCH] =?UTF-8?q?chore(=E6=96=87=E6=A1=A3):=20CLAUDE.md=20?=
 =?UTF-8?q?=E9=87=8C=E5=87=A0=E5=A4=84=E5=92=8C=E4=BB=A3=E7=A0=81=E5=AF=B9?=
 =?UTF-8?q?=E4=B8=8D=E4=B8=8A=E7=9A=84=E8=AF=B4=E6=B3=95=E6=94=B9=E6=88=90?=
 =?UTF-8?q?=E7=8E=B0=E7=8A=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 格式化行宽早就回到 Oxfmt 默认的 100，去掉「printWidth: 80 别删」
- 前端不再是「从 ojnext 原样搬来」，大部分页面已重写
- 判题镜像已没有 Node；时间列、入参校验处数这两个会变的数字去掉
- 前端路由 meta 补上 requiresTeacherAdmin，composables 补上 problemJump / teacherHelp

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 CLAUDE.md          | 11 +++++------
 apps/web/CLAUDE.md |  5 +++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 6234838..1991f5a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -21,7 +21,7 @@ OJ2 是判题狗（Online Judge）的后端重写：Django 6 → Bun + TypeScrip
 | `docs/timezone.md` | 动日历口径、动时间出参格式 |
 | `docs/contract.md` | 动 zod 契约、想给某个字段加校验 |
 | `docs/ast-rules.md` | 动 AST 代码规则、升级 tree-sitter |
-| `docker/judge/README.md` | 换判题沙箱镜像、升语言版本（gcc / Python / Node …） |
+| `docker/judge/README.md` | 换判题沙箱镜像、升语言版本（gcc / Python …） |
 | `docs/specs/` | 三份设计文档：后端重写、课堂求助与协作编辑、题目详情页重设计（动题目页之前必读） |
 
 ## 仓库结构
@@ -29,7 +29,7 @@ OJ2 是判题狗（Online Judge）的后端重写：Django 6 → Bun + TypeScrip
 | 目录 | 作用 |
 |---|---|
 | `apps/api/` | 后端。Hono + Drizzle + BullMQ，编译成单二进制 |
-| `apps/web/` | 前端。从 ojnext 原样搬来的 Vue 3 SPA |
+| `apps/web/` | 前端。Vue 3 SPA，起点是 ojnext 的代码，之后大部分已重写 |
 | `packages/contract/` | 前后端共用的 Zod 契约 |
 | `docker/` | Dockerfile + 三套 compose（dev / debian / school）+ 部署与运维脚本 |
 | `docs/` | 上面那几份专题文档 + `specs/` 里的设计文档 |
@@ -64,11 +64,10 @@ cd apps/web && bun run build                  # 前端构建（不在 verify 里
 ```
 
 **格式化、lint、任务编排都走 Vite+**（`vite-plus`，`vp` 命令），配置只有根目录的
-`vite.config.ts` 一份：`fmt` 块（Oxfmt，`semi: false`、`printWidth: 80`）、`lint` 块
+`vite.config.ts` 一份：`fmt` 块（Oxfmt，`semi: false`，行宽用默认的 100）、`lint` 块
 （Oxlint，`denyWarnings`）、`run.tasks`（`verify` 和它依赖的四个检查）。前端自己的构建
 配置在 `apps/web/vite.config.ts`，和根目录那份无关。
 
-- **Oxfmt 在 Vite+ 下默认 100 列**，根配置显式写了 80，别删 —— 删了就是几百个文件的 diff。
 - 格式化只管代码：`.md` / `.yml` / `.json` / `.toml` 在 `fmt.ignorePatterns` 里排掉了
   （文档的中文表格、compose 的逐行注释是手排的），`src/db/meta/` 快照和 unplugin 的两个
   `.d.ts` 也排掉了。
@@ -164,7 +163,7 @@ QingdaoU/JudgeServer 停更在 2024-04（官方镜像的 `latest` 和 `1.6.1` 
 拼出来的字面量，TS 已经在编译期校验过；再 parse 一遍拿不到任何新信息，唯一可能失败的输入是
 **库里的历史数据**，而失败的代价是 500 —— 这条规矩是被四次这样的线上故障换来的。
 
-**闸设在写入侧**：入参 `safeParse`（58 处）、`db/schema.ts` 的 `.$type<>()` 列收窄、
+**闸设在写入侧**：入参 `safeParse`、`db/schema.ts` 的 `.$type<>()` 列收窄、
 语义校验函数（`astRulesError()` / `exerciseDataError`）。JSONB 原文
 （`submission.info` / `statistic_info` / `exercise.data`）一律放行，它们的形状真相在判题机
 那边。query 的筛选值走 `routes/helpers.ts` 的 `asFilterValue()`，那是纯类型交接、不加校验。
@@ -211,7 +210,7 @@ SQL 里要按日历切，用 `localTime(列)`（生成 `列 at time zone 'Asia/S
 
 **分层：存 UTC 时刻 → 后端判定按东八区 → 出参 ISO UTC → 前端按东八区渲染。**
 
-- **存**：35 个时间列全是 `timestamptz`，写侧一律 `new Date().toISOString()`。
+- **存**：时间列全是 `timestamptz`，写侧一律 `new Date().toISOString()`。
 - **判定**：日历语义走 `time.ts`，SQL 用 `localTime()`。
 - **出参**：`db/index.ts` 给 OID 1184 挂了 parser，读出来的时刻统一成 ISO 8601 UTC，
   **微秒必须保留**（截成毫秒会让翻页每页丢一条、班级 AC 排名少 1）。
diff --git a/apps/web/CLAUDE.md b/apps/web/CLAUDE.md
index 5213ee9..48bb69e 100644
--- a/apps/web/CLAUDE.md
+++ b/apps/web/CLAUDE.md
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**OJ2 的前端**（`OJ2/apps/web`），代码从上一代 `ojnext/` 原样搬来、只替换了 API 层
+**OJ2 的前端**（`OJ2/apps/web`），起点是上一代 `ojnext/` 的代码，之后大部分页面已重写
 （`ojnext` 与 `../OnlineJudge` 都已下线且**完全冻结，一行都不改**）。Vue 3 + TypeScript，
 Vite（Rolldown 内核）、Naive UI、Pinia、Vue Router。
 
@@ -59,7 +59,7 @@ API 调用不按模块分：学生端全在 `oj/api.ts`、后台全在 `admin/ap
 
 Shared logic lives in `shared/`:
 - `store/` — Pinia stores: `user` (auth/roles), `config` (site-wide settings), `authModal` (login/signup form state), `collab` (help-request queue + collab room), `achievement` (解锁弹窗队列), `myFlowchart` (题面「你画的流程图」那张 A/S 图的 mermaid 源码)
-- `composables/` — `aiStream`, `pagination` (URL-synced), `websocket` (reconnect + heartbeat), `collabDoc` (Yjs binding for the collab channel), `configUpdate` (WS-pushed config sync), `useMermaid` (lazy Mermaid render), `darkTransition` (View Transitions，111 以下走降级分支), `leaveStudents` (课堂看板的「请假」), `chartTheme`, `breakpoints`, `rarity`
+- `composables/` — `aiStream`, `pagination` (URL-synced), `websocket` (reconnect + heartbeat), `collabDoc` (Yjs binding for the collab channel), `configUpdate` (WS-pushed config sync), `useMermaid` (lazy Mermaid render), `darkTransition` (View Transitions，111 以下走降级分支), `leaveStudents` (课堂看板的「请假」), `problemJump` (按题号直达), `teacherHelp` (老师接单 / 打开学生编辑器), `chartTheme`, `breakpoints`, `rarity`
 - `layout/` — `default.vue` and `admin.vue` layout wrappers
 - `api.ts` — shared API calls (auth, profile, tags, captcha)
 
@@ -178,6 +178,7 @@ proxy 转给 3000，线上由 Caddy 同源伺服。
 Routes are defined in `src/routes.ts` with two root routes: `ojs` (user-facing) and `admins` (admin panel). Route meta fields used:
 - `requiresAuth` — redirect to login if not authenticated
 - `requiresSuperAdmin` — super admin only
+- `requiresTeacherAdmin` — 老师及以上（`isTeacherOrAbove`）
 - `requiresProblemPermission` — problem management access
 
 ### Real-time Features