L'offline-first è una coda, non uno slogan
Un'operatrice sociosanitaria documenta una visita in un seminterrato senza campo. Un terminale continua a timbrare mentre il wifi del cantiere è giù. «Funziona offline» si stampa facilmente su una lista di funzioni, ciò che conta è cosa succede esattamente a quei record e cosa non deve mai succedere.
L'outbox, specificata onestamente
Quando la rete cade, le nostre app companion non tengono le timbrature «in memoria» sperando. Ogni timbratura in sospeso entra in una coda cifrata sul dispositivo, testo cifrato AES-GCM in storage locale, la chiave nel secure store della piattaforma, limitata a 32 voci perché una connessione morta non faccia crescere un arretrato senza limiti. La coda è FIFO e si svuota da sola al ritorno della connettività.
La cifratura a riposo è la parte poco appariscente che conta: una timbratura è un dato personale. «È rimasta sul telefono solo un'ora» non è una risposta a un dispositivo rubato.
Perché decide il server, non il telefono
Il replay delle timbrature in coda è dove l'offline di solito mente. Un retry può arrivare due volte. Due azioni in coda possono arrivare fuori ordine. Quindi ogni timbratura porta un client request id e il timestamp reale, quando è successa, non quando è arrivata. Il server rivendica il request id prima di ogni scrittura: un retry duplicato diventa un no-op invece di una doppia timbratura. Stesso id, contenuto diverso? È un conflitto 409, non una sovrascrittura silenziosa. E la conformità si valuta al momento della timbratura, un ingresso alle 07:02 replicato conta alle 07:02, dentro la finestra di skew configurata dall'organizzazione (24 ore di default, tetto rigido 72).
La variante chiosco risolve una versione più dura dello stesso problema: nessun login personale sul dispositivo. I badge si risolvono tramite una cache di identità NFC limitata e cifrata, massimo 500 voci, TTL di sette giorni, perché un guasto del terminale non diventi una fila all'ingresso.
Il limite che ci imponiamo
La tolleranza offline è una finestra, non uno stile di vita. Le timbrature più vecchie dello skew configurato smettono di replicare e salgono a galla perché una persona decida, un «ingresso» di una settimana prima che appare dal nulla è esattamente il meccanismo che toglie credibilità a un registro orario. E chi fa logout con timbrature in sospeso lo vede scritto, attendere o scartare, scelta vostra, detto chiaramente.
Questo è «offline-first» nelle nostre app: non che l'interfaccia si apra senza segnale, ma che la pista di audit sopravviva a un'interruzione. ArbeitszeitCheck mobile e terminale, e CareCheck, lo consegnano oggi.