The product3 min read
Logique métier
Où sont les règles du magasin, comment on compte l’argent, et pourquoi chaque règle n’est écrite qu’une fois.
Not translated yet
Le magasin vend des pièces en stock et des pièces que son atelier fabrique à la commande. Il les vend au magasin et en ligne. Il y a des délais de plusieurs semaines, des acomptes, des devis, des fournisseurs, et une comptabilité que la loi encadre. Dans le code, chaque règle de ce métier a sa place.
Ces pages suivent un meuble de sa fiche jusqu’au service après-vente : catalogue, devis, commandes, paiements, achats, stock, facturation et SAV. Pour chacun, il y a ses règles et ses cas limites. Comment les workflows s’enchaînent montre comment tout ça se suit, et ce qui manque parce que c’est voulu. Clients décrit la fiche qui regroupe les commandes et les devis d’une même personne.
Trois étages de règles
- Les règles pures sont dans
packages/domain, et les deux applications les partagent : TVA, prix et remises, port, totaux, numéros de pièce, délais et date promise, horaires et fermetures, rétractation, conservation des données. Ce paquet n’importe aucun client de base, ne touche ni au réseau ni à l’environnement. Quand une règle doit lire la base ou y prendre un verrou (la réservation d’une pièce pendant un paiement,stock-reservation.ts), l’application lui passe sa transaction. Quand un texte dépend de l’application (l’adresse du site dans la signature d’un e-mail), on le lui passe en paramètre. Il n’a pas de tests à lui. Ce sont les applications qui le testent, à travers leurs relais. Du coup, un test couvre la règle telle que l’application l’importe. - Les règles qui ont besoin de la base sont dans les
services/des modules de chaque application. C’est là qu’on trouve les écritures, les transactions, la plupart des verrous et les effets externes (Stripe, e-mail, stockage). Un refus passe par uneBusinessError, et l’action la traduit en texte pour la personne. Quand les deux applications font le même traitement, comme la rétractation, il sort danspackages/orders. Il s’appuie sur des ports que chaque application fournit (client Prisma, envoi d’e-mail, horloge). - Et certaines règles, c’est la base elle-même qui les impose : contraintes, gardes et chaînage. Elles sont décrites dans Données. Ce sont celles dont dépendent l’argent, la loi et le stock.
Ce que le site annonce, c’est ce que le code applique
Ce que le site annonce au client et ce que le code applique viennent de la même constante :
- La durée de conservation des données. La politique de confidentialité l’affiche et la veille de l’ERP l’applique (
data-retention.ts). - Le délai de rétractation et ses jours fériés. Les e-mails le citent et le calcul de l’échéance l’applique (
withdrawal.ts). - La disponibilité d’une pièce. La vitrine du site et l’ERP la lisent de la même façon (
offer.ts). - Le prix d’une remise échue. Dès minuit, le site et l’ERP reprennent le prix d’avant. Ils n’attendent pas que la veille l’écrive en base (
ended-discount.ts).
L’argent se compte en centimes
Un montant, c’est toujours un entier de centimes (…Cents). Un taux, c’est toujours un entier de points de base (…Bps, 2 000 pour 20 %). Chaque arrondi est écrit dans le code, donc on ne dépend pas des flottants. La TVA comprise dans un prix se calcule sur la valeur absolue. Comme ça, un avoir reprend exactement la TVA de la facture qu’il annule (vatPartOfTtcCents, packages/domain/src/vat.ts). Et quand on répartit un montant entre des lignes, on utilise la méthode du plus fort reste, pour que la somme des parts tombe juste au centime (allocateLargestRemainder).
- Comment les workflows s’enchaînent(in French)Comment catalogue, devis, commandes, argent, achats, stock, facture et SAV s’enchaînent, ce que chacun attend des autres, et les quelques mécanismes qui suffisent pour tous. Il n’y a ni moteur de workflow ni bus d’événements.
- Catalogue et déclinaisons(in French)Publier un meuble, gérer ses déclinaisons, changer un prix ou un coût, et retirer ou supprimer sans réécrire ce qui a déjà été vendu.
- Devis et liens de paiement(in French)Chiffrer, sceller et envoyer un devis, le relancer, le remplacer ou l’annuler, l’accepter en ligne ou au magasin. Et le lien de paiement, qui est un devis d’un autre genre.
- Commandes(in French)Trois façons de créer une même commande, ses deux états, la préparation de la fabrication à la livraison, l’annulation, et ce que devient un paiement en ligne qui échoue, arrive deux fois ou arrive trop tard.
- Acomptes et paiements(in French)Encaisser en ligne ou au magasin, en une ou plusieurs fois, l’acompte et le solde, la relance, pourquoi un trop-perçu ne peut pas arriver, et un registre d’encaissements où on ne fait qu’ajouter.
- Fournisseurs et achats(in French)La fiche d’un fournisseur et son lexique, la commande fournisseur du brouillon à la réception, l’achat lié à la ligne d’un client, les corrections, les retours et le réassort.
- Stock(in French)Deux sortes de pièces, un solde qui ne passe pas sous zéro et un journal qu’on ne réécrit pas, les pièces retenues pendant un paiement, et chaque geste qui fait bouger le stock.
- Facturation(in French)Les pièces et leurs liens, des numéros sans trou, quand une facture est émise selon le canal, l’acompte et le solde, les factures rectificatives, les avoirs, des pièces qu’on ne retouche plus, puis la déclaration et l’export.
- Service après-vente(in French)Rembourser par Stripe ou au magasin, par pièces ou en montant, la rétractation, les retours, les réserves à la livraison et la réclamation au transporteur, les litiges bancaires, et ce que le logiciel ne suit pas.
- Clients(in French)Un client existe dès qu’il commande ou reçoit un devis, sa fiche se crée toute seule à la vente, deux fiches se fusionnent, et la fiche rassemble ses affaires, ce qui attend un geste et ses données personnelles.