# 数据库文件目录

> **注意：此目录内容为自动生成，请勿手动修改！**

## 目录说明

本目录包含Game模块相关的数据库文件，主要用于：

1. **SQL脚本生成**：存放自动生成的数据库表创建脚本
2. **数据库迁移**：虽然项目不使用Laravel迁移，但保留此结构用于文档和版本管理
3. **数据库文档**：相关的数据库设计文档和说明

## 文件结构

```
Databases/
├── README.md                    # 本说明文件
└── GenerateSql/                 # 自动生成的SQL脚本目录
    ├── user_logs.sql           # 用户日志表
    ├── user_log_clear_records.sql # 用户日志清理记录表
    ├── game_reward_groups.sql  # 奖励组表
    ├── game_reward_items.sql   # 奖励项表
    ├── game_consume_groups.sql # 消耗组表
    ├── game_consume_items.sql  # 消耗项表
    ├── game_condition_groups.sql # 条件组表
    ├── game_condition_items.sql  # 条件项表
    └── ...                     # 其他相关表
```

## 使用说明

### 执行SQL脚本

1. **开发环境**：可以直接在数据库管理工具中执行SQL脚本
2. **生产环境**：请通过运维流程执行，确保数据安全

### 版本管理

- 所有SQL脚本都应该包含版本信息和变更说明
- 新增表或修改表结构时，请更新相应的SQL脚本
- 保持SQL脚本与实际数据库结构的一致性

### 注意事项

1. **不要手动修改**：此目录下的文件由系统自动生成，手动修改可能被覆盖
2. **备份重要数据**：执行SQL脚本前请确保已备份重要数据
3. **测试验证**：在生产环境执行前，请在测试环境充分验证
4. **权限控制**：确保只有授权人员可以执行数据库变更

## 相关文档

- [Game模块数据库设计文档](../Docs/)
- [用户日志系统文档](../Docs/UserLog.md)
- [奖励系统文档](../Docs/奖励组系统.md)
- [消耗系统文档](../Docs/消耗组系统.md)
- [条件系统文档](../Docs/条件组系统.md)

## 更新日志

### 2025年06月07日 - 用户日志清理逻辑优化

**新增文件：**
- `user_log_clear_records.sql` - 用户日志清理记录表

**优化内容：**
- 创建了用户日志清理记录表 `kku_user_log_clear_records`
- 实现了逻辑清理而非物理删除的机制
- 避免了真实删除日志对日志收集备份工作的影响

**技术实现：**
1. 用户点击清理日志时，不删除实际日志记录
2. 在清理记录表中记录用户的清理时间
3. 查询用户日志时，只返回清理时间之后的日志
4. 保证了日志收集系统的完整性和备份工作的正常进行

**优势：**
- ✅ 用户体验：用户看到的日志被清空
- ✅ 数据完整性：实际日志数据保持完整
- ✅ 备份安全：不影响日志收集和备份工作
- ✅ 性能优化：避免大量删除操作对数据库的影响
- ✅ 可恢复性：如需要可以恢复用户的历史日志

**相关文件：**
- 模型：`app/Module/Game/Models/UserLogClearRecord.php`
- 逻辑：`app/Module/Game/Logics/UserLogLogic.php`（已修改）
- 控制器：`app/Module/Game/AdminControllers/UserLogClearRecordController.php`
- 仓库：`app/Module/Game/Repositories/UserLogClearRecordRepository.php`

## 联系方式

如有问题请联系开发团队或查看相关技术文档。