Convertomix

💡 Aperçu du Projet

Convertomix est une application web innovante qui utilise l'intelligence artificielle pour transformer n'importe quelle recette de cuisine traditionnelle trouvée sur le web en instructions détaillées et optimisées pour les robots culinaires Thermomix® (TM5, TM6, TM7). Fini les adaptations manuelles fastidieuses, Convertomix vous permet de cuisiner vos plats préférés avec votre Thermomix® en toute simplicité.

L'application offre une expérience utilisateur fluide, de la conversion instantanée à la sauvegarde de recettes personnalisées, en passant par un mode de cuisson pas-à-pas interactif et l'exportation en PDF.

Thermomix® est une marque déposée de Vorwerk. Convertomix n'est pas affilié à Vorwerk.

✨ Fonctionnalités

• Conversion IA Avancée : Transforme automatiquement les recettes traditionnelles en étapes Thermomix® précises.
• Instructions Détaillées : Génère des instructions étape par étape avec temps, températures, vitesses et accessoires spécifiques au Thermomix®.
• Extraction Intelligente : Scrape le contenu des recettes à partir de n'importe quelle URL de site de cuisine.
• Mode Thermomix® Interactif : Un mode de cuisson pas-à-pas pour suivre facilement les instructions sur votre appareil.
• Sauvegarde Cloud : Enregistrez vos recettes converties dans votre bibliothèque personnelle, accessible depuis n'importe où.
• Export PDF : Téléchargez vos recettes converties au format PDF pour les imprimer ou les partager.
• Gestion de Profil : Gérez vos informations personnelles et suivez vos statistiques de conversion.
• Interface Responsive : Optimisé pour une utilisation sur mobile et desktop.

🚀 Pile Technologique

Convertomix est construit avec les technologies modernes suivantes :

• Frontend :
  • React & Next.js : Pour une interface utilisateur dynamique et des capacités de rendu côté serveur.
  • TypeScript : Pour une meilleure qualité de code et une expérience de développement améliorée.
  • Tailwind CSS : Framework CSS utilitaire pour un stylisme rapide et réactif.
  • shadcn/ui & Radix UI : Composants UI accessibles et personnalisables.
  • Lucide React : Bibliothèque d'icônes SVG.
• Backend / Services :
  • Supabase : Backend-as-a-service pour l'authentification utilisateur et la base de données PostgreSQL.
  • AI SDK (@ai-sdk/openai) : Intégration avec les modèles OpenAI pour la logique de conversion de recettes par IA.
  • Cheerio : Utilisé côté serveur pour le web scraping et l'extraction de contenu de recettes.
• Utilitaires :
  • jsPDF : Pour la génération de documents PDF côté client.
  • Next.js API Routes : Pour les endpoints API côté serveur (ex: conversion de recettes).

⚙️ Démarrage Rapide

Suivez ces étapes pour configurer et exécuter Convertomix en local.

Prérequis

Assurez-vous d'avoir les éléments suivants installés :

• Node.js (version 18 ou supérieure)
• npm ou Yarn
• Git
• Un compte Supabase et un projet configuré (voir la section "Configuration de la Base de Données")

Installation

1. Cloner le dépôt :

   git clone https://github.com/thomasgermain93-projects/v0-thermomix-recipe-converter.git
   cd v0-thermomix-recipe-converter

2. Installer les dépendances :

   npm install
   # ou
   yarn install

Variables d'Environnement

Créez un fichier .env.local à la racine du projet et ajoutez-y vos variables d'environnement Supabase :

NEXT_PUBLIC_SUPABASE_URL="VOTRE_URL_SUPABASE"
NEXT_PUBLIC_SUPABASE_ANON_KEY="VOTRE_CLE_ANON_SUPABASE"
# SUPABASE_SERVICE_ROLE_KEY est utilisée côté serveur, assurez-vous qu'elle est configurée dans votre environnement de déploiement

Vous trouverez ces clés dans votre tableau de bord Supabase, sous Project Settings > API.

Configuration de la Base de Données Supabase

Convertomix utilise Supabase pour l'authentification et le stockage des recettes. Vous devez configurer votre base de données en exécutant le script SQL fourni.

1. Accédez à votre projet Supabase : Connectez-vous à votre tableau de bord Supabase.
2. Ouvrez l'éditeur SQL : Allez dans SQL Editor depuis le menu de gauche.
3. Exécutez le script de configuration : Copiez le contenu du fichier scripts/setup-database.sql et collez-le dans l'éditeur SQL, puis cliquez sur Run. Ce script créera les tables nécessaires (recipes, user_profiles), les fonctions et les politiques de sécurité (RLS).
4. Vérifiez la configuration : Vous pouvez utiliser le script scripts/test-database.sql pour vérifier que tout est correctement configuré.

Pour plus de détails, consultez le fichier SETUP_DATABASE.md.

Configuration des Emails Supabase

Pour que l'authentification par email (confirmation, réinitialisation de mot de passe) fonctionne, configurez les modèles d'email et les URLs de redirection dans votre tableau de bord Supabase.

Consultez le fichier SUPABASE_EMAIL_SETUP.md pour les instructions détaillées.

Exécuter l'Application

Une fois les dépendances installées et les variables d'environnement configurées, vous pouvez lancer l'application en mode développement :

npm run dev
# ou
yarn dev

L'application sera disponible à l'adresse http://localhost:3000.

☁️ Déploiement

Ce projet est conçu pour être déployé facilement sur Vercel. Le dépôt est automatiquement synchronisé avec vos déploiements sur v0.app.

1. Connectez votre dépôt GitHub à Vercel.
2. Configurez les variables d'environnement (NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY) dans les paramètres de votre projet Vercel.
3. Vercel construira et déploiera automatiquement votre application à chaque push sur la branche principale.

🤝 Contributions

Les contributions sont les bienvenues ! Si vous souhaitez améliorer Convertomix, veuillez suivre ces étapes :

1. Fork le dépôt.
2. Créez une nouvelle branche (git checkout -b feature/ma-nouvelle-fonctionnalite).
3. Effectuez vos modifications et assurez-vous que le code respecte les conventions existantes.
4. Testez vos changements.
5. Commitez vos modifications (git commit -am 'feat: Ajout de ma nouvelle fonctionnalité').
6. Pushez votre branche (git push origin feature/ma-nouvelle-fonctionnalite).
7. Ouvrez une Pull Request.

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.