# Règlements : portage Laravel (`reglement`)

## Demande

Migrer l'écran legacy « Règlements » (`public/reglement`) en Laravel.

## Fonctionnement (identique au legacy)

- Liste des règlements entre deux dates de règlement (période par défaut : `parametre_date_grille_generale`), filtre optionnel sur le mode de règlement. Colonnes : code, société, libellé, montant, date, échéance, pièce, client, supprimer.
- Clic sur le code : modification. Bouton « Ajouter » : saisie. Icône rouge : suppression après confirmation.
- Saisie : client obligatoire (sélection ou fenêtre de recherche par double-clic), pièce facultative parmi les factures du client.
- Création :
  - code `RG` + (dernier `id_reglement` + 1) sur 8 chiffres ;
  - encours client diminué du montant ;
  - si une pièce est choisie : reste à régler et état de la facture recalculés, puis lignes commentaire (type C) en fin de facture selon les deux cases (libellé du règlement, puis « Réglement numero… le … du montant : … par :… »).
- Modification : encours ajusté de la différence de montant, reste de la facture recalculé. Un règlement sans pièce peut être rattaché à une facture du client.
- Suppression : encours client rétabli, reste de la facture recalculé.
- Envoi externe automatique (`trans_externe/extraction_reglement.php`) si `parametre_reglement_trans_externe_auto`.

## Droit requis

Le droit facture (`t_profil.profil_facture`) doit valoir 3 (Modification), 4 (Création/Modification) ou 5 (Complet). Le legacy n'exigeait aucun droit.

- Sans ce droit, la page, la liste, le formulaire, la liste des factures du client et la recherche client répondent 401.
- L'enregistrement et la suppression répondent « Vous n'avez pas le droit ! ».
- Constante `DROITS_FACTURE` et méthode `a_droit_facture()` du contrôleur, en plus des middlewares `auth:sanctum` + `interne` sur la page et `auth:sanctum` sur l'Ajax.
- Le lien du menu reste visible pour tous : le menu ne sait pas tester un niveau de droit.

## Fichiers

- `routes/web/reglement.php` : `GET /reglement` (page), `GET /table`, `GET /creer`, `GET /{reglement}/modifier`, `GET /factures_client`, `GET /recherche_client`, `POST /enregistrer`, `DELETE /{reglement}/supprimer`. La route `reglement_data_table_fiche_annexe` existante est conservée.
- `app/Http/Controllers/reglement_controller.php` : `index()`, `data_table()`, `formulaire()`, `factures_client()`, `recherche_client()`, `enregistrer()`, `supprimer()`, en plus de `data_table_reglement_fiche_annexe()`.
- `resources/views/reglement/index.blade.php`, `form.blade.php`, `recherche_client.blade.php`.
- `public/.htaccess` : `RewriteRule ^reglement/?$ index.php [L]` (voir ci-dessous).
- Menus : URL inchangée.

## Legacy : le dossier reste en partie

`public/reglement/` ne peut **pas** être supprimé entièrement, car quatre scripts servent encore à d'autres écrans legacy :

| Script | Utilisé par |
|---|---|
| `reglement_valider.php` | `public/facture/reglement`, `public/pre_facture/reglement` |
| `reglement_table.php` | `facture.js`, `releve_facture.js` |
| `reglement_supprimer.php` | `facture.js`, `releve_facture.js` |
| `reglement_valider_dans_reglement.php` | `trans_externe/integration_fichier.php` (appel HTTP) |

Fichiers de l'écran, supprimables : `index.php`, `reglement_afficher.php`, `reglement_table_tr.php`, `recherche_generale/`.

Comme le dossier existe encore, Apache ne passerait pas `/reglement` à Laravel. La règle ajoutée dans `public/.htaccess` envoie donc `/reglement` au front controller. Apache ajoute d'abord le `/` final (301 vers `/reglement/`), puis Laravel sert la page. Les scripts `public/reglement/*.php` restent servis par Apache.

## Différences avec le legacy

- Requêtes Eloquent / liées, transaction, `POST` / `DELETE` + CSRF, réponses `{success, message}`.
- Code attribué à l'enregistrement (le formulaire n'affiche qu'un aperçu) : deux saisies simultanées ne prennent plus le même code.
- Modification :
  - la société, le client et les cases « ligne sur facture » ne sont plus écrasés. Le legacy renvoyait la première société de la liste (pas de `selected`), et les cases désactivées (donc non envoyées) repassaient à 0 ;
  - les cases sont affichées figées, car elles ne servent qu'à la création.
- Reste à régler à la suppression : recalculé depuis la somme des règlements, comme à l'enregistrement. Le legacy ajoutait le montant au reste stocké. Le résultat est le même si le reste était à jour.
- Contrôles ajoutés : montant numérique, date obligatoire, facture appartenant au client.
- Traçabilité « Réglement » / code / « Création » et « Modification ». Le legacy ne traçait que la suppression.
- Montant de la liste au format `1 234,50`. Filtre « Tous » au lieu de « Aucun ».

## Vérification

Script de comparaison dans des transactions annulées (base locale sans aucun règlement, donc des règlements de test créés puis annulés) :

- Liste : identique au SQL legacy (`reglement_table_tr.php`) sur 5 combinaisons dates / mode.
- Création sur une facture de 528 € TTC :
  - code `RG00000001` attendu ;
  - encours client -100,50 ;
  - reste 427,50, état 1 ;
  - 2 lignes commentaire numérotées à la suite, textes identiques au legacy.
- Modification à 150 : encours et reste (378) ajustés, aucune ligne ajoutée.
- Suppression : encours et reste (528) rétablis.
- Traçabilité écrite.
- Règlement sans pièce rattaché ensuite à la facture : reste recalculé.
- Refus vérifiés : client absent, facture d'un autre client, montant invalide.
- Vues compilées, formulaire de modification avec client et pièce verrouillés.
- Base inchangée après le test.
- Droit : niveaux 0, 1 et 2 refusés (401 ou message selon l'action), niveaux 3, 4 et 5 acceptés.
- `/reglement` arrive bien dans Laravel (redirection vers `/login` sans session). `reglement/reglement_table.php` est toujours servi (200).

Page non testée dans le navigateur.
