# Listing clients et Listing clients / chantiers (PDF)

Deux boutons ajoutés dans la grille des clients (`/client`), à côté de Rafraichir / Ajouter : **« Listing clients »** et **« Listing clients chantiers »**. Chacun ouvre un PDF dans un nouvel onglet. Le principe vient du « Catalogue formules » de la branche `new_designNB` : un service qui dessine le PDF directement avec TCPDF.

## Clients retenus

Ce sont les mêmes clients que la grille :
- les critères **Position de compte** et **Centrale** ;
- la règle « fiche non définie » (`parametre_fiche_non_defini`), via `requete_grille()` ;
- la **recherche générale** : LIKE sur toutes les colonnes, comme SSP ;
- les **filtres par colonne** (LIKE) ;
- le **tri** de la grille, puis le code client.

Il n'y a pas de pagination : on imprime tous les clients filtrés. Les filtres actifs sont rappelés en en-tête, sous le titre.

## Listing clients

A4 paysage, un client par ligne. Les 21 colonnes de la grille sont imprimées, qu'elles soient affichées à l'écran ou non. Plusieurs champs sont regroupés par cellule, un par ligne :
- **Code** ;
- **Nom**, avec le mot directeur s'il diffère du nom, et la civilité ;
- **Adresse** : adresse 1, adresse 2, puis CP et ville ;
- **Téléphones** : Bur., Mob., Dom., Fax ;
- **E-mails** : e-mail, e-mail démat BL, e-mail facture ;
- **Règlement / Échéance** ;
- **Position**, avec « Comptant » si le client est au comptant ;
- **Sous famille / Siret**.

Les valeurs vides sont omises.

## Listing clients / chantiers

A4 paysage. Pour chaque client, un bandeau vert (code et nom), puis le tableau de ses chantiers, triés par code complet :
- Code ;
- Nom, avec le mot directeur ;
- Adresse : adresse 1, adresse 2, puis CP et ville de la commune ;
- Téléphones : Bur., Mob., Dom., Fax ;
- E-mails : démat et démat supplémentaire ;
- Mode règlement ;
- Échéance ;
- Position ;
- Statut : Affaire, Commande, Terminé ou Perdu.

Règles :
- Tous les statuts sont imprimés. La règle « fiche non définie » de la grille chantier s'applique (`chantier_definir_en_prod = 1` si `parametre_fiche_non_defini ≠ 1`).
- Les clients sans chantier sont omis.

Mise en page :
- un client n'est pas coupé quand il tient sur une page ;
- sinon, le bandeau « (suite) » et l'en-tête du tableau sont répétés en haut de la page suivante ;
- un bandeau n'est jamais laissé seul en bas de page.

## Droits

Les mêmes que la grille : `profil_client_chantier ≠ 0`. Les routes sont sous `auth:sanctum` + `interne`.

## Fichiers

- `app/Services/client_listing_service.php` (nouveau) : `pdfClients()`, `pdfClientsChantiers()`.
- `app/Http/Controllers/client_controller.php` :
  - constante `COLONNES_GRILLE`, désormais commune à `data_table_v2()` et aux éditions ;
  - `imprimer_listing()` et `imprimer_listing_chantier()` ;
  - `clients_grille()` : les clients filtrés comme la grille ;
  - `libelle_filtres_grille()`.
- `routes/web/client.php` : routes `GET client/imprimer_listing` (`client.imprimer_listing`) et `GET client/imprimer_listing_chantier` (`client.imprimer_listing_chantier`).
- `resources/views/client/index.blade.php` : deux boutons. Le JS envoie les critères, la recherche, les filtres de colonnes et le tri par `window.open`.

## Décisions

- **Le découpage des lignes de texte est fait par le service.** Il dessine chaque ligne avec `Cell` et le cadre avec `Rect`, au lieu de `MultiCell` / `getStringHeight`, avec un cache des lignes découpées.
  - Avant ce changement, sur la base locale (6 087 clients, environ 24 500 chantiers) : 375 s pour les deux éditions complètes.
  - Après : environ 7 s pour le listing clients et environ 37 s pour le listing chantiers, Xdebug coupé.
  - Avec Xdebug actif : 35 s et 132 s.
  - Le contrôleur fixe `set_time_limit(600)`.
- **Mémoire** : avec la limite par défaut de 128 Mo, le listing chantiers complet tombait en erreur 500 (`Allowed memory size … exhausted` dans TCPDF).
  - Il consomme environ 196 Mo à son maximum, surtout le contenu des pages TCPDF.
  - Aucun `ini_set` dans le code : les serveurs sont déjà à 2 Go. En local (WAMP), il faut relever `memory_limit` dans le php.ini.
  - Le cache des lignes découpées ne garde plus que les en-têtes et bandeaux. Chaque ligne de données n'est découpée qu'une fois, puis dessinée.
- **Sécurité** : les noms de colonnes reçus (filtres, tri) sont contrôlés par `COLONNES_GRILLE` et les valeurs sont liées. Testé : `a' OR 1=1 --` en recherche donne 0 client, un tri ou une colonne inconnus sont ignorés.
- **Couleurs** :
  - en-têtes de colonnes au vert de l'application (`#28a745`), texte blanc ;
  - bandeaux client du listing chantiers en vert foncé (`#1e7e34`), pour les distinguer de l'en-tête de colonnes qui les suit.
- **Logo client** en haut à droite, comme le catalogue formules : `t_parametre.photo_logo`.

## Vérifications faites

- PDF générés hors HTTP sur la base locale : tous les clients, et le filtre ville « LYON » (8 clients, dont 4 avec chantiers). Le rendu a été contrôlé visuellement.
- Vues compilées (`view:cache`) et routes résolues.
- **Non vérifié dans le navigateur** : les boutons et la transmission des filtres et du tri depuis la grille.
