# school_document_generate_log_backup 表文档

## 表概述
**表名**: school_document_generate_log_backup  
**功能**: 文档生成日志备份表，用于备份和管理文档生成的历史记录，包括生成状态、文件信息和下载统计

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	记录ID
template_id	int	NULL	NO	MUL	NULL		select,insert,update,references	模板ID（关联school_contract.id）
user_id	int	NULL	NO	MUL	NULL		select,insert,update,references	操作用户ID
user_type	varchar(20)	utf8mb4_general_ci	YES		admin		select,insert,update,references	用户类型：1 员工 2 外部用户
fill_data	json	NULL	YES		NULL		select,insert,update,references	填充数据JSON格式
generated_file_path	varchar(500)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	生成文件路径
generated_file_name	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	生成文件名
status	enum('pending','processing','completed','failed')	utf8mb4_general_ci	NO	MUL	pending		select,insert,update,references	生成状态：pending-等待，processing-处理中，completed-完成，failed-失败
error_msg	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	错误信息
process_start_time	timestamp	NULL	YES		NULL		select,insert,update,references	处理开始时间
process_end_time	timestamp	NULL	YES		NULL		select,insert,update,references	处理完成时间
download_count	int	NULL	YES		0		select,insert,update,references	下载次数
last_download_time	timestamp	NULL	YES		NULL		select,insert,update,references	最后下载时间
created_at	int	NULL	NO	MUL	0		select,insert,update,references	创建时间
updated_at	int	NULL	NO		0		select,insert,update,references	更新时间
```

## 功能用途

### 主要功能
- **日志备份**: 备份文档生成的历史记录和操作日志
- **状态追踪**: 跟踪文档生成的完整生命周期状态
- **文件管理**: 管理生成文件的存储路径和文件名信息
- **错误记录**: 记录文档生成过程中的错误信息和失败原因
- **性能监控**: 监控文档生成的处理时间和性能指标
- **下载统计**: 统计生成文档的下载次数和使用情况
- **用户追踪**: 记录文档生成的操作用户和用户类型
- **数据恢复**: 提供文档生成数据的备份和恢复功能
- **审计追溯**: 支持文档生成操作的审计和追溯

### 业务场景
- **合同文档生成**: 备份教学合同、协议等文档的生成记录
- **报表文档生成**: 备份各种统计报表的生成历史
- **证书文档生成**: 备份学员证书、荣誉证书的生成记录
- **通知文档生成**: 备份家长通知、缴费通知等文档生成
- **批量文档生成**: 备份批量生成文档的操作记录
- **模板文档生成**: 备份基于模板生成文档的历史记录
- **自定义文档生成**: 备份用户自定义文档的生成记录
- **系统文档生成**: 备份系统自动生成文档的记录
- **历史数据恢复**: 从备份中恢复历史文档生成数据

## 关联关系

### 主要关联表
- `school_contract`: 合同表（模板ID关联合同记录）
- `school_document_generate_log`: 文档生成日志表（主表备份关系）
- `school_sys_user`: 系统用户表（操作用户关联）
- `school_member`: 会员表（外部用户关联）
- `school_document_template`: 文档模板表（模板配置关联）
- `school_sys_attachment`: 附件表（生成文件关联）
- `school_campus`: 校区表（校区相关文档）

### 关联说明
- **模板关联**: template_id关联到具体的文档模板或合同记录
- **用户关联**: user_id根据user_type关联到不同的用户表
- **文件关联**: generated_file_path关联到实际的文件存储位置
- **状态关联**: status字段反映文档生成的当前状态
- **时间关联**: 记录文档生成的完整时间线信息
- **备份关联**: 与主日志表保持数据一致性和完整性

## 索引建议
- **主键索引**: id（已存在）
- **外键索引**: 
  - template_id（模板查询）
  - user_id（用户查询）
- **状态索引**: status（状态查询）
- **时间索引**: 
  - created_at（创建时间查询）
  - updated_at（更新时间查询）
  - process_start_time（处理开始时间）
  - process_end_time（处理完成时间）
  - last_download_time（最后下载时间）
- **复合索引**: 
  - (user_id, user_type)（用户类型查询优化）
  - (template_id, status)（模板状态查询）
  - (status, created_at)（状态时间查询）
  - (user_id, created_at)（用户历史查询）

## 注意事项
- **数据一致性**: 确保备份数据与主表数据的一致性
- **存储管理**: 生成文件的存储路径需要有效管理，防止文件丢失
- **状态同步**: 文档生成状态变更需要及时同步到备份表
- **文件清理**: 定期清理过期的生成文件，释放存储空间
- **权限控制**: 备份数据的访问需要严格的权限控制
- **错误处理**: 详细记录错误信息，便于问题排查和解决
- **性能监控**: 监控文档生成的性能，优化处理效率
- **备份策略**: 制定合理的数据备份和归档策略
- **数据恢复**: 建立完善的数据恢复机制和流程
- **审计合规**: 确保备份数据符合审计和合规要求
- **版本管理**: 支持备份数据的版本管理和历史追溯
- **安全保护**: 备份数据需要加密存储，防止数据泄露
- **监控告警**: 建立异常情况的监控和告警机制
- **容量规划**: 合理规划备份数据的存储容量和增长
- **数据迁移**: 系统升级时需要考虑备份数据的迁移