AcadeNice/corentin_wakdo
7
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
corentin_wakdo/docs/domaines/stock-recettes.md
Imugiii f7caf2d50c
All checks were successful
CI / secret-scan (pull_request) Successful in 9s
Details
CI / php-lint (pull_request) Successful in 21s
Details
CI / static-tests (pull_request) Successful in 44s
Details
CI / js-tests (pull_request) Successful in 17s
Details
CI / auto-merge (pull_request) Successful in 5s
Details
docs(domaines): documentation par domaine fonctionnel (7 fiches) 
docs/domaines/ : une fiche par domaine livre (perimetre / ce qui est livre / regles
metier RG-T* / decisions -> ADR / tables), + index.

auth, catalogue, stock-recettes, users, rbac, stats, borne. Commande = P4 (schema pret,
non documentee ici). Troisieme et derniere PR du jeu de documentation socle.
2026-06-17 13:53:56 +00:00

1.8 KiB
Raw Blame History

Domaine — Stock & recettes (ingredients)

Perimetre

Gestion des ingredients, du stock (reappro + inventaire), des mouvements de stock, et de la composition des produits (recettes). Sous-tend la disponibilite produit calculee.

Ce qui est livre

  • IngredientRepository : CRUD, stock %/bande calcules, restock (tx), inventoryCount (tx, ecrit une ligne meme a delta=0, RG-3), movements (borne), isReferenced.
  • IngredientController : CRUD (ingredient.manage, sans PIN), RESTOCK (stock.manage, sans PIN), INVENTORY_COUNT (stock.count + PIN), mouvements (stock.read).
  • ProductRepository : composition (product_ingredient), setComposition (delete-and-reinsert tx), isOrderable (RG-T21), autoUnavailableIds.
  • Editeur de recette (ProductController::recipeForm/saveRecipe, ingredient.manage).

Regles metier

  • RG-T13 : INVENTORY_COUNT seule action sensible du stock (PIN equipier) ; succes -> stock_movement.user_id, sans audit_log (RG-T14 : le mouvement EST la trace). RESTOCK et CRUD ingredient ne sont PAS sensibles.
  • RG-T22 : echec PIN inventaire -> pin.failed + throttle dans une transaction.
  • RG-T21 : disponibilite produit calculee (cf. ADR-0003).
  • FK : product_ingredient/stock_movement RESTRICT sur l'ingredient (hard-delete -> 409) ; product_ingredient.product_id CASCADE (trace du nombre de lignes a la suppression, dette #27).

Decisions

ADR-0003 (stock % + RG-T21), ADR-0004 / RG-T14 (attribution sans double-journal).

Tables

ingredient, product_ingredient, stock_movement, allergen, ingredient_allergen (mapping differe). Detail : docs/merise/mlt.md sections 8.8 + 9.