Aller au contenu
Meubles Morinière

Le projet28 min de lecture

Étude de cas : Meubles Morinière

Un atelier-magasin de meubles, deux applications en production sur la même base de données, et un projet que j’ai mené seul. Je raconte le contexte, le problème, les contraintes, les décisions, la réalisation et les résultats. Chaque affirmation renvoie à sa preuve.

Meubles Morinière fabrique des meubles dans son atelier de Cholet, en France, et les vend dans son magasin depuis 1971. Là-bas, chaque vente est un petit projet : un devis, un acompte, des semaines de fabrication, une commande chez un fournisseur, une date promise au client et une facture que la loi interdit de modifier. Je raconte ici le logiciel que j’ai construit pour ce métier avec des agents de code IA : un ERP pour l’équipe, une boutique en ligne pour les clients, un assistant IA et une seule base de données. Je dis aussi ce qu’il garantit aujourd’hui, avec les preuves.

Si vous avez une minute, lisez En bref. Avec trois minutes, ajoutez Mon rôle. En vingt minutes, vous lisez tout le récit, du contexte aux résultats, puis ce que le projet montre. Et si vous avez une heure, allez voir les études de cas techniques, les décisions d’architecture et les compétences et leurs preuves, extraites du dépôt à chaque build.

En bref

  • C’est un atelier d’ébénisterie et un magasin de meubles. Une petite équipe y vend, fabrique, achète, livre et tient les comptes, au magasin comme en ligne.
  • Le logiciel, c’est un ERP pour l’équipe, une boutique en ligne pour les clients et Fisher, un assistant IA dans l’ERP. Ça fait deux applications Next.js sur la même base Postgres, plus cette documentation.
  • Je suis Adrien Poirier. J’ai mené le projet seul, de l’analyse des besoins du magasin jusqu’à l’exploitation. J’intègre l’IA (Claude Code) à mon processus de développement pour explorer, concevoir et construire plus efficacement, en gardant la maîtrise des choix techniques, de la cohérence du produit et de la qualité livrée : je cadre le besoin avec le gérant, j’arbitre, je fixe les règles que suit l’IA, je lance les tests et je vérifie le rendu à l’écran (Mon rôle).
  • J’ai six ans d’expérience en entreprise, dont quatre en développement. Depuis 2022, je développe en équipe une application Next.js de traçabilité. Je détaille ce parcours plus bas.
  • Je cherche un poste en équipe produit, à Nantes ou à Montréal, à partir de mars 2027. Mes coordonnées sont en fin de page (me contacter).
  • Côté technique : TypeScript strict, Next.js 16 et React 19, Postgres (Neon) et Prisma, Stripe, Better Auth, Tailwind CSS 4, Vercel, modèles d’Anthropic.
  • Les deux applications sont en prod chez Vercel, en région Paris. J’ai commencé le projet le 23 août 2026, et le site est ouvert au public depuis le 2 novembre 2026 : meublesmoriniere.fr.
tables Postgres
54
migrations de schéma
169
modules métier
40
fichiers de tests
1 789
Comptés dans le dépôt à chaque build de cette documentation.

Voici ce que le logiciel garantit aujourd’hui. À chaque fois, c’est un test ou la base elle-même qui le vérifie :

  1. Une pièce unique ne se vend qu’une fois, même si elle part au magasin pendant qu’un autre client la paie en ligne.
  2. Une faille du site public ne peut pas marquer une commande payée, parce que la base le refuse au rôle du site.
  3. Si quelqu’un retouche un encaissement, la veille le voit le lendemain matin, même avec tous les droits et les triggers désactivés. Pour le cacher, il faudrait réécrire toute la chaîne derrière lui (les limites).
  4. L’assistant IA ne peut pas sortir un nombre de nulle part sans que ça se voie : chaque nombre qu’il écrit est cherché dans ce que l’ERP lui a fourni.

Mon rôle

L’IA comme levier. L’ingénierie comme exigence. De la réflexion à l’implémentation, Claude Code me permet d’aller plus loin : le code, les tests, les migrations et cette documentation passent par lui. Les choix, la cohérence du produit et la qualité de ce qui part en production restent les miens.

ÉtapeCe que je faisOù le vérifier
CadrageJe recueille le besoin auprès du gérant et de l’équipe, puis je le redonne aux sessions comme cadre : une PME familiale, un seul entrepôt, des particuliers et des professionnels, la TVA à 10 % et 20 %. L’ERP soumet au gérant les règles qui engagent le magasin, et après deux tris, leur liste est passée de 302 à 8.Conception
ArbitragesJe tranche le budget, le périmètre et la méthode. Le tableau des arbitrages en retient sept, datées, par exemple sortir le remboursement de la première version, jouer la migration de production à la main ou interdire à l’IA de lancer les tests. Les choix de structure (monorepo, deux applications, base partagée, argent inaltérable) sont nés d’échanges avec l’IA : elle a proposé, j’ai retenu.Arbitrages, Ce qui me revient dans ces décisions
Direction des agentsJe fixe les règles que suivent les sessions (AGENTS.md), et des hooks en font respecter une partie. Je mène plusieurs sessions en parallèle, chacune dans son worktree, et j’intègre leur travail sur main. Du 22 octobre au 13 novembre, ça fait 462 sessions et 818 messages tapés.Développement
ValidationDepuis le 12 octobre, je lance les tests moi-même. Je vérifie le rendu à l’écran et je demande la source de ce que l’IA affirme.Validation, Comprendre et mettre en doute
ProductionJe suis le seul responsable de la mise en ligne, des migrations de la base et des pannes. L’ERP est parti 126 fois en prod entre le 23 août et le 16 novembre 2026, d’après les déploiements que GitHub a enregistrés pour le dépôt.Qualité et livraison, Déploiement

Je détaille cette méthode, traces à l’appui, dans Ma contribution et l’IA. Et je propose de défendre n’importe quelle décision de ce projet en entretien, sans l’IA (les questions que je suggère).

Hors de ce projet

Ce dépôt montre un projet que j’ai mené seul, avec l’IA comme levier. Pour mon travail en équipe, il faut regarder mon emploi.

Depuis septembre 2022

Développeur full stack, Oui-Connect puis Cometi (Saint-Herblain)

Oui-Connect était la filiale numérique de Cometi, un groupe industriel d’équipements thermiques, qui l’a absorbée en 2026. J’y développe en binôme les interfaces et la couche serveur d’une application Next.js de traçabilité par code QR et de gestion d’actifs, aujourd’hui en production. J’ai signé environ la moitié de ses commits depuis juillet 2024. J’en ai rédigé le plan d’architecture du frontend et la stratégie de tests, tenu le registre des décisions techniques de l’équipe et mis en place l’intégration continue (GitHub Actions). J’y étais en alternance jusqu’en 2025, et mon contrat se termine en mars 2027.

2020 – 2022

Support client et développement, 7Opteam (Nantes)

7Opteam édite un logiciel SaaS de gestion des interventions sur le terrain. Je répondais aux demandes de ses clients, j’allais recueillir leurs besoins sur place et j’ai réalisé des évolutions du logiciel en Angular.

Le dépôt de mon employeur est privé, comme celui-ci. Les chiffres viennent de son historique git, et j’en parle volontiers en entretien.

1. Le contexte

Les ébénistes de la maison fabriquent sur place des meubles en bois massif et en acier, sur mesure ou d’après leurs propres modèles. Le magasin les expose avec du mobilier, des luminaires et de la déco choisis chez des fabricants italiens, espagnols et français.

C’est la même petite équipe qui vend, fait les devis, commande aux fournisseurs, fabrique, livre et tient les comptes. Personne n’y est informaticien. Elle voulait vendre en ligne, mais sans que le site devienne un deuxième magasin à gérer. Une pièce peut partir au magasin ou sur le site, donc chacun doit voir tout de suite ce que l’autre a fait.

Site public · /
L’accueil du site public : une pièce de l’atelier en une, avec sa cote, son prix et sa disponibilité.
ERP · /tableau-de-bord
Le tableau de bord de l’ERP : commandes à préparer, état du site et du magasin, incidents, avancement de l’atelier, devis et stock.
L’accueil du site public sur un téléphone.
Le site public en production et le tableau de bord de l’ERP, sur ordinateur et au téléphone. Les captures viennent du manuel de l’équipe, sur la base de démonstration. Les personnes, les e-mails et les montants y sont fictifs, et les pastilles numérotées guident la lecture.

Le détail du métier, des utilisateurs et des écrans est dans la Présentation.

2. Le problème

Une commande ordinaire

Une cliente entre au magasin pour une table sur mesure en chêne massif et un canapé d’un fabricant italien. L’équipe fait le devis : cotes, essence, finition, acompte. La cliente l’accepte et paie l’acompte par carte au magasin. Elle réglera le solde à la livraison.

La date annoncée dépend du délai de l’atelier (six à huit semaines, comptées en jours ouvrés), des fermetures du magasin et du fabricant italien. L’accusé de réception du fabricant arrive trois jours plus tard, avec un tissu d’une autre couleur que celui choisi. Six semaines après, la table est prête, mais le canapé a deux semaines de retard. On ne pourra pas respecter la date promise, et il faut que la cliente l’apprenne avant de s’en rendre compte toute seule. Le même après-midi, la dernière chaise d’exposition du showroom se vend au magasin pendant qu’un autre client la paie sur le site. À la livraison, on encaisse le solde et on émet la facture. Après ça, on ne peut plus la modifier.

Le vrai problème est entre les outils

Chacun de ces moments peut se gérer avec un outil courant : une caisse, une boutique en ligne, un tableur de suivi. Sauf que rien d’important ne se passe dans un seul de ces outils. La date affichée sur le site dépend de l’atelier et du fournisseur. La pièce payée en ligne doit disparaître du magasin. L’achat qui arrive doit aller à la cliente qui l’attend, et l’encaissement doit retrouver sa facture. Donc informatiser chaque étape ne suffisait pas. Il fallait garder les liens entre elles.

TensionCe qui arrive quand le logiciel se trompe
Les délaisune date promise qu’on ne respecte pas, et le client le découvre le jour où le meuble n’arrive pas
L’argent en plusieurs foisun acompte, un solde, un remboursement ou un avoir qui ne retrouve pas sa facture
Deux canaux, un stockdeux clients débités pour une seule pièce
Les achatsun accusé de réception que personne n’a vérifié, et un canapé de la mauvaise couleur livré deux mois plus tard
La loiune facture retouchée, une caisse où une modification ne laisse pas de trace, des données gardées trop longtemps

Des audits du code ont trouvé deux de ces échecs. Celui du 1er septembre 2026 a montré que deux acheteurs pouvaient payer la même pièce à dix minutes d’écart. Celui du 7 novembre a montré que la date de livraison ne se calculait pas de la même façon d’un écran à l’autre. Je raconte les deux, avec leur correction, dans Tenir une pièce pendant un paiement et Une date promise qu’on peut tenir.

3. Les contraintes

Le métier disait quoi construire. Les contraintes, elles, ont décidé comment.

  • Je suis seul à construire, exploiter et réparer. Donc chaque brique doit rapporter plus qu’elle ne coûte à entretenir. Et ce qui dépend de la vigilance de quelqu’un finit par être oublié.
  • Je construis vite, avec l’IA comme levier, et cette vitesse ne doit rien coûter à la fiabilité (Un ERP trop lourd à maintenir). Une garantie ne repose donc pas sur la seule relecture : c’est la base, le typage, le lint ou un test qui l’assure.
  • L’argent et la loi française imposent leurs règles. Il y a le logiciel de caisse au sens de l’article 286 du Code général des impôts (CGI) français, dont les enregistrements doivent être inaltérables. Il y a aussi les factures à la numérotation continue, la TVA, le droit de rétractation de la vente à distance, le RGPD et la traçabilité du bois (EUDR). Ici, une erreur ne s’efface pas avec un simple déploiement.
  • Le site est ouvert à tout Internet, et il est branché sur la base de la comptabilité. Une faille du site ne doit pas pouvoir toucher à l’argent, aux factures ou aux données des clients.
  • Les tiers ont leur propre rythme. Stripe confirme un paiement des minutes ou des heures plus tard, et il renvoie ses événements pendant trois jours. Un fournisseur livre en retard, un bon de livraison arrive en photo.
  • L’équipe n’a pas d’informaticien. L’ERP doit signaler lui-même ce qui cloche, marcher sur téléphone et pardonner un faux geste.
  • Le budget, c’est celui d’une petite entreprise : des services managés, pas de serveur à administrer et une dépense d’IA plafonnée chaque mois.

4. Les décisions

Six décisions donnent sa forme au logiciel. Chacune a son coût et une trace écrite : un ADR, une étude de cas ou les deux.

Les contraintes de budget, de périmètre et de méthode viennent de moi. Beaucoup de choix techniques sont nés de propositions de Claude Code dans ce cadre, que j’ai retenues. Le partage, ADR par ADR, est dans Ce qui me revient dans ces décisions.

Deux applications, une base, deux rôles

L’ERP et le site public sont deux applications Next.js. Elles partagent une base Postgres, mais elles n’ont pas les mêmes droits. Le site se connecte avec un rôle qui a seulement ce dont son code a besoin, table par table et colonne par colonne. Il peut créer une commande en attente de paiement, mais il ne peut pas la marquer payée. C’est l’ERP qui le fait, quand il reçoit le webhook de Stripe.

Du coup, une vente en ligne et une vente au magasin, c’est la même commande, sans synchronisation ni double saisie. Et la partie exposée à Internet n’a pas les clés de l’argent.

Par contre, le site dépend du schéma, et il faut maintenir ses droits à la main. Un test relève chaque requête du site et refuse celle qui n’a pas son droit.

ADR 0002 · ADR 0003 · Le site n’a que les droits qu’il lui faut

Les garanties sont dans la base

C’est Postgres qui garantit ce dont dépendent l’argent, la loi et le stock. Les montants sont des entiers en centimes. La base refuse qu’on modifie ou qu’on efface une facture émise, une clôture de caisse, un mouvement de stock ou un encaissement. Le stock ne descend pas sous zéro. Et chaque encaissement porte une empreinte SHA-256, calculée par la base, qui le lie au précédent.

Une garantie écrite dans le code saute avec un bug, un script ou une erreur d’inattention. Une contrainte de la base, non. Et avec la chaîne d’empreintes, une retouche faite avec tous les droits se voit, sauf si on réécrit toute la chaîne derrière elle.

Ça coûte des migrations plus lourdes. Ça demande aussi des tests sur une vraie base Postgres, et pas sur des simulations, parce que chaque contrainte CHECK a son cas de refus.

ADR 0008 · Des encaissements qui ne se retouchent pas · Données

Une règle métier s’écrit une fois

La TVA, les prix, les remises, le port, les délais et la date promise sont dans un seul paquet, packages/domain, qui n’ouvre aucune connexion et ne lit ni le réseau ni les variables d’environnement. Les deux applications l’appellent. Le site est né d’un fork de l’ERP, et il ne peut plus s’en écarter : un contrôle au push refuse une règle corrigée d’un seul côté.

Du coup, le prix, la disponibilité et la date que voit le client sont ceux que l’atelier applique, et le client paie ce qu’il a vu.

Il reste des relais d’une ligne entre les applications et les paquets. Ils ont été gardés pour sortir le code sans réécrire les tests, et ils sont notés comme dette.

ADR 0005 · Deux applications nées d’un fork · Une date promise qu’on peut tenir

Déduire plutôt que stocker

La réservation d’une pièce pendant un paiement n’est écrite nulle part. On la lit dans les commandes du site qui sont encore en attente et encore payables.

Avec une table de réservations, il faut une expiration à balayer et un chemin de libération pour chaque cas. Et à chaque oubli, une pièce reste bloquée ou se libère trop tôt. Ici, une commande abandonnée arrête de retenir quoi que ce soit, même si plus aucun code n’y touche.

En échange, chaque lecture recalcule les réservations. Au volume d’un magasin, ça fait quelques lignes. Pour une grande boutique, il faudrait un index dédié.

Tenir une pièce pendant un paiement

Les faits de Fisher viennent de l’ERP

Fisher lit les documents, rédige et répond, mais les faits ne viennent pas du modèle. Les noms et les adresses sont des emplacements que l’ERP remplit après coup. La lecture d’une demande de devis n’a pas de champ de prix. Chaque nombre d’une réponse est comparé à ce que l’ERP a fourni pendant l’échange. Et avant toute écriture, une personne doit confirmer.

Dans un ERP, un chiffre plausible mais faux engage de l’argent ou une promesse au client. Et demander au modèle de ne rien inventer, ça ne se vérifie pas.

Le contrôle est lexical, donc il signale aussi un calcul juste fait par le modèle. C’est voulu, parce que le calcul, c’est le travail du code.

ADR 0012 · Un assistant qui n’apporte pas les faits

Construire le moins possible

Le projet n’a pas de file d’attente durable, pas d’API devant la base, pas de CI hébergée, pas de rôles pour le personnel et pas de feature flags. La porte avant la prod, c’est un hook pre-push qui juge chaque commit dans un worktree détaché.

Pour un magasin et une seule personne, chacune de ces briques coûterait plus à entretenir qu’elle ne rapporterait.

Le coût ne disparaît pas, il se déplace : la fiabilité repose sur des contrôles locaux et des alertes. Pour chaque brique absente, le signal qui la ferait revenir est écrit. Si une deuxième personne pousse du code, la CI revient. Si un troisième client se branche sur la base, il faut une API. Sans file d’attente, un envoi dont on ne connaît pas l’issue reste un état visible de la ligne, et chaque reprise porte la clé d’idempotence de la première tentative.

ADR 0010 · Dette, risques et évolutions · Un ordre dont on ne sait pas s’il est parti

Dans le code

Voici quatre de ces décisions, lues dans le dépôt au build de cette page.

  • Réservation déduite : une commande retient ses pièces tant qu’elle est vendue sur le site, en attente de paiement, pas annulée et assez récente pour être encore payable. Ces quatre faits, elle les porte déjà.
  • Rôle du site : sur une vraie base et avec le rôle du site, Postgres refuse qu’il marque une commande payée.
  • Encaissements chaînés : chaque encaissement porte l’empreinte du précédent. Donc si on modifie une ligne, la chaîne casse, et la veille la vérifie chaque matin.
  • Chiffres de Fisher : à la fin de chaque échange, les nombres de la réponse qui ne sont pas dans ce que l’ERP a fourni sont signalés à la personne.
pendingReservationWherepackages/domain/src/stock-reservation.ts · lignes 25–51
/**
 * Les commandes du site qui tiennent encore leurs pièces : impayées, et ouvertes depuis moins
 * longtemps que leur session de paiement (et le délai de reprise des événements Stripe, quand une
 * session est partie). Une commande que l'atelier a annulée avant son paiement n'en tient plus :
 * payée quand même, elle ne prend rien au stock (`settleCanceledOrder`). Une pièce réservée n'est pas
 * libre pour le paiement du site, son panier et sa page de commande (`withFreeStock`), ni pour les
 * gestes de l'ERP qui servent une commande déjà payée (changement de variante, rupture servie). La
 * vente au magasin (vente hors site, devis accepté au comptoir), elle, la prend sur le stock brut :
 * le client est là, la pièce en main ; le paiement en ligne qui la tenait se ferme ensuite
 * (`releaseSoldReservations`). Les soldes AFFICHÉS de la fiche et le « Disponible » de
 * la console restent le stock brut : la caisse dit au client que la pièce est en cours de paiement
 * (`StockShortage.isInPayment`).
 */
export function pendingReservationWhere(nowMs: number): Prisma.OrderWhereInput {
	return {
		channel: SaleChannel.WEB,
		paymentStatus: PaymentStatus.PENDING,
		fulfillmentStatus: { not: FulfillmentStatus.CANCELED },
		OR: [
			{ createdAt: { gt: new Date(nowMs - CHECKOUT_RESERVATION_WINDOW_MS) } },
			{
				stripeSessionId: { not: null },
				createdAt: { gt: new Date(nowMs - CHECKOUT_PAYABLE_RESERVATION_WINDOW_MS) },
			},
		],
	};
}

5. La réalisation

Le produit

  • L’ERP couvre tout le métier : la vente au magasin et les devis, les commandes où on voit côte à côte où en est l’argent et où en est la préparation, les échéances de l’atelier, les achats liés aux lignes des clients, le stock au coût moyen pondéré, le catalogue, les factures, les avoirs, la TVA et l’export comptable, et le service après-vente.
  • Le site public vend le catalogue avec la disponibilité et la date de livraison que la fiche peut promettre. Il sait encaisser par Stripe Checkout, et le client pourra y accepter et payer un devis. Le paiement en ligne et l’envoi des devis restent fermés en prod tant que les CGV ne sont pas définitives (isCheckoutOpen). Le client peut déjà y suivre sa commande sans compte obligatoire et demander une rétractation en ligne.
  • Fisher lit un bon de livraison, un accusé de réception ou une demande de devis, sur papier, en photo ou à la voix. Il rédige à partir des faits de l’ERP et répond aux questions de l’équipe, sous les droits de la personne qui l’utilise.

L’architecture

Un monorepo pnpm regroupe les trois applications (apps/erp, apps/site, apps/docs) et les paquets qu’elles partagent : le schéma et les migrations (db), les règles métier (domain), l’authentification (auth), le contrat de leurs échanges (contracts), le kit d’interface (ui), les briques techniques (infra) et la rétractation (orders). ESLint surveille les frontières entre les couches, et les dépendances ne vont que dans un sens.

Postgres · Neon

la base commune

  • ERP → DATABASE_URL · rôle propriétaire
  • Site → DATABASE_URL · rôle moriniere_site

Stripe

paiements

  • ERP → STRIPE_SECRET_KEY · clé secrète
  • ERP ← STRIPE_WEBHOOK_SECRET · webhook
  • Site → STRIPE_SECRET_KEY · clé restreinte

Vercel Blob

photos, pièces comptables

  • ERP → BLOB_READ_WRITE_TOKEN · photos, écriture
  • ERP → INVOICE_BLOB_READ_WRITE_TOKEN · factures et devis, écriture
  • Site → BLOB_PUBLIC_HOST · photos, lecture seule

Resend

e-mails

  • ERP → RESEND_API_KEY · envoi
  • Site → RESEND_API_KEY · envoi

Upstash Redis

limites de débit

  • ERP → KV_REST_API_URL · débit, idempotence
  • Site → KV_REST_API_URL · débit

Vercel AI Gateway

Fisher, modèles Anthropic

  • ERP → AI_GATEWAY_API_KEY · appels

Web Push

notifications du personnel

  • ERP → VAPID_PRIVATE_KEY · signature

La Poste

suivi des colis

  • ERP → LA_POSTE_OKAPI_KEY · API Suivi

Vercel Cron

tâche planifiée

  • ERP ← /api/veille · « 0 6 * * * », UTC

Entre les deux applications

  • ERP → Site /api/revalidate · REVALIDATE_SECRET · périmer le cache des pages
  • Site → ERP /api/evenements-site · SITE_EVENTS_SECRET · annoncer une rétractation, une suppression de compte
  • Site → ERP /api/devis-site · QUOTE_PDF_SECRET · obtenir le PDF d’un devis
  • Site → ERP /api/factures-site · QUOTE_PDF_SECRET · obtenir le PDF d’une facture
Un lien n’est tracé que si le code de l’application lit la variable d’environnement qui l’ouvre ; les chemins des canaux viennent de packages/contracts, la tâche planifiée du vercel.json. Relu dans le dépôt à chaque build de cette documentation.
  • Le rendu passe par l’App Router de Next.js, avec Cache Components et React Compiler. Une page de l’ERP n’attend pas sa lecture la plus lente : chaque bloc secondaire arrive sous son propre Suspense, avec un squelette fidèle au rendu final.
  • Côté cache, dès qu’on publie dans l’ERP, le cache des pages concernées du site est invalidé, par tags.
  • Les événements que le site envoie à l’ERP (rétractation, suppression de compte) sont signés (HMAC-SHA256) et datés. Au-delà de cinq minutes, ils sont refusés. Les autres appels entre les applications passent par un secret partagé, comparé à temps constant. Le site n’a qu’une clé Stripe restreinte et pas de jeton d’écriture de fichiers.

Architecture · Next.js et React · Échanges entre les applications

La sécurité et la vie privée

  • Dans la base, le moindre privilège passe par le rôle du site, des droits par colonne et des triggers de garde. Si le site se connecte avec un autre rôle, il refuse de démarrer.
  • Chaque action serveur de l’ERP commence par sa garde, et un test lit chaque action pour le vérifier. Pour rembourser, effacer ou exporter des données, il faut s’être connecté récemment.
  • Les clients n’ont pas de mot de passe. Le compte est facultatif, et on s’y connecte avec un code à usage unique reçu par e-mail.
  • Un effacement survit à une restauration. Quand on restaure une copie de la base, on rejoue un registre d’empreintes qui ne contient aucune adresse (Un effacement qui survit à une restauration).
  • Dans les données que l’ERP fournit au modèle, les coordonnées des clients sont masquées. Un document déposé par l’équipe, lui, part tel quel. Et le fournisseur ne s’entraîne pas sur les données.

Sécurité · Données personnelles

La qualité

  • Chaque garantie de Postgres a ses tests sur une vraie base : les contraintes, les triggers, les ventes concurrentes du dernier exemplaire, et le nombre de requêtes d’une page pour refuser un N+1.
  • D’autres tests lisent le code et refusent tout écart à une règle : chaque écriture invalide son cache, chaque action a sa garde, et les verrous se prennent toujours dans le même ordre (Des tests qui lisent le code à la place du relecteur).
  • Avant la prod, le hook pre-push rejoue dans un worktree détaché le lint, les types et les tests touchés. Quand le changement le demande, il rejoue aussi la suite Postgres et il contrôle le poids du JavaScript du site.
  • La documentation ne peut pas rester fausse longtemps. Chaque extrait de code de ces pages est lu dans le dépôt au build, et si un symbole a disparu, le build casse.

Qualité et livraison · Tests

L’exploitation

  • Chaque matin, une veille cherche ce qui cloche en prod : de l’argent reçu par Stripe que l’ERP n’a pas encaissé, une commande encaissée sans facture, un trou dans la numérotation des factures, un stock qui ne correspond plus à son historique. Elle l’envoie à l’équipe par e-mail et sur son téléphone (Une veille qui dit ce qu’elle n’a pas pu lire).
  • Les migrations sont outillées : un essai à blanc, puis l’application, avec l’instant de restauration Neon noté avant. Pour une migration destructive, il faut un flag explicite.
  • Une restauration rejoue les effacements, pour qu’une personne effacée ne revienne pas avec une copie.
  • Les relevés de prod sont datés et on peut les rejouer : le temps de réponse des fonctions et la part des requêtes servies par le cache (Mesures).

La méthode

  • Je fixe des règles écrites, pour les humains comme pour les agents de code (AGENTS.md) : comment charger une page, quand afficher un toast, ce qu’un test doit vérifier, quand découper un fichier. Les garde-fous mécaniques (les types, le lint, les contraintes et les tests qui lisent le code) valent pour tout le monde.
  • Les décisions sont écrites au format ADR, avec ce que les sources confirment, ce qui reste une hypothèse, les risques qui restent et le signal qui ferait changer d’avis.
  • On mesure avant de corriger. Quand l’ERP ajoutait 2,5 lignes pour une retirée (du 18 octobre au 9 novembre), j’ai répondu par une règle d’écriture. Je n’ai pas lancé de grand nettoyage (Un ERP trop lourd à maintenir).
  • La documentation est dans le dépôt et lit le code au build. Elle est écrite en français. Les pages d’entrée, les pages de preuves et les études de cas techniques existent aussi en anglais.

6. Les résultats

Ce que la base et les tests garantissent

suites de tests jouées sur une vraie base Postgres
111
apps/*/test/db/*.db.test.ts
tests de régression, dont la plupart lisent le code source et refusent tout écart à une règle
92
apps/*/test/*.regression.test.ts
contraintes CHECK écrites à la main, relues sur la base à chaque migration appliquée
169
apps/erp/scripts/constants/db-invariants.ts#EXPECTED_CHECKS
tables, sur les 54 du schéma, où le site public peut écrire
6
apps/site/scripts/lib/database-grants.ts#SITE_TABLE_GRANTS
fichiers de code encore copiés d’une application à l’autre, liste qui ne peut que diminuer
28
scripts/twins.manifest.json
anomalies que la veille de l’ERP recherche en production
28
apps/erp/modules/monitoring/constants/anomaly-readings.ts#ANOMALY_READINGS
Mesuré dans le dépôt à chaque build de cette documentation.

Avant, après

Le problèmeCe qui a changéCe qui le prouve
Deux acheteurs pouvaient payer la même pièce uniquele deuxième est refusé avant de payer, et il n’y a rien à expirer ni à nettoyertest sur Postgres : une seule commande est créée pour une pièce unique
Chaque écran calculait la date de livraison à sa façonune seule règle, une promesse figée au paiement, et un avis au client quand l’échéance la dépassetest qui passe chaque jour autour des jours fériés
Un trigger désactivé ne laissait aucune tracetoute retouche d’un encaissement casse la chaîne, qui est vérifiée chaque matin et à chaque migration jouéechaîne d’empreintes SHA-256 calculée par la base
Une copie restaurée faisait revenir les clients effacésà la restauration, on rejoue le registre des effacements, sans garder d’adressetests du rejeu sur une vraie base
Une faille du site aurait ouvert toute la baseen écriture, au pire des commandes en attente de paiement et les données du compte clienttest joué avec le rôle du site
Un modèle de langage écrit des chiffres plausiblesles faits ne viennent pas du modèle, et chaque nombre qu’il écrit est comparé à ce que l’ERP a fournicontrôle à chaque échange, brouillon refusé au moindre écart
Deux copies d’une règle de calcul s’écartaient sans que personne le voieune correction faite d’un seul côté est refusée au pushpnpm check:twins, une liste de copies qui ne peut que diminuer
L’ERP ajoutait 2,5 lignes pour une retirée, du 18 octobre au 9 novembre1,35 pour une sur les quatre jours suivants (relevé du 13 novembre 2026)git log, méthode de comptage dans l’étude

Ce qui n’est pas encore prouvé

Une étude de cas qui ne raconte que ses succès, on ne peut pas la vérifier. Donc voici ce que le dépôt ne montre pas encore.

  • Je n’ai pas de chiffre d’usage à montrer : pas de nombre de commandes, pas de temps gagné par l’équipe. Le projet a commencé le 23 août 2026, le site est ouvert depuis le 2 novembre et l’équipe se sert de l’ERP depuis peu. Ces pages montrent ce que le logiciel garantit. Elles ne montrent pas encore ce qu’il a changé pour le magasin. Et le site ne vend pas encore en ligne : la caisse et l’envoi des devis attendent des CGV définitives.
  • La couverture de tests et les Core Web Vitals mesurés chez les visiteurs ne sont pas relevés, et les parcours end-to-end se lancent à la main. Le protocole pour les obtenir est écrit (Mesures).
  • Une seule personne écrit, relit, migre et restaure. Les procédures sont outillées, mais aucune restauration complète n’a laissé de trace dans le dépôt.
  • Pour la qualification du logiciel de caisse au regard de l’article 286 du CGI, on attend la réponse de l’expert-comptable. C’est le seul risque que le code ne peut pas réduire.
  • La taille n’a pas encore baissé. Le rythme d’ajout a changé de pente, mais des composants dépassent encore le plafond de 600 lignes, et des tests simulés font encore doublon avec la suite jouée sur la base.

Dette, risques et évolutions · Ce qui n’est pas couvert

7. Ce que ce projet montre

Selon le poste que vous cherchez à pourvoir, voici où regarder. Le tableau dit ce que le logiciel fait et où le vérifier. Pour savoir ce qui vient de moi dans chaque ligne, voyez Mon rôle.

Pour un poste en…Ce que le projet en montreOù le vérifier
Développement full-stack (TypeScript, React, Next.js)deux applications Next.js 16 et React 19 en prod, un rendu serveur par blocs, un cache invalidé par l’ERP, un client qui paie ce qu’il a vuFull-stack, Next.js et React
Back-end et donnéesun modèle métier riche, et Postgres qui garde les règles : contraintes, triggers, verrous ordonnés, chaîne d’empreintes, migrations outilléesDonnées, Qualité
Architecture logicielleun monorepo aux frontières vérifiées, des décisions écrites avec leurs compromis, des refus de construire argumentésArchitecture, Décisions
Sécurité applicativele moindre privilège en base, des messages signés, des secrets qui changent sans coupure, la vie privée prise en compte dès la conceptionSécurité
IA appliquée (intégration de LLM)un assistant en prod dont les garanties sont vérifiées par le code, un jeu d’évaluation tiré des vraies erreurs, une dépense plafonnéeFisher, Un assistant qui n’apporte pas les faits
Produit et UXun ERP pour une petite équipe : chargement progressif, gestes qu’on peut annuler, rien de perdu sur une coupure, accessibilité vérifiéeUX
Développement assisté par IAdes règles écrites, des garde-fous mécaniques, un rythme de maintenance mesuré puis corrigéUn ERP trop lourd à maintenir
Analyse du besoin et relation avec le métierun métier modélisé du devis à la facture, des règles soumises au gérant dans l’ERP, un manuel intégré pour l’équipeLogique métier, Conception
Livraison et exploitationune porte avant la prod, des migrations outillées avec leur retour arrière, des sauvegardes, une veille qui cherche les anomalies chaque matinQualité et livraison, Une veille qui dit ce qu’elle n’a pas pu lire

Ce qui se transpose au Québec et au Canada

Le projet répond au droit français, pour une entreprise française. Mais ses pratiques se transposent directement.

  • Pour la vie privée, le projet applique trois principes sous le RGPD : recueillir le moins possible, garder les données seulement le temps nécessaire (les durées sont écrites une fois dans le code et appliquées chaque matin) et prouver l’effacement. Ce sont aussi les principes de la LPRPDE et de la Loi 25 du Québec, qui exige de détruire ou d’anonymiser un renseignement personnel une fois que les fins de sa collecte sont accomplies. La Loi 25 demande aussi une évaluation des facteurs relatifs à la vie privée (EFVP) avant qu’un renseignement personnel quitte le Québec. La documentation dit déjà où sont hébergées les applications et la base (Vercel à Paris, Neon en Virginie), et c’est le point de départ de cette évaluation.
  • Pour les taxes, les taux et les arrondis sont dans un seul paquet pur et testé, que tous les canaux de vente appellent. C’est la forme qu’il faut pour la TPS, la TVH et la TVQ, dont les taux et les combinaisons changent d’une province à l’autre.
  • Côté langues, le produit est pensé en français d’abord, comme la Charte de la langue française l’attend des logiciels et des sites commerciaux. Dans le code, les noms sont en anglais. Cette documentation est écrite en français, et ses pages d’entrée, ses pages de preuves et ses études de cas techniques sont traduites en anglais.

Aller plus loin

Contact

Si ce projet ressemble au poste que vous cherchez à pourvoir, je vous montre volontiers le code en entretien.

Adrien Poirier

Développeur logiciel full stack

Je cherche un poste en équipe produit, à Nantes ou à Montréal, à partir de mars 2027. J’ai six ans d’expérience en entreprise, dont quatre en développement. Depuis 2022, je développe en équipe une application Next.js de traçabilité.

Formation
Titre de niveau master (RNCP 7)
Lieu
Nantes, France. Installation à Montréal dès l’embauche.
Statut au Canada
PVT, demande prévue pour 2027
Langues
Français, langue maternelle. Anglais intermédiaire.

Sur cette page