作业报告

页面元信息

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

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/t_report.html。
• 页面采用教师 Web 标准双栏导航布局，左侧为全局导航，右侧为主内容区；顶部栏包含 ← 返回、页面标题 作业报告 — {作业标题} 与右上角 刷新报告 文本按钮。
• 主内容区顶部优先展示 班级切换胶囊组，当作业仅发布到 1 个班级时隐藏该区域；当发布到多个班级时，默认高亮当前上下文班级，支持横向切换。
• 班级切换下方为统一子页签区，包含 作业分析、题目分析、学生学情 三个页签；页签切换采用页内切流，不发生整页跳转或白屏刷新。
• 作业分析 页签由 基本信息卡、核心指标六宫格、知识点分析表、知识点雷达图 组成；核心指标区依次展示提交情况、批改情况、最高分、最低分、题目错误率 Top5、学生作业评价分布。
• 题目分析 页签采用左主右辅双栏结构：左侧为题目诊断卡片流，右侧为筛选面板；每张题目卡包含题型标签、错误率、错误次数、作答次数、错题人数、难度、题干正文，以及 加入作业篮、解析 两个主动作按钮。
• 学生学情 页签采用左侧数据表、右侧筛选面板布局；左侧表格包含 ID、学生姓名、学号、正确率、评价、批改时间、操作列，表头提供 复制名单 快捷入口，并在评价列标题区域展示现有 一键全A 快捷操作。
• 页面右下角常驻 作业篮悬浮胶囊，展示已选题量；点击后从右侧滑出 作业篮抽屉。抽屉内包含题量/总分汇总、一键清空、进入选题中心、进入排版 以及分题型折叠的题目列表。
• 页面内包含 未提交名单弹窗；弹窗展示当前班级未提交学生清单、页码状态格、全选与复制能力。页面整体还需支持骨架屏、局部 Loading、空状态和失败态占位。

功能描述

• 页面入口：
  • 从首页或 t_homework_list.html 点击 作业报告/查看报告 进入。
  • 从 t_grading.html 点击 保存并查看分析 进入。
  • 从批改完成弹窗点击 查看作业报告 进入。
• 页面权限与数据范围：
  • 仅任课教师、班主任或具备当前作业所属班级数据权限的教师可进入；越权访问时不展示任何学生明细与分数数据。
  • 页面中所有统计、学生名单、题目错误率、评价结果均严格限定在“当前作业 + 当前班级”范围内，不跨班聚合展示。
• 页面初始化与数据加载：
  • 进入页面后必须校验 作业ID 是否有效；无效或缺失时直接返回 t_homework_list.html 并提示“未找到对应作业”。
  • 首次进入默认加载 作业分析 页签数据；题目分析、学生学情 采用首次进入页签时懒加载，避免一次性并发请求过多。
  • 若来源为 t_grading.html 或批改完成弹窗，则优先带入该批改链路中的 班级ID；若来源为列表/首页，则默认选中教师最近一次查看的班级，若无历史则选中作业发布班级列表的第一个班级。
  • 若来源为 t_error_analysis.html 或 t_student_evaluation.html 的“返回报告”，必须优先恢复 report_context，包括班级、页签、筛选条件和当前学生定位。
• 页面级全局控件：

• 数据保留与回退策略：
  • 页面需持久化 report_context，至少包含 homework_id、selected_class_id、active_tab、question_filters、question_sort、student_filters、current_student_id、source_page。
  • 切换班级、切换页签、打开/关闭未提交名单弹窗、打开/关闭作业篮抽屉时，不得丢失当前会话内已录入的筛选条件。
  • 从报告页下钻到 t_error_analysis.html 或 t_student_evaluation.html 后返回时，需恢复到离开前的班级、页签、筛选条件与滚动位置。

作业分析页签

• 作业分析 为默认页签，用于呈现当前班级下该次作业的整体完成与学情概览。
• 页面区域与字段说明：

• 信息说明图标（?）统一交互：
  • 鼠标悬浮显示 Tooltip，内容包含统计口径、分母范围与排除逻辑。
  • Tooltip 文案由后端返回或配置中心统一维护，避免前后端口径不一致。
• 批改修正 交互：
  • 点击后进入 t_grading.html，并透传 homework_id、selected_class_id、source_page=t_report。
  • 若当前班级存在未完成最终批改的学生，则优先定位到首个待处理学生；若已全部批改，则进入已批阅查看/修正状态。
• 查看未提交名单 交互：
  • 打开弹窗后默认展示当前班级的未提交或欠交学生，不跨班显示。
  • 关闭弹窗后仍停留在当前页签，不触发整页刷新。

题目分析页签

• 题目分析 用于帮助教师定位共性错误题，并从报告页直接回流到再出题链路。
• 区域与交互说明：

• 列表加载策略：
  • 首屏加载 20 道题目卡片；滚动到底部自动加载下一批 20 道，直到当前作业题目全部加载完成。
  • 筛选或排序变化后，结果列表回到顶部并重新从第 1 批开始加载。
  • 题目解析区按卡片维度延迟加载，避免列表首屏请求体过大。
• 加入作业篮 交互细则：
  • 加入成功后，右下角作业篮悬浮胶囊题量立即 +1，抽屉头部题量与总分同步刷新。
  • 取消加入后，如当前题目为作业篮中最后一题，对应分组从抽屉中移除；若抽屉整体为空，切换回空状态。
  • 当前页已加入题目在切换班级、切换页签后返回时，按钮需保持已加入态。
• 作业篮回流链路：
  • 报告页与资源中心共用同一个全局作业篮容器。
  • 教师可在报告页完成选题积累，再通过抽屉中的 进入选题中心 返回 t_resource_center.html 继续选题，或直接点击 进入排版 进入 t_composition.html。

学生学情页签

• 学生学情 用于查看当前班级下已提交学生的个人表现、评价结果和后续下钻入口。
• 区域与交互说明：

• 列表加载策略：
  • 首屏加载 20 名学生记录；向下滚动时追加加载后续 20 条。
  • 当前页签切换或班级切换后需保留评价筛选条件，但学生列表需回到顶部重新加载。
  • 若当前筛选结果为 0，展示空状态 暂无符合条件的学生，而非空白表格。
• 复制名单 交互：
  • 默认复制当前筛选结果内的全部学生，而不是仅复制当前屏幕可见行。
  • 复制成功 Toast：已复制{N}名学生名单；复制失败时回退为弹窗展示纯文本，便于手动复制。
• 一键全A 交互：
  • 仅作用于“当前班级 + 当前评价筛选结果 + 已批改完成学生”集合，不跨班、不跨作业、不处理未批改记录。
  • 执行成功后需同步刷新当前表格中的评价字段，以及 作业分析 页签中的评价分布卡片。
  • 若当前结果集为空、当前结果集均未批改或当前结果集全部已为 A，则按钮置灰，不允许触发。
• 下钻链路：
  • 点击 错题分析 进入 t_error_analysis.html，透传 homework_id、class_id、student_id、source_page=t_report、source_tab=student_condition。
  • 点击 作业评价 进入 t_student_evaluation.html，透传同样的上下文参数；返回时恢复当前页签和所选学生所在列表位置。

作业篮抽屉规格

弹窗规格

弹窗 1：未提交名单弹窗

补充规则：

• 全选 仅作用于当前弹窗结果集；单项勾选变化需反向同步全选状态。
• 若未勾选任何学生即点击 复制名单，提示 请先勾选需要复制的学生。
• 支持点击遮罩关闭、点击右上角 × 关闭、按 ESC 关闭。

弹窗 2：作业篮清空确认弹窗

弹窗 3：一键全A确认弹窗

• 业务规则：R09、R18、R22、R23、R24、R25、R26、R27。

异常描述

数据需求

• 接口：
  • GET /homework/report/summary：获取作业基本信息、提交情况、批改情况、最高分、最低分、评价分布。
  • GET /homework/report/knowledge：获取知识点分析表与雷达图数据。
  • GET /homework/report/questions：按班级、题型、知识点、排序字段获取题目分析列表。
  • GET /homework/report/students：按班级、评价筛选获取学生学情列表。
  • GET /homework/report/unsubmitted：获取当前班级未提交/欠交学生列表及页码状态。
  • POST /homework/report/refresh：触发当前作业报告重新计算或刷新缓存。
  • POST /question-basket/add、POST /question-basket/remove、POST /question-basket/clear：作业篮增删清空。
  • POST /homework/report/batch-evaluation：执行 一键全A 批量评价更新。
• 状态与缓存：
  • 需缓存 report_context，至少包含 homework_id、selected_class_id、active_tab、question_filters、question_sort、student_filters、current_student_id、source_page。
  • 需缓存 report_module_status，区分 idle、loading、success、empty、error、calculating，用于模块级渲染。
  • 作业篮需复用教师 Web 全局 question_basket_context，至少包含 basket_id、question_count、total_score、question_ids、source_page。
  • 从报告页下钻到 t_error_analysis.html 或 t_student_evaluation.html 时，需透传完整 report_context，用于子页面返回恢复。
• 统计口径：
  • 提交率 = 已提交人数 / 应提交人数。
  • 批改进度 = 已完成最终批改人数 / 已提交人数。
  • 题目错误率 = 当前题目错误人数 / 当前题目有效作答人数。
  • 学生评价分布 = 当前班级已生成评价的学生人数占比。
  • 知识点正确率与掌握情况由后端按统一规则引擎返回，前端不自行计算。
• 埋点：