Travailler en mode hors ligne

Teranga PMS fonctionne en mode hors ligne lorsque la connexion internet est coupée ou instable. Le comportement diffère légèrement entre le web (PWA) et l’application mobile Android.

Sur le web (PWA)

Un badge rouge « Hors ligne » s’affiche dans la barre de navigation dès que la connexion est perdue. Ce badge indique le nombre d’opérations en attente de synchronisation.

Ce qui fonctionne hors ligne :

• Saisie de commandes depuis le POS (/dashboard/pos) — les commandes sont mises en file d’attente
• Affichage des articles depuis le cache local (les articles sont mis en cache au dernier chargement réussi)

Ce qui nécessite une connexion :

• Paiements Mobile Money (Flooz/Yas) — désactivés automatiquement hors ligne
• Réservations, rapports, paramètres

Page File hors ligne (/dashboard/offline-queue) :

1. Allez dans File hors ligne dans la barre de navigation (visible uniquement hors ligne ou si des opérations sont en attente)
2. La page liste toutes les commandes en attente avec leur statut (en attente, en cours, échoué)
3. Cliquez sur Synchroniser maintenant pour forcer la synchronisation dès la reconnexion
4. Cliquez sur la corbeille pour supprimer une opération de la file

Synchronisation automatique : Dès que la connexion revient, la file est drainée automatiquement dans l’ordre FIFO. En cas d’erreur temporaire, le système réessaie avec un délai exponentiel (1s, 2s, 4s…). Chaque opération a un identifiant unique (UUID) pour éviter les doublons si la même commande est soumise deux fois.

Sur l’application mobile Android

L’application utilise Room DB pour stocker les commandes hors ligne. Un écran File hors ligne (accessible depuis le menu principal) affiche :

• Les opérations en attente avec leur montant et statut
• Un bouton Synchroniser pour forcer l’envoi
• Un indicateur de connexion (en ligne / hors ligne)

La synchronisation automatique s’exécute toutes les 15 minutes via WorkManager, même si l’application est fermée.