教师Web 作业管理模块 PRD
说明:
- 本文档基于当前教师Web原型、
docs/4. 核心业务流程/及现行PRD模板进行补充整理,定位为教师Web作业管理模块评审稿。- 页面级交互以原型稿为准,跨端联动、数据回流、AI辅助批改等业务闭环以核心流程文档为准。
- 仍需业务/研发联合确认的事项统一沉淀在第8章,避免散落在各页面描述中。
0. 修订记录
(选填项,仅在评审后有修改的情况下填写)
| 修订日期 | 修订人 | 修订原因 | 修订内容 |
|---|---|---|---|
| 2026-04-22 | Codex | 对照最新业务流程与原型补充文档 | 补充产品目标、范围边界、业务规则总表、状态字典、非功能需求、核心数据对象、遗留问题 |
1. 总体说明
1.1 文档信息
(必填项)
| 项目 | 内容 |
|---|---|
| 需求分级 | S(常规模块) |
| 产品负责人 | 教师作业产品线(实名待补) |
| 用户 | 核心用户:任课教师、班主任。 关联用户:学生(提交作业并产出批改/学情数据)。 |
| 需求背景 | 南方数字教辅平台紧扣中小学教育教学核心需求,聚焦作业全流程数字化转型,构建覆盖学校、教师、学生的全链路智慧教育服务体系。平台以标准化知识点图谱为底层支撑,集成内容管理、作业管理、智能批改、学情分析、智能推荐等核心模块,形成从内容生产、作业流转、批改反馈到学情诊断的完整业务链条。 在教师侧,平台需要承接“查看作业 -> 资源选题 -> 组卷排版 -> 发布作业 -> 批改 -> 学情分析”的高频工作流;同时联动学生小程序、教师小程序的拍照提交数据入口,依托大模型智能批改能力,切实实现教师减负增效。本文档聚焦教师Web端作业管理模块,对页面级能力进行结构化定义。 |
| 高保真原型稿 | 产出文档/作业管理模块/原型图/原型图索引.md(待补线上评审链接) |
| 影响范围 | 教师Web端;联动学生侧和教师小程序侧的提交/批改结果数据,但不在本文档内展开这些端的页面交互说明 |
| 量化目标 | 建议按V1.0验收口径确认: 1. 教师从选题到正式发布的平均耗时≤8分钟; 2. PDF生成成功率≥98%,发布失败率≤1%; 3. AI辅助批改触发覆盖率≥60%,教师最终人工复判率≤30%; 4. 批改完成后的作业报告查看率≥70% |
| 上线目标 | 形成教师Web端“列表 -> 资源中心 -> 组卷 -> 发布 -> 批改 -> 报告 -> 再出题”的可执行闭环,并与学生/教师小程序提交流水打通 |
| 文档版本 | V1.1 |
1.2 角色说明
(选填项,相同内容以父级文档为准)
| 角色 | 说明 | 备注 |
|---|---|---|
| 教师 | 在教师Web端完成作业创建、发布、批改、分析的核心使用者 | 本文档主要服务对象 |
| 系统 | 提供资源加载、PDF生成、AI批改、统计分析等能力 | 作为业务支撑角色 |
| 学生 | 接收教师发布的作业并形成提交/批改结果数据 | 间接关联角色 |
1.3 名词解释
(选填项,相同内容以父级文档为准)
| 名词 | 释义 | 备注 |
|---|---|---|
| 个性化作业 | 教师基于资源中心选题后自主组卷并发布的作业 | 一份作业可关联多个班级 |
| 纸质教辅作业 | 与纸质教辅内容配套的作业 | 一份作业关联一个班级,沿用既有纸质教辅链路 |
| 作业篮 | 教师在资源中心临时收纳待发布题目的容器 | 资源中心核心概念 |
| 统一管理平台任务 | 上游统一管理平台下发至教师资源中心的任务或资源 | 资源中心输入来源之一 |
| 组卷工作台 | 教师对已选题目进行编排、编辑、生成PDF的页面 | 发布链路核心页面 |
| AI批改 | 系统基于学生提交结果生成辅助判分结果的能力 | 批改页关联能力 |
| 作业报告 | 对一次作业的班级表现、题目表现、学生学情进行统计分析的页面 | 分析主入口 |
| 题型 | 当前数字教辅场景下题目的业务类型 | 本期重点包含填空题、选择题 |
| 题目结构 | 题目在卷面中的组织方式 | 当前重点包含组合题、单选题、多选题 |
1.4 流程说明
(选填项,相同内容以父级文档为准)
教师Web作业管理主流程:
flowchart LR
subgraph T[教师]
A[进入作业列表] --> B[发起新建作业]
C[在资源中心选题并管理作业篮] --> D{教师选择}
D -- 继续选题 --> C
D -- 完成选题 --> E[进入组卷工作台编排试卷]
E --> F{是否暂存草稿}
F -- 是 --> G[保存草稿并暂留此页等待后续操作]
F -- 否 --> H[完成编排并提交发布]
G --> H
K[在作业列表查看班级进度并进入批改]
L{是否触发AI辅助批改}
L -- 是 --> M[查看AI建议并人工确认]
L -- 否 --> N[直接人工批改]
M --> O[保存教师最终成绩]
N --> O
Q[进入作业报告查看整体分析] --> R[下钻错题分析或学生评价报告]
R --> S[基于结果执行二次出题或教学干预]
end
subgraph X[系统]
B --> B1[加载资源中心数据与作业篮]
H --> I[校验发布信息并生成作业]
I --> J[作业回写列表并进入待提交状态]
U[汇总学生提交记录] --> V[沉淀待批改数据]
L --> W[按教师指令触发AI辅助批改]
W --> M
O --> Y[生成班级、题目、学生三层统计结果]
Y --> Q
end
subgraph S1[学生及采集侧]
J --> P[学生完成纸面作答]
P --> T1{提交/采集入口}
T1 -- 学生自提交 --> T2[学生小程序拍照提交]
T1 -- 教师代提交 --> T3[教师小程序绑定作业/班级/学生后拍照代提交]
T2 --> U
T3 --> U
end
J --> K
V --> K
K --> L
补充说明:
- 个性化作业与纸质教辅作业共用教师Web作业管理主入口,但业务口径不同:
- 个性化作业:一份作业可关联多个班级。
- 纸质教辅作业:一份作业关联一个班级,按既有逻辑整合进当前页面体系。
- 学生提交数据来源包括学生小程序拍照自提交、教师小程序拍照代提交等拍照采集入口;其中教师小程序代提交需先绑定
作业 -> 班级 -> 学生,教师Web端负责消费这些结果并完成批改、分析与二次出题。 - AI辅助批改在教师侧为“人工可控的辅助能力”,教师可手动触发AI辅助批改,最终成绩以教师确认结果为准。
- 作业报告不是独立录入流程,而是教师完成批改后的派生产物;分析结果需继续支持错题分析、学生评价与后续教学动作。
参考资料:
docs/4. 核心业务流程/教师端-组卷发布主流程.mddocs/4. 核心业务流程/教师端-AI批改与教师审核.mddocs/4. 核心业务流程/教师端-作业分析与评价闭环.mddocs/4. 核心业务流程/教师小程序-拍照代提交流程.mdprds/教师小程序_PRD.md
1.5 架构说明
(选填项,相同内容以父级文档为准)
教师Web作业管理模块位于平台“四维一体”作业数字化体系中的教师工作台层,建议按以下架构理解:
- 内容底座:标准化知识点图谱、数字教辅内容、统一管理平台下发任务。
- 教师工作台:作业列表、资源中心、组卷工作台、发布作业、批改、作业报告。
- 数据入口:学生小程序拍照提交、教师小程序拍照代提交。
- 智能能力:OCR/答案识别、AI辅助批改、学情统计与智能推荐。
- 数据输出:本文档重点描述教师Web端当前原型已承接的作业分析、题目分析、学生评价等页面能力,不额外展开更高层级的独立分析页面。
1.6 产品目标
P0(本期必须实现)
- 教师可在Web端完成“选题 -> 编排 -> 发布”的标准化作业生产闭环。
- 教师可消费来自学生小程序、教师小程序的拍照提交结果,并完成最终批改确认。
- 教师可在批改后查看班级、题目、学生三级分析结果,并支持从报告回流到再出题动作。
P1(本期建议预留)
- 为草稿恢复、上下文暂存、断点续批等高频中断场景提供稳定恢复能力。
- 为后续扩展催交、班级对比、知识点专项训练、智能推荐出题预留数据结构和埋点基础。
1.7 范围边界
本期范围内
- 教师Web端作业列表、资源中心、组卷工作台、发布页、批改页、作业报告、错题分析、学生评价报告。
- 与学生提交结果、AI辅助批改、报告分析相关的跨端数据消费规则。
- 与教师高频工作流直接相关的草稿保存、发布上下文暂存、未保存离开确认等保护机制。
本期范围外
- 教师首页、个人中心、学生管理等外围通用页面。
- 学生端/教师小程序/教研端的页面级交互细节。
- 独立的草稿箱页面、复杂版本回溯、报告导出下载、消息中心能力。
- 面向学生公开排名、对外公开成绩榜单等不符合未成年人保护要求的展示能力。
1.8 核心用户旅程
journey
title 教师Web作业管理核心旅程
section 作业生产
进入作业列表并新建作业: 5: 教师
在资源中心选题并维护作业篮: 5: 教师
在组卷工作台调整题序与分值: 4: 教师
在发布页核对并选择班级后发布: 5: 教师
section 作业执行
查看学生提交进度与未交名单: 4: 教师
进入批改页结合AI建议完成确认: 5: 教师
section 分析回流
查看作业报告与学生学情: 4: 教师
从错题分析回流到再出题: 4: 教师
2. 功能清单
(必填项)
| 角色 | 功能 | 版本 | 优先级 | 范围 | 说明/备注/依赖 |
|---|---|---|---|---|---|
| 教师 | 查看作业列表(个性化作业) | V1.0 | P0 | 教师Web | 一份作业关联多个班级;状态:已评审 |
| 教师 | 查看作业列表(纸质教辅作业) | V1.0 | P0 | 教师Web | 一份作业关联一个班级;沿用既有纸质教辅逻辑整合 |
| 教师 | 资源中心选取资源 | V1.0 | P0 | 教师Web | 查看统一管理平台发送的任务列表及资源内容;状态:已评审 |
| 教师 | 作业篮管理 | V1.0 | P0 | 教师Web | 作业篮全局存在,跨资源来源共享,用于管理已选题目;状态:已评审 |
| 教师 | 试卷编辑排版 | V1.0 | P0 | 教师Web | 编辑题目位置、分数、排版结构;状态:已评审 |
| 教师 | 题目编辑 | V1.0 | P0 | 教师Web | 改编题目内容和题目信息;状态:已评审 |
| 教师 | 保存作业内容与发布 | V1.0 | P0 | 教师Web | 填入必要信息后保存当前作业内容并完成发布;状态:已评审 |
| 教师 | 查看提交记录 | V1.0 | P1 | 教师Web | 查看学生提交情况,依赖小程序端与其他采集渠道数据回流 |
| 教师 | 手动批改 | V1.0 | P0 | 教师Web | 查看学生提交原卷,手动判对错和打分 |
| 教师 | AI辅助批改 | V1.0 | P0 | 教师Web | 手动开启AI辅助批改,识别学生答案并自动给出辅助判分 |
| 教师 | 作业学情优化 | V1.0 | P1 | 教师Web | 更改统计逻辑,优化作业学情界面交互 |
| 教师 | 学情分析优化 | V1.0 | P1 | 教师Web | 以当前原型中的作业分析、错题分析、学生评价为主 |
| 教师 | 错题分析 | V1.0 | P1 | 教师Web | 查看高频错题详情与学生名单 |
| 教师 | 学生评价报告 | V1.0 | P1 | 教师Web | 查看单学生作业评价结果 |
2.1 业务规则总表
| 规则编号 | 规则描述 | 影响范围 |
|---|---|---|
| R01 | 个性化作业与纸质教辅作业共用教师Web作业管理主入口,但个性化作业可关联多个班级,纸质教辅作业仅关联一个班级 | 作业列表、发布作业、作业报告 |
| R02 | 作业篮为教师当前学科下的全局共享容器;跨资源来源共享,切换学科时若作业篮非空,必须二次确认是否清空 | 资源中心、组卷工作台 |
| R03 | 组卷工作台允许保存“组卷草稿”,发布页允许保存“发布上下文”;二者均仅对当前教师本人可见 | 组卷工作台、发布作业 |
| R04 | 发布前必须满足:作业标题必填、至少选择一个班级、题目数≥1、PDF预览可用 | 发布作业 |
| R05 | 发布成功后作业进入“待提交”状态,系统按作业-班级维度生成执行记录,供后续提交、批改、报告消费 | 作业列表、提交回流、作业报告 |
| R06 | 学生提交结果按“作业ID + 学生ID + 页码/记录版本”进行聚合展示,教师在批改时可查看提交记录,不以单次最新上传简单覆盖 | 批改、提交记录 |
| R07 | AI批改仅提供建议值;低置信度、识别失败、结构不完整时必须降级为人工确认,不得直接作为最终成绩对外展示 | 批改 |
| R08 | 教师点击保存后写入的分数与判定,才是最终有效成绩;该结果会回流影响学生端“批改结果/作业分析”与教师报告统计 | 批改、作业报告、学生端结果展示 |
| R09 | 作业报告按班级口径切换查看;报告是批改后的派生产物,未完成批改时允许查看进度型数据,不输出完整结论型分析 | 作业报告、错题分析、学生评价报告 |
| R10 | 报告页、题目分析页支持将题目重新加入作业篮,形成“分析 -> 再出题”闭环 | 作业报告、资源中心、组卷工作台 |
| R11 | 单学生评价页允许查看个体表现、知识点掌握和教师评价,但不展示公开班级排名,不形成对外公开榜单 | 学生评价报告 |
| R12 | 公开讲评、投屏、跨班复制名单等场景默认遵循未成年人保护与最小暴露原则,敏感成绩信息不得在非必要范围公开展示 | 作业列表、作业报告、评价页、后续演示场景 |
| R13 | 教辅绑定按“教师ID + 学科 + 年级”维度记忆最近一次选择;首次无绑定时自动选择当前学科、年级下排序第一本可用教辅;若历史教辅失效、下架或无权限,则回退到同维度第一本可用教辅,无可用数据时保持未绑定 | 资源中心、选择教辅弹窗、卷库指定教辅配卷 |
2.2 作业状态字典
| 业务对象 | 状态 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|---|
| 作业草稿 | 组卷草稿 | 教师在组卷工作台手动保存草稿 | 继续编辑、删除草稿、完成进入发布页 | 教师继续编辑并完成生成,或主动放弃 |
| 作业发布态 | 待提交 | 作业发布成功后,存在未提交学生,且当前已提交学生均已完成批改;包括“0人提交”与“部分学生已提交且已批改、但仍有人未提交”两种场景 | 查看学生名单、查看提交进度、批改作业(若已有学生提交)、作业分析(若已有学生完成批改) | 出现任意“已提交但未批改”学生时进入待批改;全部学生提交完毕且全部批改完成时进入已批改 |
| 作业发布态 | 待批改 | 至少存在1名已提交但未完成教师最终确认的学生 | 查看学生名单、进入批改、查看提交记录、查看进度型分析 | 所有已提交学生均完成批改后,若仍有人未提交则回到待提交;若全部学生均已提交且完成批改则进入已批改 |
| 作业发布态 | 已批改 | 全部应提交学生均已提交,且全部提交结果已完成教师最终确认 | 查看学生名单、作业分析、错题分析、学生评价、再次进入批改修正 | 若后续支持补交/重提并产生新的待确认记录,则重新进入待批改 |
2.3 批改子状态字典
| 对象 | 状态 | 说明 | 教师侧处理 |
|---|---|---|---|
| AI辅助结果 | 未触发 | 教师尚未对当前学生/题目发起AI辅助批改 | 支持直接人工批改或手动触发AI |
| AI辅助结果 | 处理中 | AI任务已发起,系统正在识别与判分 | 展示处理中占位,禁止直接引用未完成结果 |
| AI辅助结果 | 建议可用 | 已返回AI建议分数/判定 | 教师可采纳、修改或忽略 |
| AI辅助结果 | 低置信度 | AI可返回结果但置信度不足 | 明示提示,必须人工复核 |
| AI辅助结果 | 失败 | OCR/识别/判分失败或结构不完整 | 直接降级人工批改,不阻断保存 |
3. 功能说明
(必填项)
3.1 作业列表
3.1.1 前置
(选填项)
- 教师已登录教师Web端。
- 教师具备对应班级作业查看权限。
- 系统已返回当前教师可见的作业数据。
3.1.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 作业列表 | 页面名称:作业列表。 功能目的:作为教师Web作业管理模块的统一入口,用于查看已发布/进行中/已完成作业,并进入批改和分析链路。 操作流程:教师点击作业中心 -> 默认进入个性化作业 -> 通过筛选项定位目标作业 -> 查看提交/批改进度 -> 点击“批改作业”“作业分析”等操作 -> 跳转对应功能页。 字段/规则/状态说明: 顶部栏: 1. 作业中心/个性化作业:标题,固定不变。 2. 学科筛选:该系统所支持的所有学科:书法、语文、数学、英语、物理、化学、科学、历史、地理、音乐、生物学、信息技术、美术、体育与健康、道德与法治、劳动、艺术、其他。 中部栏: 1. 已发布作业:Tab,默认选择,选择之后为激活状态(蓝色)。 2. 新建作业:按钮,点击进入资源中心页面。 作业列表: 筛选查询项: 1. 班级筛选:班级多选,允许选择多个班级筛选展示作业;筛选出含筛选班级的作业。 2. 状态筛选:待提交、待批改、已批改。 3. 作业标题搜索栏:对作业标题进行模糊搜索。 4. 发布时间:时间段搜索,筛选起始时间至截止时间内发布的作业。 列表项: 1. 作业标题:该作业的标题,唯一。 2. 学科:该作业的学科。 3. 班级:该作业发布的班级,用“,”分隔;若超过所显示区域,用“…”省略展示;鼠标放置在上方可展示全部的班级。 4. 提交进度:以“a/b”展示,a为该份作业提交的学生数,b为该份作业应提交的学生数;且 a<=b。 5. 发布时间:该份作业在发布作业处点击“立即发布”之后发布成功的时间。 6. 状态:展示待提交、待批改、已批改。 7. 操作:展示学生名单、批改作业、作业分析等操作入口。 状态: 1. 待提交:若该份作业一个学生没有提交,或部分学生提交且都完成批改时展示。 2. 待批改:若该份作业仍有未批改的学生时展示。 3. 已批改:该份作业全部学生提交完毕且完成批改时展示。 操作: 1. 学生名单:点击之后弹出学生名单弹窗;任何状态都展示。 2. 批改作业:点击之后进入批改页面;有一个学生提交作业后就展示。 3. 作业分析:点击之后进入作业分析页面;有一个学生提交作业后并完成批改后展示。 异常与边界: 1. 首屏加载中时,列表区域展示骨架屏。 2. 列表加载失败时,展示错误提示和“重新加载”按钮。 3. 当前学科下无已发布作业时,展示空态文案和“新建作业”按钮。 4. 筛选后无结果时,展示“暂无符合条件的作业”,并支持清空筛选条件。 5. 发布时间筛选的开始时间晚于结束时间时,阻断查询并提示“开始时间不能晚于结束时间”。 6. 提交进度数据异常导致 a>b 时,前端不直接展示异常值,统一展示“—/—”,并提示“进度统计中,请稍后刷新”。 7. 提交数据跨端回流延迟时,列表保留最近一次成功聚合结果,并展示“最近更新时间”,支持教师手动刷新。 | 【待补充:t_homework_list 页面截图】 |
3.1.3 补充规格
顶部栏
| 元素 | 类型 | 规则 |
|---|---|---|
| 作业中心/个性化作业 | 标题 | 固定展示,不随筛选条件变化 |
| 学科筛选 | 下拉框 | 支持书法、语文、数学、英语、物理、化学、科学、历史、地理、音乐、生物学、信息技术、美术、体育与健康、道德与法治、劳动、艺术、其他 |
中部栏
| 元素 | 类型 | 规则 |
|---|---|---|
| 已发布作业 | Tab | 默认选中;选中后为蓝色激活态;当前页面只展示已发布成功的作业 |
| 新建作业 | 按钮 | 点击后进入资源中心页面 |
筛选查询项
| 字段 | 控件类型 | 默认值 | 规则 |
|---|---|---|---|
| 班级筛选 | 多选下拉 | 全部班级 | 允许选择多个班级;筛选出含所选班级的作业 |
| 状态筛选 | 单选/下拉 | 全部状态 | 支持待提交、待批改、已批改 |
| 作业标题搜索栏 | 输入框 | 空 | 对作业标题进行模糊搜索 |
| 发布时间 | 时间范围选择器 | 空 | 筛选起始时间至截止时间内发布的作业 |
列表项
| 字段 | 展示规则 | 交互说明 |
|---|---|---|
| 作业标题 | 展示该作业标题;标题唯一 | 超长时按原型展示,必要时悬浮查看完整标题 |
| 学科 | 展示该作业所属学科 | 无额外交互 |
| 班级 | 用“,”分隔展示该作业发布的班级;超出显示区域时以“…”省略 | 鼠标悬浮后展示全部班级 |
| 提交进度 | 以“a/b”展示;a为已提交学生数,b为应提交学生数;且 a<=b | 用于快速查看提交情况 |
| 发布时间 | 展示点击“立即发布”并发布成功后的时间 | 无额外交互 |
| 截止时间 | 无截止时间时展示“-”;已设置时展示 YYYY-MM-DD HH:mm | 由“设置截止时间”弹窗维护 |
| 状态 | 展示待提交、待批改、已批改 | 按下方状态规则判定 |
| 操作 | 展示学生名单、批改作业、作业分析、设置截止时间 | 按下方操作规则控制显隐 |
状态规则
| 状态 | 判定规则 |
|---|---|
| 待提交 | 该份作业一个学生没有提交,或部分学生提交且都完成批改时展示 |
| 待批改 | 该份作业仍有未批改的学生时展示 |
| 已批改 | 该份作业全部学生提交完毕且完成批改时展示 |
操作规则
| 操作 | 点击后行为 | 展示条件 |
|---|---|---|
| 学生名单 | 弹出学生名单弹窗 | 任何状态都展示 |
| 批改作业 | 进入批改页面 | 有一个学生提交作业后就展示 |
| 作业分析 | 进入作业分析页面 | 有一个学生提交作业后并完成批改后展示 |
| 设置截止时间 | 弹出“设置截止时间”弹窗;确认后更新该作业截止时间 | 当前作业已发布后展示;替代原“结束提交/恢复提交”入口 |
设置截止时间弹窗
| 元素/规则 | 说明 |
|---|---|
| 弹窗标题 | 展示“设置截止时间” |
| 作业标题 | 只读展示当前操作的作业标题,帮助教师确认操作对象 |
| 截止时间 | 时间选择器,精确到分钟,不允许清空;若作业已有合法截止时间则优先回填,否则默认当前时间后 30 天 |
| 时间范围 | 普通选择模式下,必须满足 当前时间 < 截止时间 <= 当前时间 + 365天 |
| 校验提示 | 选择过去时间、当前时间或超过 365 天后的时间时,在选择器下方展示“截止时间不符合规则,请重新选择”,并阻断确认 |
| 此刻截止 | 复选框;勾选后时间选择器禁用并显示当前时间,教师点击确认后该作业立即截止提交;取消勾选后恢复时间选择,并回到勾选前的合法时间,若无合法时间则回到当前时间后 30 天 |
| 确认 | 普通模式下将截止时间更新为所选时间;此刻截止模式下将截止时间更新为确认时的当前时间 |
| 取消 | 关闭弹窗,不修改原截止时间 |
| 接口要求 | 后端需提供更新作业截止时间能力,入参至少包含 homeworkId、deadlineAt;deadlineAt 不允许为空 |
列表反馈与异常
| 场景 | 处理方式 |
|---|---|
| 首屏加载中 | 列表区域展示骨架屏 |
| 列表加载失败 | 展示错误提示和“重新加载”按钮 |
| 当前学科下无已发布作业 | 展示空态文案和“新建作业”按钮 |
| 筛选后无结果 | 展示“暂无符合条件的作业”,并支持清空筛选条件 |
| 发布时间开始时间晚于结束时间 | 阻断查询,并提示“开始时间不能晚于结束时间” |
| 提交数据跨端回流延迟 | 列表保留最近一次成功聚合结果,并展示“最近更新时间”,支持教师手动刷新 |
| 提交进度异常 | 当 a>b 时统一展示“—/—”,并提示“进度统计中,请稍后刷新” |
| 教师无班级权限或无数据 | 展示权限/数据空态,不展示无权限班级名称 |
学生名单弹窗
| 要素 | 规格 |
|---|---|
| 功能目的 | 展示该份作业未完成提交的学生名单,支持教师对未提交学生进行名单复制并通过社交媒体工具催交作业 |
| 触发条件 | 教师在作业列表页点击提交进度区域,或点击“学生名单”按钮后弹出学生名单弹窗 |
| 页面来源 | 当前弹窗从作业列表页打开,不跳转新页面 |
| 标题 | 学生名单 |
| 班级选择 | 下拉框单选;展示该作业发布的班级;选择后,学生名单列表随之切换 |
| 人数展示 | 以“共X人”展示当前班级下学生人数 |
| 全选 | 复选框;点击后当前学生名单列表中所有学生复选框全部选中;再次取消后全部取消选中 |
| 复制名单 | 按钮;点击后复制当前已勾选学生名单 |
| 筛选未交页 | 展示该份作业的页面复选列表;有多少页展示多少个页筛选项;以“第X页”展示;默认不选,即展示班级下全部学生名单 |
| 学生名单列表 | 展示班级选择以及筛选未交页条件下的所有学生名单 |
顶部栏
| 字段 | 类型 | 规则 |
|---|---|---|
| 学生名单 | 标题 | 固定展示 |
| 班级选择 | 下拉框单选 | 展示该作业发布的班级;切换后刷新学生名单列表,并重置“全选”为未勾选状态 |
| 共X人 | 人数徽标 | 展示当前班级下学生总人数 |
| 全选 | 复选框 | 点击后选中当前列表全部学生;取消后全部取消 |
| 复制名单 | 按钮 | 复制当前已勾选学生名单;若未勾选任何学生,则提示“请先勾选需要复制名单的学生” |
筛选未交页
| 字段 | 类型 | 规则 |
|---|---|---|
| 第X页 | 复选框组 | 有多少页展示多少个页筛选项;默认全部不选;未勾选任何页时展示全部学生名单;勾选后按所选页过滤未交学生 |
学生名单列表
| 字段 | 说明 | 规则 |
|---|---|---|
| 复选框 | 支持勾选和取消选择 | 可单独选择学生;若全部勾选,则顶部“全选”自动变为选中态 |
| 学生姓名 | 展示学生姓名 | 按当前班级和页筛选条件展示 |
| 对应作业页 | 展示该份作业的全部页提交情况 | 当前 HTML 原型以页码徽标展示页状态;未提交展示灰色,已提交展示绿色;页筛选区以“第X页”展示 |
复制名单规则
| 场景 | 规则 |
|---|---|
| 已勾选学生 | 复制内容按“学生姓名(缺X、Y页)”格式拼接;若该生已全部提交,则展示“学生姓名(已全提交)” |
| 未勾选学生 | 不执行复制,提示教师先勾选学生 |
| 班级切换后 | 复制范围仅针对当前班级下已勾选学生 |
异常与边界
| 场景 | 处理方式 |
|---|---|
| 当前班级无学生数据 | 弹窗列表区展示空态提示 |
| 当前页筛选下无对应未交名单 | 列表区展示“当前筛选下没有对应未交名单” |
| 切换班级 | 重置全选状态,并按新班级重新渲染学生名单与页筛选结果 |
| 点击遮罩或关闭按钮 | 关闭弹窗,不保留本次勾选状态 |
| 业务规则引用 | R01、R05 |
3.2 资源中心
3.2.1 前置
- 教师从作业列表点击“新建作业”,或从作业报告/题目分析的“加入作业篮”动作回流进入资源中心。
- 系统已加载教师可见的资源域(平台资源、区域资源、校本资源)、题库树数据(教辅章节、知识点、试卷选题列表)、卷库试卷卡片数据及教辅检索数据。
- 资源中心在当前原型中包含两条明显分流链路:
- 题库链路:按题选题 -> 加入作业篮 -> 完成选题 -> 进入组卷工作台。
- 卷库链路:按卷浏览 -> 查看试卷预览 -> 直接去发布。
- 若教师从组卷工作台返回资源中心继续增删题目,后续重新回到组卷工作台时,需要重新核对排版结果。
3.2.2 说明
| 页面/区块 | 说明 | 原型图 |
|---|---|---|
| 资源中心(总页面) | 页面名称:资源中心,对应原型路由 /teacher/resource-center。页面结构由 3 层组成:顶部资源域 Tab(平台资源、区域资源、校本资源)+ 一级模式切换(题库、卷库)+ 内容区。内容区根据一级模式分为两套完全不同的信息架构:题库模式显示左侧树导航和右侧题目结果区;卷库模式隐藏左侧树导航,改为整页试卷检索与试卷卡列表。 默认态为“平台资源 + 题库 + 教辅章节 + 学科数学 + 学段小学”。右下常驻“已选 X 题”作业篮浮球,仅在题库模式显示。 | 【待补充:t_resource_center 页面截图】 |
| 题库(一级模式) | 功能定位:面向“按题找题”的选题模式,核心对象是单题。 结构固定为“左侧定位区 + 右侧题目区 + 右下作业篮浮球”。左侧通过三个二级页签切换定位方式:教辅章节、知识点、试卷选题。右侧根据二级页签渲染不同筛选栏,但题目卡交互保持一致。 该模式下所有“加入作业篮”动作都应沉淀到当前学科作业篮,并通过“完成选题”进入组卷工作台。 | 【待补充:题库区块截图】 |
| 题库-教辅章节 | 左侧展示学科/学段下拉、当前教辅卡、章节树;右侧展示题型筛选 Chips、结果总数、题目卡和分页器。 当前原型默认选中“阳光同学 / 数学三年级上”,树默认定位“第一章 时分秒 -> 课时1 认识钟表 -> 基础巩固区”。 适用场景是教师围绕教材章节同步备课、课后巩固和章节练习出题。 | 【待补充:t_resource_center_chapter 页面截图】 |
| 题库-知识点 | 左侧替换为知识点树,右侧筛选栏增加“难度等级”维度,支持按知识结构做专项补题。 当前原型默认树结构为“数与代数 -> 数的认识 -> 整数的认识”,右侧题目卡仍保留查看解析、加入作业篮等动作。 | 【待补充:t_resource_center_knowledge 页面截图】 |
| 题库-试卷选题 | 切到“试卷选题”后,左侧树区扩展为试卷筛选 + 试卷列表,右侧切换为 Master-Detail 详情区。 未选试卷时右侧显示“请从左侧选择一份试卷查看题目”空态;选中后展示试卷标题、题量、“一键添加”和试卷内题目列表。 该页适用于教师参考现有套卷结构后拆题选题。 | 【待补充:t_resource_center_paper_question 页面截图】 |
| 卷库(一级模式) | 功能定位:面向“按卷找卷”的整卷浏览模式,核心对象是整卷而不是单题。 切入卷库后隐藏左侧树导航和右下作业篮浮球,顶部仅保留学科、学段和卷库检索条件。 卷库当前原型更偏“查看试卷 -> 直接去发布”链路,而不是“整卷写入作业篮后再组卷”。 | 【待补充:卷库区块截图】 |
| 卷库-全库检索 | 通过“检索范围”切到“全库检索”后,展示年级、册次、适配教材、试卷名称关键词等组合筛选条件,下方为试卷卡列表与分页器。 每张卡片展示试卷名称、学科标签、题量、更新时间,并提供“查看试卷”“发布作业”两个动作。 | 【待补充:t_resource_center_paper_search 页面截图】 |
| 卷库-指定教辅配卷 | 通过“检索范围”切到“指定教辅配卷”后,先展示“尚未选择教辅”的引导 Banner;教师选择教辅后,Banner 切换为已选教辅摘要卡,再结合“配套搜卷”输入框检索配套试卷。 该页适用于教师已经确定教辅系列,希望直接复用配套整卷资源。 | 【待补充:t_resource_center_paper_match 页面截图】 |
| 选择教辅弹窗 | 资源中心在两处复用同一套教辅选择弹窗:题库-教辅章节页的当前教辅卡、卷库-指定教辅配卷页的空 Banner/已选 Banner。 弹窗支持按教辅书名、年级、册次、出版社、适配教材版本进行筛选,列表区以卡片形式展示教辅封面与基础信息。 | 【待补充:t_resource_center_book_modal 页面截图】 |
| 试卷详情弹窗 | 卷库卡片点击“查看试卷”后打开。弹窗包含试卷标题、缩放、单页/双页切换、页数信息、A4 预览区和底部“去发布/关闭”动作。 当前原型内试卷详情采用标准化排版预览,而非逐题编辑。 | 【待补充:t_resource_center_paper_modal 页面截图】 |
| 作业篮抽屉 | 题库模式下由右下浮球触发,抽屉内展示已选题量、总分、按题型分组的题目明细、一键清空和完成选题动作。 抽屉标题区采用命令栏样式,题型分组支持折叠,单题支持删除。 | 【待补充:t_resource_center_basket 页面截图】 |
3.2.3 补充规格
模块层级定义
| 层级 | 名称 | 职责 | 包含内容 |
|---|---|---|---|
| 一级模块 | 资源中心 | 统一承接入口、公共筛选、作业篮与恢复逻辑 | 题库区块、卷库区块 |
| 一级模式 | 题库 | 面向题目级资源的选题 | 教辅章节、知识点、试卷选题 |
| 一级模式 | 卷库 | 面向整卷级资源的找卷与预览 | 全库检索、指定教辅配卷 |
入口与恢复规则
| 场景 | 规则 |
|---|---|
| 作业列表新建作业 | 默认进入“平台资源 -> 题库 -> 教辅章节”;右侧直接展示题目结果,便于教师最短路径开始选题 |
| 作业报告/题目分析回流出题 | 进入资源中心后应保持当前学科与作业篮上下文,承接“分析 -> 再出题”链路 |
| 组卷工作台返回选题 | 回到资源中心后继续增删题目是允许的,但后续重新进入组卷工作台时需重新核对排版 |
| 卷库直接发布 | 教师在卷库模式下可不打开作业篮,直接从试卷卡或试卷详情进入发布页 |
资源中心公共骨架
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 顶部栏 | 返回、页面标题、资源域 Tab、教师头像/姓名 | 资源域 Tab 固定居中显示,当前原型仅做激活态切换,不承载独立筛选表单 |
| 一级模式切换 | 题库、卷库 | 使用胶囊式切换控件;默认选中题库 |
| 题库左侧容器 | 二级页签、学科下拉、学段下拉、树/列表定位区 | 仅在题库模式显示;根据二级页签切换为章节树、知识点树或试卷筛选列表 |
| 题库右侧容器 | 筛选栏、题目卡、分页器 | 根据二级页签切换不同筛选维度,但题目卡动作保持统一 |
| 卷库内容区 | 学科下拉、学段下拉、检索范围、条件区、试卷卡列表 | 进入卷库后左侧树导航整体隐藏,内容区改为整页检索布局 |
| 作业篮浮球 | 已选 X 题 | 固定在页面右下角;仅在题库模式展示 |
| 作业篮抽屉 | 摘要区、分组区、操作区 | 由作业篮浮球触发,从右侧滑出,不覆盖顶部栏 |
模式切换与分流规则
| 场景 | 规则 |
|---|---|
| 默认进入页面 | 默认选中“平台资源 + 题库 + 教辅章节 + 学科数学 + 学段小学” |
| 切换学科/学段 | 作为资源中心全局筛选条件;教师切换后,题库、卷库及其下属子页统一沿用当前学科/学段口径 |
| 切换资源域 | 仅切换顶部激活态,不影响当前一级模式和作业篮 |
| 题库 -> 卷库 | 隐藏左侧树导航与作业篮浮球,右侧改为整卷检索布局 |
| 卷库 -> 题库 | 恢复左侧树导航;根据当前二级页签决定右侧展示普通题目列表还是试卷选题 Detail 视图 |
| 教辅章节 -> 知识点 | 左侧树数据切换为知识点树,右侧筛选栏从“题型”切换为“题型 + 难度等级” |
| 教辅章节/知识点 -> 试卷选题 | 左侧面板宽度从 240px 扩展为 280px,右侧切换为试卷题目 Detail 区,默认展示空态 |
| 题库完成选题 | 通过作业篮抽屉顶部按钮进入组卷工作台 /teacher/composition |
| 卷库查看试卷/去发布 | 通过试卷卡或试卷详情弹窗直接跳转发布页 /teacher/publish |
题库区块公共规则
| 项目 | 规则 |
|---|---|
| 默认落点 | 首次进入题库时默认落在“教辅章节” |
| 公共布局 | 始终为“左侧定位区 + 右侧题目结果区” |
| 页面切换 | 切换“教辅章节 / 知识点 / 试卷选题”时不清空作业篮,仅切换当前定位和结果区域 |
| 共享容器 | 三个二级页签共享同一作业篮,允许跨定位方式连续加题 |
| 卡片动作 | 题目卡统一支持“查看解析”“加入作业篮/已加入” |
| 分页形式 | 题目结果区底部统一使用页码分页 + 前往某页输入框(试卷选题 Detail 为页码按钮) |
题库页面:教辅章节
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 左侧全局筛选 | 学科、学段下拉 | 支持教师切换;属于资源中心全局筛选条件,切换到知识点、试卷选题或卷库时继续沿用当前值;作业篮非空时切换学科/学段需先二次确认 |
| 当前教辅卡 | 教辅封面、教辅名称、年级册次、“点击切换教辅” | 点击卡片或文字入口都打开教辅选择弹窗;选中教辅后同步刷新左侧展示文案、章节树、右侧题目列表与结果总数,并将题型筛选重置为“全部”、分页回到第1页 |
| 章节树 | 章、课时、训练区三级树 | 当前节点高亮;章和课时节点带展开/收起箭头;点击节点后刷新右侧题目列表:若当前节点为叶子节点,则展示该叶子节点绑定的题目;若为非叶子节点,则展示其下所有子节点绑定题目的汇总列表 |
| 题型筛选 | 单选 | 默认“全部”;正式需求需展示平台支持的全部题型;切换题型后仅刷新当前章节口径下的题目列表,不改变已选教辅和章节节点 |
| 结果总数 | 共X题 | 按当前学科、学段、教辅、章节节点、题型口径实时统计;筛选条件变化后同步刷新,不允许沿用旧计数 |
| 题目卡默认态 | 题型、难度、题目信息 | 默认收起解析,仅展示主题题干、小题题干、选项等基础信息 |
| 题目卡展开态 | 题型、难度、题目信息、题目答案、题目解析、知识点 | 点击“展开解析”后展开当前卡片隐藏信息;再次点击“收起解析”恢复默认态 |
| 加篮动作 | 加入作业篮、移出作业篮 | 支持单题加入和移出;按钮状态需与当前作业篮实时同步,不允许同一道题重复加入;跨分页、跨筛选返回后保持一致 |
| 分页器 | 上一页、下一页 | 一页最多展示10题;仅支持左右翻页;切换学科、学段、教辅、章节或题型后默认回到第1页 |
| 排序规则 | 题目首次上架时间 | 按题目首次上架时间统一排序;若首次上架时间相同,则按题目ID做稳定次排序,避免翻页后出现重复或遗漏 |
题库页面:教辅章节异常与边界
| 场景 | 处理方式 |
|---|---|
| 首次进入无默认教辅 | 左侧展示“请选择教辅”引导态;章节树与右侧题目列表不展示旧数据 |
| 切换学科/学段后当前教辅不适配 | 清空当前教辅与章节选中态,提示教师重新选择教辅;题型筛选恢复“全部” |
| 章节树节点无题目 | 叶子节点未绑题,或非叶子节点下所有子节点均无题时,右侧展示“暂无符合条件的题目”空态,不报错;保留当前章节高亮与题型筛选 |
| 非叶子节点汇总存在重复题 | 按题目ID去重后再统计“共X题”与列表,避免重复展示和重复加入作业篮 |
| 题型筛选无结果 | 保留当前题型选中态与章节定位,右侧展示空态,并允许教师切回“全部” |
| 展开解析但字段缺失 | 缺失答案、解析或知识点时展示“暂无答案/暂无解析/暂无知识点”,不因局部字段缺失导致整张卡片报错 |
| 加入/移出作业篮失败 | Toast提示失败原因,按钮态和作业篮计数保持原值,不做静默切换 |
| 分页越界 | 当题目总数变化导致当前页超出最大页码时,自动回退到最后一个有效页;最后一页不足10题按实际题量展示 |
| 题目列表或章节树加载失败 | 仅当前区域展示局部错误态和“重试”入口,另一侧已成功加载的数据不被清空 |
题库页面:知识点
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 左侧全局筛选 | 学科、学段下拉 | 支持教师切换;属于资源中心全局筛选条件,切换到教辅章节、试卷选题或卷库时继续沿用当前值 |
| 知识点树 | 一级知识域、二级知识项、三级知识点 | 展示当前学段、学科下的知识点目录;点击节点后刷新右侧结果;若当前节点为叶子节点,则右侧展示该叶子节点绑定题目;若为非叶子节点,则展示其下所有子节点绑定题目的汇总列表 |
| 节点选中态 | 当前节点高亮、父节点展开 | 切换节点后回到第一页;保留当前题型和难度筛选,避免教师重复设置 |
| 右侧筛选栏 | 题型、难度等级、结果总数 | 右侧固定展示当前筛选口径下的“共X题”结果数;结果数需与当前知识点节点、题型、难度条件实时一致 |
| 题型筛选 | 单选 | 默认“全部”;正式需求需展示平台支持的全部题型,当前知识点口径下切换后仅刷新题目列表,不改变已选知识点节点 |
| 难度筛选 | 单选 | 默认“全部”;选项为“容易、较易、中等、较难、困难” |
| 题目卡默认态 | 题型、难度、题目信息 | 默认收起解析,仅展示主题题干、小题题干、选项等基础信息 |
| 题目卡展开态 | 题型、难度、题目信息、题目答案、题目解析、知识点 | 点击“展开解析”后展开当前卡片隐藏信息;再次点击“收起解析”恢复默认态 |
| 加篮动作 | 加入作业篮、移出作业篮 | 支持单题加入和移出;按钮状态需与当前作业篮实时同步,不允许同一道题重复加入 |
| 分页 | 上一页、下一页、页码信息 | 一页最多展示10题;正式需求至少支持左右切换页,若保留显式页码或跳页输入框,也需遵循10题/页口径 |
| 排序 | 题目首次上架时间 | 题目列表按题目首次上架时间稳定排序,翻页前后不允许出现重复题目或漏题 |
| 切换逻辑 | 从教辅章节切到知识点 | 左侧仅替换树数据,右侧卡片区复用同一套题目卡组件与分页区;学科、学段与作业篮上下文保持不变 |
题库页面:知识点状态说明
| 对象 | 状态 | 说明 |
|---|---|---|
| 题目卡 | 收起解析 | 展示题型、难度、主题题干、小题题干、选项和操作按钮,降低列表信息噪音 |
| 题目卡 | 展开解析 | 在收起态基础上补充展示题目答案、题目解析、知识点;不应影响其他卡片浏览位置 |
| 加篮按钮 | 未加入 | 默认展示“加入作业篮”,点击后写入当前作业篮 |
| 加篮按钮 | 已加入 | 进入已加入态,并允许教师执行移出作业篮操作;状态需与作业篮抽屉实时同步 |
| 结果区 | 有结果 | 展示“共X题”和当前页题目卡列表 |
| 结果区 | 无结果 | 保留当前知识点节点和筛选条件,结果数显示0,列表区展示空态说明 |
题库页面:知识点异常与边界
| 场景 | 处理方式 |
|---|---|
| 当前学段、学科下无知识点树 | 左侧展示空态“当前学段学科暂无知识点”,右侧不沿用旧结果,筛选栏禁用,仅保留学科、学段切换入口 |
| 点击叶子节点但节点未绑定题目 | 保留节点高亮,右侧展示空态“当前知识点下暂无题目”,结果数显示0,不自动跳转到其他节点 |
| 点击非叶子节点但其下无任何子节点题目 | 仍按当前节点口径返回空结果,不允许错误汇总到同级其他节点 |
| 切换学科或学段 | 需回到第一页并刷新知识点树与题目列表;若当前作业篮存在与新口径不兼容题目,需先二次确认,确认后清理不兼容题目并同步刷新作业篮状态,取消则回退原值 |
| 切换知识点、题型、难度后当前页超出总页数 | 自动重置到第一页;上一页/下一页在首页、末页置灰不可点击 |
| 当前筛选组合无结果 | 保留当前知识点节点与筛选条件,结果区展示空态,不静默重置筛选项 |
| 题目解析字段缺失 | 缺少题目答案、题目解析或知识点时,展开区分别展示“暂无答案”“暂无解析”“暂无知识点”,不影响加篮操作 |
| 题目已从其他入口加入作业篮 | 当前知识点列表需实时回显已加入状态,不允许重复加入生成重复题目 |
| 加入作业篮或移出作业篮失败 | 保持原按钮状态、结果数和作业篮计数不变,并通过Toast提示“操作失败,请重试” |
| 知识点树或题目结果加载失败 | 保留最近一次成功结果,展示局部错误提示和重试入口,不允许整页白屏 |
| 教师连续快速切换多个知识点节点 | 仅以最后一次点击的节点结果为准,避免节点高亮和右侧题目列表口径不一致 |
题库页面:试卷选题
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 左侧筛选区 | 年级下拉、册次单选 Chips、试卷名称搜索、试卷总数、收起筛选 | 左侧顶部提供“共 156 份试卷”和“收起筛选/展开筛选”动作 |
| 左侧试卷列表 | 试卷名称、题量、更新时间、选中态 | 当前选中项高亮显示,点击后刷新右侧明细 |
| 右侧空态 | 空图标 + “请从左侧选择一份试卷查看题目” | 未选择试卷前固定展示 |
| 右侧试卷头部 | 试卷标题、题量、“一键添加” | 头部固定展示当前选中试卷基础信息 |
| 右侧题目卡 | 题型、试卷内题号、分值、题干、查看解析、加入作业篮 | 适合“从卷拆题”场景,操作粒度仍然是单题 |
| Detail 分页 | 上一页、页码、下一页 | 当前原型在 Detail 区底部使用简单页码按钮 |
卷库区块公共规则
| 项目 | 规则 |
|---|---|
| 默认落点 | 切入卷库后默认展示“全库检索” |
| 公共布局 | 采用“顶部学科/学段 + 检索范围 + 条件区 + 试卷卡结果区”结构 |
| 页面切换 | 在“全库检索 / 指定教辅配卷”之间切换时,仅替换条件区,不切换试卷卡列表容器 |
| 结果对象 | 卷库始终以整卷卡片为核心对象 |
| 当前原型链路 | 卷库不展示题库作业篮浮球,主动作是“查看试卷”“发布作业” |
| 试卷预览 | 试卷卡“查看试卷”统一打开试卷详情弹窗,而不是进入单独页面 |
卷库页面:全库检索
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 顶部筛选 | 学科、学段下拉 | 位于卷库内容区最上方 |
| 检索范围 | “全库检索 / 指定教辅配卷” Chips | 当前默认选中“全库检索” |
| 条件区 | 年级、册次、适配教材、试卷名称关键词 | 年级使用 Chips,教材版本使用下拉,关键词使用输入框 + 搜索按钮 |
| 结果概览 | 当前命中量 | 搜索框右侧显示“共12000份” |
| 试卷卡 | 试卷名称、学科标签、题量、更新时间、查看试卷、发布作业 | 当前原型中“发布作业”直接跳转发布页 |
| 分页器 | 总数、页码、上一页、下一页、前往某页 | 试卷卡区底部统一展示 |
卷库页面:指定教辅配卷
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 未选教辅引导态 | 虚线 Banner、加号图标、引导文案 | 点击整块 Banner 打开教辅选择弹窗 |
| 已选教辅摘要态 | 大尺寸 Banner、教辅标题、副标题、切换教辅按钮、3D 书封面 | 选中教辅后由空 Banner 切换为摘要 Banner |
| 配套搜卷 | 搜索框、搜索按钮、匹配结果数 | 显示在 Banner 下方,帮助教师按教辅内范围继续缩小结果 |
| 试卷卡列表 | 与全库检索共用试卷卡样式 | 保持“查看试卷”“发布作业”两个主动作 |
| 切换教辅 | 重新打开教辅选择弹窗 | 切换后应重置当前配套搜卷结果 |
题目卡、试卷卡与按钮状态
| 对象 | 状态/动作 | 规则 |
|---|---|---|
| 题目卡 | 查看解析 | 点击后展开答案、解析、知识点;再次点击收起 |
| 题目卡 | 加入作业篮 | 点击后写入作业篮;成功后按钮切换为“已加入” |
| 题目卡 | 已加入 | 悬浮时文案可切换为“取消加入”;再次点击后移出作业篮 |
| 题库-试卷选题头部 | 一键添加 | 将当前试卷内全部题目批量加入当前学科作业篮 |
| 试卷列表项 | 选中态 | 选中后左侧列表高亮,右侧刷新试卷标题、题量和题目明细 |
| 卷库卡片 | 查看试卷 | 打开试卷预览弹窗,不进入题目级编辑 |
| 卷库卡片 | 发布作业 | 直接进入发布页,走整卷发布支路 |
作业篮抽屉
| 区域 | 字段/动作 | 规则 |
|---|---|---|
| 触发方式 | 右下“已选 X 题”浮球 | 点击后从右侧滑出抽屉 |
| 顶部摘要 | 已选 X 题、共 Y 分 | 摘要位于抽屉标题栏右侧,随增删题实时更新 |
| 顶部动作 | 一键清空、完成选题、关闭抽屉 | “一键清空”当前原型走原生确认框;“完成选题”跳转组卷工作台 |
| 题型分组 | 选择题、填空题、解答题等 | 标题格式为“题型(X题)”,支持折叠/展开 |
| 题目条目 | 题号、题型标签、题干摘要、分值、删除 | 删除后同步刷新分组题数、全局题号和顶部摘要 |
| 分组清理 | 最后一题被删除 | 该题型分组自动移除 |
关键弹窗与确认规格
| 交互 | 触发条件 | 规格 |
|---|---|---|
| 选择教辅弹窗 | 点击题库当前教辅卡、卷库 Banner 或“切换教辅” | 支持教辅书名、年级、册次、出版社、适配教材版本筛选;列表区按卡片展示教辅封面与简介;点击卡片即完成单选绑定并返回进入时页面,首次绑定与历史记忆按 R13 执行 |
| 清空作业篮确认 | 点击“一键清空” | 当前原型使用原生确认框,确认后清空全部题目并刷新摘要 |
| 试卷详情预览 | 点击试卷卡“查看试卷” | 弹窗内提供缩放、单双页切换、页数信息、标准 A4 预览和“去发布”按钮 |
| 学科/学段切换确认 | 作业篮非空时切换学科或学段 | 正式需求需增加二次确认;当前原型代码仅做学科同步与 Toast 提示,后续需补足学段联动与不兼容题目清理逻辑 |
选择教辅弹窗:字段/规则说明
| 区域 | 字段/动作 | 规则 | 边界说明 |
|---|---|---|---|
| 弹窗头部 | 标题“选择使用的教辅” | 固定文案,不随题库/卷库入口变化 | 仅回跳页面不同,标题与筛选结构保持一致 |
| 弹窗头部 | X关闭按钮 | 点击后仅关闭当前弹窗,不写入新的教辅绑定 | 关闭后当前页面已绑定教辅、章节树、配套搜卷结果保持不变 |
| 筛选区 | 教辅书名搜索框 | 仅对教辅书名做模糊搜索;支持点击搜索按钮或回车触发 | 关键词为空或仅空格按清空搜索处理;特殊字符按普通字符参与匹配 |
| 筛选区 | 年级下拉筛选 | 展示当前学段下的可选年级,默认“全部” | 学段切换后重新拉取年级选项并回退“全部”;若无年级数据,仅保留“全部” |
| 筛选区 | 册次下拉筛选 | 选项固定为“全部、上册、下册、全一册”,默认“全部” | 选择“全一册”时仅命中全一册教辅;选择“上册/下册”时不包含全一册 |
| 筛选区 | 出版社下拉筛选 | 展示当前结果集中可选出版社,默认“全部” | 出版社字段缺失时卡片展示“出版社待补充”,但不影响卡片选择 |
| 筛选区 | 适配教材下拉筛选 | 展示当前结果集中可选教材版本,默认“全部” | 教材版本字段缺失时卡片展示“教材版本待补充”,筛选项不展示空值 |
| 结果概览 | 共X本教辅 | X为当前筛选条件下的教辅数量,条件变化后实时刷新 | X=0时仍保留数量文案,列表区进入空态 |
| 列表区 | 教辅卡片列表 | 单选模式;点击卡片即完成绑定并返回进入时页面,回写教辅信息 | 接口提交中卡片进入防重点击态,避免连续点击写入多次 |
| 卡片字段 | 教辅封面图 | 优先展示真实封面图 | 封面加载失败时展示默认占位封面,不影响卡片点击 |
| 卡片字段 | 教辅标题 | 展示标准书名 | 书名过长时单卡片内截断展示,完整名称保留用于搜索命中与回填 |
| 卡片字段 | 学科 | 展示教辅归属学科 | 与当前资源中心学科不一致的数据不进入结果集 |
| 卡片字段 | 教材版本 | 展示适配教材版本 | 缺失时展示“教材版本待补充” |
| 卡片字段 | 出版社信息 | 展示出版社名称 | 缺失时展示“出版社待补充” |
| 卡片字段 | 年级册次 | 展示“年级 + 册次”组合信息 | 册次为全一册时统一展示“全一册”;缺失年级数据的教辅不进入当前年级结果集 |
选择教辅弹窗:状态与回填边界
| 状态/场景 | 处理规则 |
|---|---|
| 首次进入且当前未绑定教辅 | 若当前学科、年级下存在可用教辅,系统按 R13 自动绑定排序第一本可用教辅,并在题库教辅章节页/卷库指定教辅配卷页回填对应教辅信息 |
| 当前学科、年级已有历史绑定 | 再次打开弹窗时默认高亮上次所选教辅;点击卡片后覆盖当前绑定结果,并更新该学科、年级维度下的最近选择记录 |
| 历史绑定教辅失效、下架或无权限 | 不继续回填失效教辅,按 R13 回退到当前学科、年级下第一本可用教辅;若仍无可用数据,则保持未绑定并展示空态 |
| 当前筛选条件下无结果 | 仅影响弹窗列表展示,不主动清空当前已绑定教辅;教师关闭弹窗后仍保留进入前的绑定结果 |
| 当前学科、年级下无任何可用教辅 | 保持未绑定状态;题库教辅章节页展示“当前暂无可用教辅”,卷库指定教辅配卷页保持未选教辅引导态 |
| 从题库-教辅章节页切换教辅 | 返回后同步刷新当前教辅卡、章节树和题目结果;若原章节节点在新教辅中不存在,则定位到新教辅目录下第一个可用章节节点 |
| 从卷库-指定教辅配卷页切换教辅 | 返回后同步刷新 Banner 摘要信息,并清空旧教辅下的配套搜卷关键词与结果列表,按新教辅重新加载默认配套结果 |
点击X或遮罩关闭弹窗 | 仅关闭弹窗,不触发自动切换教辅,也不重置进入页的已选状态和结果列表 |
空态与异常处理
| 场景 | 处理方式 |
|---|---|
| 资源中心首屏加载中 | 左侧筛选区、试卷列表和右侧详情区分区展示骨架屏;未拿到结果前不展示“0份试卷/0题”等误导性计数 |
| 未选择试卷 | 试卷选题页右侧固定展示默认空态“请从左侧选择一份试卷查看题目”,不报错、不预占分页位 |
| 学段/学科切换后 | 学段/学科作为全局筛选同步带入题库、卷库及其他资源页签;若原年级、册次、已选试卷在新学段/学科下失效,则自动回退为“全部年级/全部册次/未选试卷”,右侧恢复默认空态 |
| 学段下无可选年级 | 年级下拉仅保留“全部年级”,并提示“当前学段暂无年级数据”;不阻断教师继续按其他条件检索 |
| 收起筛选/展开筛选 | 收起时仅隐藏年级、册次等扩展筛选项,不清空当前条件;展开后需回显教师上一次选择的年级、册次和关键词 |
| 试卷名称搜索为空或仅空格 | 按清空搜索处理,恢复展示当前学段学科、年级、册次条件下的全部试卷 |
| 切换题库/卷库或资源域后无结果 | 保留当前全局学段/学科和已输入关键词,列表展示“暂无符合条件的试卷”,并提供“清空筛选”入口 |
| 筛选后无试卷 | 左侧展示空态,“共X份试卷”展示0;若当前选中试卷已不在结果集中,则清空右侧详情并回到默认空态 |
| 试卷列表加载失败 | 左侧列表区展示错误提示和“重新加载”按钮;已成功加载的筛选条件保留,不自动清空 |
| 试卷详情加载失败 | 保留左侧当前选中态,右侧展示错误提示和“重新加载”按钮,不自动切换到其他试卷 |
| 试卷已下架、无权限或详情不存在 | 右侧展示“该试卷暂不可查看”,允许教师返回左侧重新选择其他试卷 |
| 当前试卷暂无题目 | 右侧头部仍展示试卷标题和“共0题”,题目列表区展示空态,不展示分页器 |
| 切换试卷后 | 右侧题目列表默认回到第1页,题目解析默认收起,避免沿用上一份试卷的分页和展开状态 |
| 分页越界 | 当题目总数变化导致当前页超出最大页码时,自动回退到最后一个有效页;每页最多展示10题,最后一页不足10题按实际题量展示 |
| 一键添加重复点击 | 按钮进入加载态并防重复触发,接口返回前不可再次点击,避免整卷重复提交 |
| 一键添加存在重复题 | 按题目ID去重处理;已在作业篮中的题目不重复写入,按钮仍保持可点击,操作后仅更新作业篮题数和题目按钮状态 |
| 一键添加部分失败 | Toast明确反馈“成功加入X题,Y题加入失败”;失败题不影响已成功加入题目的保留 |
| 单题加入/移出后状态同步 | 当前页题目按钮、右下作业篮数量及其他已渲染同题入口需实时同步,禁止出现同一题同时展示“加入作业篮”和“移出作业篮”两种状态 |
| 展开解析但字段缺失 | 缺失答案、解析或知识点时展示“暂无答案/暂无解析/暂无知识点”,不因局部字段缺失导致整张卡片报错 |
| 题目顺序字段异常 | 仍按试卷原始返回顺序展示;若题号缺失或重复,前端不重新排序,展示“—”占位并保留原序 |
| 教辅弹窗列表加载失败 | 弹窗列表区展示局部错误态和“重新加载”按钮;已输入关键词与筛选条件保留,不自动关闭弹窗 |
| 教辅筛选无结果 | 弹窗列表区展示“暂无匹配教辅”,保留当前关键词与筛选条件,并提供“清空筛选”快捷入口 |
| 当前学科、年级下无可用教辅 | 不执行自动绑定;题库教辅章节页展示不可操作空态,卷库指定教辅配卷页保留未选教辅引导态 |
| 历史绑定教辅失效 | 按 R13 自动回退到同维度第一本可用教辅;若无兜底数据,则清空绑定并提示“当前暂无可用教辅” |
| 教辅封面或字段缺失 | 使用占位封面与“教材版本待补充/出版社待补充”兜底文案,不影响教辅选择与回填 |
| 教师关闭教辅弹窗未选择新教辅 | 关闭行为仅影响弹窗显隐,不回写任何新绑定数据,也不重置进入页的滚动位置与筛选结果 |
| 未选择教辅 | 卷库“指定教辅配卷”模式先展示引导 Banner,不直接显示空白列表 |
| 删除至空分组 | 某题型最后一道题被删除时,当前分组自动消失,摘要同步更新 |
| 试卷详情关闭 | 点击关闭按钮或遮罩后关闭弹窗,返回卷库结果列表 |
业务规则引用
- R02:作业篮为当前教师、当前学科下的共享容器。题库模式需严格按该规则管理加题与切学科行为;当前原型已实现学科同步切换,但正式需求需补足非空确认。
- R03:题库模式下“完成选题”统一进入组卷工作台;若教师返回资源中心继续改题,后续排版需重新校验。
- R10:作业报告、题目分析回流加入的题目应继续沉淀到当前作业篮,形成“分析 -> 再出题”闭环。
- R13:教辅绑定按教师、学科、年级维度记忆最近一次选择;首次无绑定或历史绑定失效时,统一按当前维度第一本可用教辅兜底。
- 当前原型存在卷库直接发布支路,应在评审时明确其是否作为正式产品能力保留。
3.3 组卷工作台
3.3.1 前置
(选填项)
- 教师已在资源中心完成选题。
- 作业篮中至少存在1道题目。
- 系统已将作业篮数据带入组卷工作台。
3.3.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 组卷工作台 | 页面名称:组卷工作台。 功能目的:承接资源中心的选题结果,支持教师完成卷面结构编排、题序调整、分值设置、题目内容改编、答题区排版与PDF生成,是“选题 -> 组卷 -> 发布”主链路中的强编辑页面,也是后续发布、提交、批改、报告链路的上游数据源。 操作流程:教师从资源中心进入组卷工作台 -> 系统按当前作业篮初始化目录/大题/小题结构 -> 教师在左侧大纲中组织试卷层级并拖拽调序 -> 在中间A4画布查看所见即所得效果 -> 在右侧属性面板修改排版参数与分值 -> 必要时进入题目编辑全屏页改写题干、答案、解析、知识点和标签信息 -> 完成预览确认后点击“完成”生成PDF -> 成功跳转发布作业页。 字段/规则/状态说明: 1. 页面采用“顶部工具栏 + 左侧卷面大纲导航 + 中间A4画布 + 右侧属性面板”的三栏工作台结构,属于高密度B端编辑页;左侧负责结构组织,中间负责卷面呈现,右侧负责参数编辑与快速校验。 2. 页面存在三类编辑对象:目录/说明块、大题/小题、整卷级版面参数;当教师点击不同对象时,右侧属性面板和当前高亮态需同步切换,避免出现“编辑对象不明确”的状态。 3. 顶部工具栏包含“退出”“返回选题”“保存草稿”“完成”四个主操作;“退出”返回作业列表,“返回选题”回到资源中心继续加题或减题,“保存草稿”用于中断恢复,“完成”是唯一进入PDF生成的主出口。 4. 左侧卷面大纲支持目录、大题、小题三级展示与拖拽调序;题目分值需在大纲中直接可见,大题总分由下属小题分值自动汇总,不允许教师手动录入一个与小题不一致的大题总分。 5. 组卷页需支持“未分配题目暂存区”,用于承接两类题目:一类是从资源中心新增但尚未拖入任何大题的题目,另一类是从原有大题中移除但仍保留在本次组卷上下文中的题目;暂存区为空时展示独立空态。 6. 中间A4画布为所见即所得预览区,支持连续多页浏览;需展示试卷标题、说明块、题目内容、答题留白、页码、二维码/作业码预留位置,确保预览结果与最终PDF保持一致,不允许发布页再做二次版式拼装。 7. 右侧属性面板默认展示题数、总分、纸张规格等概览信息;选中具体题目后切换为编辑态,至少支持题目分值、答题区高度两类高频参数的就地调整,并提供“编辑题目”“编辑排版”双入口。 8. 题目编辑需支持全屏编辑页,覆盖题目所属目录、学科、学段、年级、册次、年份、是否组合题、难度等级、难度系数、知识点、教材章节、题目分值、题目分类、适用场景、题型、题干、正确答案、解析等字段;题干、答案、解析区域需兼容富文本、图片与公式内容。 9. 当前数字教辅场景下,题型重点支持填空题、选择题,并兼容组合题、单选题、多选题;所有内容改编不得破坏后续提交、批改和报告链路对题型结构的消费,尤其不能让已选题在结构上变成不可识别的自由文本。 10. 点击“完成”后需先执行生成前校验,再进入PDF生成中状态;生成成功后回填PDF预览与组卷结果并跳转发布页,生成失败则停留当前页并支持重试,同时保留教师已完成的分组、分值与排版设置。 异常与边界: 1. 教师点击“退出”或“返回选题”时,如存在未保存调整,必须弹出是否保存排版信息的确认弹窗,避免高频教学场景中因中断导致编辑成果丢失。 2. 题目编辑全屏页属于强编辑态,必填字段缺失时需在当前字段位置高亮提示,不允许以不完整数据覆盖原题,也不允许在关闭编辑页后静默丢弃已确认修改。 3. 若“未分配题目暂存区”仍有题目未放入目录,点击“完成”时需先弹窗提示教师返回分配或确认跳过,避免教师误以为所有题目都已进入卷面。 4. PDF生成失败时,需保留当前结构、分值与排版设置,给出失败原因摘要和“重新生成”入口,不得清空当前工作台状态。 5. 资源中心增删题导致原排版引用失效时,恢复草稿后允许继承已有配置,但须提示教师存在重排风险,不承诺旧版式100%可复用。 6. 预览渲染超时、题目内容格式异常、图片/公式渲染失败时,不得直接跳转发布页,需留在组卷页完成修正或重试。 7. 当教师从发布页返回组卷工作台继续编辑时,必须保留发布页已填写的标题、备注、班级和预览页位置,形成“带上下文返回”而非重新开始。 | 【待补充:t_composition 页面截图】 |
3.3.3 补充规格
页面结构
| 区域 | 规格 |
|---|---|
| 顶部工具栏 | 提供“退出”“返回选题”“保存草稿”“完成”四个主操作;“完成”为生成PDF入口,触发后按钮进入加载态,防止重复提交 |
| 左侧卷面大纲导航 | 展示试卷标题、目录、大题、小题的层级结构;支持拖拽调序、点击定位、分值汇总展示;需保留“未分配题目暂存区”用于承接新增但尚未归类的题目 |
| 中间A4画布 | 所见即所得排版预览区,按A4连续分页展示;点击题目或说明块后可进入对应编辑态,预览内容与最终PDF保持一致 |
| 右侧属性面板 | 默认展示题数、总分、纸张规格等概览;选中题目后切换为编辑面板,支持“编辑题目”“编辑排版”双模式 |
页面入口与到达路径
| 场景 | 入口 | 页面初始化规则 |
|---|---|---|
| 首次组卷 | 资源中心点击“完成选题” | 按当前作业篮生成初始组卷结构;若题目尚未分组,则进入默认目录/待分配状态 |
| 二次补题 | 教师从组卷页返回资源中心增删题后再次进入 | 保留原有目录、大题、分值与排版;新增题进入未分配题目暂存区,已删除题从卷面中移除 |
| 草稿恢复 | 教师点击“保存草稿”后再次进入组卷页 | 恢复上次保存的目录、题序、分值、答题留白和版面参数 |
| 发布页回跳 | 发布页点击“编辑试卷” | 组卷结构恢复到上次生成PDF后的状态,同时带回发布页上下文 |
顶部操作规则
| 操作 | 规则 |
|---|---|
| 退出 | 返回作业列表;若存在未保存修改,必须先弹出保存确认 |
| 返回选题 | 返回资源中心继续增删题;回到组卷页后保留既有目录和排版,新增题进入未分配题目暂存区 |
| 保存草稿 | 仅保存当前教师本人的题篮结构、目录、大题/小题顺序、分值、答题区留白和版面配置 |
| 完成 | 触发生成前校验和PDF生成;成功后跳转发布作业页,失败则保留当前编辑现场 |
左侧卷面大纲导航
| 能力 | 说明 |
|---|---|
| 试卷标题区 | 展示试卷标题;支持进入“添加说明/编辑说明”能力,说明内容会同步渲染到A4画布顶部 |
| 目录编排 | 支持新增/编辑目录标题与目录下说明内容;目录可作为一组题目的容器 |
| 大题调序 | 支持拖拽调整大题顺序;大题分值为下属小题分值汇总结果 |
| 小题调序 | 支持在同一大题内调整顺序;如发生跨目录移动,需同步更新所属目录关系 |
| 点击定位 | 点击目录/大题/小题后,中间A4画布滚动到对应位置并高亮当前编辑对象 |
| 分值展示 | 小题分值常驻展示;大题分值实时汇总,不允许出现大题总分与小题合计不一致 |
| 未分配题目暂存 | 从资源中心新增的题目默认先进入暂存区;教师需将其拖入目录/大题后才视为正式参与排版 |
| 删除题目 | 从组卷结构中删除后,题目返回可选状态;若题目已从资源中心作业篮删除,则组卷页同步移除 |
中间A4画布规则
| 能力 | 说明 |
|---|---|
| 版式规格 | 按A4纸纵向分页展示,支持连续多页浏览;页与页之间展示分页边界,便于教师判断打印效果 |
| 画布内容 | 包含试卷标题、目录说明、大题标题、小题题干、选项/填空结构、答题留白、页码、二维码/作业码预留位 |
| 左右联动 | 点击左侧大纲节点时,画布滚动并高亮对应对象;点击画布中的题目/说明块时,左侧和右侧同步切换到该对象 |
| 排版微调 | 支持按题目调整答题留白高度;该参数直接影响PDF最终呈现 |
| 预览一致性 | 画布预览必须与最终生成PDF的分页、页码、二维码位置、题目顺序保持一致 |
| 刷新反馈 | 拖拽、改分、改标题、改说明、确认题目编辑后重新渲染当前画布,渲染过程需提供轻量反馈,避免教师误判为卡死 |
右侧属性面板
| 状态 | 展示内容 | 规则 |
|---|---|---|
| 默认态 | 题数、总分、纸张规格、提示文案 | 页面初始进入时默认展示;用于全局概览和操作引导 |
| 题目编辑态 | 编辑题目、编辑排版两个入口;题目分值、答题区高度等参数 | 仅在选中具体题目时展示;修改后即时作用于当前题目 |
| 排版参数态 | 答题区高度、局部留白等版式参数 | 支持步进器或输入框调整;回车后生效 |
| 信息提示态 | 当前对象说明、操作提示、异常提示 | 如字段缺失、当前对象不可编辑时给出明确说明 |
题目编辑字段
| 字段组 | 内容 | 规则 |
|---|---|---|
| 关联信息 | 所属目录 | 必须归属到一个目录或默认分组下;切换目录后更新卷面位置 |
| 基础信息 | 学科、学段、年级、册次、年份、试题来源、是否组合题 | 学科默认继承当前题篮学科;不允许改成与当前作业学科冲突的值 |
| 标签信息 | 难度等级、难度系数、知识点、教材章节、题目分类、适用场景、题目分值 | 知识点支持多选标签;分值支持按0.5分粒度调整 |
| 内容信息 | 题型、题干、正确答案、解析 | 题干与答案为必填;需支持富文本、图片、公式等混排内容 |
题目编辑全屏页规则
| 项目 | 规则 |
|---|---|
| 打开方式 | 在右侧属性面板点击“编辑题目”进入全屏编辑页 |
| 页面职责 | 承担复杂字段编辑,不在主工作台中直接展开过多表单,保证组卷主界面聚焦排版效率 |
| 字段校验 | 题型、题干、正确答案为必填;难度、知识点、教材章节等标签信息需遵循当前题库口径 |
| 保存方式 | 点击“确定”后写回当前题目并刷新A4预览;点击“取消”放弃本次未确认修改 |
| 风险控制 | 不允许在字段非法、结构异常、题型冲突时直接覆盖当前卷面题目 |
排版与预览规则
| 规则 | 说明 |
|---|---|
| 预览刷新时机 | 拖拽调序、确认题目编辑、修改分值、调整答题区高度、编辑说明内容后,需刷新当前预览结果 |
| 页面展示 | 采用A4纵向连续页展示,需包含页码、标题区、说明区、题目区与二维码/作业码预留位置 |
| 选中联动 | 点击左侧大纲节点、中间画布中的题目或说明块后,需同步高亮当前对象并切换右侧属性面板 |
| 答题区留白 | 每题可单独设置答题区高度;调整结果作为排版参数参与PDF生成与后续数据库持久化 |
| 总分汇总 | 右侧概览区实时展示题数与总分;任一题目分值变化后同步更新 |
核心弹窗与状态反馈
| 名称 | 触发条件 | 主要内容 | 按钮/结果 |
|---|---|---|---|
| 退出保存确认弹窗 | 点击“退出”或“返回选题”且存在未保存调整 | 提示是否保存当前排版信息 | 支持“保存后离开”“不保存离开”“取消返回编辑” |
| 未分配题目提示弹窗 | 点击“完成”时暂存区仍有题目 | 提示仍有 {N} 道题未放入目录/大题 | 支持“返回分配”“跳过并继续” |
| PDF生成中弹窗/遮罩 | 通过生成前校验后 | 展示“正在生成作业PDF”状态,禁止重复点击 | 生成成功后自动关闭并跳转;失败后关闭并返回当前页 |
| Toast反馈 | 保存草稿、生成失败、局部校验失败等场景 | 展示轻量提示文案 | 3秒左右自动消失;失败文案需可理解 |
PDF生成前校验
| 校验项 | 规则 |
|---|---|
| 题目数量 | 试卷内题目数必须≥1,否则不可生成 |
| 必填内容 | 已编辑题目的题干、正确答案等必填字段不能为空 |
| 大题结构 | 至少存在1个大题,且每个大题下至少有1道题 |
| 分值合法性 | 所有题目分值必须>0,不允许出现空值、0分或负分 |
| 未分配题目 | 暂存区存在未分配题目时,需弹窗提示“返回分配”或“跳过并继续” |
| 预览可渲染 | 当前版面必须能够成功生成预览页;渲染异常时禁止进入发布页 |
| 重复点击保护 | 生成过程中“完成”按钮禁用,并展示生成中遮罩或进度提示 |
暂存与退出规则
- 教师主动点击“保存草稿”时,仅保存当前题篮结构、目录、题序、分值、答题区留白与版面配置,且草稿仅本人可见。
- 点击“退出”或“返回选题”时,必须弹出“是否保存排版信息”确认弹窗,至少包含“保存后离开”“不保存离开”两条出口。
- 若教师返回资源中心增删题,恢复组卷页时默认保留既有目录与排版结果;新增题目进入未分配题目暂存区,已删除题目从排版结构中剔除。
- 若题篮结构变化影响原分页或分组,需提示教师“部分排版需重新确认”,但不主动清空全部已编排结果。
- 题目编辑全屏页点击“确定”后才写回组卷工作台;点击“取消”则放弃本次未确认修改,不自动落盘。
数据持久化与上下文保留
| 数据对象 | 保存内容 | 保存时机 | 说明 |
|---|---|---|---|
| 组卷草稿 | 题篮快照、目录结构、题序、题目分值、答题留白、说明内容、版面参数 | 手动保存草稿、退出前选择保存 | 用于教师本人恢复未完成的组卷工作 |
| 排版参数 | 各题答题区高度、页面局部留白、版面布局参数 | 点击“完成”生成PDF时提交 | 作为正式PDF渲染的确切参数,不可在发布页再修改 |
| 隐式定位信息 | 题目在A4画布中的布局坐标、分页信息 | 生成预览与生成PDF时计算 | 主要供预览联动、后续识别定位和打印一致性使用,前端不直接展示 |
| 发布上下文 | 标题、备注、班级、当前预览页位置 | 从发布页返回组卷页时暂存 | 供二次编辑完成后恢复到发布页 |
生成结果与跳转
- PDF生成成功后,系统需产出可预览的PDF结果并回填到发布页,供教师继续填写标题、班级、备注等发布信息。
- 生成成功前,不得提前创建“已发布作业”实体;组卷结果仍处于临时编辑态。
- 若教师从发布页返回组卷工作台继续修改,需保留上一次发布页已填写的上下文信息,供再次返回发布页时恢复。
异步、空态与错误态
| 场景 | 页面反馈 |
|---|---|
| 首次进入组卷页加载中 | 左侧大纲、中间画布、右侧属性面板展示骨架态;顶部操作保留但“完成”不可点击 |
| 暂存区为空 | 展示“暂无未分配题目”文案,不展示错误态 |
| 画布预览刷新中 | 当前页展示轻量刷新反馈,避免整页闪烁 |
| 保存草稿失败 | Toast提示失败原因,页面保留当前编辑状态,支持再次保存 |
| PDF生成失败 | 关闭生成中弹窗,Toast提示“PDF生成失败,请检查网络后重试”,按钮恢复可点击 |
业务规则引用
- R02:作业篮为当前学科下的全局共享容器,组卷页需承接资源中心的题篮结果并处理增删题后的结构同步。
- R03:组卷工作台支持保存组卷草稿,且与发布页上下文暂存共同构成中断恢复能力。
- R04:组卷页生成的PDF预览结果,是发布页满足“题目数≥1、PDF预览可用”前提的上游输入。
3.4 发布作业
3.4.1 前置
(选填项)
- 教师已在组卷工作台完成组卷。
- 系统已成功生成PDF并回填预览信息。
3.4.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 发布作业 | 页面名称:发布作业。 功能目的:承接组卷工作台的输出结果,作为教师正式布置前的“最终确认页”,以最短链路完成三件事:核对当前PDF卷面、确认发布对象、提交发布任务。本页不承担题目结构调整职责,所有卷面内容修改都必须回到组卷工作台完成。 操作流程:教师从组卷工作台进入发布页 -> 系统加载最新 PAPER_SNAPSHOT 并渲染左侧连续PDF预览 -> 右侧展示作业概览和发布表单 -> 教师核对题量/分值/页数/题型分布/卷面ID码 -> 填写或修正作业标题 -> 按年级分组选择发布班级 -> 选填作业备注 -> 若发现卷面需调整,点击“编辑试卷”返回组卷工作台,系统先暂存当前发布上下文 -> 教师完成调整并重新生成PDF -> 再次回到发布页后恢复标题、班级、备注和预览页位置 -> 教师点击“立即发布” -> 系统执行全量校验与发布事务 -> 发布成功后Toast提示并返回作业列表,最新作业高亮展示。字段/规则/状态说明: 1. 页面采用沉浸式双栏布局:左侧为PDF连续预览区,右侧为发布信息区,底部固定“立即发布”主按钮,顶部提供“退出”入口。 2. 预览区必须展示连续页内容、快捷翻页、当前页码、总页数、总题数、总分、题型分布、卷面ID码;这些信息均来源于组卷工作台生成结果,只读展示,不允许在本页编辑。 3. 右侧发布信息区包含“作业概览”“作业标题”“班级选择”“作业备注”四个核心区域;当前版本仅保留发布最小必要字段,不新增截止时间、作答时长、允许补交等高级配置,优先保证教师布置链路最短。 4. 作业标题默认回填当前试卷标题;教师可在发布页修改“作业任务标题”,但该修改只影响作业列表、学生端任务标题、报告页标题等任务元信息,不反向改写已生成的PDF卷面标题。若需修改卷面标题本身,必须返回组卷工作台重新生成。 5. 班级选择器按年级折叠分组展示,支持展开/收起、单班勾选、年级全选/取消全选和已选数量反馈;仅展示当前教师权限范围内可发布的班级。 6. 作业类型影响班级选择策略:个性化作业允许多班发布;纸质教辅作业仅允许单班发布,不允许跨班共享同一条发布任务。 7. 作业备注为选填补充说明,不参与卷面内容生成,仅用于教师端列表、学生端任务详情和报告页基础信息展示。 8. 发布页与组卷工作台之间必须支持“带上下文返回”:教师点击“编辑试卷”时,系统暂存标题、备注、已选班级和当前预览页位置;从组卷工作台重新进入时优先恢复这些信息。 9. 发布前必须同时满足:标题有效、班级有效、题目数≥1、PDF预览可用、当前教师对所选班级有发布权限;任一条件不满足都必须阻断提交并给出明确反馈。 10. 发布成功后,系统需将作业状态初始化为“待提交”,按作业-班级维度生成执行关系,供后续学生提交、教师批改、作业报告消费。 异常与边界: 1. 必填项缺失时,需在对应字段区域展示红框和错误文案,页面滚动定位到首个错误项,且不清空教师已填写的其他内容。 2. 若PDF不存在、失效、重新生成中或预览加载失败,则“立即发布”不可执行,页面需明确提示教师返回组卷工作台重新生成。 3. 发布过程中若网络超时、接口失败或服务端返回幂等冲突,页面需完整保留标题、备注、班级和当前预览页位置,允许教师直接重试。 4. 未正式发布前,点击顶部“退出”属于放弃当前发布动作,必须二次确认;确认退出后不自动落库,也不应在作业列表生成新记录。 5. 若教师恢复发布上下文时发现班级权限已变更、班级被停用或学生人数口径已更新,系统需剔除失效班级并提示教师重新确认。 6. 若教师在返回组卷页后对题目结构、分值或分页进行了修改,返回发布页时必须以最新 PAPER_SNAPSHOT 覆盖旧预览,避免教师对旧卷面误发布。 | 【待补充:t_publish 页面截图】 |
3.4.3 补充规格
页面布局与区域职责
| 区域 | 布局/展示条件 | 规格 |
|---|---|---|
| 顶部栏 | 常驻展示 | 左侧展示“退出”“页面标题”,右侧展示当前教师身份信息;“退出”不是返回上一步,而是离开当前发布动作 |
| 左侧PDF预览区 | 页面成功加载 PAPER_SNAPSHOT 后展示 | 占页面主宽度,采用纵向连续滚动预览;每页展示班级/姓名/考号填写区、卷面条码/作业码、题目内容、作答区、页脚页码 |
| 左侧工具区 | 预览区常驻展示 | 提供快捷分页、上一页/下一页、首页/末页与页码输入跳转;输入非法页码时仅提示,不改变当前页 |
| 右侧发布信息区 | 常驻展示 | 按“作业概览 -> 作业标题 -> 选择班级 -> 作业备注”顺序排列,保证教师在一屏内完成信息确认与填写 |
| 底部固定操作区 | 常驻展示 | 仅保留“立即发布”一个主按钮,避免额外决策干扰主链路;提交中需锁定按钮状态 |
页面状态枚举
| 状态 | 触发条件 | 页面表现 | 可执行动作 |
|---|---|---|---|
| 预览加载中 | 从组卷工作台首次进入或重新进入发布页 | 左侧显示PDF加载骨架/占位;右侧表单可延后渲染或先展示基础框架 | 不允许发布;允许等待加载完成 |
| 可发布待确认 | PDF可用且页面完成初始化 | 左侧展示连续预览;右侧展示概览与表单;底部展示“立即发布” | 可编辑标题、选择班级、填写备注、编辑试卷、退出 |
| 字段校验失败 | 点击“立即发布”但存在必填缺失或无效值 | 首个错误项高亮,页面滚动定位;底部按钮恢复初始态 | 可继续修改字段并再次发布 |
| 预览失效/不可发布 | PDF不存在、失效、生成失败或当前试卷题数为0 | 页面顶部或预览区展示错误说明;“立即发布”禁用 | 仅允许返回组卷工作台重新生成或退出 |
| 发布中 | 点击“立即发布”且通过前置校验 | “立即发布”按钮置灰并展示“发布中…”;禁止重复提交 | 不允许再次提交;原则上不建议中断 |
| 发布成功回跳 | 服务端落库成功 | Toast提示“发布成功,即将跳转至作业中心…”;2秒内自动跳转列表页 | 无需额外操作 |
| 发布失败可重试 | 网络超时、接口错误、服务端拒绝 | 保留表单内容与预览页位置;展示失败原因摘要与重试入口 | 可重试发布、编辑试卷或退出 |
| 无可发布班级 | 当前教师无权限班级或全部班级不可用 | 班级区展示空态/权限态说明;“立即发布”禁用 | 仅允许退出或等待权限修复 |
作业概览与预览信息
| 模块 | 展示内容 | 规则 |
|---|---|---|
| 作业概览卡 | 总题数、总分、总页数 | 数据来自当前 PAPER_SNAPSHOT,只读展示,作为发布前快速复核信息 |
| 题型分布 | 如“选择题×5、填空题×3、解答题×3” | 按试卷题型聚合展示,用于教师快速判断卷面结构是否正确 |
| 卷面ID码 | 条码/作业码文本 | 作为后续提交识别、回收与追溯依据,发布页仅展示不允许编辑 |
| 连续页预览 | 每页卷面内容、页眉、作答区、页脚页码 | 预览结果必须与最终提供给学生作答/打印的PDF一致 |
| 快捷翻页 | 首页、上一页、当前页附近页码、下一页、末页、手动输入页码 | 页码按钮需随当前页动态刷新;输入页码范围为 1~总页数 |
表单字段
| 字段 | 控件类型 | 默认值/回填策略 | 校验规则 | 业务影响 |
|---|---|---|---|---|
| 作业标题 | Input | 默认带入当前试卷标题;若存在发布上下文暂存,则优先恢复暂存值 | 最长50字;去除首尾空格后不能为空;不允许仅空格 | 影响作业列表、学生端任务标题、报告页标题;不改写已生成PDF标题 |
| 选择班级 | 按年级分组的选择器 | 首次进入默认空;若从“编辑试卷”返回,则恢复上次已选班级 | 至少选择1个有效班级;仅可选择当前教师权限内班级;纸质教辅作业仅允许单选 | 决定发布对象范围,并决定后续 HOMEWORK_CLASS 执行关系和人数口径 |
| 作业备注 | Textarea | 默认空;存在发布上下文时恢复暂存值 | 最长200字;超过限制不允许继续输入;显示实时字数统计 | 影响学生端任务补充说明、报告页基础信息,不影响PDF卷面 |
班级选择器交互规则
| 动作 | 展示条件 | 交互结果 | 备注 |
|---|---|---|---|
| 展开/收起年级分组 | 班级按年级分组展示时常驻可用 | 点击年级头部可折叠或展开该分组 | 折叠仅影响展示,不影响已选值 |
| 年级全选 | 个性化作业且该年级下存在可选班级时展示 | 勾选该年级下全部班级;再次点击变为取消全选 | 需实时显示“全选/取消全选/已选 X/Y”状态 |
| 单班勾选 | 常驻可用 | 勾选或取消单个班级 | 纸质教辅作业场景下,勾选新班级时需取消旧班级 |
| 权限过滤 | 页面初始化或恢复上下文时执行 | 自动过滤无权限班级、停用班级、已失效班级 | 若过滤后无有效班级,页面进入“无可发布班级”状态 |
| 错误清除 | 班级区存在红框校验态时执行 | 教师完成任意有效勾选后,班级字段错误态即时清除 | 减少重复点击“发布”造成的挫败感 |
按钮与动作规格
| 操作 | 展示条件 | 点击后行为 | 状态约束 |
|---|---|---|---|
| 退出 | 常驻展示 | 打开退出确认弹窗 | 发布中不建议可点;若允许点击,必须二次确认 |
| 编辑试卷 | 常驻展示 | 先保存发布上下文,再返回组卷工作台 | 不创建作业记录;返回后需恢复上下文 |
| 立即发布 | 常驻展示 | 先执行全量校验,通过后发起发布事务 | 校验失败不提交;提交中按钮置灰并展示“发布中…” |
| 快捷页码按钮 | 总页数≥1时展示 | 跳转对应预览页并更新当前页状态 | 非法页码不可跳转 |
| 页码输入前往 | 快捷翻页区常驻展示 | 输入页码后直接定位到对应页 | 超范围时在输入区下方提示“请输入 1~N 页之间的页码” |
发布校验矩阵
| 校验项 | 触发时机 | 规则 | 反馈方式 | 失败后处理 |
|---|---|---|---|---|
| 作业标题必填 | 点击“立即发布” | 去除首尾空格后不能为空 | 标题输入框红框 + “请填写作业标题” | 阻断提交,焦点回到标题区 |
| 班级必填 | 点击“立即发布” | 至少选择1个有效班级 | 班级区域红框 + “请至少选择一个班级” | 阻断提交,滚动定位到班级区 |
| 班级有效性 | 点击“立即发布”或恢复上下文后 | 所选班级必须均在当前教师权限范围内且处于可发布状态 | 班级区顶部提示失效班级已移除 | 阻断提交或要求重新确认 |
| 单班约束 | 纸质教辅作业点击发布时 | 只能存在1个已选班级 | 就地提示“纸质教辅作业仅支持发布到1个班级” | 保留最近一次有效选择 |
| 题目数校验 | 点击“立即发布” | 当前试卷题目数必须≥1 | 页面顶部错误提示 | 禁止发布,返回组卷工作台修正 |
| PDF可用性 | 点击“立即发布” | PAPER_SNAPSHOT 必须存在且预览可访问 | 预览区或页面顶部错误提示 | 禁止发布,提供“编辑试卷”入口 |
| 重复点击保护 | 发布事务发起后 | 同一前端页面不可重复发起发布请求 | 按钮置灰 + 文案改为“发布中…” | 等待结果返回 |
暂存、恢复与清理规则
- 发布上下文的暂存内容至少包括:作业标题、作业备注、已选班级ID集合、当前预览页位置。
- 点击“编辑试卷”返回组卷工作台时,必须立即写入发布上下文暂存,确保教师往返修改时不重复录入。
- 从组卷工作台再次进入发布页时,系统优先恢复暂存的标题、备注、已选班级和预览页位置,再加载最新PDF预览。
- 若组卷页重新生成了新版本PDF,则恢复上下文时只能复用表单内容和页位置语义,不能继续展示旧版PDF内容。
- 点击“退出”并确认离开时,系统清空发布上下文,不保留未发布内容。
- 发布成功后,系统也必须清空发布上下文,避免教师下一次新建作业时串用旧数据。
- 暂存范围仅对当前教师本人、当前浏览器会话有效,不自动生成独立草稿作业。
弹窗与反馈规格
| 组件 | 触发条件 | 标题/文案 | 按钮 | 行为 |
|---|---|---|---|---|
| 退出确认弹窗 | 教师点击顶部“退出” | 标题:“确认退出发布页?”;正文:明确告知当前填写的作业标题、班级选择、作业备注不会自动保存 | “取消”“确认退出” | 取消则关闭弹窗;确认退出则清空发布上下文并返回作业列表 |
| 发布成功Toast | 发布事务成功 | 文案:“发布成功,即将跳转至作业中心…” | 无 | 2秒后自动跳转作业列表,并高亮最新发布作业 |
| 发布失败提示 | 发布事务失败 | 展示失败原因摘要,如网络超时、服务异常、班级失效等 | “重试发布”或“编辑试卷” | 不清空页面内容,允许教师自行决定下一步 |
发布事务与数据落库
- 前端提交发布请求时,携带当前
PAPER_SNAPSHOT标识、作业标题、备注、班级列表和发布人身份信息。 - 服务端发布成功时,创建
HOMEWORK主记录,至少写入:homework_id、paper_id、publisher_id、title、remark、publish_at、status=WAIT_SUBMIT。 - 服务端按所选班级创建
HOMEWORK_CLASS关系记录,固化班级范围、班级名称快照和应提交人数口径,避免后续班级结构变化直接污染历史作业统计。 - 发布成功的作业必须引用当前版本
PAPER_SNAPSHOT,确保后续打印、提交识别、批改和报告分析都基于同一份卷面快照。 - 发布成功前,不得提前写入“已发布作业”可见记录;发布失败也不得生成半成品任务。
- 发布成功后,作业列表中该作业初始聚合状态为“待提交”,后续再根据学生提交和教师批改结果流转到其他状态。
失败与边界处理
| 场景 | 处理规则 |
|---|---|
| 标题为空或仅空格 | 标题区红框提示,焦点回到输入框,不清空其他已填字段 |
| 未选择班级 | 班级区红框提示,并滚动定位到班级选择器 |
| 预览页码输入非法 | 在快捷翻页区下方提示错误;保留当前页,不触发跳转 |
| PDF不存在、失效或加载失败 | 页面进入不可发布状态;“立即发布”禁用;教师只能返回组卷工作台重新生成 |
| 恢复上下文后部分班级失效 | 自动剔除失效班级并提示教师重新确认;若剩余有效班级为0,则禁止发布 |
| 返回组卷页后卷面结构变化 | 保留标题、备注、班级,但必须以最新PDF预览替换旧预览,避免误发布旧卷面 |
| 发布接口失败或弱网超时 | 保留当前表单内容与预览页位置;按钮恢复可点击;允许重试发布 |
| 连续重复点击提交 | 前端通过按钮置灰拦截重复点击;服务端按同一发布请求做幂等保护 |
| 教师主动退出 | 必须通过退出确认弹窗二次确认;确认后不生成任何作业记录 |
页面入口、回退与初始化时序
| 场景 | 入口条件 | 系统初始化动作 | 教师可感知结果 |
|---|---|---|---|
| 首次从组卷工作台进入发布页 | 教师点击“完成”,且组卷页已成功生成最新 PAPER_SNAPSHOT | 拉取当前试卷快照、初始化预览页为第1页、加载班级权限范围、回填默认标题 | 页面进入“可发布待确认”状态 |
| 从“编辑试卷”返回发布页 | 当前教师存在发布上下文暂存 | 优先恢复标题、备注、班级、预览页位置,再用最新 PAPER_SNAPSHOT 覆盖旧预览 | 教师无需重复录入,只需核对卷面是否变化 |
| 无快照直达发布页 | 缺少合法 paper_snapshot_id 或快照已失效 | 不进入正常表单态,直接展示不可发布说明 | 仅允许返回组卷工作台重新生成 |
| 页面刷新后重进 | 当前浏览器会话仍保有有效发布上下文与快照引用 | 先校验快照与班级权限,再恢复表单字段 | 合法则恢复现场,非法则提示重新确认 |
- 页面初始化顺序必须固定为:校验
PAPER_SNAPSHOT有效性 -> 加载教师可发布班级 -> 恢复发布上下文 -> 渲染 PDF 预览与右侧表单。 - 若快照可用但班级接口加载失败,页面不得默认允许发布,而应进入“部分数据加载失败”状态并提供重试。
- 若发布上下文与最新快照不一致,系统以最新快照为准,仅复用不影响卷面正确性的表单字段。
- 发布页不是可独立长期保存的草稿页,任何初始化恢复都基于“临时上下文”而不是“已发布作业”。
概览字段口径定义
| 字段 | 数据来源 | 展示形式 | 口径说明 |
|---|---|---|---|
| 总题数 | PAPER_SNAPSHOT.question_count | 数字只读 | 统计进入当前卷面的有效题目,不含已删除题 |
| 总分 | PAPER_SNAPSHOT.total_score | 数字只读 | 按教师在组卷页确认后的最新题目分值汇总 |
| 总页数 | PAPER_SNAPSHOT.page_count | 数字只读 | 以最终可发布PDF实际页数为准 |
| 题型分布 | PAPER_SNAPSHOT.question_type_summary | 文本标签或列表 | 如“选择题 5 题 / 解答题 3 题”,用于快速核对卷面结构 |
| 卷面ID码 | PAPER_SNAPSHOT.paper_code | 条码图形 + 文本 | 后续供提交识别、回收和追溯使用,发布页仅展示 |
| 当前预览页 | 本地页面状态 | 页码高亮 | 仅影响浏览定位,不影响发布结果 |
权限、可见性与禁用规则
| 对象/操作 | 权限规则 | 前端表现 | 服务端要求 |
|---|---|---|---|
| 班级列表可见范围 | 仅展示当前教师具备发布权限的班级 | 无权限班级不进入可选列表 | 服务端二次校验班级归属与教师权限 |
| 停用班级/失效班级 | 不允许继续作为有效目标班级 | 恢复上下文时自动剔除并提示 | 服务端拒绝失效班级写入发布关系 |
| 个性化作业多班发布 | 允许同一作业一次发布多个班级 | 年级全选、批量勾选能力可用 | 一次请求内创建多条 HOMEWORK_CLASS |
| 纸质教辅作业发布 | 仅允许单班发布 | 班级选择器自动转为单选逻辑 | 服务端校验班级数量必须为1 |
| 立即发布按钮 | 仅在标题、班级、PDF、权限均合法时可执行 | 条件不满足时保持禁用或点击后拦截 | 拒绝任何绕过前端校验的非法请求 |
- 前端的禁用态仅用于减少误操作,不能替代服务端权限和参数校验。
- 若教师权限在页面停留期间发生变化,以提交时的实时权限校验结果为准。
- 班级名称、所属年级、应提交人数必须在发布时固化快照,避免后续组织架构变化影响历史作业。
发布事务时序与幂等要求
| 阶段 | 系统动作 | 成功结果 | 失败处理 |
|---|---|---|---|
| 提交前校验 | 校验标题、班级、快照、权限、单班/多班约束 | 允许进入发布中 | 任一失败即阻断,不写入任何发布记录 |
| 创建作业主记录 | 写入 HOMEWORK 主实体 | 返回 homework_id | 回滚事务,不生成半成品作业 |
| 创建班级关系 | 按班级写入 HOMEWORK_CLASS | 固化目标班级范围 | 任一失败则整单失败并回滚 |
| 建立后续消费引用 | 绑定 PAPER_SNAPSHOT、统计口径、发布人信息 | 后续提交/批改/报告使用同一快照 | 失败则整单失败并回滚 |
| 返回发布结果 | 返回成功态、列表跳转所需信息 | 前端展示成功并跳转 | 返回明确失败原因并允许重试 |
- 发布接口必须支持幂等控制,建议以前端生成的
publish_request_id或服务端会话令牌作为幂等键,避免弱网重试造成重复发布。 - 同一
PAPER_SNAPSHOT在“纸质教辅单班发布”场景下,若教师短时间内重复提交同一班级,服务端需识别重复意图并返回已存在结果或明确冲突提示。 - 事务成功判定标准不是“接口返回200”,而是
HOMEWORK、HOMEWORK_CLASS和快照绑定全部落库成功。 - 发布成功后再清理前端上下文;发布失败时严禁提前清空,防止教师重复录入。
数据对象与字段要求
| 对象 | 核心字段 | 用途 | 备注 |
|---|---|---|---|
PAPER_SNAPSHOT | paper_snapshot_id、paper_id、page_count、question_count、total_score、paper_code | 作为发布前卷面唯一依据 | 发布后需与作业记录强绑定 |
HOMEWORK | homework_id、paper_snapshot_id、title、remark、publisher_id、publish_at、status | 记录一次作业发布主体 | 初始状态固定为 WAIT_SUBMIT |
HOMEWORK_CLASS | homework_class_id、homework_id、class_id、class_name_snapshot、grade_name_snapshot、expected_submit_count | 记录发布对象范围 | 统计按作业-班级维度展开 |
PUBLISH_CONTEXT_CACHE | title、remark、selected_class_ids、current_page、snapshot_ref | 支撑临时恢复 | 仅当前教师、当前会话有效 |
HOMEWORK.title与 PDF 内标题允许不一致,这是“任务标题”和“卷面标题”的有意分离。remark为弱结构化补充字段,不参与后续批改识别,但会影响学生端任务说明展示。expected_submit_count应在发布时按班级有效学生人数快照计算,不在查看列表时实时反推。
页面反馈、弱网与可恢复性要求
| 场景 | 交互反馈 | 恢复策略 |
|---|---|---|
| 预览加载较慢 | 左侧骨架屏 + 页数占位,右侧基础表单框架先渲染 | 预览成功后再解除发布按钮限制 |
| 班级数据加载失败 | 班级区局部错误态 + 重试按钮 | 重试成功前禁止发布 |
| 发布请求超时 | 顶部或按钮附近提示“发布请求超时,请确认结果后重试” | 先查询本次幂等键结果,再决定是否允许再次提交 |
| 跳转列表失败 | 保留当前成功提示并提供“返回作业列表”按钮 | 不影响已完成发布结果 |
| 浏览器意外关闭后重开 | 若会话上下文仍在且快照有效,则恢复现场 | 否则提示重新进入组卷工作台生成 |
- 所有失败提示都必须告诉教师“下一步该做什么”,不能只给技术性报错。
- 发布页必须优先保证“填写内容不丢”,其次才是瞬时反馈样式完整。
- 在大班额场景下,班级树与人数口径的加载不得阻塞整页超过可接受阈值,必要时采用分段加载并先保障当前年级可用。
埋点与分析要求
| 埋点事件 | 触发时机 | 关键参数 | 用途 |
|---|---|---|---|
publish_page_view | 发布页首屏完成渲染 | 入口来源、paper_snapshot_id、题目数、页数 | 统计发布页到达率与来源结构 |
publish_edit_back_click | 点击“编辑试卷” | 当前已填标题长度、已选班级数、当前预览页 | 识别发布前回退原因与频次 |
publish_class_select_change | 班级选择发生变化 | 选择动作类型、班级数、年级数、作业类型 | 分析班级选择复杂度 |
publish_submit_click | 点击“立即发布” | 标题是否有效、班级数、快照状态、入口来源 | 识别提交前阻断率 |
publish_submit_result | 发布接口返回结果 | 成功/失败、失败原因、耗时、班级数 | 监控成功率与性能 |
publish_exit_confirm | 点击退出并二次确认 | 是否已填写标题、是否已选班级、是否有备注 | 识别主动放弃场景 |
- 所有埋点都应携带
teacher_id、入口来源和作业类型,便于区分个性化作业与纸质教辅作业的发布行为差异。 publish_submit_result需区分“前端校验失败未发请求”和“服务端请求失败”两类失败口径。- 若后续发现教师大量在发布页返回组卷页,应反向推动优化组卷工作台的完成前检查与预览能力。
业务规则引用
- R01:个性化作业与纸质教辅作业在班级选择策略上不同,发布页必须体现多班/单班差异。
- R03:发布页支持“发布上下文暂存”,并与组卷草稿共同构成中断恢复能力。
- R04:发布前必须满足标题必填、至少选择一个班级、题目数≥1、PDF预览可用。
- R05:发布成功后作业进入“待提交”状态,并按作业-班级维度生成执行记录。
3.5 批改
3.5.1 前置
- 当前作业至少存在 1 名学生的有效提交记录;作业整体状态为“待批改”或“已批改但允许再次进入修正”。
- 教师从作业列表点击“批改作业”进入批改页,系统需携带
homework_id、当前班级范围、最近一次批改定位信息。 - 系统已完成以下基础数据预加载:
- 作业基础信息:作业标题、班级、发布时间、作业备注、关联
PAPER_SNAPSHOT。 - 学生队列信息:学生名单、提交状态、提交时间、当前批改状态、是否存在 AI 结果。
- 当前学生数据:原卷图片/答题卡、题目结构、标准答案、题目满分、历史教师保存结果、AI 建议结果、提交记录版本列表。
- 作业基础信息:作业标题、班级、发布时间、作业备注、关联
- 当前登录教师具备该作业的查看与批改权限;若无权限,则不允许进入批改页。
- 批改页默认以“教师最终确认”为核心目标,不以 AI 自动完成为目标;AI 仅作为辅助能力存在。
3.5.2 说明
| 页面 | 说明 | 原型图 |
|---|---|---|
| 批改 | 页面名称:批改。 功能目的:承接教师 Web 主批改台能力,帮助教师围绕“单个学生答卷”完成原卷查看、提交记录追溯、逐题判分、AI 建议复核、结果保存与连续切换下一位学生的高频批改闭环。该页面的核心不是展示 AI 自动结果,而是让教师以最低操作成本完成最终成绩确认。 页面入口:教师从作业列表点击“批改作业”进入;如后续支持从作业报告回流继续批改,也必须复用同一页面与同一套规则。 默认落点规则: 1. 优先定位最近一次已保存但仍未完成整份作业批改的学生。 2. 若不存在上述学生,则定位当前作业下第一位“已提交且未完成教师最终确认”的学生。 3. 若所有已提交学生均已批改完成,则默认定位最近一次保存的学生,并以“复核模式”展示。 操作流程:教师进入批改页 -> 系统加载当前学生原卷、题目结构、历史提交记录与 AI 状态 -> 教师在左侧查看原卷、在中间逐题判分、在右侧切换学生 -> 如有需要,手动触发 AI 辅助批改获取建议值 -> 教师采纳、调整或忽略 AI 建议 -> 点击“保存批改”写入当前学生最终结果 -> 系统自动更新学生队列状态与作业整体批改进度 -> 教师继续批改下一位学生;当全部学生完成后,可进入作业报告页。 页面结构: 1. 顶部公共区:展示作业标题、当前班级/学生、批改进度、返回列表入口、上一位/下一位快捷切换。 2. 左侧原卷区:展示当前学生原卷、页码导航、缩放、适配宽度、查看提交记录入口,并支持在多次提交记录之间切换。 3. 中间判分区:按大题/小题展开题目,展示题干摘要、标准答案、学生答案、AI 建议、判定控件、得分控件、教师备注。 4. 右侧学生队列:展示当前作业全部学生、提交时间、批改状态、AI 状态、异常标记,并支持按状态快速定位。 批改原则: 1. 页面始终以“学生最终有效提交记录 + 可追溯历史提交记录”作为批改依据,不允许只看单次最新图片后覆盖历史。 2. 教师必须对当前学生所有纳入计分的题目完成判分后,才可保存最终结果。 3. AI 只能生成建议结果,不能直接替代教师保存最终成绩。 4. 教师保存后的结果会即时回流作业统计、学生端结果页和报告页相关口径。 高频效率设计: 1. 支持“一键全对”“按题组批量判分”“上一位/下一位学生连续处理”。 2. 支持在不离开页面的前提下切换学生与查看提交记录,减少教师反复返回列表。 3. 对 AI 低置信度、图片异常、识别不完整等高风险场景显式打标,优先把教师注意力拉回人工复核。 异常与边界: 1. 原卷加载失败时,不阻断右侧队列浏览,但必须将当前学生标记为“提交异常”,并提供重试。 2. AI 返回失败、超时、结构不完整时,明确提示“请改为人工批改”,且不得污染已保存成绩。 3. 教师切换学生、返回列表、关闭页面时,如存在未保存改动,必须二次确认。 4. 当全部学生均无待批改数据时,页面展示完成态,并给出“返回作业列表”“查看作业报告”两个出口。 | 【待补充:t_grading 页面截图】 |
3.5.3 补充规格
页面入口与默认定位
| 项目 | 规格 |
|---|---|
| 页面入口 | 作业列表中的“批改作业”按钮;仅当当前作业至少存在 1 名已提交学生时展示 |
| 入参 | homework_id、教师身份、当前筛选班级口径、可选 student_id |
| 默认定位优先级 | 最近一次未完成批改的学生 > 第一位待批改学生 > 最近一次已保存学生 |
| 返回出口 | 返回作业列表;若全部学生已批改完成,则增加“查看作业报告”主出口 |
| 页面刷新策略 | 刷新后按最近一次已保存结果重建页面;未保存的本地改动不承诺跨刷新恢复 |
顶部公共区
| 区域 | 规格 |
|---|---|
| 面包屑/返回区 | 展示“作业列表 / 批改”;点击返回时若存在未保存改动,先弹离开确认 |
| 作业信息区 | 展示作业标题、当前班级、当前学生姓名、提交时间、当前批改进度(如 12/45) |
| 快捷切换区 | 提供“上一位”“下一位”按钮;若目标学生不可批改,按钮置灰并提示原因 |
| 进度提示区 | 展示当前作业下待批改人数、已批改人数、异常人数;数据随保存实时刷新 |
| 快捷动作区 | 提供“查看提交记录”“保存批改”;当全部学生完成后可展示“查看作业报告” |
页面结构
| 区域 | 规格 |
|---|---|
| 左侧原卷区 | 展示当前学生原卷图片;支持页码切换、缩放、适配宽度、查看原图;当同一学生存在多次提交记录时,支持切换记录版本并同步刷新原卷 |
| 中间题目判分区 | 按大题/小题展示题目内容、题型、满分、学生答案、标准答案、AI建议、分数控件、判分控件、教师备注;支持按题组折叠/展开 |
| 右侧学生队列 | 展示当前作业下学生列表、提交时间、提交状态、批改状态、AI状态、异常标记;支持切换学生、快速定位待批改学生 |
左侧原卷区详细规则
| 项目 | 规格 |
|---|---|
| 默认内容 | 默认展示当前学生“最新有效提交记录”的第一页 |
| 页码导航 | 支持上一页、下一页、页码直接输入;非法页码不跳转并提示 |
| 缩放能力 | 支持放大、缩小、适配宽度、100% 原始比例 |
| 题目定位 | 教师点击中间题目区某一小题时,若存在题目坐标信息,左侧原卷自动定位对应区域 |
| 提交记录切换 | 通过“查看提交记录”打开侧滑/弹层,按提交时间倒序展示版本;切换版本后,中间区域需同步提示“当前查看的是第 N 次提交记录” |
| 加载失败 | 仅当前原卷区展示错误态,不影响教师查看学生队列与题目结构;支持重试 |
中间题目判分区详细规则
| 项目 | 规格 |
|---|---|
| 展示顺序 | 与 PAPER_SNAPSHOT 中题目顺序保持一致,不允许前端重排导致题序错乱 |
| 题目颗粒度 | 至少精确到可独立判分的小题;如题目仅支持按大题判分,则由配置决定隐藏子题级输入控件 |
| 信息项 | 每题至少展示:题号、题型、满分、学生答案/作答摘要、标准答案、AI建议、教师最终得分 |
| 判定方式 | 支持“对/半对/错”快速判定;若题目配置不支持“半对”,则不展示该选项 |
| 分数输入 | 支持步进调整与直接输入;输入值必须 >=0 且 <=题目满分 |
| 一键全对 | 支持对当前题组或当前学生所有未判题目一键置为满分;已人工修改过的题目需二次确认是否覆盖 |
| 教师备注 | 可对当前学生填写整体批改说明;该备注与题目分数一并保存 |
| 必填校验 | 只要存在未判题目、非法分数、异常必填项未补齐,保存按钮不可进入成功态 |
右侧学生队列规格
| 项目 | 规格 |
|---|---|
| 排序规则 | 默认按“待处理优先、提交时间次序、姓名”排序;优先把可立即批改的学生排在前面 |
| 学生项展示 | 学生姓名、提交时间、提交记录数、批改状态、AI状态、异常标记 |
| 状态筛选 | 支持筛选:全部、待批改、待复核、已批改、提交异常 |
| 切换规则 | 点击其他学生时,如当前学生存在未保存改动,先弹确认;确认放弃后才允许切换 |
| 完成引导 | 当前学生保存成功后,默认自动定位下一位“待批改/待复核”学生;若不存在,则停留当前页并提示已完成 |
学生级批改状态定义
| 状态 | 定义 | 页面表现 | 可执行动作 |
|---|---|---|---|
| 待批改 | 学生已提交,但尚无教师最终确认结果 | 队列默认高亮待处理标签 | 进入批改、触发AI、查看提交记录 |
| AI处理中 | 已触发 AI 任务,但建议结果尚未返回 | 显示处理中状态与轮询中提示 | 继续人工批改、刷新AI状态 |
| 待复核 | AI 返回低置信度/结构异常,或系统识别出提交异常需教师重点确认 | 显示风险标签 | 人工复核、忽略AI、重新触发AI |
| 已批改 | 当前学生所有纳入计分题目已由教师保存确认 | 显示完成标签 | 查看详情、再次修正并重新保存 |
| 提交异常 | 原卷缺页、图片损坏、答案结构无法解析等导致无法稳定辅助判分 | 显示异常标签 | 查看异常说明、人工批改、重试加载 |
教师操作
| 操作 | 说明 |
|---|---|
| 一键全对 | 快速将当前题组或当前学生全部未判题目置为满分;若会覆盖已有人工结果,必须二次确认 |
| 单题判对错 | 支持“对/半对/错”三态;选择后自动带出对应建议分值,但教师仍可继续改分 |
| 手动改分 | 支持步进与直接输入分数;越界时即时红字提示,不允许保存 |
| 填写评语 | 支持教师填写当前学生整体批改说明或评价,作为结果说明的一部分 |
| 查看提交记录 | 用于按页回看历史提交内容,作为批改依据;需与当前原卷查看区联动 |
| 上一位/下一位 | 在学生队列中连续处理,减少教师返回列表的操作成本 |
| 保存批改 | 保存当前学生的教师确认结果;若存在下一位待批改学生,保存后自动切换到下一位;若已全部完成,可展示进入报告的引导 |
题目判分规则
| 场景 | 规则 |
|---|---|
| 客观题 | 可优先使用“对/半对/错”快速判定;最终仍以教师确认分值为准 |
| 主观题 | 默认支持教师手动输入分数,并展示参考答案/采分点信息(若后端已提供) |
| 无法识别答案 | AI 建议区域展示“未识别到可靠答案”,教师需人工查看原卷后判分 |
| 缺答/空白 | 教师可直接判 0 分,并保留为空答标签,供报告侧统计 |
| 满分限制 | 任一题目最终得分不得大于题目满分,也不得小于 0 |
| 保存前校验 | 只有当前学生全部纳入计分题目均存在有效得分时,才允许完成保存 |
AI状态规则
| AI状态 | 说明 | 教师侧处理 |
|---|---|---|
| 未触发 | 教师尚未开启AI辅助批改 | 支持直接人工批改或手动触发AI |
| 排队中 | 已提交 AI 请求,但尚未进入实际处理 | 展示排队提示;教师可先人工批改,不阻塞页面 |
| 处理中 | AI任务已发起,系统正在识别与判分 | 展示处理中状态,不允许直接引用未完成结果 |
| 建议可用 | AI已返回建议分数/判定 | 教师可整题采纳、逐题修改或完全忽略 |
| 低置信度 | AI有返回结果,但置信度不足或存在结构缺失 | 明确提示教师必须人工复核;不得默认写入最终成绩 |
| 失败 | AI识别失败、超时或答案结构不完整 | 直接切回人工批改;保留“重试AI”入口 |
AI辅助触发与采纳规则
- AI辅助批改必须由教师显式触发,不能在进入页面后自动对所有学生发起任务。
- 同一学生已存在“处理中/排队中”AI任务时,不允许重复发起新任务,避免并发污染。
- AI结果返回后,只能回填到“建议值”区域,不能直接覆盖教师已手动填写的最终分值。
- 教师如选择采纳 AI 建议,应支持:
- 单题采纳;
- 当前题组批量采纳;
- 当前学生整份试卷批量采纳。
- 教师一旦对 AI 建议进行人工修改,页面应标记该题为“人工调整后”,便于后续追溯。
- AI结果仅作为过程性参考数据保存,不作为最终对学生生效的成绩数据。
保存与切换规则
| 场景 | 规则 |
|---|---|
| 保存当前学生 | 写入当前学生的教师最终确认结果、题目级得分、教师备注、保存人、保存时间;成功后刷新学生队列与作业整体进度 |
| 保存中 | 保存按钮进入 loading 并全局防重复提交;同一学生不允许连续重复点击多次保存 |
| 保存成功 | Toast 提示“批改已保存”;若存在下一位待处理学生,默认自动跳转下一位 |
| 保存失败 | 保留页面当前改动,不清空输入内容,提示“保存失败,请重试” |
| 切换下一位学生 | 当前学生存在未保存改动时,必须先弹确认;确认后放弃未保存改动并切换 |
| 全部批改完成 | 页面顶部展示完成提示,并提供“查看作业报告”主按钮 |
| 中途退出 | 若存在未保存改动,弹出二次确认弹窗;确认离开后不保存本次改动 |
| 并发冲突 | 若同一学生结果已被其他端或其他教师更新,保存时需提示“结果已更新,请刷新后再处理”,不得静默覆盖 |
弹窗与反馈规格
| 组件 | 触发条件 | 标题/文案 | 按钮 | 行为 |
|---|---|---|---|---|
| 离开确认弹窗 | 教师返回列表、关闭页面或切换其他学生时存在未保存改动 | 标题:“当前批改尚未保存,确认离开?”;正文:明确告知未保存的题目分数与备注将丢失 | “继续编辑”“确认离开” | 继续编辑则关闭弹窗;确认离开则放弃未保存改动并执行原操作 |
| 一键全对确认弹窗 | 教师对当前题组/整份试卷执行“一键全对”,且存在已修改题目 | 标题:“确认覆盖当前已有判分结果?” | “取消”“确认覆盖” | 确认后统一写入满分建议值 |
| 保存成功 Toast | 当前学生批改保存成功 | 文案:“批改已保存” | 无 | 2 秒自动消失;如存在下一位待处理学生则自动切换 |
| AI失败提示 | AI任务失败或返回不可用 | 文案:“AI辅助批改失败,请改为人工批改或稍后重试” | “人工批改”“重试AI” | 不影响当前人工判分内容 |
| 全部完成引导 | 当前作业下已无待批改学生 | 文案:“当前作业已全部批改完成” | “查看作业报告”“返回作业列表” | 引导教师进入分析闭环或返回列表 |
数据落库与回流
- 教师点击“保存批改”成功后,服务端至少写入以下数据:
- 学生级批改结果:
homework_id、student_id、paper_snapshot_id、grader_id、final_score、comment、graded_at、grading_source=teacher_web。 - 题目级结果:题目/小题 ID、满分、教师最终分数、判定标签、是否参考 AI、是否人工调整。
- 过程追溯信息:所依据的提交记录版本、AI任务 ID/状态快照、保存版本号。
- 学生级批改结果:
- 教师最终结果写入成功后,才允许更新学生级状态为“已批改”;不能在保存前提前变更状态。
- 服务端需同步刷新该作业的聚合进度,包括:已提交人数、待批改人数、已批改人数、异常人数。
- 教师最终保存结果是学生端“批改结果”、教师端“作业报告/学生学情”的唯一成绩口径;AI 建议值不得直接对外暴露为最终分数。
- 若保存事务中任一关键写入失败,整次保存必须回滚,不得出现“部分题目已写入、学生状态未更新”的脏数据。
异常与边界
| 场景 | 处理规则 |
|---|---|
| 当前学生无有效原卷图片 | 队列标记“提交异常”;教师仍可查看结构化答案并人工判分;若两者都不可用,则提示联系补交 |
| 原卷图片部分缺页 | 缺页页码显式标红;教师可先批改其他题目,但保存前需确认缺页题目的处理结果 |
| 学生存在多次提交 | 默认按最新有效记录展示,同时保留历史记录切换能力;最终保存需记录所依据的提交版本 |
| AI长时间处理中 | 超过阈值后转为“处理超时”,提示教师改为人工批改,并保留后续手动重试入口 |
| 网络中断 | 页面顶部提示网络异常;未保存改动保留在当前页面内存中,待网络恢复后允许继续保存 |
| 服务端返回版本冲突 | 提示教师当前学生结果已被更新,提供“刷新查看最新结果”入口 |
| 当前作业无待批改学生 | 展示完成态,不再默认落到空白批改面板 |
| 报告尚未生成 | 全部批改完成后若报告仍在计算,展示“报告生成中”,允许先返回列表 |
业务规则引用
- R06:批改必须基于可追溯的提交记录版本进行,不以单次最新上传简单覆盖。
- R07:AI批改仅提供建议值;低置信度、失败、结构不完整时必须降级为人工确认。
- R08:只有教师保存后的结果才是最终有效成绩,并回流影响学生端结果与教师报告统计。
3.6 作业报告
3.6.1 前置
(选填项)
- 当前作业已完成发布,系统已生成“作业-班级”执行关系,供提交、批改、报告统计消费。
- 当前班级至少已存在以下任一数据:提交记录、教师确认批改结果、报告生成任务;若三者均不存在,仅允许展示空态。
- 教师从作业列表点击“作业报告”,或在批改页完成当前作业最后一位学生保存后进入作业报告页。
- 报告页默认按“作业 + 班级”维度展示;若同一份作业发布到多个班级,则必须先选择班级口径后再查看结果。
3.6.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 作业报告 | 页面名称:作业报告。 功能目的:承接教师“完成批改 -> 查看整体学情 -> 下钻题目或学生 -> 继续讲评/再出题”的分析闭环,帮助教师从一次作业中快速看清提交进度、批改进度、题目薄弱点、知识点掌握情况和学生个体表现。页面不是独立录入页,而是批改结果驱动的派生分析页。 页面结构:页面采用“顶部上下文区 + 页内分析Tab + 局部下钻动作”的结构。顶部包含返回入口、报告刷新入口、班级切换、Tab切换、基础信息卡和概览指标;中部按“作业分析 / 题目分析 / 学生学情”分层承载不同分析视角;题目分析页内继续承接“加入作业篮”动作;学生学情页继续承接“错题分析 / 学生评价报告”下钻动作。 操作流程:教师进入作业报告页 -> 默认加载上次查看的班级与Tab,若无记录则默认加载第一个班级的“作业分析” -> 查看基础信息和核心概览指标 -> 在当前班级口径下切换分析Tab -> 根据分析结果查看未交学生名单、展开题目解析、将题目加入作业篮、进入学生错题分析或学生评价报告 -> 返回报告页时保留原班级和Tab状态。 字段/规则/状态说明: 1. 报告口径始终以“当前作业 + 当前班级”为准,不做跨班汇总排行。 2. 当当前班级仅有提交数据、尚未完成批改时,只展示提交率、批改进度等进度型指标,不展示平均分、知识点掌握结论、学生评价分布等结果型模块。 3. 题目分析和学生学情均属于报告页内并列分析视角,不应做成需要额外返回层层跳转的二级页面。 4. 报告页允许教师直接把高错题重新加入作业篮,形成“分析 -> 再出题”闭环,但加入后不自动生成新作业。 5. 名单复制、公开讲评等动作默认遵循最小暴露原则,不展示非必要成绩敏感信息。 | 【待补充:t_report 页面截图】 |
3.6.3 补充规格
页面到达路径
| 来源页面 | 触发动作 | 带入参数 | 到达后默认行为 |
|---|---|---|---|
| 作业列表 | 点击“作业报告” | 作业ID、默认班级ID、入口来源=list | 默认进入上次查看的Tab;若无历史记录则进入“作业分析” |
| 批改页 | 当前作业全部学生完成保存后点击“查看作业报告” | 作业ID、当前班级ID、入口来源=grading | 保留当前批改班级口径,优先展示完整结果型模块 |
| 错题分析 / 学生评价报告 | 返回作业报告 | 作业ID、班级ID、返回前Tab、筛选条件 | 必须恢复原班级、原Tab、滚动位置和已展开模块状态 |
顶部公共区
| 区域 | 说明 | 交互规则 |
|---|---|---|
| 返回入口 | 返回作业列表或来源页 | 若页面从批改页直接进入,则返回时优先回到作业列表,避免重复进入批改流程 |
| 刷新报告 | 手动重新拉取当前班级报告数据 | 点击后仅刷新当前班级、当前Tab数据;刷新期间保留页面结构和当前筛选条件 |
| 班级切换 | 以胶囊按钮或下拉形式展示当前作业下已发布班级 | 切换班级后重置为该班级最近一次查看的Tab;若无记录则回到“作业分析”首屏 |
| Tab切换 | 页内并列展示“作业分析 / 题目分析 / 学生学情” | Tab切换不跳转新页面,只更新中部内容区;切换动作需记录埋点 |
| 基础信息卡 | 展示作业标题、发布班级、发布时间、题目数量、总分、备注等 | 默认折叠,仅展示高频字段;点击“展开/收起”切换详细字段,展开状态本地保留 |
基础信息卡字段
| 字段 | 说明 | 展示规则 |
|---|---|---|
| 作业标题 | 当前作业任务标题 | 必显,只读 |
| 发布班级 | 当前作业关联的全部发布班级 | 折叠态仅展示当前查看班级;展开态展示全部发布班级 |
| 发布时间 | 作业正式发布时间 | 展开态展示 |
| 题目数量 | 当前作业总题量 | 展开态展示 |
| 总分 | 当前作业满分 | 展开态展示 |
| 作业备注 | 发布页填写的备注信息 | 无备注时展示“无” |
概览指标区
| 指标卡 | 核心字段 | 口径说明 | 关键动作 |
|---|---|---|---|
| 提交情况 | 提交率、已提交人数、总发布人数 | 提交率 = 已提交人数 / 当前班级应交人数 | 点击“查看学生名单”打开名单弹窗 |
| 批改情况 | 批改进度、已批改人数、已提交人数 | 批改进度 = 已完成教师确认人数 / 已提交人数 | 点击“批改修正”回到批改页继续处理 |
| 最高分 | 当前班级教师最终确认成绩中的最高分 | 无有效成绩时展示 -- | 仅展示,不可点击 |
| 最低分 | 当前班级教师最终确认成绩中的最低分 | 无有效成绩时展示 -- | 仅展示,不可点击 |
| 题目错误率 | 当前作业错题率最高的题目摘要列表 | 默认展示Top5,按错误率倒序 | 点击题目或切换Tab可进入“题目分析”进一步查看 |
| 学生作业评价分布 | A/B/C/D/E各档位占比 | 仅统计已完成教师确认且已写入评价的学生 | 仅展示,不形成排行 |
作业分析 Tab
| 模块 | 展示内容 | 规则 |
|---|---|---|
| 提交情况卡片 | 提交率、提交人数、未交入口 | 若班级 0人提交,卡片仍展示总人数和空态入口,帮助教师催交 |
| 批改进度卡片 | 批改进度、已批改人数、批改修正入口 | 若 已提交但未批改 人数 > 0,则应优先提示教师回到批改页 |
| 分数极值卡片 | 最高分、最低分 | 仅基于教师最终确认成绩统计,不读取AI建议值 |
| 题目错误率摘要 | 高错题TopN、错误率 | 用于首屏快速发现问题题,不替代题目分析页完整列表 |
| 评价分布图 | 学生评价档位占比 | 无评价数据时展示占位说明“批改完成后生成评价分布” |
| 知识点分析表 | 知识点名称、上级知识点、正确率、掌握情况 | 默认按正确率升序展示,便于教师优先关注薄弱知识点 |
| 知识点雷达图 | 当前班级主要知识点掌握轮廓 | 仅作为辅助视觉,不单独作为业务结论依据 |
题目分析 Tab
| 区域 | 展示内容 | 规则 |
|---|---|---|
| 列表头部 | 题目总览标题、错误人数排序、错误率排序 | 默认按错误率倒序;切换排序后仅影响当前列表,不影响其他Tab |
| 题目卡片头部 | 题型标签、错误率、错误次数、作答次数、错题人数、难度 | 所有统计均基于当前班级口径;错题人数点击后可进入错题分析页或后续弹窗能力 |
| 题目卡片正文 | 题干摘要 | 长题干默认截断展示,避免撑高列表 |
| 解析展开区 | 试题答案、试题解析、知识点、教材章节 | 点击“解析”展开/收起;同题展开状态在本次停留期间保留 |
| 加入作业篮按钮 | 将当前题目加入教师作业篮 | 首次点击写入作业篮并变更为“取消加入”;再次点击从作业篮移除 |
| 右侧筛选区 | 题目类型、知识点筛选、筛选按钮、重置按钮 | 筛选仅作用于当前班级和当前作业题目池;重置后恢复默认排序和全部数据 |
作业篮抽屉
| 区域 | 说明 | 规则 |
|---|---|---|
| 悬浮入口 | 右下角固定显示“已选X题” | 数量与题目分析页“加入作业篮”状态实时同步 |
| 抽屉头部 | 展示已选题数、总分、一键清空、关闭入口 | 一键清空前必须二次确认 |
| 题型分组区 | 按题型分组展示已加入题目、分值、删除入口 | 删除题目后需同步更新列表按钮状态 |
| 回流动作 | “进入选题中心”“进入排版” | 进入选题中心时保留当前作业篮;进入排版时直接回流组卷工作台 |
学生学情 Tab
| 区域 | 展示内容 | 规则 |
|---|---|---|
| 列表头部 | 提交人数、复制名单入口 | 名单复制默认仅复制姓名及缺页信息,不复制分数、排名等敏感数据 |
| 学生表格 | 学生ID、学生姓名、学号、正确率、评价、批改时间、操作列 | 仅展示当前班级、当前作业下的学生结果,不展示跨班排名字段 |
| 评价字段 | A/B/C/D/E评价标签 | 评价来源于教师最终确认结果;若未生成评价则展示“待评价” |
| 一键全A | 对当前筛选结果中的学生批量写入A档评价 | 仅修改评价字段,不改动分数;执行前需二次确认,执行后允许教师逐个再调整 |
| 操作列 | 错题分析、作业评价 | 点击后分别进入错题分析页、学生评价报告页 |
| 右侧筛选区 | 按评价档位筛选学生 | 默认“全部”;筛选后保留当前滚动位置和表格页态 |
学生名单弹窗
| 要素 | 内容 |
|---|---|
| 触发条件 | 教师点击“提交情况”卡片中的“查看学生名单” |
| 标题 | 学生名单 |
| 副信息 | 当前班级名称、当前筛选后人数 |
| 筛选项 | 按页码勾选“筛选未交页”,支持多选 |
| 列表内容 | 学生姓名 + 各页提交状态徽标;已提交页高亮,未提交页置灰 |
| 批量动作 | 支持全选、单选、复制名单 |
| 复制规则 | 复制内容默认输出“学生姓名(缺第X页)”格式;若学生已全提交则标记“已全提交” |
| 关闭方式 | 点击右上角关闭、点击遮罩空白区关闭 |
Tab定义
| Tab | 核心目标 | 关键动作 | 不应承载的内容 |
|---|---|---|---|
| 作业分析 | 帮教师快速看懂班级整体表现 | 班级切换、查看名单、刷新报告 | 不承载单题级完整详情 |
| 题目分析 | 帮教师定位高错题并回流再出题 | 排序、筛选、展开解析、加入作业篮 | 不承载学生个体完整画像 |
| 学生学情 | 帮教师定位重点学生并继续个体下钻 | 筛选评价、复制名单、错题分析、作业评价 | 不承载跨班对比或公开排行 |
状态与数据口径
| 场景 | 页面展示规则 |
|---|---|
| 数据生成中 | 顶部保留基础信息和班级切换,指标区与图表区展示骨架屏和“报告生成中”提示 |
| 仅有提交数据、无批改结果 | 仅展示提交情况、批改进度、未交名单,不展示最高分、最低分、知识点结论、评价分布 |
| 部分学生已批改 | 允许展示基于已批改学生的阶段性数据,但必须在模块标题旁标记“阶段数据” |
| 全部批改完成 | 展示完整结果型模块,允许继续下钻错题分析和学生评价 |
| 当前模块加载失败 | 仅当前模块展示错误态和“重试”按钮,不影响其他模块浏览 |
| 当前班级无提交 | 展示班级空态和催交提示,不输出任何误导性统计结论 |
回流规则
- 从题目分析页加入作业篮后,题目写入当前教师作业篮,不立即生成新作业。
- 从作业篮进入选题中心或组卷工作台后,返回报告页时需保留当前班级和Tab状态。
- 从学生学情进入错题分析或学生评价后,返回时必须恢复原Tab、原筛选条件和滚动位置。
- 从批改页进入报告页时,若当前班级仍有未批改学生,报告页需优先提示“仍有待批改学生”,避免教师误以为分析已完整。
异常与边界
| 场景 | 处理方式 |
|---|---|
| 无提交数据 | 展示空态,不输出平均分、正确率、评价分布等结论型指标 |
| 无批改数据 | 仅展示进度型数据,并引导教师回到批改页 |
| 部分学生缺页提交 | 名单弹窗和学生学情列表应能体现“缺第X页”信息,避免教师误判为未提交整份作业 |
| 图表或知识点模块数据缺失 | 模块展示“数据暂未生成”说明,不直接显示0,避免误导教师 |
| 班级切换后数据较大 | 当前Tab显示局部加载态,顶部公共区保持可操作,避免整页白屏 |
| 作业篮写入失败 | 保留按钮原状态并Toast提示“加入失败,请重试”,不允许前端假成功 |
| 批量复制名单失败 | 提示教师重试或手动复制,不影响弹窗继续使用 |
| 公开展示场景 | 默认不展示公开排名,不在名单复制内容中附带分数、评价等敏感信息 |
业务规则引用
- R08、R09、R10、R12。
3.7 错题分析
3.7.1 前置
(选填项)
- 当前作业至少存在 1 个已批改完成班级,且该班级下已有可用于分析的题目作答记录。
- 错题分析数据已由批改结果与作业报告链路生成;若数据仍在生成中,允许页面先进入加载态,不直接判定为空。
- 教师对当前作业、当前班级具备查看权限,仅允许查看本人任教班级或被授权代课班级的数据。
- 教师从作业报告页进入错题分析页,系统需至少携带
作业ID、班级ID,如从学生学情或题目分析下钻,还需携带学生ID或题目ID作为默认定位上下文。 - 若当前作业支持多班发布,则错题分析默认继承作业报告页当前选中的班级口径,不额外重置为其他班级。
3.7.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 错题分析 | 页面名称:错题分析。 功能目的:围绕本次作业中的错题完成“题目定位 - 学生定位 - 原卷回看 - 讲评准备 - 再出题预留”的闭环,既帮助教师快速识别班级高频问题,也支持下钻到单个学生的具体错题与原卷表现。 页面定位:错题分析是作业报告的下钻页,不独立承担统计总览功能,而是承接报告结论后的精细讲评动作。页面采用三栏结构:左侧原卷预览区、中间错题卡片区、右侧学生名单区。 进入方式: 1. 从作业报告页「学生学情」进入时,默认定位到被点击学生,展示该学生在当前作业下的错题集合。 2. 从作业报告页「题目分析」进入时,默认定位到被点击题目,优先展示该题的解析与做错学生名单。 3. 若无明确下钻对象,仅带入班级口径进入,则默认展示当前班级错误率最高的题目或首个可分析学生。 操作流程:教师从作业报告页进入错题分析页 -> 系统带入作业/班级/学生或题目上下文 -> 教师查看原卷与错题卡片 -> 按需切换学生、展开解析、查看知识点与答案 -> 在需要时放大原卷、切换页码并定位错题位置 -> 如需后续强化练习,可将题目加入作业篮(预留) -> 返回作业报告继续查看其他分析维度。 字段/规则/状态说明: 顶部上下文: 1. 展示平台名称、返回入口、当前作业标题/教材路径/班级信息。 2. 点击返回时需回到原来源页,并保留来源页的班级、Tab、滚动位置与筛选状态。 错题卡片区: 1. 按大题或题号顺序展示当前上下文下的错题卡片。 2. 每张卡片至少展示题号、题型、题干摘要、正确答案、解析、知识点、教材章节、错误率/错误人数等信息。 3. 解析内容默认折叠,展开后查看完整答案、解析与知识点。 学生名单区: 1. 支持按班级查看做错学生名单,并支持姓名搜索。 2. 列表需展示当前选中态,切换学生后中间错题卡片区和左侧原卷区同步更新。 3. 如来自单学生下钻,则默认高亮该学生;如来自单题下钻,则默认展示该题做错学生名单。 原卷查看区: 1. 展示当前学生原卷截图或结构化原卷预览。 2. 支持上一页/下一页、缩放、定位当前错题所在页。 3. 原卷仅作为讲评辅助,不允许在本页直接修改成绩。 异常与边界: 1. 无错题数据时,展示空态文案“本次作业暂无可分析错题”,并提供返回作业报告入口。 2. 无高频错题但存在个体错题时,仍允许进入个体错题视角,不应直接整页置空。 3. 原卷截图缺失或加载失败时,展示错误提示、重试按钮与“仅查看文字解析”兜底方案。 4. 学生名单为空、搜索无结果或切换班级后无数据时,展示对应空态提示,不影响其他已加载区域。 5. 当分析数据仍在生成中时,页面展示骨架屏与提示文案,不输出误导性结论。 | 【待补充:t_error_analysis 页面截图】 |
3.7.3 补充规格
页面主体
| 模块 | 规格 |
|---|---|
| 顶部上下文区 | 展示返回按钮、作业标题、教材路径、当前班级;返回时保留来源页Tab、班级筛选和滚动位置 |
| 原卷查看区 | 展示当前学生原卷截图或结构化原卷;支持页码切换、放大缩小、定位当前错题所在页 |
| 错题卡片区 | 按大题/题号顺序展示错题卡片;每卡片展示题号、题型、题干摘要、正确答案、解析、知识点、教材章节、错误率/错误人数 |
| 学生名单区 | 展示当前班级下与当前错题或当前学生视角相关的学生列表,支持高亮当前选中学生、姓名搜索和班级切换 |
默认上下文与联动规则
| 场景 | 规则 |
|---|---|
| 从学生学情下钻 | 默认选中被点击学生,中间区域展示该学生本次作业全部错题,左侧原卷默认定位到首道错题所在页 |
| 从题目分析下钻 | 默认选中被点击题目,优先展示该题的题干、答案、解析及做错学生名单 |
| 无明确下钻对象 | 默认展示当前班级错误率最高的题目,若题目级数据暂未就绪,则展示首个可分析学生的错题集合 |
| 切换学生 | 同步刷新原卷查看区与错题卡片区;若当前题目在该学生中不存在,则自动切换到该学生的首道错题 |
| 切换班级 | 继承当前作业上下文,刷新学生名单与分析结果;若原先选中学生不在目标班级中,则重置为目标班级首个可分析学生 |
| 展开解析 | 仅展开当前卡片的完整答案、解析与知识点,不影响其他卡片浏览位置 |
辅助动作
| 动作 | 说明 |
|---|---|
| 查看原卷 | 查看学生作答原卷,辅助教师完成针对性讲评;原卷区不提供改分能力 |
| 切换学生 | 在右侧名单区切换学生,快速对比同一题在不同学生中的错误表现 |
| 展开解析 | 展开查看完整答案、解析、知识点和教材章节,默认收起以降低信息噪音 |
| 返回作业报告 | 返回作业报告页继续查看其他维度,并恢复进入前的浏览上下文 |
| 加入作业篮 | 预留再出题能力;仅当题目来源可回溯且教师具备组卷权限时展示入口,加入成功后仅 Toast 提示,不跳离当前页 |
字段与数据口径
| 要素 | 规格 |
|---|---|
| 错题判定 | 以教师最终确认后的批改结果为准;AI建议分不直接作为错题判定依据 |
| 高频错题口径 | 基于当前班级、当前作业、已完成批改的学生范围计算;不跨作业混算 |
| 错误率 | 做错人数 / 当前班级已批改人数;当分母为 0 时不展示百分比,仅提示“暂无有效口径” |
| 错误人数 | 展示当前班级下该题做错的学生人数,用于帮助教师判断讲评优先级 |
| 知识点展示 | 展示与题目绑定的知识点标签;若存在多个知识点,按主知识点优先,其余以标签形式补充 |
| 学生名单口径 | 仅展示当前班级、当前作业、当前上下文下可见的学生;不跨班混合展示 |
| 原卷内容 | 优先展示最新有效提交版本;如存在多次提交,仅展示教师最终确认所对应的版本 |
| 脱敏规则 | 页面用于公开讲评、投屏或跨班复制场景时,学生姓名需支持脱敏展示,遵循最小暴露原则 |
筛选、排序与加载策略
| 场景 | 规则 |
|---|---|
| 默认口径 | 默认继承来源页班级口径,并按错误率优先或来源对象优先展示 |
| 支持筛选 | 支持按班级查看;题目列表支持按题号顺序或错误率优先浏览;学生名单支持姓名搜索 |
| 列表排序 | 在无特定来源上下文时,错题卡片默认按错误率降序、题号升序展示 |
| 原卷加载 | 原卷按页懒加载;切换学生或题目时,仅刷新受影响区域,不整页重新加载 |
| 名单加载 | 学生名单区默认滚动浏览;若人数较多,优先保证当前选中学生始终可见 |
异常与边界
| 场景 | 处理方式 |
|---|---|
| 数据生成中 | 展示骨架屏与提示文案“分析数据生成中,请稍后查看”,禁止展示不完整结论 |
| 当前班级无错题 | 展示空态文案“本次作业暂无可分析错题”,并提供返回作业报告入口 |
| 无高频错题但有个体错题 | 允许展示个体错题视角,不因缺少高频题而整页为空 |
| 搜索无结果 | 名单区展示空态“未找到符合条件的学生”,保留当前筛选输入 |
| 原卷缺失 | 展示“暂无可查看原卷”,保留文字解析与知识点信息供教师讲评 |
| 原卷加载失败 | 展示错误提示与重试按钮,不影响错题卡片区和名单区浏览 |
| 题目解析缺失 | 展示“暂无解析”,仍保留正确答案、知识点和教材章节信息 |
| 模块加载失败 | 仅当前模块展示错误态与重试按钮,不阻断其他模块已加载内容 |
业务规则引用
- R09、R10、R12。
3.8 学生评价报告
3.8.1 前置
(选填项)
- 当前学生已存在本次作业的批改结果与分析数据。
- 教师从作业报告页下钻进入学生评价报告页。
3.8.2 说明
(可以不使用表格形式,但应包含必要信息)
| 页面 | 说明 | 原型图 |
|---|---|---|
| 学生评价报告 | 页面名称:学生评价报告。 功能目的:查看单个学生在本次作业中的成绩表现、知识点掌握和错题分布,辅助个体反馈。 操作流程:教师从作业报告页进入学生评价报告页 -> 查看学生基础信息和总体评价 -> 查看题型表现、知识点掌握、错题分布和教师评语 -> 根据结果开展后续讲评或辅导 -> 处理完成后返回学生学情列表。 字段/规则/状态说明: 顶部信息: 1. 展示学生姓名、班级、总分、正确率、评价等级。 2. 支持展示教师评语。 结果模块: 1. 题型表现:查看学生在不同题型下的表现。 2. 知识点掌握:查看学生知识点掌握情况。 3. 错题分布:查看学生错题情况和错题数量。 4. 教师点评:查看本次作业的教师评价或点评。 数据口径: 1. 评价等级以当前作业结果为准。 2. 不形成跨班公开排名。 异常与边界: 1. 学生未提交或未批改完成时,展示对应提示。 2. 数据生成中或部分指标缺失时,展示占位说明。 3. 页面加载失败时,展示刷新与回退入口。 | 【待补充:t_student_evaluation 页面截图】 |
3.8.3 补充规格
顶部信息
| 字段 | 规格 |
|---|---|
| 学生姓名 | 展示当前学生姓名 |
| 班级 | 展示当前学生所属班级 |
| 总分 | 展示当前作业总分表现 |
| 正确率 | 展示当前作业正确率 |
| 评价等级 | 展示当前作业评价等级 |
| 教师评语 | 展示教师对当前学生的评价或点评 |
结果模块
| 模块 | 规格 |
|---|---|
| 题型表现 | 查看学生在不同题型下的表现情况 |
| 知识点掌握 | 查看学生知识点掌握情况 |
| 错题分布 | 查看学生错题情况及数量 |
| 教师点评 | 查看教师对学生的个体反馈 |
口径与动作
| 要素 | 规格 |
|---|---|
| 口径说明 | 评价等级以当前作业结果为准,不形成跨班公开排名 |
| 关联动作 | 返回学生学情列表、查看错题原卷、为该学生定向讲评(后续预留) |
| 合规要求 | 面向单学生的评价结果仅在有权限教师范围内展示,不向无关班级开放 |
异常与边界
| 场景 | 处理方式 |
|---|---|
| 学生未提交 | 展示未提交提示,不展示结果型数据 |
| 学生未批改完成 | 展示待批改提示,不展示最终评价结论 |
| 数据生成中 | 展示占位说明 |
| 页面加载失败 | 展示刷新与回退入口 |
4. 数据埋点
采用和数据埋点wiki同样的字段表格。评审完毕后要将内容同步贴到数据埋点wiki页面。需要在此文档中注明埋点信息。
4.1 新入埋点池
| 事件名称 | 页面 | 触发对象 | 触发时机 | 事件参数 | 是否新入埋点池 | 备注 |
|---|---|---|---|---|---|---|
| 作业列表浏览 | 作业列表 | 页面 | 教师进入作业列表页并完成首屏渲染 | 作业类型、入口来源、教师ID、默认筛选条件 | 是 | 建议补充页面浏览埋点 |
| 作业类型切换 | 作业列表 | Tab切换 | 教师点击“个性化作业/纸质教辅作业”Tab时 | 切换前类型、切换后类型、教师ID | 是 | 用于观察两类作业访问占比 |
| 资源任务查看 | 资源中心 | 任务卡片/资源卡片 | 教师打开统一管理平台任务或资源详情时 | 任务ID、资源来源、学科、教材、教师ID | 是 | 用于统计资源消费链路 |
| 加入作业篮 | 资源中心 | 题目/试卷按钮 | 教师点击“加入作业篮”或整卷加入时 | 题目ID/试卷ID、资源来源、加入方式、作业篮题目数 | 是 | 主链路关键行为 |
| 完成选题 | 资源中心 | 完成选题按钮 | 教师点击“完成选题”进入组卷工作台时 | 作业篮题目数、题型分布、来源分布 | 是 | 用于分析选题转化 |
| PDF生成 | 组卷工作台 | 完成/生成按钮 | 教师触发PDF生成并返回结果时 | 作业ID、题目数、页数、成功/失败原因 | 是 | 关键技术链路埋点 |
| 作业发布 | 发布作业 | 立即发布按钮 | 教师点击“立即发布”并收到结果时 | 作业ID、作业类型、班级数、是否成功、失败原因 | 是 | 核心转化埋点 |
| AI辅助批改触发 | 批改 | AI触发按钮 | 教师手动开启AI辅助批改时 | 作业ID、学生ID、题目数、触发入口 | 是 | 观察AI辅助使用率 |
| 批改保存 | 批改 | 保存按钮 | 教师点击“保存批改”或“保存并查看学情”时 | 作业ID、学生ID、批改耗时、AI是否参与 | 是 | 观测批改效率 |
| 作业报告浏览 | 作业报告 | 页面 | 教师进入作业报告页并完成首屏渲染时 | 作业ID、作业类型、入口来源、教师ID | 是 | 学情页核心浏览埋点 |
| 报告回流出题 | 作业报告 | 加入作业篮按钮 | 教师在报告页将题目加入作业篮时 | 作业ID、题目ID、错题率、入口Tab | 是 | 观测“分析 -> 再出题”闭环 |
| 学科切换确认 | 资源中心 | 学科切换弹窗 | 作业篮非空时,教师确认切换学科并清空作业篮 | 原学科、新学科、作业篮题目数、是否确认切换 | 是 | 观测误操作与清空损耗 |
| 组卷草稿保存 | 组卷工作台 | 保存草稿按钮 | 教师点击“保存草稿”并收到结果时 | 草稿题目数、目录数、是否成功、失败原因 | 是 | 观测中断恢复需求 |
| 组卷退出确认 | 组卷工作台 | 退出确认弹窗 | 教师点击退出/返回选题后,在弹窗中选择保存或放弃时 | 当前题目数、是否保存、入口按钮 | 是 | 判断草稿保护机制是否有效 |
| 发布页退出确认 | 发布作业 | 退出确认弹窗 | 教师点击退出并选择确认退出时 | 是否已填写标题、已选班级数、备注字数 | 是 | 观察发布前流失 |
| 提交记录查看 | 批改 | 提交记录按钮 | 教师在批改页点击“提交记录”入口时 | 作业ID、学生ID、当前页码、是否存在历史版本 | 是 | 判断批改依据使用率 |
| 报告班级切换 | 作业报告 | 班级切换器 | 教师在报告页切换查看班级口径时 | 作业ID、原班级、新班级、当前Tab | 是 | 用于分析多班作业的报告使用习惯 |
| 报告Tab切换 | 作业报告 | Tab | 教师在“作业分析/题目分析/学生学情”间切换时 | 作业ID、班级、原Tab、新Tab | 是 | 观测最常用分析视角 |
| 学生名单复制 | 作业列表/作业报告 | 复制名单按钮 | 教师在名单弹窗中勾选后复制时 | 页面来源、班级、学生数、筛选页码 | 是 | 观测催交与线下协同场景 |
5. 核心数据对象
erDiagram
HOMEWORK {
string homework_id PK
string homework_type
string subject
string title
string status
string paper_snapshot_id
string teacher_id
datetime published_at
}
HOMEWORK_CLASS {
string homework_class_id PK
string homework_id FK
string class_id
string execution_status
}
PAPER_SNAPSHOT {
string paper_snapshot_id PK
string pdf_url
int question_count
int page_count
int total_score
}
BASKET_DRAFT {
string basket_draft_id PK
string teacher_id
string subject
string draft_type
json content_snapshot
datetime updated_at
}
QUESTION_ITEM {
string question_id PK
string question_type
string structure_type
string knowledge_point_id
decimal default_score
}
STUDENT_SUBMISSION {
string submission_id PK
string homework_id FK
string student_id
string submit_channel
string submit_status
datetime submitted_at
}
SUBMISSION_PAGE {
string submission_page_id PK
string submission_id FK
int page_no
string image_url
string page_status
}
GRADING_RESULT {
string grading_result_id PK
string submission_id FK
string grader_id
string ai_status
decimal final_score
datetime confirmed_at
}
REPORT_SNAPSHOT {
string report_snapshot_id PK
string homework_id FK
string class_id
string report_scope
datetime generated_at
}
HOMEWORK ||--o{ HOMEWORK_CLASS : "发布到"
HOMEWORK ||--|| PAPER_SNAPSHOT : "引用"
HOMEWORK ||--o{ STUDENT_SUBMISSION : "收到"
HOMEWORK ||--o{ REPORT_SNAPSHOT : "生成"
BASKET_DRAFT }o--o{ QUESTION_ITEM : "暂存题目"
PAPER_SNAPSHOT }o--o{ QUESTION_ITEM : "包含"
STUDENT_SUBMISSION ||--o{ SUBMISSION_PAGE : "拆分为"
STUDENT_SUBMISSION ||--o| GRADING_RESULT : "生成"
5.1 数据对象说明
| 对象 | 说明 | 备注 |
|---|---|---|
| HOMEWORK | 教师发布后的作业主对象 | 统一承接列表、发布、报告入口 |
| HOMEWORK_CLASS | 作业与班级的执行关系 | 支撑多班发布与班级口径切换 |
| PAPER_SNAPSHOT | 发布时固化的试卷快照 | 避免后续题库变动影响已发布作业 |
| BASKET_DRAFT | 作业篮与组卷/发布上下文暂存对象 | 支撑草稿恢复与返回编辑 |
| STUDENT_SUBMISSION | 学生提交主记录 | 需区分提交渠道与版本 |
| SUBMISSION_PAGE | 提交页级明细 | 支撑缺页、补交、逐页追溯 |
| GRADING_RESULT | 教师最终确认结果 | AI状态仅作辅助字段 |
| REPORT_SNAPSHOT | 报告聚合快照 | 支撑班级/题目/学生三级分析 |
6. 非功能需求
6.1 性能要求
| 指标 | 要求 |
|---|---|
| 作业列表首屏加载 | ≤2秒 |
| 资源中心筛选切换 | ≤1.5秒 |
| 组卷工作台基础操作反馈 | ≤300ms |
| PDF生成 | ≤10秒,超时需给出处理中提示 |
| 批改结果保存 | ≤2秒 |
| 作业报告首屏加载 | ≤3秒 |
6.2 可用性与兼容性
- 教师Web端优先适配Chrome最新版及近两个大版本,兼容Edge Chromium。
- 组卷工作台最低分辨率按1440×900设计,低于该分辨率时允许出现滚动,不强求完整首屏。
- 列表、报告、批改页需支持弱网下重试与错误提示,不允许无反馈空白页。
6.3 权限矩阵
| 权限项 | 任课教师 | 班主任 | 教研员/管理角色 |
|---|---|---|---|
| 查看本人任教班级作业列表 | ✅ | ✅ | ✅ |
| 新建个性化作业并发布 | ✅ | ✅ | 视配置而定 |
| 查看非本人任教班级学生明细 | ❌ | 视授权而定 | ✅ |
| 查看并确认批改结果 | ✅ | 视授权而定 | ✅(监管场景) |
| 查看学生评价报告 | ✅ | ✅ | ✅ |
| 导出/复制学生名单 | ✅ | ✅ | ✅ |
6.4 合规与风控基线
- AI辅助批改必须保留教师最终判分权,禁止将AI建议值直接对学生生效。
- 课堂投屏、公开讲评、跨班展示场景默认脱敏处理学生个人敏感信息。
- 学生评价页禁止形成公开排名榜单,仅展示个体结果与评价等级。
- 提交图片、批改结果、作业评价等学生相关数据应遵循最小权限可见原则。
- 对于AI低置信度结果,需明示“仅供参考”,并要求人工复核后方可保存。
7. 版本规划
| 版本 | 主要能力 | 目标 |
|---|---|---|
| V1.0 | 作业列表、资源中心、组卷工作台、发布作业、批改、作业报告基础闭环 | 跑通教师Web主链路 |
| V1.1 | 草稿恢复稳定性、报告回流再出题、未交名单协同、班级口径优化 | 提升教师高频使用效率 |
| V2.0 | 催交协同、报告导出、知识点专项再练、报告智能推荐 | 形成更强的教学闭环与增值能力 |
8. 遗留问题与待确认
| 编号 | 问题描述 | 影响范围 | 优先级 |
|---|---|---|---|
| Q01 | 纸质教辅作业在当前列表页的状态、字段与操作是否完全复用个性化作业,还是保留独立差异展示? | 作业列表、发布作业、作业报告 | P0 |
| Q02 | “待批改 -> 已批改”的完成判定口径,是否以“全部学生完成教师确认”为准,还是允许部分完成即可生成完整报告? | 批改、作业报告 | P0 |
| Q03 | AI低置信度阈值的产品口径与技术阈值如何对齐,是否需要前端显式暴露置信度等级? | 批改 | P0 |
| Q04 | 学生名单复制是否需要默认脱敏,还是仅在公开讲评/投屏场景脱敏? | 作业列表、作业报告 | P1 |
| Q05 | 作业草稿是否进入独立草稿箱管理,还是维持当前“入口内恢复”模式? | 组卷工作台、发布作业 | P1 |
| Q06 | 作业报告是否需要支持导出PDF/图片、分享给家长或班主任等扩展动作? | 作业报告、学生评价报告 | P1 |