Synthèse du module Boulangerie
Document de référence pour savoir ce qui est déjà en place et comment faire évoluer le module.
1. Accès et conditions
- Le module est réservé aux boutiques dont le type est Boulangerie / Pâtisserie (
shop_type.code = 'boulangerie_pastry'). - Si l’utilisateur ouvre une boutique d’un autre type, les routes boulangerie renvoient 404 (POS, Rapports).
- Permissions utilisées :
bakery.pos.access— POS boulangeriebakery.production— Ingrédients, production, ajustementsbakery.recipes— Recettesbakery.reports— Rapports boulangerie
2. POS Boulangerie
- Route :
GET /bakery/pos→BakeryPosController@index - Finalisation :
POST /bakery/pos/complete→BakeryPosController@complete - Fonctionnement :
- Liste des produits de la boutique (même catalogue que le POS classique, filtré par
shop_id). - Catégories de la boutique.
- Utilise une session de caisse ouverte (même système que le POS principal).
- À la validation, réutilise le service POS existant (création vente + mise à jour stock produits).
- Liste des produits de la boutique (même catalogue que le POS classique, filtré par
- Spécificités :
- Paiement toujours « payé » (
payment_status = paid), pas de dettes. - Méthodes : cash, card, mobile, mixed.
- Paiement toujours « payé » (
- Vue :
resources/views/bakery/pos/index.blade.php(interface dédiée, plus simple que le POS principal).
Pistes d’amélioration : paniers en attente par shop/user (comme sur le POS principal), remises, choix client optionnel, impression reçu, etc.
3. Ingrédients
- Modèle :
App\Models\Bakery\Ingredient - Routes : index, create, store, edit, update, destroy.
- Champs principaux : name, unit, stock_on_hand, min_stock, unit_cost, is_active.
- Contrôleur :
Bakery\IngredientController - Vues :
bakery/ingredients/index, create, edit.
Note : Les ingrédients ne sont pas filtrés par shop_id dans le code actuel (scope global ou à préciser selon la base).
4. Recettes
- Modèle :
App\Models\Bakery\Recipe(avecRecipeItem: ingrédient + quantité + perte %). - Champs principaux : name, yield_qty, yield_unit, labor_cost, overhead_cost, target_margin_pct, is_active.
- Routes : index, create, store, edit, update, destroy.
- Contrôleur :
Bakery\RecipeController - Vues :
bakery/recipes/index, create, edit.
Une recette associe des ingrédients à des quantités (et % perte). Utilisée ensuite dans la production.
5. Production (lots)
- Modèle :
App\Models\Bakery\ProductionBatch - Workflow :
- Création d’un lot (planned) lié à une recette.
- Complétion du lot avec une quantité produite → le service
BakeryProductionService:- consomme les ingrédients (stock) selon la recette,
- peut créer/mettre à jour un produit en stock (selon la config).
- Routes : index, create, store, complete (POST sur un batch).
- Contrôleur :
Bakery\ProductionController - Service :
App\Services\BakeryProductionService(logique de consommation ingrédients + stock produit). - Vues :
bakery/production/index, create.
Pistes : Gestion des unités (recette en kg, produit en pièces), coût de revient, lien produit ↔ recette, etc.
6. Ajustements de stock (ingrédients)
- Modèle :
App\Models\Bakery\StockAdjustment - Types : loss, expired, adjustment (avec direction in/out).
- Routes : index (avec filtres type, ingredient_id), create, store.
- Contrôleur :
Bakery\StockAdjustmentController - Vues :
bakery/adjustments/index, create.
Permet de corriger le stock d’ingrédients (pertes, péremption, inventaire).
7. Rapports Boulangerie
- Route :
GET /bakery/reports→BakeryReportController@index - Contrôleur :
Bakery\BakeryReportController - Vue :
bakery/reports/index - Contenu actuel :
- Période :
from/to(défaut : mois en cours). - Chiffre d’affaires (ventes complétées, boutique).
- Dépenses (modèle
Bakery\Expense, par période). - Net = ventes - dépenses.
- Top 10 produits (quantités vendues sur la période).
- Période :
Pistes : Export PDF/Excel, graphiques, coûts matières, marge par recette/produit, etc.
8. Modèles et BDD
- Bakery\Ingredient — ingrédients (unité, stock, coût unitaire, seuil min).
- Bakery\Recipe — recettes (rendement, coûts, marge cible).
- Bakery\RecipeItem — lignes recette (ingrédient_id, qty, waste_pct).
- Bakery\ProductionBatch — lots de production (recipe_id, status, produced_qty, etc.).
- Bakery\ProductionConsumption — consommation d’ingrédients par lot (si suivi détaillé).
- Bakery\StockAdjustment — ajustements stock ingrédients.
- Bakery\Expense — dépenses (utilisées dans les rapports).
À vérifier en base : présence de shop_id sur ces tables (multi-boutiques) ou non.
9. Résumé des écrans
| Écran | Route / Nom | Permission |
|---|---|---|
| POS Boulangerie | /bakery/pos |
bakery.pos.access |
| Ingrédients | /bakery/ingredients |
bakery.production |
| Recettes | /bakery/recipes |
bakery.recipes |
| Production | /bakery/production |
bakery.production |
| Ajustements stock | /bakery/adjustments |
bakery.production |
| Rapports | /bakery/reports |
bakery.reports |
10. Comment avancer
- Clarifier le périmètre : multi-boutiques (shop_id partout) ou une seule boulangerie par instance.
- POS : aligner avec le POS principal (paniers en attente, remise, client, reçu, etc.) si besoin.
- Production : lien clair Recette → Produit vendu, unités (recette vs produit), coût et marge.
- Rapports : coûts matières, marges par produit/recette, exports, graphiques.
- Stocks : alertes stock bas ingrédients, inventaires, seuils par ingrédient.
Ce document peut être mis à jour au fil des évolutions du module.