xuyue/OJ2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
546 Commits 1 Branch 0 Tags
c8c38553ec57d19c60d6c2802ae360027aa84ec5
Commit Graph
47 Commits
Author SHA1 Message Date
xuyueandClaude Opus 5.5 df76e7f101 feat(提交详情): 单独打开的一条提交改成左边代码、右边为什么错 + 这道题交的每一次
Deploy / deploy (push) Canceled after 0s
Details 
- 原来不显示是哪道题、时间只到日、答案错误不说为什么，测试点表 5 行一模一样
- 右边摆题目页那块例子对比（输入 / 正确输出 / 他的输出，差的字标红），编译失败、运行时错误同提交列表右栏的说法，代码里标出那一行
- 「这道题交了 N 次」常驻右栏，← → 一次次翻，看他是怎么改对的；题单藏着的那几次点不进
- 老师：「他的全部提交」和「⋯」（复制两项、重新判题）；测试点方块悬停看用时和内存；判题中自己刷新
- 别人的代码、链接不对原来一直转圈，现在说清楚是哪种；自己在题单布置期内的照样看得到是哪道题、什么结果
- 后端详情多给题目名、班级、题单，`?attempts=1` 带上同题的每一次；看不到别人的回 403 而不是 404；提交者本人也拿得到 contestId（比赛里的题号是比赛自己的）

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 01:00:22 +08:00
xuyueandClaude Opus 5.5 8c53e28dcb feat(题单): 「截止时间」改成「布置期」，布置期内没加入的人也藏旧代码；老师能看全班情况，后台一次加好几道题 
- 布置期（列名仍是 end_time，机房共库不改名）+ 新列 assigned_at：布置期内题单里这几道题，
  学生在布置开始之前交的代码先藏起来，不管加没加入，堵住「先抄再加入」；做对或到期放出来，不拦做题
- 「总分达到 N」奖章换成「做对 N 道」，草稿并进「不公开」（0026）
- /problem-sets 带布置期、必做题数、奖章获得时间；题目带做对时刻、错几次、旧代码藏着没有
- 新增 /problem-sets/:id/class-view（老师看一个班：真名 × 每题，加入前就做对过）、/problem-sets/locks
- 后台：批量加题、拖动排序、切必做；去掉状态、难度、分数、提示和单独的进度页

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 22:01:39 +08:00
xuyueandClaude Opus 5.5 af2ca31de5 fix(学生管理员): 260 班看板 23 人、数据统计只有 22 人，学生管理员还能看同学的作业代码——学生管理员一律按学生算
Deploy / deploy (push) Canceled after 0s
Details 
- 统计、题目页各班表、流程图统计的班级名单原来只认普通用户，改成和看板、排行榜一样的
  STUDENT_ROLES，学生管理员进名单、进分母
- 看别人的提交代码和流程图只给老师、超管和出题人；题单防抄对学生管理员也生效。
  原来「比赛进行中学生管理员不能看」那条特例随之去掉
- 题单的「用户进度」原来只给题单创建者，其余老师点开报「题单不存在」；改成所有老师都能看，
  和看板、统计对所有班开放一致。后台能改能删的接口仍只给创建者

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-08 14:00:11 +08:00
xuyueandClaude Opus 5.5 c2ef55b10b fix(提交): C 代码编译不过时，提交前的自动格式化把出错的几行并成一行，学生认不出自己的代码
Deploy / deploy (push) Canceled after 0s
Details 
clang-format 不认中文分号、缺了分号的语句，会把它和下一行并起来（int n； 和 scanf 成了
一行），报错的行号也对不上学生记得的位置。现在 C / C++ 格式化之前先套上题目模板、在
判题机上编一次，编不过就原样返回、不格式化，代码照常提交、照常判成编译错误。

api 容器里没有 gcc，判题机的编译器和参数本来就是判的标准，所以借它编。这一下不进判题
队列、不建提交记录；判题机连不上时照旧格式化。代价是每次交 C 多一次编译，零点几秒。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 11:29:37 +08:00
xuyueandClaude Opus 5.5 5f9743efe0 feat(提交列表): 右栏名字旁多一个「只看这个班」，不在班级列表里的老班也能筛出来 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 00:00:38 +08:00
xuyueandClaude Opus 5.5 e37ad982c0 revert(提交列表): 撤掉班级下拉里补「近半年有提交的班」那一版，下拉回到只用系统设定的班级列表 
改成在右栏名字旁加「只看这个班」过滤按钮（下一条）。
This reverts commit 61ec7d7.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 00:00:38 +08:00
xuyueandClaude Opus 5.5 61ec7d7f8e fix(提交列表): 不在班级列表里的班（毕业、换届摘掉的老班）在班级下拉里选不到，筛不出它的提交
Deploy / deploy (push) Canceled after 0s
Details 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 23:31:50 +08:00
xuyueandClaude Opus 5.5 52bf2d6111 feat(提交列表): 题号填错一道时顶上提示「没有这道题」；← → 也能翻上一条下一条
Deploy / deploy (push) Canceled after 0s
Details 
- 列表接口回带查不到的题号（公开列表只认公开题，比赛列表只认本场的题），
  一次填好几道时打错的那道原来被悄悄忽略
- 方向键恢复成四个都能翻（9 月加的时候就是这样，老师已经用惯了）

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:58:31 +08:00
xuyueandClaude Opus 5.5 26c8d65e89 fix(判题/统计): 老师重判一次题目提交数就多一；统计选 231 班会把 2311、2312 班也算进来 
- 重判带上原来的结果，落库只做差量：提交数不变、旧结果那一格减一新结果加一，
  通过数按新旧结果调整（原来重判当新提交记账，连点三次就多三）。重判时一起清掉 info，
  判题中那几秒不再按旧结果显示「通过 2/3」
- 三个统计接口加 className，按 class_name 精确匹配（原来拼 ks231 做包含匹配）
- 流程图统计查几道题时要每道都拿到 A/S 才算完成；「每人最好的一次」截断时有标记，
  题号上限 20 道和代码统计一致；流程图列表支持按整名匹配用户
- 删掉统计弹框走后没人用的展开行明细接口，以及每次都白算的「语法未过题数」「最近一次错在哪」

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:52:58 +08:00
xuyueandClaude Opus 5.5 ea480d5e0c feat(提交列表): 老师也能重新判题；列表能按班级、一次按几道题筛，还带「通过几个测试点」 
- 重新判题从只放超管改成老师及以上：前端一直给老师亮着按钮，点了只会「权限不足」
- /submissions、/flowcharts 加 className（user.class_name 精确匹配），题号可以一次填几道
- 列表每行带 caseSummary，口径和详情一致，在库里数完只回两个数
- 新增 GET /classroom/lesson：提交列表「这节课」按钮用，班级和题的取法同课堂看板

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 11:08:49 +08:00
xuyueandClaude Opus 5.5 0c2ff68e9b feat(协作): 老师协作时右栏顶上一条协作条，结果页签先摆学生最近一次交的，抽屉变成「他的提交」 
- 协作条：「正在帮 谁 · 语言 · 看他交过什么 ↗ · 结束协作」，从工具栏里挪出来，一眼看得出
  编辑器里是学生的代码。「看他交过什么」带上学生用户名、开新标签（原来只带题号，还得再筛一遍）
- 老师接单后「结果」页签原来是空的：现在摆学生在这道题上最近一次交的结果，可刷新；
  不给 AI 提示（那是按登录的人自己的失败次数解锁的）
- 抽屉「我的提交」在协作中变成「他的提交」，列的是学生的提交，只能复制、不能放回编辑器
  （放回去会经协作通道直接盖掉学生正在写的代码），也不显示老师自己的排名
- 学生排队求助中、或者老师正在帮他时换题：先确认一句。换题会断开协作 / 撤掉举手，
  原来一点「下一题」就把正在帮他的老师踢出去了
- 求助按钮文案：「举手求助」→「已举手 · 前面 2 人」→「某某 老师在帮你」
- 提交列表加 exactUsername=1：用户名精确匹配。原来只有「包含」，ks24a1 会把 ks24a10 的提交
  也捞进来

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 18:28:53 +08:00
xuyueandClaude Opus 5.5 3fe3caa944 feat(流程图): 流程图画到 A / S 算这道题做完——题单进度、课堂条都认；加入题单之前画的图先藏起来
Deploy / deploy (push) Canceled after 0s
Details 
- 流程图评到 A 或 S，记进所有已加入、且包含这道题的题单（和判题那一路同一个口径，不看从哪个
  入口交的），徽章和题单类成就照样推送。原来题单进度只在判代码时记，流程图作业在题单里永远是
  「没做」。流程图提交的 id 进不了 problemset_submission（外键指向代码提交表），所以只写
  progress_detail —— 解锁旧提交的那道闸看的也是它
- 课堂条（/me/class-activity）的 myStatus：流程图 A / S 也算 accepted，评完的非 A/S 算 tried
- 题单防抄闸门补到流程图上：加入题单之前画的图，对本人藏起来（列表 showLink、详情 404、
  current / history 不数它），规则和代码提交同一份（problemSetJoinTimes 挪进 services/problemset）。
  原来加入之前画到 A 的那张图点一下就能载回画布、交上去就是 A
- 新增 GET /problems/:id/flowchart/scores：一次给出自己评完的每一次的分数和等级，外加被藏起来
  的次数（原来 history 一次只给一条，看分数走势得一页一页翻）
- 「A/S 算过关」和按分数定等级收进 flowchart/grade.ts；判题那边的记账 + 通知抽成
  recordSolvedAndNotify，两条路共用

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 17:56:35 +08:00
xuyueandClaude Opus 5.5 2a4405d2ea feat(题目): Python 语法错误改成中文说明，在编辑器里标出位置，中文标点可以一键换成英文
Deploy / deploy (push) Canceled after 0s
Details 
中职学生看不懂英文报错。原来提交前用浏览器里的 Skulpt 拦语法错误，只弹一句
「第 N 行存在语法错误」——Skulpt 九成报的是 bad input / bad token，没有列号。

- 提交前的语法检查挪到服务端：/code/format 先用 CPython 编译一遍（只编译不执行），
  api 镜像加 python3-minimal（3.13，与判题机同版本，+17MB），前端删掉 Skulpt
- 报错按规则表翻成中文（pythonError.ts），生产库 2695 条 Python 编译错误覆盖 99.7%；
  提交前拦下的和判题回来的编译错误共用同一张卡片
- 编辑器里标红出错行和 ^ 指的位置
- 中文标点（历史编译错误的 22%）一键换成英文，跳过字符串和注释、处理 f 字符串花括号；
  594 条里修好 593 条，经 tokenize 核对没有改到字符串内容；走编辑器事务，可 Ctrl+Z

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 21:47:01 +08:00
xuyue d25b5dbe6d update
Deploy / deploy (push) Canceled after 0s
Details
2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5 9412ba3cf6 refactor(契约): 展示题号统一叫 problemDisplayId，题单 id 统一叫 problemSetId
Deploy / deploy (push) Canceled after 0s
Details 
前后端同时改，部署前开着的旧页面要刷新一次（题号列会是空的、提交筛选会失效）。

- 挂在非题目对象上的展示题号，原来叫 problem（字符串）或 displayId，统一成
  problemDisplayId：提交列表、流程图列表、统计的 lastFailure / items /
  今日最热题、站内信里的提交、后台题单的题目列表。别处的 problem 都是对象
  或数字 id，这几处是字符串，最容易看错
- 列表筛选的 query 参数 ?problemId= 实际传的是展示题号，改成
  ?problemDisplayId=（提交列表、流程图列表、三个统计接口）
- 契约里 problemsetId / problemSetId、problemset / problemSet 两种拼法并存，
  统一成 problemSetId / problemSet，和 ProblemSet* 类型名、problem-sets
  路径、前端路由参数一致。drizzle 的列键跟表名走，没动
- aiDetail.user（用户名字符串，而契约里别的 user 都是对象）→ username。
  ai_analysis.data 里存的历史快照仍是 user，没有代码读回它
- 后台题单题目表的列是按字符串键 'displayId' 取的，类型检查抓不到，一并改

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 16:08:31 +08:00
xuyueandClaude Opus 5.5 5ae830a7f9 refactor: 一批名不副实的命名改掉（只动一端，不碰契约） 
后端：
- getUserByToken → authenticateToken：它会删会话、续 TTL、记在线，不是纯读
- todayStart → dayStart(instant)：本来就接受任意时刻，不只是「今天」
- objectValue → asRecord，删掉 4 份一模一样的私有拷贝和 `as toObject` 别名
- 报错文案 "does not exists" / "Already be a public problem" 改通顺

前端：
- utils/types 里 Contest / User / Problem 三个别名删掉：Contest 原来指后台
  比赛、契约里同名的却是学生侧。现在 Contest = 学生侧、AdminContest = 后台，
  后台用户表单叫 AdminUserForm，题目详情直接用 ProblemDetail
- SubmissionInfo → ContestSubmissionInfo，免得和 submission.info 撞名
- utoa / atou → compressToBase64 / decompressFromBase64（实际是 zlib + base64），
  encode / decode → base64EncodeUtf8 / base64DecodeUtf8
- filterResult → toProblemRow、toProblemListItem → toAdminProblemRow，
  行字段 submission / rate → submissionCount / acRate
- 组件：Modal → AddFromLibraryModal、Form → EditorToolbar、
  ContestEditor → BasicEditor（题单也在用它）、rank 的 Index → RankMedal、
  Name → UserNameCell、Password → PasswordCell、ContestType → ContestAccessTag

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 16:08:21 +08:00
xuyueandClaude Opus 5.5 f2ca34fd4b refactor(api): 请求体解析收成 readJson / parseBody 
54 处 handler 都手写同一段：
  const parsed = X.safeParse(await c.req.json().catch(() => null))
  if (!parsed.success) return failure(c, 400, "invalid-request", ...)
漏写 .catch 就是一个畸形请求打出 500。

- http.ts 加 readJson（读 + 校验）和 parseBody（再加上 400）。parseBody 不给
  message 时回 zod 的第一条 issue —— 后台表单原来就是这么写的，fallback 文案
  「Invalid payload」/「参数错误」只在 issues 为空时才用得上，实际走不到
- 51 处换成 parseBody；另 3 处失败时带别的错误码或和路径参数一起判，换成 readJson
- 错误码、状态码、文案、判断顺序都不变

实跑核过：非 JSON 请求体回原来的固定文案，公告标题为空回 zod issue。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:04:19 +08:00
xuyueandClaude Opus 5 a0ef204bd2 feat(提交): 采集编辑过程信号，落进 submission_trace
Deploy / deploy (push) Has been cancelled
Details 
AI 时代 OJ 设计的第 1 步：给「可信 AC」和学情分析攒数据，本身不判任何事。
- 契约：提交请求加可选的 trace（活跃时长、键入/粘贴/删除字符数、切后台次数等，
  只有计数、不含按键内容）；写成 .optional().catch(undefined)，坏了就当没带，
  不让附带数据把提交挡成 400
- 迁移 0016 建 submission_trace，与 submission 一对一、CASCADE；since_prev_ms
  由服务端在同一条 INSERT 里算（排掉自身），bigint —— 实测已有 44 天的间隔，int4 装不下
- 后端写 trace 失败只记日志，不影响提交
- 前端 oj/problem/utils/editTrace.ts 是模块单例（扩展对象不能过 Pinia 的响应式代理），
  只数带 userEvent 的事务：格式化回写 / 载入草稿 / 协作对方的改动天然排除；
  closeBrackets 越过右括号时是原样替换，按 no-op 跳过。比赛编辑器同样挂上
- 实跑：后端四种请求、前端浏览器里键入/粘贴/删除/setCode 回写/切后台/提交后清零，
  计数与预期逐项一致

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-19 05:46:55 -06:00
xuyueandClaude Sonnet 5 c228b164cf refactor(提交): 教师统计路由拆出 submission-statistics.ts，check:routes 支持嵌套挂载
Deploy / deploy (push) Has been cancelled
Details 
- submission.ts 1416 行降到 751 行；统计三条路由拆成子路由，挂在原位置，
  仍排在 /submissions/:id 之前
- check-route-shadowing 原来只认 index.ts 直接挂载，拆分后漏检 3 条（178→175）；
  现在按挂载位置展开嵌套的 .route()，恢复 178 条、无遮蔽

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-19 04:40:30 -06:00
xuyueandClaude Opus 5 ed56a209ea chore(格式): Prettier 统一到全仓，后端和契约一次性格式化
Deploy / deploy (push) Has been cancelled
Details 
原来只有 `apps/web` 在 Prettier 下（配置在 `apps/web/.prettierrc.toml`、脚本在
web 的 package.json），后端和契约从来没格式化过 —— 手写在 100 列上下，`db/schema.ts`
还是 drizzle-kit pull 留下的 tab 缩进。两套口径分叉久了，跨端改一处就得记着「这边
什么风格」。

- 配置搬到根目录 `.prettierrc.toml`，内容不变（`semi=false`，其余全默认，
  printWidth 80 —— 和前端已有的格式一致，不另立一套宽度）；
- 脚本统一成根目录 `bun run fmt`，覆盖 `apps/*/src`、`apps/web/tests` 和两个构建
  配置；web 自己那份 `fmt` 和重复的 prettier 依赖删掉；
- `.prettierignore` 挡掉两类不该碰的：drizzle-kit 生成的 `src/db/meta/` 结构快照
  （它是 db:generate 的比对输入，只该由 drizzle-kit 写）、unplugin 每次 dev 都会
  重写的 `auto-imports.d.ts` / `components.d.ts`；
- 全量跑了一遍。纯格式，无行为改动：api typecheck / check:routes / check:ast、
  前端 type-check 全过，起 api 打了接口确认正常。前端这 39 个文件的小改动是
  prettier 版本漂移（类型断言的换行口径变了），不是新配置带来的。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-16 08:27:34 -06:00
xuyueandClaude Opus 5 e600fd24cf feat(提交列表): 今日提交数旁加「统计」按钮，弹框给今天的提交统计 
筛到今天之后标签旁边出现「统计」，弹框里是全站今天的提交概况：总提交 / 正确 /
判题中 / 正确率 / 参与人数，外加按钟点的 24 格分布、按语言、按判题结果，以及
今天最热的 10 道题。

新接口 GET /submissions/today-statistics，公开、只出聚合数，口径和那颗标签一致
（东八区今天 + 非比赛提交）：

- 钟点分桶走 time.ts 的 localTime()。`extract(hour from create_time)` 按会话时区
  算，容器是 UTC，整张分布图会左移 8 小时；
- 正确率的分母摘掉未判完的条数，正确数含 AST_CHECK_FAILED；
- 热门题只算 visible 的题目 —— 这个接口不需要登录，不能拿它探未发布题目的标题；
  「提交列表对学生全开」关掉时这张表整个不下发，跟提交列表同一个开关（数字照给，
  否则标签说 21、弹框说 0）。

前端组件异步加载，不进本路由的关键路径；小时分布是纯 CSS 柱状图，没有引 chart.js。
柱子和基线取 useThemeVars()，深浅色都跟着走，「现在」那一格是基线上一段主色刻度。
流程图那档不给这颗按钮 —— 流程图提交在另一张表、只有 AI 评级没有判题状态。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-16 08:23:45 -06:00
xuyueandClaude Opus 5 688005c081 perf(流程图): 列表裁掉整行 select、count 去掉 join，统计面板的数值全下推 SQL
Deploy / deploy (push) Has been cancelled
Details 
流程图提交量涨上去之后，先扛不住的是教师统计面板：它一条不带 limit 的 select
把整个时间窗的行拉进内存再用 JS 算，词云那个 3000 条上限是在 JS 里截的，行早就
全回来了。列表那边则是 `select({ flowchart: 整行, problem: 整行 })`，把
mermaid_code、flowchart_data、三个 AI 文本列和整张题目表一起拉回来，响应一个
都用不到（快照实测流程图行均 4.9KB、题目行均 2.2KB，10 行一页白拉 ~70KB，
limit=250 时 1.7MB）。

- 列表改成白名单列 flowchartListColumns，对齐 submission 那边的
  submissionListColumns（那边同样刻意不取 code / info）。
- 题号 / 用户名筛选先解析成 flowchart_submission 自己的列，count 因此一个 join
  都不用挂，回得到最小索引上的 index-only scan；筛条件落在驱动表上，规划器也走
  得上 flowchart_user_time_idx / flowchart_problem_time_idx。
- 统计面板拆成五条各自和行数脱钩的查询：数值聚合、等级分布、各项平均分
  （jsonb_each + group by）、词云原料（order by ... limit 3000）、谁没做。
  每项满分改从词云那批行里顺手取，省掉一次 21 万行的排序。
- matchedUsers() 从 submission.ts 挪进 helpers.ts，两条统计共用。

拿生产快照（2134 条）复制一份、另插三行脏数据（标量 jsonb、数组 jsonb、分数和
满分写成字符串），新旧两版各跑 24 个请求组合：23 个逐字节一致；剩下 1 个只是三行
create_time 完全相同的记录先后不同 —— 既有的不确定性（ORDER BY create_time 不是
全序），留给后面的 keyset 分页一并解决。

把表灌到 5.3 万 / 21.3 万行实测（HTTP 端到端，5 次取最好，旧 → 新）：

  列表 limit=10       35 →  4 ms    |  56 →   8 ms
  列表 limit=250      36 →  5 ms    |  54 →   8 ms
  列表 offset=5万    108 → 39 ms    |  57 →  45 ms
  列表 按班级         33 →  4 ms    |  53 →   8 ms
  统计 全部时段      288 → 187 ms   | 1169 → 704 ms
  统计 一个班        143 →  43 ms   |  388 → 129 ms
  统计 一道题         94 → 194 ms   |  339 → 277 ms

「统计 一道题」在 5 万行量级是退步的：那个筛选命中全表 23% 的行，PG 侧的 jsonb
算子比「原样输出让 Bun 去 parse」更费 CPU，要到 21 万行才反超。它跟的是筛出来的
行数、不跟总量走，200ms 的教师面板可以接受，没有再调。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-15 22:19:21 -06:00
xuyueandClaude Opus 5 4c0c38445c fix(时区): 日历口径收回东八区，读出的时刻统一成 ISO 并保留微秒 
旧栈 Django 按 Asia/Shanghai 算日历，OJ2 重写时这个锚点丢了：容器和数据库会话
都是 UTC，于是「今日提交」在北京时间 0–8 点是空的，「凌晨/早起提交次数」整体偏
8 小时，热力图、AC 趋势年份、近两年活跃人数也各按进程时区切。

- 新增 apps/api/src/time.ts 作为唯一锚点（固定 +8 偏移，不依赖进程 TZ / tzdata），
  todayStart、成就小时/日期键、热力图、月份平移、年份夹逼全部改走它；
  SQL 里按日历切的一律显式 at time zone。
- db/index.ts：连接会话时区设为东八区（兜底）；给 timestamptz(1184) 挂 parser，
  读出统一成 ISO 8601 UTC，撤掉为拿 PG 文本形状写的 ::text。parser 保留微秒 ——
  生产库 12.3 万条提交几乎全带微秒，截成毫秒会让翻页分界行和班级 AC 排名的
  <= min(create_time) 把自己排除（翻页每页丢一条、排名少 1）。
- 前端 parseTime/zonedParts/zonedYear 按 Asia/Shanghai 渲染，n-date-picker 做
  toPickerValue/fromPickerValue 平移，站内不再按浏览器时区取时间部件。
- Dockerfile 设 TZ=Asia/Shanghai 作为第二道兜底。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd
 2026-09-14 05:55:17 -06:00
xuyueandClaude Opus 5 6e63866cc9 perf(提交列表): 按用户名、题号筛选走索引，不再扫全表
Deploy / deploy (push) Has been cancelled
Details 
用户名筛选：user_id 先查成字面列表，不再把子查询夹在 OR 里（那样整条 OR 不可索引），
加 trigram 索引接住 ilike '%x%'；翻页先圈出匹配行再排序取页，避开规划器顺着时间索引
倒扫、边扫边滤的计划。快照上查一个班 70~107ms → 5~14ms；匹配 9.5 万条的年级前缀
从 34ms 变成 70~90ms，实际不这么查。

题号筛选：先解析成 problem.id，加 (problem_id, create_time, id) 部分索引。老题和
不存在的题号不再倒扫大半张表（34~67ms → 4ms），题号筛选也能走游标深翻页，
count 不再 join problem。

迁移 0015 装 pg_trgm（官方镜像自带 contrib，trusted 扩展）。39 个筛选组合的响应
与改动前逐字节一致。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xg91q3JsunDE7EYoi9G3i2
 2026-09-13 23:47:24 -06:00
xuyueandClaude Opus 5 9132901cc7 feat(提交结果): 没通过时显示「通过 x/y 个测试点」；编译失败不等三次就能用 AI 分析
Deploy / deploy (push) Has been cancelled
Details 
学生拿不到 info（每个点带 output_md5，只给管理员），测试点表格从来只有管理员看得见，
学生这边只有一句「答案错误」—— 从 2/8 交到 6/8 的人，感受是连输五次。

- 提交详情新增 caseSummary，后端从 info 数出通过数下发，不放开原文。
  比赛提交、SQL 题（被杀的测试点会 break，total 偏小）、无逐点结果时为 null
- 结果面板标题缀上通过数并加进度条，提交详情页标题同步；一个都没过时不缀
- POST /ai/hint 对编译失败跳过失败次数门槛，throttleAi 照旧；前端显示条件同口径

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013TecwAowmYcoNZRheSyTgH
 2026-09-13 07:25:00 -06:00
xuyueandClaude Opus 5 8eae4bea7b feat(统计面板): 展开一个学生后按题目分组，每道题画一条「状态轨迹」
Deploy / deploy (push) Has been cancelled
Details 
老师展开一个学生，原来看到的是一排 12 位十六进制的提交编号按钮。编号本身没有信息量，
而一节课里学生常在好几道题之间来回跳，那一排看不出他到底卡在哪一道。

现在一道题一行：题号、标题、交了几次、过没过，后面跟一排按时间**从早到晚**的小方块，
颜色就是判题状态（绿=通过 红=答错 黄=编译失败/超时 灰=判题中）。
「八绿一红一绿」和「五黄到底」一眼分得开。

- **排序按老师的用法来**：没过的排前面，其中交得越多越靠前 —— 卡得最久的那道顶到眼前；
  已通过的沉底，它们只是「做完了」。
- 鼠标悬停出「状态 · 时间 · 提交号」，点击照旧打开提交详情。
- 「语法未过」(ast_check_failed) 算做出来了，和表格上「已解决」那一列口径一致。
- 方块用内联样式而不是 class：它们是 h() 出来、挂在 NDataTable 展开槽里渲染的，
  <style scoped> 能不能盖到并不确定。色值沿用 Naive 的语义色，和 ExerciseMatch.vue 一致。

为此 GET /submissions/statistics/items 多带三个字段（problem / problemTitle /
createTime）—— 原来只有 id 和 result，分组和悬停都无从谈起。innerJoin problem 不会漏行：
submission.problem_id 是 NOT NULL 且外键 NO ACTION，题目删不掉。

## 验证

起全栈在浏览器里真点过（提交列表 → 数据统计 → 提交记录 → 展开 student）：

- 五道题各成一行，顺序是 1005(5次未过) → 1006(4次) → 1020(1次) → 1018(1次) →
  1004(10次已通过)，符合「没过的在前、交得多的在前、已过的沉底」；
- 现造一条「先错后对」：轨迹读出来是 绿绿绿绿绿绿绿绿红绿，新交的 WA→AC 落在末尾，
  确认是从早到晚而不是倒序；
- 悬停取到「编译失败 · 09-02 22:03:14 · 9f02da4c5f01」。

tsc、check:routes、vue-tsc、vite build、单二进制编译均通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 20:09:09 -06:00
xuyueandClaude Opus 5 ab47e71d6f refactor(契约): 出参不再 parse，后台老题详情和站内信页不再 500
Deploy / deploy (push) Has been cancelled
Details 
## 出参改 satisfies

出参是后端自己刚拼出来的字面量，TS 编译期已经验过；再 xxxSchema.parse({...}) 一遍
拿不到任何新信息，唯一可能失败的输入是库里的历史数据，而失败的代价是 500。136 处
全部撤掉，撤的时候当场炸出两个一直存在的线上故障：

- 后台打开任何一道没编辑过的题都是 500 —— problem.last_update_time 是全库唯一可空
  的列（961 道题里 470 道是 NULL），而 adminProblemSchema.lastUpdateTime 写的是
  z.string()；
- 收到过站内信的人打开消息页全是 500 —— embeddedSubmissionSchema 从
  submissionDetailSchema 继承了 problemDisplayId 却没 omit，路由只填了同义的
  problem；列表为空时才碰巧不炸，所以一直没人报。

两个都是读出侧校验自己造出来的故障，不是它拦住的故障。

## 校验责任挪回写入侧

- db/schema.ts：枚举型的列和几个形状确定的 JSONB 挂 .$type<>()（submission.result /
  .language、problem.difficulty / .languages / .template / .astRules / .sqlConfig /
  .sqlDisplay、achievement.rarity / .operator、exercise.type、reaction.type、
  tutorial.type、problemset.difficulty / .status、flowchart_submission.status、
  problemset_badge.condition_type、acm_contest_rank.submission_info）。只影响 TS、
  不产生 SQL，断言逐列拿根目录那份生产备份核过全量数据。
- createProblemRequestSchema.languages 收窄成 problemLanguageSchema，兑现
  problem.languages 列上的断言。
- 新增 routes/helpers.ts 的 asFilterValue()：query 筛选值（result / language /
  difficulty / status）要和收窄过的列比较时做纯类型交接，不加校验 —— 在这儿拦一道
  会把「筛出空列表」变成「筛条件被忽略、返回全部」。
- 判题产物（submission.info / statistic_info / exercise.data）照旧放行，形状真相
  在判题机那边；judge/sql、flowchart/run、events.ts 里对自家产物的 parse 一并撤掉。
- 仍然 parse 的只有 judge/events.ts 的 parseSubmissionEvent —— 从 Redis 收回来的
  报文是真边界，失败返回 null 而不是 500。

顺带清掉两处重复的真相：stringArray 原本在 routes/helpers.ts、routes/problem.ts、
routes/submission.ts 各有一份拷贝，5 个调用点全部只作用于 problem.languages，列有类型后
三份一起删；routes/site.ts 里和契约同名同形的本地 interface Quote 也删了 —— loadSentences
读入时已经逐字段守过，那处 parse 同样是多余的。

## 文档

CLAUDE.md 那一节从「契约收紧要挑地方」改写成「出参不 parse，用 satisfies」，写明
三处写入侧闸门（入参 safeParse 58 处、列上 $type、语义校验函数）；apps/web/CLAUDE.md
同步 —— 现在收紧字段的后果落在 tsc 编译期，但契约形状仍要对得上存量数据。

## 验证

- 生产备份全量：12.4 万条提交的 result 全在 -2..6,10、961 道题的 languages 均为合法
  数组、10050 条榜单条目形状全对，无一例外；
- tsc -p apps/api 与 vue-tsc --noEmit 均 exit 0；check:routes 检查 177 条路由，无遮蔽；
  前端 build、单二进制编译并在仓库目录之外启动均通过；
- 实跑 40+ 端点（学生端 / 后台 / AI / 榜单 / 题目回写往返），以及一次完整比赛 e2e：
  建比赛 → 复制题目 → 错解 → 正解，把 judge/run.ts 榜单写入的三个分支全走到
  （error_number 0→1、is_first_ac + ac_time 671、totalTime 1871 = 671 + 1×20×60），
  后台核查页的勾选与 404 分支一并验过，测试数据已清理；
- 两个 500 用抓到的真实响应对着改动前的契约复验：lastUpdateTime 收到 null、
  problemDisplayId 收到 undefined，改动后同样两个响应均通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 18:14:05 -06:00
xuyueandClaude Opus 5 26b23aa7c0 fix(统计): 「提交记录」列出所有交过的人，不再只有做完的
Deploy / deploy (push) Has been cancelled
Details 
统计面板那张表原来只给 `isDone` 为真的人，于是一次没对的学生连同他的提交
在面板里根本不存在——tab 却叫「提交记录」，看起来就像统计只认成功的提交。

- `data` 改成给窗口里交过东西的全部人，每行带 `done`；「完成人数」和完成度
  跟着 `done` 数，不是 `data.length`，两个数字口径不变。
- 表格加「完成」列区分两种人；展开行拉的仍是那个人的全部提交（items 接口
  本来就不按结果过滤），对错都在里面。
- 「交了没全对」那一栏原来无条件按花名册取，不填班级/用户名时花名册为空、
  整栏跟着空掉，这批人两栏都不在。改成没有花名册时退回「有提交但没做完的
  全部普通学生」，教师和禁用账号仍然排除；全站视图里保留完整用户名不剥班级
  前缀。「还没交」那一栏没有花名册是真算不出来，仍然为空。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PZbWEaPCnGvmdfNFpPFNGb
 2026-09-08 23:52:34 -06:00
xuyueandClaude Opus 5 a89eed7bdd fix(提交统计): 按 user_id 归属提交，不再按提交时冻结的用户名 
submission.username 是提交那一刻的快照。教师统计全程拿它当主键用 —— ilike 过滤、
group by、再拿结果去 user 表 join 班级 —— 学生改名之后旧提交还挂着旧名字，一条都
匹配不上。

生产快照实测（2026-09-08）：24 级数媒两个班改成编号制用户名之后，查 ks249 旧口径
0 条、新口径 7 条，整个班 48 人全掉进「一条没交」；查 ks248 是 20 条 / 54 条，
13 个人的成绩查不出来。ks248林依晨那 8 条提交原来一条看不到，人在「一条没交」栏，
现在落到「交了没完成」并带出最后一次失败在 1082 题。

四条路径一起改：

- /submissions/statistics 的过滤、聚合、花名册全部改按 user_id，用户名从 user 表
  join 出来。已删号的学生 user 表里没有行，退回提交里冻结的名字（personCount
  那句兜底就是给这种情况的）
- /submissions/statistics/items 展开行先把用户名解析成 user_id
- /submissions 和 /contests/:id/submissions 的用户名筛选取并集：user_id 匹配到的
  账号，加上按冻结用户名匹配的（已删号的 28 个账号只剩这一份名字，顺带「按记得的
  旧名字搜」也还查得到）。列表显示的名字改成当前用户名，否则筛 ks248 出来一堆写着
  ks24数媒1班ks的行，看着像筛错了
- /rankings/activity 同样按 user_id 分组。这条眼下是预防性的：改过名又有 AC 记录的
  4 个人只有 1~2 题，够不到前 10，但真上榜会显示旧名字或被拆成两条

顺带把统计接口的四次全表扫换成索引扫：ilike 走不了索引，换成 user_id in (...)
之后单条 18448 → 537 buffers，整个接口查一个班 120~250ms → 10ms 上下。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd
 2026-09-08 18:29:02 -06:00
xuyueandClaude Opus 5 9c5a1d551d perf(教师统计): 展开行的明细改成按需拉，统计响应不再背着 4.9 万行没人看的数据
Deploy / deploy (push) Has been cancelled
Details 
上一版把明细收成「只取有 AC 的人、每人最近 50 条」，拿生产快照（12.4 万条提交）
实测下来只从 105631 行降到 49108 行 —— 2.1 倍，不是一个数量级。原因是绝大多数人
本来就不到 50 条，每人截断那道闸在真实分布上基本没咬到，最坏情况响应体仍有 ~2.4MB。

真正的问题是形状不对：表格一次只展开一行（updateExpandedRowKeys 只留最后一个 key），
却给 1900 个人各准备了一份。所以明细整个从统计响应里拿掉，改成展开时按需拉：

- 新端点 `GET /submissions/statistics/items`，要用户名 + 同一套时间窗和题号。
  用户名这里是**精确匹配**，不是统计接口那种 ilike —— 那边填 ks251 要圈出整个班，
  这边是「点开的这一行是谁」。上限 200 条，多取一条来判断 truncated，被截断时
  展开行里说明「只显示最近 200 条」，免得老师以为这人就交了这么多。
- 时间窗和题号抽成共用的 statisticsScope，两个接口必须同一个范围，否则展开行
  看到的是另一个窗口的数据。
- 前端按人缓存，收起再展开不重拉；每次重新统计（含 15 秒自动刷新）清缓存，
  并把当前展开着的那一行重拉一遍 —— 展开行跟着一起活着，不然刷新之后上面的数
  变了、下面的明细还是老的。
- 去重放在 loadItems 里：点一行会同时走 rowProps 的 onClick 和表格的
  update:expanded-row-keys，两边都想拉，改之前真发出了两条一模一样的请求。

顺带把 submissionItems 从 submissionStatisticsUserSchema 里删掉。

生产快照上的验证（12.4 万条提交 / 1956 用户 / 961 题，恢复进一次性容器跑完即删）：

- 最坏情况（全部时段 + 不填条件）少搬 49108 行，约 2.4MB
- 真实课堂量级（最忙的一小时：583 条提交 / 81 人）四条查询分别是
  主聚合 45ms、明细 6.5ms、语法未过 2.4ms、最近错因 <1ms
- 「已解决」那条口径修正的实际影响：13.3% 的「人×题」有重复 AC，同一题最多 AC 45 次；
  按人看最夸张的是 419 条 AC 其实只有 38 道题
- 语法要求的题 15 道、result=10 共 57 条，其中「最后也没改对」的 18 个人×题
  —— 角标会出现，但稀有

浏览器实跑：展开前不发明细请求；展开后 1 条、12 个按钮；收起 +0、再展开 +0（走缓存）；
自动刷新时统计与明细 1:1 配对、间隔 15 秒，没有重复请求。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd
 2026-09-08 05:43:32 -06:00
xuyueandClaude Opus 5 f66bafafaf feat(教师统计): 提交统计面板返修 —— 统计口径、未完成分两栏、多题、自动刷新 
排查这个面板时发现的一串问题和缺口，一起修掉。改动集中在
`GET /submissions/statistics` 和 `StatisticsPanel.vue`，两边互相咬着，
拆不成独立的 commit。

**「已解决」数的不是题数**（真在显示错数字）。`count(*) filter (accepted)`
按用户名分组、没有 distinct problem_id，同一道题重复 AC 会重复计数。查单道题时
看不出来，老师查「这节课全班」时「已解决 5」可能是同一道题交了 5 次。新增
`solvedCount = count(distinct problem_id) filter (accepted)`，表格那一列换成它；
`acceptedCount` 保留，正确率的分子仍然是提交条数。

**正确率把判题中的算进了分母**。PENDING / JUDGING 进分母不进分子，全班同时交卷的
那几秒正确率凭空掉一截 —— 而老师盯着看的就是这个数。分母改成判完的条数，
`UNJUDGED_RESULTS` 提到 judge/status.ts 共用。总提交仍是全部条数（交了就算交过，
否则人数口径会跟着变，正在判的学生会掉进「没交」名单），另外下发 `judgingCount`，
非零时面板多显示一块「判题中」，三个数字才对得上。

**「未完成」实际是「一次没交」**。做了但一次没对的学生既不在「完成人数」也不在
未完成名单，等于从屏幕上消失 —— 而那恰恰是最该去看一眼的人。新增
`dataAttempted`，未完成栏拆成「还没交」/「交了没对」两组，tab 计数是两者之和。
请假隐藏对两组同时生效：他们同样占着班级人数这个分母，只藏一半会把完成度算错。

**点名字能看到错在哪**。`dataAttempted` 带上最近一条提交的题号、状态和
`statistic_info.err_info`（截断 400 字），点名字弹出来，还能一步跳到代码。
老师不用再切到提交列表、翻到这个人、点开代码。

**支持一次查几道题**。题号框接受 `1001,1005,1010`（中英文逗号、分号、空格都当
分隔符，投影前手敲不该因为打了全角逗号就查不出来），有一个题号不存在就整体 404。
**完成 = 这几道全解决**；只填一道时和原来完全等价，不填题号时退回「至少做出一道」。
差一道的人落在「交了没全对」里，名字后面缀 `2/3题`。

**零提交时整块面板消失**。判空条件是 `count.total > 0`，可一节课刚开始一条提交都
没有、后端已经把整份花名册当作「未完成」返回了 —— 最该看名单的时刻反而只显示
「暂无数据」。流程图那边更彻底：`/flowcharts/statistics` 的零提交分支把
`dataUnaccepted` 写死成空数组，名单压根没下发。

**面板不会自己刷新**。打开是空的、要点一次按钮，拿到的是那一刻的快照。改成打开即查
+ 每 15 秒滚动重查，页面切到后台就停，关掉面板随组件卸载停掉。上一次没回来就跳过
这一次。班级从手打 `ks251` 换成下拉（选项来自网站配置的 class_list，和登录框同一份），
保留自由输入，查过的班级记进 localStorage 下次带上 —— 机房电脑一台对一个班。

**明细查询没有 LIMIT**。展开行用的 submissionItems 原来把窗口内**全部**提交捞进内存
再原样序列化，「全部时段 + 不填条件」就是十几万条。改成只取有 AC 的人、每人最近 50 条，
截断用窗口函数发生在数据库侧；表格「提交数」仍是真实总数。

**顺带**：`personRate` 前端从来没读过（完成度是前端按「减掉请假人数的分母」自己算的），
从契约里删掉；「语法未过」的题数单列出来（AST_CHECK_FAILED 全站仍然算通过，口径没动，
只是让老师看得见谁是绕过语法要求做出来的，那批人教学上没达标）。

实跑验证（dev 全栈 + 浏览器）：

- 已解决：student 两条 AC 都在题号 5 上 —— 改前显示 2，改后显示 1
- 正确率：临时把两条改成 PENDING/JUDGING，12 条提交 2 条通过 —— 16.67% → 20%，
  面板多出「判题中 2」，表格显示「12（2 条判题中）」
- 未完成两栏：student2 没交、student 交了 12 次没对，请假隐藏 student 后
  班级人数 2→1、tab 2→1、出现「恢复 1 位」
- 错因弹层：点 student 弹出「最近一次：1020 · 编译失败 / Test case not found / 看代码」
- 多题：`1004` 完成 1 人；`1004,1005` 完成 0 人、交了没全对 student 1/2题 8次；
  全角逗号同上；`1004,9999` 报 `Problem 9999 does not exist`
- 自动刷新：打开即发请求，之后 04:44:22 → 04:44:36 → 04:44:51 → 04:45:06 每 15 秒
  一次且窗口跟着滚；关掉面板后 20 秒请求数不再增长
- 班级下拉：选「25计算机1班」→ ks251，重开面板自动带上并立刻查

tsc / vue-tsc / check:routes 全过。验证用的 dev 库改动已还原。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd
 2026-09-08 05:20:51 -06:00
xuyueandClaude Opus 5 5222e012e1 fix(比赛): 修四处 —— 倒计时两倍速、排名不自动刷新、题目状态恒空、比赛隐藏后审核页取不到代码 
查比赛功能时实跑出来的四个问题，都在这一条里修掉：

**倒计时两倍速**（store/contest.ts）。init() 里 setInterval 之前不清旧表，而
detail.vue 在「未开始 → 进行中」那一刻会再 init 一次（为了捞开赛后才拿得到的题），
于是两个 interval 一起给 now 加 1000。学生赛前挂着页面就会中招：一场 60 分钟的
比赛，真过了 30 分钟页面就显示「已结束」、倒计时归零，而服务端还在正常收提交。
ojnext 里就有，是原样搬过来的。

**排名页「开启自动刷新」开着但不刷新**（contest/pages/rank.vue）。useIntervalFn
传的是 immediate: false，而 watch(autoRefresh) 只在开关变化时才 resume ——
开关初值就是 true、进页面不产生变化，表从没启动过，得手动关一次再开。改成
watchEffect，由「开关 + 比赛进行中」共同驱动，顺带不再在赛后空转轮询。同样来自
ojnext。

**比赛题的 myStatus 恒为 null**（routes/contest.ts）。判题其实把状态记进了
user_profile 的 acm_problems_status.contest_problems，只是这两条路由硬编码下发
空值，于是题目页的「状态」列永远是「未做」，赛后也不恢复。旧后端在赛后/管理员
视角是给的，这是回归。不按赛中赛后分档：这是学生自己的判题结果，不泄露别人任何
信息（旧后端赛中不给，只是因为它整条路换了个 serializer）。

**比赛一隐藏，审核页的「查看代码」必 404**（services/contest.ts）。acm-helper
故意不卡 visible（赛后核查恰恰发生在比赛收起来之后），它调的比赛提交列表却卡着，
两边对不上。findVisibleContest 换成 findAccessibleContest：公开的谁都取得到，
隐藏的只有比赛管理员取得到，学生看隐藏比赛照旧 404。

实跑验证（dev 全栈，判题走临时 worker 绕开本机 token 不一致）：

- 浏览器跨过开赛时刻挂着不动 —— 墙钟 20.0 秒，倒计时正好减 20 秒（原来会减 40）。
- 排名页停在「无数据」，另一账号提交一发 AC，5 秒内表格自己长出
  `1 student2 1/3 0:00:42`，没刷新页面。
- 学生 AC 后列表和详情都回 myStatus: 0，没做过的另一个学生仍是 null，匿名照旧 401。
- 比赛隐藏 + 已结束：出题人 detail / problems / rank / submissions / acm-helper
  全 200，学生这 5 条全 404，提交也 404，隐藏比赛不进公开列表。
- 排名记账口径未受影响：10 次提交（8 编译失败 + 2 AC）落库 submission_number=9、
  accepted_number=1、total_time=231=ac_time、is_first_ac=true。

tsc / vue-tsc / check:routes（175 条无遮蔽）均干净，测试数据已清库。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2
 2026-09-07 19:19:29 -06:00
xuyueandClaude Opus 5 25b86ec17e refactor(提交): 删掉从来没用起来的「提交互相可见」
Deploy / deploy (push) Has been cancelled
Details 
problem.share_submission（题目级）和 submission.shared（单条）两个开关，连同
判定分支一起删掉。

生产备份（2026-08-07）里的实际用量：956 道题只有 2 道开过 share_submission，
还都是 contest_id=1 的比赛题 —— 比赛未结束时那条分支根本走不到，等于一天都没
生效过。123140 条提交里 shared=true 的有 40 条，39 条在 2022 年、1 条在
2023-03-30，之后近三年零使用；出题页从来没给过题目级开关，单条分享的入口在更早
那版前端上，ojnext 和 OJ2 都没搬过来，OJ2 里 PUT /submissions/:id 一个调用方
都没有。

canViewSubmission 剩下三条：本人 / 管理员（比赛中的 Student Admin 除外）/ 本题
作者，其余一律看不到。结尾的 `shareSubmission || shared` 没了；它上面那条「比赛
未结束一律不给」也一并去掉 —— 走到那里的必然不是这三种人，现在无论比赛与否都是
false，留着是重复的。allowShared 参数随之消失，它唯一的用途就是分享开关的归属
校验。

一并删掉：PUT /submissions/:id、响应里的 shared / canUnshare（列表、详情、站内
信内嵌三处）、题目详情与后台题目里的 shareSubmission、shareSubmissionRequestSchema，
以及新建提交时那句 shared: false（列上本来就有 default false）。

两个数据库列保留不删，只在 schema.ts 上注明已停用：删列是破坏性迁移，而留着不读
不写零成本，还留着那 40 条的历史痕迹。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XvmqDsZNyUo9P3sFQtoWVB
 2026-09-07 07:18:41 -06:00
xuyueandClaude Opus 5 2c4d56b29a refactor(后端): 清掉 Django 遗留的死列与手工级联，角色字符串收成一份 
三条迁移，一次部署（0008/0009 含 DROP COLUMN，需要 OJ2_ALLOW_DESTRUCTIVE=1）：

- 0008 删 IP 相关：比赛 IP 白名单（前端本来就没有输入框，detail.vue 无条件置空）、
  submission.ip（前端从未显示过）、以及一次都没被调用过的 IP 限流桶。
  judge_server.ip 是运维数据，保留。
- 0009 删九个只有 Django 时代写过、OJ2 一次都没读过的列：user 的 auth_token /
  open_api / open_api_appkey / session_keys，user_profile 的 blog / github /
  school / major / language。open_api 后台连开关都没有，那段「已经开着就不重置
  appkey」的逻辑从上线起没进过 if。判据是「全仓零读取」而不是「看着没用」——
  raw_password 同样刺眼却是在用的，别一起清掉。
- 0010 给 17 条外键补上删除动作，不再是 Django 留下的一律 NO ACTION。父行消失后
  必然无意义、且不构成学生留痕的走 CASCADE（中间表、题单/教程/成就的组成部分、
  user_profile 与 user_stat）；需要人看见的继续拦着——submission.problem_id、
  以及 user 的绝大多数外键，删用户撞外键会被 handler 翻译成「请改为禁用账号」，
  这是有意的：全 CASCADE 会静默抹掉成就与进度，而 submission.user_id 压根没有
  外键，结果是一半删一半留。六处手工级联随之删掉。

角色字符串收进 packages/contract/src/roles.ts：原先 ADMIN_ROLES / TEACHER_ROLES
在两个文件各抄一份、学生口径在四个文件各写一遍、前端 USER_TYPE 是第三份副本。
AuthUser.adminType 与 drizzle 的列都收窄成联合类型，二十多处 `=== "Super Admin"`
从此受编译器管着（$type 是纯 TS 层的，generate 确认不产生任何 SQL 变更）。

顺带删掉 db/relations.ts —— drizzle-kit pull 的产物，全仓零引用。

一处行为变化：后台用户列表传非法的 ?type= 回 400，不再静默返回空列表；界面上的
下拉只有合法值，打不到这条。

验证：tsc / vue-tsc / vite build / check:routes 全过；三条迁移在 dev 库执行，
并逐条建 fixture 走 HTTP 接口验过删除连坐与拦截（题单五张子表连坐、user_badge
二级连坐、删有提交的题目仍 409、删有表情的用户仍 409）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AeJoYc2t2d7cThVqMBYrBF
 2026-09-02 22:57:45 -06:00
xuyueandClaude Opus 5 e624c62502 feat(提交): 列表标出来自题单的提交
Deploy / deploy (push) Has been cancelled
Details 
submission 新增 problemset_id，学生从 /problemset/:id/problem/:pid 入口提交时
前端带上、后端落库，提交列表在题目后面挂一个「题单 xxx」的标签，点了进题单。

只是来源标记：题单进度和奖章仍由判完之后的 recordSolvedProblem 按「已加入且含
这道题的所有题单」记账，和从哪个入口进来无关，所以这个字段带错顶多标签不准，
不影响成绩。校验只确认这道题在那个题单里 —— 不查 visible / status、也不查有没有
加入，藏起来的题单里还困着已加入的学生；对不上就当没带，提交照收。

外键 ON DELETE SET NULL：删题单不该带走提交，清掉标记就行。索引建成部分索引
（WHERE problemset_id IS NOT NULL），绝大多数提交不来自题单，全列索引是给 12 万行
白建一遍；谓词能被 problemset_id = $1 蕴含，删题单时的外键检查也用得上它。

列表按页单独查一次题单标题，没有把 problemset join 进那条调过的深翻页查询。
比赛提交恒为 null：题单只收非比赛题。

历史回填从 problemset_submission 取「当年首次 AC 那条」，其余老提交无从判断入口，
一律留空。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y7AsqceaUfC81k7UCDcSk2
 2026-09-02 22:06:29 -06:00
xuyueandClaude Opus 5 cf1eea0810 fix(比赛): 学生管理员开卷、导出只剩十行、排行榜翻页错位等四处
Deploy / deploy (push) Has been cancelled
Details 
## 学生管理员在比赛进行中能看所有人的代码

canViewSubmission 里 isAdminRole(user) 是无条件放行的捷径，而 ADMIN_ROLES 含
Student Admin —— 同时 contest.ts 的排行榜又把这个角色算作参赛者。既在榜上、
又能读别人的提交，就是开卷。比赛未结束（未开始 + 进行中）时不再吃这条捷径。

旧后端这里写的是 `not user.is_regular_user()`，学生管理员同样放行，所以这条是
相对旧栈**收紧**的一处，不是修回归。只掐角色捷径，不掐 problem.createdById ——
那是这道题的作者本人，他早就知道答案，挡他没有意义。老师和超管不受影响，他们不参赛。

实跑（造了一场进行中、一场已结束的比赛，各一条别人的提交）：学生管理员在进行中的
比赛里列表 showLink=false、详情 404，比赛结束后恢复 200；超管两种状态都是 200；
学生管理员读**自己**比赛中的提交仍然 200，没有把他自己的记录一起挡掉。

同族的 flowchart.ts canView 有同样的角色捷径，但流程图提交入库时从不写 contest_id
（永远是 null），那条路上不存在「比赛中的别人的提交」，不用跟着改。

## 获奖名单导出，参赛超过 250 人时只导出十个人

rank.vue 用 `limit: total.value || 10000` 想一次拉全量，但 queryInteger 对超出
上限的值是**静默回落到默认的 10**，不是截断到 250。于是 300 人的比赛导出 10 行，
而一二三等奖的分档仍按真实总人数算 —— 老师拿到一份十个人、等级全错的名单，还不报错。
改成按 250 一页循环拉，两个出口都留：拿不满一页说明到底了，比对 total 是防着最后
一页正好整除。班级赛（≤250）碰不到这个坑，全校赛会。

实跑：造 20 条排名，limit=300 后端确实只返回 10 行，limit=250 返回 20，
新逻辑拉回 20。

## 排行榜翻页没有全序

只按 acceptedNumber desc, totalTime asc 排，同分同罚时行序不稳定，而这条列表是
limit/offset 翻页的 —— 同一个人可能在第 2 页出现两次，另一个人从此消失。末尾补
asc(id) 兜全序，id 不参与名次，只保证同分的人每次按同一顺序排。

实跑：20 个同 AC 数同罚时的选手，每页 5 条翻 4 页，共 20 行去重后仍是 20 人，
连翻两轮顺序完全一致。

## acm-helper 两个接口对 visible 的口径不一致

GET 要求 visible = true，PUT 不要求。比赛结束后收起来，核查页就打不开了，
而标记接口还能用。赛后核查恰恰常发生在比赛已经收起来之后，按 PUT 的口径放开。

## 删掉 contest_announcement

旧 Django 栈有「比赛公告」，OJ2 从头到尾没搬：没有路由、没有契约、没有前端页面，
表建在那里纯粹是 introspect 0000 时一起拉进来的。确认不需要，连表带 schema 定义
一起删。

删除前核实：没有任何表外键指向它，序列由本表 owned 会随 DROP TABLE 一并消失，
生产快照（db_backup_2026_08_07）里只有 1 行 —— 2022 年 4 月挂在 contest 1 上的
一条测试公告。迁移不写 CASCADE，同 0002：真有别的东西引用了，宁可报错也别被悄悄
级联掉。

**上生产要显式放行**：migrate.ts 的破坏性闸会拦下 DROP TABLE，得
`OJ2_ALLOW_DESTRUCTIVE=1 docker/deploy.sh`，并按它说的先备份。本机已实跑：
不带环境变量确实被拦，带上之后表和序列都没了，重跑是「没有待执行的迁移」，
db:generate 报 No schema changes（snapshot 与 schema.ts 对齐，不给下一条迁移留假 diff）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013rpSKCNpVcMhTFhw21YiL7
 2026-09-02 20:38:04 -06:00
xuyueandClaude Opus 5 ff31f7abd1 fix(题单): 补回加入题单前旧提交的遮挡 
旧栈的 SubmissionListSerializer.get_show_link 有一条防作弊规则：学生加入含某道题的
题单后，他在加入之前留下的 AC 代码就摆在提交列表里，复制粘贴即可过关，所以要把这段
旧提交藏起来。重写时整条丢了 —— canViewSubmission 里 grep 不到一个 problemset，
自己的提交第一行就无条件 return true。

前端反而把 UI 留着了：ProblemSubmission.vue 那个锁图标的 tooltip 一直写着「这道题在
你已经加入的题单中，只有在题单中完成此题，代码才可见」，而后端永远不会给出
showLink: false，图标一次都没亮过 —— 提示语本身成了操作指引。

题单的 end_time 也因此成了孤儿字段：它不是「截止后不能提交」，是这道闸门的时间边界。

影响面不是边角：8-07 的快照里 1734 人次、188 名学生在加入题单之前就已经 AC 过题单
里的题，占全部已解题次的 22.5%。

补回来的同时改了三处旧栈的做法：

- 判断放进 canViewSubmission，列表和详情一起挡。旧栈只挡列表链接，
  SubmissionAPI.get 光走 check_user_permission，知道 submission id 直接访问照样
  拿得到代码，遮挡是虚的。
- 一题落在多个已加入题单里时取 max(join_time)，「存在任一题单要求遮挡就遮挡」等价于
  「早于最晚的那次加入」。旧栈用 .first() 取任意一条，行为不确定。
- 比赛提交列表不挂闸门。题单里的题必定是非比赛题（加题时卡了 contestId IS NULL），
  而那条列表只出比赛提交，交集恒空，挂上去就是每页白跑一次查询 —— 而比赛进行中它是
  被刷得最狠的。旧栈 ContestSubmissionListAPI 照抄了 bulk_fetch，那边同样是死代码。

闸门只挡「看代码」这一路，不挡 allowShared=false 那一路 —— 后者是分享开关的归属校验，
与作弊无关，挡了学生连自己旧提交的分享都动不了。管理员不受限，对齐旧栈的
is_regular_user() 前提。

解锁三条路实跑验证过：在题单里做出该题、题单过 end_time、题单归档。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QqqZwxtXLo2GTqMi51C94D
 2026-08-31 08:23:13 -06:00
xuyueandClaude Opus 5 6c2381ad2c perf(提交列表): 越早的页越慢，最后一页要等 1.2 秒
Deploy / deploy (push) Has been cancelled
Details 
翻页用的是 LIMIT n OFFSET m，而 Postgres 对 OFFSET 没有捷径：前 m 行必须真的
产出再丢掉，丢弃又发生在 join 之后，每一行都白回了一次表。生产快照（10.4 万条
公开提交）实测最后一页 1258ms、碰了 95347 个 buffer。最早那几页平时没人翻，
数据页从来不在缓存里，全是冷读，所以感受上比新的几页慢得多。

改成两步：先只 select create_time / id 数到第 m 行拿游标——这两列正好是部分索引
的全部内容，跳过 m 行走 Index Only Scan，Heap Fetches 为 0，纯在索引页里数数；
再拿这一行做 keyset 回查，只回表取 limit 行。同一页降到约 9ms、885 个 buffer，
端到端 HTTP 10.7ms。代价变成 O(m) 个索引条目而不是堆页，按快照密度外推，
涨到 100 万条时最深一页仍在几十毫秒量级。

接口签名和前端都没动，页码跳转照旧。offset 为 0、以及按题号筛选时（条件在
problem 表上，第一步得跟着 join，index-only 就没了）退回普通 offset。

部分索引从 (create_time) 换成 (create_time, id)：create_time 由
new Date().toISOString() 生成，只有毫秒精度，不是全序，游标用 <= 回查时同毫秒的
上一页末行会重复出现在下一页页首。加 id 之后两步走同一个顺序。索引 2.3MB → 6.9MB。

索引两列都建成默认 ASC，靠 Index Only Scan Backward 反着扫。别照着 ORDER BY
写成 (create_time DESC, id DESC)：ORDER BY 的 DESC 默认 NULLS FIRST，索引的 DESC
默认 NULLS LAST，规划器认为出不了序，会退化成 external merge sort（5.2MB 落盘），
比不加索引还糟。这一条已写进 schema.ts 和迁移文件的注释。

正确性：在快照上把新旧写法返回的 id 序列逐页比对，14 个 offset × 4 个 limit
共 56 组全部一致，含末尾残页与越界。

比赛提交列表暂不改：单场比赛撑死几千条，offset 不构成问题。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-27 11:13:38 -06:00
xuyueandClaude Opus 5 2ee61756b8 perf(提交列表): count 去掉无谓 join、只取序列化用得到的列 
用户反馈「HEADER 点提交后页面空白一段时间才有数据」。拿生产快照
（12.3 万条提交 / submission 表 169MB）在本机实测，问题分两头。

**后端**（本次改的）：

- count 无条件 `innerJoin(problem)`，但 problem 只有按题号筛选时才出现在
  where 里。带 join 的 count 走 seq scan 78ms，去掉 join 走索引 7.5ms。
- 行查询 `select submission.* + problem.*` 把两张表所有列都拉回来，包括
  submission.code（学生源码）、info、ip，以及 problem 的 description /
  hint / samples / answers / flowchart_data / sql_display —— 这些字段 map
  的时候一个都没用上。改成只 select 需要的列。
  canViewSubmission 的参数类型随之从整行 $inferSelect 收窄成实际用到的
  字段，完整行结构上仍然满足，详情接口调用不受影响。

公开列表和比赛列表两处是同一份代码，一起改了。

**前端**：

- list.vue 静态 import 了四个只在默认关闭的 n-modal 里用的组件，其中两个
  统计面板还只有老师看得见。光 chart.js 就 197KB，进页面前必须先下完。
  改成 defineAsyncComponent 后本路由增量下载 675KB / 59 个文件 →
  375KB / 43 个文件。
- n-data-table 没传 :loading，等接口这段时间表格就是一片空白，连转圈都
  没有 —— 这是「页面空白」最直接的观感来源。用 try/finally 包，接口抛错
  不会把转圈卡死。
- isAuthed 变化时重复拉了一次今日提交数。它不看登录态，onMounted 那次
  就够了。列表本身仍然重拉（要更新提交编号列的可点击状态），那次不是
  浪费；本想用 userStore.isFinished 把首次请求延后，但 getProfile() 一旦
  reject，isFinished 会永远停在 false，匿名用户就再也看不到列表了。

还有一个更大头的原因是索引用不上，导致每次翻页全表扫 169MB，那部分
需要加索引，走下一个提交。

验证：起真实 API 打生产快照，匿名 / 已登录 / myself / 题号筛选 /
语言+状态 / today / offset=5000 / 比赛列表全部 200，响应体大小前后一致
（2990 bytes），字段没丢。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-26 07:55:47 -06:00
xuyueandClaude Opus 5 75dd9bfa42 fix(提交): 独立的 /submission/:id 页面上「复制回到题目」抛 problemID 
## 复现与根因

在 `/submission/<提交id>` 这个独立页面点「复制回到题目」，必抛：

    Error: Missing required param "problemID"

`detail.vue` 的 `problemID` 是**可选** prop，但 `copyToProblem()` 无条件把它塞
进 `router.push({ params: { problemID } })`。三个组件调用方（提交列表弹框、
题目页提交弹框、后台 ACM 助手）都显式传了这个 prop，所以弹框里一直是好的；
而路由 `submission/:submissionID` 配的是 `props: true`，只喂得进
`submissionID` —— 那条路上这个 prop 恒为 undefined。

组件想自己兜底也兜不了：`submissionDetailSchema` 只有 `problemId`（内部数字
id），没有拼路由要用的 display id（`problem._id`）。

ojnext 里是**一模一样**的代码，不是这次重写引入的。

## 改法

后端补 `problemDisplayId`：`submissionDetail()` 本来就 join 了 problem 表，
不额外查库。前端 `props.problemID ?? submission.problemDisplayId`。

## ⚠️ 还剩一条边没关

非管理员看到的 `contestId` 是被抹掉的（`full ? contestId : null`，对齐旧后端
`SubmissionSafeModelSerializer` 的 exclude，把关的是角色不是归属）。所以**学生
自己的比赛提交**从这个独立 URL 打开时，组件判断不出它属于比赛，会跳到公开题
路由 `/problem/<显示编号>`，那里查的是 `contestId is null`，落到「题目不存在」。

改之前这条路是抛异常，改之后是跳错地方 —— 都不对，但主路径（非比赛提交）现在
是对的。要彻底关掉得让后端把 `contestId` 也发给**提交本人**（不只是管理员），
那是在动一条刻意对齐旧后端的决定，留给你定。另外这条路由**全站没有任何入口
链接**（查过了），只有直接输 URL 或外部链接才会到。

## 验证

真起服务、真点按钮：

- 修之前：点击不跳转，控制台 `Missing required param "problemID"`，
  Vue 警告里能看到 `<Detail submissionID="..." >` 确实没有 problemID。
- 修之后：无异常，跳到 `/problem/1004`（那条提交对应的题），
  编辑器里是这条提交的代码（`n = int(input())…`），语言也带过去了。
- 回归：走提交列表弹框（有传 prop 的那条路）照样无异常、照样跳 `/problem/1004`。
- tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、build 通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 23:59:46 -06:00
xuyueandClaude Opus 5 cafa92a102 fix(阶段4评审收尾): 清掉三条 Minor，顺带一个真 bug 
## M4 禁用账号会把学生卡在登录死循环里（唯一学生会撞上的）

`getSessionUser` 对禁用用户返回 null，于是落到 401 `login-required`，
而前端拦截器见到这个码就弹登录框 —— 一个上课上到一半被禁用的学生会陷入
「弹登录框 → 登进去 → 又被弹」，完全看不出发生了什么。

会话解析改成返回 `{ user } | { user: null, reason: "anonymous" | "disabled" }`，
禁用报 403 `account-disabled`（凭证有效、是账号不让用了，和 login 接口对禁用
账号的回法一致）。会话照删，禁用立即生效。前端补一支：清登录态 + 明确提示，
**不弹登录框**。

实测：会话中途 UPDATE is_disabled=true → 同一会话下一个请求
403 `account-disabled`「账号已被禁用，请联系老师」。

## M3 三个端点的守卫写在 handler 体内

submissions/statistics、submissions/:id/rejudge、flowcharts/statistics 的档位
本来就是对的，但写成 handler 里的 if，违背了「守卫要从注册行上看得出来」的约定，
下一个人加同类端点容易漏掉那个 if。改用 requireTeacher / requireSuperAdmin。

实测档位没变：普通学生三个都 403；教师统计接口 200、重判仍 403。

## M2 from-public 的错误码构成比赛存在性预言机

比赛不存在回 `not-found`、存在但不属于你回 `contest-not-found`，带一个已知
有效的 problemId 就能靠错误码枚举出哪些 contestId 真实存在。统一成
`contest-not-found`，和全仓其余跨租户路径一致。

实测：两种情况现在都是 404 contest-not-found。

## 顺带：比赛里的 SQL 题看不到示例数据

改 M2 时 tsc 报 `sqlDisplay` 声明了没用到 —— 查下去是真 bug：
`POST /contests/:id/problems` 把展示数据算出来了，却往库里写死 null
（公开题那两条路径都是对的）。于是比赛里的 SQL 题打开后没有示例数据表和期望结果。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 02:23:23 -06:00
xuyueandClaude Opus 5 20ecc05f63 fix(Minor M2): 比赛权限加中间件兜底 
旧后端用 @check_contest_permission 装饰器，漏挂一眼看得出来；新后端手工在 handler
里调 canAccessContest，漏调一次就是静默放行，而且这类路由挂的是 optionalAuth
（本身不拦人），从路由注册那一行完全看不出它受保护。

新增 requireContestAccess(checkType, paramName)，把「取比赛 → 404 → 鉴权 →
401/403」四步收进注册行。手工调用点 5 → 2：

- GET /contests/:id/access —— 报告权限而非强制，不能 403，留手工
- POST /submissions —— 比赛 id 来自请求体，中间件跑时 body 还没解析，留手工

两处都就地写了说明。canAccessContest 改成泛型，因为 Hono 的 Context 在
Variables 上逆变，写死 Context<AppEnv> 与 ContestEnv 不兼容。

实测拦截行为不变：匿名 401、登录 200、密码赛未过密码 403。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 07:00:58 -06:00
xuyueandClaude Opus 5 836d97847e feat(阶段3): 补齐用户侧依赖的三个 admin 端点 
重判、提交统计、流程图统计这三条挂在旧后端的 admin 路由下，权限也确实是
teacher/super admin，但入口在用户侧页面里（提交列表页的重判按钮、两个统计面板）。
不做完，阶段 3 的出口标准「用户侧全部功能跑在新后端上」就不成立 —— 按 URL
前缀切阶段会漏掉它们。

- POST submissions/:id/rejudge     ← GET admin/submission/rejudge
- GET  submissions/statistics      ← GET admin/submission/statistics
- GET  flowcharts/statistics       ← GET admin/flowchart/statistics

几处对齐旧后端的细节：
- AST_CHECK_FAILED(10) 与 ACCEPTED(0) 同算通过
- 完成度先用原始花名册人数算、再修正 person_count，顺序照搬，兜住「学生已删号
  但提交记录还在」
- 有提交但零通过的学生，两个名单里都不出现（旧后端同样口径）
- 词云用 @node-rs/jieba，STOPWORDS 与 38 个自定义词逐词照搬；jieba@2 没有
  insertWord，改用 loadDict 加载用户词典
- avgScore 分母是有分数的条数，对齐 Django Avg() 跳过 NULL

rejudge 的 jobId 带时间戳。队列保留最近 100 个已完成任务，沿用 submissionId
做 jobId 的话 BullMQ 会认为任务已存在，重判会静默变成空操作。

correctRate 改成数值不带 %，展示格式化交给前端。stripClassPrefix 用
startsWith+slice 而不是 replace，前缀对不上时不会从中间截出乱码；site.ts
原有的 replace 写法一并改掉。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 06:48:05 -06:00
xuyueandClaude Opus 5 f548aef9f0 fix(阶段3): 补齐 contestId 脱敏与仓库根 .env 加载 
两处是首轮六条修复的收尾，均由验证过程暴露：

1. contestId 未脱敏 —— 旧后端 SubmissionSafeModelSerializer 排除的是
   info/contest/ip 三个字段，首轮只处理了 info 与 ip。

2. 根 .env 读不到 —— Bun 只自动加载 cwd 下的 .env，而启动方式
   (bun run --filter '@oj2/api' dev) 会把 cwd 切到 apps/api/，
   于是 .env.example 教人写在仓库根的 JUDGE_SERVER_TOKEN 静默失效，
   后端降级成随机 token，判题全部卡在 PENDING。config 改为显式补读
   根 .env，且只填充未设置的键（真实环境变量与 cwd 下的 .env 优先）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 02:12:31 -06:00
xuyueandClaude Opus 5 8237909d00 fix(阶段3): 提交可见性守卫补上匿名，详情脱敏，提交接口加限流 
F3：`isRegularUser(user)` 对匿名用户（user 为 null）返回 false，
`submission_list_show_all` 关闭时守卫整体短路 —— 匿名能看到全部提交，
权限反而大于登录学生。实测开关关闭时匿名 total=23、登录学生 total=0。
而关闭这个开关的典型场景正是考试。改为 `!isAdminRole(user)`（非管理员即受限），
并删掉 isRegularUser（全仓只有这一处调用，留着就是下一个坑）。

F4：提交详情把 info（含每个测试点的 test_case 编号与 output_md5）与 ip
按「是不是自己的提交」下发。旧后端 submission/views/oj.py 把关的是角色：
is_admin_role() 决定用 SubmissionModelSerializer 还是
SubmissionSafeModelSerializer(exclude=("info", "contest", "ip"))。改为仅管理员可见。

F6：旧后端 SubmissionAPI.throttling 的 TokenBucket 没搬过来。
按旧参数重建（options/options.py:120 的 user 桶：capacity 20、fill_rate 0.03、
default_capacity 10，实际值仍以数据库 throttling 配置项为准），
落在 redis 上并改用 Lua 脚本做成原子操作 —— 旧实现自己注明「不是线程安全的」，
而限流要挡的正是并发突发。挂点位置与旧后端一致：比赛权限校验之后、取题目之前。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 01:59:19 -06:00
xuyueandClaude Opus 5 8c00cdc947 feat(阶段3): oj 侧端点铺开（基线提交，未经评审） 
由外部 agent (Codex) 在本会话额度中断期间完成。原样提交作为基线，
后续修复单独成 commit，便于区分与回退。

覆盖 oj 侧 65 个端点，新增 9 组路由（account/achievement/ai/classroom/
content/contest/flowchart/problemset/site）与对应 Zod 契约。

已核验：tsc --noEmit 退出码 0；API 可启动；/api/problems 返回真实数据；
judge 与 flowchart worker 均 ready。
未核验：权限边界与数据泄露，评审进行中。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-07 01:25:36 -06:00
xuyue ec274419c3 Build Phase 2 judge vertical slice 2026-08-06 22:42:39 -06:00