# Fiche chantier : panneau « Réalisation / ouvrage »

## Objectif
Saisir dans la fiche chantier (onglet Gestion commerciale) le type d'ouvrage, l'ouvrage, la description de l'ouvrage, les dates prévisionnelles, le cubage prévisionnel et les pourcentages de réalisation et d'obtention.

## Base de données
Migration `2026_11_08_1200_V905001_NB_t_chantier_realisation_ouvrage.php` (chaque colonne protégée par `hasColumn`), table `t_chantier` :

| Colonne | Type |
|---|---|
| `type_ouvrage_id` | int, défaut 0 |
| `ouvrage_id` | int, défaut 0 |
| `ouvrage_description` | varchar(50), défaut `''` |
| `chantier_date_debut_previsionnelle` | date, nullable |
| `chantier_date_fin_previsionnelle` | date, nullable |
| `chantier_cubage_previsionnel` | int, défaut 0 |
| `chantier_pourcentage_realisation` | int, défaut 0 |
| `chantier_pourcentage_obtention` | int, défaut 0 |

Décision : le nom demandé `chantier_poucentage_realisation` a été corrigé en `chantier_pourcentage_realisation`, pour rester cohérent avec `chantier_pourcentage_obtention`.

Les dates sont nullables, car une colonne `date` NOT NULL sans valeur par défaut serait refusée en MySQL strict.

## Type d'ouvrage et ouvrage (tables existantes)
- **`type_ouvrage_controller`** et **`ouvrage_controller`** : ajout de `data_table_<table>_fiche_annexe` (liste de recherche) et `liste_groupe` (recherche dans la saisie sur le code ou le libellé, 20 résultats max). Routes ajoutées dans `routes/web/type_ouvrage.php` et `routes/web/ouvrage.php`.
- **Suppression** : un type d'ouvrage ou un ouvrage utilisé par un chantier ne peut plus être supprimé (contrôle ajouté à côté des contrôles devis / commande existants).
- **Fiches annexes** : `fiche_annexe/table_type_ouvrage_fiche_annexe.blade.php` et `table_ouvrage_fiche_annexe.blade.php`. Avec `type_fiche_annexe = 'chantier'`, un double clic renseigne le champ caché et la zone de saisie.

## Fiche chantier
- **`chantier/form.blade.php`** : panneau « Réalisation / ouvrage », en pleine largeur sous les panneaux Informations commerciales / Obtention.
  - Ligne 1 : Type d'ouvrage et Ouvrage (saisie avec liste proposée et loupe), Description de l'ouvrage.
  - Ligne 2 : Début et fin prévisionnels (`type="date"`), Cubage prévisionnel (m³), % réalisation, % obtention (0 à 100).
- **Loupes** : toutes les loupes de la fiche chantier, avancement compris, portent la classe `btn_recherche_chantier` et `data-recherche="<liste>"`, avec un seul gestionnaire de clic. Pour ajouter une loupe : un bouton avec ces attributs et un `@case` dans `chantier/afficher_recherche.blade.php`.
- **`chantier_controller`** :
  - Chargement de `lier_type_ouvrage` et `lier_ouvrage`.
  - Validation : pourcentages de 0 à 100, cubage ≥ 0, dates, description de 50 caractères max.
  - Un champ vidé (null) est remis à sa valeur par défaut (`''` ou 0), car les colonnes sont NOT NULL. Ce traitement ne s'applique que si le champ est envoyé : un appel API qui ne l'envoie pas ne l'écrase pas.
- **`app/Models/chantier.php`** : relations `lier_type_ouvrage` et `lier_ouvrage`. L'API peut ainsi résoudre `type_ouvrage` / `ouvrage` par leur code.

## État
Migration passée sur la base de développement le 2026-11-08. Les tables `t_type_ouvrage` et `t_ouvrage` sont vides pour l'instant : il faut les alimenter (Fichier > Fichier de norme > Type d'ouvrage / Ouvrage) pour que les listes proposent des valeurs.
