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*
|