美团联盟CPS分销系统前后端完整源码下载与搭建教程
源码介绍
这套“前后端完整”到底完整在哪
外卖CPS源码在资源站流传时,经常出现一种情况:前端uniapp工程给了,后台登录页也有,但真正处理订单回传、佣金计算和分销关系绑定的后端逻辑是空的。用户能注册、能领红包,但订单完成后佣金不入账,分销关系也串不起来。彩虹源码网(www.yuanmaz.com)这次整理的美团联盟CPS分销系统,核心区别在于后端是完整的Laravel8应用,带数据库迁移和种子数据,不是只有接口壳子。从公开的GitHub项目结构可以看到,这套源码由两部分组成:前端waimai-cps-uniapp(uniapp工程,可一键导入HBuilderX)和后端waimai-cps-laravel8(Laravel8 + Vue管理后台)。两边是配套的,不是拼凑的。
CPS分销的钱是怎么转起来的
这套系统的业务链路可以拆成四步。第一步,用户领红包:用户在小程序或H5里点击美团/饿了么红包,系统调用联盟的取链接口,生成带utm_source和推广位标识的专属链接。第二步,用户下单:用户通过这个链接跳转到美团完成外卖下单并支付,美团联盟侧记录这笔订单与你的推广位关联。第三步,订单回传:系统通过美团分销联盟的CPS订单接口(OrdersCPSRequest)拉取订单数据,匹配到对应的推广用户和分销关系链。第四步,佣金结算:根据订单金额和预设的分佣比例,计算平台留存、直属上级佣金和更上级的佣金,写入结算记录,用户可提现到微信钱包。这套链路里,取链和订单回传是两个必须分别跑通的环节,取链不通用户下不了单,回传不通佣金不入账,任何一个断了,分销系统就是摆设。
分销体系的技术骨架:三级关系怎么存
分销返利的核心不是“分钱”这个动作,而是用户之间的邀请关系怎么在数据库里被准确记录和查询。同类CPS分销项目的标准设计是三张核心表。用户表(fenxiao_user)里除了常规的openid、昵称、手机号,关键字段是visit_code(分销邀请码)和user_type(普通用户/分销用户),邀请码用于在注册链接和小程序码中识别归属。用户邀请关系表(fenxiao_visit_relation)记录visit_user_id(邀请人)和visited_user_id(被邀请人)以及level(邀请等级),这是佣金向上追溯的依据。分销订单表则把平台订单ID、下单用户ID和推广人ID绑定在一起,确保每一笔佣金都能对应到具体的订单和推广者。三级分销(平台-A-B-C)的查询逻辑就是沿着关系表逐级向上,查两次就能拿到二级上级,而不是在用户表里存一个僵硬的“上级ID”。
前端和后台分别长什么样
前端是uniapp工程,编译目标包括微信小程序和H5。功能面上覆盖了这类系统该有的东西:红包领取入口、分销中心(我的下级、我的佣金)、推广海报生成(带专属邀请码的小程序码或H5链接)、返利提现入口和公众号推送模板配置。后台是Vue管理界面,挂在Laravel8后端下,用于管理用户、订单、分佣比例和提现审核。这套源码的定位是“可跑通分销闭环的基础系统”,它不包含美团的商户资质、联盟账号本身,也不包含商业级的风控和自动打款通道;提现到微信钱包需要你自己配置商户号和转账接口,源码里通常只预留了配置位和记录逻辑。
技术栈和部署形态
后端明确是PHP + Laravel8 + MySQL,前端是uniapp + Vue,管理后台也是Vue。这意味着它不能用虚拟主机随便丢上去跑,需要Composer安装依赖、执行数据库迁移、配置.env环境变量,并运行php artisan命令。服务器要求PHP 7.3+(Laravel8的兼容区间),MySQL 5.7+,Nginx或Apache均可。如果你之前只接触过ThinkPHP的整站源码,这套的部署方式和它不一样——它更像一个标准的Laravel Web应用,而不是“上传即用”的CMS。
流传版本和授权边界
这套源码在GitHub上有公开的MIT许可分支(master-start/waimai-cps-laravel8和wanghsh315/waimai-cps-uniapp),属于开源项目,作者标注“免费更新、不收费”。但流传到资源站后,可能存在被重新打包、植入后门或删减数据库迁移文件的版本。部署前重点检查app/和config/目录是否有来源不明的远程请求代码,.env.example是否完整。美团联盟的app_key和utm_source需要你自行注册分销联盟账号、签约入驻后获取,源码里不包含这些凭据。
源码展示:目录与关键配置位置
后端目录结构:Laravel8的标准骨架
后端是标准的Laravel8应用,目录结构包括app/(业务逻辑,含控制器、模型和分销计算逻辑)、config/(服务配置,美团联盟的app_key和utm_source通常放在config/services.php中读取环境变量)、database/migrations/(数据库迁移文件,建表靠它)、database/seeds/(种子数据,用于填充测试用户)、routes/(API路由)和.env(数据库连接及第三方凭据)。美团联盟的配置通过.env注入,典型字段是MEITUAN_PUB_UNION_APP_KEY和MEITUAN_PUB_UNION_UTM_SOURCE,对应SDK初始化时需要的两个参数。
前端工程和接口地址配置
uniapp前端导入HBuilderX后,第一件事是修改config.js(或类似的配置文件)中的后端接口URL,指向你部署好的Laravel8后端域名。如果后端还没跑起来,前端编译出来能打开页面,但登录和所有数据请求都会失败。前端工程里同时包含小程序和H5两套编译目标,分销海报生成、公众号推送等功能的模板配置需要在小程序后台和公众号后台分别完成,不是纯代码配置。
数据库迁移和种子数据
这套源码的建表方式不是导入SQL文件,而是通过php artisan migrate执行迁移。迁移文件里定义了用户表、邀请关系表、订单表、提现记录表等核心结构。种子数据用于填充测试用户和默认配置,执行php artisan db:seed --class=UserSeeder可以快速得到一个可登录的测试账号。如果迁移过程报错,通常是因为MySQL版本或字符集不匹配,先解决数据库环境问题,不要跳过迁移直接手动建表,否则字段和索引可能对不上。
搭建教程
1. 环境:PHP 7.3+ / MySQL 5.7+ / Composer
Laravel8的官方兼容区间是PHP 7.3及以上,推荐7.4。MySQL 5.7+,Nginx或Apache均可。服务器上必须安装Composer(PHP依赖管理器),这是和ThinkPHP整站源码最大的不同。宝塔面板可以安装Composer,也可以通过命令行装。数据库在宝塔中创建好,记下库名、用户名和密码。
2. 后端部署:从clone到migrate
后端源码上传到站点目录(或git clone)后,按以下顺序执行:
cp .env.example .env
composer install
php artisan key:generate然后编辑.env文件,填写数据库连接信息、小程序APPID和SECRET,以及美团联盟的app_key和utm_source。接着执行数据库迁移和种子:
php artisan migrate
php artisan db:seed --class=UserSeeder如果迁移报错,用php artisan migrate:reset回滚后检查.env中的数据库配置和MySQL版本。运行目录指向Laravel的public/,不是根目录,伪静态按Laravel规则配置(通常是将所有请求转发到index.php)。
3. 前端编译:uniapp改接口地址后运行
用HBuilderX导入uniapp工程,找到config.js或请求封装文件,把接口地址改成后端域名。然后选择编译到微信小程序或H5。小程序编译后需要在微信开发者工具中填入AppID,并在微信公众平台配置服务器域名(后端API域名)。如果前端能打开但登录失败,先确认接口地址没有写死为localhost,以及后端API路由是否正常响应。
4. 美团联盟配置和取链测试
在美团分销联盟后台注册账号、签约入驻、创建应用,拿到app_key和utm_source。填入后端的.env后,在后台或前端走一次红包领取流程,确认系统能调用取链接口并返回推广链接。取链成功是CPS链路的第一块里程碑,如果取链报错,先检查app_key是否有对应接口权限,以及签名参数是否完整。
5. 订单回传和分销佣金测试
订单回传依赖美团联盟的CPS订单接口。系统通常通过定时任务或手动触发拉取订单数据,匹配到对应的推广用户和分销关系。测试时可以用测试订单或模拟数据验证佣金计算逻辑:确认直属上级和更上级的佣金比例是否正确写入结算记录,平台留存是否按配置扣除。如果没有真实的联盟订单,至少走一遍数据库层面的分销关系绑定和佣金计算逻辑,确认关系表查询和金额计算没有报错。
6. 提现和公众号推送的配置位置
返利提现需要微信商户号和转账接口,源码里通常预留了配置项和提现记录表,但自动打款到零钱需要你自己开通商户号并配置API证书。公众号推送需要在公众号后台配置模板消息ID,并在系统后台填入对应的模板ID和推送触发条件。这两项不配置,系统核心功能仍然可用,但用户收不到提醒、提现只能停留在记录状态。
源码下载
🔥永久赞助9.9(高速下载/无广告/无转存)
✅网盘下载(下载限速/需要转存/有广告)
包里有什么,没什么
下载包通常包含Laravel8后端完整源码(含迁移和种子)、uniapp前端工程、Vue管理后台和.env.example配置模板。不包含美团联盟的账号资质、微信商户号、服务器和域名。这是一个开源项目,MIT许可,但商业使用前仍需确认美团联盟的服务条款和微信平台对小程序的类目要求。
部署前的准备清单
先在测试服务器完成composer install、数据库迁移和取链测试,确认后端API和前端能正常通信,再考虑正式环境。上线前修改.env中的默认配置、确认APP_DEBUG=false、扫描app/目录是否有可疑代码。分销返利涉及资金结算和用户数据,提现逻辑和佣金计算的准确性需要在测试环境充分验证后再上线。
免责声明:本文源码介绍与教程由彩虹源码网(www.yuanmaz.com)整理发布,仅供PHP和Laravel开发学习及合法CPS分销系统搭建参考。美团联盟CPS分销涉及平台推广政策和佣金结算规则,运营者须遵守美团联盟的服务协议及微信小程序平台规范。流传版本的安全性与功能完整性需自行审计,本文不构成对任何特定源码包可用性和安全性的保证。不得用于违规推广、虚假交易或未经许可的商业分发。
觉得内容不错?我要





