team/ycc-proxy-server
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v1.1

Browse Source
This commit is contained in:
liangzai
2025-12-09 18:55:28 +08:00
parent 8d00d67540
commit c23ab8338b
209 changed files with 5445 additions and 3963 deletions
Download Patch File Download Diff File Expand all files Collapse all files

193
app/main/api/desc/admin/admin_agent.api
View File

@@ -59,7 +59,6 @@ service main {
// 代理实名认证审核（已废弃：实名认证改为三要素核验，无需审核）
// @handler AdminAuditRealName
// post /real_name/audit (AdminAuditRealNameReq) returns (AdminAuditRealNameResp)
// 系统配置查询
@handler AdminGetAgentConfig
get /config returns (AdminGetAgentConfigResp)
@@ -93,17 +92,18 @@ type (
Mobile *string `form:"mobile,optional"` // 手机号（可选）
Region *string `form:"region,optional"` // 区域（可选）
Level *int64 `form:"level,optional"` // 等级（可选）
TeamLeaderId *int64 `form:"team_leader_id,optional"` // 团队首领ID（可选）
TeamLeaderId *string `form:"team_leader_id,optional"` // 团队首领ID（可选）
}
AgentListItem {
Id int64 `json:"id"` // 主键
UserId int64 `json:"user_id"` // 用户ID
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 int64 `json:"team_leader_id"` // 团队首领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"` // 冻结余额
@@ -128,14 +128,14 @@ type (
AdminGetAgentLinkListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
ProductId *int64 `form:"product_id,optional"` // 产品ID（可选）
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
ProductId *string `form:"product_id,optional"` // 产品ID（可选）
LinkIdentifier *string `form:"link_identifier,optional"` // 推广码（可选）
}
AgentLinkListItem {
Id int64 `json:"id"` // 主键
AgentId int64 `json:"agent_id"` // 代理ID
ProductId int64 `json:"product_id"` // 产品ID
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"` // 实际底价
@@ -148,17 +148,17 @@ type (
}
// 代理订单分页查询
AdminGetAgentOrderListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
OrderId *int64 `form:"order_id,optional"` // 订单ID（可选）
ProcessStatus *int64 `form:"process_status,optional"` // 处理状态（可选）
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 int64 `json:"id"` // 主键
AgentId int64 `json:"agent_id"` // 代理ID
OrderId int64 `json:"order_id"` // 订单ID
ProductId int64 `json:"product_id"` // 产品ID
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"` // 设定价格
@@ -174,16 +174,16 @@ type (
}
// 代理佣金分页查询
AdminGetAgentCommissionListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
OrderId *int64 `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（可选）
OrderId *string `form:"order_id,optional"` // 订单ID（可选）
Status *int64 `form:"status,optional"` // 状态（可选）
}
AgentCommissionListItem {
Id int64 `json:"id"` // 主键
AgentId int64 `json:"agent_id"` // 代理ID
OrderId int64 `json:"order_id"` // 订单ID
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"` // 状态
@@ -195,17 +195,17 @@ type (
}
// 代理返佣分页查询
AdminGetAgentRebateListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
SourceAgentId *int64 `form:"source_agent_id,optional"` // 来源代理ID（可选）
RebateType *int64 `form:"rebate_type,optional"` // 返佣类型（可选）
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 int64 `json:"id"` // 主键
AgentId int64 `json:"agent_id"` // 获得返佣的代理ID
SourceAgentId int64 `json:"source_agent_id"` // 来源代理ID
OrderId int64 `json:"order_id"` // 订单ID
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"` // 创建时间
@@ -216,15 +216,15 @@ type (
}
// 代理升级记录分页查询
AdminGetAgentUpgradeListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
UpgradeType *int64 `form:"upgrade_type,optional"` // 升级类型（可选）
Status *int64 `form:"status,optional"` // 状态（可选）
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 int64 `json:"id"` // 主键
AgentId int64 `json:"agent_id"` // 代理ID
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"` // 升级类型
@@ -241,13 +241,13 @@ type (
AdminGetAgentWithdrawalListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
AgentId *string `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
Id string `json:"id"` // 主键
AgentId string `json:"agent_id"` // 代理ID
WithdrawNo string `json:"withdraw_no"` // 提现单号
Amount float64 `json:"amount"` // 金额
TaxAmount float64 `json:"tax_amount"` // 税费金额
@@ -264,7 +264,7 @@ type (
}
// 代理提现审核
AdminAuditWithdrawalReq {
WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID
WithdrawalId string `json:"withdrawal_id"` // 提现记录ID
Status int64 `json:"status"` // 审核状态：2=通过，3=拒绝
Remark string `json:"remark"` // 备注
}
@@ -273,20 +273,20 @@ type (
}
// 代理实名认证分页查询
AdminGetAgentRealNameListReq {
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *int64 `form:"agent_id,optional"` // 代理ID（可选）
Status *int64 `form:"status,optional"` // 状态（可选）：1=未验证，2=已通过
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
AgentId *string `form:"agent_id,optional"` // 代理ID（可选）
Status *int64 `form:"status,optional"` // 状态（可选）：1=未验证，2=已通过
}
AgentRealNameListItem {
Id int64 `json:"id"` // 主键
AgentId int64 `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"` // 创建时间
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"` // 总数
@@ -303,14 +303,16 @@ type (
}
// 系统配置查询（价格配置已移除，改为产品配置表管理）
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"` // 免税额度
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
@@ -320,7 +322,6 @@ type (
UpgradeFeeConfig {
NormalToGold float64 `json:"normal_to_gold"` // 普通→黄金：199
NormalToDiamond float64 `json:"normal_to_diamond"` // 普通→钻石：980
GoldToDiamond float64 `json:"gold_to_diamond"` // 黄金→钻石：980
}
UpgradeRebateConfig {
NormalToGoldRebate float64 `json:"normal_to_gold_rebate"` // 普通→黄金返佣：139
@@ -332,34 +333,36 @@ type (
Normal float64 `json:"normal"` // 直接上级是普通的返佣金额（2元）
}
CommissionFreezeConfig {
Ratio float64 `json:"ratio"` // 佣金冻结比例（例如：0.1表示10%）
Threshold float64 `json:"threshold"` // 佣金冻结阈值（订单单价达到此金额才触发冻结，单位：元）
Days int64 `json:"days"` // 佣金冻结解冻天数（单位：天，例如：30表示30天后解冻）
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"` // 免税额度
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 *int64 `form:"product_id,optional"` // 产品ID（可选）
ProductName *string `form:"product_name,optional"` // 产品名称（可选，用于搜索）
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
ProductId *string `form:"product_id,optional"` // 产品ID（可选）
ProductName *string `form:"product_name,optional"` // 产品名称（可选，用于搜索）
}
AgentProductConfigItem {
Id int64 `json:"id"` // 主键
ProductId int64 `json:"product_id"` // 产品ID
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"` // 最低定价
@@ -374,11 +377,11 @@ type (
}
// 产品配置更新
AdminUpdateAgentProductConfigReq {
Id int64 `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"` // 提价手续费比例（可选）
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"`
@@ -397,19 +400,19 @@ type (
Page int64 `form:"page"` // 页码
PageSize int64 `form:"pageSize"` // 每页数量
Code *string `form:"code,optional"` // 邀请码（可选）
AgentId *int64 `form:"agent_id,optional"` // 发放代理ID（可选，NULL表示平台发放）
AgentId *string `form:"agent_id,optional"` // 发放代理ID（可选，NULL表示平台发放）
TargetLevel *int64 `form:"target_level,optional"` // 目标等级（可选）
Status *int64 `form:"status,optional"` // 状态（可选）
}
InviteCodeListItem {
Id int64 `json:"id"` // 主键
Id string `json:"id"` // 主键
Code string `json:"code"` // 邀请码
AgentId int64 `json:"agent_id"` // 发放代理ID（0表示平台发放）
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 int64 `json:"used_user_id"` // 使用用户ID
UsedAgentId int64 `json:"used_agent_id"` // 使用代理ID
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"` // 备注