Aller au contenu principal

Documentation de Dépannage

Index des guides de résolution de problèmes pour MyElectricalData.

📚 Guides Disponibles​

Cache & Persistance​

Synchronisation Fournisseur PDL - staleTime​

Problème: Le fournisseur sélectionné n'apparaît pas sans refresh manuel Concerne: /consumption_euro, /dashboard, /simulator Solution: Ajouter staleTime: 30 * 1000 aux queries ['pdls'] Statut: ✅ Résolu

React Query Persist avec Queries Read-Only​

Problème: Les données ne persistent pas après un refresh de page Concerne: consumptionDetail, productionDetail Solution: Approche hybride avec useQuery + useState + subscription Statut: ✅ Résolu

Debug : Cache Vide Après Récupération​

Problème: Le bouton "Récupérer" semble fonctionner mais le cache reste vide Concerne: Toutes les données (consumption, production, power) Solution: Guide de débogage étape par étape Statut: 📋 Guide de diagnostic

Simulateur​

Calcul de Consommation du Simulateur​

Problème: Comprendre les calculs de consommation HC/HP Concerne: Page /simulator Statut: 📖 Documentation

Correction des Doublons dans le Simulateur​

Problème: Offres dupliquées affichées Concerne: Page /simulator Statut: 🔧 Fix appliqué

Détection des Doublons​

Problème: Identifier les offres en double dans la base de données Concerne: Admin /admin/offers Statut: 🔍 Outil de diagnostic

🔍 Trouver Rapidement​

Par Symptôme​

SymptômeGuide
Fournisseur n'apparaît pas sans refreshSync Fournisseur staleTime
Données disparaissent au refreshReact Query Persist
Cache vide malgré fetch réussiDebug Cache Vide
Offres dupliquéesSimulateur Doublons
Calculs HC/HP incorrectsCalcul Consommation

Par Page​

PageProblèmes ConnusGuides
/consumption_euroSync fournisseur, persistanceSync staleTime, React Query Persist
/consumptionPersistance donnéesReact Query Persist
/productionPersistance donnéesReact Query Persist
/simulatorSync fournisseur, doublons, calculsSync staleTime, Doublons, Calculs
/dashboardSync fournisseurSync staleTime
/admin/offersDétection doublonsDétection

Par Technologie​

TechnologieGuides
React QuerystaleTime Sync, Persist Read-Only, Cache Vide
Zustand-
React Query PersistQueries Read-Only

🆘 Besoin d'Aide ?​

Si votre problème n'est pas listé ici :

  1. Vérifier la console navigateur (F12 → Console)
  2. Vérifier les logs backend (make backend-logs)
  3. Consulter la documentation principale (/docs/)
  4. Créer une issue GitHub avec logs et reproduction du problème

🔧 Outils de Diagnostic​

  • React Query DevTools : Panel en bas à droite (en dev)
  • Console : F12 → Console (logs applicatifs)
  • Network : F12 → Network (requêtes API)
  • Application : F12 → Application → Local Storage

Application​

  • /diagnostic : Page de diagnostic du cache
  • /admin/offers : Vérification des offres (admin uniquement)

Backend​

# Logs en temps réel
make backend-logs

# Status des containers
make ps

# Shell PostgreSQL
make db-shell

📝 Contribuer​

Pour ajouter un nouveau guide de dépannage :

  1. Créer un fichier .md dans ce dossier
  2. Utiliser la structure : 
    # Titre du Problème

    ## 🎯 Problème
    Description claire

    ## 🔍 Cause Root
    Explication technique

    ## ✅ Solution
    Code et étapes

    ## 🧪 Validation
    Comment vérifier que c'est corrigé
  3. Ajouter une entrée dans ce README
  4. Commit avec message descriptif

📚 Documentation Liée​