Просмотр исходного кода

同步修改Cleanup模块相关文档:统一数据库备份设计

- 更新备份功能总结.md:移除多种备份格式,专注数据库备份
- 更新设计概述.md:修改备份管理描述为数据库备份管理
- 更新数据库设计.md:替换backup_files表为sql_backups表
- 统一所有文档与简化后的数据备份设计保持一致
- 强调数据库备份的优势:查询快速、无文件管理、事务安全、备份可靠
notfff 6 месяцев назад
Родитель
Сommit
59acefaea9

+ 140 - 0
AiWork/2025年06月/16日2315-简化Cleanup模块数据备份设计.md

@@ -0,0 +1,140 @@
+# 简化Cleanup模块数据备份设计
+
+## 任务概述
+- **时间**: 2025年06月16日 23:15
+- **任务**: 简化Cleanup模块数据备份设计,只保留数据库备份类型,移除其他备份方式
+- **状态**: ✅ 已完成
+
+## 任务背景
+用户要求对Cleanup模块的数据备份设计进行简化,只保留数据库备份,移除其他类型的备份(SQL文件备份、JSON备份、CSV备份、压缩备份等)。
+
+## 执行步骤
+
+### 1. 分析现有设计
+- 查看了`app/Module/Cleanup/Docs/数据备份设计.md`文档
+- 识别了需要保留和移除的内容
+
+### 2. 修改备份类型说明
+- 将备份类型从多种类型简化为只支持数据库备份
+- 更新备份原则,移除压缩相关描述
+
+### 3. 简化备份架构
+- 移除了BackupStorage和BackupCompressor组件
+- 保留核心的BackupLogic、BackupService、BackupExecutor和BackupRestorer
+
+### 4. 更新数据库设计
+- 简化了`cleanup_backups`表结构,移除文件相关字段:
+  - 移除`backup_path`、`backup_size`、`original_size`、`compression_type`、`backup_hash`字段
+  - 保留核心字段,`backup_type`固定为数据库备份类型
+- 完全移除了`cleanup_backup_files`表
+
+### 5. 重构实现代码
+- **保留的功能**:
+  - 数据库备份实现(存储INSERT语句到数据库)
+  - 数据库备份的优势说明
+  - 数据库备份恢复功能
+
+- **移除的功能**:
+  - SQL文件备份实现
+  - JSON备份实现  
+  - CSV备份实现
+  - 文件压缩功能
+  - 文件存储路径管理
+
+### 6. 更新备份管理功能
+- 修改备份清理策略,移除文件操作
+- 更新备份验证功能,专注于数据库备份的完整性验证
+
+### 7. 简化配置选项
+- 移除多种备份类型的配置选项
+- 移除压缩相关配置
+- 移除文件存储路径配置
+- 保留核心配置:保留天数、批处理大小、自动清理等
+
+## 主要修改内容
+
+### 备份类型
+**修改前**:
+- 数据库备份(默认方式)
+- SQL文件备份
+- JSON备份
+- CSV备份
+- 压缩备份
+
+**修改后**:
+- 数据库备份(唯一支持的备份方式)
+
+### 数据库表结构
+**cleanup_backups表简化**:
+```sql
+-- 移除的字段
+backup_path, backup_size, original_size, compression_type, backup_hash
+
+-- 保留的核心字段
+id, task_id, backup_name, backup_type, tables_count, records_count, 
+backup_status, started_at, completed_at, expires_at, error_message, 
+created_at, updated_at
+```
+
+**移除的表**:
+- `cleanup_backup_files`表完全移除
+
+### 配置简化
+**修改前**:
+```php
+'backup' => [
+    'default_type' => 'sql',
+    'compression' => 'gzip',
+    'retention_days' => 30,
+    'batch_size' => 1000,
+    'max_file_size' => 500,
+    'storage_path' => 'cleanup/backups',
+    'auto_cleanup' => true,
+]
+```
+
+**修改后**:
+```php
+'backup' => [
+    'type' => 'database',
+    'retention_days' => 30,
+    'batch_size' => 1000,
+    'auto_cleanup' => true,
+    'max_records_per_statement' => 100,
+]
+```
+
+## 设计优势
+
+### 简化后的优势
+1. **架构简单**:只支持数据库备份,架构清晰
+2. **查询快速**:备份数据存储在数据库中,查询检索快速
+3. **无文件管理**:不需要管理文件系统,避免文件丢失
+4. **事务安全**:利用数据库事务保证数据一致性
+5. **备份可靠**:随数据库一起备份,不会单独丢失
+6. **空间优化**:数据库自动优化存储,无需额外压缩
+
+### 适用场景
+- 中小型数据量的清理备份
+- 需要快速查询和恢复的场景
+- 对数据安全性要求较高的环境
+- 不希望管理复杂文件系统的场景
+
+## 文件变更
+- `app/Module/Cleanup/Docs/数据备份设计.md` - 大幅简化,移除文件备份相关内容
+
+## 提交信息
+```
+简化Cleanup模块数据备份设计:只保留数据库备份类型
+
+- 移除SQL文件备份、JSON备份、CSV备份等文件备份类型
+- 移除文件压缩和存储相关功能
+- 简化备份记录表结构,移除文件相关字段
+- 更新备份恢复功能,专注于数据库备份恢复
+- 简化配置选项,只支持数据库备份
+- 优化备份管理功能,移除文件操作相关代码
+- 更新文档说明,突出数据库备份的优势和适用场景
+```
+
+## 总结
+成功简化了Cleanup模块的数据备份设计,专注于数据库备份这一种可靠的备份方式。新设计架构更加简洁,维护成本更低,同时保持了数据备份的安全性和可靠性。移除了复杂的文件管理和压缩功能,使整个备份系统更加专注和高效。

+ 11 - 0
AiWork/WORK.md

@@ -7,6 +7,17 @@
 
 ## 已完成任务
 
+**2025-06-16 23:15** - 简化Cleanup模块数据备份设计 - 只保留数据库备份类型,移除其他备份方式
+- 任务:简化Cleanup模块的数据备份设计,只保留数据库备份,移除其他类型的备份(SQL文件备份、JSON备份、CSV备份、压缩备份等)
+- 简化:将备份类型从多种类型简化为只支持数据库备份,更新备份原则移除压缩相关描述
+- 架构:移除BackupStorage和BackupCompressor组件,保留核心的BackupLogic、BackupService、BackupExecutor和BackupRestorer
+- 数据库:简化cleanup_backups表结构移除文件相关字段,完全移除cleanup_backup_files表
+- 实现:保留数据库备份实现,移除SQL文件备份、JSON备份、CSV备份、文件压缩功能、文件存储路径管理
+- 管理:修改备份清理策略移除文件操作,更新备份验证功能专注于数据库备份的完整性验证
+- 配置:移除多种备份类型配置选项、压缩相关配置、文件存储路径配置,保留核心配置
+- 优势:架构简单、查询快速、无文件管理、事务安全、备份可靠、空间优化
+- 文件:./AiWork/2025年06月/16日2315-简化Cleanup模块数据备份设计.md
+
 **2025-06-16 21:01** - 完善Test模块README文档 - 基于物品模块、Mex模块、农场模块的架构设计完善Test模块文档
 - 任务:基于物品模块、Mex模块、农场模块的架构设计和最佳实践,全面完善Test模块的README.md文档
 - 调研:深入研究GameItems模块(物品冻结功能、拆堆模式)、Mex模块(撮合交易、多币种适配)、Farm模块(生长周期、灾害系统)

+ 57 - 92
app/Module/Cleanup/Docs/备份功能总结.md

@@ -6,11 +6,10 @@
 
 ### 1.1 核心特性
 - **自动备份**:清理前自动备份将要删除的数据
-- **多种格式**:支持SQL、JSON、CSV三种备份格式
-- **智能压缩**:自动压缩备份文件,节省存储空间
-- **完整性验证**:MD5哈希验证确保备份文件完整性
+- **数据库存储**:将INSERT语句直接存储到数据库中
+- **完整性验证**:SHA256哈希验证确保备份数据完整性
 - **快速恢复**:支持一键恢复备份数据
-- **生命周期管理**:自动清理过期备份文件
+- **生命周期管理**:自动清理过期备份记录
 
 ## 2. 备份实现方案
 
@@ -19,74 +18,44 @@
 清理执行流程:
 1. 分析清理任务 → 确定需要备份的数据
 2. 创建备份计划 → 生成备份任务列表
-3. 执行数据备份 → 按表分别备份数据
-4. 压缩备份文件 → 减少存储空间占用
-5. 验证备份完整性 → 确保备份文件可用
-6. 记录备份信息 → 保存备份元数据
-7. 执行清理操作 → 在备份完成后执行清理
+3. 执行数据备份 → 将数据以INSERT语句形式存储到数据库
+4. 验证备份完整性 → 确保备份数据完整
+5. 记录备份信息 → 保存备份元数据
+6. 执行清理操作 → 在备份完成后执行清理
 ```
 
-### 2.2 备份格式
+### 2.2 数据库备份格式
 
-#### SQL备份
-- **优点**:包含完整的表结构和数据,恢复最可靠
-- **适用场景**:重要数据的完整备份
-- **文件示例**:
+#### 数据库备份
+- **优点**:查询快速、无文件管理、事务安全、备份可靠
+- **适用场景**:所有数据的备份存储
+- **存储示例**:
 ```sql
--- 备份文件: kku_farm_users
--- 创建时间: 2024-12-16 14:30:22
+-- 存储在 cleanup_sql_backups 表中的备份内容
+-- 表名: kku_farm_users
+-- 备份时间: 2024-12-16 14:30:22
 
+-- 表结构信息
 CREATE TABLE `kku_farm_users` (
   `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
   `user_id` bigint(20) NOT NULL,
   -- ... 表结构
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
 
+-- 数据INSERT语句
 INSERT INTO `kku_farm_users` (`id`, `user_id`, `house_level`, `created_at`) VALUES
 (1, 1001, 5, '2024-01-01 10:00:00'),
 (2, 1002, 3, '2024-01-02 11:00:00');
 ```
 
-#### JSON备份
-- **优点**:结构化数据,易于解析和处理
-- **适用场景**:需要程序化处理的数据备份
-- **文件示例**:
-```json
-{
-  "table_name": "kku_farm_users",
-  "backup_time": "2024-12-16 14:30:22",
-  "conditions": {"time_field": "created_at", "before": "2024-01-01"},
-  "records": [
-    {"id": 1, "user_id": 1001, "house_level": 5},
-    {"id": 2, "user_id": 1002, "house_level": 3}
-  ]
-}
-```
-
-#### CSV备份
-- **优点**:文件小,处理速度快
-- **适用场景**:大数据量的快速备份
-- **文件示例**:
-```csv
-id,user_id,house_level,created_at
-1,1001,5,"2024-01-01 10:00:00"
-2,1002,3,"2024-01-02 11:00:00"
-```
-
-### 2.3 压缩机制
-
-#### Gzip压缩
-```php
-// 压缩率:通常可达到70-80%的压缩率
-// 兼容性:广泛支持,Linux系统原生支持
-// 示例:farm_users_143022_abc123.sql.gz
-```
+### 2.3 数据库存储优势
 
-#### Zip压缩
+#### 存储优化
 ```php
-// 压缩率:略低于gzip,但支持多文件打包
-// 兼容性:Windows和Linux都支持
-// 示例:backup_143022_abc123.zip
+// 自动优化:数据库自动优化存储,无需额外压缩
+// 查询快速:直接存储在数据库中,查询和检索非常快速
+// 事务安全:利用数据库事务保证数据一致性
+// 备份可靠:随数据库一起备份,不会单独丢失
 ```
 
 ## 3. 数据库设计
@@ -96,24 +65,23 @@ id,user_id,house_level,created_at
 -- 存储备份的基本信息
 kku_cleanup_backups
 ├── backup_name     # 备份名称
-├── backup_type     # 备份格式(SQL/JSON/CSV)
-├── compression_type # 压缩类型(gzip/zip/none)
-├── backup_path     # 备份文件路径
-├── backup_size     # 压缩后文件大小
-├── original_size   # 原始数据大小
-├── backup_hash     # 文件MD5哈希
+├── backup_type     # 备份类型(固定为数据库备份)
+├── tables_count    # 备份表数量
+├── records_count   # 备份记录数量
+├── backup_status   # 备份状态
 └── expires_at      # 备份过期时间
 ```
 
-### 3.2 备份文件
+### 3.2 SQL备份记录
 ```sql
--- 存储每个表的备份文件详情
-kku_cleanup_backup_files
+-- 存储每个表的SQL备份内容
+kku_cleanup_sql_backups
 ├── backup_id       # 关联备份记录
 ├── table_name      # 表名
-├── file_path       # 文件路径
+├── sql_content     # INSERT语句内容
 ├── records_count   # 备份记录数
-├── file_hash       # 文件哈希
+├── content_size    # 内容大小(字节)
+├── content_hash    # 内容SHA256哈希
 └── backup_conditions # 备份条件
 ```
 
@@ -133,8 +101,8 @@ php artisan cleanup:execute 1
 
 ### 4.2 手动备份
 ```bash
-# 为特定任务创建备份
-php artisan cleanup:backup 1 --type=sql --compression=gzip
+# 为特定任务创建数据库备份
+php artisan cleanup:backup 1
 
 # 验证备份完整性
 php artisan cleanup:verify-backup 123
@@ -150,7 +118,7 @@ php artisan cleanup:restore 123 --force
 
 // 功能包括:
 // - 查看备份列表
-// - 下载备份文件
+// - 查看备份内容
 // - 验证备份完整性
 // - 恢复备份数据
 // - 删除过期备份
@@ -159,16 +127,16 @@ php artisan cleanup:restore 123 --force
 ## 5. 安全保障
 
 ### 5.1 数据完整性
-- **MD5哈希验证**:每个备份文件都有MD5哈希值
+- **SHA256哈希验证**:每个备份内容都有SHA256哈希值
 - **分批备份**:大表采用分批备份,避免内存溢出
 - **事务保护**:备份过程使用数据库事务保护
-- **错误恢复**:备份失败时自动清理临时文件
+- **错误恢复**:备份失败时自动回滚事务
 
 ### 5.2 存储安全
-- **路径隔离**:备份文件存储在专门的目录中
-- **权限控制**:备份文件设置适当的文件权限
-- **定期清理**:自动清理过期的备份文件
-- **空间监控**:监控备份存储空间使用情况
+- **数据库存储**:备份数据存储在数据库中,安全可靠
+- **权限控制**:基于数据库权限控制访问
+- **定期清理**:自动清理过期的备份记录
+- **空间监控**:监控备份数据存储空间使用情况
 
 ### 5.3 操作安全
 - **权限验证**:只有授权用户可以操作备份
@@ -181,14 +149,14 @@ php artisan cleanup:restore 123 --force
 ### 6.1 备份性能
 - **分批处理**:大表分批备份,避免长时间锁表
 - **并行备份**:多个表可以并行备份
-- **压缩优化**:选择合适的压缩算法和级别
-- **I/O优化**:优化文件读写操作
+- **数据库优化**:利用数据库自身的存储优化
+- **内存优化**:优化内存使用,避免内存溢出
 
 ### 6.2 存储优化
 - **增量备份**:只备份变更的数据(未来版本)
-- **重复数据删除**:识别和删除重复的备份文件
-- **分层存储**:新备份存储在快速存储,旧备份迁移到慢速存储
-- **压缩率优化**:根据数据特征选择最佳压缩方式
+- **重复数据删除**:识别和删除重复的备份记录
+- **数据库存储**:利用数据库自动优化存储
+- **查询优化**:优化备份数据的查询性能
 
 ## 7. 监控和维护
 
@@ -196,9 +164,9 @@ php artisan cleanup:restore 123 --force
 ```php
 // 备份状态监控
 - 备份成功率统计
-- 备份文件大小趋势
+- 备份数据大小趋势
 - 备份时间性能分析
-- 存储空间使用监控
+- 数据库存储空间使用监控
 ```
 
 ### 7.2 自动维护
@@ -219,13 +187,11 @@ php artisan cleanup:backup-report
 ```php
 // config/cleanup.php
 'backup' => [
-    'default_type' => 'sql',        // 默认备份格式
-    'compression' => 'gzip',        // 默认压缩方式
+    'type' => 'database',           // 备份类型(固定为数据库备份)
     'retention_days' => 30,         // 备份保留天数
     'batch_size' => 1000,          // 分批处理大小
-    'max_file_size' => 500,        // 最大文件大小(MB)
-    'storage_path' => 'cleanup/backups', // 存储路径
     'auto_cleanup' => true,         // 自动清理过期备份
+    'max_records_per_statement' => 100, // 生成INSERT语句时的最大记录数
 ]
 ```
 
@@ -233,7 +199,6 @@ php artisan cleanup:backup-report
 ```php
 'performance' => [
     'parallel_backups' => 3,        // 并行备份数量
-    'compression_level' => 6,       // 压缩级别(1-9)
     'memory_limit' => '512M',       // 内存限制
     'timeout' => 3600,             // 超时时间(秒)
 ]
@@ -256,7 +221,7 @@ php artisan cleanup:backup-report
 ```
 备份失败处理:
 - 备份失败 → 停止清理操作
-- 清理失败 → 保留备份文件
+- 清理失败 → 保留备份数据
 - 验证失败 → 重新创建备份
 - 恢复失败 → 记录错误日志
 ```
@@ -272,9 +237,9 @@ Cleanup 模块的备份功能提供了完整的数据保护机制:
 - **可靠性**:多重验证确保备份文件可用
 
 ### 10.2 技术优势
-- **多格式支持**:适应不同场景的备份需求
-- **智能压缩**:节省存储空间和传输时间
-- **完整性保证**:哈希验证确保数据完整性
-- **生命周期管理**:自动化的备份文件管理
+- **数据库存储**:专注于数据库备份,架构简单清晰
+- **查询快速**:备份数据存储在数据库中,查询和检索非常快速
+- **完整性保证**:SHA256哈希验证确保数据完整性
+- **生命周期管理**:自动化的备份记录管理
 
-这个备份系统不仅满足了数据安全的基本需求,还提供了专业级的备份管理功能,确保Cleanup模块在提供强大清理能力的同时,也能保证数据的绝对安全。
+这个备份系统专注于数据库备份,提供了完整的数据保护机制,确保Cleanup模块在提供强大清理能力的同时,也能保证数据的绝对安全。

+ 19 - 26
app/Module/Cleanup/Docs/数据库设计.md

@@ -9,7 +9,7 @@ Cleanup 模块包含以下核心数据表:
 3. **cleanup_plan_contents** - 计划内容表(计划具体处理哪些表,怎么清理)
 4. **cleanup_tasks** - 清理任务表(执行某个计划的具体实例)
 5. **cleanup_backups** - 备份记录表(计划的备份方案和内容)
-6. **cleanup_backup_files** - 备份文件表(备份的具体文件
+6. **cleanup_sql_backups** - SQL备份记录表(备份的具体SQL内容
 7. **cleanup_logs** - 清理日志表(任务执行日志)
 8. **cleanup_table_stats** - 表统计信息表(表的统计信息)
 
@@ -140,56 +140,49 @@ CREATE TABLE `kku_cleanup_tasks` (
 ```sql
 CREATE TABLE `kku_cleanup_backups` (
   `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `plan_id` bigint(20) unsigned NOT NULL COMMENT '关联的清理计划ID',
-  `task_id` bigint(20) unsigned DEFAULT NULL COMMENT '关联的清理任务ID(如果是任务触发的备份)',
+  `task_id` bigint(20) unsigned NOT NULL COMMENT '清理任务ID',
   `backup_name` varchar(100) NOT NULL COMMENT '备份名称',
-  `backup_type` tinyint(3) unsigned NOT NULL COMMENT '备份类型:1SQL,2JSON,3CSV',
-  `compression_type` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '压缩类型:1gzip,2zip,3none',
-  `backup_path` varchar(500) NOT NULL COMMENT '备份文件路径',
-  `backup_size` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '备份文件大小(字节)',
-  `original_size` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '原始数据大小(字节)',
+  `backup_type` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '备份类型:1数据库备份',
   `tables_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '备份表数量',
   `records_count` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '备份记录数量',
   `backup_status` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '备份状态:1进行中,2已完成,3已失败',
-  `backup_hash` varchar(64) DEFAULT NULL COMMENT '备份文件MD5哈希',
-  `backup_config` json DEFAULT NULL COMMENT '备份配置信息',
   `started_at` timestamp NULL DEFAULT NULL COMMENT '备份开始时间',
   `completed_at` timestamp NULL DEFAULT NULL COMMENT '备份完成时间',
   `expires_at` timestamp NULL DEFAULT NULL COMMENT '备份过期时间',
   `error_message` text COMMENT '错误信息',
-  `created_by` bigint(20) unsigned DEFAULT NULL COMMENT '创建者用户ID',
   `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
   `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
   PRIMARY KEY (`id`),
-  KEY `idx_plan_id` (`plan_id`),
   KEY `idx_task_id` (`task_id`),
   KEY `idx_backup_status` (`backup_status`),
   KEY `idx_expires_at` (`expires_at`),
-  KEY `idx_created_at` (`created_at`),
-  FOREIGN KEY (`plan_id`) REFERENCES `kku_cleanup_plans` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='备份记录表';
+  KEY `idx_created_at` (`created_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='清理备份记录表';
 ```
 
-### 2.6 备份文件表 (cleanup_backup_files)
+### 2.6 SQL备份记录表 (cleanup_sql_backups)
 
-存储备份的具体文件信息。
+存储备份的具体SQL内容信息。
 
 ```sql
-CREATE TABLE `kku_cleanup_backup_files` (
+CREATE TABLE `kku_cleanup_sql_backups` (
   `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `backup_id` bigint(20) unsigned NOT NULL COMMENT '备份记录ID',
+  `backup_id` bigint(20) unsigned NOT NULL COMMENT '关联备份记录ID',
   `table_name` varchar(100) NOT NULL COMMENT '表名',
-  `file_path` varchar(500) NOT NULL COMMENT '文件路径',
-  `file_size` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '文件大小(字节)',
+  `sql_content` longtext NOT NULL COMMENT 'INSERT语句内容',
   `records_count` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '记录数量',
-  `file_hash` varchar(64) DEFAULT NULL COMMENT '文件MD5哈希',
+  `content_size` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '内容大小(字节)',
+  `content_hash` varchar(64) DEFAULT NULL COMMENT '内容SHA256哈希',
   `backup_conditions` json DEFAULT NULL COMMENT '备份条件',
   `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
   PRIMARY KEY (`id`),
   KEY `idx_backup_id` (`backup_id`),
   KEY `idx_table_name` (`table_name`),
+  KEY `idx_records_count` (`records_count`),
+  KEY `idx_created_at` (`created_at`),
   FOREIGN KEY (`backup_id`) REFERENCES `kku_cleanup_backups` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='备份文件表';
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='SQL备份记录表';
 ```
 
 ### 2.7 清理日志表 (cleanup_logs)
@@ -385,7 +378,7 @@ cleanup_tasks (清理任务) <----------------+
 cleanup_logs   cleanup_backups (备份记录)
                |
                v
-               cleanup_backup_files (备份文件)
+               cleanup_sql_backups (SQL备份记录)
 
 cleanup_table_stats (表统计) - 独立存在,为决策提供支持
 ```
@@ -398,7 +391,7 @@ cleanup_table_stats (表统计) - 独立存在,为决策提供支持
 3. **计划 → 任务**:一个计划可以创建多个执行任务
 4. **任务 → 日志**:一个任务产生多条操作日志
 5. **计划 → 备份**:一个计划可以有多个备份记录
-6. **备份 → 备份文件**:一个备份包含多个表的备份文件
+6. **备份 → SQL备份记录**:一个备份包含多个表的SQL备份记录
 
 #### 5.2.2 概念层次关系
 ```
@@ -425,7 +418,7 @@ cleanup_table_stats (表统计) - 独立存在,为决策提供支持
 备份记录 (cleanup_backups)
 ├── 备份名称: "custom_backup_20241216_143022"
 ├── 备份状态: 已完成
-└── 备份文件: [...]
+└── SQL备份记录: [...]
 ```
 
 ## 6. 数据初始化

+ 2 - 2
app/Module/Cleanup/Docs/设计概述.md

@@ -177,7 +177,7 @@ CREATE TABLE `kku_cleanup_logs` (
 - **多重确认**: 危险操作需要多次确认
 - **权限控制**: 基于角色的操作权限
 - **自动备份**: 清理前自动备份将要删除的数据
-- **备份管理**: 完整的备份文件管理和恢复功能
+- **备份管理**: 完整的数据库备份管理和恢复功能
 
 ### 4.3 执行控制
 - **批量处理**: 大数据量分批处理
@@ -218,7 +218,7 @@ CREATE TABLE `kku_cleanup_logs` (
 ### 6.2 安全要求
 - 严格的权限控制
 - 完整的操作审计
-- 数据备份建议
+- 数据库备份保障
 
 ### 6.3 可维护性
 - 清晰的代码结构