健身房系统开发搭建详解:自助健身小程序核心功能与技术架构
一、项目背景与业务目标
24小时自助健身房依赖小程序完成全部自助流程,无需前台人工值守。传统健身房管理系统大多只做会员登记,缺少门禁联动、按时计费、动态通行凭证、自助购卡等自助能力。本文介绍一套基于SpringBoot+微信小程序的自助健身系统搭建方案,打通会员、订单、计费、IoT门禁,实现用户线上购卡、扫码入场、自动计时扣费、离场结算的完整闭环。
二、整体技术架构
采用前后端分离+IoT边缘网关分层架构,分为小程序端、业务服务层、边缘网关层、硬件感知层。
- 小程序端:微信原生小程序,负责门店展示、购卡、订单、通行码、入场记录;
- 后端服务:SpringBoot + MyBatis-Plus + Redis + MySQL,提供REST接口,处理会员、订单、计费、权限下发;
- 消息通信:MQTT对接边缘网关,WebSocket推送入场、扣费、告警消息;
- 边缘网关:本地缓存会员通行权限,对接门禁、储物柜、传感器,支持断网放行;
- 硬件层:二维码读头、人脸门禁、AB门控制器、智能储物柜、能耗采集设备。
架构设计原则:业务逻辑放在云端,实时控制、防尾随校验下沉到本地网关,网络波动时不影响会员正常入场。
三、小程序核心功能模块
- 门店模块:多门店切换、门店地址导航、营业时间、场地设备展示、实时客流查看。
- 会员购卡模块:次卡、日卡、月卡、时段卡、储值套餐,对接微信支付,购卡成功自动开通通行权限。
- 通行凭证模块:动态二维码,设置短有效期,防止截图复用;支持人脸信息上传、人脸权限同步下发门禁。
- 自助计费模块:按入场时长计费,支持封顶价格,离场自动结算,欠费限制入场。
- 订单与账单:购卡记录、入场记录、扣费明细、退款申请。
- 辅助功能:储物柜预约、私教预约、器材报修、紧急呼叫、协议与隐私说明。
- 个人中心:会员有效期、余额、人脸管理、账号绑定。
四、核心业务流程:入场与自动计费
会员入场流程:用户在小程序购买有效卡券 → 系统生成通行权限,同步至Redis与边缘网关 → 小程序加载动态通行码 → 门禁扫码核验 → 核验通过开门,网关上报入场事件 → 后端开启计时任务 → 会员离场扫码 → 停止计时,按规则计算费用,余额自动扣费,生成本次账单。
如果是套餐次卡,入场直接扣减次数,不按时间计费。系统需要处理中途断网、重复扫码、长时间滞留等异常场景。
// 入场计费服务核心片段
@Service
public class GymChargeService {
@Autowired
private MemberCardMapper cardMapper;
@Autowired
private ChargeRecordMapper chargeRecordMapper;
public ChargeResult startCharge(Long memberId, Long storeId) {
MemberCard card = cardMapper.selectValidCard(memberId, storeId);
if (card == null) {
return ChargeResult.fail("无有效健身权限");
}
ChargeRecord record = new ChargeRecord();
record.setMemberId(memberId);
record.setStoreId(storeId);
record.setEnterTime(LocalDateTime.now());
record.setStatus(1);
chargeRecordMapper.insert(record);
return ChargeResult.success(record.getId());
}
}
五、IoT门禁权限同步机制
权限同步采用云端增量下发+网关本地缓存的模式。
会员购卡、卡过期、会员拉黑时,云端推送权限变更消息到MQTT,网关接收后更新本地权限缓存;门禁扫码时优先本地校验,不依赖云端接口,保证断网可用。
动态通行码增加签名校验,携带会员ID、门店ID、时间戳,服务端校验签名和时间窗口,防止截图二次使用。通行日志先本地落盘,联网后批量同步到云端。
六、后台管理配套能力
配套PC管理后台,用于门店管理、卡种配置、价格设置、会员管理、通行日志查询、财务对账、设备在线状态监控、告警查看。
管理员可以手动冻结会员权限、查看入场抓拍、导出每日营收报表,配置时段定价,例如夜间优惠、高峰加价。
七、开发与联调测试要点
- 业务测试:购卡核销、入场离场、计时扣费、次卡扣减、欠费拦截;
- 安全测试:通行码防重放、越权访问、恶意重复扫码;
- 弱网测试:网络中断场景下,网关本地放行,恢复后自动同步账单;
- 硬件联调:门禁开门事件、门磁状态、告警信号的上报与回调;
- 对账校验:订单金额、扣费记录、支付流水三方核对,避免资金差异。
八、部署与运维建议
后端服务部署在云服务器,MySQL定时备份,Redis缓存通行权限与热点会员数据;MQTT服务可以选用云消息服务或者自建。
网关部署在健身房本地局域网,和门禁设备在同一内网,减少公网链路延迟。运维重点监控设备离线、长时间滞留、扣费异常告警,定期清理过期的通行日志。
九、总结
自助健身小程序的核心,不只是简单的线上购卡页面,而是会员权益、自动计费、IoT门禁联动的一体化系统。整套架构依靠云端负责业务与数据,边缘网关保障本地通行高可用,动态二维码、权限预下发机制解决无人值守场景下的断网通行、防截图、防尾随等痛点。
开发时优先保证计费和入场链路稳定,再迭代私教、储物柜、客流统计等扩展功能;同时做好权限隔离、日志留存和对账机制,降低自助场馆运营风险。该架构支持多门店横向扩展,后续可继续叠加体测设备、灯光能耗控制等更多IoT能力。