# ADR-010 — Champ `libelle` du module Banque masqué au profit de `direction`

Date : 2026-05-22
Statut : Provisoire (à valider avec Ange)
Fiche source : registry/T7-bank/DEC-BK-001-remove-libelle.md

## Contexte

Le champ `banques.libelle` est un terme manuel hérité d'Eco Bank, jugé
inapproprié et redondant. L'information utile (sens de l'opération) est mieux
portée par `direction` (crédit / débit).

## Décision

- `libelle` est **masqué partout** côté CHAPS metadata (list=0, detail=0,
  create=0, update=0). Réalisé via le seeder idempotent
  `chaps-api/database/seeders/BanqueDecBk001Seeder.php`.
- `direction` est **valorisé** : list=1, detail=1, séquences = 3, affiché en
  picklist colorée.
  - `Credit` → vert (colors.id = 5)
  - `Debit` → rouge (colors.id = 4)
- **Suppression DB différée (P3)** : la colonne `banques.libelle` n'est pas
  supprimée. Des opérations existantes ont des `libelle` peuplés et restent
  exportables.

## Écarts par rapport à la fiche (schéma réel)

- La fiche supposait des valeurs canoniques `credit`/`debit` (minuscules). Les
  valeurs réellement stockées sont `Credit` (2485 lignes) et `Debit` (1303).
  Les picklists existantes (id 9751/9752) portent déjà ces valeurs ; le seeder
  ne fait que corriger leurs couleurs.
- Les colonnes `iban`, `bank_code`, `account_name` mentionnées par certaines
  fiches T7 **n'existent pas** dans la table `banques` (cf. BUG-BK-002).
- La colonne de liaison module dans `metadatas` est `modules_id` (et non
  `module_id` comme dans le SQL d'illustration des fiches).

## Conséquences

- L'agence ne voit plus la colonne « Libellé » en liste ni en détail.
- La colonne « Direction » affiche un badge vert « Credit » / rouge « Debit ».
- Format CFA (FND-001) appliqué sur les montants inchangé.