📦 Gestion des Comptes (Clients)
Apprenez à gérer les comptes clients (entreprises, installateurs, propriétaires) et à configurer leurs accès API aux fournisseurs d'onduleurs.
Accès Administrateur
Qu'est-ce qu'un Client ?
Dans PVReactive, un Client représente une entité juridique ou organisationnelle qui possède ou gère des installations photovoltaïques :
Installateur
Entreprise qui installe et maintient des installations solaires pour plusieurs propriétaires
Propriétaire
Particulier ou entreprise possédant une ou plusieurs installations solaires
Exploitant
Société gérant un parc d'installations photovoltaïques
Accéder à la Gestion des Clients
- Cliquez sur "Comptes" dans le menu latéral gauche
- La liste de tous les clients s'affiche
Liste des Clients
Informations Affichées
| Colonne | Description |
|---|---|
| Nom | Nom du client (entreprise ou personne) |
| Adresse email de contact | |
| Téléphone | Numéro de téléphone |
| Installations | Nombre d'installations solaires liées |
| APIs | Fournisseurs configurés (FusionSolar, SolarEdge, Sungrow) |
| Actions | Boutons Modifier / Supprimer |
Créer un Nouveau Client
Cliquer sur 'Nouveau Client'
En haut à droite de la liste, cliquez sur le bouton "+ Nouveau Client".
Remplir les informations générales
Nom *
Nom du client (ex: "Solar Energie SARL", "Jean Dupont")
Email *
Email de contact du client
Téléphone
Numéro de téléphone (optionnel)
Configurer les accès API
Cette étape est cruciale : vous devez configurer les accès aux APIs des fournisseurs d'onduleurs pour que PVReactive puisse récupérer les données des installations.
Fournisseurs Supportés
FusionSolar (Huawei)
Deux méthodes d'authentification au choix :
- Credentials : User + Password 50 appels/h
- OAuth : Processus d'autorisation sécurisé 100 appels/h
SolarEdge
Authentification par clé API :
- API Key : Clé fournie par SolarEdge
- Site ID : ID du site (optionnel si plusieurs sites)
Sungrow
OAuth uniquement (obligatoire) :
- Application ID : Fourni par Sungrow
- Appkey : Clé secrète fournie par Sungrow
- Autorisation : Processus OAuth sur iSolarCloud
Configuration Recommandée
Sauvegarder
Cliquez sur "Enregistrer".
Client créé ! Les installations seront synchronisées automatiquement dans les minutes qui suivent.
Configurer FusionSolar
Méthode 1 : Credentials (User/Password)
Obtenir les identifiants
Récupérez auprès du client :
- Nom d'utilisateur : Login FusionSolar
- Mot de passe : Password FusionSolar
Saisir dans PVReactive
Dans le formulaire client, section FusionSolar :
- Sélectionnez "Credentials"
- Remplissez User et Password
- Sauvegardez
Méthode 2 : OAuth (Recommandé >50 installations)
Sélectionner OAuth
Dans le formulaire, section FusionSolar, sélectionnez "OAuth".
Autoriser l'accès
Cliquez sur "Authorize OAuth".
Vous serez redirigé vers FusionSolar pour autoriser PVReactive.
Processus d'Autorisation
Configurer SolarEdge
Obtenir l'API Key
Le client doit générer une API Key depuis son compte SolarEdge :
- Se connecter sur monitoring.solaredge.com
- Aller dans Admin > API Access
- Créer une nouvelle API Key
- Copier la clé générée
Saisir dans PVReactive
Dans le formulaire client, section SolarEdge :
- Coller l'API Key
- Saisir le Site ID (si installation unique)
- Sauvegarder
Site ID optionnel
Configurer Sungrow
OAuth Obligatoire
Obtenir Application ID et Appkey
Le client doit créer une application OAuth sur iSolarCloud :
- Se connecter sur gateway.isolarcloud.com
- Section Developer
- Créer une application
- Noter l'Application ID et l'Appkey
Saisir et autoriser
Dans PVReactive, section Sungrow :
- Remplissez Application ID et Appkey
- Sauvegardez le client
- Cliquez sur "Start Authorization"
- Suivez le processus d'autorisation OAuth
Guide Complet OAuth Sungrow
Modifier un Client
Pour modifier un client existant :
- Cliquez sur "Modifier" ()
- Modifiez les informations souhaitées
- Sauvegardez
Modification des Credentials API
Tester la Configuration API
Vous pouvez vérifier que les credentials API sont corrects avant de sauvegarder :
Test FusionSolar
Cliquez sur "Tester Credentials" ou "Test OAuth".
✅ Succès : "Connexion réussie, X installations trouvées"
❌ Échec : Message d'erreur détaillé
Test SolarEdge
Cliquez sur "Tester API Key".
✅ Succès : "API Key valide, X sites trouvés"
❌ Échec : "API Key invalide" ou erreur réseau
Test Sungrow
Cliquez sur "Test OAuth".
✅ Succès : "OAuth valide, X installations trouvées"
❌ Échec : "Token expiré" ou "Application ID invalide"
Supprimer un Client
Action Critique
- Installations
- Données KPI historiques
- Alarmes
- Interventions
Pour supprimer un client :
- Cliquez sur "Supprimer" () rouge
- Tapez le nom du client pour confirmer
- Validez la suppression
Synchronisation des Installations
Après création ou modification d'un client, PVReactive synchronise automatiquement :
Processus de Synchronisation
Liste des installations depuis l'API du fournisseur (2-5 min)
Onduleurs, batteries, compteurs (5-10 min)
KPI des 30 derniers jours (15-30 min)
Historique des alarmes (5-10 min)
Durée de Synchronisation
Vue Portfolio d'un Client
Pour voir toutes les installations d'un client, cliquez sur le nom du client dans la liste.
Vous accédez alors à sa vue portfolio détaillée (/admin/client/{id}).
Informations Affichées
En-tête du Portfolio
- Nom du client avec coordonnées
- Nombre total d'installations
- Ratio moyen production/puissance crête (indicateur de santé global)
- Fournisseurs API configurés avec statut
Vues d'Affichage des Installations
Comme sur le dashboard global, vous pouvez basculer entre deux vues :
Vue Grille
Affichage en cartes avec graphiques de production, Performance Ratio, et statut visuel. Idéale pour avoir une vue d'ensemble rapide.
Vue Liste
Tableau détaillé avec toutes les données en colonnes. Pratique pour comparer rapidement plusieurs installations.
Informations par Installation
Pour chaque installation du portfolio, vous visualisez :
| Donnée | Description |
|---|---|
| Nom Installation | Nom de l'installation (provenant du fournisseur) |
| Statut | Badge coloré : Vert (Normal), Orange (Attention), Rouge (Défaillant) |
| Performance Ratio | PR (%) calculé sur les dernières 24h avec code couleur |
| Production Actuelle | Puissance instantanée (kW) si disponible |
| Graphique Production | Histogramme des dernières 24h (réel vs théorique) |
| Alarmes | Nombre d'alarmes actives (si > 0) |
| Actions | Boutons : Voir détails, Exclure/Inclure |
Performance Ratio
Statistiques Globales du Client
En haut du portfolio, des indicateurs agrégés donnent une vision de la santé du parc :
- Nombre total d'installations
- Puissance totale installée (somme des capacités)
- Production totale actuelle (somme des productions instantanées)
- Ratio moyen production/puissance (indicateur de sous-dimensionnement ou sur-dimensionnement)
- Nombre d'installations avec alarmes
Actions sur les Installations
Depuis le portfolio client, vous pouvez :
Accéder à la fiche complète de l'installation avec historique, graphiques avancés, appareils, etc.
Retirer temporairement une installation des calculs globaux (utile pour maintenance ou travaux)
Les graphiques montrent immédiatement les installations sous-performantes
Navigation Rapide
Bonnes Pratiques
Un client = Une entité juridique
Créez un client par entreprise ou propriétaire distinct. Ne mélangez pas les installations de plusieurs entités dans un même client.
Credentials dédiés
Utilisez des comptes API dédiés à PVReactive. N'utilisez pas les comptes personnels des clients (risque de changement de mot de passe).
Tester avant de sauvegarder
Utilisez toujours les boutons "Tester" pour vérifier que les credentials fonctionnent avant de sauvegarder le client.
OAuth pour grands parcs
Pour FusionSolar avec >50 installations, privilégiez OAuth pour éviter les limitations de l'API (50 appels/h en credentials vs 100 en OAuth).
Questions Fréquentes
Puis-je configurer plusieurs fournisseurs pour un même client ?
Oui, un client peut avoir des installations FusionSolar, SolarEdge ET Sungrow. Configurez tous les fournisseurs nécessaires dans le même formulaire client.
Que faire si les installations ne s'affichent pas après création ?
Attendez 5-10 minutes pour la première synchronisation. Si rien n'apparaît :
1. Vérifiez les credentials avec le bouton "Tester"
2. Consultez les logs (si admin niveau 0)
3. Réessayez la synchronisation
Puis-je changer de méthode d'authentification (credentials → OAuth) ?
Oui, pour FusionSolar. Modifiez le client, changez le type, configurez OAuth. Les données historiques sont conservées. Pour Sungrow, OAuth est obligatoire dès le départ.
Les données sont-elles partagées entre clients ?
Non, isolation stricte. Chaque client ne voit que ses propres installations. C'est l'architecture multi-tenant de PVReactive.