Sushi SaaS 推荐奖励的工作方式

Sushi SaaS 提供的是可选推荐实现，而不是开箱即用的联盟营销业务。功能默认关闭；内置流程只记录待审核佣金，绝不会自动转账或发放积分。

从分享链接到归因

登录用户可通过 /api/affiliate/invite-code 创建八位邀请码。访问 /i/abc12345 形式的链接时，系统查找邀请者，把其 UUID 写入有效期 30 天的 ref cookie，然后跳转到首页。

共享的 theme provider 会自动挂载 AffiliateInit。推荐功能启用后，它在客户端调用 captureAffiliateAttribution()，向 /api/affiliate/update-invite 发起请求。该接口要求有效 session，并读取 ref cookie。成功后会在当前浏览器标签页的 sessionStorage 中写入标记；若调用失败，包括登录前的调用，则不写标记，之后再次挂载时可以重试。默认采用首次触达：若两个请求竞争，由条件数据库更新决定唯一结果。系统拒绝自我推荐，并通过唯一 signup 记录保证重试安全。

行为由 7580470 的 src/config/affiliate.ts配置，并由 src/services/affiliate.ts编排。

付费订单之后

启用后，一个已支付订单只会创建一条 pending 佣金。示例配置取 5,000 个最小货币单位（USD 下为 50 美元）与订单金额 20% 中较大的数值。paid_order_no 上的部分唯一索引能阻止两个 webhook worker 重复记录奖励。

退款或取消可以取消仍处于 pending 的奖励。完成打款被刻意留在自动资金链路之外：运营人员在管理后台审核，采用者自行接入 payout provider 与合规流程。

启用前的工作

1. 明确币种、比例、归因窗口与资格政策。
2. 决定身份验证、税务资料、欺诈审核与打款状态流程。
3. 替换示例奖励值，完整政策就绪前保持 enabled 为 false。
4. 测试链接访问、并发归因、Stripe webhook 重放、取消与后台审核。

推荐记录依赖可靠订单处理。先配置 Stripe 计费，再通过管理后台页面与操作了解审核界面。