分销推广

分销推广用于维护分销员、绑定关系、推广订单、佣金记录和提现。RuoYi Office 当前管理端包含分销用户、佣金记录和提现审核等页面。

模块边界

能力	管理端路径	API
分销用户	trade/brokerage/user	/trade/brokerage-user/*
佣金记录	trade/brokerage/record	/trade/brokerage-record/*
提现管理	trade/brokerage/withdraw	/trade/brokerage-withdraw/*

分销链路

管理端能力

分销用户页支持创建分销员、启停分销、修改绑定关系和查看下级/推广订单；佣金记录页用于追踪佣金来源；提现页用于处理分销员提现申请。

二次开发建议

• 佣金结算应以订单完成或售后结束后的稳定状态为准。
• 推广关系变更要有操作记录，避免佣金归属争议。
• 提现属于资金动作，建议结合 Pay 转账、财务审核和操作日志。
• 分销比例、冻结期、提现门槛应集中在交易配置中维护。

排查清单

现象	优先检查
没有生成佣金	分销关系、订单状态、商品是否参与分销
佣金金额不对	一级/二级比例、订单实付金额、退款扣减
不能提现	余额、冻结期、提现门槛、账号信息
打款失败	Pay 转账配置、收款账号、渠道错误信息