1. INTRODUCTION

Ce document constitue le manuel officiel d'utilisation et l'analyse fonctionnelle de la plateforme GMAO. Cet outil a été conçu pour digitaliser l'intégralité des processus de maintenance, assurer la traçabilité réglementaire (F-Gas) et optimiser la gestion des stocks et des consommations énergétiques. La version 3.8.0 finalise l'architecture **Full SQL Optimized** et introduit le moteur de statistiques agrégées côté serveur.

1.1. Concepts de base

L'application est structurelle autour de quatre piliers :

• La donnée machine : L'équipement est le point central. Tout historique (Intervention, Fluide, Énergie) lui est rattaché de manière unique.
• L'automatisation : Les actions métier déclenchent des mises à jour en cascade (déstockage automatique, statut de planning).
• Performance SQL Insight (v3.6) : Suppression définitive du stockage JSON hybride pour un moteur **100% SQLite**. Les données clés sont extraites dans des colonnes SQL dédiées pour des statistiques instantanées et une recherche ultra-rapide.
• Mobilité & Offline : L'interface s'adapte aux smartphones et permet la saisie sans réseau avec une file d'attente de synchronisation robuste sécurisée par jeton CSRF persistant.
• Ergonomie v2.10 (Restaurée) : Le système utilise l'interface visuelle optimisée de la version 2.10 pour une meilleure lisibilité des actions.

2. GUIDE UTILISATEUR PAR MODULE

2.1. Tableau de Bord & Pilotage

Le Tableau de Bord offre une vision macroscopique de l'état de vos sites.

• Indicateurs critiques : Les compteurs (badges) en haut de page indiquent les actions urgentes : retard réglementaire (< 30 jours), tâche planifiée dépassée ou stock sous le seuil critique.
• Analyse Graphique : Les graphiques (logiciel v3.4) permettent de visualiser en temps réel les dérives de consommation et les répartitions de coûts.
• Export Complet PDF : Génère un document structuré incluant l'intégralité des modules. Idéal pour les audits réglementaires ou les bilans annuels.

2.2. Gestion du Parc & QR Codes

C'est ici que vous enregistrez vos actifs (PAC, Chaudières, CTA, etc.).

• Fiches Équipements : Renseignez la marque, le modèle et le type de fluide. La périodicité définit la fréquence de génération automatique des rappels de maintenance.
• QR Codes : Chaque équipement possède un identifiant unique. Le scan d'une étiquette sur le terrain ouvre instantanément la fiche machine et l'historique des interventions.

2.3. Interventions & Cycle de Travail

Le module le plus utilisé par les techniciens pour tracer les travaux réalisés.

• Rapport Numérique : Inclut les mesures, le descriptif détaillé, des photos et la **Signature Électronique** du client.
• Checklist Préparatoire : Lors de la validation d'une tâche planifiée, une liste de contrôle s'affiche pour garantir qu'aucun point de maintenance n'a été oublié.
• Lien Stock : Les pièces déclarées dans l'intervention sont automatiquement déduites du stock physique.

2.4. Réglementation & Fluides

• Bilan F-Gas : Calcul automatique de la Tonne Équivalent CO2. Suivi de la balance Charge/Récupération par équipement pour une conformité réglementaire totale.
• Historique Archivé : Chaque contrôle (étanchéité, sécurité) est horodaté et conservé sans limite de durée.

2.5. Stock & Catalogue

• Seuils d'Alerte : Une notification visuelle apparaît dès qu'une pièce descend sous le stock minimum défini.
• Import Catalogue : Importation massive des références fournisseurs via CSV avec mapping intelligent des colonnes.

2.6. Suivi Énergétique & Budget

• Énergie : Suivi des consommations avec extraction SQL pour une analyse de performance saisonnière.
• Coûts : Centralisation de toutes les dépenses par catégorie (Pièces, Main d'œuvre, Déplacement).

3. MOBILITÉ & SÉCURITÉ

3.1. Mode Hors-Ligne (Sync Robustness)

• File d'attente : L'icône ⏳ indique les données en attente. La synchronisation reprend automatiquement dès que le réseau est stable.
• Sécurité CSRF : La synchronisation est protégée contre les attaques intersites. Si votre session expire (1h), le système vous demande de vous reconnecter avant de vider la file d'attente pour protéger vos données.

3.2. Installation PWA

L'application s'installe sur smartphone via le menu "Ajouter à l'écran d'accueil" de Safari (iOS) ou Chrome (Android), offrant une expérience plein écran sans navigation web parasite.

4. ADMINISTRATION

4.1. Gestion des Rôles (RBAC)

• Droits fins : Chaque rôle définit des permissions précises (Lecture seule, Gestion de stock, Administration totale).
• Journal d'Audit : Traçabilité complète des 100 dernières actions effectuées sur le système.

4.2. Archivage

Possibilité d'archiver les interventions par année ou par saison de chauffe pour alléger les vues quotidiennes tout en conservant un accès permanent aux données passées.

5. ANALYSE FONCTIONNELLE TECHNIQUE

5.1. Architecture logicielle

• Frontend : SPA (Single Page Application) en Vanilla JS. Aucune dépendance externe risquant une obsolescence.
• Backend : PHP 8.x - Contrôleur de sécurité centralisé (`proxy.php`).
• Stockage SQL : Moteur SQLite avec mode WAL (Write-Ahead Logging). Supporte plus de 200 utilisateurs simultanés avec verrouillage au niveau de la ligne (concurrence élevée).

5.2. Hardening & Sécurité

• Transactions SQL : Toutes les écritures sont protégées par des transactions `BEGIN/COMMIT`. Un crash serveur en milieu d'écriture n'altère pas l'intégrité de la base.
• Protection CSRF : Validation stricte des jetons sur 100% des requêtes POST.
• Étanchéité Multi-sites : Isolation physique des bases de données par site (`site_id/data.db`).

6. MENTIONS LÉGALES & RGPD

Conformément au Règlement Général sur la Protection des Données (RGPD), cette plateforme respecte la vie privée de ses utilisateurs.

6.1. Données Collectées

• Identité : Noms d'utilisateurs et rôles pour la gestion des accès.
• Logs de sécurité : Adresses IP et horodatages des actions (audit.log) pour la prévention des intrusions.
• Contacts : Emails et numéros des prestataires nécessaires à l'exploitation.

6.2. Finalités et Conservation

Les données sont utilisées exclusivement pour la maintenance technique des sites. Les logs de sécurité sont conservés 1 an avant suppression automatique. Les données utilisateurs sont conservées tant que le compte est actif.

6.3. Vos Droits

Chaque utilisateur dispose d'un droit d'accès, de rectification et de suppression de ses données personnelles. Pour toute demande, contactez l'administrateur système.

6.4. Cookies

Ce site utilise uniquement des cookies de session strictement nécessaires au fonctionnement de l'authentification. Aucun cookie de traçage publicitaire n'est utilisé.