八、审计日志与 OAuth2
菜单入口：系统管理 → 审计日志与 OAuth2。
本章包含两类能力：审计日志（操作日志、登录日志）回答"谁在什么时候做了什么"，OAuth2.0 管理（应用管理、令牌管理）用于对接第三方应用与单点登录会话管控。
8.1 操作日志
菜单入口：系统管理 → 操作日志。
记录用户的写操作（新增/修改/删除等）流水，是追溯"谁在什么时候改了数据"的第一入口。
页面操作：
- 查询：按操作人、操作模块、操作名、操作内容、操作时间、业务编号过滤，搜索执行、重置清空条件；
- 详情（行内）：查看该次操作的请求参数与返回结果 JSON，以及操作 IP；
- 导出：导出日志（Excel）。
| 列 | 说明 |
|---|---|
| 操作人 | 执行操作的账号 |
| 操作模块 / 操作名 / 操作内容 | 如"用户管理 / 新增用户" |
| 操作时间 / 操作 IP | 发生时间与来源 IP |
| 业务编号 | 关联单据编号（适用时） |
业务规则：
- 日志由后端在接口上标注操作注解后自动记录，无需人工干预，页面只读；
- 只有开发时声明了记录的操作才会落日志（主要是写操作），查询类操作一般不记录；
- 排查思路：先用"操作模块 + 操作时间"缩小范围，再点详情看请求参数定位具体改动。
数据变动：只读页面；数据由各业务写操作自动写入。审计与问题追溯时按需导出留档。
8.2 登录日志
菜单入口：系统管理 → 登录日志。
记录每一次登录/登出尝试（含失败原因），用于安全审计。
页面操作：
- 查询：按用户名称、登录地址、登录日期过滤，搜索执行、重置清空条件；
- 访问统计：以图表方式查看登录趋势（访问量分布）；
- 详情（行内）：查看单次登录的完整信息；
- 导出：导出日志（Excel）。
| 列 | 说明 |
|---|---|
| 操作类型 | 登录 / 登出 |
| 用户名称 | 登录账号 |
| 登录地址 / 浏览器 | 来源 IP 与客户端 |
| 登陆结果 | 成功 / 失败（含验证码错误、密码错误等具体原因） |
| 登录日期 | 发生时间 |
业务规则：
- 登录失败也会落日志，并通过"登陆结果"标注具体原因（密码错误、验证码错误、账号停用等）；
- 发现同一账号短时间多次失败登录，提示可能存在撞库尝试，建议结合强退与改密处置；
- 页面只读，仅支持查询、统计与导出。
数据变动：只读页面；数据由登录/登出动作自动写入。安全事件审计、异地登录排查均以此为准。
8.3 OAuth2.0 应用管理
菜单入口：系统管理 → OAuth2.0 应用管理。
注册 OAuth2 客户端，供第三方应用接入本系统或对接单点登录（SSO）。
页面操作：
- 查询：按应用名、状态过滤，搜索执行、重置清空条件；
- 新增：填写客户端编号（client_id）、客户端密钥（client_secret）、应用名、应用图标、状态、访问令牌的有效期、刷新令牌的有效期、授权类型；
- 编辑（行内）：调整令牌有效期、授权类型等；
- 删除（行内）/ 批量删除：删除不再使用的客户端。
| 列 | 说明 |
|---|---|
| 客户端编号 / 客户端密钥 | 即 client_id / client_secret，第三方接入凭证 |
| 应用名 / 应用图标 | 显示信息 |
| 访问令牌的有效期 / 刷新令牌的有效期 | 控制会话时长（秒/时按配置） |
| 授权类型 | 如 authorization_code / password / refresh_token |
业务规则：
- 客户端密钥（client_secret）只在创建时完整展示，注意保存；密钥是敏感凭证，泄露应立即更换；
- 令牌有效期决定接入方的会话时长：访问令牌过期后需凭刷新令牌换新，刷新令牌也过期则必须重新授权；
- 删除应用后，使用该 client_id 的接入方将立即无法完成授权。
数据变动：写入 OAuth2 客户端表。第三方应用/SSO 登录按 client_id + secret 走授权码等流程换取令牌；颁发的令牌可在OAuth2.0 令牌管理查看与强退。
8.4 OAuth2.0 令牌管理
菜单入口：系统管理 → OAuth2.0 令牌管理。
查看当前已颁发的访问/刷新令牌，并可强制使其失效。
页面操作：
- 查询：按用户编号、用户类型、客户端编号过滤，搜索执行、重置清空条件；
- 强退（行内）：使该令牌立即失效，相当于把该会话强制下线。
| 列 | 说明 |
|---|---|
| 访问令牌 / 刷新令牌 | 当前有效的令牌 |
| 用户编号 / 用户类型 | 令牌所属用户 |
| 过期时间 / 创建时间 | 有效窗口 |
业务规则：
- 令牌过期后自动失效，无需人工处理；强退用于账号异常、设备丢失等需要立即断开会话的场景；
- 强退后该用户/接入方必须重新登录或重新授权；
- 页面只读 + 强退，不提供手工新增令牌。
数据变动：强退会删除/失效对应令牌记录，相关会话立即失去访问权限；此操作本身也会留下审计痕迹。