# Fiche client, onglet Synthèse : carte « Marge HT »

## Fonctionnalité
Nouvelle carte **Marge HT (CA - coût)** dans l'onglet Synthèse (fiche client v1 et v2), en tête de la 2e ligne de cartes :
- marge en € et en %, sur la même période que la carte CA (année en cours au 01/01 → aujourd'hui, ou année passée complète) ;
- évolution de la marge € par rapport à N-1 (même période), et ligne « N-1 : marge € — % » ;
- clic → modale de détail facture par facture : montant HT, coût HT, marge HT, marge %, avec le total.

**Droit** : carte, montants et détail réservés au droit **« Visualiser coût facture »** (`profil_visualiser_cout_facture`,
voir `docs/facture_cout_marge_profil.md`). Sans ce droit, la 2e ligne garde ses 3 cartes (`col-md-4`), `synthese()` n'envoie
pas les clés `marge_*` et `synthese_detail?indicateur=marge` renvoie 401. L'onglet lui-même dépend de `profil_kpi_finance`.

## Calcul
- Coût d'une facture = somme des `t_ligne_facture.ligne_facture_cout` (constante `client_controller::COUT_FACTURE_SQL`).
- Mêmes règles que le CA de la Synthèse : toutes les factures (validées ou non), avoirs en négatif sur le CA **et** sur le coût.
- Marge = CA - coût ; marge % = marge / CA × 100 (`null`, affiché « - », si CA nul).

## Fichiers
- `app/Http/Controllers/client_controller.php` : constante `COUT_FACTURE_SQL` ; `synthese()` ajoute `cout` au cumul N / N-1 et renvoie
  `marge_n`, `marge_pourcent_n`, `marge_n1`, `marge_pourcent_n1` (si droit) ; `synthese_detail()` ajoute l'indicateur `marge`
  (colonnes `montant` et `cout`) et la clé `cout` dans les lignes.
- `resources/views/client/form.blade.php` et `form_v2.blade.php` : carte `data-indicateur="marge"` sous `@if`, colonnes de la 2e ligne
  en `col-md-3` avec la carte, `col-md-4` sans.
- `resources/views/client/form_script.blade.php` : `synthese_pourcent()`, affichage de la carte dans `charger_synthese()`,
  entrée `marge` dans `details_synthese`.

## ⚠️ Données historiques
`ligne_facture_cout` n'est calculé à la génération que depuis le 2026-10-24 (`docs/ligne_facture_cout_generation.md`).
Les factures plus anciennes ont un coût à 0 : la marge vaut alors le CA. Pour une marge exploitable sur l'historique, lancer
`public/calculer_cout_article_dans_ligne_facture.php` (paramètres `date_debut` / `date_fin` possibles), et vérifier que les prix
d'achat (produits, zones, services, ajouts) sont renseignés.

## Vérifications
- Client 2247, 2026 : CA 2 459,55 €, coût 33,99 €, marge 2 425,56 € (98,62 %), identique à un contrôle SQL indépendant ;
  le détail (40 factures) donne les mêmes totaux. Une seule facture a un coût calculé sur la base de dev, d'où le taux élevé.
- Profil sans droit coût : pas de clé `marge_*`, détail refusé (401), carte absente, 2e ligne inchangée.
- Non testé dans le navigateur (session non connectée).
