zhjwxt/niucloud/databasedoc/school_document_generate_log_backup.md

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)（用户历史查询）

注意事项

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