feat: add admin model usage audit

This commit is contained in:
wlx committed 2026-09-08 20:43:04 +08:00
1 parent 473479fc4c
commit 13f7fbbfcb
11 files changed
+566 -4

No files matched your search

+8
View File
@@ -30,6 +30,12 @@
| `GET/POST /api/admin/invitations` | 管理员 | 邀请码管理 |
| `GET /api/admin/users` | 管理员 | 用户列表 |
| `GET /api/admin/audit` | 管理员 | 审计记录 |
| `GET /api/admin/usage` | 管理员 | 分页查询模型调用/任务记录,可按用户、分发 Key、模型、状态和时间筛选 |
| `GET /api/admin/usage/{id}` | 管理员 | 查看单条调用输入、输出、错误和元数据 |
| `PATCH /api/admin/usage/{id}` | 管理员 | 修改管理员备注 |
| `DELETE /api/admin/usage/{id}` | 管理员 | 软删除单条调用记录 |
| `DELETE /api/admin/usage?ids=...` | 管理员 | 批量软删除调用记录 |
| `GET /api/admin/usage/export` | 管理员 | 按当前筛选条件导出 UTF-8 CSV |
| `GET /v1/models` | 平台 API Key | 返回该 Key 有权限的模型 |
| `POST /v1/chat/completions` | 平台 API Key | 同步聊天调用(已配置供应商 Key 时转发真实上游) |
| `POST /v1/3d/tasks` | 平台 API Key | 创建 3D 异步任务(当前 Mock 执行器) |
@@ -47,6 +53,7 @@
- `V5__usage_events.sql`:用量事件基础表;
- `V6__seed_catalog.sql`:本地首批模型目录初始数据,可由管理员继续增删改造。
- `V7__async_tasks.sql`:3D/视频异步任务、状态和结果元数据。
- `V8__usage_payload_audit.sql`:调用/任务输入输出、分发 Key、供应商、错误、管理员备注和软删除字段。
Java 版本沿用现有 TypeScript 服务的表命名,便于后续迁移 RDS;供应商密钥只返回掩码,数据库保存 AES-GCM 密文,主密钥由 `CREDENTIAL_ENCRYPTION_KEY` 注入。生产环境应进一步使用 KMS/RAM 托管该主密钥。
@@ -71,6 +78,7 @@ Invoke-WebRequest http://localhost:8080/health
- `/v1/3d/tasks` 和 `/v1/video/tasks` 已提供数据库持久化 Mock worker,真实供应商执行器尚未替换;
- Seedance、Tripo/VAST 的异步任务和 OSS 结果存储尚未迁移到 Java;
- 异步任务已持久化并提供按模型的排队上限(默认 100,可由 `TASK_MAX_QUEUED_PER_MODEL` 调整),但真实供应商执行器、优先级调度、价格/额度扣减和计费账单仍沿用下一节点计划;
- 模型调用记录会自动保存同步请求/响应和异步任务入队结果,输入输出中的 `authorization`、`api_key`、`token`、`secret`、`password` 等字段会脱敏,单个文本字段最多 8000 字符、单个 JSON 载荷最多 32000 字符;管理员可筛选、查看、备注、软删除和导出 CSV;
- Docker 镜像需要在具备 Maven 和 Docker daemon 的环境中构建验证。
## 下一节点