教师 Web / 资源中心
周策 老师
Prototype

教师 Web · 资源中心

校验资源中心选题与作业篮能力是否与页面级 PRD 一致。

设计视口: 1440 x 900 · 当前缩放: 100% · 左右分栏: 拖动中线调整
Page PRD

资源中心

当前文档: prds/作业管理模块/teacher-web/t_resource_center.md

当前对照重点: 资源中心
Review Hint

左侧现在支持三种演示模式: 默认按设计稿完整缩放、按宽度铺满、以及 100% 原始尺寸滚动查看。 右侧默认读取当前页面对应的页面级 PRD,而不是整本总 PRD;改页面时,直接同步维护这个页面文档即可。

资源中心

页面元信息

  • 终端:教师 Web
  • Astro 路由:/teacher/resource-center
  • 原始 HTML:t_resource_center.html
  • 来源章节:4.2.3
  • 维护规则:后续以本页面 PRD 为准;若改动影响通用规则,再同步总览 / 全局规则文档。

视觉描述

  • 原型引用:产出文档/作业管理模块/原型图/t_resource_center.html
  • 页面采用“顶部全局控制 + 中部模式切换 + 左侧资源导航/右侧内容区 + 右下角作业篮入口”的工作台式布局。顶部包含返回、页面标题、学科下拉、资源来源切换(平台资源/区域资源/校本资源)和教师信息。
  • 页面中部提供 题库 / 卷库 二级模式切换:
    • 题库模式下,左侧展示资源导航,右侧展示题目列表或试卷题目明细。
    • 卷库模式下,左侧树面板收起,右侧展示整卷筛选区、试卷卡片列表和分页器。
  • 题库模式左侧再拆分为 教辅章节知识点试卷选题 三个页签:
    • 教辅章节展示当前绑定教辅封面卡、切换教辅入口和章节树。
    • 知识点展示学段筛选和知识点树。
    • 试卷选题展示试卷筛选面板与试卷列表,右侧默认展示空态“请从左侧选择一份试卷查看题目”。
  • 右侧题目卡片统一展示题型标签、资源编号、题干、知识点/难度标签,以及 查看解析加入作业篮 按钮;解析以内联展开区形式展示答案、解析、知识点和教材章节。
  • 页面右下角固定悬浮 已选 X 题 作业篮按钮;点击后从右侧拉起半屏抽屉。抽屉头部展示已选题数、总分、一键清空完成选题,内容区按题型分组展示题目,支持分组折叠、单题删除和拖拽手柄。
  • 页面包含三个弹层:
    • 选择使用的教辅 弹窗:顶部为搜索和多条件筛选,下方为三列教辅卡片列表。
    • 试卷详情 弹窗:中间为 A4 试卷预览,顶部支持缩放和翻页,底部提供 去发布关闭
    • 学科切换确认 弹窗:当作业篮非空时切换学科触发,提示切换后将清空当前作业篮。

功能描述

  • 页面入口:
    • 教师从 t_home.html新建作业 入口进入。
    • 教师从 t_homework_list.html 的出题入口进入。
    • 教师从 t_report.html 的题目回流入口进入时,必须保留当前作业篮和上次选题上下文,避免教师重新筛选资源。
  • 全局控制:
    • 学科 为全局上下文,切换后同步影响题库列表、知识点树、卷库筛选和教辅选择弹窗。
    • 平台资源/区域资源/校本资源 切换只刷新资源范围,不改变当前学科与当前模式;作业篮保留已选题目,且允许跨来源混选,但每道题需记录来源类型和来源组织,便于后续追溯。
    • 当作业篮非空时切换学科,必须弹出确认框;点击 取消 保留原学科与原作业篮,点击 确定切换 后清空当前作业篮并刷新资源结果。
  • 题库 模式:
    • 教辅章节 页签下,教师先确认当前教辅对象,再按“教辅 > 章节 > 课时/分区”逐级浏览题目;点击教辅封面卡或 选择教辅 打开教辅弹窗。
    • 知识点 页签下,教师先选择学段,再按知识点树逐级展开;点击某一知识点节点后刷新右侧题目列表。
    • 试卷选题 页签下,左侧提供 全库检索教辅配卷 两种路径:
      • 全库检索:按学段、年级、册次、试卷名称筛选试卷,左侧滚动列表展示名称、题量、更新时间。
      • 教辅配卷:先绑定教辅,再按“单元卷/期末卷”等关键字搜索匹配试卷。
      • 点击左侧试卷后,右侧展示该试卷的题目明细和 一键添加 按钮;未选择试卷时展示空态。
    • 教辅章节知识点 两类题目列表统一支持按学段、年级、教材版本、出版社、教材名称筛选;筛选或搜索后默认回到第 1 页。
    • 单题操作规则:
      • 查看解析:点击后展开题目解析区,再次点击收起。
      • 加入作业篮:仅在题目未加入时显示;点击后按钮切换为 已加入
      • 已加入:鼠标悬停显示 取消加入,点击后从作业篮移除并恢复为 加入作业篮
      • 单题加入按 question_id 去重;已在作业篮中的题目不重复新增,仅更新按钮状态并 Toast 提示“题目已在作业篮中”。
  • 卷库 模式:
    • 右侧先展示检索范围切换:全库检索 / 指定教辅配卷
    • 全库检索 支持地区、学段、年级、册次、适配教材版本、试卷名称筛选:
      • 地区筛选采用省/市/区县三级级联勾选,支持“全选本省地市”“全选本市区县”。
      • 试卷卡片展示试卷名称、学科标签、题量、更新时间。
    • 指定教辅配卷 需先绑定教辅,再按关键字搜索配套试卷;未绑定教辅时仅展示绑定引导,不返回结果列表。
    • 试卷卡片操作规则:
      • 查看试卷:打开试卷详情弹窗。
      • 发布作业:以当前整卷为发布对象直接进入 t_publish.html,跳过 t_composition.html
      • 一键添加:将当前整卷全部题目加入作业篮,新增题目遵循 question_id 去重;若存在重复题,Toast 展示“新增 X 题,跳过 Y 题”。
  • 试卷详情弹窗:
    • 默认以 100% 比例展示 A4 试卷预览,支持 +10%-10%适应上一页下一页 操作。
    • 缩放比例范围限定为 50%-150%;到达边界时对应按钮保留可见但点击无效。
    • 去发布 跳转至 t_publish.html关闭 仅关闭弹窗,不清空当前筛选和作业篮。
  • 作业篮:
    • 悬浮按钮始终显示当前已选题数。
    • 抽屉内按题型分组展示题目,默认展开;教师可折叠分组、删除单题、拖拽调整顺序。
    • 拖拽后的题目顺序直接带入 t_composition.html 作为默认组卷顺序。
    • 一键清空 需二次确认,确认后清空全部题目并重置统计。
    • 完成选题 仅在作业篮题目数大于 0 时可点击,点击后进入 t_composition.html;若题目数为 0,按钮禁用并提示“请先加入题目”。
  • 教辅选择弹窗:
    • 支持按教辅书名、学段、年级、册次、出版社、适配教材版本筛选。
    • 教辅卡片展示封面、书名、学科标签、出版社、适配教材和册次信息。
    • 点击某本教辅后,更新左侧当前教辅封面卡以及“尚未绑定教辅/尚未绑定教辅对象”标签,并关闭弹窗。
  • 列表与加载策略:
    • 教辅章节/知识点 题目列表采用页码分页,默认每页 10 题,支持上一页、下一页和页码跳转;首次加载展示骨架屏,翻页展示局部 Loading。
    • 试卷选题 左侧试卷列表支持分批加载,默认每批 20 份试卷,滚动到底部自动续载,顶部固定展示总量与“收起筛选/展开筛选”入口;该能力为本次补充规格,当前原型未显式展示续载反馈,需要在后续交互稿中补充 Loading 和“已加载完成”提示。
    • 卷库 试卷卡片列表采用页码分页,默认每页 10 份试卷,支持直接跳页;切换检索条件后回到第 1 页。

异常描述

异常场景处理方式
页面首次加载失败右侧展示整页错误态,提供 重试 按钮;若本地已有作业篮缓存,需先恢复作业篮再请求资源数据。
题目/试卷筛选无结果展示空态文案“暂无匹配资源”,保留当前筛选条件,并提供 清空筛选 快捷入口。
题目解析缺失展开解析区时展示“暂无解析”,但不影响加入作业篮。
未绑定教辅即进入教辅配卷显示“请先绑定教辅对象”引导态,隐藏结果列表,仅保留 选择教辅/点击绑定 操作。
试卷预览加载失败试卷详情弹窗展示错误态和 重新加载去发布 按钮置灰不可点,教师可关闭弹窗返回列表。
学科切换误操作点击确认弹窗 取消 后,必须恢复为原学科,且作业篮、筛选条件、当前列表状态均不变化。
作业篮清空/删除失败若前端已删除但服务端保存失败,需回滚本次操作并 Toast 提示“作业篮同步失败,请重试”。
分页或翻页越界上一页/下一页在边界态置灰;手动输入页码超出范围时不跳转,并提示“页码超出范围”。
长列表加载超时首屏超过 3 秒未返回时显示骨架屏;超过 10 秒转为错误提示并支持重试。

数据需求

  • 接口:
    • 资源上下文:可访问资源来源列表、当前教师可见组织范围、学科/学段/年级/册次/教材版本字典。
    • 题库资源:教辅树、知识点树、题目列表、题目解析详情。
    • 卷库资源:试卷列表、试卷题目明细、试卷 A4 预览数据、地区筛选树。
    • 教辅资源:教辅搜索列表、教辅详情、当前已绑定教辅。
    • 作业篮:查询草稿、单题加入/移除、整卷批量加入、排序保存、清空、完成选题。
  • 关键字段:
    • 题目侧:question_idquestion_typestemansweranalysisscoredifficultyknowledge_point_idchapter_idresource_sourcesource_org_id
    • 试卷侧:paper_idpaper_namequestion_counttotal_scoreupdated_atbook_idpreview_page_count
    • 作业篮侧:basket_idteacher_idsubjectsort_noadded_from(单题加入/整卷加入/回流加入)、snapshot_version
  • 状态与缓存:
    • 页面需维护全局状态:当前学科、当前资源来源、当前模式、当前左侧页签、当前筛选条件、当前选中教辅/知识点/试卷。
    • 作业篮采用“服务端草稿为主,LocalStorage 兜底”的双写策略;缓存键按 teacher_id + subject 维度隔离,学科确认切换后清理旧学科缓存。
  • 埋点:
    • 页面浏览:记录入口来源(首页/作业列表/作业报告回流)。
    • 全局操作:学科切换、资源来源切换、题库/卷库 切换、左侧页签切换。
    • 检索行为:筛选条件变更、关键词搜索、分页跳转、滚动续载、地区树勾选。
    • 内容操作:查看解析、加入作业篮、取消加入、整卷一键添加、打开试卷详情、缩放预览、翻页、直接去发布。
    • 作业篮行为:打开/关闭作业篮、删除单题、拖拽排序、一键清空、完成选题。
    • 教辅行为:打开教辅弹窗、搜索教辅、筛选教辅、选择教辅、切换学科确认/取消。
当前这页已经是“原型 + 页面 PRD”评审工作台。跨页面规则请维护在总览 / 全局规则文档,页面细节请直接维护右侧页面 PRD。
Review Workspace - Prototype + Page PRD