19 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	959c326bc9	style(名字): 名字列按去掉 ks 前缀后的长度收窄，不再留一大块空 ... 原来的定宽是按 ks2312李鑫楠 定的（110～170px），现在名字最长 4 个字（在读的班 423 人里 5 人）。 只放名字的列收到 80px 左右；混着几个班、名字后面还有班号的（全部提交、全服 / 年级排名、 卡点分析没选班时）108px，最宽的「翁鑫叶炫 2312」95px 也放得下。改了提交列表、排名赛道和周榜、 比赛排名和成绩、题单全班情况、数据统计、后台自学情况和卡点分析、请假名单 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-11-02 23:51:28 +08:00
xuyueandClaude Opus 5.5	195069450f	style(格式化): 改成单引号、一行最长 160，全仓重新格式化 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 13:52:24 +08:00
xuyueandClaude Opus 5.5	b0700d0bd9	fix(界面): 能点的文字平时就是绿色，不用再把鼠标移上去才看得出能点 ... 首页「全部」、提交详情的用户名和题名、题目页「点开看全部」「有 N 道差一点」、 班级对抗的班级名、知识点、后台标题等 30 多处原来和正文同色，鼠标移上去才变色， 手机上根本没有「移上去」。现在一律主题绿，移上去加下划线；没设颜色的文字按钮补上 type="primary"。排名名字列、整行可点的列表、后台 quaternary 次要按钮不动。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-23 10:39:49 +08:00
xuyueandClaude Opus 5.5	309ca0ece2	refactor(前端): 全站共用的班级下拉、胶囊配色挪出提交列表目录，编辑器不再偷读题目页的 store ... - classLabel / groupClassOptions / classSelectOptions 挪到 utils/classes.ts，useTone 挪到 shared/composables/tone.ts：原来放在 oj/submission/ 下，被前台、后台、shared 引了 50 多处 - 流程图编辑器的草稿键改由题目页传进来（键名不变，学生存着的草稿照样读得到）。原来编辑器 自己读题目页的 store 和路由拼，后台出题页也用这个组件，那边 store 是空的 - SQL 表名补全改由题目页传表进来。原来补全直接读题目页的 store，自学页的 SQL 代码块会 补出上一道看过的题的表名 实跑：提交列表、题目页、排名、后台题目页、SQL 题、流程图题打开无报错；SQL 题输入 stu 补出 students；流程图加一步，草稿照旧存在 flowchart-v2-problem-<题号>。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-16 14:59:55 +08:00
xuyueandClaude Opus 5.5	64994b9499	perf(判题结果): 全班一起交、判题排队时不再每人每 2 秒问一次结果 ... 原来交上去 5 秒没结果就每 2 秒（流程图 3 秒）拉一次，分不清 WebSocket 断了还是队列长： 50 人一起交、队列排一分钟时每秒二十几个请求，全在和判题抢那两个核。 - 收到这一条的任何推送（服务端订阅时就回一帧当前状态）就认定 WebSocket 是通的， 轮询退到 20 秒一次，只防推送丢失；连接断了才回快档，2 秒起按 1.5 倍退到 10 秒 - 拉失败不再永久停掉（掉线那几秒拉失败是常事），连着失败 5 次才放弃 - 页面在后台时不拉；比赛题目页、榜单、班级页的定时刷新也一样，切回来立刻补一次 - 代码判题和流程图评分共用 shared/composables/fallbackPoll.ts Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-16 14:37:08 +08:00
xuyueandClaude Opus 5.5	cea2c7f102	fix(手机): 比赛排名表看不出能往右滑；班级 PK 每周图日期字太小；后台题目列表「藏着的」被切掉 ... - 比赛排名：手机上名字、做对、用时就占满一屏，每题的格子全在屏幕外。列收窄，前一两道题的格子露出来 - 班级 PK：每周人均横轴在手机上是 10px 的「10月12日」，改成 12px 的「10/12」 - 后台题目列表：手机上「全部 / 学生看得到 / 藏着的」换小号按钮，放不下就横着滑 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 12:44:57 +08:00
xuyueandClaude Opus 5.5	a5d5c39411	fix(手机): 收起键盘后「提交」按钮不回来；比赛领奖台第一名被挤出屏幕；iPhone 点输入框整页放大 ... - 题目页：安卓按返回键收键盘时编辑器不失焦，符号键一直贴底、「运行例子 / 提交」不回来。 改成看键盘真弹着没有（可视视口变矮），不只看焦点 - 比赛排名：结束后的领奖台三块共 646px，手机上第一名被切掉、第三名看不见；改成平分一行 - iPhone：点 14/15px 的输入框和代码编辑器，Safari 会整页放大且不缩回；只给 iOS 加 maximum-scale=1 - 登录：手机上选完班不再自动聚焦搜索框（键盘弹出来盖住半张名单） - 题单：窄屏上题目拆成两张没标题的卡片，像分了两组；放不下两栏时合成一张 - 「中等」在题目页是蓝色、在题目列表是橙色，统一成橙色 - 零碎：自学四列表格在 360 宽上收窄格子；统计「错得最多的题」表头不再挤成竖排； 「第 N 名」「14 道」不再把最后一个字甩到下一行 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 12:36:33 +08:00
xuyueandClaude Opus 5.5	da30ae1875	style(比赛/题单/班级PK/统计): 图例和规则说明跟排名页一样多，读起来像说明书 ... 比赛排名表底下的图例和用时规则、比赛题目页的「做对人数随时更新」和计分规则、 老师比赛班级页的「学生看不到这一页 · 15 秒刷新一次」和键盘提示； 题单详情的「加入以后…才算进度」「做对一道会自动回到这里」、题单列表的 「老师现在布置的」「加入过的在前」、老师题单进度表底部的颜色说明； 班级 PK 里「格子里是…」「条 = …」「皇冠 = …」「一根柱一档…」「这学期，最近 N 周」、 只有一个班做过的题那行、「根据上面这些数字写，仅供参考」； 统计里「没选班级，先按班级列出来…」「点方块在新页面打开这一条」； 流程图节点库的「拖拽节点到画布中」，都拿掉。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-10 14:17:42 +08:00
xuyueandClaude Opus 5.5	1e441411a5	style(前台): 页面整体放大一档，列表不再挤成一团；宽屏上内容居中，不再铺满到两边 ... - index.css 加一张 --oj-* 尺寸表和 .oj-page 外壳，二十几个前台页面改成引用它： 正文 14→15、页标题 20→24、题目/提交列表行高 40→48、比赛/公告 56、筛选控件 28→34 - 阅读型页面限宽 1200 居中；题目/提交列表 1600、比赛详情 1400、排名 1280、班级 PK 1440 - 1280 宽的筛选条放大后放不下，题目/提交列表在 1366 以下退回 13px 的字 - 班级 PK 五个班起格子里不写「一次 x%」（只剩「一次 8…」）；赛跑图线尾的数字不再被截掉 - 手机上比赛列表的「没参加」挪到比赛名下面；题单里「以前做对过 · 旧代码先藏着」缩成「做对过」 - 题目详情页（编辑器）和后台不在这一轮 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-10 12:43:12 +08:00
xuyueandClaude Opus 5.5	0cee4ef779	fix(名字): 比赛成绩、全班情况、看板、题单、统计里的名字不再用真名，一律和排行榜一样显示 ks241XXX；导出成绩去掉姓名列 ... 两个写法不同的 UserName 合成 shared/components/UserName.vue 一个。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-10 06:44:42 +08:00
xuyueandClaude Opus 5.5	151bbdcb50	feat(比赛): 比赛页一页看题目和自己的名次；排名竞争感做足、结束有领奖台；老师考试中看全班、考完看成绩；新建比赛一屏做完 ... - 学生比赛页（设计稿 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	6bf8c6e1d9	style(前台): 列表页去掉表头 emoji、已结束的比赛改成灰色；比赛列表置顶进行中的比赛，排名页先看榜单 ... - 前台 53 处表头改成纯文字，删掉只剩这一个用途的 utils/renders.ts - 「已结束」从红色改灰色（比赛列表 / 详情 / 后台 / 首页一起） - 比赛列表第一页、无筛选时顶部列出进行中和即将开始的比赛 - 内容少的页面页脚贴底，不再悬在半屏 - 排名页两张柱状图挪到最后，第一屏是 Top100、本周进步榜和我的排名 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 20:13:29 +08:00
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +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	5222e012e1	fix(比赛): 修四处 —— 倒计时两倍速、排名不自动刷新、题目状态恒空、比赛隐藏后审核页取不到代码 ... 查比赛功能时实跑出来的四个问题，都在这一条里修掉： **倒计时两倍速**（store/contest.ts）。init() 里 setInterval 之前不清旧表，而 detail.vue 在「未开始 → 进行中」那一刻会再 init 一次（为了捞开赛后才拿得到的题）， 于是两个 interval 一起给 now 加 1000。学生赛前挂着页面就会中招：一场 60 分钟的 比赛，真过了 30 分钟页面就显示「已结束」、倒计时归零，而服务端还在正常收提交。 ojnext 里就有，是原样搬过来的。 **排名页「开启自动刷新」开着但不刷新**（contest/pages/rank.vue）。useIntervalFn 传的是 immediate: false，而 watch(autoRefresh) 只在开关变化时才 resume —— 开关初值就是 true、进页面不产生变化，表从没启动过，得手动关一次再开。改成 watchEffect，由「开关 + 比赛进行中」共同驱动，顺带不再在赛后空转轮询。同样来自 ojnext。 **比赛题的 myStatus 恒为 null**（routes/contest.ts）。判题其实把状态记进了 user_profile 的 acm_problems_status.contest_problems，只是这两条路由硬编码下发 空值，于是题目页的「状态」列永远是「未做」，赛后也不恢复。旧后端在赛后/管理员 视角是给的，这是回归。不按赛中赛后分档：这是学生自己的判题结果，不泄露别人任何 信息（旧后端赛中不给，只是因为它整条路换了个 serializer）。 **比赛一隐藏，审核页的「查看代码」必 404**（services/contest.ts）。acm-helper 故意不卡 visible（赛后核查恰恰发生在比赛收起来之后），它调的比赛提交列表却卡着， 两边对不上。findVisibleContest 换成 findAccessibleContest：公开的谁都取得到， 隐藏的只有比赛管理员取得到，学生看隐藏比赛照旧 404。 实跑验证（dev 全栈，判题走临时 worker 绕开本机 token 不一致）： - 浏览器跨过开赛时刻挂着不动 —— 墙钟 20.0 秒，倒计时正好减 20 秒（原来会减 40）。 - 排名页停在「无数据」，另一账号提交一发 AC，5 秒内表格自己长出 `1 student2 1/3 0:00:42`，没刷新页面。 - 学生 AC 后列表和详情都回 myStatus: 0，没做过的另一个学生仍是 null，匿名照旧 401。 - 比赛隐藏 + 已结束：出题人 detail / problems / rank / submissions / acm-helper 全 200，学生这 5 条全 404，提交也 404，隐藏比赛不进公开列表。 - 排名记账口径未受影响：10 次提交（8 编译失败 + 2 AC）落库 submission_number=9、 accepted_number=1、total_time=231=ac_time、is_first_ac=true。 tsc / vue-tsc / check:routes（175 条无遮蔽）均干净，测试数据已清库。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017xu912Rv5JUUuy6MqMcQW2	2026-09-07 19:19:29 -06:00
xuyueandClaude Opus 5	cf1eea0810	fix(比赛): 学生管理员开卷、导出只剩十行、排行榜翻页错位等四处 ... ## 学生管理员在比赛进行中能看所有人的代码 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	0b7b08f2cc	refactor(前端): 去掉 { error, data } 信封，api2 改名 api ... 信封是 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
xuyueandClaude Opus 5	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
xuyue	ae1fb329b5	feat(阶段1): 搬入 ojnext 为 apps/web，未改业务代码	2026-08-06 21:18:16 -06:00