自学模块以前一个字节都不落库:读到第几课只存在浏览器的 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
This commit is contained in:
@@ -78,6 +78,45 @@ export const tutorialSchema = tutorialSummarySchema.extend({
|
||||
updatedAt: z.string(),
|
||||
})
|
||||
|
||||
/**
|
||||
* 自学留痕的上报。前端每进一课发一次 `opened: true`(`seconds` 为 0),
|
||||
* 之后按心跳补时长发 `opened: false`。
|
||||
*
|
||||
* `seconds` 卡在 1 小时以内:一次上报最多也就攒几分钟,超出这个量级只可能是
|
||||
* 客户端算错或有人手造请求,直接拒掉比默默入库好——停留时长是要给老师看的。
|
||||
*/
|
||||
export const tutorialProgressPingSchema = z.object({
|
||||
seconds: z.number().int().min(0).max(3600),
|
||||
opened: z.boolean(),
|
||||
})
|
||||
|
||||
/**
|
||||
* 学习页目录要的整套进度:**每篇公开教程都有一行**,没读过的就是一行零。
|
||||
* 让前端 `progress[id]` 永远取得到,省得目录里每处都判一次 undefined。
|
||||
*/
|
||||
export const tutorialProgressSchema = z.object({
|
||||
tutorialId: z.number().int(),
|
||||
viewCount: z.number().int(),
|
||||
totalSeconds: z.number().int(),
|
||||
// 没读过时是 null,不是假的零时间
|
||||
firstViewedAt: z.string().nullable(),
|
||||
lastViewedAt: z.string().nullable(),
|
||||
exerciseTotal: z.number().int(),
|
||||
exerciseSolved: z.number().int(),
|
||||
})
|
||||
|
||||
/**
|
||||
* 一次练一练的作答。
|
||||
*
|
||||
* `answer` 是前端拼好的一句人话(「选了 A、C」),只在做错时留下来给老师看;
|
||||
* 做对了没什么好看的。长度卡在 200 字符:它是给人扫一眼的摘要,不是完整作答,
|
||||
* 填空题写一整段进来只会把后台表格撑爆。
|
||||
*/
|
||||
export const exerciseAttemptRequestSchema = z.object({
|
||||
correct: z.boolean(),
|
||||
answer: z.string().max(200).optional(),
|
||||
})
|
||||
|
||||
export const exerciseSchema = z.object({
|
||||
id: z.number().int(),
|
||||
type: z.enum(["mcq", "sort", "fill", "match", "predict", "debug", "group"]),
|
||||
@@ -99,3 +138,6 @@ export type ReactionState = z.infer<typeof reactionStateSchema>
|
||||
export type SetReactionRequest = z.infer<typeof setReactionRequestSchema>
|
||||
export type Tutorial = z.infer<typeof tutorialSchema>
|
||||
export type Exercise = z.infer<typeof exerciseSchema>
|
||||
export type TutorialProgress = z.infer<typeof tutorialProgressSchema>
|
||||
export type TutorialProgressPing = z.infer<typeof tutorialProgressPingSchema>
|
||||
export type ExerciseAttemptRequest = z.infer<typeof exerciseAttemptRequestSchema>
|
||||
|
||||
Reference in New Issue
Block a user