Cadrage du back-office — MVP

Projet Site Maison Crosnier · Laravel + Filament · 10 août 2026

Objectif

Espace d'administration du site autonome : gérer le catalogue, les commandes (et leur préparation), les avoirs, les clients et le paramétrage. Bâti sur Filament, qui génère l'admin à partir des modèles Eloquent — donc l'essentiel du CRUD est quasi gratuit une fois le modèle en place. Reste caisse-ready : les champs refCaisse sont visibles/éditables mais optionnels.

Rôles & accès

• Admin : accès complet (catalogue, commandes, avoirs, clients, paramétrage, utilisateurs).
• Préparateur : accès limité aux commandes / préparation (voir, changer le statut) ; catalogue en lecture.

Authentification Filament distincte de l'espace client (guard séparé). Autorisations par rôle (Policies).

Modules (MVP)

1. Catalogue

• Produits — CRUD complet : nom, slug, description, famille, type (simple / formule), prix de base, catégories (multi), actif, mis en avant, SEO, médias. Selon le type :
  • simple → déclinaisons (libellé, prix absolu) et groupes de choix + options (payantes).
  • formule → groupes de composition (libellé, quantité) + produits éligibles.
  • Champ refCaisse (optionnel).
• Catégories — arborescence (parent), nom, slug, ordre, actif.
• Familles / politique de commande — libellé, type (veille / delai), heure limite ou délai, horizon (J+0 / J+1), retrait_avant.

2. Commandes & préparation (cœur opérationnel)

• Liste des commandes — filtres : date de retrait, créneau, statut, point de retrait ; recherche par n° / client.
• Fiche commande — client, créneau, point de retrait, lignes détaillées (déclinaison, options, composition de formule), montant, paiement (réf. PayPlug), statut. Actions : passer en préparation → préparée → retirée ; annuler (déclenche remboursement ou avoir selon le barème §9).
• Vue « Préparation du jour » — on choisit une date → commandes groupées par créneau, avec statut, pour piloter le retrait.
• Récapitulatif de production — pour une date / un créneau, agrégation des quantités par produit (« 12 baguettes, 8 éclairs pour 10h ») à destination du fournil / labo.
• Bon de préparation imprimable par commande.

3. Avoirs

• Liste + fiche (code, solde, statut, origine). Édition « boutique » (auto-décrémentante). Création manuelle éventuelle (geste commercial).

4. Clients

• Liste + fiche (coordonnées, commandes, avoirs). Essentiellement consultation — RGPD : minimiser les données, permettre suppression / anonymisation.

5. Contenus & pages éditoriales (CMS)

• Gestion des pages du site : à propos, univers « La Marmotte », contact, mentions légales / CGV, etc.
• Champs : titre, slug, contenu (éditeur riche), SEO (title/description), état de publication (brouillon / publié), ordre.
• Objectif : faire vivre le contenu sans intervention technique.

6. Paramétrage

• Points de retrait : nom, adresse, durée de créneau, horaires d'ouverture, fermetures exceptionnelles.
• Créneaux : paramètres de génération (durée, plages).
• Thèmes saisonniers : activer un thème, ou planifier par plage de dates (activation automatique).
• Réglages généraux : seuil « expédition offerte », coordonnées, mentions, gabarits d'e-mails (confirmation, rappel).

7. Utilisateurs admin

• Gestion des comptes admin / préparateur (admin uniquement).

Hors périmètre MVP (plus tard)

• Promotions (reportées après le lancement — l'entité reste au modèle, non gérée dans l'admin au lancement).
• Rôles fins au-delà de admin / préparateur.
• Reporting / statistiques avancés.
• Multi-boutique (une seule au lancement).

Notes techniques (Filament)

• Une Filament Resource par entité (Produit, Catégorie, Famille, Promotion, Commande, Avoir, Client, PointDeRetrait, Utilisateur).
• La Préparation du jour et le récapitulatif de production = pages Filament custom (ou widgets), pas de simple CRUD.
• Guard d'authentification admin distinct du guard client ; Policies par rôle.
• refCaisse : champ optionnel sur les ressources concernées, pour la réconciliation future.
• Respect des consignes-cadre : pas de logique métier dans l'UI ; accès aux données via les repositories / ports.

Décisions (confirmées)

1. Rôles : admin + préparateur. ✔
2. Récapitulatif de production (agrégé par produit / créneau) : inclus — indispensable au labo. ✔
3. Bons de préparation imprimables : inclus au lancement. ✔
4. Pages éditoriales : gérées dans le back-office (module CMS ci-dessus). ✔
5. Promotions : exclues du MVP (reportées). ✔