8600f8143a
fix(MaxKB): 「启用 MaxKB」开关在生产构建下拦不住脚本
...
vite 的 inject-maxkb 插件把 `<script src>` 写进 index.html 的 head，于是构建
产物在 Vue 启动之前就把第三方挂件拉下来执行了。App.vue 的 useMaxKB() 那条运行时
路径只能事后把标签和 `[id^="maxkb-"]` 的 DOM 删掉 —— 代码早跑完了。表现就是后台
把开关关掉、刷新，挂件的副作用照旧（其中之一是它自带的性能上报在每个页面抛
`Cannot read properties of undefined (reading 'startTime')`，堆栈全是 <anonymous>
因为它 bootstrap 时又 eval 了一层），而且关不掉。
改成只留运行时那一条路：
- 删掉 inject-maxkb 插件，index.html 不再带这个 script 标签。原地留注释说明
为什么不能加回去。
- config store 的 enableMaxkb 默认值从 true 改成 false。默认 true 的话
getConfig() 还没回来挂件就已经加载了，服务端说「关」依然晚一步。代价是配置
拿不到时挂件不出现 —— 第三方脚本 fail closed 是对的方向。
- URL 为空的兜底从 vite 插件挪进 loadMaxKBScript，否则会拿 undefined 当 src。
验证：headless chromium 走 CDP 记录网络请求。
- dev（5173）：enable_maxkb=false → 0 个请求、0 个 script 标签；改成 true →
发出 embed 请求、head 里 1 个标签。
- 生产构建（bun run build 后把 dist 静态跑起来、/api 转发到后端）：同样两种
配置下分别是 0 和 1。构建出来的 index.html 里已经没有 maxkb 的 script 标签，
只剩原本就在源文件里的那行 maxkbMaskTip。
MaxKB 脚本自身那个 startTime 报错是它自己的 bug，本次只保证「关得掉」，没去
动第三方代码。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-27 00:26:54 -06:00
1d9686b929
feat(后台用户): 管理员密码默认打码，点「显示」才展开
...
Deploy / deploy (push) Has been cancelled
后台用户列表把所有账号的明文密码直接铺在表格里。学生密码是有意保留的运营需求
（老师要能查），但管理员账号的密码跟着一起明文显示，投屏或者旁人路过就看到了。
现在学生管理员／教师管理员／超管三类账号的密码默认渲染成 •••••• 加一个「显示」
按钮，点一下该行展开成明文（仍然是 TextCopy，点击复制照旧）。普通用户不变。
展开状态按 user id 记在 list.vue 里，listUsers() 里清空，所以翻页、搜索、换筛选、
换排序之后一律回到打码；不做定时自动隐藏，也不记进 localStorage。
只改前端。rawPassword 照旧随列表下发——/users* 每条路由本来就是 requireSuperAdmin，
非超管连列表都拿不到，要防的是屏幕被看到，不是拿到响应的人。改成「按需取单个密码」
反而要多开一个下发明文的端点，把面扩大。
rawPassword 为空时不打码：给一个点了什么也不显示的按钮没意义，直接走原来的 TextCopy。
顺带把角色标签缩短（学生管理员→生管、教师管理员→师管）。getUserRole 只有同一张表的
用户名列在用，密码列变宽之后那一列需要让出横向空间。
实跑验证（本机 dev 栈 + 超管登录）：管理员行打码、学生行明文照旧、点「显示」后展开
且仍是可复制的按钮、搜索触发重新拉列表后回到打码。vue-tsc 与 build 均通过。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-26 10:08:30 -06:00
7793a2fe4c
清理旧后端下线后的残留
...
Deploy / deploy (push) Has been cancelled
旧 Django 后端 2026-08-26 下线、回滚路径作废，代码里还留着几处以它为前提的
死代码和过期注释。
- PUBLIC_WS_URL / PUBLIC_OJ_URL 全部删除。BaseWebSocket 的
`${PUBLIC_WS_URL}/${path}/` fallback 是 Channels 时代的写法，而三个子类
早就各自传 url，等于永不执行；config.vue 里 PUBLIC_OJ_URL 只是个会被
getWebsiteConfig() 立刻覆盖、且指着 :8000 的假初值。WebSocketConfig.path
随之去掉，url 改成必填。
- vite.config：删掉 /api2、/ws2 的迁移期注释，换成还成立的约束（代理这三段
要和 docker/Caddyfile 同步）；newBackend 改名 backend。
- 六处 “回滚时旧后端还要读” 换成真实理由：snake_case 保留的结论不变，但因为
判题机按这套键名写、存量 JSONB 就是这形状。
- CLAUDE.md：数据库一节开头「不写迁移 + 先想清楚回滚」与下一节的 drizzle
migration 自相矛盾，改掉；判题状态码不再要求同步到 OnlineJudge，理由换成
历史 submission.result 和沙箱用的就是这套编码。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-26 09:09:26 -06:00
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
a9332df6bd
update
Deploy / deploy (push) Has been cancelled
2026-08-26 00:28:18 -06:00
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
36a4663193
chore(前端): 清掉四处零引用的死代码
...
Deploy / deploy (push) Has been cancelled
按名字扫了一遍 api 层导出和 utils 常量，四处全仓零引用：
**`getContestProblem`**（admin/api.ts）—— 和紧挨在它上面的 `getProblem` 逐字
相同，同一个 URL、同一个类型。旧后端 admin 侧比赛题和公开题是两个端点，合并
之后这个壳留下来了。
**`createMessage`**（oj/api.ts）—— 两代前端都只有定义没有调用。参数名还是旧
后端那套（recipient / submission），函数体里再映射成契约的
recipientId / submissionId，等于给一个不存在的调用方写了个兼容层。
d3b05b8noreply@anthropic.com >
2026-08-25 23:32:50 -06:00
3f6b4102c9
feat(题目): 学生题目页恢复「要求」展示，走新的 astRequirements 字段
...
Deploy / deploy (push) Has been cancelled
旧后端的 ProblemSerializer.Meta.exclude 没排掉 ast_rules，学生拿到的是规则原文，
题目页上那块「要求」（「if 条件 出现 2 次」之类）是显示的。阶段 3 泄露评审刻意
收掉了它，只留 hasAstRules 布尔值 —— 报告里当时就写了：
「新的更安全，但如果 ojnext 有地方读 ast_rules 的具体内容（比如提示"必须用
for 循环"），需要补个专门的字段。」
前端确实有（ProblemContent.vue 的 astRulesForDisplay + 整块渲染），但那个字段
一直没补。结果是这块在 OJ2 上**永远拿不到数据**，代码还在、没人报错。12 道题
受影响；学生只有提交失败后才能从 statistic_info.ast_results 里看到要求。
现在按评审自己的建议补上：oj 侧题目详情（含比赛题）多一个 astRequirements，
**只有渲染要用的两个字段**：
{ description: "if 条件 出现 2 次", kind: "count" }
文案由后端生成，engine / target 这些内部字段不出现在响应里 —— 收紧保留，
展示恢复。实测响应里搜不到 "engine" 也搜不到 "if_statement"。
## 顺带合掉一堆重复
描述文案原来有两份几乎一样的实现：判题机 ast.ts 里一份（写进 ast_results）、
ProblemContent.vue 里一份（题目页用）。现在统一成 ast.ts 的 describeAstRule，
两边共用。差异只在 min/max 同时给出时的措辞（生产库里没有这种规则，实际输出
逐字不变），另外判题机现在也能用上节点类型的中文名 —— 没写 label 的规则以前
判题结果里显示 `必须使用 function_definition`，现在是 `必须使用 函数定义`。
节点类型中文名那 15 条原来在 AstRulesEditor.vue（下拉 options）和
ProblemContent.vue（NODE_TARGET_LABELS）各手抄一份，收进契约的
AST_NODE_TARGET_LABELS，编辑器的下拉现在从它生成。
前端删掉 NODE_TARGET_LABELS / ruleDescription / ruleTagType 共 ~80 行，
`Problem` 类型里那个 oj 侧根本不下发的 astRules 幽灵字段也去掉了。顺带修掉
一处潜在重复渲染：原来 message 非空时 ruleDescription 返回 message、模板里
又单独渲染一次 message（生产库 message 全是空串，所以没露出来）。
## 一个坑：契约里差点搞出循环引用
astRequirements 一开始放在 admin.ts，problem.ts 去 import 它 —— 而 admin.ts
本来就 import problem.ts。**tsc 一声不吭地过了**，运行时才炸：
ReferenceError: Cannot access 'astRequirementsSchema' before initialization
所以整块 AST schema 从 admin.ts 挪到了 problem.ts（本来也是题目域的东西），
admin.ts 反过来从那边取。这类环 tsc 抓不到，加跨文件 schema 引用时得实跑一次。
## 验证
tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、build 通过。
起服务实打：
- 把生产库那条规则种进本地库，匿名请求 /api/problems/1001：astRequirements 是
`{"Python3":[{"description":"if 条件 出现 2 次","kind":"count"}, ...]}`，
响应里没有 astRules、没有 engine、没有 if_statement。
- 浏览器打开题目页，「要求」那块活了：`要求 | if 条件 出现 2 次 | else 子句 出现 2 次`。
- 后台编辑页展开「代码规则检查」，两条规则正常渲染成
`出现次数 | if 条件 | 精确`，下拉选项（现在从契约生成）正确。
- 直接调 describeAstRule / checkAst / astRequirements：三种 kind 分类正确，
engine 认不出的规则被丢掉，null 和非对象都回落成 null。
- oj 侧 3 页 + 后台 4 页走查无重定向、console 无报错。
冒烟改动已还原（problem 2 的 ast_rules 复位成 null）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 23:27:40 -06:00
f919d41199
refactor(契约): AST 代码要求收进契约，三份各写各的合成一份
...
同一个形状原来在三个地方各定义了一份，三份都不一样：
apps/api/src/judge/ast.ts engine target outer inner label message exact min max
apps/web/src/utils/types.ts engine target message min max
AstRulesEditor.vue（本地） engine target label message exact min max
ProblemContent.vue（本地） engine target label message exact min max
判题机那份是真的（evaluateRule 按 engine 分支读哪几个字段），契约里则压根没有，
`astRules: z.unknown()`。后果是后台编辑器写得出 label 和 exact、判题机也认，
但 utils/types.ts 那个类型描述不了它们 —— 生产库 12 道带 AST 规则的题里，
15 条规则带 label、6 条带 exact，全都在类型之外。
现在契约里一份 astRuleSchema，四处都指向它。engine 收成枚举，列全判题机
实现的十种。**存量数据核过**：12 道题逐条过新 schema，12/12 通过。
顺带三件：
- `astRules` 的响应和请求 schema 从 z.unknown() 换成 astRulesSchema。之前
engine 写错一个字母能存进去，判题机 evaluateRule 走 `default: return null`
静默跳过 —— 老师设了规则、规则不生效、没有任何提示。现在保存时就 400，
错误信息把十个合法值列出来。
- judge/run.ts 的 astRulesForLanguage 原来是整片 `rules as AstRule[]` 硬转，
改成逐条 safeParse：认不出的丢掉那一条，行为和 evaluateRule 的 default 分支
一致，只是提前到读取处，也不再骗类型系统。
- 判题机实现了 must_have_nesting，但后台编辑器没有对应选项，目前只能手工造
数据才用得上。枚举里留着并加了注释，没有顺手去补 UI（那是加功能不是清理）。
## 验证
tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、build 通过。
起服务实打：
- 把生产库那条带 label/exact 的规则种进本地库，后台题目详情 200、字段齐全；
原样 PUT 回去 200，库里 label 和 exact 都在（旧类型描述不了的那两个）。
- engine 传 "must_do_magic" → 400，错误信息列出十个合法值。
- 直接调 checkAst：三条规则（两条合法 + 一条 engine 认不出）进去，判题机收下
两条；两个 if/else 的代码 passed=true，一个的 passed=false，描述文案
「if 条件 出现 2 次」正确用上了 label。
冒烟改动已还原（problem 2 的 ast_rules 复位成 null，测试标签删掉）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 23:15:52 -06:00
3f55d231c3
refactor(契约): samples / answers / testCaseScore 补回旧后端的校验
...
Deploy / deploy (push) Has been cancelled
旧后端这三个字段都是逐字段校验的（CreateSampleSerializer /
CreateAnswerSerializer / CreateTestCaseScoreSerializer），新后端一路写成
`z.record(z.string(), z.unknown())`，**比旧的松**。松出来的不只是少拦几个
错误请求，还有一处静默的落库形状漂移。
## test_case_score 会越存越胖，而且 score 变成字符串
上传接口的响应有六个键，前端 `{...entry, score}` 原样往回传。旧后端的 DRF
serializer 只认 input_name / output_name / score，多的直接丢，所以生产库
956 行 test_case_score **全部只有三个键**、7990 条 score 全部是 int
（前端算出来是 `(100/n).toFixed(0)` 这种字符串，IntegerField 收下时转了）。
新后端不做这件事，往后在 OJ2 上新建或编辑的题会存六个键、score 是字符串 ——
和旧后端写出来的不是一个形状。这列判题机不读，不影响判题，但它是回滚要
原样交回去的持久化数据，不该在这上面分叉。
现在三个精确 schema 顶上：problemSampleSchema / problemAnswerSchema /
problemTestCaseScoreSchema。zod 的 object 默认剥未知键，和 DRF 同一个行为；
score 用 `z.coerce.number().int().min(0)`，对齐 IntegerField 的收字符串转整数。
前端跟着改：`Testcase` 从 `TestCaseEntry & { score: string }`（六键+字符串分数）
换成契约的 ProblemTestCaseScore（三键+整数），三处构造点只挑落库要的键。
detail.vue 那处写成 `Number((100 / n).toFixed(0))` —— 取值和原来逐字相同，
只是不再包成字符串，分数算法一个字没动。AdminProblem 的 Omit 列表也短了两项
（samples / testCaseScore 现在契约里就是准的），只剩 answers 要把 language
收窄成 LANGUAGE。
## 顺带：一段被 @ts-ignore 压着的死代码
admin/problem/detail.vue 上传测试点那里有
// @ts-ignore
if (res.error) { ... }
—— 拿 { error, data } 信封当返回值判。上一个 commit 拆信封时正是因为
@ts-ignore 压着，vue-tsc 没报出来。res 现在是 UploadTestCaseResponse，
没有 error 这个键，这个分支永远进不去。失败本来就走 catch。
（全仓另外两处 @ts-ignore 查过了，是 skulpt 和 wangeditor 没类型定义，正常。）
## 生产数据依据
956 道题逐条扫过备份：samples 947 条 {input,output} + 9 条空数组（SQL 题没
样例）；answers 268 条 {code,language} + 633 null + 55 空数组；
test_case_score 956 条全是三键，score 全 int。收紧不会打到任何存量行。
## 验证
tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、build 通过。
起服务实打了写路径：
- 后台题目详情 200，三个 schema 都 parse 得过存量数据。
- 故意造脏 PUT：score 传字符串 "20" + 塞进 stripped_output_md5 / input_size /
output_size，落库是干净的 `{input_name, output_name, score: 20(int)}`；
samples 和 answers 里塞的多余键同样被剥掉。
- 三个错误载荷都按预期 400：samples 缺 output、answers 缺 code、score 传负数。
- 浏览器里打开后台题目编辑页，点提交 → PUT 200 → 跳回列表，库里形状正确。
（顺带发现 tags 为空的题在编辑页点提交会被 `tags.min(1)` 挡下 400 —— 旧后端
`allow_empty=False` 也是这个行为，不在本次范围。）
冒烟改动已还原：problem 2 的 answers 复位成 []，测试用的「冒烟」标签删掉。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 23:04:41 -06:00
5c772319e9
refactor(契约): 公告两侧形状分开，判题状态码从契约派生
...
Deploy / deploy (push) Has been cancelled
## 公告：一个 schema 兼两种形态，兼出两处谎
前端 utils/types.ts 只手抄了**后台那份**公告形状，oj 侧也拿它当类型用。可
apps/api/src/routes/content.ts 的 `/announcements` 列表既不下发 content 也不
下发 visible —— 于是类型声称列表行有这两个键、运行时都是 undefined。今天没炸
只是因为组件恰好没读（正文是点开后另拉一次详情）。
契约那边则是另一头：announcementSchema 把 content 写成 `.optional()`，让一个
schema 同时兼列表和详情。代价是**详情**拿到的 content 类型也成了
`string | undefined`，组件只能 ?? 兜底。
现在两边都按后台侧早就在用的套路拆开：content 必填，列表用
`.omit({ content: true })` 派生。四个类型各归各位：
oj 列表 AnnouncementListItem 无 content、无 visible
oj 详情 Announcement 有 content、无 visible
后台列表 AdminAnnouncementListItem 无 content、有 visible
后台详情 AdminAnnouncement 有 content、有 visible
前端手抄的 Announcement / AnnouncementEdit / AnnouncementListItem 全部删掉，
AnnouncementEdit 改成从请求体派生（`CreateAnnouncementRequest & { id: number }`）。
后端 content.ts 的列表端点跟着换成 announcementListItemSchema —— 它本来就没
传 content，输出一字不变。
## SUBMISSION_RESULT 不再手抄
`-2 | -1 | 0 | ... | 10` 这 11 个码是从后端抄的，改成 `JudgeStatus | 9`：
后端那部分从契约派生，9 是前端本地的「正在提交」伪状态（后端永远不下发，
所以契约里没有，见 constants.ts 的 SubmissionStatus.submitting）。
这样 CLAUDE.md 说的「三处同步」才真的有人守：**实测过**，往
judgeStatusSchema 加一个 `z.literal(11)`，constants.ts 的 JUDGE_STATUS 立刻
报 TS2741 缺 '11' 的映射，加不上标签就编译不过。
顺带 useSubmissionMonitor.ts 里两处裸 `9`（各带一句 `// 9 = submitting`）
换成 SubmissionStatus.submitting，注释就不用写了。
## 顺手
TestcaseUploadedReturns 这个改名 re-export 去掉，直接用契约的
UploadTestCaseResponse（全仓 2 处引用）。
**没动 transforms.ts。** 之前把它记成「旧前端字段名的化石」，看下来判断有误：
filterResult 里 difficulty 要查 DIFFICULTY 映射表转中文、rate 要 getACRate 算、
status 要把 myStatus 翻成 passed/failed/not_test —— 是实打实的视图模型，不是
单纯改名。改它只会把计算逻辑挪个地方。
## 验证
tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、vite build
通过。因为动了后端响应 schema，起服务实跑了公告的四条路径：
- curl 三个端点逐个核对键集：oj 列表无 content/visible 且只出可见的那条、
oj 详情有 content、后台列表有 visible 无 content 且两条都在。
- 浏览器里 oj 公告列表渲染正常、点开正文能出来；后台列表两行齐全；
编辑页表单载入正确；改标题保存 PUT 200，库里 title 变了、visible/top 没被
带歪，保存后跳回列表并重新拉取。
（agent-browser 的 `find text 保存 click` 打不到 naive-ui 的按钮 handler ——
不发请求也不报错，一开始误判成保存坏了。改用 DOM 上直接 .click() 就正常，
是自动化的坑，不是应用的问题。）
冒烟用的两条公告已删干净。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 22:54:01 -06:00
0b7b08f2cc
refactor(前端): 去掉 { error, data } 信封，api2 改名 api
...
Deploy / deploy (push) Has been cancelled
信封是 Django 时代的形状：拦截器手工造一个**恒为 null** 的 error 字段，再把
真正的载荷塞进 data。后端 http.ts 的 success 其实只返回 { data }，那个 error
从头到尾没人用 —— 全站成功路径读 res.error 的只有 admin/api.ts 的
resetPassword 一处，而它自己就是个把信封拆开再重新包一遍的 shim。
代价是每个调用点都要 .data 一次：47 个组件、3 个 api 层文件、200 多处。
现在拦截器直接返回 response.data.data，ApiResponse<T> 退化成 T，文件末尾那句
`as unknown as Api2Client` 的类型谎言也少了一层。失败路径不动，仍然 reject
`{ error: 错误码, data: 文案 }` —— 和成功路径不对称是故意的，成功没有错误码
可言，接口注释里写清楚了。
顺带把 api2 改回 api：utils/ 下早就没有 api.ts 了，"2" 是迁移期用来和旧
client 区分的，现在只剩下让人多想一秒的作用。
## 怎么改的
**没有全局 sed。** 先把客户端的返回类型从 Promise<ApiResponse<T>> 改成
Promise<T>，让 vue-tsc 把每一处报出来（210 条），再按它给的 file:line:col
精确删 `.data`（192 处），剩下的手工处理：
- 6 处 `const { data } = await ...` 解构 → `const data = await ...`
- 3 个 api 层函数（getProfile / getProblem / getSubmission）自己手工造信封，
改成直接返回值；getProfile 的返回类型跟着从 ApiResponse<Profile|null>
变成 Profile|null
**类型检查抓不到的，人工把剩下的每一处 `.data` 过了一遍** —— 载荷本身带
data 字段、或者载荷是索引签名时，`res.data` 照样过类型。这一遍捞出三条真 bug：
- `getTutorialList` 的载荷是 `{ [key: string]: TutorialListItem[] }`（按
python / c 分组）。索引签名让 `res.data` 编译通过、运行时是 undefined ——
改完信封之后教程列表会**两个 tab 全空且不报错**。实跑确认过修好了。
- `createExercise` / `updateExercise` 返回 `res.data`，而 Exercise 自己有
data 字段（练习内容）。两个调用方都不看返回值，所以类型和运行时都不响。
- `getSimilarProblems` 的 `.then(r => ({ ...r, data: r.data.map(...) }))`
删掉 .data 之后变成往对象里摊一个数组，能跑但形状是错的。
另外两处是**对的**，加了注释免得下次被"顺手清理"掉：
StatisticsPanel 的 `res.data` 是契约 submissionStatisticsSchema 自己的 data
字段（每个学生一行）；download.ts 是独立 axios 实例，`res.data` 是 axios 的
响应体（zip 二进制，不走信封）。
## 验证
tsc(apps/api) 0 error、check:routes 168 条无遮蔽、vue-tsc 0 error、vite build
通过。**因为这改动碰的是每一个请求，静态检查不够，起了全套服务用浏览器实跑：**
- oj 侧 12 个页面 + 后台 13 个页面逐个打开，断言没有重定向、console 无报错。
- 关键页面进一步断言渲染出了真数据（后台用户列表 3 行、题目列表 10 行、
站点配置表单三个输入框有值、教程列表分组正确）。
- 三条写路径实打：重置密码（库里 student123 → 531554，表格当场刷新）、
公告可见性开关（走 getAnnouncement + editAnnouncement，就是手改解构那处，
库里 visible t → f）、提交代码（POST → 判题机真跑出 -2 → 提交列表和详情页
都正确渲染状态、语言、代码）。
- /rank 有一条 `{error: "class-missing"}` 的未捕获 reject，stash 掉本次改动
复现同样报错，**是既有问题**，不在本次范围内。
本地 dev 库为了打通后台测试改了三处，都只影响本机：devadmin 补了 email 和
user_profile 行（原来缺这两样，getProfile 报 profile-not-found，AUTHED 存不
进去，所有 /admin 路由被守卫弹回首页）、密码重置成 devpass123。冒烟用的教程/
公告/提交三条测试数据已删干净，题目和用户的提交计数也回滚了。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 22:42:20 -06:00
b35118f32e
update
Deploy / deploy (push) Has been cancelled
2026-08-25 21:21:20 -06:00
66d51dfd83
chore(账号): 删掉没人调的 refreshUserProblemDisplayIds
...
Deploy / deploy (push) Has been cancelled
oj/api.ts 里那句 `// TODO: 这个API有问题` 是从 ojnext 原样搬过来的，**说的是
旧后端的 bug，移植时已经修掉了**。旧的 ProfileProblemDisplayIDRefreshAPI：
ids = list(acm_problems.keys())
display_ids = [... filter(id__in=ids, visible=True).values_list("_id")]
id_map = dict(zip(ids, display_ids))
zip 把「dict 键顺序」和「查询返回顺序」硬凑成对，题目一旦被隐藏或删除
display_ids 就比 ids 短 —— 轻则编号张冠李戴写进库，重则 id_map[k] KeyError。
account.ts 那版是按 id 建 Map、查不到就不动，是对的。留着这条 TODO 只会让
下一个人去查一个不存在的 bug。
顺带查出来：这个函数**两代前端都只有定义、没有任何调用点**。端点清单把
/api/profile/fresh_display_id 标成「前端有调用」是提取脚本匹配到了函数定义
里的 http.get 字面量，不是调用，属于假阳性。前端这个死导出删掉。
后端端点保留 —— 教师改了题目编号之后，学生 acm_problems_status 里缓存的
_id 只有它能刷，是这份缓存唯一的入口。加注释写清它是干嘛的、为什么现在没人
调（要接 UI 从这儿开始）、以及旧后端那版错在哪。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 19:02:37 -06:00
9653f1541a
refactor(契约): SQL 展示数据进契约，topReaction 收成枚举
...
d3b05b8noreply@anthropic.com >
2026-08-25 19:02:25 -06:00
6356643cc9
ci(部署): 部署走 GitHub Actions，产物挪到 runner 上编
...
Deploy / deploy (push) Has been cancelled
服务器性能差，镜像 builder 阶段（1238 个包的 bun install + bun compile +
vite build）首次约 5 分钟，光前端就 160s。改成在 runner 上编好 dist/oj2-api
和 apps/web/dist，rsync 过去，服务器那边只剩几条 COPY。
服务器自己编的能力没有砍掉。Dockerfile 顶部加了全局 ARG ARTIFACTS：
build（默认） builder 阶段自己编，只要有 docker 就能手动部署
prebuilt 用构建上下文里现成的产物，builder 不进构建图
实现是两个 scratch 阶段归一成 /artifacts/ 布局，再用变量阶段名
FROM artifacts-${ARTIFACTS} 选一个，运行时阶段不关心产物是谁编的。
deploy.sh 加 --prebuilt：产物缺失在自检就 die；顺带检测 buildx —— 没装的话
compose 会退回 classic builder，那个不看依赖图、所有阶段挨个跑，产物白编
（结果正确但不省时间），黄字提醒不阻断。
.dockerignore 末尾放行两个产物路径，必须在 dist/ 那些规则之后，
dockerignore 是最后一条匹配说了算。
顺手删掉 apps/web/.github/ —— 从 ojnext 抄来的残留，路径不对（GitHub 只认
仓库根的 .github/workflows/）从来没跑过，内容也是 ojnext 的。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 18:30:22 -06:00
d3b05b8629
refactor(契约): 补齐 80 个类型导出，前端不再手抄形状
...
契约原来有 184 个 schema 但只导出了 104 个类型，缺的那 80 个前端只能照着
手抄一遍 —— 这是「表格列静默空白」那一类 bug 的根因（d3348f9、2edb8cf，
以及上一个 commit 修的 Top100 两列）。现在 186 个 schema 对 186 个类型，
一一对应，下次要用直接 import。
补导出是机械的（fooSchema → Foo），零命名冲突。真正有价值的是换的过程中
契约逼出来的 5 处分歧 —— 手抄那份在说谎，而 vue-tsc 拦不住，因为类型说它是对的：
- Tutorial.createdBy 手抄成了可选的 `User`（即 AdminUser，带 email、
rawPassword），后端下发的是必有的 SampleUser。读 createdBy.email 会拿到
undefined。列表页因此被迫写 `row.createdBy?.username` 和 `row.createdAt!`，
换成契约类型后两处断言都不需要了。
- TutorialListItem 手抄成 `Omit<Tutorial, "content">`，但后端列表接口连 code
一起省了 —— 类型声称 code 在。
- Testcase 手抄成 `{input_name, output_name, score}`：响应实际有 5 个字段，
且**没有 score**。score 是上传完成后前端按测试点数量平分补上去的，手抄那份
把本地字段说成了响应字段。现在写成 `TestCaseEntry & { score: string }`。
- Tag 手抄成 `{id, name}`，契约是 `{id, name, problemCount}` —— shared/api.ts
只好用 `Tag & { problemCount: number }` 把丢掉的补回来。
- CreateMessage 是旧后端按名字投递的形状（sender/recipient/submission），
契约要的是 recipientId/submissionId。全仓零引用，删掉。
同时删掉另外两个零引用的手写类型：LANGUAGE_SHOW_LABEL、UserAdminType；
本地重复的 SampleUser 换成契约的；oj/problem/list.vue 里本地第三份 Tag 改成
`ContractTag & { checked: boolean }`。
需要收窄的一律**从契约派生再收窄**，字段名跟着契约走，只有真正本地的那一两个
键是自己的：
export type Exercise = Omit<AdminExercise, "data"> & { data: 七种题型的联合 }
export type SubmitCodePayload =
Omit<CreateSubmissionRequest, "language"> & { language: LANGUAGE }
保留不动的窄化：StatisticInfo / SubmissionInfo（判题 JSONB 原文，snake_case）、
SQLDisplay*、ProblemFiltered（视图模型）、Exercise*Data（契约里 data 就是
Record<string, unknown>，七种题型结构不同，后端本来也不校验）。
types.ts 的手写 interface 从 31 个降到 22 个。
顺带修的代码：admin/tutorial/detail.vue 新建教程的表单对象缺三个后端产出的
字段，加了 TutorialEdit（对齐 BlankProblem / BlankContest 的写法）；三处测试点
上传原来是拿响应对象原地塞 score，改成 map 出新对象，分数算法一字未改。
验证：apps/api tsc(7.0.2) 0 error、check:routes 168 条无遮蔽、
apps/web vue-tsc 0 error、vite build 通过。改动绝大部分在类型层，运行时只有
测试点上传那三处（等价替换）—— **那条路径要传 zip 才能实跑，没有实打**，
只做了代码等价性核对。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 18:07:01 -06:00
78a2fb4fce
feat(排行榜): 重写全服 Top100，补上「我的排名」，后台那条挪进 admin
...
起因是 Top100 的「已解决」「提交数」两列一直空白：列的 key 还是
snake_case（accepted_number / submission_number），而数据早在 c2a8120d3348f936e4ac2noreply@anthropic.com >
2026-08-25 17:57:55 -06:00
6e905085a1
chore(依赖): 后端升到 TypeScript 7，前端被 vue-tsc 挡住留在 5.9
...
apps/api 单独嵌套 typescript ^7.0.2，`bun run --filter '@oj2/api' typecheck`
从此跑的是原生版；根和 apps/web 留在 5.9.3。api 在 TS 7 下 0 error，
另外塞了个故意写错的文件复检过，确认它真在报错、不是静默跳过。
前端升不了：vue-tsc 启动时要 require.resolve("typescript/lib/tsc")，
而 TS 7 的 exports 里已经没有这个子路径，直接
ERR_PACKAGE_PATH_NOT_EXPORTED。vue-tsc@latest 就是仓库里的 3.3.11，
还没有支持 TS 7 的版本 —— 它 peer 写的是 typescript >=5.0.0，范围太松，
装上去不报冲突、一跑就炸。读源码看到 resolveTscPath 里唯一的适配分支是认
@typescript/typescript6，可见 Vue 侧目前给的路只到 6。硬上的代价是丢掉
刚清零的前端类型门禁，不值得。
顺带清掉一处假配置：apps/web 原本声明着 "typescript": "^7.0.2"，是
ae1fb32noreply@anthropic.com >
2026-08-25 17:39:50 -06:00
0e1e024fa4
chore(依赖): 升一批 patch/minor，锁死 mermaid-legacy 和 TypeScript 大版本
...
后端：@node-rs/jieba 2.0.1→2.0.2（含精确 pin 的 -linux-x64-gnu）、
bullmq 6.0.9→6.2.2、postgres→3.4.9、sql.js→1.14.2、web-tree-sitter→0.26.13；
hono ^4.0.0→^4.13.4 与 zod ^4.0.0→^4.4.3 只是把范围收紧到实装版本。
前端：@codemirror/view→6.43.9、highlight.js→11.12.0、mermaid→11.17.2、
naive-ui→2.45.2、pinia→4.0.3、y-codemirror.next→0.3.6、vite→8.2.2、
@types/node→26.3.0。
刻意没动两个：
- mermaid-legacy（npm:mermaid@^9.4.3）保持 9.4.3，vite 的 build target
也没碰 —— 机房 Chrome < 94 的兜底，legacy polyfill 产物照常生成。
- typescript 停在 5.9.3（只把根上的范围从 ^5.7.0 收到 ^5.9.3）。
7.0.2 是 Go 原生重写版，另开一个 commit 处理。
踩到的坑记一笔：`bun install` 不清理旧的嵌套副本。升完 @codemirror/view 后
md-editor-v3/node_modules/ 下留着一份 6.43.8，vue-tsc 立刻报
dispatchTransactions 私有属性冲突 —— 看起来像版本不兼容，其实
md-editor-v3 要的是 ^6.38.2，6.43.9 完全满足。当时全仓有十几处这种残留。
**升完依赖必须 rm -rf node_modules && bun install 再验类型**，否则会
对着一堆假的类型冲突查半天。
验证（删空 node_modules 重装后）：apps/api tsc 0 error、check:routes 167 条
无遮蔽、apps/web vue-tsc 0 error、vite build 通过、单二进制在仓库外起得来
并打库返回真数据、jieba 原生模块 dev 与编译两种形态都验过、BullMQ 两个
worker 正常 ready。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 17:39:06 -06:00
a03e22e60f
chore(前端): 删掉三个从 ojnext 搬来就没人用的文件
...
阶段 1 是「原样搬入、不改业务代码」，所以 ojnext 里已经死掉的东西也一起
搬了过来。这三个文件全仓零引用：
- utils/permissions.ts（usePermissions / checkRoutePermission）
- oj/ai/components/StreakStats.vue
- shared/components/IconButton.vue
确认方式：在 apps/web 全部 .ts / .vue / .json / .html / .js 里搜这五个名字
（排除文件自身）零命中；两个组件也不在自动生成的 components.d.ts 里，
permissions.ts 的两个导出同样不在 auto-imports.d.ts 里 —— 也就是说
它们连自动导入的注册都没拿到，不存在「模板里隐式用到」的可能。
permissions.ts 在 ojnext 里也是死的，不是搬运过程产生的。
vue-tsc 0 error，vite build 通过。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 17:37:58 -06:00
25c6e99c54
feat(后台): 补回「最高票评价」列，重写时漏掉了
...
管理端题目列表的「反馈」列一直是空的：前端渲染逻辑还在，后端两处
硬编码 topReaction: null —— 旧后端的 reaction/services.py:get_top_reactions
没有跟着迁过来，阶段 0 的清单也没抓到。
新增 services/reaction.ts，口径逐条对齐旧实现：
- 按 (problem_id, type) 分组计数，取票数最高的那个；
- 并列时按 reactionKeySchema 的定义顺序取靠前的，与前端 REACTIONS 的顺序
一致（旧后端是 TYPE_ORDER，已核对两边七个 key 的顺序与内容完全相同）；
- 只返回有评价的题目，没有的题调用方兜 null。
比库里可能残留、但前端已经下掉的类型多了一道跳过：不跳的话一个不再展示的
类型会以并列最优的身份把真正的最高票挤掉。
只有公开题列表下发，比赛题列表不下发 —— 与旧后端一致（旧的 top_reaction
只出现在 ProblemAPI，ContestProblemAPI 没有），前端那一列的注释也是这么写的。
实测：造 3 票 learned + 1 票 too_easy 取到 learned/3；interesting 与
too_hard 各 1 票时取到 too_hard（定义顺序在前）；插一条 obsolete_kind
不影响结果；无评价的题返回 null。探针数据已清理。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 14:08:09 -06:00
1198895b54
refactor(前端): vue-tsc 清零，type-check 可以当 CI 门禁了
...
接上 vue-tsc 时有 143 条既有错误，上一批迁移带走 89 条，这里把剩下的清完。
大部分是噪音（未使用的回调参数、死变量、少数 unknown），但里面躺着两个真问题：
- 个人主页查不存在的用户会抛：getProfile 返回 null 时后面照样取
.acmProblemsStatus，靠 `!` 压着。加了早返回。
- getProblemSetProgress 我上一批标错了类型：后台这个接口返回的是裸数组，
不是分页信封（和 oj 侧的 /user-progress 不一样）。已改正并加注释区分。
其余处理：
- 未使用的回调参数按 TS 约定加 `_` 前缀（v-for 的项、供子类重写的空钩子、
路由守卫的 from）；确认无用的局部变量直接删（clickX/clickY 算了点击位置
但飞出方向用的是随机角度，hasToday 下面已经用 lastDateOnly 判过，
prefix 算了周/月但标签里没用上）。
- App.vue 的 highlight.js 注册：Promise.all([...]).then(m => m.map(x => x.default))
会把元组塌成 (HLJSApi | LanguageFn)[]，hljs 上就找不到 registerLanguage。
改成逐个取 .default。
- 给一批 api 补上契约类型（getMetrics / getHitokoto / getTutorials /
formatCode / getProblemBeatRate / getClassUsernames 等），契约相应补了
8 个 z.infer 导出。
- ContestRank.submissionInfo 和 AcmHelperItem.acInfo 在 api 边界窄化成
SubmissionInfo —— 契约里是 Record<string, unknown>（JSONB 原文）。
- FlowchartEditor 的 TS2589：vue-flow 的 Node 嵌套太深，ref<Node[]>([]) 的
UnwrapRef 推导撞上实例化层级上限，改成 ref([]) as Ref<Node[]>。
- api2.ts 的响应拦截器**故意**不返回 AxiosResponse（要把 { data } 信封剥掉），
类型上确实说不通，没硬掰，写注释说明为什么用断言。
- 题目列表的「随机」按钮在模板里一直是注释状态，对应的 getRandom 和
getRandomProblemID 一并删除（后端 /problems/random 保留不动）。
验证：vue-tsc 0 条，apps/api tsc、check:routes、web build 全通过；
修过 key 的列都打接口确认过字段真实存在。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 14:04:10 -06:00
3d501e8b69
fix(试运行): 流程图/SQL 会往 Judge0 发出 language_id: undefined
...
Judge0 的语言 id 表里只有 C/C++/Java/Golang/JavaScript/Python2/Python3，
而 code.language 的类型包含 Flowchart 和 SQL —— 前者不是可执行代码，
后者由本站自己的 SQL 沙箱判，都走不到 Judge0。之前直接索引拿到 undefined
就发出去了。
改成 Partial<Record<LANGUAGE, number>>，取不到就提前返回提示。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 14:03:51 -06:00
d3348f994d
fix(前端): 一批表格列静默空白，题单进度点「移除」还会抛
...
没有 render 的列，naive-ui 直接按 key 取 row[key]。上一批把响应字段改成
camelCase 之后，这些列的 key 还留着 snake_case，取不到值就渲染成空白 ——
排行榜、题单进度、AI 报告、后台首页共 13 处。
这类问题类型检查够不着（列 key 是字符串），是扫「没有 render 的列 key 里
还带下划线」的组合才找出来的。
同一张表还有两处更严重的：
- 「用户」列 key 写的是 user.username，但后台 /admin/problem-sets/:id/progress
下发的是扁平的 username，没有嵌套 user。
- 点「移除」emit 的是 row.user.id —— row.user 是 undefined，直接抛，
学生根本移不掉。
test_case 那两处保留：读的是判题机 info.data 的原始键。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 14:03:51 -06:00
c2a81209d7
refactor(前端): 拆掉 camelCase→snake_case 转换层，契约成为唯一真相
...
utils/legacy.ts 是迁移期的临时层：新后端一律 camelCase，而组件读的还是
旧 Django 的 snake_case，于是在 api 层做一次递归键名重写。它自己的注释就
写了「迁移完成后这一层应当整体拆掉」。现在拆了。
代价不只是那 96 处包装：每个响应都要递归遍历整个对象重写一遍键名，而且
utils/types.ts 和 packages/contract 是两份真相 —— 手抄的那份还抄歪了好几处。
做法是按域推进，每域都用 vue-tsc 相对基线做差，确认零新增错误后再往下走。
前端的类型现在一律以契约为准，只在必要处窄化（比如 languages/template 的键
窄化成 LANGUAGE），删掉的重复定义包括 WebsiteConfig、LoginSummary、
AchievementSummary、ProblemSet、Contest、User、Profile、AdminTag、
StuckProblem 等等，其中 ClassComparison 有两个组件各手抄了一份。
## 顺带修掉的真 bug
- 管理端公告列表的「可见」开关每次都 400：列表响应被契约 omit 掉了 content，
而更新接口要求 content 必填，toggleVisible 把列表行原样回传。而且是乐观
翻转、不 await 不 catch，管理员看到开关动了、实际没存也没有提示。
改成先 GET 整条再 PUT，加失败提示。
- 删有提交的题时只显示笼统的「删除失败」：前端还在 match 旧 Django 的英文
文案，而后端返回的是 problem-has-submissions + 中文。连同另外 8 处同类
匹配一起改成判错误码 —— 文案是后端随时能改的，match 文案改一个字就静默失效。
- SubmissionStatus.time_limit_exceeded 写成 `1 | 2`，TS 按位或算成 3，和
memory_limit_exceeded 撞了同一个值。后端 judge/status.ts 里这是分开的
两个码，按后端拆成 cpu_/real_ 两项。当前没有代码读这两个成员，但
CLAUDE.md 明确要求判题状态码三处同步。
- 流程图历史翻到没有提交的那一页会直接抛：契约里 submission 是 nullable，
被 any 掩盖成看起来非空。补了 null 分支。
## 契约里被逼出来的三处不诚实
- grade 写成 z.string()，但 averageGrade() 在没有可用数据时返回空串，
前端三张图表拿它查 Record<Grade,...> 会查出 undefined。按实际收紧成
z.enum([...,""])，四个查表点都补了「无评级」分支。
- difficulty 写成 z.string()。核对过生产库 dump：956 道题只有
Low/Mid/High 三个值（761/149/46）。收紧成枚举。
- topReaction 写成 z.string()，既对不上前端渲染的 {type,count}，也对不上
旧后端 get_top_reactions 下发的形状。改成正确形状并注明当前恒传 null。
## 明确保留 snake_case 的 54 处
判题沙箱原始输出（cpu_time/exit_code/output_md5/compile_output）、
statistic_info 内容（err_info/time_cost/ast_results）、submission_info
JSONB（is_ac/ac_time/error_number，回滚时旧后端还要读）、SQL 判题引擎的
total_rows/order_sensitive/changed_tables、WebSocket 的 submission_id、
以及数据库选项键 enable_maxkb。每一处都在类型定义旁写了为什么不能改。
language 没有跟着收紧契约 —— 它是配置项、随时可能加语言，收紧会让新语言
在后端 parse 时直接抛。改在 api 边界一处窄化。
## 另外
- utils/http.ts 整个模块已是死代码（四处引用全是 import type），删除。
- profile 的 blog/github/school/major/language 五个字段全链路空转，没有
任何组件读，从契约到类型一并摘除（数据库列不动）。
- admin/account.ts 往 user_profile 塞的 totalScore 是 OI 模式遗留，表里
没这一列。Drizzle 按表定义拼列名会把它静默丢弃，所以没出过错，是死代码。
验证：vue-tsc 143 → 54 条且无新增，apps/api tsc、check:routes、web build
全通过；各域响应形状逐条打接口核对过。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 13:44:24 -06:00
b5edd6faf5
fix(比赛): 后台「审核」按钮从来不显示，老师进不去 ACM 审核页
...
判的是 `props.contest.rule_type === "ACM"`，而 rule_type 是阶段 0 砍掉
OI 模式时删掉的字段 —— 后端和契约里都不存在，`undefined === "ACM"`
恒为 false。路由、页面、接口都在（实测 acm-helper 返回 200），只有这个
入口按钮被自己判没了。
比赛只有 ACM 模式，条件直接去掉。
这条本来就在 vue-tsc 的既有错误里（TS2339: Property 'rule_type' does
not exist），只是之前没人跑，所以没人看见。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 13:43:45 -06:00
ae71055818
chore(前端): 接上 vue-tsc，模板里的字段名从此有类型检查
...
vite 不做类型检查，改错一个字段名只会在运行时变成静默 undefined ——
tsconfig.app.json 本来就 include 了 .vue，只是没人跑。装上 vue-tsc，
加 `bun run type-check`。
实测确认它能查到模板里的属性访问（往模板塞一个不存在的字段，如实报错）。
注意：它查不出模板编译错误（比如 v-model 绑了非 lvalue 的表达式），
所以 build 还是要跑，两者不能互相替代。
当前有 143 条既有错误，都是历史遗留，本次不清理。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-25 13:43:37 -06:00
2c6f8d11f3
fix(前端): 接回阶段 2 临时关掉、之后忘了打开的配置推送和 MaxKB
...
扫前端死代码时发现 apps/web 比 ojnext 多两个"没人调用的导出"：
useConfigUpdate 和 useMaxKB。查下去不是死代码，是**搬运时丢的接线** ——
ojnext 的 App.vue 调了这两个，apps/web 的没调，那里留着一句：
// 配置推送和 MaxKB 仍属于 Phase 3；在它们迁入前不连接旧 WebSocket。
阶段 2 因为后端还没有 /ws/config 而暂时关掉，说好阶段 3 迁完再开，然后就忘了。
阶段 3 早已完成。
表现是两个**静默**的功能缺失：管理员改站点配置后学生要刷新才生效；
知识库挂件根本不出现。都不报错，所以此前所有验证都没发现 ——
包括我昨天那轮浏览器走查，因为我不知道该期待它们出现。
## 验证
后端侧本来就是齐的（POST /admin/website 里已经调 publishConfigUpdate）。
接回来之后实测：
- 浏览器控制台出现 `[WebSocket] 连接成功: ws://localhost:8080/ws/config`
（之前根本不会连）
- 改站点名 → 收到 8 条 config_update 推送
- **页面全程不刷新，站点名从"判题狗-推送测试"自己变成"判题狗-实时生效了"**
中途我一度断言"configUpdateChannel 没有任何发布者"，那是错的 ——
路由调的是封装函数 publishConfigUpdate，我 grep 的是常量名。
## 顺带：两边前端的死代码规模已对齐
各 7 个没人调用的导出函数 + 2 个没人引用的 .vue。检测器已确认
unplugin-vue-components 只解析 Naive UI（无 src/components 目录），
本地组件必须显式 import，所以"没人 import"的判定是可靠的；
并用 3 个明确在用的导出反测过检测器本身。这批还没删。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-08 07:29:41 -06:00
2edb8cfb0d
fix(前端): 我改 /api2 前缀时漏了 5 处；修 4 个字段名不匹配；收紧 .gitignore
...
浏览器走查 + 真实 AI 调用暴露出来的，都是「接口好的、界面坏的」，
只靠脚本打 API 永远发现不了。
## 一、AI 功能和测试用例下载全都会 404（我今天造成的）
把 api2.ts 的 baseURL 从 /api2 改成 /api 时，只改了走 axios 实例的调用，
漏掉 5 处不走它的：
oj/store/ai.ts AI 题解分析 原生 fetch("/api2/...")
oj/problem/.../SubmissionResult.vue AI 提示 原生 fetch
oj/rank/list.vue AI 班级分析 原生 fetch
oj/class/pk.vue AI 班级 PK 原生 fetch
utils/download.ts 测试用例下载 独立 axios，baseURL "/api2/admin"
生产的 Caddy 只认 /api，这 5 条全是 404。阶段 0 的端点清单里就写着
「盲点 2：4 处用原生 fetch」「盲点 3：download.ts 是独立 axios 实例」——
我今天读过那份文档，还是漏了。
修完实测四条 AI 链路全通（真实 DeepSeek 调用）：
/api/ai/analysis 200 SSE 176 分片 5.2s start→delta→done→end 完整
/api/ai/hint 200 2.4s 且未泄露参考答案
/api/ai/class-analysis 200 12.6s
/api/ai/class-pk-analysis 200 12.6s
落库确认（ai_analysis 新增，model=deepseek-v4-flash 与旧后端一致）。
hint 对别人的提交回 404 是**正确**的，它用 userId 限定只能看自己的。
## 二、4 个字段名永久对不上（重写引入的回归）
适配器只在**大写字母**前插下划线：`top10Avg` → `top10_avg`；
而旧 Django 给的是 `top_10_avg`（数字前也有）。前端还按旧名读。
影响比"三列空白"大：`row.top_10_avg.toFixed(2)` 在 undefined 上抛异常，
Vue 放弃整个子树 —— 班级PK 和班级排名页的**整个「分层统计」面板都不显示**
（Q1/Q3/四分位距/标准差/前10%/中间80%/后10%/人数 全没了），控制台还不报错。
修完实测：前10%均值 194.80、中间80%均值 93.79、后10%均值 49.40 全部出现。
写脚本按这个规律全仓扫过，确认只有这 4 个，改完复查归零。
## 三、.gitignore 差一点把生产库提交上去
原来只忽略 data/test_case/ 和 data/judge_server/，而 compose 会在
data/postgres/ 生成**整个数据库**（含 raw_password 明文列）、data/redis/、
data/backend/（学生上传的文件）。这次 `git add -A` 报权限错误才发现 ——
只因为 postgres 容器用别的 uid、目录读不了才没提交成功。改成忽略整个 data/。
已确认历史里从没提交过这些。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-08 05:37:24 -06:00
34ae9b032c
fix(后台): SQL 测试点脚本读不出来时不能静默留一片空白编辑器
...
用浏览器把前后台走了一遍（这是第一次真的在界面上验证，之前全是脚本打 API）。
唯一找到的真问题在 SQLTestcaseEditor：
onMounted(async () => {
try { ... } catch {} // ← 静默吞掉
})
已有脚本读取失败时被 catch{} 吞掉，编辑器保持初始的 3 个空白项 ——
和「这题本来就没测试点」长得一模一样，教师完全看不出发生了什么。
改成：新题和旧格式测试点（404 problem-not-found / 409 not-sql-test-case）仍然
静默留空，那本来就是对的；其它失败挂一条 alert，并且把可操作的部分说全 ——
后端那句"测试点信息读取失败"只讲了现象，教师需要知道的是「下面是空模板、
直接存不会生效」。
保存本身是安全的，已实测：拿一道真实 SQL 题，在编辑器空白的状态下点提交，
test_case_id、测试点数（3）、sql_config 全部未变 —— 后端读不到测试点信息会
拒绝整个保存（400），不会把测试点清空。所以这条只是提示缺失，不是数据风险。
## 走查过程中的一次自我更正
中途我一度报告"保存返回 400 而界面没有任何错误提示"，那是错的：提示是正常
显示的，我第一次等了 4 秒才检查，而 Naive UI 的提示 3 秒就自动消失了。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-08 05:19:23 -06:00
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
ea521e7b0a
feat(阶段5): 镜像、三套 compose，前端切回 /api 与 /ws
...
## 镜像
一个 Dockerfile 两个 target：api（单二进制）和 web（Caddy + 前端产物）。
旧后端是一个容器里用 supervisord 跑 caddy+gunicorn+dramatiq，这里拆成
oj-web / oj-api / oj-worker 三个容器 —— Docker 本身就是进程管理器，
拆开之后 worker 挂了能单独重启、日志也分得开，少一层 supervisord 要维护。
同一个镜像换个子命令就是 worker，镜像里只有一份运行时。
新增 healthcheck 子命令：运行镜像是 debian-slim，没有 curl/wget，
让二进制自己打 /health（只打 /health 不碰库 —— 库挂了该由库的 healthcheck 报，
不该让 api 跟着被判不健康然后被重启）。
**数据目录照抄旧后端**（test_case、public/upload、public/avatar）。
不是审美问题：切换那天不用搬动任何文件，回滚时旧后端立刻能找到自己的数据。
少一次几十 GB 的 mv，就少一个在停机窗口里出错的机会。
构建路上踩到三个坑，都是「本地能过、容器里过不了」那一类：
- 构建上下文吸进了 data/，judge_server/run 是判题沙箱用别的 uid 建的，
docker 连 stat 都做不了，构建直接失败 → 补 .dockerignore
- mermaid@9.4.3（机房老 Chrome 的 legacy 依赖，不能砍）从容器里连
registry.npmjs.com 稳定失败，主机上没问题 → 换 npmmirror，并重试两次
- 容器里 bun 用 isolated 布局，本地是扁平的。靠「提升」才能解析到的包
在容器里一律解析不到：@node-rs/jieba-linux-x64-gnu（编译要 import 它的 .node）、
以及前端的 @codemirror/{language,state,view} 和 @lezer/highlight。
这些本来就是代码直接 import 的，补成直接依赖。顺手写了个脚本扫全仓，
确认只有这 4 个。
## 前端切回 /api、/ws
迁移期用 /api2、/ws2 指新后端，/api、/ws 还指着 Django。端点已全部搬完，
临时前缀去掉。改动只有三处（api2.ts 的 baseURL、websocket.ts 的两个 URL），
`api2` 那些 import 是模块名不是路径，不动。vite 代理同步收敛成三条。
## compose
- debian：全套（含 postgres，对外开 5445 给机房连）
- school：**没有 postgres**，连服务器的库；本地 Redis + 本地判题沙箱
- 两边共用一个库但各有各的队列和 WS 推送，和旧后端的 Dramatiq/Channels 拓扑一致
密钥一律走 env 且带 `:?`，没设置就直接报错退出，不静默用弱默认值。
COOKIE_SECURE 在机房必须是 false（http 直连 IP，带 Secure 的 Cookie 发不回来，
表现是「登录成功但立刻又变未登录」）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 23:41:20 -06:00
0f94e7ecbd
fix(阶段4): 两份独立安全评审的 Critical/Important 全部修掉
...
## 权限边界评审（后台 86 个 handler）
守卫本身一个没漏，问题全在对象级归属校验：
- C1 跨题单删奖章：先按 (id, problemsetId) 校验奖章归属再删，
否则拿自己的题单 id + 别人的奖章 id 就能把别人的 user_badge 删掉
- C2 make-public 无归属校验：补 canEdit，越权者拿不到题面
- I1 两个分析端点被 `/problems/:id` 遮蔽 —— Hono 按注册顺序匹配，
不是静态优先。挪到 `/problem-analytics/*`
- I2 from-public 只校验目标比赛归属：源题也必须是公开题库题
- I3 克隆比赛回传原比赛明文密码：克隆一律 password: null
- I4 upload-image 守卫比旧后端严，教师写题面会 403：收回 requireAdmin
两个互不可见的教师账号实跑复验，六条全部拦住。
## SQL 判题沙箱评审
- I-1 查询题只读被一句 `PRAGMA query_only=0` 关掉，实测 DML 拿到 AC。
query_only 自己就是个 PRAGMA，旧实现靠 authorizer 把 SQLITE_PRAGMA
一律拒了才没这个洞。现在 runStudent 逐语句拦 PRAGMA（用
sqlite3_normalized_sql 判关键字，注释和大小写由 SQLite 抹平），
并在每条语句前重放 query_only 和 max_page_count 兜底。
顺带修掉 M-1 里 max_page_count 学生可自行调大的部分。
- I-2 单条语句进了 step() 就打断不了，只能等父进程 SIGKILL，
而兜底时限是整个作业一口价 25s —— 1s 限的题要 26s 才判 TLE，
判题池只有 2 个槽，几发死循环就能把所有人堵住。
改成分阶段：子进程用 stderr 报 prepare/student/display，
父进程边读边换表，一进学生 SQL 就把兜底收到「题目时限 + 2s」。
实测 26s → 3.06s。
归因也跟着修了：卡在受信脚本（出题人的初始化脚本、标准答案）
现在报 SYSTEM_ERROR，不再当成学生超时甩 TLE。
engine.ts 头部那张防护对照表按实测重写 —— 原来那版把 query_only
写成等价于 authorizer 白名单，是不成立的。另记一笔：stock sql.js 的
wasm 没导出 progress_handler / interrupt / set_authorizer / limit，
想要得自己编，别再去翻了。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 21:59:42 -06:00
e3faa689e7
feat(阶段2补课): SQL 判题链路 + 最后两个后台端点
...
新后端此前完全没有 SQL 判题（旧 judge/sql_runner.py 378 行 + sql_dispatcher.py
113 行无对应实现），阶段 2 纵切时漏了这条与沙箱完全不同的路径。
judge/sql/engine.ts 判题核心，移植自 sql_runner.py，判定口径逐条对齐
judge/sql/child.ts 子进程入口
judge/sql/index.ts 父进程：spawn + 硬超时
judge/run.ts language === "SQL" 时分流，不经判题沙箱
POST admin/sql-test-cases/preview 题目页展示数据预览
POST admin/sql-test-cases/generate AI 按标准答案倒推初始化脚本
题目保存时重新生成 sqlDisplay（对齐旧 generate_sql_display）：取测试点 1 的初始化
脚本 + 标准答案跑一遍，失败一律拦下不让保存 —— 展示数据直接决定学生看到的表结构
与期望结果，宁可不保存也不能存错的。
## 防护换了实现，逐条实测
bun:sqlite 没有 authorizer / progress_handler / setlimit，且实测 Worker.terminate()
杀不掉跑飞的查询（原生代码占着线程）。改用「WASM 引擎 + 独立子进程」：
ATTACH → WASM 无宿主文件系统绑定，结构上够不到（比旧的 authorizer 更强）
查询题只读 → PRAGMA query_only=1
超时 → 子进程外部 SIGKILL
单值内存 → 子进程 ulimit -d
八条提交实测：正确→Accepted；列少一个/漏过滤→Wrong Answer；语法错误→Compile Error；
查询题里 INSERT→运行错误并说明；递归 CTE 死循环→CPU 超时；hex(zeroblob(2e8))→内存超限；
attach '/etc/passwd'→打不开。
## 踩到的两个坑（已写进 docs/specs/phase3-coverage.md）
1. ulimit 必须用 -d 不能用 -v。-v 限虚拟地址空间而 JS 引擎预留巨量地址，实测 -v 之下
Bun 退出时有概率 panic（SIGILL），结果早已写出但进程异常终止，父进程读到空串
误判成超时 —— 6 次里坏 2 次。换 -d 后 12/12 稳定。
2. 子进程写完结果直接 SIGKILL 自己，不走 process.exit()——后者仍有清理会撞限额。
至此 admin/api.ts 已无任何指向旧后端的调用。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 17:03:41 -06:00
007ae8619b
feat(阶段4): SQL 测试点脚本回显
...
GET admin/problems/:id/sql-scripts
只读磁盘上的 N.sql，不需要 SQL 引擎 —— 同组的 sql-preview / sql-ai-gen 要跑 SQLite
生成展示数据，新后端还没有那条链路，那两个仍指向旧后端。
实测：SQL 题回显两个脚本内容正确；测试点不是 SQL 类型返回 409 并说明；题目不存在 404。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:45:15 -06:00
cd5dd16f3b
feat(阶段4): 测试用例压缩包上传与下载
...
POST admin/test-cases
GET admin/problems/:id/test-cases （返回 zip 二进制）
落盘格式必须与判题沙箱镜像的约定一致（沙箱直接读挂进去的目录），已用真判题验证：
上传 zip → 建题 → 提交 Python 解法 → 沙箱读到用例并判出 Accepted。
安全与健壮性上比旧后端多做的几件事：
- **zip slip 从设计上进不来**：不遍历压缩包条目，只按精确文件名（`N.in`/`N.out`/`N.sql`）
取内容，条目名一律不参与路径拼接。实测带 `../../etc/passwd` 条目的包能正常处理，
且只取到 1.in/1.out。
- 单文件 32MB、解压后总量 128MB、测试点数 500 的上限，防 zip bomb 与写满磁盘 ——
旧后端一概没有，机房那台机器盘写满之后判题也会一起挂。
- 坏 zip 返回 400 而不是 500。
对齐旧后端的细节：CRLF→LF 归一；`stripped_output_md5` 按 Python `bytes.rstrip()`
的口径只剥尾部 ASCII 空白后再算（实测与 hashlib.md5 结果一致）；编号从 1 起连续、
遇缺口即停；SQL 包至少 2 个测试点（题目页会展示测试点 1 的期望结果，只有一个时
学生可以对照着硬编码 AC）；目录 0710、文件 0640。
## 顺带修掉一个只在判题时才暴露的路径 bug
config 里的相对路径（data/test_case、data/avatar、data/upload）原先按进程 cwd 解析，
而起服务的方式会把 cwd 切到 apps/api/，于是测试点落在 apps/api/data/ 下 ——
但 docker/compose.dev.yml 把**仓库根**的 data/test_case 挂进判题沙箱。两边不是同一个
目录，新传的测试点判题时会「找不到测试数据」，且只在真正判题时才暴露。
改成一律按仓库根解析，实测沙箱能看到新传的目录。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:42:54 -06:00
e396d78a07
feat(阶段4): 题目管理 / 比赛题目 / 比赛题⇄公开题互转
...
GET/POST admin/problems
GET/PUT/DELETE admin/problems/:id
POST admin/problems/:id/make-public
GET/POST admin/contests/:contestId/problems
POST admin/contests/:contestId/problems/from-public
合并了旧后端拆开的两套路由：旧 admin/problem 与 admin/contest/problem 的
GET 详情、PUT、DELETE 都只按题目 id 取、比赛是从题目推导出来的，分开没有意义，
还逼前端多传一个它未必知道的 contestId。现在共用 /admin/problems/:id。
归属判断按旧后端的口径分开：**比赛题看比赛的创建者，公开题看题目自己的创建者**
（旧 ensure_created_by(problem.contest, user) vs ensure_created_by(problem, user)）。
一道比赛题的 created_by 可能是克隆时的操作人，跟谁有权改它没关系。
题号唯一性的作用域也跟着走：公开题在全部公开题里唯一，比赛题在本场比赛内唯一。
删题不删测试用例目录，与旧后端一致（它把 rmtree 注释掉了）：删错了还能从磁盘捞回来，
而误删的测试数据没有别处备份；孤儿目录另有清理入口。有提交记录的题目拒绝删除。
## SQL 题目前只能编辑、不能新建
新后端**没有 SQL 判题链路** —— 旧 judge/sql_runner.py（378 行）+ sql_dispatcher.py
（113 行）无对应实现，languages.ts 里也只有 C/C++/Java/Golang/JavaScript/Python3 六种。
题目页给学生看的表结构与期望结果（sql_display）要跑 SQLite 现算，算不出来就没法建题。
因此：新建 SQL 题返回 501 并说明原因；**编辑已有 SQL 题时原样保留 sqlDisplay 不动** ——
不动它比生成一个错的安全，它直接决定学生看到的期望结果。SQL 的前置校验
（必须是唯一语言、要有 sql_config、要有 SQL 标准答案）照旧执行。
实测：学生 403；缺样例/缺输入描述/SQL 混语言三条校验文案与旧后端一致；
题号重复 409、跨比赛题号互不影响；公开题加入比赛后计数归零且标签带过来；
比赛题转公开后 visible=false、contestId=null、重复转 409；删除级联正常。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:37:20 -06:00
764e0d28cc
feat(阶段4): 标签管理 / 批量打标签 / 题目可见性 / 卡点与 AC 趋势 / 流程图 AI
...
GET/PUT/DELETE admin/problem-tags[/:id]
POST admin/problems/batch-tag
PUT admin/problems/:id/visibility
GET admin/problems/stuck
GET admin/problems/ac-trend
POST admin/problems/flowchart
要点：
- 后台标签列表用 leftJoin 且不加 having，能看到 problemCount=0 的标签 ——
那正是要清理的那些。oj 侧的 /problem-tags 才过滤 >0。
- 标签改名撞上已有标签视为合并：只给「还没挂目标标签」的题目补关系，
否则会撞 (problem_id, problemtag_id) 唯一约束。
- 批量打标签：add 时按需新建标签、remove 时只认已有标签 ——
否则「移除」会顺手造出一堆空标签。名字去重且大小写不敏感。
- **旧 ProblemVisibleAPI 的 `self.error(...)` 少写了 return**，题目不存在时会继续
往下跑并抛 AttributeError（500）。这里正常返回 404。
顺带记下一条阶段 5 的必做项（见 phase3-coverage.md 文末）：本地库按显式 id 从生产
导入，序列没跟着走，第一次新建标签就撞 problem_tag_pkey。只要切换流程里有
「导出→导入到新库」这一步，就必须重置全部序列，否则读全正常、第一次写才炸。
实测：学生 403；大小写重复与空白名去重后 tagCount=1、重复 add 幂等、
remove 不存在的标签 404 且不新建；纯改名 merged=false、合并 merged=true
affectedCount=1 且只剩一个标签；可见性取反两次复原、不存在的题 404。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:30:48 -06:00
5e0229db12
feat(阶段4): 题单管理（题目 / 奖章 / 进度三层）
...
GET/POST admin/problem-sets
GET/PUT/DELETE admin/problem-sets/:id
PUT admin/problem-sets/:id/visibility （取反语义，与旧一致）
PUT admin/problem-sets/:id/status
GET/POST admin/problem-sets/:id/problems
PUT/DELETE admin/problem-sets/:id/problems/:itemId
GET/POST admin/problem-sets/:id/badges
PUT/DELETE admin/problem-sets/:id/badges/:badgeId
GET admin/problem-sets/:id/progress
DELETE admin/problem-sets/:id/progress/:userId
修掉旧后端三个问题：
1. **后台列表写死了 visible=True，可它同时又提供「切换可见性」的接口** ——
一旦把题单设成不可见，它就从后台列表消失，再也没法在界面上改回来。
新实现不按 visible 过滤，后台能看见自己管的全部题单。实测取反两次仍在列表里。
2. **加题/删题/改分值后不重算学生进度**。往题单里加一道题，学生那边的
totalProblemsCount 还是老数字，进度百分比因此偏高，甚至已「完成」的人分母变了
却还标着完成。新实现加了 resyncProgress，实测 2/2 加一道题后变成 2/3 = 66.67%。
只重算分母与百分比，不碰 completeTime —— 已完成过的事实不因加题而撤销。
3. 把人踢出题单时一并收回他基于这份题单拿到的奖章，否则奖章悬空。
奖章重算对齐旧 recalculate_user_badges（那边靠 post_save 信号，这里显式调）：
只增删差集、保留已有记录的 earnedTime，否则每改一次条件所有人的获得时间都会
刷新成今天。实测 all_problems 建成时补发 1 人 → 加题后收回 → 改成
problem_count>=2 后重新发出 → 踢人后收回。
删题单要按序清五张子表（全是 NO ACTION 外键）：user_badge 挂在 problemset_badge
上，得先于 badge 删。
实测：学生 403；重复加题 409、加不存在的题 404、野状态/野奖章条件 400；
级联删除后五张表全为 0。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:25:14 -06:00
553c084579
feat(阶段4): 比赛管理 + 克隆 + ACM 赛后核查
...
GET/POST admin/contests
GET/PUT admin/contests/:id
POST admin/contests/:id/clone
GET/PUT admin/contests/:id/acm-helper
克隆是深拷贝：新比赛从 10 分钟后开始、时长与原比赛相同、一律不可见（时间是拍脑袋定的，
直接开放会让学生看到一场没准备好的赛），比赛题目连同标签一起复制，
提交数/通过数/statistic_info 归零 —— 克隆的是题面不是历史战绩。
实测：源题 99/55 两个标签，克隆出来 0/0 两个标签俱在。
两处比旧后端更严：
- **ACM 核查的 rank 必须属于本场比赛**。旧后端只按 rank_id 取，不校验归属，
带上任意 rank_id 就能改别的比赛的核查标记。
- 比赛详情/编辑越权时报「不存在」而不是「无权限」，不泄露「有这么个东西但你看不到」。
其余对齐：非超管只看得到自己建的比赛；空串密码归一成 null（否则 contestType 会把
「密码是空字符串」当成密码保护赛）；CIDR 按 ip_network(strict=False) 的口径校验，
允许主机位非零。
核查页的 realName 是**有意下发**的：这个页面就是老师对着名单确认谁抄了，
接口已由 requireTeacher + 归属校验双重把关。
实测：学生 403；结束早于开始 400、非法 CIDR 400 且文案带具体网段；创建空串密码
→ Public、改密码后 → Password Protected 且后台能读到密码原文；克隆时长一致且不可见；
不可见比赛的核查页 404；rank 不属于本场 404。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 16:02:28 -06:00
bc54fbff98
feat(阶段4): 站点配置 / 判题机 / 孤儿用例 / 概览 / 图片上传
...
GET/POST admin/website
GET admin/judge-servers
PUT admin/judge-servers/:id
DELETE admin/judge-servers/:hostname
GET/DELETE admin/orphan-test-cases
GET admin/dashboard
GET admin/random-usernames
POST admin/upload-image
顺带补上配置广播：旧后端改配置会经 WebSocket 推给所有开着页面的人，改完立刻生效。
新后端只服务 /ws/submissions，前端的 ConfigWebSocket 还连着旧 Django Channels。
现在加了 /ws/config 通道（同一个 Bun.serve 只能挂一个 handler，用 socket data 上的
kind 区分），前端 ConfigWebSocket 改走 /ws2/config。
几处判断：
- **判活不能比字符串**。库里 timestamptz 形如 `2026-08-07 13:42:50+00`（空格分隔），
toISOString() 是 `...T13:42:44.000Z`（T 分隔），字典序空格 < 'T'，同一天的心跳永远
小于阈值 —— 所有判题机都会显示离线。实测确实复现（dashboard 说 1 台在线、列表却
两台全 abnormal），已改为 Date.parse 后比较。
- 删指定的孤儿用例时**先确认它确实是孤儿**。旧后端不校验，一个手抖的 id 就能删掉在用
题目的测试数据，而测试数据没有别处备份。
- 图片上传的文件名完全由服务端生成，不带用户提供的任何一段；另加 10MB 上限 ——
旧后端靠 nginx 兜，但机房那台机器盘写满之后判题也会一起挂。
- 停用判题机后不再 process_pending_task()：任务在 BullMQ 里排着，worker 恢复自己接着
消费，不存在旧自研分发器那种「没有新提交就一直 waiting」的问题。
- dashboard 不再下发 env.FORCE_HTTPS / STATIC_CDN_HOST，前端从未读过。
实测：学生 403；配置读写回读 + oj 侧 /site 同步生效 + 还原；判题机列表带 token、
状态判定正确（一台 normal 一台 abnormal，与 dashboard 计数一致）；删不存在 404；
删非孤儿用例 404；随机点名缺班级号 400。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 07:43:38 -06:00
7e1a782747
feat(阶段4): 用户管理 + 成就管理；补上 rescan 与 contest_joined
...
GET/POST/DELETE admin/users （DELETE 走 body 传 ids）
GET/PUT admin/users/:id
POST admin/users/:id/reset-password
GET admin/achievement-metrics
GET/POST admin/achievements
GET/PUT/DELETE admin/achievements/:id
顺带补了新后端缺失的两块（不补的话成就后台建出来的东西是坏的）：
1. **rescanAchievement**：旧后端 `rescan_achievement` 的对应实现。判定平时只在判题
结算时发生，后台新建成就或调低阈值不会自动补发，必须显式扫一遍。补发标记
backfilled=true —— 前端据此只显示「已获得」不显示日期，否则一次补发会给几百人
盖同一个时间戳，把「最近获得」板块冲垮。
触发判据包含 metric 与 visible 的变化，不只看 operator/threshold：换维度、
以及从下架改上架（草稿期已达标的人）这两种都会漏。
2. **contest_joined 指标整个漏掉了**。旧 METRIC_REGISTRY 有 18 个指标，新后端只算
17 个，配在这个指标上的成就永远解锁不了。已补上计算，并把注册表抽成
services/achievement-metrics.ts 作为单一事实源 —— 后台下拉框和参数校验都读它，
避免「下拉框里选得到但没人算」这种组合。
用户管理的几处要点：
- className 解析位数不对**直接报错不猜**。猜错会把 class_name 存歪，而剥前缀显示
姓名、班级下拉、统计页都依赖它准确。
- problem_permission 按 admin_type 归一（超管恒 All、普通用户恒 None），否则把超管
降级成普通用户后他还留着 All。
- 改用户名要同步 submission.username 这个冗余列，否则历史提交查不到。
- openApi 已开着就不重置 appkey，否则每次保存用户都把对方的 key 换掉。
- **删除用户不复刻 Django 的应用层级联硬删**。用户是被引用最广的一张表，改成让
数据库外键拦下来：撞外键说明还有历史数据，应当禁用而不是删除，返回 409 并说明。
实测：学生 403；导入 2 人 / 重复 409 / 班级号位数报错文案正确；改名+降权后
permission 归一为 None、重名 409；重置密码 6 位无 0；删自己 400；
成就指标 18 项、新建后补发 unlockCount=2、野指标与野稀有度均 400。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 07:27:36 -06:00
af9cb796bd
feat(阶段4): 教程 / 练习 / AI 学情报告的后台接口
...
GET/POST admin/tutorials
GET/PUT/DELETE admin/tutorials/:id
PUT admin/tutorials/:id/visibility
GET admin/tutorials/:id/exercises
POST admin/exercises
PUT/DELETE admin/exercises/:id
GET admin/ai/reports （?pinnedOnly=true 不分页）
GET admin/ai/reports/:id
POST admin/ai/reports/:id/pin
几处判断：
- 练习改成挂在教程下的嵌套路径，旧后端是 ?tutorial_id= 查询参数。本来就是一对多的
从属关系，嵌套更贴事实，也省掉「忘了传 tutorial_id」这类错误。
- 删教程必须先删练习。Django 的 on_delete=CASCADE 是应用层实现的，库里外键实际是
NO ACTION（核对过 pg_constraint.confdeltype='a'），直接删会撞外键变 500。
已实测：带 2 个练习的教程能正常删掉且练习一并清除。**后台每个 DELETE 都要照此
核一遍子表**，这是本阶段的通用陷阱。
- 改可见性不动 updatedAt —— 上下架不是内容修改，改了会打乱按更新时间排序的直觉。
- AI 报告的 data / systemPrompt / userPrompt 一律不下发，里面是喂给模型的原始
学情数据与提示词。列表只给 120 字摘要，与旧 AIAnalysisListSerializer 一致。
实测：匿名 401 / 学生 403 / 超管 200；教程练习增删改查、非法 type 400、
挂到不存在的教程 404、置顶互斥（同一学生至多一份）、再钉一次取消，全部符合预期。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 07:10:34 -06:00
9a6c3ba225
feat(阶段4): 后台地基 + 公告管理
...
地基：
- auth/middleware.ts 加四个角色守卫 requireAdmin / requireTeacher /
requireSuperAdmin / requireProblemPermission，对应旧 account/decorators.py 的
四个装饰器。未登录 401 login-required、角色不够 403 permission-denied，
与前端 api2 拦截器按 code 分流的两支对上。
- routes/admin/ 目录 + 总入口挂在 /api/admin。角色守卫由各子路由自己挂，
不在总入口兜一层 —— 否则「这个接口要什么角色」从注册行看不出来，
正是阶段 3 Minor M2 踩过的坑。
- packages/contract/src/admin.ts 独立放后台契约。同一张表两侧下发的字段集不同
（后台要 visible，oj 侧连键都不该出现），混在一起迟早有人在 oj 侧复用后台那个。
- utils/legacy.ts：把 toLegacy / legacyResponse 从 oj/api.ts 抽出来共用。
admin 侧组件同样读 snake_case，走同一层适配，组件不动。
公告管理（旧 /api/admin/announcement 一个路径四个动词）拆成：
GET/POST admin/announcements
GET/PUT/DELETE admin/announcements/:id
一处有意不对齐旧后端：删除不存在的公告，旧后端 filter().delete() 静默成功，
这里返回 404 —— 后台是人手点删除，静默成功会让人以为删掉了，刷新后它还在。
实测：匿名 401 / 学生 403 / 超管 200；增删改查、列表不含 content、
空标题 400、不存在 404 全部符合预期。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 07:06:22 -06:00
ced8f3ee1b
docs(阶段3): 记录出口标准达成；补跑 prettier
...
覆盖率对账表更新：admin 侧 3/45 已实现，缺口 42。达成判据是 apps/web 的
oj/ 与 shared/ 两个目录已无指向旧 Django 的运行时调用，残留的 utils/http
引用只剩 ApiResponse 这一个类型。
顺带补跑 npm fmt，几个此前未格式化的文件随之改动，均为纯格式。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 06:48:20 -06:00
44f6f27841
chore(阶段3): 删除阶段 1 的临时验证物
...
GET /api/dev/problems、dev-problems.vue、对应路由项，以及只服务于它的
problemSummarySchema。阶段 1 用来验证「能从真实库读出一道题」，已完成使命。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 06:48:20 -06:00
6c18c57e7a
fix(阶段3): api2 补上鉴权失败的统一处理
...
utils/http.ts 的拦截器一直有两条全站行为：login-required 清登录态并弹登录框、
permission-denied 弹提示。api2 从建包起就漏了这两条，于是此前已迁移到 api2 的
所有端点在鉴权失败时都是「点了没反应」—— 调用方各自 catch 才能提示，漏一个
就静默。
新加的两个统计端点是教师专属，非教师点「统计」必然 403，会把这个洞放大到
用户能天天撞见，所以一并补上。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-08-07 06:48:20 -06:00
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
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
