6 Commits

Include renames

Author	SHA1	Message	Date
xuyueandClaude Opus 5.5	09e5e0bfcf	feat(后台 AI 报告): 报告列表带上学生是哪个班的 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-13 14:11:07 +08:00
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +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	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	d3757954cd	fix(AI 学情报告): pinnedOnly 那支返回裸数组，页面每次打开都白屏 ... `GET /admin/ai/reports` 同一个 URL 返回两种形状：带 limit/offset 时是 `{results, total}`，带 `pinnedOnly=true` 时是裸数组。前端 getPinnedAIReports 声明的返回类型是 AdminAiReportList、读的是 `res.results`，于是 `pinnedReports.value` 被赋成 undefined，模板里 `pinnedReports.length > 0` 在渲染时抛 `Cannot read properties of undefined (reading 'length')`， 整个页面白屏。空库也照抛 —— 裸数组同样没有 .results。 置顶那支改成同样的 `{results, total}` 信封，total 就是条数。「不分页」的意图 没变，只是别再让一个 URL 有两种形状：调用方没法照着一个类型写，类型标注也就 成了谎话。 验证：本机起 dev 栈，用 headless chromium 走 CDP 抓未捕获异常。修之前 /admin/ai/reports 稳定复现 `TypeError ... at Proxy._sfc_render (src/admin/ai/list.vue:182)`；修之后同一页面零异常，且置顶提示条正确渲染出 「以下 2 位用户的 AI 分析报告已被锁定」加两个用户标签、表格 3 行，PIN 切换 往返（取消 → total 1、再 PIN → total 2）也正常。 顺带把另外 19 个后台/学生端页面扫了一遍，只有这一处抛异常。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-27 00:18:58 -06:00
xuyueandClaude Opus 5	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