539 lines
24 KiB
Go
539 lines
24 KiB
Go
package v1
|
||
|
||
import (
|
||
"encoding/json"
|
||
|
||
"github.com/gogf/gf/v2/frame/g"
|
||
"github.com/gogf/gf/v2/os/gtime"
|
||
)
|
||
|
||
// === 仪表盘 ===
|
||
|
||
type AdminDashboardReq struct {
|
||
g.Meta `path:"/dashboard" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"仪表盘统计"`
|
||
}
|
||
|
||
type AdminDashboardRes struct {
|
||
Tenants int `json:"tenants"`
|
||
Members int `json:"members"`
|
||
ActiveChannels int `json:"active_channels"`
|
||
Today *DayStats `json:"today"`
|
||
Yesterday *DayStats `json:"yesterday"`
|
||
Month *MonthStats `json:"month"`
|
||
IpBlacklist *IpBlacklistStats `json:"ip_blacklist"`
|
||
}
|
||
|
||
// IpBlacklistStats IP 黑名单拦截统计（数据存 Redis 缓存，不落库；读取失败时仅回 enabled）
|
||
type IpBlacklistStats struct {
|
||
Enabled bool `json:"enabled"` // 黑名单当前是否启用
|
||
Total int64 `json:"total"` // 累计拦截总次数
|
||
List []IpBlacklistBlockedItem `json:"list"` // 按拦截次数倒序，最多 TOP 20
|
||
}
|
||
|
||
type IpBlacklistBlockedItem struct {
|
||
Ip string `json:"ip"`
|
||
Count int64 `json:"count"`
|
||
}
|
||
|
||
type DayStats struct {
|
||
Requests int `json:"requests"`
|
||
ActiveTenants int `json:"active_tenants"`
|
||
InputTokens int `json:"input_tokens"`
|
||
OutputTokens int `json:"output_tokens"`
|
||
TotalCost float64 `json:"total_cost"`
|
||
SuccessRate float64 `json:"success_rate"`
|
||
}
|
||
|
||
type MonthStats struct {
|
||
Requests int `json:"requests"`
|
||
InputTokens int `json:"input_tokens"`
|
||
OutputTokens int `json:"output_tokens"`
|
||
TotalCost float64 `json:"total_cost"`
|
||
Revenue float64 `json:"revenue"`
|
||
}
|
||
|
||
type AdminDashboardTrendsReq struct {
|
||
g.Meta `path:"/dashboard/trends" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"趋势数据"`
|
||
Days int `json:"days" d:"30" v:"between:1,90" dc:"天数"`
|
||
}
|
||
|
||
type AdminDashboardTrendsRes struct {
|
||
List []map[string]any `json:"list"`
|
||
}
|
||
|
||
type AdminDashboardTopTenantsReq struct {
|
||
g.Meta `path:"/dashboard/top-tenants" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"TOP租户"`
|
||
Days int `json:"days" d:"30" v:"between:1,90" dc:"天数"`
|
||
}
|
||
|
||
type AdminDashboardTopTenantsRes struct {
|
||
List []map[string]any `json:"list"`
|
||
}
|
||
|
||
type AdminDashboardModelDistributionReq struct {
|
||
g.Meta `path:"/dashboard/model-distribution" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"模型分布"`
|
||
Days int `json:"days" d:"30" v:"between:1,90" dc:"天数"`
|
||
}
|
||
|
||
type AdminDashboardModelDistributionRes struct {
|
||
List []map[string]any `json:"list"`
|
||
}
|
||
|
||
type AdminDashboardChannelHealthReq struct {
|
||
g.Meta `path:"/dashboard/channel-health" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"渠道健康概览"`
|
||
}
|
||
|
||
type ChannelHealthItem struct {
|
||
ChannelId int64 `json:"channel_id"`
|
||
ChannelName string `json:"channel_name"`
|
||
Status string `json:"status"`
|
||
HealthScore float64 `json:"health_score"`
|
||
SuccessRate float64 `json:"success_rate"`
|
||
LatencyMs int `json:"latency_ms"`
|
||
}
|
||
|
||
type AdminDashboardChannelHealthRes struct {
|
||
List []ChannelHealthItem `json:"list"`
|
||
}
|
||
|
||
type AdminDashboardRecentAlertsReq struct {
|
||
g.Meta `path:"/dashboard/recent-alerts" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"最近告警"`
|
||
}
|
||
|
||
type RecentAlertItem struct {
|
||
Id int64 `json:"id"`
|
||
RuleName string `json:"rule_name"`
|
||
Level string `json:"level"`
|
||
Status string `json:"status"`
|
||
TriggerMessage string `json:"trigger_message"`
|
||
CreatedAt string `json:"created_at"`
|
||
}
|
||
|
||
type AdminDashboardRecentAlertsRes struct {
|
||
List []RecentAlertItem `json:"list"`
|
||
}
|
||
|
||
// 模型费用按小时堆叠统计（堆叠柱状图）
|
||
type AdminDashboardModelHourlyReq struct {
|
||
g.Meta `path:"/dashboard/model-hourly-cost" method:"get" mime:"json" tags:"管理后台-仪表盘" summary:"模型小时费用堆叠"`
|
||
Hours int `json:"hours" d:"24" v:"between:1,168" dc:"统计小时数（rolling，最近 N 小时）"`
|
||
TopN int `json:"top_n" d:"8" v:"between:1,20" dc:"展示模型数量（其余归为其他）"`
|
||
}
|
||
|
||
type ModelHourlySeriesItem struct {
|
||
Model string `json:"model"`
|
||
Data []float64 `json:"data"` // 对应 Hours 各时间点的费用
|
||
}
|
||
|
||
type AdminDashboardModelHourlyRes struct {
|
||
Hours []string `json:"hours"` // X 轴时间标签
|
||
Models []string `json:"models"` // 图例（含"其他"）
|
||
Series []ModelHourlySeriesItem `json:"series"` // 每个模型一条 series
|
||
}
|
||
|
||
// === 用量日志 ===
|
||
|
||
// AdminUsageLogFilter 用量日志共用筛选条件（列表 / 统计汇总 / 导出三个接口共用，保证筛选口径一致）
|
||
type AdminUsageLogFilter struct {
|
||
ID int64 `json:"id" dc:"用量记录ID"`
|
||
TenantID int64 `json:"tenant_id" dc:"租户ID"`
|
||
UserID int64 `json:"user_id" dc:"用户ID"`
|
||
ApiKeyID int64 `json:"api_key_id" dc:"API Key ID"`
|
||
ChannelID int64 `json:"channel_id" dc:"渠道ID"`
|
||
Model string `json:"model" dc:"模型名称"`
|
||
Status string `json:"status" dc:"状态"`
|
||
RequestType int `json:"request_type" dc:"请求类型: 1=同步, 2=流式, 3=异步, 4=WebSocket"`
|
||
|
||
UpstreamRequestId string `json:"upstream_request_id" dc:"上游请求ID（精确匹配，排障反查用）"`
|
||
|
||
StartDate string `json:"start_date" dc:"开始时间（YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss）"`
|
||
EndDate string `json:"end_date" dc:"结束时间（YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss）"`
|
||
}
|
||
|
||
type AdminUsageLogListReq struct {
|
||
g.Meta `path:"/usage-logs" method:"get" mime:"json" tags:"管理后台-用量" summary:"用量日志列表"`
|
||
Page int `json:"page" d:"1" dc:"页码"`
|
||
PageSize int `json:"page_size" d:"20" v:"between:1,100" dc:"每页数量"`
|
||
AdminUsageLogFilter `json:",inline"` // 嵌入共用筛选条件
|
||
}
|
||
|
||
// AdminUsageLogListItem 用量日志列表项：仅表格列与悬浮明细（Token / 费用分解）所需字段。
|
||
// 纯关联 ID（user_id / project_id / channel_id）与排查大字段（billing_snapshot、
|
||
// user_agent、error_message、request_id 等）不进列表，统一经详情接口按需获取。
|
||
type AdminUsageLogListItem struct {
|
||
Id int64 `json:"id"`
|
||
TenantId int64 `json:"tenant_id"`
|
||
TenantName string `json:"tenant_name"`
|
||
Username string `json:"username"`
|
||
ProjectName string `json:"project_name"`
|
||
ApiKeyId int64 `json:"api_key_id"`
|
||
ApiKeyName string `json:"api_key_name"`
|
||
ChannelName string `json:"channel_name"`
|
||
ModelName string `json:"model_name"`
|
||
UpstreamModel string `json:"upstream_model"`
|
||
RequestType int `json:"request_type"`
|
||
BillingMode string `json:"billing_mode"`
|
||
InputTokens int `json:"input_tokens"`
|
||
OutputTokens int `json:"output_tokens"`
|
||
CacheCreationTokens int `json:"cache_creation_tokens"`
|
||
CacheReadTokens int `json:"cache_read_tokens"`
|
||
CacheCreation5mTokens int `json:"cache_creation_5m_tokens"`
|
||
CacheCreation1hTokens int `json:"cache_creation_1h_tokens"`
|
||
ReasoningTokens int `json:"reasoning_tokens"`
|
||
AudioInputTokens int `json:"audio_input_tokens"`
|
||
AudioOutputTokens int `json:"audio_output_tokens"`
|
||
ImageOutputTokens int `json:"image_output_tokens"`
|
||
InputCost float64 `json:"input_cost"`
|
||
OutputCost float64 `json:"output_cost"`
|
||
CacheCreationCost float64 `json:"cache_creation_cost"`
|
||
CacheReadCost float64 `json:"cache_read_cost"`
|
||
TotalCost float64 `json:"total_cost"`
|
||
ActualCost float64 `json:"actual_cost"`
|
||
RateMultiplier float64 `json:"rate_multiplier"`
|
||
LatencyMs int `json:"latency_ms"`
|
||
FirstTokenMs int `json:"first_token_ms"`
|
||
Status string `json:"status"`
|
||
RetryIndex int `json:"retry_index"`
|
||
CreatedAt *gtime.Time `json:"created_at"`
|
||
}
|
||
|
||
type AdminUsageLogListRes struct {
|
||
List []*AdminUsageLogListItem `json:"list"`
|
||
Total int `json:"total"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"page_size"`
|
||
}
|
||
|
||
// AdminUsageLogItem 用量日志全量字段结构体（详情接口专用，列表用上方的精简 ListItem）
|
||
type AdminUsageLogItem struct {
|
||
Id int64 `json:"id"`
|
||
TenantId int64 `json:"tenant_id"`
|
||
TenantName string `json:"tenant_name"`
|
||
UserId int64 `json:"user_id"`
|
||
Username string `json:"username"`
|
||
ProjectId int64 `json:"project_id"`
|
||
ProjectName string `json:"project_name"`
|
||
ApiKeyId int64 `json:"api_key_id"`
|
||
ApiKeyName string `json:"api_key_name"`
|
||
ChannelId int64 `json:"channel_id"`
|
||
ChannelName string `json:"channel_name"`
|
||
ChannelType int `json:"channel_type"`
|
||
ModelName string `json:"model_name"`
|
||
RequestedModel string `json:"requested_model"`
|
||
UpstreamModel string `json:"upstream_model"`
|
||
RelayMode string `json:"relay_mode"`
|
||
RequestType int `json:"request_type"`
|
||
InputTokens int `json:"input_tokens"`
|
||
OutputTokens int `json:"output_tokens"`
|
||
CacheCreationTokens int `json:"cache_creation_tokens"`
|
||
CacheReadTokens int `json:"cache_read_tokens"`
|
||
CacheCreation5mTokens int `json:"cache_creation_5m_tokens"`
|
||
CacheCreation1hTokens int `json:"cache_creation_1h_tokens"`
|
||
ReasoningTokens int `json:"reasoning_tokens"`
|
||
AudioInputTokens int `json:"audio_input_tokens"`
|
||
AudioOutputTokens int `json:"audio_output_tokens"`
|
||
ImageOutputTokens int `json:"image_output_tokens"`
|
||
InputCost float64 `json:"input_cost"`
|
||
OutputCost float64 `json:"output_cost"`
|
||
CacheCreationCost float64 `json:"cache_creation_cost"`
|
||
CacheReadCost float64 `json:"cache_read_cost"`
|
||
TotalCost float64 `json:"total_cost"`
|
||
ActualCost float64 `json:"actual_cost"`
|
||
Currency string `json:"currency"`
|
||
BillingMode string `json:"billing_mode"`
|
||
BillingSource string `json:"billing_source"`
|
||
RateMultiplier float64 `json:"rate_multiplier"`
|
||
LatencyMs int `json:"latency_ms"`
|
||
FirstTokenMs int `json:"first_token_ms"`
|
||
Status string `json:"status"`
|
||
ErrorMessage string `json:"error_message"`
|
||
RetryIndex int `json:"retry_index"`
|
||
ClientIp string `json:"client_ip"`
|
||
UserAgent string `json:"user_agent"`
|
||
ServiceTier string `json:"service_tier"`
|
||
ReasoningEffort string `json:"reasoning_effort"`
|
||
StreamEndReason string `json:"stream_end_reason"`
|
||
ImageCount int `json:"image_count"`
|
||
ImageSize string `json:"image_size"`
|
||
PreDeductAmount float64 `json:"pre_deduct_amount"`
|
||
RefundAmount float64 `json:"refund_amount"`
|
||
SupplementAmount float64 `json:"supplement_amount"`
|
||
BillingSummary string `json:"billing_summary"`
|
||
BillingSnapshot string `json:"billing_snapshot"`
|
||
InboundEndpoint string `json:"inbound_endpoint"`
|
||
RequestId string `json:"request_id"`
|
||
TaskId string `json:"task_id"`
|
||
UpstreamRequestId string `json:"upstream_request_id"`
|
||
CreatedAt *gtime.Time `json:"created_at"`
|
||
}
|
||
|
||
// AdminUsageLogDetailReq 用量日志详情（列表只返回表格展示字段，
|
||
// billing_snapshot / billing_summary / user_agent / error_message 等大字段经此接口按需获取）
|
||
type AdminUsageLogDetailReq struct {
|
||
g.Meta `path:"/usage-logs/{id}" method:"get" mime:"json" tags:"管理后台-用量" summary:"用量日志详情"`
|
||
Id int64 `json:"id" in:"path" v:"min:1" dc:"用量记录ID"`
|
||
}
|
||
|
||
// AdminUsageLogDetailRes 详情对象平铺进统一响应的 data 字段（json:"-" + 自定义 MarshalJSON，
|
||
// 与 RequestAuditLogDetailRes 同一模式），避免统一包装后再多包一层 data
|
||
type AdminUsageLogDetailRes struct {
|
||
Data *AdminUsageLogItem `json:"-"`
|
||
}
|
||
|
||
func (r *AdminUsageLogDetailRes) MarshalJSON() ([]byte, error) {
|
||
return json.Marshal(r.Data)
|
||
}
|
||
|
||
// AdminUsageLogSummaryReq 用量日志统计请求（复用筛选条件，不包含分页）
|
||
type AdminUsageLogSummaryReq struct {
|
||
g.Meta `path:"/usage-logs/summary" method:"get" mime:"json" tags:"管理后台-用量" summary:"用量日志统计汇总"`
|
||
AdminUsageLogFilter `json:",inline"` // 嵌入共用筛选条件
|
||
}
|
||
|
||
// AdminUsageLogSummary 用量日志统计汇总
|
||
type AdminUsageLogSummaryRes struct {
|
||
TotalCost float64 `json:"total_cost" dc:"总费用(USD)"`
|
||
TotalOutputTokens int64 `json:"total_output_tokens" dc:"总输出token数"`
|
||
CacheReadRatio float64 `json:"cache_read_ratio" dc:"缓存读取占比(%)"`
|
||
}
|
||
|
||
// === 计费记录 ===
|
||
|
||
type AdminBillingRecordListReq struct {
|
||
g.Meta `path:"/billing-records" method:"get" mime:"json" tags:"管理后台-用量" summary:"计费记录列表"`
|
||
Page int `json:"page" d:"1" dc:"页码"`
|
||
PageSize int `json:"page_size" d:"20" v:"between:1,100" dc:"每页数量"`
|
||
TenantID int64 `json:"tenant_id" dc:"租户ID"`
|
||
}
|
||
|
||
type AdminBillingRecordItem struct {
|
||
Id int64 `json:"id"`
|
||
TenantId int64 `json:"tenant_id"`
|
||
TenantName string `json:"tenant_name"`
|
||
UserId int64 `json:"user_id"`
|
||
UserName string `json:"user_name"`
|
||
ChannelId int64 `json:"channel_id"`
|
||
ChannelName string `json:"channel_name"`
|
||
ModelName string `json:"model_name"`
|
||
RelayMode string `json:"relay_mode"`
|
||
InputTokens int `json:"input_tokens"`
|
||
OutputTokens int `json:"output_tokens"`
|
||
InputPrice float64 `json:"input_price"`
|
||
OutputPrice float64 `json:"output_price"`
|
||
TotalCost float64 `json:"total_cost"`
|
||
Currency string `json:"currency"`
|
||
Status string `json:"status"`
|
||
SettledAt *gtime.Time `json:"settled_at"`
|
||
CreatedAt *gtime.Time `json:"created_at"`
|
||
}
|
||
|
||
type AdminBillingRecordListRes struct {
|
||
List []*AdminBillingRecordItem `json:"list"`
|
||
Total int `json:"total"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"page_size"`
|
||
}
|
||
|
||
// === 钱包管理 ===
|
||
|
||
type AdminWalletListReq struct {
|
||
g.Meta `path:"/wallets" method:"get" mime:"json" tags:"管理后台-钱包" summary:"钱包列表"`
|
||
Page int `json:"page" d:"1" dc:"页码"`
|
||
PageSize int `json:"page_size" d:"20" v:"between:1,100" dc:"每页数量"`
|
||
}
|
||
|
||
type AdminWalletItem struct {
|
||
Id int64 `json:"id"`
|
||
TenantId int64 `json:"tenant_id"`
|
||
Balance float64 `json:"balance"`
|
||
FrozenBalance float64 `json:"frozen_balance"`
|
||
WarningThreshold float64 `json:"warning_threshold"`
|
||
Currency string `json:"currency"`
|
||
CreatedAt *gtime.Time `json:"created_at"`
|
||
UpdatedAt *gtime.Time `json:"updated_at"`
|
||
}
|
||
|
||
type AdminWalletListRes struct {
|
||
List []*AdminWalletItem `json:"list"`
|
||
Total int `json:"total"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"page_size"`
|
||
}
|
||
|
||
type AdminWalletInfoReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}" method:"get" mime:"json" tags:"管理后台-钱包" summary:"钱包详情"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
}
|
||
|
||
type AdminWalletInfoRes struct {
|
||
Balance float64 `json:"balance"`
|
||
FrozenBalance float64 `json:"frozen_balance"`
|
||
WarningThreshold *float64 `json:"warning_threshold"`
|
||
}
|
||
|
||
type AdminWalletAdjustReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/adjust" method:"post" mime:"json" tags:"管理后台-钱包" summary:"调整余额"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
Amount float64 `json:"amount" v:"required" dc:"调整金额（正数充值，负数扣减）"`
|
||
Description string `json:"description" dc:"调整说明"`
|
||
}
|
||
|
||
type AdminWalletAdjustRes struct{}
|
||
|
||
type AdminWalletOfflineRechargeReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/offline-recharge" method:"post" mime:"json" tags:"管理后台-钱包" summary:"线下充值入账"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
Amount float64 `json:"amount" v:"required|min:0.01" dc:"线下入账金额（人民币 CNY），按平台汇率换算为 USD 到账"`
|
||
TransactionNo string `json:"transaction_no" dc:"银行转账流水号（选填，用于对账与防重复入账）"`
|
||
Description string `json:"description" v:"required" dc:"入账说明（必填，如客户名称、转账原因）"`
|
||
}
|
||
|
||
type AdminWalletOfflineRechargeRes struct {
|
||
CreditedUSD float64 `json:"credited_usd" dc:"实际入账美元金额"`
|
||
Rate float64 `json:"rate" dc:"使用的 CNY→USD 汇率"`
|
||
Balance float64 `json:"balance" dc:"入账后总余额（USD）"`
|
||
}
|
||
|
||
type AdminWalletTransactionListReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/transactions" method:"get" mime:"json" tags:"管理后台-钱包" summary:"交易流水"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
Page int `json:"page" d:"1" dc:"页码"`
|
||
PageSize int `json:"page_size" d:"20" v:"between:1,100" dc:"每页数量"`
|
||
Type string `json:"type" dc:"交易类型"`
|
||
}
|
||
|
||
type AdminWalletTransactionItem struct {
|
||
ID int64 `json:"id"`
|
||
Type string `json:"type"`
|
||
Amount float64 `json:"amount"`
|
||
BalanceAfter float64 `json:"balance_after"`
|
||
FrozenAfter float64 `json:"frozen_after"`
|
||
Description string `json:"description"`
|
||
UserId int64 `json:"user_id"`
|
||
Username string `json:"username"`
|
||
RequestId string `json:"request_id"`
|
||
ModelName string `json:"model_name"`
|
||
CreatedAt string `json:"created_at"`
|
||
}
|
||
|
||
type AdminWalletTransactionListRes struct {
|
||
List []*AdminWalletTransactionItem `json:"list"`
|
||
Total int `json:"total"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"page_size"`
|
||
}
|
||
|
||
// AdminWalletFrozenItemListReq 冻结明细列表请求（预扣追踪表中 status=frozen 的记录）
|
||
type AdminWalletFrozenItemListReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/frozen-items" method:"get" mime:"json" tags:"管理后台-钱包" summary:"冻结明细列表"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
}
|
||
|
||
// AdminWalletFrozenItem 单笔冻结明细
|
||
type AdminWalletFrozenItem struct {
|
||
RequestID string `json:"request_id" dc:"请求ID"`
|
||
ModelName string `json:"model_name" dc:"模型名称"`
|
||
Amount float64 `json:"amount" dc:"冻结金额（USD）"`
|
||
CreatedAt string `json:"created_at" dc:"冻结时间"`
|
||
AgeSeconds int64 `json:"age_seconds" dc:"已冻结时长（秒）"`
|
||
Releasable bool `json:"releasable" dc:"是否可释放（false 时 block_reason 说明原因）"`
|
||
NeedForce bool `json:"need_force" dc:"是否需要强制释放（冻结时长过短，可能仍有请求进行中）"`
|
||
BlockReason string `json:"block_reason" dc:"不可释放原因（如关联异步任务进行中）"`
|
||
TaskStatus string `json:"task_status" dc:"关联异步任务状态（无关联时为空）"`
|
||
}
|
||
|
||
type AdminWalletFrozenItemListRes struct {
|
||
List []*AdminWalletFrozenItem `json:"list"`
|
||
}
|
||
|
||
// AdminWalletFrozenReleaseReq 按笔释放冻结请求
|
||
type AdminWalletFrozenReleaseReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/frozen-items/release" method:"post" mime:"json" tags:"管理后台-钱包" summary:"释放单笔冻结"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
RequestID string `json:"request_id" v:"required" dc:"要释放的冻结项请求ID"`
|
||
Force bool `json:"force" dc:"强制释放（冻结时长不足保护期时必须显式传 true）"`
|
||
Reason string `json:"reason" v:"required" dc:"释放原因（必填，写入审计）"`
|
||
}
|
||
|
||
type AdminWalletFrozenReleaseRes struct {
|
||
ReleasedAmount float64 `json:"released_amount" dc:"实际释放金额（USD）"`
|
||
}
|
||
|
||
// AdminWalletFrozenReleaseAllReq 一键释放全部冻结请求
|
||
type AdminWalletFrozenReleaseAllReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/frozen-items/release-all" method:"post" mime:"json" tags:"管理后台-钱包" summary:"一键释放全部冻结"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
Force bool `json:"force" dc:"是否强制释放保护期内（冻结不足 10 分钟）的冻结项"`
|
||
Reason string `json:"reason" v:"required" dc:"释放原因（必填，写入审计）"`
|
||
}
|
||
|
||
// AdminWalletFrozenReleaseAllRes 一键释放结果
|
||
type AdminWalletFrozenReleaseAllRes struct {
|
||
ReleasedCount int64 `json:"released_count" dc:"实际释放笔数"`
|
||
ReleasedAmount float64 `json:"released_amount" dc:"实际释放金额合计（USD）"`
|
||
SkippedCount int64 `json:"skipped_count" dc:"跳过笔数（任务关联/待结算/保护期未强制）"`
|
||
SkippedReasons []string `json:"skipped_reasons" dc:"跳过原因摘要（去重）"`
|
||
}
|
||
|
||
type AdminWalletSetWarningThresholdReq struct {
|
||
g.Meta `path:"/wallets/{tenant_id}/warning-threshold" method:"put" mime:"json" tags:"管理后台-钱包" summary:"设置预警阈值"`
|
||
TenantID int64 `json:"tenant_id" in:"path" v:"required|min:1" dc:"租户ID"`
|
||
Threshold float64 `json:"threshold" v:"min:0" dc:"预警阈值"`
|
||
}
|
||
|
||
type AdminWalletSetWarningThresholdRes struct{}
|
||
|
||
// AdminUsageLogExportReq 导出用量日志请求
|
||
type AdminUsageLogExportReq struct {
|
||
g.Meta `path:"/usage-logs/export" method:"get" mime:"json" tags:"管理后台-用量" summary:"导出用量日志"`
|
||
Format string `json:"format" in:"query" d:"csv" v:"in:csv,xlsx" dc:"导出格式：csv / xlsx"`
|
||
AdminUsageLogFilter `json:",inline"` // 嵌入共用筛选条件
|
||
}
|
||
|
||
type AdminUsageLogExportRes struct{}
|
||
|
||
// AdminBillingRecordExportReq 导出计费记录请求
|
||
type AdminBillingRecordExportReq struct {
|
||
g.Meta `path:"/billing-records/export" method:"get" mime:"json" tags:"管理后台-用量" summary:"导出计费记录"`
|
||
Format string `json:"format" in:"query" d:"csv" v:"in:csv,xlsx" dc:"导出格式：csv / xlsx"`
|
||
TenantID int64 `json:"tenant_id" in:"query" dc:"租户ID"`
|
||
}
|
||
|
||
type AdminBillingRecordExportRes struct{}
|
||
|
||
// === 交易流水 ===
|
||
|
||
type AdminTransactionListReq struct {
|
||
g.Meta `path:"/transactions" method:"get" mime:"json" tags:"管理后台-交易" summary:"交易流水列表"`
|
||
Page int `json:"page" d:"1" dc:"页码"`
|
||
PageSize int `json:"page_size" d:"20" v:"between:1,100" dc:"每页数量"`
|
||
TenantID int64 `json:"tenant_id" dc:"租户ID"`
|
||
Type string `json:"type" dc:"交易类型：consume/recharge/adjust"`
|
||
Username string `json:"username" dc:"用户名（模糊匹配）"`
|
||
ModelName string `json:"model_name" dc:"模型名称（模糊匹配）"`
|
||
StartDate string `json:"start_date" dc:"开始日期"`
|
||
EndDate string `json:"end_date" dc:"结束日期"`
|
||
}
|
||
|
||
type AdminTransactionItem struct {
|
||
Id int64 `json:"id"`
|
||
TenantId int64 `json:"tenant_id"`
|
||
TenantName string `json:"tenant_name"`
|
||
Type string `json:"type"`
|
||
Amount float64 `json:"amount"`
|
||
BalanceAfter float64 `json:"balance_after"`
|
||
Description string `json:"description"`
|
||
UserId int64 `json:"user_id"`
|
||
Username string `json:"username"`
|
||
RequestId string `json:"request_id"`
|
||
ModelName string `json:"model_name"`
|
||
CreatedAt string `json:"created_at"`
|
||
}
|
||
|
||
type AdminTransactionListRes struct {
|
||
List []*AdminTransactionItem `json:"list"`
|
||
Total int `json:"total"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"page_size"`
|
||
}
|