# Avancement commercial (fichier CRM) et saisie dans la fiche chantier

## Objectif
Nouveau fichier CRM « Avancement commercial » (code + libellé), choisi dans la fiche chantier, onglet Gestion commerciale, panneau « Informations commerciales ».

## Base de données
| Migration | Contenu |
|---|---|
| `2026_11_08_1000_V905001_NB_t_avancement_commercial.php` | Table `t_avancement_commercial` : `id_avancement_commercial` (increments, clé primaire), `avancement_commercial_code` varchar(12) unique, défaut `''`, `avancement_commercial_libelle` varchar(50), défaut `''` |
| `2026_11_08_1010_V905001_NB_t_chantier_avancement_commercial_id.php` | `t_chantier.avancement_commercial_id` int, défaut 0 (0 = aucun) |

Les deux migrations sont protégées par `hasTable` / `hasColumn` et donc rejouables.

## Fichier CRM
- **Modèle** : `app/Models/avancement_commercial.php` (trié par code, sans timestamps).
- **Contrôleur** : `app/Http/Controllers/avancement_commercial_controller.php`
  - `index`, `data_table`, `afficher_formulaire`, `enregistrer` (code obligatoire, 12 caractères max, unique ; libellé obligatoire, 50 max), `supprimer`. Traçabilité « Avancement commercial ».
  - La suppression est refusée si un chantier utilise l'avancement.
  - `data_table_avancement_commercial_fiche_annexe` : liste de recherche.
  - `liste_groupe` : recherche dans la saisie, sur le code ou le libellé, 20 résultats max.
- **Routes** : `routes/web/avancement_commercial.php` (préfixe `/avancement_commercial`).
- **Vues** : `resources/views/avancement_commercial/index.blade.php` et `form.blade.php`. Les droits sur les boutons suivent `profil_fichier_crm`, comme les autres fichiers CRM (Ajouter et Nouveau : 0/1/3 interdits ; Valider : 0/1 interdits ; Supprimer : 5 uniquement).
- **Fiche annexe** : `resources/views/fiche_annexe/table_avancement_commercial_fiche_annexe.blade.php`. Avec `type_fiche_annexe = 'chantier'`, un double clic renseigne `#avancement_commercial_id` et la zone de saisie, puis ferme la fenêtre.
- **Menus** : Fichier > Fichier CRM, dans le nouveau menu (`public/inc/menu/menu_definition.php`, `bhp => false` comme Concurrent / Motif échec) et dans l'ancien menu (`public/inc/menu/menu_ancien.inc.php`, dans le bloc non BHP ; ouverture automatique du sous-menu sur la page).

## Fiche chantier
- **`resources/views/chantier/form.blade.php`** :
  - Onglet Gestion commerciale : nouveau panneau « Informations commerciales », placé avant « Informations relatives à l'obtention du chantier ». Champ Avancement : zone de saisie avec liste proposée (`partials.recherche_dans_saisie`), champ caché `avancement_commercial_id`, bouton loupe.
  - Fenêtre de recherche `#affiche_recherche_dans_chantier`, placée avant le `<form>` pour rester hors du `serialize()`. Son style est ajouté au groupe des fenêtres de recherche dans `style.css`.
- **`resources/views/chantier/afficher_recherche.blade.php`** : fenêtre de recherche de la fiche chantier, avec un `switch` sur `fiche_recherche`, réutilisable pour d'autres loupes.
- **`app/Http/Controllers/chantier_controller.php`** :
  - `afficher_formulaire` : chargement de `lier_avancement_commercial`.
  - `enregistrer` : validation `avancement_commercial_id` (nullable|integer), enregistré par le `fill()`.
  - Nouvelle méthode `afficher_recherche`, route `chantier/chantier_recherche` (`chantier.chantier_recherche`).
- **`app/Models/chantier.php`** : relation `lier_avancement_commercial`. L'API de transfert peut ainsi résoudre `"avancement_commercial": {"avancement_commercial_code": "…"}` ; sans cette clé dans le contenu reçu, rien ne change.

## À faire
- Lancer `php artisan migrate`. La migration `2026_11_05_1000_V905001_NB_t_bl_reglage_trappe_id` est aussi en attente ; elle est rejouable.

## CSS (public/inc/css/style.css)
- `.ajouter_avancement_commercial` : ajouté au groupe des boutons « Ajouter » des listes (calé à droite).
- `#affiche_avancement_commercial` : ajouté au groupe des fenêtres de saisie (fenêtre fixe centrée, cachée par défaut, comme `#affiche_motif_echec_reussite`).
- Fiche de saisie (`avancement_commercial/form.blade.php`) : Code et Libellé l'un sous l'autre, dans un panneau `.cadre` avec un titre `.fcv2-section`, comme les panneaux de la fiche chantier.
- Onglet Gestion commerciale de la fiche chantier : les panneaux « Informations commerciales » et « Informations relatives à l'obtention du chantier » sont côte à côte (`row` + deux `col-md-6 d-flex`, panneaux `flex-fill` à hauteur égale). Le panneau Actions reste dessous, en pleine largeur.
