# PDF « BL production + pesées »

## Fonctionnalité

- Fiche BL : nouvelle entrée **« BL production + pesées »** dans le menu **PDF**.
- Elle ouvre dans un nouvel onglet un PDF A4 portrait :
  - le BL production (le même que « BL production ») en haut ;
  - le bon de pesée **en dessous, sur la même page**.
- **Toujours sur une seule page** : si BL + pesées ne tiennent pas, les deux sont réduits du même facteur (voir « Correctif » plus bas).
- BL sans pesée : erreur 404 « Aucune pesée pour le BL … ».

## Chaîne d'appel

`public/bl/bl_afficher_tr.php` (lien `#bl_pdf_format_bl_pesee`)
→ `public/inc/js/bl/bl.js` (`window.open(App.baseUrl + "pesee/imprimer_bl_pesee/" + id_bl)`)
→ route `pesee.imprimer_bl_pesee` (`routes/web/pesee.php`, middleware `auth:sanctum` + `interne` comme les autres routes pesée)
→ `pesee_controller::imprimer_bl_pesee()` (réponse PDF `inline`)
→ `App\Services\bl_pesee_pdf_service::genererPdf()`.

## Fonctionnement de `bl_pesee_pdf_service`

1. **BL production** : généré par `bl_demat_service::genererPdfPourBl()` (pdftk + FPDI, portage Laravel de `public/pdftk/pdf.php`). Ce service renvoie désormais `bas_contenu_mm` : le bas du contenu de la dernière page du BL, en mm. Il est calculé ainsi :
   - point de départ : position du modèle + hauteur du modèle mis à l'échelle (valeur renvoyée par `useTemplate()`) ;
   - il est repoussé plus bas par la signature et le QR code quand ils sont présents sur cette page.
2. **Pesées** : `pesee_pdf_service_v2::construireHtml2Pdf($blId, $options)` accepte maintenant des options :
   - `portrait` : A4 portrait, police 6,5 pt ;
   - `sous_bl` : pas d'en-tête de page (ni titre « BON DE PESÉE », ni centrale), pas de pagination ; le bandeau info BL (BL N° / date / OF, formule, client, chantier) est affiché si `centrale_pesee_impression_info_bl` est coché sur la centrale ;
   - `bloc_largeur_mm` : rendu en « bloc ». Une page unique de cette largeur, sans marge ni pied de page (la légende passe sous le tableau). Sa hauteur est ajustée au contenu : un 1er rendu sur une page de 3 000 mm sert à mesurer `GetY()`, puis un 2e rendu se fait à la hauteur exacte. Le service renvoie cette hauteur dans `hauteur_mm`.

   Sans option, le bon de pesée est inchangé : paysage, bouton « Pdf » de l'écran pesée et impression automatique.
3. **Assemblage FPDI** :
   - les pages du BL ;
   - sur la dernière page, le bloc des pesées, placé à 4 mm sous le bas du BL, entre les marges latérales de 8 mm ;
   - échelle = min(1, hauteur disponible / hauteur du bloc), hauteur disponible = hauteur de page − 6 mm − (bas du BL + 4 mm) ;
   - le bloc est centré quand il est réduit ;
   - `genererPdf()` renvoie l'échelle appliquée (`echelle_pesees`).

   Fichier : `storage/app/public/pdf_bl_pesee/{id_bl}.pdf`. Le PDF intermédiaire des pesées est supprimé.

## Points d'attention

- Il faut pdftk sur le serveur, comme pour l'impression automatique du BL (`bl_demat_service`). Il n'est pas installé sur le poste de dev : l'assemblage a été testé avec un faux BL production (un cadre de 135, 120 puis 250 mm de haut), pas avec le vrai modèle.
- `bl_demat_service` lit les modèles dans `storage/app/public/modele_pdf/`. Le bouton legacy « BL production » (`public/pdftk/pdf.php`) les lit dans `RACINE_SITE_MODELE_CLIENT/modele_pdf/`. Les deux emplacements doivent contenir le même modèle.
- Comme « BL production », la génération met à jour `t_bl.bl_lien_pdf` et réécrit `pdf_demat/{id_bl}.pdf`.
- Si le modèle du BL comporte un fond blanc opaque sur toute la page, les pesées restent visibles : elles sont dessinées par-dessus le BL.

## Erreur en local (poste de dev)

- Sur le poste de dev, la génération échoue avec `Failed without error message: pdftk ... (Exit code: 1)`. Deux causes :
  - pdftk n'est pas installé ;
  - le modèle de BL `storage/app/public/modele_pdf/DeliveryOderTemplateFillable(1)(6).pdf` n'existe pas : seul `public/modele_pdf/DeliveryOderTemplateFillable(1)(3).pdf` est présent.
- Le bouton legacy « BL production » ne fonctionne pas non plus en local.
- `pesee_controller::imprimer_bl_pesee()` attrape désormais l'erreur. Il affiche un message clair (pdftk / modèle manquant) avec le détail technique, et trace l'exception via `report()`.
- Pour tester en local :
  - installer PDFtk Server (Windows) et ajouter son dossier `bin` au PATH du service Apache de WAMP ;
  - copier le modèle de BL (récupéré du serveur) dans `storage/app/public/modele_pdf/`.

## Évolution : une seule page

- Au départ, les pesées passaient sur la page suivante quand il restait moins de 70 mm sous le BL. Le BL et les pesées tiennent désormais toujours sur une page, grâce au mode bloc et à la réduction.
- Html2Pdf / TCPDF réoriente une page de format personnalisé selon l'orientation demandée. Il faut passer `L` quand la page est plus large que haute, sinon la largeur et la hauteur sont inversées.
- Tests faits avec un faux BL production :
  - BL de 141 mm de haut : pesées à taille réelle ;
  - BL de 250 mm de haut : pesées réduites à 64 %.

## Correctif : pesées minuscules (0,5 cm)

- **Cause** : les modèles de BL sont des pages A4 entières dont le contenu s'arrête vers 62 % de la hauteur (le bas est vide). La hauteur totale du modèle était prise comme bas du BL : il ne restait que quelques mm pour les pesées.
- **`bl_demat_service`** : il ne renvoie plus `bas_contenu_mm`, mais `placement_derniere_page` = `modele_y_mm`, `modele_hauteur_mm`, `bas_calques_mm` (signature, QR code).
- **`bl_pesee_pdf_service`** :
  - bas du BL = haut du modèle + 65 % de sa hauteur (`RATIO_HAUTEUR_UTILE_MODELE`), ou le bas des calques s'il est plus bas ;
  - si BL + pesées dépassent la page, **les deux sont réduits du même facteur** (`echelle`) et centrés ;
  - la dernière page du BL est donc redessinée par ce service.
- **À surveiller** : le ratio de 65 % vaut pour le modèle standard `DeliveryOderTemplateFillable`. Un modèle de centrale (`centrale_modele_pdf`) dont le contenu descend plus bas serait recouvert par les pesées. Dans ce cas, ajuster la constante ou en faire un paramètre (centrale / paramètres généraux).

## Paramètre centrale « Hauteur utile du modèle (%) »

- **Migration** `2026_11_05_1600_V905001_NB_t_centrale_bl_pesee_hauteur_utile` : nouvelle colonne `t_centrale.centrale_bl_pesee_hauteur_utile` (entier, valeur par défaut 65).
- **Fiche centrale**, onglet « Modèle PDF » : champ **« Hauteur utile du modèle (%) - BL + pesées »**, de 10 à 100. Validation `integer|between:10,100` dans `centrale_controller::enregistrer()`.
- **`bl_pesee_pdf_service::ratioHauteurUtile()`** lit ce paramètre sur la centrale du BL (65 % si vide), et remplace l'ancienne constante `RATIO_HAUTEUR_UTILE_MODELE`.
- **Réglage** : si les pesées recouvrent le bas du BL, augmenter la valeur ; s'il reste un blanc entre le BL et les pesées, la diminuer.
- **Test** : centrale 01 passée à 90 % ; le BL et les pesées ont été réduits à 92 % pour tenir sur la page. La valeur a été remise à 65 ensuite.

## En-tête sous le BL

- En mode `sous_bl`, le titre « PESÉES » et la centrale sont supprimés.
- Le bandeau info BL (BL N° / date / OF, formule, client, chantier) s'affiche, comme sur le bon de pesée seul, si la case **« Impression information BL en entête »** est cochée sur la centrale.
- Mesure sur le BL 154022 : bloc des pesées de 49 mm sans le bandeau, 75 mm avec.

## Bandeau compact et chevauchement avec le BL

- **Bandeau info BL en portrait** : version compacte, uniquement en mode portrait. Le bon de pesée seul en paysage est inchangé.
  - libellés en 5,5 pt ;
  - N° de BL en 9 pt ;
  - codes en 8 pt ;
  - libellés de valeur et date/OF en 6,5 pt ;
  - marges intérieures réduites ;
  - date et OF sur une seule ligne ;
  - espace sous le bandeau de 1,5 mm au lieu d'un `<br>`.
- Hauteur du bloc des pesées sur le BL 154022 : 64 mm au lieu de 75 mm.
- **Espace entre le BL et les pesées** (`MARGE_SOUS_BL_MM`) : 3 mm, puis 5 mm, puis 15 mm (les pesées écrasaient encore la dernière ligne du BL).
- **Chevauchement des pesées sur la fin du BL** : le modèle du serveur (`DeliveryOderTemplateFillable(1)(6).pdf`) descend plus bas que le 65 % mesuré sur le modèle local `(1)(3)`. Augmenter le paramètre centrale « Hauteur utile du modèle (%) - BL + pesées » (onglet Modèle PDF), par exemple à 70 ou 72, jusqu'à ce que les pesées démarrent sous la dernière ligne du BL.

## Correctif : erreur « pdftk » chez le client alors que BL seul et pesées seules fonctionnent

- **Symptôme** : sur l'installation client, « BL production + pesées » affiche « Vérifier que pdftk est installé… ». Pourtant « BL production » seul et le bon de pesée seul fonctionnent.
- **Cause** : pdftk est bien installé, puisque le BL legacy l'utilise. Le problème vient de l'emplacement du modèle :
  - `bl_demat_service` cherchait le modèle de BL dans `storage/app/public/modele_pdf/` ;
  - les modèles envoyés depuis la fiche centrale et les paramètres (`centrale_controller`, `parametre_controller`) vont dans `RACINE_SITE_MODELE_CLIENT/modele_pdf/`, et c'est là que le BL legacy (`public/pdftk/pdf.php`) les lit ;
  - chez le client, le dossier de `storage` est vide : pdftk recevait un chemin inexistant.
- **Correction** (`app/Services/bl_demat_service.php`) :
  - nouvelle méthode `cheminModelePdf()` : elle cherche d'abord dans `env('RACINE_SITE_MODELE_CLIENT')/modele_pdf/`, puis dans `storage/app/public/modele_pdf/` en repli ;
  - `resoudreModelePdf()` lève une exception claire « Modèle PDF du BL introuvable : <chemin> » si aucun fichier n'est trouvé.
- Le correctif vaut pour tous les usages de `bl_demat_service` : BL + pesées, impression automatique, mail BL démat.
- Le message d'erreur de `pesee_controller::imprimer_bl_pesee()` cite maintenant le bon dossier.
