操作记录
操作记录页面用于查看、筛选和管理用户操作日志。记录所有用户在系统中的操作行为，包括登录、创建、更新、删除等操作，便于审计和问题追踪。
1. 进入操作记录
1.1 打开操作记录页面
点击顶部下拉列表菜单中的"操作记录"，进入操作记录页面。
2. 查看操作统计
2.1 统计卡片
页面顶部显示四个统计卡片，展示操作概况：
总操作数:
- 显示所有操作记录的总数
- 包括成功和失败的操作
成功操作:
- 显示操作状态为成功的记录数
- 绿色图标标识
- 点击可筛选成功的操作
失败操作:
- 显示操作状态为失败的记录数
- 红色图标标识
- 点击可筛选失败的操作
今日操作:
- 显示今天的操作记录数
- 蓝色图标标识
- 快速了解今日活跃度
3. 筛选操作日志
3.1 基本筛选
使用筛选条件快速定位目标操作记录。
菜单筛选:
- 下拉框选择具体菜单（主页、岗位列表、面试押题等）
- 选择"全部"查看所有菜单的操作
- 快速定位特定页面的操作记录
操作类型筛选:
- 登录：用户登录系统
- 创建：创建新数据
- 更新：修改现有数据
- 删除：删除数据
- 查看：查看详情
- 导出：导出数据
- 导入：导入数据
- 备份：备份操作
- 恢复：恢复操作
状态筛选:
- 成功：操作成功完成
- 失败：操作执行失败
用户 ID 筛选:
- 输入用户 ID 查看特定用户的操作
- 用于审计某个用户的所有行为
3.2 高级筛选
关键词搜索:
- 在描述或详情中搜索关键词
- 支持模糊匹配
- 快速定位包含特定内容的操作
时间范围筛选:
- 选择开始时间和结束时间
- 查看特定时间段的操作记录
- 适用于问题回溯和审计
3.3 组合筛选
多个筛选条件可以组合使用：
示例 1：查看今天的失败操作
- 时间范围：选择今天的日期
- 状态：选择"失败"
示例 2：审计特定用户在模型设置的操作
- 菜单：选择"模型设置"
- 用户 ID：输入目标用户 ID
示例 3：查看所有删除操作
- 操作类型：选择"删除"
4. 查看操作列表
4.1 列表字段说明
操作日志列表以表格形式展示，包含以下字段：
序号:
- 当前页中的序号
- 自动计算，从 1 开始递增
菜单:
- 操作所在的菜单或页面
- 如"主页"、"岗位列表"、"模型设置"等
操作类型:
- 操作的具体类型
- 用不同颜色的标签显示：
- 登录：蓝色
- 创建：绿色
- 更新：橙色
- 删除：红色
- 查看：紫色
- 其他：灰色
描述:
- 操作的详细描述
- 说明操作的具体内容
用户 ID:
- 执行操作的用户标识
- 用于追踪用户行为
IP 地址:
- 操作来源的 IP 地址
- 用于安全审计
状态:
- 操作执行结果
- 成功：绿色勾号图标
- 失败：红色叉号图标
操作时间:
- 操作发生的具体时间
- 格式：YYYY-MM-DD HH:mm:ss
操作:
- 查看：打开详情侧拉弹框
- 删除：删除该条操作记录
4.2 分页功能
列表底部提供分页控件：
功能说明:
- 显示当前页码和总页数
- 显示总记录数
- 每页显示数量可选：10、20、50、100 条
- 切换页码查看更多记录
5. 查看操作详情
5.1 打开详情侧拉弹框
点击操作列表中的"查看"按钮，打开操作详情侧拉弹框。
弹框特性:
- 右侧侧拉弹框，占屏幕宽度 65%
- 显示操作的完整详细信息
- 支持查看请求参数和响应数据
5.2 详情内容
基本信息:
- 操作 ID
- 菜单名称
- 操作类型
- 操作描述
- 用户 ID
- IP 地址
- 操作状态
- 操作时间
请求参数:
- JSON 格式显示请求参数
- 语法高亮显示
- 可复制参数内容
响应数据:
- JSON 格式显示响应结果
- 语法高亮显示
- 可复制响应内容
用户代理:
- 浏览器信息
- 操作系统信息
- 客户端版本
6. 导出操作日志
6.1 导出功能
点击页面顶部的"导出"按钮，导出当前筛选条件下的操作日志。
导出流程:
- 设置筛选条件（可选）
- 点击"导出"按钮
- 系统生成 Excel 文件
- 自动下载到本地
导出内容:
- 序号
- 菜单
- 操作类型
- 描述
- 用户 ID
- IP 地址
- 状态
- 操作时间
使用场景:
- 生成审计报告
- 数据备份
- 离线分析
- 合规审计
7. 删除操作记录
7.1 删除单条记录
点击操作列表中的"删除"按钮，删除单条操作记录。
删除流程:
- 点击目标记录的"删除"按钮
- 弹出确认对话框
- 点击"确定"执行删除
- 显示"删除成功"提示
- 列表自动刷新
注意事项:
- 删除操作不可恢复
- 删除后记录永久移除
- 建议定期导出备份后再清理
7.2 批量删除
使用"批量删除"功能清理大量历史记录。
批量删除流程:
- 选择筛选条件（如时间范围）
- 点击"批量删除"按钮
- 确认删除条件
- 执行批量删除
- 显示删除结果
使用场景:
- 清理过期记录
- 删除测试数据
- 释放存储空间
8. 刷新操作列表
点击页面顶部的"刷新"按钮，重新加载操作日志列表。
刷新功能:
- 获取最新的操作记录
- 更新统计数据
- 保持筛选条件不变
使用场景:
- 查看最新操作
- 验证操作是否记录
- 刷新统计数据
9. 操作日志存储
9.1 日志存储位置
操作日志存储在 SQLite 数据库中：
数据库文件:
- 主机路径：
~/Library/Application Support/cuemate-desktop-client/data/sqlite/cuemate.db - 容器内路径：
/opt/cuemate/data/sqlite/cuemate.db - 表名：
operation_logs
容器卷挂载:
- web-api 服务通过 Docker 卷挂载访问数据库
- 挂载配置：
~/Library/Application Support/cuemate-desktop-client/data/sqlite:/opt/cuemate/data/sqlite - 环境变量：
SQLITE_PATH=/opt/cuemate/data/sqlite/cuemate.db
9.2 日志保留策略
默认保留时间:
- 系统默认保留所有操作记录
- 可通过批量删除清理历史记录
- 建议定期导出后清理
10. 最佳实践
10.1 定期审计
建议审计频率:
- 每日查看失败操作
- 每周查看删除操作
- 每月导出完整日志
- 季度生成审计报告
10.2 安全监控
重点关注:
- 非工作时间的操作
- 频繁失败的操作
- 批量删除操作
- 敏感配置修改
10.3 存储管理
存储优化:
- 定期导出历史记录
- 清理 3 个月前的日志
- 保留重要操作记录
- 监控数据库大小
11. 常见问题
11.1 操作没有记录
问题：执行操作后，在操作记录中找不到记录。
解决方案:
- 点击"刷新"按钮更新列表
- 检查筛选条件是否过滤了该记录
- 查看操作时间是否在筛选的时间范围内
- 清除所有筛选条件后再查看
11.2 导出失败
问题：点击"导出"按钮，下载失败或文件为空。
解决方案:
- 检查网络连接是否正常
- 检查浏览器是否允许下载
- 查看筛选条件下是否有数据
- 尝试减少导出数据量
- 查看浏览器控制台错误信息
11.3 详情查看失败
问题：点击"查看"按钮，详情弹框打不开或加载失败。
解决方案:
- 刷新页面重试
- 检查网络连接
- 查看浏览器控制台错误
- 清除浏览器缓存
11.4 删除失败
问题：点击"删除"按钮，提示删除失败。
解决方案:
- 检查是否有删除权限
- 检查网络连接
- 查看后端服务日志
- 重试删除操作