Teknik

Offline-first är en kö, inte en slogan

12 november 2026 · Software by Design

En vårdare dokumenterar ett besök i en källarlägenhet utan täckning. En kioskterminal stämpler vidare medan områdets wifi ligger nere. "Fungerar offline" står lätt på en funktionslista, det som räknas är vad som exakt händer med posterna, och vad som aldrig får hända.

Utkorgen, specificerad

När nätet går ner håller våra kompanjonappar inte stämplingar "i minnet" och hoppas. Varje väntande stämpling hamnar i en krypterad kö på enheten, AES-GCM-chiffertext i lokal lagring, nyckeln i plattformens säkra lagring, begränsad till 32 poster så att en död förbindelse inte låter ett obegränsat eftersläp växa. Kön är FIFO och tömmer sig själv när anslutningen kommer tillbaka.

Kryptering i vila är den ospektakulära delen som räknas: en stämpling är persondata. "Den låg bara på telefonen en timme" är inget svar på en stulen enhet.

Varför servern avgör, inte telefonen

Att spela upp köade stämplingar är där offline-funktioner brukar ljuga. En retry kan anlända två gånger. Två köåtgärder kan nå servern i fel ordning. Därför bär varje stämpling ett klientrequest-id och den riktiga tidsstämpeln, när det hände, inte när det anlände. Servern reserverar request-id:t före varje mutation: en dubblerad retry blir en no-op istället för en dubbelstämpling. Samma id, annat innehåll? Det är en 409-konflikt, inte en tyst överskrivning. Och efterlevnad utvärderas mot stämplingens ögonblick, en eftersänd instämpling 07:02 räknas som 07:02, inom det skew-fönster organisationen konfigurerar (24 timmar som standard, hårt tak 72).

Kioskvarianten löser en tuffare version av samma problem: ingen personlig inloggning på enheten. Brickor löses via en begränsad, krypterad NFC-identitetscache, max 500 poster, sju dagars TTL, så att ett terminalavbrott inte blir kö vid dörren.

Gränsen vi sätter för oss själva

Offline-tolerans är ett fönster, inte en livsform. Stämplingar äldre än det konfigurerade skewet spelas inte längre upp utan yts för att en människa ska avgöra, för en vecka gammal "instämpling" som dyker upp ur tomma intet är exakt mekanismen som får tidsregistreringar att tappa trovärdighet. Och den som loggar ut med väntande stämplingar får det sagt, vänta eller kassera, ert val, klart sagt.

Det är vad "offline-first" betyder i våra appar: inte att gränssnittet öppnas utan signal, utan att revisionsspåret överlever ett avbrott. ArbeitszeitCheck mobil och terminal samt CareCheck levererar detta idag.