面向开发、测试人员:说明当前原型的页面结构、角色权限、数据流向、字段口径与交互规则。 更新日期:2026-10-15(系统配图已按当前版本重新生成)
5173 端口。本仓库仅交付“数据统计”独立模块,包含以下五个页面状态。
README.md是本模块唯一的需求说明文档,页面内不再提供“需求说明”入口。
数据统计首页
├─ 数据报表
│ ├─ 考试情况统计(分级考试 / 应知应会 / 入学考试)─→ 考试人员明细
│ ├─ 实验室与人员匹配 ─→ 实验室匹配人员明细
│ └─ 学时统计
└─ 常规考试
├─ 常规考试汇总统计 ─→ 常规考试明细(人员列表)
└─ 学时统计(与数据报表使用相同卡片)
| 页面 | 用途 | 主要入口 |
|---|---|---|
| 数据统计首页 | 通过“数据报表 / 常规考试”切换两类统计视图;不同学校项目可配置常规考试页签是否显示 | 系统菜单列表 |
| 常规考试汇总统计 | 按学院汇总常规考试结果,并按单场考试查看列表 | 数据统计首页“常规考试”页签 |
| 学时统计 | 按用户类别、学院及年级展示人员安全教育学时 | 数据报表、常规考试页签 |
| 考试人员明细 | 展示分级、应知应会、入学等考试对应人员结果 | 考试类型行“人员明细” |
| 常规考试明细 | 展示某一单场常规考试对应人员结果 | 常规考试汇总统计行“人员明细” |
| 实验室匹配人员明细 | 展示人员的实验室匹配状态与实验室信息 | 实验室匹配列表“人员明细” |
| 角色 | 首页数据范围 | 考试明细范围 | 实验室匹配明细范围 | 页面表现 |
|---|---|---|---|---|
| 校级管理员(最高权限) | 可查看全校范围及所有学院创建的全部考试数据 | 可查看全校范围及所有学院创建的全部考试明细 | 可查看全校范围匹配数据 | 展示学院筛选、全校汇总行、导出入口 |
| 院级管理员 | 查看自己创建的考试,以及校级创建且考试范围包含所属学院的考试数据 | 仅查看上述考试在所属学院范围内的人员明细 | 仅所属学院人员 | 不展示跨学院数据与全校汇总 |
权限实现要求:
人员主数据 + 学籍/人员类别
+ 考试报名/应考范围
+ 考试作答与成绩
+ 补考记录
+ 实验室分级与匹配记录
│
▼
权限范围过滤
│
┌───────────┴───────────┐
▼ ▼
考试情况聚合 实验室匹配聚合
学院 + 考试类型 学院 + 实验室风险等级
│ │
▼ ▼
类型/单场考试人员明细 学院/全校人员匹配明细
建议接口处理顺序:先按角色和所属学院限定数据集,再按学年、人员类别、学院、考试类型等条件筛选,最后计算统计指标或返回明细。聚合数值、列表数据和导出数据必须来自同一筛选后的数据集。
| 项目 | 规则 |
|---|---|
| 学年 | 统计与明细页均提供学年筛选;当前原型默认 2026-2027 学年 |
| 人员类别 | 研究生、本科生、教职工;应与查询、统计、导出使用相同条件 |
| 学院筛选 | 校级管理员可选择学院;院级管理员固定为所属学院 |
| 考试类型 | 仅统计分级考试、应知应会、入学考试三类特殊考试;支持按考试类型缩小首页列表,仅展示存在考试数据的类型 |
| 堆叠柱图 | 每个学院作为一个组合,组内依次展示分级考试、应知应会、入学考试三根堆叠柱;每根柱按通过、未通过、未考展示。原型提供 10 个学院示例数据,底部支持横向滚动查看全部学院;悬停展示对应考试类型及三项人数 |
| 结果环图 | 展示当前权限与筛选范围内通过、未通过、未考人数及通过率 |
| 文案 | 使用“未考”作为未参加考试的统一表述 |
| 字段 | 口径 |
|---|---|
| 学院 | 统计归属学院;全校行显示“全校”并在列表底部展示 |
| 考试类型 | 分级考试、应知应会、入学考试;仅展示有数据类型,常规考试不在数据报表列表展示 |
| 应考人数 | 当前筛选范围内,被纳入该考试的人员数 |
| 实考人数 | 已参加考试人数,等于通过人数 + 未通过人数 |
| 通过人数 | 考试结果为通过的人数 |
| 未通过人数 | 已参加但结果未通过的人数 |
| 未考人数 | 应考但未参加考试的人数 |
| 通过率 | 通过人数 / 实考人数;实考人数为 0 时返回 -- 或按后端约定处理 |
| 操作 | 考试类型行为明细入口;学院汇总行与全校汇总行操作列留空 |
分级考试聚合规则:同一学院内的Ⅰ—Ⅳ级及五个分类组合按分级考试类型汇总展示,即合并统计 20 个分级分类组合的数据。
学年归档规则:学年结束时,系统自动归档该学年三类特殊考试(分级考试、应知应会、入学考试)的统计与明细数据;归档数据应保留原始统计口径,并可按学年查询。
| 首页考试类型行 | 操作文案 | 目标页面 | 传递条件 |
|---|---|---|---|
| 分级考试 | 人员明细 | 考试人员明细 | 学院 + 考试类型 = 分级考试 |
| 应知应会 | 人员明细 | 考试人员明细 | 学院 + 考试类型 = 应知应会 |
| 入学考试 | 人员明细 | 考试人员明细 | 学院 + 考试类型 = 入学考试 |
| 学院汇总 / 全校汇总 | 无 | 无 | 汇总行仅用于展示统计结果 |
数据报表页依次展示考试情况统计、实验室与人员匹配、学时统计卡片;常规考试页签复用完全相同的学时统计卡片。柱图按学院展示研究生、本科生、教职工的完成学时,柱顶常显数值。人员列表字段为姓名、学号、年级、所属学院、第一年至第四年及总时长;支持用户类型、学院、年级、姓名/学号筛选与导出。
常规考试页签采用两级数据结构:先展示“单场考试”汇总,再查看该场考试的人员结果。
| 字段 | 说明 |
|---|---|
| 考试名称筛选 | 位于筛选区首位并加宽展示,支持输入或从单场考试名称中选择;选择后仅展示该单场考试对应列表数据 |
| 学院 | 单场考试所属或统计归属学院 |
| 应考人数 / 实考人数 | 口径与考试情况统计一致 |
| 通过人数 / 未通过人数 / 未考人数 | 按该单场考试和当前筛选范围汇总 |
| 通过率 | 通过人数 / 实考人数 |
| 操作 | “人员明细”,进入当前单场考试的常规考试明细 |
页面筛选:年份(首位,默认当前年份,支持“全部年份”)、考试名称(首位加宽输入选择框,候选项随年份变化)、学院;不提供用户类别筛选。年份与考试名称可组合查询。列表按页展示,默认每页 3 条数据。列表右侧显示“共组织常规考试 * 次”,次数随当前筛选结果统计;进入人员页时自动带入学院、考试类型 常规考试 与考试名称。
| 项目 | 说明 |
|---|---|
| 页面标题 | 分级/应知应会/入学考试使用“考试类型 + 人员明细”;常规考试使用“常规考试明细” |
| 普通考试筛选 | 学年、学院、考试类型(分级考试、应知应会、入学考试)、考试结果、补考结果、人员类别、姓名/学工号;不显示常规考试 |
| 分级分类 | 仅当考试类型为“分级考试”时显示;可选Ⅰ—Ⅳ级,每个等级均可选择化学类、生物类、机电类、辐射类、其他类 |
| 常规考试明细筛选 | 学院、考试结果、补考结果、人员类别(下拉框)、姓名/学工号;不显示学年、考试类型与考试名称筛选,单场考试由上一页传递 |
| 表格字段 | 姓名、学工号、学院、用户类别、考试类型/分级分类、学习情况、考试状态、考试成绩、考试结果、补考成绩、补考结果 |
| 展示方式 | 所有人员明细以右侧抽屉打开,保留来源报表与筛选上下文;关闭抽屉后返回原位置 |
| 分页与导出 | 人员明细列表默认每页 5 条;按当前角色权限与全部已选筛选条件导出明细 |
补考结果取值:通过、未通过、未考;补考成绩无补考或未考时显示 —。考试结果建议值:通过、未通过、未考。
| 项目 | 规则 |
|---|---|
| 头部筛选 | 在导出各学院数据左侧提供年级(全部年级、2025级、2026级)、研究生/本科生筛选 |
| 柱图分类 | 研究生:Ⅰ级(重大风险)、Ⅱ级(高风险)、Ⅲ级(中风险)、Ⅳ级(低风险)、无需进入实验室、未操作;本科生:将“无需进入实验室”显示为“未绑定”,且不展示未操作 |
| 无需进入实验室 | 已完成选择操作,但未进入实验室的人员 |
| 未操作 | 尚未操作实验室绑定的人员 |
| 本科生特殊规则 | 切换为本科生后,柱状图与列表均隐藏“未操作”统计,并将“无需进入实验室”改为“未绑定”;总人数口径不变 |
| 列表操作 | 学院行显示“人员明细”;全校行显示“全部明细” |
| 字段 | 口径 |
|---|---|
| 学院 | 人员所属学院;校级管理员可查看全校行 |
| Ⅰ—Ⅳ级人数 | 按人员已匹配实验室的风险分级统计 |
| 状态人数 | 研究生显示“无需进入实验室人数”;本科生显示“未绑定人数”,均为已完成选择操作但未进入实验室的人员数 |
| 未操作人数 | 未进行实验室绑定选择的人数;仅研究生视图展示该字段 |
| 总人数 | 当前学院所有人员数,包含已绑定、无需进入实验室(本科生文案为未绑定)与未操作人员 |
| 操作 | 进入当前学院或全校范围的匹配人员明细 |
| 项目 | 说明 |
|---|---|
| 进入范围 | 学院行进入当前学院;全校行进入全部学院;均需继续受当前用户权限限制 |
| 同步筛选 | 年级(全部年级、2025级、2026级)、研究生/本科生,与实验室匹配首页保持一致 |
| 明细筛选 | 学院、分级分类、匹配状态、姓名/学工号 |
| 表格字段 | 姓名、学工号、学院、状态、分级、分类、实验室 |
| 状态 | 研究生:已绑定、无需进入实验室、未操作;本科生:仅已绑定、未绑定,不展示未操作记录与筛选项 |
| 实验室展示 | 使用 房间号-实验室名称 格式;无匹配实验室时显示 — |
| 导出 | 仅导出当前权限与当前筛选条件下的人员 |
rnrn## 11. 系统页面配图以下配图均为当前版本本地预览截图,随模块页面迭代同步更新;人员明细采用右侧抽屉交互,字段与筛选说明见第 6、8 节。