Udvikling · ArbeitszeitCheck
Anatomien af en offline-stempling
Kl. 12:07, en byggepladsport, ingen dækning. Medarbejderen stempler alligevel ind. Her er alt hvad den stempling gennemgår før den lander i tidsregistreringen, og hvor det kunne være gået galt.
Minut nul: telefonen kan ikke nå serveren
Mobilappen prøver ikke blindt igen og faker heller ikke succes. Stemplingen ryger i en krypteret FIFO-kø på enheden, AES-GCM-ciffertekst i AsyncStorage, med datanøglen i SecureStore. Den sidste detalje har en rigtig grund: SecureStore begrænser værdier til cirka to kilobytes på Android, så det oplagte design (kø i SecureStore, færdig) har aldrig været til rådighed. Selve køen er begrænset til 32 poster, en afgrænset buffer, ikke et uendeligt løfte. Optimistisk status viser medarbejderen som »stemplet ind« med det samme. Køen tømmes når dækningen vender tilbage.
Tømningen er bevidst nølerig: appen tager et snapshot af køen under en mutex, udfører netværksarbejdet uden for låsen og fletter derefter resultatet tilbage, så en stempling der kommer i kø under en tømning ikke overskrives af fletningen. Det er den klasse af fejl man kun finder ved at være paranoid omkring samtidige skrivninger.
Genspilningen: reservér før der muteres
Når stemplingen endelig når serveren bærer den to ting en normal stempling ikke har: et clientRequestIdcodeoccurredAt og et payload_hashcodeoccurredAt-tidsstempel. Serveren anvender den ikke direkte. Den skriver først en claim-række»dette request-id er nu mit, resultat afventer«. Først derefter muterer den tidsregistreringen. Hvis to retries kapløber, finder den anden claimen allerede taget og får det første forsøgs udfald i stedet for en dobbeltstempling.
Claim-rækken bærer en failedcode, sha256 over handlingen og dens normaliserede input. Samme request-id med en anden payload svarer 409, ikke en tavs overskrivning: en klient der prøver »stemple ind« igen og ved en fejl gensender »stemple ud« får en fejl den kan se, ikke korrupte data. Claims der hænger i mere end 300 sekunder tages tilbage. Hele genspilningsvinduet er syv dage, hvorefter et oprydningsjob sletter rækkerne.
Hvis ur der tæller
Telefonure drifter og kan stilles tilbage med vilje, så compliance evalueres på code, det øjeblik medarbejderen faktisk stemplede, ikke på ankomsttiden. Hvor langt serveren stoler på det tidsstempel er en afgrænset administratorindstilling: konfigurerbar skew mellem 24 og 72 timer tilbage, fem minutter ud i fremtiden. Loftet er bevidst. En stempling »fra sidste torsdag« kræver et menneske der ser på den, ikke en algoritme der tror den.
Kiosk-sporet får samme kontrakt med sine egne krøller: en krypteret NFC-badge-cache (syv dages TTL, maksimalt 500 poster) så en gangterminal i en kælder stadig åbner det rigtige handlingsskærmbillede under et nedbrud, og en vellykket tømning skriver den nye status tilbage i cachen, ellers ville næste nedbrud tilbyde medarbejderen handlinger der allerede er forkerte.
Hvad der stadig mangler, på skrift
To huller. En stempling der fejler permanent bliver i køen markeret code, brugeren ser en toast, men der er endnu ingen retry-UI pr. række. Og gamle app-versioner der ikke kender de nye felter stempler ganske enkelt kun online. Intet går i stykker, de mister bare funktionen. Begge står i beslutningsdokumentet fordi den værste slags begrænsning er den ingen har dokumenteret.
Hele beslutningsdokumentet, inklusive låserækkefølgen og oprydningsjobbet, ligger i det repository AGPL-licensen garanterer at I kan læse. Det er den anden halvdel af dette indlægs svar: køen er ikke kun konstrueret til at overleve en død zone, den er dokumenteret så I kan kontrollere at den er det.