【壹软V6MAX】全开源盲盒系统/Uniapp前端+PHP后端/一番赏+爬塔+排名榜+无限赏

V6MAX企业商用盲盒系统 – 功能详解与介绍

一、 系统概述

V6MAX​ 是一款功能强大、玩法多样的企业级商用盲盒系统源码。系统采用 Uniapp前端 + PHP后端的技术架构，一次开发可同时发布至App、微信小程序、H5网页端，助力企业快速搭建属于自己的多元化盲盒电商平台。系统核心特色在于集成了八大主流盲盒玩法，并配备了完善的用户运营工具，不仅满足了用户的新鲜感和刺激感，更为运营者提供了丰富的营销和盈利手段。

二、 核心功能模块详解

1. 用户与入口

• 多端登录适配： 微信小程序/H5端：支持微信授权一键登录，快速获取用户头像、昵称及手机号。 App端：支持手机号验证码登录，体验流畅。
• 首页门户： 品牌展示：左上角自定义Logo，强化品牌形象。 运营位：顶部Banner轮播图，支持配置跳转至活动页或特定盲盒。 弹窗公告：启动弹窗功能，用于发布重要公告或引导用户参与活动。 内容推荐：具备“热门推荐”、“福袋盲盒”等专属板块，支持后台灵活配置，精准引流。

2. 八大核心盲盒玩法

系统内置了八种截然不同的盲盒模式，满足多样化运营需求。

• 1. 一番赏 玩法介绍：源自日本的经典玩法。每套盲盒设有固定数量和品质的奖品（如A赏、B赏）。 核心机制： 全透明：实时公示奖池库存、奖品品质和概率，公平公正。 排队抽取：用户需先排队，按顺序抽取，抽中奖品后库存相应减少。 终结赏：当奖池只剩一件奖品时，抽取者将获得“终结赏”奖励，极具吸引力。
• 2. 福袋盲盒 玩法介绍：一番赏的变种玩法，增加了趣味性。 核心机制：在保留一番赏全透明和排队机制的基础上，允许用户自主选择福袋号码进行抽取，满足用户的偏好选择。
• 3. 无限赏（无限池） 玩法介绍：类似泡泡玛特的常规盲盒模式。奖池不设上限，概率恒定。 核心机制： 保底机制：后台可设置“N抽必中某品质奖品”，保障用户体验，避免极端非酋情况。 适合作为平台的基础和主流抽盒模式。
• 4. 爬塔盲盒 玩法介绍：融合了RPG爬塔成长元素的玩法，过程充满悬念。 核心机制： 塔层结构：盲盒与塔层绑定，登顶即可获得大奖。 概率可控：后台可自定义“上升一层”、“维持原层”、“下降一层”的概率。 排名激励：设有爬塔排名榜，展示用户冲顶次数，激发竞争欲。
• 5. 擂台赏 玩法介绍：双人实时对战模式，增强互动性与刺激性。 核心机制： 双方PK：用户选择一方（如黄/绿阵营）下注，等待对手加入。 随机判定：系统随机判定胜负，赢家获得实物奖品，输家获得幸运币补偿，参与即有奖。
• 6. 对对碰 玩法介绍：结合了“消消乐”游戏规则的趣味玩法，通常与直播拆盒结合。 核心机制： 许愿对碰：用户从9个赏品中选择1个作为“许愿赏品”。 循环消除：在场上寻找并消除相同赏品，系统会补充新赏品，直至无法消除。 次数奖励：根据成功对碰的次数，发放对应等级的奖品。
• 7. 领主赏 玩法介绍：带有社交和“收租”元素的玩法，增加用户粘性。 核心机制： 争夺领主：用户抽中“领主证明”即可成为当前盲盒的“领主”。 被动收益：在24小时的领主任期内，其他用户抽取该盲盒时，领主都能获得幸运币奖励。 身份更替：领主身份可被新抽中证明的用户顶替，鼓励持续参与。
• 8. 福赏（活动营销） 玩法介绍：不是一个独立的玩法，而是一套营销活动工具集。 核心机制： 福池：消费满额即可免费领取奖品，刺激消费。 限时活动：支持“每日限定”、“聚划算”、“N倍赠送”、“首单优惠”、“买N送N”等多种促销模式。 新人专享：如“0.01元首抽”、“新人买一送一”等，有效拉新。

3. 福房系统

这是一个独立的多人互动开奖模块，分为三种类型：

• 官方福房：由平台创建，支持“满人即开”或“定时开奖”。
• 主播福房：授权主播创建，需后台审核，增强平台内容生态。
• 用户福房：普通用户可创建“定时开奖”房间，放入自有奖品（高价值奖品需审核），促进用户间互动和奖品流通。

4. 运营与营销工具

• 口令红包： 用户可生成专属口令红包，分享给好友。好友复制口令后打开App即可领取。 支持短链、防刷机制（如限制用户ID领取），是低成本裂变传播的利器。
• 荣誉殿堂（排名榜）： 设有日榜、周榜等消费排行榜。 仅计入现金消费，排名靠前的用户可获得额外奖品，刺激头部用户消费。

5. 支付与资产

• 支付方式：集成微信支付、支付宝等主流官方支付渠道。
• 双货币体系： 余额：与现金按10：1比例兑换，用于抽、购买商品等核心消费。 幸运币：通过活动、奖励、任务等方式获得，用于参与特定活动（如擂台赏）等。

三、 系统特点与优势总结

1. 玩法全覆盖：一站式集成市面上主流的8种盲盒玩法，无需二次开发，开箱即用。
2. 技术架构先进：采用流行的Uniapp+PHP组合，多端兼容，维护成本低，扩展性强。
3. 透明度与公平性：核心玩法均强调奖池、概率、库存的透明化，建立用户信任。
4. 强运营属性：内置丰富的营销活动（福赏、红包、排名榜）和互动模块（福房），助力用户增长与留存。
5. 高灵活性：各种玩法的规则、概率、奖品均可通过后台详细配置，适应不同的运营策略。

V6MAX 潮玩盲盒商城 基于 ThinkPHP 6 的多玩法潮玩盲盒电商平台后端，支持一番赏、对对碰、福袋、擂台赏、领主赏等多种盲盒玩法，集成多渠道支付、分销推广、排行榜等运营能力。

1V6MAX V3.0版本更新日志：史诗级更新2 3全新模块 7 | 功能增强 20+ | 文件变更 140+ | 新增文件 504 5================================================================================6 7【概述】8 9本次更新涵盖七大全新模块：新增盲盒详情页6种顶部动态特效和5种自定义开盒动画效果，每种盲盒类型可独立配置专属开盒动画，打造差异化视觉体验；一键导入淘宝/天猫商品到平台，粘贴链接即可批量上架，彻底解放运营双手；多商户轮训智能支付架构上线，多号按权重自动切换，助力解决收款难点；全新投诉/售后管理系统，APP内在线申请、沟通、处理一站式闭环，投诉不再外溢；用户标签智能引擎自动为用户打标分层，精细化运营从此有据可依；商城优惠券系统支持多多币兑换专属券，营销玩法更丰富。10 11玩法方面，爬塔V2双模式重构、对碰新增累计免费局与托管模式、一番赏自定义排队与锁箱策略，全局盲盒自定义能力全面增强——每个盲盒的锁箱策略、累计阈值、碰次范围、爬塔模式、排队规则、开盒动画、顶部特效等玩法参数均可独立自定义配置，运营可按不同盲盒打造差异化玩法策略，助推平台多样化运营方案。运营工具方面，盲盒利润率一键分析、数据大屏新增多维度统计报表、12模块独立开关搭配紧急维护模式等多项功能同步增强。12 13底层代码进行了大规模重构优化，MySQL 5.7深度调优配合11项精准索引，开奖响应提速30倍，支付链路全面改造，安全防护与异常容错能力显著提升，从根本上保障平台高并发场景下的稳定性与响应速度。14 15 16================================================================================17 18一、盲盒视觉特效系统19——全新视觉体验，让每次开盒都充满惊喜20 21盲盒详情顶部特效：22  后台可自定义盲盒详情页顶部奖品轮播图周围的动态特效样式，预设6种风格：23  - 黄金闪电：金色电弧环绕，能量感十足24  - 烈焰燃烧：火焰翻涌效果，热力四射25  - 星光闪烁：星点飘散闪烁，梦幻柔和26  - 霓虹流光：紫蓝渐变流转，赛博朋克风27  - 冰霜寒气：冰晶漂浮效果，清冷高级28  - 无特效：关闭动态效果29  应用于盲盒详情、领主赏、爬塔页面，点击选择即时生效。30 31自定义开盒动画：32  支持按盲盒类型（无限赏/一番赏/福袋/对对碰/擂台赏/爬塔等）独立设置开奖动画效果，可选5种动画：33  - 卡片翻转：3D卡片翻转揭示奖品34  - 视频开盒：播放自定义开盒视频35  - 拆封揭示：撕开信封效果揭示36  - 碎裂粒子：能量球爆裂散开37  - 滚动老虎机：滚动停止揭晓结果38 39 40================================================================================41 42二、商品管理 & 一键导入43——粘贴链接，5分钟批量上架20件商品44 45一键导入商品：46  - 粘贴淘宝/天猫商品链接，系统自动抓取标题、主图、详情图、价格47  - 支持批量编辑售价、成本、库存、等级、多多币48  - 图片可一键转存到 OSS/七牛，不依赖外链49  - 单次最多导入20件，效率提升20倍50 51盲盒商品增强：52  - 商品表单新增爬塔效果（不变/升层/降层）配置53  - 新增爬塔模式选择、锁箱独立配置、对碰累计设置等93行配置项54 55 56================================================================================57 58三、玩法体系全面进化59——全局盲盒自定义能力增强，助推平台多样化运营方案60 61【爬塔 V2】双模式重构：62  - 概率爬塔：按权重随机升降，经典玩法更成熟63  - 证明爬塔：开出赏品决定升降，策略性拉满64  - 登顶奖励：每次登顶都可领取盲盒奖励，不限首次65 66【对对碰】累计免费局 + 托管模式：67  - 托管模式：用户可设置自动对碰，系统自动执行无需手动操作68  - 累计免费：完成指定局数后下一局免费，每盒独立配置累计阈值和有效碰次范围69  - 新增对对碰中奖记录管理页70 71【一番赏】自定义排队 & 自定义锁箱：72  - 排队机制完全自定义：支付成功自动延长排队有效期，高峰期不掉队73  - 锁箱策略每盒独立自定义：锁箱开关、锁定时长、触发比例均可按盒配置74  - 前端实时锁箱暂停倒计时展示，超时自动解锁释放75 76【擂台赏】概率全透明：77  - 每件商品实时概率公开展示，随库存变化实时更新78  - Redis缓存 + 数据库降级双保险79 80【口令红包】防自领：81  - 分享者不能领取自己的红包，杜绝自导自演82 83全局盲盒自定义能力增强：84  每个盲盒的玩法参数均可独立自定义配置：85  锁箱策略 | 累计阈值 | 碰次范围 | 爬塔模式 | 排队规则 | 开盒动画 | 顶部特效86  运营可按不同盲盒打造差异化玩法策略，助推平台多样化运营方案。87 88 89================================================================================90 91四、投诉/售后管理系统92——APP内一站式闭环，投诉不再外溢93 94完整售后流程：95  用户发起申请 → 上传凭证图片 → 在线沟通协商 → 后台处理 → 实时查看进度96 975种处理方式：98  - 退余额：退款到用户账户余额99  - 赠优惠券：赠送平台优惠券补偿100  - 赠多多币：赠送多多币补偿101  - 赠实物：赠送实物商品补偿102  - 拒绝：拒绝并说明原因103 104配套功能：105  - 售后原因配置：按抽盒订单/发货订单分类管理，支持增删改、排序、启用/禁用106  - 消息实时提醒：15秒轮询新消息自动提醒，首页展示待处理售后数量107  - 售后入口全覆盖：订单详情、我的订单、支付成功页面均有入口108  - 转赠审核机制：转赠需审核，展示双方信息，防止恶意转移套现109 110 111================================================================================112 113五、微信多商户轮训 & 支付系统114——多号自动切换，助力解决收款难点115 116核心架构：117  用户发起支付 → 系统按权重选择商户 → 异常自动切换 → 全部不可用时降级到全局配置118 119功能清单：120  - 多商户轮训：支持配置多个微信商户号，按权重自动轮训，覆盖小程序/H5/APP三端121  - 智能风控：失败率>30%自动禁用，>15%标记警告，日限额>=90%触发预警122  - 三端支付改造：AmpWxPay / H5Wxpay / AppWxPay 全部改造为多商户模式123  - 回调适配：自动按 merchant_id 取对应配置验签124  - Epay兼容：同时支持 GET 和 POST 回调方式125  - 充值优化：最多12档自定义配置，支持自定义金额和随机尾数126  - 容灾降级：单点故障自动切换，完全向下兼容原有配置127 128 129================================================================================130 131六、用户标签智能系统132——12种自动标签 + 自定义规则引擎133 134预设标签：135  新用户 | 活跃用户 | 高价值 | 鲸鱼 | 7日沉默 | 流失预警 | 已流失 | 已首充 | 未付费 | 复购用户 | 欧皇 | PK爱好者136 137功能特性：138  - 自动标签引擎：支持自定义规则引擎（多条件 AND/OR 组合），定时自动刷新匹配139  - 行为数据采集：自动采集消费、充值、活跃度等行为数据用于标签计算140  - 标签看板：可视化展示各标签人数与占比，点击直达用户列表141  - 会员列表筛选：按标签下拉筛选，彩色徽章展示；列表新增积分、累计消费、佣金收益等列142 143 144================================================================================145 146七、商城优惠券系统147——多多币兑换专属券，营销新利器148 149  - 商城专属优惠券：可配置面值、满减门槛、兑换价格（多多币）、库存、有效天数，支持关联全部盲盒或指定盲盒150  - 优惠券管理增强：列表增加「已领取人数」列，新增领取详情统一查看页151  - 商城页面改版：分为「多多商城」「积分商城」「优惠券」三大板块152 153 154================================================================================155 156八、后台管理 & 运营工具157——全方位增强后台管理能力158 159  - 仪表盘改版：全新渐变统计卡、四宫格概览、ECharts图表、订单状态直达160  - 菜单体系重组：拆分为「系统设置」「营销运营」「交易配置」三组，新增「支付管理」；兑换码/道具卡合并到「活动管理」161  - 会员管理增强：新增查看赏池、编辑页补充身份信息、余额页多Tab162  - 统计报表增强：销售额/充值/毛利率/RTP/渠道饼图，盲盒利润一键分析163  - 排行榜配置升级：多档奖品、发奖记录页、手动发放功能164  - 手动发奖：中奖记录页直接发放商品到用户赏池165  - 12模块独立开关：独立控制12个业务模块，关闭后前端自动隐藏166  - 紧急维护模式：一键开启，自定义公告文案，保留仓库发货功能167  - 后台安全码：敏感操作邮箱验证码二次确认168  - 数据清理增强：新增投诉数据、用户标签数据一键清理169  - 签到补签：支持补签漏签日期，累计总天数统计170  - 实名认证：阿里云身份二元素核验，身份证号脱敏记录171 172 173================================================================================174 175九、用户端体验优化176 177  - 首页入口优化：模块根据后台配置动态显示/隐藏，中奖滚动公告优化178  - 排行榜展示升级：奖品展示更直观，类型更丰富179  - 消费等级展示：当前等级 + 升级进度一目了然180  - 订单号一键复制：订单详情页支持复制181  - 扫码加群：首页侧栏新增扫码加群弹窗182  - 系统维护优化：维护期间仓库发货不受影响183  - 异常提示优化：支付异常、网络异常等场景错误提示更友好准确184 185 186================================================================================187 188十、风控与安全189 190  - 锁箱独立配置：防止用户恶意操控概率，每盒独立条件191  - 擂台库存修正：解决旧版库存计算不准的超发问题192  - 签到防并发：唯一索引保护，防止并发重复提交193  - 模块开关防护：前端模块开关机制防止用户访问未开放功能，减少无效请求194 195 196================================================================================197 198十一、MySQL 5.7 + 深度性能调优199——开奖提速 30 倍，高峰期也稳如磐石200 201  - 开奖提速 30x：一番赏/无限赏 API 从 1.7~3s 降至 <100ms，11项精准索引消除全表扫描202  - InnoDB缓冲池：热数据常驻内存，读写提升 20%~50%203  - 原生JSON支持：投诉图片、标签规则等数据存取效率更高204  - 批量写入翻倍：几百人同时开奖、充值、下单依然丝滑205  - 子查询优化器：统计报表、排行榜复杂查询显著提升206  - 在线DDL：加字段不锁表，后续升级零停服207  - 崩溃恢复：异常重启后秒级恢复208  - 连接池优化：连接超时大幅减少，大促高峰稳定209  - 仓库秒开：全表扫描改为索引命中，大仓库毫秒加载210  - 严格模式兼容：修复 25+ 字段默认值，SQL Mode 精确配置211 212 213================================================================================214 215V6MAX 3.0 — 更安全的支付、更高效的运营、更流畅的体验216感谢您的支持与反馈，我们将持续改进产品体验！

1# V6MAX 潮玩盲盒商城 2 3> 基于 ThinkPHP 6 的多玩法潮玩盲盒电商平台后端，支持一番赏、对对碰、福袋、擂台赏、领主赏等多种盲盒玩法，集成多渠道支付、分销推广、排行榜等运营能力。4 5---6 7## 目录8 9- [1. 项目简介](#1-项目简介-project-overview)10- [2. 项目架构与目录结构](#2-项目架构与目录结构-architecture)11- [3. 接口文档](#3-接口文档-api-documentation)12  - [3.1 认证模块 (Login)](#31-认证模块-login)13  - [3.2 会员模块 (Member)](#32-会员模块-member)14  - [3.3 盲盒模块 (BlindBox)](#33-盲盒模块-blindbox)15  - [3.4 支付模块 (Pay)](#34-支付模块-pay)16  - [3.5 订单模块 (Order)](#35-订单模块-order)17  - [3.6 通用模块 (Common)](#36-通用模块-common)18  - [3.7 排行榜模块 (Rank)](#37-排行榜模块-rank)19  - [3.8 奖品记录模块 (PrizeRecord)](#38-奖品记录模块-prizerecord)20  - [3.9 支付回调 (Notify)](#39-支付回调-notify)21  - [3.10 其他模块](#310-其他模块)22  - [3.11 后台管理 (Admin)](#311-后台管理-admin)23  - [3.12 商户端 (Merchant)](#312-商户端-merchant)24- [4. 快速开始](#4-快速开始-getting-started)25- [5. 定时任务](#5-定时任务-scheduled-commands)26- [6. 功能更新日志](#6-功能更新日志)27 28---29 30## 1. 项目简介 (Project Overview)31 32V6MAX 潮玩盲盒商城是一个面向 C 端用户的潮玩盲盒电商平台后端服务。平台提供多种盲盒玩法（一番赏、对对碰、福袋、擂台赏、领主赏等），用户可通过 H5 / 微信小程序 / APP 多端访问。33 34### 核心功能35 36| 功能域 | 说明 |37|--------|------|38| **盲盒玩法** | 一番赏、无限赏、对对碰（配对碰撞）、福袋、擂台赏（PK）、领主赏、爬塔等 |39| **商品与订单** | 商品展示、下单购买、卡密发货、物流跟踪 |40| **支付体系** | 微信支付（小程序/H5/APP）、支付宝、易支付、聚合支付、汇付、余额、积分（多多币） |41| **会员体系** | 注册登录、实名认证、签到奖励、任务中心、等级消费 |42| **仓库与奖品** | 奖品管理、兑换回收、转赠、申请发货、保险箱 |43| **运营工具** | 排行榜（日/周）、分销推广、口令红包、优惠券、福利房、专题活动 |44| **后台管理** | 盲盒 / 商品 / 订单 / 会员 / 统计 / 配置全面管理 |45 46### 技术栈47 48| 类别 | 技术 |49|------|------|50| **语言** | PHP >= 7.1 |51| **框架** | ThinkPHP 6（多应用模式） |52| **数据库** | MySQL 5.6+（表前缀 `xn_`） |53| **缓存** | Redis / File |54| **认证** | JWT（`thans/tp-jwt-auth`） |55| **文件存储** | 阿里云 OSS / 七牛云 |56| **短信** | 短信宝 |57| **支付 SDK** | 微信支付 / 支付宝 / 易支付 / 聚合支付 / 汇付 |58| **其他** | 阿里云实名认证、快递100物流查询、PHPExcel、淘宝开放平台 |59 60---61 62## 2. 项目架构与目录结构 (Architecture)63 64```65v6max/66├── app/                              # 应用主目录67│   ├── admin/                        # 后台管理应用68│   │   ├── config/route.php          #   路由配置（AdminCheck 中间件）69│   │   ├── controller/               #   后台控制器70│   │   ├── middleware/AdminCheck.php  #   登录 & 安全码校验71│   │   └── view/                     #   后台视图模板（HTML）72│   ├── api/                          # API 应用（前端 H5/小程序/APP 调用）73│   │   ├── config/route.php          #   路由配置（跨域中间件）74│   │   ├── controller/               #   API 控制器75│   │   └── middleware/76│   │       ├── AllowCrossDomain.php  #   跨域处理77│   │       └── Jwt.php               #   JWT 认证 & Token 刷新78│   ├── index/                        # 前台入口应用79│   │   ├── controller/               #   前台控制器80│   │   └── middleware/TemplateCheck   #   模板切换中间件81│   ├── merchant/                     # 商户/分销端82│   │   ├── controller/               #   商户控制器83│   │   └── view/                     #   商户端视图84│   ├── common/                       # 公共模块85│   │   ├── controller/               #   基类控制器86│   │   │   ├── ApiBase.php           #     API 基类（认证、响应封装）87│   │   │   ├── AdminBase.php         #     后台基类（RBAC、权限）88│   │   │   └── MerchantBase.php      #     商户基类89│   │   ├── model/                    #   数据模型（ORM）90│   │   └── lib/                      #   工具库91│   │       ├── Pay/                  #     支付集成（13 种支付方式）92│   │       ├── Sms/Duanxinbao.php    #     短信服务93│   │       ├── Oss.php               #     阿里云 OSS94│   │       ├── Qiniu.php             #     七牛云存储95│   │       ├── WxLogin.php           #     微信登录96│   │       └── PairMatchLogger.php   #     对对碰日志97│   ├── command/                      # CLI 定时任务命令98│   ├── lang/                         # 多语言包（zh-cn / en-us）99│   ├── common.php                    # 全局辅助函数100│   └── middleware.php                # 全局中间件注册101├── config/                           # 全局配置102│   ├── database.php                  #   数据库配置103│   ├── cache.php                     #   缓存配置（File / Redis）104│   ├── jwt.php                       #   JWT 配置105│   ├── console.php                   #   CLI 命令注册106│   └── ...                           #   其他框架配置107├── public/                           # Web 根目录（对外暴露）108│   ├── index.php                     #   HTTP 入口109│   └── static/                       #   静态资源110├── route/app.php                     # 全局路由111├── extend/                           # 第三方扩展112├── vendor/                           # Composer 依赖113├── .env                              # 环境变量配置114├── composer.json                     # PHP 依赖声明115└── think                             # ThinkPHP CLI 入口116```117 118### 路由规则119 120项目使用 ThinkPHP 默认路由模式，URL 格式为：121 122```123/{应用名}/{控制器}/{方法}124```125 126示例：`/api/member/get_user_info` → `app\api\controller\Member::get_user_info()`127 128### 中间件体系129 130| 层级 | 中间件 | 作用 |131|------|--------|------|132| 全局 | `SessionInit` | Session 初始化 |133| 全局 | `Check` | 动态后台 URL 映射 |134| API 应用 | `AllowCrossDomain` | 跨域请求处理 |135| API 控制器 | `Jwt` | JWT Token 认证、自动刷新、注入 `member_id` |136| Admin 应用 | `AdminCheck` | 管理员登录校验、安全码验证 |137| Index 应用 | `TemplateCheck` | 前台模板切换 |138 139---140 141## 3. 接口文档 (API Documentation)142 143> 基础路径：`/api`  144> 认证方式：JWT Bearer Token（Header: `Authorization: Bearer {token}`）  145> 通用响应格式：`{ "code": 1, "msg": "success", "data": {...} }`  146> 多语言：请求参数或 Header 中传递 `lang=en-us` / `lang=zh-cn`147 148### 3.1 认证模块 (Login)149 150**Endpoint 前缀**：`/api/login`  151**认证要求**：无需 Token152 153| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |154|----------|--------|----------|----------|----------|155| 发送短信验证码 | POST | `/api/login/send_sms` | `mobile`, `event` | 发送手机短信验证码 |156| 号码认证获取手机号 | POST | `/api/login/getMobile` | `token` | 通过运营商一键登录 Token 获取手机号 |157| 手机号登录/注册 | POST | `/api/login/mobile_login` | `mobile`, `code`, `pid` | 短信验证码登录，新用户自动注册 |158| 微信小程序登录 | POST | `/api/login/mp_wechat_login` | `code`, `nickName`, `share_ma` | 小程序 `wx.login` code 换取登录态 |159| 获取小程序手机号 | POST | `/api/login/get_mp_wechat_phone` | `code` | 小程序获取用户手机号 |160| APP 微信登录 | POST | `/api/login/get_wechat_info_by_app` | `code`, `share_ma` | APP 端微信授权登录 |161| H5 微信登录 | GET | `/api/login/h5_wx_login` | `code`, `openid`, `share_ma` | H5 端微信 OAuth 登录 |162| 退出登录 | POST | `/api/login/logout` | `token` | 注销当前 Token |163 164---165 166### 3.2 会员模块 (Member)167 168**Endpoint 前缀**：`/api/member`  169**认证要求**：JWT Token（全部接口）170 171| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |172|----------|--------|----------|----------|----------|173| 获取用户信息 | GET | `/api/member/get_user_info` | — | 返回当前用户完整信息 |174| 修改个人信息 | POST | `/api/member/change_info` | `image`, `nickname` | 修改头像和昵称 |175| 绑定手机号 | POST | `/api/member/bind_mobile` | `mobile`, `code` | 绑定 / 更换手机号 |176| 绑定邀请码 | POST | `/api/member/bind_invite_code` | `invite_code` | 绑定上级推广码 |177| 获取实名认证状态 | GET | `/api/member/get_real_name_status` | — | 查询实名认证状态 |178| 提交实名认证 | POST | `/api/member/update_real_name_status` | `real_name`, `real_id_card`, `certify_id` | 提交身份证实名信息 |179| 获取银行卡信息 | GET | `/api/member/get_my_bank` | — | 查询已绑定银行卡 |180| 申请提现 | POST | `/api/member/withdrawal` | `number`, `bank_fullname`, `bank_card`, `bank_type` | 余额提现申请 |181| 提现记录 | GET | `/api/member/withdrawal_log` | `page`, `limit` | 分页查询提现记录 |182| 资金变动日志 | GET | `/api/member/money_log` | `type`, `page`, `change_type`, `year_month` | 余额/积分/佣金变动流水 |183| 今日消费 | GET | `/api/member/get_day_money` | — | 查询当日消费金额 |184| 我的优惠券 | GET | `/api/member/get_my_coupon` | — | 查询已领取优惠券 |185| 领取优惠券 | POST | `/api/member/receive_coupon` | `cid`, `a_type` | 领取指定优惠券 |186| 查询可用优惠券 | GET | `/api/member/find_coupon` | `box_id`, `price` | 根据盲盒和价格查可用券 |187| 收货地址列表 | GET | `/api/member/my_address` | — | 获取用户收货地址 |188| 添加收货地址 | POST | `/api/member/add_address` | `fullname`, `mobile`, `province`, `city`, `area`, `detailed`, `is_default` | 新增收货地址 |189| 编辑收货地址 | POST | `/api/member/edit_address` | `address_id`, `fullname`, `mobile`, ... | 修改收货地址 |190| 删除收货地址 | POST | `/api/member/delete_address` | `address_id` | 删除收货地址 |191| 获取单条地址 | GET | `/api/member/get_address` | `address_id` | 获取单条地址详情 |192| 每日签到 | POST | `/api/member/qiandao` | — | 执行每日签到领取奖励 |193| 获取签到配置 | GET | `/api/member/get_qiandao_set_list` | — | 签到规则及奖励配置 |194| 兑换 CDKEY | POST | `/api/member/cdkey` | `kahao` | 输入卡号兑换奖励 |195| 获取分享配置 | GET | `/api/member/get_share_config` | — | 分享奖励规则 |196| 分享奖励 | POST | `/api/member/share` | `share_type` | 分享成功后领取奖励 |197| 我的团队 | GET | `/api/member/get_my_team` | `type`, `page` | 查看推广下级列表 |198| 推广记录 | GET | `/api/member/get_popularize_log` | `page` | 推广佣金记录 |199| 系统通知 | GET | `/api/member/get_notice` | — | 获取通知列表 |200| 通知详情 | GET | `/api/member/get_notice_info` | `id` | 查看通知详情 |201| 一键已读通知 | POST | `/api/member/set_allread_notice` | — | 标记所有通知已读 |202| 任务中心 | POST | `/api/member/get_task_info` | `task_id`, `type` | 查看 / 解锁每日任务 |203| 小程序邀请二维码 | GET | `/api/member/get_wxamp_share_qrcode` | — | 生成小程序分享海报二维码 |204| 注销账号 | POST | `/api/member/logoff` | — | 永久注销账号 |205 206---207 208### 3.3 盲盒模块 (BlindBox)209 210**Endpoint 前缀**：`/api/blind_box`  211**认证要求**：部分接口需要 JWT Token（标注 🔒）212 213| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |214|----------|--------|----------|----------|----------|215| 🔒 开启盲盒抽奖 | POST | `/api/blind_box/open` | `order_no` | 根据订单号执行开盒抽奖 |216| 🔒 对对碰-选择心愿商品 | POST | `/api/blind_box/choose_wish_goods` | `goods_id`, `box_id` | 对对碰选择想要的商品 |217| 对对碰-获取商品池 | GET | `/api/blind_box/get_pair_match_box_goods` | `record_id`, `box_id` | 获取当前对对碰商品池 |218| 🔒 对对碰-执行碰撞 | POST | `/api/blind_box/pair_box_collision` | `record_id`, `positions` | 执行配对碰撞翻牌 |219| 🔒 对对碰-开启心愿卡 | POST | `/api/blind_box/open_wish_card` | `record_id` | 使用心愿卡直接获得商品 |220| 一番赏-获取箱列表 | GET | `/api/blind_box/get_yfs_box_xiang_list` | `blind_box_id` | 获取一番赏所有箱号 |221| 一番赏-获取盒子详情 | GET | `/api/blind_box/get_yfs_box_detail` | `blind_box_id`, `xiang_number` | 获取指定箱的剩余商品 |222| 福袋-获取列表 | GET | `/api/blind_box/get_fukubukuro_list` | — | 福袋活动列表 |223| 福袋-获取详情 | GET | `/api/blind_box/get_fukubukuro_detail` | `blind_box_id`, `xiang_number` | 福袋详情信息 |224| 福袋-获取箱列表 | GET | `/api/blind_box/get_fukubukuro_box_xiang_list` | `blind_box_id` | 福袋箱号列表 |225| 福袋-购买记录 | GET | `/api/blind_box/get_fukubukuro_purchase_record` | `blind_box_id`, `xiang_number` | 福袋某箱购买记录 |226| 获取挑战者数量 | GET | `/api/blind_box/get_challengers_count` | `blind_box_id` | 擂台赏挑战人数 |227| 获取保底商品列表 | GET | `/api/blind_box/box_match_guarantee_goods` | `blind_box_id` | 对对碰保底商品池 |228| 🔒 加入排队 | POST | `/api/blind_box/join_queue` | `blind_box_id`, `xiang_number` | 一番赏/福袋排队购买 |229| 🔒 取消排队 | POST | `/api/blind_box/cancel_queue` | `blind_box_id`, `xiang_number` | 取消排队 |230| 查询排队状态 | GET | `/api/blind_box/get_queue_status` | `blind_box_id`, `xiang_number` | 查看当前排队位置 |231| 🔒 锁定箱子 | POST | `/api/blind_box/lock_box` | `blind_box_id`, `xiang_number` | 紧急暂停箱子 |232| 🔒 解锁箱子 | POST | `/api/blind_box/unlock_box` | `blind_box_id`, `xiang_number` | 恢复箱子可购买 |233 234---235 236### 3.4 支付模块 (Pay)237 238**Endpoint 前缀**：`/api/pay`  239**认证要求**：大部分需要 JWT Token240 241| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |242|----------|--------|----------|----------|----------|243| 🔒 盲盒购买支付 | POST | `/api/pay/go_pay` | `boxid`, `num`, `paymode`, `client`, `xiang_number`, `fukubukuro_numbers` | 创建盲盒支付订单 |244| 🔒 获取盲盒价格 | POST | `/api/pay/get_box_price` | `boxid`, `num`, `paymode`, `is_pk`, `xiang_number` | 计算盲盒价格（含优惠） |245| 🔒 新人专享支付 | POST | `/api/pay/newer_pay` | `source`, `blind_box_id`, `zid`, `couponid`, `paymode` | 新用户专属优惠购买 |246| 🔒 商品购买入仓库 | POST | `/api/pay/buy_goods_to_warehouse` | `goods_id`, `num`, `paymode`, `client` | 购买商品存入仓库 |247| 🔒 商品购买支付 | POST | `/api/pay/go_goods_pay` | `goods_id`, `num`, `address_id`, `paymode`, `client` | 购买商品直接发货 |248| 🔒 余额充值 | POST | `/api/pay/recharge_balance` | `amount`, `paymode`, `client` | 充值余额 |249| 🔒 查询订单状态 | GET | `/api/pay/get_order_status` | `order_no` | 轮询支付结果 |250| 订单详情/价格活动 | GET | `/api/pay/order_details` | `boxid`, `zid`, `type`, `source` | 获取订单价格和活动信息 |251| 易支付跳转 | GET | `/api/pay/go_epay` | `order_no` | 易支付收银台页面跳转 |252| 聚合支付查询 | GET | `/api/pay/juhepay_query` | `order_no`, `pay_order_id` | 查询聚合支付结果 |253| 汇付支付查询 | GET | `/api/pay/heepay_query` | `agent_bill_id` | 查询汇付支付结果 |254 255**支持的支付方式（paymode）**：256 257| paymode | 支付方式 |258|---------|----------|259| 1 | 微信小程序支付 |260| 2 | APP 支付宝 |261| 3 | APP 微信支付 |262| 4/5 | 易支付（H5 微信/支付宝） |263| 6 | 多多币（积分支付） |264| 7 | H5 微信支付 |265| 8 | H5 支付宝 |266| 9 | 付呗 |267| 10 | 聚合支付 |268| 11 | 余额支付 |269| 12 | APP 支付宝 v2 |270| 13 | 汇付（云闪付） |271 272---273 274### 3.5 订单模块 (Order)275 276**Endpoint 前缀**：`/api/order`  277**认证要求**：JWT Token278 279| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |280|----------|--------|----------|----------|----------|281| 中奖记录 | GET | `/api/order/get_prize_record` | `status`, `in_safe_box`, `goods_source_type`, `except_box_type` | 用户奖品仓库列表 |282| 未开盒盲盒订单 | GET | `/api/order/get_blind_box_order` | `page` | 已购但未开的盲盒 |283| 商品订单列表 | GET | `/api/order/get_goods_order` | `status`, `page` | 商品订单分页列表 |284| 商品订单详情 | GET | `/api/order/get_goods_order_info` | `order_id` | 订单详细信息 |285| 订单状态统计 | GET | `/api/order/get_order_status_count` | — | 各状态订单数量统计 |286| 查询物流 | GET | `/api/order/get_express_data` | `express_company`, `express_number` | 快递100 物流追踪 |287| 奖品兑换回收 | POST | `/api/order/prize_exchange` | `id`（逗号分隔多个） | 将奖品兑换为余额/积分 |288| 奖品转赠 | POST | `/api/order/prize_give` | `id`, `receive_username`, `reason_type`, `reason_text` | 向指定用户转赠奖品 |289| 转赠记录 | GET | `/api/order/prize_give_log` | `page`, `type` | 转赠操作记录 |290| 重抽奖品 | POST | `/api/order/redraw_prize` | `card_id`, `id` | 使用重抽卡重新抽奖 |291| 获取发货运费 | GET | `/api/order/get_apply_deliver_price` | `ids` | 计算发货运费 |292| 申请发货 | POST | `/api/order/apply_deliver` | `ids`, `address_id`, `remarks`, `paymode` | 提交奖品发货申请 |293| 确认收货 | POST | `/api/order/confirm_deliver` | `id` | 确认收货完成 |294 295---296 297### 3.6 通用模块 (Common)298 299**Endpoint 前缀**：`/api/common`  300**认证要求**：大部分无需 Token301 302<details>303<summary>点击展开完整列表（35+ 接口）</summary>304 305| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |306|----------|--------|----------|----------|----------|307| 首页盲盒列表 | GET | `/api/common/get_index_list` | `uid`, `type` | 首页盲盒分类列表 |308| 获取盲盒分类 | GET | `/api/common/get_blind_box` | — | 盲盒分类信息 |309| 按类型获取盲盒 | GET | `/api/common/get_blind_box_by_type` | `type` | 指定类型盲盒列表 |310| 热门盲盒 | GET | `/api/common/get_hot_blind_box` | — | 热门推荐盲盒 |311| 盲盒商品列表 | GET | `/api/common/get_blind_box_goods` | `blind_box_id`, `uid` | 盲盒内商品列表 |312| 盲盒商品（优化版） | GET | `/api/common/optimize_get_blind_box_goods` | `blind_box_id`, `uid` | 缓存优化的商品列表 |313| 盲盒商品（按来源） | GET | `/api/common/get_blind_source_box_goods` | `blind_box_id`, `source`, `zid` | 新人/活动来源商品 |314| 盲盒概率配置 | GET | `/api/common/get_blind_box_odds` | `blind_box_id` | 各档位概率设置 |315| 盲盒概率商品 | GET | `/api/common/get_blind_box_odds_goods` | `blind_box_id` | 按概率分组的商品 |316| 开盒记录 | GET | `/api/common/get_blind_box_open_log` | — | 全站最近开盒滚动 |317| 一番赏详情 | GET | `/api/common/get_yfsbox_detail` | `id`, `type` | 一番赏盲盒详情 |318| 一番赏中奖信息 | GET | `/api/common/get_yfsinfo_list` | `box_id` | 一番赏中奖展示 |319| 一番赏记录 | GET | `/api/common/get_yfs_log` | `blind_box_id`, `odds_id` | 一番赏开奖记录 |320| 擂台赏详情 | GET | `/api/common/get_pxbox_detail` | `id`, `type` | 擂台赏盲盒详情 |321| PK 房间列表 | GET | `/api/common/get_pkhouse_list` | `box_id`, `status` | 擂台 PK 房间 |322| 爬塔配置 | GET | `/api/common/pata_config` | — | 爬塔玩法配置 |323| 爬塔层级详情 | GET | `/api/common/pata_level_detail` | `level` | 指定层级详情 |324| 爬塔开盒记录 | GET | `/api/common/get_pata_blind_box_open_log` | `level`, `odds_id` | 爬塔层开盒记录 |325| 爬塔排行榜 | GET | `/api/common/towerRank` | — | 爬塔玩家排行 |326| 试玩开奖 | GET | `/api/common/test_open_prize` | `boxid`, `num` | 无需登录模拟开盒 |327| 系统配置 | GET | `/api/common/get_general` | — | 全局系统配置信息 |328| 指定配置 | GET | `/api/common/get_config` | `key` | 获取指定配置项 |329| 协议内容 | GET | `/api/common/get_agreement` | `name` | 用户协议/隐私政策 |330| 新闻详情 | GET | `/api/common/get_news` | `id` | 资讯详情 |331| 广告列表 | GET | `/api/common/get_advert` | `type` | Banner / 弹窗广告 |332| 商品列表 | GET | `/api/common/get_goods_list` | `pid`, `goods_tj`, `order`, `page` | 商品商城列表 |333| 商品详情 | GET | `/api/common/get_goods_info` | `id` | 商品详情信息 |334| 商品分类 | GET | `/api/common/get_goods_menu` | — | 商品分类菜单 |335| 优惠券列表 | GET | `/api/common/get_coupon` | `a_type`, `uid` | 可领优惠券列表 |336| 卡片列表 | GET | `/api/common/get_card` | — | 重抽卡等卡片 |337| 签到数据 | GET | `/api/common/get_qiandao_data` | — | 签到统计信息 |338| 新人专享活动 | GET | `/api/common/get_new_user_buy_open` | `uid` | 新用户专享活动 |339| 一周限定 | GET | `/api/common/get_present_list` | `week_day`, `type` | 每周限定活动 |340| 专题活动 | GET | `/api/common/get_zhuanti` | — | 专题活动列表 |341| 任务列表 | GET | `/api/common/get_user_tasks` | `uid` | 用户可做任务 |342| 消费统计 | GET | `/api/common/get_xiaofei_count` | `uid` | 用户消费汇总 |343| 分享邀请链接 | GET | `/api/common/get_my_share` | `share_ma`, `type`, `st`, `uid` | 生成邀请链接/活码 |344| 银行列表 | GET | `/api/common/get_sys_bank` | — | 系统支持银行 |345| 判断小程序版本 | GET | `/api/common/pd_amp` | `amp_appid` | 判断是否更换新小程序 |346| 身份认证发起 | POST | `/api/common/identity_verify` | `cert_name`, `cert_no`, `outer_order_no` | 阿里云身份核验 |347| 查询认证结果 | POST | `/api/common/query_identity_verify` | `certify_id` | 查询核验结果 |348| APP 版本检查 | GET | `/api/common/getAppVersion` | `app_ident` | 获取最新 APP 版本号 |349 350</details>351 352---353 354### 3.7 排行榜模块 (Rank)355 356**Endpoint 前缀**：`/api/rank`  357**认证要求**：JWT Token358 359| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |360|----------|--------|----------|----------|----------|361| 排行榜奖品信息 | GET | `/api/rank/get_rank_prize_info` | `interval`（daily/weekly） | 获取排行榜奖品配置 |362| 排行榜数据 | GET | `/api/rank/get_rank_info` | `interval`, `uid` | 查看日榜/周榜排名 |363| 发放日榜奖励 | POST | `/api/rank/sendDayRankPrize` | — | 手动触发日排行奖励 |364| 发放周榜奖励 | POST | `/api/rank/sendWeekRankPrize` | — | 手动触发周排行奖励 |365 366---367 368### 3.8 奖品记录模块 (PrizeRecord)369 370**Endpoint 前缀**：`/api/prize_record`  371**认证要求**：JWT Token372 373| 接口名称 | Method | Endpoint | 关键参数 | 功能描述 |374|----------|--------|----------|----------|----------|375| 福利房中奖记录 | GET | `/api/prize_record/get_welfare_room_winners` | `room_id`, `page`, `limit` | 福利房开奖结果 |376| 中奖记录列表 | GET | `/api/prize_record/get_prize_records` | — | 个人中奖记录 |377| 最新中奖记录 | GET | `/api/prize_record/get_latest_prize_records` | — | 全站最新中奖滚动 |378| 高级兑换 | POST | `/api/prize_record/advanced_exchange` | — | 奖品高级兑换 |379| 移入保险箱 | POST | `/api/prize_record/move_to_safe_box` | — | 将奖品移入保险箱 |380 381---382 383### 3.9 支付回调 (Notify)384 385**Endpoint 前缀**：`/api/notify`  386**认证要求**：无（支付平台服务器回调）387 388| 接口名称 | Method | Endpoint | 功能描述 |389|----------|--------|----------|----------|390| 易支付同步回调 | GET/POST | `/api/notify/recharge_epay_return` | 用户支付后前端跳回 |391| 易支付异步回调 | POST | `/api/notify/recharge_epay_notify` | 易支付服务端通知 |392| 小程序微信支付回调 | POST | `/api/notify/recharge_amp_wxpay_notify` | 微信小程序支付回调 |393| H5 微信支付回调 | POST | `/api/notify/recharge_h5wxpay_notify` | H5 微信支付回调 |394| 付呗支付回调 | POST | `/api/notify/recharge_fbalipay_notify` | 付呗支付回调 |395| APP 支付宝回调 | POST | `/api/notify/recharge_app_alipay_notify` | APP 支付宝回调 |396| APP 支付宝 v2 回调 | POST | `/api/notify/recharge_app_alipay2_notify` | APP 支付宝 v2 回调 |397| 聚合支付回调 | POST | `/api/notify/recharge_juhepay_notify` | 聚合支付服务端通知 |398| 汇付支付回调 | POST | `/api/notify/recharge_heepay_notify` | 汇付（云闪付）回调 |399 400---401 402### 3.10 其他模块403 404| 模块 | Endpoint 前缀 | 接口 | 功能描述 |405|------|---------------|------|----------|406| **文件上传** | `/api/upload` | `POST /api/upload/upload` | 图片/文件上传（支持水印） |407| **红包** | `/api/red_packet` | `GET get_info` / `POST use_code` | 口令红包查询与使用 |408| **评论** | `/api/comment` | `POST add` / `GET getListByGoodsId` / `GET getListByBlindBoxId` / `GET detail` | 商品/盲盒评论管理 |409| **身份核验** | `/api/identity` | `POST verify` / `GET history` | 身份证核验服务 |410| **合作申请** | `/api/cooperation` | `POST submit` | 提交商务合作申请 |411| **福利池** | `/api/welfare_pool` | `GET list` / `GET detail` / `POST join` | 福利池活动 |412| **福利房** | `/api/welfare_room` | `GET list` / `POST create` / `POST join` / `GET detail` | 福利房创建与参与 |413| **积分优惠券** | `/api/integral_points_coupon` | `GET index` / `GET detail` / `POST exchange` / `GET my` | 积分兑换优惠券 |414| **积分商品** | `/api/integral_points_goods` | `GET goods_list` / `GET goods_detail` / `POST exchange_goods` / `GET get_categories` | 积分商城 |415| **领主记录** | `/api/lord_record` | `GET list` | 领主赏记录 |416| **充值** | `/api/recharge` | — | 充值相关（通过 Pay 模块入口） |417 418---419 420### 3.11 后台管理 (Admin)421 422**Endpoint 前缀**：`/admin`  423**认证要求**：AdminCheck 中间件（登录 + 安全码）424 425| 模块 | 主要功能 |426|------|----------|427| **首页 (Index)** | 后台仪表盘、数据统计、清除缓存、SQL 更新 |428| **登录 (Login)** | 管理员登录、安全码校验、验证码 |429| **会员 (Member)** | 用户列表、查看手机号、编辑上级、调整余额、封禁/解封、设置星标 |430| **盲盒 (BlindBox)** | 盲盒 CRUD、概率配置、保底设置、奖池重置、试开测试 |431| **商品 (Goods)** | 商品 CRUD、SKU 管理、淘宝同步、上下架 |432| **统计 (Statistics)** | 用户游戏汇总、整体经营统计、盲盒利润分析 |433| **系统配置 (General)** | 网站设置、参数配置、分销设置、运费设置、转赠设置、排行规则 |434| **充值管理 (Recharge)** | 充值订单列表 |435| **红包 (RedPacket)** | 口令红包 CRUD、使用记录 |436| **排行榜 (Rank)** | 排行榜奖品配置 |437| **任务 (Task)** | 每日任务配置 |438| **优惠券 (Coupon)** | 优惠券 CRUD、绑定盲盒 |439| **福利池 (WelfarePool)** | 福利池管理、参与记录 |440| **福利房 (WelfareRoom)** | 福利房管理、参与者、状态切换 |441| **转赠审核 (PrizeGiveLog)** | 奖品转赠申请审核（通过/驳回） |442| **提现审核 (Withdrawal)** | 用户提现申请审核、批量处理、导出 |443 444---445 446### 3.12 商户端 (Merchant)447 448**Endpoint 前缀**：`/merchant`  449**认证要求**：MerchantBase 登录校验450 451| 接口名称 | Method | Endpoint | 功能描述 |452|----------|--------|----------|----------|453| 商户首页 | GET | `/merchant/index/index` | 商户控制台首页 |454| 商户统计 | GET | `/merchant/index/home` | 经营数据统计 |455| 个人资料 | GET/POST | `/merchant/member/user_info` | 查看/编辑个人信息 |456| 我的团队 | GET | `/merchant/member/my_team` | 查看推广下级 |457| 多多币充值 | GET/POST | `/merchant/member/my_up_xyb` | 给下级充值多多币 |458 459---460 461## 4. 快速开始 (Getting Started)462 463### 环境要求464 465| 组件 | 版本要求 |466|------|----------|467| PHP | >= 7.1（推荐 7.4） |468| MySQL | >= 5.6 |469| Redis | 可选（用于缓存加速） |470| Composer | 最新版 |471| Web 服务器 | Nginx / Apache |472 473### 安装步骤474 475**1. 克隆项目**476 477```bash478git clone <repository-url>479cd v6max480```481 482**2. 安装 PHP 依赖**483 484```bash485composer install486```487 488**3. 配置环境变量**489 490复制并编辑 `.env` 文件：491 492```ini493[APP]494DEBUG = true495DEFAULT_TIMEZONE = Asia/Shanghai496 497[DATABASE]498TYPE = mysql499HOSTNAME = 127.0.0.1500DATABASE = your_database_name501USERNAME = your_username502PASSWORD = your_password503HOSTPORT = 3306504CHARSET = utf8505PREFIX = xn_506 507[REDIS]508HOSTNAME = 127.0.0.1509PASSWORD =510PORT = 6379511 512[JWT]513SECRET = your_jwt_secret_key514TTL = 604800515```516 517**4. 导入数据库**518 519创建 MySQL 数据库（字符集 `utf8mb4`），导入项目提供的 SQL 文件：520 521```bash522mysql -u root -p your_database_name < public/sql.txt523```524 525**5. 设置 Web 根目录**526 527将 Web 服务器根目录指向 `public/` 目录。528 529Nginx 示例配置：530 531```nginx532server {533    listen 80;534    server_name your-domain.com;535    root /path/to/project/public;536    index index.php;537 538    location / {539        if (!-e $request_filename) {540            rewrite ^(.*)$ /index.php?s=/$1 last;541        }542    }543 544    location ~ \.php$ {545        fastcgi_pass 127.0.0.1:9000;546        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;547        include fastcgi_params;548    }549}550```551 552**6. 启动开发服务器（可选）**553 554```bash555php think run556```557 558访问 `http://localhost:8000` 即可。559 560**7. 配置定时任务**561 562```bash563# 日榜奖励发放（每日零点）5640 0 * * * cd /path/to/project && php think send:daily-rank-prize565 566# 周榜奖励发放（每周一零点）5670 0 * * 1 cd /path/to/project && php think send:weekly-rank-prize568 569# 福利房开奖570* * * * * cd /path/to/project && php think welfare:lottery571 572# 领主过期检查5730 */1 * * * cd /path/to/project && php think check:lord-expiration574 575# 每日推广统计5760 1 * * * cd /path/to/project && php think day_popularize_log577 578# 排行数据清理5790 0 * * * cd /path/to/project && php think clearRankingData580```581 582---583 584## 5. 定时任务 (Scheduled Commands)585 586| 命令 | 类 | 功能说明 |587|------|----|----------|588| `php think send:daily-rank-prize` | SendDailyRankPrize | 发放日排行榜奖励 |589| `php think send:weekly-rank-prize` | SendWeeklyRankPrize | 发放周排行榜奖励 |590| `php think welfare:lottery` | WelfareRoomLottery | 福利房自动开奖 |591| `php think check:lord-expiration` | CheckLordExpiration | 检查领主赏过期 |592| `php think day_popularize_log` | DayPopularizeLog | 统计每日推广数据 |593| `php think clearRankingData` | ClearRankingData | 清理过期排行数据 |594| `php think caiji` | Caiji | 数据采集 |595| `php think migrate:yifanshang` | MigrateYifanshangBox | 一番赏数据迁移 |596| `php think clean:queue` | CleanQueue | 清理超时排队记录 |597 598---599 600## 6. 功能更新日志601 602### 接口返回中英文多语言支持 (2025-12-11)603 604- 开启了 ThinkPHP 多语言中间件605- `ApiBase` 基类的 `success()` / `error()` 自动支持翻译606- 建立了 `zh-cn.php` 和 `en-us.php` 语言包607- 前端可通过 `?lang=en-us` 或 Header `lang` 参数切换语言608 609---610 611> 📌 本文档由代码库自动分析生成，如需补充具体接口的请求/响应示例，请指定模块名称。

1# 项目源码结构与功能说明书2 3> **项目名称**: V6MAX 潮玩盲盒商城后端  4> **文档版本**: v1.0  5> **生成日期**: 2026-03-06  6 7---8 9## 第一部分：项目概览10 11### 1.1 核心技术栈12 13| 类别 | 技术 |14|------|------|15| **语言** | PHP >= 7.1（推荐 7.4） |16| **框架** | ThinkPHP 6.x（多应用模式） |17| **数据库** | MySQL 5.6+，表前缀 `xn_` |18| **缓存** | Redis（Predis 扩展） |19| **认证** | JWT（API 端）/ Session（后台管理端） |20| **存储** | 阿里云 OSS / 七牛云 |21| **短信** | 短信宝（api.smsbao.com） |22| **支付** | 微信支付（小程序/APP/H5）、支付宝（APP/H5）、易支付、聚合支付、汇付支付、付呗、余额支付、积分支付 |23| **身份核验** | 阿里云 Cloudauth（二要素：姓名+身份证） |24| **微信生态** | 小程序登录、APP 微信登录、H5 微信 OAuth |25| **前端对接** | uni-app + Vue3（H5/小程序/APP） |26 27### 1.2 关键依赖库28 29| 包名 | 用途 |30|------|------|31| `topthink/framework` ^6.0.0 | ThinkPHP 核心框架 |32| `topthink/think-orm` ^2.0 | ORM 数据库操作 |33| `topthink/think-multi-app` ^1.0 | 多应用支持 |34| `topthink/think-view` ^1.0 | 模板视图引擎 |35| `thans/tp-jwt-auth` | JWT 认证 |36| `aliyuncs/oss-sdk-php` | 阿里云 OSS 存储 |37| `qiniu/php-sdk` | 七牛云存储 |38| `alibabacloud/sdk` | 阿里云 SDK（身份核验） |39| `alibabacloud/dypnsapi-20170525` | 阿里云号码认证 |40| `dtk-developer/openapi-sdk-php` | 淘宝联盟/大淘客 API（商品采集） |41| `jianyan74/php-excel` | Excel 导入导出 |42| `phpmailer/phpmailer` | 邮件发送 |43| `topthink/think-image` | 图片处理 |44| `topthink/think-captcha` | 验证码生成 |45 46### 1.3 主要业务目标47 48本项目是一个**潮玩盲盒电商平台后端系统**，核心业务包括：49 501. **盲盒抽奖** — 支持普通盲盒、一番赏、福袋、对对碰（54 张卡牌配对）、擂台赏、领主赏等多种玩法512. **商品商城** — 实体商品销售、淘宝商品同步、积分商城兑换523. **福利系统** — 福利房（多人拼奖）、福利池（消费抽奖）、红包口令、签到、任务系统534. **分销推广** — 邀请注册返佣、团队管理、推广日志、消费等级体系545. **排行榜** — 日榜/周榜消费排名及奖励发放556. **后台管理** — 管理员 RBAC 权限、盲盒/商品/会员/订单/财务全方位管理567. **商户端** — 分销代理后台、团队收益统计57 58---59 60## 第二部分：目录结构树61 62```63v6max.mh.50api.cn_RdfGT/64├── app/                                 # 应用主目录（ThinkPHP 多应用架构）65│   ├── admin/                           # 后台管理端应用66│   │   ├── config/                      # Admin 应用级配置67│   │   │   ├── route.php                #   路由中间件配置（AdminCheck）68│   │   │   ├── rank_prize.php           #   排行榜奖励配置（日/周榜多多币）69│   │   │   └── crontab.php              #   定时任务配置70│   │   ├── controller/                  # Admin 控制器（50+ 个）71│   │   │   ├── Index.php                #   后台首页、菜单、缓存管理72│   │   │   ├── Login.php                #   后台登录认证73│   │   │   ├── BlindBox.php             #   盲盒分类管理74│   │   │   ├── blind_box/               #   盲盒子模块（商品/概率/订单/奖品等）75│   │   │   ├── Goods.php                #   商品管理、淘宝同步76│   │   │   ├── goods/                   #   商品子模块（分类/订单）77│   │   │   ├── Member.php               #   会员管理78│   │   │   ├── member/                  #   会员子模块（提现/地址/资金等）79│   │   │   ├── General.php              #   系统配置管理80│   │   │   ├── general/                 #   配置子模块（签到/爬塔/银行等）81│   │   │   ├── Statistics.php           #   数据统计82│   │   │   ├── Rank.php                 #   排行榜管理83│   │   │   ├── Task.php                 #   任务管理84│   │   │   ├── RedPacket.php            #   红包管理85│   │   │   ├── WelfareRoom.php          #   福利房管理86│   │   │   ├── WelfarePool.php          #   福利池管理87│   │   │   ├── Auth.php                 #   权限规则管理88│   │   │   ├── AuthGroup.php            #   角色组管理89│   │   │   ├── Admin.php                #   管理员管理90│   │   │   └── ...                      #   更多管理控制器91│   │   ├── middleware/                  # Admin 中间件92│   │   │   └── AdminCheck.php           #   敏感操作安全码校验93│   │   └── view/                        # Admin 视图模板（HTML）94│   │       ├── blind_box/               #   盲盒相关页面95│   │       ├── goods/                   #   商品相关页面96│   │       ├── general/                 #   系统设置页面97│   │       ├── member/                  #   会员相关页面98│   │       ├── index/                   #   首页/仪表盘99│   │       ├── login/                   #   登录页100│   │       └── ...                      #   更多管理页面101│   │102│   ├── api/                             # API 应用（H5/小程序/APP 接口）103│   │   ├── controller/                  # API 控制器（20+ 个）104│   │   │   ├── Login.php                #   用户登录/注册（短信/微信/手机号）105│   │   │   ├── Member.php               #   用户中心（信息/提现/签到等）106│   │   │   ├── Common.php               #   公共接口（首页/配置/商品列表等）107│   │   │   ├── BlindBox.php             #   盲盒开箱/对对碰/一番赏/福袋108│   │   │   ├── Pay.php                  #   支付入口（多种支付方式）109│   │   │   ├── Order.php                #   订单管理（兑换/回收/转赠/发货）110│   │   │   ├── PrizeRecord.php          #   奖品记录/进阶兑换/保险箱111│   │   │   ├── Notify.php               #   支付异步回调处理112│   │   │   ├── WelfareRoom.php          #   福利房（创建/加入/开奖）113│   │   │   ├── WelfarePool.php          #   福利池（列表/加入/抽奖）114│   │   │   ├── Rank.php                 #   排行榜与奖励115│   │   │   ├── RedPacket.php            #   红包口令116│   │   │   ├── Comment.php              #   评论系统117│   │   │   ├── Identity.php             #   实名认证118│   │   │   ├── IntegralPointsGoods.php  #   积分商品兑换119│   │   │   ├── IntegralPointsCoupon.php #   积分优惠券兑换120│   │   │   ├── Upload.php               #   文件上传121│   │   │   ├── Recharge.php             #   充值（模型复用）122│   │   │   ├── Cooperation.php          #   合作申请123│   │   │   ├── LordRecord.php           #   领主记录124│   │   │   └── Index.php                #   测试/首页125│   │   └── middleware/                  # API 中间件126│   │       └── Jwt.php                  #   JWT 认证校验与自动刷新127│   │128│   ├── index/                           # PC 端/默认站点应用129│   │   ├── controller/                  # 首页控制器130│   │   │   └── Index.php                #   首页、注册、分享跳转131│   │   ├── route/                       # 自定义路由132│   │   │   └── app.php                  #   注册页路由133│   │   └── view/                        # 视图134│   │       └── index/index.html         #   首页模板135│   │136│   ├── merchant/                        # 商户/代理端应用137│   │   ├── controller/                  # 商户控制器138│   │   │   ├── Index.php                #   商户后台首页139│   │   │   └── Member.php               #   团队/下级/收益管理140│   │   └── view/                        # 商户端视图141│   │       ├── index/index.html         #   商户首页142│   │       └── member/                  #   团队/用户详情页143│   │144│   ├── common/                          # 公共模块（跨应用共享）145│   │   ├── controller/                  # 基础控制器146│   │   │   ├── Base.php                 #   全局基类（validate/success/error）147│   │   │   ├── AdminBase.php            #   Admin 基类（RBAC/登录检查）148│   │   │   ├── ApiBase.php              #   API 基类（JWT uid/统一响应）149│   │   │   ├── IndexBase.php            #   Index 基类150│   │   │   └── MerchantBase.php         #   商户端基类151│   │   ├── model/                       # 数据模型（60+ 个）152│   │   │   ├── Member.php               #   会员模型（登录/注册/信息）153│   │   │   ├── BlindBox.php             #   盲盒模型（列表/详情/缓存）154│   │   │   ├── BlindBoxOrder.php        #   盲盒订单（下单/开奖逻辑）155│   │   │   ├── BlindBoxPrizeRecord.php  #   奖品记录（抽奖核心逻辑）156│   │   │   ├── GoodsOrder.php           #   商品订单157│   │   │   ├── MemberMoneyLog.php       #   资金流水（余额/积分/佣金变动）158│   │   │   ├── Recharge.php             #   充值订单159│   │   │   ├── WelfareRoom.php          #   福利房160│   │   │   ├── WelfarePool.php          #   福利池161│   │   │   ├── General.php              #   系统配置（K-V 存储+缓存）162│   │   │   └── ...                      #   更多数据模型163│   │   └── lib/                         # 工具/服务类库164│   │       ├── Pay/                     #   支付集成（10+ 支付方式）165│   │       │   ├── AmpWxPay.php         #     小程序微信支付166│   │       │   ├── AppWxPay.php         #     APP 微信支付167│   │       │   ├── AppAliPay.php        #     APP 支付宝168│   │       │   ├── H5Wxpay.php          #     H5 微信支付169│   │       │   ├── H5Alipay.php         #     H5 支付宝170│   │       │   ├── Epay.php             #     易支付网关171│   │       │   ├── JuhePay.php          #     聚合支付172│   │       │   ├── HeePay.php           #     汇付支付173│   │       │   ├── FbPay.php            #     付呗支付174│   │       │   ├── BalancePay.php       #     余额支付175│   │       │   ├── IntegralPay.php      #     积分支付176│   │       │   └── SDK/                 #     微信/支付宝 SDK 封装177│   │       ├── Aliyun/178│   │       │   └── IdentityVerify.php   #   阿里云身份核验（二要素）179│   │       ├── Sms/180│   │       │   └── Duanxinbao.php       #   短信宝短信发送181│   │       ├── Oss.php                  #   阿里云 OSS 文件操作182│   │       ├── Qiniu.php               #   七牛云文件操作183│   │       ├── WxLogin.php             #   微信登录（小程序/APP/H5）184│   │       ├── PairMatchLogger.php     #   对对碰游戏日志185│   │       ├── SendEmail.php           #   邮件发送（PHPMailer）186│   │       ├── SendCode.php            #   后台安全码邮件验证187│   │       └── ShortLink/188│   │           └── Bslyun.php          #   短链接生成（变色龙云）189│   │190│   ├── command/                         # CLI 命令（定时任务）191│   │   ├── SendDailyRankPrize.php       #   每日排行榜奖励发放192│   │   ├── SendWeeklyRankPrize.php      #   每周排行榜奖励发放（周一执行）193│   │   ├── WelfareRoomLottery.php       #   福利房定时开奖194│   │   ├── CleanQueue.php               #   清理超时排队记录（3 分钟）195│   │   ├── CheckLordExpiration.php      #   领主过期检查（24 小时）196│   │   ├── ClearRankingData.php         #   清理排行榜/爬塔缓存数据197│   │   ├── DayPopularizeLog.php         #   每日邀请推广统计198│   │   ├── Caiji.php                    #   商品采集（外部 API + OSS 上传）199│   │   └── MigrateYifanshangBox.php     #   一番赏数据迁移200│   │201│   ├── common.php                       # 全局公共函数202│   ├── middleware.php                   # 全局中间件注册203│   ├── service.php                      # 服务注册204│   ├── event.php                        # 事件定义205│   ├── AppService.php                   # 应用服务206│   ├── ExceptionHandle.php              # 异常处理207│   └── Request.php                      # 请求对象208│209├── config/                              # 全局配置210│   ├── app.php                          #   应用配置（时区/默认应用/URL 后缀）211│   ├── database.php                     #   数据库配置（MySQL/前缀 xn_）212│   ├── cache.php                        #   缓存配置213│   ├── redis.php                        #   Redis 配置214│   ├── jwt.php                          #   JWT 配置（密钥/TTL/获取方式）215│   ├── middleware.php                   #   中间件别名216│   ├── route.php                        #   路由全局配置217│   ├── filesystem.php                   #   文件系统（本地/OSS）218│   ├── session.php                      #   Session 配置219│   ├── cookie.php                       #   Cookie 配置220│   ├── log.php                          #   日志配置221│   ├── console.php                      #   命令行注册222│   ├── view.php                         #   视图引擎配置223│   ├── captcha.php                      #   验证码配置224│   ├── lang.php                         #   多语言配置225│   └── trace.php                        #   调试追踪配置226│227├── route/                               # 路由目录228│   └── app.php                          #   全局路由（以约定路由为主）229│230├── extend/                              # 扩展库231│   ├── alipay/                          #   支付宝 SDK（Wap/App/转账/退款）232│   ├── Predis.php                       #   Redis 客户端封装233│   ├── OpenApi.php                      #   开放 API 接口234│   └── NotifyApi.php                    #   通知 API 接口235│236├── public/                              # Web 根目录（文档根）237│   ├── index.php                        #   应用入口文件238│   ├── favicon.ico                      #   站点图标239│   ├── static/                          #   静态资源（JS/CSS/图片）240│   ├── uploads/                         #   上传文件存储241│   ├── share_code/                      #   分享码图片242│   ├── sql.txt                          #   数据库结构文件243│   └── .well-known/                     #   SSL 证书验证244│245├── vendor/                              # Composer 依赖246├── view/                                # 全局视图247├── runtime/                             # 运行时缓存/日志248├── .env                                 # 环境变量配置249├── composer.json                        # Composer 依赖管理250├── think                                # CLI 入口脚本251├── README.md                            # 项目说明252└── API接口文档.md                        # API 接口文档253```254 255---256 257## 第三部分：详细功能解析258 259### 3.1 应用层 — `app/admin/`（后台管理端）260 261#### 3.1.1 `app/admin/controller/`262 263**路径**: `app/admin/controller/`  264**核心职责**: 提供后台管理的全部 Web 操作接口，基于 Session 认证 + RBAC 权限控制。  265**具体功能点**:266 267| 控制器文件 | 核心功能 |268|-----------|----------|269| `Index.php` | 后台首页仪表盘、左侧菜单渲染、缓存清理、系统信息展示 |270| `Login.php` | 管理员登录、验证码校验、Session 管理 |271| `BlindBox.php` | 盲盒分类 CRUD、类型管理（普通/一番赏/福袋/对对碰/擂台赏）、启停控制 |272| `blind_box/Goods.php` | 盲盒关联商品管理、库存、价格、图片配置 |273| `blind_box/Odds.php` | 盲盒概率配置（各赏级中奖率设置） |274| `blind_box/OddsGroup.php` | 概率分组管理（多概率方案切换） |275| `blind_box/Buy.php` | 购买方案管理（单抽/多抽/包抽价格配置） |276| `blind_box/Order.php` | 盲盒订单列表、订单详情、状态管理、数据导出 |277| `blind_box/PrizeRecord.php` | 奖品记录管理、发货状态、回收管理 |278| `blind_box/PrizeGiveLog.php` | 奖品转赠审核（通过/拒绝）、转赠日志查询 |279| `blind_box/LordRecord.php` | 领主记录管理（领主赏玩法） |280| `Goods.php` | 实体商品 CRUD、淘宝商品同步（大淘客 API）、商品上下架 |281| `goods/Order.php` | 商品订单管理、发货操作、物流跟踪、退款处理 |282| `goods/Menu.php` | 商品分类管理 |283| `Member.php` | 会员列表、搜索、禁用/启用、详情、余额调整 |284| `member/Withdrawal.php` | 提现申请审核（通过/拒绝）、提现记录查询 |285| `member/MoneyLog.php` | 资金流水查询、按类型/时间筛选 |286| `member/CommissionLog.php` | 佣金记录查询 |287| `member/PopularizeLog.php` | 推广邀请记录、下级关系查询 |288| `member/Level.php` | 会员等级配置（权益/折扣） |289| `member/ConsumptionLevel.php` | 消费等级配置（积分门槛/特权） |290| `member/Coupon.php` | 用户优惠券管理 |291| `member/Card.php` | 道具卡管理（重抽卡等） |292| `member/Address.php` | 收货地址管理 |293| `member/Bank.php` | 银行卡绑定管理 |294| `member/QiandaoLog.php` | 签到记录查询 |295| `General.php` | 系统全局配置管理（站点名称/域名/支付参数/短信参数/上传配置等） |296| `general/QiandaoSet.php` | 签到奖励配置（连续签到/奖励递增） |297| `general/TowerLevels.php` | 爬塔层级配置（难度/奖品） |298| `general/Bank.php` | 系统银行列表管理 |299| `general/ShortLink.php` | 短链接管理 |300| `general/SysDataDel.php` | 系统数据清理工具 |301| `Statistics.php` | 数据统计报表（盲盒利润、营收分析、用户数据） |302| `Rank.php` | 排行榜管理、日榜/周榜奖励配置与发放 |303| `Task.php` | 任务系统管理（每日任务配置/奖励设置） |304| `RedPacket.php` | 红包口令管理（创建/编辑/日志查询） |305| `Recharge.php` | 充值记录查询与管理 |306| `WelfareRoom.php` | 福利房管理（官方房/用户房控制） |307| `WelfarePool.php` | 福利池管理（奖池配置/奖品设置） |308| `WelfarePoolRecord.php` | 福利池参与记录查询 |309| `WelfareRoomGoods.php` | 福利房商品管理 |310| `Coupon.php` | 优惠券模板管理（创建/发放/状态管理） |311| `Cdkey.php` | 兑换码管理（批量生成/查询/状态管理） |312| `IntegralPointsGoods.php` | 积分商品管理（上下架/库存/积分价格） |313| `IntegralPointsGoodsCategory.php` | 积分商品分类管理 |314| `IntegralPointsCoupon.php` | 积分优惠券管理 |315| `Advert.php` | 广告位管理（Banner/弹窗等） |316| `Notice.php` | 公告管理（系统通知推送） |317| `News.php` | 新闻/资讯管理 |318| `Agreement.php` | 协议管理（用户协议/隐私政策/转赠协议等） |319| `Comment.php` | 用户评论管理（审核/删除） |320| `Auth.php` | 权限规则管理（菜单/操作权限配置） |321| `AuthGroup.php` | 角色组管理（角色创建/权限分配） |322| `Admin.php` | 管理员账号管理（增删改/角色分配） |323| `AdminLog.php` | 管理员操作日志查询 |324| `Newer.php` | 新人活动配置 |325| `Zhuanti.php` | 专题活动管理 |326| `Lucky.php` | 幸运活动配置（新人/活动盲盒绑定） |327| `Cooperation.php` | 合作申请管理（审核/处理） |328| `VersionManager.php` | APP 版本管理（版本号/更新内容/强制更新） |329| `UploadFiles.php` | 上传文件管理 |330| `SysReward.php` | 系统奖励配置 |331| `BlindBoxMatchProbability.php` | 对对碰匹配概率配置 |332| `BlindBoxMatchGuaranteeGoods.php` | 对对碰保底商品配置 |333| `Kuaidi100Code.php` | 快递 100 编码管理 |334| `FriendlyLink.php` | 友情链接管理 |335 336#### 3.1.2 `app/admin/middleware/AdminCheck.php`337 338**核心职责**: 后台敏感操作安全码校验中间件。  339**具体功能点**:3401. 拦截指定的敏感操作请求（如提现审核、数据删除等）3412. 校验请求中携带的安全码是否与管理员邮箱验证码匹配3423. 验证通过后放行请求，失败则返回错误提示3434. 与 `SendCode` 邮件服务配合使用344 345#### 3.1.3 `app/admin/view/`346 347**核心职责**: 后台管理端的 HTML 视图模板层。  348**具体功能点**:3491. 基于 ThinkPHP 模板引擎渲染后台管理页面3502. 使用 layui/element-ui 等 UI 组件构建管理界面3513. 包含表单（form.html）、列表（index.html）、弹窗等页面模板3524. 支持数据可视化图表展示（统计页面）353 354---355 356### 3.2 应用层 — `app/api/`（API 接口端）357 358#### 3.2.1 `app/api/controller/Login.php`359 360**核心职责**: 用户登录、注册与第三方授权认证。  361**具体功能点**:3621. **短信验证码登录** — 发送短信（60 秒限制）、验证码校验、自动注册/登录，颁发 JWT3632. **手机号一键登录** — 运营商号码认证（阿里云 GetMobile），免短信登录3643. **微信小程序登录** — `jscode2session` 获取 openid，绑定/创建用户3654. **微信 APP 登录** — 通过 `WxLogin::threeLogin()` 实现第三方登录3665. **H5 微信 OAuth** — 网页授权获取用户信息登录367 368#### 3.2.2 `app/api/controller/Member.php`369 370**核心职责**: 用户中心全部个人操作接口。  371**具体功能点**:3721. **个人信息** — 获取/修改用户信息、头像、昵称3732. **实名认证** — 查询/提交实名认证状态（关联阿里云身份核验）3743. **提现** — 余额提现申请（5 秒防重、余额校验、银行卡信息）3754. **收货地址** — 地址 CRUD（增删改查、默认地址设置）3765. **签到** — 每日签到领奖（连续签到递增奖励）3776. **分享** — 每日分享领奖（限次）3787. **优惠券** — 查看/领取优惠券3798. **CDKEY 兑换** — 输入兑换码领取对应奖励3809. **道具卡** — 查看我的道具卡（重抽卡等）38110. **团队** — 邀请关系、下级列表、团队统计38211. **消息通知** — 系统公告列表38312. **任务中心** — 每日任务进度查询38413. **账号注销** — 用户自主注销账号38514. **绑定邀请码** — 绑定上级邀请码386 387#### 3.2.3 `app/api/controller/Common.php`388 389**核心职责**: 面向前端的公共数据接口（大部分无需登录）。  390**具体功能点**:3911. **首页数据** — 盲盒列表、广告 Banner、公告、热门盲盒3922. **盲盒详情** — 商品列表、概率列表、购买方案、一番赏/福袋详情3933. **商品数据** — 商品列表、详情、分类菜单3944. **系统配置** — 站点名称、联系方式、功能开关等通用配置3955. **协议/新闻** — 用户协议、隐私政策、新闻资讯3966. **签到配置** — 签到规则与奖励展示3977. **任务列表** — 用户可完成的每日任务3988. **爬塔系统** — 爬塔配置、层级详情、爬塔排行榜3999. **专题/活动** — 专题页数据、新人活动配置40010. **身份核验** — 发起实名认证请求、查询认证结果40111. **版本检查** — APP 版本号与更新提示402 403#### 3.2.4 `app/api/controller/BlindBox.php`404 405**核心职责**: 盲盒核心开箱与游戏逻辑。  406**具体功能点**:4071. **普通开箱** — 验证订单 → 概率抽奖 → 生成奖品记录，支持首次开箱奖励4082. **对对碰** — 54 张卡牌匹配游戏（选择心愿商品 → 翻牌碰撞 → 0/3/6/9/14 次保底机制 → 心愿卡触发）4093. **一番赏** — 查看赏箱列表 → 选择赏箱 → 排队 → 抽取（库存递减）4104. **福袋** — 福袋列表/详情 → 购买 → 随机获取福袋内商品4115. **排队系统** — 加入/取消/查询排队状态（一番赏/福袋）4126. **锁箱** — 盲盒锁定/解锁（防止并发操作冲突）413 414#### 3.2.5 `app/api/controller/Pay.php`415 416**核心职责**: 统一支付入口，对接多种支付渠道。  417**具体功能点**:4181. **盲盒支付** — 计算价格（含优惠券/积分抵扣）→ 生成充值订单 → 调用对应支付渠道4192. **商品支付** — 实体商品下单支付4203. **余额充值** — 向平台账户充值余额4214. **运费支付** — 单独支付发货运费4225. **支付方式映射** — 根据 `pay_method` 字段路由到：小程序微信(1)、APP 支付宝(2)、APP 微信(3)、易支付(4/5)、积分(6)、H5 微信(7)、H5 支付宝(8)、付呗(9)、聚合支付(10)、余额(11)、APP 支付宝 2(12)、汇付(13)4236. **新人专享支付** — 特殊价格的新人盲盒购买通道424 425#### 3.2.6 `app/api/controller/Notify.php`426 427**核心职责**: 各支付渠道的异步回调统一处理。  428**具体功能点**:4291. **签名验证** — 验证各支付渠道回调签名的合法性4302. **订单状态更新** — 支付成功后更新充值订单状态为已支付4313. **业务分发** — 根据订单类型执行不同业务逻辑：432   - `add_blind_box_order` — 创建盲盒订单433   - `add_goods_order` — 创建商品订单434   - `batch_apply_deliver` — 批量发货申请435   - `add_balance_recharge` — 余额充值到账436   - `add_goods_to_warehouse` — 商品入仓库4374. **消费等级升级** — 支付成功后检查并升级用户消费等级4385. **分销佣金** — 触发上级推广佣金结算4396. **爬塔逻辑** — 消费后触发爬塔进度更新440 441#### 3.2.7 `app/api/controller/Order.php`442 443**核心职责**: 订单与奖品的全生命周期管理。  444**具体功能点**:4451. **订单查询** — 商品订单列表/详情、未开箱盲盒订单列表4462. **奖品兑换** — 将奖品兑换为积分/余额（按 `exchange_integral` 价格）4473. **奖品转赠** — 赠送奖品给其他用户（需实名认证、消费门槛、月/周限额、协议确认）4484. **申请发货** — 选择收货地址、计算运费、提交发货申请4495. **确认收货** — 用户确认收到实物商品4506. **重抽** — 使用重抽卡对奖品进行重新抽取4517. **物流查询** — 通过快递 100 接口查询物流信息4528. **订单状态统计** — 各状态订单数量（用于前端角标显示）453 454#### 3.2.8 `app/api/controller/PrizeRecord.php`455 456**核心职责**: 奖品仓库操作与进阶兑换。  457**具体功能点**:4581. **奖品记录查询** — 按类型/状态查询用户的奖品列表4592. **进阶兑换** — 多个低价值奖品合成一个高价值奖品（价值差额校验/退还）4603. **保险箱** — 将奖品移入/移出保险箱（防误操作保护）4614. **福利房中奖记录** — 查询福利房的中奖详情4625. **最新奖品滚动** — 获取最近的中奖记录（用于前端滚动展示）463 464#### 3.2.9 `app/api/controller/WelfareRoom.php`465 466**核心职责**: 福利房的创建、参与和开奖。  467**具体功能点**:4681. **房间列表** — 获取可加入的福利房列表4692. **创建房间** — 从仓库选择奖品作为奖池，设置人数/密码/开奖方式（人满/定时）4703. **加入房间** — 验证消费门槛/密码/容量，扣除参与费用，人满自动开奖4714. **房间详情** — 参与者列表、奖品信息、开奖状态4725. **开奖逻辑** — 单人房直接发放、多人房随机抽取中奖者、官方房指定奖品发放473 474#### 3.2.10 `app/api/controller/WelfarePool.php`475 476**核心职责**: 福利池抽奖玩法。  477**具体功能点**:4781. **池列表** — 获取活跃的福利池列表4792. **池详情** — 奖品列表、剩余库存、参与条件4803. **加入抽奖** — 验证当日消费额 → Redis 库存扣减 → 按权重随机抽取奖品 → 生成奖品记录481 482#### 3.2.11 `app/api/controller/Rank.php`483 484**核心职责**: 消费排行榜与排名奖励。  485**具体功能点**:4861. **排行数据** — 按日/周统计充值消费金额排名（排除积分支付和余额支付）4872. **奖励配置** — 获取日榜/周榜各名次的奖励信息4883. **发放日榜奖励** — 结算前一日排行，发放多多币/商品/优惠券/道具卡4894. **发放周榜奖励** — 结算上周排行，仅周一可执行490 491#### 3.2.12 `app/api/controller/RedPacket.php`492 493**核心职责**: 红包口令系统。  494**具体功能点**:4951. **红包信息** — 通过口令查询红包详情（金额/状态/剩余）4962. **使用口令** — 校验口令有效性、防止自领、单人单次限制、到账余额497 498#### 3.2.13 其他 API 控制器499 500| 控制器 | 核心功能 |501|--------|----------|502| `Comment.php` | 评论发布（关联订单/商品评级）、评论列表查询（按商品/订单/盲盒）、用户名脱敏 |503| `Identity.php` | 二要素身份核验（姓名+身份证）、每日限额 1000 次、阿里云 Cloudauth 对接、防重复绑定 |504| `IntegralPointsGoods.php` | 积分商品列表/详情、消费等级过滤、积分兑换（扣积分+生成奖品记录） |505| `IntegralPointsCoupon.php` | 积分优惠券列表/详情、积分兑换优惠券（扣积分+发券） |506| `Upload.php` | 文件上传（禁 PHP 文件、支持水印）、存储到 OSS/七牛/本地 |507| `Cooperation.php` | 合作申请提交（姓名/手机/微信/备注）、24 小时去重 |508| `LordRecord.php` | 领主赏记录查询（当前领主/收益/任期/抽取次数/排名） |509| `Recharge.php` | 充值模型（非独立控制器，充值逻辑在 Pay 中实现） |510 511#### 3.2.14 `app/api/middleware/Jwt.php`512 513**核心职责**: API 请求的 JWT 认证中间件。  514**具体功能点**:5151. 从请求头/参数中提取 JWT Token5162. 校验 Token 有效性，解析出 `member_id`5173. 过期 Token 自动刷新机制5184. 将 `member_id` 注入到请求对象中供控制器使用5195. 白名单路由免认证放行520 521---522 523### 3.3 应用层 — `app/index/`（PC 端/默认站点）524 525**路径**: `app/index/`  526**核心职责**: PC 端首页与注册分享页面。  527**具体功能点**:5281. 首页展示 — 平台介绍/引导下载5292. 注册页面 — 带邀请码的注册入口5303. 分享跳转 — 从分享链接跳转到 H5/小程序531 532---533 534### 3.4 应用层 — `app/merchant/`（商户/代理端）535 536**路径**: `app/merchant/`  537**核心职责**: 分销代理的后台管理面板。  538**具体功能点**:5391. 商户首页 — 个人收益概览、团队数据统计5402. 团队管理 — 下级用户列表、层级关系展示5413. 用户详情 — 查看下级用户的消费/充值/收益详情5424. 收益管理 — 推广佣金记录、下级贡献统计543 544---545 546### 3.5 公共模块 — `app/common/model/`（数据模型）547 548#### 3.5.1 核心业务模型549 550| 模型文件 | 对应表 | 核心业务逻辑 |551|---------|--------|-------------|552| `Member.php` | `xn_member` | 用户登录/注册（`mobile_login_or_reg`）、用户信息获取（`get_info`）、邀请码生成、分享码图片生成（`create_share_ma`）、消费等级关联 |553| `BlindBox.php` | `xn_blind_box` | 盲盒列表查询（`get_index_blind_box`/`get_blind_box`）、缓存优化、购买方案关联（`buy_data`）、擂台赏详情 |554| `BlindBoxOrder.php` | `xn_blind_box_order` | 订单创建（`add_order`）、开奖核心逻辑（`order_open`，区分普通/一番赏/福袋/对对碰模式） |555| `BlindBoxPrizeRecord.php` | `xn_blind_box_prize_record` | **抽奖核心** — 概率计算（`get_open_prize`）、一番赏开奖（`yfs_open`）、福袋抽取（`get_fukubukuro_prizes`）、保底机制、领主赏触发、奖品兑换/转赠/发货流程 |556| `BlindBoxMatchRecord.php` | `xn_blind_box_match_record` | 对对碰游戏记录、碰撞匹配逻辑、卡牌状态管理 |557| `MemberMoneyLog.php` | `xn_member_money_log` | **资金核心** — `set_money()` 方法处理所有余额/积分/佣金的增减操作，记录流水明细 |558| `Recharge.php` | `xn_recharge` | 充值订单管理（创建/查询/状态更新） |559| `GoodsOrder.php` | `xn_goods_order` | 商品订单管理（创建/发货/物流/确认收货） |560| `General.php` | `xn_general` | 系统配置 K-V 存储（`getConfig`/`confSave`），缓存刷新（`reflash`），被 `xn_cfg()` 函数调用 |561 562#### 3.5.2 盲盒相关模型563 564| 模型文件 | 对应表 | 说明 |565|---------|--------|------|566| `BlindBoxGoods.php` | `xn_blind_box_goods` | 盲盒关联商品数据 |567| `BlindBoxOdds.php` | `xn_blind_box_odds` | 概率配置 |568| `BlindBoxOddsGroup.php` | `xn_blind_box_odds_group` | 概率分组 |569| `BlindBoxBuy.php` | `xn_blind_box_buy` | 购买方案 |570| `BlindBoxQueue.php` | `xn_blind_box_queue` | 一番赏/福袋排队 |571| `BlindBoxLock.php` | `xn_blind_box_lock` | 盲盒锁定 |572| `BlindBoxXiang.php` | `xn_blind_box_xiang` | 一番赏赏箱（含 `initBoxXiang` 初始化方法） |573| `BlindBoxFukubukuro.php` | `xn_blind_box_fukubukuro` | 福袋数据 |574| `BlindBoxPrizeGiveLog.php` | `xn_blind_box_prize_give_log` | 奖品转赠日志/审核 |575| `BlindBoxLordRecord.php` | `xn_blind_box_lord_record` | 领主赏记录 |576| `BlindBoxMatchGuaranteeGoods.php` | `xn_blind_box_match_guarantee_goods` | 对对碰保底商品 |577 578#### 3.5.3 会员相关模型579 580| 模型文件 | 对应表 | 说明 |581|---------|--------|------|582| `MemberAddress.php` | `xn_member_address` | 收货地址 |583| `MemberBank.php` | `xn_member_bank` | 银行卡绑定 |584| `MemberLevel.php` | `xn_member_level` | 会员等级 |585| `MemberConsumptionLevel.php` | `xn_member_consumption_level` | 消费等级 |586| `MemberMoneyLog.php` | `xn_member_money_log` | 资金流水 |587| `MemberCommissionLog.php` | `xn_member_commission_log` | 佣金记录 |588| `MemberPopularizeLog.php` | `xn_member_popularize_log` | 推广日志 |589| `MemberShareLog.php` | `xn_member_share_log` | 分享日志 |590| `MemberQiandaoLog.php` | `xn_member_qiandao_log` | 签到日志 |591| `MemberWithdrawal.php` | `xn_member_withdrawal` | 提现记录 |592| `MemberCouponList.php` | `xn_member_coupon_list` | 用户优惠券 |593| `MemberCdkeyLog.php` | `xn_member_cdkey_log` | CDKEY 兑换日志 |594| `MemberCard.php` | `xn_member_card` | 用户道具卡 |595| `MemberToken.php` | `xn_member_token` | 用户 Token |596 597#### 3.5.4 福利/活动模型598 599| 模型文件 | 对应表 | 说明 |600|---------|--------|------|601| `WelfareRoom.php` | `xn_welfare_room` | 福利房 |602| `WelfareRoomParticipant.php` | `xn_welfare_room_participants` | 福利房参与者 |603| `WelfareRoomWinner.php` | `xn_welfare_room_winners` | 福利房中奖者 |604| `WelfareRoomGoods.php` | `xn_welfare_room_goods` | 福利房商品 |605| `WelfarePool.php` | `xn_welfare_pool` | 福利池 |606| `WelfarePoolRecord.php` | `xn_welfare_pool_record` | 福利池参与记录 |607| `WelfarePoolPrize.php` | `xn_welfare_pool_prize` | 福利池奖品 |608| `RedPacket.php` | `xn_red_packet` | 红包模板 |609| `RedPacketLog.php` | `xn_red_packet_log` | 红包领取记录 |610| `SysReward.php` | `xn_sys_reward` | 系统奖励配置 |611 612#### 3.5.5 商品/内容/其他模型613 614| 模型文件 | 对应表 | 说明 |615|---------|--------|------|616| `Goods.php` | `xn_goods` | 商品目录 |617| `GoodsMenu.php` | `xn_goods_menu` | 商品分类 |618| `GoodsKami.php` | `xn_goods_kami` | 虚拟卡密商品 |619| `Coupon.php` | `xn_coupon` | 优惠券模板 |620| `Cdkey.php` | `xn_cdkey` | 兑换码 |621| `TaskList.php` | `xn_task_list` | 任务列表 |622| `TaskUserLog.php` | `xn_task_user_log` | 任务完成日志 |623| `QiandaoSet.php` | `xn_qiandao_set` | 签到配置 |624| `IntegralPointsGoods.php` | `xn_integral_points_goods` | 积分商品 |625| `IntegralPointsGoodsCategory.php` | `xn_integral_points_goods_category` | 积分商品分类 |626| `IntegralPointsCoupon.php` | `xn_integral_points_coupon` | 积分优惠券 |627| `TowerLevels.php` | `xn_tower_levels` | 爬塔层级 |628| `TowerLogs.php` | `xn_tower_logs` | 爬塔日志 |629| `TowerUserStatus.php` | `xn_tower_user_status` | 用户爬塔状态 |630| `UserpkLog.php` | `xn_userpk_log` | 擂台 PK 日志 |631| `Comment.php` | `xn_comment` | 评论 |632| `Notice.php` | `xn_notice` | 系统公告 |633| `Advert.php` | `xn_advert` | 广告 |634| `News.php` | `xn_news` | 新闻 |635| `Agreement.php` | `xn_agreement` | 协议 |636| `Cooperation.php` | `xn_cooperation` | 合作申请 |637| `SmsLog.php` | `xn_sms_log` | 短信日志 |638 639---640 641### 3.6 公共模块 — `app/common/lib/`（类库与集成）642 643#### 3.6.1 支付集成（`app/common/lib/Pay/`）644 645**核心职责**: 统一封装多种支付渠道的下单、回调、退款逻辑。646 647| 类文件 | 支付方式 | 关键方法 |648|--------|----------|---------|649| `AmpWxPay.php` | 小程序微信支付 | `goPay()` — JSAPI 下单 |650| `AppWxPay.php` | APP 微信支付 | `goPay()` — APP 统一下单 |651| `AppAliPay.php` | APP 支付宝 | `goPay()` — APP 支付签名 |652| `AppAliPay2.php` | APP 支付宝 2 | `goPay()` — 备用支付宝通道 |653| `H5Wxpay.php` | H5 微信支付 | `goPay()` — H5 场景支付 |654| `H5Alipay.php` | H5 支付宝 | `goPay()` — H5 Wap 支付 |655| `H5Alipay2.php` | H5 支付宝 2 | `goPay()` — 备用 H5 通道 |656| `Epay.php` | 易支付网关 | `goPay()` / `go_epay()` / `notify()` — 支持微信/支付宝 |657| `JuhePay.php` | 聚合支付 | `goPay()` — 聚合支付网关 |658| `HeePay.php` | 汇付支付 | `goPay()` — 汇付天下支付 |659| `FbPay.php` | 付呗 | `goPay()` — 付呗支付 |660| `BalancePay.php` | 余额支付 | `goPay()` — 扣减余额，直接触发 Notify 回调 |661| `IntegralPay.php` | 积分支付 | `goPay()` — 扣减积分，直接触发 Notify 回调 |662 663`Pay/SDK/WeChatDeveloper/` — 微信支付/支付宝 SDK 底层封装（OAuth、支付、小程序等）。664 665#### 3.6.2 存储服务666 667| 类文件 | 服务 | 关键方法 |668|--------|------|---------|669| `Oss.php` | 阿里云 OSS | `putFile()` — 上传文件、`delete()` — 删除文件 |670| `Qiniu.php` | 七牛云 | `putFile()` — 上传文件、`delete()` — 删除文件、`getToken()` — 获取上传凭证 |671 672#### 3.6.3 短信服务673 674| 类文件 | 服务 | 说明 |675|--------|------|------|676| `Sms/Duanxinbao.php` | 短信宝 | `send()` — 发送短信、`error_msg()` — 错误码映射，对接 `api.smsbao.com` |677 678#### 3.6.4 身份核验679 680| 类文件 | 服务 | 说明 |681|--------|------|------|682| `Aliyun/IdentityVerify.php` | 阿里云 Cloudauth | `verifyIdentity()` — 二要素核验（姓名+身份证）、`maskIdCard()` / `maskName()` — 信息脱敏 |683 684#### 3.6.5 微信登录685 686| 类文件 | 服务 | 说明 |687|--------|------|------|688| `WxLogin.php` | 微信生态 | `getAccessToken()` — 获取 access_token、`threeLogin()` — 三方登录统一入口（小程序/APP/H5）、微信 API 请求封装 |689 690#### 3.6.6 其他服务691 692| 类文件 | 服务 | 说明 |693|--------|------|------|694| `SendEmail.php` | 邮件发送 | 基于 PHPMailer 的邮件封装 |695| `SendCode.php` | 安全码 | 管理员敏感操作的邮件验证码发送 |696| `PairMatchLogger.php` | 对对碰日志 | 游戏日志记录（`gameStart` / `collision` / `gameEnd`），写入文件 + 数据库 |697| `ShortLink/Bslyun.php` | 短链接 | 对接变色龙云 `qr.bslyun.com` 生成短链 |698 699---700 701### 3.7 公共模块 — `app/common/controller/`（基础控制器）702 703| 控制器 | 核心职责 |704|--------|---------|705| `Base.php` | 全局基类 — `validate()` 参数验证、`success()` / `error()` 统一响应、`redirect()` 重定向、响应类型判断 |706| `AdminBase.php` | 后台基类 — 登录状态检查、RBAC 权限校验（`checkAuth` / `checkMenuAuth`）、演示模式拦截、面包屑导航 |707| `ApiBase.php` | API 基类 — `get_uid()` 从 JWT 获取用户 ID、统一 JSON 响应（含 `sysTime`）、参数验证 |708| `IndexBase.php` | 前台基类 — 继承 Base |709| `MerchantBase.php` | 商户基类 — Session 登录检查（`getUid()`）、商户身份验证 |710 711---712 713### 3.8 公共函数 — `app/common.php`714 715**核心职责**: 全局通用辅助函数。  716**关键函数**:717 718| 函数名 | 功能 |719|--------|------|720| `xn_cfg($name)` | 从 `xn_general` 表读取系统配置（支持 `group.key` 格式，自动缓存） |721| `get_source()` | 获取活动来源映射（新人专享/买一送一/免单白嫖/一周限定等） |722| `get_integer_price()` | 计算积分（多多币/星石）抵扣后的价格 |723| `get_userday_countmoney()` | 查询用户当日消费金额 |724| `get_user_task_day_countmoney()` | 查询用户当日任务消费金额 |725| `get_order()` | 生成唯一订单号 |726| `alipayrefund()` | 支付宝退款 |727| `isCreditNo()` | 身份证号码格式验证 |728| `curl_post()` | HTTP POST 请求封装 |729| `get_host_url()` | 获取当前域名 URL |730| `xn_encrypt()` / `xn_root()` | 加密/路径工具 |731| `del_files()` | 删除文件 |732 733---734 735### 3.9 命令行任务 — `app/command/`736 737**核心职责**: 定时任务与数据维护命令（通过 `php think` 执行）。738 739| 命令文件 | 注册命令 | 功能说明 | 建议执行频率 |740|---------|---------|---------|-------------|741| `SendDailyRankPrize.php` | `send:daily-rank-prize` | 每日排行榜奖励发放：统计前一日消费排名 → 发放多多币/商品/优惠券/道具卡 | 每日 00:05 |742| `SendWeeklyRankPrize.php` | `send:weekly-rank-prize` | 每周排行榜奖励发放：统计上周消费排名（仅周一可执行） | 每周一 00:10 |743| `WelfareRoomLottery.php` | `welfare:lottery` | 福利房定时开奖：检查到期房间 → 随机抽取中奖者 → 发放奖品 | 每分钟 |744| `CleanQueue.php` | `clean:queue` | 清理排队超时记录：删除加入超过 3 分钟的排队数据 | 每分钟 |745| `CheckLordExpiration.php` | `check:lord-expiration` | 领主过期检查：标记超过 24 小时的领主记录为已过期 | 每小时 |746| `ClearRankingData.php` | `clearRankingData` | 清理排行榜/爬塔缓存数据，重置排名 | 按需/每日 |747| `DayPopularizeLog.php` | `day_popularize_log` | 每日邀请推广统计：统计星级用户的邀请战绩 | 每日 |748| `Caiji.php` | `caiji` | 商品采集：从外部 API 获取商品数据 → 上传图片到 OSS → 入库 | 按需 |749| `MigrateYifanshangBox.php` | `migrate:yifanshang` | 一番赏数据迁移：将旧版一番赏数据迁移到新的赏箱系统 | 一次性 |750 751---752 753### 3.10 全局配置 — `config/`754 755| 配置文件 | 核心职责 |756|---------|---------|757| `app.php` | 应用配置 — 应用映射（`app_map`）、默认时区 `Asia/Shanghai`、URL 后缀、错误显示 |758| `database.php` | 数据库配置 — MySQL 连接（从 `.env` 读取）、表前缀 `xn_`、编码 `utf8mb4` |759| `redis.php` | Redis 配置 — 连接地址/端口/密码 |760| `jwt.php` | JWT 配置 — 密钥（`JWT_SECRET`）、过期时间（TTL）、Token 获取方式 |761| `middleware.php` | 中间件别名 — Session、Check 等全局中间件注册 |762| `route.php` | 路由配置 — pathinfo 模式、默认控制器/操作、URL 参数方式 |763| `filesystem.php` | 文件系统 — 本地存储和 OSS 存储驱动配置 |764| `console.php` | 命令注册 — 定时任务命令类绑定 |765| `session.php` | Session — 存储驱动/过期时间 |766| `cache.php` | 缓存 — 缓存驱动配置 |767| `log.php` | 日志 — 日志通道/级别/格式 |768| `view.php` | 视图 — 模板引擎配置 |769| `captcha.php` | 验证码 — 字体/长度/干扰线配置 |770| `lang.php` | 多语言 — 默认语言/检测方式 |771 772---773 774### 3.11 路由 — `route/`775 776**核心职责**: 路由配置（项目以约定路由为主）。  777**路由规则**:778- 采用 ThinkPHP 多应用 + 默认约定路由（`url_route_must => false`）779- URL 格式：`/{app}/{controller}/{action}`780- API 示例：`/api/login/mobile_login`、`/api/blind_box/open`781- Admin 示例：`/admin/index/home`、`/admin/blind_box/index`782- `app/index/route/app.php` 中有少量自定义路由（注册页等）783 784---785 786### 3.12 扩展库 — `extend/`787 788| 文件/目录 | 说明 |789|----------|------|790| `alipay/` | 支付宝 SDK（Wap 支付、App 支付、转账、退款等） |791| `Predis.php` | Redis 客户端封装 |792| `OpenApi.php` | 开放 API 接口 |793| `NotifyApi.php` | 通知 API 接口 |794 795---796 797### 3.13 入口与部署 — `public/`798 799**核心职责**: Web 服务根目录。  800**关键文件**:8011. `index.php` — 应用唯一入口，定义 `PAY_ROOT`（支付宝 SDK 路径），设置 CORS 头8022. `static/` — 前端静态资源（JS/CSS/图片/字体）8033. `uploads/` — 用户上传文件存储目录8044. `share_code/` — 生成的分享码图片8055. `sql.txt` — 数据库初始化结构文件806 807---808 809## 第四部分：源码结构汇总表810 811| 路径 (Path) | 类型 (Type) | 模块名称 (Module Name) | 核心功能描述 (Key Functionality) | 备注 (Notes) |812|---|---|---|---|---|813| `app/admin/controller/` | 目录 | 后台管理控制器 | 50+ 个控制器，覆盖盲盒/商品/会员/订单/财务/配置/权限全方位管理 | Session + RBAC 认证 |814| `app/admin/controller/Index.php` | 文件 | 后台首页 | 仪表盘展示、菜单渲染、缓存管理 | |815| `app/admin/controller/Login.php` | 文件 | 后台登录 | 管理员登录验证、验证码校验 | |816| `app/admin/controller/BlindBox.php` | 文件 | 盲盒分类管理 | 盲盒 CRUD、类型管理、启停控制 | |817| `app/admin/controller/blind_box/` | 目录 | 盲盒子模块管理 | 商品/概率/概率分组/购买方案/订单/奖品/转赠审核/领主记录 | 含 8 个子控制器 |818| `app/admin/controller/Goods.php` | 文件 | 商品管理 | 商品 CRUD、淘宝同步、上下架 | 对接大淘客 API |819| `app/admin/controller/goods/` | 目录 | 商品子模块管理 | 商品分类、商品订单管理/发货 | |820| `app/admin/controller/Member.php` | 文件 | 会员管理 | 会员列表/搜索/禁用/详情/余额调整 | |821| `app/admin/controller/member/` | 目录 | 会员子模块管理 | 提现审核/地址/资金流水/佣金/推广/等级/消费等级/签到/优惠券/道具卡/银行卡 | 含 12 个子控制器 |822| `app/admin/controller/General.php` | 文件 | 系统配置 | 站点/支付/短信/上传/分销等全局参数配置 | |823| `app/admin/controller/general/` | 目录 | 配置子模块 | 签到设置/爬塔层级/系统银行/短链接/数据清理 | |824| `app/admin/controller/Statistics.php` | 文件 | 数据统计 | 盲盒利润报表、营收分析、用户数据统计 | |825| `app/admin/controller/Rank.php` | 文件 | 排行榜管理 | 日榜/周榜奖励配置与手动发放 | |826| `app/admin/controller/WelfareRoom.php` | 文件 | 福利房管理 | 官方/用户福利房管理 | |827| `app/admin/controller/WelfarePool.php` | 文件 | 福利池管理 | 福利池奖品配置 | |828| `app/admin/controller/Auth.php` | 文件 | 权限管理 | RBAC 权限规则/菜单管理 | |829| `app/admin/controller/AuthGroup.php` | 文件 | 角色管理 | 角色组创建与权限分配 | |830| `app/admin/controller/Task.php` | 文件 | 任务管理 | 每日任务配置与奖励设置 | |831| `app/admin/controller/RedPacket.php` | 文件 | 红包管理 | 红包口令创建/编辑/日志 | |832| `app/admin/middleware/AdminCheck.php` | 文件 | 安全码中间件 | 后台敏感操作邮件验证码校验 | |833| `app/admin/view/` | 目录 | 后台视图 | HTML 模板（layui），涵盖所有后台管理页面 | |834| `app/api/controller/Login.php` | 文件 | 用户登录 | 短信登录/微信登录/手机号一键登录/注册/JWT 颁发 | 公开接口 |835| `app/api/controller/Member.php` | 文件 | 用户中心 | 个人信息/提现/签到/分享/地址/优惠券/CDKEY/团队/任务/注销 | 30+ 个接口 |836| `app/api/controller/Common.php` | 文件 | 公共接口 | 首页数据/盲盒列表/商品列表/配置/协议/爬塔/身份核验/版本 | 40+ 个接口，大部分公开 |837| `app/api/controller/BlindBox.php` | 文件 | 盲盒开箱 | 普通开箱/对对碰(54 张卡牌)/一番赏/福袋/排队/锁箱 | 核心业务逻辑 |838| `app/api/controller/Pay.php` | 文件 | 支付入口 | 盲盒/商品/充值/运费支付，支持 13 种支付方式 | 统一支付网关 |839| `app/api/controller/Notify.php` | 文件 | 支付回调 | 各渠道异步回调处理、订单状态更新、业务分发、分销佣金 | 公开接口 |840| `app/api/controller/Order.php` | 文件 | 订单管理 | 订单查询/奖品兑换/转赠/发货/确认收货/重抽/物流 | |841| `app/api/controller/PrizeRecord.php` | 文件 | 奖品管理 | 奖品查询/进阶兑换/保险箱/福利房中奖/最新记录 | |842| `app/api/controller/WelfareRoom.php` | 文件 | 福利房 | 房间列表/创建/加入/详情/自动开奖 | |843| `app/api/controller/WelfarePool.php` | 文件 | 福利池 | 池列表/详情/加入抽奖（Redis 库存+权重随机） | |844| `app/api/controller/Rank.php` | 文件 | 排行榜 | 日/周消费排名、排名奖励发放 | |845| `app/api/controller/RedPacket.php` | 文件 | 红包 | 红包口令查询与使用 | |846| `app/api/controller/Comment.php` | 文件 | 评论 | 评论发布/按商品or订单查询/用户名脱敏 | |847| `app/api/controller/Identity.php` | 文件 | 身份核验 | 二要素实名认证（阿里云）、每日限额、防重复 | |848| `app/api/controller/IntegralPointsGoods.php` | 文件 | 积分商城 | 积分商品列表/详情/兑换（扣积分+生成奖品） | |849| `app/api/controller/IntegralPointsCoupon.php` | 文件 | 积分优惠券 | 积分优惠券列表/详情/兑换 | |850| `app/api/controller/Upload.php` | 文件 | 文件上传 | 图片上传（禁 PHP/水印）→ OSS/七牛/本地 | |851| `app/api/controller/Cooperation.php` | 文件 | 合作申请 | 合作申请提交（24h 去重） | |852| `app/api/controller/LordRecord.php` | 文件 | 领主记录 | 领主赏历史/收益/任期查询 | |853| `app/api/middleware/Jwt.php` | 文件 | JWT 中间件 | Token 解析/校验/自动刷新/白名单 | API 认证核心 |854| `app/index/` | 目录 | PC 端应用 | 首页展示、注册页、分享跳转 | |855| `app/merchant/` | 目录 | 商户端应用 | 分销代理后台、团队管理、收益统计 | Session 认证 |856| `app/common/controller/Base.php` | 文件 | 全局基类 | 参数验证、统一响应、重定向 | 所有控制器基类 |857| `app/common/controller/AdminBase.php` | 文件 | Admin 基类 | 登录检查、RBAC 校验、演示模式、面包屑 | |858| `app/common/controller/ApiBase.php` | 文件 | API 基类 | JWT uid 获取、统一 JSON 响应 | |859| `app/common/model/Member.php` | 文件 | 会员模型 | 登录注册、用户信息、邀请码、分享码生成 | 核心模型 |860| `app/common/model/BlindBox.php` | 文件 | 盲盒模型 | 盲盒列表/详情查询、缓存、购买方案 | |861| `app/common/model/BlindBoxOrder.php` | 文件 | 盲盒订单模型 | 订单创建、开奖核心逻辑（普通/一番赏/福袋/对对碰） | 核心业务 |862| `app/common/model/BlindBoxPrizeRecord.php` | 文件 | 奖品记录模型 | **抽奖核心** — 概率计算/一番赏开奖/福袋抽取/保底/领主赏/兑换/转赠/发货 | 最核心业务模型 |863| `app/common/model/MemberMoneyLog.php` | 文件 | 资金流水模型 | `set_money()` 处理所有余额/积分/佣金增减 | 资金核心 |864| `app/common/model/General.php` | 文件 | 系统配置模型 | K-V 配置存储/读取/缓存 | 被 `xn_cfg()` 调用 |865| `app/common/model/Recharge.php` | 文件 | 充值订单模型 | 充值订单创建/查询/状态管理 | |866| `app/common/model/GoodsOrder.php` | 文件 | 商品订单模型 | 商品订单管理/发货/物流 | |867| `app/common/model/WelfareRoom.php` | 文件 | 福利房模型 | 福利房数据管理 | |868| `app/common/model/WelfarePool.php` | 文件 | 福利池模型 | 福利池数据管理 | |869| `app/common/lib/Pay/` | 目录 | 支付集成 | 13 种支付方式封装（微信/支付宝/易支付/聚合/汇付/付呗/余额/积分） | 含 SDK |870| `app/common/lib/Oss.php` | 文件 | 阿里云 OSS | 文件上传/删除 | |871| `app/common/lib/Qiniu.php` | 文件 | 七牛云 | 文件上传/删除/Token | |872| `app/common/lib/Sms/Duanxinbao.php` | 文件 | 短信服务 | 短信宝短信发送 | api.smsbao.com |873| `app/common/lib/Aliyun/IdentityVerify.php` | 文件 | 身份核验 | 阿里云二要素实名认证 | Cloudauth |874| `app/common/lib/WxLogin.php` | 文件 | 微信登录 | 小程序/APP/H5 微信登录封装 | |875| `app/common/lib/PairMatchLogger.php` | 文件 | 对对碰日志 | 游戏过程日志（文件+数据库） | |876| `app/common/lib/SendEmail.php` | 文件 | 邮件服务 | PHPMailer 邮件封装 | |877| `app/common/lib/SendCode.php` | 文件 | 安全码 | 管理员操作验证码邮件 | |878| `app/common/lib/ShortLink/Bslyun.php` | 文件 | 短链接 | 变色龙云短链生成 | |879| `app/common.php` | 文件 | 全局函数 | `xn_cfg()`配置读取/`get_source()`活动来源/`get_integer_price()`积分抵扣/订单号生成/退款 | |880| `app/command/SendDailyRankPrize.php` | 文件 | 日榜奖励 | 每日排行榜奖品发放定时任务 | cron |881| `app/command/SendWeeklyRankPrize.php` | 文件 | 周榜奖励 | 每周排行榜奖品发放定时任务（周一） | cron |882| `app/command/WelfareRoomLottery.php` | 文件 | 福利房开奖 | 定时检查到期福利房并执行开奖 | cron |883| `app/command/CleanQueue.php` | 文件 | 清理排队 | 清理超过 3 分钟的排队超时记录 | cron |884| `app/command/CheckLordExpiration.php` | 文件 | 领主过期 | 标记超 24h 领主记录为过期 | cron |885| `app/command/ClearRankingData.php` | 文件 | 清理排行 | 重置爬塔排行榜与缓存 | cron |886| `app/command/DayPopularizeLog.php` | 文件 | 推广统计 | 每日邀请推广战绩统计 | cron |887| `app/command/Caiji.php` | 文件 | 商品采集 | 外部 API 商品采集并上传 OSS | 按需 |888| `app/command/MigrateYifanshangBox.php` | 文件 | 一番赏迁移 | 旧数据迁移到新赏箱系统 | 一次性 |889| `config/app.php` | 文件 | 应用配置 | 时区/默认应用/URL 后缀/错误显示 | |890| `config/database.php` | 文件 | 数据库配置 | MySQL 连接/表前缀 `xn_` | 读 `.env` |891| `config/jwt.php` | 文件 | JWT 配置 | 密钥/TTL/Token 获取方式 | |892| `config/redis.php` | 文件 | Redis 配置 | 连接地址/端口/密码 | |893| `config/console.php` | 文件 | 命令注册 | CLI 命令类注册 | |894| `extend/alipay/` | 目录 | 支付宝 SDK | Wap/App 支付、转账、退款 | |895| `extend/Predis.php` | 文件 | Redis 客户端 | Redis 连接封装 | |896| `public/index.php` | 文件 | 入口文件 | Web 入口、CORS 设置、路径定义 | |897| `public/sql.txt` | 文件 | 数据库结构 | 数据库初始化 SQL | |898| `.env` | 文件 | 环境变量 | 数据库/JWT/版本/域名等敏感配置 | **勿提交** |899| `composer.json` | 文件 | 依赖管理 | Composer 包依赖定义 | |900 901---902 903## 附录 A：核心业务流程简述904 905### A1. 盲盒开箱流程906 907```908用户下单 → Pay.go_pay() 生成充值订单 → 支付渠道下单909    → 支付成功 → Notify 回调 → 创建盲盒订单 (BlindBoxOrder.add_order)910    → 用户点击开箱 → BlindBox.open() → BlindBoxOrder.order_open()911    → BlindBoxPrizeRecord.get_open_prize() 概率抽奖912    → 生成奖品记录 → 用户查看奖品 → 兑换/发货/转赠913```914 915### A2. 对对碰流程916 917```918选择心愿商品 → choose_wish_goods()919    → 54张卡牌初始化 → 逐次翻牌碰撞 pair_box_collision()920    → 匹配成功：获得对应商品921    → 匹配失败：计数+1，达到保底次数(3/6/9/14)触发保底922    → 心愿卡出现：open_wish_card() 直接获得心愿商品923    → 游戏结束924```925 926### A3. 支付回调分发流程927 928```929支付渠道回调 → Notify.recharge_xxx_notify()930    → 验证签名 → recharge_notify()931    → 更新充值订单状态 → 根据 order_type 分发：932        ├── type=1: add_blind_box_order (盲盒订单)933        ├── type=2: add_goods_order (商品订单)934        ├── type=3: batch_apply_deliver (批量发货)935        ├── type=4: add_balance_recharge (余额充值)936        └── type=5: add_goods_to_warehouse (商品入仓)937    → 消费等级检查升级 → 分销佣金结算938```939 940### A4. 福利房开奖流程941 942```943创建房间 (从仓库选择奖品) → 其他用户加入 (检查消费门槛/密码/容量)944    → 人满触发 / 定时触发 → WelfareRoomLottery 执行开奖945    → 随机抽取中奖者 → 奖品转移到中奖者仓库946```947 948---949 950## 附录 B：数据库表清单951 952| 表名 | 说明 |953|------|------|954| `xn_member` | 会员 |955| `xn_member_address` | 收货地址 |956| `xn_member_bank` | 银行卡 |957| `xn_member_level` | 会员等级 |958| `xn_member_consumption_level` | 消费等级 |959| `xn_member_money_log` | 资金流水 |960| `xn_member_commission_log` | 佣金记录 |961| `xn_member_popularize_log` | 推广日志 |962| `xn_member_share_log` | 分享日志 |963| `xn_member_qiandao_log` | 签到日志 |964| `xn_member_withdrawal` | 提现记录 |965| `xn_member_coupon_list` | 用户优惠券 |966| `xn_member_cdkey_log` | CDKEY 兑换日志 |967| `xn_member_card` | 用户道具卡 |968| `xn_member_token` | 用户 Token |969| `xn_blind_box` | 盲盒分类 |970| `xn_blind_box_goods` | 盲盒商品 |971| `xn_blind_box_odds` | 盲盒概率 |972| `xn_blind_box_odds_group` | 概率分组 |973| `xn_blind_box_buy` | 购买方案 |974| `xn_blind_box_order` | 盲盒订单 |975| `xn_blind_box_prize_record` | 奖品记录 |976| `xn_blind_box_prize_give_log` | 转赠日志 |977| `xn_blind_box_queue` | 排队记录 |978| `xn_blind_box_lock` | 盲盒锁定 |979| `xn_blind_box_xiang` | 一番赏赏箱 |980| `xn_blind_box_fukubukuro` | 福袋 |981| `xn_blind_box_match_record` | 对对碰记录 |982| `xn_blind_box_match_guarantee_goods` | 对对碰保底商品 |983| `xn_blind_box_lord_record` | 领主记录 |984| `xn_goods` | 商品 |985| `xn_goods_menu` | 商品分类 |986| `xn_goods_order` | 商品订单 |987| `xn_goods_kami` | 虚拟卡密 |988| `xn_recharge` | 充值订单 |989| `xn_welfare_room` | 福利房 |990| `xn_welfare_room_participants` | 福利房参与者 |991| `xn_welfare_room_winners` | 福利房中奖者 |992| `xn_welfare_room_goods` | 福利房商品 |993| `xn_welfare_pool` | 福利池 |994| `xn_welfare_pool_record` | 福利池记录 |995| `xn_welfare_pool_prize` | 福利池奖品 |996| `xn_general` | 系统配置 |997| `xn_admin` | 管理员 |998| `xn_auth_rule` | 权限规则 |999| `xn_auth_group` | 角色组 |1000| `xn_auth_group_access` | 角色权限关联 |1001| `xn_admin_log` | 管理员操作日志 |1002| `xn_red_packet` | 红包 |1003| `xn_red_packet_log` | 红包领取记录 |1004| `xn_coupon` | 优惠券模板 |1005| `xn_cdkey` | 兑换码 |1006| `xn_task_list` | 任务列表 |1007| `xn_task_user_log` | 任务完成日志 |1008| `xn_qiandao_set` | 签到配置 |1009| `xn_integral_points_goods` | 积分商品 |1010| `xn_integral_points_goods_category` | 积分商品分类 |1011| `xn_integral_points_coupon` | 积分优惠券 |1012| `xn_tower_levels` | 爬塔层级 |1013| `xn_tower_logs` | 爬塔日志 |1014| `xn_tower_user_status` | 用户爬塔状态 |1015| `xn_userpk_log` | 擂台 PK 日志 |1016| `xn_sys_reward` | 系统奖励 |1017| `xn_comment` | 评论 |1018| `xn_notice` | 公告 |1019| `xn_advert` | 广告 |1020| `xn_news` | 新闻 |1021| `xn_agreement` | 协议 |1022| `xn_cooperation` | 合作申请 |1023| `xn_sms_log` | 短信日志 |1024| `xn_newer` | 新人活动 |1025| `xn_zhuanti` | 专题 |1026| `xn_card` | 道具卡模板 |1027| `xn_bank_list` | 银行列表 |1028| `xn_short_link` | 短链接 |1029| `xn_version_manager` | 版本管理 |1030| `xn_app_version` | APP 版本 |1031| `xn_friendly_link` | 友情链接 |1032| `xn_kuaidi100_code` | 快递编码 |1033| `xn_upload_files` | 上传文件 |1034 1035---1036 1037## 附录 C：环境变量配置项（.env）1038 1039| 配置项 | 说明 |1040|--------|------|1041| `DATABASE_HOSTNAME` | 数据库主机 |1042| `DATABASE_DATABASE` | 数据库名 |1043| `DATABASE_USERNAME` | 数据库用户名 |1044| `DATABASE_PASSWORD` | 数据库密码 |1045| `DATABASE_HOSTPORT` | 数据库端口 |1046| `DATABASE_PREFIX` | 表前缀（`xn_`） |1047| `JWT_SECRET` | JWT 签名密钥 |1048| `APP_DEBUG` | 调试模式 |1049| `APP_VERSION` | 应用版本 |1050| `APP_HOST` | 应用域名 |1051| `APP_ISDEMO` | 是否演示模式 |1052 1053---1054 1055> **文档说明**: 本文档基于源码静态分析自动生成，覆盖项目主要目录、文件和业务逻辑。如有新增模块或业务变更，请及时更新本文档。

感谢您的来访，获取更多精彩文章请收藏。