# Guide utilisateur : KPI production

Documentation utilisateur de la feuille KPI production (`/kpi`), même présentation que les guides précédents (charte ADLER, encadrés, figures numérotées). Le détail technique des calculs est dans `docs/kpi_volume_moyen_capacite_camion.md`.

## Fichiers livrés

- `docs/Guide_utilisateur_kpi_production.docx`
- `docs/Guide_utilisateur_kpi_production.pdf` (8 pages, 10 figures)

## Contenu

1. Rôle de la feuille, accès (menu Statistiques > KPI production, droit profil « KPI production », navigation vers KPI finance).
2. Filtres Début / Fin (date de livraison, mois en cours par défaut) et Centrale ; recalcul automatique au changement. Règles communes (BL annulés et véhicules sous centrale exclus, voyage / rotation).
3. Volume & chargement : 4 cartes, calculs, exemple chiffré de septembre 2026, détail par camion.
4. Temps de cycle : phases de la rotation rapportées aux horaires de l'onglet Heures du BL, filtres d'anomalies (phase > 2 h, total < 5 min ou > 4 h), attente chantier, attente centrale.
5. Qualité : retour béton.
6. Productivité : rotations / jour travaillé (par camion) vs rotations / jour de production (flotte), jours de production.
7. Données à renseigner : Capacité et « Véhicule sous centrale » de la fiche véhicule, horaires du BL.
8. FAQ.

## Points vérifiés dans le code

- Filtres et exclusions : `app/Http/Controllers/kpi_controller.php` (`statsParVehicule`, `baseRotationQuery`, `baseAttenteCentraleQuery`, `statsVehiculesParJour`). Les 4 cartes « Volume & chargement » excluent les camions sans capacité.
- Dates par défaut : `definir_date_selection(2)` = mois en cours ; rechargement sur `change` des filtres (`resources/views/kpi/index.blade.php`).
- Retour béton : `t_bl.bl_qte_retour_beton` est la quantité de retour **réutilisée**, enregistrée sur le BL créé (départ de cycle, cadre « Retour béton » / BL, onglet Divers « Qté remplacée »). Le détail par camion rattache donc le retour au camion du BL qui réutilise le béton. Le guide le précise.

## Méthode

- Docx généré avec PHPWord à partir de `guide_commun.php` (scratchpad, non versionné) ; PDF exporté par Word (COM).
- Captures html2canvas dans l'application locale (septembre 2026, toutes centrales ; véhicule CM08SE202), via `public/_capture_doc_tmp.php` et `.js`, supprimés à la fin. La capture de la fiche véhicule a été recadrée pour ne pas montrer le nom du chauffeur.
- Correctif du script : `addTitle()` n'échappe pas le texte, un « & » dans un titre rendait le docx illisible par Word. Les titres contenant `&` passent par `htmlspecialchars()`.
