120 lines
4.8 KiB
Markdown
120 lines
4.8 KiB
Markdown
# 培训计划学员进度计算逻辑说明
|
||
|
||
本文档说明了在生成“在线教育培训月度统计表”时，学员完成培训进度的计算逻辑及相关数据库表关联关系。
|
||
|
||
## 1. 总体进度计算逻辑
|
||
|
||
学员的培训进度取决于 `hot_training_participant` 表中的状态。
|
||
|
||
### 1.1 已完成学员
|
||
如果学员在 `hot_training_participant` 表中的 `is_completed` 字段为 `1`（或 `complete_time` 不为空），则该学员的进度直接记为 **100%**。
|
||
这意味着学员已经完成了所有的课程学习以及综合检测（如果有）。
|
||
|
||
### 1.2 未完成学员
|
||
如果学员尚未完成（`is_completed = 0`），则进度计算公式如下：
|
||
|
||
$$
|
||
\text{总进度} = \frac{\sum \text{各课程进度} + \text{综合检测进度}}{\text{课程数量} + 1}
|
||
$$
|
||
|
||
* **课程数量**：当前培训计划包含的课程总数（来自 `hot_training_course_config`）。
|
||
* **综合检测进度**：对于未完成学员，综合检测部分默认记为 **0%**。
|
||
* **各课程进度**：见下文详细计算。
|
||
|
||
---
|
||
|
||
## 2. 单门课程进度计算逻辑
|
||
|
||
对于培训计划中的每一门课程，其进度计算取决于该课程是否包含**随堂练习**（题目）。
|
||
|
||
### 2.1 判断课程是否有随堂练习
|
||
1. 通过 `hot_training_course_config` 表找到对应的 `course_id`。
|
||
2. 查询 `hot_course_resource` 表，条件为 `course_id` 且 `resource_type = 3`（题目）。
|
||
3. 如果存在记录，则认为该课程包含随堂练习；否则认为不包含。
|
||
|
||
### 2.2 课程进度计算公式
|
||
|
||
#### 情况 A：无随堂练习
|
||
$$
|
||
\text{课程进度} = \text{视频播放进度}
|
||
$$
|
||
* **视频播放进度**：取 `hot_training_course_record` 表中该用户该课程的 `progress_rate`（百分比值，最大100）。
|
||
|
||
#### 情况 B：有随堂练习
|
||
$$
|
||
\text{课程进度} = (\text{视频播放进度} \times 90\%) + (\text{随堂练习得分} \times 10\%)
|
||
$$
|
||
* **视频播放进度**：同上。
|
||
* **随堂练习得分**：
|
||
* 检查 `hot_training_course_record` 表中的 `check_status` 字段。
|
||
* 如果 `check_status = 1`（已完成），则得分为 **100**。
|
||
* 否则，得分为 **0**。
|
||
|
||
---
|
||
|
||
## 3. 课程时长计算逻辑（分钟）
|
||
|
||
“教育培训内容”区域除展示课程名称外，同时展示每门课程的视频总时长（分钟）。
|
||
|
||
### 3.1 计算步骤
|
||
|
||
1. 通过 `hot_training_course_config` 获取当前培训计划的课程列表（按 `sort_no` 排序），得到每门课的 `course_id`。
|
||
2. 查询 `hot_course_resource` 表中该 `course_id` 下的视频资源：
|
||
- 条件：`course_id = ? AND resource_type = 1`（视频）
|
||
- 得到视频资源 ID 列表：`resource_id`（对应 `hot_media_resource.id`）
|
||
3. 查询 `hot_media_resource` 表，按资源 ID 集合汇总视频时长：
|
||
- 汇总字段：`SUM(duration_seconds)`
|
||
4. 将秒数转换为分钟并向上取整：
|
||
- `duration_min = ceil(duration_seconds / 60)`
|
||
|
||
### 3.2 展示规则
|
||
|
||
- 若课程无视频资源或汇总时长为空，则时长列显示空白。
|
||
- 否则显示 `X分钟`。
|
||
|
||
---
|
||
|
||
## 4. 学习记录表 - 学习时长计算逻辑
|
||
|
||
在“学习记录表”中，会显示“学习分钟数/计划分钟数”。
|
||
|
||
### 4.1 计划分钟数
|
||
逻辑同第3节“课程时长计算逻辑”，为该培训计划下所有课程视频时长的总和（分钟，向上取整）。
|
||
|
||
### 4.2 学习分钟数
|
||
取 `hot_training_course_record` 表中的 `learn_duration_min` 字段。
|
||
**注意**：尽管字段名为 `min`，但在实际业务中存储的是**秒**。
|
||
因此计算逻辑为：
|
||
1. 获取该用户在该培训计划下所有课程的学习记录。
|
||
2. 若同一课程有多条记录，取 `learn_duration_min` 最大值。
|
||
3. **对于每一门课程，将其学习时长与该课程的计划视频时长进行比较，取较小值（即学习时长不大于课程时长）。**
|
||
4. 累加所有课程的**处理后时长**（秒）。
|
||
5. 将总秒数除以 60 并向上取整，得到最终的学习分钟数。
|
||
|
||
---
|
||
|
||
## 5. 数据库表关联关系
|
||
|
||
以下是涉及的关键数据库表及其关联方式：
|
||
|
||
1. **hot_training (培训计划主表)**
|
||
* `id`: 培训计划ID
|
||
|
||
2. **hot_training_participant (培训参与人员表)**
|
||
* `training_id`: 关联 `hot_training.id`
|
||
* `user_id`: 学员ID
|
||
* `is_completed`: 是否完成培训 (1=是, 0=否)
|
||
* `complete_time`: 完成时间
|
||
|
||
3. **hot_training_course_config (培训课程配置表)**
|
||
* `training_id`: 关联 `hot_training.id`
|
||
* `course_id`: 关联 `hot_course.id` (实际课程ID)
|
||
* `id`: 培训课程配置ID (用于关联学习记录)
|
||
|
||
4. **hot_course_resource (课程资源关联表)**
|
||
* `course_id`: 关联 `hot_course.id`
|
||
* `resource_type`: 资源类型 (1=视频 2=音频 3=题目)
|
||
* 用于判断课程是否有随堂练习。
|
||
|
||
5. **hot_training_course_record (培训课程学习记录表)**
|