9 Commits

Author	SHA1	Message	Date
yuetsh	127718dc06	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/submission.ts）。 ## 文档 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 条路由，无遮蔽。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-10 05:45:15 -06:00
yuetsh	25b86ec17e	refactor(提交): 删掉从来没用起来的「提交互相可见」 ... problem.share_submission（题目级）和 submission.shared（单条）两个开关，连同 判定分支一起删掉。 生产备份（2026-08-07）里的实际用量：956 道题只有 2 道开过 share_submission， 还都是 contest_id=1 的比赛题 —— 比赛未结束时那条分支根本走不到，等于一天都没 生效过。123140 条提交里 shared=true 的有 40 条，39 条在 2022 年、1 条在 2023-03-30，之后近三年零使用；出题页从来没给过题目级开关，单条分享的入口在更早 那版前端上，ojnext 和 OJ2 都没搬过来，OJ2 里 PUT /submissions/:id 一个调用方 都没有。 canViewSubmission 剩下三条：本人 / 管理员（比赛中的 Student Admin 除外）/ 本题 作者，其余一律看不到。结尾的 `shareSubmission || shared` 没了；它上面那条「比赛 未结束一律不给」也一并去掉 —— 走到那里的必然不是这三种人，现在无论比赛与否都是 false，留着是重复的。allowShared 参数随之消失，它唯一的用途就是分享开关的归属 校验。 一并删掉：PUT /submissions/:id、响应里的 shared / canUnshare（列表、详情、站内 信内嵌三处）、题目详情与后台题目里的 shareSubmission、shareSubmissionRequestSchema， 以及新建提交时那句 shared: false（列上本来就有 default false）。 两个数据库列保留不删，只在 schema.ts 上注明已停用：删列是破坏性迁移，而留着不读 不写零成本，还留着那 40 条的历史痕迹。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XvmqDsZNyUo9P3sFQtoWVB	2026-09-07 07:18:41 -06:00
yuetsh	bd84599174	feat(自学): 教程和练一练都留痕，老师能看到谁学了多少 ... 自学模块以前一个字节都不落库：读到第几课只存在浏览器的 localStorage 里， 练一练的对错是组件内的一个 ref，刷新即失忆。老师能看到的只有「谁交了题」。 现在两张新表： * tutorial_progress —— 一个学生 × 一课，记打开次数和累计停留秒数 * exercise_attempt —— 一个学生 × 一道练习，记试了几次、错了几次、 第几次做对的、最后一次做错时填的什么 都存聚合不存流水。练习那张表尤其明显：流水会随着学生反复点提交无限长， 而多出来的行回答不了任何新问题 ——「他第 3 次和第 5 次都选了 B」对老师 没有意义，「他试了 7 次才对」有。 停留时长只在页面可见、且十分钟内有过操作时才计。机房的电脑经常开着页面 就走了，不设这道闸的话「停留时长」会变成「电脑开机时长」，老师看到的 数字全是假的。换课、切标签页、关窗口都会先把攒着的秒数冲给**离开的那一课**。 练一练的对错仍然是前端判的：答案本来就随题面一起下发到浏览器，后端再判 一遍也挡不住任何人，只是重复实现七套判题。所以这是教学观察数据，不是成绩。 `last_wrong_answer` 存的是前端拼好的一句人话（「选了 C」「顺序 3-1-2」）， 不是原始作答结构 —— 七种题型形状各不相同，存结构就得在后台按题型各写一套 渲染，而老师要看的只是他错在哪。 顺带修掉预测输出题的一个老问题：它的 `submitted` 一旦为真就不再收回，而 `allCorrect` 是跟着输入实时算的，于是学生错一次之后把答案改对，界面直接 跳成「输出正确！」、提交按钮同时禁用，submit() 再也执行不到 —— 这道题 **永远不会被记成做对**。排序/连线/找错/分组四种题本来就在交互处把 submitted 置回 false，只有这里漏了，按同一套补上。 学生端：目录每课显示「✓ 已读 · 11 分钟」和「练一练 3/5」。教程保持免登录 可读，未登录只是不留痕，并明说一句。 老师端：后台新开「自学情况」（教师及以上可进），三个 tab —— 按学生（默认把读得最少的排在最前，这张表要回答的是谁还没开始）、 按练习（每道题的正确率、一次做对几人、做对的人平均试几次；展开看逐人明细 和他们最后错在哪）、按课程。班级框填 3-4 位是具体班级，1-2 位当年级前缀。 外键用了库级 CASCADE，和 Django 建的那批 NO ACTION 不同：删教程、删用户 不必再记得回来手工清子表。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GW5ef6C2kRW8Ru27ghCaUu	2026-09-01 08:54:27 -06:00
yuetsh	36a4663193	chore(前端): 清掉四处零引用的死代码 ... 按名字扫了一遍 api 层导出和 utils 常量，四处全仓零引用： **`getContestProblem`**（admin/api.ts）—— 和紧挨在它上面的 `getProblem` 逐字 相同，同一个 URL、同一个类型。旧后端 admin 侧比赛题和公开题是两个端点，合并 之后这个壳留下来了。 **`createMessage`**（oj/api.ts）—— 两代前端都只有定义没有调用。参数名还是旧 后端那套（recipient / submission），函数体里再映射成契约的 recipientId / submissionId，等于给一个不存在的调用方写了个兼容层。 d3b05b8 删掉了它的类型 CreateMessage，函数漏了。 后端 `POST /messages` 是完整实现的，只是后台那个页面 （admin/communication/messages.vue）两代都是一句「未完待续」的占位。 在端点上加了注释说明这件事，免得下次扫「无人调用的端点」时被当成可删。 **`CONTEST_TYPE`**（constants.ts）—— 和上面 30 行处的 `ContestType` 枚举 一模一样。枚举那份有 8 处在用，这个对象零引用。 **`LANGUAGE_ID`**（constants.ts）—— Judge0 的语言 id。真正在用的那份在 utils/judge.ts 的 JUDGE0_LANGUAGE_ID，而且**只有那份是对的**：死掉的这份把 Golang / JavaScript / Python2 全写成了 0，谁要是拿它去调 Judge0，这三种语言 的在线试运行会静默发出 `language_id: 0`。 顺带确认过没有 `constants["LANGUAGE_ID"]` 这类动态取值。 验证：vue-tsc 0 error、vite build 通过、tsc(apps/api) 0 error、 check:routes 168 条无遮蔽。四处都是零文本引用的纯删除。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-25 23:32:50 -06:00
yuetsh	5c772319e9	refactor(契约): 公告两侧形状分开，判题状态码从契约派生 ... ## 公告：一个 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
yuetsh	95625d6711	refactor: 另外两处守卫也收到注册行上 ... 走查题单进度时撞到 `/problem-sets/:id/user-progress` 对学生 403 —— 那是**正确**的 （它是给教师看全班进度的），但守卫又写在 handler 体内。评审的 M3 只列了 3 处， 按同一模式扫全仓，还有 2 处： content.ts POST /messages isSuperAdmin problemset.ts GET /problem-sets/:id/user-progress isTeacherOrAbove 改用 requireSuperAdmin / requireTeacher，理由同 M3：守卫要能从注册行上看出来， 不然下一个人加同类端点容易漏掉那个 if。 实测档位没变：学生两条都 403，教师看全班进度 200。 路由遮蔽检查仍然干净。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-08 06:28:44 -06:00
yuetsh	cebaa87b13	fix(Minor M-1): 站内信内嵌提交改用独立 schema，并修复题号链接 ... 两件事： 1. 内嵌的 submission 之前复用 submissionDetailSchema 并把 info / ip 写死成空值， 于是键仍留在响应里。旧 SubmissionSafeModelSerializer 是 exclude，这三个键 根本不出现。改成独立的 embeddedSubmissionSchema —— 形状对上了，将来有人 把空值改成真值也不会变成泄露，因为这里压根没有这三个字段。 2. 顺带修掉一个评审没覆盖的真回归：内嵌 submission 给的是 problemId（数字主键）， 而旧 serializer 的 problem 是 SlugRelatedField(slug_field="_id")，即展示用题号。 oj/user/message.vue:20 拿它拼 /problem/<题号>，迁移后拼出的是 /problem/undefined， 题号那一栏也是空的。改为下发 problem，实测返回 "1004"。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-07 07:01:13 -06:00
yuetsh	b4b61af6b0	fix(阶段3): 匿名不可读用户档案，真名改为默认不下发 ... F1：GET /profiles/:username 只挂了 optionalAuth、handler 内无登录判断， 匿名可读 email、adminType、className、lastLogin。用户名又能经 /rankings/users 公开枚举，等于可以无 cookie 批量收集全校学生的邮箱与最后登录时间。 handler 开头补上未登录即返回空，对齐旧后端 account/views/oj.py 的 UserProfileAPI.get 首行 `if not user.is_authenticated: return self.success()`。 F2：旧后端把「是否下发真名」做成 UsernameSerializer(need_real_name=False) 的默认关闭开关，全仓 11 处调用只有比赛榜单一处显式打开；新后端没搬这一层， 真名随用户对象无条件下发，13 个下发点里 8 个匿名可达。 这里补回同一层：helpers.ts 新增 sampleUser()，realName 默认不下发， 需要的地方显式传 { includeRealName: true }。12 个下发点改为走这个函数， 只有比赛榜单一处打开（对齐 contest/serializers.py:84 的 is_contest_admin）。 没有逐处删字段 —— 那样下次新增端点还会重犯。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-07 01:59:05 -06:00
yuetsh	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