李建琦
6d655c9903
Release / update-version (push) Has been cancelled
Release / build-frontend (push) Has been cancelled
Release / release (push) Has been cancelled
Release / sync-version-file (push) Has been cancelled
CI / shell (push) Canceled after 0s
CI / test (push) Canceled after 0s
CI / frontend (push) Canceled after 0s
CI / golangci-lint (push) Canceled after 0s
Security Scan / backend-security (push) Canceled after 0s
Security Scan / frontend-security (push) Canceled after 0s
69 lines
3.5 KiB
Go
69 lines
3.5 KiB
Go
package domain
|
||
|
||
import "time"
|
||
|
||
// 渠道监控「配额模式」的归一化配额快照类型。
|
||
//
|
||
// 配额模式监控不直接对接上游，而是关联一个已有账号，复用账号侧的用量服务
|
||
// （AccountUsageService / CNProviderQuotaService / CNProviderBalanceService），
|
||
// 把各平台形态各异的用量数据归一成 MonitorQuotaSnapshot，随检测历史持久化
|
||
// 到 channel_monitor_histories.quota（JSONB），供管理端与用户端渲染。
|
||
//
|
||
// 类型放在 domain 包是因为 ent schema（internal/domain 的下游）需要引用它做
|
||
// field.JSON 序列化；service 不能被 ent import（会造成循环依赖）。
|
||
|
||
// MonitorQuotaTier 单个用量窗口的快照。
|
||
//
|
||
// Window 取值约定（与前端 monitorCommon.quota.windows.* 标签一一对应）：
|
||
// - "5h" 5 小时滚动窗口（Claude/Codex/Kimi/Zhipu coding plan）
|
||
// - "7d" 7 天窗口（Claude/Codex）
|
||
// - "7d-sonnet" Claude 7 天 Sonnet 独立额度
|
||
// - "7d-fable" Claude 7 天 Fable 独立额度
|
||
// - "weekly" 周窗口（Kimi/Zhipu coding plan）
|
||
// - "daily" 日窗口（Gemini 日配额 / Grok 日请求）
|
||
// - "30d" 30 天窗口（Grok 月度）
|
||
// - "total" 无窗口语义的总量额度（Antigravity per-model 等）
|
||
//
|
||
// 同一 Window 可能出现多条（Gemini 多档日配额、Antigravity per-model、
|
||
// Grok requests/tokens），用 Label 区分：Label 是机器 token（requests/tokens/
|
||
// shared/pro/flash 或模型名），前端已知 token 走 i18n，未知原样展示。
|
||
type MonitorQuotaTier struct {
|
||
Window string `json:"window"`
|
||
Label string `json:"label,omitempty"`
|
||
UsedPercent float64 `json:"used_percent"` // 0-100+；仅有绝对值时按 used/limit 计算
|
||
Used float64 `json:"used,omitempty"`
|
||
Limit float64 `json:"limit,omitempty"`
|
||
ResetAt string `json:"reset_at,omitempty"` // RFC3339；未知时留空
|
||
}
|
||
|
||
// MonitorQuotaSnapshot 一次配额查询的完整快照。
|
||
//
|
||
// Source 取值：
|
||
// - "usage" 海外平台（AccountUsageService.GetUsage）
|
||
// - "cn_quota" 国产 Coding Plan（CNProviderQuotaService.QueryUsage）
|
||
// - "cn_balance" 国产按量付费余额（CNProviderBalanceService.QueryBalance）
|
||
type MonitorQuotaSnapshot struct {
|
||
Source string `json:"source"`
|
||
Success bool `json:"success"`
|
||
Tiers []MonitorQuotaTier `json:"tiers,omitempty"`
|
||
Balance *float64 `json:"balance,omitempty"` // cn_balance 主余额
|
||
Balances []MonitorBalance `json:"balances,omitempty"` // 多币种余额（如 DeepSeek CNY+USD）
|
||
Currency string `json:"currency,omitempty"` // 主余额币种
|
||
PlanLevel string `json:"plan_level,omitempty"` // 套餐等级（如智谱 level）
|
||
// BalanceLow 余额低于阈值或账号被上游标记不可用（仅 cn_balance 来源）。
|
||
// 抓取器按 Gateway.CNProviders.BalanceThreshold 判定，口径与账号停调
|
||
// （CNProviderBalanceCheckService.checkOne）一致：任一币种达标即健康。
|
||
BalanceLow bool `json:"balance_low,omitempty"`
|
||
// CredentialInvalid 上游 401/403 鉴权失败（区别于网络/解析错误），
|
||
// 检测状态据此推导 failed 而非 error。
|
||
CredentialInvalid bool `json:"credential_invalid,omitempty"`
|
||
Error string `json:"error,omitempty"` // Success=false 时的错误摘要
|
||
FetchedAt time.Time `json:"fetched_at"`
|
||
}
|
||
|
||
// MonitorBalance 单币种余额条目。
|
||
type MonitorBalance struct {
|
||
Currency string `json:"currency"`
|
||
Balance float64 `json:"balance"`
|
||
}
|