街机超人是一套连接平台运营、代理商、微信用户和线下街机设备的软硬件系统。用户可以按设备配置购买游戏币,也可以把账户中的游戏币发送到现场设备;运营方负责设备投放、在线状态、订单、代理收益、提现和活动运营。
项目后期又增加了游戏中心、抽奖活动、幸运币、积分、红包、礼物领取、公众号和小程序能力,因此当前目录同时包含设备交易主链路与用户增长活动链路。
项目组成
原目录包含四个独立 Git 仓库:
| 项目 | 技术形态 | 主要职责 |
|---|---|---|
jieji |
Yii 2、PHP 7、Vue 2、Element UI | 旧主系统,覆盖平台后台、代理端、用户 H5、订单、设备、MQTT 回执、收益和提现 |
new_jieji |
ThinkPHP 6、多应用模式、Redis、微信 SDK | 新业务与迁移工程,覆盖游戏中心、抽奖、小程序、公众号、设备事件和兼容接口 |
jjcr_mqtt_cmd |
ThinkPHP 6、phpMQTT | 轻量 MQTT 指令发布桥,按设备 IMEI 向 Broker 发布命令 |
eh-web-ow |
Node.js、Express、Handlebars | 产品介绍、招商加盟、新闻与关于页面等公开官网 |
new_jieji 中还保存 Vue 2 管理端模板和微信小程序抽奖模板。它们属于新系统的客户端源码,不是额外的后端服务。
核心业务
- 管理平台管理员、代理商、渠道、用户和权限;
- 通过 IMEI 建立设备档案,记录激活、归属、位置、在线时长和异常状态;
- 为不同设备配置金额与游戏币数量的兑换关系;
- 接收微信支付结果,创建订单并向在线设备发送出币命令;
- 维护用户在代理体系下的游戏币余额,并支持余额投币;
- 根据订单与代理层级记录收益,处理提现申请;
- 接收设备上线、离线、缺货、卡纸和命令执行回执;
- 运营游戏资料、礼包分类和兑换码;
- 运营抽奖专区、幸运币、积分、红包、礼物领取和积分商城;
- 通过公众号与小程序完成登录、授权、素材回复和用户触达。
架构重点
系统必须把“支付成功”“命令已发布”“设备已执行”和“收益已结算”视为不同状态。网络超时、设备离线或重复回调都可能让这些状态暂时不一致,不能用一次同步请求假设整个链路已经完成。
另一个重点是旧 Yii 与新 ThinkPHP 系统并存。两套系统共享或兼容一部分设备、订单和用户数据,但订单、游戏币、MQTT 命令与收益必须明确唯一主写方,避免双写和重复结算。
阅读路径
先阅读系统架构,了解四个仓库和各业务模块如何协作;再阅读支付投币与设备回传流程,理解一笔交易怎样走到实体设备并完成对账。