开发文档

一、技术架构

• 框架：ThinkPHP 8 多应用（topthink/framework、think-orm、think-multi-app、think-view、think-template、think-captcha）+ aferrandini/phpqrcode（推广二维码）、phpmailer/phpmailer（邮件）；PHP 8.0+（推荐 8.1）/ MySQL 5.7+；
• 多应用：app/admin（后台 27 个控制器）、app/home（前台）、app/api（接口）、app/common（公共层，48 个模型）、app/function（公共函数）；
• 扩展：extend/ 下收口了第三方能力 —— alipay（支付宝）、epay（易支付）、alisms（阿里云短信）、WxOpen（微信开放平台）、jwt（接口令牌）、page（分页）。

二、目录结构

程序根/
├── public/index.php      # Web 入口
├── app/
│   ├── admin/            # 后台
│   ├── home/             # 前台（任务大厅/会员中心/发布任务）
│   ├── api/              # 接口
│   ├── common/           # model / 中间件 / 公共控制器
│   └── function/         # 公共函数
├── config/               # 配置（database/alipay/epay/captcha/...）
├── extend/               # 扩展（alipay / epay / alisms / WxOpen / jwt / page）
├── database/             # 建库脚本（xuanshang_tp8_structure.sql 结构 / _demo.sql / _seed.sql）
├── view/                 # 模板（admin / home 两套）
├── docs/                 # 随包文档（功能说明/安装文档/系统文档）
├── .env.example          # 环境示例（复制为 .env 填库与密钥）
└── xj_panel.php          # 授权验证 / 在线更新维护页

三、数据库

• 表前缀 tb_，共 52 张表；
• 会员与资金：tb_member、tb_member_level（等级）、tb_charge / tb_recharge（充值）、tb_withdraw（提现）、tb_credit_record（积分/信用流水）；
• 任务体系：tb_task / tb_task_category / tb_task_join / tb_task_record / tb_task_weekly / tb_daily_task / tb_task_operate_steps（步骤）；
• 赏金与抽奖：tb_reward、tb_jackpot / tb_jackpot_jl / tb_all_jackpot、tb_redpackage / tb_redpackage_record、tb_seepackage / tb_seepackage_record；
• 社交与推广：tb_follows、tb_chat / tb_chat_reply、tb_groupchat、tb_invitation_code / tb_invitation_log / tb_invitation_rebate_record（邀请返利）、tb_linkregis；
• 其它：tb_config（配置）、tb_banner、tb_notice、tb_help、tb_complaint / tb_complaint_reply、tb_feedback、tb_auth_group* / tb_auth_rule（后台权限）、tb_administrator（后台账号）、tb_uploads。

四、关键机制

4.1 任务流转

发布（tb_task）→ 接单（tb_task_join）→ 提交/审核（tb_task_record）→ 结算（tb_reward + 资金流水）。改流程先看 app/common/model/ 下任务相关模型，避免直接改控制器。

4.2 支付与提现

支付通道在 extend/epay（易支付）与 extend/alipay；配置在 config/epay.php / config/alipay.php。提现审核在后台，流水 tb_withdraw。

4.3 邀请分销

tb_invitation_* 三张表支撑邀请码、邀请关系与返利记录；返利规则在后台设置里。

五、二次开发指引

• 加前台页面：app/home/controller/ + view/home/（TP8 模板）；
• 加后台功能：app/admin/controller/ + view/admin/，后台菜单与权限在 tb_auth_rule / tb_auth_group 里加；
• 改库：改 database/xuanshang_tp8_structure.sql 的同时写一份升级 SQL（可重复执行），并在 app/common/model/ 建模型；
• 加支付通道：照 extend/epay 的接口实现新通道类，回调控制器在 app/home/controller/ 或 app/api；
• 注意：.env 里有数据库与密钥，不要外泄；后台控制器在买家包里是加密壳，二开请在明文源码上进行。

六、授权与在线更新

站点根 xj_panel.php 提供「验证授权 / 在线更新」；授权码在 xj_auth.php。更新不会覆盖 config/、.env 与上传目录，但会覆盖 app/ 下改过的程序文件，二开前请先备份。