# Modèle PDF du BL : champs de base de données reconnus

Toutes les colonnes de `t_bl`, des tables liées au BL et de la société sont envoyées au modèle PDF (formulaire pdftk) lors de la génération du BL dématérialisé.
Pour afficher une donnée, il suffit d'ajouter au modèle PDF un **champ texte** qui porte le nom attendu.

Implémentation : `app/Services/champs_bdd_pdf_bl.php`, appelée par `bl_demat_service` (Laravel) et par `public/pdftk/pdf.php` (script historique).

## Nommage des champs

Chaque colonne est disponible sous deux noms :

| Forme | Exemple | Remarque |
|---|---|---|
| `<source>__<colonne>` (deux `_`) | `client__client_nom`, `societe__Societe_SIRET`, `commune_chantier__commune_ville` | Toujours disponible, sans ambiguïté. **Forme recommandée.** |
| `<colonne>` | `client_nom`, `Societe_SIRET`, `bl_date_livraison` | Nom court, attribué à la première source qui possède la colonne (ordre ci-dessous). |

Les champs historiques du modèle (`delivery_order_number`, `customer_name`, `bl_annule`, …) gardent leur valeur et leur priorité.

## Sources (ordre de priorité des noms courts)

| Source | Table | Lien |
|---|---|---|
| `bl` | `t_bl` | le BL |
| `client` | `t_client` | `t_bl.client_id` |
| `chantier` | `t_chantier` | `t_bl.chantier_id` |
| `centrale` | `t_centrale` | `t_bl.centrale_id` |
| `commande` | `t_commande` | `t_bl.commande_id` |
| `vehicule` | `t_vehicule` | `t_bl.vehicule_id` |
| `chauffeur` | `t_chauffeur` | `t_bl.chauffeur_id` |
| `produit` | `t_produit` | ligne de BL de type 5 (négoce) |
| `formule` | `t_formule` | ligne de BL de type 0, sinon `t_bl.formule_id` (hors négoce) |
| `zone` | `t_zone` | ligne de BL de type 4, sinon `t_bl.zone_id` |
| `tva` | `t_tva` | `t_bl.tva_id` |
| `moyen_dechargement` | `t_moyen_dechargement` | `t_bl.moyen_dechargement_id` |
| `classe_consistance` | `t_classe_consistance` | `t_bl.classe_consisatnce_id` |
| `specificite` | `t_specificite` | `t_bl.spesificite_id` |
| `designation_beton` | `t_designation_beton` | `t_bl.designation_beton_id` |
| `adresse_facturation` | `t_adresse_facturation` | `t_bl.adresse_facturation_id` |
| `modele_impression` | `t_modele_impression` | `t_bl.modele_impression_id` |
| `modele_qr_code` | `t_modele_qr_code` | `t_bl.modele_qr_code_id` |
| `activite` | `t_activite` | `t_centrale.activite_id` |
| `transporteur` | `t_transporteur` | `t_vehicule.transporteur_id` |
| `commune_chantier` | `t_commune` | `t_chantier.commune_id` |
| `commune_client` | `t_commune` | `t_client.commune_id` |
| `societe` | `t_societe` | `t_centrale.societe_id`, sinon la première société |

Une source introuvable (clé vide, table ou colonne absente sur la base client) est ignorée : le champ reste vide et le BL est généré normalement.

## Mise en forme des valeurs

- `NULL` et dates nulles (`0000-00-00`) → vide
- date → `jj/mm/aaaa`, date-heure → `jj/mm/aaaa hh:mm`, heure → `hh:mm`
- autres valeurs : telles qu'en base

Les colonnes sensibles (mot de passe, jeton, clé d'API, secret) et les images de signature ne sont jamais exposées.

## Lister les champs d'un BL

```bash
php artisan pdf:champs_bl <bl_code>                    # noms préfixés et valeurs
php artisan pdf:champs_bl <bl_code> --source=societe   # une seule source
php artisan pdf:champs_bl <bl_code> --court            # noms courts
```

En local Docker : `docker exec -u www-data -e HOME=/tmp smartcentral-app php artisan pdf:champs_bl <bl_code>`.
