# Contribution exceptionnelle — champs paramètre / client / chantier

## Fichier ajouté
- `database/migrations/2026_10_26_1000_V905001_NB_contribution_exeptionnelle.php`

## Colonnes ajoutées (toutes `int(11)`)

| Table | Colonne | Défaut |
|---|---|---|
| `t_parametre` | `parametre_contribution_exeptionnelle_id` | `NULL` |
| `t_parametre` | `parametre_contribution_exeptionnelle_facturable` | `0` |
| `t_client` | `client_contribution_exeptionnelle_id` | `NULL` |
| `t_client` | `client_contribution_exeptionnelle_facturable` | `0` |
| `t_chantier` | `chantier_contribution_exeptionnelle_id` | `NULL` |
| `t_chantier` | `chantier_contribution_exeptionnelle_facturable` | `0` |

## Décisions
- Orthographe `exeptionnelle` conservée telle que demandée.
- `*_id` nullable (pas de contribution par défaut), `*_facturable` à 0 par défaut.
- Les modèles `parametre`, `client`, `chantier` utilisent `$guarded` : aucune modification de modèle nécessaire.
- Migration idempotente (`Schema::hasColumn`) et réversible (`down`).

## Case à cocher « Contrib. exceptionnelle facturable »
Ajoutée juste avant la case « REP facturable », dans l'onglet facturation béton :
- `resources/views/parametre/index.blade.php`
- `resources/views/client/form.blade.php` et `client/form_v2.blade.php` : valeur par défaut reprise du paramètre si le client n'a pas de valeur
- `resources/views/chantier/form.blade.php` : pour un nouveau chantier, la valeur vient du client

Enregistrement :
- `parametre_controller` : `$request->has(...) ? 1 : 0` + règle de validation
- `client_controller` et `chantier_controller` : règle `nullable|boolean` (enregistrée via `fill(validated())`, avec un champ caché à 0 pour la case décochée)

## Fonctionnement identique à la REP (ecotaxe)
`parametre_contribution_exeptionnelle_id` = article (t_service) de la contribution, choisi dans Paramètres (liste « Article contrib. exceptionnelle », à côté de « Article REP »). Rien n'est généré tant qu'il vaut 0/NULL.
Uniquement pour l'activité béton (BPE), comme la REP.

| Étape | Fichier |
|---|---|
| Lignes de taxe devis (type `'10'` dans `verifier_ecrire_ligne` : chantier > client > paramètre) | `app/fonctions/ajout_lignes_taxes_fonction.php` |
| Article reconnu comme taxe (tri des lignes de devis) | `ajout_lignes_taxes_fonction::articles_taxes_ids`, `public/inc/fonction.inc.php::chercher_articles_taxes_ids` |
| Mise à jour quantité ligne taxe | `app/fonctions/modifier_qte_lignes_taxes_fonction.php` |
| Case modifiée sur un chantier → ajout/suppression dans les BL non facturés | `app/fonctions/recalculer_lignes_transport_lignes_taxes_dans_chantier_fonction.php` |
| Création BL : ajout de la ligne si chantier facturable | `public/trans/action_trans_bl.php` |
| Vérification taxes d'un BL (ajout/suppression) | `public/bl/chantier_verifier_taxes.php` |
| Génération facture : cumul et ligne en fin de facture (si `parametre_contrib_ligne_fin_facture`) | `public/generation_facture/generation_facture_selectionner_client.php` |
| Valeur par défaut à la création client (paramètre) / chantier (client) par intégration | `public/trans/action_trans_client.php`, `action_trans_chantier.php` et leurs versions `V2/` |

Non traités : imports Excel ponctuels (`public/integrer_*_xlsx.php`), import facture comptant (`action_trans_ligne_facture_comptant.php`, il n'y a pas de code produit externe pour cette contribution), rapport « CA client éligible REP ».
`client_contribution_exeptionnelle_id` et `chantier_contribution_exeptionnelle_id` ne sont pas utilisés : seul l'article du paramètre compte, comme pour la REP.
