资源中心
页面元信息
- 终端:教师 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;关闭仅关闭弹窗,不清空当前筛选和作业篮。
- 默认以 100% 比例展示 A4 试卷预览,支持
- 作业篮:
- 悬浮按钮始终显示当前已选题数。
- 抽屉内按题型分组展示题目,默认展开;教师可折叠分组、删除单题、拖拽调整顺序。
- 拖拽后的题目顺序直接带入
t_composition.html作为默认组卷顺序。 一键清空需二次确认,确认后清空全部题目并重置统计。完成选题仅在作业篮题目数大于 0 时可点击,点击后进入t_composition.html;若题目数为 0,按钮禁用并提示“请先加入题目”。
- 教辅选择弹窗:
- 支持按教辅书名、学段、年级、册次、出版社、适配教材版本筛选。
- 教辅卡片展示封面、书名、学科标签、出版社、适配教材和册次信息。
- 点击某本教辅后,更新左侧当前教辅封面卡以及“尚未绑定教辅/尚未绑定教辅对象”标签,并关闭弹窗。
- 列表与加载策略:
教辅章节/知识点题目列表采用页码分页,默认每页 10 题,支持上一页、下一页和页码跳转;首次加载展示骨架屏,翻页展示局部 Loading。试卷选题左侧试卷列表支持分批加载,默认每批 20 份试卷,滚动到底部自动续载,顶部固定展示总量与“收起筛选/展开筛选”入口;该能力为本次补充规格,当前原型未显式展示续载反馈,需要在后续交互稿中补充 Loading 和“已加载完成”提示。卷库试卷卡片列表采用页码分页,默认每页 10 份试卷,支持直接跳页;切换检索条件后回到第 1 页。
异常描述
| 异常场景 | 处理方式 |
|---|---|
| 页面首次加载失败 | 右侧展示整页错误态,提供 重试 按钮;若本地已有作业篮缓存,需先恢复作业篮再请求资源数据。 |
| 题目/试卷筛选无结果 | 展示空态文案“暂无匹配资源”,保留当前筛选条件,并提供 清空筛选 快捷入口。 |
| 题目解析缺失 | 展开解析区时展示“暂无解析”,但不影响加入作业篮。 |
| 未绑定教辅即进入教辅配卷 | 显示“请先绑定教辅对象”引导态,隐藏结果列表,仅保留 选择教辅/点击绑定 操作。 |
| 试卷预览加载失败 | 试卷详情弹窗展示错误态和 重新加载,去发布 按钮置灰不可点,教师可关闭弹窗返回列表。 |
| 学科切换误操作 | 点击确认弹窗 取消 后,必须恢复为原学科,且作业篮、筛选条件、当前列表状态均不变化。 |
| 作业篮清空/删除失败 | 若前端已删除但服务端保存失败,需回滚本次操作并 Toast 提示“作业篮同步失败,请重试”。 |
| 分页或翻页越界 | 上一页/下一页在边界态置灰;手动输入页码超出范围时不跳转,并提示“页码超出范围”。 |
| 长列表加载超时 | 首屏超过 3 秒未返回时显示骨架屏;超过 10 秒转为错误提示并支持重试。 |
数据需求
- 接口:
- 资源上下文:可访问资源来源列表、当前教师可见组织范围、学科/学段/年级/册次/教材版本字典。
- 题库资源:教辅树、知识点树、题目列表、题目解析详情。
- 卷库资源:试卷列表、试卷题目明细、试卷 A4 预览数据、地区筛选树。
- 教辅资源:教辅搜索列表、教辅详情、当前已绑定教辅。
- 作业篮:查询草稿、单题加入/移除、整卷批量加入、排序保存、清空、完成选题。
- 关键字段:
- 题目侧:
question_id、question_type、stem、answer、analysis、score、difficulty、knowledge_point_id、chapter_id、resource_source、source_org_id。 - 试卷侧:
paper_id、paper_name、question_count、total_score、updated_at、book_id、preview_page_count。 - 作业篮侧:
basket_id、teacher_id、subject、sort_no、added_from(单题加入/整卷加入/回流加入)、snapshot_version。
- 题目侧:
- 状态与缓存:
- 页面需维护全局状态:当前学科、当前资源来源、当前模式、当前左侧页签、当前筛选条件、当前选中教辅/知识点/试卷。
- 作业篮采用“服务端草稿为主,LocalStorage 兜底”的双写策略;缓存键按
teacher_id + subject维度隔离,学科确认切换后清理旧学科缓存。
- 埋点:
- 页面浏览:记录入口来源(首页/作业列表/作业报告回流)。
- 全局操作:学科切换、资源来源切换、
题库/卷库切换、左侧页签切换。 - 检索行为:筛选条件变更、关键词搜索、分页跳转、滚动续载、地区树勾选。
- 内容操作:查看解析、加入作业篮、取消加入、整卷一键添加、打开试卷详情、缩放预览、翻页、直接去发布。
- 作业篮行为:打开/关闭作业篮、删除单题、拖拽排序、一键清空、完成选题。
- 教辅行为:打开教辅弹窗、搜索教辅、筛选教辅、选择教辅、切换学科确认/取消。