385 lines
18 KiB
Plaintext
385 lines
18 KiB
Plaintext
syntax = "v1"
|
||
|
||
info (
|
||
title: "后台代理管理服务"
|
||
desc: "后台代理相关接口"
|
||
author: "team"
|
||
version: "v1"
|
||
)
|
||
|
||
// 代理管理接口
|
||
@server(
|
||
prefix: /api/v1/admin/agent
|
||
group: admin_agent
|
||
)
|
||
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 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 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)
|
||
}
|
||
|
||
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（可选）
|
||
ProductName *string `form:"product_name,optional"` // 产品名（可选）
|
||
Status *int64 `form:"status,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"` // 列表数据
|
||
}
|
||
|
||
// 代理奖励分页查询请求
|
||
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"` // 提现单号（可选）
|
||
}
|
||
|
||
// 代理提现列表项
|
||
AgentWithdrawalListItem {
|
||
Id int64 `json:"id"` // 主键
|
||
AgentId int64 `json:"agent_id"` // 代理ID
|
||
WithdrawNo string `json:"withdraw_no"` // 提现单号
|
||
Amount float64 `json:"amount"` // 金额
|
||
Status int64 `json:"status"` // 状态
|
||
PayeeAccount string `json:"payee_account"` // 收款账户
|
||
Remark string `json:"remark"` // 备注
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
}
|
||
|
||
// 代理提现分页查询响应
|
||
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"` // 是否成功
|
||
}
|
||
) |