Plan amélioration boulangerie

Lien isolé Accueil docs Formation
Modules métier

Roadmap et améliorations du module boulangerie.

Plan d’amélioration – Module Boulangerie

Ce document décrit les améliorations prévues, par phase, pour ne rien casser et avancer de façon ordonnée.


Phase 1 – POS Boulangerie : paniers en attente

Objectif : Comme sur le POS principal, permettre au caissier boulangerie de mettre des paniers en attente (sauvegarder / charger / finaliser) avec une clé par boutique et par utilisateur pour ne pas mélanger les paniers entre caissiers ou boutiques.

Fait :

  • Passer posShopId et posUserId depuis BakeryPosController vers la vue.
  • Dans la vue POS boulangerie : clé localStorage bakery_pos_pending_carts_{shopId}_{userId} (préfixe boulangerie pour ne pas mélanger avec le POS principal).
  • Ajout du bloc « Paniers en attente » : bouton Sauvegarder, liste des paniers (Charger, Finaliser, Supprimer), chargement au init depuis le storage.

Fichiers modifiés :

  • app/Http/Controllers/Bakery/BakeryPosController.php
  • resources/views/bakery/pos/index.blade.php

Phase 2 – Multi-boutique cohérent ✅

Objectif : S’assurer que tous les écrans boulangerie (ingrédients, recettes, production, ajustements) ne montrent que les données de la boutique courante et refuser l’accès si la boutique courante n’est pas une boulangerie.

Fait :

  • Trait EnsuresBakeryShop avec getBakeryShopId() : retourne l’ID boutique uniquement si le type est boulangerie, sinon abort 404.
  • IngredientController, RecipeController, ProductionController, StockAdjustmentController utilisent le trait et appellent getBakeryShopId() dans index, create, store, edit, update, destroy (et complete pour Production).
  • Lors des créations (store), shop_id est passé explicitement dans les données pour ingrédient, recette, lot de production et ajustement.

Phase 3 – Rapports Boulangerie : graphiques et export ✅

Objectif : Enrichir la page Rapports Boulangerie avec des graphiques (Chart.js) et un export PDF.

Fait :

  • Données : getBakeryContext() calcule salesByDay (ventes par jour sur la période) en plus de stats et topProducts.
  • Graphiques (Chart.js) :
    • Courbe (line) : ventes par jour sur la période.
    • Barres horizontales : top 10 produits (quantités vendues).
  • Export PDF : Route GET /bakery/reports/export-pdf?from=...&to=..., vue bakery.reports.export-pdf, téléchargement du rapport (synthèse + top produits).
  • Vue : Bouton « Export PDF » en haut à droite, deux cartes avec canvas pour les graphiques, tableau détail top produits inchangé.

Fichiers modifiés / créés :

  • app/Http/Controllers/Bakery/BakeryReportController.php (refactor getBakeryContext, exportPdf).
  • resources/views/bakery/reports/index.blade.php (graphiques + bouton export).
  • resources/views/bakery/reports/export-pdf.blade.php (nouveau).
  • routes/web.php (route bakery.reports.export-pdf).

Phase 4 – Alertes stock bas (ingrédients) ✅

Objectif : Afficher les ingrédients dont le stock est sous le seuil minimum pour éviter les ruptures en production.

Fait :

  • Sur la page Ingrédients (/bakery/ingredients) : bloc « Ingrédients en alerte » affiché en haut lorsque au moins un ingrédient actif a un seuil min > 0 et stock_on_hand <= min_stock.
  • Liste : nom, stock actuel, seuil min, unité, avec bouton Ajustement entrée qui ouvre le formulaire d’ajustement avec l’ingrédient présélectionné, type « Ajustement » et sens « Entrée (+) ».
  • Lien « Voir tous les ajustements » vers la liste des ajustements.

Fichiers modifiés :

  • app/Http/Controllers/Bakery/IngredientController.php : calcul de $lowStockIngredients, passé à la vue.
  • app/Http/Controllers/Bakery/StockAdjustmentController.php : create() accepte ingredient_id en query, passe preselectedIngredientId à la vue.
  • resources/views/bakery/ingredients/index.blade.php : bloc alerte + liens.
  • resources/views/bakery/adjustments/create.blade.php : présélection ingrédient + type Ajustement + direction Entrée quand ouvert depuis l’alerte.

Phase 5 (optionnel) – Production et recettes

  • Lien recette → produit vendu : champ optionnel sur la recette (product_id) pour savoir quel produit du catalogue est produit par cette recette ; utile pour les rapports (coût de revient, marge).
  • Coût de revient : affichage du coût matières (ingrédients) par recette / par lot, et comparaison au prix de vente du produit.

Ces points peuvent être traités après les phases 1–4.


Récapitulatif des priorités

Phase Description Statut
1 POS boulangerie – Paniers en attente (shop + user) ✅ Fait
2 Scope shop + accès réservé boulangerie ✅ Fait
3 Rapports – Graphiques + export PDF ✅ Fait
4 Alertes stock bas ingrédients ✅ Fait
5 Lien recette ↔ produit, coût de revient Optionnel

Impact sur les autres types de boutiques

Aucune modification du comportement des autres types de boutiques (épicerie, pharmacie, etc.).

  • Routes : Toutes les routes modifiées ou ajoutées sont sous le préfixe /bakery/... et protégées par les permissions bakery.*. Elles ne sont utilisées que lorsque l’utilisateur travaille sur une boutique de type Boulangerie.
  • Phase 2 : Le trait EnsuresBakeryShop et les contrôles sont uniquement dans les contrôleurs du namespace Bakery. Les contrôleurs « généraux » (Produits, Ventes, Caisse, Rapports principaux, etc.) n’ont pas été touchés.
  • Phase 1 (POS) : Le POS boulangerie utilise une clé localStorage distincte (bakery_pos_pending_carts_...). Le POS principal et ses paniers en attente (pos_pending_carts_...) restent inchangés.
  • Phase 3 & 4 : Rapports boulangerie et alertes ingrédients ne s’affichent que dans les vues du module boulangerie, accessibles uniquement en contexte boulangerie.

Ce plan peut être mis à jour au fil des livraisons.