Le projet10 min de lecture
Présentation
Le magasin et son métier, le problème à régler, pour qui j’ai fait le logiciel, et ce que font l’ERP et le site au quotidien.
Meubles Morinière, c’est une entreprise familiale de Cholet, dans le Maine-et-Loire. Depuis 1971, elle fabrique des meubles dans son atelier d’ébénisterie et les vend dans son magasin. Je développe son logiciel. Il couvre tout le métier, de la fiche d’un meuble jusqu’à sa livraison. L’équipe travaille dans l’ERP. Les clients choisissent et suivent leurs meubles sur le site, et ils pourront y payer dès que les CGV seront définitives. L’ERP et le site tournent sur la même base Postgres. Du coup, une vente en ligne, au magasin ou sur devis, c’est la même commande, et on la suit jusqu’à la facture.



Cette doc est longue. Selon ce que vous cherchez, un parcours vous amène à l’essentiel en quelques pages.
- Vous recrutezL’essentielCe qu’est le projet, ce qu’il montre selon le poste, et comment j’utilise l’IA comme levier.6 étapes · environ 14 minCommencer
- Vous encadrez une équipe techniqueLes décisionsLes choix qui donnent sa forme au logiciel, ce qu’ils coûtent, ce que j’ai refusé de construire et ma façon de travailler avec des agents de code.6 étapes · environ 53 minCommencer
- Vous développezDans le codeComment le dépôt est rangé, ce que la base garantit, comment les pages se rendent, et ce qui juge un changement avant la production.7 étapes · environ 1 h 20Commencer
Le contexte
À l’atelier, les ébénistes fabriquent 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 achetés chez des fabricants italiens, espagnols et français.
L’équipe est petite. Ce sont les mêmes personnes qui vendent au magasin, font les devis, commandent aux fournisseurs, fabriquent, livrent et tiennent les comptes. La vente en ligne s’ajoute au magasin. Une même pièce peut donc partir au magasin ou sur le site, et il faut que chacun sache ce que l’autre a vendu.
Le problème métier
Quand on fabrique ce qu’on vend, chaque vente devient un petit projet qui dure plusieurs semaines.
Premier souci, les délais. Un meuble fabriqué à la commande met plusieurs semaines à arriver. La date promise au client dépend du délai de l’atelier, des fournisseurs, des jours ouvrés et des fermetures du magasin. Et si on ne peut plus respecter cette date, il faut prévenir le client avant qu’il s’en rende compte tout seul.
Ensuite, l’argent arrive en plusieurs fois : un acompte, puis le solde, en ligne ou au magasin (espèces, chèque, carte, virement). Parfois il y a aussi un remboursement ou un avoir.
Le stock est partagé entre le magasin et le site. Une pièce vendue au magasin ne doit plus pouvoir se payer sur le site. Et si le magasin vend une pièce qu’un client est en train de payer en ligne, ce paiement doit s’arrêter.
Une commande client en déclenche souvent une autre chez un fournisseur. Il faut la relancer, vérifier que son accusé de réception correspond bien à ce que le client a choisi (finition, couleur, cotes), puis servir le client dès que la marchandise arrive.
Et il y a la loi : des factures qu’on ne peut plus modifier, des encaissements où la moindre retouche doit se voir, la TVA, le droit de rétractation pour la vente à distance, des données personnelles qu’on ne garde qu’un temps et la traçabilité du bois (EUDR).
Chacun de ces sujets pourrait se gérer avec un outil du commerce : une caisse, une boutique en ligne, un tableur. Le vrai problème, c’est ce qui se passe entre ces outils. La date promise sur le site dépend de l’échéance de l’atelier. L’achat qui arrive doit aller au client qui l’attend. Et l’encaissement doit retrouver sa facture.
Les objectifs
- On ne saisit une donnée qu’une fois. Ensuite elle sert partout : dans l’ERP, sur le site, dans les e-mails, les PDF et le flux Google Merchant Center.
- On ne promet au client que ce qu’on peut vraiment faire. Le prix, la disponibilité et la date qu’il voit viennent de la règle que l’atelier applique, écrite une seule fois dans
packages/domain(Logique métier). Et il paie ce qu’il a vu (Panier et paiement). - Les obligations ne doivent pas dépendre de la vigilance de l’équipe. Tout ce qui touche à l’argent, à la loi et au stock, c’est la base qui le protège (Données). Le site est ouvert à tout Internet, donc il peut seulement créer une commande en attente de paiement. C’est l’ERP qui la marque payée (Sécurité).
- L’ERP doit faciliter la vie d’une petite équipe. Il est rapide, il marche sur téléphone, il signale chaque matin ce qu’il faut regarder et il se charge des saisies pénibles (Interface de l’ERP).
Les utilisateurs
| Qui | Où | Ce qu’ils y font |
|---|---|---|
| L’équipe du magasin et de l’atelier | L’ERP, sur ordinateur et sur téléphone | vendre au magasin, faire les devis, préparer et livrer, commander aux fournisseurs, compter le stock, publier le catalogue, suivre les chiffres |
| Les clients | Le site | choisir, payer, accepter et payer un devis, suivre une commande, se rétracter, retrouver leurs factures |
| Le comptable | Les exports de l’ERP | recevoir l’export de l’exercice. L’ERP prépare aussi les déclarations de TVA |
Dans l’ERP, tout le monde a les mêmes droits. Dans une équipe de cette taille, chacun doit pouvoir tout faire. Du coup, les écrans sont rangés par métier. Les gestes sensibles demandent quand même de s’être connecté récemment : rembourser, émettre un avoir, effacer des données, exporter des données personnelles ou fiscales.
Côté site, le compte client est facultatif. On peut payer et suivre une commande sans compte. Pour se connecter, on reçoit un code à usage unique par e-mail. Il n’y a pas de mot de passe.
L’ERP, l’outil de l’équipe
Le menu de gauche est organisé par métier : Vendre, Achats et stock, Catalogue, Gestion (apps/erp/shared/constants/admin-sections.ts#ADMIN_SIDEBAR_GROUPS). La journée commence sur le tableau de bord et la liste « À faire », triée selon ce qu’on perd à attendre (La journée de l’équipe). La palette (⌘K) ouvre n’importe quel écran, n’importe quelle fiche et n’importe quel chapitre du manuel.
- Vendre : une vente au magasin peut s’encaisser en une ou plusieurs fois. Sur une commande, on voit côte à côte où en est le paiement et où en est la préparation. Un devis part au client, qui peut l’accepter et le payer en ligne. Il devient alors une commande. L’envoi attend l’ouverture du paiement en ligne (Devis, Commandes, Acomptes et paiements).
- Atelier et livraison, dans le groupe Vendre : chaque commande a deux dates. Il y a l’échéance de l’atelier, comptée en jours ouvrés à partir du paiement, et la date promise au client. Si l’échéance de l’atelier dépasse la date promise, l’ERP le signale et l’équipe prévient le client (Délais et dates promises). On y trouve aussi la préparation et le planning des livraisons.
- Achats et stock : une commande fournisseur est liée aux lignes des commandes clients. Quand elle arrive, ce que le client attend lui revient directement, et le reste entre en stock au coût moyen pondéré. Le réassort propose ce qui passe sous son seuil. Et le journal du stock ne peut pas être réécrit (Fournisseurs et achats, Stock).
- Catalogue : les meubles et leurs déclinaisons, les photos, les catégories, les collections, les couleurs et les matériaux. Dès qu’on publie ou qu’on modifie quelque chose, le cache des pages concernées est invalidé sur le site (Échanges entre les applications).
- Gestion : les chiffres et la TVA, les factures et les avoirs, les déclarations par période et l’export de l’exercice (Facturation). Les remboursements, les rétractations, les retours et les litiges se suivent sur la commande (Service après-vente). La fiche d’un client regroupe ses commandes et ses devis, qu’il ait acheté sur le site ou au magasin (Clients).
- Réglages et coulisses : les horaires, les fermetures, la livraison, les codes promo et les comptes du personnel, plus la santé du système et la mesure de Fisher.
Même si personne n’ouvre l’ERP, la veille regarde chaque matin ce qui cloche et l’envoie à l’équipe par e-mail et sur son téléphone. Une nouvelle commande ou un litige arrivent aussi en notification (ERP).
ERP
Ouvrir la journée
On voit d’abord ce qui demande de l’attention, puis on ouvre n’importe quel écran au clavier.




Tableau de bord. Il montre les commandes à préparer, l’état du site et du magasin, les incidents, l’atelier, les devis et le stock.
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 site, la boutique des clients
- Choisir : le catalogue et ses filtres, la recherche, les collections et les favoris. Sur la fiche d’un meuble, le client voit les déclinaisons, le prix, la disponibilité et la date de livraison possible, calculés avec les mêmes règles que dans l’ERP.
- Payer : le panier, puis le paiement par Stripe Checkout. Si un prix, un stock ou une remise a changé entre le moment où le client l’a vu et le moment où il paie, le site le lui dit. Il ne paie que ce qu’il a vu (Panier et paiement). En prod, le paiement en ligne reste fermé tant que les CGV ne sont pas définitives (
isCheckoutOpen). - Accepter un devis : le client ouvre son devis depuis un lien. Il peut télécharger le PDF et payer en ligne.
- Suivre : pas besoin de compte pour suivre une commande. Avec un compte, on retrouve au même endroit ses commandes, ses devis et ses factures. La rétractation se demande aussi en ligne.
- Demander : un projet sur mesure se décrit en une phrase, et un souci après l’achat se signale avec des photos. Les deux partent par e-mail au magasin, sans système de tickets (Demandes au magasin).
- Être trouvé : le plan du site, les données structurées, les images de partage, et un flux Google Merchant Center qui reprend le prix, la livraison et la date affichés sur la page (Référencement).
Site public
Choisir et commander
De la une au suivi d’une commande, tel que les clients le voient.







Accueil. La une montre une pièce de l’atelier avec sa cote, son prix et sa disponibilité, et l’état du magasin.
Le site en production, capturé en lecture seule.
Fisher, l’assistant
Fisher, c’est l’assistant de l’ERP. Il est en haut à droite de chaque page (⌘J). On peut lui donner un bon de livraison, l’accusé de réception d’un fournisseur ou une demande de devis, sur papier, en photo ou à la voix, et il en tire de quoi remplir le formulaire. Il sait aussi rédiger un texte à partir des données de l’ERP, et répondre aux questions de l’équipe sur la marche à suivre, le stock, une commande ou un achat.
Tous les chiffres qu’il donne viennent d’une lecture de l’ERP. S’il en écrit un qui n’a pas de source, la personne est prévenue. Et il ne modifie rien tant qu’elle n’a pas confirmé (Fisher).
Le parcours d’une commande
- 01ERPPublierLa fiche réunit les déclinaisons, les photos, le prix et le délai d’atelier. Dès qu’on la publie, le cache du site est invalidé et elle y apparaît aussitôt.
- 02Site et ERPVendreUne vente en ligne, au magasin ou sur devis, c’est la même commande. Le client paie ce qu’il a vu.
- 03ERPEncaisserStripe ne confirme le paiement qu’à l’ERP, par webhook. Chaque encaissement est chaîné au précédent.
- 04ERPFabriquer et acheterL’échéance de l’atelier se compte à partir du paiement. Les achats sont liés aux lignes du client, et Fisher lit les accusés de réception.
- 05ERPRecevoirCe que le client attend lui revient dès la réception. Le reste entre en stock, au coût moyen pondéré.
- 06Site et ERPLivrerL’équipe prépare la commande et planifie la livraison. Le client la suit sur le site, sans compte.
- 07ERPFacturerLa facture est inaltérable et archivée avec son empreinte. Une erreur se corrige par une nouvelle pièce, et la TVA se déclare par période.
- 08ERPVeillerChaque matin, la veille passe en revue ce qui cloche et prévient l’équipe par e‑mail et sur son téléphone.
Comment c’est construit
- tables Postgres
- 54
- migrations de schéma
- 169
- modules métier
- 40
- fichiers de tests
- 1 789
L’ERP (apps/erp) et le site (apps/site) lisent et écrivent dans la même base Postgres, mais pas avec les mêmes droits. Le site n’a que ceux dont il a besoin, table par table et colonne par colonne. Tout ce que les deux applications doivent faire de la même façon est dans les paquets (packages/*) : le schéma de la base, les règles métier (TVA, prix, délais…), l’authentification, le contrat de leurs échanges et le kit d’interface (Architecture).
Côté technique, c’est du Next.js (App Router, Cache Components, React Compiler) et React 19 en TypeScript strict, Prisma sur Postgres (Neon), Better Auth, Stripe pour les paiements en ligne, Tailwind CSS 4, et les modèles d’Anthropic via la passerelle IA de Vercel. Les applications sont hébergées chez Vercel, en région Paris. La base est chez Neon, aux États-Unis, en Virginie (us-east-1) (Intégrations).
Ce que ce code a de particulier
Tout ce que j’affirme ici, et chaque compétence que je revendique avec ce projet, a sa preuve dans Compétences et preuves : le code concerné et le test qui le vérifie, extraits du dépôt à chaque build.
- Les garanties importantes ne dépendent de la discipline de personne. C’est la base ou le code qui les impose. Les encaissements sont chaînés et on ne peut plus les modifier. Le stock ne passe pas sous zéro et son journal ne se réécrit pas. Le site ne peut créer que des commandes en attente de paiement. Le détail est dans Données et Logique métier.
- Il y a deux applications, mais chaque règle métier n’est écrite qu’une fois. Le site est parti d’un fork de l’ERP, et aujourd’hui un contrôle empêche le code de se dupliquer à nouveau. Je le raconte dans l’étude de cas Deux applications nées d’un fork.
- Fisher ne parle que de ce que l’ERP sait. Chaque chiffre qu’il donne vient d’une lecture de l’ERP, et s’il en écrit un sans source, la personne est prévenue (Fisher).
Comment lire cette doc
J’explique ici comment le code est construit et pourquoi. Pour le détail, la référence, c’est le code : chaque page cite les fichiers et les symboles concernés (fichier.ts#SYMBOLE). Certains passages sont repris tels quels d’autres textes du dépôt (le README, la carte du site), et c’est là-bas qu’ils se mettent à jour.
Les parcours de lecture proposent un ordre selon ce que vous cherchez. La carte ci-dessous reprend les groupes du menu, avec la question à laquelle chacun répond.
Le projet
De quoi s’agit-il, et qui l’a fait ?
- Parcours de lectureUn ordre de lecture selon ce que vous cherchez, avec le temps que prend chaque étape, puis la carte de toutes les rubriques.
- Étude de cas : Meubles MorinièreUn 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.
- Compétences et preuvesLes compétences que je revendique en full-stack, architecture, sécurité, UX et qualité. Chacune a sa preuve, lue dans le dépôt au build : du code, un test, un schéma ou une décision.
- Ma contribution et l’IAL’IA comme levier, l’ingénierie comme exigence. Comment je conçois et construis avec Claude Code, ce que je cadre, tranche et vérifie, et les traces qui le montrent.
Le produit
Que fait le logiciel ?
- ERPL’outil de l’équipe, ce qu’il couvre, comment un module est rangé, et ce qui tourne même quand personne ne l’ouvre.
- Fisher, l’assistant IAL’assistant de l’ERP, ce qu’il fait, et les garanties que le code lui impose.
- Site publicComment le site est construit, du catalogue au paiement, les règles qu’il suit et la carte de son code.
- Logique métierOù sont les règles du magasin, comment on compte l’argent, et pourquoi chaque règle n’est écrite qu’une fois.
Le code
Comment est-il construit ?
- ArchitectureLe monorepo, ses applications Next.js et ses paquets : ce qui appartient à chacun, qui dépend de qui, qui parle à qui en prod, et où tout est hébergé.
- SécuritéCe que le logiciel protège, contre quoi, et où chaque garantie se vérifie, pour les comptes, la base, les prestataires et les échanges entre les applications.
- Qualité et livraisonLe trajet d’un changement de mon poste jusqu’à la prod, le contrôle qui le vérifie à chaque étape, le risque que chacun couvre, et ce qui n’est pas couvert.
Les choix d’ingénierie
Pourquoi est-il construit ainsi ?
- Études de cas techniquesOnze problèmes d’ingénierie rencontrés sur le projet, de la pièce unique vendue sur deux canaux à l’assistant qui ne doit inventer aucun chiffre. Pour chacun, je donne la solution retenue, ce qu’elle a donné et ses limites.
- Décisions d’architectureLes décisions qui donnent sa forme au logiciel, au format ADR. Je sépare ce que les sources confirment de ce qui reste une hypothèse.
- Dette, risques et évolutionsCe qu’on n’a pas construit et pourquoi, la dette qu’on garde en connaissance de cause, les risques qui restent malgré les gardes, et le signal qui ferait changer d’avis.