427 lines
19 KiB
Plaintext
427 lines
19 KiB
Plaintext
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 AdminAuditAgent
|
||
post /audit (AdminAuditAgentReq) returns (AdminAuditAgentResp)
|
||
|
||
// 代理推广链接分页查询
|
||
@handler AdminGetAgentLinkList
|
||
get /link/list (AdminGetAgentLinkListReq) returns (AdminGetAgentLinkListResp)
|
||
|
||
// 代理订单分页查询
|
||
@handler AdminGetAgentOrderList
|
||
get /order/list (AdminGetAgentOrderListReq) returns (AdminGetAgentOrderListResp)
|
||
|
||
// 代理佣金分页查询
|
||
@handler AdminGetAgentCommissionList
|
||
get /commission/list (AdminGetAgentCommissionListReq) returns (AdminGetAgentCommissionListResp)
|
||
|
||
// 代理返佣分页查询
|
||
@handler AdminGetAgentRebateList
|
||
get /rebate/list (AdminGetAgentRebateListReq) returns (AdminGetAgentRebateListResp)
|
||
|
||
// 代理升级记录分页查询
|
||
@handler AdminGetAgentUpgradeList
|
||
get /upgrade/list (AdminGetAgentUpgradeListReq) returns (AdminGetAgentUpgradeListResp)
|
||
|
||
// 代理提现分页查询
|
||
@handler AdminGetAgentWithdrawalList
|
||
get /withdrawal/list (AdminGetAgentWithdrawalListReq) returns (AdminGetAgentWithdrawalListResp)
|
||
|
||
// 代理提现审核
|
||
@handler AdminAuditWithdrawal
|
||
post /withdrawal/audit (AdminAuditWithdrawalReq) returns (AdminAuditWithdrawalResp)
|
||
|
||
// 代理实名认证分页查询
|
||
@handler AdminGetAgentRealNameList
|
||
get /real_name/list (AdminGetAgentRealNameListReq) returns (AdminGetAgentRealNameListResp)
|
||
|
||
// 代理实名认证审核（已废弃：实名认证改为三要素核验，无需审核）
|
||
// @handler AdminAuditRealName
|
||
// post /real_name/audit (AdminAuditRealNameReq) returns (AdminAuditRealNameResp)
|
||
// 系统配置查询
|
||
@handler AdminGetAgentConfig
|
||
get /config returns (AdminGetAgentConfigResp)
|
||
|
||
// 系统配置更新
|
||
@handler AdminUpdateAgentConfig
|
||
post /config/update (AdminUpdateAgentConfigReq) returns (AdminUpdateAgentConfigResp)
|
||
|
||
// 产品配置分页查询
|
||
@handler AdminGetAgentProductConfigList
|
||
get /product_config/list (AdminGetAgentProductConfigListReq) returns (AdminGetAgentProductConfigListResp)
|
||
|
||
// 产品配置更新
|
||
@handler AdminUpdateAgentProductConfig
|
||
post /product_config/update (AdminUpdateAgentProductConfigReq) returns (AdminUpdateAgentProductConfigResp)
|
||
|
||
// 生成钻石邀请码
|
||
@handler AdminGenerateDiamondInviteCode
|
||
post /invite_code/diamond/generate (AdminGenerateDiamondInviteCodeReq) returns (AdminGenerateDiamondInviteCodeResp)
|
||
|
||
// 邀请码列表查询
|
||
@handler AdminGetInviteCodeList
|
||
get /invite_code/list (AdminGetInviteCodeListReq) returns (AdminGetInviteCodeListResp)
|
||
}
|
||
|
||
type (
|
||
// 代理分页查询
|
||
AdminGetAgentListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
Mobile *string `form:"mobile,optional"` // 手机号（可选）
|
||
Region *string `form:"region,optional"` // 区域（可选）
|
||
Level *int64 `form:"level,optional"` // 等级（可选）
|
||
TeamLeaderId *string `form:"team_leader_id,optional"` // 团队首领ID（可选）
|
||
}
|
||
AgentListItem {
|
||
Id string `json:"id"` // 主键
|
||
UserId string `json:"user_id"` // 用户ID
|
||
Level int64 `json:"level"` // 等级：1=普通，2=黄金，3=钻石
|
||
LevelName string `json:"level_name"` // 等级名称
|
||
Region string `json:"region"` // 区域
|
||
Mobile string `json:"mobile"` // 手机号
|
||
WechatId string `json:"wechat_id"` // 微信号
|
||
TeamLeaderId string `json:"team_leader_id"` // 团队首领ID
|
||
AgentCode int64 `json:"agent_code"`
|
||
Balance float64 `json:"balance"` // 钱包余额
|
||
TotalEarnings float64 `json:"total_earnings"` // 累计收益
|
||
FrozenBalance float64 `json:"frozen_balance"` // 冻结余额
|
||
WithdrawnAmount float64 `json:"withdrawn_amount"` // 提现总额
|
||
IsRealName bool `json:"is_real_name"` // 是否已实名
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理审核
|
||
AdminAuditAgentReq {
|
||
AuditId int64 `json:"audit_id"` // 审核记录ID
|
||
Status int64 `json:"status"` // 审核状态：1=通过，2=拒绝
|
||
AuditReason string `json:"audit_reason"` // 审核原因（拒绝时必填）
|
||
}
|
||
AdminAuditAgentResp {
|
||
Success bool `json:"success"`
|
||
}
|
||
// 推广链接分页查询
|
||
AdminGetAgentLinkListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
ProductId *string `form:"product_id,optional"` // 产品ID（可选）
|
||
LinkIdentifier *string `form:"link_identifier,optional"` // 推广码（可选）
|
||
}
|
||
AgentLinkListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
ProductId string `json:"product_id"` // 产品ID
|
||
ProductName string `json:"product_name"` // 产品名称
|
||
SetPrice float64 `json:"set_price"` // 设定价格
|
||
ActualBasePrice float64 `json:"actual_base_price"` // 实际底价
|
||
LinkIdentifier string `json:"link_identifier"` // 推广码
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentLinkListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentLinkListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理订单分页查询
|
||
AdminGetAgentOrderListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
OrderId *string `form:"order_id,optional"` // 订单ID（可选）
|
||
ProcessStatus *int64 `form:"process_status,optional"` // 处理状态（可选）
|
||
}
|
||
AgentOrderListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
OrderId string `json:"order_id"` // 订单ID
|
||
ProductId string `json:"product_id"` // 产品ID
|
||
ProductName string `json:"product_name"` // 产品名称
|
||
OrderAmount float64 `json:"order_amount"` // 订单金额
|
||
SetPrice float64 `json:"set_price"` // 设定价格
|
||
ActualBasePrice float64 `json:"actual_base_price"` // 实际底价
|
||
PriceCost float64 `json:"price_cost"` // 提价成本
|
||
AgentProfit float64 `json:"agent_profit"` // 代理收益
|
||
ProcessStatus int64 `json:"process_status"` // 处理状态
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentOrderListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentOrderListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理佣金分页查询
|
||
AdminGetAgentCommissionListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
OrderId *string `form:"order_id,optional"` // 订单ID（可选）
|
||
Status *int64 `form:"status,optional"` // 状态（可选）
|
||
}
|
||
AgentCommissionListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
OrderId string `json:"order_id"` // 订单ID
|
||
ProductName string `json:"product_name"` // 产品名称
|
||
Amount float64 `json:"amount"` // 金额
|
||
Status int64 `json:"status"` // 状态
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentCommissionListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentCommissionListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理返佣分页查询
|
||
AdminGetAgentRebateListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
SourceAgentId *string `form:"source_agent_id,optional"` // 来源代理ID（可选）
|
||
RebateType *int64 `form:"rebate_type,optional"` // 返佣类型（可选）
|
||
}
|
||
AgentRebateListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 获得返佣的代理ID
|
||
SourceAgentId string `json:"source_agent_id"` // 来源代理ID
|
||
OrderId string `json:"order_id"` // 订单ID
|
||
RebateType int64 `json:"rebate_type"` // 返佣类型
|
||
Amount float64 `json:"amount"` // 金额
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentRebateListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentRebateListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理升级记录分页查询
|
||
AdminGetAgentUpgradeListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
UpgradeType *int64 `form:"upgrade_type,optional"` // 升级类型（可选）
|
||
Status *int64 `form:"status,optional"` // 状态（可选）
|
||
}
|
||
AgentUpgradeListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
FromLevel int64 `json:"from_level"` // 原等级
|
||
ToLevel int64 `json:"to_level"` // 目标等级
|
||
UpgradeType int64 `json:"upgrade_type"` // 升级类型
|
||
UpgradeFee float64 `json:"upgrade_fee"` // 升级费用
|
||
RebateAmount float64 `json:"rebate_amount"` // 返佣金额
|
||
Status int64 `json:"status"` // 状态
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentUpgradeListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentUpgradeListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理提现分页查询
|
||
AdminGetAgentWithdrawalListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
Status *int64 `form:"status,optional"` // 状态（可选）
|
||
WithdrawNo *string `form:"withdraw_no,optional"` // 提现单号（可选）
|
||
}
|
||
AgentWithdrawalListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
WithdrawNo string `json:"withdraw_no"` // 提现单号
|
||
Amount float64 `json:"amount"` // 金额
|
||
TaxAmount float64 `json:"tax_amount"` // 税费金额
|
||
ActualAmount float64 `json:"actual_amount"` // 实际到账金额
|
||
Status int64 `json:"status"` // 状态
|
||
PayeeAccount string `json:"payee_account"` // 收款账户
|
||
PayeeName string `json:"payee_name"` // 收款人姓名
|
||
Remark string `json:"remark"` // 备注
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentWithdrawalListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentWithdrawalListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理提现审核
|
||
AdminAuditWithdrawalReq {
|
||
WithdrawalId string `json:"withdrawal_id"` // 提现记录ID
|
||
Status int64 `json:"status"` // 审核状态：2=通过，3=拒绝
|
||
Remark string `json:"remark"` // 备注
|
||
}
|
||
AdminAuditWithdrawalResp {
|
||
Success bool `json:"success"`
|
||
}
|
||
// 代理实名认证分页查询
|
||
AdminGetAgentRealNameListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
||
Status *int64 `form:"status,optional"` // 状态（可选）：1=未验证，2=已通过
|
||
}
|
||
AgentRealNameListItem {
|
||
Id string `json:"id"` // 主键
|
||
AgentId string `json:"agent_id"` // 代理ID
|
||
Name string `json:"name"` // 姓名
|
||
IdCard string `json:"id_card"` // 身份证号
|
||
Mobile string `json:"mobile"` // 手机号
|
||
Status int64 `json:"status"` // 状态：1=未验证，2=已通过（verify_time不为空表示已通过）
|
||
VerifyTime string `json:"verify_time"` // 验证时间（三要素核验通过时间）
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentRealNameListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentRealNameListItem `json:"items"` // 列表数据
|
||
}
|
||
// 代理实名认证审核
|
||
AdminAuditRealNameReq {
|
||
RealNameId int64 `json:"real_name_id"` // 实名认证记录ID
|
||
Status int64 `json:"status"` // 审核状态：2=通过，3=拒绝
|
||
AuditReason string `json:"audit_reason"` // 审核原因（拒绝时必填）
|
||
}
|
||
AdminAuditRealNameResp {
|
||
Success bool `json:"success"`
|
||
}
|
||
// 系统配置查询（价格配置已移除，改为产品配置表管理）
|
||
AdminGetAgentConfigResp {
|
||
LevelBonus LevelBonusConfig `json:"level_bonus"` // 等级加成配置
|
||
UpgradeFee UpgradeFeeConfig `json:"upgrade_fee"` // 升级费用配置
|
||
UpgradeRebate UpgradeRebateConfig `json:"upgrade_rebate"` // 升级返佣配置
|
||
DirectParentRebate DirectParentRebateConfig `json:"direct_parent_rebate"` // 直接上级返佣配置
|
||
MaxGoldRebateAmount float64 `json:"max_gold_rebate_amount"` // 黄金代理最大返佣金额
|
||
CommissionFreeze CommissionFreezeConfig `json:"commission_freeze"` // 佣金冻结配置
|
||
TaxRate float64 `json:"tax_rate"` // 税率
|
||
TaxExemptionAmount float64 `json:"tax_exemption_amount"` // 免税额度
|
||
GoldMaxUpliftAmount float64 `json:"gold_max_uplift_amount"`
|
||
DiamondMaxUpliftAmount float64 `json:"diamond_max_uplift_amount"`
|
||
}
|
||
LevelBonusConfig {
|
||
Diamond int64 `json:"diamond"` // 钻石加成：0
|
||
Gold int64 `json:"gold"` // 黄金加成：3
|
||
Normal int64 `json:"normal"` // 普通加成：6
|
||
}
|
||
UpgradeFeeConfig {
|
||
NormalToGold float64 `json:"normal_to_gold"` // 普通→黄金：199
|
||
NormalToDiamond float64 `json:"normal_to_diamond"` // 普通→钻石：980
|
||
}
|
||
UpgradeRebateConfig {
|
||
NormalToGoldRebate float64 `json:"normal_to_gold_rebate"` // 普通→黄金返佣：139
|
||
ToDiamondRebate float64 `json:"to_diamond_rebate"` // 升级为钻石返佣：680
|
||
}
|
||
DirectParentRebateConfig {
|
||
Diamond float64 `json:"diamond"` // 直接上级是钻石的返佣金额（6元）
|
||
Gold float64 `json:"gold"` // 直接上级是黄金的返佣金额（3元）
|
||
Normal float64 `json:"normal"` // 直接上级是普通的返佣金额（2元）
|
||
}
|
||
CommissionFreezeConfig {
|
||
Ratio float64 `json:"ratio"` // 佣金冻结比例（例如：0.1表示10%）
|
||
Threshold float64 `json:"threshold"` // 佣金冻结阈值（订单单价达到此金额才触发冻结，单位：元）
|
||
Days int64 `json:"days"` // 佣金冻结解冻天数（单位：天，例如：30表示30天后解冻）
|
||
}
|
||
// 系统配置更新（价格配置已移除，改为产品配置表管理）
|
||
AdminUpdateAgentConfigReq {
|
||
LevelBonus *LevelBonusConfig `json:"level_bonus,optional"` // 等级加成配置
|
||
UpgradeFee *UpgradeFeeConfig `json:"upgrade_fee,optional"` // 升级费用配置
|
||
UpgradeRebate *UpgradeRebateConfig `json:"upgrade_rebate,optional"` // 升级返佣配置
|
||
DirectParentRebate *DirectParentRebateConfig `json:"direct_parent_rebate,optional"` // 直接上级返佣配置
|
||
MaxGoldRebateAmount *float64 `json:"max_gold_rebate_amount,optional"` // 黄金代理最大返佣金额
|
||
CommissionFreeze *CommissionFreezeConfig `json:"commission_freeze,optional"` // 佣金冻结配置
|
||
TaxRate *float64 `json:"tax_rate,optional"` // 税率
|
||
TaxExemptionAmount *float64 `json:"tax_exemption_amount,optional"` // 免税额度
|
||
GoldMaxUpliftAmount *float64 `json:"gold_max_uplift_amount,optional"`
|
||
DiamondMaxUpliftAmount *float64 `json:"diamond_max_uplift_amount,optional"`
|
||
}
|
||
AdminUpdateAgentConfigResp {
|
||
Success bool `json:"success"`
|
||
}
|
||
// 产品配置分页查询
|
||
AdminGetAgentProductConfigListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
ProductId *string `form:"product_id,optional"` // 产品ID（可选）
|
||
ProductName *string `form:"product_name,optional"` // 产品名称（可选，用于搜索）
|
||
}
|
||
AgentProductConfigItem {
|
||
Id string `json:"id"` // 主键
|
||
ProductId string `json:"product_id"` // 产品ID
|
||
ProductName string `json:"product_name"` // 产品名称
|
||
BasePrice float64 `json:"base_price"` // 基础底价
|
||
PriceRangeMin float64 `json:"price_range_min"` // 最低定价
|
||
PriceRangeMax float64 `json:"price_range_max"` // 最高定价
|
||
PriceThreshold float64 `json:"price_threshold"` // 提价标准阈值
|
||
PriceFeeRate float64 `json:"price_fee_rate"` // 提价手续费比例
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetAgentProductConfigListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []AgentProductConfigItem `json:"items"` // 列表数据
|
||
}
|
||
// 产品配置更新
|
||
AdminUpdateAgentProductConfigReq {
|
||
Id string `json:"id"` // 主键
|
||
BasePrice float64 `json:"base_price"` // 基础底价
|
||
PriceRangeMax float64 `json:"price_range_max"` // 最高定价（对应数据库 system_max_price）
|
||
PriceThreshold *float64 `json:"price_threshold,optional"` // 提价标准阈值（可选）
|
||
PriceFeeRate *float64 `json:"price_fee_rate,optional"` // 提价手续费比例（可选）
|
||
}
|
||
AdminUpdateAgentProductConfigResp {
|
||
Success bool `json:"success"`
|
||
}
|
||
// 生成钻石邀请码
|
||
AdminGenerateDiamondInviteCodeReq {
|
||
Count int64 `json:"count"` // 生成数量
|
||
ExpireDays int64 `json:"expire_days,optional"` // 过期天数（可选，0表示不过期）
|
||
Remark string `json:"remark,optional"` // 备注（可选）
|
||
}
|
||
AdminGenerateDiamondInviteCodeResp {
|
||
Codes []string `json:"codes"` // 生成的邀请码列表
|
||
}
|
||
// 邀请码列表查询
|
||
AdminGetInviteCodeListReq {
|
||
Page int64 `form:"page"` // 页码
|
||
PageSize int64 `form:"pageSize"` // 每页数量
|
||
Code *string `form:"code,optional"` // 邀请码（可选）
|
||
AgentId *string `form:"agent_id,optional"` // 发放代理ID（可选，NULL表示平台发放）
|
||
TargetLevel *int64 `form:"target_level,optional"` // 目标等级（可选）
|
||
Status *int64 `form:"status,optional"` // 状态（可选）
|
||
}
|
||
InviteCodeListItem {
|
||
Id string `json:"id"` // 主键
|
||
Code string `json:"code"` // 邀请码
|
||
AgentId string `json:"agent_id"` // 发放代理ID（0表示平台发放）
|
||
AgentMobile string `json:"agent_mobile"` // 发放代理手机号
|
||
TargetLevel int64 `json:"target_level"` // 目标等级
|
||
Status int64 `json:"status"` // 状态：0=未使用，1=已使用，2=已失效
|
||
UsedUserId string `json:"used_user_id"` // 使用用户ID
|
||
UsedAgentId string `json:"used_agent_id"` // 使用代理ID
|
||
UsedTime string `json:"used_time"` // 使用时间
|
||
ExpireTime string `json:"expire_time"` // 过期时间
|
||
Remark string `json:"remark"` // 备注
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
AdminGetInviteCodeListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []InviteCodeListItem `json:"items"` // 列表数据
|
||
}
|
||
)
|
||
|