# Guide utilisateur : Suivi des pesées et export CSV

Documentation utilisateur de l'écran Suivi Pesée (`/pesee`), avec la même présentation que le guide des variantes de formule (charte ADLER, encadrés, figures numérotées).

## Fichiers livrés

- `docs/Guide_utilisateur_suivi_pesees_export_csv.docx`
- `docs/Guide_utilisateur_suivi_pesees_export_csv.pdf` (7 pages)

## Contenu

1. Rôle de l'écran.
2. Accès : menu Suivi > Suivi Pesée.
3. Filtres : période, formule, BL, centrale, désignation béton, BL annulés, formules NF, charge minimale, volume < 1/2 malaxeur. Les filtres ne s'appliquent qu'au clic sur « Rafraichir ».
4. La liste des pesées.
5. Prérequis du filtre volume malaxeur : `t_centrale.centrale_volume_mx` doit être renseigné (Fichier > Fichier de base > Centrale, onglet Général, cadre Communication). Si la valeur est vide ou à 0, le filtre n'a aucun effet.
6. Export CSV : centrale obligatoire, nom du fichier, format (`;`, UTF-8 avec BOM), regroupement par BL/gâchée/produit, description des 18 colonnes, extrait réel.
7. FAQ.

## Méthode

- Le docx est généré avec PHPWord (`vendor/phpoffice/phpword`), à partir du script commun `guide_commun.php` des guides précédents. Ce script se trouve dans le scratchpad de la session ; il n'est pas versionné. Le PDF est exporté par Word (COM).
- Les captures ont été faites avec html2canvas dans l'application locale (centrale 04 SAINT ETIENNE DE CROSSEY, 14/09/2026, volume malaxeur 1,50). Elles passaient par un fichier temporaire `public/_capture_doc_tmp.php`, supprimé à la fin.

## Point relevé dans l'export (non corrigé)

Dans `app/Exports/export_pesee_csv.php`, la colonne « QTE Gâchée » est restée vide sur les données testées. Une ligne sans code produit apparaît aussi en tête de chaque gâchée (ConsFor = quantité du BL). La cause probable : la ligne volume (`pesee_type_donnee = 4`, `produit_formule_id = 0`) est regroupée par le `groupBy` avec une autre pesée du produit 0. La condition `pesee_type_donnee == 4` n'est alors jamais vraie dans la boucle. Le guide décrit la colonne sans entrer dans ce détail.