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
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
| Workflow | Commence quand | Écrit | Attend de |
|---|---|---|---|
| Catalogue et déclinaisons | l’équipe crée, publie ou retouche un meuble | Product, ProductVariant, VariantPriceChange | marques, fournisseurs, grille de port |
| Devis | un client demande une pièce sur mesure, ou un lien de paiement | Quote, QuoteLine | catalogue, port, délais |
| Commandes | un panier est payé, une vente se fait au magasin, un devis est accepté | Order, OrderItem, OrderStep, OrderParcel | catalogue ou devis, stock |
| Acomptes et paiements | l’argent arrive, en ligne ou au magasin | Payment | commande |
| Fournisseurs et achats | une ligne client attend une pièce, ou le stock passe sous son seuil | PurchaseOrder, PurchaseOrderLine | catalogue, lignes des clients |
| Stock | il y a une vente, une réception, un comptage ou un retour | ProductVariant.stock, StockMovement | catalogue, commandes, achats |
| Facturation | une vente est payée, ou il y a un encaissement, un remboursement, une correction | Invoice, InvoiceLine, DocumentCounter | commande, encaissements, remboursements |
| Service après-vente | après la vente | Refund, RefundItem, Dispute, colonnes datées de Order | commande, 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étier | Réponse | Exemples |
|---|---|---|
| Un objet passe par quelques états, et chaque étape compte | une é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 autres | on le calcule à la lecture, donc il n’y a ni colonne à mettre à jour ni tâche planifiée | devis expiré, achat reçu en partie ou soldé, pièces réservées, reste dû (storeCollectionOf) |
| Deux personnes font le même geste | la 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 ligne | RECEIPT_STALE, PRICE_CHANGED, STOCK_CHANGED, QUOTE_PAYMENT_LOCK_PREFIX |
| Un message arrive deux fois | une 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 Stripe | WebhookEvent, stripePaymentIntentId, Invoice.paymentId, receiptKey, ensureSaleInvoice |
| Un effet hors de la base peut échouer | il part après la validation, et quand on ne sait pas comment ça s’est fini, on le dit et on ne devine pas | devis à l’envoi incertain, remboursement laissé en attente, session Stripe fermée après coup |
| Une erreur ne doit pas s’effacer | une pièce qui corrige la précédente, un mouvement inverse, une ligne qui échoue ou qui s’annule | avoir, facture rectificative, comptage inverse, remboursement retombé |
| Un oubli ne se voit pas | la veille du matin lit les anomalies rubrique par rubrique | remboursement en attente, retour non revenu, rétractation sans accusé, trou de numérotation |
| Le site et l’ERP doivent dire la même chose | la règle s’écrit une fois dans packages/domain | reste à 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
| Absent | Parce que | Ce que ça coûte |
|---|---|---|
| Un moteur de workflow | chaque objet a de trois à huit états, et ses passages s’écrivent dans une constante ou un trigger | les 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 messages | les enchaînements se font en une transaction : le paiement écrit l’encaissement, accepte le devis et décompte le stock d’un coup | si 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éservations | une réservation se déduit : session de paiement ouverte, pièces reçues pour un client | une agrégation à chaque lecture |
| Des versions du catalogue | chaque ligne recopie ce qu’elle vend, et les identifiants cités sont gelés | une ligne ne suit plus la fiche, et c’est voulu |
| Un configurateur d’options | une déclinaison est une combinaison complète, et le sur-mesure passe par le devis, en lignes libres | un meuble très configurable ne se vend pas en ligne sans devis |
| Emplacements, lots, numéros de série, inventaire | il y a un seul magasin avec son atelier, et un entier par pièce suffit | rien ne dit où se trouve une pièce |
| Une comptabilité en partie double | les écritures se calculent à l’export, à partir des pièces | pas d’écriture d’opération diverse : toute correction est une pièce |
| Les factures des fournisseurs | l’ERP n’a besoin que du coût, pour le stock et la marge | la comptabilité des achats reste chez le comptable |
| Un module de SAV, des tickets | le 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 ligne | au magasin, les versements sont libres jusqu’au reste dû, et en ligne, le client paie tout | un client qui veut verser un acompte passe au magasin |
| Des rôles | c’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 |