立项原因：传统CPS返利/淘客系统多为单租户，难以支持多团队、多品牌独立运营；推广关系、点击与订单归因容易断链，佣金返利规则复杂，结算提现与财务对账依赖人工，租户数据隔离和权限安全也难以保障。该系统旨在解决多租户SaaS化运营、一级分销关系绑定、CPS订单自动同步归因、佣金/返利自动计算、冻结结算、提现审核和对账报表等问题。
行业场景与业务背景：适用于淘客导购、私域社群分销、社交电商、联盟营销、MCN、返利平台、企业内购及SaaS服务商。平台创建租户并配置CPS渠道和佣金规则，租户发展推广者，推广者分享商品链接/淘口令，用户下单后系统同步订单、归因并计算平台佣金、租户分成、推广者佣金和用户返利，最终完成结算提现与对账。
本系统是一套多租户SaaS化CPS返利平台，主要功能模块及描述如下：
多租户管理：租户开通、套餐配置、独立后台、数据隔离、角色权限分配。
用户与推广者：注册登录、实名认证、推广身份、邀请绑定、一级分销关系、收益账户。
商品与推广：CPS商品库、选品、优惠券、推广链接、二维码、淘口令、海报生成。
订单与归因：对接淘宝客/联盟订单接口，同步订单，记录点击，归因绑定，处理退款与失效。
佣金与返利：佣金规则、返利比例、平台/租户/推广者/用户分佣、冻结与解冻。
结算提现：收益明细、结算周期、提现申请、审核打款、状态跟踪。
财务对账：平台佣金、租户分成、推广者佣金、返利明细、对账报表。
系统管理：角色权限、操作日志、消息通知、API对接、数据看板。
主要功能路径：平台创建租户 → 配置CPS渠道与佣金规则 → 推广者注册并生成推广链接 → 用户点击下单 → 系统同步订单并归因 → 计算佣金与返利 → 返利冻结 → 确认收货/过售后期后解冻 → 推广者申请提现 → 审核打款 → 财务对账统计。
我独立完成需求分析、技术选型、架构设计、数据库设计、前后端开发、淘宝客/联盟API对接、测试部署与上线运维。前端采用 Vue3 + Element Plus，实现平台后台、租户后台、推广者中心及H5页面；Node.js 负责BFF接口聚合、任务调度和部分异步处理；Java Spring Boot 承载租户、用户、商品、订单、归因、佣金、返利、结算、提现、对账等核心服务；MySQL 存储业务数据，Redis 做缓存与分布式锁，RabbitMQ 处理订单同步、佣金计算、消息通知等异步任务；Nginx + Docker + CI/CD 完成部署。
架构与实现亮点：采用多租户SaaS架构，通过 tenant_id + 权限拦截器实现数据隔离，支持租户独立配置佣金与返利规则；一级分销通过邀请码/邀请链接绑定唯一上级，记录绑定时间与状态，防止关系篡改；CPS归因以 click_id、推广位、淘口令为链路，订单同步后按归因窗口匹配推广者，处理退款、失效与重复订单；佣金返利采用规则快照 + 状态机，支持平台、租户、推广者、用户多方分佣，以及冻结、解冻、结算、提现审核、打款、对账全流程；关键操作做幂等、分布式锁和异步重试。
难点：多租户数据隔离与权限、订单延迟/退款导致归因和佣金冲正、一级关系绑定防篡改、佣金并发一致性、财务对账差异处理。
评论