Skip to Content
Meubles Morinière

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

Stock

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.

Not translated yet

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

Une pièce unique est en vente au magasin et sur le site en même temps, et elle ne doit partir qu’une fois. Il faut aussi pouvoir dire, pour une date passée, combien il y en avait, pourquoi le nombre a bougé et ce que valait le stock.

Les chemins sans préfixe partent de apps/erp/.

Le stock bouge avec la vente (site, magasin, devis accepté), l’annulation, le remboursement, le retour d’un client, les achats et les gestes de l’équipe. Ce qui le lit, c’est la disponibilité affichée sur le site (offerAvailability, packages/domain/src/offer.ts), le panier, la vente au magasin et le réassort (Fournisseurs et achats).

Deux sortes de pièces

Une déclinaison est soit suivie en stock (TRACKED), soit fabriquée à la commande (MADE_TO_ORDER). La première a un solde qui monte et qui descend. La seconde n’a pas de solde, et c’est la base qui l’impose (ProductVariant_made_to_order_stock_check). Elle est toujours achetable, avec un délai d’atelier (Délais et dates promises). On peut passer de l’une à l’autre, sous conditions (Catalogue).

Ce que dit le solde

Le solde (ProductVariant.stock) compte les pièces libres. Une pièce sort du solde dès que sa vente est acquise. Pour une commande du site, c’est au paiement confirmé. Pour une vente au magasin, c’est dès l’enregistrement, même sur acompte. À partir de là, elle ne compte plus dans le solde, même si elle attend encore en magasin que l’atelier la prépare. Pendant un paiement en ligne, la pièce reste dans le solde, et c’est la commande en attente qui la retient (Tenir une pièce pendant un paiement).

  • Du coup, les pièces vendues encore en magasin ne sont plus dans le solde. On les recalcule quand il faut les voir : les ventes payées pas encore préparées, plus les pièces reçues pour un client (modules/variants/services/shelf-sales.ts#soldPiecesOnShelf). C’est grâce à ça qu’on peut compter le rayon (plus bas).
  • Une commande du site encore impayée retient ses pièces tant que sa session de paiement est ouverte (pendingReservationWhere, packages/domain/src/stock-reservation.ts). Pendant ce temps, la pièce n’est pas libre pour un autre panier. Un changement de déclinaison dans l’ERP la respecte aussi, et il dit que la pièce est en cours de paiement. Par contre, la vente au magasin et l’accord d’un devis au magasin passent devant : ils prennent la pièce sur le stock brut, puis ferment la session Stripe qui la retenait (shared/server/sold-reservations.ts#releaseSoldReservations). Si le client en ligne avait déjà payé, l’équipe reçoit une alerte de survente. Le solde affiché reste le stock brut. Comme ça, la fiche ne fait pas croire à une rupture le temps d’un paiement.
  • Les pièces reçues pour un client restent hors du solde. On les déduit de l’achat lié (Fournisseurs et achats).

Ces réservations ne sont pas stockées. On les déduit à la lecture, donc il n’y a rien à faire expirer ni à nettoyer (Données).

Le journal

Chaque fois que le solde bouge, un mouvement dit pourquoi (StockMovementReason). Le solde et son mouvement s’écrivent ensemble, dans la même transaction, et seulement par shared/server/stock-ledger.ts (changeStock, changeOrderStock) : un module dit de combien, sous quelle garde et pour quelle cause, et le journal pose les deux. Un test refuse toute autre écriture du solde, hors création d’une variante avec son solde de départ (test/stock-ledger.regression.test.ts).

MouvementSensGeste
Vente (SALE)sortiepaiement d’une commande, vente au magasin, rupture servie depuis le stock
Annulation (CANCELLATION)entréecommande annulée ou pièce remboursée avant le départ
Retour (RETURN)entréepièce rapportée par le client après l’expédition
Réception (RECEIPT)entrée, sortie si elle corrige une ligne d’achatréception d’un achat, ajout hors commande
Comptage (COUNT)l’un ou l’autrecomptage, correction de coût, geste défait
Perte (LOSS)sortiecasse, vol, pièce retirée de la vente
Retour fournisseur (SUPPLIER_RETURN)sortiepièce renvoyée sans remplacement
Stock initial (INITIAL)entréepremier stock d’une pièce suivie, à sa création ou à son passage en suivi, une fois
  • La base vérifie le sens de chaque raison (StockMovement_delta_sign_check). Elle exige un motif écrit pour un comptage, une perte ou un retour fournisseur (StockMovement_note_check). Et elle ne rattache un mouvement à une commande que s’il en vient.
  • Elle refuse aussi un solde sous zéro (ProductVariant_stock_check).
  • Un mouvement ne se modifie pas et ne s’efface pas (StockMovement_guard). La garde n’admet que deux exceptions. Quand on supprime une pièce, ses mouvements de stock initial et de comptage partent avec elle. Et quand un compte est supprimé, l’auteur de ses mouvements s’efface. Une correction de prix ou de coût s’écrit en paire, une sortie puis une entrée. Comme ça, la valeur du stock à une date passée se rejoue à l’identique.
  • Côté coût, une réception d’achat entre au coût moyen pondéré et reste rattachée à sa ligne d’achat. Un ajout hors commande entre au coût courant de la pièce, et c’est un trigger qui le pose (StockMovement_cost_insert).

Les gestes

La vente et la rupture

  • Sur le site, le stock se décompte à la confirmation du paiement, et seulement s’il y en a assez (modules/payments/services/paid-stock.ts#decrementPaidStock). Sinon, la ligne passe en rupture (backorderedAt) et l’équipe est prévenue. Le paiement n’échoue pas, parce que Stripe a déjà encaissé l’argent. Et la pièce peut se racheter ou se fabriquer.
  • Au magasin, la vente verrouille les pièces triées par identifiant, puis elle refuse si le stock manque (shared/server/store-order.ts#takeFromStock). La personne est là, donc on lui dit non tout de suite.
  • Une rupture peut se finir de trois façons. On peut commander la pièce au fournisseur, et sa réception marque la rupture traitée. On peut la confier à l’atelier (modules/orders/services/order-edits.service.ts#acknowledgeBackorder). Ou on peut la servir depuis le stock revenu. Dans ce cas, modules/orders/services/backorder-stock.service.ts#serveBackorderFromStock verrouille la commande, ses achats et la pièce. Il vérifie que le stock libre couvre la quantité due, il écrit la vente, il efface la rupture et il défait le lien d’achat. La base n’admet une rupture que sur une pièce suivie (OrderItem_backorderedAt_check), et une rupture traitée que si elle existe (OrderItem_backorder_acknowledged_check).
  • Tant qu’une pièce manque, la commande ne part pas (modules/orders/services/fulfillment-guards.ts#assertNoMissingPiece). L’avis au client part une fois que toutes les pièces sont décidées, sans les pièces remboursées (backorderNoticeSentAt).

Compter

modules/variants/services/variant-stock.service.ts#adjustStock verrouille la pièce. Il compare le solde et les pièces vendues en magasin à ceux que l’écran a lus (STOCK_CHANGED, SOLD_ON_SHELF_CHANGED).

  • On compte ce qu’on voit sur le rayon, y compris les pièces vendues pas encore enlevées. Le nouveau solde, c’est le nombre compté moins les pièces vendues encore en magasin. S’il y en a et que le compte ne tombe pas juste, il faut donner un motif (SOLD_PIECES_NOT_COUNTED).
  • Le mouvement vaut la cible moins la somme du journal, et pas la cible moins le solde. Si les deux avaient divergé, le comptage réaligne le journal et il le dit dans sa note (LEDGER_REALIGNMENT_NOTE).
  • En lot, le comptage passe en entier ou pas du tout, et il nomme la pièce refusée. Une pièce fabriquée à la commande ne se compte pas à plus de zéro.

Perdre, ajouter, défaire

  • Une perte (stock-loss.service.ts#declareStockLoss) ne peut pas dépasser le stock, et il faut donner son motif.
  • Un ajout hors commande (variant-stock.service.ts#receiveStockBatch) porte une clé de réception unique par pièce (receiptKey). Du coup, un envoi rejoué n’ajoute pas deux fois.
  • On peut défaire un geste (stock-movement.service.ts#undoStockMovements) pendant deux minutes (STOCK_UNDO_WINDOW_MS). Ça vaut pour un ajout hors commande, un comptage ou une perte, s’il n’y a pas eu de mouvement plus récent depuis. Le journal ne se réécrit pas, donc défaire, c’est écrire le comptage inverse.

Changer de déclinaison sur une commande

Quand un client change d’avis sur la finition avant que la commande parte, même si elle est prête, et qu’elle est payée en entier, modules/orders/services/order-item-variant.service.ts#changeOrderItemVariant admet une autre déclinaison du même meuble. Il faut qu’elle soit active, vendue aux mêmes conditions de prix (PRICE_GAP) et pas déjà dans la commande. Les documents de la commande doivent être archivés. Et il faut assez de stock, sans compter les pièces en cours de paiement chez un autre client (IN_PAYMENT).

L’ancienne pièce revient en stock si elle était suivie, et la nouvelle en sort (modules/orders/services/order-item-variant.service.ts#changeOrderItemVariant, shared/server/stock-ledger.ts#changeOrderStock). Les pièces réservées par un achat sont libérées et le lien d’achat se défait. La ligne reprend les copies de la nouvelle déclinaison. Et si la pièce passe en fabrication à la commande, l’échéance de l’atelier recule.

Les retours d’un client

Les gestes sont décrits dans Service après-vente. Une pièce remboursée avant le départ revient en stock par une annulation. Une pièce rapportée après l’expédition revient par un retour. Ça ne concerne que les pièces suivies, et on ne dépasse pas ce qui reste à rentrer (modules/orders/services/fulfillment-restock.service.ts).

Les limites

  • Chaque pièce n’a qu’un entier. Il n’y a pas d’emplacement, pas de lot, pas de numéro de série. Il n’y a pas non plus d’inventaire à ouvrir et à clore. Un inventaire, ce sont des comptages, puis un export.
  • Il n’y a pas de trigger qui recalcule le solde à partir du journal. Le journal écrit les deux ensemble, la vérification de la base compare chaque solde à la somme de son journal, et un comptage réaligne.
  • Les pièces vendues en magasin et les réservations se recalculent à chaque lecture. Ça coûte une agrégation par écran.

On this page