xuyue/OJ2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
642 Commits 1 Branch 0 Tags
e3c0507d415b0876b051582f8abce098ee85cf42
Commit Graph
77 Commits
Author SHA1 Message Date
xuyueandClaude Opus 5.5 e3c0507d41 feat(设置): 能查出并删掉没人用的图片，编辑器里删掉的图和换下来的头像都算
Deploy / deploy (push) Canceled after 0s
Details 
编辑器里删图、学生换头像都只改库不删文件，盘上越积越多。设置页加「没人用的图片」，
点「查一下」才扫（要扫整个库，不在进页面时跑），按编辑器插图 / 头像分两组，
缩略图可点开，单张删或整组删（先确认）。

判定宁可多留：扫库里每张表的每个文本列，文件名在哪儿出现过都算在用（老域名、
markdown 写法都认，不分大小写）；只看 png/jpg/gif/bmp，目录里的 mp4 不碰；
一天内传的不算（可能还在编辑器里没保存）；库里一张图都没提到时什么也不列（多半连错了库）；
删之前重新扫一遍。服务器和机房图片目录各一份，要各清各的。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-20 20:50:02 +08:00
xuyueandClaude Opus 5.5 465dbfd42f refactor(后端): 权限判断收到一处，路由文件之间不再互相 import 
- services/permissions.ts：「超管或创建者」原来在比赛、题单、比赛题目（4 处）、
  services/contest.ts 各抄一遍，「题目全部权限」在题目和标签两个路由各写一份
- services/submission-filters.ts：提交列表的用户名 / 班级 / 题号筛选，原来
  submission.ts、flowchart.ts 从 submission-statistics.ts 这个路由文件里拿
- services/class-activity.ts：课堂做题记录的口径和「正在上课的班」，原来后台
  conf.ts 从 classroom.ts 路由里拿
- services/problem-tags.ts：标签名去重、按名查标签，原来 tag.ts 从 admin/problem.ts 拿

纯搬家。三种身份（超管 / 老师 / 学生）打了 26 个受影响的接口，改前改后状态码和响应体
逐字节一致，包括「不是自己的比赛 / 题单 / 题目报不存在」那几条。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 14:53:24 +08:00
xuyueandClaude Opus 5.5 a814776fb9 feat(教程): 改练一练时可以顺手清空学生的作答——改了答案，按旧答案做对的人不再算做对
Deploy / deploy (push) Canceled after 0s
Details 
练一练是原地改的，作答记录跟着题走：改了答案或选项，按旧答案做对的人仍然显示做对、
「最后错在 选了 B」说的也是旧选项。编辑框底下多一个「同时清空学生的作答（N 人做过）」，
没人做过时不出现；勾上保存，学生那边这道题回到没做。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 12:28:47 +08:00
xuyueandClaude Opus 5.5 1ebb23cdac feat(自学情况): 看得到配套题做没做——每人一列、每课一个页签、学生明细里逐题列出
Deploy / deploy (push) Canceled after 0s
Details 
- 方块格多一列「配套题」：他打开过的那些课挂的题，做对几道 / 一共几道；格子提示里也带上
- 右栏分「练一练 / 配套题」两个页签：每道题读过这课的人里几人做对，点开看谁没交、谁交了没对，
  一键跳到这个人这道题的提交
- 学生明细每课多一段配套题：做对没有、交了几次、最后哪天交的
- 做对不论早晚，读教程之前在课上做对的也算；口径同学生端课文里那个勾（代码 AC 或流程图 A / S）
- 1366 宽下 C 语言 20 课也不用横着滑了：「最后学习」只留日期，几列收窄

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 12:21:34 +08:00
xuyueandClaude Opus 5.5 7839a65f59 feat(自学情况): 每个学生练一练做到哪了——格子分出做了一部分、点名字看逐题明细 
- 方块格多一档「做了一部分」：按做对的比例从下往上涨绿，一道没做对的底下压一条橙；
  鼠标停上去是「练一练 3/5，错了 4 次」
- 「练一练」列改成 做对/应做（应做 = 他打开过的课的练一练总数）
- 点学生名字从右边滑出明细：每课一段，逐题写第几次做对、交了几次、最后错在哪；
  手机上返回键关它
- 点开一道练一练，底下多一串「读了这课还没做」的人
- 顺手修：那个弹框七列加起来比弹框宽，「最后作答」被挤没了；改成一列用户名

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-16 11:40:30 +08:00
xuyueandClaude Opus 5.5 20a6f667d8 refactor(设置): 站点配置去掉从来没人读的网址、简称、页脚三项和 AI 小助手开关 
库里 options 表那几行旧值留着，没有代码再读。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:37:35 +08:00
xuyueandClaude Opus 5.5 b93d4d83a1 fix(后台公告): 后台公告列表置顶的排在最前，和学生在首页看到的顺序一样 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:21:49 +08:00
xuyueandClaude Opus 5.5 1d406a50e4 feat(后台首页): 首页接口带上全站的数（学生、题目、提交、比赛、题单、自学、这周做题的人）、最近 30 天每天提交、系统错误、在线人数和正在上课的班 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:17:00 +08:00
xuyueandClaude Opus 5.5 09e5e0bfcf feat(后台 AI 报告): 报告列表带上学生是哪个班的 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:11:07 +08:00
xuyueandClaude Opus 5.5 591c7bcab9 feat(后台比赛): 比赛列表带上每场几道题、几人参加，按开始时间排，复制出来的旧比赛不再跑到最前面 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:07:24 +08:00
xuyueandClaude Opus 5.5 ba823ecb7d feat(后台用户): 用户列表能按班级筛、按用户名排、看出几人从没登录；批量建号前能查重名，新班级建好自动加进班级列表 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 13:56:03 +08:00
xuyueandClaude Opus 5.5 952edbf86f feat(后台题目): 题目列表带上做对 / 做过的人数和「学生看得到 / 藏着的」各几道，能一次放出或藏起好几道题；比赛题目也能按题号搜 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 13:27:39 +08:00
xuyueandClaude Opus 5.5 4240a451e4 chore(站内信): 消息页、后台空壳页、两个接口和 message 表一起下线
Deploy / deploy (push) Canceled after 0s
Details 
历史上一共 6 条站内信（最后一条 2025-06），发信接口两代前端都没接过，后台页面只有一句
「未完待续」，OJ2 顶栏也没有入口。

0033 是 DROP TABLE，部署要显式放行：OJ2_ALLOW_DESTRUCTIVE=1 docker/deploy.sh，
或 CI 手工触发时勾 allow_destructive。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 00:51:12 +08:00
xuyueandClaude Opus 5.5 3ca3b42997 fix(排名): 老师点「本班」不再随手挑个交题最多的班，改成布置过作业的班、上次选的班，都没有就停在全部
Deploy / deploy (push) Canceled after 0s
Details 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 23:28:55 +08:00
xuyueandClaude Opus 5.5 6e946c99fb feat(出题): 参考流程图改用画布画，「让学生自己画」不再要参考图
Deploy / deploy (push) Canceled after 0s
Details 
- 学生画的图现在按例子和测试数据评（拼成程序跑），参考图用不上了：「让学生自己画」
  只剩一句说明，保存前改成检查有没有例子；「给学生的提示」那一栏去掉（学生从来看不到，
  16 道题也都没填）
- 「给学生看一张参考流程图」改用学生画图的同一个编辑器，存结构树（problem.flowchart_data，
  原来是死列），Mermaid 由后端照它生成，题面里的图和学生交的图同一套形状
- 「AI 照 Python 答案画一张」改成出结构树，直接摆在画布上接着改；for 循环画成
  计数变量 + 当型循环
- 老题手写的 Mermaid 照旧给代码框，旁边「改用画布画」

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 21:39:50 +08:00
xuyueandClaude Opus 5.5 318ffac90f feat(年度趋势): 历年概况那张表只有一堆数、看不出趋势；改成按届比，这届和往届在同一批题上逐题比一次就对 
- 新接口 /problem-analytics/grades：每道题在各届（班号前两位）的人数和一次就对人数
- 删掉 /problem-analytics/yearly 和只给它用的学年时间函数

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 13:10:18 +08:00
xuyueandClaude Opus 5.5 b2c802174c feat(卡点分析): 「卡住」原来数的是错过一次的人，做的人多的题全排在前面；改成看一次就对、交几次才对，能按班级和时间段筛 
- 卡点按「人 × 题」算：一次就对、做对之前交了几次、还没做对几人，带知识点；一道题给每个人的情况、错在哪、全站历年一次就对
- 年度趋势换成历年概况：学年按 9 月切（原来按自然年），进行中的学年和去年同期并排
- 删掉旧的 /problem-analytics/stuck 全站前 40 和 /ac-trend

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 12:55:49 +08:00
xuyueandClaude Opus 5.5 11194543a3 feat(自学): 教程有了「所属项目」和课末的相关题，正文里的代码能直接运行 
- 0031 迁移：tutorial 加 project 列（从正文「所属项目：」回填），新表 tutorial_problem
  挂每课的相关题（两头 CASCADE）
- 学完一课 = 练一练全对（契约 isLessonDone），不再按停留满 3 分钟算
- /tutorials/:id 带相关题和做对没有，/tutorials/:id/exercises 带每道做对没有
- /trial-runs 收 tutorialId：教程里的代码块走同一台判题机跑一组
- 后台：教程列表带练一练 / 相关题数 / 打开过的人，拖动排序、项目改名、挑题候选（必会题在前）
- 自学情况换成学生 × 课的方块格（/learn-analytics/board），默认班和排名页同一套猜法

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 09:40:34 +08:00
xuyueandClaude Opus 5.5 646c57c748 refactor(题单): 难度、状态、分数、提示、总分、百分比和 problemset_submission 表不再读写，先补默认值、下一步再删
Deploy / deploy (push) Canceled after 0s
Details 
机房和服务器共用一个库、不一定同时升级，所以分两步退役：0027 只给还非空的几列补默认值，
新代码插行不用再填、没升级的那边照旧能跑；两个站点都换上新代码后，再单独一条迁移删列删表
（要手工放行破坏性迁移，语句写在 0027 的注释里）。

进度算法随之去掉分数和百分比，判题记进度不再往 problemset_submission 写一行（从来没人读）。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 22:08:15 +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 b94e028ff4 feat(比赛): 榜单一次给全，带名次变化和每题谁最先做对；期中、期末考试中学生看不到排名；老师能看全班情况 
- GET /contests/:id/scoreboard 代替 /rank：整张榜、5 分钟前的名次、每题做对 / 做过人数和学生里最先做对的人（不再用 is_first_ac，老师赛中试做会占掉它）
- 期中、期末进行中：学生只拿到自己那一行，人数清零、「全班最先」也不给，考完一起公布
- GET /contests/:id/class-view（老师）：真名、每人最后一次交、没进来的人 —— 比赛不绑班，来了一半以上的班才算这场的班
- 比赛列表带题数、参赛人数、我的名次和做对数，能筛「我参加过的」「期中 · 期末」
- PUT /admin/contests/:id/problems/order：比赛题按顺序重编 1、2、3，比赛结束后不让动
- 后台「审核」列表接口去掉，并进前台老师的成绩页；「看过了」的写接口留着

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 20:58:59 +08:00
xuyueandClaude Opus 5.5 ba5b9ada0e feat(后台): 编程题出题页重做——左边写，右边是学生看到的样子；例子和测试数据的输出都由标准答案跑出来，改老题能直接看、改测试数据 
- 例子就是测试数据里勾了「当例子」的几组，不再手抄输出；老题的例子不在测试数据里的补到最后
- 改了答案，输出变了的那组标黄、写清原来存的是什么；答案在某组上报错就挡住保存
- 没存标准答案的老题输出手写；太大的测试数据（>100 组或单文件 >32KB）只能导入 / 下载 zip
- 预制代码只写学生看得到的那段，前后藏起来的代码收进折叠；语法要求先拿标准答案自测
- 流程图两个互斥开关改成三选一；时间 / 内存限制能改了；草稿只给新建页
- 后端：读回测试点原文、语法要求自测、AI 想测试输入三个接口

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 20:07:34 +08:00
xuyueandClaude Opus 5.5 033a245abb feat(SQL 题): 增删改题除了第 1 组，其余测试数据可以一行都不改——用来抓学生多改（WHERE 写漏、写宽）
Deploy / deploy (push) Canceled after 0s
Details 
原来每组数据都必须有被标准答案改到的行，所以「这组里没有研发部，看学生会不会把别的部门也改了」
这种测试数据建不了。现在只有第 1 组（题面上给学生看的那组）还要求改到行；其余组一行都没改时
出题页写「一行都没改」、预览写「执行后所有表都没有变化」。删掉第 1 组、别的组顶上来时自动按
新位置重查。判题本来就不管这一条，不受影响。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 19:17:42 +08:00
xuyueandClaude Opus 5.5 2cb39fd96b feat(后台): SQL 题有了自己的出题页——左边写，右边就是学生看到的样子，改答案、改数据马上重跑 
- 「新建题目」先选编程题还是 SQL 题，选了就不能改；编辑时按题目本身进对应的页
- SQL 出题页（设计稿「SQL 出题页」方案 B）：测试数据一组一行，改完自动重跑，
  跑不通的用中文说原因；保存时才打包上传测试点，不用再手动「预览」「上传」
- 新建时存草稿，误关页面不丢
- 编程题出题页去掉 SQL 那一堆分支（以前勾上 SQL 会静默清掉语法要求和流程图）
- 题目列表能按题型筛，SQL 题标题后面挂标签

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 18:59:15 +08:00
xuyueandClaude Opus 5.5 30f34f0e36 fix(老师权限): 老师在自己比赛里点题目「可见」没反应、看不到学生的智能分析入口等一批权限错位 
- 比赛题的可见开关按题目作者判归属，从题库加进比赛的题作者是别人，老师点了 404 且无提示；
  改成和编辑、删除一样按比赛创建者判（canEdit）
- 学生主页「智能分析」和「查看指定用户」只给超管，后端本来就允许老师；改成老师可见
- 排名页班级详情的「AI 分析」学生也看得到，点了权限不足；只给老师显示
- 班级 PK 页解构 store 丢了响应性，资料晚到时老师看不到「AI 分析」
- 学生管理员能给任何人的流程图重新评分且不限流；别人的提交只有老师能重评，免限流也只给老师
- 超管没退登就过期的机房电脑上，下一个登录的老师继承演示模式、看不到后台和看板且关不掉；
  演示模式只对超管生效
- 老师的出题权限能设成「无权限」，设了比赛题目页全是权限不足；后端兜成「仅自己」，
  编辑框里老师不再给这个选项

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-08 14:00:04 +08:00
xuyue bde387e8bc fix
Deploy / deploy (push) Canceled after 0s
Details
2026-10-08 12:29:35 +08:00
xuyueandClaude Opus 5.5 d07459928d feat(标签): 题目列表的标签分成「知识点」「主题」两组，新建的标签在后台标出待归类
Deploy / deploy (push) Canceled after 0s
Details 
- 迁移 0022：problem_tag 加 category（knowledge / theme）和 category_confirmed；
  存量 25 个题材、题集类标签归主题，其余归知识点，全部记为已确认
- 前台题目列表按两组显示标签，组内按题目数从多到少
- 后台标签管理：每行切换分类；出题时新建的标签默认知识点、标「待归类」并排在最前，
  页头提示待归类数量，可点「确认」保留默认；加分类筛选
- 新接口 PUT /admin/problem-tags/:id/category，设置分类即视为确认

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 20:38:43 +08:00
xuyue d25b5dbe6d update
Deploy / deploy (push) Canceled after 0s
Details
2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5 23844ae301 fix(班级筛选): 输入 ks251 会把 2511 班的学生也算进来
Deploy / deploy (push) Canceled after 0s
Details 
班级号 3~4 位并存，按用户名前缀/包含匹配时 ks251 会捞到 ks2510~ks2519。
新增 classPrefixCondition：ks + 3 位以上数字按具体班级匹配（后面不能再跟数字），
1~2 位仍是年级前缀。后台首页的用户排名、随机抽签，以及题单的学生进度筛选
（只填数字时补上 ks）都改用它。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 19:34: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 f8b04af4ea chore: 加 oxlint，现存 19 条 warning 清零
Deploy / deploy (push) Canceled after 0s
Details 
原来只有 Prettier，没有任何 lint。根目录加 `bun run lint`（oxlint，覆盖后端、前端、
契约，--deny-warnings：有一条就算失败），CLAUDE.md 常用检查里加上。

现存 19 条顺手清掉：
- 11 处未使用的 import / catch 参数 / 回调参数
- oj/store/problem.ts：`...problem.value?.languages` 展开可能是 undefined
  （外层 if 已经保证非空，去掉 ?.）
- admin/problem/detail.vue：`contestId = contestId` 自赋值，删掉
- judge/sql/engine.ts：注释里的 `/*x*/` 示例原来靠零宽空格防止提前闭合注释，
  改成 `*\/`
- 其余：多余的 !!、new Array(n)、展开里多余的 `|| {}`

两边类型检查、前端构建、后端单二进制编译都过。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:25:27 +08:00
xuyueandClaude Opus 5.5 e17da63fc6 fix(上传): 头像和题面插图按文件头认格式，不信扩展名 
原来只看扩展名：改个后缀什么都能落盘，再由 /public/* 按扩展名配 content-type
发出去。线上 Caddy 有 nosniff 兜着，但不该把非图片存到盘上。

- services/image.ts：按 PNG / JPEG / GIF / BMP 的文件头识别，返回落盘用的扩展名 ——
  以内容为准，改名成 .png 的 JPEG 存成 .jpg，content-type 才对得上
- 头像上传、后台插图上传都走它；插图那边扩展名白名单保留当第一道快速筛
- serveUpload 自己也带 x-content-type-options: nosniff，不只靠 Caddy

实跑核过：真 PNG / GIF 正常；改名成 .png 的 JPEG 存成 .jpg；改名成 .png 的 HTML
两个入口都拒；/public/upload 回 image/png + nosniff。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:15:36 +08:00
xuyueandClaude Opus 5.5 925cecb389 refactor(题目): 新建 / 复制题目收成 validateProblem、insertProblem、copyProblem 
admin/problem.ts 里四处 insert(schema.problem) 其实是两对重复：

- 新建公开题 / 新建比赛题：公共校验 + SQL 展示数据 + 插入 + 写标签，逐行一样，
  只差 contestId。编辑题目那条也抄了同一段校验。收成 validateProblem（校验 +
  展示数据）和 insertProblem（插入 + 标签，一个事务）。比赛题当初就是抄漏了
  sqlDisplay，现在三条路径只有一份
- 比赛题转公开 / 从公开题库拉进比赛：复制整行 + 统计清零 + 复制标签，收成 copyProblem

顺带 db/index.ts 加 DbOrTx 类型，四处 `tx as unknown as typeof db` 去掉。

唯一的行为差异：编辑题目时 SQL 展示数据的生成挪到了题号查重之前（和新建一致），
两项同时出错时报的是前一个。

实跑核过：新建公开题、编辑、重复题号 409、新建比赛题、比赛题转公开（不可见、
标签跟过去）、从公开题库拉进比赛（可见、标签跟过去），SQL 题测试点缺失时照样拦下。
测试数据已删。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:07:13 +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 f90d01338e feat(自学情况): 按学生加姓名/学号搜索，后端补稳定排序
Deploy / deploy (push) Has been cancelled
Details 
搜索是纯前端过滤（整表本来就一次拉完），和班级筛选可以叠加。

学生查询原来没有 orderBy，前端默认按「已读」升序排之后，同分的一大批
（尤其一堆 0）落回聚合的任意顺序，刷新一次换一个样；按班级、学号兜底。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-17 02:23:01 -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 cc51e305cf refactor(时区): 常量收进契约、SQL 统一走 localTime，去掉会话时区与 TZ 兜底
Deploy / deploy (push) Has been cancelled
Details 
- TIME_ZONE / TIME_ZONE_OFFSET_MINUTES 移到 packages/contract/src/time.ts，
  前后端共用一份，不再各写一遍靠注释对齐。
- apps/api/src/time.ts 新增 localTime(列)，替换散落 7 处的
  `at time zone ${TIME_ZONE_SQL}`；ac-trend 的 where 复用同一个 year 表达式。
- /problems/:displayId/yearly-ac 漏写了时区、按 UTC 切年，被会话时区兜底掩盖；
  改为按东八区切（只影响每年 12-31 北京 0–8 点的提交归年）。
- 删掉数据库连接的 TimeZone 和 Dockerfile 的 TZ：正确代码不依赖它们，
  它们只会在线上掩盖漏写处、让 dev 与线上答案不同。
- time.ts：calendarDayYearsAgo/pad 并入 shiftMonthsByCalendar，startOfCalendarDay
  并入 todayStart，localWeekday 改用 getUTCDay，删掉历史叙述注释。
- 前端 zonedParts 改为固定偏移 + getUTC*（与后端、日期选择器同一写法），
  去掉 Intl formatToParts；10 万次 299ms → 11ms。zonedYear 去掉按浏览器时区的兜底。
- 两份 CLAUDE.md 同步；n-date-picker 那条过时说明改成现用法。

验证：新旧「近两年起点」21359 个时刻 0 差异、localWeekday 0 差异、
前端固定偏移与 Intl 在 America/New_York 下 47821 个时刻 0 差异；
localTime 在 select/group by/where 复用可用；fix-achievement-hours 预演仍为 148 / 60。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd
 2026-09-14 06:06:52 -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 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 6bef55904f fix(题目分析): 「卡住的题」只看公共题，别把比赛题也算进来
Deploy / deploy (push) Has been cancelled
Details 
这条查询原来一个 where 都没有，比赛题一起进榜。隔壁 ac-trend 在同一个文件、同一块
面板，isNull(contestId) 写得明明白白，所以判定是漏写而不是口径选择。

比赛题的题号是每场比赛各自从 1 开始编的（快照里 61 道不同的题都叫「1」、61 道叫
「2」），一旦挤进前 40，那一行显示的题号会指向一道根本不存在的公共题。眼下还没
发生：前 40 的门槛是 97 人卡住，比赛题最多的一道是 59 人 —— 但两个班一起考的场次
有 95 人，撞上一道难题就够得着。

对公共题的数字没有任何影响：比赛提交挂的是比赛自己的 problem 行（快照实测两个方向
的交叉都是 0 条），公共题那一行本来就只统计自己的提交。实跑接口逐行比对，改前改后
前 40 集合完全一致，只有三处并列名次的先后不同 —— 那是这条查询本来就没有确定性
tiebreaker，并列的题在两次刷新之间也会自己换位置。

顺带能用上 0013 的 submission_public_metrics_idx：183ms / 18646 buffers →
80ms / 788。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd
 2026-09-08 18:30:05 -06:00
xuyueandClaude Opus 5 64ad6139f5 fix(后台用户): 删账号前拦住还有提交的人，改名回填按 user_id 
两处都是「提交与用户的归属」在写路径上没维护住。

删账号：处理器那段注释早就点到了 submission.user_id 没有外键、全连坐会留下孤儿行，
但只把它当成「不改成 CASCADE」的理由，没有加对应的检查。结果是报错文案里写着
「该用户还有提交、题目等历史数据」，而提交恰恰是唯一拦不住的那一类 —— 只交过题、
没拿过成就没进过题单没参加过比赛的学生照样删得掉。

生产快照实测复现：删 id=1454（李若菡，13 条提交）返回 200 deleted:1，用户没了、
13 条提交留在库里，孤儿总数从 935 涨到 948。那 935 条就是这么攒出来的（28 个已删
账号）。线上今天还有 5 个这样能删的学生。

补一次提交查询把它拦下来，和 delete 放同一个事务里免得中间正好交了一发。文案一个
字没改 —— 它本来就是对的，缺的是兑现它的代码。混批删除整批回滚，干净的那个也留着。

存量 935 条不动：四条读路径现在都用 leftJoin 兜住了，列表显示冻结的名字、不出死链，
统计按 user_id 聚合他们本来就不在花名册里。加外键得先清历史数据，收益只有「以后
不再产生」，而那一半这次已经解决了。

改名回填：条件从「等于旧用户名」改成按 user_id。前者只改得动当前正好还等于旧名的
行，一个已经漂移过的账号再改一次名，更早那批仍然改不动 —— 库里 726 条挂着旧名字的
提交就是旧栈时代这么留下的，之后每次改名都从它身边绕过去。实测拿 user 2039 验过：
user 表叫 ks248吴紫妍、13 条提交挂着 ks24数媒1班ks吴紫妍，老写法一行都匹配不上，
改成按 user_id 之后一次拉平。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KqjE6qPo67fqVDKn6Bx7yd
 2026-09-08 18:29:19 -06:00
xuyueandClaude Opus 5 856b7a280e feat(后台用户): 新增「在线优先」排序，列表直接显示在线标记 
在线状态库里没有、会话也判定不了 —— session 的 TTL 是 7 天且每次请求续期，
「有会话」只说明这人一周内来过。新开一个 Redis sorted set（auth/presence.ts）
记最后活动时间，5 分钟内有活动算在线。

写入全搭在已有的 pipeline 上，不多一趟往返：登录、每个带鉴权请求的续期、
以及 touchSession —— 只挂着 WebSocket 不发请求的人靠最后这条，sweepSessions
每 60 秒一轮，所以窗口取 5 分钟，明显大于那个间隔。登出、改密码、禁用账号
会立刻把人摘掉；过期成员在后台读列表时顺手清理（整个 key 不能设 TTL，
ZADD 不重置 key 的 TTL，到期会把还在线的人一起抹掉）。

排序 orderBy=-online 先捞在线 id，SQL 里 case when 分两档，档内继续按
最近登录排；没人在线时那个 case 恒等于 1，直接省掉。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2
 2026-09-07 19:30:45 -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 498fc1ceca fix(后台): 会话吊销、导入查重、练习题校验，以及一批后台页面的小毛病
Deploy / deploy (push) Has been cancelled
Details 
后台代码审查后的一批修复。

后端：
- 改密码 / 重置密码 / 禁用账号现在真的把该用户所有设备的会话删掉。原来只
  publishSessionRevoked 广播断 WebSocket，HTTP 拿着旧 cookie 照样能用到会话
  自然过期 —— 给被盗用的账号改密码等于没改。为此在 Redis 里补了反向索引
  user-sessions:<id>（createSession 写入、登出和失效路径清理、跟着会话续期）。
- 导入用户补齐校验：邮箱走 z.email()、批内查重、库内查重，用户名和邮箱各报各的；
  用户名和邮箱都归一成小写，和登录的 lower(username) 比较口径对齐。以前导入这条
  路什么都不查，而前端占位邮箱按「班级+批内序号」拼，同一个班导第二批必然重号，
  那两个账号从此在后台保存一次就撞 409、再也改不动。前端生成的占位邮箱同步加了
  每批随机后缀。
- PUT /users/:id 的邮箱查重改比 lower(email)，存量大小写混着的数据也能拦住。
- 删用户的裸 catch 收窄成只认外键冲突 23503（顺 cause 链找，drizzle 0.45 把驱动
  错误包了一层），别的错照常抛 500，不再把连接故障说成「该用户还有历史数据」。
- 练习题 data 补语义校验（services/exercise.ts）：没有 {{空位}} 的填空题、空选项的
  选择题、越界的下标等一律拒收。以前后端零校验，坏数据只有学生端会撞到。
- PUT /judge-servers/:id 改用 queryInteger，非数字 id 回 404 而不是 500。
- 比赛克隆不加归属校验是**有意的**（快速再开一场以前的比赛；保密边界在师生之间不在
  教师之间），把这条政策和它的副作用写进注释，免得反复被当成漏洞。

前端：
- 编辑用户弹窗的「班级」输入框改成只读 —— 它一直是个改了没用的控件，班级由后端从
  用户名推导。
- 新建用户预填唯一占位邮箱、角色默认改成实际会建出来的 Regular User、密码留空直接拦。
- 比赛题目列表的列过滤写的是 top_reaction，实际 key 是 topReaction，空列一直没被滤掉。
- AI 生成流程图加 try/finally，接口失败不再把按钮卡在 loading。
- 单个判题机删除后刷新表格；后台首页显示在线判题机数量（后端一直在下发）。
- 下载测试点失败时读 Blob 里的错误信封弹提示，不再毫无反应。
- 练习题编辑器补上和后端一致的前置校验。

验证：tsc / vue-tsc / vite build / check:routes 全过；后端每条改动都在本机起服务
实跑确认（会话吊销、导入各种重复、练习题七种题型、外键 409、非数字 id）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RC5uL72UY9aZFuTvUKe2jv
 2026-09-06 08:41:54 -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 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 286487acf3 fix(自学): 少于三分钟的不算已读 
原来只要打开过（viewCount > 0）就记成已读，于是「点开看一眼就退」和「认真读完」
在老师那张表上长得一模一样，「已读 17/17」并不说明他学了。加一道 3 分钟的门槛 ——
按最短的一课定的下限，读不完还翻不动的课文，扫一眼是到不了这个数的。

阈值 TUTORIAL_READ_SECONDS 放在 contract 里，前后端共用一个数：学生端目录的 ✓、
后台「按学生」的已读课数、「按课程」的读过人数，三处口径必须一致，各写各的迟早分叉。

**累计时长故意不卡**。时长记的是真实停留，不满三分钟的秒数照样算进去，于是
「已读 0 课、累计 25 分钟」成为一种能看见的状态 —— 他翻了很多课，每课都没读满。
这正是这道门槛想让老师看见的东西，把时长一起滤掉反而把信息删了。

「按课程」的人均时长跟着改了分子：分母是读满三分钟的人，分子就得是同一批人的时长，
否则拿全部时长去除达标人数，人均会被翻一眼就走的人凭空抬高。

顺带修掉「✓ 已读 · -」：心跳 15 秒一跳，点开就走会落在 0 秒上，而 readableDuration(0)
返回的是 "-"。新口径下打勾要求 ≥180 秒，这个组合不可能再出现；打开过但没读满的
显示灰色的「读了 N 分钟」，记是记下了，只是还没到「已读」。

后台筛选栏上方写了一行口径说明，免得老师对着「已读 0 课 / 累计 25 分钟」猜是不是坏了。

本机实跑：student 读 A 课 500 秒、B 课 60 秒 → 已读 1/2、累计 560 秒；
A 课「读过 2 人、累计 700、人均 350」，B 课「读过 0 人、累计 60、人均 0」。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013rpSKCNpVcMhTFhw21YiL7
 2026-09-02 20:37:30 -06:00
xuyueandClaude Opus 5 bd84599174 feat(自学): 教程和练一练都留痕，老师能看到谁学了多少
Deploy / deploy (push) Has been cancelled
Details 
自学模块以前一个字节都不落库：读到第几课只存在浏览器的 localStorage 里，
练一练的对错是组件内的一个 ref，刷新即失忆。老师能看到的只有「谁交了题」。

现在两张新表：
* tutorial_progress —— 一个学生 × 一课，记打开次数和累计停留秒数
* exercise_attempt  —— 一个学生 × 一道练习，记试了几次、错了几次、
  第几次做对的、最后一次做错时填的什么

都存聚合不存流水。练习那张表尤其明显：流水会随着学生反复点提交无限长，
而多出来的行回答不了任何新问题 ——「他第 3 次和第 5 次都选了 B」对老师
没有意义，「他试了 7 次才对」有。

停留时长只在页面可见、且十分钟内有过操作时才计。机房的电脑经常开着页面
就走了，不设这道闸的话「停留时长」会变成「电脑开机时长」，老师看到的
数字全是假的。换课、切标签页、关窗口都会先把攒着的秒数冲给**离开的那一课**。

练一练的对错仍然是前端判的：答案本来就随题面一起下发到浏览器，后端再判
一遍也挡不住任何人，只是重复实现七套判题。所以这是教学观察数据，不是成绩。
`last_wrong_answer` 存的是前端拼好的一句人话（「选了 C」「顺序 3-1-2」），
不是原始作答结构 —— 七种题型形状各不相同，存结构就得在后台按题型各写一套
渲染，而老师要看的只是他错在哪。

顺带修掉预测输出题的一个老问题：它的 `submitted` 一旦为真就不再收回，而
`allCorrect` 是跟着输入实时算的，于是学生错一次之后把答案改对，界面直接
跳成「输出正确！」、提交按钮同时禁用，submit() 再也执行不到 —— 这道题
**永远不会被记成做对**。排序/连线/找错/分组四种题本来就在交互处把 submitted
置回 false，只有这里漏了，按同一套补上。

学生端：目录每课显示「✓ 已读 · 11 分钟」和「练一练 3/5」。教程保持免登录
可读，未登录只是不留痕，并明说一句。

老师端：后台新开「自学情况」（教师及以上可进），三个 tab ——
按学生（默认把读得最少的排在最前，这张表要回答的是谁还没开始）、
按练习（每道题的正确率、一次做对几人、做对的人平均试几次；展开看逐人明细
和他们最后错在哪）、按课程。班级框填 3-4 位是具体班级，1-2 位当年级前缀。

外键用了库级 CASCADE，和 Django 建的那批 NO ACTION 不同：删教程、删用户
不必再记得回来手工清子表。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GW5ef6C2kRW8Ru27ghCaUu
 2026-09-01 08:54:27 -06:00
xuyueandClaude Opus 5 a2f67eebf6 perf(用户导入): 批量导入从几秒降到半秒
Deploy / deploy (push) Has been cancelled
Details 
导入一个班（45 人）要转好几秒，慢的全在密码哈希这一处：

- 哈希在重名检查之前算。老师习惯把同一份名单粘两次，那种情况要白等
  一整个班的 argon2 才看到 409。把校验和重名查询提到前面，这条路径
  现在是 5.6ms 返回。
- 45 次 argon2 串行 await。改成固定 4 路并发池；不用 Promise.all 是因为
  oj-api 的 mem_limit 只有 512m，一个年级 300 人全量并发撑不住。
- argon2id 参数从 Bun 默认的 m=64MiB 显式降到 OWASP 推荐下限 m=19MiB，
  单次 140ms → 20ms。参数编码在哈希串里，存量账号照常验证、不用迁移，
  旧的 pbkdf2 那条分支也不受影响。

45 人端到端 2.04s → 0.55s。验过：旧 m=65536 的哈希、新 m=19456 的哈希、
Django 的 pbkdf2 三种都能正常登录，错误密码照常拒绝。

顺带把生成页下载的 CSV 裁成用户名和密码两列 —— 发给学生的就这两样。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QqqZwxtXLo2GTqMi51C94D
 2026-09-01 00:28:16 -06:00