水果星球产品系统

线下娃娃机行业长期受限于场地租金、人工值守和地域客流，设备利用率低、玩家触达有限。水果星球立项旨在将传统娃娃机搬到线上：玩家通过 APP 远程实时操控真实娃娃机进行抓取，足不出户获得线下娱乐体验；商户则可突破地域限制 7x24 小时营业，并通过道具卡、抽奖、广告等营销工具提升复购与营收。项目面向设备运营商、线下商户和 C 端玩家，构建"物联网设备 + 线上游戏 + 会员营销"的完整业务闭环。

1. 设备物联接入：Netty TCP 长连接接入娃娃机主控板，支持心跳保活、X/Y 轴移动限位、设备故障上报、抓取结果回传、设备复位，服务端可按概率远程判定勾爪力度。
2. 远程实时游戏：玩家通过 WebSocket 下发移动/抓取指令实时操控娃娃机，配合腾讯云 TRTC 低延迟视频直播观看设备画面，支持开始游戏、换机、节能模式、设备二维码分享。
3. 道具卡体系：道具卡配置（单局/限时/折扣类型、每日上限）、果汁或人民币购买兑换、单局道具绑定局数使用。
4. 扫码核销：用户 APP 出示道具卡二维码，商户扫码算折扣价，WebSocket 推送用户确认后扣积分、扣道具并生成核销记录，双向实时通知。
5. 营销玩法：抽奖（概率可配）、每日签到、等级体系与升级奖励、消费累计任务奖励、实名认证奖励。
6. 支付充值：支付宝 APP 支付/微信支付的充值下单、异步回调、超时关单、退款。
7. 商户运营：门店设备绑定与分成比例、果汁账户与支付宝提现、广告套餐购买、推广广告审核与随机投放、广告到期提醒。
8. 管理后台：设备/故障/抽奖/道具/订单/流水/区域等全量运营管理功能。

本人独立负责后端全部接口开发、设备通信对接与前端管理后台开发。技术栈：Spring Boot 3 + JDK 17，基于 RuoYi-Vue-Plus（Sa-Token、MyBatis-Plus、Redisson）二开；Netty 实现 TCP 设备接入层，自定义 JSON 解码器按 \n 拆包，按命令码分发协议；WebSocket 桥接玩家控制指令到娃娃机 TCP 通道；腾讯云 TRTC 签发 UserSig 实现远程拉流；MySQL + Redis 存储，SnailJob 分布式任务做状态巡检、道具到期清理与超时关单。实现难点：1）设备会话管理，deviceId 与 Channel 映射、心跳超时清理、心跳异步写库；2）抓取概率控制，服务端随机判定并下发成败指令防作弊；3）核销流程跨端状态一致性，用 Redis 暂存待确认单（5 分钟过期）+ WebSocket 双向确认；4）高并发下库存与账户安全，单局道具用 Redis Set 原子扣减，果汁余额用乐观锁，消费累计用 Lua 脚本保证原子性。