26 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	38360e8668	perf(流程图): 流程图改用 pele 渲染，懒加载从 200 kB 降到 44 kB（gzip） ... mermaid 换成 obsidianmd/pele：同一套 Mermaid 语法、同步渲染、没有依赖。 库里 2170 张图（题目参考图 36、学生提交 2134）两边逐张对过，能画的和报错的完全一致。 配色按 pele 的 DOM 重写选择器，颜色不变；版本锁死在 1.6.0。 顺带按 modernPolyfills: true 重新探测了 polyfill 清单（50 项），并改正注释里 「DEBUG 会打印全集」的说法 —— 写死清单时它只回显清单。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-19 20:50:17 +08:00
xuyueandClaude Opus 5.5	801d84c53b	feat(登录): 登录框改成点名字：打开就是这个班的名单，点自己再输密码；老师和往届写用户名，这台电脑上次怎么登下次就怎么开；注册完直接登上 ... - 学生登录 / 管理员登录两个页签和「没有我所在的班级」合成一条「写用户名」，入口是名单底下的「名单里没有我」「老师登录」 - 名单按拼音排、可打拼音缩写筛，只剩一个人时回车就选中；这台电脑没登过时先列出全部班级 - 密码错就地标在密码框下面（「密码不对，再试一次」），错太多次按钮灰掉写清 15 分钟 - 注册保留邮箱，错在哪个框标在哪个框下面，按钮改「注册并登录」 - name / autocomplete 原来写在 n-input 上、落在外层 div，没到真正的 input；改走 input-props，点名字时的密码框才真的不会让浏览器填上一个人的密码 - 登法和班级一样跨退出登录保留；authModal store 只管开关，表单回到组件里 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 21:48:30 +08:00
xuyueandClaude Opus 5.5	c1cd908fa2	chore(文档): CLAUDE.md 里几处和代码对不上的说法改成现状 ... - 格式化行宽早就回到 Oxfmt 默认的 100，去掉「printWidth: 80 别删」 - 前端不再是「从 ojnext 原样搬来」，大部分页面已重写 - 判题镜像已没有 Node；时间列、入参校验处数这两个会变的数字去掉 - 前端路由 meta 补上 requiresTeacherAdmin，composables 补上 problemJump / teacherHelp Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 19:00:23 +08:00
xuyueandClaude Opus 5.5	0ee5444ede	feat(后台设置): 设置页重排成网站、班级、开关、判题机几块，保存挪到右上角；班级按年级分组不用再拖；判题机写出多久没动静；AI 小助手（MaxKB 挂件）整个删掉 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 14:37:35 +08:00
xuyueandClaude Opus 5.5	845e41c060	feat(自学): 自学重做——首页课程地图、读一课按项目分目录、代码块就地运行、学完给题做 ... - 顶栏「自学」进新的自学首页 /learn：接着学（按服务端记录，不再串到上一个学生）+ 按项目分组的课程地图 - 读一课：左边目录按项目折叠，正文加宽，右边本课大纲带练一练标记；去掉了不能运行的示例代码栏 - 正文里的代码块能改能运行，报错用题目页那套中文解释；读输入的代码出输入框 - 课末：练一练做到几道 → 学完了 → 老师挑的几道题（必会标出来）→ 下一课 - 练一练统一成绿色提交、结果一行字；手机版目录从底部弹出 - 后台：教程列表按项目分组拖动排序，编辑页左写右看、练一练插到光标处、挑相关题； 自学情况改成方块格 + 还没打开过的名单 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 09:40:34 +08:00
xuyueandClaude Opus 5.5	1ba8928d41	feat(课堂看板): 「请假隐藏」不会用——改成班级旁一个「请假」按钮勾名单，请假的人变灰排到最后、今天有效 ... 原来要先打开开关、名字变成带 × 的标签再点 ×，× 像删除；标完人从页面上消失， 恢复只能全部恢复。现在： - 班级下拉旁「请假」按钮，标了人之后按钮直接写「请假 2 人：陈言、黄依露 · 修改」 - 弹框只列今天还没交过的人（请假的人一定在里面，刚上课时就是全班），勾上点确定 - 请假的人在表格里变灰排到最后，不算进进度和「还没交过」 - 交了题或举手就算来了，自动取消标记 - 有效期从两小时改成今天（请假一般是一整天），仍然只记在这台电脑上 顺带修掉：被标过的学生后来交了题，会从表格里整个消失、也不算进进度。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-09 10:38:25 +08:00
xuyueandClaude Opus 5.5	91d9c9c6d7	feat(首页): 登录后不再弹「登录速报」，上次来做了什么、哪道还没做对放进首页，带「接着做」 ... - 新接口 /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	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	eb32676de4	feat(题目): 「运行例子」「自己输入」改用和提交同一台判题机——例子上跑出什么样，提交在这几个例子上就是什么样 ... 原来试运行走另一台 Judge0：C 是 GCC 9、编译参数也不一样，Python 的语法错误回来的是运行错误， 没有题目的时间内存限制和代码模板，例子上的结果常和提交对不上。现在走本站判题机 （POST /trial-runs），同一套编译命令、这道题的限制和模板，对不对也由判题机比。 - 不落库、不算提交、不进判题队列：api 进程里自己排队，全站同时 TRIAL_CONCURRENCY 批 （服务器 2、机房 4），每人最多两批，排满或等超过 30 秒就请学生过一会儿再点 - 死循环不停打印时判题机回包会很大，超过 16MB 就掐断，告诉学生输出太多、停不下来 - Python 语法错误用和提交一样的说明：第几行、中文标点标红、一键换成英文 - 运行时错误和提交用同一个解析，说清楚第几行、为什么（下标越界、int() 转换失败、段错误……）； 比赛里照旧只给按结果码的那一句 - 语法没过、服务没跑成时，标题不再说「N 个例子没对上」 - 后台「生成测试点」一并迁过来，编译警告不会再写进 .out；Judge0 的地址和调用全部删掉 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-29 08:09:44 +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	45505e8384	feat(题目): 工具栏加「运行例子」、结果页签加「自己输入」，去掉每个例子旁的「测试」和顶栏的分栏切换 ... - 工具栏「运行例子」：一键用全部例子试跑（Judge0，不算提交），结果进「结果 › 运行例子」， 每个例子 ✓ / ✕，没对上的沿用答案错误那套中文说明；比赛里只摆输出、不给提示句 （后端在比赛里故意不做例子对比）；SQL 题不给 - 「结果」页签分成提交结果 / 运行例子 / 自己输入三段；「自己输入」顶替顶栏「自测」模式 那个单独的编辑器 - 试跑出错（编译、运行、超时）给中文说明，Judge0 的英文原文折叠起来 - 例子比对两边都去掉末尾空白：原来只 trim 了运行输出，样例末尾带空格的题永远「不通过」 - 去掉题面里每个例子旁的「测试」、顶栏的「双栏 / 自测 / 题目」切换、EditorForTest 和 screenMode store Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-28 14:35:58 +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
xuyueandClaude Opus 5.5	41cd141769	docs(CLAUDE.md): 修正前端文档里指错的路径，补上提交约定 ... - apps/web/CLAUDE.md 三处 `../CLAUDE.md` 指向不存在的 apps/CLAUDE.md，改成 `../../CLAUDE.md` - composables 清单补上 aiStream - 删掉与旧版本对比的措辞（< 94 基线、mermaid-legacy、PUBLIC_OJ_URL）和格式化、时区的历史记录 - 新增「提交」一节：直接在 main 上干活、中文提交信息格式（原来只写在 AGENTS.md，Claude Code 读不到） Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 19:27:22 +08:00
xuyueandClaude Opus 5.5	ca1df38440	chore(web): 构建配置清理 —— 别名读 tsconfig、调高 chunk 警告阈值、删死掉的 browserslistrc ... - resolve.alias 换成 resolve.tsconfigPaths，别名只在 tsconfig.app.json 写一份 - chunkSizeWarningLimit 调到 1000：超 500 kB 的三个 chunk（skulpt / wangeditor / @mermaid-js/parser）都是懒加载，默认阈值下每次构建都报，真涨了反而看不见 - 删 .browserslistrc（chrome >= 90）：renderLegacyChunks 关着时 plugin-legacy 不读它， vite / oxc 也不读，留着只会和 105 的基线打架 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 16:15:05 +08:00
xuyueandClaude Opus 5.5	44295188b9	chore: 格式化、lint、任务编排换成 Vite+ ... Prettier + oxlint + 散在各包的检查脚本，收成 vite-plus（1.0.0-rc.1）一套，配置只有 根目录 vite.config.ts 一份： - fmt（Oxfmt，替掉 Prettier）：semi: false、printWidth: 80。Vite+ 下 Oxfmt 默认 100 列， 不显式写 80 就是 267 个文件的 diff。范围和原来 Prettier 一致，只管代码 —— md / yml / json / toml 排掉（文档表格、compose 注释是手排的），db/meta 快照和 unplugin 的两个 .d.ts 照旧排掉。.prettierrc.toml / .prettierignore 删除 - lint（Oxlint，vite-plus 自带同版本 1.85.0，单独的 oxlint 依赖删掉）：denyWarnings。 范围从三个 src 目录扩到全仓，多抓出 apps/web/vite.config.ts 里没人用的 loadEnv，删掉 - run.tasks：typecheck:api / typecheck:web / check:routes / check:ast 四个检查 + 汇总的 verify（vp check + 前四个）。一律经 `bun run <脚本>` 调 —— 任务定义在根包，PATH 是根 目录的 node_modules/.bin，直接写 tsc 拿到的是根目录的 TS 5.9 而不是 apps/api 的 TS 7， 实测报一堆假错 - 根脚本：fmt → vp fmt，lint → vp lint，新增 check → vp check。verify 不设同名脚本 （Vite+ 不许任务和脚本重名），用 `bunx vp run verify` - dev 仍是 bun run --parallel：常驻进程，缓存用不上 实测：verify 首跑全过；第二遍 5/5 命中缓存、0.25 秒；往 apps/api 塞一个类型错误， 只有 typecheck:api 和 check:routes 重跑并失败、前端直接命中缓存；.vue 里塞类型错误 同样被抓到；denyWarnings 下有一条 warning 退出码就是 1。前端构建、后端单二进制编译照常。 代价：vite-plus 带 vitest、tsgolint 等约 120MB 依赖，只进 Docker builder 阶段、不进运行 镜像，CI 的 --prebuilt 部署不受影响。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-09-27 15:37:23 +08:00
xuyueandClaude Opus 5	ed56a209ea	chore(格式): Prettier 统一到全仓，后端和契约一次性格式化 ... 原来只有 `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	a8408c0bb5	docs: 文档整理，CLAUDE.md 瘦身一半，删掉重写期已完成的 22 份阶段产物 ... CLAUDE.md 从 490 行降到 228 行：只留日常要当场记住的约束，展开拆成五份专题 文档 —— docs/deploy.md（部署与备份恢复）、database.md（迁移执行器、基线、 drizzle-kit 的坑）、timezone.md（时区口径与那次成就订正）、contract.md （出参不 parse 的四次故障）、ast-rules.md（AST 规则与 C++ 的调用形态）。 删掉的是阶段 0–5 那批一次性产物：4 份实施计划、10 份评审/核验/修复报告、 endpoint-inventory.md（110 端点是 2026-08 的快照，现在 363 条路由）、 docs/spikes/ 的 spike 与提取脚本（结论早已落进代码）。phase5 切换手册删之前 先把仍然有效的部分提炼进 docs/deploy.md：拓扑、deploy.sh、部署后验证清单、 NPM 那两个不能关的开关、pg_dumpall 恢复的两个坑、镜像体积；演练报告与回滚 两节随旧栈下线一并作废。 两份设计文档保留，补上状态行说明它们是「当初为什么这么定」而不是现状。 apps/web/CLAUDE.md 顺手订正过期内容：PUBLIC_OJ_URL / PUBLIC_WS_URL 两个变量 早已不存在（baseURL 写死 /api，dev 走 vite proxy、线上由 Caddy 同源伺服）， store 与 composable 清单补齐到与目录一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 08:03:26 -06:00
xuyueandClaude Opus 5	3559ae4d6f	chore(前端): 浏览器基线从 Chrome < 94 提到 105，删掉 mermaid@9 那套 fallback ... 机房只有部分电脑还是 Chrome 105，其余更新，按最低那档定基线。 - legacy 插件留着：vite 8 的默认 build.target 是 chrome111，比机房高。 modernTargets 不写，用插件自带的 chrome>=105 基线，正好是这一档。 - polyfill 清单按 105 重新探测，63 → 50 项，仍然写死：自动探测要对每个产物 跑 Babel 扫描，构建 3s → 12s。写死后产出的 polyfills chunk 与自动探测同尺寸。 - 删 mermaid-legacy(mermaid@9)、useMermaid 里按 UA 分叉的 v9 回调式 render、 为它存在的 cytoscape UMD→ESM 别名 —— 105 直接用 mermaid 11。 - View Transitions 要 111，darkTransition 的降级分支保留，注释改成 105。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-16 07:43:21 -06:00
xuyueandClaude Opus 5	cc51e305cf	refactor(时区): 常量收进契约、SQL 统一走 localTime，去掉会话时区与 TZ 兜底 ... - TIME_ZONE / TIME_ZONE_OFFSET_MINUTES 移到 packages/contract/src/time.ts， 前后端共用一份，不再各写一遍靠注释对齐。 - apps/api/src/time.ts 新增 localTime(列)，替换散落 7 处的 `at time zone ${TIME_ZONE_SQL}`；ac-trend 的 where 复用同一个 year 表达式。 - /problems/:displayId/yearly-ac 漏写了时区、按 UTC 切年，被会话时区兜底掩盖； 改为按东八区切（只影响每年 12-31 北京 0–8 点的提交归年）。 - 删掉数据库连接的 TimeZone 和 Dockerfile 的 TZ：正确代码不依赖它们， 它们只会在线上掩盖漏写处、让 dev 与线上答案不同。 - time.ts：calendarDayYearsAgo/pad 并入 shiftMonthsByCalendar，startOfCalendarDay 并入 todayStart，localWeekday 改用 getUTCDay，删掉历史叙述注释。 - 前端 zonedParts 改为固定偏移 + getUTC*（与后端、日期选择器同一写法）， 去掉 Intl formatToParts；10 万次 299ms → 11ms。zonedYear 去掉按浏览器时区的兜底。 - 两份 CLAUDE.md 同步；n-date-picker 那条过时说明改成现用法。 验证：新旧「近两年起点」21359 个时刻 0 差异、localWeekday 0 差异、 前端固定偏移与 Intl 在 America/New_York 下 47821 个时刻 0 差异； localTime 在 select/group by/where 复用可用；fix-achievement-hours 预演仍为 148 / 60。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 06:06:52 -06:00
xuyueandClaude Opus 5	4c0c38445c	fix(时区): 日历口径收回东八区，读出的时刻统一成 ISO 并保留微秒 ... 旧栈 Django 按 Asia/Shanghai 算日历，OJ2 重写时这个锚点丢了：容器和数据库会话 都是 UTC，于是「今日提交」在北京时间 0–8 点是空的，「凌晨/早起提交次数」整体偏 8 小时，热力图、AC 趋势年份、近两年活跃人数也各按进程时区切。 - 新增 apps/api/src/time.ts 作为唯一锚点（固定 +8 偏移，不依赖进程 TZ / tzdata）， todayStart、成就小时/日期键、热力图、月份平移、年份夹逼全部改走它； SQL 里按日历切的一律显式 at time zone。 - db/index.ts：连接会话时区设为东八区（兜底）；给 timestamptz(1184) 挂 parser， 读出统一成 ISO 8601 UTC，撤掉为拿 PG 文本形状写的 ::text。parser 保留微秒 —— 生产库 12.3 万条提交几乎全带微秒，截成毫秒会让翻页分界行和班级 AC 排名的 <= min(create_time) 把自己排除（翻页每页丢一条、排名少 1）。 - 前端 parseTime/zonedParts/zonedYear 按 Asia/Shanghai 渲染，n-date-picker 做 toPickerValue/fromPickerValue 平移，站内不再按浏览器时区取时间部件。 - Dockerfile 设 TZ=Asia/Shanghai 作为第二道兜底。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1d8B3f4SXJwDvUY625eQd	2026-09-14 05:55:17 -06:00
xuyueandClaude Opus 5	ab47e71d6f	refactor(契约): 出参不再 parse，后台老题详情和站内信页不再 500 ... ## 出参改 satisfies 出参是后端自己刚拼出来的字面量，TS 编译期已经验过；再 xxxSchema.parse({...}) 一遍 拿不到任何新信息，唯一可能失败的输入是库里的历史数据，而失败的代价是 500。136 处 全部撤掉，撤的时候当场炸出两个一直存在的线上故障： - 后台打开任何一道没编辑过的题都是 500 —— problem.last_update_time 是全库唯一可空 的列（961 道题里 470 道是 NULL），而 adminProblemSchema.lastUpdateTime 写的是 z.string()； - 收到过站内信的人打开消息页全是 500 —— embeddedSubmissionSchema 从 submissionDetailSchema 继承了 problemDisplayId 却没 omit，路由只填了同义的 problem；列表为空时才碰巧不炸，所以一直没人报。 两个都是读出侧校验自己造出来的故障，不是它拦住的故障。 ## 校验责任挪回写入侧 - db/schema.ts：枚举型的列和几个形状确定的 JSONB 挂 .$type<>()（submission.result / .language、problem.difficulty / .languages / .template / .astRules / .sqlConfig / .sqlDisplay、achievement.rarity / .operator、exercise.type、reaction.type、 tutorial.type、problemset.difficulty / .status、flowchart_submission.status、 problemset_badge.condition_type、acm_contest_rank.submission_info）。只影响 TS、 不产生 SQL，断言逐列拿根目录那份生产备份核过全量数据。 - createProblemRequestSchema.languages 收窄成 problemLanguageSchema，兑现 problem.languages 列上的断言。 - 新增 routes/helpers.ts 的 asFilterValue()：query 筛选值（result / language / difficulty / status）要和收窄过的列比较时做纯类型交接，不加校验 —— 在这儿拦一道 会把「筛出空列表」变成「筛条件被忽略、返回全部」。 - 判题产物（submission.info / statistic_info / exercise.data）照旧放行，形状真相 在判题机那边；judge/sql、flowchart/run、events.ts 里对自家产物的 parse 一并撤掉。 - 仍然 parse 的只有 judge/events.ts 的 parseSubmissionEvent —— 从 Redis 收回来的 报文是真边界，失败返回 null 而不是 500。 顺带清掉两处重复的真相：stringArray 原本在 routes/helpers.ts、routes/problem.ts、 routes/submission.ts 各有一份拷贝，5 个调用点全部只作用于 problem.languages，列有类型后 三份一起删；routes/site.ts 里和契约同名同形的本地 interface Quote 也删了 —— loadSentences 读入时已经逐字段守过，那处 parse 同样是多余的。 ## 文档 CLAUDE.md 那一节从「契约收紧要挑地方」改写成「出参不 parse，用 satisfies」，写明 三处写入侧闸门（入参 safeParse 58 处、列上 $type、语义校验函数）；apps/web/CLAUDE.md 同步 —— 现在收紧字段的后果落在 tsc 编译期，但契约形状仍要对得上存量数据。 ## 验证 - 生产备份全量：12.4 万条提交的 result 全在 -2..6,10、961 道题的 languages 均为合法 数组、10050 条榜单条目形状全对，无一例外； - tsc -p apps/api 与 vue-tsc --noEmit 均 exit 0；check:routes 检查 177 条路由，无遮蔽； 前端 build、单二进制编译并在仓库目录之外启动均通过； - 实跑 40+ 端点（学生端 / 后台 / AI / 榜单 / 题目回写往返），以及一次完整比赛 e2e： 建比赛 → 复制题目 → 错解 → 正解，把 judge/run.ts 榜单写入的三个分支全走到 （error_number 0→1、is_first_ac + ac_time 671、totalTime 1871 = 671 + 1×20×60）， 后台核查页的勾选与 404 分支一并验过，测试数据已清理； - 两个 500 用抓到的真实响应对着改动前的契约复验：lastUpdateTime 收到 null、 problemDisplayId 收到 undefined，改动后同样两个响应均通过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 18:14:05 -06:00
xuyueandClaude Opus 5	b9a80d62bc	docs(CLAUDE.md): 合并顶部叠着的更正块，订正前端验证方式，补上契约收紧的边界 ... ## 顶部 两层引用块套着一段「2026-09-10 更正」，说的是同一件事的两个版本（7 张表已删 → 其实还剩一张）。合成一段现状：旧栈不可逆下线、唯一退路是备份恢复、漏网那张 django_migrations 由 0014 补删。考古过程留在迁移文件的注释里，这里不重复。27 行 → 14 行。 ## 常用检查 `cd apps/web && bun run build` 后面那句「vite 不做类型检查，构建即验证」是错的： vite 确实不做类型检查，但**构建也不是验证**。补上 `bun run type-check`，并写明两条 会静默通过的假路子 —— `vue-tsc --noEmit -p tsconfig.json` 检查 0 个文件（那个 tsconfig 是 files: [] + references 的壳，0.2 秒跑完就是信号）、`vite build` 不看类型。 后端也改成 `bun run --filter '@oj2/api' typecheck`（脚本本来就有）。 ## 新增「契约收紧要挑地方」 前一个 commit 的教训值得留在这儿：契约 schema 后端也在读路径上 parse，收紧字段 等于给历史数据加闸，对不上要么 500（exerciseSchema）、要么静默塌成 {}（info， 9163/124192 条）。JSONB 原文的形状真相在写入侧，闸就设在那里；要收紧先拿生产备份 跑全量，重点看空值不是键集合。AST 规则的 astRulesError() 本来就是同一个道理。 ## apps/web/CLAUDE.md Commands 段还是 ojnext 时代的 npm start / npm fmt，全部换成 bun 并补上 type-check 的坑。Module Pattern 写的 `views/` 这一层实际不存在（页面组件直接放模块根下）， api.ts 也不按模块分（学生端 oj/api.ts、后台 admin/api.ts、跨端 shared/api.ts）。 工作区根目录的 CLAUDE.md / AGENTS.md 同样折叠了那段更正、订正了类型检查命令 （那两份不在 git 里）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012j1vgeDqay8wKCh8dPgPcH	2026-09-10 04:57:34 -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	5da661d7f0	refactor(契约): 补上 AI / 站内信 / 自学留痕等接口的闸门，并订正前端 CLAUDE.md 的过期内容 ... 闸门再补 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
xuyueandClaude Opus 5	d1fc6349b7	refactor(web): 删掉 y-webrtc 协同编辑的旧实现 ... sync.ts / syncStatus.ts、y-webrtc 依赖、PUBLIC_SIGNALING_URL 全部移除， 外部信令服务器 signaling.xuyue.cc 不再被使用。 顺带修掉 CLAUDE.md 里「协作在流程图编辑器」这句一直是错的描述。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016DHxhKNxXfG89JnVzHbvgj	2026-08-30 08:22:06 -06:00
xuyue	ae1fb329b5	feat(阶段1): 搬入 ojnext 为 apps/web，未改业务代码	2026-08-06 21:18:16 -06:00