Aller au contenu
Meubles Morinière

Les choix d’ingénierieÉtudes de cas techniques6 min de lecture

Une date promise qu’on peut tenir

Une pièce fabriquée à la commande met plusieurs semaines à arriver. Sa date s’affiche du site au devis, et ensuite elle bouge avec les fournisseurs. Je raconte comment la promesse reste la même partout, se fige au paiement et dit d’avance quel maillon la menace.

Le problème

Une table fabriquée à la commande met plusieurs semaines à arriver : six à huit pour le délai de référence de l’atelier (REFERENCE_LEAD_TIME_WEEKS). Sa date de livraison s’affiche à beaucoup d’endroits : sur la fiche du site (« livrée d’ici le… »), sur l’accueil, dans la date limite pour Noël, dans le flux Google Merchant Center, dans le PDF d’un devis, sur la page de commande, dans la confirmation de commande et dans l’échéance que l’atelier se fixe.

Le 7 novembre 2026, un audit de cohérence entre l’ERP, la base et le site a montré que ces dates n’étaient pas d’accord (93c1b6eaad). L’accueil et la date limite de Noël oubliaient l’acheminement, alors que la fiche et la commande l’ajoutaient. Le délai d’un devis était recalculé à partir de la fiche, alors qu’il aurait dû rester celui du PDF que le client avait lu. Quand on changeait de déclinaison pour une pièce sur commande, la date restait celle d’une pièce en stock. En fait, chaque écran comptait à sa façon.

Et une fois la date donnée, elle bouge. Un fournisseur livre en retard, ou une fermeture du magasin tombe au milieu.

Les contraintes

  • La date annoncée engage le magasin. En vente à distance, il livre à la date ou dans le délai indiqué (Code de la consommation, article L216-1).
  • Le temps de l’atelier, ce n’est pas celui du calendrier. Un délai se compte en semaines d’atelier, sous forme de fourchette. Il se compte en jours ouvrés, sans les jours fériés ni les fermetures du magasin, et à l’heure de Paris alors que les serveurs tournent en UTC.
  • Les fournisseurs ne respectent pas toujours leur délai, et chacun ne représente que quelques achats par an. Une statistique sur trois réceptions, c’est fragile.
  • Ce qui a été promis doit rester lisible une fois que la date a bougé, parce que c’est ça qui dit s’il faut prévenir le client.

Les alternatives

  • Annoncer le bas ou le milieu de la fourchette. C’est plus attrayant, mais c’est faux une fois sur deux. Cette option a été écartée : « Toujours la borne HAUTE : une date annoncée est une date tenue » (offerDeliveryDates, d’après l’analyse de la décision d’achat du 3 novembre 2026).
  • Donner seulement un nombre de semaines, et la date après le paiement. C’était comme ça avant. La même analyse a placé la date avant le paiement, là où elle aide à décider.
  • Garder une seule date sur la commande, et la mettre à jour quand un fournisseur prend du retard. On perd alors ce qui avait été promis, donc on ne sait plus qu’il faut prévenir le client.
  • Laisser chaque écran calculer sa date. C’est ce qui avait donné les écarts de l’audit.

La décision

Il y a une seule règle de calcul, écrite dans packages/domain. Le site, le flux et l’ERP l’appellent tous les trois (Délais et dates promises). On annonce toujours la borne haute. La commande a deux dates : la promesse, qui se fige au paiement, et l’échéance de l’atelier, qui bouge. Ce que font vraiment les fournisseurs peut allonger une promesse, mais ne la raccourcit jamais. Et une vue dit quel maillon menace la date, avant qu’elle soit passée.

L’implémentation

Une seule règle, et on annonce la borne haute

Un délai, c’est une fourchette en semaines (LeadTimeWeeks). On le cherche sur le meuble, puis sur sa marque, puis on prend le délai de référence de l’atelier (productLeadTimeWeeks). L’échéance part du jour du paiement. On y ajoute la borne haute convertie en jours ouvrés de l’atelier, sans les fériés ni les fermetures, à l’heure du magasin (workshopDueDate, packages/domain/src/workshop-due-date.ts ; STORE_TIME_ZONE). La livraison ajoute l’acheminement maximal du mode choisi, et un retrait n’en a pas (deliveryDueDate, orderDeliveryDueAt). Le flux Merchant Center appelle workshopDueDate lui-même. La fiche, l’accueil et Noël comptent avec la même primitive et la même constante (addWorkshopBusinessDays, apps/site/modules/products/lib/offer-delivery-dates.ts). Quand un mode de livraison ne dit pas son acheminement, la fiche promet seulement le départ de l’atelier, et Noël ne promet pas cette pièce.

workshopDueDatepackages/domain/src/workshop-due-date.ts · lignes 21–34
export function workshopDueDate(
	paidAt: Date,
	closures: readonly ClosurePeriodLike[],
	leadTimeWeeks: LeadTimeWeeks = REFERENCE_LEAD_TIME_WEEKS,
	timeZone: string = STORE_TIME_ZONE,
): Date {
	const paidDay = toIsoDateIn(paidAt, timeZone);
	const day = addWorkshopBusinessDays(
		paidDay,
		workshopShippingBusinessDays(leadTimeWeeks),
		closures,
	) as CivilDay;
	return new Date(zonedMidnight(day, timeZone).getTime() + localTimeOfDayMs(paidAt, timeZone));
}

La promesse se fige au paiement

Au paiement, l’ERP écrit la même valeur dans workshopDueAt et promisedWorkshopDueAt (webhook-session.service.ts). Le site ne peut écrire ni l’une ni l’autre : la garde de la base refuse une commande du site qui les aurait. Ensuite, seule l’échéance bouge. Si elle est repoussée après la promesse, l’ERP le signale (isWorkshopDuePostponed) et propose l’avis de report au client. Comme ça, c’est le magasin qui le lui apprend, et pas son calendrier.

La date promise au client et l’échéance de l’atelierAu paiement, la même date s’écrit dans deux colonnes. paiement (paidAt), borne haute du délai, en jours ouvrés de l’atelier (référence : 6 à 8 semaines, soit 8 × 5 = 40 jours ouvrés, hors fériés et fermetures), départ de l’atelier (workshopDueAt = promisedWorkshopDueAt), acheminement maximal du mode (un retrait n’en a pas), livraison (orderDeliveryDueAt). Ensuite, seule l’échéance se déplace. L’équipe la repousse quand un fournisseur est en retard (rescheduleWorkshopDue), et le passage d’une pièce en stock à une pièce fabriquée aussi. date promise (promisedWorkshopDueAt), échéance repoussée (workshopDueAt), la livraison suit. isWorkshopDuePostponed : l’ERP le signale et propose l’avis de report au client.Au paiement, la même date s’écrit dans deux colonnespaiementpaidAtdépart de l’atelierworkshopDueAt= promisedWorkshopDueAtlivraisonorderDeliveryDueAtborne haute du délai, en jours ouvrés del’atelierréférence : 6 à 8 semaines, soit 8 × 5 = 40jours ouvrés, hors fériés et fermeturesacheminement maximal du modeun retrait n’en a pasEnsuite, seule l’échéance se déplaceL’équipe la repousse quand un fournisseur est en retard (rescheduleWorkshopDue), et le passaged’une pièce en stock à une pièce fabriquée aussi.paiementpaidAtdate promisepromisedWorkshopDueAtéchéance repousséeworkshopDueAtisWorkshopDuePostponed : l’ERP le signale etpropose l’avis de report au clientla livraison suit
Schéma sans échelle. Le délai de référence et les jours ouvrés par semaine sont lus dans packages/domain à chaque build de cette documentation. Les fonctions et les colonnes nommées y sont vérifiées.
isWorkshopDuePostponedpackages/domain/src/workshop-due-date.ts · lignes 159–166
export function isWorkshopDuePostponed(order: PromisedDue): boolean {
	const promised = promisedWorkshopDueOf(order);
	return (
		promised !== null &&
		order.workshopDueAt !== null &&
		order.workshopDueAt.getTime() > promised.getTime()
	);
}

Le devis garde le délai de son PDF

Le délai qu’un devis promet est figé à l’envoi (Quote.leadTimeWeeksMin, leadTimeWeeksMax, verrouillés par Quote_guard, migration 20261107120000_delai_promis_du_devis). La page du devis sur le site, le paiement en ligne et l’acceptation au magasin le relisent sans le recalculer : « la date due de sa commande est celle du document qu’il a signé ».

Le délai constaté du fournisseur

Le délai constaté d’un fournisseur se calcule sur ses dix dernières réceptions des vingt-quatre derniers mois, et il en faut au moins trois (apps/erp/shared/lib/supplier-lead-time.ts). Il va de la médiane au délai que huit achats sur dix ont respecté, et une semaine entamée compte pour une semaine. Le délai promis par un devis prend, borne par borne, le plus long entre le délai déclaré et le délai constaté (promisedLeadTimeWeeks). Il s’allonge pour un fournisseur plus lent, mais il ne raccourcit jamais pour un plus rapide : « l’écart d’un fournisseur plus rapide reste au magasin ».

La chaîne de la promesse

Pour une commande payée qui attend une pièce d’un fournisseur, chaque maillon, de l’achat à la livraison, reçoit un verdict : en retard, menacé, inconnu, à l’heure, fait (apps/erp/modules/orders/lib/promise-chain.ts). Le pire devient le maillon faible. La date qu’on peut attendre d’un achat en route dit toujours sur quoi elle repose. En premier, c’est la date enregistrée sur l’achat (en général celle de l’accusé de réception), décalée du retard moyen quand le fournisseur est en retard plus d’une fois sur deux. S’il n’y en a pas, c’est la date de commande plus le délai que huit achats sur dix ont respecté. Sinon, il n’y a rien. « Aucun modèle n’y décide rien, et rien n’est écrit : c’est une vue, recalculée à chaque rendu. »

Les résultats

  • La date est la même partout. La fiche, l’accueil, Noël, le flux et la commande comptent avec les mêmes primitives, et chaque écart relevé le 7 novembre a été corrigé à sa source.
  • La promesse ne se perd plus. La commande garde ce qui a été promis au paiement, l’atelier garde son échéance, et c’est l’écart entre les deux qui déclenche l’avis au client.
  • On voit la menace avant la date. La chaîne de la promesse dit quel achat, chez quel fournisseur, met en danger quelle commande, et sur quoi repose cette prévision.

Les limites

  • La fiche du site annonce le délai déclaré. Il n’y a que le devis qui l’allonge selon le délai constaté du fournisseur. Sur le site, un fournisseur lent ne se voit qu’une fois la commande payée, dans la chaîne de la promesse.
  • La même règle est écrite deux fois. Le site compte en jours civils, la commande en instants. Les deux s’appuient sur la même primitive et la même constante, mais ce n’est pas la même fonction.
  • Trois réceptions, c’est peu. En dessous de ce seuil, le délai constaté n’existe pas et on applique seulement le délai déclaré. Au-dessus, le délai constaté suit les dix derniers achats. Du coup, il ne voit un fournisseur ralentir qu’après quelques réceptions en retard.
  • Avec la borne haute, le magasin paraît souvent plus lent qu’il ne l’est. C’est ce que ça coûte d’annoncer une date qu’on respecte.

Sur cette page