Skip to content

Latest commit

 

History

History
109 lines (85 loc) · 16.7 KB

PRD.md

File metadata and controls

109 lines (85 loc) · 16.7 KB

Broco-Chou — Produit et exigences

Objectif : Décrire le produit réel, ses utilisateurs et ses perspectives sans confondre livraison et intention. Dernière mise à jour : 2026-11-03 Statut : Fonctionnalités intégrées à main et frontend livré le 2026-11-03 (f7f94f5) ; tests complets locaux et contrôles publics limités décrits au journal. Documents liés : Parcours, Architecture, Roadmap, Décisions.

Vision et périmètre

Broco-Chou aide à décider quoi cuisiner, organiser sept jours et préparer les courses. Le public initial est étudiant : studio, petit budget, peu de matériel et peu de temps. La découverte par swipe réduit l'effort de sélection ; le planning et les courses rendent ces choix utilisables au quotidien, y compris sur téléphone au supermarché.

Le projet indépendant s'inspire des calendriers du Crous de Lyon. Il n'est pas un service officiel du Crous. Les contraintes de saison, de simplicité et de coût sont des objectifs éditoriaux ; aucun prix réel ni budget calculé n'est fourni. L'usage par d'autres publics est une hypothèse à valider. Le score de variété n'est pas une évaluation nutritionnelle clinique.

Convention de preuve commune

Mention Signification
EXISTANT Confirmé dans les sources versionnées ; ne prouve pas un déploiement
TESTÉ Vérifié par un test identifiable ; consulter le journal pour son environnement et son résultat
CONFIGURÉ Présent dans un fichier ou observé par lecture d'un service
[À CONFIRMER] Non vérifié, inconnu ou déclaration historique non rejouée
À FAIRE Développement ou vérification manquant
HORS PÉRIMÈTRE Évolution qui ne doit pas être implémentée par cette mission

Les confirmations de production sont TESTÉES manuellement selon le retour du propriétaire, pour les adresses essayées seulement. Elles ne prouvent pas une ouverture publique sans restriction.

Utilisateurs et droits

Rôle Besoin et accès réel Limites
Visiteur non connecté Catalogue publié, swipe, favoris, planning, courses, suivi local Pas de soumission ni de photo privée d'un autre auteur
Utilisateur authentifié Parcours visiteur, création de recette, consultation de ses recettes dans tous leurs statuts et utilisation dans son planning Aucune modification après soumission par l'auteur ; aucune auto-validation sans rôle administrateur
Administrateur Lecture des soumissions et e-mails auteurs, modification des recettes community/pending, publication ou refus motivé Droits SQL vérifiés avec adresse confirmée ; aucune édition ni seconde décision après traitement par ces RPC

Les droits administrateur proviennent de recipe_admins ou recipe_admin_emails, jamais de métadonnées utilisateur. Le détail des permissions appartient au schéma backend. Aucun autre rôle applicatif n'est livré.

Personas de travail, non issus d'entretiens : étudiant sans four voulant préparer ses courses ; personne cuisinant pour plusieurs convives ; contributeur souhaitant utiliser sa recette avant publication ; administrateur contrôlant la qualité. [À CONFIRMER] fréquence d'utilisation, intérêt du swipe face à une recherche directe et efficacité de l'organisation proposée.

Exigences fonctionnelles

Chaque ligne associe une user story, une règle et un critère vérifiable. Les cas limites explicitent les limites de la version actuelle.

Fonction / statut User story et comportement Critères d'acceptation et cas limites
Onboarding — EXISTANT Comme visiteur, comprendre les trois étapes : choisir, planifier, acheter ; bouton « Commencer » Enregistre hasCompletedOnboarding puis ouvre l'accueil ; aucune collecte de régime/budget à ce stade. ?review permet d'accéder à la connexion/modération sans onboarding
Accueil — EXISTANT Comme utilisateur, consulter la plage de dates, les repas d'aujourd'hui et le nombre de repas cuisinés Sans plan : accès au swipe ; avec plan : accès au calendrier. Pas de moteur de suggestion du jour autonome
Swipe — EXISTANT Comme utilisateur, accepter à droite, refuser à gauche, mettre en favori, annuler le dernier choix Favori implique acceptation ; pas de doublon d'acceptation. Au bout du catalogue, compléter les types manquants ou recommencer. Le recommencement conserve les favoris, efface acceptations/refus/actions
Recherche et filtres — TESTÉ localement dans l'éditeur Comme utilisateur, chercher un plat par mots de son titre, sans dépendre des accents, de leur ordre ou de la casse, puis le choisir dans les résultats Résultats alphabétiques, 20 par affichage, action pour en voir davantage, état vide et effacement ; filtres saison/durée/régime/équipement repliés par défaut et cumulables. Pas de recherche dans le swipe ni de filtre de prix
Favoris — EXISTANT Comme utilisateur, retrouver une sélection persistante dans le profil Aperçu limité aux cinq premiers ; pas de page de gestion complète, pas de synchronisation distante
Planning automatique — EXISTANT Comme utilisateur, remplir les créneaux choisis sur aujourd'hui à J+6 avec les recettes acceptées Sept recettes distinctes par type/créneau requis : 14 plats pour déjeuner+dîner, 7 desserts si activés, 7 petits-déjeuners si activés. Pas de répétition d'une recette ; stock insuffisant : créneaux vides au niveau du store et invitation à compléter dans l'UI
Planning manuel — TESTÉ localement Comme utilisateur, composer sans terminer le swipe, choisir un jour et un créneau puis ajouter un résultat de recherche Sauvegarde immédiate locale, remplacement confirmé, confirmation de retrait et annulation du dernier retrait. Recette déjà présente désactivée avec date/créneau ; tous les créneaux si aucune préférence. Persistance vérifiée après rechargement
Préférences — EXISTANT partiel Comme utilisateur, activer les saisons, choisir les créneaux et le nombre de personnes Profil : saison, créneaux et multiplicateur 1–12. Régime, exclusions, ingrédients favoris, équipement, budget, difficulté, répétition mensuelle existent dans les types mais n'ont pas d'écran complet. Le bouton « Préférences » retourne à l'accueil
Consultation / cuisine — TESTÉ localement pour le parcours corrigé Comme utilisateur, lire intégralement les étapes numérotées et les cocher sans perdre leur lisibilité Corps 16 px/interligne 28 px, progression et défilement, unités affichées, fermeture Échap et retour du focus. L'ajout depuis la fiche ou Mes recettes ouvre l'éditeur recherchant le plat. Corrections Crous ciblées sur l'ancien texte connu, sans remplacer une correction ultérieure de l'auteur ; préparations très succinctes signalées, jamais inventées
Gestion des repas — EXISTANT Comme utilisateur, marquer cuisiné, sauter ou déplacer vers une autre date du plan Le déplacement conserve le créneau et remplace un repas à destination. « Cuisiné » ajoute une entrée à l'historique ; « sauté » retire les ingrédients à la prochaine génération
Courses — EXISTANT partiel Comme utilisateur, obtenir une liste regroupée, cocher, copier, partager ou imprimer Exclut les repas sautés, inclut les cuisinés. Quantités de même unité additionnées ; unités différentes concaténées. Multiplie par le nombre de personnes sans diviser par les portions de la recette : correction à prévoir. Basiques masqués seulement à l'écran ; restent dans le texte partagé
Historique — EXISTANT Comme utilisateur, retrouver mes six dernières préparations, noter 1–5 et « Refaire » Stockage local ; compteur « Semaines » estimé par ceil(history.length/7), pas un décompte de plans archivés. Aucune collection Cloud de semaines
Inscription / confirmation — EXISTANT, CONFIGURÉ Comme contributeur, créer un compte e-mail/mot de passe et confirmer avant connexion signUp, redirection vers l'origine du navigateur, pas de session avant confirmation, renvoi après délai 60 s ; ne jamais désactiver la confirmation
Connexion / déconnexion — EXISTANT Comme utilisateur, retrouver mon espace de navigateur par compte signInWithPassword, sessions Supabase persistées et rafraîchies, signOut({scope:'local'}). Pas de Google OAuth ni CAPTCHA
Récupération de mot de passe — EXISTANT et déployé, parcours complet TESTÉ localement Comme utilisateur, demander un lien depuis « Mot de passe oublié ? » et choisir un nouveau mot de passe Réponse générique, délai UI 60 s, e-mail Supabase existant ; session de récupération requise, confirmation du nouveau mot de passe, déconnexion après réussite. Session ordinaire et lien invalide/consommé refusés ; retour à la racine déjà autorisé, aucun réglage distant changé. Site public : refus sans session testé ; aucun e-mail ni changement de mot de passe réel utilisé pour la livraison
Confidentialité — EXISTANT, déployé et consulté publiquement Comme utilisateur, savoir où sont conservés compte, recettes et planning, et contacter le responsable Page /privacy, responsable et contact public confirmés, droits et demandes manuelles ; revue des comptes après six mois d'inactivité et recettes publiées conservées après anonymisation à la fermeture. Ce sont des règles décidées, sans purge ni anonymisation automatique livrée. Procédure opérationnelle, conservation des prestataires et mentions complémentaires restent SEC-04 ; aucune conformité juridique revendiquée
Création de recette — EXISTANT Comme contributeur connecté, saisir les champs, 1–60 ingrédients, 1–50 étapes et une photo facultative RPC atomique, photo JPG/PNG/WebP ≤5 Mio ; nouvelle recette community/pending, ingrédients rapprochés du référentiel ou créés. Erreur de suggestions : saisie manuelle possible ; fermeture bloquée pendant enregistrement
Saisie multimodale — PARTIEL, complément À FAIRE Comme contributeur, notamment San pour la voix, créer une recette par texte, voix ou photo et corriger avant enregistrement Texte et fichier photo existent ; aucune transcription vocale. Prototype OCR local séparé IMP-10 : images/texte, fusion et brouillon éditable sans sauvegarde, uniquement en développement. Précision manuscrite et capture sur appareils réels à vérifier ; aucune intégration OCR au parcours de soumission de production. Suivi COM-01/07/08
Modération — EXISTANT Comme administrateur, examiner, corriger, publier/refuser une soumission Auteur conservé, édition ne publie pas ; commentaire obligatoire pour refus, au plus 1000 caractères. Réponse concurrente : une seule décision. Auteur garde l'accès après refus ; aucune révision par l'auteur
Notifications — EXISTANT local seulement Comme administrateur local, recevoir un lien d'examen dans Mailpit Envoi facultatif après sauvegarde, file SQL durable et reprise manuelle ; aucun transport ni cron de production. Le nettoyage limite l'appel automatique au développement local sans affecter la modération
Référentiel To Eat List — À FAIRE Comme propriétaire, conserver les recettes dans To Eat List sur Notion, source de vérité durable, et les échanger avec Broco-Chou Exigence confirmée le 2026-10-17 ; aucune synchronisation applicative démontrée. Aller-retour complet, données et médias récupérables même après abandon/suppression de Broco-Chou ; priorité Notion, conflits et suppressions protégées à formaliser, restauration isolée à tester. Pas de garantie fournie par un simple export ponctuel. Suivi DB-05/06, distinct des plans locaux
Menus hebdomadaires — PARTIEL côté artefacts, maintenance À FAIRE Comme utilisateur, retrouver les plats du menu de la période choisie dans le catalogue et le planning Import historique de 11 recettes présent, sans preuve de couverture du menu actif. Confirmer source et dates, rapprocher les recettes, compléter les manquantes sans doublon et suivre l'état Notion. Opération récurrente IMP-07 ; aucune automatisation Odélis implicite
Développement hors ligne — TESTÉ sous restriction réseau, confirmation physique À FAIRE Comme développeur, travailler sans Internet après préparation du poste Démarrage Next.js avec DNS/TCP/fetch Node externes bloqués, parcours navigateur avec requêtes externes refusées, Supabase/Mailpit/Storage locaux réels vérifiés ; photos distantes facultatives avec repli local. Modules/images préchargés indispensables ; WAN physiquement coupé et redémarrage Docker Desktop non testés. OPS-05 reste IN_PROGRESS ; aucune garantie hors ligne pour le site public

Sources : orchestrateur, store, profil, éditeur, formulaire.

Priorisation MoSCoW

Niveau Version livrée à préserver Évolutions distinctes
Must Have Consultation, sélection, planning daté, courses, Auth confirmée, confidentialité des soumissions, modération/RLS Corriger fiabilité des quantités et vérifier avant ouverture publique les limites e-mail et les protections d'import
Should Have Filtres de l'éditeur, statut textuel, historique, photos privées Préférences complètes, accessibilité clavier/zoom, couverture des calculs, restauration documentée
Could Have Partage et impression des courses Partage du plan, restes, batch cooking, recherche plein texte, suggestions selon ingrédients disponibles, estimation de coût
Won't Have pour cette version — Google OAuth, Turnstile, Mailjet/Resend applicatifs, refonte UI, domaine payant imposé, synchronisation multi-appareil, pipeline Odélis automatique

Les priorités et statuts opérationnels uniques sont dans ROADMAP.

Objectifs et KPI proposés

À FAIRE : instrumentation métier, aucune mesure revendiquée. Vercel Analytics est rendu en production, mais aucun événement métier n'est codé.

KPI proposé Définition à valider
Activation Part des nouveaux visiteurs créant un premier planning
Onboarding terminé Fin d'onboarding / affichages initiaux
Sélection Recettes acceptées ou favorites par visiteur actif
Planning Nombre de générations ou créations manuelles distinctes
Contribution Soumissions réussies et part publiée
Modération Délai reviewed_at - created_at, en distinguant refus et validation
Retour utilisateur Retours volontaires et réutilisation hebdomadaire ; méthode de collecte à décider

Prévoir minimisation des données, finalité et information des utilisateurs avant toute nouvelle collecte. Ne pas déduire un KPI à partir du compteur « Semaines » actuel.

Risques et questions ouvertes

  • E-mail : SMTP intégré restreint ; voir les faits et sources dans TRD. Un succès sur les adresses testées ne valide pas l'inscription du grand public.
  • Offres gratuites : quotas, disponibilité, stockage des photos et conservation/sauvegardes doivent être suivis ; pas de garantie chiffrée inventée.
  • Catalogue : interprétations City Café, attributions d'images approximatives, ingrédients et portions hétérogènes ; historique maintenu dans la roadmap.
  • Données locales : effacement navigateur ou changement d'appareil entraîne perte des plans locaux ; séparation de clés ne constitue pas un chiffrement sur appareil partagé.
  • Sécurité : import de développement sans contrôle de rôle ; risque si connecté à Cloud ou exposé sur le réseau. Accessibilité et conformité RGPD non certifiées.
  • [À CONFIRMER] Public réellement autorisé à s'inscrire avec le SMTP actuel et calendrier d'ouverture plus large.
  • [À CONFIRMER] Base de portions canonique et comportement attendu quand le nombre de convives change.
  • [À CONFIRMER] Gouvernance éditoriale et délai souhaité pour modérer ; politique de conservation/suppression et contact pour les droits des personnes.
  • To Eat List comme source de vérité et sauvegarde durable des recettes : besoin confirmé ; contrat de données, règles de confidentialité/conflits/suppressions et restauration à définir et tester avant développement. La synchronisation multi-appareil des plans reste une demande distincte non livrée.
  • [À CONFIRMER] Semaine cible et source active des menus à maintenir, appareils pour voix/prise de photo, besoin éventuel d'extraction depuis une image, notifications et automatisation Odélis.