教师 Web / 批改
周策 老师
Prototype

教师 Web · 批改

校验逐题批改、保存并下一份等关键交互。

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

prds/作业管理模块/teacher-web/t_grading.md

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

当前对照重点: 2.3 批改子状态字典
Review Hint

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

教师Web 作业管理模块 PRD

说明:

  1. 本文档基于当前教师Web原型、docs/4. 核心业务流程/ 及现行PRD模板进行补充整理,定位为教师Web作业管理模块评审稿。
  2. 页面级交互以原型稿为准,跨端联动、数据回流、AI辅助批改等业务闭环以核心流程文档为准。
  3. 仍需业务/研发联合确认的事项统一沉淀在第8章,避免散落在各页面描述中。

0. 修订记录

(选填项,仅在评审后有修改的情况下填写)

修订日期修订人修订原因修订内容
2026-04-22Codex对照最新业务流程与原型补充文档补充产品目标、范围边界、业务规则总表、状态字典、非功能需求、核心数据对象、遗留问题

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

补充说明:

  1. 个性化作业与纸质教辅作业共用教师Web作业管理主入口,但业务口径不同:
    • 个性化作业:一份作业可关联多个班级。
    • 纸质教辅作业:一份作业关联一个班级,按既有逻辑整合进当前页面体系。
  2. 学生提交数据来源包括学生小程序拍照自提交、教师小程序拍照代提交等拍照采集入口;其中教师小程序代提交需先绑定 作业 -> 班级 -> 学生,教师Web端负责消费这些结果并完成批改、分析与二次出题。
  3. AI辅助批改在教师侧为“人工可控的辅助能力”,教师可手动触发AI辅助批改,最终成绩以教师确认结果为准。
  4. 作业报告不是独立录入流程,而是教师完成批改后的派生产物;分析结果需继续支持错题分析、学生评价与后续教学动作。

参考资料:

  1. docs/4. 核心业务流程/教师端-组卷发布主流程.md
  2. docs/4. 核心业务流程/教师端-AI批改与教师审核.md
  3. docs/4. 核心业务流程/教师端-作业分析与评价闭环.md
  4. docs/4. 核心业务流程/教师小程序-拍照代提交流程.md
  5. prds/教师小程序_PRD.md

1.5 架构说明

(选填项,相同内容以父级文档为准)

教师Web作业管理模块位于平台“四维一体”作业数字化体系中的教师工作台层,建议按以下架构理解:

  1. 内容底座:标准化知识点图谱、数字教辅内容、统一管理平台下发任务。
  2. 教师工作台:作业列表、资源中心、组卷工作台、发布作业、批改、作业报告。
  3. 数据入口:学生小程序拍照提交、教师小程序拍照代提交。
  4. 智能能力:OCR/答案识别、AI辅助批改、学情统计与智能推荐。
  5. 数据输出:本文档重点描述教师Web端当前原型已承接的作业分析、题目分析、学生评价等页面能力,不额外展开更高层级的独立分析页面。

1.6 产品目标

P0(本期必须实现)

  1. 教师可在Web端完成“选题 -> 编排 -> 发布”的标准化作业生产闭环。
  2. 教师可消费来自学生小程序、教师小程序的拍照提交结果,并完成最终批改确认。
  3. 教师可在批改后查看班级、题目、学生三级分析结果,并支持从报告回流到再出题动作。

P1(本期建议预留)

  1. 为草稿恢复、上下文暂存、断点续批等高频中断场景提供稳定恢复能力。
  2. 为后续扩展催交、班级对比、知识点专项训练、智能推荐出题预留数据结构和埋点基础。

1.7 范围边界

本期范围内

  1. 教师Web端作业列表、资源中心、组卷工作台、发布页、批改页、作业报告、错题分析、学生评价报告。
  2. 与学生提交结果、AI辅助批改、报告分析相关的跨端数据消费规则。
  3. 与教师高频工作流直接相关的草稿保存、发布上下文暂存、未保存离开确认等保护机制。

本期范围外

  1. 教师首页、个人中心、学生管理等外围通用页面。
  2. 学生端/教师小程序/教研端的页面级交互细节。
  3. 独立的草稿箱页面、复杂版本回溯、报告导出下载、消息中心能力。
  4. 面向学生公开排名、对外公开成绩榜单等不符合未成年人保护要求的展示能力。

1.8 核心用户旅程

journey
  title 教师Web作业管理核心旅程
  section 作业生产
    进入作业列表并新建作业: 5: 教师
    在资源中心选题并维护作业篮: 5: 教师
    在组卷工作台调整题序与分值: 4: 教师
    在发布页核对并选择班级后发布: 5: 教师
  section 作业执行
    查看学生提交进度与未交名单: 4: 教师
    进入批改页结合AI建议完成确认: 5: 教师
  section 分析回流
    查看作业报告与学生学情: 4: 教师
    从错题分析回流到再出题: 4: 教师

2. 功能清单

(必填项)

角色功能版本优先级范围说明/备注/依赖
教师查看作业列表(个性化作业)V1.0P0教师Web一份作业关联多个班级;状态:已评审
教师查看作业列表(纸质教辅作业)V1.0P0教师Web一份作业关联一个班级;沿用既有纸质教辅逻辑整合
教师资源中心选取资源V1.0P0教师Web查看统一管理平台发送的任务列表及资源内容;状态:已评审
教师作业篮管理V1.0P0教师Web作业篮全局存在,跨资源来源共享,用于管理已选题目;状态:已评审
教师试卷编辑排版V1.0P0教师Web编辑题目位置、分数、排版结构;状态:已评审
教师题目编辑V1.0P0教师Web改编题目内容和题目信息;状态:已评审
教师保存作业内容与发布V1.0P0教师Web填入必要信息后保存当前作业内容并完成发布;状态:已评审
教师查看提交记录V1.0P1教师Web查看学生提交情况,依赖小程序端与其他采集渠道数据回流
教师手动批改V1.0P0教师Web查看学生提交原卷,手动判对错和打分
教师AI辅助批改V1.0P0教师Web手动开启AI辅助批改,识别学生答案并自动给出辅助判分
教师作业学情优化V1.0P1教师Web更改统计逻辑,优化作业学情界面交互
教师学情分析优化V1.0P1教师Web以当前原型中的作业分析、错题分析、学生评价为主
教师错题分析V1.0P1教师Web查看高频错题详情与学生名单
教师学生评价报告V1.0P1教师Web查看单学生作业评价结果

2.1 业务规则总表

规则编号规则描述影响范围
R01个性化作业与纸质教辅作业共用教师Web作业管理主入口,但个性化作业可关联多个班级,纸质教辅作业仅关联一个班级作业列表、发布作业、作业报告
R02作业篮为教师当前学科下的全局共享容器;跨资源来源共享,切换学科时若作业篮非空,必须二次确认是否清空资源中心、组卷工作台
R03组卷工作台允许保存“组卷草稿”,发布页允许保存“发布上下文”;二者均仅对当前教师本人可见组卷工作台、发布作业
R04发布前必须满足:作业标题必填、至少选择一个班级、题目数≥1、PDF预览可用发布作业
R05发布成功后作业进入“待提交”状态,系统按作业-班级维度生成执行记录,供后续提交、批改、报告消费作业列表、提交回流、作业报告
R06学生提交结果按“作业ID + 学生ID + 页码/记录版本”进行聚合展示,教师在批改时可查看提交记录,不以单次最新上传简单覆盖批改、提交记录
R07AI批改仅提供建议值;低置信度、识别失败、结构不完整时必须降级为人工确认,不得直接作为最终成绩对外展示批改
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 前置

(选填项)

  1. 教师已登录教师Web端。
  2. 教师具备对应班级作业查看权限。
  3. 系统已返回当前教师可见的作业数据。

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 天
确认普通模式下将截止时间更新为所选时间;此刻截止模式下将截止时间更新为确认时的当前时间
取消关闭弹窗,不修改原截止时间
接口要求后端需提供更新作业截止时间能力,入参至少包含 homeworkIddeadlineAtdeadlineAt 不允许为空

列表反馈与异常

场景处理方式
首屏加载中列表区域展示骨架屏
列表加载失败展示错误提示和“重新加载”按钮
当前学科下无已发布作业展示空态文案和“新建作业”按钮
筛选后无结果展示“暂无符合条件的作业”,并支持清空筛选条件
发布时间开始时间晚于结束时间阻断查询,并提示“开始时间不能晚于结束时间”
提交数据跨端回流延迟列表保留最近一次成功聚合结果,并展示“最近更新时间”,支持教师手动刷新
提交进度异常当 a>b 时统一展示“—/—”,并提示“进度统计中,请稍后刷新”
教师无班级权限或无数据展示权限/数据空态,不展示无权限班级名称

学生名单弹窗

要素规格
功能目的展示该份作业未完成提交的学生名单,支持教师对未提交学生进行名单复制并通过社交媒体工具催交作业
触发条件教师在作业列表页点击提交进度区域,或点击“学生名单”按钮后弹出学生名单弹窗
页面来源当前弹窗从作业列表页打开,不跳转新页面
标题学生名单
班级选择下拉框单选;展示该作业发布的班级;选择后,学生名单列表随之切换
人数展示以“共X人”展示当前班级下学生人数
全选复选框;点击后当前学生名单列表中所有学生复选框全部选中;再次取消后全部取消选中
复制名单按钮;点击后复制当前已勾选学生名单
筛选未交页展示该份作业的页面复选列表;有多少页展示多少个页筛选项;以“第X页”展示;默认不选,即展示班级下全部学生名单
学生名单列表展示班级选择以及筛选未交页条件下的所有学生名单

顶部栏

字段类型规则
学生名单标题固定展示
班级选择下拉框单选展示该作业发布的班级;切换后刷新学生名单列表,并重置“全选”为未勾选状态
共X人人数徽标展示当前班级下学生总人数
全选复选框点击后选中当前列表全部学生;取消后全部取消
复制名单按钮复制当前已勾选学生名单;若未勾选任何学生,则提示“请先勾选需要复制名单的学生”

筛选未交页

字段类型规则
第X页复选框组有多少页展示多少个页筛选项;默认全部不选;未勾选任何页时展示全部学生名单;勾选后按所选页过滤未交学生

学生名单列表

字段说明规则
复选框支持勾选和取消选择可单独选择学生;若全部勾选,则顶部“全选”自动变为选中态
学生姓名展示学生姓名按当前班级和页筛选条件展示
对应作业页展示该份作业的全部页提交情况当前 HTML 原型以页码徽标展示页状态;未提交展示灰色,已提交展示绿色;页筛选区以“第X页”展示

复制名单规则

场景规则
已勾选学生复制内容按“学生姓名(缺X、Y页)”格式拼接;若该生已全部提交,则展示“学生姓名(已全提交)”
未勾选学生不执行复制,提示教师先勾选学生
班级切换后复制范围仅针对当前班级下已勾选学生

异常与边界

场景处理方式
当前班级无学生数据弹窗列表区展示空态提示
当前页筛选下无对应未交名单列表区展示“当前筛选下没有对应未交名单”
切换班级重置全选状态,并按新班级重新渲染学生名单与页筛选结果
点击遮罩或关闭按钮关闭弹窗,不保留本次勾选状态
业务规则引用R01、R05

3.2 资源中心

3.2.1 前置

  1. 教师从作业列表点击“新建作业”,或从作业报告/题目分析的“加入作业篮”动作回流进入资源中心。
  2. 系统已加载教师可见的资源域(平台资源、区域资源、校本资源)、题库树数据(教辅章节、知识点、试卷选题列表)、卷库试卷卡片数据及教辅检索数据。
  3. 资源中心在当前原型中包含两条明显分流链路:
    1. 题库链路:按题选题 -> 加入作业篮 -> 完成选题 -> 进入组卷工作台。
    2. 卷库链路:按卷浏览 -> 查看试卷预览 -> 直接去发布。
  4. 若教师从组卷工作台返回资源中心继续增删题目,后续重新回到组卷工作台时,需要重新核对排版结果。

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,不直接显示空白列表
删除至空分组某题型最后一道题被删除时,当前分组自动消失,摘要同步更新
试卷详情关闭点击关闭按钮或遮罩后关闭弹窗,返回卷库结果列表

业务规则引用

  1. R02:作业篮为当前教师、当前学科下的共享容器。题库模式需严格按该规则管理加题与切学科行为;当前原型已实现学科同步切换,但正式需求需补足非空确认。
  2. R03:题库模式下“完成选题”统一进入组卷工作台;若教师返回资源中心继续改题,后续排版需重新校验。
  3. R10:作业报告、题目分析回流加入的题目应继续沉淀到当前作业篮,形成“分析 -> 再出题”闭环。
  4. R13:教辅绑定按教师、学科、年级维度记忆最近一次选择;首次无绑定或历史绑定失效时,统一按当前维度第一本可用教辅兜底。
  5. 当前原型存在卷库直接发布支路,应在评审时明确其是否作为正式产品能力保留。

3.3 组卷工作台

3.3.1 前置

(选填项)

  1. 教师已在资源中心完成选题。
  2. 作业篮中至少存在1道题目。
  3. 系统已将作业篮数据带入组卷工作台。

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分或负分
未分配题目暂存区存在未分配题目时,需弹窗提示“返回分配”或“跳过并继续”
预览可渲染当前版面必须能够成功生成预览页;渲染异常时禁止进入发布页
重复点击保护生成过程中“完成”按钮禁用,并展示生成中遮罩或进度提示

暂存与退出规则

  1. 教师主动点击“保存草稿”时,仅保存当前题篮结构、目录、题序、分值、答题区留白与版面配置,且草稿仅本人可见。
  2. 点击“退出”或“返回选题”时,必须弹出“是否保存排版信息”确认弹窗,至少包含“保存后离开”“不保存离开”两条出口。
  3. 若教师返回资源中心增删题,恢复组卷页时默认保留既有目录与排版结果;新增题目进入未分配题目暂存区,已删除题目从排版结构中剔除。
  4. 若题篮结构变化影响原分页或分组,需提示教师“部分排版需重新确认”,但不主动清空全部已编排结果。
  5. 题目编辑全屏页点击“确定”后才写回组卷工作台;点击“取消”则放弃本次未确认修改,不自动落盘。

数据持久化与上下文保留

数据对象保存内容保存时机说明
组卷草稿题篮快照、目录结构、题序、题目分值、答题留白、说明内容、版面参数手动保存草稿、退出前选择保存用于教师本人恢复未完成的组卷工作
排版参数各题答题区高度、页面局部留白、版面布局参数点击“完成”生成PDF时提交作为正式PDF渲染的确切参数,不可在发布页再修改
隐式定位信息题目在A4画布中的布局坐标、分页信息生成预览与生成PDF时计算主要供预览联动、后续识别定位和打印一致性使用,前端不直接展示
发布上下文标题、备注、班级、当前预览页位置从发布页返回组卷页时暂存供二次编辑完成后恢复到发布页

生成结果与跳转

  1. PDF生成成功后,系统需产出可预览的PDF结果并回填到发布页,供教师继续填写标题、班级、备注等发布信息。
  2. 生成成功前,不得提前创建“已发布作业”实体;组卷结果仍处于临时编辑态。
  3. 若教师从发布页返回组卷工作台继续修改,需保留上一次发布页已填写的上下文信息,供再次返回发布页时恢复。

异步、空态与错误态

场景页面反馈
首次进入组卷页加载中左侧大纲、中间画布、右侧属性面板展示骨架态;顶部操作保留但“完成”不可点击
暂存区为空展示“暂无未分配题目”文案,不展示错误态
画布预览刷新中当前页展示轻量刷新反馈,避免整页闪烁
保存草稿失败Toast提示失败原因,页面保留当前编辑状态,支持再次保存
PDF生成失败关闭生成中弹窗,Toast提示“PDF生成失败,请检查网络后重试”,按钮恢复可点击

业务规则引用

  1. R02:作业篮为当前学科下的全局共享容器,组卷页需承接资源中心的题篮结果并处理增删题后的结构同步。
  2. R03:组卷工作台支持保存组卷草稿,且与发布页上下文暂存共同构成中断恢复能力。
  3. R04:组卷页生成的PDF预览结果,是发布页满足“题目数≥1、PDF预览可用”前提的上游输入。

3.4 发布作业

3.4.1 前置

(选填项)

  1. 教师已在组卷工作台完成组卷。
  2. 系统已成功生成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 必须存在且预览可访问预览区或页面顶部错误提示禁止发布,提供“编辑试卷”入口
重复点击保护发布事务发起后同一前端页面不可重复发起发布请求按钮置灰 + 文案改为“发布中…”等待结果返回

暂存、恢复与清理规则

  1. 发布上下文的暂存内容至少包括:作业标题、作业备注、已选班级ID集合、当前预览页位置。
  2. 点击“编辑试卷”返回组卷工作台时,必须立即写入发布上下文暂存,确保教师往返修改时不重复录入。
  3. 从组卷工作台再次进入发布页时,系统优先恢复暂存的标题、备注、已选班级和预览页位置,再加载最新PDF预览。
  4. 若组卷页重新生成了新版本PDF,则恢复上下文时只能复用表单内容和页位置语义,不能继续展示旧版PDF内容。
  5. 点击“退出”并确认离开时,系统清空发布上下文,不保留未发布内容。
  6. 发布成功后,系统也必须清空发布上下文,避免教师下一次新建作业时串用旧数据。
  7. 暂存范围仅对当前教师本人、当前浏览器会话有效,不自动生成独立草稿作业。

弹窗与反馈规格

组件触发条件标题/文案按钮行为
退出确认弹窗教师点击顶部“退出”标题:“确认退出发布页?”;正文:明确告知当前填写的作业标题、班级选择、作业备注不会自动保存“取消”“确认退出”取消则关闭弹窗;确认退出则清空发布上下文并返回作业列表
发布成功Toast发布事务成功文案:“发布成功,即将跳转至作业中心…”2秒后自动跳转作业列表,并高亮最新发布作业
发布失败提示发布事务失败展示失败原因摘要,如网络超时、服务异常、班级失效等“重试发布”或“编辑试卷”不清空页面内容,允许教师自行决定下一步

发布事务与数据落库

  1. 前端提交发布请求时,携带当前 PAPER_SNAPSHOT 标识、作业标题、备注、班级列表和发布人身份信息。
  2. 服务端发布成功时,创建 HOMEWORK 主记录,至少写入:homework_idpaper_idpublisher_idtitleremarkpublish_atstatus=WAIT_SUBMIT
  3. 服务端按所选班级创建 HOMEWORK_CLASS 关系记录,固化班级范围、班级名称快照和应提交人数口径,避免后续班级结构变化直接污染历史作业统计。
  4. 发布成功的作业必须引用当前版本 PAPER_SNAPSHOT,确保后续打印、提交识别、批改和报告分析都基于同一份卷面快照。
  5. 发布成功前,不得提前写入“已发布作业”可见记录;发布失败也不得生成半成品任务。
  6. 发布成功后,作业列表中该作业初始聚合状态为“待提交”,后续再根据学生提交和教师批改结果流转到其他状态。

失败与边界处理

场景处理规则
标题为空或仅空格标题区红框提示,焦点回到输入框,不清空其他已填字段
未选择班级班级区红框提示,并滚动定位到班级选择器
预览页码输入非法在快捷翻页区下方提示错误;保留当前页,不触发跳转
PDF不存在、失效或加载失败页面进入不可发布状态;“立即发布”禁用;教师只能返回组卷工作台重新生成
恢复上下文后部分班级失效自动剔除失效班级并提示教师重新确认;若剩余有效班级为0,则禁止发布
返回组卷页后卷面结构变化保留标题、备注、班级,但必须以最新PDF预览替换旧预览,避免误发布旧卷面
发布接口失败或弱网超时保留当前表单内容与预览页位置;按钮恢复可点击;允许重试发布
连续重复点击提交前端通过按钮置灰拦截重复点击;服务端按同一发布请求做幂等保护
教师主动退出必须通过退出确认弹窗二次确认;确认后不生成任何作业记录

页面入口、回退与初始化时序

场景入口条件系统初始化动作教师可感知结果
首次从组卷工作台进入发布页教师点击“完成”,且组卷页已成功生成最新 PAPER_SNAPSHOT拉取当前试卷快照、初始化预览页为第1页、加载班级权限范围、回填默认标题页面进入“可发布待确认”状态
从“编辑试卷”返回发布页当前教师存在发布上下文暂存优先恢复标题、备注、班级、预览页位置,再用最新 PAPER_SNAPSHOT 覆盖旧预览教师无需重复录入,只需核对卷面是否变化
无快照直达发布页缺少合法 paper_snapshot_id 或快照已失效不进入正常表单态,直接展示不可发布说明仅允许返回组卷工作台重新生成
页面刷新后重进当前浏览器会话仍保有有效发布上下文与快照引用先校验快照与班级权限,再恢复表单字段合法则恢复现场,非法则提示重新确认
  1. 页面初始化顺序必须固定为:校验 PAPER_SNAPSHOT 有效性 -> 加载教师可发布班级 -> 恢复发布上下文 -> 渲染 PDF 预览与右侧表单。
  2. 若快照可用但班级接口加载失败,页面不得默认允许发布,而应进入“部分数据加载失败”状态并提供重试。
  3. 若发布上下文与最新快照不一致,系统以最新快照为准,仅复用不影响卷面正确性的表单字段。
  4. 发布页不是可独立长期保存的草稿页,任何初始化恢复都基于“临时上下文”而不是“已发布作业”。

概览字段口径定义

字段数据来源展示形式口径说明
总题数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、权限均合法时可执行条件不满足时保持禁用或点击后拦截拒绝任何绕过前端校验的非法请求
  1. 前端的禁用态仅用于减少误操作,不能替代服务端权限和参数校验。
  2. 若教师权限在页面停留期间发生变化,以提交时的实时权限校验结果为准。
  3. 班级名称、所属年级、应提交人数必须在发布时固化快照,避免后续组织架构变化影响历史作业。

发布事务时序与幂等要求

阶段系统动作成功结果失败处理
提交前校验校验标题、班级、快照、权限、单班/多班约束允许进入发布中任一失败即阻断,不写入任何发布记录
创建作业主记录写入 HOMEWORK 主实体返回 homework_id回滚事务,不生成半成品作业
创建班级关系按班级写入 HOMEWORK_CLASS固化目标班级范围任一失败则整单失败并回滚
建立后续消费引用绑定 PAPER_SNAPSHOT、统计口径、发布人信息后续提交/批改/报告使用同一快照失败则整单失败并回滚
返回发布结果返回成功态、列表跳转所需信息前端展示成功并跳转返回明确失败原因并允许重试
  1. 发布接口必须支持幂等控制,建议以前端生成的 publish_request_id 或服务端会话令牌作为幂等键,避免弱网重试造成重复发布。
  2. 同一 PAPER_SNAPSHOT 在“纸质教辅单班发布”场景下,若教师短时间内重复提交同一班级,服务端需识别重复意图并返回已存在结果或明确冲突提示。
  3. 事务成功判定标准不是“接口返回200”,而是 HOMEWORKHOMEWORK_CLASS 和快照绑定全部落库成功。
  4. 发布成功后再清理前端上下文;发布失败时严禁提前清空,防止教师重复录入。

数据对象与字段要求

对象核心字段用途备注
PAPER_SNAPSHOTpaper_snapshot_idpaper_idpage_countquestion_counttotal_scorepaper_code作为发布前卷面唯一依据发布后需与作业记录强绑定
HOMEWORKhomework_idpaper_snapshot_idtitleremarkpublisher_idpublish_atstatus记录一次作业发布主体初始状态固定为 WAIT_SUBMIT
HOMEWORK_CLASShomework_class_idhomework_idclass_idclass_name_snapshotgrade_name_snapshotexpected_submit_count记录发布对象范围统计按作业-班级维度展开
PUBLISH_CONTEXT_CACHEtitleremarkselected_class_idscurrent_pagesnapshot_ref支撑临时恢复仅当前教师、当前会话有效
  1. HOMEWORK.title 与 PDF 内标题允许不一致,这是“任务标题”和“卷面标题”的有意分离。
  2. remark 为弱结构化补充字段,不参与后续批改识别,但会影响学生端任务说明展示。
  3. expected_submit_count 应在发布时按班级有效学生人数快照计算,不在查看列表时实时反推。

页面反馈、弱网与可恢复性要求

场景交互反馈恢复策略
预览加载较慢左侧骨架屏 + 页数占位,右侧基础表单框架先渲染预览成功后再解除发布按钮限制
班级数据加载失败班级区局部错误态 + 重试按钮重试成功前禁止发布
发布请求超时顶部或按钮附近提示“发布请求超时,请确认结果后重试”先查询本次幂等键结果,再决定是否允许再次提交
跳转列表失败保留当前成功提示并提供“返回作业列表”按钮不影响已完成发布结果
浏览器意外关闭后重开若会话上下文仍在且快照有效,则恢复现场否则提示重新进入组卷工作台生成
  1. 所有失败提示都必须告诉教师“下一步该做什么”,不能只给技术性报错。
  2. 发布页必须优先保证“填写内容不丢”,其次才是瞬时反馈样式完整。
  3. 在大班额场景下,班级树与人数口径的加载不得阻塞整页超过可接受阈值,必要时采用分段加载并先保障当前年级可用。

埋点与分析要求

埋点事件触发时机关键参数用途
publish_page_view发布页首屏完成渲染入口来源、paper_snapshot_id、题目数、页数统计发布页到达率与来源结构
publish_edit_back_click点击“编辑试卷”当前已填标题长度、已选班级数、当前预览页识别发布前回退原因与频次
publish_class_select_change班级选择发生变化选择动作类型、班级数、年级数、作业类型分析班级选择复杂度
publish_submit_click点击“立即发布”标题是否有效、班级数、快照状态、入口来源识别提交前阻断率
publish_submit_result发布接口返回结果成功/失败、失败原因、耗时、班级数监控成功率与性能
publish_exit_confirm点击退出并二次确认是否已填写标题、是否已选班级、是否有备注识别主动放弃场景
  1. 所有埋点都应携带 teacher_id、入口来源和作业类型,便于区分个性化作业与纸质教辅作业的发布行为差异。
  2. publish_submit_result 需区分“前端校验失败未发请求”和“服务端请求失败”两类失败口径。
  3. 若后续发现教师大量在发布页返回组卷页,应反向推动优化组卷工作台的完成前检查与预览能力。

业务规则引用

  1. R01:个性化作业与纸质教辅作业在班级选择策略上不同,发布页必须体现多班/单班差异。
  2. R03:发布页支持“发布上下文暂存”,并与组卷草稿共同构成中断恢复能力。
  3. R04:发布前必须满足标题必填、至少选择一个班级、题目数≥1、PDF预览可用。
  4. R05:发布成功后作业进入“待提交”状态,并按作业-班级维度生成执行记录。

3.5 批改

3.5.1 前置

  1. 当前作业至少存在 1 名学生的有效提交记录;作业整体状态为“待批改”或“已批改但允许再次进入修正”。
  2. 教师从作业列表点击“批改作业”进入批改页,系统需携带 homework_id、当前班级范围、最近一次批改定位信息。
  3. 系统已完成以下基础数据预加载:
    • 作业基础信息:作业标题、班级、发布时间、作业备注、关联 PAPER_SNAPSHOT
    • 学生队列信息:学生名单、提交状态、提交时间、当前批改状态、是否存在 AI 结果。
    • 当前学生数据:原卷图片/答题卡、题目结构、标准答案、题目满分、历史教师保存结果、AI 建议结果、提交记录版本列表。
  4. 当前登录教师具备该作业的查看与批改权限;若无权限,则不允许进入批改页。
  5. 批改页默认以“教师最终确认”为核心目标,不以 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辅助触发与采纳规则

  1. AI辅助批改必须由教师显式触发,不能在进入页面后自动对所有学生发起任务。
  2. 同一学生已存在“处理中/排队中”AI任务时,不允许重复发起新任务,避免并发污染。
  3. AI结果返回后,只能回填到“建议值”区域,不能直接覆盖教师已手动填写的最终分值。
  4. 教师如选择采纳 AI 建议,应支持:
    • 单题采纳;
    • 当前题组批量采纳;
    • 当前学生整份试卷批量采纳。
  5. 教师一旦对 AI 建议进行人工修改,页面应标记该题为“人工调整后”,便于后续追溯。
  6. AI结果仅作为过程性参考数据保存,不作为最终对学生生效的成绩数据。

保存与切换规则

场景规则
保存当前学生写入当前学生的教师最终确认结果、题目级得分、教师备注、保存人、保存时间;成功后刷新学生队列与作业整体进度
保存中保存按钮进入 loading 并全局防重复提交;同一学生不允许连续重复点击多次保存
保存成功Toast 提示“批改已保存”;若存在下一位待处理学生,默认自动跳转下一位
保存失败保留页面当前改动,不清空输入内容,提示“保存失败,请重试”
切换下一位学生当前学生存在未保存改动时,必须先弹确认;确认后放弃未保存改动并切换
全部批改完成页面顶部展示完成提示,并提供“查看作业报告”主按钮
中途退出若存在未保存改动,弹出二次确认弹窗;确认离开后不保存本次改动
并发冲突若同一学生结果已被其他端或其他教师更新,保存时需提示“结果已更新,请刷新后再处理”,不得静默覆盖

弹窗与反馈规格

组件触发条件标题/文案按钮行为
离开确认弹窗教师返回列表、关闭页面或切换其他学生时存在未保存改动标题:“当前批改尚未保存,确认离开?”;正文:明确告知未保存的题目分数与备注将丢失“继续编辑”“确认离开”继续编辑则关闭弹窗;确认离开则放弃未保存改动并执行原操作
一键全对确认弹窗教师对当前题组/整份试卷执行“一键全对”,且存在已修改题目标题:“确认覆盖当前已有判分结果?”“取消”“确认覆盖”确认后统一写入满分建议值
保存成功 Toast当前学生批改保存成功文案:“批改已保存”2 秒自动消失;如存在下一位待处理学生则自动切换
AI失败提示AI任务失败或返回不可用文案:“AI辅助批改失败,请改为人工批改或稍后重试”“人工批改”“重试AI”不影响当前人工判分内容
全部完成引导当前作业下已无待批改学生文案:“当前作业已全部批改完成”“查看作业报告”“返回作业列表”引导教师进入分析闭环或返回列表

数据落库与回流

  1. 教师点击“保存批改”成功后,服务端至少写入以下数据:
    • 学生级批改结果:homework_idstudent_idpaper_snapshot_idgrader_idfinal_scorecommentgraded_atgrading_source=teacher_web
    • 题目级结果:题目/小题 ID、满分、教师最终分数、判定标签、是否参考 AI、是否人工调整。
    • 过程追溯信息:所依据的提交记录版本、AI任务 ID/状态快照、保存版本号。
  2. 教师最终结果写入成功后,才允许更新学生级状态为“已批改”;不能在保存前提前变更状态。
  3. 服务端需同步刷新该作业的聚合进度,包括:已提交人数、待批改人数、已批改人数、异常人数。
  4. 教师最终保存结果是学生端“批改结果”、教师端“作业报告/学生学情”的唯一成绩口径;AI 建议值不得直接对外暴露为最终分数。
  5. 若保存事务中任一关键写入失败,整次保存必须回滚,不得出现“部分题目已写入、学生状态未更新”的脏数据。

异常与边界

场景处理规则
当前学生无有效原卷图片队列标记“提交异常”;教师仍可查看结构化答案并人工判分;若两者都不可用,则提示联系补交
原卷图片部分缺页缺页页码显式标红;教师可先批改其他题目,但保存前需确认缺页题目的处理结果
学生存在多次提交默认按最新有效记录展示,同时保留历史记录切换能力;最终保存需记录所依据的提交版本
AI长时间处理中超过阈值后转为“处理超时”,提示教师改为人工批改,并保留后续手动重试入口
网络中断页面顶部提示网络异常;未保存改动保留在当前页面内存中,待网络恢复后允许继续保存
服务端返回版本冲突提示教师当前学生结果已被更新,提供“刷新查看最新结果”入口
当前作业无待批改学生展示完成态,不再默认落到空白批改面板
报告尚未生成全部批改完成后若报告仍在计算,展示“报告生成中”,允许先返回列表

业务规则引用

  1. R06:批改必须基于可追溯的提交记录版本进行,不以单次最新上传简单覆盖。
  2. R07:AI批改仅提供建议值;低置信度、失败、结构不完整时必须降级为人工确认。
  3. R08:只有教师保存后的结果才是最终有效成绩,并回流影响学生端结果与教师报告统计。

3.6 作业报告

3.6.1 前置

(选填项)

  1. 当前作业已完成发布,系统已生成“作业-班级”执行关系,供提交、批改、报告统计消费。
  2. 当前班级至少已存在以下任一数据:提交记录、教师确认批改结果、报告生成任务;若三者均不存在,仅允许展示空态。
  3. 教师从作业列表点击“作业报告”,或在批改页完成当前作业最后一位学生保存后进入作业报告页。
  4. 报告页默认按“作业 + 班级”维度展示;若同一份作业发布到多个班级,则必须先选择班级口径后再查看结果。

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核心目标关键动作不应承载的内容
作业分析帮教师快速看懂班级整体表现班级切换、查看名单、刷新报告不承载单题级完整详情
题目分析帮教师定位高错题并回流再出题排序、筛选、展开解析、加入作业篮不承载学生个体完整画像
学生学情帮教师定位重点学生并继续个体下钻筛选评价、复制名单、错题分析、作业评价不承载跨班对比或公开排行

状态与数据口径

场景页面展示规则
数据生成中顶部保留基础信息和班级切换,指标区与图表区展示骨架屏和“报告生成中”提示
仅有提交数据、无批改结果仅展示提交情况、批改进度、未交名单,不展示最高分、最低分、知识点结论、评价分布
部分学生已批改允许展示基于已批改学生的阶段性数据,但必须在模块标题旁标记“阶段数据”
全部批改完成展示完整结果型模块,允许继续下钻错题分析和学生评价
当前模块加载失败仅当前模块展示错误态和“重试”按钮,不影响其他模块浏览
当前班级无提交展示班级空态和催交提示,不输出任何误导性统计结论

回流规则

  1. 从题目分析页加入作业篮后,题目写入当前教师作业篮,不立即生成新作业。
  2. 从作业篮进入选题中心或组卷工作台后,返回报告页时需保留当前班级和Tab状态。
  3. 从学生学情进入错题分析或学生评价后,返回时必须恢复原Tab、原筛选条件和滚动位置。
  4. 从批改页进入报告页时,若当前班级仍有未批改学生,报告页需优先提示“仍有待批改学生”,避免教师误以为分析已完整。

异常与边界

场景处理方式
无提交数据展示空态,不输出平均分、正确率、评价分布等结论型指标
无批改数据仅展示进度型数据,并引导教师回到批改页
部分学生缺页提交名单弹窗和学生学情列表应能体现“缺第X页”信息,避免教师误判为未提交整份作业
图表或知识点模块数据缺失模块展示“数据暂未生成”说明,不直接显示0,避免误导教师
班级切换后数据较大当前Tab显示局部加载态,顶部公共区保持可操作,避免整页白屏
作业篮写入失败保留按钮原状态并Toast提示“加入失败,请重试”,不允许前端假成功
批量复制名单失败提示教师重试或手动复制,不影响弹窗继续使用
公开展示场景默认不展示公开排名,不在名单复制内容中附带分数、评价等敏感信息

业务规则引用

  1. R08、R09、R10、R12。

3.7 错题分析

3.7.1 前置

(选填项)

  1. 当前作业至少存在 1 个已批改完成班级,且该班级下已有可用于分析的题目作答记录。
  2. 错题分析数据已由批改结果与作业报告链路生成;若数据仍在生成中,允许页面先进入加载态,不直接判定为空。
  3. 教师对当前作业、当前班级具备查看权限,仅允许查看本人任教班级或被授权代课班级的数据。
  4. 教师从作业报告页进入错题分析页,系统需至少携带 作业ID班级ID,如从学生学情或题目分析下钻,还需携带 学生ID题目ID 作为默认定位上下文。
  5. 若当前作业支持多班发布,则错题分析默认继承作业报告页当前选中的班级口径,不额外重置为其他班级。

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 时不展示百分比,仅提示“暂无有效口径”
错误人数展示当前班级下该题做错的学生人数,用于帮助教师判断讲评优先级
知识点展示展示与题目绑定的知识点标签;若存在多个知识点,按主知识点优先,其余以标签形式补充
学生名单口径仅展示当前班级、当前作业、当前上下文下可见的学生;不跨班混合展示
原卷内容优先展示最新有效提交版本;如存在多次提交,仅展示教师最终确认所对应的版本
脱敏规则页面用于公开讲评、投屏或跨班复制场景时,学生姓名需支持脱敏展示,遵循最小暴露原则

筛选、排序与加载策略

场景规则
默认口径默认继承来源页班级口径,并按错误率优先或来源对象优先展示
支持筛选支持按班级查看;题目列表支持按题号顺序或错误率优先浏览;学生名单支持姓名搜索
列表排序在无特定来源上下文时,错题卡片默认按错误率降序、题号升序展示
原卷加载原卷按页懒加载;切换学生或题目时,仅刷新受影响区域,不整页重新加载
名单加载学生名单区默认滚动浏览;若人数较多,优先保证当前选中学生始终可见

异常与边界

场景处理方式
数据生成中展示骨架屏与提示文案“分析数据生成中,请稍后查看”,禁止展示不完整结论
当前班级无错题展示空态文案“本次作业暂无可分析错题”,并提供返回作业报告入口
无高频错题但有个体错题允许展示个体错题视角,不因缺少高频题而整页为空
搜索无结果名单区展示空态“未找到符合条件的学生”,保留当前筛选输入
原卷缺失展示“暂无可查看原卷”,保留文字解析与知识点信息供教师讲评
原卷加载失败展示错误提示与重试按钮,不影响错题卡片区和名单区浏览
题目解析缺失展示“暂无解析”,仍保留正确答案、知识点和教材章节信息
模块加载失败仅当前模块展示错误态与重试按钮,不阻断其他模块已加载内容

业务规则引用

  1. R09、R10、R12。

3.8 学生评价报告

3.8.1 前置

(选填项)

  1. 当前学生已存在本次作业的批改结果与分析数据。
  2. 教师从作业报告页下钻进入学生评价报告页。

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 可用性与兼容性

  1. 教师Web端优先适配Chrome最新版及近两个大版本,兼容Edge Chromium。
  2. 组卷工作台最低分辨率按1440×900设计,低于该分辨率时允许出现滚动,不强求完整首屏。
  3. 列表、报告、批改页需支持弱网下重试与错误提示,不允许无反馈空白页。

6.3 权限矩阵

权限项任课教师班主任教研员/管理角色
查看本人任教班级作业列表
新建个性化作业并发布视配置而定
查看非本人任教班级学生明细视授权而定
查看并确认批改结果视授权而定✅(监管场景)
查看学生评价报告
导出/复制学生名单

6.4 合规与风控基线

  1. AI辅助批改必须保留教师最终判分权,禁止将AI建议值直接对学生生效。
  2. 课堂投屏、公开讲评、跨班展示场景默认脱敏处理学生个人敏感信息。
  3. 学生评价页禁止形成公开排名榜单,仅展示个体结果与评价等级。
  4. 提交图片、批改结果、作业评价等学生相关数据应遵循最小权限可见原则。
  5. 对于AI低置信度结果,需明示“仅供参考”,并要求人工复核后方可保存。

7. 版本规划

版本主要能力目标
V1.0作业列表、资源中心、组卷工作台、发布作业、批改、作业报告基础闭环跑通教师Web主链路
V1.1草稿恢复稳定性、报告回流再出题、未交名单协同、班级口径优化提升教师高频使用效率
V2.0催交协同、报告导出、知识点专项再练、报告智能推荐形成更强的教学闭环与增值能力

8. 遗留问题与待确认

编号问题描述影响范围优先级
Q01纸质教辅作业在当前列表页的状态、字段与操作是否完全复用个性化作业,还是保留独立差异展示?作业列表、发布作业、作业报告P0
Q02“待批改 -> 已批改”的完成判定口径,是否以“全部学生完成教师确认”为准,还是允许部分完成即可生成完整报告?批改、作业报告P0
Q03AI低置信度阈值的产品口径与技术阈值如何对齐,是否需要前端显式暴露置信度等级?批改P0
Q04学生名单复制是否需要默认脱敏,还是仅在公开讲评/投屏场景脱敏?作业列表、作业报告P1
Q05作业草稿是否进入独立草稿箱管理,还是维持当前“入口内恢复”模式?组卷工作台、发布作业P1
Q06作业报告是否需要支持导出PDF/图片、分享给家长或班主任等扩展动作?作业报告、学生评价报告P1
当前这页已经是“原型 + 页面 PRD”评审工作台。跨页面规则请维护在总览 / 全局规则文档,页面细节请直接维护右侧页面 PRD。
Review Workspace - Prototype + Page PRD