2026-01-22 16:04:12 +08:00
|
|
|
|
syntax = "v1"
|
|
|
|
|
|
|
|
|
|
|
|
info (
|
|
|
|
|
|
title: "后台代理管理服务"
|
|
|
|
|
|
desc: "后台代理相关接口"
|
|
|
|
|
|
author: "team"
|
|
|
|
|
|
version: "v1"
|
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理管理接口
|
|
|
|
|
|
@server(
|
|
|
|
|
|
prefix: /api/v1/admin/agent
|
|
|
|
|
|
group: admin_agent
|
|
|
|
|
|
middleware: AdminAuthInterceptor
|
|
|
|
|
|
)
|
|
|
|
|
|
service main {
|
|
|
|
|
|
// 代理分页查询
|
|
|
|
|
|
@handler AdminGetAgentList
|
|
|
|
|
|
get /list (AdminGetAgentListReq) returns (AdminGetAgentListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理推广链接分页查询
|
|
|
|
|
|
@handler AdminGetAgentLinkList
|
|
|
|
|
|
get /agent-link/list (AdminGetAgentLinkListReq) returns (AdminGetAgentLinkListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金分页查询
|
|
|
|
|
|
@handler AdminGetAgentCommissionList
|
|
|
|
|
|
get /agent-commission/list (AdminGetAgentCommissionListReq) returns (AdminGetAgentCommissionListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金状态更新
|
|
|
|
|
|
@handler AdminUpdateAgentCommissionStatus
|
|
|
|
|
|
post /agent-commission/update-status (AdminUpdateAgentCommissionStatusReq) returns (AdminUpdateAgentCommissionStatusResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 批量解冻代理佣金
|
|
|
|
|
|
@handler AdminBatchUnfreezeAgentCommission
|
|
|
|
|
|
post /agent-commission/batch-unfreeze (AdminBatchUnfreezeAgentCommissionReq) returns (AdminBatchUnfreezeAgentCommissionResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理奖励分页查询
|
|
|
|
|
|
@handler AdminGetAgentRewardList
|
|
|
|
|
|
get /agent-reward/list (AdminGetAgentRewardListReq) returns (AdminGetAgentRewardListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理提现分页查询
|
|
|
|
|
|
@handler AdminGetAgentWithdrawalList
|
|
|
|
|
|
get /agent-withdrawal/list (AdminGetAgentWithdrawalListReq) returns (AdminGetAgentWithdrawalListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理上级抽佣分页查询
|
|
|
|
|
|
@handler AdminGetAgentCommissionDeductionList
|
|
|
|
|
|
get /agent-commission-deduction/list (AdminGetAgentCommissionDeductionListReq) returns (AdminGetAgentCommissionDeductionListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理钱包信息
|
|
|
|
|
|
@handler AdminGetAgentWallet
|
|
|
|
|
|
get /wallet/:agent_id (AdminGetAgentWalletReq) returns (AdminGetAgentWalletResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 修改代理钱包余额
|
|
|
|
|
|
@handler AdminUpdateAgentWalletBalance
|
|
|
|
|
|
post /wallet/update-balance (AdminUpdateAgentWalletBalanceReq) returns (AdminUpdateAgentWalletBalanceResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 平台抽佣分页查询
|
|
|
|
|
|
@handler AdminGetAgentPlatformDeductionList
|
|
|
|
|
|
get /agent-platform-deduction/list (AdminGetAgentPlatformDeductionListReq) returns (AdminGetAgentPlatformDeductionListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置分页查询
|
|
|
|
|
|
@handler AdminGetAgentProductionConfigList
|
|
|
|
|
|
get /agent-production-config/list (AdminGetAgentProductionConfigListReq) returns (AdminGetAgentProductionConfigListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置编辑
|
|
|
|
|
|
@handler AdminUpdateAgentProductionConfig
|
|
|
|
|
|
post /agent-production-config/update (AdminUpdateAgentProductionConfigReq) returns (AdminUpdateAgentProductionConfigResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员充值订单分页查询
|
|
|
|
|
|
@handler AdminGetAgentMembershipRechargeOrderList
|
|
|
|
|
|
get /agent-membership-recharge-order/list (AdminGetAgentMembershipRechargeOrderListReq) returns (AdminGetAgentMembershipRechargeOrderListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置分页查询
|
|
|
|
|
|
@handler AdminGetAgentMembershipConfigList
|
|
|
|
|
|
get /agent-membership-config/list (AdminGetAgentMembershipConfigListReq) returns (AdminGetAgentMembershipConfigListResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置编辑
|
|
|
|
|
|
@handler AdminUpdateAgentMembershipConfig
|
|
|
|
|
|
post /agent-membership-config/update (AdminUpdateAgentMembershipConfigReq) returns (AdminUpdateAgentMembershipConfigResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 银行卡提现审核（确认/拒绝）
|
|
|
|
|
|
@handler AdminReviewBankCardWithdrawal
|
|
|
|
|
|
post /agent-withdrawal/bank-card/review (AdminReviewBankCardWithdrawalReq) returns (AdminReviewBankCardWithdrawalResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取提现统计数据
|
|
|
|
|
|
@handler AdminGetWithdrawalStatistics
|
|
|
|
|
|
get /agent-withdrawal/statistics (AdminGetWithdrawalStatisticsReq) returns (AdminGetWithdrawalStatisticsResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理订单统计数据
|
|
|
|
|
|
@handler AdminGetAgentOrderStatistics
|
|
|
|
|
|
get /agent-order/statistics (AdminGetAgentOrderStatisticsReq) returns (AdminGetAgentOrderStatisticsResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理统计数据
|
|
|
|
|
|
@handler AdminGetAgentStatistics
|
|
|
|
|
|
get /statistics (AdminGetAgentStatisticsReq) returns (AdminGetAgentStatisticsResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理链接产品统计
|
|
|
|
|
|
@handler AdminGetAgentLinkProductStatistics
|
|
|
|
|
|
get /agent-link/product-statistics (AdminGetAgentLinkProductStatisticsReq) returns (AdminGetAgentLinkProductStatisticsResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 获取系统配置
|
|
|
|
|
|
@handler AdminGetSystemConfig
|
|
|
|
|
|
get /system-config (AdminGetSystemConfigResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 更新系统配置
|
|
|
|
|
|
@handler AdminUpdateSystemConfig
|
|
|
|
|
|
post /system-config (AdminUpdateSystemConfigReq) returns (AdminUpdateSystemConfigResp)
|
|
|
|
|
|
|
|
|
|
|
|
// 代理钱包流水分页查询
|
|
|
|
|
|
@handler AdminGetAgentWalletTransactionList
|
|
|
|
|
|
get /wallet-transaction/list (AdminGetAgentWalletTransactionListReq) returns (AdminGetAgentWalletTransactionListResp)
|
|
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
type (
|
|
|
|
|
|
// 代理分页查询请求
|
|
|
|
|
|
AdminGetAgentListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
Mobile *string `form:"mobile,optional"` // 手机号（可选）
|
|
|
|
|
|
Region *string `form:"region,optional"` // 区域（可选）
|
|
|
|
|
|
ParentAgentId *int64 `form:"parent_agent_id,optional"` // 上级代理ID（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理列表项
|
|
|
|
|
|
AgentListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
UserId int64 `json:"user_id"` // 用户ID
|
|
|
|
|
|
ParentAgentId int64 `json:"parent_agent_id"` // 上级代理ID
|
|
|
|
|
|
LevelName string `json:"level_name"` // 等级名称
|
|
|
|
|
|
Region string `json:"region"` // 区域
|
|
|
|
|
|
Mobile string `json:"mobile"` // 手机号
|
|
|
|
|
|
MembershipExpiryTime string `json:"membership_expiry_time"` // 会员到期时间
|
|
|
|
|
|
Balance float64 `json:"balance"` // 钱包余额
|
|
|
|
|
|
TotalEarnings float64 `json:"total_earnings"` // 累计收益
|
|
|
|
|
|
FrozenBalance float64 `json:"frozen_balance"` // 冻结余额
|
|
|
|
|
|
WithdrawnAmount float64 `json:"withdrawn_amount"` // 提现总额
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
IsRealNameVerified bool `json:"is_real_name_verified"` // 是否已实名认证
|
|
|
|
|
|
RealName string `json:"real_name"` // 实名姓名
|
|
|
|
|
|
IdCard string `json:"id_card"` // 身份证号
|
|
|
|
|
|
RealNameStatus string `json:"real_name_status"` // 实名状态（pending/approved/rejected）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理分页查询响应
|
|
|
|
|
|
AdminGetAgentListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理推广链接分页查询请求
|
|
|
|
|
|
AdminGetAgentLinkListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
ProductName *string `form:"product_name,optional"` // 产品名（可选）
|
|
|
|
|
|
LinkIdentifier *string `form:"link_identifier,optional"` // 推广码（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理推广链接列表项
|
|
|
|
|
|
AgentLinkListItem {
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
ProductName string `json:"product_name"` // 产品名
|
|
|
|
|
|
Price float64 `json:"price"` // 价格
|
|
|
|
|
|
LinkIdentifier string `json:"link_identifier"` // 推广码
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理推广链接分页查询响应
|
|
|
|
|
|
AdminGetAgentLinkListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentLinkListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金分页查询请求
|
|
|
|
|
|
AdminGetAgentCommissionListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
OrderId *int64 `form:"order_id,optional"` // 订单ID（可选）
|
|
|
|
|
|
ProductName *string `form:"product_name,optional"` // 产品名（可选）
|
|
|
|
|
|
Status *int64 `form:"status,optional"` // 状态（可选）
|
|
|
|
|
|
CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始（可选）
|
|
|
|
|
|
CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金列表项
|
|
|
|
|
|
AgentCommissionListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
OrderId int64 `json:"order_id"` // 订单ID
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
ProductName string `json:"product_name"` // 产品名
|
|
|
|
|
|
Status int64 `json:"status"` // 状态
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金分页查询响应
|
|
|
|
|
|
AdminGetAgentCommissionListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentCommissionListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金状态更新请求
|
|
|
|
|
|
AdminUpdateAgentCommissionStatusReq {
|
|
|
|
|
|
Id int64 `json:"id"` // 佣金记录ID
|
|
|
|
|
|
Status int64 `json:"status"` // 状态:0-已结算,1-冻结中,2-已取消
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理佣金状态更新响应
|
|
|
|
|
|
AdminUpdateAgentCommissionStatusResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 批量解冻代理佣金请求
|
|
|
|
|
|
AdminBatchUnfreezeAgentCommissionReq {
|
|
|
|
|
|
AgentId *int64 `json:"agent_id,optional"` // 代理ID，可选。如果不传则解冻所有冻结中的佣金
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 批量解冻代理佣金响应
|
|
|
|
|
|
AdminBatchUnfreezeAgentCommissionResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
Count int64 `json:"count"` // 解冻的数量
|
|
|
|
|
|
Amount float64 `json:"amount"` // 解冻的总金额
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理奖励分页查询请求
|
|
|
|
|
|
AdminGetAgentRewardListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
RelationAgentId *int64 `form:"relation_agent_id,optional"` // 关联代理ID（可选）
|
|
|
|
|
|
Type *string `form:"type,optional"` // 奖励类型（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理奖励列表项
|
|
|
|
|
|
AgentRewardListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
RelationAgentId int64 `json:"relation_agent_id"` // 关联代理ID
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
Type string `json:"type"` // 奖励类型
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理奖励分页查询响应
|
|
|
|
|
|
AdminGetAgentRewardListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentRewardListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理提现分页查询请求
|
|
|
|
|
|
AdminGetAgentWithdrawalListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
Status *int64 `form:"status,optional"` // 状态（可选）
|
|
|
|
|
|
WithdrawNo *string `form:"withdraw_no,optional"` // 提现单号（可选）
|
|
|
|
|
|
WithdrawType *int64 `form:"withdraw_type,optional"` // 提现类型（可选）1-支付宝,2-银行卡
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理提现列表项
|
|
|
|
|
|
AgentWithdrawalListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
WithdrawNo string `json:"withdraw_no"` // 提现单号
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
ActualAmount float64 `json:"actual_amount"` // 实际到账金额（扣税后）
|
|
|
|
|
|
TaxAmount float64 `json:"tax_amount"` // 扣税金额
|
2026-02-01 16:33:20 +08:00
|
|
|
|
TaxRate float64 `json:"tax_rate"` // 扣税比例，如 0.06 表示 6%
|
2026-01-22 16:04:12 +08:00
|
|
|
|
Status int64 `json:"status"` // 状态
|
|
|
|
|
|
PayeeAccount string `json:"payee_account"` // 收款账户
|
|
|
|
|
|
Remark string `json:"remark"` // 备注
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
WithdrawType int64 `json:"withdraw_type"` // 提现类型:1-支付宝,2-银行卡
|
|
|
|
|
|
BankCardNo string `json:"bank_card_no"` // 银行卡号
|
|
|
|
|
|
BankName string `json:"bank_name"` // 开户支行
|
|
|
|
|
|
PayeeName string `json:"payee_name"` // 收款人姓名
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理提现分页查询响应
|
|
|
|
|
|
AdminGetAgentWithdrawalListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentWithdrawalListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理抽佣分页查询请求
|
|
|
|
|
|
AdminGetAgentCommissionDeductionListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
ProductName *string `form:"product_name,optional"` // 产品名（可选）
|
|
|
|
|
|
Type *string `form:"type,optional"` // 类型（cost/pricing，可选）
|
|
|
|
|
|
Status *int64 `form:"status,optional"` // 状态（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理抽佣列表项
|
|
|
|
|
|
AgentCommissionDeductionListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
DeductedAgentId int64 `json:"deducted_agent_id"` // 被扣代理ID
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
ProductName string `json:"product_name"` // 产品名
|
|
|
|
|
|
Type string `json:"type"` // 类型（cost/pricing）
|
|
|
|
|
|
Status int64 `json:"status"` // 状态
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理抽佣分页查询响应
|
|
|
|
|
|
AdminGetAgentCommissionDeductionListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentCommissionDeductionListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 平台抽佣分页查询请求
|
|
|
|
|
|
AdminGetAgentPlatformDeductionListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
Type *string `form:"type,optional"` // 类型（cost/pricing，可选）
|
|
|
|
|
|
Status *int64 `form:"status,optional"` // 状态（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 平台抽佣列表项
|
|
|
|
|
|
AgentPlatformDeductionListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
Type string `json:"type"` // 类型（cost/pricing）
|
|
|
|
|
|
Status int64 `json:"status"` // 状态
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 平台抽佣分页查询响应
|
|
|
|
|
|
AdminGetAgentPlatformDeductionListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentPlatformDeductionListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置分页查询请求
|
|
|
|
|
|
AdminGetAgentProductionConfigListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
ProductName *string `form:"product_name,optional"` // 产品名（可选）
|
|
|
|
|
|
Id *int64 `form:"id,optional"` // 配置ID（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置分页查询响应
|
|
|
|
|
|
AdminGetAgentProductionConfigListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentProductionConfigItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置列表项
|
|
|
|
|
|
AgentProductionConfigItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
ProductName string `json:"product_name"` // 产品名
|
|
|
|
|
|
CostPrice float64 `json:"cost_price"` // 成本
|
|
|
|
|
|
PriceRangeMin float64 `json:"price_range_min"` // 最低定价
|
|
|
|
|
|
PriceRangeMax float64 `json:"price_range_max"` // 最高定价
|
|
|
|
|
|
PricingStandard float64 `json:"pricing_standard"` // 定价标准
|
|
|
|
|
|
OverpricingRatio float64 `json:"overpricing_ratio"` // 超价比例
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置编辑请求
|
|
|
|
|
|
AdminUpdateAgentProductionConfigReq {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
CostPrice float64 `json:"cost_price"` // 成本
|
|
|
|
|
|
PriceRangeMin float64 `json:"price_range_min"` // 最低定价
|
|
|
|
|
|
PriceRangeMax float64 `json:"price_range_max"` // 最高定价
|
|
|
|
|
|
PricingStandard float64 `json:"pricing_standard"` // 定价标准
|
|
|
|
|
|
OverpricingRatio float64 `json:"overpricing_ratio"` // 超价比例
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理产品配置编辑响应
|
|
|
|
|
|
AdminUpdateAgentProductionConfigResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员充值订单分页查询请求
|
|
|
|
|
|
AdminGetAgentMembershipRechargeOrderListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
UserId *int64 `form:"user_id,optional"` // 用户ID（可选）
|
|
|
|
|
|
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
|
|
|
|
|
|
OrderNo *string `form:"order_no,optional"` // 订单号（可选）
|
|
|
|
|
|
PlatformOrderId *string `form:"platform_order_id,optional"` // 平台订单号（可选）
|
|
|
|
|
|
Status *string `form:"status,optional"` // 状态（可选）
|
|
|
|
|
|
PaymentMethod *string `form:"payment_method,optional"` // 支付方式（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员充值订单列表项
|
|
|
|
|
|
AgentMembershipRechargeOrderListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
UserId int64 `json:"user_id"` // 用户ID
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
LevelName string `json:"level_name"` // 等级名称
|
|
|
|
|
|
Amount float64 `json:"amount"` // 金额
|
|
|
|
|
|
PaymentMethod string `json:"payment_method"` // 支付方式
|
|
|
|
|
|
OrderNo string `json:"order_no"` // 订单号
|
|
|
|
|
|
PlatformOrderId string `json:"platform_order_id"` // 平台订单号
|
|
|
|
|
|
Status string `json:"status"` // 状态
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员充值订单分页查询响应
|
|
|
|
|
|
AdminGetAgentMembershipRechargeOrderListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentMembershipRechargeOrderListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置分页查询请求
|
|
|
|
|
|
AdminGetAgentMembershipConfigListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
LevelName *string `form:"level_name,optional"` // 会员级别名称（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置分页查询响应
|
|
|
|
|
|
AdminGetAgentMembershipConfigListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentMembershipConfigListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置列表项
|
|
|
|
|
|
AgentMembershipConfigListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
LevelName string `json:"level_name"` // 会员级别名称
|
|
|
|
|
|
Price *float64 `json:"price"` // 会员年费
|
|
|
|
|
|
ReportCommission *float64 `json:"report_commission"` // 直推报告收益
|
|
|
|
|
|
LowerActivityReward *float64 `json:"lower_activity_reward"` // 下级活跃奖励金额
|
|
|
|
|
|
NewActivityReward *float64 `json:"new_activity_reward"` // 新增活跃奖励金额
|
|
|
|
|
|
LowerStandardCount *int64 `json:"lower_standard_count"` // 活跃下级达标个数
|
|
|
|
|
|
NewLowerStandardCount *int64 `json:"new_lower_standard_count"` // 新增活跃下级达标个数
|
|
|
|
|
|
LowerWithdrawRewardRatio *float64 `json:"lower_withdraw_reward_ratio"` // 下级提现奖励比例
|
|
|
|
|
|
LowerConvertVipReward *float64 `json:"lower_convert_vip_reward"` // 下级转化VIP奖励
|
|
|
|
|
|
LowerConvertSvipReward *float64 `json:"lower_convert_svip_reward"` // 下级转化SVIP奖励
|
|
|
|
|
|
ExemptionAmount *float64 `json:"exemption_amount"` // 免责金额
|
|
|
|
|
|
PriceIncreaseMax *float64 `json:"price_increase_max"` // 提价最高金额
|
|
|
|
|
|
PriceRatio *float64 `json:"price_ratio"` // 提价区间收取比例
|
|
|
|
|
|
PriceIncreaseAmount *float64 `json:"price_increase_amount"` // 在原本成本上加价的金额
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置编辑请求
|
|
|
|
|
|
AdminUpdateAgentMembershipConfigReq {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
LevelName string `json:"level_name"` // 会员级别名称
|
|
|
|
|
|
Price float64 `json:"price"` // 会员年费
|
|
|
|
|
|
ReportCommission float64 `json:"report_commission"` // 直推报告收益
|
|
|
|
|
|
LowerActivityReward *float64 `json:"lower_activity_reward,optional,omitempty"` // 下级活跃奖励金额
|
|
|
|
|
|
NewActivityReward *float64 `json:"new_activity_reward,optional,omitempty"` // 新增活跃奖励金额
|
|
|
|
|
|
LowerStandardCount *int64 `json:"lower_standard_count,optional,omitempty"` // 活跃下级达标个数
|
|
|
|
|
|
NewLowerStandardCount *int64 `json:"new_lower_standard_count,optional,omitempty"` // 新增活跃下级达标个数
|
|
|
|
|
|
LowerWithdrawRewardRatio *float64 `json:"lower_withdraw_reward_ratio,optional,omitempty"` // 下级提现奖励比例
|
|
|
|
|
|
LowerConvertVipReward *float64 `json:"lower_convert_vip_reward,optional,omitempty"` // 下级转化VIP奖励
|
|
|
|
|
|
LowerConvertSvipReward *float64 `json:"lower_convert_svip_reward,optional,omitempty"` // 下级转化SVIP奖励
|
|
|
|
|
|
ExemptionAmount *float64 `json:"exemption_amount,optional,omitempty"` // 免责金额
|
|
|
|
|
|
PriceIncreaseMax *float64 `json:"price_increase_max,optional,omitempty"` // 提价最高金额
|
|
|
|
|
|
PriceRatio *float64 `json:"price_ratio,optional,omitempty"` // 提价区间收取比例
|
|
|
|
|
|
PriceIncreaseAmount *float64 `json:"price_increase_amount,optional,omitempty"` // 在原本成本上加价的金额
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理会员配置编辑响应
|
|
|
|
|
|
AdminUpdateAgentMembershipConfigResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 银行卡提现审核请求
|
|
|
|
|
|
AdminReviewBankCardWithdrawalReq {
|
2026-02-01 16:33:20 +08:00
|
|
|
|
WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID
|
|
|
|
|
|
Action int64 `json:"action"` // 操作:1-确认,2-拒绝
|
|
|
|
|
|
Remark string `json:"remark"` // 备注（拒绝时必填）
|
|
|
|
|
|
TaxRate *float64 `json:"tax_rate,optional"` // 扣税比例，如 0.06 表示 6%，不传则默认 6%
|
2026-01-22 16:04:12 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 银行卡提现审核响应
|
|
|
|
|
|
AdminReviewBankCardWithdrawalResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取提现统计数据请求
|
|
|
|
|
|
AdminGetWithdrawalStatisticsReq {
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取提现统计数据响应
|
|
|
|
|
|
AdminGetWithdrawalStatisticsResp {
|
|
|
|
|
|
TotalWithdrawalAmount float64 `json:"total_withdrawal_amount"` // 总提现金额
|
|
|
|
|
|
TodayWithdrawalAmount float64 `json:"today_withdrawal_amount"` // 今日提现金额
|
|
|
|
|
|
TotalActualAmount float64 `json:"total_actual_amount"` // 总实际到账金额
|
|
|
|
|
|
TotalTaxAmount float64 `json:"total_tax_amount"` // 总扣税金额
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理订单统计数据请求
|
|
|
|
|
|
AdminGetAgentOrderStatisticsReq {
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理订单统计数据响应
|
|
|
|
|
|
AdminGetAgentOrderStatisticsResp {
|
|
|
|
|
|
TotalAgentOrderCount int64 `json:"total_agent_order_count"` // 总代理订单数
|
|
|
|
|
|
TodayAgentOrderCount int64 `json:"today_agent_order_count"` // 今日代理订单数
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理统计数据请求
|
|
|
|
|
|
AdminGetAgentStatisticsReq {
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理统计数据响应
|
|
|
|
|
|
AdminGetAgentStatisticsResp {
|
|
|
|
|
|
TotalAgentCount int64 `json:"total_agent_count"` // 总代理数
|
|
|
|
|
|
TodayAgentCount int64 `json:"today_agent_count"` // 今日新增代理数
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理链接产品统计请求
|
|
|
|
|
|
AdminGetAgentLinkProductStatisticsReq {
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理链接产品统计列表项
|
|
|
|
|
|
AgentLinkProductStatisticsItem {
|
|
|
|
|
|
ProductName string `json:"product_name"` // 产品名称
|
|
|
|
|
|
LinkCount int64 `json:"link_count"` // 推广链接数量
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理链接产品统计响应
|
|
|
|
|
|
AdminGetAgentLinkProductStatisticsResp {
|
|
|
|
|
|
Items []AgentLinkProductStatisticsItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理钱包信息请求
|
|
|
|
|
|
AdminGetAgentWalletReq {
|
|
|
|
|
|
AgentId int64 `path:"agent_id"` // 代理ID
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取代理钱包信息响应
|
|
|
|
|
|
AdminGetAgentWalletResp {
|
|
|
|
|
|
Balance float64 `json:"balance"` // 可用余额
|
|
|
|
|
|
FrozenBalance float64 `json:"frozen_balance"` // 冻结余额
|
|
|
|
|
|
TotalEarnings float64 `json:"total_earnings"` // 总收益
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 修改代理钱包余额请求
|
|
|
|
|
|
AdminUpdateAgentWalletBalanceReq {
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
Amount float64 `json:"amount"` // 修改金额（正数增加，负数减少）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 修改代理钱包余额响应
|
|
|
|
|
|
AdminUpdateAgentWalletBalanceResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
Balance float64 `json:"balance"` // 修改后的余额
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 更新系统配置请求
|
|
|
|
|
|
AdminUpdateSystemConfigReq {
|
|
|
|
|
|
CommissionSafeMode *bool `json:"commission_safe_mode,optional"` // 佣金安全防御模式：true-冻结模式，false-直接结算模式
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 更新系统配置响应
|
|
|
|
|
|
AdminUpdateSystemConfigResp {
|
|
|
|
|
|
Success bool `json:"success"` // 是否成功
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 获取系统配置响应
|
|
|
|
|
|
AdminGetSystemConfigResp {
|
|
|
|
|
|
CommissionSafeMode bool `json:"commission_safe_mode"` // 佣金安全防御模式
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理钱包流水分页查询请求
|
|
|
|
|
|
AdminGetAgentWalletTransactionListReq {
|
|
|
|
|
|
Page int64 `form:"page"` // 页码
|
|
|
|
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|
|
|
|
|
AgentId int64 `form:"agent_id"` // 代理ID
|
|
|
|
|
|
TransactionType *string `form:"transaction_type,optional"` // 交易类型（可选）
|
|
|
|
|
|
CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始（可选）
|
|
|
|
|
|
CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束（可选）
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理钱包流水列表项
|
|
|
|
|
|
AgentWalletTransactionListItem {
|
|
|
|
|
|
Id int64 `json:"id"` // 主键
|
|
|
|
|
|
AgentId int64 `json:"agent_id"` // 代理ID
|
|
|
|
|
|
TransactionType string `json:"transaction_type"` // 交易类型
|
|
|
|
|
|
Amount float64 `json:"amount"` // 变动金额
|
|
|
|
|
|
BalanceBefore float64 `json:"balance_before"` // 变动前余额
|
|
|
|
|
|
BalanceAfter float64 `json:"balance_after"` // 变动后余额
|
|
|
|
|
|
FrozenBalanceBefore float64 `json:"frozen_balance_before"` // 变动前冻结余额
|
|
|
|
|
|
FrozenBalanceAfter float64 `json:"frozen_balance_after"` // 变动后冻结余额
|
|
|
|
|
|
TransactionId *string `json:"transaction_id"` // 关联交易ID
|
|
|
|
|
|
RelatedUserId *int64 `json:"related_user_id"` // 关联用户ID
|
|
|
|
|
|
Remark *string `json:"remark"` // 备注说明
|
|
|
|
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 代理钱包流水分页查询响应
|
|
|
|
|
|
AdminGetAgentWalletTransactionListResp {
|
|
|
|
|
|
Total int64 `json:"total"` // 总数
|
|
|
|
|
|
Items []AgentWalletTransactionListItem `json:"items"` // 列表数据
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
)
|
