441 lines
19 KiB
Plaintext
441 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 {
|
|||
|
|
// 代理分页查询（简化：移除level, team_leader_id筛选）
|
|||
|
|
@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 AdminGetAgentOrdersList
|
|||
|
|
get /orders/list (AdminGetAgentOrdersListReq) returns (AdminGetAgentOrdersListResp)
|
|||
|
|
|
|||
|
|
// 代理订单退款
|
|||
|
|
@handler AdminRefundAgentOrder
|
|||
|
|
post /orders/refund (AdminRefundAgentOrderReq) returns (AdminRefundAgentOrderResp)
|
|||
|
|
|
|||
|
|
// 系统配置查询（简化：移除等级、升级、返佣配置）
|
|||
|
|
@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 AdminGetAgentWithdrawList
|
|||
|
|
get /withdraw/list (AdminGetAgentWithdrawListReq) returns (AdminGetAgentWithdrawListResp)
|
|||
|
|
|
|||
|
|
// 代理提现审核
|
|||
|
|
@handler AdminAuditAgentWithdraw
|
|||
|
|
post /withdraw/audit (AdminAuditAgentWithdrawReq) returns (AdminAuditAgentWithdrawResp)
|
|||
|
|
|
|||
|
|
// 发送代理投诉通知短信
|
|||
|
|
@handler AdminSendAgentComplaintNotify
|
|||
|
|
post /complaint/notify (AdminSendAgentComplaintNotifyReq) returns (AdminSendAgentComplaintNotifyResp)
|
|||
|
|
|
|||
|
|
// 获取统计概览数据
|
|||
|
|
@handler AdminGetStatisticsOverview
|
|||
|
|
get /statistics/overview returns (AdminGetStatisticsOverviewResp)
|
|||
|
|
|
|||
|
|
// 获取订单趋势数据
|
|||
|
|
@handler AdminGetOrderTrends
|
|||
|
|
get /statistics/order/trends (AdminGetOrderTrendsReq) returns (AdminGetOrderTrendsResp)
|
|||
|
|
|
|||
|
|
// 获取代理注册趋势
|
|||
|
|
@handler AdminGetAgentTrends
|
|||
|
|
get /statistics/agent/trends (AdminGetAgentTrendsReq) returns (AdminGetAgentTrendsResp)
|
|||
|
|
|
|||
|
|
// 获取产品订单分布
|
|||
|
|
@handler AdminGetProductDistribution
|
|||
|
|
get /statistics/product/distribution returns (AdminGetProductDistributionResp)
|
|||
|
|
|
|||
|
|
// 获取区域代理分布
|
|||
|
|
@handler AdminGetRegionDistribution
|
|||
|
|
get /statistics/region/distribution returns (AdminGetRegionDistributionResp)
|
|||
|
|
|
|||
|
|
// 获取代理排行榜
|
|||
|
|
@handler AdminGetAgentRanking
|
|||
|
|
get /statistics/agent/ranking (AdminGetAgentRankingReq) returns (AdminGetAgentRankingResp)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type (
|
|||
|
|
// 代理分页查询（简化）
|
|||
|
|
AdminGetAgentListReq {
|
|||
|
|
Page int64 `form:"page"` // 页码
|
|||
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|||
|
|
Mobile *string `form:"mobile,optional"` // 手机号（可选）
|
|||
|
|
Region *string `form:"region,optional"` // 区域（可选）
|
|||
|
|
}
|
|||
|
|
AgentListItem {
|
|||
|
|
Id string `json:"id"` // 主键
|
|||
|
|
UserId string `json:"user_id"` // 用户ID
|
|||
|
|
Region string `json:"region"` // 区域
|
|||
|
|
Mobile string `json:"mobile"` // 手机号
|
|||
|
|
WechatId string `json:"wechat_id"` // 微信号
|
|||
|
|
AgentCode int64 `json:"agent_code"` // 代理编码
|
|||
|
|
Balance float64 `json:"balance"` // 钱包余额
|
|||
|
|
FrozenAmount float64 `json:"frozen_amount"` // 冻结余额
|
|||
|
|
TotalEarnings float64 `json:"total_earnings"` // 累计收益
|
|||
|
|
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"` // 设定价格
|
|||
|
|
ShortLink string `json:"short_link"` // 短链链接
|
|||
|
|
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"` // 列表数据
|
|||
|
|
}
|
|||
|
|
// 代理订单列表（整合订单、佣金、代理信息）
|
|||
|
|
AdminGetAgentOrdersListReq {
|
|||
|
|
Page int64 `form:"page"` // 页码
|
|||
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|||
|
|
// 代理筛选
|
|||
|
|
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
|||
|
|
AgentMobile *string `form:"agent_mobile,optional"` // 代理手机号（可选）
|
|||
|
|
// 用户筛选
|
|||
|
|
UserMobile *string `form:"user_mobile,optional"` // 用户手机号（可选）
|
|||
|
|
// 订单筛选
|
|||
|
|
OrderNo *string `form:"order_no,optional"` // 商户订单号（可选）
|
|||
|
|
PlatformOrderId *string `form:"platform_order_id,optional"` // 支付订单号（可选）
|
|||
|
|
ProductName *string `form:"product_name,optional"` // 产品名称（可选）
|
|||
|
|
// 支付筛选
|
|||
|
|
PaymentPlatform *string `form:"payment_platform,optional"` // 支付方式（可选）
|
|||
|
|
PaymentScene *string `form:"payment_scene,optional"` // 支付平台（可选）
|
|||
|
|
// 状态筛选
|
|||
|
|
OrderStatus *string `form:"order_status,optional"` // 订单状态（可选）
|
|||
|
|
CommissionStatus *int64 `form:"commission_status,optional"` // 佣金状态（可选）
|
|||
|
|
// 时间筛选
|
|||
|
|
CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始（可选）
|
|||
|
|
CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束（可选）
|
|||
|
|
PayTimeStart *string `form:"pay_time_start,optional"` // 支付时间开始（可选）
|
|||
|
|
PayTimeEnd *string `form:"pay_time_end,optional"` // 支付时间结束（可选）
|
|||
|
|
// 排序
|
|||
|
|
OrderBy *string `form:"order_by,optional"` // 排序字段（可选）
|
|||
|
|
OrderType *string `form:"order_type,optional"` // 排序方式（可选）
|
|||
|
|
}
|
|||
|
|
AgentOrdersListItem {
|
|||
|
|
Id string `json:"id"` // 主键
|
|||
|
|
OrderNo string `json:"order_no"` // 商户订单号
|
|||
|
|
PlatformOrderId string `json:"platform_order_id"` // 支付订单号
|
|||
|
|
// 代理信息
|
|||
|
|
AgentId string `json:"agent_id"` // 代理ID
|
|||
|
|
AgentMobile string `json:"agent_mobile"` // 代理手机号
|
|||
|
|
// 用户信息
|
|||
|
|
UserId string `json:"user_id"` // 用户ID
|
|||
|
|
UserMobile *string `json:"user_mobile"` // 用户手机号
|
|||
|
|
// 产品信息
|
|||
|
|
ProductId string `json:"product_id"` // 产品ID
|
|||
|
|
ProductName string `json:"product_name"` // 产品名称
|
|||
|
|
// 金额信息
|
|||
|
|
OrderAmount float64 `json:"order_amount"` // 订单金额
|
|||
|
|
CommissionAmount float64 `json:"commission_amount"` // 佣金金额
|
|||
|
|
// 支付信息
|
|||
|
|
PaymentPlatform string `json:"payment_platform"` // 支付方式
|
|||
|
|
PaymentScene string `json:"payment_scene"` // 支付平台
|
|||
|
|
// 状态
|
|||
|
|
OrderStatus string `json:"order_status"` // 订单状态
|
|||
|
|
CommissionStatus int64 `json:"commission_status"` // 佣金状态
|
|||
|
|
// 时间
|
|||
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|||
|
|
PayTime *string `json:"pay_time"` // 支付时间
|
|||
|
|
}
|
|||
|
|
AdminGetAgentOrdersListResp {
|
|||
|
|
Total int64 `json:"total"` // 总数
|
|||
|
|
Items []AgentOrdersListItem `json:"items"` // 列表数据
|
|||
|
|
}
|
|||
|
|
// 代理订单退款
|
|||
|
|
AdminRefundAgentOrderReq {
|
|||
|
|
OrderId int64 `json:"order_id"` // 订单ID
|
|||
|
|
RefundAmount float64 `json:"refund_amount"` // 退款金额
|
|||
|
|
RefundReason string `json:"refund_reason"` // 退款原因
|
|||
|
|
}
|
|||
|
|
AdminRefundAgentOrderResp {
|
|||
|
|
Success bool `json:"success"` // 是否成功
|
|||
|
|
Message string `json:"message"` // 消息
|
|||
|
|
RefundNo *string `json:"refund_no"` // 退款单号
|
|||
|
|
}
|
|||
|
|
// 系统配置查询（简化：只保留佣金冻结配置）
|
|||
|
|
AdminGetAgentConfigResp {
|
|||
|
|
CommissionFreeze CommissionFreezeConfig `json:"commission_freeze"` // 佣金冻结配置
|
|||
|
|
TaxRate float64 `json:"tax_rate"` // 税率
|
|||
|
|
}
|
|||
|
|
CommissionFreezeConfig {
|
|||
|
|
Ratio float64 `json:"ratio"` // 佣金冻结比例（例如：0.1表示10%）
|
|||
|
|
Threshold float64 `json:"threshold"` // 佣金冻结阈值（订单单价达到此金额才触发冻结，单位：元）
|
|||
|
|
Days int64 `json:"days"` // 佣金冻结解冻天数（单位：天，例如：30表示30天后解冻）
|
|||
|
|
}
|
|||
|
|
// 系统配置更新（简化）
|
|||
|
|
AdminUpdateAgentConfigReq {
|
|||
|
|
CommissionFreeze *CommissionFreezeConfig `json:"commission_freeze,optional"` // 佣金冻结配置
|
|||
|
|
TaxRate *float64 `json:"tax_rate,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"` // 最高定价
|
|||
|
|
PriceThreshold *float64 `json:"price_threshold,optional"` // 提价标准阈值（可选）
|
|||
|
|
PriceFeeRate *float64 `json:"price_fee_rate,optional"` // 提价手续费比例（可选）
|
|||
|
|
}
|
|||
|
|
AdminUpdateAgentProductConfigResp {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
}
|
|||
|
|
// ============================================
|
|||
|
|
// 代理提现相关
|
|||
|
|
// ============================================
|
|||
|
|
// 代理提现记录分页查询
|
|||
|
|
AdminGetAgentWithdrawListReq {
|
|||
|
|
Page int64 `form:"page"` // 页码
|
|||
|
|
PageSize int64 `form:"pageSize"` // 每页数量
|
|||
|
|
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
|
|||
|
|
Status *int64 `form:"status,optional"` // 状态（可选）：0=待审核，1=已通过，2=已拒绝
|
|||
|
|
}
|
|||
|
|
AgentWithdrawListItem {
|
|||
|
|
Id string `json:"id"` // 主键
|
|||
|
|
AgentId string `json:"agent_id"` // 代理ID
|
|||
|
|
AgentMobile string `json:"agent_mobile"` // 代理手机号
|
|||
|
|
AgentCode int64 `json:"agent_code"` // 代理编码
|
|||
|
|
WithdrawAmount float64 `json:"withdraw_amount"` // 提现金额
|
|||
|
|
TaxAmount float64 `json:"tax_amount"` // 税费金额
|
|||
|
|
ActualAmount float64 `json:"actual_amount"` // 实际到账金额（税后）
|
|||
|
|
FrozenAmount float64 `json:"frozen_amount"` // 冻结金额
|
|||
|
|
AccountName string `json:"account_name"` // 收款人姓名
|
|||
|
|
BankCardNumber string `json:"bank_card_number"` // 银行卡号（脱敏）
|
|||
|
|
BankCardNumberFull string `json:"bank_card_number_full"` // 银行卡号（完整，用于审核）
|
|||
|
|
BankBranch string `json:"bank_branch"` // 开户支行
|
|||
|
|
Status int64 `json:"status"` // 状态：0=待审核，1=已通过，2=已拒绝
|
|||
|
|
AuditUserId string `json:"audit_user_id"` // 审核人ID
|
|||
|
|
AuditTime string `json:"audit_time"` // 审核时间
|
|||
|
|
AuditRemark string `json:"audit_remark"` // 审核备注
|
|||
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|||
|
|
}
|
|||
|
|
AdminGetAgentWithdrawListResp {
|
|||
|
|
Total int64 `json:"total"` // 总数
|
|||
|
|
Items []AgentWithdrawListItem `json:"items"` // 列表数据
|
|||
|
|
}
|
|||
|
|
// 代理提现审核
|
|||
|
|
AdminAuditAgentWithdrawReq {
|
|||
|
|
WithdrawId string `json:"withdraw_id"` // 提现记录ID
|
|||
|
|
Status int64 `json:"status"` // 审核状态：1=通过，2=拒绝
|
|||
|
|
AuditRemark string `json:"audit_reason,optional"` // 审核原因（拒绝时必填）
|
|||
|
|
}
|
|||
|
|
AdminAuditAgentWithdrawResp {
|
|||
|
|
Success bool `json:"success"` // 是否成功
|
|||
|
|
Message string `json:"message"` // 消息
|
|||
|
|
}
|
|||
|
|
// 发送代理投诉通知短信请求
|
|||
|
|
AdminSendAgentComplaintNotifyReq {
|
|||
|
|
AgentId string `json:"agent_id"` // 代理ID
|
|||
|
|
UserName string `json:"user_name"` // 投诉用户姓名
|
|||
|
|
}
|
|||
|
|
// 发送代理投诉通知短信响应
|
|||
|
|
AdminSendAgentComplaintNotifyResp {
|
|||
|
|
Success bool `json:"success"` // 是否成功
|
|||
|
|
Message string `json:"message"` // 消息
|
|||
|
|
}
|
|||
|
|
// ============================================
|
|||
|
|
// 统计分析相关类型
|
|||
|
|
// ============================================
|
|||
|
|
// 统计概览响应
|
|||
|
|
AdminGetStatisticsOverviewResp {
|
|||
|
|
TotalAgents int64 `json:"total_agents"` // 代理总数
|
|||
|
|
TodayNewAgents int64 `json:"today_new_agents"` // 今日新增代理
|
|||
|
|
TotalOrders int64 `json:"total_orders"` // 总订单数
|
|||
|
|
TodayOrders int64 `json:"today_orders"` // 今日订单数
|
|||
|
|
TotalOrderAmount float64 `json:"total_order_amount"` // 总订单金额
|
|||
|
|
TodayOrderAmount float64 `json:"today_order_amount"` // 今日订单金额
|
|||
|
|
TotalCommission float64 `json:"total_commission"` // 总佣金支出
|
|||
|
|
TodayCommission float64 `json:"today_commission"` // 今日佣金支出
|
|||
|
|
PendingWithdraw float64 `json:"pending_withdraw"` // 待审核提现金额
|
|||
|
|
MonthOrderAmount float64 `json:"month_order_amount"` // 本月订单金额
|
|||
|
|
MonthCommission float64 `json:"month_commission"` // 本月佣金支出
|
|||
|
|
}
|
|||
|
|
// 订单趋势请求
|
|||
|
|
AdminGetOrderTrendsReq {
|
|||
|
|
StartDate string `form:"start_date,optional"` // 开始日期 YYYY-MM-DD
|
|||
|
|
EndDate string `form:"end_date,optional"` // 结束日期 YYYY-MM-DD
|
|||
|
|
}
|
|||
|
|
// 订单趋势响应
|
|||
|
|
AdminGetOrderTrendsResp {
|
|||
|
|
Dates []string `json:"dates"` // 日期列表
|
|||
|
|
Amounts []float64 `json:"amounts"` // 金额列表
|
|||
|
|
Counts []int64 `json:"counts"` // 订单数列表
|
|||
|
|
}
|
|||
|
|
// 代理注册趋势请求
|
|||
|
|
AdminGetAgentTrendsReq {
|
|||
|
|
StartDate string `form:"start_date,optional"` // 开始日期 YYYY-MM-DD
|
|||
|
|
EndDate string `form:"end_date,optional"` // 结束日期 YYYY-MM-DD
|
|||
|
|
}
|
|||
|
|
// 代理注册趋势响应
|
|||
|
|
AdminGetAgentTrendsResp {
|
|||
|
|
Dates []string `json:"dates"` // 日期列表
|
|||
|
|
Counts []int64 `json:"counts"` // 新增代理数列表
|
|||
|
|
}
|
|||
|
|
// 产品订单分布响应
|
|||
|
|
AdminGetProductDistributionResp {
|
|||
|
|
Products []string `json:"products"` // 产品名称列表
|
|||
|
|
Counts []int64 `json:"counts"` // 订单数量列表
|
|||
|
|
Amounts []float64 `json:"amounts"` // 订单金额列表
|
|||
|
|
}
|
|||
|
|
// 区域代理分布响应
|
|||
|
|
AdminGetRegionDistributionResp {
|
|||
|
|
Regions []string `json:"regions"` // 区域名称列表
|
|||
|
|
Counts []int64 `json:"counts"` // 代理数量列表
|
|||
|
|
}
|
|||
|
|
// 代理排行榜请求
|
|||
|
|
AdminGetAgentRankingReq {
|
|||
|
|
Type string `form:"type"` // 排行类型: commission=佣金排行, orders=订单量排行
|
|||
|
|
Limit int64 `form:"limit,optional"` // 返回数量，默认10
|
|||
|
|
}
|
|||
|
|
// 代理排行榜响应
|
|||
|
|
AdminGetAgentRankingResp {
|
|||
|
|
Items []AgentRankingItem `json:"items"` // 排行榜列表
|
|||
|
|
}
|
|||
|
|
// 代理排行榜项
|
|||
|
|
AgentRankingItem {
|
|||
|
|
AgentId string `json:"agent_id"` // 代理ID
|
|||
|
|
AgentMobile string `json:"agent_mobile"` // 代理手机号
|
|||
|
|
Region string `json:"region"` // 区域
|
|||
|
|
Value float64 `json:"value"` // 值（佣金或订单数）
|
|||
|
|
}
|
|||
|
|
)
|
|||
|
|
|