自动发卡系统 · 开发文档 - 开发文档

自动发卡系统 · 开发文档

一、技术架构

框架：ThinkPHP 5 系（内核 framework/）+ Composer 依赖（zoujingli/wechat-php-sdk 微信模块、5ini99/think-addons 插件机制、jeremykendall/php-domain-parser 域名解析）；PHP 7.2~8.0（推荐 7.4）/ MySQL 5.6+；
应用目录：application/ 下分前台与 application/admin（后台，12 个控制器）；入口 public/index.php；
插件化：addons/ 目录 + think-addons，插件在后台「插件管理」里安装启用；支付通道、店铺装修、任务分润等都以插件形式存在（对应库里 plugin_* 表）；
支付：plugin_airpayx / plugin_codepay_* / plugin_cross* / plugin_custompay_* 等多套通道插件，通道账号表 channel / channel_account / cash_channel。

二、目录结构

程序根/
├── public/index.php      # Web 入口（public 为站点根）
├── application/          # ThinkPHP 应用
│   ├── admin/            # 后台（controller / model / view）
│   ├── api/  index/      # 接口与前台（按版本随包附带）
│   └── ...               # 公共模块
├── addons/               # 插件目录（think-addons 机制）
├── extend/               # 扩展：Aliyun（阿里云短信/OSS）、HTMLPurifier、
│                         #   aop（AOP 切面）、captcha、hook、Util、controller
├── framework/            # ThinkPHP5 内核
├── vendor/               # Composer 依赖
├── upgrade/              # 版本升级脚本目录
├── runtime/              # 运行缓存（要可写）
├── xj_license_client.php / xj_license_store.php   # 授权客户端
└── xj_panel.php          # 授权验证 / 在线更新维护页

三、数据库

共 89 张表，业务表直接以业务名命名（可在安装时统一加前缀）：goods / goods_card / goods_category / goods_coupon / order / order_card / order_master / user / merchant_log / cash（提现）等；
系统表：system_user（后台账号）/ system_menu / system_node / system_auth / system_auth_node / system_config / system_log（后台权限与配置）；
插件表：plugin（插件注册）+ 每个插件自己的 plugin_xxx 表；
微信模块：wechat_fans / wechat_keys / wechat_menu / wechat_news*；
风控与信誉：user_risk / user_rate / rate_group* / user_login_error_log / verify_error_log。

四、关键机制

4.1 卡密（自动发货）

商品卡存放在 goods_card（卡密池 goods_pool / goods_pool_span），订单 order 支付成功后由系统自动取卡写 order_card。改发货逻辑找 application/ 下订单相关 model/逻辑，不要直接改表。

4.2 支付通道插件

每个通道一个插件（对应库里 plugin_airpayx / plugin_codepay_* / plugin_custompay_* 等表），账号与费率配置在 channel_account / cash_channel_account。新增通道 = 照 addons/ 下现有插件结构复制一份，改回调地址与验签，再在后台插件管理里启用。

4.3 商户与分润

多商户体系：user（商户/用户）+ user_proxy（代理）+ merchant_log（商户流水）+ cash（提现）。

五、二次开发指引

加后台菜单：在 system_menu / system_node 登记（后台「权限管理」里可视化加），控制器放 application/admin/controller/，模板放 application/admin/view/；
加插件：照 addons/ 下现有插件结构（info.php + 控制器 + 方法），装完在后台启用；
改主题：前台模板在 application/ 对应模块 view 下，商品详情/列表分别对应各自模板；
注意：xj_license_client.php / xj_license_store.php / xj_panel.php 属授权链路，别删改；upgrade/ 是升级脚本目录，在线更新会依次执行。

六、授权与在线更新

后台与前台模板都在程序包内加密分发（授权壳），xj_panel.php 支持「验证授权 / 在线更新」。二开后如需更新，先用 xj_panel.php 里的备份功能或手动备份改过的文件（更新会覆盖程序文件、保留 data/ 与上传目录）。

← 返回文档列表