# Sections de devis : placement automatique des lignes

Statut : **proposition validée**, étapes 1 à 5 réalisées (migrations, écran de paramétrage, section dans les fiches article, placement des lignes, titres de section). Étape 6 plus tard.

## Principe

Chaque ligne de devis appartient à une **section principale** et éventuellement à une **sous-section**. À l'ajout, la ligne se place directement au bon endroit et les lignes suivantes sont décalées : plus besoin de la glisser à la main.

## Table `t_section_devis`

| Colonne | Type | Rôle |
|---|---|---|
| `id_section_devis` | int, clé primaire | |
| `section_devis_parent_id` | int, défaut 0 | 0 = section principale, sinon id de la section principale |
| `section_devis_code` | varchar(20) | Code fixe des sections principales (utilisé par le code), vide pour les sous-sections |
| `section_devis_libelle` | varchar(50) | Titre affiché à l'écran et sur le PDF |
| `section_devis_ordre` | int | Ordre d'affichage (10, 20, 30…) |
| `section_devis_titre` | varchar(100), défaut `''` | Sections principales seulement : texte de la ligne de titre ajoutée au devis (vide = pas de titre). Pré-rempli avec le libellé en majuscules |

Table en **InnoDB** (le moteur par défaut du serveur est MyISAM, qui ignore les transactions).

Convention du projet : les liens `*_id` sont des entiers à 0 par défaut (0 = aucun), pas des colonnes nullables.

### Sections principales (créées par la migration)

Renommables et réordonnables, mais ni supprimables ni ajoutables : le code s'appuie sur leur code.

| Ordre | Code | Libellé par défaut |
|---|---|---|
| 10 | `BETON` | Béton |
| 20 | `GRANULAT` | Granulat |
| 30 | `TRANSPORT` | Transport |
| 40 | `SERVICE` | Services |
| 50 | `ADJUVANT` | Adjuvants |
| 60 | `AJOUT` | Ajouts |
| 70 | `CONTRIBUTION` | Contributions |

### Sous-sections (seul paramétrage)

Créées librement sous une section principale. Exemples : Béton → Mortier, Chape, Norme, Hors norme ; Services → Pompage, Tapis, Prestation.

Pas de section ni de sous-section « Options » (décision du 08/11/2026).

## Rattachement des articles

Colonne `section_devis_id` (int, défaut 0) sur 4 tables d'articles, avec une liste « Section devis » dans chaque fiche, limitée aux sections autorisées :

| Table | Sections proposées |
|---|---|
| `t_formule` | Béton et ses sous-sections |
| `t_service` | Transport, Services, Adjuvants, Ajouts, Contributions et leurs sous-sections (Adjuvants et Ajouts ajoutés le 08/11/2026) |
| `t_produit` avec `produit_type` = 0 (Granulat) | Granulat et ses sous-sections |
| `t_produit` avec `produit_type` = 3 (Adjuvant) | Adjuvants et ses sous-sections |
| `t_ajout` | Ajouts, Adjuvants et leurs sous-sections (Adjuvants ajouté le 08/11/2026) |

- Fiche Produit : la liste se filtre selon le type du produit, et elle est masquée pour les autres types (liant, eau, colorant). Le type d'un produit existant n'est pas modifiable, donc pas d'incohérence possible.
- Les zones (`t_zone`) n'ont pas de colonne : toujours **Transport**.

### Section par défaut (article sans section renseignée)

| Type de ligne | Section par défaut |
|---|---|
| 0 Béton | Béton |
| 5 Granulat | Granulat |
| 4 Zone | Transport (toujours) |
| 1 Service | Services (ou la section où le service est rangé : Transport, Adjuvants, Ajouts, Contributions) |
| 3 Adjuvant | Adjuvants |
| 2 Ajout manuel | Ajouts (Adjuvants possible si l'ajout y est rangé) |

Une ligne sans sous-section se place en fin de sa section principale, après les sous-sections.

### Contributions

Les services déclarés comme contributions dans les paramètres (`articles_taxes_ids`) vont **toujours** en Contributions, quelle que soit la section du service. D'autres services peuvent aussi être rattachés à Contributions depuis leur fiche.

## Ligne de devis

`t_ligne_devis.section_devis_id` (int, défaut 0) : section de la ligne **au moment de l'ajout**.

- Changer la section d'un article ne réorganise pas les anciens devis.
- Le tri n'a pas besoin de relire les articles.
- La section pourra suivre lors de la transformation en commande ou en facture.
- À la modification d'une ligne avec changement d'article, la section est recalculée et la ligne se replace.

## Règle de placement

Clé de tri d'une ligne : (ordre de la section principale, ordre de la sous-section). Sans sous-section, l'ordre de sous-section est « infini » : fin de section.

- **Ajout** : insertion après la dernière ligne de clé inférieure ou égale, les suivantes sont décalées. Remplace la logique à 3 groupes (normale / taxe / commentaire) de `reserver_numero_ligne_devis` et `renumeroter_lignes_devis` (`app/fonctions/ajout_lignes_taxes_fonction.php`).
- **Commentaire (type 9)** : pas de section propre. Ajouté à la suite d'une ligne, il prend la section de la ligne au-dessus et reste collé à elle. Sur un devis vide, ou glissé tout en bas, il reste en fin de devis.
- **Glisser-déposer** : possible à l'intérieur d'une section principale. Une ligne glissée dans une autre section revient à sa place (comme les contributions aujourd'hui).
- **Contributions automatiques** (`ajouter_lignes_taxes`) : même règle, donc en Contributions.

## Paramétrage

- Écran « Sections de devis » : les 7 sections principales (libellé et ordre modifiables) et, sous chacune, ajout / renommage / ordre / suppression des sous-sections. Suppression refusée si un article ou une ligne de devis utilise encore la sous-section.
- Fiches Formule, Service, Produit, Ajout : liste « Section devis », vide = section par défaut.

## Présentation client : onglet « Option présentation »

Une case « Afficher les titres de section » (`t_devis.devis_afficher_titres_section`), **cochée par défaut pour les nouveaux devis**. Les devis existants restent à 0.

**Les titres sont des lignes commentaires du devis** (décision du 08/11/2026) : les 89 modèles PDF clients les impriment comme n'importe quel commentaire, **aucun modèle n'est modifié**. Ils suivent aussi en commande et en facture comme des commentaires.

Pas de sous-totaux par section. Les titres ne concernent que les sections principales (les sous-sections servent seulement au tri). Une section sans ligne n'a pas de titre. Case décochée : pas de ligne de titre.

## Étapes

| # | Étape | Statut |
|---|---|---|
| 1 | Migrations : `t_section_devis` + 7 sections principales, `section_devis_id` sur `t_formule`, `t_service`, `t_produit`, `t_ajout`, `t_ligne_devis`, option `devis_afficher_titres_section` sur `t_devis` ; modèle `section_devis` | **Fait** |
| 2 | Écran « Sections de devis » (contrôleur, vues, routes, menu) | **Fait** |
| 3 | Liste « Section devis » dans les fiches Formule, Service, Produit (filtrée par type), Ajout | **Fait** |
| 4 | Calcul de la section d'une ligne, placement, renumérotation, glisser-déposer limité à la section | **Fait** |
| 5 | Onglet Option présentation et titres de section (lignes commentaires, sans toucher aux modèles PDF) | **Fait** |
| 6 | Section conservée à la transformation en commande / facture | Plus tard |

### Étape 1 : fichiers

- `database/migrations/2026_11_08_1300_V905001_NB_t_section_devis.php` : création de la table et des 7 sections principales (insertion seulement si le code n'existe pas, migration rejouable).
- `database/migrations/2026_11_08_1310_V905001_NB_section_devis_id.php` : colonne `section_devis_id` sur `t_formule`, `t_service`, `t_produit`, `t_ajout`, `t_ligne_devis`.
- `database/migrations/2026_11_08_1320_V905001_NB_t_devis_option_presentation_section.php` : `devis_afficher_titres_section` sur `t_devis`.
- `app/Models/section_devis.php` : modèle, tri par ordre, relations parent / sous-sections, constantes des codes.

### Étape 2 : écran « Sections de devis »

Menu **Fichier divers > Sections de devis** (nouveau menu `menu_definition.php` et ancien menu `menu_ancien.inc.php`), juste après « Famille article ». Droit : `profil_fichier_divers`, mêmes niveaux que Famille article (0 = pas d'accès, Ajouter / Nouveau interdits en 0, 1, 3, Valider interdit en 0, 1, Supprimer réservé au niveau 5).

- **Liste** : chaque section principale (ligne teintée, en gras) suivie de ses sous-sections, dans l'ordre d'affichage. Tri par colonne désactivé, l'ordre vient du serveur. Colonnes : Section, Sous-section, Ordre (« 10 / 20 » pour une sous-section : ordre de la section / ordre de la sous-section), Supprimer (sous-sections seulement).
- **Fiche section principale** : code affiché en lecture seule, libellé et ordre modifiables, Supprimer grisé.
- **Fiche sous-section** (bouton « Ajouter une sous-section ») : section principale, libellé, ordre.
- **Contrôles** (`section_devis_controller`) :
  - sous-section : section principale obligatoire, libellé unique dans sa section ;
  - section principale : le parent et le code ne peuvent pas être modifiés, même si la requête les envoie ;
  - sous-section utilisée (formule, service, produit, ajout ou ligne de devis) : pas de suppression, pas de changement de section principale. La fiche affiche ce qui l'utilise (« Utilisée par : 3 formule(s)… ») ;
  - section principale : jamais supprimable.
- Traçabilité : feuille « Section devis », code = id de la section (le libellé d'une sous-section peut changer).

Fichiers :

- `routes/web/section_devis.php`
- `app/Http/Controllers/section_devis_controller.php`
- `resources/views/section_devis/index.blade.php`
- `resources/views/section_devis/form.blade.php`
- `public/inc/menu/menu_definition.php`, `public/inc/menu/menu_ancien.inc.php`

Testé sur la base de dev via le contrôleur (création, sous-section sans section, doublon, modification d'une section principale, suppression d'une principale / d'une sous-section utilisée / libre, déplacement d'une sous-section utilisée). Pas testé dans le navigateur.

### Étape 3 : liste « Section devis » dans les fiches article

- **Champ partagé** `resources/views/section_devis/champ.blade.php` (`@include` avec `codes`, `valeur`, `defaut`) : première option « Par défaut (…) » = 0, puis un `<optgroup data-section-code="…">` par section principale avec la section elle-même et ses sous-sections (« Services › Pompage »). La valeur n'est jamais vide, la colonne étant NOT NULL.
- **Sections proposées** : constantes et fonctions de `App\Models\section_devis` :
  - `CODES_FORMULE` = Béton ; `CODES_SERVICE` = Transport, Services, Adjuvants, Ajouts, Contributions ; `CODES_AJOUT` = Ajouts, Adjuvants ;
  - `codes_produit($produit_type)` : Granulat pour 0, Adjuvants pour 3, rien pour les autres types ;
  - `arbre($codes)` : sections principales et sous-sections pour la liste ; `ids_autorises($codes)` : valeurs acceptées (0 compris) pour la validation.
- **Placement** : juste après « Famille » dans les fiches Service, Formule et Ajout ; après « Code Facturation » dans la fiche Produit.
- **Fiche Produit** : `gerer_section_devis_produit()` (au chargement et au changement de type) n'affiche que le groupe du type, met à jour le libellé « Par défaut (Granulat / Adjuvants) », masque la liste et la remet à 0 pour liant, eau et colorant.
- **Validation** : `'section_devis_id' => ['sometimes', 'integer', Rule::in(section_devis::ids_autorises(…))]` dans `enregistrer()` des 4 contrôleurs (produit : selon le `produit_type` envoyé). `sometimes` : les autres enregistrements (API `enregistrer_api`, écrans qui n'envoient pas le champ) ne touchent pas à la section. Une section d'une autre catégorie (formule en Services, granulat en Adjuvants…) est refusée.
- **Testé** sur la base de dev (sous-sections temporaires supprimées ensuite) : valeurs acceptées / refusées pour chaque fiche, requête sans le champ, rendu du champ. Les vues compilent. Pas testé dans le navigateur.

Fichiers : `app/Models/section_devis.php`, `resources/views/section_devis/champ.blade.php`, `resources/views/{service,formule,produit,ajout}/form.blade.php`, `app/Http/Controllers/{service,formule,produit,ajout}_controller.php`.

### Étape 4 : placement des lignes

Nouvelle classe `app/fonctions/section_ligne_devis_fonction.php`. Les méthodes publiques `reserver_numero_ligne_devis()` et `renumeroter_lignes_devis()` de `ajout_lignes_taxes_fonction` gardent leur signature et lui délèguent : aucun appelant n'a changé (saisie d'une ligne, ajout de plusieurs services, contributions automatiques, suppression, glisser-déposer, duplication).

- **Section d'une ligne** (`section_ligne()`), dans l'ordre :
  1. contribution des paramètres (`articles_taxes_ids`, ou ancienne ligne de taxe numérotée ≥ 999) → Contributions ;
  2. section de l'article (`section_devis_id` de la formule / du service / du produit / de l'ajout) si elle est permise pour ce type de ligne (`CODES_PAR_TYPE_LIGNE`) ;
  3. sinon la section par défaut du type : 0 Béton, 5 Granulat, 4 Transport, 1 Services, 3 Adjuvants, 2 Ajouts.
- **Enregistrement** : une ligne arrive avec `section_devis_id` = 0 et reçoit sa section à la renumérotation (`classer_lignes_devis()`). Les points d'entrée n'ont donc rien à calculer.
- **Modification d'une ligne** (`devis_controller::ligne_devis_enregistrer`) : si l'article ou le type change, `section_devis_id` est remis à 0 et la ligne est reclassée et replacée.
- **Numéro d'une nouvelle ligne** : un commentaire va tout en dernier ; une autre ligne va avant les commentaires de fin de devis, puis la renumérotation la place dans sa section.
- **Renumérotation** : tri **stable** des blocs par clé (ordre de la section principale, ordre de la sous-section ; section principale seule après ses sous-sections). À clé égale, l'ordre actuel est gardé : une nouvelle ligne se place après les lignes de même clé.
- **Commentaires** : avant la première ligne → restent en tête ; après la dernière ligne → restent en fin ; entre deux lignes → suivent la ligne au-dessus (bloc ligne + commentaires).
- **Glisser-déposer** : l'ordre envoyé est enregistré puis renuméroté. Une ligne glissée hors de sa **sous-section** (ou de sa section s'il n'y a pas de sous-section) revient à sa place ; à l'intérieur, l'ordre choisi est gardé. La grille est rechargée après chaque déplacement (déjà le cas).
- **Devis existants (décision)** : leurs lignes sans section sont classées à la **première modification** du devis (ajout, modification, suppression ou déplacement d'une ligne, duplication), pas à l'affichage ni à l'impression. Un devis déjà envoyé n'est pas modifié tant qu'on n'y touche pas.
- **Tests** :
  - scénario sur un devis fictif de la base de dev (`TESTSECTION`, remis en état ensuite) : ajouts dans le désordre, contribution glissée en tête (revient en fin), inversion de deux lignes de Transport (gardée), commentaire glissé sous une formule puis ajout d'une autre formule (le commentaire suit sa formule), changement d'article d'une ligne, ancien devis sans sections ;
  - `tests/Feature/DevisTest.php` : 11 tests OK. Lancer avec PHP 8.2 (`C:\wamp64\bin\php\php8.2.18\php.exe vendor/bin/phpunit …`) : en PHP 8.3, `public/inc/fonction.inc.php` redéclare `mb_str_pad()`, qui existe déjà.

Fichiers : `app/fonctions/section_ligne_devis_fonction.php` (nouveau), `app/fonctions/ajout_lignes_taxes_fonction.php`, `app/Http/Controllers/devis_controller.php`.

### Étape 5 : titres de section

- **Migration** `2026_11_08_1330_V905001_NB_t_section_devis_titre.php` :
  - `t_section_devis.section_devis_titre`, pré-rempli pour les sections principales (« BÉTON », « TRANSPORT », « SERVICES »…) ;
  - valeur par défaut de `t_devis.devis_afficher_titres_section` passée à 1 (`ALTER … SET DEFAULT 1`), sans toucher aux devis existants ;
  - passage de `t_section_devis` en InnoDB si elle a été créée en MyISAM. La migration 1300 fixe maintenant `$table->engine = 'InnoDB'`.
- **Écran Sections de devis** : champ « Titre sur le devis » dans la fiche d'une section principale, colonne « Titre sur le devis » dans la liste.
- **Ligne de titre** : commentaire (type 9, `article_id` 0, quantité et prix 0) dont `section_devis_id` = id de la section principale. Les commentaires saisis ont `section_devis_id` = 0 : aucune nouvelle colonne pour les distinguer.
- **Gestion automatique** (`section_ligne_devis_fonction::mettre_a_jour_titres()`, appelée par chaque renumérotation) :
  - case décochée : tous les titres du devis sont supprimés ;
  - case cochée : un titre par section principale qui a au moins une ligne (hors commentaires), si son titre n'est pas vide. Doublons et titres de sections sans ligne supprimés ;
  - devis pas encore enregistré (lignes saisies avant le premier « Valider ») : pas de titre. `devis_controller::enregistrer` renumérote à la création du devis, ce qui ajoute les titres ;
  - le texte est copié à la création du titre : changer le titre dans le paramétrage ne modifie pas les devis existants. Il peut être corrigé sur le devis comme un commentaire.
- **Placement** : un titre ouvre un bloc de clé (ordre de sa section, avant toutes les sous-sections) : toujours en tête de sa section, il y revient s'il est glissé ailleurs. Les commentaires placés juste sous un titre restent sous lui.
  - Limite : quand la case est décochée, ces commentaires suivent la ligne au-dessus (dernière ligne de la section précédente) et y restent quand on recoche.
- **Fiche devis** :
  - onglet Option présentation : interrupteur « Afficher les titres de section » (classe `.toggle-vert`, champ caché à 0 pour l'envoyer décoché) ;
  - `devis_controller::enregistrer` renumérote les lignes à la création du devis et quand la case change, puis la grille des lignes est rechargée (déjà le cas) ;
  - grille des lignes : titres affichés « Titre », en gras vert (classe `ligne_devis_titre_section`) ;
  - suppression d'un titre refusée (`ligne_devis_supprimer`) avec un message : il faut décocher la case.
- **Tests** :
  - scénario dans une transaction annulée (copie d'un devis existant sous le code `TESTSECTION`) : pas de titre avant l'enregistrement, titres créés, titre vide = pas de titre, commentaire sous un titre puis ajout d'une ligne, titre glissé en fin (revient), section vidée (titre retiré), case décochée puis recochée, total HT inchangé ;
  - `DevisTest` : 11 tests OK (PHP 8.2).

Fichiers : migrations 1300 et 1330, `app/fonctions/section_ligne_devis_fonction.php`, `app/Http/Controllers/devis_controller.php`, `app/Http/Controllers/section_devis_controller.php`, `resources/views/section_devis/{index,form}.blade.php`, `resources/views/devis/form.blade.php`.

## Points encore ouverts

- Colorant et liant : vendables sur un devis ? Si oui, dans quelle section ?
