# Sous-avancement commercial (fichier CRM) et saisie dans la fiche chantier

Même principe que l'avancement commercial (voir `docs/avancement_commercial_chantier.md`). Le sous-avancement est indépendant de l'avancement : aucun lien parent / enfant entre les deux tables.

## Base de données
| Migration | Contenu |
|---|---|
| `2026_11_08_1100_V905001_NB_t_sous_avancement_commercial.php` | Table `t_sous_avancement_commercial` : `id_sous_avancement_commercial` (increments), `sous_avancement_commercial_code` varchar(12) unique, défaut `''`, `sous_avancement_commercial_libelle` varchar(50), défaut `''` |
| `2026_11_08_1110_V905001_NB_t_chantier_sous_avancement_commercial_id.php` | `t_chantier.sous_avancement_commercial_id` int, défaut 0 |

## Fichier CRM
- **Modèle** : `app/Models/sous_avancement_commercial.php`.
- **Contrôleur** : `app/Http/Controllers/sous_avancement_commercial_controller.php`. Liste, fiche, enregistrement, suppression (refusée si un chantier utilise le sous-avancement), liste de recherche, `liste_groupe`. Traçabilité « Sous-avancement commercial ».
- **Routes** : `routes/web/sous_avancement_commercial.php`.
- **Vues** : `resources/views/sous_avancement_commercial/index.blade.php`, `form.blade.php` (champs l'un sous l'autre dans un panneau), `fiche_annexe/table_sous_avancement_commercial_fiche_annexe.blade.php`.
- **CSS** (`style.css`) : `.ajouter_sous_avancement_commercial` et `#affiche_sous_avancement_commercial`, ajoutés aux mêmes groupes que l'avancement.
- **Menus** : Fichier > Fichier CRM, sous « Avancement commercial », dans le nouveau menu (`menu_definition.php`) et dans l'ancien (`menu_ancien.inc.php`).

## Fiche chantier
- **`chantier/form.blade.php`** : champ « Sous-avancement » sous « Avancement », dans le panneau Informations commerciales. Il comprend la saisie avec liste proposée, le champ caché `sous_avancement_commercial_id` et une loupe. Les deux loupes partagent le même gestionnaire de clic.
- **`chantier/afficher_recherche.blade.php`** : nouveau cas `sous_avancement_commercial`.
- **`chantier_controller.php`** : chargement de `lier_sous_avancement_commercial` et validation de `sous_avancement_commercial_id`.
- **`app/Models/chantier.php`** : relation `lier_sous_avancement_commercial`.

## À faire
- Migrations passées sur la base de développement le 2026-11-08, après le correctif ci-dessous.

## Correctif migration (nom d'index trop long)
- Au premier passage, `2026_11_08_1100_V905001_NB_t_sous_avancement_commercial` échouait : le nom d'index généré par Laravel (`t_sous_avancement_commercial_sous_avancement_commercial_code_unique`) dépasse la limite de 64 caractères de MySQL (erreur 1059). La table restait créée sans son index.
- L'index porte maintenant un nom explicite, `sous_avancement_commercial_code_unique`, et il est ajouté à part s'il manque (`SHOW INDEX`). La migration répare ainsi une table créée lors d'un premier passage en échec.
- ⚠️ Pour toute table au nom long, nommer explicitement les index (`->unique('champ', 'nom_court')`).
