555 lines
20 KiB
Markdown
555 lines
20 KiB
Markdown
# 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 验收标准
|
||
|
||
```gherkin
|
||
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 验收标准
|
||
|
||
```gherkin
|
||
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 验收标准
|
||
|
||
```gherkin
|
||
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 验收标准
|
||
|
||
```gherkin
|
||
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 验收标准
|
||
|
||
```gherkin
|
||
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 考虑 |
|
||
| 能力雷达图的维度如何定义？ | 建议按知识分类一级目录 |
|
||
|
||
---
|
||
|
||
**文档状态：待评审**
|