Skip to Content
Meubles Morinière

The productLogique métier(in French)9 min read

Comment les workflows s’enchaînent

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.

Not translated yet

This page is shown in its original French. Code excerpts, tests and figures read the same in either language.

Un meuble passe par huit workflows, de sa fiche jusqu’au service après-vente. Chacun a sa page, avec ses étapes, ses règles et ses cas limites. Ici, je regarde comment ils s’enchaînent et ce que chacun attend des autres. Et j’explique pourquoi quelques mécanismes, toujours les mêmes, suffisent pour tous.

La chaîne

WorkflowCommence quandÉcritAttend de
Catalogue et déclinaisonsl’équipe crée, publie ou retouche un meubleProduct, ProductVariant, VariantPriceChangemarques, fournisseurs, grille de port
Devisun client demande une pièce sur mesure, ou un lien de paiementQuote, QuoteLinecatalogue, port, délais
Commandesun panier est payé, une vente se fait au magasin, un devis est acceptéOrder, OrderItem, OrderStep, OrderParcelcatalogue ou devis, stock
Acomptes et paiementsl’argent arrive, en ligne ou au magasinPaymentcommande
Fournisseurs et achatsune ligne client attend une pièce, ou le stock passe sous son seuilPurchaseOrder, PurchaseOrderLinecatalogue, lignes des clients
Stockil y a une vente, une réception, un comptage ou un retourProductVariant.stock, StockMovementcatalogue, commandes, achats
Facturationune vente est payée, ou il y a un encaissement, un remboursement, une correctionInvoice, InvoiceLine, DocumentCountercommande, encaissements, remboursements
Service après-venteaprès la venteRefund, RefundItem, Dispute, colonnes datées de Ordercommande, encaissements, facturation, stock

Deux pages décrivent les règles communes à tous ces workflows : Prix, remises, TVA et port et Délais et dates promises. Le client, ce n’est pas un workflow de plus. Sa fiche regroupe ses commandes et ses devis, et elle se crée toute seule à la vente (Clients). Tout ce que ces workflows laissent à faire chaque jour remonte dans une seule liste, rangée par urgence (La journée de l’équipe).

Ce que chacun attend des autres

  • Un devis, une commande, un achat et une facture recopient ce qu’ils citent du catalogue : libellé, référence, prix, coût, politique de stock. Comme ça, ce qui a été vendu ne bouge plus. La base gèle aussi les identifiants qu’ils citent, comme la référence d’une pièce ou l’adresse d’un meuble publié. Du coup, le catalogue peut changer librement et le passé n’est pas réécrit (Catalogue).
  • C’est l’argent qui commande la préparation. Rien ne part tant que ce n’est pas payé en entier. Rien ne se prépare tant qu’on n’a pas reçu d’argent. Et seule une vente du magasin entre en fabrication sur acompte. Le SAV s’y ajoute, parce qu’une rétractation ouverte ou un litige bancaire arrêtent la commande dans la même condition (Commandes).
  • En ligne, la vente passe d’abord et le stock suit. Quand le paiement est confirmé, il décompte la pièce s’il en reste. Sinon, la ligne passe en rupture. Le paiement est déjà encaissé, donc on ne le fait pas échouer. C’est l’équipe qui décide ensuite d’acheter, de fabriquer ou de servir depuis le stock revenu (Stock).
  • Un achat sert le client avant le stock. Quand une ligne d’achat est liée à la ligne d’un client, ce qui arrive lui est réservé. Et si la date de livraison du fournisseur tombe le jour de l’échéance de l’atelier ou après, les clients à prévenir sont signalés (Fournisseurs et achats).
  • Une fois la facture émise, les montants de la commande ne changent plus que par une facture rectificative. Une période de TVA déclarée ou un exercice exporté ferment eux aussi les gestes qui les changeraient (Facturation).
  • Un remboursement émet son avoir. Ses pièces reviennent au stock par un geste à part, que l’équipe confirme. S’il retombe, une facture annule son avoir et ses pièces ressortent du stock (Service après-vente).

Les mêmes mécanismes partout

Les huit workflows n’ont pas de moteur commun. Quand ils ont les mêmes contraintes, ils reprennent les mêmes réponses.

Contrainte du métierRéponseExemples
Un objet passe par quelques états, et chaque étape compteune énumération pour l’état, une colonne datée par étape, des CHECK qui lient les deux, et un trigger de transition là où l’argent ou la loi en dépendent (ailleurs, c’est une constante que le service lit)Quote_guard, PurchaseOrder_transition, Invoice_chain_guard_insert, FULFILLMENT_TRANSITIONS, PRODUCT_STATUS_TRANSITIONS
Un état qui se déduit des autreson le calcule à la lecture, donc il n’y a ni colonne à mettre à jour ni tâche planifiéedevis expiré, achat reçu en partie ou soldé, pièces réservées, reste dû (storeCollectionOf)
Deux personnes font le même gestela valeur que l’écran a lue revient dans la condition de la mise à jour, les verrous se prennent dans un ordre stable, et un verrou consultatif partagé par le site et l’ERP couvre ce qui n’a pas encore de ligneRECEIPT_STALE, PRICE_CHANGED, STOCK_CHANGED, QUOTE_PAYMENT_LOCK_PREFIX
Un message arrive deux foisune contrainte d’unicité sert de clé d’idempotence, les émissions répondent « déjà fait », et l’identifiant local sert de clé d’idempotence chez StripeWebhookEvent, stripePaymentIntentId, Invoice.paymentId, receiptKey, ensureSaleInvoice
Un effet hors de la base peut échoueril part après la validation, et quand on ne sait pas comment ça s’est fini, on le dit et on ne devine pasdevis à l’envoi incertain, remboursement laissé en attente, session Stripe fermée après coup
Une erreur ne doit pas s’effacerune pièce qui corrige la précédente, un mouvement inverse, une ligne qui échoue ou qui s’annuleavoir, facture rectificative, comptage inverse, remboursement retombé
Un oubli ne se voit pasla veille du matin lit les anomalies rubrique par rubriqueremboursement en attente, retour non revenu, rétractation sans accusé, trou de numérotation
Le site et l’ERP doivent dire la même chosela règle s’écrit une fois dans packages/domainreste à payer, disponibilité, statuts de paiement regroupés

Le détail des verrous, des contraintes et des gardes est dans Données.

Ce qui manque, et pourquoi

AbsentParce queCe que ça coûte
Un moteur de workflowchaque objet a de trois à huit états, et ses passages s’écrivent dans une constante ou un triggerles règles d’un même objet se lisent à plusieurs endroits, et elles peuvent diverger : la base admet une vente du magasin en fabrication sans encaissement, le service la refuse
Un bus d’événements ou une file de messagesles enchaînements se font en une transaction : le paiement écrit l’encaissement, accepte le devis et décompte le stock d’un coupsi une réponse de Stripe se perd, une ligne reste en attente, et c’est une personne ou la veille qui la reprend
Une table de réservationsune réservation se déduit : session de paiement ouverte, pièces reçues pour un clientune agrégation à chaque lecture
Des versions du cataloguechaque ligne recopie ce qu’elle vend, et les identifiants cités sont gelésune ligne ne suit plus la fiche, et c’est voulu
Un configurateur d’optionsune déclinaison est une combinaison complète, et le sur-mesure passe par le devis, en lignes libresun meuble très configurable ne se vend pas en ligne sans devis
Emplacements, lots, numéros de série, inventaireil y a un seul magasin avec son atelier, et un entier par pièce suffitrien ne dit où se trouve une pièce
Une comptabilité en partie doubleles écritures se calculent à l’export, à partir des piècespas d’écriture d’opération diverse : toute correction est une pièce
Les factures des fournisseursl’ERP n’a besoin que du coût, pour le stock et la margela comptabilité des achats reste chez le comptable
Un module de SAV, des ticketsle SAV doit agir sur les gardes de la commande, qui lisent ses colonnes, et les demandes du site arrivent par e-mail (Demandes au magasin)la garantie n’est pas suivie, une commande n’a qu’une réclamation, et rien ne suit une demande restée sans réponse
Un échéancier, l’acompte en ligneau magasin, les versements sont libres jusqu’au reste dû, et en ligne, le client paie toutun client qui veut verser un acompte passe au magasin
Des rôlesc’est une petite équipe où chacun fait tout, et les gestes sensibles demandent une connexion récente (Sécurité)on ne peut limiter personne à la caisse ou au stock

On this page