Ingénierie · ArbeitszeitCheck
Anatomie d'un pointage hors ligne
12 h 07, une grille de chantier, aucune barre de réseau. L'ouvrier pointe quand même. Voici tout ce que ce pointage traverse avant d'atterrir dans la feuille d'heures, et où il aurait pu mal tourner.
Minute zéro: le téléphone ne joint pas le serveur
L'application mobile ne réessaie pas à l'aveugle et ne simule pas un succès. Le pointage part dans une file FIFO chiffrée sur l'appareil, texte chiffré AES-GCM dans AsyncStorage, la clé de données dans SecureStore. Ce dernier détail a une vraie raison: SecureStore plafonne les valeurs autour de deux kilo-octets sous Android, donc le design évident (la file dans SecureStore, et voilà) n'a jamais été disponible. La file elle-même est plafonnée à 32 entrées, un tampon borné, pas une promesse infinie. Le statut optimiste affiche l'ouvrier « pointé » immédiatement. La file se vide quand le réseau revient.
La vidange est délibérément pointilleuse: l'app prend un instantané de la file sous un mutex, fait le travail réseau hors du verrou, puis fusionne le résultat, ainsi un pointage enfilé pendant une vidange n'est pas écrasé par la fusion. C'est la classe de bogue qu'on ne trouve qu'en étant paranoïaque sur les écritures concurrentes.
Le rejeu: réclamer avant de modifier
Quand le pointage atteint enfin le serveur, il porte deux choses qu'un pointage normal n'a pas: un clientRequestId et un horodatage occurredAt. Le serveur ne l'applique pas directement. Il écrit d'abord une ligne de revendication« cet identifiant de requête m'appartient désormais, résultat en attente ». Ce n'est qu'ensuite qu'il modifie la feuille d'heures. Si deux réémissions se concurrencent, la seconde trouve la revendication déjà prise et reçoit le résultat de la première tentative au lieu d'un double pointage.
La ligne de revendication porte un payload_hash, sha256 sur l'action et ses entrées normalisées. Le même identifiant de requête avec une charge différente reçoit un 409, pas un écrasement silencieux: un client qui renvoie « pointer » et envoie par accident « dépointer » obtient une erreur visible, pas des données corrompues. Les revendications restées en attente plus de 300 secondes sont reprises. Toute la fenêtre de rejeu est de sept jours, après quoi une tâche de nettoyage supprime les lignes.
À quelle horloge se fier
Les horloges de téléphone dérivent et peuvent être reculées délibérément, donc la conformité est évaluée à occurredAt, l'instant où l'ouvrier a réellement pointé, et non à l'heure d'arrivée. Jusqu'où le serveur fait confiance à cet horodatage est un réglage admin borné: dérive configurable entre 24 et 72 heures en arrière, cinq minutes dans le futur. Le plafond est délibéré. Un pointage « de jeudi dernier » mérite un humain qui le regarde, pas un algorithme qui le croit.
Le chemin kiosque reçoit le même contrat avec ses propres subtilités: un cache de badges NFC chiffré (TTL de sept jours, plafonné à 500 entrées) pour qu'un terminal de couloir en sous-sol ouvre encore le bon écran d'action pendant une panne, et une vidange réussie réécrit le nouveau statut dans ce cache, sinon la prochaine panne proposerait à l'ouvrier des actions déjà fausses.
Ce qui manque encore, pour mémoire
Deux manques assumés. Un pointage qui échoue définitivement reste dans la file marqué failed, l'utilisateur voit un toast, mais il n'y a pas encore d'UI de rejeu par ligne. Et les anciennes versions de l'app qui ne connaissent pas les nouveaux champs pointent simplement en ligne seulement. Rien ne casse, elles perdent juste la fonctionnalité. Les deux sont écrits dans le document de décision, car le pire type de limitation est celle que personne n'a documentée.
Le dossier de décision complet, y compris l'ordre de verrouillage et la tâche de nettoyage, vit dans le dépôt que l'AGPL vous garantit de pouvoir lire. C'est l'autre moitié de la réponse de ce billet: la file n'est pas seulement conçue pour survivre à une zone morte, elle est documentée pour que vous puissiez le vérifier.