Teknik · ArbeitszeitCheck
Anatomin i en offlinestämpling
12:07, en grind på en byggarbetsplats, ingen täckning. Arbetaren stämplar in ändå. Här är allt den stämplingen går igenom innan den landar i tidrapporten, och var det kunde ha gått fel.
Minut noll: telefonen når inte servern
Mobilappen försöker inte igen blint och den låtsas inte att det lyckades. Stämplingen hamnar i en krypterad FIFO-kö på enheten, AES-GCM-chiffertext i AsyncStorage, med datanyckeln i SecureStore. Den sista detaljen har en verklig orsak: SecureStore begränsar värden till ungefär två kilobyte på Android, så den självklara designen (kön i SecureStore, klart) fanns aldrig att tillgå. Själva kön är begränsad till 32 poster, en avgränsad buffert, inte ett oändligt löfte. Optimistisk status visar arbetaren som "instämplad" direkt. Kön töms när täckningen kommer tillbaka.
Tömningen är medvetet petig: appen tar en ögonblicksbild av kön under ett mutex, gör nätverksarbetet utanför låset och slår sedan ihop resultatet, så att en stämpling som läggs i kö under en pågående tömning inte skrivs över av ihopslagningen. Det här är den sortens bugg man bara hittar genom att vara paranoid om samtidiga skrivningar.
Uppspelningen: reservera innan du ändrar
När stämplingen till slut når servern bär den två saker som en vanlig stämpling inte gör: ett clientRequestIdcodeoccurredAt och en payload_hashcodeoccurredAt-tidsstämpel. Servern tillämpar den inte direkt. Den skriver först en claim-rad"det här request-id:t är nu mitt, resultat väntar." Först därefter muterar den tidrapporten. Om två retries tävlar hittar den andra att claimet redan är taget och får det första försökets utfall istället för en dubbelstämpling.
Claim-raden bär en failedcode, sha256 över åtgärden och dess normaliserade indata. Samma request-id med en annan nyttolast svarar 409, inte en tyst överskrivning: en klient som försöker "stämpla in" igen och av misstag skickar "stämpla ut" får ett fel den kan se, inte korrupta data. Claims som lämnats väntande i mer än 300 sekunder återtas. Hela uppspelningsfönstret är sju dagar, varefter ett städjobb raderar raderna.
Vems klocka räknas
Telefonklockor driftar och kan ställas bakåt med flit, så efterlevnad utvärderas vid code, ögonblicket då arbetaren faktiskt stämplade, inte vid ankomsttiden. Hur långt servern litar på den tidsstämpeln är en avgränsad admininställning: konfigurerbart skew mellan 24 och 72 timmar bakåt, fem minuter in i framtiden. Taket är avsiktligt. En stämpling "från förra torsdagen" behöver en människa som tittar på den, inte en algoritm som tror på den.
Kioskvägen får samma kontrakt med egna kinkigheter: en krypterad NFC-brickcache (sjudagars TTL, tak 500 poster) så att en korridorsterminal i en källare fortfarande öppnar rätt åtgärdsskärm under ett avbrott, och en lyckad tömning skriver tillbaka den nya statusen i den cachen, annars skulle nästa avbrott erbjuda arbetaren åtgärder som redan är fel.
Vad som fortfarande saknas, öppet redovisat
Två luckor. En stämpling som misslyckas permanent stannar i kön flaggad code, användaren ser en toast, men det finns ingen retry-UI per rad ännu. Och gamla appversioner som inte känner de nya fälten stämplar helt enkelt bara online. Inget går sönder, de förlorar bara funktionen. Båda är nedskrivna i beslutsdokumentet eftersom den värsta sortens begränsning är den ingen dokumenterat.
Det fullständiga beslutsprotokollet, inklusive låsordningen och städjobbet, ligger i det repository som AGPL garanterar att ni kan läsa. Det är den andra halvan av det här inläggets svar: kön är inte bara konstruerad för att överleva en död zon, den är dokumenterad så att ni kan kontrollera att den är det.