Aller au contenu
Meubles Morinière

Les choix d’ingénierieDécisions d’architecture4 min de lecture

0003 · Une base partagée, un rôle borné pour le site

L’ERP et le site lisent et écrivent dans la même base Postgres. C’est la base elle-même qui limite ce que le site peut faire.

Statut : acceptée · Décidée : 17 octobre 2026 (lecture seule), 18 au 25 octobre (rôle moriniere_site) · Sources : d30dfaebac, 90ccdfd846, 09f84b6d4f, 667757d693, c98e049eb4, da8a4021bc

Contexte

Une vente en ligne, au magasin ou sur devis, c’est la même commande, et on la suit jusqu’à la facture. Le premier site, le 17 octobre, lisait la base avec un compte de lecture (DATABASE_URL_READONLY) et « n’écrit jamais » (d30dfaebac). Le site Next.js du lendemain crée des commandes, des devis et des comptes clients. Il a donc besoin d’écrire.

Contraintes

  • Le site doit lire le catalogue là où l’ERP l’écrit, sans délai de synchronisation.
  • C’est le site qui est exposé. Une faille ne doit pas pouvoir marquer une commande payée, ni toucher à une facture.
  • Pour un seul magasin, rien ne justifie un service de plus à héberger.

Alternatives

  • Une base par application, avec une synchronisation entre les deux. Ça ferait deux schémas, et la synchronisation deviendrait elle-même une source d’erreurs.
  • Une API de l’ERP devant la base. Ça ferait un service de plus à garder disponible, et de la latence sur chaque page du catalogue.
  • Le même rôle pour les deux applications. Une faille du site ouvrirait alors toute la base.

Décision

Il y a une base, un schéma (packages/db) et deux rôles. Le site se connecte en moriniere_site. Ses droits sont écrits table par table et colonne par colonne (apps/site/scripts/lib/database-grants.ts). Des triggers n’acceptent de lui qu’une commande web en attente de paiement. Et il refuse de démarrer avec un autre rôle (apps/site/shared/server/database-role-check.ts). Les migrations ne se jouent que depuis l’ERP (ADR 0009). Le détail des droits est dans Droits PostgreSQL, et leur histoire dans l’étude de cas Le site n’a que les droits qu’il lui faut.

Raisons

Confirmées

  • Le moindre droit était là avant le rôle actuel : le premier site lisait et n’écrivait jamais (d30dfaebac).
  • Les droits se contrôlent colonne par colonne, y compris pour les colonnes modifiables (09f84b6d4f). Quand le site n’a pas besoin d’une colonne réservée à l’ERP, on la lui retire. C’est le cas de la référence fournisseur (da8a4021bc).

Hypothèses

  • La base est partagée, sans API ni synchronisation, pour éviter un service de plus et sa latence. Ces raisons viennent de l’étude de cas, écrite après coup. Aucune trace de l’époque ne compare les trois options.

Compromis

  • La liste des droits suit le schéma à la main. Quand le site doit lire une nouvelle table, on l’ajoute à database-grants.ts, puis on réaligne le rôle (pnpm site:db:role).
  • Le site garde des écritures légitimes (commandes en attente, compte client, demandes). Il a donc toujours besoin de ses propres validations.
  • Avec des droits par colonne, le site charge ses relations dans des requêtes séparées (667757d693).
  • Les deux applications prennent des verrous Postgres sur les mêmes lignes. Leurs clés ne sont écrites qu’une fois, dans packages/contracts (quote-payment-lock.ts, promotion-lock.ts).

Conséquences

  • Le site lit le catalogue là où l’ERP l’écrit. Il n’y a ni synchronisation ni service intermédiaire.
  • Le script qui migre la prod refuse un rôle désaligné et donne la commande qui le réaligne (pnpm site:db:role --target <URL directe> --keep-password --yes). Le workflow qui le réalignait tout seul (c98e049eb4) est parti avec les GitHub Actions le 6 novembre.
  • Un test relève chaque requête du site et refuse celles qui n’ont pas leur droit (apps/site/test/database-grants.regression.test.ts).

Risques résiduels

  • Les deux applications partagent la base, et rien ne réserve de capacité à l’une ou à l’autre. Un pic sur le site ou une lecture lourde dans l’ERP ralentit les deux.
  • Une migration se juge depuis l’ERP, mais le site lit la base aussi. Si on renomme une colonne que le site lit, c’est le site qui casse, pas l’ERP. La détection des DROP et des RENAME et le contrôle du rôle au déploiement le signalent. Par contre, faire la migration en deux temps reste une question de discipline (Migrations Prisma).

Quand la revoir

  • Avec un troisième client de la base, ou un site confié à quelqu’un d’autre, une API devant la base remplacerait les droits par colonne.
  • Si le catalogue chargeait la base au point de gêner l’ERP, le site aurait une réplique en lecture, que Neon propose. Ça viendrait avant toute séparation des bases.
  • Si on devait retoucher les droits du site à presque chaque migration, ce serait le signe que le site lit une trop grande partie du schéma. Des vues dédiées vaudraient alors mieux que des droits table par table.

Sur cette page