8c55f9f376
主要更新: - 修复了所有主要的代码逻辑错误 - 实现了完整的任务清理系统 - 添加了系统设置页面的任务清理管理功能 - 修复了API调用认证问题 - 优化了密码加密和验证机制 - 统一了错误处理模式 - 添加了详细的文档和测试工具 新增功能: - 任务清理管理界面 - 任务归档和清理日志 - API监控和诊断工具 - 完整的测试套件 技术改进: - 修复了Repository方法调用错误 - 统一了模型方法调用 - 改进了类型安全性 - 优化了代码结构和可维护性
141 lines
3.3 KiB
Markdown
141 lines
3.3 KiB
Markdown
# 系统设置页面任务清理功能使用说明
|
||
|
||
## 功能概述
|
||
|
||
系统设置页面新增了"任务清理管理"选项卡，提供了完整的任务清理功能，包括统计信息查看、清理操作执行和配置管理。
|
||
|
||
## 功能特性
|
||
|
||
### 1. 选项卡式界面
|
||
- **会员收费标准**: 原有的会员管理功能
|
||
- **任务清理管理**: 新增的任务清理功能
|
||
|
||
### 2. 清理统计信息
|
||
- 当前任务总数统计
|
||
- 已完成任务数量
|
||
- 失败任务数量
|
||
- 已归档任务数量
|
||
- 清理日志数量
|
||
- 保留天数配置
|
||
|
||
### 3. 清理操作
|
||
- **完整清理**: 将所有成功任务导出到归档表，删除失败任务
|
||
- **用户清理**: 清理指定用户的所有任务
|
||
|
||
### 4. 清理配置
|
||
- 任务保留天数设置
|
||
- 归档保留天数设置
|
||
- 配置保存功能
|
||
|
||
## 使用方法
|
||
|
||
### 1. 访问系统设置页面
|
||
1. 登录系统后，点击左侧导航栏的"系统设置"
|
||
2. 在页面顶部选择"任务清理管理"选项卡
|
||
|
||
### 2. 查看统计信息
|
||
1. 页面加载时自动获取统计信息
|
||
2. 点击"刷新"按钮手动更新统计信息
|
||
3. 统计信息包括：
|
||
- 当前任务总数
|
||
- 已完成任务数
|
||
- 失败任务数
|
||
- 已归档任务数
|
||
- 清理日志数
|
||
- 保留天数
|
||
|
||
### 3. 执行清理操作
|
||
|
||
#### 完整清理
|
||
1. 点击"执行完整清理"按钮
|
||
2. 系统将自动：
|
||
- 导出所有成功任务到归档表
|
||
- 记录失败任务到清理日志
|
||
- 删除原始任务记录
|
||
3. 清理完成后会显示结果统计
|
||
|
||
#### 用户清理
|
||
1. 点击"清理指定用户任务"按钮
|
||
2. 在弹出的对话框中输入用户名
|
||
3. 点击"确认清理"按钮
|
||
4. 系统将清理该用户的所有任务
|
||
|
||
### 4. 配置管理
|
||
1. 在"清理配置"区域设置参数：
|
||
- **任务保留天数**: 任务完成后保留的天数（1-365天）
|
||
- **归档保留天数**: 归档数据保留的天数（30-3650天）
|
||
2. 点击"保存配置"按钮保存设置
|
||
|
||
## 安全提示
|
||
|
||
### 1. 操作不可撤销
|
||
- 清理操作一旦执行，原始任务记录将被删除
|
||
- 请确保在清理前已备份重要数据
|
||
|
||
### 2. 用户清理警告
|
||
- 用户清理会删除该用户的所有任务记录
|
||
- 建议在清理前确认用户身份
|
||
|
||
### 3. 配置影响
|
||
- 修改保留天数会影响自动清理的行为
|
||
- 建议根据实际需求合理设置
|
||
|
||
## API接口
|
||
|
||
### 1. 获取统计信息
|
||
```
|
||
GET /api/cleanup/cleanup-stats
|
||
```
|
||
|
||
### 2. 执行完整清理
|
||
```
|
||
POST /api/cleanup/full-cleanup
|
||
```
|
||
|
||
### 3. 清理用户任务
|
||
```
|
||
POST /api/cleanup/user-tasks/{username}
|
||
```
|
||
|
||
## 测试功能
|
||
|
||
系统提供了测试页面来验证清理功能：
|
||
- 访问路径: `/cleanup-test`
|
||
- 提供所有API接口的测试功能
|
||
- 显示详细的请求和响应信息
|
||
|
||
## 故障排除
|
||
|
||
### 1. 统计信息获取失败
|
||
- 检查网络连接
|
||
- 确认API服务正常运行
|
||
- 查看浏览器控制台错误信息
|
||
|
||
### 2. 清理操作失败
|
||
- 检查数据库连接
|
||
- 确认有足够的权限
|
||
- 查看服务器日志
|
||
|
||
### 3. 配置保存失败
|
||
- 检查配置参数是否有效
|
||
- 确认有写入权限
|
||
- 重启应用使配置生效
|
||
|
||
## 最佳实践
|
||
|
||
### 1. 定期清理
|
||
- 建议每天执行一次完整清理
|
||
- 避免任务表数据过多影响性能
|
||
|
||
### 2. 监控统计
|
||
- 定期查看统计信息
|
||
- 关注失败任务数量变化
|
||
|
||
### 3. 合理配置
|
||
- 根据业务需求设置保留天数
|
||
- 平衡存储空间和数据保留需求
|
||
|
||
---
|
||
*文档更新时间: 2025-01-24*
|
||
*版本: 1.0*
|