健身房AB门管控方案:IoT门禁对接与异常告警模块设计思路
一、方案背景与痛点
24小时无人健身房依靠AB互锁门禁实现防尾随管控,整套系统需要打通IoT网关、门禁控制器、门磁传感器、AI摄像头与后端业务平台。在项目落地中,经常遇到硬件协议不统一、云端和网关状态不同步、异常事件缺少分级处置、断网后告警失效等问题。
单纯依靠云端下发开门指令,网络抖动时容易出现门控错乱;告警没有做收敛,短时间内批量推送重复消息,运维人员无法识别高优先级风险。本文围绕IoT网关对接、AB门互锁状态管理、异常告警模块设计,介绍可落地的技术实现思路。
二、整体架构与IoT网关对接设计
系统分为三层:硬件感知层、边缘网关层、云端业务层。
硬件感知层包含A门外门、B门内门、门磁、人脸识别/扫码设备、通道摄像头、声光报警器;边缘网关作为核心中转节点,采用MQTT协议和云端通信,本地维护AB门状态机,互锁逻辑、人数检测、本地声光告警都在网关侧执行;云端负责会员权限校验、权限下发、日志持久化、告警消息推送、后台管理。
网关和云端采用双向通信:网关主动上报门状态、通行事件、抓拍数据;云端下发权限变更、远程解锁、告警复位指令。消息采用QoS1保证投递,避免通行事件丢失。网关本地缓存权限白名单,断网时独立完成通行校验和基础告警,网络恢复后批量同步日志。
三、AB门互锁通行状态逻辑
AB门核心互锁规则:A门开启期间B门强制锁定,B门开启期间A门强制锁定;必须收到门磁关门信号,才允许进入下一次核验流程;人员进入缓冲通道后,AI摄像头检测通道人数,识别到多人尾随直接触发本地告警,拒绝开启B门。
正向入场流程:用户发起核验→网关上报云端校验权限→校验通过,解锁A门→用户进入缓冲区,A门关门上锁→AI判定单人通行→解锁B门进入场馆→B门关闭,通道状态重置。离场流程反向执行。
异常分支包含通道超时滞留、门被强行打开、多次核验失败、网关离线、摄像头离线。
四、异常告警模块核心设计
告警模块做分级管理,区分一般告警、重要告警、紧急告警。
一般告警:会员权限过期、非开放时段尝试开门;
重要告警:通道超时滞留、设备离线、多次核验失败;
紧急告警:尾随闯入、暴力撬门、门长时间未关闭,触发本地声光报警,同时推送运维通知。
告警做去重与收敛,同一设备同一种告警在5分钟内只推送一次,避免消息风暴。告警记录和通行日志、抓拍图片绑定,支持在后台直接查看告警快照。
下面是告警事件处理的Java示例代码:
@Data
public class AlarmEventDTO {
private String deviceNo;
private String gymId;
private Integer alarmLevel;
private String alarmType;
private String snapshotUrl;
private LocalDateTime eventTime;
}
@Service
public class DoorAlarmService {
@Autowired
private RedisTemplate<String, Object> redisTemplate;
@Autowired
private AlarmRecordService alarmRecordService;
@Autowired
private AlarmNotifyService alarmNotifyService;
public void handleAlarmEvent(AlarmEventDTO dto) {
// 告警收敛key,设备+告警类型
String alarmKey = "gym:alarm:" + dto.getDeviceNo() + ":" + dto.getAlarmType();
Boolean exist = redisTemplate.hasKey(alarmKey);
if(Boolean.TRUE.equals(exist)){
// 短时间重复告警,只入库不推送
alarmRecordService.saveAlarm(dto, false);
return;
}
alarmRecordService.saveAlarm(dto, true);
// 设置收敛有效期5分钟
redisTemplate.opsForValue().set(alarmKey, "1", 5, TimeUnit.MINUTES);
// 分级推送通知
if(dto.getAlarmLevel() >= 2){
alarmNotifyService.sendNotice(dto);
}
}
}
五、消息幂等与状态同步机制
网关上报事件携带唯一事件ID,云端基于事件ID做幂等处理,防止网关重传消息造成重复生成通行记录、重复告警。
云端定时向网关同步最新权限,当会员续费、冻结、拉黑时,云端主动推送变更指令,网关即时刷新本地缓存,不用等待定时同步。
门状态采用双向校验:网关上报实时门状态,云端定时轮询核对,发现状态不一致时触发状态同步修复。
六、后台管理与运维能力
后台支持门禁设备在线状态看板、告警列表、通行日志查询、抓拍图片预览;支持远程解锁、远程复位告警、临时通行权限下发。同时支持告警规则配置,可自定义哪些告警开启推送、告警推送渠道。
日志和告警记录永久保存,抓拍图片设置归档策略,超过保存周期转存至低成本对象存储,降低存储成本。
七、上线优化与边界处理
上线后发现两个典型问题:网络波动时网关上报大量短暂离线告警,增加离线判定延迟,连续30s没有心跳才判定离线;部分场景AI人数识别存在误判,后台增加人工复核入口,支持告警标记误报。
消防场景做特殊兼容,消防信号接入网关,收到消防信号后自动解除AB门互锁,两门同时解锁,保障疏散通道畅通。
总结
这套AB门管控方案的核心是把互锁逻辑下沉到IoT边缘网关,云端只负责权限和告警管理,实现断网可用;告警模块通过分级、收敛、快照绑定,解决无人值守场景下风险识别和消息泛滥问题。
基于MQTT的IoT对接方式具备良好的通用性,可以适配不同厂商门禁控制器,不需要深度绑定硬件。告警和通行日志联动,每一次异常事件都可追溯,适合24小时自助健身房、自助场馆等无人场景。后续扩展多区域门禁、人脸识别升级时,只需要新增告警类型和权限维度,基础的网关对接、告警处理框架不需要大规模改动。