只改界面文字和注释：网址 /problemset、接口、表名、字段名都不动，老链接照常能打开。 设计稿页名「题单重设计」和已执行的迁移文件保留原样。 线上 3 个成就（题单收藏家 / 入门 / 通关）已同步改名。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
xuyueandClaude Opus 5.5 committed
1 parent
959c326bc9
commit
1b703d13ae
68 files changed
+306
-306
No files matched your search
@@ -11,7 +11,7 @@ type ProblemLink = { problemId: number; isRequired: boolean }
|
||||
type BadgeCheck = Pick<ProgressRow, 'completedProblemsCount' | 'totalProblemsCount' | 'progressDetail'>
|
||||
|
||||
/**
|
||||
* 题单进度的唯一算法：学生做出一道题后的增量更新、后台改动题目后的批量重算，都走这一份。
|
||||
* 专题进度的唯一算法：学生做出一道题后的增量更新、后台改动题目后的批量重算，都走这一份。
|
||||
*
|
||||
* 以前两边各写一遍，于是各自漂了一段：后台那份不碰 is_completed（加一道题之后分母变大，
|
||||
* 人还标着「已完成」）、不清理 progress_detail（删掉一道题之后没做的题被算成做了）。
|
||||
@@ -19,7 +19,7 @@ type BadgeCheck = Pick<ProgressRow, 'completedProblemsCount' | 'totalProblemsCou
|
||||
*/
|
||||
export function computeProgress(detail: Record<string, unknown>, links: ProblemLink[], previousCompleteTime: string | null, now = new Date().toISOString()) {
|
||||
const inSet = new Set(links.map((link) => String(link.problemId)))
|
||||
// 已经移出题单的题目要从 detail 里剔掉，留着它 completed 就会比实际做出的题还多。
|
||||
// 已经移出专题的题目要从 detail 里剔掉，留着它 completed 就会比实际做出的题还多。
|
||||
// 老数据的每一项还带着 score（分数已经拿掉了），原样留着无害
|
||||
const kept: Record<string, unknown> = {}
|
||||
for (const [key, value] of Object.entries(detail)) {
|
||||
@@ -27,17 +27,17 @@ export function computeProgress(detail: Record<string, unknown>, links: ProblemL
|
||||
}
|
||||
// 分母只算必做题。「（选做）」这个标签一直只是卡片上的一行字，进度分母和 all_problems
|
||||
// 奖章照样要求做完 —— 快照里 22 个人做完了全部必做题，界面却显示未完成、全通奖章也拿不到
|
||||
// （题单 5/6/8/11）。选做题做对了照样算进「做对 N 道」奖章，只是不卡完成。
|
||||
// （专题 5/6/8/11）。选做题做对了照样算进「做对 N 道」奖章，只是不卡完成。
|
||||
//
|
||||
// 一道必做都没标的题单退回「全部都算必做」：那种题单多半是没用这个字段，而不是
|
||||
// 一道必做都没标的专题退回「全部都算必做」：那种专题多半是没用这个字段，而不是
|
||||
// 真的整单选做；不兜住的话它永远完不成。
|
||||
const required = links.filter((link) => link.isRequired)
|
||||
const graded = required.length ? required : links
|
||||
const gradedKeys = new Set(graded.map((link) => String(link.problemId)))
|
||||
const completed = Object.keys(kept).filter((key) => gradedKeys.has(key)).length
|
||||
const total = graded.length
|
||||
// total > 0 这个前提不能省：0 === 0 同样成立，没有题目的题单会让人一加入就算「完成」，
|
||||
// 还会写下 complete_time、计进「完成题单数」成就，而且后面补上题目也不会自愈。
|
||||
// total > 0 这个前提不能省：0 === 0 同样成立，没有题目的专题会让人一加入就算「完成」，
|
||||
// 还会写下 complete_time、计进「完成专题数」成就，而且后面补上题目也不会自愈。
|
||||
const isCompleted = total > 0 && completed === total
|
||||
return {
|
||||
progressDetail: kept,
|
||||
@@ -46,9 +46,9 @@ export function computeProgress(detail: Record<string, unknown>, links: ProblemL
|
||||
isCompleted,
|
||||
// 只设不清，语义是「曾经完成于」，对齐旧栈 problemset/models.py:218。
|
||||
//
|
||||
// 「未完成 + 有完成时间」是允许的组合，快照里就有 4 条 —— 题单 8 那批人在它
|
||||
// 「未完成 + 有完成时间」是允许的组合，快照里就有 4 条 —— 专题 8 那批人在它
|
||||
// 还只有 6 题时完成过，老师后来加到 12 题，进度退回未完成，完成时间留了下来。
|
||||
// 反过来清空的代价是不可逆：往一个 100 人已完成的题单里加一道题、再改主意删掉，
|
||||
// 反过来清空的代价是不可逆：往一个 100 人已完成的专题里加一道题、再改主意删掉，
|
||||
// 这 100 个人的历史完成时间就一起被冲成了「现在」。
|
||||
completeTime: previousCompleteTime ?? (isCompleted ? now : null),
|
||||
}
|
||||
@@ -57,7 +57,7 @@ export function computeProgress(detail: Record<string, unknown>, links: ProblemL
|
||||
type ProgressWrite = ReturnType<typeof computeProgress> & { id: number }
|
||||
|
||||
/**
|
||||
* 一条 UPDATE 刷完整批参与者。逐行 update 的话一个班的题单就是上百次往返，
|
||||
* 一条 UPDATE 刷完整批参与者。逐行 update 的话一个班的专题就是上百次往返，
|
||||
* 而每行要写的值都已经在内存里算好了，没有一个依赖数据库现有的值。
|
||||
*/
|
||||
async function writeProgress(rows: ProgressWrite[]) {
|
||||
@@ -93,11 +93,11 @@ async function writeProgress(rows: ProgressWrite[]) {
|
||||
}
|
||||
|
||||
/**
|
||||
* 奖章达标判定的唯一实现。学生做出一题、后台改题单、补发脚本三处都调它 ——
|
||||
* 奖章达标判定的唯一实现。学生做出一题、后台改专题、补发脚本三处都调它 ——
|
||||
* 以前是三份各写一遍。
|
||||
*
|
||||
* problem_count 数的是**做出的题目总数（含选做）**，不是 completedProblemsCount
|
||||
* （自从分母只算必做，那个只数必做题）。老师当初是按题单的总题数设阈值的：题单 5
|
||||
* （自从分母只算必做，那个只数必做题）。老师当初是按专题的总题数设阈值的：专题 5
|
||||
* 的「一职欧拉」要 8 题，而它的必做只有 7 道 —— 改用必做计数会让这枚奖章一夜之间
|
||||
* 不可得，76 个已经拿到的人被 recalculateBadge 收回。
|
||||
*/
|
||||
@@ -144,11 +144,11 @@ export async function recalculateBadge(badge: BadgeRow, known?: (BadgeCheck & {
|
||||
}
|
||||
|
||||
/**
|
||||
* 题目集或分值变动后，把所有参与者的进度整体重算一遍，再重算这份题单的奖章。
|
||||
* 题目集或分值变动后，把所有参与者的进度整体重算一遍，再重算这个专题的奖章。
|
||||
*
|
||||
* 别信「旧后端不做这件事」那个说法（本仓早先的注释里有，是错的）：旧栈用 signals 做了，
|
||||
* 而且两件事都做 —— problemset/signals.py 在 ProblemSetProblem 的 post_save / post_delete
|
||||
* 上重算全部参与者的进度、再重算该题单全部奖章的资格。重写时 views 里看不到显式调用，
|
||||
* 上重算全部参与者的进度、再重算该专题全部奖章的资格。重写时 views 里看不到显式调用，
|
||||
* 就当成没做，于是奖章那一半漏了，生产快照里攒下 53 条应发未发（30 名学生）。
|
||||
*
|
||||
* 那 53 条里有 23 条另有出处：旧栈的管理命令 fix_problemset_progress 按实际 AC 记录补
|
||||
@@ -177,16 +177,16 @@ export async function resyncProgress(problemsetId: number) {
|
||||
}
|
||||
|
||||
/**
|
||||
* 判题通过后，把这道题记进该用户所有「已加入且包含这道题」的题单。
|
||||
* 判题通过后，把这道题记进该用户所有「已加入且包含这道题」的专题。
|
||||
*
|
||||
* 以前这件事由前端做：SubmitCode.vue 看到 AC 就回调 PUT /problem-set-progress，而且只回调
|
||||
* 路由参数里那一个题单。于是从普通题库入口做出同一道题不计进度、网络一抖进度就静默丢失；
|
||||
* 路由参数里那一个专题。于是从普通题库入口做出同一道题不计进度、网络一抖进度就静默丢失；
|
||||
* 旧栈为此专门有个管理命令 fix_problemset_progress 定期按实际提交补账，2026-05-22 那次
|
||||
* 批量补进度就是它跑的（而它不补奖章，53 条漏发里的 23 条由此而来）。
|
||||
*
|
||||
* 挪到判题这一路之后，记账和判题在同一个事务链里，前端只管显示。
|
||||
*
|
||||
* 不按 visible / status 过滤：进度是学生自己的记录，老师把题单藏起来不该让它停止累积。
|
||||
* 不按 visible / status 过滤：进度是学生自己的记录，老师把专题藏起来不该让它停止累积。
|
||||
*/
|
||||
export async function recordSolvedProblem(userId: number, problemId: number, solvedAt: string) {
|
||||
const joined = await db
|
||||
@@ -250,7 +250,7 @@ export async function recordSolvedProblem(userId: number, problemId: number, sol
|
||||
}
|
||||
|
||||
/**
|
||||
* 记题单进度，并把这一下拿到的徽章、解锁的题单类成就推给学生。判题（judge/run.ts）和
|
||||
* 记专题进度，并把这一下拿到的徽章、解锁的专题类成就推给学生。判题（judge/run.ts）和
|
||||
* 流程图评分（flowchart/run.ts）两条路都在「这道题做完了」的那一刻调它。
|
||||
* 记账失败不往外抛：判题 / 评分本身已经落库，不能因为进度没记上就把整次判题算失败。
|
||||
*/
|
||||
@@ -289,16 +289,16 @@ export async function recordSolvedAndNotify(userId: number, problemId: number, s
|
||||
}
|
||||
}
|
||||
|
||||
/** 题单现在是不是在布置期内。按数据库的钟算（`now()`），和防抄闸门同一个口径 */
|
||||
/** 专题现在是不是在布置期内。按数据库的钟算（`now()`），和防抄闸门同一个口径 */
|
||||
export const assigningSql = sql<boolean>`(${schema.problemset.assignedAt} is not null and ${schema.problemset.assignedUntil} > now())`
|
||||
|
||||
/**
|
||||
* 题单防抄闸门：查出这些题目里，哪些题的旧提交要对该用户藏起来，返回 problemId → 分界时刻
|
||||
* 专题防抄闸门：查出这些题目里，哪些题的旧提交要对该用户藏起来，返回 problemId → 分界时刻
|
||||
* （早于它的提交藏起来）。代码提交（routes/submission.ts）和流程图提交（routes/flowchart.ts）
|
||||
* 共用这一道闸。
|
||||
*
|
||||
* 规则（2026-10 题单重设计，用户拍板）：题单**布置期内**，题单里这几道题，学生在**布置开始之前**
|
||||
* 交的代码一律先藏起来 —— 不管他加没加入。老师常拿刚讲过的题攒复习题单：快照里 16% 的
|
||||
* 规则（2026-10 题单重设计，用户拍板）：专题**布置期内**，专题里这几道题，学生在**布置开始之前**
|
||||
* 交的代码一律先藏起来 —— 不管他加没加入。老师常拿刚讲过的题攒复习专题：快照里 16% 的
|
||||
* 「学生 × 题」加入前就做对过，不藏的话把自己以前的答案贴进去就完了。
|
||||
*
|
||||
* 以前是「加入之后藏加入之前的」，于是先去提交记录里把旧答案复制下来、再点加入，闸就白设了；
|
||||
@@ -306,11 +306,11 @@ export const assigningSql = sql<boolean>`(${schema.problemset.assignedAt} is not
|
||||
* 在这一两周里也看不到自己的旧代码，用户认了。
|
||||
*
|
||||
* 解锁的路全写在 where 里，任一成立就查不出来、也就不遮挡：
|
||||
* - 题单不在布置期（没布置，或者布置期过了）
|
||||
* - 题单没公开
|
||||
* - 已经在这份题单里做对了这道题（progress_detail 里有这道题的 key）
|
||||
* - 专题不在布置期（没布置，或者布置期过了）
|
||||
* - 专题没公开
|
||||
* - 已经在这个专题里做对了这道题（progress_detail 里有这道题的 key）
|
||||
*
|
||||
* 一道题可能同时落在几个正在布置的题单里，取最晚的布置开始 ——「任一题单要求遮挡就遮挡」。
|
||||
* 一道题可能同时落在几个正在布置的专题里，取最晚的布置开始 ——「任一专题要求遮挡就遮挡」。
|
||||
*/
|
||||
export async function problemSetLockCutoffs(userId: number, problemIds: number[]) {
|
||||
const cutoffs = new Map<number, string>()
|
||||
@@ -338,7 +338,7 @@ export async function problemSetLockCutoffs(userId: number, problemIds: number[]
|
||||
return cutoffs
|
||||
}
|
||||
|
||||
/** 这道题的旧代码为什么藏着：它落在哪些正在布置、我还没在里面做对的题单里 */
|
||||
/** 这道题的旧代码为什么藏着：它落在哪些正在布置、我还没在里面做对的专题里 */
|
||||
export async function problemSetLocksFor(userId: number, problemId: number) {
|
||||
return db
|
||||
.select({
|
||||
|
||||
Reference in new issue
Block a user