Skip to content

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Broco-Chou

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

Fonctionnalités

  • 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.

Stack et prérequis

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.

Démarrage local — PowerShell

Depuis la racine du dépôt :

npx supabase start
npm run dev

Sur 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.0

Ouvrir 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.

Commandes importantes

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.

Prototype OCR expérimental local

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.

Architecture et déploiement

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
Loading

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é.

Documentation de référence

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 ?

Limites et contributions

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.

Licence et attribution

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.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages