Les choix d’ingénierieÉtudes de cas techniques4 min de lecture
Des encaissements qui ne se retouchent pas
La loi veut qu’un logiciel de caisse rende visible la moindre retouche. Du coup, la base chaîne chaque encaissement au précédent, et voici comment.
Le problème
L’ERP enregistre ce que les particuliers règlent au magasin : espèces, chèque, carte, virement. Peu importe le moyen de paiement, pour le Code général des impôts c’est un système de caisse (article 286, I, 3° bis). Ses enregistrements doivent être inaltérables et sécurisés. Si on modifie ou si on supprime quelque chose, ça doit laisser une trace, par exemple avec un chaînage. Et des clôtures périodiques doivent figer leur état (BOI-TVA-DECLA-30-10-30).
La base refusait déjà qu’on modifie ou qu’on efface un encaissement : des triggers rejettent UPDATE, DELETE et TRUNCATE. Sauf qu’un trigger, ça se désactive, et le désactiver ne laisse aucune trace dans les données. Il fallait donc qu’une retouche se voie après coup, même quand elle est faite avec tous les droits.
Les contraintes
- La preuve doit marcher aussi contre le propriétaire de la base, pas seulement contre le code de l’application. Celui qui peut désactiver un trigger peut aussi réécrire une ligne.
- L’argent s’écrit par plusieurs chemins : la vente au magasin, l’encaissement de la suite d’une vente, le webhook de Stripe, les remboursements faits au magasin ou annoncés par Stripe. Si chaque chemin devait appliquer la garantie lui-même, le prochain l’oublierait.
- Un remboursement change de statut après sa création, quand Stripe le confirme ou le refuse. Par contre, ses montants ne bougent plus. Donc la preuve ne doit porter que sur ce qui ne change plus.
- Deux encaissements peuvent arriver en même temps. Un numéro d’ordre ne doit pas être pris deux fois, et on ne doit pas en sauter un.
- Les clôtures périodiques doivent figer l’état de la caisse à leur date.
Les alternatives
- Garder seulement les triggers. Ils bloquent la retouche ordinaire, mais quand on les désactive, ça ne laisse aucune trace.
- Prendre un logiciel de caisse tiers. Les encaissements seraient alors hors de l’ERP, loin des commandes et des factures qu’ils soldent.
- Calculer le chaînage dans l’application. Chaque chemin d’écriture devrait faire le calcul. Un script ou une migration qui l’oublie écrirait un maillon faux, sans erreur.
- Ancrer la chaîne hors de la base, avec un horodatage ou une signature par une clé externe. Ça protège aussi contre une réécriture complète, mais ça fait un service et un secret de plus.
- Calculer le chaînage dans la base, au moment de l’insertion, quel que soit le chemin qui écrit.
La décision
C’est la base qui calcule le chaînage, dans un trigger, à la création de chaque encaissement et de chaque remboursement. On le recalcule chaque matin, et à chaque migration jouée en prod.
L’implémentation
Quand un encaissement ou un remboursement est créé, il reçoit deux valeurs que la base calcule elle-même (migration 20261025000100_encaissements_chaines) :
- Un numéro d’ordre sans trou (
chainSequence). - Une empreinte SHA-256 (
chainHash) de son contenu (identifiant, commande, moyen, montant, dates en UTC au millième), chaînée à l’empreinte du maillon précédent.
packages/db/prisma/migrations/20261025000100_encaissements_chaines/migration.sql · lignes 32–37-- L'empreinte d'un maillon : celle du précédent, puis le contenu du maillon. Les dates sont
-- écrites en UTC, au millième, pour ne pas dépendre du fuseau de la session.
CREATE FUNCTION "cash_chain_hash"(previous text, payload text) RETURNS text
LANGUAGE sql IMMUTABLE AS $$
SELECT encode(sha256(convert_to(coalesce(previous, '') || '|' || payload, 'UTF8')), 'hex')
$$;Le calcul est dans un trigger, donc hors de l’application. Les colonnes ont une valeur par défaut, le code n’a rien à fournir, et le trigger remplace toujours cette valeur. L’empreinte ne couvre que ce qui ne change plus. Le statut d’un remboursement peut encore bouger, mais pas ses montants, donc son maillon reste valable. Pour que deux encaissements simultanés ne prennent pas le même numéro, un verrou consultatif par table fait passer les insertions l’une après l’autre. Au volume d’un magasin, ce verrou ne coûte rien.
Les clôtures quotidiennes, mensuelles et annuelles reprennent la dernière empreinte de la chaîne. Elles non plus, on ne peut pas les modifier.
Personne n’a besoin de penser à vérifier.
- Chaque matin, la veille recalcule les deux chaînes. Si un maillon est rompu, l’étape échoue et l’alerte part (
cash-closure.service.ts). pnpm db:invariantsvérifie que la base a bien ses gardes et que la chaîne est intacte. Le script qui joue les migrations en prod le relance après chaque application.
Si on touche une ligne, la chaîne casse à partir de cette ligne. Son empreinte ne correspond plus à son contenu. Et si on la recalcule pour le cacher, c’est l’empreinte du maillon suivant qui ne correspond plus.
Les résultats
Pendant la migration, on a chaîné les encaissements existants dans l’ordre où ils avaient été enregistrés. Depuis, si quelqu’un modifie une ligne, la veille le signale le lendemain matin, même avec les droits du propriétaire et les triggers désactivés.
Les limites
- Le chaînage rend la retouche visible, mais pas impossible. Si quelqu’un réécrit toute la chaîne à partir du maillon touché, puis les clôtures qui reprennent son empreinte, il obtient une chaîne cohérente. Dans ce cas, c’est une copie de la base gardée ailleurs qui sert de point de comparaison.
- On ne chaîne que l’argent encaissé et l’argent rendu. Les factures sont protégées autrement : les gardes de la base, une numérotation sans trou et un PDF archivé avec son empreinte (Facturation).