Files
new-api-key-usage/docs/design/交互设计-审计日志.md
T
skycurtain e293a8e5a9 docs: R16 成员档案修改与空壳删除裁决入档
成员操作面扩为可改 name/remark、key_count=0 时硬删空壳;软删除仍是账本实体默认语义。
2026-10-11 22:41:43 +08:00

40 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 交互设计 · 审计日志
> 管理操作留痕的查看面——审计是独立正交需求(与鉴权方案无关),本页是作者的自察工具,无对外语义。
| 项目 | 内容 |
|------|------|
| 状态 | 定稿(2026-10-01;R16 修订 2026-10-10) |
| 关联 | `需求清单.md` §9(访问主体模型·审计日志条目)· `members/users表字段设计.md`(写入时机中「落审计」的动作全集) |
| 数据 | 审计日志表(表结构归技术稿——本文锁定信息结构与展示) |
---
## 1. 记录清单(页面主体)
时间线列表(时间倒序):
| 列 | 内容 |
|----|------|
| 时间 | 到秒(北京时间) |
| 操作者 | `user_id` → 用户名;**系统触发的事件(如空库重建)为 NULL**,天然区分系统操作与会话操作 |
| 操作类型 | 分类标签(见 §2) |
| 内容摘要 | 关键信息(「key 小张-01 · 停用」「成员 A · 令牌重发」「支付记录 #3 · 编辑」) |
## 2. 操作类型体系(登记面的完整枚举)
| 域 | 类型 |
|----|------|
| Key | 登记 / 启用 / 停用 / 归属变更 |
| 支付记录 | 订阅 / 充值登记、编辑、删除 |
| 成员 | 开户 / 档案修改(名称/备注)/ 停用 / 启用 / 令牌签发 / 令牌重发 / 空壳删除 |
| 账号 | 改密 /(空库重建为系统事件,记「初始化」) |
- 每类管理面写操作一行留痕——操作者列当前恒为作者(单管理员),但**审计是不可变历史,操作者归属不能事后补写**:保留该列是前向兼容(未来若扩展多管理员 / 权限引擎,历史记录自然区分),也是审计语义的自描述原则(who did what when 的 who 是本体字段)
- 筛选:按域(Key / 支付 / 成员 / 账号);分页(时间倒序 + 每页 50 条之类,细节随实现)
## 3. 定位边界
- 审计**只记录管理面写操作**:查询类动作(看总览、翻明细)不留痕;成员侧动作(看自己的视图)不属管理面、不在此列
- 本页无任何操作(纯只读)