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
posShopIdetposUserIddepuisBakeryPosControllervers 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.phpresources/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
EnsuresBakeryShopavecgetBakeryShopId(): retourne l’ID boutique uniquement si le type est boulangerie, sinon abort 404. IngredientController,RecipeController,ProductionController,StockAdjustmentControllerutilisent le trait et appellentgetBakeryShopId()dans index, create, store, edit, update, destroy (et complete pour Production).- Lors des créations (store),
shop_idest 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()calculesalesByDay(ventes par jour sur la période) en plus destatsettopProducts. - 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=..., vuebakery.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 etstock_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()accepteingredient_iden query, passepreselectedIngredientIdà 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 permissionsbakery.*. Elles ne sont utilisées que lorsque l’utilisateur travaille sur une boutique de type Boulangerie. - Phase 2 : Le trait
EnsuresBakeryShopet les contrôles sont uniquement dans les contrôleurs du namespaceBakery. 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.