Le produitLogique métier8 min de lecture
Catalogue et déclinaisons
Publier un meuble, gérer ses déclinaisons, changer un prix ou un coût, et retirer ou supprimer sans réécrire ce qui a déjà été vendu.
L’ERP écrit le catalogue et le site le lit tel quel. Il n’y a ni copie ni synchronisation (Échanges). Un meuble (Product) se vend en déclinaisons (ProductVariant). Chaque déclinaison est une combinaison complète, avec sa référence, son prix, son coût, sa politique de stock et ses cotes. Quand on retouche le catalogue, le site change tout de suite. Par contre, ce qui a déjà été vendu, chiffré ou acheté ne doit pas bouger.
Les chemins sans préfixe partent de apps/erp/.
Le catalogue dépend des marques, pour le fabricant à nommer. Il dépend des fournisseurs, parce que leur pays décide d’une obligation (plus bas). Et il dépend de la grille de port, qui a besoin du poids quand le port se calcule au poids. De l’autre côté, voici ce qui lit le catalogue :
- Les devis, qui en tirent leurs lignes.
- Le panier du site et la vente au magasin.
- Les commandes fournisseurs et le réassort.
- Le flux Google Merchant Center.
Publier un meuble
Un meuble commence en brouillon (ProductStatus.DRAFT). Ensuite on le publie, puis on l’archive. Les transitions permises sont écrites une fois (modules/products/constants/product-status.ts#PRODUCT_STATUS_TRANSITIONS) :
| Vers | Depuis |
|---|---|
| Publié | brouillon, archivé |
| Archivé | brouillon, publié |
| Brouillon | archivé, seulement s’il n’a jamais été publié |
Un meuble qui a été en ligne ne redevient jamais brouillon. On l’archive, et son adresse continue de répondre, avec une page « plus disponible ».
Pour publier, il faut une description, une catégorie, une déclinaison active à prix positif et une photo. Il faut aussi le poids de chaque déclinaison si le port se calcule au poids, et le fabricant déclaré sur la marque. Et quand le fournisseur est hors de l’Union, il faut la personne responsable dans l’Union. C’est le règlement sur la sécurité des produits (GPSR) qui l’exige. La liste se calcule dans une fonction pure (modules/products/lib/product-completeness.ts#publishMissing), et la même condition est réécrite dans la mise à jour qui publie. Du coup, si une photo disparaît pendant la publication, le meuble est refusé. Il n’est pas publié incomplet.
En lot, product-status.service.ts#setProductStatus traite chaque meuble dans sa propre transaction. Il rend la liste des meubles publiés et celle des refusés. Un meuble incomplet n’empêche pas les autres de partir.
Côté base, un trigger pose la date de première publication (Product_first_published_fill), et elle ne change plus. Il ne la pose qu’à la publication. Un brouillon archivé reste donc « jamais publié » : il peut revenir au brouillon, son adresse n’est pas gelée, et le site ne lui donne pas de page « plus disponible ». L’adresse du meuble est gelée à ce moment-là (Product_slug_guard).
L’historique des prix démarre à la mise en ligne. À la première publication, #restartPriceHistory efface les prix du brouillon et réinscrit le prix courant. Donc un prix qu’aucun client n’a vu n’entre pas dans le prix de référence d’une remise (Prix barré). Dernière chose : quand on publie, retouche ou archive un meuble, le cache des pages concernées du site est périmé.
Retirer et supprimer un meuble
Il y a trois gestes, selon ce que le meuble a déjà vécu.
- Archiver : le meuble quitte le site et la vitrine de l’accueil. Les rangs de la vitrine se resserrent sous un verrou consultatif (
compactHomePositions). - Retirer de la vente :
product-retire.service.ts#retireProductarchive le meuble, puis vide son stock par un mouvement de perte. Ce sont deux transactions. Si le stock a bougé entre les deux (DELETE_STOCK_CHANGED), l’archivage reste acquis et il n’y a que le vidage à refaire. - Supprimer :
product-delete.service.ts#productDeletePlanrefuse dans cinq cas. Le meuble a été vendu, une commande le retient, son stock a un historique, un achat l’attend, ou un devis en cours le chiffre. Un meuble qui a eu des pièces en stock garde un historique : il se retire et ne se supprime pas (apps/erp/shared/lib/order-pin.ts#KEPT_MOVEMENT_WHERE).
Faire vivre une déclinaison
Une déclinaison n’a pas d’état énuméré. Elle a quatre champs : active ou non (active), sa politique de stock (inventoryPolicy), son solde (stock) et la date de son dernier comptage (lastCountedAt).
- À la création,
modules/variants/services/variant-admin.service.ts#createVariantverrouille le meuble pour calculer le rang de la déclinaison. Il exige le poids si le port se calcule au poids. Une pièce fabriquée à la commande est créée sans stock (ProductVariant_made_to_order_stock_check). Une pièce suivie créée avec du stock reçoit un mouvement de stock initial. Il n’y en a qu’un, et c’est un index unique partiel qui l’impose (StockMovement_variantId_initial_key). L’étiquette est unique dans le meuble. La référence est unique dans tout le catalogue, et le GTIN aussi quand il existe. - Si personne ne saisit la référence, elle sort d’une séquence de la base (
ProductVariant_next_reference: MM-0001, MM-0002…), dans un format que la base contrôle. Dès qu’une ligne de commande, de devis, d’achat ou de facture la cite, un trigger la gèle (ProductVariant_reference_guard). Le service prévient avant (variant-write-guards.ts#assertReferenceRenamable). Et une référence citée ne se réattribue pas à une autre pièce (shared/server/variant-references.ts#isReferenceRetired). Du coup, un bon de commande ou une facture désigne toujours la même pièce. - Une déclinaison inactive disparaît du site (
BUYABLE_VARIANT_WHERE,packages/domain/src/offer.ts). On ne peut pas retirer de la vente la dernière déclinaison active d’un meuble publié, parce que la page n’aurait plus rien à vendre (variant-write-guards.ts#removableVariantWhere). - Pour la suppression,
variant-write-guards.ts#deletableVariantWherepose ses conditions directement dans la requête. Il ne faut pas qu’une commande payée, confirmée ou en cours de paiement retienne la déclinaison. Elle ne doit jamais avoir eu de pièce en stock : seul un comptage qui ne change rien est toléré, et un stock initial compte toujours au moins une pièce. Elle ne doit pas avoir d’achat en brouillon ou passé, ni de devis en cours. Et une pièce suivie doit être à zéro. Quand c’est refusé, l’explication vient après coup (#explainRejectedWrite). - Quand une déclinaison est supprimée, les lignes de commandes abandonnées, de devis clos ou d’achats soldés perdent leur lien (
onDelete: SetNull). Par contre, elles gardent leurs copies : nom, référence, prix (Une vente garde ce qui a été vendu). Un devis dont la pièce suivie a disparu ne s’accepte plus (PIECE_GONE).
Changer de politique de stock
Une pièce peut passer de « suivie en stock » à « fabriquée à la commande », ou l’inverse. Ça change ce que l’annulation, la réception et le paiement feront d’elle (Stock).
- De suivie à fabriquée à la commande, c’est refusé tant qu’il reste du stock, par le service et par la base. C’est refusé aussi tant que des pièces vendues attendent encore en magasin (
variant-admin.service.ts#assertNothingHeldOnShelf). Si leur vente était annulée, elles ne pourraient plus revenir en stock. - De fabriquée à la commande à suivie, avec un stock de départ, c’est admis seulement pour une pièce qui n’a eu aucun mouvement (
variant-write-guards.ts#assertFirstStock), avec son prix de revient dès la première pièce. Sinon, le stock s’ouvre par un comptage. - Le passage ne vérifie pas tout. Prenons un achat pour le stock qu’on attend encore au moment du passage. À sa réception, il donnera seulement son prix de revient à la pièce, et il ne l’entrera pas en stock (
purchase-order-receipt.service.ts#receivePurchaseOrder). Et une ligne déjà payée comme pièce en stock passe en rupture, parce que le décompte ne vise que les pièces suivies (decrementPaidStock).
Changer un prix ou un coût
Chaque changement de prix s’inscrit dans l’historique des prix (VariantPriceChange), sous un verrou de la déclinaison (shared/server/price-history.ts#lockVariantPricing, #recordVariantPrice). C’est dans cet historique qu’on lit le prix de référence d’un prix barré (Prix, remises, TVA et port). La base exige un prix positif et une éco-contribution comprise entre zéro et le prix (ProductVariant_priceCents_check, ProductVariant_ecoContribution_check).
Le formulaire renvoie le prix et le coût qu’il affichait, et la mise à jour les met dans sa condition. Si quelqu’un les a changés entre-temps, la réponse est « le prix a changé » (PRICE_CHANGED, COST_CHANGED). Le second geste n’écrase donc pas le premier sans le dire.
En lot, modules/products/services/product-price.service.ts#setProductsPrices verrouille les déclinaisons triées par identifiant. Le lot passe en entier ou pas du tout. Si un prix a bougé (PRICES_CHANGED) ou si une ligne est refusée (PRICES_REFUSED), tout s’arrête. Les prix tirés d’un tarif fournisseur (#setVariantsPrices) ne s’annoncent jamais comme une réduction.
Un nouveau prix ne touche pas les devis ouverts, parce que leur ligne est une copie figée à l’envoi. Il ne touche pas non plus les commandes. Chaque ligne de commande recopie le prix, le coût et la politique de stock à sa création.
Quand on corrige le coût de pièces en stock, le journal reçoit une paire : une sortie, puis une entrée au nouveau coût. Le solde ne change pas (shared/server/stock-ledger.ts#recordCostCorrection). Du coup, la valeur du stock à une date passée se rejoue à l’identique. On ne peut pas effacer le coût d’une pièce suivie qui a du stock (COST_ON_HAND_CLEARED). Et un tarif fournisseur n’écrase pas un coût moyen en jeu. La pièce est laissée de côté, et la personne le voit (variant-cost.service.ts#setVariantsCosts).
Les limites
- Une déclinaison est une combinaison complète, et le meuble ne nomme qu’un axe de choix (
choiceTerm). Il n’y a pas de grille d’options combinées. Donc un meuble très configurable se vend sur devis, en lignes libres avec leurs précisions (Devis). - Il n’y a pas de versions du catalogue. Ce qui protège le passé, ce sont les copies que porte chaque ligne et le gel des identifiants cités. Une ligne lit donc la valeur figée à sa création, même si la fiche a changé depuis.