TODO — Feuille de route projet

Projet Site e-commerce Maison Crosnier · Mise à jour : 10 août 2026

Suivi méthodique des points à traiter. Légende : [x] fait · [~] partiel / en cours · [ ] à faire. Objectif immédiat : atteindre la « définition de prêt » pour commencer à coder (§0).

0. Bloqueurs pour commencer à coder

• Stack technique — VERROUILLÉE : Laravel (PHP 8.3) + MySQL, front Blade + Alpine.js (réutilise les maquettes), back-office Filament. Serveur : prérequis confirmés (PHP/MySQL). VPS possible plus tard si besoin (cron/queue/déploiement).
• Modèle de données autonome finalisé (voir §2).
• Périmètre back-office MVP — VALIDÉ (Cadrage_BackOffice_MVP) : catalogue, commandes & préparation (+ récap prod + bons de prépa), avoirs, clients, CMS pages, paramétrage, utilisateurs ; rôles admin + préparateur ; promos hors MVP.

1. Déjà acté (socle)

• Vision, décisions et ADR — Synthèse V5.
• Réorientation « site autonome, caisse-ready ».
• Direction artistique + maquettes (V2) + thèmes saisonniers.
• Consignes-cadre pour l’agent de développement → fichier de règles racine AGENTS.md figé (v1), stack-spécifique (Laravel/Filament), à placer à la racine du dépôt.
• Paiement : PayPlug, intégral, barème d’annulation.
• Parcours client, créneaux (30 min), politique de commande (formule de calcul), avoirs (modèle site).
• Espace de dev www/dev/ + index + protection par mot de passe.

2. Modèle de données (à finaliser)

• Repasser le document en site-propriétaire (v1, « cache caisse » retiré).
• Ajouter le champ refCaisse (produits, commandes, clients, avoirs, déclinaisons).
• Structure fine du catalogue — confirmée : déclinaison à prix absolu, options payantes, formule à prix fixe (choix N produits dans des groupes), multi-catégories.
• Entités back-office : utilisateur admin + rôles.
• Ports/interfaces (catalogue, commandes, avoirs, clients) définis.
• [~] Schéma de base : entités/champs/relations définis ; index et migrations Laravel à finaliser.

3. Back-office — CADRÉ (voir Cadrage_BackOffice_MVP)

• Gestion du catalogue (produits, déclinaisons, options, formules, catégories, familles).
• Gestion des médias.
• Commandes & préparation : liste/filtres, récap de production, bons de préparation.
• Authentification + rôles (admin, préparateur).
• CMS (pages éditoriales) + paramétrage (horaires, familles, créneaux, thèmes).

4. Réalignement des documents existants

• Modèle de données → version autonome v1 (structure catalogue confirmée).
• Contrat Gateway → recadrer comme interface/port pointant d’abord vers la base du site.
• Synthèse → V5 (réorientation).
• Consignes-cadre → réalignées (ports/adaptateurs, refCaisse).
• [~] Exigences API caisse → conservé tel quel comme contrat d’intégration future (ok).

5. Points fonctionnels à trancher

• Familles de politique de commande : liste définitive.
• Viennoiserie : règle pour un retrait après 9h.
• Bouton « Ajouter au panier » sans créneau : comportement exact.
• Horaires d’ouverture, jours fériés, fermetures exceptionnelles.
• Durée de créneau (30 min ?) + règles de génération.
• Stock : pas de gestion de stock (confirmé).
• [~] Cible d’intégration caisse (maître ou synchro) : différé, à la découverte de l’API.

6. Éléments externes à réunir

• Compte PayPlug + clés de test (sandbox).
• Envoi d’e-mails : SMTP de l’hébergeur ou service transactionnel.
• Contenu : produits, prix, catégories, photos.
• Hébergement — cible décidée : VPS sous Debian 13 (Nginx + PHP-FPM 8.4 + MySQL ; Debian 13 retenu car PHP 8.4 par défaut, supporté par Laravel/Filament — Ubuntu 26.04 = PHP 8.5, pas encore supporté). Déploiement piloté par Git (push HTTPS → le VPS tire et déploie ; pas de SSH direct depuis l’agent). Reste : commander le VPS, bootstrap serveur, pipeline + script de déploiement, .env prod.

7. Design / assets / graphiste

• Logo marmotte intégré + logo SVG vectoriel extrait (visuels/marmotte.svg).
• Police Condor intégrée (WOFF2 auto-hébergées : ExtraLight + Light) — remplace les approximations Google Fonts.
• ⚠ Licence webfont Condor à acquérir pour la mise en ligne (les .otf sont en licence bureau).
• Favicon provisoire (marmotte) ; [ ] favicon lisible (version simplifiée) — demandé au graphiste.
• Récupérer les autres assets : motif d’empreintes + icônes en SVG.
• [~] Écrans manquants (sélecteur de créneau, panier, tunnel, espace client, back-office) — brief envoyé au graphiste.
• Déclinaisons mobiles.

8. Légal & conformité

• CGV (dont mention d’exclusion du droit de rétractation).
• RGPD : mentions, données personnelles, consentement.
• Protection du dossier dev/ (Basic Auth).

9. Non-fonctionnel

• Mobile-first (principe acté).
• Performance : budget de page, optimisation des images.
• Accessibilité : prefers-reduced-motion, contrastes, navigation clavier.
• [~] SEO : spécification produite (SEO_Specification) — URLs propres, métadonnées, Open Graph, données structurées (Schema.org), sitemap/robots ; reste à implémenter.

10. Backlog / prompts de développement (plus tard)

• Fichier de règles racine AGENTS.md figé (v1) — garde-fou anti-dérive, relu à chaque phase.
• Nettoyage de l’ancien site PHP : script nettoyer-ancien-site.ps1 exécuté par JP.
• [~] Kit de démarrage livré (site-maison-crosnier-starter-kit.zip) : install.sh génère Laravel + Filament + architecture (enums, ports, services, provider) + règles racine ; syntaxe PHP/bash vérifiée. À lancer par JP là où Composer est accessible (le sandbox de l’agent n’atteint pas packagist).
• Dépôt Git neuf effectivement généré (via le kit) puis poussé sur un remote HTTPS.
• Pipeline de déploiement VPS (provisioning + hook de déploiement) — voir décision §6. Migration OVH mutualisé → VPS en cours (JP).
• Découper le backlog une fois stack + modèle + back-office prêts.
• Rédiger les prompts séquencés (vibe coding).

Prochaine action

À décider ensemble : verrouiller la stack (§0), puis enchaîner sur le modèle de données autonome + structure du catalogue (§2) et le cadrage du back-office (§3). On traite un bloc à la fois ; je mets ce fichier à jour à chaque étape.