批改

页面元信息

• 终端：教师 Web
• Astro 路由：/teacher/grading
• 原始 HTML：t_grading.html
• 来源章节：4.2.6
• 维护规则：后续以本页面 PRD 为准；若改动影响通用规则，再同步总览 / 全局规则文档。

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/t_grading.html。
• 页面采用三栏布局：左侧为学生原卷区，中间为批改操作区，右侧为班级与学生列表区；顶部展示返回、作业标题和“已阅/总人数”进度信息。
• 左侧学生原卷区展示当前学生作业原卷、页码切换器和题目定位标记；卷面区顶部当前存在辅助工具位，但“标注”“放大”“搜索”能力本节暂不展开说明，待对应专项 PRD 补充后再单独定义。
• 中间批改操作区按“题组 -> 大题卡片 -> 小题批改项”组织，卡片内可展示题干、学生修正、参考答案和小题级批改控件。
• 右侧区域展示班级切换、待确认/已确认页签、学生名单以及页级一键全对入口。
• 底部操作区包含保存批改、动态主按钮保存并进入下一份/保存并查看分析和重置。

功能描述

• 页面入口：
  • 主入口为 t_homework_list.html 的 批改作业/去批改。
  • 辅助入口为 t_report.html 作业分析中的 批改修正，用于教师在查看报告后回到批改链路继续修正成绩。
• 页面进入逻辑：
  • 进入页面时需带入当前 作业ID，并根据入口上下文带入 班级ID、学生ID、来源页面 等信息。
  • 若存在断点续批记录，优先恢复到教师上一次离开的学生与题目位置。
  • 若不存在断点续批记录，则默认加载当前班级下首个待批改或待确认学生；若当前作业已全部批改完成，则进入已批阅查看/修正状态。
• 左侧学生原卷区：
  • 展示当前选中学生、当前作业对应的原卷内容，默认打开该学生最近一次需要教师确认的提交记录。
  • 卷面底部展示页码切换器；教师切换上一页/下一页时，仅切换当前学生原卷页，不改变右侧学生选中状态。
  • 卷面中的作答框与中间批改项建立题目映射关系；教师点击卷面中的题目作答区域时，中间批改操作区自动滚动并定位到对应小题。
  • 当教师在中间批改区完成改判或改分后，左侧卷面上的题目标记需同步刷新，保证卷面结果与批改面板一致。
  • 教师切换班级、页签或学生后，左侧原卷区需整体刷新为新学生数据；默认回到该学生原卷第一页。
• 右侧班级与学生列表区：
  • 顶部班级下拉框用于切换当前批改班级；切换后刷新当前班级下的学生名单、批改进度和左/中两栏内容。
  • 学生名单按页签分为待确认和已确认；默认优先进入待确认页签。
  • 每个学生项展示学生姓名和学号/序号；当前选中学生高亮显示。
  • 教师点击其他学生时，需先校验当前学生是否存在未保存修改；若存在，弹出离开确认，确认后放弃未保存修改并切换学生，取消则停留当前学生。
  • 右侧一键全对为页级操作，仅作用于当前选中学生的当前作业，不跨学生、不跨班级。
• 中间批改操作区整体结构：
  • 按题组展示大题内容，每个题组下可包含题组标题、大题标题、题干/材料、学生修正信息、参考答案和小题批改项。
  • 大题标题、题干/材料等长文本支持展开/收起，避免大段内容挤占批改视口。
  • 对于包含多个小题的大题卡片，在卡片头部展示本题全对按钮；仅有一个小题的大题不展示该按钮。
  • 小题区域不展示“判定”“本题”等冗余字眼，界面仅保留题号、分值、结果状态和批改控件。
• 小题级批改操作：
  • 每个小题默认带出 AI批改结果，作为教师初始参考结果。
  • 每个小题展示AI批改按钮；当教师尚未手动修改时，该按钮呈 AI态；教师一旦修改判定或分数，该小题切换为教师批改态，再次点击AI批改可恢复该小题的 AI结果。
  • 每个小题提供评对错与去打分两种批改模式切换，教师可按题型选择使用。
  • 评对错模式下，教师可在对/错/半对三种结果间切换；选择结果后系统自动换算为对应得分，并同步更新卷面标记。
  • 去打分模式下，教师可通过加减按钮或直接输入分数完成打分；分数取值范围为0 ~ 该小题满分，超出范围时自动校正为合法值。
  • 当教师输入具体分数后，系统需自动反推该小题的批改结果状态：满分为“对”、0分为“错”、中间分值为“半对”。
  • 教师针对同一小题的任何修改，均只作用于当前小题，不影响同题组内其他小题。
• 批量操作：
  • 本题全对：将当前大题下全部小题批改结果设为“教师判对”，并将每个小题得分写满分；点击后左侧卷面对应题目标记同步更新。
  • 一键采纳AI：恢复当前页面所有小题为 AI批改结果，清空本次页面内未保存的教师手动改判/改分。
  • 页级一键全对：将当前选中学生当前作业内全部可批改题目设为“教师判对”，并写入满分；该操作不跨学生、不跨班级。
• 页面返回逻辑：
  • 左上角 返回 统一返回 t_homework_list.html，不直接回到作业报告页。
  • 若当前存在未保存的批改修改，点击返回时需弹出确认提示；教师确认离开后放弃本次未保存修改。
• 保存批改：
  • 点击后保存当前学生的批改结果，但不切换学生、不跳转页面。
  • 保存成功后停留当前学生批改页，刷新右侧学生状态、顶部已阅进度和左侧卷面标记。
  • 若当前学生从待确认变为已确认，需同步将其从待确认列表移出，并按当前页签规则决定是否继续留在当前学生或回到新的当前选中项。
• 动态主按钮：
  • 当当前学生之后仍存在下一名待确认学生时，主按钮文案显示为保存并进入下一份。
  • 当当前学生已是当前班级待确认列表中的最后一名待处理学生时，主按钮文案显示为保存并查看分析，不再使用保存并完成批改。
  • 教师切换班级、页签或学生后，系统需立即重新计算主按钮文案。
• 保存并进入下一份：
  • 点击后先保存当前学生批改结果。
  • 保存成功后，自动定位到当前待确认列表中的下一名学生，并刷新左侧原卷区、中间批改区和右侧选中态。
  • 若保存失败，则停留当前学生，不切换下一份。
• 保存并查看分析：
  • 仅在当前学生为当前待确认列表最后一名待处理学生时显示。
  • 点击后先保存当前学生批改结果。
  • 保存成功后跳转 t_report.html，并带入当前 作业ID 与 班级ID，默认进入当前作业的分析页面。
  • 保存失败时阻断跳转，页面停留在当前批改页并提示教师重试。
• 重置：
  • 作用范围仅为当前选中学生当前页面内尚未保存的教师手动修改，不影响其他学生和已保存数据。
  • 点击后将当前学生本次未保存的手动改判、手动打分恢复到最近一次已保存结果；若该学生尚无教师保存结果，则恢复为当前 AI批改初始结果。
  • 重置完成后，中间批改区和左侧卷面题目标记需同步回滚。

异常描述

• 学生原卷加载失败、AI结果缺失时，需提示教师刷新重试或切换下一名学生，不允许展示空白批改区。
• 批改保存失败时，不更新批改进度，不跳转下一名学生，也不允许进入作业报告页。
• 并发批改冲突时，提示“当前作业已被其他终端更新，请刷新后重试”，并要求教师重新确认最新数据。
• 存在未保存修改时离开页面，需弹出确认提示，防止教师误操作丢失批改结果。
• 一键全对为高风险操作，点击后需二次确认；取消确认时保持当前批改状态不变。
• 教师切换班级、页签或学生时，若当前存在未保存修改，需先弹出确认提示；取消切换时保持当前批改上下文不变。
• 重置执行失败时，需保留当前未保存批改状态并提示教师重试，不允许出现局部题目回滚、局部题目未回滚的混乱状态。

数据需求

• 接口：
  • 获取学生提交原卷、题目批改项、班级学生列表、批改进度。
  • 保存批改结果。
  • 获取/恢复断点续批位置。
• 状态与缓存：
  • 需缓存 grading_context，至少包含 homework_id、selected_class_id、current_student_id、current_question_id、source_page。
  • 需记录断点续批位置，用于教师重新进入页面时恢复到上次批改进度。
  • 从 保存并查看分析 跳转作业报告时，需透传当前 作业ID 与 班级ID。
• 埋点：
  • 页面浏览：记录入口来源（作业列表/作业报告）。
  • 批改过程：班级切换、页签切换、学生切换、卷面题目点击定位、题目模式切换、题目改判、分数修改、恢复AI、本题全对、一键采纳AI、一键全对、重置、保存批改。
  • 页面流转：保存并进入下一份、保存并查看分析、批改完成弹窗-查看作业报告、批改完成弹窗-返回作业列表。