6 Commits

Include renames

Author	SHA1	Message	Date
xuyue	d25b5dbe6d	update	2026-09-27 19:36:28 +08:00
xuyueandClaude Opus 5	4d7be969d9	refactor(智能分析): 重排版面，砍掉重复的三张周期图，补三个新维度 ... 原来 8 张图挤在两列大网格里，左列还套了一层两列小网格 —— 四张小图各自只有半页的 一半宽，"难度掌握情况"的标题被挤断成两行、周期图的 x 轴标签斜着叠在一起、一年热力图 53 列塞进半宽几乎看不清。改成单列为主，宽的图给全宽，窄的图两两并排。 砍掉的重复：进步曲线 / 提交效率 / 周期综合读的是同一个 durationData，半年视图统共 6 个桶四个字段，摊成三张卡六条曲线还都是双轴。合并成一张：柱是完成题目数和总提交数， 线是 AC 率，等级进 tooltip（S/A/B/C 四档离散值连成折线读不出东西，逐题等级表格里有）。 同期解题排名分布也砍了：五片扇形对十几道题做统计本来就是噪声，而排名逐题列在 SolvedTable 里，饼图没有增加任何信息。 换形式： - 标签雷达图 → 横向条形。雷达对比较大小是最差的形式之一，原来还把值归一化成"占最多 标签的百分比"，第一名恒为 100%，等于只画了个排序。现在画真实题数。 - 难度掌握情况 → 难度分布。去掉叠在里面的 S/A/B/C 维度，3×4 十二个格子对一个两个月 做十来道题的学生大部分恒为 0。 热力图改成一格一周（53 格，周一起算，最后一格是本周）。按天切的话一年 365 格里三百多 格是空的，中职学生一年也就二三十天有提交，整张图看着像没用过。颜色阈值跟着按周重定。 新增三个维度： - 错在哪里：判完的失败提交按状态码分组。编译错误占大头说明语法不熟，答案错误占大头 说明是逻辑问题，两种情况老师该给的建议完全不同。 - 几次做对：到首次通过为止提交了几次，分一次过 / 2-3 / 4-6 / 7次以上。原来只有一个 "平均提交次数"，看不出分布。 - 流程图得分：detailsData.flowcharts 早就在下发，但全页一张图都没有，只在解题表格的 第二个 tab 里列着。 顺带： - 时间活跃度从"只统计 AC 时间"改成"统计全部提交"，星期和时段由后端按东八区聚合。 只看 AC 的话十来个点撒进 7×4 的格子几乎全是空的，和热力图的时区口径也对不上。 - 两两并排用弹性容器而不是固定两列网格：知识点分布在没有标签时整张卡不渲染， 固定两列会空掉一半。 - AI 卡片原来有三个条件挂载点（solved>10 在右列、≤10 在全宽行、=0 藏在 Overview 里面），单列之后收成最后一张无条件的卡。 - DurationChart 右轴的 S/A/B/C 一个刻度都没显示过：轴范围 -0.5~3.5，生成的刻度值是 -0.5/0.5/1.5/2.5/3.5，拿去索引 gradeOrder 全是 undefined。 契约新增 activity / errors / rankScope / solved[].attempts / durationData[].acceptedCount。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LZuPwqDmLEiK9zgQ9z9sVn	2026-09-03 03:08:54 -06:00
xuyue	69883bd016	fix chart	2026-09-03 02:35:29 -06:00
xuyueandClaude Opus 5	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
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