# school_document_data_source_config_backup 表文档

## 表概述
**表名**: school_document_data_source_config_backup  
**功能**: 文档数据源配置备份表，用于备份和管理文档生成时的数据源配置信息

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	配置ID
contract_id	int	NULL	NO	MUL	0		select,insert,update,references	合同ID
table_name	varchar(64)	utf8mb4_general_ci	NO	MUL	NULL		select,insert,update,references	数据表名
table_alias	varchar(64)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	表别名（显示名称）
field_name	varchar(64)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	字段名
field_alias	varchar(64)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	字段别名（显示名称）
field_type	varchar(32)	utf8mb4_general_ci	YES		text		select,insert,update,references	字段类型：text-文本，number-数字，date-日期，datetime-日期时间
is_active	tinyint(1)	NULL	YES	MUL	1		select,insert,update,references	是否启用：1-启用，0-禁用
sort_order	int	NULL	YES		0		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	更新时间
```

## 功能用途

### 主要功能
- **配置备份**: 备份文档生成时使用的数据源配置信息
- **合同关联**: 通过contract_id关联具体的合同文档
- **表结构映射**: 记录数据表名和字段名的映射关系
- **别名管理**: 管理表名和字段名的显示别名，提高可读性
- **字段类型**: 定义字段的数据类型(文本、数字、日期等)
- **状态控制**: 通过is_active控制配置的启用状态
- **排序管理**: 通过sort_order控制字段的显示顺序
- **版本控制**: 记录配置的创建和更新时间，支持版本追踪
- **数据恢复**: 在配置丢失时可以从备份中恢复
- **配置审计**: 提供配置变更的审计追踪功能

### 业务场景
- **合同文档生成**: 为合同文档生成提供数据源配置备份
- **报表模板**: 为各类报表模板提供数据字段配置
- **文档模板**: 为文档模板系统提供数据源映射配置
- **数据导出**: 为数据导出功能提供字段配置信息
- **配置恢复**: 在系统故障时恢复数据源配置
- **版本管理**: 管理不同版本的数据源配置
- **配置迁移**: 在系统升级时迁移配置数据
- **模板复制**: 复制现有模板的数据源配置
- **批量处理**: 批量处理多个合同的配置备份
- **配置审计**: 审计配置变更历史和操作记录

## 关联关系

### 主要关联表
- **school_contract**: 合同表，通过contract_id关联合同信息
- **school_document_data_source_config**: 原始数据源配置表
- **school_document_template**: 文档模板表，关联模板信息
- **school_document_generate_log**: 文档生成日志表，关联生成记录
- **school_sys_user**: 系统用户表，关联配置操作用户
- **school_member**: 会员表，合同相关的会员信息
- **school_course**: 课程表，课程相关的合同配置
- **school_campus**: 校区表，校区相关的配置信息

### 关联说明
- `contract_id` 关联 `school_contract.id`，标识配置所属的合同
- `table_name` 标识数据源表名，对应系统中的实际数据表
- `field_name` 标识具体的字段名，对应表中的实际字段
- `table_alias` 和 `field_alias` 提供用户友好的显示名称
- **配置关联**: 与原始配置表关联，实现配置的备份和恢复
- **模板关联**: 与文档模板关联，支持模板的数据源配置
- **合同关联**: 与合同表关联，获取合同的详细信息
- **日志关联**: 与生成日志关联，追踪配置的使用情况
- **用户关联**: 与用户表关联，记录配置的操作者

## 索引建议
```sql
-- 主键索引(自动创建)
PRIMARY KEY (id)

-- 合同ID索引(用于查询合同的配置备份)
INDEX idx_contract_id (contract_id)

-- 表名索引(用于按表查询配置)
INDEX idx_table_name (table_name)

-- 启用状态索引(用于查询启用的配置)
INDEX idx_is_active (is_active)

-- 创建时间索引(用于按时间查询)
INDEX idx_created_at (created_at)

-- 更新时间索引(用于按更新时间查询)
INDEX idx_updated_at (updated_at)

-- 复合索引(用于查询合同的启用配置)
INDEX idx_contract_active (contract_id, is_active)

-- 复合索引(用于查询表的字段配置)
INDEX idx_table_field (table_name, field_name)

-- 复合索引(用于排序查询)
INDEX idx_contract_sort (contract_id, sort_order)
```

## 注意事项
- **数据一致性**: 确保备份的配置与原始配置保持一致
- **字段类型**: field_type字段值需要严格按照规范设置
- **表名有效性**: table_name必须对应系统中实际存在的数据表
- **字段名有效性**: field_name必须对应表中实际存在的字段
- **别名唯一性**: 在同一合同内，别名应该保持唯一性
- **排序合理性**: sort_order应该保证字段显示的合理顺序
- **状态管理**: is_active状态变更需要考虑对文档生成的影响
- **备份时机**: 在配置变更前应及时创建备份
- **数据清理**: 定期清理过期或无效的配置备份
- **权限控制**: 配置备份的查看和操作需要严格权限控制
- **版本管理**: 通过时间戳实现配置的版本管理
- **恢复验证**: 从备份恢复配置时需要验证数据完整性
- **性能优化**: 大量配置查询时需要考虑缓存机制
- **监控告警**: 监控配置备份的创建和使用情况
- **数据备份**: 重要的配置备份数据需要定期备份到外部存储