This commit is contained in:
2026-05-13 14:43:10 +08:00
parent 2312f54e1e
commit 3399de0dc5
49 changed files with 1637 additions and 287 deletions

View File

@@ -20,6 +20,10 @@ service main {
@handler AdminGetAgentList
get /list (AdminGetAgentListReq) returns (AdminGetAgentListResp)
// 代理团队树(同钻石团队 + 邀请关系)
@handler AdminGetAgentTeamTree
get /team/tree (AdminGetAgentTeamTreeReq) returns (AdminGetAgentTeamTreeResp)
// 代理审核
@handler AdminAuditAgent
post /audit (AdminAuditAgentReq) returns (AdminAuditAgentResp)
@@ -32,6 +36,10 @@ service main {
@handler AdminGetAgentOrderList
get /order/list (AdminGetAgentOrderListReq) returns (AdminGetAgentOrderListResp)
// 单笔订单分账视图:同一响应返回佣金 + 返佣(避免前端双请求重复走鉴权)
@handler AdminGetAgentOrderSettlement
get /order/settlement (AdminGetAgentOrderSettlementReq) returns (AdminGetAgentOrderSettlementResp)
// 代理佣金分页查询
@handler AdminGetAgentCommissionList
get /commission/list (AdminGetAgentCommissionListReq) returns (AdminGetAgentCommissionListResp)
@@ -94,9 +102,12 @@ type (
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
Mobile *string `form:"mobile,optional"` // 手机号(可选)
AgentCode *string `form:"agent_code,optional"` // 代理编码(可选)
Region *string `form:"region,optional"` // 区域(可选)
Level *int64 `form:"level,optional"` // 等级(可选)
TeamLeaderId *string `form:"team_leader_id,optional"` // 团队首领ID可选
AgentId *string `form:"agent_id,optional"` // 代理主键UUID精确查询传入时不再按 team_leader 与其它条件组合筛选
RealName *string `form:"real_name,optional"` // 实名姓名(可选,模糊匹配已三要素核验记录)
}
AgentListItem {
Id string `json:"id"` // 主键
@@ -108,7 +119,8 @@ type (
RealName string `json:"real_name"` // 姓名(来自实名表)
IdCard string `json:"id_card"` // 身份证(解密后明文返回)
WechatId string `json:"wechat_id"` // 微信号
TeamLeaderId string `json:"team_leader_id"` // 团队首领ID
TeamLeaderId string `json:"team_leader_id"` // 团队首领ID
SubordinateCount int64 `json:"subordinate_count"` // 直属下级代理数team_leader_id 为本代理 id
AgentCode int64 `json:"agent_code"`
Balance float64 `json:"balance"` // 钱包余额
TotalEarnings float64 `json:"total_earnings"` // 累计收益
@@ -121,6 +133,21 @@ type (
Total int64 `json:"total"` // 总数
Items []AgentListItem `json:"items"` // 列表数据
}
AdminGetAgentTeamTreeReq {
AgentId string `form:"agent_id"` // 锚点代理IDUUID
}
AgentTeamTreeNode {
Id string `json:"id"`
AgentCode int64 `json:"agent_code"`
Level int64 `json:"level"`
LevelName string `json:"level_name"`
Mobile string `json:"mobile"`
IsAnchor bool `json:"is_anchor"`
Children []AgentTeamTreeNode `json:"children"`
}
AdminGetAgentTeamTreeResp {
Root AgentTeamTreeNode `json:"root"`
}
// 代理审核
AdminAuditAgentReq {
AuditId int64 `json:"audit_id"` // 审核记录ID
@@ -135,12 +162,14 @@ type (
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID可选
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
ProductId *string `form:"product_id,optional"` // 产品ID可选
LinkIdentifier *string `form:"link_identifier,optional"` // 推广码(可选)
}
AgentLinkListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
ProductId string `json:"product_id"` // 产品ID
ProductName string `json:"product_name"` // 产品名称
SetPrice float64 `json:"set_price"` // 设定价格
@@ -157,14 +186,18 @@ type (
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID可选
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
OrderId *string `form:"order_id,optional"` // 订单ID可选
OrderNo *string `form:"order_no,optional"` // 商户订单号(可选)
ProcessStatus *int64 `form:"process_status,optional"` // 处理状态(可选)
OrderStatus *string `form:"order_status,optional"` // 订单状态可选pending-待支付paid-已支付refunded-已退款closed-已关闭failed-支付失败
}
AgentOrderListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
OrderId string `json:"order_id"` // 订单ID
OrderNo string `json:"order_no"` // 商户订单号
ProductId string `json:"product_id"` // 产品ID
ProductName string `json:"product_name"` // 产品名称
OrderAmount float64 `json:"order_amount"` // 订单金额
@@ -180,18 +213,28 @@ type (
Total int64 `json:"total"` // 总数
Items []AgentOrderListItem `json:"items"` // 列表数据
}
AdminGetAgentOrderSettlementReq {
OrderNo string `form:"order_no"` // 商户订单号
}
AdminGetAgentOrderSettlementResp {
Commissions []AgentCommissionListItem `json:"commissions"` // 本单销售佣金
Rebates []AgentRebateListItem `json:"rebates"` // 本单返佣
}
// 代理佣金分页查询
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"` // 状态(可选)
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID可选
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
OrderNo *string `form:"order_no,optional"` // 商户订单号(可选)
Status *int64 `form:"status,optional"` // 状态(可选)
}
AgentCommissionListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
OrderId string `json:"order_id"` // 订单ID
OrderNo string `json:"order_no"` // 商户订单号
ProductName string `json:"product_name"` // 产品名称
Amount float64 `json:"amount"` // 金额
Status int64 `json:"status"` // 状态
@@ -203,18 +246,23 @@ type (
}
// 代理返佣分页查询
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"` // 返佣类型(可选)
Status *int64 `form:"status,optional"` // 状态可选1=已发放2=已冻结3=已取消(已退款
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID可选
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
SourceAgentCode *string `form:"source_agent_code,optional"` // 来源代理编号(可选)
OrderNo *string `form:"order_no,optional"` // 商户订单号(可选
RebateType *int64 `form:"rebate_type,optional"` // 返佣类型(可选)
Status *int64 `form:"status,optional"` // 状态可选1=已发放2=已冻结3=已取消(已退款)
}
AgentRebateListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 获得返佣的代理ID
SourceAgentId string `json:"source_agent_id"` // 来源代理ID
OrderId string `json:"order_id"` // 订单ID
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 获得返佣的代理ID
AgentCode int64 `json:"agent_code"` // 获得返佣代理编号
SourceAgentId string `json:"source_agent_id"` // 来源代理ID
SourceAgentCode int64 `json:"source_agent_code"` // 来源代理编号
OrderId string `json:"order_id"` // 订单ID
OrderNo string `json:"order_no"` // 商户订单号
RebateType int64 `json:"rebate_type"` // 返佣类型
Amount float64 `json:"amount"` // 金额
Status int64 `json:"status"` // 状态1=已发放2=已冻结3=已取消(已退款)
@@ -229,12 +277,14 @@ type (
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID可选
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
UpgradeType *int64 `form:"upgrade_type,optional"` // 升级类型(可选)
Status *int64 `form:"status,optional"` // 状态(可选)
}
AgentUpgradeListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
FromLevel int64 `json:"from_level"` // 原等级
ToLevel int64 `json:"to_level"` // 目标等级
UpgradeType int64 `json:"upgrade_type"` // 升级类型
@@ -249,15 +299,20 @@ type (
}
// 代理提现分页查询
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"` // 提现单号(可选)
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理主键 UUID弹窗内按代理筛选时传入
AgentCode *string `form:"agent_code,optional"` // 代理编号(可选)
WithdrawNo *string `form:"withdraw_no,optional"` // 提现单号(可选,模糊匹配
Status string `form:"status,optional"` // 状态可选1=待审核2=已通过3=已拒绝5=已打款
WithdrawalType string `form:"withdrawal_type,optional"` // 提现方式可选1=支付宝2=银行卡
PayeeAccount *string `form:"payee_account,optional"` // 收款账户(可选,模糊)
PayeeName *string `form:"payee_name,optional"` // 收款人(可选,模糊)
}
AgentWithdrawalListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
WithdrawNo string `json:"withdraw_no"` // 提现单号
Amount float64 `json:"amount"` // 金额
TaxAmount float64 `json:"tax_amount"` // 税费金额
@@ -294,6 +349,7 @@ type (
AgentRealNameListItem {
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
AgentCode int64 `json:"agent_code"` // 代理编号
Name string `json:"name"` // 姓名
IdCard string `json:"id_card"` // 身份证号
Mobile string `json:"mobile"` // 手机号
@@ -412,20 +468,21 @@ type (
AdminGetInviteCodeListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
Code *string `form:"code,optional"` // 邀请码(可选)
AgentId *string `form:"agent_id,optional"` // 发放代理ID可选NULL表示平台发放
Code *string `form:"code,optional"` // 邀请码(可选,模糊匹配
TargetLevel *int64 `form:"target_level,optional"` // 目标等级(可选)
Status *int64 `form:"status,optional"` // 状态(可选)
Status string `form:"status,optional"` // 状态(可选)0=未使用1=已使用2=已失效
}
InviteCodeListItem {
Id string `json:"id"` // 主键
Code string `json:"code"` // 邀请码
AgentId string `json:"agent_id"` // 发放代理ID0表示平台发放
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
Id string `json:"id"` // 主键
Code string `json:"code"` // 邀请码
AgentId string `json:"agent_id"` // 发放代理ID0表示平台发放
AgentCode int64 `json:"agent_code"` // 发放代理编号平台为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
UsedAgentCode int64 `json:"used_agent_code"` // 使用代理编号
UsedTime string `json:"used_time"` // 使用时间
ExpireTime string `json:"expire_time"` // 过期时间
Remark string `json:"remark"` // 备注