操作日志
操作日志（审计日志）是后台的「行车记录仪」，把关键管理操作一条条记下来， 方便事后追责与排查问题——比如「这个账号是谁禁用的」「公告什么时候改的」。
- 📜 访问地址：https://gfssm.butian.club/admin/audit
- 当前代码要求已激活的管理员账号；种子权限元数据将这项能力标记为
audit:view。
每条日志记录了什么
每条记录围绕「谁、何时、做了什么、对什么」四个要素：
| 字段 | 含义 | 例子 |
|---|---|---|
| actor（操作者） | 执行操作的管理员 | 某管理员账号 |
| 时间 | 操作发生的时刻 | 2026-07-10 12:30 |
| action（动作） | 做了什么操作 | 改角色 / 发布公告 / 删除任务 |
| target（对象） | 操作作用的对象 | 某个用户 / 某条公告 / 某个部门 |
记录范围与页面范围
- 记录范围：用户角色与状态变更、部门增删改、内容发布/置顶/归档/删除、 站点设置与倒计时调整等关键操作都会被写入。
- 分页：页面每次读取 30 条，支持翻页；这只是展示分页，不是保留上限。
- 导出范围：CSV 最多导出当前筛选结果的前 1000 条。
保留期限由运维策略决定
当前代码没有“仅保留约 300 条并自动淘汰”的逻辑。数据库备份与实际保留期限属于运维策略， 不能从页面分页大小推断。
查看与筛选
- 打开 https://gfssm.butian.club/admin/audit。
- 用搜索、操作者、动作、对象类型和排序控件缩小范围。
- 定位到你关心的某条记录，查看其 actor、时间、action、target。
导出 CSV
需要留底、离线分析或上报时，可把日志导出为 CSV：
- 在 https://gfssm.butian.club/admin/audit 点击导出。
- 得到当前筛选结果的 CSV 文件（最多 1000 条），可用 Excel / 表格软件打开。
- 建议在重要节点（如比赛结束、管理员交接）定期导出归档。
典型排查场景
| 你想弄清楚 | 怎么用日志 |
|---|---|
| 某账号为何登不上 | 按对象筛出该用户，看是否有「禁用」记录及操作者 |
| 谁改了某条公告或设置 | 按对象或动作筛，定位 actor 与时间 |
| 某段时间发生了哪些管理动作 | 按时间排序，通读该时间段的记录 |
| 需要向社团交代管理留痕 | 导出 CSV 作为凭据 |
note
操作日志是只读的审计视图，不能在此处直接改数据。要恢复某个误操作， 请回到对应板块（如 成员目录，或对应的功能页面）执行相应动作。