逐题批改

页面元信息

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

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/tm_grading.html。
• 页面为教师小程序沉浸式批改页，自上而下分为导航栏、卷面查看区、页级工具条、底部题目批改抽屉、底部固定操作区5个层级。卷面区为灰底查看层，批改抽屉自底部上滑覆盖；工具条固定贴在卷面底部上沿。
• 顶部导航栏左侧为返回图标，中间标题展示当前学生姓名，右侧为小程序胶囊占位。导航栏仅承担返回和学生身份识别，不展示作业来源、班级、学科等辅助信息。
• 卷面查看区默认展示当前学生当前作业的当前页原卷。卷面上叠加左右翻页箭头、题目热区和当前命中的题目高亮态；空白区域不承载其他业务入口。
• 页级工具条包含 提交记录、放大、缩小、第N页4类元素。其中 提交记录 位于左侧，缩放按钮位于中间，页码文本位于右侧。
• 底部题目批改抽屉默认收起；点击卷面题目热区后上滑展开。抽屉头部左侧固定标题题目批改，右侧为文字按钮保存并查看分析。抽屉内容区依次展示题目摘要、题目卡片、AI恢复入口、评对错/打分切换、标准答案。
• 底部固定操作区包含左侧次按钮一键全对和右侧主按钮。主按钮文案按当前上下文动态切换为保存并下一页、保存并下一份或保存并退出。
• 卷面标题区不展示来源标签教研院，也不展示“教研院”文本；即使后端返回该字段，前端也不得渲染。参见 R56。

功能描述

页面入口

• 教师在 tm_grading_list.html 点击某一学生行进入本页，必须透传 homework_id、homework_type、class_id、student_id、student_name、status=pending|graded、source_page=tm_grading_list。
• 页面首次加载默认打开当前学生的第1页；若服务端返回 default_page_no 或 last_ungraded_page_no，则以前者为准。
• 若教师从 tm_grading_history.html 返回本页，需恢复离开前的 current_page_no、当前学生、当前页签和已打开的提交记录上下文。

页面分区与控件交互

• 本页按导航栏、卷面查看区、页级工具条、题目批改抽屉、底部固定操作区5个交互分区展开说明。

导航栏

卷面查看区

页级工具条

• 缩放与手势规则：
  • 双指缩放：教师可在卷面区域使用双指捏合进行放大、缩小；缩放范围固定为 50%-200%，与按钮缩放边界一致。参见 R55。
  • 单指长按拖移：教师单指在卷面上长按 300ms 后进入拖移模式，仅允许上下滑动拖移当前页内容；释放手指即退出拖移模式。普通单击不进入拖移模式，避免与题目热区点击冲突。参见 R55。
  • 手势优先级：长按拖移期间不触发题目热区点击；双指缩放期间不触发左右翻页；手势结束后恢复普通点击能力。

题目批改抽屉

• 题目改判与本地保存策略：
  • 教师在抽屉中进行的对错判定、分数调整、恢复 AI 操作，先写入本地页面状态，不立即提交服务端。
  • 切换题目、收起抽屉、切换页码时，本地未保存改动继续保留在当前学生会话中；只有点击 保存并下一页、保存并下一份、保存并退出 或 保存并查看分析 时才提交服务端。

底部固定操作区

文案和按钮状态变化

• 第N页 文案随页码即时变化；切页后 提交记录 的查询范围同步切换为新页。
• 主按钮文案根据入口页签、当前页码和是否存在下一位待批改学生动态变化：pending + 非最后一页 = 保存并下一页，pending + 最后一页 + 有下一位 = 保存并下一份，其余场景为 保存并退出；从 graded 页签进入时，主按钮始终展示 保存并退出。参见 R57。
• 一键全对 始终可见，但在当前学生当前作业无可批改题目时点击仅 Toast 提示 当前作业暂无可批改题目，不弹确认框。
• 当抽屉摘要处于收起态时，按钮文案为 展开；处于展开态时文案为 收起。

页面跳转和返回逻辑

• 点击导航返回：返回 tm_grading_list.html，恢复离开前页签、分页和滚动位置。
• 点击 提交记录：进入 tm_grading_history.html，默认打开当前页最新一条提交记录；从该页返回后，本页继续停留在原学生、原页码。
• 点击 保存并下一页：保存成功后停留在当前学生下，将 current_page_no 自动切换到下一页，并刷新该页卷面、题目热区和提交记录范围。
• 点击 保存并下一份：仅在当前学生最后一页展示；保存成功后进入同一作业、同一页签下的下一位待批改学生，并默认打开其第1页或服务端返回的 default_page_no；若服务端返回不存在下一位，则降级为 保存并退出 返回列表。
• 点击 保存并退出：保存成功后返回 tm_grading_list.html，并刷新当前学生所在列表状态。
• 点击 保存并查看分析：保存成功后进入 tm_report.html；从报告页返回时恢复到本页当前学生和当前页码。

批量操作范围

• 本页不支持多学生选择，不提供批量保存、批量导出、批量备注、批量退回。
• 一键全对 的作用范围仅为“当前学生 + 当前作业”的全部可批改题目，不跨学生、不跨班级、不跨作业。
• 题目抽屉中的 AI 恢复、对错改判、打分调整均只作用于当前选中的批改项，不自动联动其他题目。

弹窗规格

弹窗 1：一键全对确认弹窗

弹窗 2：未保存离开确认弹窗

• 业务规则：R18、R29、R34、R52、R54、R55、R56、R57。

异常描述

数据需求

• 接口：
  • 批改详情接口：返回学生信息、页数、默认页码、当前页原卷、题目热区、题目批改项、AI原始结果。
  • 提交记录范围接口：按 student_id + homework_id + current_page_no 返回当前页提交记录列表及默认记录。
  • 保存批改接口：提交教师改判结果、操作来源、当前页码、是否一键全对。
  • 下一位学生接口：按 homework_id + class_id + status=pending 返回下一位待批改学生。
• 关键字段：
  • 页面上下文：homework_id、homework_type、class_id、student_id、student_name、current_page_no、page_count、current_submission_id、status。
  • 题目维度：question_id、question_type、max_score、hotzone、ai_judge、teacher_judge、teacher_score、answer_text。
  • 交互状态：zoom_ratio、drag_offset_y、active_question_id、has_unsaved_change、primary_action_type=next_page|next_student|exit。
  • 来源标签：如接口返回 source_label=教研院，前端仅可用于日志透传或调试，不参与任何页面渲染。参见 R56。
• 页面状态缓存：
  • tm_grading_context 至少保存 homework_id、student_id、status、current_page_no、page_count、current_submission_id、zoom_ratio、active_question_id、has_unsaved_change、primary_action_type，用于 tm_grading_history.html 往返恢复。
• 埋点：
  • 页面浏览：记录 source_page、homework_id、student_id、status、默认页码。
  • 卷面操作：记录翻页、热区点击、缩放按钮点击、双指缩放、长按拖移、抽屉展开/收起。
  • 题目操作：记录 AI 恢复、判定切换、分数加减、直接输入分数、摘要展开/收起。
  • 页面出口：记录点击 提交记录、一键全对确认/取消、保存并下一页、保存并下一份、保存并退出、保存并查看分析。