Parlons-en

É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.

Sur la tablette

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.

Quand le réseau revient

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.

Côté serveur

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.

Partout ailleurs

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.

1 000caisses simultanées, 5 000 commandes geste par geste : zéro erreur serveur, zéro vente perdue
0vente perdue ou doublée quand le serveur est tué net (kill ‑9), deux fois, en pleine charge
26 mspour le rapport de ventes d'un gérant, pendant que mille caisses poussent leurs commandes
1 100+tests automatiques — calculs monétaires, synchronisation, sécurité, parcours complets en navigateur

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.

La pile technique de Kaissi, couche par couche.
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 calculUn 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.
SynchronisationAPI 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éesPostgreSQL (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-officeNext.js (Vercel) : rapports, carte, stock, équipe — avec la clé publique seulement, jamais une clé qui contourne la sécurité.
LivraisonCI 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