Étude de cas · Restauration · Res2Boost
Kaissi : la caisse qui n'arrête jamais d'encaisser
Un samedi soir, en plein service, Internet tombe. Avec une caisse cloud, le restaurant s'arrête. Avec Kaissi, personne ne s'en aperçoit : les tablettes encaissent en local, et tout remonte au retour du réseau — sans une vente perdue, sans une vente comptée deux fois.
- 100 % hors ligne
- Multi-terminaux
- Exact au millime
Le problème
Une caisse qui dépend d'Internet est une caisse qui s'arrête
Res2Boost voulait équiper les cafés et restaurants tunisiens. Trois contraintes rendaient les solutions classiques inutilisables.
Le réseau tombe, le service continue
Les coupures d'Internet font partie du quotidien. Une caisse cloud affiche alors une page blanche — au pire moment, devant des clients qui attendent. L'encaissement ne devait dépendre d'aucun serveur : ni pour les données, ni pour le code de l'application elle-même.
Le dinar a trois décimales
24,500 TND, pas 24,50. La quasi-totalité des logiciels de caisse suppose deux décimales (« centimes = ×100 ») : les écarts d'arrondi s'accumulent en silence et apparaissent des mois plus tard, dans la caisse du client.
Plusieurs terminaux, zéro conflit
Deux serveurs ajoutent chacun un plat à la table 12, chacun sur sa tablette, pendant une coupure. Au retour du réseau, la commande doit porter les deux plats — pas l'un des deux, pas un doublon, pas un écran « conflit à résoudre ».
L'architecture
Offline d'abord : le chemin d'une vente
L'application complète est embarquée sur la tablette — code, base de données, règles de calcul. Le réseau n'est jamais une condition : c'est une conséquence.
1. La vente est encaissée en local
Base SQLite embarquée, totaux et TVA calculés sur l'appareil, en entiers de millimes. Chaque geste est un événement horodaté, à l'identifiant unique, rangé dans une file d'attente locale.
2. La file se vide vers le serveur
Les événements partent par lots. Le serveur reconnaît ce qu'il a déjà reçu (idempotence) : un lot renvoyé deux fois — réseau qui hoquette, accusé perdu — n'est compté qu'une fois.
3. Le journal fait foi
Les événements sont la source de vérité, en insertion seule — une annulation s'ajoute, rien ne s'efface. Les commandes en sont reconstruites avec les mêmes règles de calcul que la tablette : les totaux sont identiques au millime.
4. Tout le monde voit la même chose
Les autres tablettes reçoivent les événements, le back-office affiche le chiffre du jour en temps réel, et l'isolation entre établissements est garantie par la base elle-même (règles de sécurité par ligne), pas par la vigilance du code.
Le produit
Un système complet, pas un prototype
Tout ce qu'un restaurant utilise en service, du premier café à la clôture de caisse.
La salle et la caisse
Plan de salle, vente à emporter, remises plafonnées par rôle, paiements mixtes, remboursements tracés, annulations sous PIN d'un responsable.
La cuisine et le bar
Envois par poste de préparation, écran « prêt » qui redescend en salle, notifications — et jamais deux fois le même bon, même après une coupure.
La gestion
Stock calculé en continu, coûts et marges sur le CA hors taxe, rapports par article, employé et mode de paiement, exports, multi-établissements.
La traçabilité
Journal de ventes inaltérable, piste d'audit chaînée par hachage, clôture de caisse avec écart, pointeuse — qui a fait quoi, et quand.
Deux langues
Français et arabe, interface retournée de droite à gauche, vérifiées automatiquement à chaque modification — jusqu'à 320 px de large.
Mobile et web, une seule base
Android et iOS par Capacitor, une cible web pour les démonstrations, impression thermique ESC/POS en file persistante — un seul code pour tout.
Mesuré, pas promis
Les chiffres d'un banc d'essai, pas d'une plaquette
Avant toute mise en service, Kaissi passe un audit de charge et de résilience contre un vrai PostgreSQL : des caisses simulées qui parlent le protocole réel, et trois propriétés qui ne se négocient pas — aucune vente perdue, aucune dupliquée, totaux exacts au millime.
Mesures du banc d'audit (novembre 2026), service et base sur une même machine de test : ce qui se transpose en production, ce sont les invariants — pas de perte, pas de doublon, exactitude au millime — et les ordres de grandeur. Le détail est documenté dans le dépôt du projet.
La technique
Des briques simples, tenues par des règles strictes
Pas de framework exotique : des outils éprouvés, et les garanties placées là où elles ne peuvent pas être contournées.
| Caisse (Android, iOS, web) | React + Vite, empaquetés par Capacitor. SQLite embarquée. Aucun code chargé depuis le réseau : l'application s'ouvre en mode avion, et une vérification automatique l'impose à chaque modification. |
|---|---|
| Règles de calcul | Un seul module TypeScript pur — montants en entiers de millimes, TVA arrondie par taux, remises réparties au prorata — importé à l'identique par la caisse et par le serveur. Deux implémentations divergeraient d'un millime : il n'y en a qu'une. |
| Synchronisation | API Node.js (Hono). Push idempotent par identifiant d'événement, pull par curseur serveur — jamais par horodatage, les horloges des tablettes dérivent. |
| Base de données | PostgreSQL (Supabase). Journal en insertion seule, isolation par établissement imposée par la base (RLS forcée sur chaque table), audit chaîné par hachage. |
| Back-office | Next.js (Vercel) : rapports, carte, stock, équipe — avec la clé publique seulement, jamais une clé qui contourne la sécurité. |
| Livraison | CI GitHub Actions — 1 100+ tests dont des parcours complets en navigateur et des tests de charge contre un vrai PostgreSQL — puis publication automatique vers Google Play et TestFlight à chaque fusion. |
Ce que ce projet démontre
La méthode Afaqus, appliquée à un système critique
La contrainte d'abord
Tout le projet découle d'une seule exigence — « l'encaissement ne s'arrête jamais » — posée avant la première ligne de code. Chaque décision technique s'y mesure, et ce qui la contredit est refusé, même quand c'est plus rapide.
Prouvé par des tests, pas par des démos
Coupures réseau simulées, serveur tué en pleine charge, 1 000 caisses simultanées : les garanties sont vérifiées par des bancs d'essai rejouables, exécutés à chaque modification du code.
Documenté pour durer
Chaque règle du système est écrite avec sa raison et la panne qu'elle prévient. Le client n'est jamais prisonnier : le code, les tests et la documentation lui appartiennent.
Un process critique qui ne doit jamais s'arrêter ?
Caisse, production, logistique, terrain sans réseau : 20 minutes suffisent pour savoir si c'est réglable.
Réserver 20 minutes