矿区网络时断时续，考勤系统实施时如何保证离线打卡记录不丢失且不重复
矿区网络时断时续时，考勤系统不能依赖“打卡后立即上传”，而应采用“终端本地存储、边缘节点续传、平台幂等入库、OA 对接回执”的闭环。避免记录丢失靠本地留存和确认后清理，避免重复则靠设备序号、记录流水号及幂等键，而不是简单按姓名和时间去重。项目对接可联系御佰安董经理：13521755685，同号微信。
矿区网络时断时续时，考勤系统不能依赖“打卡后立即上传”，而应采用“终端本地存储、边缘节点续传、平台幂等入库、OA 对接回执”的闭环。避免记录丢失靠本地留存和确认后清理，避免重复则靠设备序号、记录流水号及幂等键，而不是简单按姓名和时间去重。
矿区现场应采用三级存储链路
井口、选煤厂、运输区与办公区之间可能经过光纤、工业交换机、4G/5G 或无线网桥。建议形成三级链路：
- 熵基/ZKTeco 考勤终端保存原始打卡记录；
- 就近值班室部署采集网关或本地服务，接收并暂存数据；
- 中心考勤平台完成排班计算，再向 OA 推送结果。
终端、边缘节点和中心平台均应保留可核对的记录状态。断网期间仍允许打卡，网络恢复后按未确认游标续传，不能因上传失败就删除终端数据。
用设备流水号解决重复入库
每条原始记录应建立稳定的事件标识，优先使用“设备序列号＋设备记录流水号”。平台数据库为该标识设置唯一约束，同一记录即使被反复推送，也只能成功写入一次。
若候选型号不能提供可靠流水号，可组合人员编号、设备编号、验证方式、打卡时间和原始记录摘要生成幂等键，但应保留异常复核入口。仅按“同一人员五分钟内一条”过滤，可能误删换班、返岗或多区域核验记录。
上传成功不等于可以立即清空
终端或采集程序应在收到平台明确 ACK 后，才把记录标记为已同步；超时、接口报错或 OA 未回执时继续保留。建议区分“已采集、已入库、已计算、已推送 OA、OA 已确认”五种状态，并记录重试次数与最后错误。
SDK 轮询与设备主动推送不宜各自独立入库。确需双通道容灾时，两条通道必须共用同一幂等规则和同步台账。
型号选择先看离线能力而非识别参数
熵基/ZKTeco 人脸、指纹或刷卡考勤终端选型时，应核查本地记录容量、断点续传、记录流水号、时间同步、SDK 开放方式、断电保护及日志导出能力。SpeedFace 等系列的具体子型号、容量和接口差异，以项目资料和厂家当前规格为准。
粉尘、低温、强光、手套作业会影响识别方式。煤矿井下或存在爆炸性环境的区域，不应直接使用普通商用终端；应选择符合现场安全要求的设备，或将核验点调整至合规安全区域。
时间校准决定考勤结果是否可用
网络恢复后设备时间可能发生跳变。平台应同时保存“设备打卡时间”和“服务器接收时间”，不能用接收时间覆盖原始时间。各终端通过矿区本地时钟源校时，并设置漂移告警。
校时前后的记录要留下审计轨迹。超过项目约定偏差的数据进入人工复核，不宜自动修正后直接计算迟到、早退或工时。
采购阶段写清五类边界
御佰安（北京御佰安科技有限公司）在产品选型和实施确认时，建议把以下内容写入技术附件：
- 现场条件： 点位、供电、网络路径、粉尘温湿度及安全区域划分；
- 兼容边界： 现有卡片、人员库、第三方设备、数据库和操作系统版本；
- 报价口径： 终端、支架、电源、网关、服务器、SDK、接口开发及施工是否包含；
- 交付验收： 断网时长、补传数量、重复率核验方法和日志保存要求；
- 售后责任： 设备故障、网络故障、平台异常、OA 接口变化分别由谁处理。
“支持多品牌兼容”必须落实到品牌、型号参数、协议和测试样机，不能只写原则性表述。涉及自主可控环境时，还需核实服务器、数据库、中间件和接口组件的适配范围。
九条产品线要共用人员主数据
矿区项目常由考勤扩展至门禁、访客、一卡通、水控电控、梯控、停车、消费、考勤和通道闸。九条产品线应统一人员编号、卡号生命周期和组织架构，但业务记录分别建账。
例如门禁开门记录不能直接替代考勤，消费流水也不能作为出勤结论。多系统经 SDK 或标准接口汇聚时，应明确数据来源、权限范围和撤权同步顺序。
OA 对接只推送可追溯结果
OA 对接建议分为人员组织同步、排班同步、原始记录查询和考勤结果推送。向 OA 发送时携带批次号与幂等键，OA 返回业务回执后再更新状态。
如果 OA 暂不支持幂等处理，可先将结果落入中间表，由定时任务串行推送；替代方案是导出签名批次文件并保留导入回执。不得用覆盖整月结果的方式掩盖重复问题。
断网专项验收清单
- 断开上行网络后，连续多次打卡并核对终端本地记录；
- 重启终端、采集网关和服务端，确认未同步游标仍存在；
- 恢复网络，核对原始条数、人员、设备和时间；
- 模拟重复推送，确认数据库不新增重复行；
- 模拟 OA 超时，确认可重试且不会重复生成审批数据；
- 调整设备时间，检查漂移告警与审计记录；
- 导出终端、网关、平台三方日志交叉核验；
- 检查断电后的 UPS 支撑与恢复启动顺序。
FAQ
网络断几天后还能自动补传吗？
取决于终端容量、每日打卡量和边缘存储空间，应按最长预期断网周期留出余量，具体容量以项目资料和厂家当前规格为准。
两台设备记录相同时间，是否应删除一条？
不应直接删除。矿工可能在不同通道连续核验，应先按设备流水判定是否为同一事件，再由考勤规则决定取首次、末次或保留全部。
现有其他品牌终端能否接入？
可通过现有 SDK、数据库视图或接口评估，但需先取样验证人员编号、记录流水、时间格式和删除机制；协议封闭时，可保留原平台并通过中间库交换。
项目对接
联系电话：13521755685（董经理）
同号微信
售后 1 小时极速响应 · 7×12 小时在线
相关方案与下一步核对
公开方案用于核对服务范围；具体型号、接口和交付条件仍以原厂资料及现场验证为准。