作业列表

页面元信息

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

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/tm_list.html。
• 页面为教师小程序底部导航的 作业中心 主列表页。顶部为双分段切换区，包含 纸质教辅作业、个性化作业 两个大页签；未选中项为白底灰字，选中项为浅灰底深色字。当前原型默认高亮 个性化作业。
• 分段切换下方为三枚筛选胶囊 全部学科、全部班级、全部状态，每枚胶囊右侧带下拉箭头。筛选生效后，胶囊文案直接替换为当前已选值，不额外显示第二行标签或筛选摘要。
• 主内容区为纵向作业卡片流。每张卡片由 学科方块、标题区、状态标签、信息盒、底部操作区 五部分组成。
• 标题区展示 作业标题、可选来源标签 教研院、以及 共X页，共Y题。状态标签仅允许三种视觉样式：灰色 待提交、橙色 待批改、绿色 已完成。
• 信息盒固定展示三行内容：发布班级、发布时间、提交情况。其中 提交情况 使用高亮色突出 已提交人数/应提交人数。
• 卡片底部操作区包含 查看分析 与 批改 两个横向等分文本按钮，中间使用竖线分隔。原型中整张卡片可点击，卡片内按钮点击时需阻断整卡点击。
• 页面底部在 TabBar 上方悬浮一组快捷操作：左侧 提交记录 为描边按钮，右侧 提交作业 为品牌主按钮，按钮内带相机图标。
• 最底部为四项 TabBar 首页、作业中心、学情分析、我的，其中 作业中心 为当前激活态。
• 页面需补齐四类占位态：首屏骨架屏、筛选无结果空态、权限空态、触底加载反馈态。

功能描述

• 页面入口：
  • 教师从小程序全局底部导航点击 作业中心 进入。
  • 从 tm_submit.html 在普通提交模式下完成上传后自动回流本页。
  • 从 tm_submit.html 在普通提交模式点击返回并确认退出后回流本页；若当前为 upload_result 模式，则返回 tm_history.html，不直接回流本页。
  • 从 tm_report.html 顶部返回、tm_grading_list.html 顶部返回、tm_history.html 左上关闭返回本页。
• 页面权限与数据范围：
  • 仅具备当前班级代提交/批改权限的教师可见；列表仅返回教师有权限处理的作业，不展示其他学校、其他班级作业。
  • 页面卡片只展示作业级汇总信息，不展示学生姓名、得分、手机号、原卷图片等学生敏感明细。
• 页面初始化与上下文恢复：
  • 首次进入优先读取 tm_list_context；若不存在历史上下文，则默认选中 个性化作业 页签，与现有原型默认态一致。
  • tm_list_context 至少保存 active_type、subject_id、class_id、status、page_no、scroll_top、source_page、updated_at。
  • 若进入 tm_list.html 前检测到本地仍存在 pendingUploadTask，则本页不得继续渲染作业列表，必须立即重定向至 tm_submit.html 的上传任务拦截态，由该页继续上传；教师不能先看到列表再决定是否恢复。
  • 从 tm_report.html、tm_grading_list.html、tm_history.html、tm_submit.html 回流本页时，必须恢复离开前的页签、筛选条件、已加载页数和滚动位置，不得每次回到默认首屏。
  • 列表默认按 发布时间 倒序排列，最新发布的作业排在最前；同一筛选条件下不提供手动排序入口。

顶部作业类型切换区

筛选区

作业卡片列表区

• 列表加载策略：
  • 首屏加载 10 张作业卡片，向下滚动触底后继续加载下一页 10 条。
  • 触发作业类型切换或任一筛选变化后，分页游标重置为第 1 页，已加载卡片清空并重新请求。
  • 加载过程中显示卡片骨架屏；触底加载失败时保留已加载数据，在列表底部展示 加载失败，点击重试。
• 卡片字段与交互说明：

• 卡片状态与按钮绑定规则：
  • 待提交：
    • 判定条件：当前不存在待最终确认的已提交答卷，且仍存在未提交学生。
    • 业务子态 1：submitted_student_count = 0。卡片展示 提交情况 = 0/应交人数；查看分析 与 批改 均为禁用态；整卡不可点击。
    • 业务子态 2：submitted_student_count > 0 且当前已提交部分均完成最终成绩确认。查看分析 可用；批改 可用但默认进入 已批改 页签，用于复查已批学生。
  • 待批改：
    • 判定条件：至少存在 1 份已提交但未完成最终成绩确认的答卷，不区分是否仍有未提交学生。
    • 查看分析 在 report_status in (partial_generated, generated) 时可用，否则显示禁用态。
    • 批改 始终可用，默认进入 待批改 页签。
  • 已完成：
    • 判定条件：全部应交学生已提交，且全部提交答卷均完成最终成绩确认。
    • 查看分析 与 批改 均可用；批改 进入 已批改 页签，用于复查或修正成绩。

底部悬浮快捷操作区

• 提交作业 跳转补充规则：
  • tm_submit.html 收到入口后，必须先执行 pendingUploadTask 恢复判断；若存在未完成上传任务，则直接进入上传任务拦截态，不以 tab 入参覆盖当前恢复结果。
  • 教师重新进入小程序时，只要当前账号下仍有未完成上传任务，无论其原本打算访问 tm_list.html、tm_history.html、tm_report.html 或 tm_grading_list.html，都必须先被拦截到 tm_submit.html 上传任务页，直至当前任务结束。
  • 仅在不存在未完成上传任务时，才按入口传入的 tab=paper|personal 打开对应页签；若入口未透传 tab，则再走 tm_submit.html 的默认页签初始化规则。

底部全局导航区

批量操作范围

• 本页不支持作业卡片多选，不提供批量批改、批量提交、批量删除、批量催交入口。
• 三个筛选胶囊仅影响“当前列表结果集的展示范围”，不修改任何作业、提交、批改数据。
• 提交记录 与 提交作业 属于页面级快捷入口，对整个教师账号当前权限范围生效，不绑定当前卡片，也不只作用于当前筛选结果。

弹层规格

弹层 1：学科选择底部弹层

弹层 2：班级选择底部弹层

弹层 3：状态选择底部弹层

• 业务规则：R18、R28、R29、R30、R31、R32、R33、R34。

异常描述

数据需求

• 接口需求：
  • GET /mini/homework/list：查询教师小程序作业列表。入参至少包含 homework_type、subject_id、class_id、status、page_no、page_size。
  • GET /mini/homework/filter-options：返回当前教师在当前作业类型下可用的学科、班级、状态选项及默认值。
  • GET /mini/homework/context（可选）：返回最近一次 tm_list_context，用于多端一致的默认页签恢复；若无服务端接口，则前端本地缓存承担相同职责。
• 列表字段需求：
  • 基础字段：homework_id、homework_type、source、display_title、subject_name、page_count、question_count、published_at、class_summary_text。
  • 统计字段：assigned_student_count、submitted_student_count、ungraded_submission_count、graded_student_count、status、report_status。
  • 按钮控制字段：can_view_report、can_grade、default_grade_tab。
  • 展示字段：source_tag_text、status_tag_style、highlight_submit_text。
• 页面状态缓存：
  • 本地缓存 tm_list_context：active_type、subject_id、class_id、status、page_no、scroll_top、source_page、updated_at。
  • 全局上传恢复对象 pendingUploadTask：至少包含 task_id、task_status、active_tab、selected_homework_id、selected_homework_title、total_count、success_count、failed_count、pending_count、snapshot_images、updated_at；进入本页前必须先读取该对象，决定是否触发强制拦截。
  • 下游页面透传字段：至少包含 source_page=tm_list、homework_id、homework_type；进入 tm_grading_list.html 时增加 tab=pending|graded。
• 埋点需求：