# Statistiques Laravel : rappel des critères sélectionnés

## Besoin
À la génération d'une statistique (`/statistique_laravel/{slug}`), seule la période était rappelée.
Les autres critères choisis dans le formulaire maître (société, centrale, client, chantier, ...) doivent
aussi apparaître, à l'écran, dans le PDF et dans l'Excel.

Livré pour **toutes les statistiques du registre** de `statistique_laravel_controller`, sauf
`journal_comptable` et `tarif_edition`, qui n'utilisent aucun critère en dehors des dates.

## Principe
- `app/Reports/Support/CriteresSelection.php` (trait, utilisé par `BaseReport`) traduit les valeurs du
  formulaire (`stat_*`) en libellés « code - libellé » via les modèles, en ignorant les valeurs
  « Tous/Toutes » (`0`, ou `10` pour type d'article, `3` pour BL annulé / préfa).
  - `criteresSelection()` : tableau `libellé => valeur` ; `criteresSelectionTexte()` : sur une ligne.
  - `criteresSelectionHtml($avecLigne = false)` : bloc pour la vue web (placé dans la ligne
    « Du ... AU ... / Edité le » ; `true` pour les vues sans cette ligne, ex. palmarès).
  - `criteresSelectionPdf()` : paragraphe « Critères : ... » sous la période.
  - `criteresSelectionExcel()` : cellule A2 (fusion A2:I2) ; le tableau de chaque export commence en A3.
    Texte en entités HTML, car le parseur de vue Excel de KoolReport lit les accents en ISO-8859-1.
- Chaque rapport déclare `protected $criteresStat = [...]` : **uniquement les critères réellement
  appliqués par sa requête** (relevés dans `$this->params['stat_*']` de la classe ; pour les palmarès,
  `stat_societe` est lu dans le trait `PalmaresReport`). Un critère visible dans le formulaire mais
  ignoré par la requête n'est donc pas affiché (ex. `consommation` : centrale + BL préfa, pas société).

## Fichiers
- `app/Reports/Support/CriteresSelection.php` (nouveau), `app/Reports/Support/BaseReport.php`.
- Pour chaque rapport `app/Reports/<slug>/` : `<slug>.php` (propriété `$criteresStat`), et un appel d'une
  ligne au helper dans `<slug>.view.php`, `<slug>.pdf.view.php`, `<slug>.excel.view.php`.
- Correction annexe : dans tous les exports Excel, « Edité le » / « Édité le » passés en entités
  (`Edit&eacute;`) ; ils sortaient auparavant en « EditÃ© ».

## Vérification
Les 42 rapports du registre ont été générés (web, PDF, Excel) avec tous les critères renseignés : la ligne
de critères est présente partout, sans erreur d'accent dans l'Excel. Pas encore vérifié dans le navigateur.

## Ajouter une nouvelle statistique
Déclarer `$criteresStat` dans la classe et appeler les trois helpers dans les vues (voir
`facture_chiffre_affaire_societe` pour l'exemple).
