24小时自助健身小程序开发实战：从零搭建全流程指南

南城以南溫暖如初147

125人浏览 · 2026-09-11 16:00:41

南城以南溫暖如初147 · 2026-09-11 16:00:41 发布

一、项目背景与技术选型

24小时自助健身小程序的本质是将传统健身房的人力依赖（前台、教练推销）替换为软件自动化流程。用户在深夜或清晨到店，通过小程序完成门禁通行、设备启动、计费扣款，全程无人干预。我在开发此类项目时，参考了无人台球室、自助茶室等成熟领域的架构经验，尤其是"线上开台、自动计费"的模型。

技术栈选择遵循"快速落地、稳定省成本"的原则：

后端服务：Spring Boot + MyBatis Plus + MySQL
- Why：MyBatis Plus 对单表 CRUD 有极大简化，适合业务逻辑集中在订单、会员、设备状态流转的场景。MySQL 足够支撑单店到几十家连锁店的规模。
管理后台：Vue + Element UI
- Why：Element UI 组件成熟，开发表格、表单、权限管理效率高。
用户端小程序：uniapp（Vue 语法）
- Why：适配小程序、H5、甚至未来可能上架的抖音小程序。一套代码多端复用，节省维护成本。
硬件对接：IoT 网关 + HTTP 回调 / MQTT 长连接

二、核心功能模块设计

24小时自助健身小程序不同于普通预约系统，它强调 “门禁-设备-计费” 三条主链路。

2.1 门禁通行闭环

用户到店后，小程序通过蓝牙或扫码向门禁控制器发送开门指令。这里的安全设计是核心：

生成一次性动态，有效期 30 秒，防止截图转发。
服务端记录每次开门请求的 IP 与设备指纹。

2.2 设备控制与状态同步

用户在小程序上选择"开跑步机"或"开灯"，指令链路是：

用户端小程序 → 后端API → IoT网关 → 设备
设备状态变化 → IoT网关 → 后端WebSocket → 用户端实时更新

这里建议采用 状态机设计（待机/运行/暂停/故障），避免用户多次点击造成重复扣费。

2.3 自动计费引擎

这是核心的业务逻辑，比跑腿系统中的计费更为复杂。参考无人台球室系统的思路，可采用两套计费模式并存：

按时计费：按分钟计费，用户扫码开台，离场自动结算。
次卡/时段卡：用户提前购买次卡，每次入场扣除次数，不用处理金额计算。

计费引擎的伪代码逻辑如下：

public class BillingEngine {
    // 会话开始时间、结束时间、单价（按分钟）
    public Bill calculate(Session session, PricingRule rule) {
        long minutes = Duration.between(session.getStartTime(), session.getEndTime()).toMinutes();
        // 取整：不满15分钟按15分钟算，避免收益漏洞
        int billableMinutes = (int) Math.ceil(minutes / 15.0) * 15;
        double amount = billableMinutes * rule.getUnitPrice();
        // 叠加优惠券抵扣
        return new Bill(amount, discount);
    }
}

2.4 会员与营销模块

三、数据库表结构设计与核心实现

3.1 核心表设计

关键表包括：

member（会员表）：含余额、有效期、等级。
device（设备表）：含门店ID、设备类型、状态。
order（订单表）：含会员ID、门店ID、设备ID、开始时间、结束时间、金额。
door_record（门禁记录）：含用户ID、开门时间、开门方式。

3.2 订单状态流转

订单状态字段建议用 Integer 存储常量：

public enum OrderStatus {
    PENDING(0, "已开台未开始"),
    RUNNING(1, "进行中"),
    FINISHED(2, "已结束待结算"),
    SETTLED(3, "已结算"),
    CANCELLED(4, "已取消");
}

3.3 防并发穿透设计

在设备控制接口中，必须加入分布式锁（Redis or 数据库乐观锁）。否则用户连续点击两次"开机"，会产生两台设备同时启动的 bug。

// 使用 Redis 锁，key 为设备ID
boolean locked = redisTemplate.opsForValue()
    .setIfAbsent("lock:device:" + deviceId, "1", 3, TimeUnit.SECONDS);
if (!locked) {
    return Result.error("操作过于频繁");
}