# Catalogue formules (PDF)

Nouvelle édition PDF lancée depuis la grille des formules (`/formule`), bouton **« Catalogue formules »**.

## Fonctionnement

- Le bouton reprend les filtres de l'écran :
  - **Centrale** (`#centrale_export_excel`) ;
  - **Définir en production** ;
  - **Formule normée**, appliqué seulement quand une centrale est choisie, comme dans la grille.
- Le PDF est en A4 portrait et se lit **formule par formule**, dans l'ordre des codes :
  1. **Bandeau** : code + appellation commerciale.
  2. **Informations générales** : 3 couples libellé / valeur par ligne. Champs : code fac., caractéristique, désignation, type, classes résistance / exposition / chlorure / consistance, spécificité, nature d'addition, famille.
  3. **Compositions** de la formule :
     - aucune centrale choisie : **centrale par centrale**, triées par code centrale ;
     - une centrale choisie : la seule centrale choisie ;
     - dans chaque centrale, **variante par variante**, la variante active d'abord. Le nom de la variante n'apparaît dans le titre (« Centrale XX | Variante YY ») que s'il existe plusieurs variantes.
     - Colonnes : Type / Code / Libellé / Quantité / Imprimable.
  4. On passe ensuite à la formule suivante.
- **Mise en page** :
  - une composition n'est pas coupée quand elle tient sur une page ;
  - sinon, le bandeau de la formule « (suite) » et l'en-tête du tableau sont répétés en haut de la page suivante ;
  - le bandeau d'une formule n'est jamais laissé seul en bas de page.
- **Formules retenues** : uniquement celles qui ont au moins une composition sur la ou les centrales concernées.
- Toutes les lignes de composition sont imprimées, imprimables ou non. L'information est visible dans la colonne « Imprimable ».
- Pas de coût formule.
- Les compositions rattachées à une variante qui n'existe pas dans `t_formule_variant` (`formule_variant_id = 0`, anciennes données) sont ignorées.
- **Droits** :
  - `profil_formule ≠ 0`, comme pour l'édition de conformité ;
  - un profil limité aux centrales (`profil_limiter_centrale`) ne voit que ses centrales ;
  - sinon, toutes les centrales actives.

## Fichiers

- `app/Services/formule_catalogue_service.php` : nouveau service.
  - `construireDonnees()` regroupe les données formule → centrale → variante, avec des requêtes groupées (pas de N+1).
  - `construirePdf()` dessine le PDF.
- `app/Http/Controllers/formule_controller.php` : nouvelle méthode `imprimer_catalogue_pdf()`.
- `routes/web/formule.php` : nouvelle route `GET formule/imprimer_catalogue_pdf`, nommée `formule.imprimer_catalogue_pdf`.
- `resources/views/formule/index.blade.php` : bouton et JS (`window.open`). « Export excel » et « Catalogue formules » sont réunis dans un même bloc `col-md-3 d-flex align-items-end`, pour éviter qu'ils se superposent. La marge de « Définir en production » passe de `offset-md-6` à `offset-md-4`.

## Décisions

- **TCPDF en dessin direct plutôt qu'Html2Pdf / Blade.**
  - Avec Html2Pdf, une seule centrale (575 formules, environ 3 000 lignes de composition) dépassait 10 minutes.
  - Avec TCPDF : environ 11 s pour une centrale (166 pages) et environ 47 s pour les 6 centrales (environ 1 600 formules, 607 pages).
  - Les hauteurs de cellule mesurées sont mises en cache par style / largeur / texte, ce qui divise le temps par 2.
  - Le contrôleur fixe `set_time_limit(600)`.
- **Logo client** :
  - il vient de `t_parametre.photo_logo` et est placé en haut à droite de chaque page, dans le `Header()` TCPDF, cadre de 40 × 14 mm, proportions conservées ;
  - il est cherché dans `RACINE_SITE_MODELE_CLIENT/image/`, où `parametre_controller` le dépose ;
  - sinon dans `public/image/` (repli utile en local, où `RACINE_SITE_MODELE_CLIENT` pointe vers le chemin du serveur).
