工程

离线优先是队列,不是口号

2026年11月12日 · Software by Design

护理人员在地下室没有网络的情况下记录家访。打卡终端在工地 wifi 断掉时继续打卡。“支持离线”印在功能清单上很容易:重要的是这些记录究竟会发生什么,以及什么绝不会发生在它们身上。

发件箱,如实说明

断网时,我们的配套应用不会把记录“放在内存里”碰运气。每条待处理的打卡进入设备上的加密队列:本地存储中的 AES-GCM 密文,密钥放在平台安全保险库:上限 32 条,以免一条死连接养出无限积压。队列先进先出,连接恢复后自动清空。

静态加密是那个重要但不显眼的部分:一条打卡记录就是个人数据。“只在手机里放了一小时”不是设备失窃时的答案。

为什么由服务器裁决,而不是手机

重放排队记录正是离线功能通常撒谎的地方。一次重试可能到达两次;两个排队动作可能乱序到达。所以每条打卡都带一个客户端生成的请求标识和真实时间戳:事情发生的时间,不是它到达的时间。服务器在任何写入之前先登记标识:重复的重放变成无操作,而不是重复记录。标识相同、内容不同?那是 409 冲突,不是静默覆盖。而合规性按打卡时刻评估:07:02 打卡、07:03 重放的记录计为 07:02,只要在组织配置的偏差窗口内(默认 24 小时,硬上限 72)。

自助终端变体解的是同一问题的更硬版本:设备上没有个人会话。刷卡通过一个有界加密的 NFC 身份缓存解析:最多 500 条、TTL 七天:这样终端断连不会变成门口排队。

我们给自己设的边界

离线容忍是一个窗口,不是生活方式。早于配置偏差的记录不再重放,而是浮现出来让一个人去决定,一周后凭空冒出来的“上班打卡”恰恰是毁掉工时台账可信度的机制。带着待处理打卡退出登录的人会被明确告知,等待还是丢弃,由您选,但明讲。

这就是我们应用中的“离线优先”:不是界面在没信号时还能打开,而是审计追踪能挺过一次断网。ArbeitszeitCheck 移动端和终端,以及 CareCheck,今天就提供这些。