📖 Guide d'utilisation

🚀 Démarrage & connexion

• Connexion : email + mot de passe sur /login. Si la double authentification est activée sur votre compte, saisissez aussi le code à 6 chiffres.
• Mot de passe oublié : lien « Mot de passe oublié ? » → vous recevez un lien de réinitialisation valable 1 heure.
• Tableau de bord : à la connexion, le dashboard résume l'activité (sites, contrats, demandes en attente, échéances, KPI énergie et maintenance, alertes).
• Navigation : le menu du haut donne accès à tous les modules. La cloche 🔔 affiche les alertes en cours.

🏢 Sites & parc d'équipements

• Créer un site : menu Sites → « Créer un site ». Renseignez nom, adresse, nombre de lots, puissance, type d'énergie, classe DPE, département, commune (choisissez-la dans la liste — Normandie + grandes villes pré-enregistrées — pour le DJU automatique ; un code INSEE peut aussi être saisi) et surface chauffée.
• Fiche site : regroupe équipements, contrats, carnet, interventions et documents du site.
• Équipements : chaque équipement a une fiche (marque, modèle, n° de série, puissance, périodicité de maintenance) et un QR code imprimable pour le scan mobile.
• Carte du parc : importez le plan du bâtiment (image ≤ 3 Mo) puis positionnez les équipements dessus (coordonnées en %).
• Suppression : supprimer un site efface aussi ses équipements, interventions, carnet et relevés (confirmation demandée).

🔧 Interventions & planning

• Vue Kanban : menu Interventions — colonnes par statut (à faire, assignée, en cours, en attente, terminée). Glissez-déposez une carte pour changer son statut.
• Recherche : champ de recherche par objet, site, technicien ou équipement.
• Créer : « Nouvelle intervention » — site, objet, priorité, technicien, équipement.
• Clôture : passer une intervention à « terminée » génère automatiquement une entrée de carnet et horodate la clôture (KPI délai de résolution).
• Planning : menu Planning — vue calendrier mensuelle, filtrable par site et par type (préventif / correctif / astreinte).

📱 Application mobile technicien

Accessible sur /m depuis un smartphone (installable en PWA).

• Mes interventions : la tournée du jour, avec bouton GPS « Y aller » et appel direct du syndic.
• Scan QR : scannez le QR d'un équipement pour ouvrir sa fiche.
• Compte rendu : mesures, pièces utilisées (quantité ajustable, décomptée du stock), photos avant/après, checklist, signature client tactile.
• Stock mobile : consultez et décomptez les pièces sur le terrain.
• Hors-ligne (sous-sol / chaufferie) : chargez votre tournée avant de descendre — les fiches restent consultables sans réseau. Un compte rendu validé sans connexion est enregistré et envoyé automatiquement dès la reconnexion (un bandeau indique les CR en attente). Rien n'est perdu.

🎫 Demandes & portail syndic

• Demandes : menu Demandes — tickets internes et tickets reçus du portail syndic, filtrables par statut et recherche.
• Portail syndic : chaque syndic dispose d'un lien à jeton (sans compte) pour déposer une demande d'intervention. Anti-spam intégré. Le lien + QR code se gèrent dans Config → Syndics.
• Portail occupant : chaque site peut avoir un lien public (fiche site → « Activer le portail occupant », avec QR à afficher dans le hall). Les résidents (copropriétaires ou locataires) voient l'état des équipements (pannes, interventions en cours) et signalent un problème — mobile ou ordinateur. Les doublons sont regroupés automatiquement : un même problème signalé par plusieurs occupants n'apparaît qu'une fois (compteur), à suivre dans Terrain → Signalements (statut + message de suivi visible des occupants).
• Conversion : un ticket se transforme en intervention pré-remplie (site, objet, priorité, description) en un clic.

📓 Carnet de chaufferie

• Registre chronologique des interventions par site (préventif, correctif, contrôles réglementaires), alimenté automatiquement à la clôture des interventions.
• Export imprimable (PDF via le navigateur) pour transmission au syndic ou en assemblée générale.

⚡ Énergie & performance

• Relevés : menu Énergie → « Nouveau relevé » (index, consommation kWh, coût €, et DJU de la période si connu).
• Relevés automatiques par la GTB : sur la fiche équipement (section Supervision GTB), cochez « Compteur d'énergie » sur le point qui porte l'index kWh cumulé. La plateforme crée alors un relevé par mois automatiquement (consommation = delta d'index, DJU auto) — badge 📡 GTB dans la liste. Le bouton « Relever via GTB » de la page Énergie force un relevé immédiat. Le coût (€) reste à compléter à la main si souhaité (✏️).
• DJU automatique : renseignez le code INSEE de la commune sur la fiche site — c'est tout. La plateforme géocode la commune et calcule le DJU chauffage de la période via Open-Meteo (gratuit, sans clé) à chaque relevé. Il alimente la signature énergétique. Diagnostic : Compte → Diagnostic DJU.
• Comparaison N / N-1 : évolution de la consommation à période équivalente (pas de biais de début d'année).
• Signature énergétique (kWh/DJU) : quand les degrés-jours sont renseignés sur les deux périodes, la plateforme affiche la performance corrigée du climat — la vraie efficacité, hors effet météo.
• Alertes de dérive : une hausse anormale de consommation par rapport à la même période l'an dernier déclenche une alerte.
• Dashboard : KPI coût moyen €/kWh, coût par lot, consommation par lot.

📋 Réglementaire & F-Gas

• Contrôles réglementaires : menu Réglementaire — échéancier des contrôles (gaz, eau, BACS…) avec statut à jour / échu et alertes.
• Registre F-Gas : suivi des mouvements de fluides frigorigènes, équivalent CO₂, et génération du CERFA 15497 (déclaration annuelle).

💶 Devis, contrats, coûts

• Devis : création, statuts, envoi ; conversion possible en intervention.
• Contrats : P2/P3, tarifs annuels, nombre de visites contractuelles, échéances (alertes à 60 jours). Le taux de service du dashboard compare visites réalisées et visites prévues.
• Coûts & TCO : menu Coûts — coûts de maintenance par catégorie et par équipement, TCO cumulé, top des équipements les plus coûteux (dans Analytics).

📡 Supervision GTB

• Menu GTB — points supervisés (oBIX/Niagara réel ou simulé), regroupés par zone, avec seuils min/max et alerte hors seuil.
• Chaque point affiche une mini-tendance (sparkline) issue de l'historique des relevés.
• Les points se configurent depuis la fiche d'un équipement (section « Supervision GTB »).

📊 Rapports & analytics

• Rapport d'assemblée générale : depuis une fiche site, synthèse annuelle sur données réelles (consommation N/N-1, provision P3, équipements remplacés, conformité, MaPrimeRénov'). Version imprimable.
• Analytics : coûts par mois/catégorie, interventions par statut, supervision multi-site, top équipements coûteux, KPI de performance maintenance (MTBF, MTTR, disponibilité, part préventif, délai de résolution).
• Rapports automatiques : digest d'alertes quotidien et rapport hebdomadaire par email (si l'ordonnanceur est activé).

⚙️ Administration & équipe

• Équipe : menu Compte — invitez des membres (un mot de passe temporaire aléatoire leur est envoyé), attribuez un rôle (admin / membre / lecture) et restreignez, si besoin, l'accès à certains sites.
• Rôles personnalisés : droits fins (écriture + sections accessibles).
• Configuration : techniciens, fournisseurs, référentiels, gammes, catalogue, jetons API, webhooks, journal d'audit, archives, syndics.
• Journal d'audit : traçabilité des actions sensibles (rôles, utilisateurs, jetons, suppressions), paginé.

🔒 Sécurité (2FA, mots de passe)

• Double authentification (2FA) : Compte → Sécurité → « Activer la 2FA ». Scannez le QR dans une application d'authentification (Google Authenticator, Authy…), confirmez avec un code, puis conservez les 8 codes de secours (affichés une seule fois). La désactivation exige le mot de passe.
• Mot de passe : minimum 8 caractères, avec au moins une lettre et un chiffre. Modifiable depuis Compte → Sécurité.
• Sessions : une session expire au plus tard après 12 h ; un changement de rôle est appliqué à l'expiration.

↕️ Import / export de données

• Import CSV : Compte → Import / Export — import en lot de stock, équipements, coûts, énergie, réglementaire, techniciens, fournisseurs, planning, fluides. L'import est atomique (tout ou rien).
• Export : export CSV par entité, et sauvegarde technique de la base.
• Export complet (RGPD) : Import / Export → « Exporter toutes les données » : un seul fichier JSON avec l'intégralité des données du compte (portabilité RGPD, migration). Réservé aux admins ; secrets exclus.
• Astuce colonnes : la première ligne du CSV doit contenir les noms de colonnes (ex. nom, conso, coutEur, dju, date pour l'énergie).