# Calcul de `ligne_facture_cout` à la génération des factures

## Contexte
`t_ligne_facture.ligne_facture_cout` (coût d'achat de la ligne, utilisé par le rapport
`app/Reports/facture_chiffre_affaire_cout`) n'était renseigné que par le script manuel
`public/calculer_cout_article_dans_ligne_facture.php`. Les nouvelles factures avaient un coût à 0.

Le coût est désormais calculé à chaque création / modification de lignes de facture, et figé à ce moment
(un changement de prix d'achat ultérieur ne modifie pas les factures existantes, sauf recalcul manuel).

## Règles de calcul (`App\Services\ligne_facture_cout_service`)
`ligne_facture_cout = coût unitaire × ligne_facture_qte` (arrondi 2 décimales).

| Type | Coût unitaire |
|---|---|
| F formule | `article_tarif_service::calculerCout()` type 0 : composition à la centrale + transport produits |
| S service | `service_prix_achat` |
| J ajout manuel | `ajout_prix_achat` |
| D adjuvant | `produit_cout_kg` + transport centrale (quantité en kg / L) |
| G granulat | (`produit_cout_kg` + transport centrale) × 1000 (quantité en tonnes) |
| Z zone | `zone_prix_m3_achat` (au m3) ou `zone_prix_m3_voyage_achat` (au voyage) |
| autres (C, E, acompte...) | 0 |

### Zone : m3 ou voyage
La quantité d'une ligne zone est toujours dans l'unité facturée (vérifié : total = qte × PU sur 100 % des lignes) :
m3 livrés en mode m3, nombre de voyages en mode voyage. Le mode est déterminé **sur la ligne**, pas seulement
sur le chantier, car une facture émise avant un changement de mode du chantier garde les quantités de l'ancien mode :

1. transport incomplet (`parametre_article_ti_id`) : toujours au m3 ;
2. quantité = volume du BL (`t_bl.bl_qte_acceptee`, BL ≠ 1 m3) → au m3 ; quantité 1 pour un BL d'un autre volume → au voyage ;
3. cas ambigu (BL de 1 m3...) : mode détecté sur les autres lignes zone du même chantier dans la facture ;
4. à défaut : mode actuel du chantier, `chantier_mode_transport` (centrale béton) ou
   `chantier_mode_transport_granulat` (centrale granulat), selon `t_activite.activite_type`.

À la génération, le mode du chantier est fiable : `recalculer_mode_transport_bl()` remet les BL non facturés
au nouveau mode quand le chantier change. Contrôle sur la base de dev (14 041 lignes zone) : 3 174 lignes
facturées au m3 sur des chantiers passés depuis au voyage sont correctement détectées ; 320 lignes (2,3 %)
restent ambiguës sur l'historique et prennent le mode actuel du chantier.

## Fichiers
**Créés**
- `app/Services/ligne_facture_cout_service.php` : `mettre_a_jour_facture($facture_numero)`, `cout_unitaire(...)`.
- `docs/ligne_facture_cout_generation.md`.

**Modifiés**
- `public/inc/fonction.inc.php` : fonction `mettre_a_jour_cout_lignes_facture($facture_numero)` pour le legacy. Elle était dans `init.inc.php`, qui est ignoré par git ; déplacée le 2026-10-26 et entourée de `function_exists` pour ne pas planter si un `init.inc.php` local la contient encore.
  Démarre Laravel sans traiter la requête et **sans** `HandleExceptions` (sinon les warnings legacy, ex. le
  `session_start()` en tête de `bl_controller.php` chargé par les routes, deviennent des exceptions).
  Toute erreur est journalisée (`error_log`) et ne bloque jamais la génération de la facture.
- `app/Http/Controllers/facture_controller.php` : appel dans `creer_avoir()` et `valider_ligne()` (création et modification de ligne).
- Scripts legacy, appel après insertion des lignes :
  - `public/generation_facture/generation_facture_selectionner_client.php` (génération BL → facture, dans `calculer_totaux_facture()`, factures définitives uniquement)
  - `public/pre_facture/transformer_facture.php`
  - `public/commande/transformer_facture/transformer_facture_valider.php`
  - `public/devis/transformer_facture/transformer_facture_valider.php`
  - `public/facture/valider_ligne_facture.php`, `public/pre_facture/valider_ligne_facture.php`
  - `public/facture/generer_avoir.php`, `public/pre_facture/generer_avoir.php`
  - `public/trans/action_trans_entete_facture_comptant.php`, `public/trans/action_trans_ligne_facture_comptant.php`
- `public/calculer_cout_article_dans_ligne_facture.php` : réécrit, recalcul de l'historique via le service
  (paramètres GET optionnels `date_debut`, `date_fin` sur `facture_date`).

**Non modifiés (volontairement)**
- `reglement/reglement_valider*.php`, `supprimer_reglement()`, `deduire_acomptes()` : uniquement des lignes commentaire / acompte (coût 0).
- Copies `public/trans/*11032025.php` : anciennes versions non utilisées.

## Points d'attention
- Avoirs : coût recalculé avec la quantité de l'avoir (positif) ; le rapport le passe en négatif via `facture_avoir`.
  Un avoir de remise de prix (même quantité) retire donc tout le coût de la ligne.
- `valider_ligne()` (Laravel) en mode voyage force `ligne_facture_qte = 1` alors que le total utilise la quantité
  saisie : le coût suit `ligne_facture_qte` (comportement préexistant non modifié).
- La qualité du coût dépend des prix d'achat renseignés (sur la base de dev, tous les prix d'achat zone sont à 0).
- Recalcul complet de l'historique : ~20 s pour 3 000 factures.
