server/training-system

Fork 0

Files

tony b20da3cd06 2026-05-12

2026-05-12 12:24:11 +08:00

20 KiB

Raw Blame History

V2 统计报表中心 - 产品需求文档

版本：V2.0.0-draft 作者：Product Agent 日期：2026-02-04 状态：待评审

一、功能概述

1.1 背景与目标

背景：V1 版本完成了培训系统的基础功能，但管理层无法量化培训效果，讲师无法追踪学员学习情况，缺乏数据支撑决策。

目标：构建统计报表中心，让培训效果可量化、可追踪、可对比。

1.2 目标用户

角色	核心诉求
管理员	全局数据概览，跨部门对比，发现问题部门
讲师	本部门数据，学员学习进度，考试成绩分布
学员	个人学习记录，成绩趋势，与平均水平对比

1.3 功能边界

范围	说明
包含	数据看板、培训统计、考试统计、学员统计、数据导出
不包含	实时监控、预测分析、自定义报表设计器

二、功能清单

2.1 模块总览

统计报表中心
├── 2.1 数据概览看板
│   ├── 关键指标卡片
│   ├── 趋势图表
│   └── 快捷入口
│
├── 2.2 培训统计
│   ├── 培训计划完成率
│   ├── 知识学习统计
│   └── 部门培训排名
│
├── 2.3 考试统计
│   ├── 考试通过率
│   ├── 成绩分布
│   └── 题目正确率分析
│
├── 2.4 学员统计
│   ├── 学员学习排行
│   ├── 个人学习报告
│   └── 学习时长统计
│
└── 2.5 数据导出
    ├── Excel 导出
    └── 定期报表

三、详细需求

3.1 数据概览看板

3.1.1 功能描述

为不同角色提供个性化的数据概览首页，一目了然掌握关键指标。

3.1.2 管理员看板

关键指标卡片（4个）：

指标	计算方式	对比
总学员数	状态=启用的学员数量	较上月增减
本月培训完成率	本月已完成培训人次 / 本月应完成培训人次	较上月变化
本月考试通过率	本月通过考试人次 / 本月参考人次	较上月变化
活跃学员数	本月有学习行为的学员数	较上月增减

趋势图表：

近6个月培训完成率趋势（折线图）
近6个月考试通过率趋势（折线图）
部门培训完成率排名（横向柱状图，TOP 8）

快捷入口：

查看详细培训报表
查看详细考试报表
导出月度汇总

3.1.3 讲师看板

关键指标卡片（4个）：

指标	范围
本部门学员数	本部门
本部门培训完成率	本部门本月
本部门考试通过率	本部门本月
待批阅数	如有主观题（V2暂无）

趋势图表：

本部门近6个月培训完成率趋势
本部门学员学习进度分布（饼图：已完成/进行中/未开始）

3.1.4 学员看板

关键指标卡片（4个）：

指标	说明
我的培训进度	已完成/总计划数
我的考试成绩	最近一次考试分数
学习排名	在本部门的排名
累计学习时长	总学习时长

图表：

我的成绩趋势（近5次考试）
与部门平均分对比

3.1.5 验收标准

Feature: 数据概览看板

Scenario: 管理员查看全局看板
  Given 我是管理员角色
  When 我进入统计报表中心
  Then 我应该看到4个关键指标卡片
  And 我应该看到培训完成率趋势图
  And 我应该看到部门排名图表
  And 所有数据应反映全平台数据

Scenario: 讲师查看部门看板
  Given 我是讲师角色
  When 我进入统计报表中心
  Then 所有数据应仅包含本部门数据
  And 我不应该看到其他部门的数据

Scenario: 指标卡片显示环比变化
  Given 当前月份培训完成率为 80%
  And 上月培训完成率为 75%
  When 我查看培训完成率卡片
  Then 应显示 "+5%" 的环比增长标记
  And 增长应显示为绿色

3.2 培训统计

3.2.1 培训计划完成率

筛选条件：

时间范围：本月/本季度/本年度/自定义
部门：全部/指定部门（管理员可选）
培训计划：全部/指定计划

统计维度：

维度	指标
按计划	计划名称、应参加人数、实际完成人数、完成率
按部门	部门名称、计划数、完成率、排名
按时间	月度完成率趋势

列表展示：

培训计划	部门	应参加	已完成	完成率	状态
2026Q1安全培训	救援一部	50	45	90%	进行中
新员工入职培训	救援二部	20	20	100%	已结束

3.2.2 知识学习统计

统计内容：

知识总数、已发布数
学习总人次
热门知识 TOP 10（按学习人次）
最少学习知识（提醒优化或下架）

3.2.3 验收标准

Feature: 培训统计

Scenario: 按部门查看培训完成率
  Given 我是管理员
  When 我选择按部门维度查看
  Then 应显示所有部门的培训完成率列表
  And 列表应按完成率降序排列
  And 应显示部门排名

Scenario: 筛选指定时间范围
  Given 我在培训统计页面
  When 我选择时间范围为 "2026年1月"
  Then 所有数据应仅包含该月份的培训数据

Scenario: 导出培训报表
  Given 我在培训统计页面
  When 我点击导出按钮
  Then 应下载 Excel 文件
  And 文件应包含当前筛选条件下的所有数据

3.3 考试统计

3.3.1 考试通过率

筛选条件：

时间范围：本月/本季度/本年度/自定义
部门：全部/指定部门
考试：全部/指定考试

统计指标：

指标	说明
参考人数	实际参加考试的人数
通过人数	分数 >= 及格线的人数
通过率	通过人数 / 参考人数
平均分	所有考生的平均分数
最高分 / 最低分	分数极值

3.3.2 成绩分布

图表展示：

分数段分布（柱状图）：0-59 / 60-69 / 70-79 / 80-89 / 90-100
各部门平均分对比（横向柱状图）

列表展示：

考试名称	参考人数	通过率	平均分	最高分	最低分
安全规范考核	120	85%	78.5	98	42
月度技能测试	95	72%	71.2	100	35

3.3.3 题目正确率分析

功能描述：分析每道题的正确率，发现难题和易错题。

统计内容：

字段	说明
题目内容	题干摘要（前50字）
题型	单选/多选/判断
作答人次	该题被作答的总次数
正确率	正确人次 / 作答人次
错误选项分布	各错误选项的选择占比

排序：

默认按正确率升序（易错题优先）
可切换按作答人次排序

用途：

正确率 < 30% 的题目：可能题目有问题或知识点难度大
正确率 > 95% 的题目：可能过于简单

3.3.4 验收标准

Feature: 考试统计

Scenario: 查看考试成绩分布
  Given 我在考试统计页面
  When 我选择某场考试
  Then 应显示分数段分布柱状图
  And 应显示通过率、平均分等指标

Scenario: 查看题目正确率
  Given 我在考试统计页面
  When 我点击 "题目分析"
  And 选择某场考试
  Then 应显示该考试所有题目的正确率
  And 默认按正确率升序排列
  And 可以查看每道题的错误选项分布

Scenario: 识别易错题
  Given 某道题的正确率为 25%
  When 我查看题目分析列表
  Then 该题应标记为 "易错题"
  And 应显示主要错误选项

3.4 学员统计

3.4.1 学员学习排行

排行维度：

学习时长排行（本月/本季度）
考试成绩排行（平均分/最高分）
培训完成数排行

展示内容：

排名	学员	部门	学习时长	完成培训数	平均分
1	张三	救援一部	45h	8	92
2	李四	救援二部	42h	7	88

范围控制：

管理员：可查看全平台排行
讲师：仅可查看本部门排行
学员：可查看本部门排行，自己会高亮显示

3.4.2 个人学习报告

入口：

讲师点击学员姓名进入
学员点击"我的学习报告"进入

报告内容：

模块	内容
基本信息	姓名、部门、入职时间、角色
学习概览	累计学习时长、完成培训数、参加考试数
培训记录	参加的培训计划列表，包含进度和状态
考试记录	参加的考试列表，包含成绩和是否通过
成绩趋势	近10次考试成绩折线图
能力雷达图	按知识分类的掌握程度（基于考试正确率）

3.4.3 学习时长统计

统计规则：

知识学习：从打开到关闭/切换的时长（上限30分钟/次）
视频学习：实际播放时长
考试时长：从开始到交卷的时长

展示：

个人：日/周/月学习时长统计
部门：部门平均学习时长、学习时长分布

3.4.4 验收标准

Feature: 学员统计

Scenario: 查看学习排行榜
  Given 我是讲师
  When 我进入学员排行榜页面
  Then 应显示本部门学员排行
  And 不应显示其他部门学员

Scenario: 查看个人学习报告
  Given 我是讲师
  When 我点击某学员的姓名
  Then 应进入该学员的学习报告页面
  And 应显示该学员的培训记录
  And 应显示该学员的考试记录
  And 应显示成绩趋势图

Scenario: 学员查看自己的报告
  Given 我是学员
  When 我点击 "我的学习报告"
  Then 应显示我的学习报告
  And 应显示我在部门中的排名

3.5 数据导出

3.5.1 Excel 导出

支持导出的报表：

报表	内容	权限
培训完成率报表	按计划/部门的完成率明细	管理员、讲师
考试成绩报表	学员成绩明细	管理员、讲师
学员学习报表	学员学习时长和完成情况	管理员、讲师
题目分析报表	题目正确率明细	管理员、讲师

导出规则：

导出当前筛选条件下的数据
文件名格式：报表类型_日期_导出人.xlsx
单次导出上限：10000 条记录

3.5.2 验收标准

Feature: 数据导出

Scenario: 导出考试成绩报表
  Given 我在考试统计页面
  And 当前筛选条件为 "2026年1月"
  When 我点击导出按钮
  Then 应下载 Excel 文件
  And 文件名应为 "考试成绩报表_20260204_张三.xlsx"
  And 数据应仅包含2026年1月的考试成绩

Scenario: 导出数据量限制
  Given 当前筛选条件下有 15000 条记录
  When 我点击导出按钮
  Then 应提示 "数据量超过限制，请缩小筛选范围"

四、数据模型（建议）

4.1 新增统计表（可选，用于性能优化）

日统计汇总表 (stat_daily_summary)

字段	类型	说明
id	Long	主键
stat_date	Date	统计日期
department_id	Long	部门ID（0=全平台）
total_users	Integer	学员总数
active_users	Integer	活跃学员数
training_complete_count	Integer	培训完成人次
exam_pass_count	Integer	考试通过人次
exam_total_count	Integer	考试参与人次
total_learning_minutes	Long	总学习时长（分钟）

学习时长记录表 (stat_learning_log)

字段	类型	说明
id	Long	主键
user_id	Long	用户ID
knowledge_id	Long	知识ID
start_time	DateTime	开始时间
end_time	DateTime	结束时间
duration_seconds	Integer	学习时长（秒）
create_time	DateTime	创建时间

五、页面原型

5.1 管理员数据看板

┌────────────────────────────────────────────────────────────────────────────┐
│  统计报表中心                                                              │
├────────────────────────────────────────────────────────────────────────────┤
│                                                                            │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐             │
│  │  总学员数   │ │ 培训完成率  │ │ 考试通过率  │ │ 活跃学员数  │             │
│  │    486     │ │    82%     │ │    78%     │ │    312     │             │
│  │   +12 ↑   │ │   +5% ↑   │ │   -2% ↓   │ │   +28 ↑   │             │
│  └────────────┘ └────────────┘ └────────────┘ └────────────┘             │
│                                                                            │
│  ┌─────────────────────────────────┐ ┌─────────────────────────────────┐  │
│  │ 培训完成率趋势                   │ │ 部门培训完成率排名               │  │
│  │                                 │ │                                 │  │
│  │  100%│                         │ │ 救援一部  ████████████  92%     │  │
│  │   80%│    ╭──╮    ╭──╮        │ │ 救援三部  ██████████    85%     │  │
│  │   60%│╭──╯  ╰──╮╭╯  ╰──      │ │ 救援二部  █████████     80%     │  │
│  │   40%│           ╰            │ │ 救援四部  ███████       72%     │  │
│  │      └─────────────────       │ │ 综合部    ██████        65%     │  │
│  │       9  10  11  12  1   2    │ │                                 │  │
│  └─────────────────────────────────┘ └─────────────────────────────────┘  │
│                                                                            │
│  [查看培训详情]  [查看考试详情]  [导出月度报表]                            │
│                                                                            │
└────────────────────────────────────────────────────────────────────────────┘

5.2 考试统计页面

┌────────────────────────────────────────────────────────────────────────────┐
│  统计报表中心 > 考试统计                                                   │
├────────────────────────────────────────────────────────────────────────────┤
│                                                                            │
│  时间范围: [本月 ▼]  部门: [全部 ▼]  考试: [全部 ▼]    [查询]  [导出]    │
│                                                                            │
│  ┌─────────────────────────────────┐ ┌─────────────────────────────────┐  │
│  │ 成绩分布                         │ │ 汇总指标                        │  │
│  │                                 │ │                                 │  │
│  │      ┌───┐                      │ │  参考人数:     320              │  │
│  │      │   │ ┌───┐                │ │  通过人数:     256              │  │
│  │ ┌───┐│   │ │   │ ┌───┐         │ │  通过率:       80%              │  │
│  │ │   ││   │ │   │ │   │ ┌───┐   │ │  平均分:       76.5             │  │
│  │ │   ││   │ │   │ │   │ │   │   │ │  最高分:       100              │  │
│  │ └───┘└───┘ └───┘ └───┘ └───┘   │ │  最低分:       32               │  │
│  │ 0-59 60-69 70-79 80-89 90-100  │ │                                 │  │
│  └─────────────────────────────────┘ └─────────────────────────────────┘  │
│                                                                            │
│  ┌──────────────────────────────────────────────────────────────────────┐  │
│  │ 考试名称          参考人数   通过率   平均分   最高分   操作         │  │
│  ├──────────────────────────────────────────────────────────────────────┤  │
│  │ 安全规范考核        120       85%     78.5     98     [详情][分析]  │  │
│  │ 月度技能测试         95       72%     71.2    100     [详情][分析]  │  │
│  │ 新员工入职考试       45       91%     82.3     96     [详情][分析]  │  │
│  └──────────────────────────────────────────────────────────────────────┘  │
│                                                                            │
│                                                      < 1  2  3 >          │
└────────────────────────────────────────────────────────────────────────────┘

六、非功能需求

类型	要求
性能	看板页面加载时间 < 2秒
性能	报表查询响应时间 < 3秒（万级数据）
兼容性	支持 Chrome、Edge、Firefox 最新版本
数据安全	严格按角色和部门隔离数据
导出	Excel 导出支持 .xlsx 格式

七、不做什么（Out of Scope）

排除项	原因
实时数据监控	V2 不需要实时性，T+1 统计即可
自定义报表设计器	复杂度高，用户需求不明确
数据预测/AI分析	数据量不足，价值有限
打印报表	使用 Excel 导出替代

八、里程碑建议

阶段	内容	建议周期
M1	数据看板（管理员+讲师+学员）	-
M2	培训统计 + 考试统计	-
M3	学员统计 + 数据导出	-
M4	测试 + 优化	-

九、开放问题

问题	待确认
学习时长统计是否需要精确到秒级？	建议分钟级即可
是否需要支持定时自动发送报表邮件？	建议 V3 考虑
能力雷达图的维度如何定义？	建议按知识分类一级目录

文档状态：待评审

20 KiB Raw Blame History Unescape Escape

V2 统计报表中心 - 产品需求文档

一、功能概述

1.1 背景与目标

1.2 目标用户

1.3 功能边界

二、功能清单

2.1 模块总览

三、详细需求

3.1 数据概览看板

3.1.1 功能描述

3.1.2 管理员看板

3.1.3 讲师看板

3.1.4 学员看板

3.1.5 验收标准

3.2 培训统计

3.2.1 培训计划完成率

3.2.2 知识学习统计

3.2.3 验收标准

3.3 考试统计

3.3.1 考试通过率

3.3.2 成绩分布

3.3.3 题目正确率分析

3.3.4 验收标准

3.4 学员统计

3.4.1 学员学习排行

3.4.2 个人学习报告

3.4.3 学习时长统计

3.4.4 验收标准

3.5 数据导出

3.5.1 Excel 导出

3.5.2 验收标准

四、数据模型（建议）

4.1 新增统计表（可选，用于性能优化）

日统计汇总表 (stat_daily_summary)

学习时长记录表 (stat_learning_log)

五、页面原型

5.1 管理员数据看板

5.2 考试统计页面

六、非功能需求

七、不做什么（Out of Scope）

八、里程碑建议

九、开放问题

20 KiB

Raw Blame History