# Planning : contrôle du reste à planifier (glisser-déposer et planification manuelle)

## Problème
- **Glisser-déposer, Réel** : chaque dépôt créait un tour de la capacité du camion, plafonnée au restant de la commande, sans déduire les tours déjà planifiés. On pouvait planifier bien plus que le restant.
- **Glisser-déposer, Prévisionnel** : une fois le reste épuisé, chaque dépôt créait un tour à pleine capacité.
- **Planification manuelle** : aucun contrôle de la quantité saisie au-delà du reste.

## Règle commune
Elle est portée par `app/Services/planning_quantite_service.php`.
- **Quantité de référence** :
  - Réel : `commande_qte_restant` (commande moins livré) ;
  - Prévisionnel : `commande_qte_commande`, comme l'ancienne planification manuelle et la planification auto. Les tours prévisionnels ne sont jamais « produits », alors que le restant baisse à chaque livraison.
- **Planifié** :
  - Réel : tours de la commande sans BL et non réels (`planning_reel = 0`), car un tour produit est déjà déduit du restant ;
  - Prévisionnel : tous les tours de la commande (les blocages ont `commande_id = 0`).
- **À planifier** = référence − planifié.
- **Contrôle d'une quantité de tour** :
  - dans le reste à planifier : accepté ;
  - dépassement et commande « Complément possible » (`t_commande.commande_complement`) : accepté. Le message « Tour placé comme complément. » s'affiche dans une fenêtre de même format, avec un seul bouton **OK** (`informerComplementTour()`, réponse `complement: true`) ;
  - dépassement sans complément : fenêtre « Commande entièrement planifiée : X m³ planifiés pour Y m³ restants. » (ou « Quantité supérieure au reste à planifier… » si une partie reste), avec les boutons **Abandon** et **Forcer le tour**. Forcer renvoie la demande avec `forcer=1`.
- Le contrôle se fait dans une transaction, avec verrou sur la commande (`lockForUpdate`) : deux ajouts simultanés ne peuvent pas dépasser ensemble.

## Glisser-déposer (`planning_laravel_controller::ajouter_commande`)
- Quantité du tour : capacité du camion, plafonnée au reste à planifier (le dernier camion prend le solde). S'il ne reste rien (complément ou tour forcé), c'est la pleine capacité.
- L'ancien refus en Réel « quantité restante inférieure ou égale à 0 » est remplacé par la règle commune.
- Panneau des commandes (`commandes()`, paramètre `type`) :
  - « Planifié » est calculé sur la table de l'écran (avant : toujours `t_planning`) ;
  - nouvelle ligne « À planifier », en rouge si négative ;
  - badge « Complément possible » ;
  - commande grisée quand tout est planifié, mais toujours déplaçable pour un complément ou un tour forcé.

## Planification manuelle (`planning_controller::of_manuel_valider`)
- Création : contrôle après celui de la capacité du véhicule.
- Modification : contrôle seulement si la quantité augmente, sans compter le tour modifié. Un tour déjà forcé reste modifiable (heures, véhicule…).
- `verifier_quantite_planifier()` (bandeau « Quantité planifiée / restant à planifier ») utilise le même calcul. Avant, c'était la quantité commandée moins tous les tours, produits compris.
- Badge « Complément possible » dans le bandeau.

## Grille des commandes (`commande_controller::data_table`)
- Nouvelle ligne « À planifier » sous LIVRE / RESTE / Planifiée, en rouge si elle est négative (commande sur-planifiée).
- Calcul groupé `planning_quantite_service::a_planifier_par_commande()` : deux requêtes pour toute la grille. La table dépend de la commande : Réel si `commande_of = 1`, sinon Prévisionnel.
- La ligne « Planifiée » existante n'est pas modifiée : somme de tous les tours `t_planning`, produits compris.

## Fichiers
- `app/Services/planning_quantite_service.php` (nouveau)
- `app/Http/Controllers/planning_laravel_controller.php` : `ajouter_commande()`, `commandes()`
- `app/Http/Controllers/planning_controller.php` : `verifier_quantite_planifier()`, `of_manuel_valider()`
- `app/Http/Controllers/commande_controller.php` : `data_table()`, ligne « À planifier » de la grille des commandes
- `resources/views/planning/_confirmation_depassement.blade.php` (nouveau) : fenêtre commune `fenetreDepassementTour()`, avec `confirmerDepassementTour()` (Abandon / Forcer le tour) et `informerComplementTour()` (OK). Partagée et définie une seule fois (la planification manuelle peut être chargée dans le planning). Échap = premier bouton (Abandon ou OK).
- `resources/views/planning/script.blade.php` : `ajouterCommande()`, panneau des commandes
- `resources/views/planning/index.blade.php` : styles (grisé, badge complément, dépassement)
- `resources/views/commande/planification_commande/planification_commande_manuel.blade.php` : confirmation et badge

## Non traité
- Planification automatique (`of_auto_valider`) : elle a sa propre boucle de remplissage, inchangée.

## Vérification
- Syntaxe PHP (PHP 8.3) et compilation des vues Blade : OK.
- Règle testée en lecture seule sur des cas fictifs (dans le reste, dépassement partiel, rien à planifier, forcé, complément, prévisionnel) et sur des commandes réelles de la base.
- Non testé dans l'écran (connexion requise) : dépôt, fenêtre Abandon / Forcer et planification manuelle sont à recetter.
