Aller au contenu
Meubles Morinière

Le produit3 min de lecture

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.

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

  1. 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.
  2. 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 une BusinessError, 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 dans packages/orders. Il s’appuie sur des ports que chaque application fournit (client Prisma, envoi d’e-mail, horloge).
  3. 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).

Règles communes

Sur cette page