工程

離線優先是佇列,不是口號

2026年11月12日 · Software by Design

照護人員在地下室沒有網路的情況下記錄家訪。自助服務機在工地 wifi 斷線時繼續打卡。「支援離線」印在功能清單上很容易:重要的是這些記錄究竟會發生什麼,以及什麼絕不會發生在它們身上。

寄件匣,如實說明

斷線時,我們的配套應用不會把記錄「放在記憶體裡」碰運氣。每筆待處理的打卡進入裝置上的加密佇列:本機儲存中的 AES-GCM 密文,金鑰放在平台安全保存庫:上限 32 筆,以免一條死連線養出無限積壓。佇列先進先出,連線恢復後自動清空。

靜態加密是那個重要但不顯眼的部分:一筆打卡記錄就是個人資料。「只在手機裡放了一小時」不是裝置失竊時的答案。

為什麼由伺服器裁決,而不是手機

重送排隊記錄正是離線功能通常說謊的地方。一次重試可能送達兩次;兩個排隊動作可能亂序到達。所以每筆打卡都帶一個用戶端產生的請求識別碼和真即時間戳: 事情發生的時間,不是它到達的時間。伺服器在任何寫入之前先登記識別碼:重複的重送變成無操作,而不是重複記錄。識別碼相同、內容不同?那是 409 衝突,不是靜默覆蓋。而合規性按打卡時刻評估:07:02 打卡、07:03 重送的記錄計為 07:02,只要在組織設定的偏差時間窗內(預設 24 小時,硬上限 72)。

自助服務機變體解的是同一問題的更硬版本:裝置上沒有個人工作階段。刷卡透過一個有界加密的 NFC 身分快取解析:最多 500 筆、TTL 七天:這樣終端斷線不會變成門口排隊。

我們給自己設的界線

離線容忍是一個時間窗,不是生活方式。早於設定偏差的記錄不再重送,而是浮現出來讓一個人去決定:一週後憑空冒出來的「上班打卡」恰恰是毀掉工時帳本可信度的機制。帶著待處理打卡登出的人會被明確告知:等待還是捨棄,由你選,但明講。

這就是我們應用中的「離線優先」:不是介面在沒訊號時還能打開,而是稽核軌跡能挺過一次斷線。ArbeitszeitCheck 行動端和終端,以及 CareCheck,今天就提供這些。