Aller au contenu
Meubles Morinière

Le produit4 min de lecture

ERP

L’outil de l’équipe, ce qu’il couvre, comment un module est rangé, et ce qui tourne même quand personne ne l’ouvre.

L’ERP (apps/erp), c’est l’outil de l’équipe du magasin et de l’atelier. Il faut faire partie du personnel et être connecté pour y entrer, et il n’est pas indexé.

Ce qu’il couvre

Le menu de gauche range l’ERP par métier (apps/erp/shared/constants/admin-sections.ts#ADMIN_SIDEBAR_GROUPS) : le tableau de bord et la liste « À faire », puis Vendre, Achats et stock, Catalogue et Gestion. Les réglages et les coulisses (la santé du système, la mesure de Fisher) ont leur propre menu. La Présentation décrit ce que chaque rubrique fait pour l’équipe. La journée de l’équipe explique comment l’ERP lui dit quoi faire en premier. Les règles de chaque métier, du devis au service après-vente, sont dans Logique métier. Et l’assistant de l’ERP a sa page, Fisher.

Comment un module est rangé

Chaque métier est un module (modules/<domaine>/), découpé en couches. app/ compose les pages et les routes à partir de ces couches. Le module des marques (modules/brands) sert de modèle.

CoucheRôleN’y entre pas
actions/L’entrée d’un geste : session, lecture et validation du formulaire, un appel au service, invalidations, puis le texte que voit l’opérateurPrisma, règle métier
services/Les règles qui demandent la base, les écritures, transactions et verrous, les effets externes (Stripe, e-mail, Blob). Un refus se dit par une BusinessErrorlecture de formulaire, refresh()
data/Les lectures, gardées en tête par requireAdminReader()écriture
lib/Les règles et calculs purs, partagés par les services et les composantsaccès à la base
schemas/La forme des entréesrègle qui demande la base
components/L’affichage, qui lit par data/ et écrit par actions/Prisma

ESLint fait respecter ces frontières. Prisma est interdit dans actions/, components/, lib/ et app/, et un module n’importe pas un autre module. On n’ajoute pas de couche qui ne ferait que passer l’appel à la suivante, donc une page appelle directement la lecture de data/. Quand un service dépasse 500 lignes, on le découpe en fichiers voisins sans changer son API. Comme ça, les tests qui le simulent couvrent toujours tous ses appelants.

Ce qui tourne sans l’ERP

  • Chaque matin, une tâche planifiée appelle /api/veille (modules/monitoring/services/monitoring.service.ts). La veille lit les anomalies rubrique par rubrique, en parallèle. Si une rubrique est illisible, elle est signalée « aveugle » et les autres passent quand même. Ensuite, s’il y a quelque chose à signaler, la veille envoie l’e-mail du matin et une notification sur le téléphone du personnel. Un jour calme, rien ne part, sauf un rapport par e-mail le lundi. Dans tous les cas, elle applique la durée de conservation des données (Données personnelles), relance les accusés de rétractation restés en attente, rattrape chez Stripe les événements qu’il n’a pas pu livrer (Stripe), confirme les livraisons de colis par le suivi de La Poste, et signale son passage à une sonde externe. Du coup, si la veille ne passe pas, quelqu’un est prévenu. Dans l’e-mail du matin, chaque anomalie arrive avec le geste qui la règle, écrit pour l’équipe, et le passage du manuel qui l’explique (modules/monitoring/constants/morning-guides.ts#MORNING_GUIDES). L’étude de cas Une veille qui dit ce qu’elle n’a pas pu lire raconte d’où viennent ces choix et ce que la veille ne voit pas.
  • Le webhook Stripe n’arrive qu’à l’ERP. Il enregistre chaque événement une seule fois, même si Stripe le livre plusieurs fois (Stripe).
  • Une commande, un litige ou une anomalie arrivent sur le téléphone du personnel par Web Push (owner-order-push.service.ts, owner-dispute-push.service.ts, watch-anomaly-push.service.ts).

Le manuel

Le manuel est dans l’ERP (apps/erp/app/(console)/manuel), derrière la connexion. Il décrit pour l’équipe chaque écran et chaque geste, avec des captures, et Fisher s’en sert pour répondre sur la marche à suivre. Cette doc ne le recopie pas. Ici je décris le code, et le manuel décrit l’usage.

Sur cette page