开发文档

一、技术架构

• 框架：ThinkPHP 5（内核在 thinkphp/，非 Composer 版），入口文件为根目录各功能入口 + index.php；PHP 7.0~8.0（建议 7.4），MySQL 5.6+；
• 多站点形态：同一套代码跑三种角色 —— 总站（application/website）、分站（application/substation）、分销商（application/fenxiao），角色由域名 / 入口文件区分；
• 三套模板目录：template/website（总站）、template/substation（分站）、template/fenxiao（分销），后台用 template/layuiadmin；
• 授权模块：application/website/controller/License.php + config/extra/license.php 承担授权验证（程序包是加密壳分发，二开时这三个文件 + Update.php、config/extra/web.php 别改结构）。

二、目录结构

程序根/
├── index.php             # 主入口
├── group.php             # 进群落地页入口
├── fenxiao.php           # 分销入口
├── substation.php        # 分站入口
├── notify.php / notifysc.php / notifyzfb.php   # 支付回调（易支付/微信/支付宝）
├── qrcode.php            # 二维码生成
├── application/          # 应用目录
│   ├── website/          # 总站（controller / model / view / behavior）
│   ├── substation/       # 分站
│   ├── fenxiao/          # 分销
│   └── common.php        # 公共函数
├── config/               # 配置（database.php、route.php、extra/ 下 web/license/update 等）
├── extend/               # 扩展类（Auth 权限、Navigat 导航、paylist 支付、phpqrcode）
├── template/             # 模板（website / substation / fenxiao / layuiadmin）
├── ueditor/              # 富文本编辑器
├── upload/               # 上传目录（要可写）
├── install/              # 安装向导（装完请删除）
└── xj_panel.php          # 授权验证 / 在线更新维护页

三、数据库

• 表前缀 web_，共 25 张表（随包含 fufeijinqun_full.sql）；
• 后台权限：web_auth_group / web_auth_group_access / web_auth_rule（TP5 标准 auth 三件套）；
• 业务核心：web_wxgroup / web_wxgroup_tmp / web_qwxgroup（微信群与群素材）、web_dianka / web_dianka_log（点卡/卡密）、web_bill（账单）、web_chouyong（抽佣）、web_paylist（支付通道）、web_setup（全局设置）、web_license（授权）；
• 分销体系：web_distribution / web_distribution_group / web_distribution_tixian（分销商 / 分销分组 / 提现）。

四、关键机制

4.1 总站 / 分站 / 分销三形态

三套控制器互不干扰，分站与分销的数据都挂在总站群主账号下（web_substation 记录归属）。做二开时先确定你要改哪一层：只改总站模板不会影响分站，反之同理。

4.2 支付

回调入口是根目录三个 notify 文件（易支付 / 微信 / 支付宝），支付渠道配置在后台「系统设置 → 支付设置」；二开接第三方支付时，照 notify.php 的验签 + 改单 + 入账写法补一个回调文件即可。

4.3 模板

模板变量由控制器 assign() 后 fetch()，模板里用 {$var} 输出；公共头尾分别在 template/website/head.html / foot.html。

五、二次开发指引

• 加一个前台页面：在 application/website/controller/ 建控制器方法 → 在 template/website/ 建同名模板 → 路由（config/route.php）按需配置；
• 加一个后台菜单：后台菜单存在 web_auth_rule 表（后台「系统设置 → 权限管理」里可视化添加），加完给对应管理员组勾权限即可；
• 改表结构：直接改库 + 在 application/ 里改对应 Model（TP5 模型名与表名去掉前缀后一致）；
• 新增支付通道：参考 extend/paylist/ 下现成通道类，新增一个类 + 后台注册；
• 注意：application/website/controller/License.php、Update.php、config/extra/license.php、config/extra/update.php、application/common.php 属于授权链路文件，改坏会导致「后台打不开 / 在线更新失效」。

六、授权与在线更新

程序包带星聚授权验证：xj_panel.php（维护页）可「验证授权 / 在线更新」，config/extra/license.php 里存授权码与绑定域名。二开时：① 不要删除/改名 xj_panel.php；② 在线更新会覆盖除 config/、upload/ 等数据目录外的程序文件，改过核心文件请先备份。