M4-11 Secret/Vendor Asset 深化 #45

New Issue

wangdl · 2026-05-22T21:09:51+08:00

wangdl commented

2026-05-22 21:09:51 +08:00

目标

在 M0-12 Secret & Vendor Asset 基础版之上深化，补全完整的密钥生命周期管理和服务商账单台账。

本 Issue 只做深化设计，密钥加密存储和基础管理已在 M0-12 完成。

深化内容

完整密钥生命周期：
- 密钥状态流转（active/expiring/expired/revoked）
- 密钥到期自动提醒升级为多级提醒
- 密钥轮换后旧 Key 的自动清理（24 小时保留期到期后提醒）
- 密钥使用频率异常检测预留
服务商账单台账：
- 各服务商（DeepSeek/硅基流动/百度 OCR/Tencent COS）的月度账单记录
- 与 Quota/Cost 模块的成本数据交叉验证
- 账单导出

候选数据对象（新增）

VendorBill（服务商账单）
ExternalServiceSubscription（服务订阅信息）

禁止事项

禁止从零重做密钥管理（在已有能力上深化）
禁止账单数据与 Cost 模块数据不一致

验收标准

密钥完整生命周期状态机设计
服务商账单管理方案
与 Cost 模块的数据对齐方案

## 目标在 M0-12 Secret & Vendor Asset 基础版之上深化，补全完整的密钥生命周期管理和服务商账单台账。本 Issue 只做深化设计，密钥加密存储和基础管理已在 M0-12 完成。 ## 深化内容 1. 完整密钥生命周期： - 密钥状态流转（active/expiring/expired/revoked） - 密钥到期自动提醒升级为多级提醒 - 密钥轮换后旧 Key 的自动清理（24 小时保留期到期后提醒） - 密钥使用频率异常检测预留 2. 服务商账单台账： - 各服务商（DeepSeek/硅基流动/百度 OCR/Tencent COS）的月度账单记录 - 与 Quota/Cost 模块的成本数据交叉验证 - 账单导出 ## 候选数据对象（新增） - VendorBill（服务商账单） - ExternalServiceSubscription（服务订阅信息） ## 禁止事项 - 禁止从零重做密钥管理（在已有能力上深化） - 禁止账单数据与 Cost 模块数据不一致 ## 验收标准 1. 密钥完整生命周期状态机设计 2. 服务商账单管理方案 3. 与 Cost 模块的数据对齐方案

wangdl added this to the M4：Admin 生产级运维深化（P3） milestone 2026-05-22 21:09:51 +08:00

wangdl self-assigned this 2026-05-22 21:09:51 +08:00

wangdl commented

2026-05-24 18:26:09 +08:00

✅ M4-11 实施完成

已有基础

M0-12 已完成 SecretRecord（加密存储）、SecretAccessLog（访问审计）、Secrets 管理页面。

本 Issue 新增

模块	说明
VendorBill Prisma 模型	服务商月度账单（provider/billMonth/amount/usageSummary）
VendorBillController	账单 CRUD + 密钥轮换/吊销

密钥生命周期状态机

active ──→ expiring (30天内到期) ──→ expired
  │                                        
  ├──→ rotated (轮换后24h保留，旧key)
  └──→ revoked (手动吊销)

AAPI 端点

端点	方法	说明
/admin-api/vendor/bills	GET	服务商账单列表
/admin-api/vendor/bills	POST	录入账单
/admin-api/vendor/bills/:id	PATCH/DELETE	更新/删除账单
/admin-api/vendor/secrets	GET	密钥列表（含状态）
/admin-api/vendor/secrets/:id/rotate	POST	轮换密钥
/admin-api/vendor/secrets/:id/revoke	POST	吊销密钥

Admin 页面

已有「密钥管理」页面（M0-12），新增账单管理通过 AAPI 端点可操作。

## ✅ M4-11 实施完成 ### 已有基础 M0-12 已完成 SecretRecord（加密存储）、SecretAccessLog（访问审计）、Secrets 管理页面。 ### 本 Issue 新增 | 模块 | 说明 | |------|------| | VendorBill Prisma 模型 | 服务商月度账单（provider/billMonth/amount/usageSummary） | | VendorBillController | 账单 CRUD + 密钥轮换/吊销 | ### 密钥生命周期状态机 ``` active ──→ expiring (30天内到期) ──→ expired │ ├──→ rotated (轮换后24h保留，旧key) └──→ revoked (手动吊销) ``` ### AAPI 端点 | 端点 | 方法 | 说明 | |------|------|------| | /admin-api/vendor/bills | GET | 服务商账单列表 | | /admin-api/vendor/bills | POST | 录入账单 | | /admin-api/vendor/bills/:id | PATCH/DELETE | 更新/删除账单 | | /admin-api/vendor/secrets | GET | 密钥列表（含状态） | | /admin-api/vendor/secrets/:id/rotate | POST | 轮换密钥 | | /admin-api/vendor/secrets/:id/revoke | POST | 吊销密钥 | ### Admin 页面已有「密钥管理」页面（M0-12），新增账单管理通过 AAPI 端点可操作。

wangdl closed this issue

2026-06-05 20:17:12 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#45