# school_student_course_usage 表文档

## 表概述
**表名**: school_student_course_usage  
**功能**: 学员课程使用记录表，用于详细记录学员对课程的使用情况，包括学习时长、进度跟踪、访问频次等数据，为学习效果分析、课程优化和个性化推荐提供数据支撑

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	记录编号
student_course_id	int	NULL	NO		NULL		select,insert,update,references	学员课程ID（关联到student_courses表）
used_hours	int	NULL	NO		NULL		select,insert,update,references	本次使用的课时数
usage_date	date	NULL	NO		NULL		select,insert,update,references	课时使用日期
created_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	创建时间
updated_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	修改时间
student_id	int	NULL	YES		NULL		select,insert,update,references	学员id
resource_id	int	NULL	YES		NULL		select,insert,update,references	资源 id
```

## 功能用途

### 主要功能
- **学习行为记录**: 详细记录学员的学习行为和使用模式
- **进度跟踪**: 实时跟踪学员的学习进度和完成情况
- **时长统计**: 统计学员在课程上的实际学习时间
- **访问分析**: 分析学员的访问频次和学习习惯
- **效果评估**: 为学习效果评估提供客观数据支撑
- **个性化推荐**: 基于使用数据为学员推荐合适的课程
- **课程优化**: 为课程内容和结构优化提供数据依据
- **学习报告**: 生成详细的学习报告和统计分析

### 业务场景
- **学习监控**: 实时监控学员的学习状态和活跃度
- **进度管理**: 帮助教师和管理员了解学员学习进度
- **效果分析**: 分析不同课程的学习效果和受欢迎程度
- **个性化服务**: 根据学习数据提供个性化学习建议
- **课程改进**: 基于使用数据优化课程内容和教学方法
- **学习报告**: 为学员、教师、家长提供详细的学习报告
- **数据挖掘**: 挖掘学习行为模式，发现教学规律
- **质量评估**: 评估课程质量和教学效果
- **资源配置**: 根据使用情况合理配置教学资源
- **预警机制**: 识别学习困难的学员，及时提供帮助

## 关联关系

### 直接关联
- **school_member**: 通过member_id关联学员信息
- **school_course**: 通过course_id关联课程信息
- **school_sys_user**: 通过create_uid关联创建用户
- **school_sys_user**: 通过update_uid关联更新用户

### 业务关联
- **school_class**: 关联班级信息，了解班级学习情况
- **school_personnel**: 关联教师信息，分析教学效果
- **school_contract**: 关联合同信息，验证课程权限
- **school_attendance**: 关联考勤记录，完善学习档案
- **school_homework**: 关联作业情况，评估学习效果

### 统计关联
- **school_stat_day**: 日统计数据的基础来源
- **school_stat_hour**: 小时统计数据的基础来源
- **学习分析报表**: 为各类学习分析报表提供数据支撑

## 索引建议

### 主键索引
```sql
PRIMARY KEY (`id`)
```

### 业务索引
```sql
-- 学员查询索引
INDEX `idx_member_id` (`member_id`)

-- 课程查询索引
INDEX `idx_course_id` (`course_id`)

-- 使用日期索引
INDEX `idx_usage_date` (`usage_date`)

-- 创建时间索引
INDEX `idx_create_time` (`create_time`)

-- 学员课程组合索引
INDEX `idx_member_course` (`member_id`, `course_id`)

-- 日期范围查询索引
INDEX `idx_member_date` (`member_id`, `usage_date`)

-- 课程统计索引
INDEX `idx_course_date` (`course_id`, `usage_date`)
```

### 索引说明
- **member_id索引**: 支持按学员查询使用记录
- **course_id索引**: 支持按课程统计使用情况
- **usage_date索引**: 支持按日期范围查询
- **组合索引**: 优化常用的学员+课程组合查询
- **统计索引**: 支持各类统计分析查询

## 注意事项

### 数据准确性
- **实时记录**: 确保学习行为的实时准确记录
- **数据完整性**: 保证使用记录的完整性和一致性
- **时间精度**: 精确记录学习时间，支持细粒度分析
- **去重处理**: 避免重复记录同一学习行为

### 性能优化
- **批量处理**: 对大量使用记录采用批量处理方式
- **数据分区**: 按时间或学员进行数据分区提升查询效率
- **缓存策略**: 对热点数据进行缓存优化
- **索引优化**: 根据查询模式优化索引设计

### 隐私保护
- **数据脱敏**: 在数据分析时对敏感信息进行脱敏处理
- **访问控制**: 严格控制学习数据的访问权限
- **数据备份**: 定期备份重要的学习记录数据
- **合规要求**: 确保数据处理符合相关法律法规

### 业务规则
- **异常检测**: 识别异常的学习行为模式
- **数据清理**: 定期清理无效或过期的使用记录
- **统计准确**: 确保基于使用数据的统计分析准确可靠
- **报告生成**: 为各类学习报告提供准确的数据支撑