开发文档

一、技术架构

• 形态：原生 PHP（无框架）自助下单/自动发货系统，PHP 7.4（兼容 7.2~8.0）+ MySQL 5.6+；
• 开发边界（重要）：程序核心文件做了加密（index.php、登录/注册等关键入口是 eval 加密形态，改不动本体）—— 二次开发的正确姿势是：改模板 + 旁挂 PHP 文件 + 直接操作数据库，不要尝试改核心文件；
• 多模板：template/ 下多个模板目录（Agod / AgodM / AgodN / Fall1~Fall13…），后台一键切换；
• 分站/供应商：sup/ 供应商对接、分站表 shua_site、站点价格表 shua_site_price。

二、目录结构

程序根/
├── index.php / api.php / ajax.php    # 入口与接口（核心文件已加密）
├── cron.php / cron_jobs.php          # 定时任务（自动发货/对账/清理）
├── admin/                            # 后台（/admin/login.php，账号在 shua_account 表）
├── user/                             # 前台会员中心（/user/，账号在 shua_site 表）
├── includes/ src/ sup/               # 公共包含、业务代码、供应商对接
├── template/                         # 模板目录（Agod / AgodM / AgodN / Fall1…）
├── install/                          # 安装向导（装完删除）
├── other/ assets/ cache/ runtime/    # 其它资源与运行目录（cache 要可写）
└── config.php                        # 数据库配置（$dbconfig）

三、数据库

• 表前缀 shua_，共 51 张，主要分组：
• 账号：shua_site（前台会员/分站，含余额 rmb、明文密码 pwd）、shua_account（后台员工账号）；
• 商品与订单：shua_goods / shua_class（分类）/ shua_price（价格）/ shua_orders / shua_kms（卡密）/ shua_faka（发卡）/ shua_cart / shua_gift / shua_giftlog；
• 资金：shua_tixian（提现）、shua_points / shua_qiandao（积分与签到）、shua_coupons / shua_coupon_rules / shua_user_coupons；
• 分站/供应商：shua_site_price / shua_sitetask / shua_domain_landing、shua_supplier / shua_suppoints / shua_suptixian / shua_sync_config；
• 营销与运营：shua_invite / shua_invitelog / shua_inviteshop（邀请）、shua_seckillshop（秒杀）、shua_shequ（社区）、shua_article / shuaarticle（文章）、shua_tools / shua_toollogs（工具站）、shua_workorder（工单）、shua_chat_*（客服）、shua_visit_*（访客统计）、shua_region_price_*（地区定价）；
• 系统：shua_config、shua_cache、shua_logs、shua_sendcode、shua_message、shua_apps、shua_pay。

四、二次开发指引

• 改界面：直接改 template/ 下对应模板目录（HTML + 原生 PHP 混写），改前先复制一份做备份；
• 加功能：在根目录旁挂独立的 xxx.php（可以参考演示站的自动开号接口写法：直接 include config.php 拿 $dbconfig 连库），需要对外暴露再在 Nginx 加 location；
• 改数据：密码是明文存储（shua_site.pwd），改名/改价/加余额直接 SQL 即可；订单表 shua_orders 是唯一订单源；
• 定时任务：cron.php / cron_jobs.php 挂计划任务（建议 1 分钟一次）；
• 注意：cache/、runtime/ 要可写；改模板后清一下模板缓存；核心加密文件升级会被覆盖，改过的模板记得备份。

五、常见运维

• 后台登录：/admin/login.php（员工账号 shua_account）；会员中心 /user/（shua_site）；
• 前台接口（AJAX）多数在 ajax.php / api.php 下，带同站 Referer 校验，跨站调用会被拒绝（403）；
• 换域名/搬家：改 config.php 的库信息 + 后台站点域名设置，注意 shua_domain_landing 里的落地域名表。