Recettes des Boultons
Le carnet de recettes de la famille Boulton, en ligne : on y range les recettes, on prépare
le planning des repas de la semaine et on fait les courses à partir de ce planning.
Site : https://recettes-des-boultons.vercel.app
Fonctionnalités
- Recettes organisées en sections (« Pâte », « Garniture »…), chacune avec ses
ingrédients et ses étapes. Ajout, modification et suppression réservés aux administrateurs.
- Recherche sans accents : « gateau » trouve « Gâteau au yaourt ». Filtres par catégorie
et par tags, pagination.
- Portions ajustables : les quantités se recalculent selon le nombre de personnes.
- Mode cuisine : une étape à la fois, en plein écran, l'écran reste allumé.
- Photos : une photo par recette, redimensionnée dans le navigateur avant l'envoi.
- Favoris.
- Planning des repas : déjeuner et dîner sur la semaine, recettes ou repas libres, notes,
déplacement par glisser-déposer (ou par un menu « Déplacer… »), impression.
- Listes de courses : ajout des ingrédients d'une recette (toutes les sections ou
certaines), quantités additionnées quand un article revient avec la même unité, tri par
rayon, mode « magasin » avec de grandes cases à cocher.
- Hors ligne : la dernière version des listes de courses reste lisible sans réseau.
- Traducteur IA (administrateurs) : une recette collée en texte libre devient une
recette structurée, relue avant l'ajout, enregistrée en français ET en anglais.
- Recettes bilingues : chaque recette existe dans sa langue d'origine et en traduction
automatique ; le site affiche la langue de l'interface et la recherche trouve dans les deux
(DEVELOPER.md § 19).
- Connexion par e-mail et mot de passe, ou avec Google.
- Français et anglais, mode sombre, installable sur téléphone (PWA).
- Deux éditions : « Recettes des Boultons » (identité d'origine, par défaut) ou
générique (
NUXT_PUBLIC_EDITION=generic, base de la future version multi-comptes).
Stack
| |
|---|
| Application | Nuxt 4.5 (Vue 3.5, rendu serveur), Nuxt UI 4.11 (Tailwind CSS 4.3), Pinia 3, @nuxtjs/i18n 10 |
| Données et comptes | Supabase (PostgreSQL 17, Auth, Storage) via @nuxtjs/supabase 2 et supabase-js 2.117 |
| Validation | Zod 3.25, partagé entre le navigateur et le serveur |
| IA | Vercel AI SDK 7 (OpenAI gpt-4.1-mini par défaut) |
| Qualité | TypeScript strict, ESLint 9, Vitest 5, Playwright 1.63, GitHub Actions |
| Suivi des erreurs | Sentry (@sentry/nuxt 11), inactif sans DSN |
| Hébergement | Vercel, Node 22 |
Démarrage rapide (base locale)
Prérequis : Node 22 (.nvmrc), Docker Desktop, psql (brew install libpq).
npm install
npm run db:local:up # Supabase local (Docker) + migrations + comptes de test
cp .env.local.example .env.local
npm run dev:local # http://localhost:3001
Comptes de test (mot de passe password123) : [email protected] (administrateur) et
[email protected]. Studio Supabase : http://127.0.0.1:54323.
Les recettes réelles viennent d'un export des données de la famille, qui n'est pas dans le
dépôt. Sans lui, la base locale démarre vide ; pour avoir des recettes de test, voir
« Données locales » dans DEVELOPER.md.
Ne lancez jamais npm run dev avec un fichier .env qui pointe sur la base de
production : utilisez npm run dev:local.
Vérifications courantes : npm run lint, npm run typecheck, npm test,
npm run test:e2e (base locale).
Documentation
