Si Nutri AI refuse de démarrer ou se ferme immédiatement après le lancement, ce guide vous aide à identifier et résoudre le problème rapidement.

🔍 Diagnostic rapide

1. Symptômes précis :
   • L’app ne s’ouvre pas du tout (écran noir puis retour)
   • Écran de démarrage puis crash immédiat
   • Message d’erreur spécifique avant fermeture
   • Freeze sur l’écran de démarrage
   • Redémarrage de l’appareil après tentative
2. Informations à noter :
   • Modèle exact de votre appareil
   • Version du système d’exploitation
   • Version de Nutri AI (si visible)
   • Message d’erreur exact (capture d’écran idéale)
   • Quand le problème a commencé
3. Test de base :
   • Lancer d’autres applications similaires
   • Tester avec/sans connexion internet
   • Essayer sur WiFi vs données mobiles
   • Tester à différents moments de la journée

🔄 Solutions de base (90% des cas)

1. Redémarrage simple de l’appareil :
   • iOS : Appuyer longuement sur bouton latéral + volume, glisser pour éteindre
   • Android : Appuyer longuement sur bouton power, sélectionner « Redémarrer »
   • Attendre 30 secondes après extinction avant rallumage
   • Ne pas simplement mettre en veille, vraiment redémarrer
2. Force close de l’application :
   • iOS : Switcher d’apps (balayage bas vers le haut), faire glisser Nutri AI vers le haut
   • Android : Paramètres → Applications → Nutri AI → Forcer l’arrêt
   • Sur Android récent : Appuyer long sur l’icône → (i) → Forcer l’arrêt
   • Attendre 10 secondes après fermeture avant relance
3. Vérification de la connexion internet :
   • Activer/désactiver le mode avion pendant 10 secondes
   • Changer de réseau (WiFi → données ou inversement)
   • Ouvrir un site web pour tester la connexion
   • Vérifier les restrictions réseau (proxy, firewall)
4. Libération d’espace de stockage :
   • iOS : Paramètres → Général → Stockage iPhone
   • Android : Paramètres → Stockage
   • Supprimer :
     1. Apps inutilisées
     2. Photos/vidéos en double
     3. Cache des apps sociales
     4. Téléchargements anciens
   • Objectif : Minimum 1 Go libre, idéal 2-3 Go

🔧 Solutions intermédiaires

1. Mise à jour de l’application :
   • iOS : App Store → Profil (icône) → faire défiler vers le bas
   • Android : Play Store → Mon profil → Gérer apps et appareil → Mises à jour disponibles
   • Si Nutri AI apparaît, mettre à jour
   • Si pas de mise à jour disponible, passer à l’étape suivante
2. Mise à jour du système d’exploitation :
   • iOS : Paramètres → Général → Mise à jour logicielle
   • Android : Paramètres → À propos du téléphone → Mise à jour système
   • Installer toutes les mises à jour disponibles
   • Redémarrer après installation
3. Vider le cache de l’application :
   • iOS : Paramètres → Général → Stockage iPhone → Nutri AI → Supprimer l’app (conserve les données)
   • Android : Paramètres → Applications → Nutri AI → Stockage → Vider le cache
   • Android alternative : Settings → Storage → Other apps → Nutri AI → Clear cache
   • Ne PAS vider les données (sauf en dernier recours)
4. Réinstallation de l’application :
   • D’abord : Exporter vos données si possible (via site web)
   • iOS : Appuyer long sur l’icône → Supprimer l’app → Confirmer
   • Android : Paramètres → Applications → Nutri AI → Désinstaller
   • Télécharger à nouveau depuis l’App Store/Play Store
   • Ne pas restaurer depuis sauvegarde si problème récurrent

⚡ Solutions avancées

1. Mode sans échec (Android) :
   • Éteindre l’appareil complètement
   • Redémarrer en appuyant sur Power + Volume bas
   • Maintenir jusqu’à apparition du logo puis relâcher
   • « Mode sans échec » apparaît en bas de l’écran
   • Tester Nutri AI dans ce mode
   • Redémarrer normalement pour quitter le mode
2. Réinitialisation des paramètres réseau :
   • iOS : Paramètres → Général → Transfert ou réinitialisation → Réinitialiser → Réinitialiser les paramètres réseau
   • Android : Paramètres → Système → Réinitialisation → Réinitialiser les paramètres réseau
   • Cela supprime WiFi, Bluetooth, VPN sauvegardés
   • À réserver aux problèmes réseau persistants
3. Comptes et synchronisation (Android) :
   • Paramètres → Comptes → Google → Votre compte
   • Appuyer sur les 3 points → Supprimer le compte
   • Redémarrer l’appareil
   • Ajouter à nouveau le compte Google
4. Date et heure incorrectes :
   • iOS : Paramètres → Général → Date et heure
   • Android : Paramètres → Système → Date et heure
   • Activer « Définir automatiquement »
   • Vérifier le fuseau horaire correct

📱 Solutions spécifiques par plateforme

🔍 Problèmes liés au compte

• Compte corrompu :
  • Symptôme : App démarre mais crash à la connexion
  • Solution : Se déconnecter, utiliser version web pour vérifier le compte
  • Alternative : Créer un nouveau compte temporaire pour test
  • Support : Contacter avec l’email du compte problématique
• Données corrompues localement :
  • Symptôme : Crash seulement après connexion réussie
  • Solution : Vider données de l’app (attention : supprime tout local)
  • Précaution : Synchroniser d’abord avec le cloud si possible
  • Restauration : Reconnexion pour resynchroniser depuis le cloud
• Conflit avec données iCloud/Google Drive :
  • Symptôme : Problème après changement d’appareil ou restauration
  • Solution : Désactiver temporairement backup/sync pour Nutri AI
  • iOS : iCloud → Gager le stockage → Sauvegardes → Désactiver Nutri AI
  • Android : Drive → Paramètres → Sauvegarde → Désactiver backup app

🌐 Problèmes liés au réseau

• Firewall/Proxy d’entreprise :
  • Symptôme : Fonctionne sur données mais pas sur WiFi bureau
  • Solution : Contacter service IT pour autoriser Nutri AI
  • URLs à autoriser : api.nutriai.io, cdn.nutriai.io, *.nutriai.io
  • Ports : 443 (HTTPS), éventuellement 80 (HTTP redirect)
• DNS problématique :
  • Symptôme : App démarre mais ne se connecte pas au serveur
  • Solution : Changer de serveur DNS (1.1.1.1 Cloudflare ou 8.8.8.8 Google)
  • iOS : WiFi → (i) → DNS → Manuel → Ajouter serveurs
  • Android : Paramètres réseau avancés → DNS privé → dns.google
• VPN actif :
  • Symptôme : Problème seulement avec VPN activé
  • Solution : Désactiver VPN temporairement pour test
  • Alternative : Configurer exclusion pour Nutri AI dans le VPN
  • Exception : Ajouter *.nutriai.io à la liste d’exclusion

📞 Contact avec le support technique

1. Informations à préparer :
   • Modèle exact de l’appareil
   • Version exacte du système d’exploitation
   • Version de Nutri AI (si connue)
   • Description précise du problème
   • Ce que vous avez déjà essayé
   • Capture d’écran de toute erreur
2. Logs techniques (si possible) :
   • iOS : Développeur → Console (si activé)
   • Android : Developer options → Bug report
   • Logcat : Via ADB si techniquement compétent
   • Capture vidéo du problème
3. Canaux de contact :
   • Email : [email protected]
   • Site web : nutriai.app/contact
   • Twitter : @NutriAI_Support
   • Forum communautaire : community.nutriai.io
4. Temps de réponse :
   • Prioritaire (Pro) : < 2 heures
   • Premium : < 24 heures
   • Essentiel : 48-72 heures
   • Urgences critiques : 24/7 pour problèmes bloquants

🔄 Solutions de contournement temporaires

1. Utiliser la version web : nutriai.app fonctionnalités complètes
2. Appareil alternatif : Tester sur tablette ou téléphone de secours
3. Compte invité : Créer un compte temporaire pour usage urgent
4. Version précédente : Installer APK ancienne version (Android seulement, déconseillé)

🔮 Prévention des problèmes futurs

• Mises à jour automatiques : Activées par défaut
• Sauvegardes régulières : Export mensuel de vos données
• Stockage surveillé : Garder minimum 1 Go libre
• Appareil maintenu : OS à jour, apps obsolètes supprimées
• Rapports de bugs : Contribuer à l’amélioration en signalant les problèmes

Si Nutri AI a des difficultés à reconnaître vos aliments ou estime mal les quantités, ce guide vous explique comment obtenir des analyses plus précises et fiables.

🔍 Diagnostic du problème

• Types de problèmes :
  • Aliments non reconnus (confiance < 20%)
  • Aliments mal identifiés (carotte → patate douce)
  • Quantités estimées incorrectement (±50% d’erreur)
  • Plats composés partiellement reconnus
  • Analyse lente (>10 secondes)
• Facteurs influençant la reconnaissance :
  • Qualité de la photo (lumière, netteté, angle)
  • Complexité du plat (nombre d’ingrédients, mélange)
  • Originalité de la préparation (recette maison unique)
  • Aliments similaires visuellement (riz vs quinoa cuit)
  • Présentation (assiette décorative vs mélangé)
• Test de base :
  • Prendre une photo d’un aliment simple (banane, pomme)
  • Prendre la même photo dans différentes conditions
  • Comparer les résultats
  • Identifier le facteur problématique principal

📸 Optimisation des conditions de prise de vue

🍽️ Préparation optimale des aliments

1. Assiette adaptée :
   • Couleur : Blanche ou très claire idéalement
   • Taille : Standard (24-28 cm de diamètre)
   • Forme : Ronde de préférence (plus facile à détecter)
   • Propreté : Bord propre, pas de taches ou restes
2. Disposition des aliments :
   • Séparation : Aliments bien distincts, pas superposés
   • Espace : Légère marge entre les différents éléments
   • Visibilité : Tous les ingrédients doivent être visibles
   • Organisation : Logique (protéine, féculent, légumes)
3. Présentation spécifique :
   • Plats mélangés (salades, riz sauté) : Montrer avant mélange
   • Sauces : À côté ou visiblement sur l’aliment
   • Boissons : Verre transparent, sur fond contrasté
   • Snacks : Éparpillés pour montrer quantité totale
4. Éviter les pièges courants :
   • Reflets : Sur sauces, couverts, assiettes brillantes
   • Fumée/vapeur : Attendre que le plat refroidisse légèrement
   • Condiments : Très petits, souvent mal reconnus
   • Aliments coupés identiquement : Difficile à distinguer

⚙️ Utilisation avancée de l’application

1. Mode multi-photos :
   • Prendre 2-3 photos sous angles légèrement différents
   • L’IA combine les informations pour meilleure précision
   • Particulièrement utile pour plats en hauteur (sandwichs, burgers)
   • Activer dans paramètres SnapTrack
2. Correction manuelle proactive :
   • Avant validation, vérifier chaque aliment détecté
   • Corriger immédiatement les erreurs d’identification
   • Ajuster les quantités estimées si nécessaire
   • Ajouter les aliments manquants via « + Ajouter aliment »
3. Utilisation des références :
   • Placer un objet de taille connue dans le cadre
   • Objets recommandés : Carte bancaire, pièce de monnaie, clé
   • Éviter les objets trop variables (téléphone de modèle inconnu)
   • L’app apprend progressivement vos références habituelles
4. Mode expert :
   • Activer dans paramètres → SnapTrack → Mode expert
   • Contrôle manuel de la mise au point et exposition
   • Grille de composition pour meilleur cadrage
   • Indicateurs de niveau et d’angle

🔄 Amélioration continue par l’apprentissage

1. Feedback systématique :
   • Après chaque analyse, noter la précision (1-5 étoiles)
   • Corriger les erreurs : C’est ainsi que l’IA apprend
   • Ajouter des détails : « Poulet grillé » vs « Poulet pané »
   • Signaler les aliments fréquemment mal reconnus
2. Création de profils alimentaires personnels :
   • Dans « Mes aliments », créer des entrées personnalisées
   • Ajouter photos sous différents angles
   • Définir des noms personnels (« Recette de maman »)
   • Partager avec la communauté (optionnel)
3. Calibration régulière :
   • Analyser le même repas plusieurs fois pour calibration
   • Utiliser des aliments étalons (pomme, banane, œuf)
   • Comparer vos estimations avec celles de l’IA
   • Améliorer votre propre œil pour les portions
4. Participation à la base de données :
   • Contribuer en ajoutant de nouveaux aliments
   • Corriger les informations nutritionnelles erronées
   • Ajouter des variantes régionales
   • Traduire les noms d’aliments

⚠️ Cas particuliers et solutions

🔧 Résolution des problèmes techniques

1. Problèmes de caméra :
   • Nettoyer l’objectif de la caméra
   • Tester avec une autre app photo
   • Redémarrer l’appareil
   • Vérifier les permissions caméra
2. Problèmes de connexion :
   • L’analyse se fait localement, pas besoin de connexion forte
   • Mais la reconnaissance avancée nécessite internet
   • Tester en WiFi vs données mobiles
   • Vérifier les restrictions réseau
3. App obsolète :
   • Mettre à jour vers la dernière version
   • Les modèles IA s’améliorent avec chaque version
   • Désinstaller et réinstaller si problème persiste
4. Compatibility appareil :
   • Vérifier les specs minimales : iOS 14+/Android 8+
   • Caméra : Minimum 8MP recommandé
   • RAM : 2Go minimum, 4Go recommandé
   • Processeur : Supporte l’accélération IA (Apple Neural Engine, etc.)

📊 Mesure et suivi de la précision

🎓 Programme d’amélioration continue

📞 Quand contacter le support

Si Nutri AI est lent, laggue, se fige ou plante régulièrement, ce guide vous aide à identifier les causes et appliquer les solutions appropriées pour une expérience fluide.

🔍 Diagnostic des symptômes

⚡ Solutions immédiates pour la lenteur

1. Fermer les autres applications :
   • iOS : Switcher d’apps, fermer toutes les apps inutilisées
   • Android : Menu récent, fermer toutes les apps
   • Particulièrement important : Jeux, navigateur, apps sociales
   • Libère de la RAM immédiatement
2. Redémarrer l’appareil :
   • Pas seulement mettre en veille, vraiment redémarrer
   • Élimine les processus zombies
   • Nettoie la mémoire cache système
   • Résout souvent les problèmes temporaires
3. Vérifier la connexion internet :
   • Tester la vitesse : fast.com ou speedtest.net
   • Latence idéale : < 100ms
   • Bande passante minimale : 5 Mbps pour Nutri AI
   • Changer de réseau si problème constaté
4. Mode économie de données (si activé) :
   • iOS : Paramètres → Données cellulaires → Options → Mode économie de données
   • Android : Paramètres → Réseau et Internet → Économiseur de données
   • Désactiver temporairement pour Nutri AI
   • L’app peut ralentir en mode économie

🧹 Nettoyage et optimisation

1. Vider le cache de Nutri AI :
   • iOS : Paramètres → Général → Stockage iPhone → Nutri AI → Supprimer l’app
   • Android : Paramètres → Applications → Nutri AI → Stockage → Vider le cache
   • Attention : Sur iOS, « Supprimer l’app » conserve les données
   • Effet : Supprime les fichiers temporaires, souvent plusieurs centaines de Mo
2. Libérer de l’espace de stockage :
   • Cible minimum : 1 Go libre, idéal 3 Go
   • Supprimer :
     1. Photos/vidéos en double ou similaires
     2. Apps inutilisées (> 6 mois sans utilisation)
     3. Téléchargements anciens
     4. Fichiers volumineux inutiles
   • Utiliser l’outil de nettoyage intégré à l’appareil
3. Désactiver les fonctionnalités lourdes :
   • Dans Nutri AI : Paramètres → Performance
   • Options :
     1. Préchargement moins agressif
     2. Animations réduites
     3. Images en qualité standard (pas haute définition)
     4. Sync en arrière-plan limitée
   • Gagne souvent 20-30% de performance
4. Mettre à jour l’application :
   • Vérifier les mises à jour disponibles
   • Les nouvelles versions contiennent souvent des optimisations
   • Lire les notes de version pour les améliorations de performance
   • Si problème apparu après mise à jour, contacter le support

🔧 Solutions avancées pour plantages

1. Mode sans échec (Android) :
   • Éteindre l’appareil complètement
   • Redémarrer en maintenant Power + Volume bas
   • Relâcher quand le logo apparaît
   • Tester Nutri AI en mode sans échec
   • Si ça marche : Une app tierce cause le problème
2. Réinitialiser les données de l’app (dernier recours) :
   • Android : Paramètres → Applications → Nutri AI → Stockage → Effacer les données
   • iOS : Désinstaller puis réinstaller l’app
   • Attention : Supprime toutes les données locales !
   • Avant : Synchroniser avec le cloud, faire un export
3. Désactiver les services de localisation :
   • iOS : Paramètres → Confidentialité → Service de localisation → Nutri AI
   • Android : Paramètres → Applications → Nutri AI → Permissions → Localisation
   • Désactiver temporairement pour test
   • Certains bugs GPS peuvent faire planter l’app
4. Vérifier les permissions corrompues :
   • iOS : Réinstaller l’app complètement
   • Android : Paramètres → Applications → Nutri AI → Permissions → Tout désactiver puis réactiver
   • Problème connu avec Android 11+ et certaines permissions

📱 Solutions spécifiques par plateforme

💾 Gestion des données et stockage

1. Données locales volumineuses :
   • Vérifier la taille des données Nutri AI
   • iOS : Paramètres → Général → Stockage iPhone → Nutri AI
   • Android : Paramètres → Applications → Nutri AI → Stockage
   • Taille normale : 200-500 Mo, >1 Go peut poser problème
2. Nettoyage des données inutiles :
   • Dans Nutri AI : Paramètres → Stockage → Nettoyer
   • Options :
     1. Photos analysées compressées (garde les données)
     2. Cache des recettes
     3. Logs techniques anciens
     4. Données temporaires d’analyse
   • Peut libérer plusieurs centaines de Mo
3. Archivage des données anciennes :
   • Exporter les données de plus de 6 mois
   • Les supprimer de l’app (resteront dans l’export)
   • Réduit la base de données locale
   • Améliore les performances de recherche/filtrage
4. Mode hors ligne limité :
   • Paramètres → Données → Mode hors ligne
   • Limiter la quantité de données stockées hors ligne
   • Garder seulement les 30 derniers jours
   • Réduit considérablement l’utilisation du stockage

🌐 Problèmes liés au réseau et serveurs

1. Vérifier le statut des serveurs Nutri AI :
   • Site : status.nutriai.io
   • Twitter : @NutriAIStatus
   • Si problème côté serveur : Attendre la résolution
   • App peut être lente ou planter si serveurs surchargés
2. Problèmes DNS/VPN/Proxy :
   • Désactiver temporairement VPN/Proxy
   • Changer de serveur DNS (1.1.1.1 ou 8.8.8.8)
   • Vérifier les règles firewall (surtout en entreprise)
   • Test avec/without réseau cellulaire
3. Limitations de débit :
   • Vérifier avec votre opérateur si limitation active
   • Certains forfaits limitent après un certain seuil
   • App peut être lente en données limitées
4. Conflits avec autres apps réseau :
   • Apps de sécurité (antivirus, firewall)
   • Optimiseurs réseau douteux
   • Apps modifiant les paramètres réseau
   • Désinstaller temporairement pour test

🔄 Gestion des mises à jour et versions

1. Problème après mise à jour :
   • Si problème apparu après mise à jour Nutri AI
   • Télécharger la version précédente (Android seulement, APK)
   • Contacter le support avec numéro de version problématique
   • Attendre le correctif (généralement rapide)
2. Problème après mise à jour OS :
   • Attendre une mise à jour de Nutri AI compatible
   • Vérifier les forums communautaires pour solutions temporaires
   • Réduire au minimum les fonctionnalités utilisées
   • Utiliser la version web temporairement
3. Version bêta/test :
   • Si vous participez aux programmes bêta
   • Retourner à la version stable
   • Signaler les bugs rencontrés
   • Les versions bêta peuvent être instables

📊 Monitoring et diagnostic

1. Outils de diagnostic intégrés :
   • Dans Nutri AI : Paramètres → Aide → Diagnostic
   • Informations affichées :
     1. Utilisation mémoire
     2. Utilisation CPU
     3. Taille base de données
     4. Statut réseau
     5. Logs d’erreurs récentes
2. Crash reports automatiques :
   • iOS : Paramètres → Confidentialité → Analytique et améliorations → Partager l’analyse iPhone
   • Android : Automatique via Play Store
   • Ces rapports nous aident à identifier et corriger les bugs
3. Test sur autre appareil :
   • Tester sur un autre téléphone/tablette
   • Si problème persiste : Problème lié au compte
   • Si problème disparaît : Problème lié à l’appareil

🚨 Situations nécessitant un contact support

🛡️ Prévention des problèmes futurs

🔧 Solutions de contournement temporaires