Documentation du système

Guide pas à pas pour comprendre, configurer et utiliser l'application de gestion de produits. Cette base peut être adaptée pour tout projet de gestion de carte pour restaurant.

Espace public

Consultation des catégories et produits, recherche visuelle, fiches produits rapides avec modale, navigation claire.

Espace gestion

Création/édition des catégories et produits, gestion des images, paramètres (devise, options). Propulsé par Laravel 12, Livewire v3, Tailwind v4, Alpine.js et Preline UI.

Sommaire

1. Aperçu du fonctionnement 2. Prérequis & rôles 3. Navigation générale 4. Gérer les catégories 5. Gérer les produits 6. Images & médias 7. Paramètres globaux (devise) 8. Authentification & utilisateurs 9. Adapter pour un restaurant 10. Performance & SEO 11. FAQ

1. Aperçu du fonctionnement

Le système organise le contenu en deux entités principales : Catégories (ex. : Entrées, Plats, Desserts) et Produits (ex. : Burger, Salade, Pizza). Chaque produit peut avoir un prix à l’unité, un prix menu, une description/recette et une image. Les slugs sont générés pour un adressage propre et SEO-friendly.

2. Prérequis & rôles

Technos : Laravel 12, Livewire v3, Tailwind v4, Alpine.js, Preline UI.

Rôles :

Visiteur : consulte les catégories/produits.
Administrateur : gère catégories, produits, images, paramètres.

4. Gérer les catégories

Ouvrez l’interface de gestion et allez dans Catégories.
Cliquez sur Créer puis renseignez : nom, description, image (optionnelle). Le slug est généré automatiquement.
Validez pour enregistrer. La nouvelle catégorie apparaît dans l’accueil et le menu.
Pour modifier ou supprimer, ouvrez la catégorie et utilisez les actions dédiées.

5. Gérer les produits

Allez dans Produits puis cliquez sur Créer.
Renseignez : nom, description/recette, prix à l’unité, prix menu (optionnel), image (optionnelle), catégories associées.
Enregistrez. Le produit apparaît instantanément côté public (grâce à Livewire).
Pour mettre en avant un produit, assurez-vous que l’image est nette et au bon format.

6. Images & médias

Formats recommandés : .webp (léger), .jpg.
Taille conseillée : 800 px de largeur minimum, ratio 1:1 pour les cartes.
Après déploiement, si les images n’apparaissent pas, exécutez php artisan storage:link.
Les images de catégories/produits s’affichent automatiquement côté public si renseignées.

7. Paramètres globaux (devise)

La devise affichée (symbole) est gérée via les paramètres applicatifs. Mettez à jour la devise selon votre marché (€, $, CFA, etc.). Les prix côté public s’actualiseront automatiquement.

8. Authentification & utilisateurs

Accédez à la gestion avec un compte administrateur.
Les visiteurs n’ont pas besoin de compte pour consulter le menu.
Les bonnes pratiques de sécurité Laravel sont suivies (CSRF, validation, rôles).

9. Adapter pour un restaurant

Ce système sert de base pour une carte de restaurant en ligne : catégories = sections du menu, produits = plats. Quelques pistes d’adaptation :

Personnalisation visuelle : logo, couleurs, typographies via Tailwind.
Libellés : renommer les catégories selon votre carte (Entrées, Plats, Desserts, Boissons).
Options : ajouter tailles/suppléments (via champs produits ou relations dédiées).

10. Performance & SEO

Slugs pour des URLs propres et indexables.
Images optimisées (.webp) et chargement rapide.
Accessibilité : contrastes, textes alternatifs, navigation au clavier.
Robots : fichier robots.txt présent.

11. FAQ

Les images ne s’affichent pas ?

Assurez-vous d’avoir exécuté php artisan storage:link et téléversé des images au bon format.

Le symbole de devise est incorrect ?

Mettez à jour la devise dans les paramètres.

Comment ajouter une nouvelle section de carte ?

Créez une catégorie (ex. : Boissons), puis associez-y des produits.

Besoin d’une personnalisation avancée ? Le code suit les bonnes pratiques Laravel (SOLID, sécurité) et un design moderne responsive. Étendez en toute sérénité.