🏢 Gestion des Comptes

Chaque compte (client) regroupe un portefeuille de stations photovoltaïques, ses utilisateurs, ses comptes API (provider accounts), ses tags et ses paramètres de facturation.

Structure d'un compte

Un compte sur PVReactive contient :

Informations légales — raison sociale, SIREN/SIRET, adresse de facturation, email de facturation
Stations — toutes les installations photovoltaïques rattachées
Utilisateurs — comptes humains avec accès au portail (Propriétaire, Administrateur, Technicien, Viewer)
Provider Accounts — comptes d'accès aux APIs constructeurs (FusionSolar, SolarEdge, Sungrow, SMA)
Tags — étiquettes métier pour organiser les stations (CDM, maintenance, etc.)
Abonnement — informations Stripe (statut trial / actif, quota MWc, factures)

Isolation par compte

Toutes les données d'un compte sont strictement isolées des autres comptes. Un utilisateur n'a accès qu'aux données du compte auquel il est rattaché. L'isolation est garantie au niveau du backend.

Fiche d'un compte — Trois onglets

L'édition d'un compte se fait depuis /admin/client/{id}/edit. Trois onglets organisent les paramètres :

Onglet Configuration (par défaut)

Comptes API — Liste des Provider Accounts du compte (un par provider, ou plusieurs)
Bouton + Ajouter pour connecter un nouveau provider
Pour chaque compte API : statut de connexion (Connecté / Déconnecté / Non testé), badge serveur (EU/AP/US), bouton Test API

Référence : Provider Accounts.

Onglet Facturation

Informations légales — raison sociale, SIREN, adresse, email de facturation
Statut Stripe — Trial / Actif / Annulé / Retard de paiement
Quota MWc — Tranche d'abonnement actuelle (1, 5, 10, 26 MWc…)
Factures — Liste des factures émises avec lien PDF Pennylane
Compte offert — Toggle (réservé superadmin) pour exonérer le compte de facturation

Onglet Tags

Liste des tags définis pour ce compte avec couleur personnalisée et compteur de stations associées
Boutons d'édition / suppression
Bouton + New Tag pour en créer un nouveau

Référence : Tags.

Vue Accounts CRM (réservée superadmin)

Vue Accounts CRM avec liste des clients, statut essai/abonnement et indicateurs commerciaux — Vue interne Accounts — vision 360° des comptes pour le suivi commercial : essais, abonnements, usage, portefeuille MWc, dernière facture.

L'écran /admin/accounts (interne PVReactive) donne une vue agrégée de tous les comptes du SaaS pour le suivi commercial. Indicateurs synthétiques :

Total — Nombre de comptes
En essai — Comptes en trial
Fin essai < 3j — Trials qui expirent bientôt (priorité commerciale)
Essai expiré — Trials sortis sans conversion
Abo actif — Abonnements payants
Retard paiement — Comptes avec impayé
Annulé (churn) — Comptes ayant résilié

Création d'un compte

Deux modes de création :

Auto-inscription publique via /inscription — l'utilisateur saisit lui-même les informations légales et démarre un trial 14 jours
Création interne via la vue Accounts — le superadmin crée un compte, puis envoie une invitation par email à l'utilisateur principal

Vérification email obligatoire

Tout nouveau compte créé par auto-inscription doit valider son email avant d'accéder au dashboard. Un filtre anti-spam bloque les emails jetables et vérifie le DNS du domaine.

Annulation d'abonnement

Un compte peut annuler son abonnement à tout moment depuis l'onglet Facturation. L'annulation est programmée à la fin de la période en cours (pas immédiate), un email récap est envoyé au propriétaire avec confirmation du motif (champ libre pour analyse churn).

L'accès reste actif jusqu'à la fin de la période payée, puis le compte bascule en mode read-only (pas de nouvelles synchronisations).