# Guide utilisateur : devis et sections de devis

Documentation utilisateur de l'écran Devis (Laravel, `/devis_laravel`) et des sections de devis livrées le 08/11/2026 (`docs/sections_devis.md`). Même présentation que les guides précédents (charte ADLER, encadrés, figures numérotées), produite avec le skill `adler-guide-utilisateur`.

## Fichiers livrés

- `docs/Guide_utilisateur_devis.docx`
- `docs/Guide_utilisateur_devis.pdf` (16 pages, 16 figures)

Le script du guide (`guide_devis_docx.php`) et les captures restent dans le scratchpad de la session (non versionnés), comme pour les guides précédents.

## Contenu

1. Vue d'ensemble : menus (Commercial > Devis, Fichier > Fichier divers > Sections de devis, liste « Section devis » des fiches article, Tarifs), règle « Valider du devis / Valider des lignes », étapes.
2. Liste des devis : filtres (période sur la date du devis, société, commercial, état, Relance dans (jours)), recherche générale et par colonne, Colonnes, Excel, ligne dépliée avec totaux.
3. En-tête : code automatique (date-heure), cadre Information (client / chantier en compte ou saisis à la main), onglet Options (état, dates, Qte prev, TVA du devis…), autres onglets.
4. Lignes : zone de saisie, recherche d'article (formules limitées à la centrale du devis), ajout de plusieurs services, commentaires, modifier / supprimer / déplacer, ligne non facturable, contributions automatiques, zone franco et totaux.
5. Sections de devis : section par type de ligne, sous-sections, glisser-déposer limité à la section, anciens devis classés à la première modification, titres de section (onglet Option présentation), écran Sections de devis (section principale, sous-section, messages), liste « Section devis » des fiches article.
6. Prix : origine du prix, Recalculer les prix, Copier les prix dans tarif (avec ses effets hors devis), Basculer tarif.
7. PDF, envoi par mail, Mails envoyés, pièces jointes.
8. Suivi et transformation : état, relance, Trans commande (contrôles et messages), Trans facture / Trans BL, Dupliquer, Supprimer, Traçabilité, droits du profil (niveaux 0 à 5, voir le coût, devis comptant uniquement).
9. FAQ (8 questions).

## Points vérifiés dans le code

- Droits (`devis_controller`, `devis/form.blade.php`) : `profil_devis` 0 = pas d'accès ; création refusée en 0/1/3 ; modification refusée en 0/1/2 ; suppression de devis et de ligne réservée au niveau 5 ; niveau 1 : transformation commande / facture et envoi mail grisés. `profil_devis_comptant_uniquement` limite la liste et l'enregistrement aux clients comptant.
- Enregistrement : société, centrale, état, date et TVA obligatoires (une TVA « Aucune » = 0 passe la validation et laisse la TVA de chaque article). Message « Devis enregistrée ! ».
- Dates : changer la date du devis recalcule Validité (+ 30 jours) et Date relance (+ `parametre_devis_temps_relance`).
- Filtre « Relance dans (jours) » : devis à l'état En cours avec une date de relance ≤ aujourd'hui + N jours.
- Ligne non facturable : `ligne_devis_enregistrer` enregistre la quantité à 0 quand Facturable est décoché.
- Ligne modifiée : `ligne_devis_prix_force` = 1 ; changement d'article ou de type : section remise à 0 et ligne reclassée.
- Plusieurs services (`valider_services_multiple`) : quantité 1, ou Qte prev si le service est au m³ (`service_type_unite == 1`).
- Contributions automatiques : appelées au choix du client, du chantier ou de la centrale par la loupe (déclencheur `change` sur les champs cachés), seulement si une centrale est choisie ; quantité = Qte prev, mise à jour au changement de Qte prev.
- Recalculer les prix : remplace le prix de toutes les lignes hors commentaires, y compris les prix saisis.
- Copier les prix dans tarif : crée ou met à jour les tarifs (société / groupe centrale / sous-famille / client / chantier) puis recalcule les BL non facturés concernés (`modifier_prix_bl.php`).
- Trans commande : client et chantier en compte ; date et heure obligatoires ; au moins un béton ou granulat, un seul béton, une seule zone ; articles rattachés à la centrale ; n'enregistre pas l'état « Gagné » sur le devis. Trans facture / BL : centrale exigée en plus (`transformer_facture_valider.php` et `transformer_bl_valider.php` restent legacy).
- Supprimer : refusé si `t_commande.devis_id` pointe sur le devis.
- Dupliquer : nouveau code, état En cours, dates du jour, lignes (prix forcé remis à 0) et pièces jointes copiées.
- Titres de section : non supprimables à la main (message de `ligne_devis_supprimer`), ajoutés au premier Valider d'un nouveau devis, case cochée par défaut pour les nouveaux devis seulement.

## Méthode des captures

- Application locale (`http://localhost`), navigateur piloté, html2canvas et récepteur temporaire `public/_capture_doc_tmp.php`, **supprimé** à la fin avec `public/_captures_doc_tmp/`.
- Données : devis d'août 2026 de la base de dev, devis **140826110621** (CACTUS ENERGIE, chantier 002 NOYAREY DALLAGE) pour la fiche, les lignes et la transformation.
- Confidentialité : liste des devis filtrée sur des clients sociétés (particuliers masqués), colonnes Contact et E-mail masquées ; dans la fiche, e-mail remplacé par `contact@exemple.fr`, contact vidé et commercial mis sur « Aucun » le temps de la capture (rien enregistré).
- Titres de section : aucun devis de la base n'avait encore de sections. Une **copie temporaire** du devis 140826110621 (code `999999999901`, titres activés) a été créée par script, classée par `renumeroter_lignes_devis()`, capturée, puis **supprimée** (devis et lignes, vérifié : 0 restant).
- Fenêtre Transformation en commande ouverte puis fermée sans valider ; sous-section « Pompage » saisie dans le formulaire sans l'enregistrer ; la liste « Section devis » de la fiche service AMOR est rendue en liste dépliée le temps de la capture.
- Pas de capture du menu PDF : aucun modèle de devis dans l'installation locale.

## Anomalies relevées (non corrigées)

- ~~`transformer_facture_valider.php` : le message d'erreur « Erreur lors de création de facture » est affiché avec la classe `alert-success` (vert).~~ **Corrigé** dans la même session : bandeau rouge (`alert-danger`) et texte « Erreur lors de la création de la facture ! ». Aucun écran ne compare ce texte ; la réussite (« Facture bien créée ! ») reste en vert.
- ~~Trans facture / Trans BL : quand la centrale est sur « Aucune », le message affiché est « Le client et le chantier doivent être en compte ! », qui ne parle pas de la centrale.~~ **Corrigé** dans la même session (`devis/form.blade.php`) : contrôle séparé, message « Choisissez la centrale du devis ! » quand le client et le chantier sont en compte mais la centrale est sur « Aucune ». Vues compilées ; non testé dans le navigateur.
- Une ligne enregistrée non facturable perd sa quantité (mise à 0) : la quantité saisie n'est pas conservée.
- ~~La transformation en commande ne passe pas le devis à l'état « Gagné (commande) ».~~ **Corrigé** dans la même session :
  - `devis_controller::transformer_commande_valider` passe `devis_etat` à 1 après la création de la commande (s'il ne l'était pas déjà) et écrit une traçabilité « Modification » du devis ;
  - `devis/transformer_commande.blade.php` met aussi la liste « Etat devis » de la fiche ouverte sur « Gagné (commande) » et rafraîchit la liste des devis, pour qu'un clic sur Valider après la transformation ne remette pas l'ancien état ;
  - seulement l'écran Laravel : l'ancien script `public/devis/transformer_commande/transformer_commande_valider.php` n'est pas modifié ;
  - vérifié par `php -l`, la compilation des vues et `DevisTest` (11 tests OK). La transformation elle-même n'a pas été rejouée : elle appelle l'API Google Maps (temps d'accès au chantier).
- « Devis supprimé ! » est affiché dans un bandeau rouge (classe `alert-danger`) alors que c'est une réussite.

## Fautes d'orthographe corrigées (même session, à la demande)

| Avant | Après | Fichiers |
|---|---|---|
| Devis enregistrée ! | Devis enregistré ! | `devis_controller` |
| devis supprimé ! | Devis supprimé ! | `devis_controller` |
| Vous avez pas les droit ! | Vous n'avez pas les droits ! | `devis_controller` (copier les prix) |
| Prix copier dans tarif ! | Prix copiés dans le tarif ! | `devis_controller` |
| Ligne enregistrée . / Ligne supprimée . | sans espace avant le point | `devis_controller` |
| Choisissez un produit . / Choisissez une ligne . | sans espace avant le point | `devis/form.blade.php` |
| Lignes taxes ajoutée / modifiée, Erreur lors d'ajout / lors  de modification lignes taxes | Lignes de taxes ajoutées / modifiées, Erreur lors de l'ajout / de la modification des lignes de taxes | `devis_controller` |
| Date et heure sont obligatoire ! | … obligatoires ! | `devis_controller`, `public/devis/transformer_commande/transformer_commande_valider.php`, `public/devis/transformer_bl/transformer_bl_valider.php` |
| Facture bien crée ! | Facture bien créée ! | `transformer_facture_valider.php` **et** les deux écrans qui comparent ce texte (`devis/transformer_facture.blade.php`, `public/devis/transformer_facture/transformer_facture_affiche.php`) |
| Validee | Validée | `devis/transformer_commande.blade.php`, `transformer_commande_affiche.php` |
| Veuillez Choisissez les lignes | Veuillez choisir les lignes | les 3 vues de transformation Laravel et les 3 écrans legacy |
| Pour déselecte une ligne appuyez(Ctrl+click) | Pour désélectionner une ligne, décochez sa case. | vues de transformation commande / facture (Laravel et legacy) ; le texte d'origine décrivait aussi un geste faux |

Non modifié : `public/inc/js/devis/devis.js` (ancien écran) compare « Devis enregistrée ! » et « Prix copier dans tarif ! » aux réponses des scripts legacy, qui n'ont pas changé.

Vérifié : `php -l` sur les fichiers PHP, `php artisan view:cache`, `tests/Feature/DevisTest.php` (11 tests OK, PHP 8.2). Le guide cite les nouveaux libellés ; la figure 16 (Transformation en commande) montre encore « Validee » et l'ancienne phrase, capturées avant la correction.
- html2canvas rogne la première lettre du libellé à côté du toggle `.toggle-vert` (« Afficher les titres de section » apparaît « ıfficher » sur la figure 10) : artefact de capture, pas de l'écran.
