Objectif : Découvrir le projet et lancer un environnement local sûr.
Dernière mise à jour : 2026-11-03
Statut : Frontend livré en production le 2026-11-03 (f7f94f5) ; recherche/planning, préparation et confidentialité vérifiés publiquement, détail et limites dans le journal.
Documents liés : PRD, TRD, Parcours, Design, Backend, Roadmap, Décisions.
Broco-Chou aide à choisir des recettes, composer sept jours de repas et préparer ses courses. Pensé pour les étudiants et la cuisine du quotidien, ce projet indépendant s'inspire des calendriers du Crous de Lyon ; il n'est pas un service officiel du Crous.
Application publique · Dépôt GitHub
- Découverte par swipe, sélection et favoris.
- Planning sur aujourd'hui à J+6, génération à partir des recettes choisies ou édition manuelle.
- Recherche de plats par nom, résultats lisibles et choix manuel du jour/créneau ; filtres facultatifs et confirmation de remplacement.
- Préparations numérotées, lisibles même après avoir été cochées ; textes Crous restaurés depuis les quatre PDF d'origine.
- Courses regroupées, cases à cocher, copie, partage et impression.
- Comptes e-mail/mot de passe, confirmation Supabase, recettes personnelles et photos privées.
- Récupération de mot de passe par e-mail et page d'information sur les données personnelles ; aucun nouveau fournisseur d'authentification ou d'e-mail.
- Modération administrative ; workflow enrichi et droits des deux comptes attendus déployés dans Supabase Cloud le 2026-10-17, accès SQL/RLS vérifiés.
Plans, favoris, préférences, courses et historique restent dans le navigateur, séparément par compte. Comptes, recettes et photos sont dans Supabase.
Next.js 16.4.4, React 19.2.6, TypeScript 5.7.3, Tailwind CSS 4.3.3, shadcn/ui/Radix, Framer Motion, Zustand, Supabase JS 2.117.3 et CLI 3.0.0, PostgreSQL/RLS, Storage, Vercel. Versions résolues du lockfile ; détail dans le TRD.
Installer Node.js ≥22.13 et npm ; démarrer Docker Desktop avec conteneurs Linux. Préparer avec Internet les dépendances npm, le binaire Windows du CLI et les images Docker avant de travailler hors ligne.
Depuis la racine du dépôt :
npx supabase start
npm run devSur un nouveau poste, exécuter d'abord npm ci avec Internet, puis, après le premier démarrage Supabase, npm run supabase:env une fois pour préparer .env.development.local. Les deux commandes ci-dessus suffisent ensuite tant que cette configuration reste valide. Elles utilisent les dépendances installées, sans installation nécessaire au démarrage.
Ouvrir Next.js, Studio et Mailpit. Supabase API utilise 54321, PostgreSQL 54322. Supabase démarre aussi Mailpit ; npm run mailpit permet de le relancer seul. npm run supabase:start reste une alternative conservant le correctif PostgREST historique.
supabase:env écrit les clés de la pile locale dans .env.development.local, préserve .env.local et ne contacte pas Cloud. Redémarrer Next.js si déjà lancé. Les comptes locaux sont distincts des comptes de production ; les confirmations sont capturées par Mailpit. Le seed local autorise l'adresse d'administrateur de développement sans créer de compte ni mot de passe.
Le modèle .env.example est l'unique exemple, sans secret. Ne jamais versionner les fichiers .env*.local. Sans Supabase configuré, les mocks permettent la découverte ; Auth et soumissions nécessitent Supabase. Une configuration Cloud éventuelle dans .env.local n'est pas remplacée pour le build de production local.
Pour un téléphone sur le même réseau privé :
npm run dev:local -- --hostname 0.0.0.0Ouvrir http://<IPv4-du-PC>:3000, adapter allowedDevOrigins et les redirections Auth locales, puis vérifier le pare-feu. Next.js relaie Supabase local via /__supabase. Procédure et diagnostic.
| Commande | Usage |
|---|---|
npm run lint |
ESLint |
npx tsc --noEmit |
Contrôle de types séparé obligatoire : le build ignore les erreurs de types |
npm run build puis npm run start |
Construire et servir la version de production localement |
npm run supabase:stop |
Arrêter les services locaux en conservant leurs données |
npm run supabase:status |
Statut local ; peut afficher des clés, ne pas partager sa sortie |
npm run mailpit:stop |
Arrêter uniquement la boîte locale |
npm run mailpit:check |
Tester livraison et confirmation locales avec nettoyage |
node scripts/verify-personal-recipes.mjs |
Soumission, photos et droits dans la seule base locale |
node scripts/verify-documentation.mjs |
Sept documents, métadonnées et liens locaux |
node scripts/verify-preparations.mjs |
Corrections Crous, intégrité des étapes et préservation des modifications d'auteur |
node scripts/verify-local-recovery.mjs |
Session de récupération, changement de mot de passe et invalidation du lien sur Supabase local |
node scripts/verify-auth-recovery-browser.mjs |
Parcours récupération et confidentialité, vrai e-mail Mailpit, ordinateur/mobile via Playwright externe |
node scripts/audit-preparation-catalog.mjs |
Audit anonyme en lecture seule du catalogue local ; --remote-readonly cible explicitement le catalogue public Cloud |
node scripts/verify-planning-browser.mjs |
Parcours planning et préparation sur ordinateur et mobile émulé, avec Playwright externe |
npm run offline:check |
Vérifier les 299 chemins photo locaux, le repli partagé et l'absence de police/CSS/script CDN obligatoire ; les photos Pexels restent facultatives |
Autres tests, prérequis Playwright, résultats et échecs : journal de validation. Avec CLI 3, une migration additive locale utilise npm exec -- supabase migration up (cible locale par défaut, lire --help avant toute opération). npm run supabase:reset détruit les données locales et rejoue les seeds : ce n'est pas une commande normale de démarrage. Ne jamais exécuter de reset distant.
Après npm ci, préparer une fois les ressources avec Internet par npm run ocr:prepare, puis npm run ocr:check sans réseau. Démarrer normalement avec npm run dev et ouvrir /dev/ocr. Cette page renvoie 404 en mode production, y compris avec npm run start. Les binaires ignorés dans public/ocr/ occupent 65,01 Mio ; aucune page normale ne charge le moteur. Aucun compte requis, aucun enregistrement de recette. Précision manuscrite et appareils réels restent à valider. Architecture, limites et protocole dans le TRD, preuves dans la roadmap.
flowchart LR
N[Navigateur React] --> Z[Zustand et localStorage par compte]
N --> S[Supabase Auth, PostgreSQL RLS et Storage]
N --> A[API Next.js pour imports et notifications locales]
V[Vercel] --> N
Vercel, projet recipe-app, équipe vertondan-9283s-projects, installe avec npm ci. Supabase Cloud : cbwrvcifxcqyrgtcpvbd. Les migrations sont distinctes du déploiement frontend. Aucun push ni déploiement de production sans accord ; travailler depuis main, relire le diff et les tests avant fusion.
Au 2026-10-17 : SMTP intégré Supabase confirmé en lecture seule, confirmation obligatoire et redirection publique correcte. Limites de destinataires/débit documentées dans TRD. RESEND_API_KEY existe dans Vercel Production/Preview sans usage dans le code ; retrait proposé, pas effectué. Mailpit est conservé, aucun Mailjet/Resend applicatif ajouté.
| Document | Question traitée |
|---|---|
| PRD | Pourquoi, pour qui et quelles fonctions réelles ? |
| TRD | Comment construire, configurer, tester et exploiter ? |
| APP_FLOW | Quels écrans, états et appels ? |
| DESIGN_BRIEF | Quels tokens, composants et règles UX ? |
| BACKEND_SCHEMA | Quelles tables, RPC, permissions et divergences Cloud ? |
| ROADMAP | Quelles tâches, dettes, preuves et historique City Café ? |
| DECISIONS | Pourquoi ces choix et quelles propositions restent ouvertes ? |
Pas de synchronisation multi-appareil, d'écran complet régime/budget, de gestion complète du compte ni de pipeline Odélis périodique. La récupération utilise l'envoi Supabase existant et ses limites. La confidentialité indique le responsable/contact confirmé et la règle de revue manuelle après six mois d'inactivité, avec conservation des recettes publiées après anonymisation lors d'une fermeture ; aucun traitement automatique n'est implémenté. La procédure opérationnelle, la conservation chez les prestataires et les autres mentions restent à finaliser dans SEC-04. Quantités/portions, invalidation des courses, accessibilité et dépendances demandent encore des corrections. Audit npm du 2026-11-02 : zéro alerte de production, 11 alertes modérées dans l'outillage de développement, sans correction forcée incompatible. L'écart SQL de modération est corrigé par la livraison autorisée du 2026-10-17 ; aucun e-mail de modération n'est envoyé en production. Les validations et limites sont suivies dans la roadmap.
Pour contribuer : lire AGENTS.md, partir de main, conserver Auth/RLS/données, utiliser Conventional Commits et mettre à jour documentation et journal avec les tests. Ne pas importer automatiquement feat/auth-email-readiness.
Les références éditoriales Crous, URLs/pages sources et attributions Pexels doivent être conservées. Aucun fichier de licence générale du code n'est présent à la racine au moment de l'audit ; ne pas présumer une licence MIT ni des droits de republication des contenus tiers.
Sources : Crous Lyon — Le plein d'idées recettes, Manger Bouger — Manger mieux. Les attributions City Café/Pexels et les artefacts d'import restent versionnés.