高校宿舍「出入寝数据」如何与闸机、门禁系统打通？

出入寝数据与闸机、门禁的打通，本质是把闸机的一条条通行记录变成可判定的归寝状态：先有身份核验与通行事件，再有晚归、未归判定。顺序反了，后面所有预警都是空中楼阁。

一、整条链路怎么走

身份核验：刷卡、人脸比对、密码三选一。人脸按入住楼宇自动下发照片，入住即开通、退宿即回收；照片不合格会提醒、下发失败可重试。

产生通行记录：门禁按入口与出口分别登记，门禁类型分住宿通行（按入住自动下发）与全员通行。

上报：集成层由开放平台、标准 API 与消息队列组成，对外是定时推送与事件回调两种模式，第三方凭应用 ID 与密钥调用、逐项授权数据范围。别让对接方直连业务库表，会绕开接口级授权。

归集：刷卡与人脸数据自动同步到出入寝模块，实时记录进出时间，支撑归寝记录、未归预警与考勤判定；考勤复用门禁闸机。

判定：归寝时段按周一至周日分别设开始、结束与归寝截止时间，可按校区或专业班级单独设，假期自动忽略；比对后标记未出与未归，连续超过自定义天数未归自动生成预警。

二、四个关键对接点

设备协议。 硬件接入支持 RS485、Modbus、MQTT、蓝牙、OPC-UA 等协议与标准 API，门禁走门禁网关，已对接人行闸机与宇视、海康门禁设备。

主数据同步。 学号、楼栋、房间、床位先对齐，账号校内不重复并与一卡通证件号映射。没对齐，通行事件找不到人。

通行事件字段。 时间、进出方向、人员、设备编号缺一不可。缺了方向与编号，分不清刷的是宿舍楼闸机还是校门。

状态参与判定。 请假分晚归（只能当天申请）与外出外宿（期间不在宿舍住）；假期可按专业班级单独放假，考勤时段可分别设假期是否考勤。走读、实习长期不在校的，在考勤「绑定人员」里直接不纳入，比事后销假干净。

三、五个常见坑

断网后的离线记录。 私有化部署下网关与门禁同内网通信，判定不因外网中断停摆。但缓存多久、补传顺序、重复记录怎么去重，要写进实施范围。

设备时间校准。 判定以设备时间戳为准，几十台闸机各走各的钟必然对不上，统一时间源进实施清单。

代刷与一人多卡。 账号校内不重复、管理卡挂失后权限暂停、人脸绑定校验照片质量、归寝异常稽查人工复查。技术只压低概率，配合查寝才闭环。

数据延迟误判晚归。 别盯单日快照，用「连续超过自定义天数未归」更稳；归寝时段配假期忽略，否则寒暑假天天报警。

人脸隐私与合规。 私有化部署下人脸数据校内存储不出校，仅用于门禁通行、门锁开锁与考勤比对，退宿即回收；传输 TLS 1.2 及以上，敏感信息 AES-256 存储。收集范围与保存期限以学校制度为准。

索蓝云实施工程师反复提醒的一点：这条链路上最容易掉链子的不是闸机，是主数据。楼栋、床位、账号没对齐，报表也错。

四、分阶段落地

第一阶段先采通行。 门禁建档、时段配好、记录能查，目标是「有数据」，别急着开预警。

第二阶段统一身份。 卡号、人脸、学号与床位对齐，把通行事件落到具体的人。

第三阶段再做预警。 归寝时段、晚归登记、连续未归预警依次启用，未归通知按学生、老师、家长分级推送。

数据流向：学生刷卡或刷脸，闸机产生通行事件，门禁网关回传，出入寝模块比对归寝时段，判定归寝、晚归或未归，进晚归登记与三类报表，通知推送学生、老师、家长，最后移动端复核回写。