xuyue/OJ2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
598 Commits 1 Branch 0 Tags
55038cc78ba36f712782d4f2e27d1c3be128e0a3
Commit Graph
63 Commits
Author SHA1 Message Date
xuyueandClaude Opus 5.5 10d2638c23 feat(首页): 学生上课时首页最上面就是这节课和「接着做」，课后先看上次没做完的；老师有了自己的首页，看今天哪些班在上课、点进课堂看板
Deploy / deploy (push) Canceled after 0s
Details 
去掉和顶栏重复的找题框、常年空着的比赛卡、底部快捷入口，公告只留置顶那条。
修了当天上午上课、下午再登录时写「上次（今天的日期）还有几道没过」。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 14:53:38 +08:00
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 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 e368ed3eca feat(个人主页): 主页改成名片 + 两栏，做对的题按天带题名；设置并进主页，点头像换头像、点笔改签名 
- 名片：头像、班级、签名、做对几道 / 本班第几 / 成就，底下一排四个时间（第一次提交、最近一次提交、距上次提交、学习天数）
- 做对的题按日期或按知识点，能搜；最上面一行是交过还没做对的
- 知识点本人和老师看得到；同学看多一张「你和他」
- 老师看学生：看他的智能分析 / 看他的提交 /「⋯」不计入排名、清空签名
- 换头像弹框：拖圆圈选一块，看领奖台和排名里多大，可退回名字的字
- 去掉「我的设置」页和下拉菜单里那一项；手机三个页签

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-13 00:03:37 +08:00
xuyueandClaude Opus 5.5 e4abbc1645 feat(智能分析): 页面改成每节课一行，一眼看出哪道一次就对、哪道交了很多次、哪道还没做对
Deploy / deploy (push) Canceled after 0s
Details 
一年热力图、半年月度图、难度分布、时间活跃度这些对多数学生大半空白的图都去掉了；
右边是差一点的（接着做）、错在哪、知识点；老师看学生能 ‹ › 翻同班下一个人。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 23:20:34 +08:00
xuyueandClaude Opus 5.5 845e41c060 feat(自学): 自学重做——首页课程地图、读一课按项目分目录、代码块就地运行、学完给题做
Deploy / deploy (push) Canceled after 0s
Details 
- 顶栏「自学」进新的自学首页 /learn：接着学（按服务端记录，不再串到上一个学生）+ 按项目分组的课程地图
- 读一课：左边目录按项目折叠，正文加宽，右边本课大纲带练一练标记；去掉了不能运行的示例代码栏
- 正文里的代码块能改能运行，报错用题目页那套中文解释；读输入的代码出输入框
- 课末：练一练做到几道 → 学完了 → 老师挑的几道题（必会标出来）→ 下一课
- 练一练统一成绿色提交、结果一行字；手机版目录从底部弹出
- 后台：教程列表按项目分组拖动排序，编辑页左写右看、练一练插到光标处、挑相关题；
  自学情况改成方块格 + 还没打开过的名单

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-12 09:40:34 +08:00
xuyueandClaude Opus 5.5 2553c6ddfe feat(排名): 个性签名挂到排名上，领奖台上每人一句、「你」卡里就地改；全服排名只列到第 100 名，展开不再卡死 
- 领奖台：头像旁边一个签名气泡（手机在头像上面），只露两行，长的指上去看全文
- 「你」卡：自己的签名带「改」，就地改不用跳设置页；没写的提示「写一句个性签名」；前一名、后一名名字下面带他们的签名
- 赛道：桌面有签名的名字后面一个引号，指上去看；手机直接写在名字后面
- 个性签名以后限 30 个字（老的长签名不动，榜上只露两行）
- 老师在名单「⋯」或台上气泡的「×」能清空不合适的签名（DELETE /rankings/mood/:userId）
- 全服名单最多列到第 100 名：原来展开会一次摊开一千五百多人把页面卡死

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-10 09:52:06 +08:00
xuyueandClaude Opus 5.5 ce0093fc29 feat(班级PK): 班级 PK 页重做：两个班看比分和每道题谁赢，三个班以上看题目对照格，学生也能比
Deploy / deploy (push) Canceled after 0s
Details 
- 两个班：大比分 + 一次就对副比分，每道题左右两根条、差得最多的在上，下面每周人均和全班分布
- 三个班以上：一行一道题、一格一个班，越深做对的人越多，皇冠是这道做得最好的班；右边谁领先的题多和赛跑
- 学生自己的班标「你们班」，输掉的题写「再 N 人做对就打平」；AI 分析只给老师，直接在页面里出
- 去掉综合分、雷达图、十张柱状图；手机版按稿改成上下排和页签
- 排名页、班级对抗、班级详情的入口对登录的人都开放，带上当前的班

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-10 09:06:21 +08:00
xuyueandClaude Opus 5.5 3c6e4a1e7c feat(排名): 班级详情改成右侧抽屉、老师能在里面直接出 AI 分析；排名页加上个人智能分析入口；用词改成前一名 / 后一名
Deploy / deploy (push) Canceled after 0s
Details 
- 班级对抗点班名打开班级详情：人均做对和年级比、中间那位同学、做对过的人、全班分布点阵、
  每周人均新做对；去掉四分位数、标准差、综合分。老师多看到「要多关心的同学」（这学期做对不到
  3 道）和 AI 分析，报告直接在抽屉里出
- 班级 AI 分析只传班号，数字由服务端按抽屉同一套现算（services/ranking.ts），报告和抽屉对得上
- 学生「你」那张卡底下加「看我的智能分析」；老师名单「⋯」加「看他的智能分析」；班级对抗右上角
  「班级 PK ›」
- 「要追的 / 追你 / 冲得最猛 / 对手」会被学生读歪，改成「前一名 / 后一名 / 进步最大」，
  对前后一名只说「比你早 / 晚几秒做到几道」
- 老师打开排名页默认看全部，班级下拉框第一项「全部」，选了班就切到本班

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-10 07:58:52 +08:00
xuyueandClaude Opus 5.5 1c6e2b9d82 feat(排名): 排名页重做成领奖台加全班赛道，一眼看出自己第几、该追谁、谁在追自己
Deploy / deploy (push) Canceled after 0s
Details 
- 一张榜两个开关：本班 / 本年级 / 全服 × 这周 / 这学期 / 全部，默认本班 · 这学期。
  原来最大那张全服 Top100 里，这学期在用的 25 级学生一个都进不去
- 做对一样多的不再按「提交少的在前」排，改成先做到的在前；名次旁边写比周一升降了几名
- 「你」那张卡：第几名、再做对几道上领奖台，要追的人早你几秒、追你的人晚你几秒
- 本年级 / 全服只列前面一段和你附近一段，中间折起来，点开再看
- 班级对抗按人均做对比，另有我和对手的名次走势、这周本班、每周冠军
- 老师不上榜，选班看；每行「⋯」能把怀疑抄代码的学生设成不计入排名（新增 user.rank_hidden_at，
  首页周榜同样不算他），随时能恢复
- 去掉全服 Top10、日活两张图、在线人数和班级详情弹框里的统计词，以及它们背后的旧接口

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-10 07:26:15 +08:00
xuyueandClaude Opus 5.5 c17f88cdbb feat(题单): 题单页重做——布置中的放最上面，详情顶上一条进度和奖章阶梯，没加入看得见题点不进；老师看全班、后台一屏编辑
Deploy / deploy (push) Canceled after 0s
Details 
- 列表：布置中的大卡片（做对几道、布置到哪天、再做对几道拿哪个奖章），其余小卡片，加入过的在前
- 详情：进度 + 奖章阶梯（下一个金圈「再做对 n 道」），题目两列写几点做对 / 交过几次；
  以前做对过的标「旧代码先藏着」；做完整条变绿，烟花只在做完那一刻放
- 老师多一个「全班情况」页签；题目页从链接直接进来没加入时，条上给「加入题单」
- 后台一屏编辑：布置一周 / 两周 / 四周 / 选日期，公开开关，粘贴多个题号一次加，拖动排序，奖章只剩两种条件
- 旧代码藏着的地方都说清楚是哪个题单、哪天之后能看
- 修掉列表卡片把选做题数说成「新加了 N 题」

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 22:01:39 +08:00
xuyueandClaude Opus 5.5 151bbdcb50 feat(比赛): 比赛页一页看题目和自己的名次；排名竞争感做足、结束有领奖台；老师考试中看全班、考完看成绩；新建比赛一屏做完
Deploy / deploy (push) Canceled after 0s
Details 
- 学生比赛页（设计稿 B）：左边题目带几人做对、谁最先做对；右边我第几名、5 分钟里升了几名、再做对 1 道能到第几名、我前后的人
- 期中、期末考试中只有自己的进度，写明「排名考完公布」，题目页的排名入口也藏起来
- 排名页：按班筛、名次变化、最先做对的深绿格、自己那行钉住；结束后前三名领奖台 + 我的成绩卡；排名曲线和学生的「导出数据」去掉
- 老师的「全班情况」：卡在一道题、15 分钟没交的放最上面，没进来的人对上看板的请假；考完变「成绩」，点格子看代码、标看过了（代替后台审核页），导出成绩
- 比赛列表：进行中的一大块「接着比」，已结束的写我第几名，前三带奖杯
- 新建比赛：默认 10 分钟后开始，时长点按钮，搜题号把题加进来自动编号、拖动排顺序

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 20:58:59 +08:00
xuyueandClaude Opus 5.5 fcf63c2ecb fix(课堂看板): 作业里有 SQL 题就布置不上去（报「不能用 C 交」），也没法布置一节 SQL 课 
- 布置作业的语言加上 SQL，数据库课整节选 SQL
- C / Python 的作业里可以夹 SQL 题：SQL 题只收 SQL，不受作业语言限制，交对 SQL 就算做完
  （学生首页课堂条、看板格子、班里做了几个人三处一起改）
- 看板点 SQL 题的格子，提交列表按 SQL 筛，不再是一片空白；提交列表「这节课」遇到夹了
  SQL 题的作业不再按 C 筛

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 18:18:10 +08:00
xuyueandClaude Opus 5.5 98dfcc1e7e fix(题目列表): 「随便来一道」常抽到用自己的语言做不了的题，老师那边「只看没做完」开了看不出藏了什么
Deploy / deploy (push) Canceled after 0s
Details 
- 随便来一道：按学生在编辑器里上次用的语言挑（没用过按 Python），C 学生不再抽到 Python 专用题和 SQL 题，Python 学生不再抽到 SQL 题；选了 SQL 知识点或 SQL 类型才从 SQL 题里抽。也跟着「全部类型」的筛选走
- 老师那一版去掉「只看没做完」：没有状态列，开了只是题少了
- 题目页「相似题目」：流程图评到 A / S 的题也算做对，不再推荐，和列表打勾一个口径

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 16:56:34 +08:00
xuyueandClaude Opus 5.5 ed7752afbb feat(题目列表): 学生自己挑题时只看得到一堆标签和提交数，不知道自己练到哪了——改成左栏知识点进度、顶上先说做到了什么
Deploy / deploy (push) Canceled after 0s
Details 
- 左栏是知识点（可切到主题）和自己的进度：做了一部分写 37/96 加进度条，全做对写「通关」，
  一道没做对过的只写题数，不再是一整列 0/108
- 顶上一行：做对几道 · 这周 +n（或连续几周都有做对）· 离哪个成就最近 ·「有 n 道差一点」
  （点开才列出来）；新生引去「输出入门」；一言照旧在右边
- 每题最后一列是做对 / 做过的人数，代替提交数和按提交算的通过率（和题目页统计同一个口径）
- 「画流程图 / 语法要求 / 有参考图」挂在题目名后面，「全部类型」下拉单独筛这三类，
  不再混在排序里；题目页的「代码要求」统一叫「语法要求」
- 「只看没做完」开关（默认关）、「随便来一道」（当前知识点里先挑没做对的简单 / 中等题）
- 画流程图的题，流程图评到 A / S 在状态列也打勾，和题单、课堂条一个口径
- 老师看不到状态列和个人进度；出题者筛选保留

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-09 12:31:49 +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 773d15b033 feat(课堂看板): 「这节课的题」旁边多一个语言下拉，布置 C 的作业学生打开题目编辑器就是 C
Deploy / deploy (push) Canceled after 0s
Details 
默认是这个班上一次布置选的语言。学生那边首页、题号下拉、题目页课堂条都写上「C语言」；
打开这节课的题时编辑器自动切过去，每道题只切一次，学生自己再换就按他的。提交列表的
「这节课」连语言一起筛。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 09:54:21 +08:00
xuyueandClaude Opus 5.5 e3be3cd62c feat(统计): 「今日统计」「数据统计」合成一个「统计」，打开是一行一节课，这节课在最上面
Deploy / deploy (push) Canceled after 0s
Details 
老师的提交列表上只剩一个「统计」按钮；什么都没筛时按课列（选「今天」就是原来今日统计看的），
点一行进那节课（班、题、时段都带好），左上「← 全部」回来；只填题号时仍按班级汇总，和题目页
统计页签对得上。数字行加结果条，统计里的「课堂看板」按钮去掉，改成有班正在上课时才引过去。
学生仍是「今日统计」。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 09:23:54 +08:00
xuyueandClaude Opus 5.5 db493cebe4 fix(题目页): 统计页签的老师版回到讲这道题本身，各班只列一张表，不选班、不列人名
Deploy / deploy (push) Canceled after 0s
Details 
按人看谁没做对是提交页「数据统计」的活；表里点一个班就去那边看。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 00:50:01 +08:00
xuyueandClaude Opus 5.5 99319fdcc5 feat(题目页): 「统计」页签重做——学生看难不难、几次做对、常错在哪，老师按班看谁没做对 
- 全部按人算：原来的「通过数」是 AC 条数、「通过率」按提交算；击败用户、饼图、历年 AC 率去掉
- 错得最多的那种给一句该怎么办（都指向「运行例子」），自己交了 3 次以上还没对再多一张卡
- 老师选一个班：做对 / 交了没对（次数、最后结果）/ 没交；班里错得和全站不一样时点出来
- 题库入口工具栏的「课堂统计」并进这里（题单没有页签，按钮留着）
- 新接口 /problems/:id/stats（按内部题号，比赛题不再查到同号公开题），删掉 beat-count、yearly-ac

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 00:39:57 +08:00
xuyueandClaude Opus 5.5 91d9c9c6d7 feat(首页): 登录后不再弹「登录速报」，上次来做了什么、哪道还没做对放进首页，带「接着做」
Deploy / deploy (push) Canceled after 0s
Details 
- 新接口 /me/last-visit：上次登录到这次登录之间的题库提交，不调 AI（原来要同步等模型最长 60 秒弹框才出来）
- 班里今天在做时让位给班里卡，只在卡底留一句；班里那天就是上次来那天时两张卡合成一张
- 第一次登录说「欢迎来到判题狗」，隔了 30 天以上说「好久不见」
- 删掉弹框、store 和 /ai/login-summary

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-30 00:28:14 +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 0bcc981e6f fix(提交列表/统计): 按方向键会顺手切掉「代码/流程图」、重判后右栏还是旧内容、没人交时统计说「全都做完了」 
提交列表：
- 焦点在单选框、下拉框上时方向键不再一边切控件一边换条；跨页没回来前不再连跳一整页
- 重判、重新评分之后右栏重新拉，不再命中旧缓存；同一条新旧请求不再互相覆盖
- 从「我的提交」点顶栏「提交」、浏览器后退时，地址里没有的筛选回到默认
- 找回点用户名开个人主页；「只看他 / 只看这题」学生也能用；重判不用等代码拉下来
- 手机上老师也能重判、能按语言筛，流程图行有手机排版；学生界面带着的班级筛选显示成能点掉的标签
- mermaid 画不出来时先说中文、原始报错折起来

统计页：
- 没人交时说「这段时间没有人交」，不再说「全都做完了」；没填题号时各处统一叫「做对过题」
- 班级按 class_name 单独传；查询失败清掉旧数据并说清原因；标签跟着查出来的那一份走
- 「语法未过」的格子单独标「语」；正确率不算还在判的；截断提示说清哪些数字受影响
- 看板的请假隐藏只藏还没交过、没在举手的人，「恢复」只恢复这个班的
- 手机上筛选折行、上下排，不再挤出屏幕

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:52:58 +08:00
xuyueandClaude Opus 5.5 ed55ee5af6 feat(统计): 数据统计从弹框改成独立页面，左边题目、右边学生，一道题看全班每人的每一次 
- 课堂看板管这节课，统计管回头看：时间段默认「两节课」，还有这节课、今天、7 天、30 天、这学期、全部、自己选日子；不再自动刷新
- 选一道题看每人在这道题上的方块串，鼠标停上去看那次的代码；选「全部」每人一行、展开按题看
- 没选班级（从题目页进来）先按班级汇总；流程图统计有等级分布、四项雷达、各项平均分、词云和每人最好的一次
- 提交列表、题目页的「数据统计」改成新标签打开这个页面
- 「请假隐藏」挪到课堂看板：点名字旁的 × 藏两个小时，做完人数的分母一起减掉

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 18:28:27 +08:00
xuyueandClaude Opus 5.5 660f689a5c feat(提交列表): 重做成左边列表、右边代码，方向键一条条翻，不再开弹框 
- 右栏常驻选中那条的代码：编译失败 / 运行时错误用中文说清第几行错了并标红，
  老师看得到逐个测试点，学生看别人的只显示结果
- 老师一键「这节课」：筛到正在上课的班、这节课的题、今天
- 「正在评分」的行自己变成结果；新交的不插队，顶上提示「有 N 条新提交」
- 按天分组、默认每页 30 条；状态筛选补全，语言补上 SQL；流程图的评分详情也放进右栏
- 课堂看板的格子和名字能直接点进这个学生今天的提交

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-29 11:08:49 +08:00
xuyueandClaude Opus 5.5 11368813cc feat(流程图): 「写代码 / 画流程图」变成工具栏上的切换，AI 的评分和历次分数挪进结果页签，题单里也能画 
- 流程图题的工具栏最左边是「写代码 / 画流程图」。原来流程图藏在语言下拉里，叫一个名叫
  Flowchart 的「语言」；画完一道题之后它还被记成语言偏好，下一道能画的题一打开就是画布
- 「交给 AI 点评」交完切到「结果」页签：评的时候写着「AI 正在看你的图」、画布照样能改；
  评完是分数、评语、改进建议、四项得分，顶上一排历次分数，点哪次看哪次。
  原来是提交按钮旁一个 1000px 的弹框，盖住画布，翻历次评分要一页一页点
- 画到 A / S：给「照着它写代码 →」，题单里 1.5 秒后回题单（和代码通过一样），
  课堂条当场标成做完；只在这一页上刚评完的那次才算，进页面读到以前的 A 不跳
- 「把这一版载回画布」只在画布和那一版不一样时出现；载回、进页面读回草稿后都缩放到装下整张图
- 题单入口能画流程图了（原来只有题库入口能画），题单里的代码草稿、流程图草稿各存一份，
  加入题单之前写的、画的不会一进题单就摆在编辑器里
- 手机上不给「画流程图」（节点库是拖放，手机上拖不动），题面里以前画好的那张照样看得到

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-28 18:19:16 +08:00
xuyueandClaude Opus 5.5 a7f6ebaf49 feat(激励): 知识点地图——每个知识点做对几道、在哪一档、再做几道升级，首页一句话提示本周进步
Deploy / deploy (push) Canceled after 0s
Details 
现有 38 个成就全是累计量（通过几题、提交几次、连续几天），起步的人人都有、往上的够不着，
而且没有一个在说「你学会了什么」。连续打卡在这里结构上做不到：2025 秋学生最长连续交题
天数的中位数是 1 天，连续 7 天的只有 3 人。

- GET /me/knowledge：题数 ≥10 的知识点标签（10 个），每个给做对几道、档位、周一时的档位、
  下一档门槛；四档 入门 1 / 会了 3 / 熟练 题数 40%（≤10）/ 精通 75%（≤20）。
  回测 2025 秋：中位数学生一学期升 5 档；「入门」一档是给只做对一两道的 71 人加的
- 同班 ≥30% 点亮过的知识点才会出现在「还没碰过」里，免得 Python 班看到「C 语言」
- 个人主页加「我的知识点」，只在看自己时显示；首页一句话：本周升级 > 离下一档最近的 >
  去点亮一个班里在学的，点了去按知识点筛的题目列表

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 23:17:43 +08:00
xuyueandClaude Opus 5.5 80106eaa04 feat(课堂): 老师的课堂看板——布置这节课的题、看全班谁还没开始谁卡住了，布置的题直接出现在学生首页 
2025 秋平均每节课有 14 个平时在用的学生一道都没交（三分之一），交了 3 次以上还没过的
平均不到 1 个；而老师原来只能一道题一道题打开统计弹窗看。

- 新表 class_lesson（迁移 0023，仅建表）：一个班一天一行，存老师布置的 problem.id 与顺序；
  day 存东八区日历日文本，created_by CASCADE
- GET /classroom/board：这个班今天的题 × 全班学生（通过与否不限今天、今天交了几次、
  最后提交时间）；不给班级时猜最近两小时提交人数最多的班，不记老师上次选的
- PUT /classroom/lesson：按展示题号布置，对不上的题号点名拒绝，空数组 = 清掉
- /me/class-activity 优先返回老师布置的题（source = teacher），否则照旧推断
- 前端 /classroom：没交过的名单置顶，按 没交过 → 卡住 → 在做 → 做完 排序，15 秒刷新；
  投影模式只显示每题完成人数、不出名字；用户菜单给老师加入口
- 学生首页：老师布置的标题写「今天老师布置的题」，没人交时不显示 0/0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 22:37:59 +08:00
xuyueandClaude Opus 5.5 039992dc86 feat(前台): 顶栏可以输入题号直达；首页列出班里最近一次课一起做的题和自己的完成情况
Deploy / deploy (push) Canceled after 0s
Details 
课上老师报题号、全班去找，是 2025 秋七成非比赛提交的来路，界面上原本没有它的入口。

- 顶栏（桌面端）加题号框，首页「找题」同一套逻辑：题号对上直接进题，否则去列表搜
- 新接口 GET /me/class-activity：同班同一天 ≥5 人做过的题，取最近 7 天里最近的一天，
  附带我自己的状态与班里通过人数；首页据此显示「今天班里在做」卡片，没有就不占位

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 20:58:15 +08:00
xuyue d25b5dbe6d update
Deploy / deploy (push) Canceled after 0s
Details
2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5.5 a698ebf585 perf(前端): 首页和题目详情页按需加载，首页 477 → 380KB、详情页 1031 → 682KB（传输量）
Deploy / deploy (push) Canceled after 0s
Details 
浏览器实测（preview 构建，生产规模数据）：首页解压后 1428 → 1112KB，
未登录的题目详情页 3317 → 2021KB。后端接口 6–8ms，不是瓶颈，没动。

首页：
- 登录速报弹框挂在默认布局上，静态 import 了 md-editor-v3（~160KB JS + 76KB CSS），
  而 AI 分析只在登录后、提交满 3 次才有。MdPreview 改成异步组件，目标是本地包装
  LoginSummaryPreview.vue —— 直接 import("md-editor-v3") 会让 rolldown 把它和
  CodeMirror 语言包并成一个 467KB 的 chunk，排名页反而涨了 560KB（实测）
- 题目列表经 oj/api.ts 还带着 zod（~70KB）：那个文件静态 import 了题目详情、提交详情
  两个 schema。改成和请求并行动态加载（单独的 oj/detailSchemas.ts，理由同
  profileSchema.ts），闸门仍是同步的 —— submissionDetailSchema 有 .catch()，
  不能改 contractDeferred

题目详情页：
- skulpt（~226KB gzip）原来一选 Python 就立刻预取。改成登录后才取（没登录交不了），
  且等 requestIdleCallback，不和题面、编辑器抢带宽
- StatisticsPanel 只有老师可见，却被 EditorToolbar 静态 import，每个学生都白拉一份
  chart.js（~68KB gzip）。改成异步组件，打开课堂统计时才加载
- SubmissionResult（带 DataTable）改成异步组件，第一次提交弹出结果面板时才加载

浏览器核过：首页正常；详情页未登录不再加载 skulpt / chart.js / DataTable；学生登录后
skulpt 空闲预取、提交后结果面板正常弹出；老师点课堂统计按需加载图表并正常渲染。
登录速报的 AI 分析与语法错误拦截路径本机没能触发，未在浏览器里核。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 16:34:32 +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 83b9d23c68 perf(前端): zod 移出首屏包，首屏 JS 721KB → 594KB（gzip 237 → 199KB） 
首屏包里带着整个 zod 运行时（~100KB），来路有三条，缺一条都挪不出去（逐条撤回实测过）：

- 契约包没有 sideEffects: false，入口从桶里取任何一个值都会把所有 schema 模块带上。
  契约包里没有顶层副作用（核过），加上之后 rolldown 才能按导出摇树
- roles.ts 里的 USER_TYPE / toAdminType 是入口要的，同文件却定义了两个 z.enum。
  schema 挪到 admin.ts（唯一用处），roles.ts 文件头写明不许 import zod
- 启动就要调的 getWebsiteConfig / getAILoginSummary 在 oj/api.ts 里，而那个文件同步
  import 了题目详情、提交详情两个 schema。这两个函数挪到 shared/api.ts；那两道
  闸门保持同步 —— submissionDetailSchema 有 .catch()，放行原文和解析结果不等价
- /me 的契约闸门改成 contractDeferred：先放行原文，schema 按需加载后在后台核、只记
  日志。userProfileSchema 没有 default / transform，两者等价。动态 import 的目标是
  单独的 shared/profileSchema.ts —— 直接 import 契约桶会让 rolldown 重排共享 chunk，
  实测首屏反而涨到 1811KB

浏览器实跑核过：登录后 profile 正常加载、profileSchema 按需拉取、无控制台报错；
故意喂一份不符的数据，后台闸门照常打出 [契约] 分歧日志。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-09-27 15:23:31 +08:00
xuyueandClaude Opus 5 8b4d8899f9 feat(判题机): 自建镜像升级工具链，语言收敛到 C / C++ / Python
Deploy / deploy (push) Canceled after 0s
Details 
上游 QingdaoU/JudgeServer 停更在 2024-04（registry 上的 latest 和 1.6.1 是同一份
镜像，编译器停在 gcc-13），没有新版可拉，所以自己重编。docker/judge/ 是只改工具链
的 Dockerfile 分叉，server/ 和 Judger/ 从上游固定 commit b28aa56 拉，一行没动。

镜像 oj2-judge-2（不在任何 registry 上：本机 build.sh --save → scp → docker load）
- gcc/g++ 13 → 14.2，Python 3.12 → 3.13.5，都是 trixie 默认
- Go / JDK / Node 整套删掉：前端的题目语言复选框从来只给 C / C++ / Python / SQL，
  12 万条提交里 Java 44 条、Golang 15、JavaScript 3，全是很早以前的
- 体积 1.1GB → 433MB；默认走清华源，构建 12 分钟 → 40 秒（--no-mirror 换回官方）
- deploy.sh 加一道自检：镜像不在本机就中止，并打印该跑的三条命令

C 的编译参数加三个 -Wno-error（implicit-function-declaration / int-conversion /
incompatible-pointer-types）：gcc-14 把它们从 warning 提成了 error，而 -w 压不住。

语言值统一成 Python（迁移 0019 / 0020）
- 0019：Python3（104527 条提交）与 Python2（3 条）并成 Python，一并改掉 937 道题的
  languages、75 个 template 键、15 个 ast_rules 键、257 条 answers、1235 个用户的
  成就指标 _languages（languages_used 重算，总和 1928 → 1925，少的 3 个是同时用过
  两种 Python 的人）
- 0020：把 Java / JavaScript / Golang 从 84 道题的可选语言里摘掉 —— 不摘的话那些题
  的语言下拉还能选 Java，提交必 SYSTEM_ERROR
- 契约新增 normalizeLanguage() 别名表，判题侧一律走 judgeConfigFor()：旧客户端
  localStorage 里的 Python3、迁移前排进队列的任务都还能判；协作的语言归一也走它，
  否则上线那一刻学生页面里的 Python3 会静默落到 C
- 回滚要连数据一起回，只滚代码会让所有 Python 提交变 SYSTEM_ERROR

实跑
- 判题冒烟 docker/judge/smoke.ts 13 条全过：三种语言、六种状态码、gcc 宽松度
- 拿备份里的真实代码逐文件比对新旧镜像的编译结果，0 差异：C 提交 1951 份
  （1725 过 / 226 CE）、C++ 882 份、Python 2000 份、20 篇 C 教程的 93 个代码块。
  不加那三个 -Wno-error 的话，C 有 26 份会从能过变成 CE
- 迁移在灌了 12.4 万行真实数据的一次性库里跑过：0 残留、没有题目被清空；
  dev 库用真正的执行器跑通
- check:ast 56 个 target 全过，前后端 typecheck 均 0

顺带记下一个升级之前就有的坑（现在随 Go 一起消失，写在 README 里）：GOCACHE 指向
容器的 tmpfs，判题机重启后第一次 Go 提交是冷构建，Go 1.22 要 5.6 秒 CPU、超过 3 秒
的编译预算，于是重启后第一个交 Go 的学生必吃一次 CE，后面的人缓存热了又都正常。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-20 06:24:05 -06:00
xuyueandClaude Opus 5 47d8f46bdb feat(AI 提示): 提示落库并收集学生评价，落进 ai_hint
Deploy / deploy (push) Has been cancelled
Details 
AI 时代 OJ 设计的 2a：先把现有提示记下来，为后面的分级和两段式诊断攒对照数据。
提示本身的行为不变，发给模型的 prompt 一字未改。
- 迁移 0017 建 ai_hint：模型、prompt 版本、内容、错误、耗时、学生评价；
  成功和失败都记（失败率是 AI 悄悄变差时最先动的数）。挂在 submission 上 CASCADE
- streamChat 第三个参数改成 { onComplete, onError }：onComplete 的返回值并进
  done 事件，提示 id 由此带回前端；班级学情分析那处调用同步改写，行为不变
- 落库失败只记日志，不影响学生拿到提示
- 新增 POST /ai/hint/:id/feedback：只能评自己的提示（别人的一律 404），可以改票
- 前端提示生成完出「有帮助 / 没帮助」，选中的高亮；后端没存上时不出按钮
- 实跑：本地假 LLM 验证成功 / provider 断开 / 缺 AI_KEY 三条路径的落库，
  评价接口六种请求，浏览器里按钮出现、改票、重复点不发请求

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-19 06:00:10 -06:00
xuyueandClaude Opus 5 24af385f33 feat(排名): 加本周进步榜，按本周首次 AC 数排，每周一清零
Deploy / deploy (push) Has been cancelled
Details 
存量榜（/rankings/users、班级榜）排的都是 user_profile 的 AC 总数，名次几乎不动，
中位学生看一眼就知道追不上 —— 榜单在那批人身上是负反馈。这张榜的分母换成「这一周」，
每周一 0:00（东八区）清零，谁都可能进前十。

口径是**本周首次 AC 的题目数**，不是「本周 AC 过的去重题数」：后者把上周就做出来的题
重交一遍也算成绩，一分钟能刷满一屏。靠 NOT EXISTS 排掉本周之前已通过的
(user, problem) 对，四个条件正好是 submission_public_metrics_idx 的全部列。

- time.ts 加 weekStart()：localWeekday 的 0 是周日，要先折成 7，否则周日单独成一周
- GET /rankings/weekly?scope=global|class，入榜人群与全服榜一致（教师/超管不参与）
- 前端默认落在本班 —— 全服周榜上中位学生仍然看不到自己，班内 30 人那张才有答案
- 本周一题没做出来时 me 是 null，footer 那句「做出 1 题就能上榜」照样出现：
  它是说给还没上榜的人听的，而那正是最需要被推一把的一批

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-17 01:53:37 -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 79bfd28b07 chore: 删掉 369 行没有任何调用方的代码
Deploy / deploy (push) Has been cancelled
Details 
## utils/functions.ts 砍掉一半（622 → 291 行）

- trickOrTreat()：317 行、八种页面恶搞效果（中文乱码、页面翻转、去掉鼠标……），
  **全仓零调用**，占这个共享工具文件的一半；
- 文件末尾注释掉的 getChromeVersion / isLowVersion / protocol 六行。

## 其余没有调用方的导出

- services/achievement-metrics.ts 的 RARITIES / OPERATORS —— 和契约的
  achievementRaritySchema / achievementOperatorSchema 取值逐字相同，是没人用的第二份；
- collab/state.ts 的 hasRequest；以及 resetCollabState，它的注释写着「仅供进程退出或
  测试用」，而本仓库不写测试（项目约定），进程退出那条路径也没调过；
- contract/language.ts 的 JUDGE_LANGUAGES，注释说「前端用它排语言 tab」——前端并没有，
  它排 tab 用的是 constants.ts 里以 ProblemLanguage 为键的 SOURCES / LANGUAGE_SHOW_VALUE
  （那组映射的完整性 tsc 已经在管）；
- web 的 useSimplePagination（usePagination 的一层空壳包装）和 updateProblemSetProgress。

扫描口径：三个包全部 .ts / .vue 里逐个导出符号数出现次数，只在定义处出现的算无引用
（.vue 模板里的引用也计入）。剩下 56 个仍无引用的全部是契约里 `z.infer` 派生的一行
类型（46 个请求类型 + 10 个领域类型）—— 它们是在用的 schema 的类型另一半，成体系的
1:1 镜像，删一部分只会让那个文件变得随意，所以不动。

## 留给你定的一件事

`updateProblemSetProgress` 删掉之后，后端 `PUT /problem-set-progress`（routes/problemset.ts:249）
就没有任何调用方了。题单进度实际是判完之后由 services/problemset.ts 的 recordSolvedProblem
在服务端记账的（schema.ts 里那条注释写明了），这个端点是一条客户端自报进度的平行路径。
没顺手删：删端点是行为变化，而且不能排除有脚本在打它。

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 19:38:16 -06:00
xuyueandClaude Opus 5 7d15e6aeaa refactor(契约): 判题产物退回不校验，练一练的形状闸挪到写入侧，运行时闸门收回三处 
前四轮把契约当成运行时闸门铺开，复盘下来三块里只有一块是赚的：类型收拢成一份
（语言联合、Problem/Message/ContestRank 的重复派生）留着；另外两块退回来。

## 判题产物：读出侧不再校验

judgeCaseResultSchema 按采样键集收紧的结果，用根目录那份生产备份全量跑了一遍：
124192 条提交里 9163 条对不上，**RE 8480/8480、TLE 338/338+26、MLE 1/1 全中**，
另有 270 条 WA、47 条 AC。原因不是键集合，是空值和 SQL 链路：

- 沙箱在非正常退出的测试点上写 `output_md5: null`，契约写的是 z.string()；
- SQL 判题（judge/sql/engine.ts 的 CaseResult）根本没有 `output` 键；
- SQL 通过的测试点 `error_message` 是 null，契约写的是 z.string().optional()。

更糟的是失败方式：`info` 是 `union([完整形状, z.object({})])`，对不上的一律落进
第二支被剥成 `{}` 且 parse 成功 —— 管理员详情页的测试点表格**静默消失**，无日志。

JSONB 的形状真相在写入侧（判题机），读出侧再校验一遍只会在两边分叉时丢数据。
所以 `info` 回到 z.unknown()，形状改用 JudgeInfo / JudgeCaseResult 两个 TS 类型
描述（按判题机实际写的形状，不是采样出来的），取值处由 submissionCaseResults()
做唯一需要的运行时判断：有没有 data 数组。statisticInfo 换成 looseObject ——
所有键可选、不剥未知键，对任何对象都不会失败，它的作用是给类型不是当闸门。

## 练一练：形状闸从读路径挪到写路径

exerciseSchema 的 superRefine 挂在读路径上，而这个 schema 后端也在 parse
（routes/content.ts），等于一行脏数据就能让整条学生练习列表 500。同时写入侧的
exerciseDataError **一次都没查过 question**，两边严紧度不一致，脏数据进得来出不去。

exerciseDataByType 保留，改由 exerciseDataError 在写入前查，错误信息按字段翻成
中文给老师看；读路径回到不校验。

## 运行时闸门收回三处

contract() 从 41 个端点收回到题目详情 / 提交详情 / 用户资料 —— 原本就写了
.parse() 的那三条。留着的理由是「别抛错」（原来 parse 抛 ZodError 会白屏、
后面的 as 又让校验白做），不是校验：前后端同仓、共享同一份 schema，字段漂移
tsc 已经抓了。闸门本身也瘦掉了没人读的 window.__OJ2_CONTRACT_DRIFT__ 那套簿记。

## 验证

- 生产备份全量：124192 条提交过 submissionDetailSchema / submissionListItemSchema
  零失败，其中 112144 条能拿到测试点明细（另外 12048 条本来就是 data:null）；
  151 道练习读路径 151/151、写入闸 151/151（老师改旧题不会被新闸挡）；
- 反向验证写入闸：缺题干的排序题被拒并给出「题干的格式不对」；
- 本地实跑：种一条生产形状的 RE 提交（output_md5: null），管理员详情接口原样
  返回 info.data（改之前是 {}）；库里塞一行没有 options 的 mcq，学生端练习列表
  照常返回两条而不是 500；
- vue-tsc / tsc -p apps/api 均 exit 0，vite build 通过，check:routes 无遮蔽。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH
 2026-09-10 04:53:28 -06:00
xuyue 684f2d29a5 feat(契约): 练一练的内容按题型收进契约，7 个题型组件不再裸读 data
Deploy / deploy (push) Has been cancelled
Details 
`Exercise*.vue` 七个组件直接读 `data.question` / `data.options` / `data.lines`，
而契约里 `data` 是 `Record<string, unknown>`（后端不校验）、前端只做了类型收窄
—— 也就是说这条路径**从来没有在运行时被看过一眼**，结构对不上时渲染期才炸。

现在 exerciseSchema 用 superRefine 按外层 `type` 分派到对应的内容形状，
外层与 data 对不上也会被抓住（`type: "mcq"` 配 `{question, code}` 会在渲染
mcq 组件时炸在 `data.options`）。七个题型的键集按生产库实测确定。

**这个 schema 后端也在 parse**（routes/content.ts 的 `exerciseSchema.parse`），
所以收紧它同时是一道服务端闸门：坏数据会让练习列表 500。因此先用生产全量
数据核验：151/151 通过，且反向验证确认能抓住题型与 data 不匹配的情况。

`getExercises` 另加了一层逐题型校验，让前端也能把内层分歧记进
`__OJ2_CONTRACT_DRIFT__`；`z.infer` 拿不到判别联合（superRefine 无法把校验
结果反映到推断类型上），所以类型上仍需一次经过 unknown 的断言 —— 它不掩盖
未经检查的分歧，因为运行时那一步已经做过。

顺带补上 getFlowchartSubmission 的闸门；被守卫端点达到 41 个。

验证：vue-tsc 与 tsc -p apps/api 均 exit 0；vite build 通过；check:routes 无遮蔽。
 2026-09-10 04:28:26 -06:00
xuyue 5da661d7f0 refactor(契约): 补上 AI / 站内信 / 自学留痕等接口的闸门，并订正前端 CLAUDE.md 的过期内容
Deploy / deploy (push) Has been cancelled
Details 
闸门再补 13 个端点：AI 系列（detail / solved / duration / heatmap /
login-summary / pinned）、站内信列表、教程列表与学习进度、题目逐年 AC、
流程图列表。学生端读接口至此基本覆盖（写操作与纯前端伪状态不接）。

文档订正（原文写着"后端是 ../OnlineJudge 的 Django 5"、"utils/http.ts"、
"utils/permissions.ts"，这些都早已不存在）：
- 项目概述改成 OJ2 前端，并点明要兼容机房老 Chrome；
- HTTP 客户端改成实际存在的 utils/api.ts；
- 新增「Contract guard」一节，把**失败策略**（记日志 + 放行原始数据、不抛错）
  和排查入口（window.__OJ2_CONTRACT_DRIFT__）写清楚，并提醒同一个 schema
  后端也在 parse、收紧前要用生产数据核验；
- Related Repository 指向同仓的 ../api 与 packages/contract。

验证：vue-tsc 与 vite build 通过；13 个新端点对真实接口全部通过
（11 通过 / 0 失败 / 0 跳过）。
 2026-09-10 04:25:24 -06:00
xuyue de34a47996 refactor(契约): 契约闸门铺到其余学生端接口，并清掉与契约等价的重复类型
Deploy / deploy (push) Has been cancelled
Details 
## 闸门覆盖

从 7 条扩到 20 条：竞赛列表/详情/口令/榜单、题单列表/详情/题目/徽章/进度、
全服榜与活跃榜、公告列表/详情、教程、用户度量、流程图历史/当前/统计、
提交统计与统计明细、相似题目、题目 AC 榜。

## 顺手把两处形状收进契约

- `contestRankItemSchema.submissionInfo` 原来只是 `Record<string, unknown>`，
  前端被迫再声明一份 `SubmissionInfo` 去覆盖它。现在 JSONB 的 snake_case 形状
  （is_ac / ac_time / is_first_ac / error_number / checked）进了契约，那层覆盖随之消失。
- 竞赛题目列表用 `problemListItemSchema.array()` 而不是契约里的
  `contestProblemsSchema` —— 后者是 `array(union([列表项, 详情]))`，联合类型会让
  `filterResult` 的类型收窄落到详情分支，而且学生侧这条接口只下发列表项。

## 清掉两处确证重复的派生

用类型探针（双向可赋值）逐对验证，`Problem` 与 `Message` 的本地派生与契约**完全等价**，
是没有内容的重复：`Problem` 的 languages/template 收窄、`Message` 的 submission 收窄
都已经在前两轮搬进契约。其余七处派生（Submission 的 result|9、Profile、AdminProblem、
Exercise、ContestRank、BlankProblem、TutorialEdit 等）探针确认**不等价**，都有真实理由，
一律保留。

`Problem` 原来还挂着 hasAstRules / visible / answers 三个可选字段，探针证明它们对
赋值没有影响（契约里本来就有 hasAstRules），去掉后没有任何调用点报错。

## 验证

- vue-tsc 与 tsc -p apps/api 均 exit 0；vite build 通过；check:routes 无遮蔽；
- 契约 schema 直跑真实接口：学生会话 13 通过 / 0 失败，管理员会话 15 通过 / 0 失败；
  跳过的三条都是预期的权限或空数据（/submissions/statistics 与 /flowcharts/statistics
  要教师权限、/users/:id/metrics 只统计公开提交）。
 2026-09-10 04:23:41 -06:00
xuyue aab0404ed7 refactor(契约): 语言与判题产物的形状收进契约，学生端高频响应接上运行时校验
Deploy / deploy (push) Has been cancelled
Details 
契约在前端一直只当类型包用：45 处引用里几乎全是 import type，三个 .parse() 后面
还都紧跟一个 as 把校验结果断言回去，等于没校验。这一轮把形状的来源收拢。

## 语言：三份真相并成一份

前端 utils/types.ts 手写了一份 9 值的语言联合，后端 judge/languages.ts 有自己的一套，
生产库又有一套。手抄那份**漏了 SQL**，而生产库 961 道题里有 9 道 SQL 题、
124191 条提交里有 91 条 SQL 提交 —— 这些提交的 language 在前端类型上是 undefined。
现在唯一来源是契约的 problemLanguageSchema，constants.ts 的显示映射以它为键，
契约里加语言而那边没补映射会当场编译不过。

## 判题产物：按生产数据实测收紧

judgeInfoSchema / statisticInfoSchema 的形状来自 124191 条提交的实测，不是手抄：

- info.data 有 12048 条是 null（编译失败等没有逐测试点结果），前端手抄的 Info
  却把 data 写成非空数组 —— 这 12048 条在类型上根本不成立；
- info 还允许**空对象**：非管理员看提交详情时后端下发 info: {}（权限投影）。
  收紧时必须把它算进去，否则每条非管理员看的提交详情直接 500 —— 本地实测复现过；
- statistic_info 的五个键按出现次数定成全部可选；另有 8916 条 JSONB 原文因内嵌
  带转义的 shell 输出不是合法 JSON，被后端 objectValue() 兜成 { value: ... }，
  所以不能用严格对象，否则这 8916 条会被误判成分歧。

## 运行时闸门

新增 utils/contract.ts：safeParse 失败时记一条分歧（去重、控制台可见、
window.__OJ2_CONTRACT_DRIFT__ 可查）后**放行原始数据**，不白屏 —— 面向学生的
生产站点，字段空着比整页崩掉可接受。接在 7 条高频链路上：/site、/site/online、
/problems、/problems/:id、/submissions、/submissions/:id、/me。

提交详情的 info 是联合类型，调用方不再直接取 .data，统一走
utils/functions.ts 的 submissionCaseResults()。

## 验证

- vue-tsc 与 tsc -p apps/api 均 exit 0；vite build 通过；
- 契约 schema 直跑真实接口：7/7 通过（自包含脚本，从登录到详情全链路）；
- 用生产备份复核收紧后的约束：961 题的 languages 无越界值，template 只出现
  C/Python3 两个键 —— 不会因为这次收紧在生产上抛错。
 2026-09-10 04:19:41 -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 6a438872b9 feat(排行榜): 页头显示当前在线人数，在线绿点只给老师
Deploy / deploy (push) Has been cancelled
Details 
新增匿名可读的 GET /api/site/online，一条 ZCOUNT 让 Redis 自己数，
不拉成员、也不写（清理过期成员留给后台列表，匿名接口不带写操作）。
榜单页进页面拉一次，为 0 时不显示。

/rankings/users 的 isOnline 是三态：null 表示「这个调用方不该知道」，
只有老师及以上拿到 true/false。写成普通 boolean 的话学生看到的 false
和真的离线分不开，等于默认把每个人的在线状态摊给全校同学看。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2
 2026-09-07 19:36:12 -06:00
xuyueandClaude Opus 5 8a88fe8d99 feat(智能分析): 解题表格改服务端分页，/ai/detail 不再下发整份 solved
Deploy / deploy (push) Has been cancelled
Details 
原来 /ai/detail 把区间内做出来的每道题连排名带等级整份下发，一个活跃学生一年几百道，
一次请求就是几百 KB，而表格一屏只看得到二十行。

拆成两支：
- GET /ai/detail 只留聚合（solvedCount、difficulty、tags、attempts、activity、errors…）
- GET /ai/solved?offset&limit 按首次通过时间升序分页给逐题明细

排名只跟当前这批题有关，所以分页那支只算一页的 problemIds，不必把整年算一遍。抽出
firstAcQuery / buildSolved / listSolved 三个函数，detail 和分页两边共用。

前端相应改动：
- 难度分布改读后端的 difficulty 聚合（本来就在下发，之前是从逐题列表里现数的）
- 几次做对改读新的 attempts 数组（每道题的尝试次数）；tooltip 里的题名去掉了 ——
  明细是分页拿的，不该为了一个 tooltip 把全量拉回来
- Overview 用 solvedCount
- SolvedTable 的代码提交那张走 remote 分页，流程图那张仍是本地分页（一个 OJ 的
  流程图题就那么几道，全量下发没问题）；换时间范围回到第一页
- 表格原来是 max-height 1500 的滚动区，现在由分页兜住，滚动条和分页器不再并存

/ai/analysis 的 prompt 仍然带逐题明细（少了它模型只剩聚合数字），但顺手卡了 200 条 ——
以前是整份 solved 无上限塞进去，题做得多的学生一次调用能顶好几倍 token。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LZuPwqDmLEiK9zgQ9z9sVn
 2026-09-03 03:18:18 -06:00