# Départ cycle : nouvelle présentation (index_v2), à côté de l'écran actuel

Même principe que la fiche client v2 (`docs/fiche_client_v2.md`). L'écran de départ cycle actuel reste celui qui s'ouvre par défaut depuis le bouton « Lancer Cycle » de la commande (mode BHP). Une nouvelle présentation existe à côté. On y accède par un **bouton invisible** (24 × 24 px, transparent) **dans le coin bas-droit de l'en-tête**. Le même bouton, au même endroit dans la nouvelle présentation, ramène à l'écran actuel.

## Ce qui change dans la nouvelle présentation (habillage seulement)

- Fond gris-vert `#f4f6f3`, cartes blanches à bordure `#d3d8d2` avec titre de section vert, comme la fiche client v2.
- En-tête : titre vert « Départ cycle » souligné ; dessous, en gras et plus gros : « Commande XXXXX - formule », puis la date et l'heure de livraison (même taille, en gras). À droite, des tuiles :
  - Commandé ;
  - Livré (`commande_accepte`) ;
  - Reste, ou **Dépassement** en rouge quand `commande_qte_restant` est négatif ;
  - BL suivant (numéro de la ventilation choisie).
- Fenêtre élargie : `#affiche_commande` (80 % dans `style.css`) passe à 96 % tant que le départ cycle v2 est affiché. La règle est dans la vue, avec `:has()`. Elle ne s'applique pas quand `#formulaire_lancer_cycle` est caché, donc la fiche commande garde ses 80 %. La croix de la page (`#filtre .fermer`, à 5 % du bord droit) se retrouve alors sous la fenêtre : la v2 a sa propre croix ronde en haut à droite de l'en-tête (`#dcv2_fermer`), qui déclenche `$('.fermer').click()`, la même fermeture qu'après « Lancer le cycle ». On ne peut pas faire passer la croix de la page au-dessus : elle est dans `#filtre` (fixe, z-index 10, opacité 0,7), qui forme son propre empilement sous la fenêtre (z-index 11).
- Trois colonnes à partir de 1200 px (`col-xl-4 / 4 / 4`, trois tiers) ; en dessous, deux colonnes et la troisième passe dessous en pleine largeur :
  - cartes Véhicule et chauffeur, Quantités (unités dans les champs, quantité à produire en gras) ;
  - livraison : client, chantier, réf. commande client, zone. Sous le client et sous le chantier, leur adresse (icône repère), au format « adresse1, adresse2 · CP ville », puis leurs téléphones renseignés (icône téléphone) : Bureau / GSM / Domicile pour le client (`client_tel_pro`, `client_tel_mobile`, `client_tel_dom`), Téléphone / Portable pour le chantier (`chantier_numero_telephone`, `chantier_numero_portable`). Le CP n'est pas répété quand la ville le contient déjà (ex. `client_ville` = « 38570 THEYS »). C'est l'adresse du client / chantier de la commande : les recherches (`client.liste_groupe`, `chantier.liste_groupe`) ne renvoient pas l'adresse, donc le bloc adresse et téléphones est caché dès qu'on choisit un autre client ou chantier dans cet écran, et réapparaît si on revient au choix d'origine. Le script cherche les champs dans `.depart-cycle-v2`, car la fiche commande a aussi des `#client_commande` / `#chantier_commande` ;
  - cartes Bon de livraison (ventilation, modèle d'impression), Options (Cycle / Impression), Malaxeur (malaxeur, point de chargement, Gâchée pleine, Optimalax). Toutes les cases de l'écran sont des interrupteurs (Options : Transport incomplet, BL sans production, Blocage en départ cycle, Impression pesées, Démat BL, Imprimer BL si Démat ; Malaxeur : Gâchée pleine, Optimalax). Les interrupteurs restent des cases à cocher, avec les mêmes id et name, simplement dessinées en bouton par CSS : le `custom-switch` n'existe pas dans le Bootstrap 4.1.1 chargé par la page.
- En dessous, Lignes de commande et Composition côte à côte, chacune sur la moitié de la largeur (`col-lg-6`, même hauteur). Elles sont hors du `<form>` : ce sont des tableaux sans champ, donc l'envoi ne change pas (vérifié : mêmes 26 champs). Les tableaux prennent le style `.dt-moderne` (`public/inc/css/style.css`).
- Boutons du bas : Commande au trait, « Lancer le cycle » seul bouton plein.

## Ce qui ne change pas

- **Mêmes `id` et `name` de champs** : les deux formulaires envoient les 26 mêmes champs (vérifié en comparant le rendu des deux vues). L'enregistrement (`depart_cycle_controller::lancer_cycle_valider`) n'est pas touché.
- Les parties incluses (`depart_cycle_vehicule`, `_chauffeur`, `_client`, `_chantier`, `_zone`, `_composition`, `commande.commande_ligne_commande_table`) sont reprises telles quelles, avec leurs scripts. La v2 les rhabille seulement par CSS (classe `.dcv2-inclus` : libellé remonté au-dessus, champ et loupe sur une ligne). Elles ne sont pas modifiées et l'écran actuel les garde comme avant.
- Malaxeur / point de chargement : la v2 réécrit le contenu de `depart_cycle_par_config_centrale` avec les mêmes id. L'écran actuel continue d'inclure le fichier.

## Fonctionnement

- `depart_cycle_controller::index()` affiche `depart_cycle.index_v2` si la requête porte `fiche_version=2`, sinon `depart_cycle.index`. Il transmet désormais aussi `par_config_centrale`. Avant, cette variable venait seulement de la fiche commande qui inclut l'écran ; l'appel direct de la route aurait échoué.
- Le script a été sorti de `index.blade.php` dans `depart_cycle/index_script.blade.php` (déplacement à l'identique), inclus par les deux vues. Ajouts :
  - clic sur `.bascule_depart_cycle` : recharge le départ cycle de la même commande dans l'autre présentation (GET `depart_cycle.index` avec `commande_id` et `fiche_version`), dans `#formulaire_lancer_cycle` de la fiche commande ;
  - le numéro de BL suivant lit l'attribut `data-prefixe` de `#depart_cycle_no_bl` (vide dans la v2, « No BL: » par défaut). Sans ventilation choisie, il n'affiche plus « undefined » (dans les deux présentations).
- Rhabillage des parties incluses : la ligne `.form-group.row` devient une grille (`minmax(0, 1fr) auto`), avec le libellé sur toute la largeur, puis le champ et la loupe. Un montage en flex ne marche pas : le champ, avec une base à 0, restait à côté du libellé avec une largeur nulle et sortait de la carte (constaté au rendu dans Chrome).
- Le choix n'est pas mémorisé : chaque commande ouverte affiche l'écran actuel. Basculer recharge l'écran : une saisie non validée est perdue.

## Changement de chantier dans le départ cycle (v1 et v2)

Défaut corrigé dans `depart_cycle/depart_cycle_chantier.blade.php`. Le script cherchait ses champs par id (`#chantier_commande`, `#chantier_id`, `#client_id`, `#liste_chantier_commande`). Ces id existent aussi dans la fiche commande, plus haut dans la page, et `$('#id')` prenait les siens. Conséquences :
- la saisie d'un chantier dans le départ cycle ne déclenchait rien (pas de suggestions, `chantier_id` du départ cycle jamais mis à jour) ;
- au changement de chantier de la **fiche commande**, ce script s'exécutait en double du sien ;
- les cases Impression pesées et Gâchée pleine visées étaient celles de la fiche commande (`#commande_imp_pesee`, `#commande_gachee_pleine`), pas celles du départ cycle.

Maintenant, le script cherche ses champs dans `#formulaire_depart_cycle`. Au choix d'un chantier, `depart_cycle_impression_pesee` et `depart_cycle_gachee_pleine` reprennent `chantier__impression_pesee` et `chantier_gachee_pleine` (`commande_laravel.chercher_information_chantier`). Les appels qui modifiaient des champs de la fiche commande ont été retirés : `chercher_temps_acces_chantier()`, `chercher_zone_chantier()`, commentaire et numéro de contact. Ils ne s'exécutaient de fait qu'au changement de chantier de la fiche commande, qui a le même traitement dans `commande/commande_chantier.blade.php`.

Vérifié dans Chrome (headless), avec la fiche commande v1 et v2 et le départ cycle chargés ensemble, et le serveur simulé : suggestions dans le départ cycle, `chantier_id` du départ cycle mis à jour, cases du départ cycle cochées selon le chantier ; chantier, cases et contact de la fiche commande inchangés.

Restent tels quels (même cause, non demandés) : la loupe de recherche du chantier (`#btn_rechrche_chantier_commande`) et la partie client (`depart_cycle_client`) visent toujours les champs de la fiche commande.

## Zone et transport incomplet enregistrés dans le BL (v1 et v2)

Avant, deux cases du départ cycle lisaient des colonnes absentes de `t_commande`, et le lancement n'enregistrait pas leur saisie :
- **Zone** : la liste lisait `$commande->zone_id`, qui n'existe pas (seul le chantier a une `zone_id`). Rien n'était présélectionné, donc la première zone de la liste s'affichait, et le service enregistrait `$bl->zone_id = $commande->zone_id`, donc une zone vide sur chaque BL créé au lancement.
- **Transport incomplet** : la case lisait `commande_ti` (absent, donc toujours décochée), le contrôleur ne la lisait pas et le service écrivait toujours `bl_transport_incomplet = 0`.

Maintenant :
- `commande::zone_ligne_commande_id()` (nouveau) renvoie l'article de la ligne de zone de la commande (`ligne_commande_type_article = 4`, la première par numéro de ligne), ou null. `depart_cycle/depart_cycle_zone.blade.php` (commun aux deux présentations) présélectionne cette zone.
- `lancer_cycle_valider()` valide `zone_id` (doit exister dans `t_zone`) et transmet `zone_id` et `transport_incomplet` (case `commande_ti`) au service.
- `depart_cycle_service::creerBl()` enregistre `bl.zone_id` = la zone choisie à l'écran (à défaut, la ligne de zone de la commande) et `bl_transport_incomplet` = 1 si la case est cochée, 0 sinon.

Vérifié sur la base locale : commande 93513, ligne de zone 2, donc « 001->TRANSPORT ZONE 1 » présélectionné (avant : « 000->TRANSPORT ZONE 0 », première de la liste) ; une zone inexistante est refusée par la validation. La création complète du BL n'a pas pu être testée en local (colonne `bl_point_chargement` absente de la base locale, voir l'encart retour béton).

**Non modifié** : les lignes du BL sont toujours copiées des lignes de la commande, y compris la ligne de zone, avec son article et son prix. Si on choisit une autre zone à l'écran, `bl.zone_id` prend la nouvelle zone mais la ligne de zone du BL garde celle de la commande.

## Lignes de commande classées par type (v1 et v2)

Dans le départ cycle, les lignes de commande sont regroupées par type de ligne, puis classées par numéro de ligne à l'intérieur d'un type. L'ordre des types est : formule (0), service (1), ajout (2), produit (3 et 5 ensemble), zone (4).
- `commande/commande_ligne_commande_table.blade.php` envoie `tri_type_article=1` quand `$prefix == 'depart_cycle'`, donc dans les deux présentations du départ cycle.
- `commande_controller::ligne_commande_table()` ajoute alors le tri par type avant le tri existant par `numero_ligne_commande`.
- Sans ce paramètre (fiche commande, PDF personnalisé), l'ordre reste celui des numéros de ligne.

Vérifié sur la commande CB230626095845 : types 4, 0, 2, 3 sans le tri, 0, 2, 3, 4 avec.

## Tuiles météo (v2)

Dans l'en-tête, à gauche des quantités et séparées d'elles par un trait vertical : **Température** (icône thermomètre) et **Vent** (icône dessinée en SVG dans la vue, car `fa-wind` n'existe pas dans le Font Awesome 5.0.13 chargé par la page). Elles reprennent le style des autres tuiles.

**Aucune source de mesure n'est encore branchée** : les tuiles affichent « — ». Pour les remplir, il suffit d'appeler `dcv2_afficher_meteo({temperature, vent, niveau_temperature, niveau_vent, detail_temperature, detail_vent})`, définie en bas de la vue :
- °C avec une décimale et une virgule, km/h arrondi ;
- `niveau_*` : `''` (normal), `'alerte'` (orange) ou `'danger'` (rouge) ;
- `detail_*` : texte de la bulle au survol (ex. rafales, direction, heure de la mesure) ;
- une valeur `null` remet « — ».

Restent à décider : la source (sonde ou anémomètre de la centrale, ou service météo), le rafraîchissement et les seuils d'alerte.

## Encart Retour béton (v2)

Sous Quantités, une carte « Retour béton » regroupe :
- **Quantité retour** : le champ `depart_cycle_qte_retour_beton`, sorti de la carte Quantités, avec le même id et le même name ;
- **BL retour** : la liste `depart_cycle_bl_retour_id` des BL du jour non annulés (« Aucun » par défaut), affichés sous la forme code · quantité · client / chantier ;
- la **formule retour** du BL choisi, affichée dessous dans un bandeau vert (code et appellation commerciale), lue dans les attributs `data-` de l'option, sans appel au serveur.

Côté serveur :
- `depart_cycle_controller::index()` passe `bls_retour` (v2 seulement) via `bls_retour_du_jour()`. La formule d'un BL est sa `formule_id` ; si elle vaut 0 (cas de certains BL), c'est l'article de sa ligne béton (`ligne_bl_type_article = 0`), dans `ajouter_formule_retour()`.
- `lancer_cycle_valider()` valide `depart_cycle_bl_retour_id`. Si un BL est choisi, il doit exister et la quantité retour doit être > 0 ; sinon l'erreur est mise sur le champ concerné.
- Le contrôleur transmet `bl_retour` au service. `depart_cycle_service::creerBl()` remplit `bl_code_bl_retour_beton` (code du BL), `bl_code_formule_retour_beton` (`formule_code`) et `bl_appellation_commercial_retour_beton` (`formule_app_commerciale`, « App commerciale » de la fiche formule, et non `formule_libelle_commercial`), coupés à 25 / 25 / 50 caractères. Ces colonnes étaient jusqu'ici enregistrées vides ; ce sont celles affichées par le legacy (`public/bl/bl_afficher_tr.php` : « Qté remplacée », « BL origine », « Formule origine »).
- La v1 n'envoie pas de BL retour : ses BL restent enregistrés comme avant (colonnes vides).

Vérifié sur la base locale (date fixée au 14/09/2026, dernier jour avec des BL à formule) : 103 BL proposés ; le BL 007247083 donne la formule C25 XC1 D22 S3. La création complète d'un BL n'a pas pu être testée en local : la colonne `bl_point_chargement`, déjà écrite par le service avant ces changements, n'existe pas dans la base locale et aucune migration ne la crée.

## Point d'attention

Les scripts des parties client/chantier s'accrochent à `#client_id` / `#chantier_id`. Ces id existent aussi dans la fiche commande, qui est plus haut dans la page : jQuery prend donc l'élément de la commande. C'était déjà le cas avant. Chaque bascule réexécute ces scripts et ajoute donc un gestionnaire de plus sur ces champs de la commande (par exemple, un changement de chantier relance la recherche d'information une fois de plus). Ce n'est pas bloquant, mais c'est à garder en tête si on rend la bascule mémorisée.

## Fichiers

- `resources/views/depart_cycle/index_v2.blade.php` (nouveau) : vue et styles (préfixe `.depart-cycle-v2` / `.dcv2-*`).
- `resources/views/depart_cycle/index_script.blade.php` (nouveau) : script commun.
- `resources/views/depart_cycle/index.blade.php` : script remplacé par `@include('depart_cycle.index_script')`, bouton invisible dans l'en-tête.
- `app/Http/Controllers/depart_cycle_controller.php` : choix de la vue, `par_config_centrale`.

## Pour faire évoluer la v2

Ajouter un champ dans les **deux** vues, avec le même `id` / `name`, tant que les deux présentations cohabitent.
