From 1217ba119be1c7ac8c30f2cd2971fadfac7f4476 Mon Sep 17 00:00:00 2001 From: liangzai <2440983361@qq.com> Date: Sun, 1 Feb 2026 18:06:07 +0800 Subject: [PATCH] f --- app/main/api/desc/admin/admin_agent.api | 447 ++++++++---------- app/main/api/desc/front/agent.api | 21 +- .../admingetagentwithdrawallistlogic.go | 5 + .../adminreviewbankcardwithdrawallogic.go | 49 +- .../logic/agent/getagentwithdrawallogic.go | 5 + app/main/api/internal/types/types.go | 9 +- 6 files changed, 263 insertions(+), 273 deletions(-) diff --git a/app/main/api/desc/admin/admin_agent.api b/app/main/api/desc/admin/admin_agent.api index ad93a8c..9273aa7 100644 --- a/app/main/api/desc/admin/admin_agent.api +++ b/app/main/api/desc/admin/admin_agent.api @@ -8,9 +8,9 @@ info ( ) // 代理管理接口 -@server( - prefix: /api/v1/admin/agent - group: admin_agent +@server ( + prefix: /api/v1/admin/agent + group: admin_agent middleware: AdminAuthInterceptor ) service main { @@ -109,491 +109,430 @@ service main { // 代理钱包流水分页查询 @handler AdminGetAgentWalletTransactionList get /wallet-transaction/list (AdminGetAgentWalletTransactionListReq) returns (AdminGetAgentWalletTransactionListResp) - - } +} type ( // 代理分页查询请求 AdminGetAgentListReq { - Page int64 `form:"page"` // 页码 - PageSize int64 `form:"pageSize"` // 每页数量 - Mobile *string `form:"mobile,optional"` // 手机号(可选) - Region *string `form:"region,optional"` // 区域(可选) + 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"` // 手机号 + 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) + 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"` // 产品名(可选) + 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"` // 价格 + 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"` // 创建时间 + 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(可选) - OrderId *int64 `form:"order_id,optional"` // 订单ID(可选) - ProductName *string `form:"product_name,optional"` // 产品名(可选) - Status *int64 `form:"status,optional"` // 状态(可选) + Page int64 `form:"page"` // 页码 + PageSize int64 `form:"pageSize"` // 每页数量 + AgentId *int64 `form:"agent_id,optional"` // 代理ID(可选) + OrderId *int64 `form:"order_id,optional"` // 订单ID(可选) + ProductName *string `form:"product_name,optional"` // 产品名(可选) + Status *int64 `form:"status,optional"` // 状态(可选) CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始(可选) - CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束(可选) + CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束(可选) } - // 代理佣金列表项 AgentCommissionListItem { - Id int64 `json:"id"` // 主键 - AgentId int64 `json:"agent_id"` // 代理ID - OrderId int64 `json:"order_id"` // 订单ID - Amount float64 `json:"amount"` // 金额 + 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"` // 创建时间 + Status int64 `json:"status"` // 状态 + CreateTime string `json:"create_time"` // 创建时间 } - // 代理佣金分页查询响应 AdminGetAgentCommissionListResp { Total int64 `json:"total"` // 总数 Items []AgentCommissionListItem `json:"items"` // 列表数据 } - // 代理佣金状态更新请求 AdminUpdateAgentCommissionStatusReq { - Id int64 `json:"id"` // 佣金记录ID + Id int64 `json:"id"` // 佣金记录ID Status int64 `json:"status"` // 状态:0-已结算,1-冻结中,2-已取消 } - // 代理佣金状态更新响应 AdminUpdateAgentCommissionStatusResp { Success bool `json:"success"` // 是否成功 } - // 批量解冻代理佣金请求 AdminBatchUnfreezeAgentCommissionReq { AgentId *int64 `json:"agent_id,optional"` // 代理ID,可选。如果不传则解冻所有冻结中的佣金 } - // 批量解冻代理佣金响应 AdminBatchUnfreezeAgentCommissionResp { Success bool `json:"success"` // 是否成功 - Count int64 `json:"count"` // 解冻的数量 - Amount float64 `json:"amount"` // 解冻的总金额 + Count int64 `json:"count"` // 解冻的数量 + Amount float64 `json:"amount"` // 解冻的总金额 } - // 代理奖励分页查询请求 AdminGetAgentRewardListReq { - Page int64 `form:"page"` // 页码 - PageSize int64 `form:"pageSize"` // 每页数量 - AgentId *int64 `form:"agent_id,optional"` // 代理ID(可选) + 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"` // 奖励类型(可选) + Type *string `form:"type,optional"` // 奖励类型(可选) } - // 代理奖励列表项 AgentRewardListItem { - Id int64 `json:"id"` // 主键 - AgentId int64 `json:"agent_id"` // 代理ID + 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"` // 创建时间 + 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"` // 状态(可选) + 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"` // 提现单号(可选) WithdrawType *int64 `form:"withdraw_type,optional"` // 提现类型(可选)1-支付宝,2-银行卡 } - // 代理提现列表项 AgentWithdrawalListItem { - Id int64 `json:"id"` // 主键 - AgentId int64 `json:"agent_id"` // 代理ID - WithdrawNo string `json:"withdraw_no"` // 提现单号 - Amount float64 `json:"amount"` // 金额 + Id int64 `json:"id"` // 主键 + AgentId int64 `json:"agent_id"` // 代理ID + WithdrawNo string `json:"withdraw_no"` // 提现单号 + Amount float64 `json:"amount"` // 金额 ActualAmount float64 `json:"actual_amount"` // 实际到账金额(扣税后) - TaxAmount float64 `json:"tax_amount"` // 扣税金额 - Status int64 `json:"status"` // 状态 + TaxAmount float64 `json:"tax_amount"` // 扣税金额 + TaxRate float64 `json:"tax_rate"` // 扣税比例,如 0.06 表示 6% + Status int64 `json:"status"` // 状态 PayeeAccount string `json:"payee_account"` // 收款账户 - Remark string `json:"remark"` // 备注 - CreateTime string `json:"create_time"` // 创建时间 + Remark string `json:"remark"` // 备注 + CreateTime string `json:"create_time"` // 创建时间 WithdrawType int64 `json:"withdraw_type"` // 提现类型:1-支付宝,2-银行卡 - BankCardNo string `json:"bank_card_no"` // 银行卡号 - BankName string `json:"bank_name"` // 开户支行 - PayeeName string `json:"payee_name"` // 收款人姓名 + BankCardNo string `json:"bank_card_no"` // 银行卡号 + BankName string `json:"bank_name"` // 开户支行 + PayeeName string `json:"payee_name"` // 收款人姓名 } - // 代理提现分页查询响应 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(可选) + 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"` // 状态(可选) + Type *string `form:"type,optional"` // 类型(cost/pricing,可选) + Status *int64 `form:"status,optional"` // 状态(可选) } - // 代理抽佣列表项 AgentCommissionDeductionListItem { - Id int64 `json:"id"` // 主键 - AgentId int64 `json:"agent_id"` // 代理ID + 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"` // 创建时间 + 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"` // 每页数量 + 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"` // 状态(可选) + 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"` // 状态 + 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"` // 每页数量 + Page int64 `form:"page"` // 页码 + PageSize int64 `form:"pageSize"` // 每页数量 ProductName *string `form:"product_name,optional"` // 产品名(可选) - Id *int64 `form:"id,optional"` // 配置ID(可选) + 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"` // 定价标准 + 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"` // 创建时间 + 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"` // 定价标准 + 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"` // 订单号(可选) + 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"` // 支付方式(可选) + 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"` // 订单号 + 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"` // 创建时间 + 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"` // 每页数量 + 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"` // 新增活跃下级达标个数 + 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"` // 创建时间 + 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"` // 新增活跃下级达标个数 + 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"` // 在原本成本上加价的金额 + 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"` // 是否成功 } - // 银行卡提现审核请求 AdminReviewBankCardWithdrawalReq { - WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID - Action int64 `json:"action"` // 操作:1-确认,2-拒绝 - Remark string `json:"remark"` // 备注(拒绝时必填) + WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID + Action int64 `json:"action"` // 操作:1-确认,2-拒绝 + Remark string `json:"remark"` // 备注(拒绝时必填) + TaxRate *float64 `json:"tax_rate,optional"` // 扣税比例,如 0.06 表示 6%,不传则默认 6% } - // 银行卡提现审核响应 AdminReviewBankCardWithdrawalResp { Success bool `json:"success"` // 是否成功 } - // 获取提现统计数据请求 - AdminGetWithdrawalStatisticsReq { - } - + AdminGetWithdrawalStatisticsReq {} // 获取提现统计数据响应 AdminGetWithdrawalStatisticsResp { - TotalWithdrawalAmount float64 `json:"total_withdrawal_amount"` // 总提现金额 - TodayWithdrawalAmount float64 `json:"today_withdrawal_amount"` // 今日提现金额 - TotalActualAmount float64 `json:"total_actual_amount"` // 总实际到账金额 - TotalTaxAmount float64 `json:"total_tax_amount"` // 总扣税金额 + TotalWithdrawalAmount float64 `json:"total_withdrawal_amount"` // 总提现金额 + TodayWithdrawalAmount float64 `json:"today_withdrawal_amount"` // 今日提现金额 + TotalActualAmount float64 `json:"total_actual_amount"` // 总实际到账金额 + TotalTaxAmount float64 `json:"total_tax_amount"` // 总扣税金额 } - // 获取代理订单统计数据请求 - AdminGetAgentOrderStatisticsReq { - } - + AdminGetAgentOrderStatisticsReq {} // 获取代理订单统计数据响应 AdminGetAgentOrderStatisticsResp { TotalAgentOrderCount int64 `json:"total_agent_order_count"` // 总代理订单数 TodayAgentOrderCount int64 `json:"today_agent_order_count"` // 今日代理订单数 } - // 获取代理统计数据请求 - AdminGetAgentStatisticsReq { - } - + AdminGetAgentStatisticsReq {} // 获取代理统计数据响应 AdminGetAgentStatisticsResp { TotalAgentCount int64 `json:"total_agent_count"` // 总代理数 TodayAgentCount int64 `json:"today_agent_count"` // 今日新增代理数 } - // 获取代理链接产品统计请求 - AdminGetAgentLinkProductStatisticsReq { - } - + AdminGetAgentLinkProductStatisticsReq {} // 代理链接产品统计列表项 AgentLinkProductStatisticsItem { ProductName string `json:"product_name"` // 产品名称 - LinkCount int64 `json:"link_count"` // 推广链接数量 + LinkCount int64 `json:"link_count"` // 推广链接数量 } - // 获取代理链接产品统计响应 AdminGetAgentLinkProductStatisticsResp { Items []AgentLinkProductStatisticsItem `json:"items"` // 列表数据 } - // 获取代理钱包信息请求 AdminGetAgentWalletReq { AgentId int64 `path:"agent_id"` // 代理ID } - // 获取代理钱包信息响应 AdminGetAgentWalletResp { - Balance float64 `json:"balance"` // 可用余额 - FrozenBalance float64 `json:"frozen_balance"` // 冻结余额 - TotalEarnings float64 `json:"total_earnings"` // 总收益 + Balance float64 `json:"balance"` // 可用余额 + FrozenBalance float64 `json:"frozen_balance"` // 冻结余额 + TotalEarnings float64 `json:"total_earnings"` // 总收益 } - // 修改代理钱包余额请求 AdminUpdateAgentWalletBalanceReq { AgentId int64 `json:"agent_id"` // 代理ID - Amount float64 `json:"amount"` // 修改金额(正数增加,负数减少) + Amount float64 `json:"amount"` // 修改金额(正数增加,负数减少) } - // 修改代理钱包余额响应 AdminUpdateAgentWalletBalanceResp { Success bool `json:"success"` // 是否成功 - Balance float64 `json:"balance"` // 修改后的余额 + Balance float64 `json:"balance"` // 修改后的余额 } - // 更新系统配置请求 AdminUpdateSystemConfigReq { CommissionSafeMode *bool `json:"commission_safe_mode,optional"` // 佣金安全防御模式:true-冻结模式,false-直接结算模式 } - // 更新系统配置响应 AdminUpdateSystemConfigResp { Success bool `json:"success"` // 是否成功 } - // 获取系统配置响应 AdminGetSystemConfigResp { CommissionSafeMode bool `json:"commission_safe_mode"` // 佣金安全防御模式 } - // 代理钱包流水分页查询请求 AdminGetAgentWalletTransactionListReq { - Page int64 `form:"page"` // 页码 - PageSize int64 `form:"pageSize"` // 每页数量 - AgentId int64 `form:"agent_id"` // 代理ID - TransactionType *string `form:"transaction_type,optional"` // 交易类型(可选) - CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始(可选) - CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束(可选) + Page int64 `form:"page"` // 页码 + PageSize int64 `form:"pageSize"` // 每页数量 + AgentId int64 `form:"agent_id"` // 代理ID + TransactionType *string `form:"transaction_type,optional"` // 交易类型(可选) + CreateTimeStart *string `form:"create_time_start,optional"` // 创建时间开始(可选) + CreateTimeEnd *string `form:"create_time_end,optional"` // 创建时间结束(可选) } - // 代理钱包流水列表项 AgentWalletTransactionListItem { - Id int64 `json:"id"` // 主键 - AgentId int64 `json:"agent_id"` // 代理ID - TransactionType string `json:"transaction_type"` // 交易类型 - Amount float64 `json:"amount"` // 变动金额 - BalanceBefore float64 `json:"balance_before"` // 变动前余额 - BalanceAfter float64 `json:"balance_after"` // 变动后余额 + Id int64 `json:"id"` // 主键 + AgentId int64 `json:"agent_id"` // 代理ID + TransactionType string `json:"transaction_type"` // 交易类型 + Amount float64 `json:"amount"` // 变动金额 + BalanceBefore float64 `json:"balance_before"` // 变动前余额 + BalanceAfter float64 `json:"balance_after"` // 变动后余额 FrozenBalanceBefore float64 `json:"frozen_balance_before"` // 变动前冻结余额 - FrozenBalanceAfter float64 `json:"frozen_balance_after"` // 变动后冻结余额 - TransactionId *string `json:"transaction_id"` // 关联交易ID - RelatedUserId *int64 `json:"related_user_id"` // 关联用户ID - Remark *string `json:"remark"` // 备注说明 - CreateTime string `json:"create_time"` // 创建时间 + FrozenBalanceAfter float64 `json:"frozen_balance_after"` // 变动后冻结余额 + TransactionId *string `json:"transaction_id"` // 关联交易ID + RelatedUserId *int64 `json:"related_user_id"` // 关联用户ID + Remark *string `json:"remark"` // 备注说明 + CreateTime string `json:"create_time"` // 创建时间 } - // 代理钱包流水分页查询响应 AdminGetAgentWalletTransactionListResp { - Total int64 `json:"total"` // 总数 - Items []AgentWalletTransactionListItem `json:"items"` // 列表数据 + Total int64 `json:"total"` // 总数 + Items []AgentWalletTransactionListItem `json:"items"` // 列表数据 } +) -) \ No newline at end of file diff --git a/app/main/api/desc/front/agent.api b/app/main/api/desc/front/agent.api index 12ac05d..d877954 100644 --- a/app/main/api/desc/front/agent.api +++ b/app/main/api/desc/front/agent.api @@ -326,12 +326,12 @@ type ( SubWithdrawReward float64 `json:"sub_withdraw_reward"` } Commission { - OrderId string `json:"order_id"` // 订单号 + OrderId string `json:"order_id"` // 订单号 ProductName string `json:"product_name"` - Amount float64 `json:"amount"` // 原始佣金金额 + Amount float64 `json:"amount"` // 原始佣金金额 RefundedAmount float64 `json:"refunded_amount"` // 已退款佣金金额 - NetAmount float64 `json:"net_amount"` // 剩余净佣金金额 = amount - refunded_amount - Status int64 `json:"status"` // 状态:0-已结算,1-冻结中,2-已退款 + NetAmount float64 `json:"net_amount"` // 剩余净佣金金额 = amount - refunded_amount + Status int64 `json:"status"` // 状态:0-已结算,1-冻结中,2-已退款 CreateTime string `json:"create_time"` QueryParams map[string]interface{} `json:"query_params,omitempty"` } @@ -363,6 +363,7 @@ type ( Remark string `json:"remark"` payeeAccount string `json:"payee_account"` CreateTime string `json:"create_time"` + TaxRate float64 `json:"tax_rate"` // 扣税比例,如 0.06 表示 6% } GetWithdrawalReq { Page int64 `form:"page"` // 页码 @@ -399,17 +400,17 @@ type ( // 银行卡提现申请请求 BankCardWithdrawalReq { BankCardNo string `json:"bank_card_no"` // 银行卡号 - BankName string `json:"bank_name"` // 开户支行 - Amount float64 `json:"amount"` // 提现金额 + BankName string `json:"bank_name"` // 开户支行 + Amount float64 `json:"amount"` // 提现金额 } // 获取历史银行卡信息请求 - GetBankCardInfoReq {} + GetBankCardInfoReq {} // 获取历史银行卡信息响应 GetBankCardInfoResp { BankCardNo string `json:"bank_card_no"` // 银行卡号 - BankName string `json:"bank_name"` // 开户支行 - PayeeName string `json:"payee_name"` // 收款人姓名 - IdCard string `json:"id_card"` // 身份证号 + BankName string `json:"bank_name"` // 开户支行 + PayeeName string `json:"payee_name"` // 收款人姓名 + IdCard string `json:"id_card"` // 身份证号 } ) diff --git a/app/main/api/internal/logic/admin_agent/admingetagentwithdrawallistlogic.go b/app/main/api/internal/logic/admin_agent/admingetagentwithdrawallistlogic.go index 6c286e4..dda2b65 100644 --- a/app/main/api/internal/logic/admin_agent/admingetagentwithdrawallistlogic.go +++ b/app/main/api/internal/logic/admin_agent/admingetagentwithdrawallistlogic.go @@ -65,6 +65,11 @@ func (l *AdminGetAgentWithdrawalListLogic) AdminGetAgentWithdrawalList(req *type item.PayeeName = v.PayeeName.String } + // 从扣税记录中取扣税比例 + taxModel, taxErr := l.svcCtx.AgentWithdrawalTaxModel.FindOneByWithdrawalId(l.ctx, v.Id) + if taxErr == nil { + item.TaxRate = taxModel.TaxRate + } items = append(items, item) } resp = &types.AdminGetAgentWithdrawalListResp{ diff --git a/app/main/api/internal/logic/admin_agent/adminreviewbankcardwithdrawallogic.go b/app/main/api/internal/logic/admin_agent/adminreviewbankcardwithdrawallogic.go index 027f116..bfb643d 100644 --- a/app/main/api/internal/logic/admin_agent/adminreviewbankcardwithdrawallogic.go +++ b/app/main/api/internal/logic/admin_agent/adminreviewbankcardwithdrawallogic.go @@ -48,7 +48,6 @@ func NewAdminReviewBankCardWithdrawalLogic(ctx context.Context, svcCtx *svc.Serv svcCtx: svcCtx, } } - func (l *AdminReviewBankCardWithdrawalLogic) AdminReviewBankCardWithdrawal(req *types.AdminReviewBankCardWithdrawalReq) (resp *types.AdminReviewBankCardWithdrawalResp, err error) { // 验证操作类型 if req.Action != ReviewActionApprove && req.Action != ReviewActionReject { @@ -85,9 +84,18 @@ func (l *AdminReviewBankCardWithdrawalLogic) AdminReviewBankCardWithdrawal(req * return errors.Wrapf(xerr.NewErrMsg("提现类型不正确"), "提现类型验证失败") } + // 确认时使用的扣税比例:请求中传入则用传入值,否则默认 6% + taxRate := 0.06 + if req.Action == ReviewActionApprove && req.TaxRate != nil { + taxRate = *req.TaxRate + if taxRate < 0 || taxRate > 1 { + return errors.Wrapf(xerr.NewErrMsg("扣税比例必须在 0~100% 之间"), "扣税比例验证失败") + } + } + if req.Action == ReviewActionApprove { - // 确认提现 - return l.approveWithdrawal(ctx, session, record) + // 确认提现(可带自定义扣税比例) + return l.approveWithdrawal(ctx, session, record, taxRate) } else { // 拒绝提现 return l.rejectWithdrawal(ctx, session, record, req.Remark) @@ -102,11 +110,15 @@ func (l *AdminReviewBankCardWithdrawalLogic) AdminReviewBankCardWithdrawal(req * return resp, nil } -// 确认提现 -func (l *AdminReviewBankCardWithdrawalLogic) approveWithdrawal(ctx context.Context, session sqlx.Session, record *model.AgentWithdrawal) error { +// 确认提现(taxRate 为扣税比例,如 0.06 表示 6%) +func (l *AdminReviewBankCardWithdrawalLogic) approveWithdrawal(ctx context.Context, session sqlx.Session, record *model.AgentWithdrawal, taxRate float64) error { + // 按审核时选择的扣税比例重新计算并更新提现记录与扣税记录 + if err := l.applyReviewTaxRate(ctx, session, record, taxRate); err != nil { + return err + } // 根据提现类型执行不同的操作 if record.WithdrawType == WithdrawTypeAlipay { - // 支付宝提现:先调用支付宝转账接口 + // 支付宝提现:按更新后的实际到账金额调用支付宝转账 return l.approveAlipayWithdrawal(ctx, session, record) } else { // 银行卡提现:直接更新状态为成功(线下转账) @@ -114,6 +126,31 @@ func (l *AdminReviewBankCardWithdrawalLogic) approveWithdrawal(ctx context.Conte } } +// applyReviewTaxRate 按审核时选择的扣税比例更新提现记录与扣税记录 +func (l *AdminReviewBankCardWithdrawalLogic) applyReviewTaxRate(ctx context.Context, session sqlx.Session, record *model.AgentWithdrawal, taxRate float64) error { + newTaxAmount := record.Amount * taxRate + newActualAmount := record.Amount - newTaxAmount + + record.TaxAmount = newTaxAmount + record.ActualAmount = newActualAmount + if _, err := l.svcCtx.AgentWithdrawalModel.Update(ctx, session, record); err != nil { + return errors.Wrapf(xerr.NewErrCode(xerr.DB_ERROR), "更新提现记录扣税金额失败: %v", err) + } + + taxModel, err := l.svcCtx.AgentWithdrawalTaxModel.FindOneByWithdrawalId(ctx, record.Id) + if err != nil { + return errors.Wrapf(xerr.NewErrCode(xerr.DB_ERROR), "查询扣税记录失败: %v", err) + } + taxModel.TaxRate = taxRate + taxModel.TaxAmount = newTaxAmount + taxModel.ActualAmount = newActualAmount + taxModel.TaxableAmount = record.Amount + if err := l.svcCtx.AgentWithdrawalTaxModel.UpdateWithVersion(ctx, session, taxModel); err != nil { + return errors.Wrapf(xerr.NewErrCode(xerr.DB_ERROR), "更新扣税记录失败: %v", err) + } + return nil +} + // 确认支付宝提现 func (l *AdminReviewBankCardWithdrawalLogic) approveAlipayWithdrawal(ctx context.Context, session sqlx.Session, record *model.AgentWithdrawal) error { // 同步调用支付宝转账 diff --git a/app/main/api/internal/logic/agent/getagentwithdrawallogic.go b/app/main/api/internal/logic/agent/getagentwithdrawallogic.go index e306b15..854653d 100644 --- a/app/main/api/internal/logic/agent/getagentwithdrawallogic.go +++ b/app/main/api/internal/logic/agent/getagentwithdrawallogic.go @@ -56,6 +56,11 @@ func (l *GetAgentWithdrawalLogic) GetAgentWithdrawal(req *types.GetWithdrawalReq return nil, errors.Wrapf(xerr.NewErrCode(xerr.SERVER_COMMON_ERROR), "获取代理提现列表, %v", err) } withdrawal.CreateTime = agentWithdrawalModel.CreateTime.Format("2006-01-02 15:04:05") + // 从扣税记录中取扣税比例,供前端展示“扣了几个点” + taxModel, taxErr := l.svcCtx.AgentWithdrawalTaxModel.FindOneByWithdrawalId(l.ctx, agentWithdrawalModel.Id) + if taxErr == nil { + withdrawal.TaxRate = taxModel.TaxRate + } list = append(list, withdrawal) } } diff --git a/app/main/api/internal/types/types.go b/app/main/api/internal/types/types.go index d7db89b..52cacd9 100644 --- a/app/main/api/internal/types/types.go +++ b/app/main/api/internal/types/types.go @@ -808,9 +808,10 @@ type AdminRetryAgentProcessResp struct { } type AdminReviewBankCardWithdrawalReq struct { - WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID - Action int64 `json:"action"` // 操作:1-确认,2-拒绝 - Remark string `json:"remark"` // 备注(拒绝时必填) + WithdrawalId int64 `json:"withdrawal_id"` // 提现记录ID + Action int64 `json:"action"` // 操作:1-确认,2-拒绝 + Remark string `json:"remark"` // 备注(拒绝时必填) + TaxRate *float64 `json:"tax_rate,optional"` // 扣税比例,如 0.06 表示 6%,不传则默认 6% } type AdminReviewBankCardWithdrawalResp struct { @@ -1300,6 +1301,7 @@ type AgentWithdrawalListItem struct { Amount float64 `json:"amount"` // 金额 ActualAmount float64 `json:"actual_amount"` // 实际到账金额(扣税后) TaxAmount float64 `json:"tax_amount"` // 扣税金额 + TaxRate float64 `json:"tax_rate"` // 扣税比例,如 0.06 表示 6% Status int64 `json:"status"` // 状态 PayeeAccount string `json:"payee_account"` // 收款账户 Remark string `json:"remark"` // 备注 @@ -2198,6 +2200,7 @@ type Withdrawal struct { Remark string `json:"remark"` PayeeAccount string `json:"payee_account"` CreateTime string `json:"create_time"` + TaxRate float64 `json:"tax_rate"` // 扣税比例,如 0.06 表示 6% } type WithdrawalReq struct {