1. INTRODUCTION

Ce document constitue le manuel officiel d'utilisation et l'analyse fonctionnelle de la plateforme GMAO. Cet outil a ete concu pour digitaliser l'integralite des processus de maintenance, assurer la tracabilite reglementaire (F-Gas) et optimiser la gestion des stocks et des consommations energetiques. La version 5.0.0 (Enterprise) integre l'API REST publique, l'internationalisation FR/EN, le SSO LDAP, la gestion documentaire, les tickets/DI, le TCO, les rapports configurables et le design "Industrial Precision".

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.

2.7. Workflow Interventions (v4.2)

• Statuts : Chaque intervention suit un cycle de vie : Ouverte, Assignee, En cours, En attente, Terminee, Cloturee.
• Time Tracking : Heure de debut/fin avec calcul automatique de la duree en minutes.
• KPI Maintenance : MTBF (temps moyen entre pannes), MTTR (temps moyen de reparation), Disponibilite calculees par equipement sur le dashboard.
• Mes Interventions : Filtre rapide sur les interventions du technicien connecte.

2.8. Maintenance Avancee (v4.3)

• Hierarchie Equipements : Champ parent pour relier un equipement a un autre (sous-ensemble). Affichage indente dans le tableau.
• Compteurs d'Usage : Heures de fonctionnement, cycles, seuil d'alerte. Notification visuelle quand le seuil est atteint.
• Calendrier Planning : Vue mensuelle avec navigation et points colores par tache.
• Gammes Operatoires : Checklists de maintenance reutilisables, liees par type d'equipement. CRUD dans Administration.

2.9. Tickets / Demandes d'Intervention (v4.4)

• Soumission : Tout utilisateur peut creer un ticket (objet, equipement, priorite, description).
• Workflow : Soumis, Accepte, Assigne, Resolu, Cloture ou Rejete.
• Priorites : Basse, Normale, Haute, Critique avec codes couleur.
• Dashboard : Compteurs visuels par statut de ticket.

2.10. Gestion Documentaire (v4.4)

• Documents par equipement : Fiches techniques, plans de maintenance, certificats, manuels, photos.
• Upload securise : Validation extension + MIME, noms aleatoires.
• Acces : Bouton "Documents" sur chaque ligne equipement.

2.11. BI & Rapports (v4.5)

• TCO : Cout Total de Possession par equipement (main-d'oeuvre + pieces + couts directs).
• Tendances 12 mois : Graphiques interventions/mois et couts/mois.
• Rapports a la demande : 4 types (mensuel, couts, equipements, complet). Previsualisation HTML + export PDF.
• Dashboard configurable : Chaque utilisateur choisit les widgets visibles.

2.12. API REST & Enterprise (v5.0)

• API REST publique : api_rest.php — CRUD complet (GET/POST/PUT/DELETE) sur toutes les tables. Auth par Bearer token. CORS active. Documentation via ?endpoint=docs.
• Tokens API : Generation/revocation dans Administration. Permissions par token.
• i18n FR/EN : Toggle langue dans la sidebar. Interface traduite dynamiquement.
• SSO LDAP : Authentification LDAP avec creation automatique du compte local. Configuration via config.php.
• Alertes Email : Envoi d'alertes (stock, retards, compteurs) depuis l'admin.

4. ADMINISTRATION

4.1. Gestion des Roles (RBAC)

• Droits fins : Chaque role definit des permissions precises (Lecture seule, Gestion de stock, Administration totale).
• Journal d'Audit : Tracabilite complete des 100 dernieres actions effectuees sur le systeme.

4.2. Archivage

Possibilite d'archiver les interventions par annee ou par saison de chauffe pour alleger les vues quotidiennes tout en conservant un acces permanent aux donnees passees.

4.3. Gammes Operatoires

Checklists de maintenance reutilisables, definies dans Administration. Chaque gamme comprend un nom, un type d'equipement, une frequence et une liste d'etapes.

4.4. Tokens API REST

Les tokens Bearer permettent a des systemes externes (BMS, application mobile, integration) d'acceder a l'API REST. Generation et revocation via la console admin.

5. ANALYSE FONCTIONNELLE TECHNIQUE

5.1. Architecture logicielle

• Frontend : SPA (Single Page Application) en Vanilla JS. Polices système. Design "Industrial Precision".
• Backend : PHP 7+/8.x — Controleur de securite centralise (proxy.php) + API REST (api_rest.php).
• Stockage SQL : Moteur SQLite avec mode WAL (Write-Ahead Logging). Multi-sites (isolation physique sites/{id}/data.db). Tables: equip, inter, stock, plan, reglem, fluides, energy, couts, tickets, documents.
• Internationalisation : Module i18n FR/EN avec dictionnaire de traduction et attributs data-i18n.
• PWA : Service Worker avec strategie Network-First (navigation) et Stale-While-Revalidate (assets). Manifest avec shortcuts.

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`).
• v5.9.3 : correctifs de maintenance Coût total (TCO) : les pièces sont valorisées par les lignes de coût des interventions, à défaut par le coût de pièce par défaut du site. Une ligne de coût calculée depuis une intervention ne se supprime plus à la main. Archivage : session expirée et module Interventions contrôlés. Toute écriture exige POST (405 + en-tête Allow sinon). Libellé de l'équipement recalculé par le serveur. Libellés des modules de l'éditeur de site alignés sur les messages.
• v5.9.2 : noms des sites dans la liste des utilisateurs La colonne Sites affiche les noms au lieu des identifiants.
• v5.9.1 : sites d'un compte enregistrés, version affichée à la connexion Les sites autorisés choisis dans la fiche d'un compte sont de nouveau enregistrés et réaffichés ; la version de l'écran de connexion vient du serveur.
• v5.9.0 : CSP stricte effective Plus aucun `'unsafe-inline'` dans `script-src` : zéro handler inline (`data-action`, `data-input-action`, `data-change-action` + dispatcher whitelisté), zéro script inline. CDN protégés par SRI sha384.
• Security Pass (v4.1.0) : Fuite mots de passe via API GET bloquée. Import CSV utilisateurs interdit. Rehash automatique des mots de passe (password_needs_rehash). Noms de fichiers uploads cryptographiquement aléatoires. Rate limiting par session (120 req/min). Compteurs brute-force isolés dans data/. Routes silencieuses corrigées (retournent une erreur explicite).
• Modulabilite par site (v4.0.7+) : Activation/desactivation chirurgicale de chaque module (Dashboard, Scanner, Stock, Energie, GTB...) et filtrage du catalogue fournisseurs par site depuis la console admin.
• Accessibilite (v4.0.11) : Viewport zoomable (WCAG 1.4.4), navigation clavier sur les role="button", focus-visible global.
• API REST (v5.0) : Authentification Bearer token, CORS, permissions par token, rate limiting, table api_tokens avec tracking d'usage.
• SSO LDAP (v5.0) : Bind LDAP securise avec creation automatique du compte local. Protection injection LDAP via ldap_escape().

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é.