634 lines
50 KiB
Go
634 lines
50 KiB
Go
// ================================================================================
|
||
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
|
||
// You can delete these comments if you wish manually maintain this interface file.
|
||
// ================================================================================
|
||
|
||
package service
|
||
|
||
import (
|
||
"context"
|
||
|
||
v1 "github.com/qianfree/team-api/api/admin/v1"
|
||
)
|
||
|
||
type (
|
||
IAdmin interface {
|
||
// ListUsers returns a paginated list of admin users.
|
||
ListUsers(ctx context.Context, req *v1.AdminUserListReq) (*v1.AdminUserListRes, error)
|
||
// CreateUser creates a new admin user.
|
||
CreateUser(ctx context.Context, req *v1.AdminUserCreateReq) (*v1.AdminUserCreateRes, error)
|
||
// UpdateUser updates an admin user.
|
||
UpdateUser(ctx context.Context, req *v1.AdminUserUpdateReq) (*v1.AdminUserUpdateRes, error)
|
||
// DeleteUser deletes an admin user.
|
||
DeleteUser(ctx context.Context, req *v1.AdminUserDeleteReq) (*v1.AdminUserDeleteRes, error)
|
||
// UpdateUserStatus enables or disables an admin user.
|
||
UpdateUserStatus(ctx context.Context, req *v1.AdminUserUpdateStatusReq) (*v1.AdminUserUpdateStatusRes, error)
|
||
// UnlockUser 清除管理员的登录锁定状态（重置失败计数与锁定截止时间）。
|
||
//
|
||
// 解锁是本文件里唯一漏掉 assertCanManageAdminUser 的账号处置动作：锁定本身是暴力破解
|
||
// 的防线，非超管若能解锁超级管理员账号，就等于可以无限次重置对方的失败计数继续爆破。
|
||
UnlockUser(ctx context.Context, req *v1.AdminUserUnlockReq) (*v1.AdminUserUnlockRes, error)
|
||
// ResetUserPassword resets an admin user's password.
|
||
ResetUserPassword(ctx context.Context, req *v1.AdminUserResetPasswordReq) (*v1.AdminUserResetPasswordRes, error)
|
||
// ExportUsers exports admin users to CSV or Excel.
|
||
ExportUsers(ctx context.Context, req *v1.AdminUserExportReq) (*v1.AdminUserExportRes, error)
|
||
// CreateAgreement 创建协议版本
|
||
CreateAgreement(ctx context.Context, req *v1.AgreementCreateReq) (*v1.AgreementCreateRes, error)
|
||
// ListAgreements 协议版本列表
|
||
ListAgreements(ctx context.Context, req *v1.AgreementListReq) (*v1.AgreementListRes, error)
|
||
// GetAgreement 协议版本详情
|
||
GetAgreement(ctx context.Context, req *v1.AgreementGetReq) (*v1.AgreementGetRes, error)
|
||
// UpdateAgreement 更新协议版本（仅 draft）
|
||
UpdateAgreement(ctx context.Context, req *v1.AgreementUpdateReq) (*v1.AgreementUpdateRes, error)
|
||
// DeleteAgreement 删除协议版本（仅 draft）
|
||
DeleteAgreement(ctx context.Context, req *v1.AgreementDeleteReq) (*v1.AgreementDeleteRes, error)
|
||
// PublishAgreement 发布协议版本
|
||
PublishAgreement(ctx context.Context, req *v1.AgreementPublishReq) (*v1.AgreementPublishRes, error)
|
||
// ListAgreementAcceptances 协议接受记录列表
|
||
ListAgreementAcceptances(ctx context.Context, req *v1.AgreementAcceptanceListReq) (*v1.AgreementAcceptanceListRes, error)
|
||
// ListAdminPendingAgreements 当前管理员待接受的协议
|
||
ListAdminPendingAgreements(ctx context.Context, req *v1.AdminAgreementPendingReq) (*v1.AdminAgreementPendingRes, error)
|
||
// AcceptAdminAgreements 管理员接受协议
|
||
AcceptAdminAgreements(ctx context.Context, req *v1.AdminAgreementAcceptReq) (*v1.AdminAgreementAcceptRes, error)
|
||
// GetAuditConfig retrieves the global audit level from sys_options.
|
||
GetAuditConfig(ctx context.Context, _ *v1.AuditConfigGetReq) (*v1.AuditConfigGetRes, error)
|
||
// UpdateAuditConfig updates the global audit level.
|
||
UpdateAuditConfig(ctx context.Context, req *v1.AuditConfigUpdateReq) (*v1.AuditConfigUpdateRes, error)
|
||
// ListOperationLogs retrieves a paginated list of operation logs with optional filters.
|
||
ListOperationLogs(ctx context.Context, req *v1.OperationLogListReq) (*v1.OperationLogListRes, error)
|
||
// ListSensitiveAccessLogs retrieves a paginated list of sensitive data access logs.
|
||
ListSensitiveAccessLogs(ctx context.Context, req *v1.SensitiveLogListReq) (*v1.SensitiveLogListRes, error)
|
||
// ListRequestAuditLogs 分页查询请求审计日志（不返回 request_body/response_body 以优化性能）
|
||
// 审计数据从审计库查询，关联信息（用户名、租户名等）从主库批量查询后在应用层合并。
|
||
ListRequestAuditLogs(ctx context.Context, req *v1.RequestAuditLogListReq) (*v1.RequestAuditLogListRes, error)
|
||
// GetRequestAuditLogDetail 查询单条请求审计日志详情（含完整 request_body 和 response_body）
|
||
GetRequestAuditLogDetail(ctx context.Context, req *v1.RequestAuditLogDetailReq) (*v1.RequestAuditLogDetailRes, error)
|
||
// ForwardingTraceGet 按 request_id 查询请求转发路径追踪（仅管理员，用量日志详情懒加载用）。
|
||
// 从审计库查询 aud_request_logs（可能独立于主库），仅取 forwarding_trace 与 audit_level 两列。
|
||
// 一个 request_id 仅对应一条审计记录（任务完成审计为 UPDATE 非 INSERT），OrderDesc 取最新为防御性兜底。
|
||
ForwardingTraceGet(ctx context.Context, req *v1.ForwardingTraceGetReq) (*v1.ForwardingTraceGetRes, error)
|
||
// ExportOperationLogs exports operation logs to CSV or Excel.
|
||
ExportOperationLogs(ctx context.Context, req *v1.OperationLogExportReq) (*v1.OperationLogExportRes, error)
|
||
// ContentFilterLogList returns a paginated list of content filter interception logs.
|
||
// 审计数据从审计库查询，关联信息从主库批量查询后在应用层合并。
|
||
ContentFilterLogList(ctx context.Context, req *v1.ContentFilterLogListReq) (*v1.ContentFilterLogListRes, error)
|
||
// ContentFilterLogClear 硬删除全部内容过滤拦截日志。
|
||
// 拦截日志为追加型审计流水，堆积后用 TRUNCATE 秒级清空并立即归还磁盘空间
|
||
// （DELETE 需等 VACUUM 回收）。TRUNCATE 不返回行数，故先取删除前条数作为反馈。
|
||
// 表无数据库级外键，TRUNCATE 安全。
|
||
ContentFilterLogClear(ctx context.Context, _ *v1.ContentFilterLogClearReq) (*v1.ContentFilterLogClearRes, error)
|
||
// Login handles admin login.
|
||
Login(ctx context.Context, req *v1.AdminLoginReq) (*v1.AdminLoginRes, error)
|
||
// Logout handles admin logout.
|
||
Logout(ctx context.Context, _ *v1.AdminLogoutReq) (*v1.AdminLogoutRes, error)
|
||
// Refresh handles token refresh.
|
||
Refresh(ctx context.Context, req *v1.AdminRefreshReq) (*v1.AdminRefreshRes, error)
|
||
// ListSessions returns active sessions for the current admin user.
|
||
ListSessions(ctx context.Context, req *v1.AdminSessionListReq) (*v1.AdminSessionListRes, error)
|
||
// RevokeSession revokes a specific session.
|
||
RevokeSession(ctx context.Context, req *v1.AdminRevokeSessionReq) (*v1.AdminRevokeSessionRes, error)
|
||
// ForceLogout revokes all sessions for a specific user.
|
||
ForceLogout(ctx context.Context, req *v1.AdminForceLogoutReq) (*v1.AdminForceLogoutRes, error)
|
||
// ChangePassword handles admin password change.
|
||
ChangePassword(ctx context.Context, req *v1.AdminChangePasswordReq) (*v1.AdminChangePasswordRes, error)
|
||
// GetMe 返回当前登录用户的信息与有效权限。
|
||
//
|
||
// 权限此前只在登录响应里下发一次，之后前端从 localStorage 恢复：管理员改了某人的权限，
|
||
// 对方不重新登录就一直按旧权限渲染菜单。前端在应用启动与 token 刷新后调用本接口刷新。
|
||
GetMe(ctx context.Context, _ *v1.AdminMeReq) (*v1.AdminMeRes, error)
|
||
// CreateChangelog 创建更新日志
|
||
CreateChangelog(ctx context.Context, req *v1.ChangelogCreateReq) (*v1.ChangelogCreateRes, error)
|
||
// ListChangelogs 更新日志列表（管理后台，含草稿）
|
||
ListChangelogs(ctx context.Context, req *v1.ChangelogListReq) (*v1.ChangelogListRes, error)
|
||
// UpdateChangelog 更新更新日志
|
||
UpdateChangelog(ctx context.Context, req *v1.ChangelogUpdateReq) (*v1.ChangelogUpdateRes, error)
|
||
// DeleteChangelog 删除更新日志
|
||
DeleteChangelog(ctx context.Context, req *v1.ChangelogDeleteReq) (*v1.ChangelogDeleteRes, error)
|
||
// PublishChangelog 发布更新日志
|
||
PublishChangelog(ctx context.Context, req *v1.ChangelogPublishReq) (*v1.ChangelogPublishRes, error)
|
||
// ListChannelOptions 渠道下拉选项（不分页，返回全部渠道）。
|
||
// 刻意不做状态过滤：日志 / 统计页的渠道筛选项要覆盖历史数据里出现过的全部渠道，
|
||
// 已停用渠道同样需要能作为筛选条件；status 原样返回，由前端决定是否标记。
|
||
// 注意与 /admin/channels 的区别：后者是渠道管理列表（分页 + 健康度联表 + 运行态），
|
||
// 下拉场景不要用它 —— 那是本接口存在的意义。
|
||
ListChannelOptions(ctx context.Context, _ *v1.ChannelOptionsReq) (*v1.ChannelOptionsRes, error)
|
||
ListChannels(ctx context.Context, req *v1.ChannelListReq) (*v1.ChannelListRes, error)
|
||
// CloneChannel 克隆渠道
|
||
CloneChannel(ctx context.Context, req *v1.ChannelCloneReq) (*v1.ChannelCloneRes, error)
|
||
// CreateChannel 创建渠道
|
||
CreateChannel(ctx context.Context, req *v1.ChannelCreateReq) (*v1.ChannelCreateRes, error)
|
||
// UpdateChannel 更新渠道
|
||
UpdateChannel(ctx context.Context, req *v1.ChannelUpdateReq) (*v1.ChannelUpdateRes, error)
|
||
// DeleteChannel 删除渠道
|
||
DeleteChannel(ctx context.Context, req *v1.ChannelDeleteReq) (*v1.ChannelDeleteRes, error)
|
||
// GetChannelDetail 获取渠道详情
|
||
GetChannelDetail(ctx context.Context, req *v1.ChannelDetailReq) (*v1.ChannelDetailRes, error)
|
||
// AddChannelKey 添加渠道 API Key（已废弃：每渠道仅支持一个 Key）
|
||
AddChannelKey(ctx context.Context, req *v1.ChannelKeyCreateReq) (*v1.ChannelKeyCreateRes, error)
|
||
// DeleteChannelKey 删除渠道 API Key
|
||
DeleteChannelKey(ctx context.Context, req *v1.ChannelKeyDeleteReq) (*v1.ChannelKeyDeleteRes, error)
|
||
// SetChannelAbilities 设置渠道模型能力
|
||
SetChannelAbilities(ctx context.Context, req *v1.ChannelAbilityBatchReq) (*v1.ChannelAbilityBatchRes, error)
|
||
// GetChannelKeys 获取渠道 Key 列表
|
||
GetChannelKeys(ctx context.Context, req *v1.ChannelKeyListReq) (*v1.ChannelKeyListRes, error)
|
||
// GetChannelAbilities 获取渠道模型能力列表
|
||
GetChannelAbilities(ctx context.Context, req *v1.ChannelAbilitiesGetReq) (*v1.ChannelAbilitiesGetRes, error)
|
||
// GetProviderDefaultURLs 获取供应商默认 API 地址
|
||
GetProviderDefaultURLs(ctx context.Context, _ *v1.ProviderDefaultURLReq) (*v1.ProviderDefaultURLRes, error)
|
||
// GetChannelHealthTrend 获取渠道健康趋势数据（健康度、延迟在 SQL 层四舍五入取整，避免展示小数）
|
||
// 不再返回 stability_score / consecutive_failures：健康体系重写后这两列已停止写入，
|
||
// 返回恒定值只会让前端画出两条毫无意义的常量线。
|
||
GetChannelHealthTrend(ctx context.Context, req *v1.ChannelHealthTrendReq) (*v1.ChannelHealthTrendRes, error)
|
||
// ResetChannelHealth 重置渠道健康度（渠道可能已修复、重新可用）：落库健康分 80（展示层），
|
||
// 并复位熔断 + 成功率 EWMA（调度层），使渠道立即恢复被调度选择的能力。
|
||
ResetChannelHealth(ctx context.Context, req *v1.ChannelResetHealthReq) (*v1.ChannelResetHealthRes, error)
|
||
// ExportChannels exports channel list to CSV or Excel.
|
||
ExportChannels(ctx context.Context, req *v1.ChannelExportReq) (*v1.ChannelExportRes, error)
|
||
// ChannelDebugLogList 渠道调试日志列表（原生 SQL：octet_length 表达式经 gdb Fields 有引号化风险）
|
||
ChannelDebugLogList(ctx context.Context, req *v1.ChannelDebugLogListReq) (*v1.ChannelDebugLogListRes, error)
|
||
// ChannelDebugLogStats 渠道调试日志统计（条数/落库体积/最早时间，供清理提示）
|
||
ChannelDebugLogStats(ctx context.Context, req *v1.ChannelDebugLogStatsReq) (*v1.ChannelDebugLogStatsRes, error)
|
||
// ChannelDebugLogDetail 渠道调试日志详情（四段完整报文；headers JSONB 解析为对象便于前端渲染）
|
||
ChannelDebugLogDetail(ctx context.Context, req *v1.ChannelDebugLogDetailReq) (*v1.ChannelDebugLogDetailRes, error)
|
||
// ChannelDebugLogDelete 删除单条调试日志（硬删除）
|
||
ChannelDebugLogDelete(ctx context.Context, req *v1.ChannelDebugLogDeleteReq) (*v1.ChannelDebugLogDeleteRes, error)
|
||
// ChannelDebugLogClear 清空渠道调试日志（按渠道硬删除全部）
|
||
ChannelDebugLogClear(ctx context.Context, req *v1.ChannelDebugLogClearReq) (*v1.ChannelDebugLogClearRes, error)
|
||
// ChannelErrorEventList 渠道错误事件列表
|
||
ChannelErrorEventList(ctx context.Context, req *v1.ChannelErrorEventListReq) (*v1.ChannelErrorEventListRes, error)
|
||
// ChannelErrorStats 渠道错误统计
|
||
ChannelErrorStats(ctx context.Context, req *v1.ChannelErrorStatsReq) (*v1.ChannelErrorStatsRes, error)
|
||
// ChannelErrorTrend 渠道错误趋势
|
||
ChannelErrorTrend(ctx context.Context, req *v1.ChannelErrorTrendReq) (*v1.ChannelErrorTrendRes, error)
|
||
// ChannelErrorTopChannels 错误最多的渠道
|
||
ChannelErrorTopChannels(ctx context.Context, req *v1.ChannelErrorTopChannelsReq) (*v1.ChannelErrorTopChannelsRes, error)
|
||
// ChannelErrorCategories 错误分类选项
|
||
ChannelErrorCategories(ctx context.Context, req *v1.ChannelErrorCategoriesReq) (*v1.ChannelErrorCategoriesRes, error)
|
||
// ChannelErrorClear 硬删除全部渠道错误事件。
|
||
// 错误风暴时事件表堆积很快，用 TRUNCATE 而非逐行 DELETE 秒级清空并立即归还磁盘空间。
|
||
// TRUNCATE 不返回行数，故先取删除前条数作为反馈。表无数据库级外键，TRUNCATE 安全。
|
||
// 注意异步写入器（DefaultChannelErrorWriter）清空后继续写入新事件，属预期行为。
|
||
ChannelErrorClear(ctx context.Context, _ *v1.ChannelErrorClearReq) (*v1.ChannelErrorClearRes, error)
|
||
// ChannelOAuthAuthURL 生成 OAuth 授权链接
|
||
ChannelOAuthAuthURL(ctx context.Context, req *v1.ChannelOAuthAuthURLReq) (*v1.ChannelOAuthAuthURLRes, error)
|
||
// ChannelOAuthExchange OAuth 授权码换取令牌
|
||
ChannelOAuthExchange(ctx context.Context, req *v1.ChannelOAuthExchangeReq) (*v1.ChannelOAuthExchangeRes, error)
|
||
// ChannelOAuthRefresh 手动刷新 OAuth 令牌
|
||
ChannelOAuthRefresh(ctx context.Context, req *v1.ChannelOAuthRefreshReq) (*v1.ChannelOAuthRefreshRes, error)
|
||
// TestChannel 测试渠道可用性（发送最小请求验证）。
|
||
// 不限制渠道状态：禁用中的渠道也允许手动测试，便于管理员在启用放流量前确认已恢复；
|
||
// 自动探测 cron 只查 active 渠道，禁用渠道不会被自动探测。
|
||
TestChannel(ctx context.Context, req *v1.ChannelTestReq) (*v1.ChannelTestRes, error)
|
||
// CronJobList returns all registered cron jobs with their last execution status.
|
||
CronJobList(ctx context.Context, _ *v1.CronJobListReq) (*v1.CronJobListRes, error)
|
||
// CronJobTrigger manually triggers a cron job.
|
||
CronJobTrigger(ctx context.Context, req *v1.CronJobTriggerReq) (*v1.CronJobTriggerRes, error)
|
||
// GetDashboardStats 获取管理后台仪表盘统计
|
||
GetDashboardStats(ctx context.Context, req *v1.AdminDashboardReq) (*v1.AdminDashboardRes, error)
|
||
// GetDashboardTrends returns daily revenue and request trends for the past N days.
|
||
GetDashboardTrends(ctx context.Context, req *v1.AdminDashboardTrendsReq) (*v1.AdminDashboardTrendsRes, error)
|
||
// GetTopTenants returns the top 10 tenants by revenue.
|
||
GetTopTenants(ctx context.Context, req *v1.AdminDashboardTopTenantsReq) (*v1.AdminDashboardTopTenantsRes, error)
|
||
// GetModelDistribution returns the model usage distribution.
|
||
GetModelDistribution(ctx context.Context, req *v1.AdminDashboardModelDistributionReq) (*v1.AdminDashboardModelDistributionRes, error)
|
||
// GetModelHourlyCost 模型费用按小时堆叠统计，用于仪表盘堆叠柱状图：
|
||
// 取最近 N 小时内费用最高的 TopN 个模型，按小时聚合费用，非 TopN 模型归并为"其他"。
|
||
GetModelHourlyCost(ctx context.Context, req *v1.AdminDashboardModelHourlyReq) (*v1.AdminDashboardModelHourlyRes, error)
|
||
// GetAllUsageLogs 获取所有租户的用量日志（管理后台）
|
||
GetAllUsageLogs(ctx context.Context, req *v1.AdminUsageLogListReq) (*v1.AdminUsageLogListRes, error)
|
||
// GetUsageLogDetail 获取单条用量日志详情（含 billing_snapshot / billing_summary /
|
||
// user_agent / error_message 等列表不返回的大字段）。
|
||
// bil_usage_logs 按 created_at 月分区且 PK 为 (id, created_at)：仅按 id 查询无法
|
||
// 分区裁剪，计划为对各月分区的 Append 索引探测（每分区走本地 PK 前缀命中 id），
|
||
// 分区数随月份线性增长但单次探测为微秒级，与 upstream_request_id 反查（000023）
|
||
// 同一模式；若日后分区数显著增大，可让调用方携带 created_at 提示做裁剪。
|
||
GetUsageLogDetail(ctx context.Context, req *v1.AdminUsageLogDetailReq) (*v1.AdminUsageLogDetailRes, error)
|
||
// GetUsageLogSummary 获取用量日志统计汇总（独立接口，与列表共用筛选口径）
|
||
GetUsageLogSummary(ctx context.Context, req *v1.AdminUsageLogSummaryReq) (*v1.AdminUsageLogSummaryRes, error)
|
||
// GetAllBillingRecords 获取所有计费记录（管理后台）
|
||
GetAllBillingRecords(ctx context.Context, req *v1.AdminBillingRecordListReq) (*v1.AdminBillingRecordListRes, error)
|
||
// GetTenantWallets 获取所有租户钱包（管理后台）
|
||
GetTenantWallets(ctx context.Context, req *v1.AdminWalletListReq) (*v1.AdminWalletListRes, error)
|
||
// AdjustBalance 调整租户余额（管理后台）。
|
||
// Redis 权威化架构：余额变动以 Redis Lua 为资金提交点（扣减在权威可用余额上原子判断，
|
||
// 穿透冻结会破坏预扣一致性），DB 侧仅记流水；流水失败时逆转 Redis 已发生的变动。
|
||
AdjustBalance(ctx context.Context, req *v1.AdminWalletAdjustReq) (*v1.AdminWalletAdjustRes, error)
|
||
// OfflineRecharge 线下充值入账（管理后台）
|
||
// 场景：用户线下银行转账（人民币 CNY），运营确认到账后入账。
|
||
// 本位币=USD 时按平台汇率换算入账；本位币=CNY 时直接入账（无换汇）。
|
||
// 与 AdjustBalance 的区别：走正规充值链路——余额与累计充值同步累加、触发等级检查、
|
||
// 流水类型为 recharge，并在描述中携带 CNY 快照（原始人民币 + 汇率 + 入账金额 + 转账流水号），
|
||
// 供现金对账与开票追溯。
|
||
OfflineRecharge(ctx context.Context, req *v1.AdminWalletOfflineRechargeReq) (*v1.AdminWalletOfflineRechargeRes, error)
|
||
// GetWalletInfo 获取租户钱包信息（管理后台）。
|
||
// balance/frozen_balance 以 Redis 权威值为准（Redis 是资金提交点，调整余额/线下入账后立即可见），
|
||
// DB 侧余额是物化器周期覆盖的滞后副本，仅作钱包行存在性校验与 Redis 不可用时的降级展示。
|
||
GetWalletInfo(ctx context.Context, req *v1.AdminWalletInfoReq) (*v1.AdminWalletInfoRes, error)
|
||
// GetWalletTransactions 获取租户钱包交易流水（管理后台）
|
||
GetWalletTransactions(ctx context.Context, req *v1.AdminWalletTransactionListReq) (*v1.AdminWalletTransactionListRes, error)
|
||
// SetWarningThreshold 设置租户钱包预警阈值（管理后台）
|
||
SetWarningThreshold(ctx context.Context, req *v1.AdminWalletSetWarningThresholdReq) (*v1.AdminWalletSetWarningThresholdRes, error)
|
||
// GetWalletFrozenItems 获取租户钱包冻结明细（管理后台）。
|
||
// 数据源为 Redis 预扣明细（权威），DB 预扣追踪表已废弃。
|
||
GetWalletFrozenItems(ctx context.Context, req *v1.AdminWalletFrozenItemListReq) (*v1.AdminWalletFrozenItemListRes, error)
|
||
// ReleaseWalletFrozenItem 按笔释放冻结（管理后台运维逃生舱）。
|
||
// 释放走 billing.UnfreezePreDeduct 的 Redis 认领路径：认领即删预扣 hash、幂等、逐笔精确，
|
||
// 绝不直接改写钱包 hash 的 frozen_balance 汇总值。
|
||
ReleaseWalletFrozenItem(ctx context.Context, req *v1.AdminWalletFrozenReleaseReq) (*v1.AdminWalletFrozenReleaseRes, error)
|
||
// ReleaseAllWalletFrozenItems 一键释放租户全部冻结（管理后台运维逃生舱）。
|
||
// 遍历 Redis 活跃冻结明细，复用 frozenItemGuard 护栏逐项筛选：
|
||
// - 任务关联在途/待结算项自动跳过（由任务结算流程负责，禁止手动释放）；
|
||
// - 保护期内（冻结不足 frozenReleaseMinAge）项默认跳过，Force=true 时才释放；
|
||
// - 其余项逐个 UnfreezePreDeduct（Lua 认领即删，幂等，与并发结算竞争安全）。
|
||
//
|
||
// 返回实际释放笔数/金额与跳过原因摘要（去重）。
|
||
ReleaseAllWalletFrozenItems(ctx context.Context, req *v1.AdminWalletFrozenReleaseAllReq) (*v1.AdminWalletFrozenReleaseAllRes, error)
|
||
// GetAllTransactions 获取所有租户交易流水（管理后台）
|
||
GetAllTransactions(ctx context.Context, req *v1.AdminTransactionListReq) (*v1.AdminTransactionListRes, error)
|
||
// GetDashboardChannelHealth 获取渠道健康概览（最不健康的5个活跃渠道）
|
||
GetDashboardChannelHealth(ctx context.Context, req *v1.AdminDashboardChannelHealthReq) (*v1.AdminDashboardChannelHealthRes, error)
|
||
// GetDashboardRecentAlerts 获取最近5条告警
|
||
GetDashboardRecentAlerts(ctx context.Context, req *v1.AdminDashboardRecentAlertsReq) (*v1.AdminDashboardRecentAlertsRes, error)
|
||
// ExportUsageLogs exports usage logs to CSV or Excel.
|
||
ExportUsageLogs(ctx context.Context, req *v1.AdminUsageLogExportReq) (*v1.AdminUsageLogExportRes, error)
|
||
// ExportBillingRecords exports billing records to CSV or Excel.
|
||
ExportBillingRecords(ctx context.Context, req *v1.AdminBillingRecordExportReq) (*v1.AdminBillingRecordExportRes, error)
|
||
DataGovernanceSettingsGet(ctx context.Context, _ *v1.DataGovernanceSettingsGetReq) (*v1.DataGovernanceSettingsGetRes, error)
|
||
// UpdateDataGovernanceSettings 更新数据治理设置
|
||
DataGovernanceSettingsUpdate(ctx context.Context, req *v1.DataGovernanceSettingsUpdateReq) (*v1.DataGovernanceSettingsUpdateRes, error)
|
||
// RequestDataExport 请求数据导出
|
||
DataGovernanceExport(ctx context.Context, req *v1.DataGovernanceExportReq) (*v1.DataGovernanceExportRes, error)
|
||
// RequestDataDeletion 请求数据删除
|
||
DataGovernanceDeletion(ctx context.Context, req *v1.DataGovernanceDeletionReq) (*v1.DataGovernanceDeletionRes, error)
|
||
// TriggerDataCleanup 手动触发数据清理
|
||
DataGovernanceCleanup(ctx context.Context, _ *v1.DataGovernanceCleanupReq) (*v1.DataGovernanceCleanupRes, error)
|
||
// ListEmailSendLogs 分页查询邮件发送记录（ntf_send_log，主库）。
|
||
// 列表不返回 body（HTML 正文较大），由详情接口返回完整记录。
|
||
ListEmailSendLogs(ctx context.Context, req *v1.EmailSendLogListReq) (*v1.EmailSendLogListRes, error)
|
||
// GetEmailSendLogDetail 查询单条邮件发送记录详情（含 body 正文）。
|
||
GetEmailSendLogDetail(ctx context.Context, req *v1.EmailSendLogDetailReq) (*v1.EmailSendLogDetailRes, error)
|
||
// ListEmailVerifyCodes 分页查询验证码申请记录（sys_email_verify_codes，主库）。
|
||
ListEmailVerifyCodes(ctx context.Context, req *v1.EmailVerifyCodeListReq) (*v1.EmailVerifyCodeListRes, error)
|
||
// ErrorLogList returns a paginated list of system error logs.
|
||
ErrorLogList(ctx context.Context, req *v1.ErrorLogListReq) (*v1.ErrorLogListRes, error)
|
||
// ErrorLogDetail returns the detail of a single error log.
|
||
ErrorLogDetail(ctx context.Context, req *v1.ErrorLogDetailReq) (*v1.ErrorLogDetailRes, error)
|
||
// ErrorLogResolve marks an error log as resolved.
|
||
ErrorLogResolve(ctx context.Context, req *v1.ErrorLogResolveReq) (*v1.ErrorLogResolveRes, error)
|
||
// ErrorLogBatchResolve marks multiple error logs as resolved.
|
||
ErrorLogBatchResolve(ctx context.Context, req *v1.ErrorLogBatchResolveReq) (*v1.ErrorLogBatchResolveRes, error)
|
||
// ErrorLogClear 硬删除全部错误日志。
|
||
// 系统报错大量堆积时用于快速释放数据库空间：用 TRUNCATE 而非逐行 DELETE，
|
||
// 秒级清空并立即归还磁盘空间（DELETE 需等 VACUUM 回收）。TRUNCATE 不返回行数，
|
||
// 故先取删除前条数作为反馈。表无数据库级外键，TRUNCATE 安全。
|
||
ErrorLogClear(ctx context.Context, _ *v1.ErrorLogClearReq) (*v1.ErrorLogClearRes, error)
|
||
// ErrorLogStats returns error log statistics.
|
||
ErrorLogStats(ctx context.Context, _ *v1.ErrorLogStatsReq) (*v1.ErrorLogStatsRes, error)
|
||
// ListAllFeedbacks 管理后台反馈列表
|
||
ListAllFeedbacks(ctx context.Context, req *v1.FeedbackListAllReq) (*v1.FeedbackListAllRes, error)
|
||
// ReplyToFeedback 管理员回复反馈
|
||
ReplyToFeedback(ctx context.Context, req *v1.FeedbackReplyReq) (*v1.FeedbackReplyRes, error)
|
||
// UpdateFeedbackStatus 更新反馈状态
|
||
UpdateFeedbackStatus(ctx context.Context, req *v1.FeedbackUpdateStatusReq) (*v1.FeedbackUpdateStatusRes, error)
|
||
// GetFeedbackStats 反馈统计
|
||
GetFeedbackStats(ctx context.Context, req *v1.FeedbackStatsReq) (*v1.FeedbackStatsRes, error)
|
||
// FileList 文件列表（分页 + 筛选）。
|
||
FileList(ctx context.Context, req *v1.FileListReq) (*v1.FileListRes, error)
|
||
// FileStats 存储占用统计（KPI）。
|
||
FileStats(ctx context.Context, req *v1.FileStatsReq) (*v1.FileStatsRes, error)
|
||
// FileDownload 生成临时预览下载链接。
|
||
FileDownload(ctx context.Context, req *v1.FileDownloadReq) (*v1.FileDownloadRes, error)
|
||
// FileDelete 删除单个文件（存储对象 + 记录）。
|
||
FileDelete(ctx context.Context, req *v1.FileDeleteReq) (*v1.FileDeleteRes, error)
|
||
// FileCleanup 手动触发一次保留期清理（导出 + 图片）。
|
||
FileCleanup(ctx context.Context, req *v1.FileCleanupReq) (*v1.FileCleanupRes, error)
|
||
// CreateHelpCategory 创建帮助分类
|
||
CreateHelpCategory(ctx context.Context, req *v1.HelpCategoryCreateReq) (*v1.HelpCategoryCreateRes, error)
|
||
// UpdateHelpCategory 更新帮助分类
|
||
UpdateHelpCategory(ctx context.Context, req *v1.HelpCategoryUpdateReq) (*v1.HelpCategoryUpdateRes, error)
|
||
// DeleteHelpCategory 删除帮助分类
|
||
DeleteHelpCategory(ctx context.Context, req *v1.HelpCategoryDeleteReq) (*v1.HelpCategoryDeleteRes, error)
|
||
// ListHelpCategories 帮助分类列表（管理后台）
|
||
ListHelpCategories(ctx context.Context, req *v1.HelpCategoryListReq) (*v1.HelpCategoryListRes, error)
|
||
// CreateHelpArticle 创建帮助文章
|
||
CreateHelpArticle(ctx context.Context, req *v1.HelpArticleCreateReq) (*v1.HelpArticleCreateRes, error)
|
||
// UpdateHelpArticle 更新帮助文章
|
||
UpdateHelpArticle(ctx context.Context, req *v1.HelpArticleUpdateReq) (*v1.HelpArticleUpdateRes, error)
|
||
// DeleteHelpArticle 删除帮助文章
|
||
DeleteHelpArticle(ctx context.Context, req *v1.HelpArticleDeleteReq) (*v1.HelpArticleDeleteRes, error)
|
||
// ListHelpArticles 帮助文章列表（管理后台）
|
||
ListHelpArticles(ctx context.Context, req *v1.HelpArticleListReq) (*v1.HelpArticleListRes, error)
|
||
// GetHelpArticle 帮助文章详情（管理后台）
|
||
GetHelpArticle(ctx context.Context, req *v1.HelpArticleGetReq) (*v1.HelpArticleGetRes, error)
|
||
// CreateMember adds a new member to a specified tenant.
|
||
CreateMember(ctx context.Context, req *v1.AdminMemberCreateReq) (*v1.AdminMemberCreateRes, error)
|
||
// ListAllMembers returns a paginated list of all tenant members across all tenants.
|
||
ListAllMembers(ctx context.Context, req *v1.AdminMemberListReq) (*v1.AdminMemberListRes, error)
|
||
// DisableMember disables a tenant member by admin.
|
||
DisableMember(ctx context.Context, req *v1.AdminMemberDisableReq) (*v1.AdminMemberDisableRes, error)
|
||
// EnableMember re-enables a tenant member by admin.
|
||
EnableMember(ctx context.Context, req *v1.AdminMemberEnableReq) (*v1.AdminMemberEnableRes, error)
|
||
// ResetMemberPassword resets a member's password by admin, returns the new random password.
|
||
ResetMemberPassword(ctx context.Context, req *v1.AdminMemberResetPasswordReq) (*v1.AdminMemberResetPasswordRes, error)
|
||
// UnlockMember 清除成员的登录锁定状态（平台视角，跨租户）。
|
||
UnlockMember(ctx context.Context, req *v1.AdminMemberUnlockReq) (*v1.AdminMemberUnlockRes, error)
|
||
// ExportMembers exports member list to CSV or Excel.
|
||
ExportMembers(ctx context.Context, req *v1.AdminMemberExportReq) (*v1.AdminMemberExportRes, error)
|
||
// ListModelOptions 获取模型选项列表（不分页，用于下拉选择）
|
||
ListModelOptions(ctx context.Context, req *v1.ModelOptionsReq) (*v1.ModelOptionsRes, error)
|
||
// ListModels 获取模型列表（含定价摘要）
|
||
ListModels(ctx context.Context, req *v1.ModelListReq) (*v1.ModelListRes, error)
|
||
// CreateModel 创建模型（自动创建默认 token 定价记录）
|
||
CreateModel(ctx context.Context, req *v1.ModelCreateReq) (*v1.ModelCreateRes, error)
|
||
// UpdateModel 更新模型（含弃用状态管理）
|
||
UpdateModel(ctx context.Context, req *v1.ModelUpdateReq) (*v1.ModelUpdateRes, error)
|
||
// DeleteModel 删除模型（同时删除定价记录、租户分配记录和分组关联）
|
||
DeleteModel(ctx context.Context, req *v1.ModelDeleteReq) (*v1.ModelDeleteRes, error)
|
||
// GetModelPricing 获取模型定价（pricing JSONB 单行还原为 PricingItem 列表，响应结构与旧多行结构保持兼容）
|
||
GetModelPricing(ctx context.Context, req *v1.PricingGetReq) (*v1.PricingGetRes, error)
|
||
// SetModelPricing 设置模型定价（全量替换）
|
||
SetModelPricing(ctx context.Context, req *v1.PricingSetReq) (*v1.PricingSetRes, error)
|
||
// FetchOfficialPricing 拉取模型官方定价（来自 LiteLLM + models.dev 双数据源）
|
||
FetchOfficialPricing(ctx context.Context, req *v1.PricingFetchOfficialReq) (*v1.PricingFetchOfficialRes, error)
|
||
// FetchOfficialModelInfo 按模型名称拉取官方模型信息（上下文长度+能力特性）
|
||
// 按优先级尝试 LiteLLM → OpenRouter → BaseLLM，返回第一个匹配的结果
|
||
FetchOfficialModelInfo(ctx context.Context, req *v1.ModelFetchOfficialInfoReq) (*v1.ModelFetchOfficialInfoRes, error)
|
||
// ExportModels exports model list to CSV or Excel.
|
||
ExportModels(ctx context.Context, req *v1.ModelExportReq) (*v1.ModelExportRes, error)
|
||
// ListModelGroups 模型分组列表
|
||
ListModelGroups(ctx context.Context, req *v1.ModelGroupListReq) (*v1.ModelGroupListRes, error)
|
||
// CreateModelGroup 创建模型分组
|
||
CreateModelGroup(ctx context.Context, req *v1.ModelGroupCreateReq) (*v1.ModelGroupCreateRes, error)
|
||
// UpdateModelGroup 更新模型分组
|
||
UpdateModelGroup(ctx context.Context, req *v1.ModelGroupUpdateReq) (*v1.ModelGroupUpdateRes, error)
|
||
// DeleteModelGroup 删除模型分组
|
||
DeleteModelGroup(ctx context.Context, req *v1.ModelGroupDeleteReq) (*v1.ModelGroupDeleteRes, error)
|
||
// ListModelGroupOptions 分组选项列表（不分页，用于下拉选择）
|
||
ListModelGroupOptions(ctx context.Context, req *v1.ModelGroupOptionsReq) (*v1.ModelGroupOptionsRes, error)
|
||
// ListGroupModels 查看分组内模型列表
|
||
ListGroupModels(ctx context.Context, req *v1.GroupModelsListReq) (*v1.GroupModelsListRes, error)
|
||
// SetGroupModels 设置分组内模型（全量替换）
|
||
SetGroupModels(ctx context.Context, req *v1.GroupModelsSetReq) (*v1.GroupModelsSetRes, error)
|
||
// ListTenantGroups 查看租户关联的分组列表
|
||
ListTenantGroups(ctx context.Context, req *v1.TenantGroupsListReq) (*v1.TenantGroupsListRes, error)
|
||
// SetTenantGroups 设置租户关联的分组（全量替换）
|
||
SetTenantGroups(ctx context.Context, req *v1.TenantGroupsSetReq) (*v1.TenantGroupsSetRes, error)
|
||
// ExportModelsJson 导出模型配置为 JSON 文件（含定价数据，用于跨环境迁移）
|
||
ExportModelsJson(ctx context.Context, req *v1.ModelExportJsonReq) (*v1.ModelExportJsonRes, error)
|
||
// ImportModelsPreview 导入模型预览（解析上传文件，检测冲突）
|
||
ImportModelsPreview(ctx context.Context, req *v1.ModelImportPreviewReq) (*v1.ModelImportPreviewRes, error)
|
||
// ImportModels 确认导入模型（事务内执行）
|
||
ImportModels(ctx context.Context, req *v1.ModelImportReq) (*v1.ModelImportRes, error)
|
||
// ListTemplates 获取通知模板列表（分页）
|
||
ListTemplates(ctx context.Context, req *v1.TemplateListReq) (*v1.TemplateListRes, error)
|
||
// GetTemplate 获取单个通知模板
|
||
GetTemplate(ctx context.Context, req *v1.TemplateGetReq) (*v1.TemplateGetRes, error)
|
||
// UpdateTemplate 更新通知模板
|
||
UpdateTemplate(ctx context.Context, req *v1.TemplateUpdateReq) (*v1.TemplateUpdateRes, error)
|
||
// TestTemplate 用测试变量渲染模板，返回渲染结果（不发送）
|
||
TestTemplate(ctx context.Context, req *v1.TemplateTestReq) (*v1.TemplateTestRes, error)
|
||
// SendMessage 创建手动站内消息并推送 WebSocket 通知
|
||
SendMessage(ctx context.Context, req *v1.MessageSendReq) (*v1.MessageSendRes, error)
|
||
// SendBroadcast 创建广播消息并推送 WebSocket 通知
|
||
SendBroadcast(ctx context.Context, req *v1.MessageBroadcastReq) (*v1.MessageBroadcastRes, error)
|
||
// ListMessages 获取所有消息列表（管理后台，支持过滤）
|
||
ListMessages(ctx context.Context, req *v1.MessageListReq) (*v1.MessageListRes, error)
|
||
// CreateAnnouncement 创建公告
|
||
CreateAnnouncement(ctx context.Context, req *v1.AnnouncementCreateReq) (*v1.AnnouncementCreateRes, error)
|
||
// UpdateAnnouncement 更新公告
|
||
UpdateAnnouncement(ctx context.Context, req *v1.AnnouncementUpdateReq) (*v1.AnnouncementUpdateRes, error)
|
||
// ListAnnouncements 获取公告列表（分页）
|
||
ListAnnouncements(ctx context.Context, req *v1.AnnouncementListReq) (*v1.AnnouncementListRes, error)
|
||
// PublishAnnouncement 发布公告
|
||
PublishAnnouncement(ctx context.Context, req *v1.AnnouncementPublishReq) (*v1.AnnouncementPublishRes, error)
|
||
// ArchiveAnnouncement 归档公告
|
||
ArchiveAnnouncement(ctx context.Context, req *v1.AnnouncementArchiveReq) (*v1.AnnouncementArchiveRes, error)
|
||
// ListOrders 获取全部订单列表
|
||
ListOrders(ctx context.Context, req *v1.OrderListReq) (*v1.OrderListRes, error)
|
||
// GetOrder 获取订单详情
|
||
GetOrder(ctx context.Context, req *v1.OrderDetailReq) (*v1.OrderDetailRes, error)
|
||
// RefundOrder 发起退款（线上侧一步完成：状态流转 + 权益收回；渠道打款由管理员线下原路退回）。
|
||
//
|
||
// 退款语义（与《系统货币规则》对齐）：
|
||
// - 退款认订单原始 CNY 金额（ord_ 层永远 CNY），线下按此金额原路退给用户；
|
||
// - 已履约的充值订单必须按【履约当时入账的 USD】原额扣回钱包（从入账流水取值，
|
||
// 禁止按当前汇率反算，防止汇率波动套利）；
|
||
// - 已履约的套餐订单撤销对应的活跃订阅；
|
||
// - 已支付未履约（paid）的订单权益尚未发放，仅做状态流转。
|
||
RefundOrder(ctx context.Context, req *v1.OrderRefundReq) (*v1.OrderRefundRes, error)
|
||
// OrderComplete 手动完成订单
|
||
OrderComplete(ctx context.Context, req *v1.OrderCompleteReq) (*v1.OrderCompleteRes, error)
|
||
// GetPaymentChannels 获取所有渠道配置（单例模式，从 sys_options 读取）
|
||
GetPaymentChannels(ctx context.Context, _ *v1.PaymentChannelListReq) (*v1.PaymentChannelListRes, error)
|
||
// SavePaymentChannel 保存指定渠道的配置（整体覆盖）
|
||
SavePaymentChannel(ctx context.Context, req *v1.PaymentChannelSaveReq) (*v1.PaymentChannelSaveRes, error)
|
||
// GetPaymentSettings 获取全局支付设置。
|
||
GetPaymentSettings(ctx context.Context, _ *v1.PaymentSettingsGetReq) (*v1.PaymentSettingsGetRes, error)
|
||
// UpdatePaymentSettings 更新全局支付设置。
|
||
UpdatePaymentSettings(ctx context.Context, req *v1.PaymentSettingsUpdateReq) (*v1.PaymentSettingsUpdateRes, error)
|
||
// ExportOrders exports order list to CSV or Excel.
|
||
ExportOrders(ctx context.Context, req *v1.OrderExportReq) (*v1.OrderExportRes, error)
|
||
// GetUserPermissions returns permission points and data scopes for an admin user.
|
||
GetUserPermissions(ctx context.Context, req *v1.AdminPermissionListReq) (*v1.AdminPermissionListRes, error)
|
||
// UpdateUserPermissions updates permission points for an admin user.
|
||
UpdateUserPermissions(ctx context.Context, req *v1.AdminPermissionUpdateReq) (*v1.AdminPermissionUpdateRes, error)
|
||
// GetAllPermissions returns all predefined permission groups plus tier metadata.
|
||
//
|
||
// 同时返回权限点分组（高级模式用）与「模块 × 档位」元数据（默认配置界面用）：
|
||
// 二者是同一份数据的两个视图，由后端统一给出，避免前端复刻一份档位定义造成漂移。
|
||
GetAllPermissions(ctx context.Context, _ *v1.AdminAllPermissionsReq) (*v1.AdminAllPermissionsRes, error)
|
||
// ListPlans 获取套餐列表
|
||
ListPlans(ctx context.Context, req *v1.PlanListReq) (*v1.PlanListRes, error)
|
||
// GetPlan 获取套餐详情
|
||
GetPlan(ctx context.Context, req *v1.PlanDetailReq) (*v1.PlanDetailRes, error)
|
||
// CreatePlan 创建套餐
|
||
CreatePlan(ctx context.Context, req *v1.PlanCreateReq) (*v1.PlanCreateRes, error)
|
||
// UpdatePlan 更新套餐
|
||
UpdatePlan(ctx context.Context, req *v1.PlanUpdateReq) (*v1.PlanUpdateRes, error)
|
||
// ArchivePlan 下架套餐（软删除）
|
||
ArchivePlan(ctx context.Context, req *v1.PlanArchiveReq) (*v1.PlanArchiveRes, error)
|
||
// ToggleRecommend 切换推荐标记
|
||
ToggleRecommend(ctx context.Context, req *v1.PlanToggleRecommendReq) (*v1.PlanToggleRecommendRes, error)
|
||
// ExportPlans exports plan list to CSV or Excel.
|
||
ExportPlans(ctx context.Context, req *v1.PlanExportReq) (*v1.PlanExportRes, error)
|
||
PluginList(ctx context.Context, req *v1.PluginListReq) (*v1.PluginListRes, error)
|
||
PluginDetail(ctx context.Context, req *v1.PluginDetailReq) (*v1.PluginDetailRes, error)
|
||
PluginInstall(ctx context.Context, req *v1.PluginInstallReq) (*v1.PluginInstallRes, error)
|
||
PluginEnable(ctx context.Context, req *v1.PluginEnableReq) (*v1.PluginEnableRes, error)
|
||
PluginDisable(ctx context.Context, req *v1.PluginDisableReq) (*v1.PluginDisableRes, error)
|
||
PluginUninstall(ctx context.Context, req *v1.PluginUninstallReq) (*v1.PluginUninstallRes, error)
|
||
PluginUpgrade(ctx context.Context, req *v1.PluginUpgradeReq) (*v1.PluginUpgradeRes, error)
|
||
PluginConfigUpdate(ctx context.Context, req *v1.PluginConfigUpdateReq) (*v1.PluginConfigUpdateRes, error)
|
||
PluginConfigSchema(ctx context.Context, req *v1.PluginConfigSchemaReq) (*v1.PluginConfigSchemaRes, error)
|
||
// ListPromoCodes 获取优惠码列表
|
||
ListPromoCodes(ctx context.Context, req *v1.PromoCodeListReq) (*v1.PromoCodeListRes, error)
|
||
// CreatePromoCode 创建优惠码
|
||
CreatePromoCode(ctx context.Context, req *v1.PromoCodeCreateReq) (*v1.PromoCodeCreateRes, error)
|
||
// UpdatePromoCode 更新优惠码
|
||
UpdatePromoCode(ctx context.Context, req *v1.PromoCodeUpdateReq) (*v1.PromoCodeUpdateRes, error)
|
||
// GetPromoCodeUsages 获取优惠码使用记录
|
||
GetPromoCodeUsages(ctx context.Context, req *v1.PromoCodeUsagesReq) (*v1.PromoCodeUsagesRes, error)
|
||
// ExportPromoCodes exports promo code list to CSV or Excel.
|
||
ExportPromoCodes(ctx context.Context, req *v1.PromoCodeExportReq) (*v1.PromoCodeExportRes, error)
|
||
// ListRedemptions 获取兑换码列表
|
||
ListRedemptions(ctx context.Context, req *v1.RedemptionListReq) (*v1.RedemptionListRes, error)
|
||
// BatchCreateRedemptions 批量生成兑换码
|
||
BatchCreateRedemptions(ctx context.Context, req *v1.RedemptionCreateReq) (*v1.RedemptionCreateRes, error)
|
||
// DisableRedemption 禁用兑换码
|
||
DisableRedemption(ctx context.Context, req *v1.RedemptionDisableReq) (*v1.RedemptionDisableRes, error)
|
||
// ListRedemptionUsages 获取兑换码使用记录
|
||
ListRedemptionUsages(ctx context.Context, req *v1.RedemptionUsagesReq) (*v1.RedemptionUsagesRes, error)
|
||
// ExportRedemptions exports redemption list to CSV or Excel.
|
||
ExportRedemptions(ctx context.Context, req *v1.RedemptionExportReq) (*v1.RedemptionExportRes, error)
|
||
// AssignUserRoles 为管理员分配角色（全量覆盖）。
|
||
AssignUserRoles(ctx context.Context, req *v1.AdminUserRoleAssignReq) (*v1.AdminUserRoleAssignRes, error)
|
||
// GetUserRoles 查询管理员已分配的角色。
|
||
GetUserRoles(ctx context.Context, req *v1.AdminUserRoleListReq) (*v1.AdminUserRoleListRes, error)
|
||
// ListRoles 返回角色列表（角色数量少，不分页）。
|
||
ListRoles(ctx context.Context, _ *v1.AdminRoleListReq) (*v1.AdminRoleListRes, error)
|
||
// GetRoleDetail 返回角色详情，同时给出权限点全集与按模块归纳的档位视图。
|
||
GetRoleDetail(ctx context.Context, req *v1.AdminRoleDetailReq) (*v1.AdminRoleDetailRes, error)
|
||
// CreateRole 新建角色。权限可直接给出，也可从现有角色复制。
|
||
CreateRole(ctx context.Context, req *v1.AdminRoleCreateReq) (*v1.AdminRoleCreateRes, error)
|
||
// UpdateRole 更新角色的名称、说明、排序与权限（code 不可修改）。
|
||
UpdateRole(ctx context.Context, req *v1.AdminRoleUpdateReq) (*v1.AdminRoleUpdateRes, error)
|
||
// UpdateRoleStatus 启用/禁用角色。禁用后该角色的权限对全部关联用户立即失效。
|
||
UpdateRoleStatus(ctx context.Context, req *v1.AdminRoleStatusUpdateReq) (*v1.AdminRoleStatusUpdateRes, error)
|
||
// DeleteRole 删除角色，并在同一事务内级联清理其权限行与用户关联。
|
||
//
|
||
// 无外键，级联必须由业务层完成，否则会留下悬空的权限行与用户关联。
|
||
// 预置角色同样可删：is_builtin 只标识来源，不构成删除保护。
|
||
//
|
||
// 不存在把自己锁死的风险 —— 超级管理员由 sys_admin_users.role 判定并短路鉴权，
|
||
// 不依赖任何角色记录，即便角色被删光也能登录并重建，因此不设「至少保留一个角色」的约束。
|
||
DeleteRole(ctx context.Context, req *v1.AdminRoleDeleteReq) (*v1.AdminRoleDeleteRes, error)
|
||
// ResetRoleDefaults 把预置角色的权限恢复为出厂默认值。
|
||
ResetRoleDefaults(ctx context.Context, req *v1.AdminRoleResetReq) (*v1.AdminRoleResetRes, error)
|
||
// Verify2FA handles the 2FA verification step during admin login.
|
||
Verify2FA(ctx context.Context, req *v1.Admin2FAVerifyReq) (*v1.Admin2FAVerifyRes, error)
|
||
// Setup2FA starts the 2FA setup process for the current admin user.
|
||
Setup2FA(ctx context.Context, _ *v1.Admin2FASetupReq) (*v1.Admin2FASetupRes, error)
|
||
// Enable2FA confirms and enables 2FA after verifying the code.
|
||
Enable2FA(ctx context.Context, req *v1.Admin2FAEnableReq) (*v1.Admin2FAEnableRes, error)
|
||
// Disable2FA disables 2FA for the current admin user.
|
||
Disable2FA(ctx context.Context, req *v1.Admin2FADisableReq) (*v1.Admin2FADisableRes, error)
|
||
// RegenerateBackupCodes generates new backup codes.
|
||
RegenerateBackupCodes(ctx context.Context, req *v1.Admin2FARegenerateBackupCodesReq) (*v1.Admin2FARegenerateBackupCodesRes, error)
|
||
// ConfirmHighRisk generates a confirm token for high-risk operations.
|
||
ConfirmHighRisk(ctx context.Context, req *v1.Admin2FAConfirmReq) (*v1.Admin2FAConfirmRes, error)
|
||
// LoginHistory returns the login history for all admin users with search filters.
|
||
LoginHistory(ctx context.Context, req *v1.AdminLoginHistoryReq) (*v1.AdminLoginHistoryRes, error)
|
||
// TenantLoginHistory returns login history for tenant users (admin view).
|
||
TenantLoginHistory(ctx context.Context, req *v1.AdminTenantLoginHistoryReq) (*v1.AdminTenantLoginHistoryRes, error)
|
||
// GetSettingsCategories returns all available setting categories.
|
||
GetSettingsCategories(ctx context.Context, _ *v1.AdminSettingsCategoriesReq) (*v1.AdminSettingsCategoriesRes, error)
|
||
// GetSettings retrieves settings with schema for a given category.
|
||
GetSettings(ctx context.Context, req *v1.AdminSettingsGetReq) (*v1.AdminSettingsGetRes, error)
|
||
// UpdateSettings batch-updates settings for a given category.
|
||
UpdateSettings(ctx context.Context, req *v1.AdminSettingsUpdateReq) (*v1.AdminSettingsUpdateRes, error)
|
||
// TestStorageConfig 测试对象存储配置连通性：用生成的测试图片走一次「上传 → 下载校验 → 删除」
|
||
// 完整往返，验证凭证 / 桶 / 端点 / 读写删权限是否正常。
|
||
//
|
||
// access_key_id / secret 为空或掩码（"******"）时回落到已保存的配置值——与 GET 接口对敏感字段
|
||
// 的掩码逻辑（config.GetCategoryWithValues）以及 Turnstile 校验的 "******" 处理保持一致，
|
||
// 从而支持管理员在「未点保存」的状态下直接测试表单中新填/改动的配置。
|
||
TestStorageConfig(ctx context.Context, req *v1.AdminStorageTestReq) (*v1.AdminStorageTestRes, error)
|
||
// TestEmailConfig 发送一封测试邮件，验证 SMTP 配置是否可用。
|
||
//
|
||
// 与 TestStorageConfig 同构：请求体携带表单中的邮件配置（可能尚未保存），字段为空或为掩码
|
||
// "******" 时回落到已保存的值，从而支持管理员在「未点保存」的状态下直接测试改动。
|
||
// 收件人留空时发送给当前登录管理员的邮箱。
|
||
//
|
||
// 使用 SendOnce 而非 Send：连通性测试要快速拿到真实 SMTP 错误（认证失败、端口不通重试
|
||
// 三次也不会变好），不该让管理员多等十几秒的退避。
|
||
TestEmailConfig(ctx context.Context, req *v1.AdminEmailTestReq) (*v1.AdminEmailTestRes, error)
|
||
// GetSupportPendingSummary 顶栏铃铛待办计数。
|
||
GetSupportPendingSummary(ctx context.Context, _ *v1.AdminSupportPendingSummaryReq) (*v1.AdminSupportPendingSummaryRes, error)
|
||
// TaskList 大模型异步任务列表
|
||
TaskList(ctx context.Context, req *v1.TaskListReq) (*v1.TaskListRes, error)
|
||
// TaskDetail 大模型异步任务详情
|
||
TaskDetail(ctx context.Context, req *v1.TaskDetailReq) (*v1.TaskDetailRes, error)
|
||
// TaskCancel 取消大模型异步任务
|
||
TaskCancel(ctx context.Context, req *v1.TaskCancelReq) (*v1.TaskCancelRes, error)
|
||
// TenantSelect returns a lightweight paginated tenant list for dropdown selectors.
|
||
TenantSelect(ctx context.Context, req *v1.TenantSelectReq) (*v1.TenantSelectRes, error)
|
||
// CreateTenant creates a new tenant with its owner user and wallet.
|
||
CreateTenant(ctx context.Context, req *v1.TenantCreateReq) (*v1.TenantCreateRes, error)
|
||
// ListTenants returns a paginated list of tenants.
|
||
ListTenants(ctx context.Context, req *v1.TenantListReq) (*v1.TenantListRes, error)
|
||
// GetTenant returns detail of a single tenant.
|
||
GetTenant(ctx context.Context, req *v1.TenantGetReq) (*v1.TenantGetRes, error)
|
||
// UpdateTenantStatus updates a tenant's status.
|
||
UpdateTenantStatus(ctx context.Context, req *v1.TenantUpdateStatusReq) (*v1.TenantUpdateStatusRes, error)
|
||
// UpdateTenant updates tenant information.
|
||
UpdateTenant(ctx context.Context, req *v1.TenantUpdateReq) (*v1.TenantUpdateRes, error)
|
||
// UpdateTenantChannelScope 更新租户默认渠道范围
|
||
UpdateTenantChannelScope(ctx context.Context, req *v1.TenantChannelScopeUpdateReq) (*v1.TenantChannelScopeUpdateRes, error)
|
||
// ExportTenants exports tenant list to CSV or Excel.
|
||
ExportTenants(ctx context.Context, req *v1.TenantExportReq) (*v1.TenantExportRes, error)
|
||
// TenantApiKeySelect 租户 API Key 下拉选择列表（轻量，不返回密钥原值）。
|
||
// 供渠道调试目标过滤等管理端选择器使用；user_id > 0 时按创建者过滤。
|
||
// 注意：Fields 不能挂在 Count 之前的模型上——gdb 会生成 COUNT(col1, col2, ...)，
|
||
// PostgreSQL 的 count 只接受单参数，会直接报错。
|
||
TenantApiKeySelect(ctx context.Context, req *v1.TenantApiKeySelectReq) (*v1.TenantApiKeySelectRes, error)
|
||
ListTenantLevelConfigs(ctx context.Context, _ *v1.TenantLevelConfigListReq) (*v1.TenantLevelConfigListRes, error)
|
||
CreateTenantLevelConfig(ctx context.Context, req *v1.TenantLevelConfigCreateReq) (*v1.TenantLevelConfigCreateRes, error)
|
||
UpdateTenantLevelConfig(ctx context.Context, req *v1.TenantLevelConfigUpdateReq) (*v1.TenantLevelConfigUpdateRes, error)
|
||
DeleteTenantLevelConfig(ctx context.Context, req *v1.TenantLevelConfigDeleteReq) (*v1.TenantLevelConfigDeleteRes, error)
|
||
// ListTenantModels 列出租户已分配的模型
|
||
ListTenantModels(ctx context.Context, req *v1.TenantModelListReq) (*v1.TenantModelListRes, error)
|
||
// BatchAssignModels 批量分配模型给租户
|
||
BatchAssignModels(ctx context.Context, req *v1.TenantModelBatchAssignReq) (*v1.TenantModelBatchAssignRes, error)
|
||
// UpdateTenantModel 更新租户模型配置
|
||
UpdateTenantModel(ctx context.Context, req *v1.TenantModelUpdateReq) (*v1.TenantModelUpdateRes, error)
|
||
// DeleteTenantModel 移除租户模型分配
|
||
DeleteTenantModel(ctx context.Context, req *v1.TenantModelDeleteReq) (*v1.TenantModelDeleteRes, error)
|
||
// ListTenantAvailableModels 预览租户实际可用的所有模型（显式分配 + 分组来源，去重）
|
||
ListTenantAvailableModels(ctx context.Context, req *v1.TenantAvailableModelsPreviewReq) (*v1.TenantAvailableModelsPreviewRes, error)
|
||
// ListAllTickets 获取全部工单列表（管理后台）
|
||
ListAllTickets(ctx context.Context, req *v1.TicketListReq) (*v1.TicketListRes, error)
|
||
// GetTicketAdmin 获取工单详情（管理后台，含回复）
|
||
GetTicketAdmin(ctx context.Context, req *v1.TicketGetReq) (*v1.TicketGetRes, error)
|
||
// AssignTicket 分配工单给管理员
|
||
AssignTicket(ctx context.Context, req *v1.TicketAssignReq) (*v1.TicketAssignRes, error)
|
||
// ReplyToTicketAdmin 管理员回复工单
|
||
ReplyToTicketAdmin(ctx context.Context, req *v1.TicketReplyReq) (*v1.TicketReplyRes, error)
|
||
// UpdateTicketStatus 更新工单状态
|
||
UpdateTicketStatus(ctx context.Context, req *v1.TicketStatusUpdateReq) (*v1.TicketStatusUpdateRes, error)
|
||
// CheckUpdate checks GitHub Releases for a newer version
|
||
UpdateCheck(ctx context.Context, req *v1.UpdateCheckReq) (*v1.UpdateCheckRes, error)
|
||
// GetUpdateStatus returns the current update status
|
||
UpdateStatus(ctx context.Context, req *v1.UpdateStatusReq) (*v1.UpdateStatusRes, error)
|
||
// ExecuteUpdate triggers the system update
|
||
UpdateExecute(ctx context.Context, req *v1.UpdateExecuteReq) (*v1.UpdateExecuteRes, error)
|
||
// RollbackUpdate rolls back to the previous version
|
||
UpdateRollback(ctx context.Context, req *v1.UpdateRollbackReq) (*v1.UpdateRollbackRes, error)
|
||
UsageLogCleanupCreate(ctx context.Context, req *v1.UsageLogCleanupCreateReq) (*v1.UsageLogCleanupCreateRes, error)
|
||
UsageLogCleanupList(ctx context.Context, req *v1.UsageLogCleanupListReq) (*v1.UsageLogCleanupListRes, error)
|
||
UsageLogCleanupCancel(ctx context.Context, req *v1.UsageLogCleanupCancelReq) (*v1.UsageLogCleanupCancelRes, error)
|
||
// GetWorkbenchSummary 工作台汇总。
|
||
GetWorkbenchSummary(ctx context.Context, _ *v1.AdminWorkbenchSummaryReq) (*v1.AdminWorkbenchSummaryRes, error)
|
||
// GetWorkbenchBadges 工作台菜单角标计数（与 summary 共用缓存，不额外压库）。
|
||
//
|
||
// 角标只挂工作台菜单一项：待办的排查线索只存在于工作台的描述文案里，
|
||
// 业务菜单里没有对应的定位入口，往各业务菜单挂数字只会带来
|
||
// 「进去了却找不到问题」的困惑（红点引路却无路可走）。
|
||
GetWorkbenchBadges(ctx context.Context, _ *v1.AdminWorkbenchBadgeReq) (*v1.AdminWorkbenchBadgeRes, error)
|
||
}
|
||
)
|
||
|
||
var (
|
||
localAdmin IAdmin
|
||
)
|
||
|
||
func Admin() IAdmin {
|
||
if localAdmin == nil {
|
||
panic("implement not found for interface IAdmin, forgot register?")
|
||
}
|
||
return localAdmin
|
||
}
|
||
|
||
func RegisterAdmin(i IAdmin) {
|
||
localAdmin = i
|
||
}
|