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.
| Couche | Rôle | N’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érateur | Prisma, 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 BusinessError | lecture 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 composants | accès à la base |
schemas/ | La forme des entrées | rè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.
- La journée de l’équipeComment l’ERP dit à une petite équipe quoi faire en premier. Le tableau de bord, une liste triée selon ce qu’on perd à attendre, les signaux d’une commande, puis la préparation et le planning des livraisons.
- Interface de l’ERPDes pages qui ne font pas attendre tout l’écran, des toasts qui ne le cachent pas, et des animations dosées selon leur rôle.