源码系统概览
文章正文
总裁发卡系统商户版是一款基于 Laravel 12 的多商户数字卡密自动发卡平台 PHP 源码免费下载版本。
后端 Laravel 12 + Sanctum，前端 Vue 3 + Naive UI，前后端一套装，部署到宝塔后访问 /install 跟着向导走完就能上线。
多商户入驻、卡密自动发货、多支付通道收款、自动提现、代理分销、渠道费率分组这些都做完了，不用自己再写一遍。
源码简介
项目由总裁发卡系统官方团队维护（系统官网 ceowl.cn），composer.json 声明的开源协议是 MIT，前端 npm 包名是 whale-card-v2。
后端跑 PHP 8.2 加 Laravel 12，对外全是 RESTful 接口；前端用 Vue 3.5 + Vite 7 + TypeScript 5.7 加 Naive UI 2.41 拼出来一个单页应用。
数据库用 MySQL 5.7 以上，鉴权走 Laravel Sanctum，把管理员、商户、买家三套身份隔开。
多店铺靠二级域名落地，路由里有一段 App\Support\ShopDomain::resolveShopId，会按访问的 Host 自动把店铺 ID 注入前端。
核心数据：
- 数据库默认 60+ 张表，覆盖商品、卡密、订单、支付、分销、对账等业务域
- 后端 30 多个 B 前缀 API 控制器，覆盖 BGoods / BOrder / BFinance / BSeller / BPlugin / BConfig 等模块
- 每日 02:00 自动备份数据库（routes/console.php 中 Schedule::command(‘bak:auto’)->dailyAt(’02:00′)）
- 多套支付通道插件：airpayx、codepay、paysafe、custompay、merchantauth 即插即用
- 鉴权三角色：管理员（system_user 表）、商户（user 表）、买家
和独角数卡（Faka）、ZFAKA 这类同类单商户轻量发卡项目相比，这套源码在多商户运营这件事上做了更细的封装：
| 维度 | 同类单商户项目（独角数卡 / ZFAKA） | 总裁发卡系统商户版（本源码） |
|---|---|---|
| 定位 | 单商户轻量发卡 | 多商户运营级发卡商城 |
| 鉴权 | 单角色后台 | 管理员 + 商户 + 买家三角色（Sanctum Token 隔离） |
| 商户体系 | 通常单店铺 | 多商户 + 二级域名独立店铺（ShopDomain::resolveShopId） |
| 代理分销 | 基础 | 完善：invite_code + plugin_ambassador + agent_key 三件套 |
| 数据库自动备份 | 通常需手动配置 | 每日 02:00 内置自动（Schedule::command(‘bak:auto’)） |
| 部署形态 | 传统 LNMP | 宝塔 + Laravel 伪静态 + Supervisor 队列常驻 |
适用场景
把这套源码用在哪些业务上比较顺手，几个典型场景列一下。
软件序列号、点卡、会员账号、课程兑换码这类数字卡密和虚拟商品的自动售卖。
游戏点卡、话费充值卡的多商户分销，不同渠道走不同结算费率。
软件序列号和许可证密匙的批量销售，配合卡密导入和库存管理就能跑批量。
多店铺联盟发卡商城，每个店铺一个二级域名方便做品牌运营。
代理分销和渠道返佣，invite_code、agent_key、rate_group_rule 三张表把多级分销串起来。
功能亮点
管理员在 system_user 表，商户在 user 表，鉴权靠 Sanctum Token 隔离，三类身份互不串。
goods、goods_card、goods_category、goods_pool 四张表撑住自动发货和多库存策略。
支付通道插件化，cash_channel、cash_channel_account、plugin_airpayx、plugin_codepay、plugin_paysafe、plugin_custompay、plugin_merchantauth 几个插件即插即用。
下单、取卡、查询、回调走 order、order_master、order_card、order_api、order_query_history 五张表，整个订单链路不漏环节。
提现对账靠 finance_fee、rate、rate_group、rate_group_rule 按渠道和分组配费率，后台 BBak.php 提供一键备份和恢复。
代理分销由 plugin_ambassador、invite_code、agent_key 三个模块搭起来，邀请码、代理商品、渠道返佣三件套齐全。
PC 和移动两套主题，商户在店铺设置里能独立切换 pc_template 和 pay_theme_mobile。
后台模块铺得开，30 多个 B 前缀的 API 控制器覆盖 BAdminUser、BGoods、BOrder、BFinance、BSeller、BPlugin、BConfig 等业务域。
技术架构与部署指南
技术栈与运行环境
前端：Vue 3.5 + Vite 7 + TypeScript 5.7 + Naive UI 2.41 + Pinia 3.0 + Vue Router 4.5
后端：PHP 8.2+ · Laravel 12 · Laravel Sanctum 4.3 · Laravel Tinker 2.10
数据库：MySQL 5.7+（默认 60+ 张表，含 goods / order / cash / plugin_* / system_* 等）
运行环境：Linux（推荐）或 Windows · Nginx（推荐）或 Apache · PHP 8.2 需启用 pdo_mysql / mbstring / openssl / fileinfo / curl / gd / tokenizer 扩展
其他依赖：Node.js 18+（仅构建前端时需要）· Composer 2 · Supervisor（队列常驻）· 可选 Redis 缓存
安装与部署提示
源码包已经带好 vendor 依赖和编译好的 public/build 前端产物，不用手动跑 composer install，也不用 npm run build。
把安装包上传到服务器站点目录，比如 /www/wwwroot/zongcai，解压。
宝塔新建站点，PHP 选 8.2 及以上，网站目录指向 public 子目录，运行目录选 /public。
伪静态必配，Nginx 在站点配置里选 laravel 模板，或者直接贴下面这段：
location / { try_files $uri $uri/ /index.php?$query_string; }
宝塔数据库页面新建一个 MySQL 库，把库名、用户名、密码记下来。
浏览器打开 http://你的域名/install ，按向导填数据库信息、站点信息、管理员账号，点开始安装。
装完之后 storage 和 bootstrap/cache 这两个目录要给运行用户 www 写权限，建议 755/775，否则容易白屏。
上线前把 APP_DEBUG 关掉，重新生成一组 APP_KEY，把 SESSION_DRIVER 和 CACHE_STORE 都设成 database，避免文件会话在某些中文路径下报错。
定时任务在宝塔计划任务里加一条每分钟跑一次的 shell：cd /www/wwwroot/zongcai && php artisan schedule:run >> /dev/null 2>&1，这样每日 02:00 的自动备份就生效了。
截图与演示说明
商城首页是多商户自助发卡平台的主视觉，顶部导航、商品分类入口、热门店铺推荐、公告滚动区都摆好了。
商户登录是商户端登录表单，图形验证码、记住登录、找回密码三个入口都齐。
后台数据看板是平台概览和营收对账视图，订单数、营收额、待处理投诉、新增商户几块关键指标卡都能看到。
商品列表是多店铺商品和卡密管理视图，可以按店铺、分类、库存、上架状态筛选，也能批量操作。
装完之后访问 /admin 进管理后台，访问 /seller 进商户中心，访问 /shop/{subdomain} 进二级域名店铺。
常见问题
问：这套总裁发卡系统商户版是免费开源的吗？
开源版源码免费下载，composer.json 里写的是 MIT 协议，自建发卡商城和二次开发都允许，不用交授权费。
问：装完之后首页 404 或者打不开怎么办？
十有八九是 Nginx 伪静态没配对，去宝塔站点设置 → 伪静态选 laravel，或者把 try_files 那段贴进去保存。
问：打开页面是空白或者 500 报错？
先看 PHP 是不是 8.2 及以上，pdo_mysql、mbstring、openssl、fileinfo、curl、gd、tokenizer 这几个扩展全开没，再看 storage 和 bootstrap/cache 能不能写。
问：登录后台提示没权限怎么解决？
用安装第 3 步填的超级管理员账号登，就有 system_user 角色全权限。密码忘了就 php artisan tinker 进去重置。
问：和独角数卡（Faka）、ZFAKA 这些同类项目有什么不一样？
这套源码主打多商户多店铺运营，独角数卡和 ZFAKA 更偏单商户轻量场景。多商户入驻、代理分销、渠道费率分组、每日自动备份这几块是它做得比较细的地方。
问：手机移动端能用吗？
PC 和移动双端自适应，商户能在店铺设置里独立切 pc_template 和 pay_theme_mobile 两套主题。
问：部署上线大概要多少成本？
源码本身免费下载；服务器建议 2 核 4G 起跑（同时跑 Nginx + PHP-FPM + 队列 + MySQL），宝塔环境下首年大约几百元；域名按年付几十元；短信和支付通道按调用量计费。
问：刚拿到源码怎么开始上手？
三步：本地解压后看 docs/deploy/DEPLOY.md 把环境对一遍；宝塔建站指向 public 并配 Laravel 伪静态；浏览器访问 /install 走完安装向导，之后用管理员账号登 /admin 验后台。
问：遇到技术问题去哪里找支持？
官方维护方在系统官网 ceowl.cn 提供文档与客服 QQ 群（README 末尾标注 3092059473 / 778080027），源码层面的二次开发可读 routes/、app/Http/Controllers/Api/ 下的 B 前缀控制器自审。
安全风险提示
路径：.env｜类型：配置文件｜证据：安装包根目录带了 .env 而不是只带 .env.example｜建议：部署前先删掉包内 .env，按 .env.example 重新生成，APP_KEY、数据库密码、Sanctum 密钥都换成长随机串。
扫了一遍 app/ 下面的代码，没找到 eval、base64_decode、shell_exec、exec、passthru、system 这类高危 PHP 函数调用（vendor 目录没扫），也没看到明显的混淆或后门代码。不过上线前还是建议把 app/Http/Controllers/Api 下面 B 前缀的控制器人工过一遍，重点看 BPayGateway、BPlugin、BAuth 这三类支付和鉴权文件。
系统带多商户发卡、支付通道、自动提现这些资金相关能力，部署上线前要把 PCI 相关合规检查做完，HTTPS 配好，WAF 打开，再接一套风控和反欺诈规则。
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
这份安装包是完整版，依赖和前端产物都打好了，按上面的部署步骤一小时左右能跑起来。
系统涉及虚拟商品售卖、支付通道接入、资金提现这些敏感业务能力，请严格遵守所在地区法律法规和第三方支付平台的合规要求，不要拿去做违法违规的事。
原文：https://www.xkwo.com/thread-30916-1-1.html
最后更新：2026-08-23
