Module boulangerie

Lien isolé Accueil docs Formation
Modules métier

Recettes, production, commandes — boutique type boulangerie/pâtisserie.

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 boulangerie
    • bakery.production — Ingrédients, production, ajustements
    • bakery.recipes — Recettes
    • bakery.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).
  • Spécificités :
    • Paiement toujours « payé » (payment_status = paid), pas de dettes.
    • Méthodes : cash, card, mobile, mixed.
  • 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 (avec RecipeItem : 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).

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

  1. Clarifier le périmètre : multi-boutiques (shop_id partout) ou une seule boulangerie par instance.
  2. POS : aligner avec le POS principal (paniers en attente, remise, client, reçu, etc.) si besoin.
  3. Production : lien clair Recette → Produit vendu, unités (recette vs produit), coût et marge.
  4. Rapports : coûts matières, marges par produit/recette, exports, graphiques.
  5. Stocks : alertes stock bas ingrédients, inventaires, seuils par ingrédient.

Ce document peut être mis à jour au fil des évolutions du module.