Skip to Content
Meubles Morinière

Engineering choicesDécisions d’architecture(in French)5 min read

0008 · L’argent et les pièces, inaltérables dans la base

Des montants en centimes, des instantanés à la vente, une numérotation sans trou. C’est Postgres qui impose les gardes et le chaînage, plutôt que le code.

Not translated yet

This page is shown in its original French. Code excerpts, tests and figures read the same in either language.

Statut : acceptée · Décidée : 23 et 24 août 2026, étendue les 17 et 25 octobre et le 11 novembre · Sources : ancien journal (23 et 24 août 2026), d30dfaebac, migration 20261025000100_encaissements_chaines, 6327df8f1c

Contexte

L’ERP émet les factures et les avoirs, pour le site comme pour le magasin, et il enregistre les règlements des particuliers au magasin. Le code le traite donc comme un système de caisse au sens de l’article 286, I, 3° bis du CGI, et la qualification reste à confirmer par l’expert-comptable (Dette, risques et évolutions). Une pièce émise ne se modifie pas, sa numérotation doit être continue, et un encaissement modifié doit laisser une trace.

Contraintes

  • Une obligation légale ne doit pas dépendre du code qui écrit. Deux applications, des scripts et des migrations touchent la base.
  • Une TVA recalculée des années plus tard rejouerait l’arrondi du jour. Elle pourrait s’écarter, au centime, du montant encaissé.
  • Un trigger se désactive, et le désactiver ne laisse aucune trace dans les données.

Alternatives

  • Un logiciel de caisse certifié à côté de l’ERP. La question a été étudiée le 23 août : « soit un outil certifié porte l’enregistrement des règlements, soit le site est qualifié de système de caisse ».
  • Des gardes dans le code seulement. Un script, une migration ou l’autre application les contourneraient.
  • Une séquence Postgres pour les numéros. Elle a été étudiée et écartée le 23 août, parce qu’elle laisse des trous quand une transaction est annulée.
  • Des montants décimaux. Il faudrait faire attention aux arrondis et aux comparaisons partout. Rien ne dit qu’on les a étudiés.

Décision

  • Les montants sont des entiers en centimes, en euros, sans champ de devise. Les taux de TVA sont en points de base.
  • Une ligne vendue fige son prix, sa TVA et ce qui l’engage au moment de la vente (les instantanés).
  • Les factures et les avoirs sont numérotés par un compteur verrouillé dans la transaction (DocumentCounter, apps/erp/shared/invoicing/invoice.ts). Le PDF archivé porte son empreinte SHA-256.
  • La base refuse qu’on modifie ou qu’on efface une pièce émise, une écriture comptable, un mouvement de stock ou un encaissement (triggers, contraintes CHECK).
  • Chaque encaissement et chaque remboursement est chaîné au précédent par une empreinte que la base calcule. Les clôtures du jour, du mois et de l’exercice reprennent la dernière. Et une vente est scellée dès son premier encaissement (Des encaissements qui ne se retouchent pas).

Raisons

Confirmées

  • On évite la séquence Postgres, « qui laisse des trous au rollback ». Et le « sans trou » est une exigence comptable (art. 242 nonies A de l’annexe II du CGI) (ancien journal, 23 et 24 août 2026).
  • La TVA est figée sur chaque ligne parce que « le taux seul obligeait à recalculer la TVA des années plus tard, donc à rejouer l’arrondi du jour » (ancien journal, 24 août 2026).
  • Les contraintes CHECK bornent « les états qui ne devraient exister sous aucune application » (ancien journal, 24 août 2026).
  • On chaîne parce que les gardes existantes « ne laissent pas de trace si on les désactive » (en-tête de la migration 20261025000100_encaissements_chaines, qui cite l’article 286 du CGI et le BOI-TVA-DECLA-30-10-30).

Hypothèses

  • Les centimes entiers viennent du premier schéma. Aucune entrée ne les compare à un type décimal.
  • Le chaînage se fait dans l’ERP, sans logiciel de caisse certifié. Le 23 août, la question était renvoyée à l’expert-comptable, et sa réponse n’est pas notée dans le dépôt.

Compromis

  • Une erreur sur une pièce émise se corrige seulement avec une nouvelle pièce (avoir, facture rectificative). On ne la corrige jamais sur place.
  • Le chaînage rend une retouche visible. Il ne la rend pas impossible : si on réécrit toute la chaîne à partir du maillon touché, elle reste cohérente. Dans ce cas, l’étude de cas compte sur une copie gardée ailleurs, qui sert de témoin. Sauf que depuis le 6 novembre, aucune sauvegarde ne tourne toute seule (ADR 0009).
  • Les triggers et les contraintes sont écrits à la main dans les migrations. Ils échappent au modèle de Prisma, qui ne les décrit pas et ne les compare pas.
  • Un verrou par table fait passer les encaissements l’un après l’autre. Au volume d’un magasin, ça ne coûte rien.

Conséquences

  • Chaque matin, la veille recalcule les chaînes et alerte si un maillon est rompu (cash-closure.service.ts).
  • pnpm db:invariants vérifie que la base a bien ses gardes et que la chaîne est intacte. Le script qui migre la prod le relance.
  • La suite sur une vraie base (test:db) prouve chaque contrainte avec un cas de refus.

Risques résiduels

  • La conformité de la caisse n’est pas réglée. D’après la doctrine fiscale relue le 18 novembre 2026, un logiciel maison qui enregistre des règlements de particuliers doit avoir le certificat d’un organisme accrédité, et l’ERP n’en a pas (Dette, risques et évolutions). Aucune garde technique ne le remplace.
  • L’ERP se connecte avec le rôle propriétaire. En principe, une faille de l’ERP peut donc désactiver un trigger. Avec la chaîne, la retouche se voit le lendemain matin. Par contre, une chaîne réécrite en entier ne se voit qu’en la comparant à une copie gardée ailleurs, et cette copie ne se fait pas toute seule (Droits PostgreSQL).

Quand la revoir

  • Un rôle applicatif pour l’ERP, différent de celui qui migre et sans le droit de désactiver un trigger, fermerait la porte que la détection surveille. Ça coûterait un deuxième jeu de droits. Le rôle du site montre déjà comment faire.
  • Si l’expert-comptable l’exige, un logiciel de caisse certifié prendrait l’enregistrement des règlements. L’ERP garderait les factures, le stock et les commandes.
  • Pour vendre hors de la zone euro, il faudrait un champ de devise sur chaque montant, donc une migration de tout le schéma de l’argent.

On this page