# Contrôle BL : portage Laravel (`controle_bl`)

## Demande

Migrer l'écran legacy « Contrôle BL » (`public/control_bl`) en Laravel.

## Fonctionnement (identique au legacy)

- Liste des BL dont la date de livraison diffère de la date de référence (`bl_date_livraison <> bl_date_ref`), sur une période. Les dates par défaut suivent `t_parametre.parametre_date_grille_generale`. Changer la date de début recopie la même date en fin.
- Filtres : centrale, BL annulé, BL facturé (`facture_numero` nul ou non), client facturable (`client_client_non_facturable`), ventilation, BL en alarme (`bl_nombre_alert > 0`), BL en incident (`bl_incident_numero` non vide). La grille se recharge avec le bouton « Rafraîchir », comme dans le legacy.
- Compteurs : nombre de BL, m³ livrés, quantité moyenne par BL.
- Grille : icônes d'état (livré, annulé/abandonné, alertes, lien PDF orange si ajout démat), couleur de la centrale, couleur de position de compte sur le nom client, code BL en cyan s'il est facturé, ligne en rouge si annulé ou abandonné.
- Pas de droit de profil, comme le legacy (middlewares `auth:sanctum` + `interne`).

## Fichiers

- `routes/web/controle_bl.php` : `GET /controle_bl` (page) et `GET /controle_bl/table` (JSON de la grille).
- `app/Http/Controllers/controle_bl_controller.php` : `index()`, `data_table()`.
- `resources/views/controle_bl/index.blade.php`.
- Menus : `menu_definition.php` et `menu_ancien.inc.php` pointent vers `controle_bl` (clé de favori `control_bl` inchangée).

## Legacy

Le dossier `public/control_bl/` a été supprimé. Il reste récupérable dans l'historique git.

## Différences avec le legacy

- Requête unique avec paramètres liés (le legacy concaténait `$_GET` dans le SQL) ; valeurs affichées et lien PDF échappés.
- Éléments sans effet dans le legacy, non repris :
  - listes « BL transmis » et case « BL ajout eau » (jamais envoyées au serveur) ;
  - bouton « Ajouter » et menu de téléchargement Excel (aucun traitement associé) ; remplacés par un bouton d'export Excel DataTables qui fonctionne ;
  - colonnes vides « D », « QTE ACC », « SERV1 », « QTE S1 », « SERV2 », « QTE S2 » et la colonne « SUPPRIMER » (icône sans action).
- Heures vides affichées vides au lieu d'une heure arbitraire.
- Couleur « facturé » du code BL : uniquement si `facture_numero` est renseigné. En PHP 8, le test legacy colorait aussi les numéros vides.

## Vérification

Comparaison legacy / Laravel sur 5 combinaisons de filtres, sur toute la période de la base locale : mêmes BL et mêmes m³. La base locale ne contient que 11 BL avec une date de livraison différente de la date de référence, donc les filtres n'ont été vérifiés que sur peu de lignes. Vue Blade compilée sans erreur. Page non testée dans le navigateur.
