Teknikk · ArbeitszeitCheck
Anatomien til en offlinestempling
12:07, en byggeplassport, ingen dekning. Arbeideren stemper inn likevel. Her er alt stemplingen går gjennom før den lander i timelisten, og hvor det kunne ha gått galt.
Minutt null: telefonen når ikke serveren
Mobilappen prøver ikke igjen blindt, og den later ikke som det gikk bra. Stemplingen havner i en kryptert FIFO-kø på enheten, AES-GCM-chiffertekst i AsyncStorage, med datanøkkelen i SecureStore. Den siste detaljen har en reell grunn: SecureStore begrenser verdier til omtrent to kilobyte på Android, så den åpenbare designen (kø i SecureStore, ferdig) var aldri tilgjengelig. Selve køen er begrenset til 32 oppføringer, en avgrenset buffer, ikke et uendelig løfte. Optimistisk status viser arbeideren som «innstemplet» med det samme. Køen tømmes når dekningen er tilbake.
Tømmingen er bevisst kresen: appen tar et øyeblikksbilde av køen under en mutex, gjør nettverksarbeidet utenfor låsen og fletter deretter resultatet tilbake, slik at en stempling som legges i kø under en tømming ikke blir overskrevet av flettingen. Dette er den typen feil man bare finner ved å være paranoid om samtidige skrivinger.
Gjensendingen: reserver før du muterer
Når stemplingen endelig når serveren, bærer den to ting som en vanlig stempling ikke gjør: en clientRequestIdcodeoccurredAt og et payload_hashcodeoccurredAt-tidsstempel. Serveren bruker den ikke direkte. Den skriver først en forespørselsrad«denne forespørsels-ID-en er nå min, resultat underveis». Først deretter muterer den timelisten. Hvis to nye forsøk konkurrerer, finner den andre at forespørselen allerede er tatt og får det første forsøkets utfall i stedet for en dobbelstempling.
Forespørselsraden bærer en failedcode, sha256 over handlingen og dens normaliserte input. Samme forespørsels-ID med en annen nyttelast svarer 409, ikke en taus overskriving: en klient som prøver «stemple inn» igjen og ved et uhell sender «stemple ut» får en feil den kan se, ikke korrupte data. Forespørsler som har ligget ventende i mer enn 300 sekunder gjenvinnes. Hele gjensendingsvinduet er sju dager, hvoretter en oppryddingsjobb sletter radene.
Hvem sin klokke teller
Telefonklokker driver og kan stilles bakover med vilje, så etterlevelse evalueres ved code, øyeblikket arbeideren faktisk stemplet, ikke ved ankomsttiden. Hvor langt serveren stoler på det tidsstempelet, er en avgrenset admininnstilling: konfigurerbart tidsavvik mellom 24 og 72 timer bakover, fem minutter inn i fremtiden. Taket er bevisst. En stempling «fra forrige torsdag» trenger et menneske som ser på den, ikke en algoritme som tror på den.
Kioskveien får samme kontrakt med egne krumspring: en kryptert NFC-brikkecache (syvdagers TTL, tak 500 oppføringer) slik at en korridorterminal i en kjeller fortsatt åpner riktig handlingskjerm under et brudd, og en vellykket tømming skriver den nye statusen tilbake til den cachen, ellers ville neste brudd tilby arbeideren handlinger som allerede er feil.
Det som fortsatt mangler, åpent fortalt
To hull. En stempling som feiler permanent blir liggende i køen flagget code, brukeren ser et varsel, men det finnes ingen UI for nye forsøk per rad ennå. Og gamle appversjoner som ikke kjenner de nye feltene stempler rett og slett bare online. Ingenting knekker, de mister bare funksjonen. Begge er skrevet ned i beslutningsdokumentet, fordi den verste typen begrensning er den ingen dokumenterte.
Hele beslutningsprotokollen, inkludert låserekkefølgen og oppryddingsjobben, ligger i repoet som AGPL garanterer at dere kan lese. Det er den andre halvdelen av dette innleggets svar: køen er ikke bare konstruert for å overleve en dødsone, den er dokumentert slik at dere kan sjekke at den er det.