feat(commercial) : expose accounting referentials read-only API

Expose TvaMode, PaymentDelay, PaymentType et Bank en lecture seule (GetCollection + Get), security commercial.clients.view au niveau operations + ressource. Aucune ecriture declaree -> POST/PATCH/DELETE renvoient 405. Tri par defaut position ASC puis label ASC (spec M1 § 4.7). Pagination serveur conservee (ERP-72) avec paginationClientEnabled pour activer l'echappatoire ?pagination=false (alimenter un select sans pagination). Endpoints : GET /api/tva_modes, /api/payment_delays, /api/payment_types, /api/banks. Tests fonctionnels : 200 + seed, tri position/label, 405 ecritures, 403 sans permission, 401 anonyme, pagination toggle.
feat(commercial) : declare commercial.clients permissions + sync RBAC mirrors
2026-06-01 11:50:11 +02:00 · 2026-06-01 09:45:17 +02:00 · 2026-05-29 16:41:40 +02:00 · 2026-05-29 15:36:14 +02:00 · 2026-05-29 14:48:40 +02:00 · 2026-05-29 14:41:43 +02:00
118 changed files with 691 additions and 11616 deletions
@@ -13,64 +13,6 @@
 - Le login `/login_check` est **hors** prefix `/api` (nginx reecrit `REQUEST_URI` vers `/login_check`)
 - **Exception** : si tu dois creer un controller custom sous `/api/`, mettre `priority: 1` sur `#[Route]` pour eviter le conflit avec API Platform `{id}`
 ## Pagination (obligatoire)
 **Regle** : toute collection API DOIT etre paginee. Aucun retour de collection complete cote serveur.
 ### Standard global
 Pose dans `config/packages/api_platform.yaml` (section `defaults:`) et heritee par toutes les ressources :
 | Cle | Valeur | Effet |
 |---|---|---|
 | `pagination_enabled` | `true` | Pagination Hydra active par defaut. |
 | `pagination_items_per_page` | `10` | Taille de page par defaut, aligne sur l'UI `MalioDataTable`. |
 | `pagination_maximum_items_per_page` | `50` | Borne dure : `?itemsPerPage=999` → ramene a 50. Anti deep-fetch. |
 | `pagination_client_items_per_page` | `true` | Le client peut envoyer `?itemsPerPage=25` (bornee par le max). |
 | `pagination_client_enabled` | `true` | Le client peut envoyer `?pagination=false` pour TOUT recuperer (echappatoire selects). |
 ### Override par ressource (rare)
 Si une ressource a besoin d'un autre defaut (ex: payload lourd), utiliser les attributs sur l'operation. **JAMAIS `paginationEnabled: false`** sans whitelist explicite dans `tests/Architecture/CollectionsArePaginatedTest::EXCLUDED`.
 ```php
 new GetCollection(
    paginationItemsPerPage: 5,           // override taille par defaut
    paginationMaximumItemsPerPage: 20,   // override borne max
 )
 ```
 ### Selects et autocompletions
 Pour alimenter un `<select>` ou un drawer RBAC (Role, Permission, Site, CategoryType), le front passe :
 ```ts
 useApi().get('/api/roles?pagination=false')
 ```
 Le serveur retourne toute la collection, sans `view`. C'est l'echappatoire prevue par `pagination_client_enabled: true`. Sur les ressources a forte volumetrie, preferer une saisie assistee (recherche serveur via `?q=`) — a planifier dans un ticket dedie.
 Les tests fonctionnels qui exercent ce comportement doivent egalement passer `?pagination=false` (cf. `CategoryListTest`, `PermissionApiTest`).
 ### Providers customs et pagination
 Un provider custom qui retourne un `array` brut sur une `CollectionOperationInterface` **court-circuite la pagination Hydra** (pas de `totalItems`, pas de `view`). Patterns supportes :
 - **ORM** : injecter `ApiPlatform\State\Pagination\Pagination`, wrap un `Doctrine\ORM\Tools\Pagination\Paginator` dans `ApiPlatform\Doctrine\Orm\Paginator`. Exemple : `CategoryProvider`.
 - **DBAL** : implementer un paginator local conforme a `PaginatorInterface`. Exemple : `DbalPaginator` (Core) + `AuditLogProvider`.
 Gerer l'echappatoire `?pagination=false` :
 ```php
 if (!$this->pagination->isEnabled($operation, $context)) {
    return $qb->getQuery()->getResult(); // tout retourner
 }
 ```
 ### Garde-fou architecture
 `tests/Architecture/CollectionsArePaginatedTest` scanne reflexivement toutes les classes `#[ApiResource]` sous `src/` et echoue si une `GetCollection` pose `paginationEnabled: false` hors whitelist `EXCLUDED`. Ajouter une entree a la whitelist requiert une justification courte + un ticket Lesstime ouvert.
 ## Repositories
 - Interface : `*RepositoryInterface` dans `Domain/Repository/`
@@ -98,24 +40,6 @@ Format obligatoire : `module.resource[.subresource].action` en snake_case.
 - Audit ManyToMany : trace automatiquement `{fieldName: {added: [ids], removed: [ids]}}` — aucune action supplementaire
 - Spec complete : @doc/audit-log.md
 ### Libelle i18n du type d'entite (obligatoire avec `#[Auditable]`)
 **Toute entite `#[Auditable]` doit avoir son libelle FR dans le bloc `audit.entity` de `frontend/i18n/locales/fr.json`.** C'est la contrepartie i18n de l'attribut : sans elle, le filtre « Type d'entite » de l'audit-log affiche le type technique brut (ex: `commercial.Client`) au lieu d'un libelle lisible.
 Pourquoi : le filtre est dynamique (`GET /audit-log-entity-types` renvoie les `entity_type` distincts presents en base) ; des qu'un module audite une entite, son type y apparait. Le front (`formatEntityType`, `audit-log.vue`) construit la cle `audit.entity.<module>_<entity>` et, faute de traduction, **retombe silencieusement** sur le type brut.
 Derivation de la cle (emplacement centralise + schema flat — decision ERP-99) :
 | FQCN entite | `entity_type` (back) | Cle i18n (flat) |
 |---|---|---|
 | `App\Module\Commercial\Domain\Entity\Client` | `commercial.Client` | `commercial_client` |
 | `App\Module\Commercial\Domain\Entity\ClientAddress` | `commercial.ClientAddress` | `commercial_clientaddress` |
 | `App\Module\Catalog\Domain\Entity\Category` | `catalog.Category` | `catalog_category` |
 Regle : `strtolower(module)` + `_` + `strtolower(Entity)`. Ajouter sa cle de libelle audit fait partie de la **definition de fini** d'une entite metier auditee.
 **Garde-fou** : `tests/Architecture/AuditableEntitiesHaveI18nLabelTest` scanne les entites `#[Auditable]` et echoue si une seule n'a pas sa cle `audit.entity.*`. Conclusion : creer une entite `#[Auditable]` sans son libelle i18n casse `make test`.
 ## Timestampable + Blamable (obligatoire pour entites metier)
 Toute **nouvelle** entite metier sous `src/Module/*/Domain/Entity/` doit porter les 4 colonnes `created_at` / `updated_at` / `created_by` / `updated_by`, remplies automatiquement. Trois lignes a ajouter a l'entite :
@@ -53,53 +53,6 @@ Tout affichage LISTE tabulaire (donnees metier paginees, CRUD admin) doit passer
 **Exception** : tableaux purement presentationnels non paginables (diff field/old/new, grille de comparaison, matrice RBAC d'admin, etc.) peuvent rester en `<table>` HTML brut.
 ## Listes paginees (standard) — usePaginatedList obligatoire
 **Toute liste qui consomme une `GetCollection` API doit passer par `usePaginatedList`** (`frontend/shared/composables/usePaginatedList.ts`). Le composable est le pendant front de la regle ABSOLUE n°13 (« toute collection est paginee cote back ») : il consomme l'envelope Hydra (`member` / `totalItems` / `view`) et expose un etat reactif a brancher directement sur `MalioDataTable`.
 Pattern de reference :
 ```ts
 const {
    items,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: loadList,
    goToPage,
    setItemsPerPage,
 } = usePaginatedList<MyEntity>({ url: '/my-resources' })
 onMounted(loadList)
 ```
 ```vue
 <MalioDataTable
    :columns="columns"
    :items="rows"
    :total-items="totalItems"
    :page="currentPage"
    :per-page="itemsPerPage"
    :per-page-options="itemsPerPageOptions"
    :empty-message="t('foo.empty')"
    @update:page="goToPage"
    @update:per-page="setItemsPerPage"
 />
 ```
 Garanties offertes par le composable :
 - Force `Accept: application/ld+json` → API Platform 4 renvoie bien `member` / `totalItems` (sans Accept, retour tableau plat sans pagination).
 - Defaut 10 items/page, choix client 10 / 25 / 50, aligne sur le defaut serveur.
 - Mutation `setFilters` / `setSort` / `setItemsPerPage` → retombe systematiquement en page 1.
 - Cas limite « page hors borne apres filtre » : retombe automatiquement sur la derniere page valide (`tests/usePaginatedList.test.ts`).
 - Etat 100 % local (refs internes a l'instance) — **jamais reflete dans l'URL**, conformement a la regle « Etat des tableaux — pas de persistance URL » ci-dessous.
 A NE PAS faire :
 - Charger une collection complete via `?itemsPerPage=999` pour bypasser la pagination. Le seul cas legitime de retour complet est l'alimentation d'un `<select>` sur un referentiel ≤ quelques dizaines d'entrees, et il passe par `?pagination=false` (echappatoire prevue par `pagination_client_enabled: true`).
 - Reimplementer la pagination prev/next a la main au-dessus de `MalioDataTable` — le composant porte deja le selecteur items/page et les boutons Prev/Next.
 - Persister `page`/`tri`/`filtre` dans la query string — meme regle que pour `<MalioDataTable>` brut (cf. section suivante).
 ## Etat des tableaux — pas de persistance URL
 **Interdit** de persister l'etat d'un tableau (filtres, pagination, tri par colonne, selection, ligne active, scroll) dans la query string ou de le reinjecter depuis `route.query` au montage.
@@ -3,7 +3,7 @@
 ## Contexte
 CRM/ERP en architecture **modular monolith DDD**. Le backend est la source de verite unique (modules actifs, sidebar). Le frontend scanne `frontend/modules/*/` comme layers Nuxt et consomme l'API pour la navigation. Multi-tenant : chaque module est activable/desactivable.
-Doc humaine : `README.md` — Spec audit : `doc/audit-log.md` (à lire à la demande, non chargés en permanence).
+Doc humaine : @README.md — Spec audit : @doc/audit-log.md
 ## Stack
 - Backend : PHP 8.4, Symfony 8, API Platform 4, Doctrine ORM, PostgreSQL 16 (port 5437)
@@ -25,8 +25,6 @@ Doc humaine : `README.md` — Spec audit : `doc/audit-log.md` (à lire à la dem
 10. **Jamais mentionner Claude, Anthropic ou une IA** dans un commit (message, titre, body, footer, trailer) ou une PR (titre, description). Pas de `Co-Authored-By: Claude`, pas de `Generated with Claude Code`, pas de `🤖`, pas d'emoji robot, rien. Les commits sont signes par l'utilisateur uniquement.
 11. **Migrations d'initialisation au namespace racine** `DoctrineMigrations` dans `migrations/` (setup user, RBAC, seed de base). Les migrations modulaires (`src/Module/*/Infrastructure/Doctrine/Migrations/`) sont reservees aux evolutions post-schema (ajout de colonnes, index) — cf. @.claude/rules/architecture.md pour la raison.
 12. **Toujours documenter chaque colonne BDD via `COMMENT ON COLUMN`** dans la migration qui la cree ou la modifie. Description en francais, courte (≤ 200 caracteres), explique la semantique metier + contraintes implicites (unicite partielle, FK importante, lien RG). Garde-fou : `tests/Architecture/ColumnsHaveSqlCommentTest` echoue si une colonne `public` n'a pas de description (`col_description IS NULL`). Details et exemples : @.claude/rules/backend.md § Migrations Doctrine.
 13. **Toujours paginer toute collection exposee par l'API.** Aucun retour de collection complete (pas de provider qui retourne un array brut). Standard pose dans `config/packages/api_platform.yaml` : 10 items par defaut, max 50, le client peut basculer entre 10/25/50 et peut envoyer `?pagination=false` pour alimenter un select. Garde-fou : `tests/Architecture/CollectionsArePaginatedTest` echoue si une `GetCollection` desactive la pagination sans whitelist. Details et exemples : @.claude/rules/backend.md § Pagination.
 14. **`symfony.lock` est versionne** (au meme titre que `composer.lock`) — ne JAMAIS le `.gitignore`. C'est le registre des recipes Flex appliquees : sans lui, chaque `composer require` rejoue toutes les recipes et repollue `.env`, `config/bundles.php`, `docker-compose.yml` et recree du scaffolding parasite (`src/Entity/`, `src/Controller/`...). Le regenerer si besoin via `composer recipes:install --force`.
 ## Conventions
@.claude/rules/architecture.md
@@ -37,7 +35,7 @@ Doc humaine : `README.md` — Spec audit : `doc/audit-log.md` (à lire à la dem
@.claude/rules/git.md
@.claude/rules/workflow.md
-## Commandes (liste complete dans `README.md`)
+## Commandes (liste complete dans @README.md)
 - Demarrer : `make start`
 - Dev front (hot reload) : `make dev-nuxt` (port 3004)
@@ -55,7 +53,6 @@ Editer uniquement `config/modules.php` (commenter la ligne). Cascade automatique
 ## A NE PAS faire
 - Pas de controller Symfony custom sous `/api/` sans `priority: 1` sur `#[Route]` (conflit API Platform `{id}`).
 - Pas de provider API Platform qui retourne un array brut sur une `GetCollection` — court-circuite la pagination Hydra (`totalItems` / `view` absents). Utiliser `ApiPlatform\Doctrine\Orm\Paginator` (ORM) ou un paginator implementant `PaginatorInterface` (DBAL — cf. `DbalPaginator`).
 - Pas de `getClientMimeType()` pour valider un upload — utiliser `$file->getMimeType()` (serveur).
 - Pas de hardcode de la sidebar cote front, pas de `modules-loader.ts` ni `.module.ts`.
 - Pas d'edition manuelle de `extends` dans `frontend/nuxt.config.ts` — les layers sont scannes automatiquement.
@@ -70,5 +67,3 @@ Editer uniquement `config/modules.php` (commenter la ligne). Cascade automatique
 ## Credentials (dev)
 `admin` / `admin` (ROLE_ADMIN) ; `alice` / `alice`, `bob` / `bob` (ROLE_USER).
 Comptes demo des roles metier (seedes par `RbacDemoFixtures` / `app:seed-rbac --with-demo-users`, mot de passe `demo`) : `bureau` / `demo`, `compta` / `demo`, `commerciale` / `demo`, `usine` / `demo`. Matrice RBAC § 2.7 (M1 Clients) attachee aux roles correspondants.
@@ -169,41 +169,13 @@ Secrets requis dans Gitea :
 - `RELEASE_TOKEN` — PAT avec droits `write:repository`
 - `REGISTRY_TOKEN` — token pour le registry Docker
 ## Déploiement — seed RBAC (recette / prod)
 Le RBAC métier (rôles `bureau` / `compta` / `commerciale` / `usine` + matrice § 2.7)
 est seedé par une **commande applicative idempotente** (présente dans le build prod,
 contrairement aux fixtures Doctrine en `require-dev`). À jouer dans l'étape de release,
 **après** les migrations et la synchronisation des permissions :
 ```bash
 php bin/console doctrine:migrations:migrate --no-interaction
 php bin/console app:sync-permissions          # pose les permissions commercial.clients.*
 php bin/console app:seed-rbac                  # PROD : rôles + matrice § 2.7 (sans comptes démo)
 ```
 En **recette / staging**, ajouter le flag pour disposer de logins de test (mot de passe
 fourni explicitement, jamais en dur) :
 ```bash
 php bin/console app:seed-rbac --with-demo-users --password='<mot-de-passe>'
 # ou via la variable d'env RBAC_DEMO_PASSWORD
 ```
 La commande est rejouable sans effet de bord (aucun doublon de rôle, de lien ou de compte).
 En dev, `make db-reset` produit le même résultat (rôles + matrice + comptes démo).
 ## Credentials (dev)
-| Username | Password | Role | RBAC métier |
+| Username | Password | Role |
-|----------|----------|------|-------------|
+|----------|----------|------|
-| admin | admin | ROLE_ADMIN | bypass (is_admin) |
+| admin | admin | ROLE_ADMIN |
-| alice | alice | ROLE_USER | — |
+| alice | alice | ROLE_USER |
-| bob | bob | ROLE_USER | — |
+| bob | bob | ROLE_USER |
 | bureau | demo | ROLE_USER | clients : view + manage |
 | compta | demo | ROLE_USER | clients : view + accounting.view/manage |
 | commerciale | demo | ROLE_USER | clients : view + manage (Information obligatoire — RG-1.04) |
 | usine | demo | ROLE_USER | aucun accès clients |
 ## Conventions
@@ -16,7 +16,6 @@
        "nelmio/cors-bundle": "^2.6",
        "nyholm/psr7": "^1.8",
        "phpdocumentor/reflection-docblock": "^5.6|^6.0",
        "phpoffice/phpspreadsheet": "^5.7",
        "phpstan/phpdoc-parser": "^2.3",
        "symfony/asset": "8.0.*",
        "symfony/console": "8.0.*",
@@ -24,7 +23,6 @@
        "symfony/expression-language": "8.0.*",
        "symfony/flex": "^2",
        "symfony/framework-bundle": "8.0.*",
        "symfony/intl": "8.0.*",
        "symfony/mime": "8.0.*",
        "symfony/monolog-bundle": "^4.0",
        "symfony/property-access": "8.0.*",
@@ -4,7 +4,7 @@
        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
        "This file is @generated automatically"
    ],
-    "content-hash": "aada2e60fd7563f1498b5505b37e3f4b",
+    "content-hash": "d65a546151abb6b977fbf7f1c86d14fe",
    "packages": [
        {
            "name": "api-platform/doctrine-common",
@@ -1160,85 +1160,6 @@
            },
            "time": "2026-03-17T15:23:21+00:00"
        },
        {
            "name": "composer/pcre",
            "version": "3.3.2",
            "source": {
                "type": "git",
                "url": "https://github.com/composer/pcre.git",
                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
                "shasum": ""
            },
            "require": {
                "php": "^7.4 || ^8.0"
            },
            "conflict": {
                "phpstan/phpstan": "<1.11.10"
            },
            "require-dev": {
                "phpstan/phpstan": "^1.12 || ^2",
                "phpstan/phpstan-strict-rules": "^1 || ^2",
                "phpunit/phpunit": "^8 || ^9"
            },
            "type": "library",
            "extra": {
                "phpstan": {
                    "includes": [
                        "extension.neon"
                    ]
                },
                "branch-alias": {
                    "dev-main": "3.x-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "Composer\\Pcre\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Jordi Boggiano",
                    "email": "j.boggiano@seld.be",
                    "homepage": "http://seld.be"
                }
            ],
            "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
            "keywords": [
                "PCRE",
                "preg",
                "regex",
                "regular expression"
            ],
            "support": {
                "issues": "https://github.com/composer/pcre/issues",
                "source": "https://github.com/composer/pcre/tree/3.3.2"
            },
            "funding": [
                {
                    "url": "https://packagist.com",
                    "type": "custom"
                },
                {
                    "url": "https://github.com/composer",
                    "type": "github"
                },
                {
                    "url": "https://tidelift.com/funding/github/packagist/composer/composer",
                    "type": "tidelift"
                }
            ],
            "time": "2024-11-12T16:29:46+00:00"
        },
        {
            "name": "composer/semver",
            "version": "3.4.4",
@@ -2709,191 +2630,6 @@
            ],
            "time": "2025-12-20T17:47:00+00:00"
        },
        {
            "name": "maennchen/zipstream-php",
            "version": "3.2.2",
            "source": {
                "type": "git",
                "url": "https://github.com/maennchen/ZipStream-PHP.git",
                "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e",
                "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e",
                "shasum": ""
            },
            "require": {
                "ext-mbstring": "*",
                "ext-zlib": "*",
                "php-64bit": "^8.3"
            },
            "require-dev": {
                "brianium/paratest": "^7.7",
                "ext-zip": "*",
                "friendsofphp/php-cs-fixer": "^3.86",
                "guzzlehttp/guzzle": "^7.5",
                "mikey179/vfsstream": "^1.6",
                "php-coveralls/php-coveralls": "^2.5",
                "phpunit/phpunit": "^12.0",
                "vimeo/psalm": "^6.0"
            },
            "suggest": {
                "guzzlehttp/psr7": "^2.4",
                "psr/http-message": "^2.0"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "ZipStream\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Paul Duncan",
                    "email": "pabs@pablotron.org"
                },
                {
                    "name": "Jonatan Männchen",
                    "email": "jonatan@maennchen.ch"
                },
                {
                    "name": "Jesse Donat",
                    "email": "donatj@gmail.com"
                },
                {
                    "name": "András Kolesár",
                    "email": "kolesar@kolesar.hu"
                }
            ],
            "description": "ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.",
            "keywords": [
                "stream",
                "zip"
            ],
            "support": {
                "issues": "https://github.com/maennchen/ZipStream-PHP/issues",
                "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.2.2"
            },
            "funding": [
                {
                    "url": "https://github.com/maennchen",
                    "type": "github"
                }
            ],
            "time": "2026-04-11T18:38:28+00:00"
        },
        {
            "name": "markbaker/complex",
            "version": "3.0.2",
            "source": {
                "type": "git",
                "url": "https://github.com/MarkBaker/PHPComplex.git",
                "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/MarkBaker/PHPComplex/zipball/95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
                "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
                "shasum": ""
            },
            "require": {
                "php": "^7.2 || ^8.0"
            },
            "require-dev": {
                "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
                "phpcompatibility/php-compatibility": "^9.3",
                "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
                "squizlabs/php_codesniffer": "^3.7"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "Complex\\": "classes/src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Mark Baker",
                    "email": "mark@lange.demon.co.uk"
                }
            ],
            "description": "PHP Class for working with complex numbers",
            "homepage": "https://github.com/MarkBaker/PHPComplex",
            "keywords": [
                "complex",
                "mathematics"
            ],
            "support": {
                "issues": "https://github.com/MarkBaker/PHPComplex/issues",
                "source": "https://github.com/MarkBaker/PHPComplex/tree/3.0.2"
            },
            "time": "2022-12-06T16:21:08+00:00"
        },
        {
            "name": "markbaker/matrix",
            "version": "3.0.1",
            "source": {
                "type": "git",
                "url": "https://github.com/MarkBaker/PHPMatrix.git",
                "reference": "728434227fe21be27ff6d86621a1b13107a2562c"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/MarkBaker/PHPMatrix/zipball/728434227fe21be27ff6d86621a1b13107a2562c",
                "reference": "728434227fe21be27ff6d86621a1b13107a2562c",
                "shasum": ""
            },
            "require": {
                "php": "^7.1 || ^8.0"
            },
            "require-dev": {
                "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
                "phpcompatibility/php-compatibility": "^9.3",
                "phpdocumentor/phpdocumentor": "2.*",
                "phploc/phploc": "^4.0",
                "phpmd/phpmd": "2.*",
                "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
                "sebastian/phpcpd": "^4.0",
                "squizlabs/php_codesniffer": "^3.7"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "Matrix\\": "classes/src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Mark Baker",
                    "email": "mark@demon-angel.eu"
                }
            ],
            "description": "PHP Class for working with matrices",
            "homepage": "https://github.com/MarkBaker/PHPMatrix",
            "keywords": [
                "mathematics",
                "matrix",
                "vector"
            ],
            "support": {
                "issues": "https://github.com/MarkBaker/PHPMatrix/issues",
                "source": "https://github.com/MarkBaker/PHPMatrix/tree/3.0.1"
            },
            "time": "2022-12-02T22:17:43+00:00"
        },
        {
            "name": "monolog/monolog",
            "version": "3.10.0",
@@ -3316,115 +3052,6 @@
            },
            "time": "2026-01-06T21:53:42+00:00"
        },
        {
            "name": "phpoffice/phpspreadsheet",
            "version": "5.7.0",
            "source": {
                "type": "git",
                "url": "https://github.com/PHPOffice/PhpSpreadsheet.git",
                "reference": "9f55d3b9b7bcb1084fda8340e4b7ce4ed10cd0c8"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/PHPOffice/PhpSpreadsheet/zipball/9f55d3b9b7bcb1084fda8340e4b7ce4ed10cd0c8",
                "reference": "9f55d3b9b7bcb1084fda8340e4b7ce4ed10cd0c8",
                "shasum": ""
            },
            "require": {
                "composer/pcre": "^1||^2||^3",
                "ext-ctype": "*",
                "ext-dom": "*",
                "ext-fileinfo": "*",
                "ext-filter": "*",
                "ext-gd": "*",
                "ext-iconv": "*",
                "ext-libxml": "*",
                "ext-mbstring": "*",
                "ext-simplexml": "*",
                "ext-xml": "*",
                "ext-xmlreader": "*",
                "ext-xmlwriter": "*",
                "ext-zip": "*",
                "ext-zlib": "*",
                "maennchen/zipstream-php": "^2.1 || ^3.0",
                "markbaker/complex": "^3.0",
                "markbaker/matrix": "^3.0",
                "php": "^8.1",
                "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
            },
            "require-dev": {
                "dealerdirect/phpcodesniffer-composer-installer": "dev-main",
                "dompdf/dompdf": "^2.0 || ^3.0",
                "ext-intl": "*",
                "friendsofphp/php-cs-fixer": "^3.2",
                "mitoteam/jpgraph": "^10.5",
                "mpdf/mpdf": "^8.1.1",
                "phpcompatibility/php-compatibility": "^9.3",
                "phpstan/phpstan": "^1.1 || ^2.0",
                "phpstan/phpstan-deprecation-rules": "^1.0 || ^2.0",
                "phpstan/phpstan-phpunit": "^1.0 || ^2.0",
                "phpunit/phpunit": "^10.5",
                "squizlabs/php_codesniffer": "^3.7",
                "tecnickcom/tcpdf": "^6.5"
            },
            "suggest": {
                "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
                "ext-intl": "PHP Internationalization Functions, required for NumberFormat Wizard and StringHelper::setLocale()",
                "mitoteam/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers",
                "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
                "tecnickcom/tcpdf": "Option for rendering PDF with PDF Writer"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Maarten Balliauw",
                    "homepage": "https://blog.maartenballiauw.be"
                },
                {
                    "name": "Mark Baker",
                    "homepage": "https://markbakeruk.net"
                },
                {
                    "name": "Franck Lefevre",
                    "homepage": "https://rootslabs.net"
                },
                {
                    "name": "Erik Tilt"
                },
                {
                    "name": "Adrien Crivelli"
                },
                {
                    "name": "Owen Leibman"
                }
            ],
            "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
            "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
            "keywords": [
                "OpenXML",
                "excel",
                "gnumeric",
                "ods",
                "php",
                "spreadsheet",
                "xls",
                "xlsx"
            ],
            "support": {
                "issues": "https://github.com/PHPOffice/PhpSpreadsheet/issues",
                "source": "https://github.com/PHPOffice/PhpSpreadsheet/tree/5.7.0"
            },
            "time": "2026-04-20T02:42:17+00:00"
        },
        {
            "name": "phpstan/phpdoc-parser",
            "version": "2.3.2",
@@ -3886,57 +3513,6 @@
            },
            "time": "2024-09-11T13:17:53+00:00"
        },
        {
            "name": "psr/simple-cache",
            "version": "3.0.0",
            "source": {
                "type": "git",
                "url": "https://github.com/php-fig/simple-cache.git",
                "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/php-fig/simple-cache/zipball/764e0b3939f5ca87cb904f570ef9be2d78a07865",
                "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865",
                "shasum": ""
            },
            "require": {
                "php": ">=8.0.0"
            },
            "type": "library",
            "extra": {
                "branch-alias": {
                    "dev-master": "3.0.x-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "Psr\\SimpleCache\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "PHP-FIG",
                    "homepage": "https://www.php-fig.org/"
                }
            ],
            "description": "Common interfaces for simple caching",
            "keywords": [
                "cache",
                "caching",
                "psr",
                "psr-16",
                "simple-cache"
            ],
            "support": {
                "source": "https://github.com/php-fig/simple-cache/tree/3.0.0"
            },
            "time": "2021-10-29T13:26:27+00:00"
        },
        {
            "name": "symfony/asset",
            "version": "v8.0.8",
@@ -5596,95 +5172,6 @@
            ],
            "time": "2026-03-31T21:14:05+00:00"
        },
        {
            "name": "symfony/intl",
            "version": "v8.0.8",
            "source": {
                "type": "git",
                "url": "https://github.com/symfony/intl.git",
                "reference": "604a1dbbd67471e885e93274379cadd80dc33535"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/symfony/intl/zipball/604a1dbbd67471e885e93274379cadd80dc33535",
                "reference": "604a1dbbd67471e885e93274379cadd80dc33535",
                "shasum": ""
            },
            "require": {
                "php": ">=8.4"
            },
            "conflict": {
                "symfony/string": "<7.4"
            },
            "require-dev": {
                "symfony/filesystem": "^7.4|^8.0",
                "symfony/var-exporter": "^7.4|^8.0"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "Symfony\\Component\\Intl\\": ""
                },
                "exclude-from-classmap": [
                    "/Tests/",
                    "/Resources/data/"
                ]
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Bernhard Schussek",
                    "email": "bschussek@gmail.com"
                },
                {
                    "name": "Eriksen Costa",
                    "email": "eriksen.costa@infranology.com.br"
                },
                {
                    "name": "Igor Wiedler",
                    "email": "igor@wiedler.ch"
                },
                {
                    "name": "Symfony Community",
                    "homepage": "https://symfony.com/contributors"
                }
            ],
            "description": "Provides access to the localization data of the ICU library",
            "homepage": "https://symfony.com",
            "keywords": [
                "i18n",
                "icu",
                "internationalization",
                "intl",
                "l10n",
                "localization"
            ],
            "support": {
                "source": "https://github.com/symfony/intl/tree/v8.0.8"
            },
            "funding": [
                {
                    "url": "https://symfony.com/sponsor",
                    "type": "custom"
                },
                {
                    "url": "https://github.com/fabpot",
                    "type": "github"
                },
                {
                    "url": "https://github.com/nicolas-grekas",
                    "type": "github"
                },
                {
                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                    "type": "tidelift"
                }
            ],
            "time": "2026-03-30T15:14:47+00:00"
        },
        {
            "name": "symfony/mime",
            "version": "v8.0.8",
@@ -8776,6 +8263,85 @@
            ],
            "time": "2022-12-23T10:58:28+00:00"
        },
        {
            "name": "composer/pcre",
            "version": "3.3.2",
            "source": {
                "type": "git",
                "url": "https://github.com/composer/pcre.git",
                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
                "shasum": ""
            },
            "require": {
                "php": "^7.4 || ^8.0"
            },
            "conflict": {
                "phpstan/phpstan": "<1.11.10"
            },
            "require-dev": {
                "phpstan/phpstan": "^1.12 || ^2",
                "phpstan/phpstan-strict-rules": "^1 || ^2",
                "phpunit/phpunit": "^8 || ^9"
            },
            "type": "library",
            "extra": {
                "phpstan": {
                    "includes": [
                        "extension.neon"
                    ]
                },
                "branch-alias": {
                    "dev-main": "3.x-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "Composer\\Pcre\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Jordi Boggiano",
                    "email": "j.boggiano@seld.be",
                    "homepage": "http://seld.be"
                }
            ],
            "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
            "keywords": [
                "PCRE",
                "preg",
                "regex",
                "regular expression"
            ],
            "support": {
                "issues": "https://github.com/composer/pcre/issues",
                "source": "https://github.com/composer/pcre/tree/3.3.2"
            },
            "funding": [
                {
                    "url": "https://packagist.com",
                    "type": "custom"
                },
                {
                    "url": "https://github.com/composer",
                    "type": "github"
                },
                {
                    "url": "https://tidelift.com/funding/github/packagist/composer/composer",
                    "type": "tidelift"
                }
            ],
            "time": "2024-11-12T16:29:46+00:00"
        },
        {
            "name": "composer/xdebug-handler",
            "version": "3.0.5",
@@ -21,18 +21,3 @@ api_platform:
        stateless: true
        cache_headers:
            vary: ['Content-Type', 'Authorization', 'Origin']
        # === Pagination Hydra (regle projet : toute collection DOIT etre paginee) ===
        # Standard datatable : 10 items par defaut, choix client 10 / 25 / 50.
        # Borne dure cote serveur a 50 pour prevenir tout `?itemsPerPage=999999`
        # (attaque memoire / deep-fetch). Le client peut neanmoins desactiver la
        # pagination via `?pagination=false` pour alimenter un <select> ou autre
        # vue "tout-en-un" — c'est l'echappatoire prevue pour les ressources
        # servant a la fois de datatable et de source de select (Role,
        # Permission, Site, CategoryType). Override par ressource possible via
        # `paginationItemsPerPage` / `paginationMaximumItemsPerPage` /
        # `paginationEnabled` sur l'attribut #[ApiResource] ou sur une operation.
        pagination_enabled: true
        pagination_items_per_page: 10
        pagination_maximum_items_per_page: 50
        pagination_client_items_per_page: true
        pagination_client_enabled: true
@@ -3,14 +3,6 @@ lexik_jwt_authentication:
    public_key: '%env(resolve:JWT_PUBLIC_KEY)%'
    pass_phrase: '%env(JWT_PASSPHRASE)%'
    token_ttl: '%env(int:JWT_TOKEN_TTL)%'
    # Tolerance d'horloge (en secondes) appliquee a la validation des claims
    # temporels iat / nbf / exp (LooseValidAt cote lcobucci). Sans cette marge
    # (defaut 0), un recul d'horloge entre la signature (/login_check) et la
    # requete suivante rend iat/nbf « dans le futur » -> « Invalid JWT Token »
    # (401). Observe en dev sous WSL2/Docker (horloge CLOCK_REALTIME non
    # monotone) : flakes intermittents de la suite PHPUnit (ERP-98). Benefice
    # aussi en prod si les noeuds derivent legerement entre eux.
    clock_skew: 15
    remove_token_from_body_when_cookies_used: true
    token_extractors:
        authorization_header:
@@ -105,7 +105,7 @@ return [
        'items' => [
            [
                'label'      => 'sidebar.commercial.clients',
-                'to'         => '/clients',
+                'to'         => '/commercial/clients',
                'icon'       => 'mdi:account-group-outline',
                'module'     => 'commercial',
                'permission' => 'commercial.clients.view',
@@ -1,2 +1,2 @@
 parameters:
-    app.version: '0.1.70'
+    app.version: '0.1.54'
@@ -118,8 +118,6 @@ Aucun pattern soft delete existant dans Starseed (vérifié, aucune entité ne p
 Index unique partiel sur `(LOWER(name), category_type_id) WHERE deleted_at IS NULL`. Permet de recréer une catégorie avec le même `(name, type)` après suppression logique. Postgres supporte nativement (`CREATE UNIQUE INDEX ... WHERE`). Pattern propre, pas besoin de validator applicatif maison côté unicité — la contrainte SQL fait le job.
 > **🔗 Évolution ERP-78 (refonte taxonomie M1)** : `Category` porte désormais une colonne **`code`** (`VARCHAR(50)`, NOT NULL), slug MAJUSCULE auto-généré du nom (figé à la création, lecture seule via l'API), avec un **second index unique partiel** `uq_category_code (code) WHERE deleted_at IS NULL`. Ce code est la clé métier stable utilisée par le M1 Commercial (RG-1.03 / RG-1.29). Détail : `docs/specs/M1-clients/spec-back.md` § 3.3.
 ### 2.5 Audit & traces temporelles — deux niveaux complémentaires
 Deux mécanismes **indépendants** cohabitent :
@@ -1,80 +0,0 @@
 # Cahier de test back — M1 Répertoire clients (ticket ERP-60 / #478)
 Mapping **toutes les RG (§ 7) → test(s) PHPUnit**, à jour après ERP-60.
 Légende source : `ERP-55` `ERP-56` `ERP-57` `ERP-58` = tests écrits par les wagons
 précédents ; **`ERP-60`** = tests ajoutés par ce ticket (stratégie « combler les
 trous, zéro duplication »).
 ## Stratégie
 ERP-60 n'écrit QUE les tests des RG non déjà couvertes par la stack, et mappe ici
 l'intégralité des RG (existantes + nouvelles + déléguées). Les tests dépendants
 des **rôles métier** (matrice RBAC bureau/compta/commerciale/usine + RG-1.04
 fonctionnel) sont **délégués à ERP-74 (#493)** : ces rôles n'existent qu'après le
 merge de la stack.
 ## Mapping RG → test
 | RG | Intitulé | Test(s) | Source |
 |----|----------|---------|--------|
 | RG-1.01 | Prénom OU nom obligatoire → 422 | `ClientApiTest::testPostWithoutFirstOrLastNameReturns422` ; `ClientProcessorTest` (unit) | ERP-55 |
 | RG-1.02 | phoneSecondary persisté ; max 2 téléphones | `ClientFormulaireMainTest::testPostPersistsSecondaryPhoneNormalized` ; `::testThirdPhoneFieldIsIgnored` | **ERP-60** |
 | RG-1.03 | distributor/broker exclusifs + type catégorie | `ClientApiTest::testPostWithDistributorAndBrokerReturns422` ; `::testPostDistributorReferencingNonDistributorReturns422` ; `::testPostValidDistributorReturns201` ; `ClientProcessorTest` (unit) | ERP-55 |
 | RG-1.04 | Onglet Information obligatoire pour rôle Commerciale | `ClientProcessorTest::testCommercialeIncompleteInformationIsUnprocessable` ; `::testNonCommercialeSkipsInformationCompleteness` (unit, dormant). **Test fonctionnel + durcissement → ERP-74** | ERP-55 / **ERP-74** |
 | RG-1.05 | Contact : prénom OU nom → 422 (CHECK) | `ClientSubResourceApiTest::testPostContactWithoutNameReturns422` | ERP-57 |
 | RG-1.06/07/08 | Adresse prospect exclusive de livraison/facturation → 422 (Assert\Callback + CHECK filet) | `ClientAddressTest::testProspectAddressCannotBeDelivery` ; `::testProspectAddressCannotBeBilling` | ERP-60 / **ERP-76** |
 | RG-1.09 | Code postal `^[0-9]{4,5}$` → 422 | `ClientSubResourceApiTest::testPostAddressWithInvalidPostalCodeReturns422` | ERP-57 |
 | RG-1.10 | ≥ 1 site sur adresse → 422 | `ClientSubResourceApiTest::testPostAddressWithoutSiteReturns422` | ERP-57 |
 | RG-1.11 | billingEmail obligatoire ssi isBilling → 422 (Assert\Callback + CHECK filet) | `ClientAddressTest::testBillingAddressRequiresBillingEmail` ; `::testNonBillingAddressRejectsBillingEmail` | ERP-60 / **ERP-76** |
 | RG-1.12 | Virement → banque obligatoire → 422 | `ClientProcessorTest::testVirementWithoutBankIsUnprocessable` ; `::testVirementWithBankPasses` (unit) | ERP-55 |
 | RG-1.13 | LCR → ≥ 1 RIB ; DELETE dernier RIB en LCR → 409 | `ClientProcessorTest::testLcrWithoutRibIsUnprocessable` / `::testLcrWithRibPasses` (unit) ; `ClientSubResourceApiTest::testDeleteLastRibUnderLcrReturns409` / `::testDeleteRibNonLcrReturns204` | ERP-55 / ERP-57 |
 | RG-1.14 | ≥ 1 bloc Contact pour finaliser l'onglet | **Front-driven (pas de state machine back).** Back voisin : `ClientSubResourceApiTest::testDeleteLastContactReturns409` | ERP-57 |
 | RG-1.15 | ~~Unicité SIREN~~ supprimée (Q4) — SIREN partageable | `ClientUniquenessTest::testDuplicateSirenIsAllowed` ; `ClientMigrationTest::testNoSirenOrEmailUniqueIndex` | **ERP-60** |
 | RG-1.16 | companyName unique (case-insensitive) parmi actifs → 409 | `ClientApiTest::testPostDuplicateCompanyNameReturns409` ; `ClientMigrationTest::testCompanyNameActivePartialIndexExistsExactlyOnce` | ERP-55 / **ERP-60** |
 | RG-1.17 | ~~Unicité email~~ supprimée (Q4) — email partageable | `ClientUniquenessTest::testDuplicateEmailIsAllowed` ; `ClientMigrationTest::testNoSirenOrEmailUniqueIndex` | **ERP-60** |
 | RG-1.18 | companyName upper-cased serveur | `ClientApiTest::testPostNormalizesTextFields` ; `ClientFieldNormalizerTest::testCompanyNameIsUppercased` (unit) | ERP-55 |
 | RG-1.19 | firstName/lastName capitalize serveur | `ClientApiTest::testPostNormalizesTextFields` ; `ClientFieldNormalizerTest::testPersonNameIsTitleCased` (unit) ; `ClientSubResourceApiTest::testPostContactNormalizesFields` | ERP-55 / ERP-57 |
 | RG-1.20 | Téléphones chiffres-seuls serveur | `ClientApiTest::testPostNormalizesTextFields` ; `ClientFieldNormalizerTest::testPhoneKeepsOnlyDigits` (unit) ; `ClientFormulaireMainTest::testPostPersistsSecondaryPhoneNormalized` (secondary) | ERP-55 / **ERP-60** |
 | RG-1.21 | email lowercase serveur | `ClientApiTest::testPostNormalizesTextFields` ; `ClientFieldNormalizerTest::testEmailIsLowercased` (unit) ; `ClientSubResourceApiTest::testPostContactNormalizesFields` / `::testPostAddressNormalizesBillingEmail` | ERP-55 / ERP-57 |
 | RG-1.22 | Archive : permission `archive` + archivedAt + aucun autre champ | `ClientApiTest::testPatchArchiveSetsArchivedAtThenRestore` ; `::testPatchArchiveWithOtherFieldReturns422` ; `ClientProcessorTest` (unit, gating archive) | ERP-55 |
 | RG-1.23 | Restauration : archivedAt=null ; **409 si conflit d'unicité** | `ClientApiTest::testPatchArchiveSetsArchivedAtThenRestore` (cas nominal) ; **`ClientArchiveTest::testRestoreConflictReturns409`** (409 restauration, gap P1) | ERP-55 / **ERP-60** |
 | RG-1.24 | Liste exclut les archivés par défaut | `ClientApiTest::testListSortedByCompanyNameAscAndExcludesArchived` | ERP-55 |
 | RG-1.25 | `?includeArchived=true` inclut les archivés | `ClientApiTest::testListIncludeArchivedReturnsArchived` | ERP-55 |
 | RG-1.26 | Tri par défaut companyName ASC | `ClientApiTest::testListSortedByCompanyNameAscAndExcludesArchived` | ERP-55 |
 | RG-1.27 | Timestampable/Blamable : created* figés, updated* mis à jour | `ClientAuditTest::testCreatedFrozenAndUpdatedByReflectsModifier` | **ERP-60** |
 | RG-1.28 | PATCH multi-groupes sans permission → 403 strict (tout le payload) | `ClientProcessorTest::testStrictMixWithAccountingFieldIsForbidden` / `::testAccountingFieldWithoutPermissionIsForbidden` (unit) ; **`ClientPatchStrictTest::testMixedGroupsPatchWithoutAccountingPermissionIsForbidden`** (fonctionnel) | ERP-55 / **ERP-60** |
 | RG-1.29 | Catégorie d'adresse limitée aux types SECTEUR/AUTRE | **Filtrage LECTURE = front-driven** (SearchFilter `GET /api/categories?categoryType.code[]=…`). **Validation ÉCRITURE** : `ClientAddress::validateCategoryTypes` (Assert\Callback) rejette une catégorie DISTRIBUTEUR/COURTIER en 422 (violation `categories`). Tests : `ClientAddressTest::testAddressRejectsDistributorCategory` / `::testAddressRejectsBrokerCategory` / `::testAddressAcceptsSectorCategory` / `::testAddressAcceptsOtherCategory` | **ERP-76** |
 ## Couvertures transverses
 | Sujet | Test(s) | Source |
 |-------|---------|--------|
 | Audit iban/bic présents dans le diff (pas d'`#[AuditIgnore]`) | `ClientAuditTest::testRibCreateAuditIncludesIbanAndBic` | **ERP-60** |
 | Sécurité générique : 401 anonyme + 403 sans `commercial.clients.view` | `ClientSecurityTest` (collection + détail) ; `ClientExportControllerTest::testForbiddenWithoutClientsViewPermission` / `::testUnauthorizedWhenAnonymous` | **ERP-60** / ERP-58 |
 | Migration : index partiel unique présent (1 seul), pas de siren/email unique | `ClientMigrationTest` | **ERP-60** |
 | Référentiels comptables read-only (405 écriture, 401/403) | `ReferentialApiTest` | ERP-56 |
 | Export XLSX (colonnes accounting selon permission, 401/403) | `ClientExportControllerTest` | ERP-58 |
 ## Délégué à ERP-74 (#493) — NE PAS faire dans ERP-60
 - **Matrice RBAC différenciée** par rôle métier (Bureau / Compta / Commerciale /
  Usine) : 200/403 par verbe et par onglet selon le rôle.
 - **RG-1.04 fonctionnel** : PATCH onglet Information par une Commerciale avec
  champs incomplets → 422 ; même PATCH par Admin → 200 (+ durcissement code/spec).
 - Raison : ces rôles métier ne sont seedés qu'après le merge de la stack M1.
 ## Gaps & suivi
 - ~~**RG-1.29 (validation écriture)**~~ — **résolu en ERP-76**. La validation
  d'écriture refuse désormais une catégorie de type `DISTRIBUTEUR`/`COURTIER` sur
  une `ClientAddress` (→ 422, violation `categories`) via l'Assert\Callback
  `ClientAddress::validateCategoryTypes`. Le filtrage de lecture reste
  front-driven (SearchFilter). Couvert par `ClientAddressTest`.
 - ~~**Violations CHECK → statut HTTP**~~ — **résolu en ERP-76**. Les règles
  d'adresse RG-1.06/07/08/11 sont désormais rejetées en **422** par des
  Assert\Callback applicatifs (`validateProspectExclusivity` /
  `validateBillingEmailPresence`) qui s'exécutent AVANT la base. Les CHECK
  Postgres (`chk_client_address_prospect_exclusive` /
  `chk_client_address_billing_email`) restent en filet de sécurité. Les tests
  `ClientAddressTest` assertent maintenant le 422 explicite (et non plus ≥ 400).
@@ -465,32 +465,26 @@ CREATE TABLE client_rib (
 CREATE INDEX idx_client_rib_client ON client_rib(client_id);
 ```
-### 3.3 Seed taxonomie — type unique `CLIENT` + `Category.code` (refonte ERP-78)
+### 3.3 Seed `CategoryType` (extension du M0)
-> **⚠ Refonte ERP-78 (décision produit 01/06) — le modèle ci-dessous remplace l'ancien.**
+Au M0, la table `category_type` a été créée mais reste vide (HP-1 du M0). Le M1 lève cette restriction avec un seed initial des **types métier** dont le module Tiers a besoin :
 > Historique : à l'origine (#38), `DISTRIBUTEUR` / `COURTIER` / `SECTEUR` / `AUTRE` étaient des **`category_type`**. Le modèle a été **inversé** :
 >
 > - **UN SEUL `category_type` : `CLIENT`** (code `CLIENT`, label « Client »).
 > - `Distributeur` / `Courtier` / `Secteur` / `Autre` (+ catégories métier fines) sont désormais des **`Category`** rattachées au type `CLIENT`.
 > - Le filtrage métier ne se fait plus sur le **type** mais sur un **`code` stable porté par la `Category`** (NOT NULL, unique parmi les actifs — index partiel `uq_category_code`). Le code est un **slug MAJUSCULE auto-généré du nom** (`CategoryCodeGenerator`), figé à la création, et exposé en **lecture seule** (groupe `category:read`). Les codes `DISTRIBUTEUR` / `COURTIER` (anciennement portés par le type) sont reportés sur les `Category` correspondantes.
 Seed cible (migration corrective `Version20260602100000`, namespace racine) :
 ```sql
-- Type unique
+INSERT INTO category_type (code, label, position) VALUES
-INSERT INTO category_type (code, label) VALUES ('CLIENT', 'Client') ON CONFLICT (code) DO NOTHING;
+    ('DISTRIBUTEUR', 'Distributeur', 10),
-- Catégories système sous CLIENT (codes stables pilotant les RG)
+    ('COURTIER',     'Courtier',     20),
-- Distributeur -> DISTRIBUTEUR, Courtier -> COURTIER, Secteur -> SECTEUR, Autre -> AUTRE
+    ('SECTEUR',      'Secteur',      30),
    ('AUTRE',        'Autre',        99);
 ```
-> **Note** : le CRUD admin de `CategoryType` reste HP (cf. M0). Le `code` de `Category` n'est PAS saisissable via l'API (auto-généré côté serveur).
+> **Note** : le CRUD admin de `CategoryType` reste HP (cf. M0).
 >
-> **Seed en DEUX endroits (décision 29/05, vérifiée empiriquement)** : le `make db-reset` lance les fixtures, dont le purger Doctrine **vide `category` / `category_type`** (entités M0 mappées) avant `load()` → un seed posé uniquement en migration disparaît en dev/test. Donc :
+> **Seed en DEUX endroits (décision 29/05, vérifiée empiriquement)** : le `make db-reset` lance les fixtures, dont le purger Doctrine **vide `category_type`** (entité M0 mappée) avant `load()` → un seed posé uniquement en migration disparaît en dev/test. Donc :
-> 1. **Migration** (`ON CONFLICT` / guards `NOT EXISTS`) → sert en **prod** (pas de fixtures).
+> 1. **Migration** (`ON CONFLICT (code) DO NOTHING`) → sert en **prod** (pas de fixtures).
-> 2. **Fixtures idempotentes** (`CategoryTypeFixtures` → type CLIENT ; `CategoryFixtures` → catégories codées sous CLIENT) → survivent au `db-reset`.
+> 2. **Fixture Commercial idempotente** (ex. `CommercialReferentialFixtures`) re-seedant les 4 types → survit au `db-reset`, satisfait le critère « 4 types présents après db-reset ».
 >
 > ⚠ **À venir en ERP-54** : `tva_mode` / `payment_delay` / `payment_type` / `bank` ne sont pas encore des entités mappées au M1.0 → le purger ne les touche pas, leur seed migration survit. **Dès qu'ERP-54 crée leurs entités, ils seront purgés au db-reset** → il faudra les ajouter à la même fixture référentielle.
-> 🔗 **Coordination ERP-68** : ERP-78 (cette refonte) atterrit avant ERP-68. `CategoryFixtures` / `ClientFixtures` ont été adaptées au type unique CLIENT + codes (les tiers distributeur/courtier portent les `Category` de code DISTRIBUTEUR/COURTIER).
+> 🔗 **Coordination ERP-68** : ERP-53 pose la fixture référentielle minimale (4 category_types). ERP-68 l'**étend** (clients de démo, ~12-15) sans la dupliquer.
 ### 3.4 Entité `Client` — squelette
@@ -748,7 +742,7 @@ class Client implements TimestampableInterface, BlamableInterface
 - **Security** : `is_granted('commercial.clients.view')`
 - **Query params** :
  - `includeArchived=true|false` (default `false`)
-  - `categoryCode=<code>` (filtre les clients ayant ≥ 1 `Category` de ce code stable — ERP-78 ; ex. `DISTRIBUTEUR`, `COURTIER`)
+  - `categoryType=<code>` (filtre par type de catégorie via `SearchFilter`)
  - `search=<text>` (recherche fuzzy sur companyName + lastName + email)
 - **Tri par défaut** : `companyName ASC`
 - **Pagination** : front via `<MalioDataTable>` (volumétrie cible faible). Pas de pagination serveur au M1.
@@ -887,12 +881,11 @@ Cf. § 2.6. Pattern Shared standard.
 - **RG-1.01** : Au moins l'un des champs `firstName` (Prénom du contact principal) ou `lastName` (Nom du contact principal) doit être renseigné. Sinon → 422.
 - **RG-1.02** : Le champ `phoneSecondary` est optionnel et apparaît au clic sur un bouton `+` côté front. Maximum 2 téléphones (primary + secondary). Comportement purement front au niveau UI ; côté serveur, les 2 colonnes existent et sont distinctes.
- **RG-1.03** : Les champs `distributor` et `broker` sont **mutuellement exclusifs** (au plus une seule des deux est renseignée). Tentative d'envoyer les deux → 422. Contrainte CHECK en base également : `NOT (distributor_id IS NOT NULL AND broker_id IS NOT NULL)`. Un `distributor` référencé doit porter une **`Category` de code `DISTRIBUTEUR`** ; un `broker` une **`Category` de code `COURTIER`** — sinon 422. _(Refonte ERP-78 : le filtrage se fait sur le `code` de la `Category`, plus sur le type — `ClientProcessor::hasCategoryCode`.)_ La liste front de `distributor` = clients ayant une catégorie de code `DISTRIBUTEUR`, via `GET /api/clients?categoryCode=DISTRIBUTEUR` ; idem `broker` avec `COURTIER`.
+- **RG-1.03** : Les champs `distributor` et `broker` sont **mutuellement exclusifs** (au plus une seule des deux est renseignée). Tentative d'envoyer les deux → 422. Contrainte CHECK en base également : `NOT (distributor_id IS NOT NULL AND broker_id IS NOT NULL)`. La liste front de `distributor` = clients ayant au moins une catégorie de type `DISTRIBUTEUR` ; idem pour `broker` avec `COURTIER`.
 ### Onglet Information
- **RG-1.04** _(durcie — ERP-74)_ : Pour un utilisateur portant le rôle métier **Commerciale**, **tous** les champs de l'onglet Information (`description`, `competitors`, `foundedAt`, `employeesCount`, `revenueAmount`, `directorName`, `profitAmount`) sont obligatoires sur **POST et sur tout PATCH**, **indépendamment des champs réellement envoyés** (la condition d'intersection avec `client:write:information` a été retirée). Pour les autres rôles, ces champs restent optionnels. Implémenté via un validator custom `ClientInformationCompletenessValidator` invoqué systématiquement par le `ClientProcessor` quand le user porte le rôle Commerciale.
+- **RG-1.04** : Pour un utilisateur portant le rôle métier **Commerciale**, **tous** les champs de l'onglet Information (`description`, `competitors`, `foundedAt`, `employeesCount`, `revenueAmount`, `directorName`, `profitAmount`) deviennent obligatoires lors d'un PATCH sur le groupe `client:write:information`. Pour les autres rôles, ces champs restent optionnels. Implémenté via un validator custom `ClientInformationCompletenessValidator` invoqué par le `ClientProcessor` quand le user porte le rôle Commerciale.
  - **Conséquence** : le POST n'exposant que le groupe `client:write:main`, l'onglet Information n'y est pas renseignable → une Commerciale obtient **422** sur tout POST (cf. § 8.1). La complétude se fait donc via les PATCH `client:write:information` ultérieurs. Un Admin (non gaté) crée normalement (201).
 ### Onglet Contact
@@ -952,9 +945,9 @@ Cf. § 2.6. Pattern Shared standard.
 - **RG-1.28** : Si un PATCH contient des champs de **plusieurs groupes** de sérialisation et que l'utilisateur **n'a pas toutes les permissions** correspondantes, le `ClientProcessor` renvoie **403 Forbidden sur l'ensemble du payload** (mode strict — pas de filtrage silencieux). Le front est responsable de ne JAMAIS envoyer de champs hors-permission (les onglets masqués via `usePermissions()` ne génèrent pas de payload). Cette règle protège contre les appels API directs malveillants. Exemple : un Bureau qui envoie `{ "companyName": "...", "siren": "..." }` → 403, le message d'erreur précise « Champ `siren` requiert la permission `commercial.clients.accounting.manage` ».
-### Catégorie sur ClientAddress (filtrage par code)
+### Catégorie sur ClientAddress (filtrage par type)
- **RG-1.29** _(refonte ERP-78)_ : sur une adresse, les `Category` de **code `DISTRIBUTEUR` ou `COURTIER`** sont **interdites** — elles qualifient une **relation entre clients** (cf. RG-1.03) et n'ont pas de sens sur une adresse physique. **Toute autre** catégorie (type unique CLIENT) est autorisée. Validation du POST/PATCH : poster une catégorie de code DISTRIBUTEUR/COURTIER sur une adresse → **422** avec violation `categories: "Type de catégorie non autorisé sur une adresse."` (`ClientAddress::validateCategoryCodes`). Côté front, le `<MalioSelectCheckbox>` Catégorie de l'onglet Adresse exclut les `Category` de code `DISTRIBUTEUR` / `COURTIER` (le `code` est exposé en lecture sur `/api/categories`).
+- **RG-1.29** : Le `<MalioSelectCheckbox>` Catégorie de l'onglet Adresse n'expose **que** les `Category` dont `categoryType.code IN ('SECTEUR', 'AUTRE')`. Les types `DISTRIBUTEUR` et `COURTIER` qualifient une **relation entre clients** (cf. RG-1.03) et n'ont pas de sens sur une adresse physique. Implémentation : `ClientAddressProvider` filtre côté serveur via paramètre de requête à l'endpoint `GET /api/categories?categoryType.code[]=SECTEUR&categoryType.code[]=AUTRE` (SearchFilter API Platform). Côté validation du POST/PATCH : si l'utilisateur tente de poster une catégorie de type DISTRIBUTEUR ou COURTIER sur une adresse → **422** avec violation `categories: "Type de catégorie non autorisé sur une adresse."`.
 ## 8. Tests à automatiser
@@ -963,7 +956,7 @@ Cf. § 2.6. Pattern Shared standard.
 - [ ] **RG-1.01** : POST sans firstName ni lastName → 422
 - [ ] **RG-1.02** : POST avec phoneSecondary rempli → persistance OK ; PATCH ajoutant un 3e téléphone → côté API, 2 colonnes uniquement (test que le payload ne peut pas créer un 3e)
 - [ ] **RG-1.03** : POST avec distributor ET broker → 422 ; POST distributor seul → 201
- [ ] **RG-1.03** : POST distributor référençant un client SANS catégorie de code DISTRIBUTEUR → 422 (validation custom `ClientProcessor::hasCategoryCode`)
+- [ ] **RG-1.03** : POST distributor référençant un client SANS catégorie de type DISTRIBUTEUR → 422 (validation custom)
 - [ ] **RG-1.04** : PATCH onglet Information par un user Commerciale avec champs incomplets → 422 ; même PATCH par Admin → 200
 - [ ] **RG-1.05** : POST contact sans firstName ni lastName → 422 (BDD CHECK lève une exception)
 - [ ] **RG-1.06/07/08** : POST adresse avec isProspect=true ET isDelivery=true → 422 / CHECK
@@ -96,8 +96,8 @@ C'est le 1er bloc à remplir. Sans validation de ce formulaire, les onglets ne s
 | **Téléphone secondaire** | `<MalioInputText>` (masque tel) | Non | Apparaît au clic sur le bouton `+` (RG-1.02). Max 2 — bouton `+` disparaît une fois rempli. |
 | **Email** | `<MalioInputText>` type email | Oui | RG-1.21 (lowercase) |
 | **Distributeur / Courtier** | `<MalioSelect>` | Non | Valeurs : `Dépend du distributeur` / `Dépend du courtier` / `Aucun`. RG-1.03 conditionne les 2 champs suivants. |
-| **Nom du distributeur** | `<MalioSelect>` | Conditionnel | Visible si « Dépend du distributeur ». Liste = clients ayant ≥ 1 catégorie de **code** `DISTRIBUTEUR` (ERP-78), via `GET /api/clients?categoryCode=DISTRIBUTEUR`. RG-1.03. |
+| **Nom du distributeur** | `<MalioSelect>` | Conditionnel | Visible si « Dépend du distributeur ». Liste = clients ayant ≥ 1 catégorie de type `DISTRIBUTEUR`. RG-1.03. |
-| **Nom du courtier** | `<MalioSelect>` | Conditionnel | Visible si « Dépend du courtier ». Liste = clients ayant ≥ 1 catégorie de **code** `COURTIER` (ERP-78), via `GET /api/clients?categoryCode=COURTIER`. RG-1.03. |
+| **Nom du courtier** | `<MalioSelect>` | Conditionnel | Visible si « Dépend du courtier ». Liste = clients ayant ≥ 1 catégorie de type `COURTIER`. RG-1.03. |
 | **Prestation de triage** | `<MalioCheckbox>` | Non | — |
 **Action** : « Valider » (`<MalioButton>`) → POST `/api/clients` ([`spec-back.md` § 4.3](./spec-back.md)). Si succès, on passe automatiquement à l'onglet « Information ».
@@ -150,7 +150,7 @@ Saisir une ou plusieurs adresses du client, rattachées à un ou plusieurs sites
 | **Prospect** | `<MalioCheckbox>` | Non | RG-1.06 — masque Adresse de livraison + Facturation si coché |
 | **Adresse de livraison** | `<MalioCheckbox>` | Non | RG-1.07 — masque Prospect si coché |
 | **Facturation** | `<MalioCheckbox>` | Non | RG-1.08 — masque Prospect si coché ; affiche le champ Email (RG-1.11) |
-| **Catégorie** | `<MalioSelectCheckbox>` (multi) | Oui | Liste des `Category` **hors codes `DISTRIBUTEUR` / `COURTIER`** (ERP-78 — ces codes qualifient une relation entre clients, pas un lieu). Le front exclut ces 2 codes du select (le `code` est exposé en lecture sur `/api/categories`). |
+| **Catégorie** | `<MalioSelectCheckbox>` (multi) | Oui | Liste des `Category` de **type SECTEUR + AUTRE** uniquement (cf. décision Q5 — DISTRIBUTEUR et COURTIER qualifient une relation entre clients, pas un lieu) |
 | **Pays** | `<MalioSelect>` | Oui | Préremplie « France » |
 | **Code postal** | `<MalioInputText>` (masque numérique) | Oui | RG-1.09 — déclenche autocomplete ville via BAN |
 | **Ville** | `<MalioSelect>` | Oui | RG-1.09 — alimentée par api-adresse.data.gouv.fr suivant le CP |
@@ -268,7 +268,7 @@ Le composant `Code postal` + `Ville` + `Adresse` est branché sur **api-adresse.
 | # | Zone d'ombre V0 | Résolution (cf. `spec-back.md`) |
 |---|---|---|
-| 1 | Catégorie en multi-select non clarifiée (1 ou n par client) | **M2M `client_category`** validée. Refonte ERP-78 : type unique `CLIENT` ; `Distributeur`/`Courtier`/`Secteur`/`Autre` (+ catégories métier) sont des `Category` portant un `code` stable (HP-3 du M0 levé). |
+| 1 | Catégorie en multi-select non clarifiée (1 ou n par client) | **M2M `client_category`** validée. CategoryType seedé avec `DISTRIBUTEUR`, `COURTIER`, `SECTEUR`, `AUTRE` (HP-3 du M0 levé). |
 | 2 | Distributeur / Courtier : liste de quoi ? | **Auto-référence Client** via 2 FK nullables `distributor_id` et `broker_id` (cf. RG-1.03). Une seule des deux est remplie à la fois. |
 | 3 | Onglet « Comptabilité » : qui édite ? | **Admin et Compta** peuvent éditer l'onglet Comptabilité (`commercial.clients.accounting.manage`). Bureau / Commerciale ne voient pas l'onglet. Compta ne peut pas créer un client (pas de `manage` global), mais peut éditer la partie comptable d'un client existant. |
 | 4 | Workflow par onglet | **Sauvegarde incrémentale**. POST formulaire principal crée le `Client` (status implicite « actif »). Chaque onglet validé = PATCH partiel par groupe de sérialisation dédié. Pas d'état « draft ». |
@@ -24,10 +24,10 @@
            <div class="h-full flex-1 flex flex-col min-h-0 min-w-0">
                <SiteSelector v-if="showSiteSelector"/>
                <main
-                    class="flex flex-1 flex-col overflow-y-auto overflow-x-hidden bg-white px-4 pb-10 sm:px-6 lg:px-12 xl:px-11">
+                    class="flex flex-1 flex-col overflow-y-auto overflow-x-hidden bg-white px-4 pb-10 sm:px-6 lg:px-12 xl:px-[170px]">
                    <div
                        aria-hidden="true"
-                        class="pointer-events-none sticky top-0 z-30 h-11 flex-shrink-0 bg-white"/>
+                        class="pointer-events-none sticky top-0 z-30 h-[47px] flex-shrink-0 bg-white"/>
                    <slot/>
                </main>
            </div>
@@ -44,147 +44,7 @@
    },
    "commercial": {
        "title": "Commercial",
-        "welcome": "Module Commercial",
+        "welcome": "Module Commercial"
        "clients": {
            "title": "Répertoire clients",
            "add": "Ajouter",
            "export": "Exporter",
            "empty": "Aucun client pour l'instant.",
            "column": {
                "companyName": "Nom",
                "categories": "Catégories",
                "sites": "Site",
                "lastActivity": "Dernière activité"
            },
            "filters": {
                "title": "Filtres",
                "search": "Recherche",
                "categories": "Catégories",
                "sites": "Sites",
                "status": "Statut",
                "archivedOnly": "Voir les archivés",
                "apply": "Voir les résultats",
                "reset": "Réinitialiser"
            },
            "tab": {
                "information": "Information",
                "contact": "Contact",
                "address": "Adresse",
                "transport": "Transport",
                "accounting": "Comptabilité",
                "statistics": "Statistiques",
                "reports": "Rapports",
                "exchanges": "Échanges"
            },
            "action": {
                "edit": "Modifier",
                "archive": "Archiver",
                "restore": "Restaurer"
            },
            "toast": {
                "createSuccess": "Client créé avec succès",
                "updateSuccess": "Client mis à jour avec succès",
                "archiveSuccess": "Client archivé avec succès",
                "restoreSuccess": "Client restauré avec succès",
                "error": "Une erreur est survenue. Réessayez.",
                "exportError": "L'export du répertoire clients a échoué. Réessayez."
            },
            "validation": {
                "informationRequiredForCommercial": "Les informations de l'entreprise sont obligatoires pour le rôle Commerciale.",
                "contactRequired": "Au moins un contact (nom ou prénom) est obligatoire.",
                "siteRequired": "Au moins un site Starseed doit être rattaché à l'adresse.",
                "billingEmailRequired": "L'email de facturation est obligatoire pour une adresse de facturation.",
                "bankRequiredForTransfer": "La banque est obligatoire pour un règlement par virement.",
                "ribRequiredForLcr": "Au moins un RIB complet est obligatoire pour un règlement par LCR.",
                "phoneFormat": "Format de téléphone invalide (attendu : XX XX XX XX XX).",
                "emailFormat": "Format d'email invalide.",
                "addressCategoryForbidden": "Une catégorie « Distributeur » ou « Courtier » ne peut pas qualifier une adresse."
            },
            "form": {
                "title": "Ajouter un client",
                "back": "Précédent",
                "submit": "Valider",
                "duplicateCompany": "Un client portant ce nom de société existe déjà.",
                "main": {
                    "companyName": "Nom du client (Entreprise)",
                    "firstName": "Prénom du contact principal",
                    "lastName": "Nom du contact principal",
                    "email": "Email",
                    "phonePrimary": "Téléphone",
                    "phoneSecondary": "Téléphone (2)",
                    "addPhone": "Ajouter un numéro",
                    "categories": "Catégorie",
                    "relation": "Distributeur / Courtier",
                    "relationDistributor": "Dépend du distributeur",
                    "relationBroker": "Dépend du courtier",
                    "distributorName": "Nom du distributeur",
                    "brokerName": "Nom du courtier",
                    "triageService": "Prestation de triage"
                },
                "information": {
                    "description": "Description",
                    "competitors": "Concurrent",
                    "foundedAt": "Date de création",
                    "employeesCount": "Nombre de salariés",
                    "revenueAmount": "CA",
                    "profitAmount": "Résultat",
                    "directorName": "Dirigeant"
                },
                "contact": {
                    "title": "Contact {n}",
                    "lastName": "Nom",
                    "firstName": "Prénom",
                    "jobTitle": "Fonction",
                    "email": "Email",
                    "phonePrimary": "Téléphone",
                    "phoneSecondary": "Téléphone (2)",
                    "addPhone": "Ajouter un numéro",
                    "remove": "Supprimer le contact",
                    "add": "Nouveau contact"
                },
                "address": {
                    "title": "Adresse {n}",
                    "prospect": "Prospect",
                    "delivery": "Adresse de livraison",
                    "billing": "Facturation",
                    "categories": "Catégorie",
                    "country": "Pays",
                    "postalCode": "Code postal",
                    "city": "Ville",
                    "street": "Adresse",
                    "streetComplement": "Adresse complémentaire",
                    "sites": "Sites Starseed",
                    "contacts": "Contact(s) rattaché(s)",
                    "billingEmail": "Email de facturation",
                    "remove": "Supprimer l'adresse",
                    "add": "Nouvelle adresse",
                    "degraded": "Service d'adresse indisponible : saisie de la ville et de l'adresse en mode libre."
                },
                "accounting": {
                    "siren": "SIREN",
                    "accountNumber": "Numéro de compte",
                    "tvaMode": "Mode de TVA",
                    "nTva": "N° de TVA",
                    "paymentDelay": "Délai de règlement",
                    "paymentType": "Type de règlement",
                    "bank": "Banque",
                    "ribTitle": "RIB {n}",
                    "ribLabel": "Libellé",
                    "ribBic": "BIC",
                    "ribIban": "IBAN",
                    "addRib": "Ajouter un RIB",
                    "removeRib": "Supprimer le RIB"
                },
                "confirmDelete": {
                    "title": "Confirmer la suppression",
                    "contact": "Supprimer ce contact ?",
                    "address": "Supprimer cette adresse ?",
                    "rib": "Supprimer ce RIB ?",
                    "cancel": "Annuler",
                    "confirm": "Confirmer"
                }
            }
        }
    },
    "auth": {
        "login": "Connexion",
@@ -222,15 +82,10 @@
            "delete": "Suppression"
        },
        "entity": {
-            "core_user":              "Utilisateur",
+            "core_user":       "Utilisateur",
-            "core_role":              "Rôle",
+            "core_role":       "Rôle",
-            "core_permission":        "Permission",
+            "core_permission": "Permission",
-            "sites_site":             "Site",
+            "sites_site":      "Site"
            "catalog_category":       "Catégorie",
            "commercial_client":      "Client",
            "commercial_clientaddress": "Adresse client",
            "commercial_clientcontact": "Contact client",
            "commercial_clientrib":   "RIB client"
        },
        "empty": "Aucune activité enregistrée",
        "no_results": "Aucun résultat pour ces filtres",
@@ -12,7 +12,7 @@
            </h2>
        </template>
-        <form class="flex flex-col py-4 gap-2" @submit.prevent="handleSave">
+        <form class="flex flex-col gap-4 py-4" @submit.prevent="handleSave">
            <!-- Nom (RG-1.02 obligatoire / RG-1.04 longueur 2-120 apres trim).
                 Erreur miroir client + erreurs server-side (422) mappees sur ce champ. -->
            <MalioInputText
@@ -52,21 +52,21 @@
                variant="danger"
                icon-name="mdi:delete-outline"
                icon-position="left"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('delete')"
            />
            <MalioButton
                v-else
                :label="t('common.cancel')"
                variant="tertiary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('update:modelValue', false)"
            />
            <MalioButton
                v-if="canShowSave"
                :label="t('common.save')"
                variant="primary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                :disabled="form.submitting.value || loadingTypes"
                @click="handleSave"
            />
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
-import type { CategoryType } from '~/modules/catalog/types/category'
+import type { Category, CategoryType } from '~/modules/catalog/types/category'
 import type { HydraCollection } from '~/shared/utils/api'
 // Mock du store auth : useCategoriesAdmin s'auto-enregistre via
@@ -28,6 +28,27 @@ const { useCategoriesAdmin } = await import('../useCategoriesAdmin')
 const TYPE_VENTE: CategoryType = { id: 1, code: 'VENTE', label: 'Vente' }
 const TYPE_ACHAT: CategoryType = { id: 2, code: 'ACHAT', label: 'Achat' }
 const CAT_A: Category = {
    id: 10,
    name: 'Vis',
    categoryType: TYPE_VENTE,
    deletedAt: null,
    createdAt: '2026-01-01T10:00:00+00:00',
    updatedAt: '2026-01-01T10:00:00+00:00',
    createdBy: null,
    updatedBy: null,
 }
 const CAT_B: Category = {
    id: 11,
    name: 'Boulons',
    categoryType: TYPE_VENTE,
    deletedAt: null,
    createdAt: '2026-01-02T10:00:00+00:00',
    updatedAt: '2026-01-02T10:00:00+00:00',
    createdBy: null,
    updatedBy: null,
 }
 function makeHydra<T>(items: T[]): HydraCollection<T> {
    return {
        totalItems: items.length,
@@ -35,32 +56,113 @@ function makeHydra<T>(items: T[]): HydraCollection<T> {
    }
 }
 /**
 * Apres ERP-73, `useCategoriesAdmin` ne porte plus la liste paginee des
 * categories (elle est geree par `usePaginatedList<Category>` cote page).
 * Le composable se concentre sur le referentiel CategoryType (lecture
 * seule, ≤ 5 entrees connues) charge en une fois via `?pagination=false`.
 */
 describe('useCategoriesAdmin', () => {
    beforeEach(() => {
        mockGet.mockReset()
        // Reset systematique du state singleton entre tests : sans ca,
-        // les types charges dans un test fuiteraient dans le suivant.
+        // les categories chargees dans un test fuiteraient dans le suivant.
        const { resetCategoriesAdmin } = useCategoriesAdmin()
        resetCategoriesAdmin()
    })
    describe('fetchAll', () => {
        it('appelle GET /categories avec itemsPerPage=999 par defaut', async () => {
            mockGet.mockResolvedValueOnce(makeHydra<Category>([]))
            const { fetchAll } = useCategoriesAdmin()
            await fetchAll()
            expect(mockGet).toHaveBeenCalledTimes(1)
            expect(mockGet).toHaveBeenCalledWith(
                '/categories',
                { itemsPerPage: 999 },
                { toast: false },
            )
        })
        it('peuple categories.value depuis le champ Hydra member', async () => {
            mockGet.mockResolvedValueOnce(makeHydra([CAT_A, CAT_B]))
            const { fetchAll, categories } = useCategoriesAdmin()
            await fetchAll()
            expect(categories.value).toEqual([CAT_A, CAT_B])
        })
        it('exclut les soft-deleted par defaut (pas de query includeDeleted)', async () => {
            mockGet.mockResolvedValueOnce(makeHydra<Category>([]))
            const { fetchAll } = useCategoriesAdmin()
            await fetchAll()
            const queryArg = mockGet.mock.calls[0]?.[1] as Record<string, unknown>
            expect(queryArg).not.toHaveProperty('includeDeleted')
        })
        it('ajoute includeDeleted=true quand demande explicitement', async () => {
            mockGet.mockResolvedValueOnce(makeHydra<Category>([]))
            const { fetchAll } = useCategoriesAdmin()
            await fetchAll(true)
            expect(mockGet).toHaveBeenCalledWith(
                '/categories',
                { itemsPerPage: 999, includeDeleted: 'true' },
                { toast: false },
            )
        })
        it('passe loading a true pendant la requete et false apres', async () => {
            let resolveRequest: (v: HydraCollection<Category>) => void = () => {}
            mockGet.mockImplementationOnce(
                () => new Promise((resolve) => { resolveRequest = resolve }),
            )
            const { fetchAll, loading } = useCategoriesAdmin()
            const pending = fetchAll()
            expect(loading.value).toBe(true)
            resolveRequest(makeHydra<Category>([]))
            await pending
            expect(loading.value).toBe(false)
        })
        it('peuple error.value et vide categories en cas d echec', async () => {
            mockGet.mockRejectedValueOnce(new Error('Network down'))
            const { fetchAll, categories, error, loading } = useCategoriesAdmin()
            // Pre-charge volontairement quelque chose pour verifier la purge.
            categories.value = [CAT_A]
            await fetchAll()
            expect(categories.value).toEqual([])
            expect(error.value).toBe('Network down')
            expect(loading.value).toBe(false)
        })
        it('gere une reponse sans champ member (fallback tableau vide)', async () => {
            mockGet.mockResolvedValueOnce({
                totalItems: 0,
            } as unknown as HydraCollection<Category>)
            const { fetchAll, categories } = useCategoriesAdmin()
            await fetchAll()
            expect(categories.value).toEqual([])
        })
    })
    describe('fetchTypes', () => {
-        it('appelle GET /category_types avec ?pagination=false (echappatoire selects)', async () => {
+        it('appelle GET /category_types avec itemsPerPage=999', async () => {
            mockGet.mockResolvedValueOnce(makeHydra<CategoryType>([]))
            const { fetchTypes } = useCategoriesAdmin()
            await fetchTypes()
            expect(mockGet).toHaveBeenCalledTimes(1)
            expect(mockGet).toHaveBeenCalledWith(
                '/category_types',
-                { pagination: 'false' },
+                { itemsPerPage: 999 },
                { toast: false },
            )
        })
@@ -101,55 +203,48 @@ describe('useCategoriesAdmin', () => {
            expect(loadingTypes.value).toBe(false)
        })
        it('gere une reponse sans champ member (fallback tableau vide)', async () => {
            mockGet.mockResolvedValueOnce({
                totalItems: 0,
            } as unknown as HydraCollection<CategoryType>)
            const { fetchTypes, types } = useCategoriesAdmin()
            await fetchTypes()
            expect(types.value).toEqual([])
        })
    })
    describe('resetCategoriesAdmin', () => {
-        it('vide types, loadingTypes et error', () => {
+        it('vide categories, types, loading, loadingTypes et error', () => {
-            const { resetCategoriesAdmin, types, loadingTypes, error }
+            const { resetCategoriesAdmin, categories, types, loading, loadingTypes, error }
                = useCategoriesAdmin()
            // Pre-peuple le state pour verifier la purge effective.
            categories.value = [CAT_A]
            types.value = [TYPE_VENTE]
            loading.value = true
            loadingTypes.value = true
            error.value = 'oops'
            resetCategoriesAdmin()
            expect(categories.value).toEqual([])
            expect(types.value).toEqual([])
            expect(loading.value).toBe(false)
            expect(loadingTypes.value).toBe(false)
            expect(error.value).toBeNull()
        })
    })
    describe('singleton', () => {
-        it('deux appels a useCategoriesAdmin() partagent la meme ref types', () => {
+        it('deux appels a useCategoriesAdmin() partagent la meme ref categories', () => {
            const a = useCategoriesAdmin()
            const b = useCategoriesAdmin()
            // Les fonctions sont reinstanciees a chaque appel mais les refs
            // doivent etre rigoureusement les memes (state au niveau module).
            expect(a.categories).toBe(b.categories)
            expect(a.types).toBe(b.types)
-            expect(a.loadingTypes).toBe(b.loadingTypes)
+            expect(a.loading).toBe(b.loading)
            expect(a.error).toBe(b.error)
        })
        it('une mutation via une instance est visible depuis une autre instance', () => {
            const a = useCategoriesAdmin()
            const b = useCategoriesAdmin()
-            a.types.value = [TYPE_VENTE]
+            a.categories.value = [CAT_A]
-            expect(b.types.value).toEqual([TYPE_VENTE])
+            expect(b.categories.value).toEqual([CAT_A])
        })
    })
 })
@@ -1,56 +1,96 @@
 /**
- * Composable de chargement du referentiel CategoryType (M0 — Gestion des
+ * Composable d'administration des categories (M0 — Gestion des categories).
 * categories).
 *
- * Apres ERP-73 (composable de liste paginee), la liste des categories
+ * Centralise le chargement et le state des deux ressources lues par la page
- * elle-meme passe par `usePaginatedList<Category>` directement dans
+ * `/admin/categories` : la liste des categories et le referentiel
- * `admin/categories.vue` — c'est un etat propre a la page (pagination,
+ * CategoryType (utilise dans le select du drawer).
 * filtres, tri locaux). Ce composable se concentre donc sur le
 * referentiel CategoryType : petite collection lue une fois et reutilisee
 * dans le drawer (select de type) → singleton volontaire pour eviter de
 * la recharger a chaque ouverture du drawer.
 *
- * State singleton au niveau module : reset automatique au logout via
+ * State singleton au niveau module (meme convention que `useSidebar` /
- * `onAuthSessionCleared` (cf. CLAUDE.md regle frontend.md), et reset
+ * `useModules` / `useAuditLog`) : reset automatique au logout via
- * explicite via `resetCategoriesAdmin()` appele depuis logout.vue.
+ * `onAuthSessionCleared` (cf. CLAUDE.md regle frontend.md : « composables
 * avec state singleton doivent etre reinitialises au logout »), et reset
 * explicite expose via `resetCategoriesAdmin()` appele depuis
 * `modules/core/pages/logout.vue`.
 */
 import { ref } from 'vue'
-import type { CategoryType } from '~/modules/catalog/types/category'
+import type { Category, CategoryType } from '~/modules/catalog/types/category'
 import type { HydraCollection } from '~/shared/utils/api'
 import { onAuthSessionCleared } from '~/shared/stores/auth'
 /**
- * CategoryType est un referentiel lecture-seule (RG-1.06) avec une
+ * Dette M0 : pas de pagination serveur sur les ressources Catalog (volumetrie
- * cardinalite minuscule (≤ 5 entrees connues). On force `pagination=false`
+ * cible ≤ 300). On force une page geante via `itemsPerPage` pour recuperer
- * pour recuperer toutes les entrees en un appel et alimenter le select du
+ * toute la liste en un coup. A basculer en pagination serveur quand la
- * drawer sans pagination — echappatoire prevue par
+ * volumetrie reelle depassera ce plafond — meme pattern que sites.vue.
 * `pagination_client_enabled: true` cote API Platform.
 */
-const NO_PAGINATION_QUERY = { pagination: 'false' } as const
+const HYDRA_NO_PAGINATION = 999
 // State singleton — partage entre tous les composants qui appellent le
 // composable dans la meme session. Les refs sont declarees au niveau module
 // (pas dans la fonction `useCategoriesAdmin()`) pour eviter qu'une nouvelle
 // instance soit creee a chaque appel.
 const categories = ref<Category[]>([])
 const types = ref<CategoryType[]>([])
 const loading = ref(false)
 const loadingTypes = ref(false)
 const error = ref<string | null>(null)
 function resetCategoriesAdminState(): void {
    categories.value = []
    types.value = []
    loading.value = false
    loadingTypes.value = false
    error.value = null
 }
-// Auto-enregistrement singleton : purge le state sur 401/clearSession
+// Auto-enregistrement singleton : purge le state sur 401/clearSession pour
-// pour eviter qu'un user suivant (connecte sur le meme onglet) voie le
+// eviter qu'un user suivant (connecte sur le meme onglet) voie l'etat de
-// referentiel de l'ancien tenant. Le logout volontaire (page logout.vue)
+// l'ancien. Le logout volontaire (page logout.vue) appelle directement
-// appelle directement `resetCategoriesAdmin()` ci-dessous.
+// `resetCategoriesAdmin()` ci-dessous.
 onAuthSessionCleared(resetCategoriesAdminState)
 export function useCategoriesAdmin() {
    const api = useApi()
    /**
-     * Charge le referentiel CategoryType. Appele a l'ouverture de la page
+     * Charge la liste des categories. Le serveur exclut les soft-deleted par
-     * admin pour que le select du drawer ait deja les options pretes au
+     * defaut (RG-1.08) et trie par name ASC (RG-1.10). Pas de pagination
-     * moment de la creation/edition.
+     * serveur (volumetrie ≤ 300, pagination front via MalioDataTable).
     *
     * `includeDeleted=true` permet a un user avec `catalog.categories.manage`
     * de voir les soft-deleted (RG-1.09) — au M0 la page n'utilise pas cette
     * option mais on l'expose pour la suite (corbeille future).
     *
     * Swallow volontaire : un 403 (user sans permission view) ne doit pas
     * toaster — la sidebar masque deja l'entree pour ces users, on tombe sur
     * la page seulement par URL directe et on affiche un tableau vide propre.
     */
    async function fetchAll(includeDeleted = false): Promise<void> {
        loading.value = true
        error.value = null
        try {
            const query: Record<string, unknown> = { itemsPerPage: HYDRA_NO_PAGINATION }
            if (includeDeleted) {
                query.includeDeleted = 'true'
            }
            const data = await api.get<HydraCollection<Category>>(
                '/categories',
                query,
                { toast: false },
            )
            categories.value = data.member ?? []
        } catch (e) {
            categories.value = []
            error.value = (e as Error)?.message ?? 'Erreur de chargement'
        } finally {
            loading.value = false
        }
    }
    /**
     * Charge le referentiel CategoryType (lecture seule, RG-1.06). Appele a
     * l'ouverture de la page admin pour que le select du drawer ait deja les
     * options pretes au moment de la creation/edition.
     *
     * Toast desactive : on stocke l'erreur dans `error` plutot que de
     * spammer un toast — le drawer affichera l'erreur inline s'il y a lieu.
@@ -60,7 +100,7 @@ export function useCategoriesAdmin() {
        try {
            const data = await api.get<HydraCollection<CategoryType>>(
                '/category_types',
-                NO_PAGINATION_QUERY,
+                { itemsPerPage: HYDRA_NO_PAGINATION },
                { toast: false },
            )
            types.value = data.member ?? []
@@ -73,18 +113,21 @@ export function useCategoriesAdmin() {
    }
    /**
-     * Reset explicite — appele depuis `logout.vue` apres `auth.logout()`
+     * Reset explicite — appele depuis `logout.vue` apres `auth.logout()` pour
-     * pour garantir que la prochaine session reparte sur un state propre
+     * garantir que la prochaine session reparte sur un state propre meme si
-     * meme si `clearSession()` n'a pas ete declenche (cas logout volontaire).
+     * `clearSession()` n'a pas ete declenche (cas logout volontaire).
     */
    function resetCategoriesAdmin(): void {
        resetCategoriesAdminState()
    }
    return {
        categories,
        types,
        loading,
        loadingTypes,
        error,
        fetchAll,
        fetchTypes,
        resetCategoriesAdmin,
    }
@@ -13,23 +13,18 @@
            </template>
        </PageHeader>
-        <!-- Table des categories. Tri serveur (name ASC, RG-1.10) +
+        <!-- Table des categories. Affichage exhaustif (volumetrie cible
-             pagination serveur via usePaginatedList (#73). Le composable
+             <= 300, cf. spec § 4.1) — tri 100% serveur via CategoryProvider
-             remplace l'ancien chargement « tout en un coup » a volumetrie
+             (name ASC, RG-1.10). La barre de pagination du MalioDataTable
-             cible ≤ 300 — la pagination est desormais alignee sur la regle
+             reste cosmetique tant qu'aucun slice client n'est cable : a
-             projet (toute collection paginee, regle ABSOLUE n°13). -->
+             traiter cote @malio/layer-ui le jour ou la volumetrie monte. -->
        <MalioDataTable
            :columns="columns"
            :items="categoryItems"
-            :total-items="totalItems"
+            :total-items="categories.length"
            :page="currentPage"
            :per-page="itemsPerPage"
            :per-page-options="itemsPerPageOptions"
            :row-clickable="true"
            :empty-message="t('admin.categories.noCategories')"
            @row-click="onRowClick"
            @update:page="goToPage"
            @update:per-page="setItemsPerPage"
        />
        <!-- Drawer creation / consultation / edition. -->
@@ -55,27 +50,13 @@ import type { Category } from '~/modules/catalog/types/category'
 const { t } = useI18n()
 const { can } = usePermissions()
-const { fetchTypes } = useCategoriesAdmin()
+const { categories, fetchAll, fetchTypes } = useCategoriesAdmin()
 const { submitDelete } = useCategoryForm()
 useHead({ title: t('admin.categories.title') })
 const canManage = computed(() => can('catalog.categories.manage'))
 // Pagination serveur via le composable partage (#73). Le CategoryProvider
 // applique deja name ASC (RG-1.10) — pas besoin de defaultSort cote front
 // tant qu'aucun OrderFilter n'est expose.
 const {
    items: categories,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: fetchCategories,
    goToPage,
    setItemsPerPage,
 } = usePaginatedList<Category>({ url: '/categories' })
 const drawerOpen = ref(false)
 const selectedCategory = ref<Category | null>(null)
 const deleteModalOpen = ref(false)
@@ -137,7 +118,7 @@ async function handleDelete(): Promise<void> {
            deleteModalOpen.value = false
            categoryToDelete.value = null
            drawerOpen.value = false
-            await fetchCategories()
+            await fetchAll()
        }
    } finally {
        deleting.value = false
@@ -145,14 +126,14 @@ async function handleDelete(): Promise<void> {
 }
 function onCategorySaved() {
-    fetchCategories()
+    fetchAll()
 }
 // Chargement initial des deux ressources (liste + referentiel des types).
 // Le referentiel est pre-charge ici (et pas dans le drawer) pour que le
 // select soit pret au moment ou l'utilisateur clique sur « + Ajouter ».
 onMounted(() => {
-    fetchCategories()
+    fetchAll()
    fetchTypes()
 })
 </script>
@@ -1,298 +0,0 @@
 <template>
    <div class="relative grid grid-cols-4 gap-x-[44px] gap-y-4 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
        <!-- ariaLabel via v-bind objet (prop camelCase ; aria-* serait un attribut HTML). -->
        <MalioButtonIcon
            v-if="removable && !readonly"
            icon="mdi:delete-outline"
            variant="ghost"
            button-class="absolute top-3 right-3"
            v-bind="{ ariaLabel: t('commercial.clients.form.address.remove') }"
            @click="$emit('remove')"
        />
        <!-- Usage de l'adresse : Prospect exclusif de Livraison/Facturation
             (RG-1.06/07/08). L'exclusivite est appliquee au toggle (cocher l'un
             decoche l'autre) plutot qu'en masquant les options. -->
        <MalioCheckbox
            :model-value="model.isProspect"
            :label="t('commercial.clients.form.address.prospect')"
            group-class="self-center"
            :readonly="readonly"
            @update:model-value="(v: boolean) => toggleFlag('isProspect', v)"
        />
        <MalioCheckbox
            :model-value="model.isDelivery"
            :label="t('commercial.clients.form.address.delivery')"
            group-class="self-center"
            :readonly="readonly"
            @update:model-value="(v: boolean) => toggleFlag('isDelivery', v)"
        />
        <MalioCheckbox
            :model-value="model.isBilling"
            :label="t('commercial.clients.form.address.billing')"
            group-class="self-center"
            :readonly="readonly"
            @update:model-value="(v: boolean) => toggleFlag('isBilling', v)"
        />
        <!-- Cellule vide : laisse un trou en position 4 (ligne 1) pour que
             Categorie reparte au debut de la ligne suivante. -->
        <div aria-hidden="true" />
        <MalioSelectCheckbox
            :model-value="model.categoryIris"
            :options="categoryOptions"
            :label="t('commercial.clients.form.address.categories')"
            :display-tag="true"
            :disabled="readonly"
            @update:model-value="(v: (string | number)[]) => update('categoryIris', v.map(String))"
        />
        <MalioSelect
            :model-value="model.country"
            :options="countryOptions"
            :label="t('commercial.clients.form.address.country')"
            :disabled="readonly"
            @update:model-value="(v: string | number | null) => update('country', String(v ?? 'France'))"
        />
        <MalioInputText
            :model-value="model.postalCode"
            :label="t('commercial.clients.form.address.postalCode')"
            :mask="POSTAL_CODE_MASK"
            :readonly="readonly"
            @update:model-value="onPostalCodeChange"
        />
        <!-- Ville : MalioSelect alimente par le code postal (BAN). En mode
             degrade (service indisponible), bascule en saisie libre. -->
        <MalioSelect
            v-if="!degraded"
            :model-value="model.city"
            :options="cityOptions"
            :label="t('commercial.clients.form.address.city')"
            :disabled="readonly"
            empty-option-label=""
            @update:model-value="(v: string | number | null) => update('city', v === null ? null : String(v))"
        />
        <MalioInputText
            v-else
            :model-value="model.city"
            :label="t('commercial.clients.form.address.city')"
            :readonly="readonly"
            @update:model-value="(v: string) => update('city', v)"
        />
        <!-- Adresse + Adresse complementaire sur 2 colonnes : on wrappe car
             MalioInputText/Autocomplete (inheritAttrs:false) renvoient `class`
             sur l'input interne, pas sur la cellule de grille. Le wrapper porte
             le col-span-2, le champ le remplit (w-full). -->
        <div class="col-span-2">
            <!-- Adresse : saisie assistee (BAN) ou libre en mode degrade. -->
            <MalioInputAutocomplete
                v-if="!degraded"
                :model-value="model.street"
                :options="addressOptions"
                :loading="addressLoading"
                :min-search-length="3"
                :label="t('commercial.clients.form.address.street')"
                :readonly="readonly"
                @update:model-value="(v: string | number | null) => update('street', v === null ? null : String(v))"
                @search="onAddressSearch"
                @select="onAddressSelect"
            />
            <MalioInputText
                v-else
                :model-value="model.street"
                :label="t('commercial.clients.form.address.street')"
                :readonly="readonly"
                @update:model-value="(v: string) => update('street', v)"
            />
        </div>
        <div class="col-span-2">
            <MalioInputText
                :model-value="model.streetComplement"
                :label="t('commercial.clients.form.address.streetComplement')"
                :readonly="readonly"
                @update:model-value="(v: string) => update('streetComplement', v)"
            />
        </div>
        <!-- Sites Starseed : cases a cocher inline (>= 1 obligatoire, RG-1.10). -->
        <div class="flex justify-between">
            <MalioCheckbox
                v-for="site in siteOptions"
                :key="site.value"
                :model-value="model.siteIris.includes(site.value)"
                :label="site.label"
                group-class="w-auto self-center"
                :readonly="readonly"
                @update:model-value="(v: boolean) => toggleSite(site.value, v)"
            />
        </div>
        <MalioSelectCheckbox
            :model-value="model.contactIris"
            :options="contactOptions"
            :label="t('commercial.clients.form.address.contacts')"
            :display-tag="true"
            :disabled="readonly"
            @update:model-value="(v: (string | number)[]) => update('contactIris', v.map(String))"
        />
        <!-- Email de facturation : visible/obligatoire seulement si Facturation
             est coche (RG-1.11). -->
        <MalioInputText
            v-if="isBillingEmailRequired(model)"
            :model-value="model.billingEmail"
            :label="t('commercial.clients.form.address.billingEmail')"
            :required="true"
            :readonly="readonly"
            @update:model-value="(v: string) => update('billingEmail', v)"
        />
    </div>
 </template>
 <script setup lang="ts">
 import {
    applyProspectExclusivity,
    isBillingEmailRequired,
    type AddressFlagsDraft,
 } from '~/modules/commercial/utils/clientFormRules'
 import { useAddressAutocomplete, type AddressSuggestion } from '~/shared/composables/useAddressAutocomplete'
 import type { CategoryOption, RefOption } from '~/modules/commercial/composables/useClientReferentials'
 import type { AddressFormDraft } from '~/modules/commercial/types/clientForm'
 // Masque code postal FR : 5 chiffres.
 const POSTAL_CODE_MASK = '#####'
 const props = defineProps<{
    /** Brouillon de l'adresse (v-model). */
    modelValue: AddressFormDraft
    title: string
    /** Categories autorisees sur une adresse (DISTRIBUTEUR/COURTIER exclus, RG-1.29). */
    categoryOptions: CategoryOption[]
    /** Sites Starseed disponibles. */
    siteOptions: RefOption[]
    /** Contacts deja saisis, rattachables a l'adresse. */
    contactOptions: RefOption[]
    /** Pays disponibles (France par defaut). */
    countryOptions: RefOption[]
    removable?: boolean
    readonly?: boolean
 }>()
 const emit = defineEmits<{
    'update:modelValue': [value: AddressFormDraft]
    'remove': []
    /** Emis une fois quand le service d'autocompletion bascule en indisponible. */
    'degraded': []
 }>()
 const { t } = useI18n()
 const autocomplete = useAddressAutocomplete()
 const model = computed(() => props.modelValue)
 // Mode degrade : service BAN indisponible → Ville/Adresse en saisie libre.
 const degraded = ref(false)
 const cityOptions = ref<RefOption[]>([])
 const addressOptions = ref<RefOption[]>([])
 const addressLoading = ref(false)
 // Conserve les suggestions d'adresse pour retrouver ville/CP au moment du select.
 let lastAddressSuggestions: AddressSuggestion[] = []
 /** Emet un nouveau brouillon avec le champ modifie (immutabilite). */
 function update<K extends keyof AddressFormDraft>(field: K, value: AddressFormDraft[K]): void {
    emit('update:modelValue', { ...props.modelValue, [field]: value })
 }
 /** Coche/decoche un site Starseed rattache a l'adresse (M2M par IRI, RG-1.10). */
 function toggleSite(siteIri: string, selected: boolean): void {
    const current = props.modelValue.siteIris
    const next = selected
        ? [...current, siteIri]
        : current.filter(iri => iri !== siteIri)
    update('siteIris', next)
 }
 /** Applique l'exclusivite Prospect / (Livraison|Facturation) au changement. */
 function toggleFlag(field: keyof AddressFlagsDraft, value: boolean): void {
    const flags = applyProspectExclusivity(
        { isProspect: model.value.isProspect, isDelivery: model.value.isDelivery, isBilling: model.value.isBilling },
        field,
        value,
    )
    emit('update:modelValue', { ...props.modelValue, ...flags })
 }
 /** Bascule définitivement en mode degrade et previent le parent (toast unique). */
 function enterDegraded(): void {
    if (!degraded.value) {
        degraded.value = true
        emit('degraded')
    }
 }
 /** Saisie du code postal → met a jour le champ + interroge la BAN pour la ville. */
 async function onPostalCodeChange(value: string): Promise<void> {
    update('postalCode', value)
    if (degraded.value) {
        return
    }
    const digits = (value ?? '').replace(/\D/g, '')
    if (digits.length < 5) {
        return
    }
    try {
        const suggestions = await autocomplete.searchCity(digits)
        cityOptions.value = suggestions.map(s => ({ value: s.city, label: s.city }))
    }
    catch {
        enterDegraded()
    }
 }
 /** Recherche d'adresse assistee (event de MalioInputAutocomplete). */
 async function onAddressSearch(query: string): Promise<void> {
    if (degraded.value) {
        return
    }
    addressLoading.value = true
    try {
        const postalCode = (model.value.postalCode ?? '').replace(/\D/g, '') || undefined
        const suggestions = await autocomplete.searchAddress(query, postalCode)
        lastAddressSuggestions = suggestions
        addressOptions.value = suggestions.map(s => ({ value: s.street, label: s.label }))
    }
    catch {
        enterDegraded()
    }
    finally {
        addressLoading.value = false
    }
 }
 /**
 * Selection d'une suggestion d'adresse → remplit rue + ville + CP.
 * Le type d'option suit le contrat MalioInputAutocomplete ({ label, value }).
 */
 function onAddressSelect(option: { label: string, value: string | number } | null): void {
    if (option === null) {
        return
    }
    const suggestion = lastAddressSuggestions.find(s => s.street === option.value)
    if (!suggestion) {
        update('street', String(option.value))
        return
    }
    emit('update:modelValue', {
        ...props.modelValue,
        street: suggestion.street,
        city: suggestion.city,
        postalCode: suggestion.postalCode,
    })
 }
 </script>
@@ -1,97 +0,0 @@
 <template>
    <div class="relative grid grid-cols-4 gap-x-[44px] gap-y-4 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
        <!-- Suppression : ouvre une modal de confirmation cote parent. Masquee si
             non supprimable (1er bloc obligatoire RG-1.14) ou en lecture seule.
             ariaLabel via v-bind objet (prop camelCase ; aria-* serait un attribut HTML). -->
        <MalioButtonIcon
            v-if="removable && !readonly"
            icon="mdi:delete-outline"
            variant="ghost"
            button-class="absolute top-3 right-3"
            v-bind="{ ariaLabel: t('commercial.clients.form.contact.remove') }"
            @click="$emit('remove')"
        />
        <MalioInputText
            :model-value="model.lastName"
            :label="t('commercial.clients.form.contact.lastName')"
            :readonly="readonly"
            @update:model-value="(v: string) => update('lastName', v)"
        />
        <MalioInputText
            :model-value="model.firstName"
            :label="t('commercial.clients.form.contact.firstName')"
            :readonly="readonly"
            @update:model-value="(v: string) => update('firstName', v)"
        />
        <MalioInputText
            :model-value="model.jobTitle"
            :label="t('commercial.clients.form.contact.jobTitle')"
            :readonly="readonly"
            @update:model-value="(v: string) => update('jobTitle', v)"
        />
        <MalioInputEmail
            :model-value="model.email"
            :label="t('commercial.clients.form.contact.email')"
            :readonly="readonly"
            @update:model-value="(v: string) => update('email', v)"
        />
        <MalioInputPhone
            :model-value="model.phonePrimary"
            :label="t('commercial.clients.form.contact.phonePrimary')"
            :mask="PHONE_MASK"
            :readonly="readonly"
            :addable="!model.hasSecondaryPhone && !readonly"
            :add-button-label="t('commercial.clients.form.contact.addPhone')"
            @update:model-value="(v: string) => update('phonePrimary', v)"
            @add="revealSecondaryPhone"
        />
        <MalioInputPhone
            v-if="model.hasSecondaryPhone"
            :model-value="model.phoneSecondary"
            :label="t('commercial.clients.form.contact.phoneSecondary')"
            :mask="PHONE_MASK"
            :readonly="readonly"
            @update:model-value="(v: string) => update('phoneSecondary', v)"
        />
    </div>
 </template>
 <script setup lang="ts">
 import type { ContactFormDraft } from '~/modules/commercial/types/clientForm'
 // Masque telephone FR : 5 groupes de 2 chiffres (la normalisation finale reste
 // serveur, cf. formatPhoneFR re-applique a la valeur renvoyee).
 const PHONE_MASK = '## ## ## ## ##'
 const props = defineProps<{
    /** Brouillon du contact (v-model). */
    modelValue: ContactFormDraft
    /** Titre du bloc (ex: « Contact 1 »). */
    title: string
    /** Affiche l'icone de suppression (1er bloc non supprimable, RG-1.14). */
    removable?: boolean
    /** Bloc en lecture seule (onglet valide). */
    readonly?: boolean
 }>()
 const emit = defineEmits<{
    'update:modelValue': [value: ContactFormDraft]
    'remove': []
 }>()
 const { t } = useI18n()
 // Alias local pour la lisibilite du template.
 const model = computed(() => props.modelValue)
 /** Emet un nouveau brouillon avec le champ modifie (immutabilite). */
 function update<K extends keyof ContactFormDraft>(field: K, value: ContactFormDraft[K]): void {
    emit('update:modelValue', { ...props.modelValue, [field]: value })
 }
 /** Revele le 2e numero (RG-1.02/1.20 : max 1 secondaire, le « + » disparait). */
 function revealSecondaryPhone(): void {
    emit('update:modelValue', { ...props.modelValue, hasSecondaryPhone: true })
 }
 </script>
@@ -1,14 +0,0 @@
 <template>
    <!--
        Placeholder des onglets non encore implementes (Transport, Statistiques,
        Rapports, Echanges). Frame vide blanche : aucun champ, aucun bouton,
        aucun message « En cours » (decision Tristan 28/05). L'orchestrateur passe
        automatiquement a l'onglet suivant — ce composant n'est qu'une coquille
        visuelle reutilisee par 1.11/1.12.
    -->
    <div class="min-h-[240px] rounded-md bg-white" />
 </template>
 <script setup lang="ts">
 // Composant purement presentationnel : aucune prop, aucun event.
 </script>
@@ -1,85 +0,0 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
 import type { HydraCollection } from '~/shared/utils/api'
 import type { Client } from '../useClientsRepository'
 // `useApi` est un auto-import Nuxt : on le stubbe globalement pour intercepter
 // les appels declenches par usePaginatedList (que useClientsRepository enveloppe)
 // et controler les reponses. Meme pattern que useCategoriesAdmin.spec.ts.
 const mockGet = vi.hoisted(() => vi.fn())
 vi.stubGlobal('useApi', () => ({
    get: mockGet,
    post: vi.fn(),
    put: vi.fn(),
    patch: vi.fn(),
    delete: vi.fn(),
 }))
 // Import APRES le stub pour que useApi soit bien resolu au top-level du module.
 const { useClientsRepository } = await import('../useClientsRepository')
 /** Envelope Hydra minimale (la liste reelle des membres importe peu ici). */
 function makeHydra(total: number): HydraCollection<Client> {
    return { totalItems: total, member: [] }
 }
 describe('useClientsRepository', () => {
    beforeEach(() => {
        mockGet.mockReset()
        // 25 items → 3 pages a 10/page : permet de tester la navigation page 2.
        mockGet.mockResolvedValue(makeHydra(25))
    })
    it('cible la ressource /clients en page 1 par defaut', async () => {
        const repo = useClientsRepository()
        await repo.fetch()
        expect(mockGet).toHaveBeenLastCalledWith(
            '/clients',
            { page: 1, itemsPerPage: 10 },
            expect.objectContaining({ toast: false }),
        )
    })
    it('pousse les filtres du drawer (categories multi, sites, archives) et retombe en page 1', async () => {
        const repo = useClientsRepository()
        await repo.fetch()
        await repo.goToPage(2)
        expect(repo.currentPage.value).toBe(2)
        await repo.setFilters(
            {
                search: 'acme',
                'categoryCode[]': ['DISTRIBUTEUR', 'COURTIER'],
                'siteId[]': ['1', '2'],
                archivedOnly: true,
            },
            { replace: true },
        )
        expect(repo.currentPage.value).toBe(1)
        expect(mockGet).toHaveBeenLastCalledWith(
            '/clients',
            {
                search: 'acme',
                'categoryCode[]': ['DISTRIBUTEUR', 'COURTIER'],
                'siteId[]': ['1', '2'],
                archivedOnly: true,
                page: 1,
                itemsPerPage: 10,
            },
            expect.objectContaining({ toast: false }),
        )
    })
    it('repasse a une query propre apres reinitialisation des filtres', async () => {
        const repo = useClientsRepository()
        await repo.setFilters({ search: 'acme', archivedOnly: true }, { replace: true })
        await repo.setFilters({}, { replace: true })
        expect(mockGet).toHaveBeenLastCalledWith(
            '/clients',
            { page: 1, itemsPerPage: 10 },
            expect.objectContaining({ toast: false }),
        )
    })
 })
@@ -1,141 +0,0 @@
 import { ref } from 'vue'
 /**
 * Charge les referentiels (listes courtes) alimentant les selects de l'ecran
 * « Ajouter un client » : categories, sites, modes de TVA, delais et types de
 * reglement, banques, et les listes distributeurs / courtiers.
 *
 * Toutes les collections sont recuperees en entier via l'echappatoire prevue
 * `?pagination=false` (referentiels de quelques dizaines d'entrees max), avec
 * l'en-tete `Accept: application/ld+json` impose par API Platform 4 pour obtenir
 * l'enveloppe Hydra (`member`). Les valeurs d'option sont les IRI Hydra (`@id`)
 * pour pouvoir etre renvoyees telles quelles dans les payloads POST/PATCH
 * (relations ManyToOne / ManyToMany).
 *
 * Etat 100 % local a l'instance (refs) — aucune persistance URL.
 */
 /** Option generique au format attendu par MalioSelect / MalioSelectCheckbox ({ label, value }). */
 export interface RefOption {
    value: string
    label: string
 }
 /** Option de type de reglement enrichie de son code stable (RG-1.12 / RG-1.13). */
 export interface PaymentTypeOption extends RefOption {
    code: string
 }
 /** Option de categorie enrichie de son code stable (filtrage RG-1.29 cote adresse). */
 export interface CategoryOption extends RefOption {
    code: string
 }
 /** Option de client (distributeur / courtier) — value = IRI du client lie. */
 export type ClientOption = RefOption
 interface HydraMember {
    '@id': string
 }
 interface CategoryMember extends HydraMember {
    code: string
    name: string
 }
 interface SiteMember extends HydraMember {
    name: string
 }
 interface ReferentialMember extends HydraMember {
    code: string
    label: string
 }
 interface ClientMember extends HydraMember {
    companyName: string
 }
 const LD_JSON_HEADERS = { Accept: 'application/ld+json' }
 export function useClientReferentials() {
    const api = useApi()
    const categories = ref<CategoryOption[]>([])
    const sites = ref<RefOption[]>([])
    const tvaModes = ref<RefOption[]>([])
    const paymentDelays = ref<RefOption[]>([])
    const paymentTypes = ref<PaymentTypeOption[]>([])
    const banks = ref<RefOption[]>([])
    const distributors = ref<ClientOption[]>([])
    const brokers = ref<ClientOption[]>([])
    /** Recupere une collection complete (pagination desactivee) en Hydra. */
    async function fetchAll<T extends HydraMember>(
        url: string,
        query: Record<string, string | string[]> = {},
    ): Promise<T[]> {
        const res = await api.get<{ member?: T[] }>(
            url,
            { pagination: 'false', ...query },
            { headers: LD_JSON_HEADERS, toast: false },
        )
        return res.member ?? []
    }
    /**
     * Charge en parallele les referentiels communs (hors distributeurs/courtiers,
     * charges a la demande selon la relation choisie). Les selects compta ne sont
     * pertinents que si l'utilisateur a acces a l'onglet, mais le cout est
     * negligeable et simplifie l'orchestration.
     */
    async function loadCommon(): Promise<void> {
        const [cats, sitesList, tva, delays, types, banksList] = await Promise.all([
            fetchAll<CategoryMember>('/categories'),
            fetchAll<SiteMember>('/sites'),
            fetchAll<ReferentialMember>('/tva_modes'),
            fetchAll<ReferentialMember>('/payment_delays'),
            fetchAll<ReferentialMember>('/payment_types'),
            fetchAll<ReferentialMember>('/banks'),
        ])
        categories.value = cats.map(c => ({ value: c['@id'], label: c.name, code: c.code }))
        sites.value = sitesList.map(s => ({ value: s['@id'], label: s.name }))
        tvaModes.value = tva.map(t => ({ value: t['@id'], label: t.label }))
        paymentDelays.value = delays.map(d => ({ value: d['@id'], label: d.label }))
        paymentTypes.value = types.map(t => ({ value: t['@id'], label: t.label, code: t.code }))
        banks.value = banksList.map(b => ({ value: b['@id'], label: b.label }))
    }
    /** Liste des clients pouvant etre choisis comme distributeur (code DISTRIBUTEUR). */
    async function loadDistributors(): Promise<void> {
        if (distributors.value.length > 0) {
            return
        }
        const clients = await fetchAll<ClientMember>('/clients', { categoryCode: 'DISTRIBUTEUR' })
        distributors.value = clients.map(c => ({ value: c['@id'], label: c.companyName }))
    }
    /** Liste des clients pouvant etre choisis comme courtier (code COURTIER). */
    async function loadBrokers(): Promise<void> {
        if (brokers.value.length > 0) {
            return
        }
        const clients = await fetchAll<ClientMember>('/clients', { categoryCode: 'COURTIER' })
        brokers.value = clients.map(c => ({ value: c['@id'], label: c.companyName }))
    }
    return {
        categories,
        sites,
        tvaModes,
        paymentDelays,
        paymentTypes,
        banks,
        distributors,
        brokers,
        loadCommon,
        loadDistributors,
        loadBrokers,
    }
 }
@@ -1,53 +0,0 @@
 import { usePaginatedList } from '~/shared/composables/usePaginatedList'
 /**
 * Site Starseed rattache a une adresse du client, tel qu'embarque en LISTE
 * (groupe site:read) pour la colonne « Site(s) » du Repertoire (badges colores).
 */
 export interface ClientSite {
    id: number
    name: string
    color: string
 }
 /**
 * Categorie rattachee au client, embarquee en LISTE (groupe category:read).
 * Seul le `code` (stable, MAJUSCULE — ERP-78) est affiche dans la colonne
 * « Catégories ». Les autres champs sont presents mais non utilises ici.
 */
 export interface ClientCategory {
    code: string
    name?: string
 }
 /**
 * Vue MINIMALE d'un client pour le Repertoire (datatable). Volontairement
 * partielle : seuls les champs des colonnes + l'id (navigation) sont types ici.
 * Le detail complet (onglets) est hors perimetre de cet ecran (ERP-62).
 */
 export interface Client {
    id: number
    companyName: string
    categories: ClientCategory[]
    sites: ClientSite[]
    /** Date ISO de derniere modification (default:read) — colonne « Dernière activité ». */
    updatedAt: string | null
    isArchived: boolean
 }
 /**
 * Repertoire clients (ERP-62) — simple enveloppe de `usePaginatedList<Client>`
 * sur la ressource `/clients` (RG-13 : pagination serveur obligatoire ; jamais
 * de chargement integral en memoire).
 *
 * Les filtres (recherche, categories, sites, archives) sont pilotes par la page
 * via `setFilters` du composable partage — la remise en page 1 est garantie.
 *
 * Volontairement PAR INSTANCE (pas de singleton module-level) : l'etat tableau
 * est propre a l'ecran Repertoire et meurt avec lui, comme tout consommateur de
 * `usePaginatedList` (cf. sites.vue / categories.vue). Aucun reset au logout a
 * gerer.
 */
 export function useClientsRepository() {
    return usePaginatedList<Client>({ url: '/clients' })
 }
@@ -1,421 +0,0 @@
 <template>
    <div>
        <PageHeader>
            {{ t('commercial.clients.title') }}
            <template #actions>
                <!-- gap-12 = 48px d'espacement entre Ajouter et Filtres. -->
                <div class="flex items-center gap-12">
                    <MalioButton
                        v-if="canManage"
                        variant="secondary"
                        :label="t('commercial.clients.add')"
                        icon-name="mdi:add-bold"
                        icon-position="left"
                        @click="goToCreate"
                    />
                    <!-- Bouton Filtres a DROITE d'Ajouter : meme design que
                         l'audit-log. Le compteur reflete les filtres actifs. -->
                    <MalioButton
                        v-if="canView"
                        variant="tertiary"
                        :label="filterButtonLabel"
                        icon-name="mdi:tune"
                        icon-position="left"
                        icon-size="24"
                        button-class="w-[184px] justify-start gap-4 text-black"
                        @click="openFilters"
                    />
                </div>
            </template>
        </PageHeader>
        <!-- Datatable branchee sur usePaginatedList via useClientsRepository :
             pagination serveur, tri companyName ASC par defaut (cote back). -->
        <MalioDataTable
            :columns="columns"
            :items="rows"
            :total-items="totalItems"
            :page="currentPage"
            :per-page="itemsPerPage"
            :per-page-options="itemsPerPageOptions"
            row-clickable
            table-class="table-fixed"
            :empty-message="t('commercial.clients.empty')"
            @row-click="onRowClick"
            @update:page="goToPage"
            @update:per-page="setItemsPerPage"
        >
            <!-- Categories : codes stables separes par une virgule (ERP-78). -->
            <template #cell-categories="{ item }">
                {{ formatCategories(item) }}
            </template>
            <!-- Sites : badges colores (name + color), agreges des adresses. -->
            <template #cell-sites="{ item }">
                <span class="flex flex-wrap gap-1">
                    <span
                        v-for="site in (item.sites as ClientSite[])"
                        :key="site.id"
                        class="inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium text-white"
                        :style="{ backgroundColor: site.color }"
                    >
                        {{ site.name }}
                    </span>
                </span>
            </template>
            <!-- Derniere activite : date de derniere modification (updatedAt). -->
            <template #cell-lastActivity="{ item }">
                {{ formatLastActivity(item) }}
            </template>
        </MalioDataTable>
        <div class="flex justify-center mt-6">
            <MalioButton
                v-if="canView"
                variant="primary"
                :label="t('commercial.clients.export')"
                :disabled="exporting"
                @click="exportXlsx"
            />
        </div>
        <!-- Drawer de filtres : etat BROUILLON, applique uniquement au clic sur
             « Appliquer ». Meme pattern que l'audit-log. Etat 100 % local, jamais
             dans l'URL (regle ABSOLUE n°6). -->
        <MalioDrawer
            v-model="filterDrawerOpen"
            drawer-class="max-w-[450px]"
            body-class="p-0"
            footer-class="justify-between border-t border-black p-6"
        >
            <template #header>
                <h2 class="text-[24px] font-bold uppercase">{{ t('commercial.clients.filters.title') }}</h2>
            </template>
            <MalioAccordion>
                <!-- Recherche : nom societe + contact + email (param `search`). -->
                <MalioAccordionItem :title="t('commercial.clients.filters.search')" value="search">
                    <MalioInputText
                        v-model="draftSearch"
                        icon-name="mdi:magnify"
                    />
                </MalioAccordionItem>
                <!-- Categories : cases a cocher (multi). Valeur = code stable. -->
                <MalioAccordionItem :title="t('commercial.clients.filters.categories')" value="categories">
                    <div class="flex flex-col">
                        <MalioCheckbox
                            v-for="opt in categoryOptions"
                            :id="`filter-category-${opt.value}`"
                            :key="opt.value"
                            :label="opt.label"
                            :model-value="draftCategoryCodes.includes(opt.value)"
                            @update:model-value="(val: boolean) => toggleCategory(opt.value, val)"
                        />
                    </div>
                </MalioAccordionItem>
                <!-- Sites : cases a cocher (multi). Valeur = id du site. -->
                <MalioAccordionItem :title="t('commercial.clients.filters.sites')" value="sites">
                    <div class="flex flex-col">
                        <MalioCheckbox
                            v-for="opt in siteOptions"
                            :id="`filter-site-${opt.value}`"
                            :key="opt.value"
                            :label="opt.label"
                            :model-value="draftSiteIds.includes(opt.value)"
                            @update:model-value="(val: boolean) => toggleSite(opt.value, val)"
                        />
                    </div>
                </MalioAccordionItem>
                <!-- Statut : bool unique. Coche = archives uniquement, sinon actifs. -->
                <MalioAccordionItem :title="t('commercial.clients.filters.status')" value="status">
                    <MalioCheckbox
                        id="filter-archived-only"
                        :label="t('commercial.clients.filters.archivedOnly')"
                        :model-value="draftArchivedOnly"
                        @update:model-value="(val: boolean) => draftArchivedOnly = val"
                    />
                </MalioAccordionItem>
            </MalioAccordion>
            <template #footer>
                <MalioButton
                    variant="tertiary"
                    :label="t('commercial.clients.filters.reset')"
                    button-class="w-m-btn-action"
                    @click="resetFilters"
                />
                <MalioButton
                    variant="primary"
                    :label="t('commercial.clients.filters.apply')"
                    button-class="w-[170px]"
                    @click="applyFilters"
                />
            </template>
        </MalioDrawer>
    </div>
 </template>
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue'
 import type { Client, ClientSite } from '~/modules/commercial/composables/useClientsRepository'
 interface FilterOption {
    value: string
    label: string
 }
 const { t } = useI18n()
 const api = useApi()
 const router = useRouter()
 const toast = useToast()
 const { can } = usePermissions()
 useHead({ title: t('commercial.clients.title') })
 // Bouton « Ajouter » reserve a `manage` (POST /clients garde manage seul →
 // Compta / Usine ne creent pas). « Exporter » et « Filtres » suivent `view`.
 const canManage = computed(() => can('commercial.clients.manage'))
 const canView = computed(() => can('commercial.clients.view'))
 const {
    items: clients,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: loadClients,
    goToPage,
    setItemsPerPage,
    setFilters,
 } = useClientsRepository()
 // Mappe les clients en objets « plats » pour MalioDataTable (items typees
 // Record<string, unknown>[]) : un objet litteral porte une signature d'index
 // implicite, contrairement a l'interface Client. Meme pattern que sites.vue.
 const rows = computed(() => clients.value.map(client => ({
    id: client.id,
    companyName: client.companyName,
    categories: client.categories,
    sites: client.sites,
    updatedAt: client.updatedAt,
 })))
 const columns = [
    { key: 'companyName', label: t('commercial.clients.column.companyName') },
    { key: 'categories', label: t('commercial.clients.column.categories') },
    { key: 'sites', label: t('commercial.clients.column.sites') },
    { key: 'lastActivity', label: t('commercial.clients.column.lastActivity') },
 ]
 /** Codes des categories du client, separes par une virgule (ERP-78). */
 function formatCategories(item: Record<string, unknown>): string {
    const categories = (item.categories as Client['categories']) ?? []
    return categories.map(c => c.code).join(', ')
 }
 /**
 * Derniere activite : faute de suivi d'activite metier au M1, on affiche la
 * date de derniere modification de la fiche (updatedAt, expose en liste via
 * default:read). Format court francais jj/mm/aaaa.
 */
 function formatLastActivity(item: Record<string, unknown>): string {
    const value = item.updatedAt as string | null | undefined
    if (!value) {
        return ''
    }
    // Garde-fou date invalide : un updatedAt mal forme donnerait « Invalid Date ».
    const date = new Date(value)
    if (Number.isNaN(date.getTime())) {
        return ''
    }
    return date.toLocaleDateString('fr-FR')
 }
 /** Clic sur une ligne → ecran Consultation (route a plat /clients/{id}). */
 function onRowClick(item: Record<string, unknown>): void {
    router.push(`/clients/${item.id}`)
 }
 function goToCreate(): void {
    router.push('/clients/new')
 }
 // ── Filtres (drawer) ────────────────────────────────────────────────────────
 // Deux niveaux d'etat (pattern audit-log) :
 //  - APPLIED : pilote la liste/l'export + le compteur du bouton. Modifie
 //    uniquement au clic « Appliquer » / « Réinitialiser ».
 //  - DRAFT : edite librement dans le drawer ; recopie vers applied a la validation.
 const filterDrawerOpen = ref(false)
 const draftSearch = ref('')
 const draftCategoryCodes = ref<string[]>([])
 const draftSiteIds = ref<string[]>([])
 const draftArchivedOnly = ref(false)
 const appliedSearch = ref('')
 const appliedCategoryCodes = ref<string[]>([])
 const appliedSiteIds = ref<string[]>([])
 const appliedArchivedOnly = ref(false)
 // Options des selects multi, chargees une fois (referentiels courts).
 const categoryOptions = ref<FilterOption[]>([])
 const siteOptions = ref<FilterOption[]>([])
 const activeFilterCount = computed(() => {
    let count = 0
    if (appliedSearch.value.trim() !== '') count++
    if (appliedCategoryCodes.value.length > 0) count++
    if (appliedSiteIds.value.length > 0) count++
    if (appliedArchivedOnly.value) count++
    return count
 })
 const filterButtonLabel = computed(() => {
    const base = t('commercial.clients.filters.title')
    return activeFilterCount.value > 0 ? `${base} (${activeFilterCount.value})` : base
 })
 // Recopie l'etat applique vers le brouillon puis ouvre le drawer : la
 // reouverture reflete les filtres actifs.
 function openFilters(): void {
    draftSearch.value = appliedSearch.value
    draftCategoryCodes.value = [...appliedCategoryCodes.value]
    draftSiteIds.value = [...appliedSiteIds.value]
    draftArchivedOnly.value = appliedArchivedOnly.value
    filterDrawerOpen.value = true
 }
 function toggleCategory(code: string, selected: boolean): void {
    draftCategoryCodes.value = selected
        ? [...draftCategoryCodes.value, code]
        : draftCategoryCodes.value.filter(c => c !== code)
 }
 function toggleSite(id: string, selected: boolean): void {
    draftSiteIds.value = selected
        ? [...draftSiteIds.value, id]
        : draftSiteIds.value.filter(s => s !== id)
 }
 /**
 * Construit le payload de filtres serveur a partir de l'etat applique. Cles
 * `categoryCode[]` / `siteId[]` pour que PHP les parse en tableaux (OR cote back).
 * Les filtres vides sont omis pour une query propre.
 */
 function buildFilterPayload(): Record<string, string | string[] | boolean> {
    const payload: Record<string, string | string[] | boolean> = {}
    if (appliedSearch.value.trim() !== '') payload.search = appliedSearch.value.trim()
    if (appliedCategoryCodes.value.length > 0) payload['categoryCode[]'] = [...appliedCategoryCodes.value]
    if (appliedSiteIds.value.length > 0) payload['siteId[]'] = [...appliedSiteIds.value]
    if (appliedArchivedOnly.value) payload.archivedOnly = true
    return payload
 }
 // « Appliquer » : recopie brouillon → applied, pousse les filtres (retombe en
 // page 1 via usePaginatedList) et ferme le drawer.
 function applyFilters(): void {
    appliedSearch.value = draftSearch.value.trim()
    appliedCategoryCodes.value = [...draftCategoryCodes.value]
    appliedSiteIds.value = [...draftSiteIds.value]
    appliedArchivedOnly.value = draftArchivedOnly.value
    setFilters(buildFilterPayload(), { replace: true })
    filterDrawerOpen.value = false
 }
 // « Réinitialiser » : vide brouillon ET applied, recharge la liste complete.
 // Le drawer reste ouvert pour montrer le formulaire vide.
 function resetFilters(): void {
    draftSearch.value = ''
    draftCategoryCodes.value = []
    draftSiteIds.value = []
    draftArchivedOnly.value = false
    appliedSearch.value = ''
    appliedCategoryCodes.value = []
    appliedSiteIds.value = []
    appliedArchivedOnly.value = false
    setFilters({}, { replace: true })
 }
 /** Charge les referentiels du drawer (categories + sites) via ?pagination=false. */
 async function loadFilterOptions(): Promise<void> {
    const [cats, sites] = await Promise.all([
        api.get<{ member?: Array<{ code: string, name: string }> }>(
            '/categories',
            { pagination: 'false' },
            { headers: { Accept: 'application/ld+json' }, toast: false },
        ),
        api.get<{ member?: Array<{ id: number, name: string }> }>(
            '/sites',
            { pagination: 'false' },
            { headers: { Accept: 'application/ld+json' }, toast: false },
        ),
    ])
    categoryOptions.value = (cats.member ?? []).map(c => ({ value: c.code, label: c.name }))
    siteOptions.value = (sites.member ?? []).map(s => ({ value: String(s.id), label: s.name }))
 }
 // ── Export XLSX ─────────────────────────────────────────────────────────────
 // Memes filtres que la vue. La colonne SIREN n'est dans le fichier que si
 // l'utilisateur a accounting.view (gere cote back).
 const exporting = ref(false)
 async function exportXlsx(): Promise<void> {
    if (exporting.value) {
        return
    }
    exporting.value = true
    try {
        // useApi type ses options en JSON ; l'export renvoie un binaire, donc on
        // force responseType:'blob' (transmis tel quel a ofetch au runtime). Cast
        // contenu faute d'overload blob sur le client partage — a generaliser via
        // un ticket dedie si d'autres exports binaires arrivent.
        const blob = await api.get<Blob>('/clients/export.xlsx', buildFilterPayload(), {
            responseType: 'blob',
            toast: false,
        } as unknown as Parameters<typeof api.get>[2])
        triggerDownload(blob, 'repertoire-clients.xlsx')
    }
    catch {
        toast.error({
            title: t('commercial.clients.toast.error'),
            message: t('commercial.clients.toast.exportError'),
        })
    }
    finally {
        exporting.value = false
    }
 }
 /** Declenche le telechargement d'un blob via un lien temporaire. */
 function triggerDownload(blob: Blob, filename: string): void {
    const url = URL.createObjectURL(blob)
    const link = document.createElement('a')
    link.href = url
    link.download = filename
    document.body.appendChild(link)
    link.click()
    link.remove()
    URL.revokeObjectURL(url)
 }
 onMounted(() => {
    loadClients()
    // Echec du chargement des referentiels non bloquant : la liste s'affiche,
    // l'utilisateur perd juste les options de filtre.
    loadFilterOptions().catch(() => {
        categoryOptions.value = []
        siteOptions.value = []
    })
 })
 </script>
@@ -1,960 +0,0 @@
 <template>
    <div>
        <!-- En-tete : retour vers le repertoire + titre. -->
        <div class="flex items-center gap-3">
            <MalioButtonIcon
                icon="mdi:arrow-left-bold"
                icon-size="24"
                variant="ghost"
                v-bind="{ ariaLabel: t('commercial.clients.form.back') }"
                @click="goBack"
            />
            <h1 class="text-[32px] font-bold text-m-primary">{{ t('commercial.clients.form.title') }}</h1>
        </div>
        <!-- ── Formulaire principal (pre-onglets) ─────────────────────────────
             Sans validation de ce bloc, les onglets restent inaccessibles. Au
             succes du POST, les champs passent en lecture seule et on bascule
             automatiquement sur l'onglet Information. -->
        <div class="mt-[48px] grid grid-cols-3 xl:grid-cols-4 gap-x-[44px] gap-y-4">
            <MalioInputText
                v-model="main.companyName"
                :label="t('commercial.clients.form.main.companyName')"
                :required="true"
                :readonly="mainLocked"
            />
            <MalioInputText
                v-model="main.lastName"
                :label="t('commercial.clients.form.main.lastName')"
                :readonly="mainLocked"
            />
            <MalioInputText
                v-model="main.firstName"
                :label="t('commercial.clients.form.main.firstName')"
                :readonly="mainLocked"
            />
            <MalioSelectCheckbox
                :model-value="main.categoryIris"
                :options="referentials.categories.value"
                :label="t('commercial.clients.form.main.categories')"
                :display-tag="true"
                :disabled="mainLocked"
                @update:model-value="(v: (string | number)[]) => main.categoryIris = v.map(String)"
            />
            <!-- Telephones : 1 par defaut, le bouton « + » revele le 2e (max 2, RG-1.02). -->
            <MalioInputPhone
                v-for="(_, index) in mainPhones"
                :key="index"
                v-model="mainPhones[index]"
                :label="t('commercial.clients.form.main.phonePrimary')"
                :mask="PHONE_MASK"
                :required="index === 0"
                :readonly="mainLocked"
                add-icon-name="mdi:plus"
                :addable="mainPhones.length === 1 && !mainLocked"
                :add-button-label="t('commercial.clients.form.main.addPhone')"
                @add="addMainPhone"
            />
            <MalioInputEmail
                v-model="main.email"
                :label="t('commercial.clients.form.main.email')"
                :required="true"
                :readonly="mainLocked"
            />
            <MalioSelect
                :model-value="main.relationType"
                :options="relationOptions"
                :label="t('commercial.clients.form.main.relation')"
                :disabled="mainLocked"
                @update:model-value="onRelationChange"
            />
            <MalioSelect
                v-if="main.relationType === 'courtier'"
                :model-value="main.brokerIri"
                :options="referentials.brokers.value"
                :label="t('commercial.clients.form.main.brokerName')"
                :disabled="mainLocked"
                @update:model-value="(v: string | number | null) => main.brokerIri = v === null ? null : String(v)"
            />
            <MalioSelect
                v-if="main.relationType === 'distributeur'"
                :model-value="main.distributorIri"
                :options="referentials.distributors.value"
                :label="t('commercial.clients.form.main.distributorName')"
                :disabled="mainLocked"
                @update:model-value="(v: string | number | null) => main.distributorIri = v === null ? null : String(v)"
            />
            <MalioCheckbox
                v-model="main.triageService"
                :label="t('commercial.clients.form.main.triageService')"
                group-class="self-center"
                :readonly="mainLocked"
            />
        </div>
        <div v-if="!mainLocked" class="mt-12 flex justify-center">
            <MalioButton
                variant="primary"
                :label="t('commercial.clients.form.submit')"
                :disabled="!isMainValid || mainSubmitting"
                @click="submitMain"
            />
        </div>
        <!-- ── Onglets a validation incrementale ─────────────────────────────-->
        <MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
            <!-- Onglet Information -->
            <template #information>
                <div class="mt-12 grid grid-cols-4 gap-x-[44px] gap-y-4 bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
                    <!-- pt-1 : aligne le bord superieur du textarea sur celui des
                         inputs (centres dans un conteneur h-12, soit ~4px de retrait haut). -->
                    <MalioInputTextArea
                        v-model="information.description"
                        :label="t('commercial.clients.form.information.description')"
                        resize="none"
                        group-class="row-span-2 pt-1"
                        text-input="h-full text-lg"
                        :disabled="isValidated('information')"
                    />
                    <MalioInputText
                        v-model="information.competitors"
                        :label="t('commercial.clients.form.information.competitors')"
                        :readonly="isValidated('information')"
                    />
                    <MalioDate
                        v-model="information.foundedAt"
                        :label="t('commercial.clients.form.information.foundedAt')"
                        :readonly="isValidated('information')"
                    />
                    <MalioInputText
                        v-model="information.employeesCount"
                        :label="t('commercial.clients.form.information.employeesCount')"
                        :mask="EMPLOYEES_MASK"
                        :readonly="isValidated('information')"
                    />
                    <MalioInputAmount
                        v-model="information.revenueAmount"
                        :label="t('commercial.clients.form.information.revenueAmount')"
                        :disabled="isValidated('information')"
                    />
                    <MalioInputText
                        v-model="information.directorName"
                        :label="t('commercial.clients.form.information.directorName')"
                        :readonly="isValidated('information')"
                    />
                    <MalioInputAmount
                        v-model="information.profitAmount"
                        :label="t('commercial.clients.form.information.profitAmount')"
                        :disabled="isValidated('information')"
                    />
                </div>
                <div v-if="!isValidated('information')" class="mt-12 flex justify-center">
                    <!-- Desactive tant que le client n'est pas cree : evite un PATCH
                         avant le POST si l'utilisateur clique trop tot (le panneau
                         Information est l'onglet actif par defaut). -->
                    <MalioButton
                        variant="primary"
                        :label="t('commercial.clients.form.submit')"
                        :disabled="tabSubmitting || clientId === null"
                        @click="submitInformation"
                    />
                </div>
            </template>
            <!-- Onglet Contact -->
            <template #contact>
                <div class="mt-12 flex flex-col gap-6">
                    <ClientContactBlock
                        v-for="(contact, index) in contacts"
                        :key="index"
                        :model-value="contact"
                        :title="t('commercial.clients.form.contact.title', { n: index + 1 })"
                        :removable="index > 0"
                        :readonly="isValidated('contact')"
                        @update:model-value="(v) => contacts[index] = v"
                        @remove="askRemoveContact(index)"
                    />
                    <div v-if="!isValidated('contact')" class="flex justify-center gap-6">
                        <MalioButton
                            variant="secondary"
                            icon-name="mdi:add-bold"
                            icon-position="left"
                            :label="t('commercial.clients.form.contact.add')"
                            :disabled="!canAddContact"
                            @click="addContact"
                        />
                        <MalioButton
                            variant="primary"
                            :label="t('commercial.clients.form.submit')"
                            :disabled="!canValidateContacts || tabSubmitting"
                            @click="submitContacts"
                        />
                    </div>
                </div>
            </template>
            <!-- Onglet Adresse -->
            <template #address>
                <div class="mt-12 flex flex-col gap-6">
                    <ClientAddressBlock
                        v-for="(address, index) in addresses"
                        :key="index"
                        :model-value="address"
                        :title="t('commercial.clients.form.address.title', { n: index + 1 })"
                        :category-options="addressCategoryOptions"
                        :site-options="referentials.sites.value"
                        :contact-options="contactOptions"
                        :country-options="countryOptions"
                        :removable="index > 0"
                        :readonly="isValidated('address')"
                        @update:model-value="(v) => addresses[index] = v"
                        @remove="askRemoveAddress(index)"
                        @degraded="onAddressDegraded"
                    />
                    <div v-if="!isValidated('address')" class="flex justify-center gap-6">
                        <MalioButton
                            variant="secondary"
                            icon-name="mdi:add-bold"
                            icon-position="left"
                            :label="t('commercial.clients.form.address.add')"
                            @click="addAddress"
                        />
                        <MalioButton
                            variant="primary"
                            :label="t('commercial.clients.form.submit')"
                            :disabled="!canValidateAddresses || tabSubmitting"
                            @click="submitAddresses"
                        />
                    </div>
                </div>
            </template>
            <!-- Onglet Comptabilite (present uniquement si accounting.view) -->
            <template v-if="canAccountingView" #accounting>
                <div class="mt-12 flex flex-col gap-6">
                    <div class="bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]">
                        <div class="grid grid-cols-3 gap-x-[80px] gap-y-5">
                            <MalioInputText
                                v-model="accounting.siren"
                                :label="t('commercial.clients.form.accounting.siren')"
                                :mask="SIREN_MASK"
                                :readonly="accountingReadonly"
                            />
                            <MalioInputText
                                v-model="accounting.accountNumber"
                                :label="t('commercial.clients.form.accounting.accountNumber')"
                                :readonly="accountingReadonly"
                            />
                            <MalioSelect
                                :model-value="accounting.tvaModeIri"
                                :options="referentials.tvaModes.value"
                                :label="t('commercial.clients.form.accounting.tvaMode')"
                                :disabled="accountingReadonly"
                                empty-option-label=""
                                @update:model-value="(v: string | number | null) => accounting.tvaModeIri = v === null ? null : String(v)"
                            />
                            <MalioInputText
                                v-model="accounting.nTva"
                                :label="t('commercial.clients.form.accounting.nTva')"
                                :readonly="accountingReadonly"
                            />
                            <MalioSelect
                                :model-value="accounting.paymentDelayIri"
                                :options="referentials.paymentDelays.value"
                                :label="t('commercial.clients.form.accounting.paymentDelay')"
                                :disabled="accountingReadonly"
                                empty-option-label=""
                                @update:model-value="(v: string | number | null) => accounting.paymentDelayIri = v === null ? null : String(v)"
                            />
                            <MalioSelect
                                :model-value="accounting.paymentTypeIri"
                                :options="referentials.paymentTypes.value"
                                :label="t('commercial.clients.form.accounting.paymentType')"
                                :disabled="accountingReadonly"
                                empty-option-label=""
                                @update:model-value="onPaymentTypeChange"
                            />
                            <MalioSelect
                                v-if="isBankRequired"
                                :model-value="accounting.bankIri"
                                :options="referentials.banks.value"
                                :label="t('commercial.clients.form.accounting.bank')"
                                :disabled="accountingReadonly"
                                empty-option-label=""
                                @update:model-value="(v: string | number | null) => accounting.bankIri = v === null ? null : String(v)"
                            />
                        </div>
                    </div>
                    <!-- Blocs RIB (0..n) — obligatoires si type de reglement = LCR. -->
                    <div
                        v-for="(rib, index) in ribs"
                        :key="index"
                        class="relative bg-white py-4 pl-[28px] pr-[60px] shadow-[0_4px_4px_0_rgba(0,0,0,0.25)]"
                    >
                        <!-- ariaLabel via v-bind objet (prop camelCase ; aria-* serait un attribut HTML). -->
                        <MalioButtonIcon
                            v-if="!accountingReadonly"
                            icon="mdi:delete-outline"
                            variant="ghost"
                            button-class="absolute top-3 right-3"
                            v-bind="{ ariaLabel: t('commercial.clients.form.accounting.removeRib') }"
                            @click="askRemoveRib(index)"
                        />
                        <div class="grid grid-cols-3 gap-x-[80px] gap-y-5">
                            <MalioInputText
                                v-model="rib.label"
                                :label="t('commercial.clients.form.accounting.ribLabel')"
                                :readonly="accountingReadonly"
                            />
                            <MalioInputText
                                v-model="rib.bic"
                                :label="t('commercial.clients.form.accounting.ribBic')"
                                :readonly="accountingReadonly"
                            />
                            <MalioInputText
                                v-model="rib.iban"
                                :label="t('commercial.clients.form.accounting.ribIban')"
                                :readonly="accountingReadonly"
                            />
                        </div>
                    </div>
                    <div v-if="!accountingReadonly" class="flex justify-center gap-6">
                        <MalioButton
                            variant="secondary"
                            icon-name="mdi:add-bold"
                            icon-position="left"
                            :label="t('commercial.clients.form.accounting.addRib')"
                            @click="addRib"
                        />
                        <MalioButton
                            variant="primary"
                            :label="t('commercial.clients.form.submit')"
                            :disabled="!canValidateAccounting || tabSubmitting"
                            @click="submitAccounting"
                        />
                    </div>
                </div>
            </template>
            <!-- Onglet non encore implemente : frame vide, passage automatique.
                 Statistiques / Rapports / Echanges sont edit-only (absents a la
                 creation) — cf. buildClientFormTabKeys. -->
            <template #transport><TabPlaceholderBlank /></template>
        </MalioTabList>
        <!-- Modal de confirmation generique (suppression contact/adresse/RIB). -->
        <MalioModal v-model="confirmModal.open" modal-class="max-w-md">
            <template #header>
                <h2 class="text-[24px] font-bold">{{ t('commercial.clients.form.confirmDelete.title') }}</h2>
            </template>
            <p>{{ confirmModal.message }}</p>
            <template #footer>
                <MalioButton
                    variant="secondary"
                    button-class="flex-1"
                    :label="t('commercial.clients.form.confirmDelete.cancel')"
                    @click="confirmModal.open = false"
                />
                <MalioButton
                    variant="danger"
                    button-class="flex-1"
                    :label="t('commercial.clients.form.confirmDelete.confirm')"
                    @click="runConfirm"
                />
            </template>
        </MalioModal>
    </div>
 </template>
 <script setup lang="ts">
 import { computed, onMounted, reactive, ref, watch } from 'vue'
 import { useClientReferentials, type RefOption } from '~/modules/commercial/composables/useClientReferentials'
 import {
    buildClientFormTabKeys,
    CLIENT_FORM_PLACEHOLDER_TABS,
    hasAtLeastOneValidContact,
    isBankRequiredForPaymentType,
    isBillingEmailRequired,
    isContactNamed,
    isRibRequiredForPaymentType,
 } from '~/modules/commercial/utils/clientFormRules'
 import {
    emptyAddress,
    emptyContact,
    emptyRib,
    type AddressFormDraft,
    type ContactFormDraft,
    type RibFormDraft,
 } from '~/modules/commercial/types/clientForm'
 import { formatPhoneFR } from '~/shared/utils/phone'
 import { extractApiErrorMessage } from '~/shared/utils/api'
 // Masques de saisie (la normalisation finale reste serveur).
 const PHONE_MASK = '## ## ## ## ##'
 const SIREN_MASK = '#########'
 // Masque « nombre » du champ Nombre de salaries : chiffres uniquement (max 7).
 const EMPLOYEES_MASK = '#######'
 // Codes de categorie interdits sur une adresse (RG-1.29, ERP-78).
 const FORBIDDEN_ADDRESS_CATEGORY_CODES = ['DISTRIBUTEUR', 'COURTIER']
 const { t } = useI18n()
 const api = useApi()
 const toast = useToast()
 const router = useRouter()
 const { can } = usePermissions()
 /** Retour vers le repertoire clients (fleche d'en-tete). */
 function goBack(): void {
    router.push('/clients')
 }
 /**
 * Message d'erreur a afficher dans un toast a partir d'une erreur d'API.
 * Retourne TOUJOURS une chaine (le composant de toast plante sur `undefined`) :
 * le message de validation renvoye par le serveur (violations 422 / detail),
 * sinon un libelle generique.
 */
 function apiErrorMessage(error: unknown): string {
    const data = (error as { data?: unknown })?.data
    return extractApiErrorMessage(data) || t('commercial.clients.toast.error')
 }
 useHead({ title: t('commercial.clients.form.title') })
 // Gating de la route : la creation est reservee a `manage`. Compta (accounting
 // seul) et Usine sont rediriges vers le repertoire (cf. §0 du ticket).
 if (!can('commercial.clients.manage')) {
    await navigateTo('/clients')
 }
 const canAccountingView = computed(() => can('commercial.clients.accounting.view'))
 const canAccountingManage = computed(() => can('commercial.clients.accounting.manage'))
 const referentials = useClientReferentials()
 // ── Etat du client cree ────────────────────────────────────────────────────
 const clientId = ref<number | null>(null)
 const mainLocked = ref(false)
 const mainSubmitting = ref(false)
 const tabSubmitting = ref(false)
 // ── Formulaire principal ────────────────────────────────────────────────────
 const main = reactive({
    companyName: null as string | null,
    firstName: null as string | null,
    lastName: null as string | null,
    email: null as string | null,
    categoryIris: [] as string[],
    relationType: null as 'distributeur' | 'courtier' | null,
    distributorIri: null as string | null,
    brokerIri: null as string | null,
    triageService: false,
 })
 // Telephones du formulaire principal : 1 par defaut, 2 au maximum (RG-1.02).
 // L'index 0 alimente phonePrimary, l'index 1 phoneSecondary au POST.
 const mainPhones = ref<string[]>([''])
 /** Revele le 2e numero (le bouton « + » disparait une fois a 2, RG-1.02). */
 function addMainPhone(): void {
    if (mainPhones.value.length === 1) {
        mainPhones.value.push('')
    }
 }
 // Pas d'option « Aucun » : le select est vide par defaut (relationType = null).
 const relationOptions = computed<RefOption[]>(() => [
    { value: 'distributeur', label: t('commercial.clients.form.main.relationDistributor') },
    { value: 'courtier', label: t('commercial.clients.form.main.relationBroker') },
 ])
 // Validation du formulaire principal (gate le bouton « Valider ») :
 //  - companyName / email / telephone principal / >= 1 categorie obligatoires ;
 //  - RG-1.01 : nom OU prenom du contact principal ;
 //  - relation Distributeur/Courtier obligatoire (un des deux), ET le nom
 //    correspondant obligatoire selon le choix (spec fonctionnelle).
 const isMainValid = computed(() => {
    const filled = (v: string | null | undefined) => v !== null && v !== undefined && v.trim() !== ''
    // Relation Distributeur/Courtier OPTIONNELLE ; mais si « Depend du
    // distributeur/courtier » est choisi, le nom correspondant devient requis.
    const relationValid
        = main.relationType === null
        || (main.relationType === 'distributeur' && filled(main.distributorIri))
        || (main.relationType === 'courtier' && filled(main.brokerIri))
    return filled(main.companyName)
        && filled(main.email)
        && filled(mainPhones.value[0])
        && (filled(main.firstName) || filled(main.lastName))
        && main.categoryIris.length >= 1
        && relationValid
 })
 async function onRelationChange(value: string | number | null): Promise<void> {
    const relation = (value === null || value === '')
        ? null
        : (String(value) as 'distributeur' | 'courtier')
    main.relationType = relation
    // Reinitialise la FK non concernee (une seule remplie a la fois, RG-1.03).
    if (relation !== 'distributeur') main.distributorIri = null
    if (relation !== 'courtier') main.brokerIri = null
    if (relation === 'distributeur') await referentials.loadDistributors()
    if (relation === 'courtier') await referentials.loadBrokers()
 }
 /** POST /clients (groupe client:write:main). Au succes : verrouille + bascule Information. */
 async function submitMain(): Promise<void> {
    if (!isMainValid.value || mainSubmitting.value) return
    mainSubmitting.value = true
    try {
        const payload: Record<string, unknown> = {
            companyName: main.companyName,
            firstName: main.firstName || null,
            lastName: main.lastName || null,
            email: main.email,
            phonePrimary: mainPhones.value[0] || null,
            phoneSecondary: mainPhones.value[1] || null,
            categories: main.categoryIris,
            distributor: main.relationType === 'distributeur' ? main.distributorIri : null,
            broker: main.relationType === 'courtier' ? main.brokerIri : null,
            triageService: main.triageService,
        }
        const created = await api.post<ClientResponse>('/clients', payload, {
            headers: { Accept: 'application/ld+json' },
            toast: false,
        })
        clientId.value = created.id
        // Reaffiche les valeurs normalisees renvoyees par le serveur.
        main.companyName = created.companyName ?? main.companyName
        main.firstName = created.firstName ?? null
        main.lastName = created.lastName ?? null
        main.email = created.email ?? main.email
        // Reaffiche les telephones normalises (reformates via formatPhoneFR).
        const normalizedPhones = [formatPhoneFR(created.phonePrimary), formatPhoneFR(created.phoneSecondary)]
            .filter(p => p !== '')
        mainPhones.value = normalizedPhones.length > 0 ? normalizedPhones : ['']
        // Pre-remplit le 1er contact a partir du formulaire principal (editable).
        prefillFirstContact()
        mainLocked.value = true
        unlockedIndex.value = 0
        activeTab.value = 'information'
        toast.success({ title: t('commercial.clients.toast.createSuccess') })
    }
    catch (error) {
        // 409 = doublon nom de societe (RG d'unicite) → message explicite ;
        // sinon on remonte le message de validation du serveur (ex: 422).
        const status = (error as { response?: { status?: number } })?.response?.status
        toast.error({
            title: t('commercial.clients.toast.error'),
            message: status === 409
                ? t('commercial.clients.form.duplicateCompany')
                : apiErrorMessage(error),
        })
    }
    finally {
        mainSubmitting.value = false
    }
 }
 // ── Onglets : ordre + gating progressif ─────────────────────────────────────
 const activeTab = ref('information')
 // Index du dernier onglet deverrouille (-1 tant que le client n'est pas cree).
 const unlockedIndex = ref(-1)
 // Onglets valides (passent en lecture seule).
 const validated = reactive<Record<string, boolean>>({})
 const tabKeys = computed(() => buildClientFormTabKeys(canAccountingView.value))
 // Icone (Iconify) affichee dans l'onglet, par cle. A ajuster librement.
 const TAB_ICONS: Record<string, string> = {
    information: 'mdi:account-outline',
    contact: 'mdi:account-box-plus-outline',
    address: 'mdi:map-marker-outline',
    transport: 'mdi:truck-delivery-outline',
    accounting: 'mdi:bank-circle-outline',
    statistics: 'mdi:finance',
    reports: 'mdi:file-document-edit-outline',
    exchanges: 'mdi:account-group-outline',
 }
 const tabs = computed(() => tabKeys.value.map((key, index) => ({
    key,
    label: t(`commercial.clients.tab.${key}`),
    icon: TAB_ICONS[key],
    disabled: index > unlockedIndex.value,
 })))
 function isValidated(key: string): boolean {
    return validated[key] === true
 }
 function tabIndex(key: string): number {
    return tabKeys.value.indexOf(key)
 }
 /** Marque l'onglet valide, deverrouille et avance automatiquement au suivant. */
 function completeTab(key: string): void {
    validated[key] = true
    const next = tabKeys.value[tabIndex(key) + 1]
    unlockedIndex.value = Math.max(unlockedIndex.value, tabIndex(key) + 1)
    if (next) activeTab.value = next
 }
 // Passage automatique sur les onglets coquille (Transport, Stats, Rapports, Echanges).
 watch(activeTab, (key) => {
    if ((CLIENT_FORM_PLACEHOLDER_TABS as readonly string[]).includes(key)) {
        const next = tabKeys.value[tabIndex(key) + 1]
        unlockedIndex.value = Math.max(unlockedIndex.value, tabIndex(key) + 1)
        if (next) activeTab.value = next
    }
 })
 // ── Onglet Information ──────────────────────────────────────────────────────
 const information = reactive({
    description: null as string | null,
    competitors: null as string | null,
    foundedAt: null as string | null,
    employeesCount: null as string | null,
    revenueAmount: null as string | null,
    profitAmount: null as string | null,
    directorName: null as string | null,
 })
 /** PATCH /clients/{id} — mode strict : uniquement les champs du groupe information. */
 async function submitInformation(): Promise<void> {
    if (clientId.value === null || tabSubmitting.value) return
    tabSubmitting.value = true
    try {
        await api.patch(`/clients/${clientId.value}`, {
            description: information.description || null,
            competitors: information.competitors || null,
            foundedAt: information.foundedAt || null,
            employeesCount: information.employeesCount ? Number(information.employeesCount) : null,
            revenueAmount: information.revenueAmount || null,
            profitAmount: information.profitAmount || null,
            directorName: information.directorName || null,
        }, { toast: false })
        completeTab('information')
        toast.success({ title: t('commercial.clients.toast.updateSuccess') })
    }
    catch (error) {
        toast.error({ title: t('commercial.clients.toast.error'), message: apiErrorMessage(error) })
    }
    finally {
        tabSubmitting.value = false
    }
 }
 // ── Onglet Contact ──────────────────────────────────────────────────────────
 const contacts = ref<ContactFormDraft[]>([emptyContact()])
 /** Pre-remplit le 1er contact depuis le formulaire principal (apres creation). */
 function prefillFirstContact(): void {
    const first = contacts.value[0]
    if (!first) return
    first.lastName = main.lastName
    first.firstName = main.firstName
    first.email = main.email
    first.phonePrimary = mainPhones.value[0] ?? null
 }
 // « + Nouveau contact » desactive tant que le dernier bloc n'a ni nom ni prenom.
 const canAddContact = computed(() => {
    const last = contacts.value[contacts.value.length - 1]
    return last !== undefined && isContactNamed(last)
 })
 // RG-1.14 : au moins un contact nomme pour finaliser l'onglet.
 const canValidateContacts = computed(() => hasAtLeastOneValidContact(contacts.value))
 function addContact(): void {
    if (canAddContact.value) contacts.value.push(emptyContact())
 }
 function askRemoveContact(index: number): void {
    askConfirm(t('commercial.clients.form.confirmDelete.contact'), () => {
        contacts.value.splice(index, 1)
    })
 }
 /** POST/PATCH des contacts sur la sous-ressource /clients/{id}/contacts. */
 async function submitContacts(): Promise<void> {
    if (clientId.value === null || !canValidateContacts.value || tabSubmitting.value) return
    tabSubmitting.value = true
    try {
        for (const contact of contacts.value) {
            // On ignore les blocs totalement vides (ni nom ni prenom).
            if (!isContactNamed(contact)) continue
            const body = {
                firstName: contact.firstName || null,
                lastName: contact.lastName || null,
                jobTitle: contact.jobTitle || null,
                phonePrimary: contact.phonePrimary || null,
                phoneSecondary: contact.hasSecondaryPhone ? (contact.phoneSecondary || null) : null,
                email: contact.email || null,
            }
            if (contact.id === null) {
                const created = await api.post<ContactResponse>(
                    `/clients/${clientId.value}/contacts`,
                    body,
                    { headers: { Accept: 'application/ld+json' }, toast: false },
                )
                contact.id = created.id
                contact.iri = created['@id'] ?? null
            }
            else {
                await api.patch(`/client_contacts/${contact.id}`, body, { toast: false })
            }
        }
        completeTab('contact')
        toast.success({ title: t('commercial.clients.toast.updateSuccess') })
    }
    catch (error) {
        toast.error({ title: t('commercial.clients.toast.error'), message: apiErrorMessage(error) })
    }
    finally {
        tabSubmitting.value = false
    }
 }
 // ── Onglet Adresse ──────────────────────────────────────────────────────────
 const addresses = ref<AddressFormDraft[]>([emptyAddress()])
 const addressDegradedNotified = ref(false)
 // Categories autorisees sur une adresse : toutes SAUF DISTRIBUTEUR/COURTIER (RG-1.29).
 const addressCategoryOptions = computed(() =>
    referentials.categories.value.filter(c => !FORBIDDEN_ADDRESS_CATEGORY_CODES.includes(c.code)),
 )
 // Contacts deja crees, rattachables a une adresse (M2M, via leur IRI).
 const contactOptions = computed<RefOption[]>(() =>
    contacts.value
        .filter(c => c.iri !== null)
        .map(c => ({
            value: c.iri as string,
            label: [c.firstName, c.lastName].filter(Boolean).join(' ') || (c.email ?? ''),
        })),
 )
 // Pays disponibles (France preselectionnee par defaut sur chaque adresse).
 const countryOptions: RefOption[] = [
    { value: 'France', label: 'France' },
    { value: 'Espagne', label: 'Espagne' },
 ]
 // RG-1.10 (>= 1 site) + RG-1.11 (email facturation si Facturation) sur chaque adresse.
 const canValidateAddresses = computed(() =>
    addresses.value.length > 0
    && addresses.value.every((a) => {
        const filledBillingEmail = a.billingEmail !== null && a.billingEmail.trim() !== ''
        return a.siteIris.length >= 1 && (!isBillingEmailRequired(a) || filledBillingEmail)
    }),
 )
 function addAddress(): void {
    addresses.value.push(emptyAddress())
 }
 function askRemoveAddress(index: number): void {
    askConfirm(t('commercial.clients.form.confirmDelete.address'), () => {
        addresses.value.splice(index, 1)
    })
 }
 /** Avertit une seule fois quand l'autocompletion d'adresse bascule en degrade. */
 function onAddressDegraded(): void {
    if (addressDegradedNotified.value) return
    addressDegradedNotified.value = true
    toast.warning({
        title: t('commercial.clients.toast.error'),
        message: t('commercial.clients.form.address.degraded'),
    })
 }
 /** POST des adresses sur la sous-ressource /clients/{id}/addresses. */
 async function submitAddresses(): Promise<void> {
    if (clientId.value === null || !canValidateAddresses.value || tabSubmitting.value) return
    tabSubmitting.value = true
    try {
        for (const address of addresses.value) {
            const body = {
                isProspect: address.isProspect,
                isDelivery: address.isDelivery,
                isBilling: address.isBilling,
                country: address.country,
                postalCode: address.postalCode || null,
                city: address.city || null,
                street: address.street || null,
                streetComplement: address.streetComplement || null,
                categories: address.categoryIris,
                sites: address.siteIris,
                contacts: address.contactIris,
                billingEmail: isBillingEmailRequired(address) ? (address.billingEmail || null) : null,
            }
            if (address.id === null) {
                const created = await api.post<{ id: number }>(
                    `/clients/${clientId.value}/addresses`,
                    body,
                    { headers: { Accept: 'application/ld+json' }, toast: false },
                )
                address.id = created.id
            }
            else {
                await api.patch(`/client_addresses/${address.id}`, body, { toast: false })
            }
        }
        completeTab('address')
        toast.success({ title: t('commercial.clients.toast.updateSuccess') })
    }
    catch (error) {
        toast.error({ title: t('commercial.clients.toast.error'), message: apiErrorMessage(error) })
    }
    finally {
        tabSubmitting.value = false
    }
 }
 // ── Onglet Comptabilite ─────────────────────────────────────────────────────
 const accounting = reactive({
    siren: null as string | null,
    accountNumber: null as string | null,
    tvaModeIri: null as string | null,
    nTva: null as string | null,
    paymentDelayIri: null as string | null,
    paymentTypeIri: null as string | null,
    bankIri: null as string | null,
 })
 const ribs = ref<RibFormDraft[]>([])
 // L'onglet est editable seulement avec accounting.manage (sinon lecture seule).
 const accountingReadonly = computed(() => isValidated('accounting') || !canAccountingManage.value)
 // Code du type de reglement selectionne (pour RG-1.12 / RG-1.13).
 const selectedPaymentTypeCode = computed(() =>
    referentials.paymentTypes.value.find(p => p.value === accounting.paymentTypeIri)?.code ?? null,
 )
 const isBankRequired = computed(() => isBankRequiredForPaymentType(selectedPaymentTypeCode.value))
 const isRibRequired = computed(() => isRibRequiredForPaymentType(selectedPaymentTypeCode.value))
 function onPaymentTypeChange(value: string | number | null): void {
    accounting.paymentTypeIri = value === null ? null : String(value)
    // La banque n'a de sens que pour un virement : on la vide sinon (RG-1.12).
    if (!isBankRequired.value) accounting.bankIri = null
 }
 function ribIsComplete(rib: RibFormDraft): boolean {
    const filled = (v: string | null) => v !== null && v.trim() !== ''
    return filled(rib.label) && filled(rib.bic) && filled(rib.iban)
 }
 // RG-1.12 : banque requise si VIREMENT. RG-1.13 : >= 1 RIB complet si LCR.
 const canValidateAccounting = computed(() => {
    if (isBankRequired.value && (accounting.bankIri === null)) return false
    if (isRibRequired.value && !ribs.value.some(ribIsComplete)) return false
    return true
 })
 function addRib(): void {
    ribs.value.push(emptyRib())
 }
 function askRemoveRib(index: number): void {
    askConfirm(t('commercial.clients.form.confirmDelete.rib'), () => {
        ribs.value.splice(index, 1)
    })
 }
 /**
 * Valide l'onglet Comptabilite : PATCH des scalaires (groupe client:write:accounting)
 * PUIS POST des RIB sur /clients/{id}/ribs. Deux appels distincts (mode strict
 * RG-1.28 : il n'existe pas d'endpoint /accounting, cf. recon back).
 */
 async function submitAccounting(): Promise<void> {
    if (clientId.value === null || !canValidateAccounting.value || tabSubmitting.value) return
    tabSubmitting.value = true
    try {
        await api.patch(`/clients/${clientId.value}`, {
            siren: accounting.siren || null,
            accountNumber: accounting.accountNumber || null,
            tvaMode: accounting.tvaModeIri,
            nTva: accounting.nTva || null,
            paymentDelay: accounting.paymentDelayIri,
            paymentType: accounting.paymentTypeIri,
            bank: isBankRequired.value ? accounting.bankIri : null,
        }, { toast: false })
        for (const rib of ribs.value) {
            if (!ribIsComplete(rib)) continue
            if (rib.id === null) {
                const created = await api.post<{ id: number }>(
                    `/clients/${clientId.value}/ribs`,
                    { label: rib.label, bic: rib.bic, iban: rib.iban },
                    { headers: { Accept: 'application/ld+json' }, toast: false },
                )
                rib.id = created.id
            }
            else {
                await api.patch(`/client_ribs/${rib.id}`, { label: rib.label, bic: rib.bic, iban: rib.iban }, { toast: false })
            }
        }
        completeTab('accounting')
        toast.success({ title: t('commercial.clients.toast.updateSuccess') })
    }
    catch (error) {
        toast.error({ title: t('commercial.clients.toast.error'), message: apiErrorMessage(error) })
    }
    finally {
        tabSubmitting.value = false
    }
 }
 // ── Modal de confirmation generique ─────────────────────────────────────────
 const confirmModal = reactive({
    open: false,
    message: '',
    action: null as null | (() => void),
 })
 function askConfirm(message: string, action: () => void): void {
    confirmModal.message = message
    confirmModal.action = action
    confirmModal.open = true
 }
 function runConfirm(): void {
    confirmModal.action?.()
    confirmModal.action = null
    confirmModal.open = false
 }
 // ── Types de reponse API ────────────────────────────────────────────────────
 interface ClientResponse {
    id: number
    companyName: string | null
    firstName: string | null
    lastName: string | null
    email: string | null
    phonePrimary: string | null
    phoneSecondary: string | null
 }
 interface ContactResponse {
    '@id'?: string
    id: number
 }
 onMounted(() => {
    // Echec du chargement des referentiels non bloquant : les selects restent vides.
    referentials.loadCommon().catch(() => {})
 })
 </script>
@@ -1,98 +0,0 @@
 /**
 * Types « brouillon » de l'ecran « Ajouter un client » (M1 Commercial).
 *
 * Ces interfaces decrivent l'etat LOCAL du formulaire (refs Vue), distinct des
 * DTO de l'API : elles portent en plus des champs purement UI (`hasSecondaryPhone`)
 * et l'`iri` Hydra des entites creees (necessaire pour rattacher une adresse a
 * des contacts deja persistes, M2M). Partage par la page et les blocs reutilisables
 * `ClientContactBlock` / `ClientAddressBlock` (reutilises par 1.11/1.12).
 */
 /** Un contact du client (onglet Contact). */
 export interface ContactFormDraft {
    /** Id serveur une fois le contact cree (null tant que non persiste). */
    id: number | null
    /** IRI Hydra du contact cree — utilise pour le rattachement M2M cote adresse. */
    iri: string | null
    firstName: string | null
    lastName: string | null
    jobTitle: string | null
    phonePrimary: string | null
    phoneSecondary: string | null
    email: string | null
    /** UI : le 2e numero a ete revele via le bouton « + ». */
    hasSecondaryPhone: boolean
 }
 /** Une adresse du client (onglet Adresse). */
 export interface AddressFormDraft {
    id: number | null
    isProspect: boolean
    isDelivery: boolean
    isBilling: boolean
    country: string
    postalCode: string | null
    city: string | null
    street: string | null
    streetComplement: string | null
    /** IRI des categories rattachees (hors DISTRIBUTEUR/COURTIER — RG-1.29). */
    categoryIris: string[]
    /** IRI des sites Starseed rattaches (>= 1 obligatoire — RG-1.10). */
    siteIris: string[]
    /** IRI des contacts rattaches (= blocs Contact deja crees). */
    contactIris: string[]
    /** Email de facturation (obligatoire si isBilling — RG-1.11). */
    billingEmail: string | null
 }
 /** Un RIB du client (onglet Comptabilite). */
 export interface RibFormDraft {
    id: number | null
    label: string | null
    bic: string | null
    iban: string | null
 }
 /** Fabrique un contact vierge. */
 export function emptyContact(): ContactFormDraft {
    return {
        id: null,
        iri: null,
        firstName: null,
        lastName: null,
        jobTitle: null,
        phonePrimary: null,
        phoneSecondary: null,
        email: null,
        hasSecondaryPhone: false,
    }
 }
 /** Fabrique une adresse vierge (pays prerempli « France »). */
 export function emptyAddress(): AddressFormDraft {
    return {
        id: null,
        isProspect: false,
        isDelivery: false,
        isBilling: false,
        country: 'France',
        postalCode: null,
        city: null,
        street: null,
        streetComplement: null,
        categoryIris: [],
        siteIris: [],
        contactIris: [],
        billingEmail: null,
    }
 }
 /** Fabrique un RIB vierge. */
 export function emptyRib(): RibFormDraft {
    return {
        id: null,
        label: null,
        bic: null,
        iban: null,
    }
 }
@@ -1,152 +0,0 @@
 import { describe, it, expect } from 'vitest'
 import {
    applyProspectExclusivity,
    buildClientFormTabKeys,
    canSelectDeliveryOrBilling,
    canSelectProspect,
    hasAtLeastOneValidContact,
    isBankRequiredForPaymentType,
    isBillingEmailRequired,
    isContactNamed,
    isRibRequiredForPaymentType,
    type ContactDraft,
 } from '../clientFormRules'
 describe('buildClientFormTabKeys (gating onglet Comptabilite + onglets edit-only)', () => {
    it('inclut l onglet accounting si l utilisateur a accounting.view', () => {
        expect(buildClientFormTabKeys(true)).toContain('accounting')
    })
    it('exclut l onglet accounting sinon (Bureau / Commerciale)', () => {
        expect(buildClientFormTabKeys(false)).not.toContain('accounting')
    })
    it('a la creation, exclut Statistiques / Rapports / Echanges', () => {
        const keys = buildClientFormTabKeys(true)
        expect(keys).toEqual(['information', 'contact', 'address', 'transport', 'accounting'])
        expect(keys).not.toContain('statistics')
        expect(keys).not.toContain('reports')
        expect(keys).not.toContain('exchanges')
    })
    it('en modification (includeEditOnlyTabs), ajoute les onglets edit-only en fin', () => {
        const keys = buildClientFormTabKeys(true, { includeEditOnlyTabs: true })
        expect(keys).toEqual([
            'information',
            'contact',
            'address',
            'transport',
            'accounting',
            'statistics',
            'reports',
            'exchanges',
        ])
    })
 })
 describe('isContactNamed (RG-1.05)', () => {
    it('vrai si le prenom est renseigne', () => {
        expect(isContactNamed({ firstName: 'Alice', lastName: null })).toBe(true)
    })
    it('vrai si le nom est renseigne', () => {
        expect(isContactNamed({ firstName: null, lastName: 'Martin' })).toBe(true)
    })
    it('faux si les deux sont vides ou espaces uniquement', () => {
        expect(isContactNamed({ firstName: null, lastName: null })).toBe(false)
        expect(isContactNamed({ firstName: '  ', lastName: '' })).toBe(false)
    })
 })
 describe('hasAtLeastOneValidContact (RG-1.14)', () => {
    it('faux sur une liste vide', () => {
        expect(hasAtLeastOneValidContact([])).toBe(false)
    })
    it('faux si aucun contact n a de nom ni prenom', () => {
        const contacts: ContactDraft[] = [
            { firstName: null, lastName: null },
            { firstName: '', lastName: '  ' },
        ]
        expect(hasAtLeastOneValidContact(contacts)).toBe(false)
    })
    it('vrai des qu un contact a un nom ou un prenom', () => {
        const contacts: ContactDraft[] = [
            { firstName: null, lastName: null },
            { firstName: 'Bob', lastName: null },
        ]
        expect(hasAtLeastOneValidContact(contacts)).toBe(true)
    })
 })
 describe('exclusivite Prospect / Livraison / Facturation (RG-1.06/07/08)', () => {
    it('Prospect est selectionnable tant que ni Livraison ni Facturation', () => {
        expect(canSelectProspect({ isProspect: false, isDelivery: false, isBilling: false })).toBe(true)
        expect(canSelectProspect({ isProspect: false, isDelivery: true, isBilling: false })).toBe(false)
        expect(canSelectProspect({ isProspect: false, isDelivery: false, isBilling: true })).toBe(false)
    })
    it('Livraison / Facturation selectionnables tant que pas Prospect', () => {
        expect(canSelectDeliveryOrBilling({ isProspect: false, isDelivery: false, isBilling: false })).toBe(true)
        expect(canSelectDeliveryOrBilling({ isProspect: true, isDelivery: false, isBilling: false })).toBe(false)
    })
    it('cocher Prospect efface Livraison et Facturation', () => {
        const next = applyProspectExclusivity(
            { isProspect: false, isDelivery: true, isBilling: true },
            'isProspect',
            true,
        )
        expect(next).toEqual({ isProspect: true, isDelivery: false, isBilling: false })
    })
    it('cocher Livraison efface Prospect', () => {
        const next = applyProspectExclusivity(
            { isProspect: true, isDelivery: false, isBilling: false },
            'isDelivery',
            true,
        )
        expect(next).toEqual({ isProspect: false, isDelivery: true, isBilling: false })
    })
    it('cocher Facturation efface Prospect mais conserve Livraison', () => {
        const next = applyProspectExclusivity(
            { isProspect: true, isDelivery: true, isBilling: false },
            'isBilling',
            true,
        )
        expect(next).toEqual({ isProspect: false, isDelivery: true, isBilling: true })
    })
    it('decocher un drapeau ne reactive rien d autre', () => {
        const next = applyProspectExclusivity(
            { isProspect: false, isDelivery: true, isBilling: true },
            'isBilling',
            false,
        )
        expect(next).toEqual({ isProspect: false, isDelivery: true, isBilling: false })
    })
 })
 describe('isBillingEmailRequired (RG-1.11)', () => {
    it('obligatoire uniquement si Facturation est coche', () => {
        expect(isBillingEmailRequired({ isProspect: false, isDelivery: false, isBilling: true })).toBe(true)
        expect(isBillingEmailRequired({ isProspect: false, isDelivery: true, isBilling: false })).toBe(false)
    })
 })
 describe('regles type de reglement (RG-1.12 / RG-1.13)', () => {
    it('banque obligatoire si VIREMENT', () => {
        expect(isBankRequiredForPaymentType('VIREMENT')).toBe(true)
        expect(isBankRequiredForPaymentType('LCR')).toBe(false)
        expect(isBankRequiredForPaymentType(null)).toBe(false)
    })
    it('RIB obligatoire si LCR', () => {
        expect(isRibRequiredForPaymentType('LCR')).toBe(true)
        expect(isRibRequiredForPaymentType('VIREMENT')).toBe(false)
        expect(isRibRequiredForPaymentType(null)).toBe(false)
    })
 })
@@ -1,158 +0,0 @@
 /**
 * Regles metier pures de l'ecran « Ajouter un client » (M1 Commercial).
 *
 * Centralisees ici (hors composant) pour rester testables unitairement et
 * partagees entre la page de creation et les futurs ecrans d'edition (1.11/1.12).
 * Ces helpers ne touchent ni a l'API ni a l'etat reactif : ils prennent des
 * brouillons « plats » et retournent des booleens / nouveaux objets.
 *
 * Le back reste la source de verite (les RG sont re-validees serveur) ; ces
 * regles ne servent qu'au feedback UI immediat (gating de boutons, visibilite).
 *
 * NOTE RG-1.04 (Information obligatoire pour la Commerciale) : volontairement
 * NON miroite cote front pour l'instant. Le payload /api/me ne porte pas le code
 * de role (roles = IRIs opaques) et Bureau partage les memes permissions que
 * Commerciale : aucun signal fiable pour distinguer le role cote front. Le back
 * (ClientProcessor, via BusinessRoleAware) applique la regle de maniere fiable ;
 * a rebrancher ici des qu'un code de role sera expose dans /api/me.
 */
 /**
 * Onglets « coquille » (non encore implementes) : frame vide, passage
 * automatique a l'onglet suivant (decision Tristan 28/05).
 */
 export const CLIENT_FORM_PLACEHOLDER_TABS = ['transport', 'statistics', 'reports', 'exchanges'] as const
 /**
 * Onglets affiches uniquement en MODIFICATION (selon le role), jamais a la
 * creation : Statistiques / Rapports / Echanges. A rebrancher dans les ecrans
 * d'edition (1.11/1.12) via l'option `includeEditOnlyTabs`.
 */
 export const CLIENT_FORM_EDIT_ONLY_TABS = ['statistics', 'reports', 'exchanges'] as const
 /**
 * Construit l'ordre des onglets du formulaire client.
 *  - L'onglet Comptabilite n'est present que si l'utilisateur a `accounting.view`
 *    (Bureau / Commerciale ne le voient pas).
 *  - Les onglets edit-only (Statistiques / Rapports / Echanges) sont exclus par
 *    defaut (creation) ; passer `includeEditOnlyTabs: true` pour les afficher en
 *    modification.
 * Ordre aligne sur la spec M1 § Ecran « Ajouter un client ».
 */
 export function buildClientFormTabKeys(
    canAccountingView: boolean,
    options: { includeEditOnlyTabs?: boolean } = {},
 ): string[] {
    const keys = ['information', 'contact', 'address', 'transport']
    if (canAccountingView) {
        keys.push('accounting')
    }
    if (options.includeEditOnlyTabs) {
        keys.push(...CLIENT_FORM_EDIT_ONLY_TABS)
    }
    return keys
 }
 /** Sous-ensemble d'un contact necessaire aux regles de nommage (RG-1.05/1.14). */
 export interface ContactDraft {
    firstName: string | null
    lastName: string | null
 }
 /** Drapeaux d'usage d'une adresse (RG-1.06/07/08/11). */
 export interface AddressFlagsDraft {
    isProspect: boolean
    isDelivery: boolean
    isBilling: boolean
 }
 /** Vrai si une chaine porte au moins un caractere non-espace. */
 function isFilled(value: string | null | undefined): boolean {
    return value !== null && value !== undefined && value.trim() !== ''
 }
 /**
 * RG-1.05 : un contact est valide des qu'il porte un nom OU un prenom.
 */
 export function isContactNamed(contact: ContactDraft): boolean {
    return isFilled(contact.firstName) || isFilled(contact.lastName)
 }
 /**
 * RG-1.14 : l'onglet Contact ne peut etre finalise que s'il reste au moins un
 * contact nomme (nom ou prenom).
 */
 export function hasAtLeastOneValidContact(contacts: ContactDraft[]): boolean {
    return contacts.some(isContactNamed)
 }
 /**
 * RG-1.06/07/08 : une adresse de prospection est exclusive d'une adresse de
 * livraison/facturation. Prospect n'est selectionnable que si ni Livraison ni
 * Facturation ne sont coches.
 */
 export function canSelectProspect(flags: AddressFlagsDraft): boolean {
    return !flags.isDelivery && !flags.isBilling
 }
 /**
 * RG-1.06/07/08 : Livraison et Facturation ne sont selectionnables que si
 * Prospect n'est pas coche.
 */
 export function canSelectDeliveryOrBilling(flags: AddressFlagsDraft): boolean {
    return !flags.isProspect
 }
 /**
 * Applique l'exclusivite Prospect / (Livraison|Facturation) au changement d'un
 * drapeau. Cocher Prospect efface Livraison + Facturation ; cocher Livraison ou
 * Facturation efface Prospect. Decocher n'a aucun effet de bord. Retourne un
 * nouvel objet (pas de mutation de l'entree).
 */
 export function applyProspectExclusivity(
    flags: AddressFlagsDraft,
    field: keyof AddressFlagsDraft,
    value: boolean,
 ): AddressFlagsDraft {
    const next: AddressFlagsDraft = { ...flags, [field]: value }
    if (value && field === 'isProspect') {
        next.isDelivery = false
        next.isBilling = false
    }
    else if (value && (field === 'isDelivery' || field === 'isBilling')) {
        next.isProspect = false
    }
    return next
 }
 /**
 * RG-1.11 : l'email de facturation n'est visible/obligatoire que si l'adresse
 * est une adresse de facturation.
 */
 export function isBillingEmailRequired(flags: AddressFlagsDraft): boolean {
    return flags.isBilling
 }
 /** Code stable du type de reglement « virement » (cf. PaymentType.code, RG-1.12). */
 const PAYMENT_TYPE_TRANSFER = 'VIREMENT'
 /** Code stable du type de reglement « lettre de change » (RG-1.13). */
 const PAYMENT_TYPE_LCR = 'LCR'
 /**
 * RG-1.12 : la banque est obligatoire lorsque le type de reglement est un
 * virement.
 */
 export function isBankRequiredForPaymentType(code: string | null | undefined): boolean {
    return code === PAYMENT_TYPE_TRANSFER
 }
 /**
 * RG-1.13 : au moins un RIB complet est obligatoire lorsque le type de reglement
 * est une LCR.
 */
 export function isRibRequiredForPaymentType(code: string | null | undefined): boolean {
    return code === PAYMENT_TYPE_LCR
 }
@@ -11,7 +11,7 @@
            :title="`${group.module} (${selectedCountFor(group)}/${group.permissions.length})`"
            header-class="capitalize"
        >
-            <div class="flex flex-col">
+            <div class="flex flex-col gap-3">
                <!-- Tout selectionner pour ce module -->
                <MalioCheckbox
                    :id="`${idPrefix}-group-${group.module}`"
@@ -20,7 +20,7 @@
                    label-class="font-semibold text-sm text-neutral-700"
                    @update:model-value="(val: boolean) => emit('toggle-all', group.module, val)"
                />
-                <div class="flex flex-col">
+                <div class="flex flex-col gap-2">
                    <MalioCheckbox
                        v-for="perm in group.permissions"
                        :id="`${idPrefix}-perm-${perm.id}`"
@@ -11,7 +11,7 @@
                {{ isEditMode ? t('admin.roles.editRole') : t('admin.roles.createRole') }}
            </h2>
        </template>
-        <form class="flex flex-col py-4 gap-2" @submit.prevent="handleSave">
+        <form class="flex flex-col gap-4 py-4" @submit.prevent="handleSave">
            <!-- Champs du role -->
            <MalioInputText
                v-model="form.label"
@@ -71,7 +71,7 @@
                variant="danger"
                icon-name="mdi:delete-outline"
                icon-position="left"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                :disabled="role?.isSystem"
                @click="emit('delete')"
            />
@@ -79,13 +79,13 @@
                v-else
                :label="t('common.cancel')"
                variant="tertiary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('update:modelValue', false)"
            />
            <MalioButton
                :label="t('common.save')"
                variant="primary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                :disabled="saving || permissionsLoadFailed"
                @click="handleSave"
            />
@@ -11,7 +11,7 @@
                {{ t('admin.users.drawer.title', { username: user?.username ?? '' }) }}
            </h2>
        </template>
-        <div class="flex flex-col space-y-4 py-4">
+        <div class="flex flex-col gap-4 py-4">
            <!-- Etat d'erreur de chargement des referentiels : bloque la
                 sauvegarde pour empecher un ecrasement silencieux des droits. -->
            <div
@@ -41,13 +41,11 @@
            />
            <!-- Section Roles -->
-            <!-- !mt-0 : la MalioCheckbox au-dessus expose son slot message (16px),
+            <div>
                 qui couvre deja l'ecart attendu — pas besoin du space-y-4 ici. -->
            <div class="!mt-0">
                <h4 class="mb-3 text-sm font-semibold text-neutral-700">
                    {{ t('admin.users.drawer.rolesSection') }}
                </h4>
-                <div class="flex flex-col">
+                <div class="flex flex-col gap-2">
                    <MalioCheckbox
                        v-for="role in allRoles"
                        :key="role.id"
@@ -86,7 +84,7 @@
                <div v-if="allSites.length === 0" class="text-sm text-neutral-400">
                    {{ t('admin.sites.noSites') }}
                </div>
-                <div class="flex flex-col">
+                <div class="flex flex-col gap-2">
                    <MalioCheckbox
                        v-for="site in allSites"
                        :id="`site-${site.id}`"
@@ -115,13 +113,13 @@
            <MalioButton
                :label="t('common.cancel')"
                variant="tertiary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('update:modelValue', false)"
            />
            <MalioButton
                :label="t('common.save')"
                variant="primary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                :disabled="saving || loadFailed"
                @click="handleSave"
            />
@@ -66,18 +66,15 @@
            <MalioAccordion>
                <!-- Dates : deux champs date+heure Du / Au (champs datetime a l'origine) -->
                <MalioAccordionItem :title="t('audit.filters.date_range')" value="dates">
-                    <!-- pb-4 sur les labels Du/Au : simule le slot message
+                    <div class="grid grid-cols-[auto_1fr] items-center gap-x-3 gap-y-4">
-                         du MalioDateTime voisin pour qu'items-center recentre
+                        <span>{{ t('audit.filters.date_from') }}</span>
                         le label sur le centre visible du champ. -->
                    <div class="grid grid-cols-[auto_1fr] items-center gap-x-3">
                        <span class="pb-4">{{ t('audit.filters.date_from') }}</span>
                        <!-- Borne le picker "Du" par la valeur "Au" pour interdire une plage
                             inversee a la saisie (le backend renverrait silencieusement 0 ligne). -->
                        <MalioDateTime
                            v-model="draftDateFrom"
                            :max="draftDateTo ?? undefined"
                        />
-                        <span class="pb-4">{{ t('audit.filters.date_to') }}</span>
+                        <span>{{ t('audit.filters.date_to') }}</span>
                        <MalioDateTime
                            v-model="draftDateTo"
                            :min="draftDateFrom ?? undefined"
@@ -87,7 +84,7 @@
                <!-- Type d'entite : cases a cocher (multi-selection) -->
                <MalioAccordionItem :title="t('audit.filters.entity_type')" value="entity">
-                    <div class="flex flex-col">
+                    <div class="flex flex-col gap-4">
                        <MalioCheckbox
                            v-for="opt in entityTypeOptions"
                            :id="`filter-entity-${opt.value}`"
@@ -108,7 +105,6 @@
                        name="audit-action"
                        :value="opt.value"
                        :label="opt.label"
                        group-class="mt-0"
                    />
                </MalioAccordionItem>
@@ -125,7 +121,7 @@
                <MalioButton
                    variant="tertiary"
                    :label="t('audit.filters.reset')"
-                    button-class="w-m-btn-action"
+                    button-class="w-[150px]"
                    @click="resetFilters"
                />
                <MalioButton
@@ -13,19 +13,14 @@
            </template>
        </PageHeader>
-        <!-- Table des roles — pagination serveur via usePaginatedList (#73). -->
+        <!-- Table des roles -->
        <MalioDataTable
            :columns="columns"
            :items="roleItems"
-            :total-items="totalItems"
+            :total-items="roles.length"
            :page="currentPage"
            :per-page="itemsPerPage"
            :per-page-options="itemsPerPageOptions"
            :row-clickable="canManage"
            :empty-message="t('admin.roles.noRoles')"
            @row-click="onRowClick"
            @update:page="goToPage"
            @update:per-page="setItemsPerPage"
        >
            <template #cell-code="{ item }">
                <span class="font-mono text-xs">{{ item.code }}</span>
@@ -71,17 +66,8 @@ const canManage = computed(() => can('core.roles.manage'))
 useHead({ title: t('admin.roles.title') })
-// Pagination serveur via le composable partage (#73).
+const roles = ref<Role[]>([])
-const {
+const loading = ref(false)
    items: roles,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: loadRoles,
    goToPage,
    setItemsPerPage,
 } = usePaginatedList<Role>({ url: '/roles' })
 const columns = [
    { key: 'label', label: t('admin.roles.table.label') },
@@ -116,6 +102,25 @@ const deleteModalOpen = ref(false)
 const roleToDelete = ref<Role | null>(null)
 const deleting = ref(false)
 // Charger la liste des roles
 async function loadRoles() {
    loading.value = true
    try {
        const data = await api.get<{ member: Role[] }>(
            '/roles',
            {},
            { toast: false },
        )
        roles.value = data.member
    } catch {
        // Reset sur echec pour ne pas afficher de donnees stale (ancienne
        // requete reussie avant une perte reseau ou 403).
        roles.value = []
    } finally {
        loading.value = false
    }
 }
 function openCreateDrawer() {
    selectedRole.value = null
    drawerOpen.value = true
@@ -2,19 +2,14 @@
    <div>
        <PageHeader>{{ t('admin.users.title') }}</PageHeader>
-        <!-- Table des utilisateurs — pagination serveur via usePaginatedList (#73). -->
+        <!-- Table des utilisateurs -->
        <MalioDataTable
            :columns="columns"
            :items="userItems"
-            :total-items="totalItems"
+            :total-items="users.length"
            :page="currentPage"
            :per-page="itemsPerPage"
            :per-page-options="itemsPerPageOptions"
            :row-clickable="canManage"
            :empty-message="t('admin.users.noUsers')"
            @row-click="onRowClick"
            @update:page="goToPage"
            @update:per-page="setItemsPerPage"
        >
            <template #cell-admin="{ item }">
                <span
@@ -39,26 +34,15 @@
 import type { UserListItem } from '~/shared/types/rbac'
 const { t } = useI18n()
 const api = useApi()
 const { can } = usePermissions()
 useHead({ title: t('admin.users.title') })
 const canManage = computed(() => can('core.users.manage'))
-// Pagination serveur via le composable partage (#73). Le payload `users`
+const users = ref<UserListItem[]>([])
-// reste leger (pas de detail RBAC dans la liste — cf. commentaire colonne
+const loading = ref(false)
 // "Sites" plus bas) ce qui rend la pagination 10/25/50 par page confortable.
 const {
    items: users,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: loadUsers,
    goToPage,
    setItemsPerPage,
 } = usePaginatedList<UserListItem>({ url: '/users' })
 const drawerOpen = ref(false)
 const selectedUser = ref<UserListItem | null>(null)
@@ -83,6 +67,21 @@ const userItems = computed(() =>
    })),
 )
 async function loadUsers() {
    loading.value = true
    try {
        const usersData = await api.get<{ member: UserListItem[] }>('/users', {}, { toast: false })
        users.value = usersData.member
    } catch {
        // Reset sur echec pour ne pas afficher de donnees stale (ancienne
        // requete reussie avant une perte reseau ou 403). Pas de toast par
        // design ici : on laisse la liste vide parler d'elle-meme.
        users.value = []
    } finally {
        loading.value = false
    }
 }
 function getUserById(id: number): UserListItem | undefined {
    return users.value.find(u => u.id === id)
 }
@@ -6,7 +6,7 @@
            <img src="/LOGO_MALIO.png" alt="Logo" class="w-[150px]"/>
        </span>
        <form
-            class="mt-8 rounded-lg border border-neutral-200 bg-white p-6 shadow-sm"
+            class="mt-8 space-y-6 rounded-lg border border-neutral-200 bg-white p-6 shadow-sm"
            @submit.prevent="handleSubmit"
        >
            <MalioInputText
@@ -30,7 +30,7 @@
                type="submit"
                :disabled="isSubmitting"
            />
-            <p class="mt-6 font-bold">v{{ version }}</p>
+            <p class="font-bold">v{{ version }}</p>
        </form>
    </div>
 </template>
@@ -11,7 +11,7 @@
                {{ isEditMode ? t('admin.sites.editSite') : t('admin.sites.createSite') }}
            </h2>
        </template>
-        <form class="flex flex-col py-4 gap-2" @submit.prevent="handleSave">
+        <form class="flex flex-col gap-4 py-4" @submit.prevent="handleSave">
            <MalioInputText
                v-model="form.name"
                :label="t('admin.sites.form.name')"
@@ -65,16 +65,11 @@
                        input-class="w-full font-mono"
                        required
                    />
-                    <!-- pb-4 sur le wrapper : simule le slot message du
+                    <span
-                         MalioInputText voisin pour qu'items-center recentre
+                        :style="{ backgroundColor: isValidHex ? form.color : 'transparent' }"
-                         la puce sur le centre visible de l'input. -->
+                        class="inline-block size-10 shrink-0 rounded-lg border border-neutral-200"
-                    <div class="shrink-0 pb-4">
+                        :class="{ 'border-dashed': !isValidHex }"
-                        <span
+                    />
                            :style="{ backgroundColor: isValidHex ? form.color : 'transparent' }"
                            class="inline-block size-10 rounded-lg border border-neutral-200"
                            :class="{ 'border-dashed': !isValidHex }"
                        />
                    </div>
                </div>
                <p v-if="form.color && !isValidHex" class="mt-1 text-xs text-red-600">
                    {{ t('admin.sites.form.colorInvalid') }}
@@ -92,20 +87,20 @@
                variant="danger"
                icon-name="mdi:delete-outline"
                icon-position="left"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('delete')"
            />
            <MalioButton
                v-else
                :label="t('common.cancel')"
                variant="tertiary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                @click="emit('update:modelValue', false)"
            />
            <MalioButton
                :label="t('common.save')"
                variant="primary"
-                button-class="w-m-btn-action"
+                button-class="w-[150px]"
                :disabled="saving || !isValidHex"
                @click="handleSave"
            />
@@ -13,19 +13,14 @@
            </template>
        </PageHeader>
-        <!-- Table des sites — pagination serveur via usePaginatedList (#73). -->
+        <!-- Table des sites -->
        <MalioDataTable
            :columns="columns"
            :items="siteItems"
-            :total-items="totalItems"
+            :total-items="sites.length"
            :page="currentPage"
            :per-page="itemsPerPage"
            :per-page-options="itemsPerPageOptions"
            :row-clickable="canManage"
            :empty-message="t('admin.sites.noSites')"
            @row-click="onRowClick"
            @update:page="goToPage"
            @update:per-page="setItemsPerPage"
        >
            <template #cell-color="{ item }">
                <span class="inline-flex items-center gap-2">
@@ -72,20 +67,8 @@ const canManage = computed(() => can('sites.manage'))
 useHead({ title: t('admin.sites.title') })
-// Pagination serveur via le composable partage (#73). Aucun OrderFilter
+const sites = ref<Site[]>([])
-// declare cote API Platform sur Site, donc on s'appuie sur le tri par
+const loading = ref(false)
 // defaut du repository (id ASC). Le composable est neanmoins pret a
 // recevoir un `defaultSort` ou des filtres le jour ou l'API les expose.
 const {
    items: sites,
    totalItems,
    currentPage,
    itemsPerPage,
    itemsPerPageOptions,
    fetch: loadSites,
    goToPage,
    setItemsPerPage,
 } = usePaginatedList<Site>({ url: '/sites' })
 const columns = [
    { key: 'name', label: t('admin.sites.table.name') },
@@ -124,6 +107,24 @@ const deleteModalOpen = ref(false)
 const siteToDelete = ref<Site | null>(null)
 const deleting = ref(false)
 async function loadSites() {
    loading.value = true
    try {
        const data = await api.get<{ member: Site[] }>(
            '/sites',
            { itemsPerPage: 999 },
            { toast: false },
        )
        sites.value = data.member
    } catch {
        // Reset sur echec pour ne pas afficher de donnees stale (ancienne
        // requete reussie avant une perte reseau ou 403).
        sites.value = []
    } finally {
        loading.value = false
    }
 }
 function openCreateDrawer() {
    selectedSite.value = null
    drawerOpen.value = true
@@ -7,7 +7,7 @@
      "name": "starseed-frontend",
      "hasInstallScript": true,
      "dependencies": {
-        "@malio/layer-ui": "^1.7.3",
+        "@malio/layer-ui": "^1.7.1",
        "@nuxt/icon": "^2.2.1",
        "@nuxtjs/i18n": "^10.2.3",
        "@nuxtjs/tailwindcss": "^6.14.0",
@@ -1866,9 +1866,9 @@
      "license": "MIT"
    },
    "node_modules/@malio/layer-ui": {
-      "version": "1.7.3",
+      "version": "1.7.1",
-      "resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.3/layer-ui-1.7.3.tgz",
+      "resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.1/layer-ui-1.7.1.tgz",
-      "integrity": "sha512-jw3ka0Az6Jf0F9ifsooknkwXph8TNgoe6H3CjF8tbBxl8oND8HLHjlZ04ooUCoOUEIlsQ1Mm2hFFlQRCB04qdA==",
+      "integrity": "sha512-RYMMappWt/fgjD+BM7//h2O6kxD6WH9Fui8hoC29xtKySRQsqD61XKTdR7BRRkpktbxKmV39q/hblyAFBqV5yw==",
      "dependencies": {
        "@nuxt/icon": "^2.2.1",
        "@nuxtjs/tailwindcss": "^6.14.0",
@@ -17,7 +17,7 @@
    "test:e2e:ui": "playwright test --ui"
  },
  "dependencies": {
-    "@malio/layer-ui": "^1.7.3",
+    "@malio/layer-ui": "^1.7.1",
    "@nuxt/icon": "^2.2.1",
    "@nuxtjs/i18n": "^10.2.3",
    "@nuxtjs/tailwindcss": "^6.14.0",
@@ -1,412 +0,0 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
 import { usePaginatedList } from '../usePaginatedList'
 const mockApiGet = vi.hoisted(() => vi.fn())
 vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
 /**
 * Tests du composable `usePaginatedList`.
 *
 * Couvre les invariants critiques :
 *  - parse Hydra (member / totalItems)
 *  - navigation page (goToPage / next / prev / bornes)
 *  - changement items/page → retour page 1
 *  - mutation filtres / tri → retour page 1
 *  - cas limite : page courante hors borne apres filtre → derniere page valide
 *  - liste vide / page unique
 *  - reset → defaults
 *  - swallow d'erreur reseau (la promesse `fetch` ne reject jamais)
 *  - header `Accept: application/ld+json` toujours envoye (besoin du
 *    paginator Hydra cote API Platform 4).
 */
 describe('usePaginatedList', () => {
    beforeEach(() => {
        mockApiGet.mockReset()
    })
    function mockResponse(member: unknown[], totalItems: number): void {
        mockApiGet.mockResolvedValueOnce({ member, totalItems })
    }
    it('fetch initial : page=1, itemsPerPage par defaut, parse Hydra', async () => {
        mockResponse([{ id: 1 }, { id: 2 }], 42)
        const list = usePaginatedList<{ id: number }>({ url: '/sites' })
        await list.fetch()
        expect(mockApiGet).toHaveBeenCalledTimes(1)
        const [url, query, opts] = mockApiGet.mock.calls[0]
        expect(url).toBe('/sites')
        expect(query).toMatchObject({ page: 1, itemsPerPage: 10 })
        expect(opts).toMatchObject({
            toast: false,
            headers: { Accept: 'application/ld+json' },
        })
        expect(list.items.value).toEqual([{ id: 1 }, { id: 2 }])
        expect(list.totalItems.value).toBe(42)
        expect(list.totalPages.value).toBe(5)
        expect(list.isEmpty.value).toBe(false)
        expect(list.isSinglePage.value).toBe(false)
    })
    it('itemsPerPage personnalise est respecte au premier fetch', async () => {
        mockResponse([], 0)
        const list = usePaginatedList({ url: '/users', defaultItemsPerPage: 25 })
        await list.fetch()
        expect(mockApiGet.mock.calls[0][1]).toMatchObject({ itemsPerPage: 25 })
        expect(list.itemsPerPage.value).toBe(25)
    })
    it('goToPage(N) declenche un nouvel appel avec page=N', async () => {
        mockResponse([{ id: 1 }], 30) // page 1
        const list = usePaginatedList<{ id: number }>({ url: '/users' })
        await list.fetch()
        mockResponse([{ id: 2 }], 30) // page 2
        await list.goToPage(2)
        expect(mockApiGet).toHaveBeenCalledTimes(2)
        expect(mockApiGet.mock.calls[1][1]).toMatchObject({ page: 2, itemsPerPage: 10 })
        expect(list.currentPage.value).toBe(2)
    })
    it('goToPage hors borne sup. est clampe a totalPages', async () => {
        mockResponse([], 30) // totalPages = 3
        const list = usePaginatedList({ url: '/roles' })
        await list.fetch()
        mockResponse([], 30)
        await list.goToPage(999)
        expect(list.currentPage.value).toBe(3)
    })
    it('goToPage hors borne inf. est clampe a 1 (no-op si deja en 1)', async () => {
        mockResponse([], 30)
        const list = usePaginatedList({ url: '/roles' })
        await list.fetch()
        mockApiGet.mockClear()
        await list.goToPage(-5)
        // Deja en page 1 -> aucun nouvel appel.
        expect(mockApiGet).toHaveBeenCalledTimes(0)
        expect(list.currentPage.value).toBe(1)
    })
    it('nextPage / prevPage avancent et reculent dans les bornes', async () => {
        mockResponse([], 30) // page 1, totalPages 3
        const list = usePaginatedList({ url: '/roles' })
        await list.fetch()
        mockResponse([], 30)
        await list.nextPage()
        expect(list.currentPage.value).toBe(2)
        mockResponse([], 30)
        await list.nextPage()
        expect(list.currentPage.value).toBe(3)
        // En derniere page -> no-op
        mockApiGet.mockClear()
        await list.nextPage()
        expect(mockApiGet).toHaveBeenCalledTimes(0)
        expect(list.currentPage.value).toBe(3)
        mockResponse([], 30)
        await list.prevPage()
        expect(list.currentPage.value).toBe(2)
    })
    it('setItemsPerPage revient en page 1 et refetch', async () => {
        mockResponse([], 100)
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        // place-toi page 3
        mockResponse([], 100)
        await list.goToPage(3)
        expect(list.currentPage.value).toBe(3)
        mockResponse([], 100)
        await list.setItemsPerPage(25)
        expect(list.currentPage.value).toBe(1)
        expect(list.itemsPerPage.value).toBe(25)
        expect(mockApiGet.mock.calls.at(-1)?.[1]).toMatchObject({ page: 1, itemsPerPage: 25 })
    })
    it('setItemsPerPage no-op si meme valeur', async () => {
        mockResponse([], 10)
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        mockApiGet.mockClear()
        await list.setItemsPerPage(10)
        expect(mockApiGet).toHaveBeenCalledTimes(0)
    })
    it('setFilters fusionne et retombe en page 1', async () => {
        mockResponse([], 100)
        const list = usePaginatedList<unknown, { name?: string; active?: boolean }>({
            url: '/users',
            defaultFilters: { active: true },
        })
        await list.fetch()
        mockResponse([], 100)
        await list.goToPage(2)
        mockResponse([], 100)
        await list.setFilters({ name: 'alice' })
        expect(list.currentPage.value).toBe(1)
        expect(list.filters.value).toEqual({ active: true, name: 'alice' })
        expect(mockApiGet.mock.calls.at(-1)?.[1]).toMatchObject({
            page: 1,
            active: true,
            name: 'alice',
        })
    })
    it('setFilters({ key: undefined }) supprime la cle', async () => {
        mockResponse([], 100)
        const list = usePaginatedList<unknown, { name?: string }>({
            url: '/users',
            defaultFilters: { name: 'alice' },
        })
        await list.fetch()
        mockResponse([], 100)
        await list.setFilters({ name: undefined })
        expect(list.filters.value).toEqual({})
        // Le query envoye ne contient plus `name` (compactQuery elimine
        // aussi les valeurs vides).
        const q = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
        expect(q.name).toBeUndefined()
    })
    it('setFilters({ replace: true }) remplace integralement', async () => {
        mockResponse([], 100)
        const list = usePaginatedList<unknown, { a?: string; b?: string }>({
            url: '/users',
            defaultFilters: { a: 'x' },
        })
        await list.fetch()
        mockResponse([], 100)
        await list.setFilters({ b: 'y' }, { replace: true })
        expect(list.filters.value).toEqual({ b: 'y' })
    })
    it('setSort envoie order[field]=direction et reset page', async () => {
        mockResponse([], 100)
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        mockResponse([], 100)
        await list.goToPage(2)
        mockResponse([], 100)
        await list.setSort({ field: 'username', direction: 'desc' })
        expect(list.currentPage.value).toBe(1)
        const q = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
        expect(q['order[username]']).toBe('desc')
    })
    it('setSort(null) retire le tri', async () => {
        mockResponse([], 100)
        const list = usePaginatedList({
            url: '/users',
            defaultSort: { field: 'name', direction: 'asc' },
        })
        await list.fetch()
        // Le tri initial est applique
        let q = mockApiGet.mock.calls[0][1] as Record<string, unknown>
        expect(q['order[name]']).toBe('asc')
        mockResponse([], 100)
        await list.setSort(null)
        q = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
        expect(q['order[name]']).toBeUndefined()
    })
    it('setFilters retombe en page 1 (cas standard, pas le hors-borne)', async () => {
        // setFilters remet toujours page=1 avant de refetcher : ce n'est
        // donc PAS le chemin de retry hors-borne (couvert par le test
        // suivant via un refetch a page constante). On verifie juste le
        // reset de page ici.
        mockResponse([], 50) // 5 pages
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        mockResponse([], 50)
        await list.goToPage(5)
        expect(list.currentPage.value).toBe(5)
        mockResponse([{ id: 1 }, { id: 2 }], 12)
        await list.setFilters({ active: true } as never)
        expect(list.currentPage.value).toBe(1)
        expect(mockApiGet.mock.calls.at(-1)?.[1]).toMatchObject({ page: 1 })
    })
    it('declenche le retry sur derniere page si currentPage > totalPages apres fetch', async () => {
        // Scenario : on a fait un fetch (5 pages, page=1). Sans toucher aux
        // filtres mais entre deux fetchs la donnee a change cote serveur,
        // la page courante peut devenir hors borne. On force le scenario
        // en montant manuellement currentPage via goToPage borne, puis en
        // simulant une reponse plus petite.
        mockResponse([], 50) // 5 pages
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        mockResponse([], 50)
        await list.goToPage(5)
        expect(list.currentPage.value).toBe(5)
        // Maintenant simule : refetch -> totalItems chute a 12 (2 pages),
        // le composable doit refetcher sur page=2.
        mockApiGet.mockReset()
        mockApiGet
            .mockResolvedValueOnce({ member: [], totalItems: 12 }) // page=5 vide
            .mockResolvedValueOnce({ member: [{ id: 11 }, { id: 12 }], totalItems: 12 }) // page=2
        await list.fetch()
        expect(mockApiGet).toHaveBeenCalledTimes(2)
        expect(mockApiGet.mock.calls[1][1]).toMatchObject({ page: 2 })
        expect(list.currentPage.value).toBe(2)
        expect(list.items.value).toEqual([{ id: 11 }, { id: 12 }])
    })
    it('liste vide : isEmpty true, isSinglePage true', async () => {
        mockResponse([], 0)
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        expect(list.totalItems.value).toBe(0)
        expect(list.isEmpty.value).toBe(true)
        expect(list.isSinglePage.value).toBe(true)
        expect(list.totalPages.value).toBe(1)
    })
    it('isEmpty est faux avant le premier fetch (etat indetermine)', () => {
        const list = usePaginatedList({ url: '/users' })
        expect(list.isEmpty.value).toBe(false)
    })
    it('reset revient aux defaults', async () => {
        mockResponse([], 100)
        const list = usePaginatedList<unknown, { a?: string }>({
            url: '/users',
            defaultItemsPerPage: 10,
            defaultFilters: { a: 'x' },
            defaultSort: { field: 'name', direction: 'asc' },
        })
        await list.fetch()
        mockResponse([], 100)
        await list.setItemsPerPage(50)
        mockResponse([], 100)
        await list.setFilters({ a: 'y' })
        mockResponse([], 100)
        await list.setSort({ field: 'id', direction: 'desc' })
        mockResponse([], 100)
        await list.goToPage(2)
        expect(list.currentPage.value).toBe(2)
        mockResponse([], 100)
        await list.reset()
        expect(list.itemsPerPage.value).toBe(10)
        expect(list.filters.value).toEqual({ a: 'x' })
        expect(list.sort.value).toEqual({ field: 'name', direction: 'asc' })
        expect(list.currentPage.value).toBe(1)
    })
    it('swallow l\'erreur reseau : items vides, loading false, fetch ne reject pas', async () => {
        const boom = new Error('boom')
        mockApiGet.mockRejectedValueOnce(boom)
        const list = usePaginatedList({ url: '/users' })
        await expect(list.fetch()).resolves.toBeUndefined()
        expect(list.items.value).toEqual([])
        expect(list.totalItems.value).toBe(0)
        expect(list.loading.value).toBe(false)
        // L'erreur est consideree comme un fetch consume -> isEmpty=true.
        expect(list.isEmpty.value).toBe(true)
        // ... mais `error` est expose pour distinguer « vide » d'« echec ».
        expect(list.error.value).toBe(boom)
    })
    it('error est remis a null des qu\'un fetch ulterieur reussit', async () => {
        mockApiGet.mockRejectedValueOnce(new Error('boom'))
        const list = usePaginatedList({ url: '/users' })
        await list.fetch()
        expect(list.error.value).toBeInstanceOf(Error)
        mockResponse([{ id: 1 }], 1)
        await list.fetch()
        expect(list.error.value).toBeNull()
        expect(list.items.value).toEqual([{ id: 1 }])
    })
    it('ignore une reponse periemee : la derniere requete *demandee* gagne', async () => {
        // Deux fetch concurrents : le 1er resout APRES le 2eme. Sans garde
        // de sequence, la reponse arrivee en dernier (token 1) ecraserait
        // les donnees plus fraiches du token 2. Avec la garde, token 2 fait
        // foi quel que soit l'ordre d'arrivee reseau.
        const list = usePaginatedList<{ id: number }>({ url: '/users' })
        let resolveSlow!: (v: unknown) => void
        const slow = new Promise((r) => { resolveSlow = r })
        // 1er appel : reponse lente (en vol).
        mockApiGet.mockReturnValueOnce(slow)
        // 2eme appel : reponse immediate avec des donnees plus fraiches.
        mockApiGet.mockResolvedValueOnce({ member: [{ id: 2 }], totalItems: 30 })
        const p1 = list.fetch()   // token 1, en vol
        const p2 = list.fetch()   // token 2, resout tout de suite
        await p2
        expect(list.items.value).toEqual([{ id: 2 }])
        // La reponse lente du token 1 arrive enfin : elle doit etre ignoree.
        resolveSlow({ member: [{ id: 1 }], totalItems: 30 })
        await p1
        expect(list.items.value).toEqual([{ id: 2 }])
        // Le spinner reste eteint (la requete recente l'avait deja coupe).
        expect(list.loading.value).toBe(false)
    })
    it('extraQuery est injecte a chaque fetch (ex : includeDeleted)', async () => {
        mockResponse([], 0)
        const list = usePaginatedList({
            url: '/categories',
            extraQuery: { includeDeleted: 'true' },
        })
        await list.fetch()
        expect(mockApiGet.mock.calls[0][1]).toMatchObject({ includeDeleted: 'true' })
    })
    it('valeurs nulles/vides des filtres ne sont pas envoyees', async () => {
        mockResponse([], 0)
        const list = usePaginatedList<unknown, { name?: string; q?: string }>({
            url: '/users',
            defaultFilters: { name: '', q: undefined } as never,
        })
        await list.fetch()
        const q = mockApiGet.mock.calls[0][1] as Record<string, unknown>
        expect(q.name).toBeUndefined()
        expect(q.q).toBeUndefined()
    })
    it('refresh() est un alias de fetch()', async () => {
        mockResponse([{ id: 1 }], 1)
        const list = usePaginatedList<{ id: number }>({ url: '/users' })
        await list.refresh()
        expect(list.items.value).toEqual([{ id: 1 }])
    })
 })
@@ -1,60 +0,0 @@
 // STUB ERP-63 — remplacé par l'implémentation BAN d'ERP-66.
 //
 // Ce fichier appartient fonctionnellement à ERP-66 (#66). ERP-63 n'en livre
 // qu'un STUB pour ne pas se bloquer : la vraie implémentation (appels
 // api-adresse.data.gouv.fr) viendra remplacer le CORPS des deux méthodes SANS
 // changer leur signature ni l'usage côté composant.
 //
 // Contrat figé par ERP-66 (c'est lui qui fait foi) :
 //   searchCity(postalCode)       -> liste { city, postalCode }
 //   searchAddress(query, cp?)    -> liste { label, street, postalCode, city }
 //   En cas d'erreur/timeout, la méthode THROW. Le composant catch l'erreur,
 //   affiche un toast d'avertissement et bascule en saisie libre (MalioInputText).
 //
 // Comportement du stub : les deux méthodes throw systématiquement → l'onglet
 // Adresse part directement en mode dégradé (Ville + Adresse en saisie libre,
 // Code postal saisi manuellement). Aucun appel réseau n'est émis ici.
 /** Une suggestion de ville renvoyée à partir d'un code postal. */
 export interface CitySuggestion {
    city: string
    postalCode: string
 }
 /** Une suggestion d'adresse complète (saisie assistée du champ « Adresse »). */
 export interface AddressSuggestion {
    label: string
    street: string
    postalCode: string
    city: string
 }
 export interface AddressAutocomplete {
    searchCity(postalCode: string): Promise<CitySuggestion[]>
    searchAddress(query: string, postalCode?: string): Promise<AddressSuggestion[]>
 }
 /** Erreur signalant que le service d'autocomplétion BAN n'est pas disponible. */
 export class AddressAutocompleteUnavailableError extends Error {
    constructor() {
        // Message technique (non affiché tel quel) : le composant remonte son
        // propre libellé i18n. Sert au debug / aux logs uniquement.
        super('Address autocomplete (BAN) is not available yet — ERP-66 stub.')
        this.name = 'AddressAutocompleteUnavailableError'
    }
 }
 /**
 * STUB : renvoie un composable conforme au contrat ERP-66 dont les méthodes
 * échouent toujours, forçant le mode dégradé côté onglet Adresse.
 */
 export function useAddressAutocomplete(): AddressAutocomplete {
    return {
        async searchCity(_postalCode: string): Promise<CitySuggestion[]> {
            throw new AddressAutocompleteUnavailableError()
        },
        async searchAddress(_query: string, _postalCode?: string): Promise<AddressSuggestion[]> {
            throw new AddressAutocompleteUnavailableError()
        },
    }
 }
@@ -1,364 +0,0 @@
 import { computed, ref, type Ref } from 'vue'
 import type { HydraCollection } from '~/shared/utils/api'
 /**
 * Composable generique de liste paginee serveur.
 *
 * Responsabilites :
 *  - centraliser l'etat tableau (page courante, items/page, tri, filtres,
 *    totalItems, items, loading, error) cote local — JAMAIS dans l'URL,
 *    conformement a la regle ABSOLUE n°6 du CLAUDE.md (« Jamais persister
 *    l'etat de tableau dans l'URL »).
 *  - dialoguer avec une ressource API Platform 4 (Hydra) en passant
 *    `page`, `itemsPerPage` et le tri/filtres en query params.
 *  - exposer une API simple a brancher sur `MalioDataTable`
 *    (props page/perPage/totalItems + events update:page / update:per-page).
 *
 * Volontairement **par-instance** (state local a chaque appel) : a la
 * difference de `useAuditLog` / `useCategoriesAdmin` qui sont des
 * singletons module-level partages, une liste paginee est propre a son
 * ecran et ne doit pas etre partagee entre pages (sinon un retour
 * arriere reprendrait la pagination d'une autre liste).
 *
 * Pas de gestion URL : si une page veut un deep link (ex : ouvrir un
 * detail), elle le fait via sa propre route, pas via la query string
 * de pagination. Derogation possible uniquement si l'utilisateur le
 * demande explicitement, cf. CLAUDE.md.
 */
 /**
 * Direction de tri serveur. API Platform 4 attend `asc` ou `desc` via la
 * syntaxe `?order[field]=asc`.
 */
 export type SortDirection = 'asc' | 'desc'
 /**
 * Specification de tri : un seul champ trie a la fois cote front (la
 * majorite des tableaux Malio n'expose pas le multi-tri). Si null, aucun
 * `order[...]` n'est envoye et l'API applique son tri par defaut.
 */
 export interface SortSpec {
    field: string
    direction: SortDirection
 }
 /**
 * Type des filtres : un dictionnaire de valeurs serialisables en query
 * params. Le caller decide du mapping (ex : `{ active: true }`,
 * `{ 'name[ilike]': 'a' }`). Valeurs `null` / `undefined` / chaines vides
 * sont automatiquement omises au moment de la requete.
 */
 export type PaginatedListFilters = Record<string, string | number | boolean | string[] | null | undefined>
 export interface UsePaginatedListOptions<F extends PaginatedListFilters = PaginatedListFilters> {
    /** URL relative au prefix `/api` (ex : `/sites`, `/categories`). */
    url: string
    /** Items par page initial. Defaut 10 (aligne avec le defaut serveur). */
    defaultItemsPerPage?: number
    /** Options proposees dans le selecteur items/page. Defaut [10, 25, 50]. */
    itemsPerPageOptions?: number[]
    /** Filtres initiaux. */
    defaultFilters?: F
    /** Tri initial. */
    defaultSort?: SortSpec | null
    /**
     * Query params additionnels propres a la ressource (ex : `includeDeleted=true`,
     * `groups[]=foo`) injectes a chaque requete. **Snapshot statique** : l'objet
     * est lu tel quel a chaque `fetch()`, ses valeurs ne sont pas deballees. Ne
     * pas y passer de `ref` / `computed` (elles seraient serialisees comme objet,
     * pas comme valeur) — pour un extra reactif, muter les filtres via
     * `setFilters` ou ouvrir un ticket pour un support `MaybeRefOrGetter`.
     */
    extraQuery?: Record<string, unknown>
 }
 export interface UsePaginatedListReturn<T, F extends PaginatedListFilters = PaginatedListFilters> {
    /** Items de la page courante. */
    items: Ref<T[]>
    /** Total d'items (toutes pages) renvoye par Hydra. */
    totalItems: Ref<number>
    /** Page courante (1-based). */
    currentPage: Ref<number>
    /** Taille de page courante. */
    itemsPerPage: Ref<number>
    /** Options exposees au selecteur items/page. */
    itemsPerPageOptions: Ref<number[]>
    /** Nombre total de pages (≥ 1). */
    totalPages: Ref<number>
    /** Indicateur de chargement (vrai pendant `fetch()`). */
    loading: Ref<boolean>
    /**
     * Derniere erreur de `fetch()` (null si le dernier appel a abouti).
     * Permet a la page de distinguer « liste reellement vide » d'un echec
     * reseau / 403 : sans ca, `isEmpty` confond les deux cas (la liste
     * tombe a 0 item dans les deux situations). La page decide de l'UX
     * (bandeau, bouton reessayer) — le composable ne toaste pas.
     */
    error: Ref<unknown | null>
    /** Vrai apres au moins un fetch reussi avec 0 item. */
    isEmpty: Ref<boolean>
    /** Vrai si la collection tient en une seule page (totalPages <= 1). */
    isSinglePage: Ref<boolean>
    /** Filtres courants (mutation via `setFilters`). */
    filters: Ref<F>
    /** Tri courant (mutation via `setSort`). */
    sort: Ref<SortSpec | null>
    /** Lance un fetch contre l'API et met a jour items/totalItems. */
    fetch: () => Promise<void>
    /** Va a la page demandee (bornes appliquees : 1 ≤ p ≤ totalPages). */
    goToPage: (page: number) => Promise<void>
    /** Page suivante (no-op si deja en derniere page). */
    nextPage: () => Promise<void>
    /** Page precedente (no-op si deja en premiere page). */
    prevPage: () => Promise<void>
    /** Change la taille de page et revient en page 1. */
    setItemsPerPage: (value: number) => Promise<void>
    /** Applique de nouveaux filtres et revient en page 1. */
    setFilters: (next: Partial<F>, options?: { replace?: boolean }) => Promise<void>
    /** Change le tri et revient en page 1. */
    setSort: (next: SortSpec | null) => Promise<void>
    /** Reinitialise filtres + tri + page sur les valeurs par defaut. */
    reset: () => Promise<void>
    /** Alias de `fetch()` (intention plus claire dans certains contextes). */
    refresh: () => Promise<void>
 }
 /**
 * Force `application/ld+json` : sous `application/json`, API Platform 4
 * renvoie un tableau plat sans envelope de pagination — on ne pourrait pas
 * lire `totalItems` ni `view`. Voir aussi `useAuditLog.ts`.
 */
 const JSONLD_HEADERS = { Accept: 'application/ld+json' } as const
 /**
 * Filtre les entrees nulles/undefined/vides d'un objet de query : evite
 * d'envoyer `?foo=&bar=null` a l'API qui declencherait parfois des erreurs
 * de filtre cote Symfony (`FilterInterface::apply` strict).
 */
 function compactQuery(raw: Record<string, unknown>): Record<string, unknown> {
    const out: Record<string, unknown> = {}
    for (const [key, value] of Object.entries(raw)) {
        if (value === null || value === undefined) continue
        if (typeof value === 'string' && value === '') continue
        if (Array.isArray(value) && value.length === 0) continue
        out[key] = value
    }
    return out
 }
 export function usePaginatedList<T, F extends PaginatedListFilters = PaginatedListFilters>(
    options: UsePaginatedListOptions<F>,
 ): UsePaginatedListReturn<T, F> {
    const api = useApi()
    const defaultItemsPerPage = options.defaultItemsPerPage ?? 10
    const initialFilters = { ...(options.defaultFilters ?? ({} as F)) } as F
    const initialSort = options.defaultSort ?? null
    const items = ref<T[]>([]) as Ref<T[]>
    const totalItems = ref(0)
    const currentPage = ref(1)
    const itemsPerPage = ref(defaultItemsPerPage)
    const itemsPerPageOptions = ref(options.itemsPerPageOptions ?? [10, 25, 50])
    const loading = ref(false)
    const error = ref<unknown | null>(null)
    // Jeton de sequence : incremente a chaque `fetch()`. Une reponse dont
    // le jeton n'est plus le dernier est ignoree (protection contre les
    // reponses periemes quand l'utilisateur enchaine page / tri / filtres
    // plus vite que le reseau ne repond — sinon la derniere reponse
    // *arrivee* gagnerait au lieu de la derniere *demandee*).
    let fetchToken = 0
    // `hasFetched` evite que `isEmpty` retourne `true` avant le premier
    // chargement (etat initial = 0 items mais on ne sait pas encore si la
    // ressource est vide ou en cours de chargement). Un appel reseau au
    // moins doit avoir abouti pour qu'on annonce une liste « vide ».
    const hasFetched = ref(false)
    const filters = ref({ ...initialFilters }) as Ref<F>
    const sort = ref<SortSpec | null>(initialSort ? { ...initialSort } : null)
    const totalPages = computed(() => {
        if (totalItems.value <= 0 || itemsPerPage.value <= 0) return 1
        return Math.max(1, Math.ceil(totalItems.value / itemsPerPage.value))
    })
    const isEmpty = computed(() => hasFetched.value && totalItems.value === 0)
    const isSinglePage = computed(() => totalPages.value <= 1)
    /**
     * Construit l'objet query envoye a l'API : extras + filtres, puis
     * pagination + tri. Les cles reservees (`page`, `itemsPerPage`,
     * `order[...]`) sont assignees **en dernier** pour qu'un filtre ou un
     * extra portant le meme nom ne puisse pas ecraser silencieusement la
     * pagination. Les filtres `null`/`undefined`/'' sont elimines pour ne
     * pas polluer l'URL.
     */
    function buildQuery(): Record<string, unknown> {
        const query: Record<string, unknown> = {}
        if (options.extraQuery) {
            Object.assign(query, options.extraQuery)
        }
        Object.assign(query, filters.value)
        // Cles reservees en dernier : priorite a la pagination/au tri.
        query.page = currentPage.value
        query.itemsPerPage = itemsPerPage.value
        if (sort.value) {
            // Format API Platform : ?order[field]=asc
            query[`order[${sort.value.field}]`] = sort.value.direction
        }
        return compactQuery(query)
    }
    /**
     * Lance un fetch et applique la borne haute si necessaire. Si la page
     * courante depasse `totalPages` apres l'application des filtres (cas
     * « j'etais en page 5, je filtre, il ne reste qu'une page »), on
     * rappelle l'API sur la derniere page valide. Un seul niveau de retry
     * pour eviter une boucle si l'API renvoie des resultats incoherents.
     */
    async function fetch(): Promise<void> {
        const token = ++fetchToken
        loading.value = true
        error.value = null
        try {
            const data = await api.get<HydraCollection<T>>(
                options.url,
                buildQuery(),
                { toast: false, headers: JSONLD_HEADERS },
            )
            // Une requete plus recente a ete lancee entre-temps : on jette
            // cette reponse pour ne pas ecraser des donnees plus fraiches.
            if (token !== fetchToken) return
            items.value = data.member ?? []
            totalItems.value = data.totalItems ?? 0
            const tp = totalItems.value > 0
                ? Math.max(1, Math.ceil(totalItems.value / itemsPerPage.value))
                : 1
            // Si on est hors borne ET qu'il y a au moins une page valide
            // a viser, on retombe sur la derniere page (cf. cas limite
            // « page hors borne apres filtre » de la spec #73). On ne
            // refetch que si la nouvelle page est differente, sinon
            // boucle infinie potentielle.
            if (currentPage.value > tp && tp >= 1 && totalItems.value > 0) {
                currentPage.value = tp
                const data2 = await api.get<HydraCollection<T>>(
                    options.url,
                    buildQuery(),
                    { toast: false, headers: JSONLD_HEADERS },
                )
                // Meme garde apres le refetch hors-borne.
                if (token !== fetchToken) return
                items.value = data2.member ?? []
                totalItems.value = data2.totalItems ?? 0
            }
            hasFetched.value = true
        } catch (e) {
            // Reponse periemee : ne pas toucher au state, une requete plus
            // recente est en cours et fera foi.
            if (token !== fetchToken) return
            // Swallow volontaire : on remet la liste a vide pour ne pas
            // afficher de donnees stale, et on expose l'erreur pour que la
            // page distingue « vide » d'« echec ». Le composant parent
            // decide de l'UX (toast / message d'erreur) — pas d'a-priori ici.
            error.value = e
            items.value = []
            totalItems.value = 0
            hasFetched.value = true
        } finally {
            // Seule la requete la plus recente eteint le spinner : une
            // reponse periemee ne doit pas le couper alors qu'un fetch plus
            // recent est encore en vol.
            if (token === fetchToken) loading.value = false
        }
    }
    async function goToPage(page: number): Promise<void> {
        const tp = totalPages.value
        const next = Math.max(1, Math.min(page, tp))
        if (next === currentPage.value) return
        currentPage.value = next
        await fetch()
    }
    async function nextPage(): Promise<void> {
        if (currentPage.value >= totalPages.value) return
        await goToPage(currentPage.value + 1)
    }
    async function prevPage(): Promise<void> {
        if (currentPage.value <= 1) return
        await goToPage(currentPage.value - 1)
    }
    async function setItemsPerPage(value: number): Promise<void> {
        if (!Number.isFinite(value) || value <= 0) return
        const rounded = Math.floor(value)
        if (rounded === itemsPerPage.value) return
        itemsPerPage.value = rounded
        currentPage.value = 1
        await fetch()
    }
    /**
     * `replace: false` (defaut) fusionne avec les filtres courants. Une
     * valeur explicitement `undefined` retire la cle (utile pour effacer
     * un filtre depuis un champ controle). `replace: true` remplace
     * integralement l'objet par `next`.
     */
    async function setFilters(next: Partial<F>, opts?: { replace?: boolean }): Promise<void> {
        if (opts?.replace) {
            filters.value = { ...(next as F) }
        } else {
            const merged = { ...filters.value, ...next } as F
            // Supprime les cles explicitement passees a undefined : sans ce
            // nettoyage, l'objet `filters` accumulerait des cles fantomes.
            for (const key of Object.keys(next)) {
                if (next[key as keyof F] === undefined) {
                    delete (merged as Record<string, unknown>)[key]
                }
            }
            filters.value = merged
        }
        currentPage.value = 1
        await fetch()
    }
    async function setSort(next: SortSpec | null): Promise<void> {
        sort.value = next ? { ...next } : null
        currentPage.value = 1
        await fetch()
    }
    async function reset(): Promise<void> {
        filters.value = { ...initialFilters }
        sort.value = initialSort ? { ...initialSort } : null
        itemsPerPage.value = defaultItemsPerPage
        currentPage.value = 1
        await fetch()
    }
    return {
        items,
        totalItems,
        currentPage,
        itemsPerPage,
        itemsPerPageOptions,
        totalPages,
        loading,
        error,
        isEmpty,
        isSinglePage,
        filters,
        sort,
        fetch,
        goToPage,
        nextPage,
        prevPage,
        setItemsPerPage,
        setFilters,
        setSort,
        reset,
        refresh: fetch,
    }
 }
@@ -1,23 +0,0 @@
 import { describe, it, expect } from 'vitest'
 import { formatPhoneFR } from '../phone'
 describe('formatPhoneFR', () => {
    it('formate un numero 10 chiffres en XX XX XX XX XX', () => {
        expect(formatPhoneFR('0612345678')).toBe('06 12 34 56 78')
    })
    it('tolere une saisie deja pointee ou espacee', () => {
        expect(formatPhoneFR('06.12.34.56.78')).toBe('06 12 34 56 78')
        expect(formatPhoneFR('06 12 34 56 78')).toBe('06 12 34 56 78')
    })
    it('retourne une chaine vide pour une valeur vide ou nulle', () => {
        expect(formatPhoneFR('')).toBe('')
        expect(formatPhoneFR(null)).toBe('')
        expect(formatPhoneFR(undefined)).toBe('')
    })
    it('groupe par 2 meme un nombre impair de chiffres (dernier groupe seul)', () => {
        expect(formatPhoneFR('123')).toBe('12 3')
    })
 })
@@ -1,23 +0,0 @@
 /**
 * Formatage d'un numero de telephone francais en groupes de 2 chiffres
 * (`XX XX XX XX XX`).
 *
 * Helper PARTAGE volontaire : les telephones sont presents un peu partout dans
 * l'app (fiches clients, contacts, fournisseurs, prestataires...). Introduit ici
 * comme util transverse stable plutot que duplique a chaque ecran. La signature
 * `formatPhoneFR(value): string` est coordonnee avec ERP-66, qui pourra enrichir
 * l'implementation (validation, indicatif international) sans casser les appelants.
 *
 * - Ne garde que les chiffres puis groupe par 2 (tolere une saisie deja espacee
 *   ou pointee, ex: `06.12.34.56.78` ou `0612345678`).
 * - Retourne une chaine vide si la valeur est vide/nulle (cellule vide propre).
 */
 export function formatPhoneFR(value: string | null | undefined): string {
    const digits = (value ?? '').replace(/\D/g, '')
    if (digits.length === 0) {
        return ''
    }
    // Groupe par paquets de 2 ; un dernier groupe impair reste tel quel.
    return digits.match(/.{1,2}/g)?.join(' ') ?? digits
 }
@@ -198,18 +198,13 @@ migration-migrate:
 #     doctrine:fixtures:load essaie de DELETE toutes les tables connues
 #     via les mappings — si fake_site_aware_entity est mappe mais absent
 #     en DB, le purger crash.
-#  3. fixtures -> sync-permissions -> seed-rbac : fixtures:load purge la table
+#  3. fixtures -> sync-permissions : fixtures:load purge la table permission,
-#     permission, donc sync doit passer apres. seed-rbac (matrice RBAC § 2.7)
+#     donc sync doit passer apres.
 #     passe ensuite, car attachMatrix() exige les permissions en base. Les
 #     comptes demo sont crees par RbacDemoFixtures au load (sans la matrice,
 #     attachee ici). Cf. ERP-74.
 #  4. recreation des index partiels uniques : schema:update drop les index
 #     orphelins du mapping ORM. Les index partiels (LOWER + WHERE) ne sont pas
 #     exprimables via les attributs Doctrine ORM (fonctionnel + partiel), donc
 #     ils disparaissent apres schema:update. On les recree par dbal:run-sql :
 #       - `uq_category_name_type_active` (M0 Catalog) : tests RG-1.07.
 #       - `uq_category_code` (Catalog ERP-78) : unicite du code categorie parmi
 #         les actifs (slug du nom), pilote RG-1.03/1.29.
 #       - `uq_client_company_name_active` (M1 Commercial) : unicite nom societe
 #         parmi actifs non archives/non supprimes (RG-1.16), tests ERP-55.
 #     Sans ces restores, les POST doublons remontent 201 au lieu de 409.
@@ -225,9 +220,7 @@ test-db-setup:
 	$(SYMFONY_CONSOLE) --env=test --no-interaction app:apply-column-comments
 	$(SYMFONY_CONSOLE) --env=test --no-interaction doctrine:fixtures:load
 	$(SYMFONY_CONSOLE) --env=test --no-interaction app:sync-permissions
 	$(SYMFONY_CONSOLE) --env=test --no-interaction app:seed-rbac
 	$(SYMFONY_CONSOLE) --env=test dbal:run-sql "CREATE UNIQUE INDEX IF NOT EXISTS uq_category_name_type_active ON category (LOWER(name), category_type_id) WHERE deleted_at IS NULL"
 	$(SYMFONY_CONSOLE) --env=test dbal:run-sql "CREATE UNIQUE INDEX IF NOT EXISTS uq_category_code ON category (code) WHERE deleted_at IS NULL"
 	$(SYMFONY_CONSOLE) --env=test dbal:run-sql "CREATE UNIQUE INDEX IF NOT EXISTS uq_client_company_name_active ON client (LOWER(company_name)) WHERE is_archived = FALSE AND deleted_at IS NULL"
 fixtures:
@@ -238,15 +231,6 @@ fixtures:
 sync-permissions:
 	$(SYMFONY_CONSOLE) --no-interaction app:sync-permissions
 # Seed RBAC metier : roles (bureau/compta/commerciale/usine) + matrice § 2.7
 # (+ comptes demo en dev). Idempotent et NON destructif. A lancer APRES
 # sync-permissions (attachMatrix exige les permissions en base). Les comptes
 # demo dev sont deja crees par RbacDemoFixtures (make fixtures) ; ici on attache
 # la matrice (les permissions etaient purgees au moment du load fixtures).
 # En recette/prod, c'est cette commande (avec/sans --with-demo-users) qui seede.
 seed-rbac:
 	$(SYMFONY_CONSOLE) --no-interaction app:seed-rbac
 # Attention, supprime votre bdd local
 db-reset:
 	$(DOCKER_COMPOSE) down -v
@@ -256,7 +240,6 @@ db-reset:
 	$(MAKE) migration-migrate
 	$(MAKE) fixtures
 	$(MAKE) sync-permissions
 	$(MAKE) seed-rbac
 	$(MAKE) test-db-setup
 # Restart la bdd
@@ -39,40 +39,20 @@ final class Version20260528120000 extends AbstractMigration
    public function up(Schema $schema): void
    {
-        // Ne commente que les tables ET colonnes deja presentes a ce stade de la
+        // Ne commente que les tables deja presentes a ce stade de la chaine de
-        // chaine de migrations. Les tables des modules crees plus tard (M1
+        // migrations. Les modules crees plus tard (ex: M1 Commercial, 06-01)
-        // Commercial, 06-01) ET les colonnes ajoutees ensuite sur une table
+        // figurent desormais dans le catalogue partage mais leurs tables
-        // existante (ex: category.code, ERP-78 06-02) figurent desormais dans le
+        // n'existent pas encore ici : elles posent leurs propres COMMENT dans
-        // catalogue partage mais n'existent pas encore ici : elles posent leur
+        // leur migration dediee (regle ABSOLUE n°12). Garde-fou indispensable,
-        // propre COMMENT dans leur migration dediee (regle ABSOLUE n°12). Garde-fou
+        // sinon l'ajout d'un module au catalogue casse ce retrofit avec un
-        // indispensable (table + colonne), sinon enrichir le catalogue casse ce
+        // "relation X does not exist".
-        // retrofit avec un "relation/column X does not exist".
+        $existingTables = array_values(array_filter(
-        foreach (ColumnCommentsCatalog::comments() as $table => $entries) {
+            array_keys(ColumnCommentsCatalog::comments()),
-            if (!$schema->hasTable($table)) {
+            static fn (string $table): bool => $schema->hasTable($table),
-                continue;
+        ));
            }
-            $dbTable     = $schema->getTable($table);
+        foreach (ColumnCommentsCatalog::toSqlStatements($existingTables) as $sql) {
-            $quotedTable = '"'.str_replace('"', '""', $table).'"';
+            $this->addSql($sql);
            foreach ($entries as $column => $description) {
                if ('_table' === $column) {
                    $this->addSql(sprintf('COMMENT ON TABLE %s IS $_$%s$_$', $quotedTable, $description));
                    continue;
                }
                if (!$dbTable->hasColumn($column)) {
                    continue;
                }
                $this->addSql(sprintf(
                    'COMMENT ON COLUMN %s.%s IS $_$%s$_$',
                    $quotedTable,
                    '"'.str_replace('"', '""', $column).'"',
                    $description,
                ));
            }
        }
    }
@@ -84,18 +84,10 @@ final class Version20260601000000 extends AbstractMigration
        $this->addSql('DROP TABLE payment_delay');
        $this->addSql('DROP TABLE tva_mode');
-        // Retire uniquement les 4 types seedes par cette migration ET restes
+        // Retire uniquement les 4 types seedes par cette migration. Les autres
-        // orphelins (aucune `category` ne les reference). Sans la clause
+        // types eventuels (CRUD futur) sont preserves.
        // NOT EXISTS, le DELETE casse sur la FK RESTRICT category.category_type_id
        // des qu'une categorie pointe sur l'un d'eux. Symetrique du
        // `ON CONFLICT (code) DO NOTHING` du up() : on ne defait que ce qu'on a
        // reellement cree et qui n'est pas reutilise.
        $this->addSql(<<<'SQL'
-            DELETE FROM category_type
+            DELETE FROM category_type WHERE code IN ('DISTRIBUTEUR', 'COURTIER', 'SECTEUR', 'AUTRE')
            WHERE code IN ('DISTRIBUTEUR', 'COURTIER', 'SECTEUR', 'AUTRE')
              AND NOT EXISTS (
                  SELECT 1 FROM category c WHERE c.category_type_id = category_type.id
              )
            SQL);
    }
@@ -228,14 +220,6 @@ final class Version20260601000000 extends AbstractMigration
        $this->addSql('CREATE INDEX idx_client_created_by ON client (created_by)');
        $this->addSql('CREATE INDEX idx_client_updated_by ON client (updated_by)');
        // Index sur les FK des referentiels comptables — coherence avec les autres
        // FK deja indexees ci-dessus (Postgres n'indexe pas automatiquement les
        // colonnes portant une FOREIGN KEY).
        $this->addSql('CREATE INDEX idx_client_tva_mode_id ON client (tva_mode_id)');
        $this->addSql('CREATE INDEX idx_client_payment_delay_id ON client (payment_delay_id)');
        $this->addSql('CREATE INDEX idx_client_payment_type_id ON client (payment_type_id)');
        $this->addSql('CREATE INDEX idx_client_bank_id ON client (bank_id)');
        // Unicite metier partielle (Q4) : nom de societe insensible a la casse,
        // parmi les non-archives ET non soft-deletes uniquement. Pas d'index
        // unique sur siren ni email.
@@ -1,189 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace DoctrineMigrations;
 use App\Shared\Infrastructure\Database\CategoryCodeSql;
 use Doctrine\DBAL\Schema\Schema;
 use Doctrine\Migrations\AbstractMigration;
 /**
 * ERP-78 — Refonte de la taxonomie Categories (M0/M1).
 *
 * Modele AVANT (merge via Version20260527164000 + Version20260601000000) :
 * DISTRIBUTEUR / COURTIER / SECTEUR / AUTRE sont des `category_type`.
 *
 * Modele APRES (decision produit 01/06) :
 *  - UN SEUL `category_type` : CLIENT (code CLIENT, label « Client ») ;
 *  - Distributeur / Courtier / Secteur / Autre (+ categories metier fines)
 *    deviennent des `Category` rattachees au type CLIENT ;
 *  - filtrage metier sur un `code` stable porte par la `Category` (et non plus
 *    par le type) : on reporte les codes DISTRIBUTEUR / COURTIER sur la categorie
 *    correspondante. RG-1.03 (distributor/broker) et RG-1.29 (categorie interdite
 *    sur adresse) s'appuient desormais sur `category.code`.
 *
 * Migration CORRECTIVE et NOUVELLE : la migration mergee Version20260601000000
 * (qui a pu tourner en CI / chez d'autres devs) n'est PAS editee.
 *
 * Namespace racine `DoctrineMigrations` (regle ABSOLUE n°11) et NON modulaire
 * Catalog : avec plusieurs migrations_paths, Doctrine Migrations 3.x trie par
 * FQCN alphabetique (AlphabeticalComparator). Introduire la 1re migration
 * modulaire `App\Module\Catalog\...` la ferait trier AVANT toutes les
 * `DoctrineMigrations\...` sur base vide -> elle s'executerait avant la creation
 * des tables et le seed dont elle depend. Le namespace racine garantit l'ordre
 * par timestamp.
 *
 * Idempotence : `ADD COLUMN IF NOT EXISTS`, `INSERT ... ON CONFLICT` / guards
 * `NOT EXISTS`, `CREATE UNIQUE INDEX IF NOT EXISTS`. En prod la table `category`
 * est vide (aucune fixture metier) : l'ajout de `code NOT NULL` est sur. En
 * dev/test, le purger Doctrine vide `category`/`category_type` avant les
 * fixtures, qui reproduisent le meme etat final (cf. CategoryTypeFixtures /
 * CategoryFixtures).
 */
 final class Version20260602100000 extends AbstractMigration
 {
    /**
     * Categories systeme reportees depuis les anciens types : nom => code.
     * Le code est la cle metier stable (RG-1.03 / RG-1.29).
     */
    private const array SYSTEM_CATEGORIES = [
        'Distributeur' => 'DISTRIBUTEUR',
        'Courtier'     => 'COURTIER',
        'Secteur'      => 'SECTEUR',
        'Autre'        => 'AUTRE',
    ];
    /** Anciens codes de `category_type` devenus inutiles. */
    private const array LEGACY_TYPE_CODES = ['DISTRIBUTEUR', 'COURTIER', 'SECTEUR', 'AUTRE'];
    public function getDescription(): string
    {
        return 'ERP-78 : Category.code + type unique CLIENT (categories Distributeur/Courtier/Secteur/Autre codees, anciens types supprimes).';
    }
    public function up(Schema $schema): void
    {
        // 1. Colonne `code` (nullable d'abord pour pouvoir backfiller, NOT NULL ensuite).
        $this->addSql('ALTER TABLE category ADD COLUMN IF NOT EXISTS code VARCHAR(50) DEFAULT NULL');
        // 2. Type unique CLIENT (idempotent via l'index unique uq_category_type_code).
        $this->addSql(<<<'SQL'
            INSERT INTO category_type (code, label) VALUES ('CLIENT', 'Client')
            ON CONFLICT (code) DO NOTHING
            SQL);
        // 3. Re-pointer toute categorie pre-existante (rattachee a un ancien type)
        //    vers le type CLIENT, en lui donnant un code derive du nom si absent.
        //    En prod la table est vide -> no-op ; defensif pour les envs qui
        //    auraient deja seede des categories sous les anciens types. Le slug
        //    SQL est le miroir EXACT de CategoryCodeGenerator::slugify (cf.
        //    CategoryCodeSql + CategoryCodeSqlSlugTest) : un nom accentue produit
        //    le meme code que la generation applicative (« Independant » ->
        //    INDEPENDANT, et non IND_PENDANT).
        $this->addSql(
            'UPDATE category c '
            ."SET category_type_id = (SELECT id FROM category_type WHERE code = 'CLIENT'), "
            .'code = COALESCE(c.code, '.CategoryCodeSql::slugExpression('c.name').') '
            .'WHERE c.category_type_id IN (SELECT id FROM category_type WHERE code IN (:legacyCodes))',
            ['legacyCodes' => self::LEGACY_TYPE_CODES],
            ['legacyCodes' => \Doctrine\DBAL\ArrayParameterType::STRING],
        );
        // 4. Creer les 4 categories systeme sous CLIENT (si leur code est libre
        //    parmi les actifs). created_at/updated_at NOT NULL -> now() ; le blame
        //    reste null (seed hors contexte HTTP, libelle « Systeme » cote front).
        foreach (self::SYSTEM_CATEGORIES as $name => $code) {
            $this->addSql(<<<'SQL'
                INSERT INTO category (name, code, category_type_id, created_at, updated_at)
                SELECT :name, :code, ct.id, NOW(), NOW()
                FROM category_type ct
                WHERE ct.code = 'CLIENT'
                  AND NOT EXISTS (
                      SELECT 1 FROM category c WHERE c.code = :code AND c.deleted_at IS NULL
                  )
                SQL, ['name' => $name, 'code' => $code]);
        }
        // 5. Backfill defensif : toute categorie encore sans code recoit un slug
        //    de son nom (garantit que le SET NOT NULL passe). Meme expression de
        //    slug fidele au generateur applicatif (CategoryCodeSql).
        $this->addSql(
            'UPDATE category SET code = '.CategoryCodeSql::slugExpression('name').' WHERE code IS NULL',
        );
        // 6. Index unique partiel sur le code parmi les actifs (non exprimable en
        //    ORM : recree aussi dans `test-db-setup` apres schema:update).
        $this->addSql('CREATE UNIQUE INDEX IF NOT EXISTS uq_category_code ON category (code) WHERE deleted_at IS NULL');
        // 7. Code desormais obligatoire.
        $this->addSql('ALTER TABLE category ALTER COLUMN code SET NOT NULL');
        // 8. Documentation SQL (regle ABSOLUE n°12). Dollar-quoting Postgres.
        $this->addSql(<<<'SQL'
            COMMENT ON COLUMN category.code IS $_$Code technique stable (slug MAJUSCULE du nom, <= 50) — unique parmi les actifs (uq_category_code). Fige a la creation. DISTRIBUTEUR/COURTIER pilotent RG-1.03/1.29.$_$
            SQL);
        // 9. Supprimer les anciens types devenus orphelins (aucune categorie ne
        //    les reference plus apres le re-pointage de l'etape 3). Le guard
        //    NOT EXISTS evite de casser sur la FK RESTRICT category.category_type_id.
        $this->addSql(<<<'SQL'
            DELETE FROM category_type
            WHERE code IN (:legacyCodes)
              AND NOT EXISTS (
                  SELECT 1 FROM category c WHERE c.category_type_id = category_type.id
              )
            SQL, ['legacyCodes' => self::LEGACY_TYPE_CODES], ['legacyCodes' => \Doctrine\DBAL\ArrayParameterType::STRING]);
        // 10. Realigner la doc SQL de client_address_category (migration mergee
        //     Version20260601000000, non editable) sur le nouveau modele RG-1.29.
        $this->addSql(<<<'SQL'
            COMMENT ON TABLE client_address_category IS $_$Jointure M2M client_address <-> category — codes DISTRIBUTEUR/COURTIER interdits sur une adresse (RG-1.29).$_$
            SQL);
        $this->addSql(<<<'SQL'
            COMMENT ON COLUMN client_address_category.category_id IS $_$FK -> category.id, ON DELETE RESTRICT — categorie d adresse (tout code sauf DISTRIBUTEUR/COURTIER, RG-1.29).$_$
            SQL);
    }
    public function down(Schema $schema): void
    {
        // Best-effort : rollback du modele CLIENT vers les 4 anciens types.
        // 1. Retirer l'index unique sur le code.
        $this->addSql('DROP INDEX IF EXISTS uq_category_code');
        // 2. Recreer les 4 anciens types.
        $this->addSql(<<<'SQL'
            INSERT INTO category_type (code, label) VALUES
                ('DISTRIBUTEUR', 'Distributeur'),
                ('COURTIER',     'Courtier'),
                ('SECTEUR',      'Secteur'),
                ('AUTRE',        'Autre')
            ON CONFLICT (code) DO NOTHING
            SQL);
        // 3. Re-pointer les categories systeme (par code) vers leur type d'origine.
        //    Codes inlines : constantes controlees (self::SYSTEM_CATEGORIES), pas
        //    d'entree utilisateur — evite le binding d'un parametre nomme repete.
        foreach (self::SYSTEM_CATEGORIES as $name => $code) {
            $this->addSql(sprintf(
                "UPDATE category SET category_type_id = (SELECT id FROM category_type WHERE code = '%s') WHERE code = '%s'",
                $code,
                $code,
            ));
        }
        // 4. Supprimer le type CLIENT s'il ne reference plus aucune categorie.
        $this->addSql(<<<'SQL'
            DELETE FROM category_type
            WHERE code = 'CLIENT'
              AND NOT EXISTS (
                  SELECT 1 FROM category c WHERE c.category_type_id = category_type.id
              )
            SQL);
        // 5. Retirer la colonne code (les categories libres sans type d'origine
        //    restent sous CLIENT si encore presentes — rollback uniquement
        //    pertinent en prod ou seules les 4 categories systeme existent).
        $this->addSql('ALTER TABLE category DROP COLUMN IF EXISTS code');
    }
 }
@@ -1,77 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Catalog\Application\Service;
 use App\Module\Catalog\Domain\Repository\CategoryRepositoryInterface;
 use Symfony\Component\String\Slugger\AsciiSlugger;
 /**
 * Genere le code technique stable d'une Category a partir de son nom (ERP-78).
 *
 * Regle (decision produit 02/06) : `code` est obligatoire et auto-genere — un
 * slug MAJUSCULE du nom, sans accent, separateurs non alphanumeriques reduits a
 * `_`, borne a 50 caracteres (longueur colonne). Exemples :
 *  - « Distributeur »      -> DISTRIBUTEUR
 *  - « Agro-alimentaire »  -> AGRO_ALIMENTAIRE
 *  - « Transport/Logistique » -> TRANSPORT_LOGISTIQUE
 *
 * Le code est FIGE a la creation (jamais recalcule sur renommage) afin de rester
 * une cle deterministe stable entre environnements (RG-1.03 / RG-1.29 cote M1).
 *
 * Unicite : l'index partiel `uq_category_code` (WHERE deleted_at IS NULL) impose
 * l'unicite parmi les categories actives. Deux noms distincts peuvent produire
 * le meme slug (« Agro alimentaire » / « Agro-alimentaire ») : on suffixe alors
 * le code par `_2`, `_3`... jusqu'a obtenir un code libre.
 */
 final class CategoryCodeGenerator
 {
    /** Longueur maximale de la colonne `category.code`. */
    private const int MAX_LENGTH = 50;
    private readonly AsciiSlugger $slugger;
    public function __construct(
        private readonly CategoryRepositoryInterface $categoryRepository,
    ) {
        $this->slugger = new AsciiSlugger();
    }
    /**
     * Slug brut (sans garantie d'unicite) — utile pour les seeds deterministes.
     */
    public function slugify(string $name): string
    {
        $slug = $this->slugger->slug($name, '_')->upper()->toString();
        // Borne a la longueur colonne, puis retire un eventuel `_` terminal
        // introduit par la troncature.
        $slug = substr($slug, 0, self::MAX_LENGTH);
        $slug = trim($slug, '_');
        // Garde-fou : un nom uniquement compose de caracteres non alphanumeriques
        // (theorique, le nom est NotBlank + Length>=2) donnerait un slug vide.
        return '' === $slug ? 'CATEGORY' : $slug;
    }
    /**
     * Code unique parmi les categories actives : slug du nom, suffixe `_N` en
     * cas de collision. `$excludeId` ignore la categorie courante (PATCH).
     */
    public function generateUnique(string $name, ?int $excludeId = null): string
    {
        $base      = $this->slugify($name);
        $candidate = $base;
        $suffix    = 2;
        while ($this->categoryRepository->existsActiveByCode($candidate, $excludeId)) {
            $suffixStr = '_'.$suffix;
            // Retronque la base pour que `base + suffixe` tienne dans 50 caracteres.
            $candidate = substr($base, 0, self::MAX_LENGTH - strlen($suffixStr)).$suffixStr;
            ++$suffix;
        }
        return $candidate;
    }
 }
@@ -74,11 +74,10 @@ use Symfony\Component\Validator\Constraints as Assert;
 )]
 #[ORM\Entity(repositoryClass: DoctrineCategoryRepository::class)]
 #[ORM\Table(name: 'category')]
-// Index nommes pour matcher la migration (cf. Role/Permission/Site). Les index
+// Index nommes pour matcher la migration (cf. Role/Permission/Site). L'index
-// uniques partiels `uq_category_name_type_active` (LOWER(name), category_type_id
+// unique partiel `uq_category_name_type_active` (LOWER(name), category_type_id
-// WHERE deleted_at IS NULL) et `uq_category_code` (code WHERE deleted_at IS NULL)
+// WHERE deleted_at IS NULL) reste possede par la seule migration : Doctrine ORM
-// restent possedes par la seule migration : Doctrine ORM ne sait pas exprimer un
+// ne sait pas exprimer un index fonctionnel + partiel via attribut.
 // index partiel via attribut.
 #[ORM\Index(name: 'idx_category_deleted_at', columns: ['deleted_at'])]
 #[ORM\Index(name: 'idx_category_type_id', columns: ['category_type_id'])]
 #[ORM\Index(name: 'idx_category_created_by', columns: ['created_by'])]
@@ -110,16 +109,6 @@ class Category implements TimestampableInterface, BlamableInterface, CategoryInt
    #[Groups(['category:read', 'category:write'])]
    private ?string $name = null;
    // Code technique stable (slug MAJUSCULE du nom) — NOT NULL + unique parmi les
    // actifs (index partiel `uq_category_code` possede par la migration). Genere
    // par le CategoryProcessor a la creation puis fige (jamais recalcule sur
    // renommage) : sert de cle metier deterministe (RG-1.03 / RG-1.29). Lecture
    // seule cote API (hors groupe category:write) : le front filtre dessus mais
    // ne le saisit pas.
    #[ORM\Column(length: 50)]
    #[Groups(['category:read'])]
    private ?string $code = null;
    #[ORM\ManyToOne(targetEntity: CategoryType::class)]
    #[ORM\JoinColumn(name: 'category_type_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')]
    #[Assert\NotNull(message: 'Type de catégorie obligatoire.')]
@@ -152,21 +141,6 @@ class Category implements TimestampableInterface, BlamableInterface, CategoryInt
        return $this;
    }
    /**
     * Implemente CategoryInterface : code technique stable de la categorie.
     */
    public function getCode(): ?string
    {
        return $this->code;
    }
    public function setCode(string $code): static
    {
        $this->code = $code;
        return $this;
    }
    public function getCategoryType(): ?CategoryType
    {
        return $this->categoryType;
@@ -13,13 +13,6 @@ interface CategoryRepositoryInterface
    public function save(Category $category): void;
    /**
     * Vrai si une categorie active (deleted_at IS NULL) porte deja ce code.
     * `$excludeId` exclut une categorie precise du test (cas PATCH). Sert a
     * garantir l'unicite du code generee par le CategoryCodeGenerator (ERP-78).
     */
    public function existsActiveByCode(string $code, ?int $excludeId = null): bool;
    /**
     * Construit un QueryBuilder de liste avec filtre soft-delete et tri par defaut.
     * - $includeDeleted = false : exclut les categories soft-deleted (RG-1.08)
@@ -7,7 +7,6 @@ namespace App\Module\Catalog\Infrastructure\ApiPlatform\State\Processor;
 use ApiPlatform\Metadata\DeleteOperationInterface;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\State\ProcessorInterface;
 use App\Module\Catalog\Application\Service\CategoryCodeGenerator;
 use App\Module\Catalog\Domain\Entity\Category;
 use DateTimeImmutable;
 use Doctrine\DBAL\Exception\UniqueConstraintViolationException;
@@ -17,13 +16,10 @@ use Symfony\Component\HttpKernel\Exception\HttpException;
 /**
 * Processor Category : applique les regles de gestion en ecriture.
 *
- * - POST / PATCH : trim du nom (RG-1.03) ; a la CREATION, generation du `code`
+ * - POST / PATCH : trim du nom (RG-1.03) puis delegation au persist_processor
- *   technique stable (slug MAJUSCULE du nom, unique parmi les actifs — ERP-78)
+ *   Doctrine ORM. Toute UniqueConstraintViolationException remontee par Postgres
- *   via CategoryCodeGenerator ; puis delegation au persist_processor Doctrine
+ *   (collision sur l'index partiel uq_category_name_type_active) est traduite
- *   ORM. Le code est FIGE a la creation (jamais recalcule sur PATCH). Toute
+ *   en HTTP 409 avec le message attendu par la spec (RG-1.07).
 *   UniqueConstraintViolationException remontee par Postgres (collision sur
 *   l'index partiel uq_category_name_type_active) est traduite en HTTP 409 avec
 *   le message attendu par la spec (RG-1.07).
 * - DELETE : soft delete (RG-1.12). On NE delegue PAS au remove_processor ;
 *   on pose deletedAt = now() puis on delegue au persist_processor pour que
 *   le UPDATE Doctrine parte et que le TimestampableBlamableSubscriber mette
@@ -36,7 +32,6 @@ final class CategoryProcessor implements ProcessorInterface
    public function __construct(
        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
        private readonly ProcessorInterface $persistProcessor,
        private readonly CategoryCodeGenerator $codeGenerator,
    ) {}
    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
@@ -67,14 +62,6 @@ final class CategoryProcessor implements ProcessorInterface
            $data->setName(trim($data->getName()));
        }
        // ERP-78 : le code est genere a la CREATION puis fige. On le (re)genere
        // uniquement s'il est absent (POST, ou entite seedee sans code) — un PATCH
        // sur une categorie existante conserve son code. Genere depuis le nom
        // (NotBlank, deja trimme), unique parmi les actifs.
        if (null === $data->getCode() && null !== $data->getName()) {
            $data->setCode($this->codeGenerator->generateUnique($data->getName(), $data->getId()));
        }
        try {
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
        } catch (UniqueConstraintViolationException $e) {
@@ -4,14 +4,11 @@ declare(strict_types=1);
 namespace App\Module\Catalog\Infrastructure\ApiPlatform\State\Provider;
 use ApiPlatform\Doctrine\Orm\Paginator;
 use ApiPlatform\Metadata\CollectionOperationInterface;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\State\Pagination\Pagination;
 use ApiPlatform\State\ProviderInterface;
 use App\Module\Catalog\Domain\Entity\Category;
 use App\Module\Catalog\Domain\Repository\CategoryRepositoryInterface;
 use Doctrine\ORM\Tools\Pagination\Paginator as DoctrinePaginator;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 /**
@@ -32,32 +29,18 @@ final class CategoryProvider implements ProviderInterface
    public function __construct(
        #[Autowire(service: 'App\Module\Catalog\Infrastructure\Doctrine\DoctrineCategoryRepository')]
        private readonly CategoryRepositoryInterface $repository,
        private readonly Pagination $pagination,
    ) {}
-    public function provide(Operation $operation, array $uriVariables = [], array $context = []): Category|iterable|Paginator|null
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): Category|iterable|null
    {
        $includeDeleted = $this->readIncludeDeleted($context);
        if ($operation instanceof CollectionOperationInterface) {
-            $qb = $this->repository->createListQueryBuilder($includeDeleted);
+            return $this->repository
-
+                ->createListQueryBuilder($includeDeleted)
-            // Echappatoire ?pagination=false : retourne la collection complete sans Paginator.
+                ->getQuery()
-            // Utile pour les drawers Role/Permission/Site/CategoryType qui alimentent un <select>.
+                ->getResult()
-            if (!$this->pagination->isEnabled($operation, $context)) {
+            ;
                return $qb->getQuery()->getResult();
            }
            // Branche paginee standard : on applique offset/limit via Pagination,
            // puis on enveloppe dans le Paginator ORM (fetchJoinCollection: true
            // pour que Doctrine compte correctement avec les JOINs futurs).
            $limit  = $this->pagination->getLimit($operation, $context);
            $page   = max(1, $this->pagination->getPage($context));
            $offset = ($page - 1) * $limit;
            $qb->setFirstResult($offset)->setMaxResults($limit);
            return new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: true));
        }
        // Get unitaire : recharger l'entite, puis appliquer le filtre soft-delete.
@@ -1,132 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Catalog\Infrastructure\DataFixtures;
 use App\Module\Catalog\Domain\Entity\Category;
 use App\Module\Catalog\Domain\Entity\CategoryType;
 use App\Module\Catalog\Domain\Repository\CategoryTypeRepositoryInterface;
 use Doctrine\Bundle\FixturesBundle\Fixture;
 use Doctrine\Common\DataFixtures\DependentFixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 use RuntimeException;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 /**
 * Fixtures dev/test du module Catalog : ~11 categories de demonstration, toutes
 * rattachees au type unique CLIENT (refonte taxonomie ERP-78). Chaque categorie
 * porte un `code` stable. Alimente le repertoire clients (ClientFixtures, module
 * Commercial) avec des donnees realistes couvrant RG-1.03 (codes DISTRIBUTEUR /
 * COURTIER) et RG-1.29 (codes interdits sur adresse).
 *
 * Depend de CategoryTypeFixtures : le type CLIENT doit etre seede avant de
 * pouvoir y rattacher des Category.
 *
 * Idempotence : lookup par `code` parmi les categories non supprimees (deletedAt
 * null), coherent avec l'index unique partiel uq_category_code (code WHERE
 * deleted_at IS NULL). Rejouable sans doublon meme si le purger Doctrine est
 * desactive.
 *
 * Audit / Blamable : persist hors contexte HTTP -> created_by / updated_by
 * restent null (« Systeme » cote front), c'est attendu.
 *
 * Portee : DONNEES DE DEMONSTRATION (dev uniquement). En environnement `test`,
 * la fixture ne charge rien : les tests seedent et nettoient leurs propres
 * categories (prefixe dedie) et comptent sur une table `category` vierge — y
 * injecter des categories de demo casserait comptages et cleanups FK
 * (client_category). Cf. ClientFixtures (meme garde-fou).
 */
 class CategoryFixtures extends Fixture implements DependentFixtureInterface
 {
    /** Code du type unique (cf. CategoryTypeFixtures, migration ERP-78). */
    private const string CLIENT_TYPE_CODE = 'CLIENT';
    /**
     * Source unique des categories de demonstration : nom => code stable. Les 4
     * premieres (Distributeur / Courtier / Secteur / Autre) sont les categories
     * « systeme » reportees des anciens types ; leurs codes pilotent les RG.
     *
     * @var array<string, string>
     */
    private const CATEGORIES = [
        'Distributeur'         => 'DISTRIBUTEUR',
        'Courtier'             => 'COURTIER',
        'Secteur'              => 'SECTEUR',
        'Autre'                => 'AUTRE',
        'BTP'                  => 'BTP',
        'Industrie'            => 'INDUSTRIE',
        'Agro-alimentaire'     => 'AGRO_ALIMENTAIRE',
        'Transport/Logistique' => 'TRANSPORT_LOGISTIQUE',
        'Services'             => 'SERVICES',
        'Association'          => 'ASSOCIATION',
        'Indépendant'          => 'INDEPENDANT',
    ];
    public function __construct(
        private readonly CategoryTypeRepositoryInterface $categoryTypeRepository,
        #[Autowire('%kernel.environment%')]
        private readonly string $environment,
    ) {}
    /**
     * @return array<int, class-string>
     */
    public function getDependencies(): array
    {
        return [CategoryTypeFixtures::class];
    }
    public function load(ObjectManager $manager): void
    {
        // Donnees de demo : dev uniquement. En test, on laisse la table vierge.
        if ('test' === $this->environment) {
            return;
        }
        $clientType = null;
        foreach ($this->categoryTypeRepository->findAllOrderedByLabel() as $type) {
            if (self::CLIENT_TYPE_CODE === $type->getCode()) {
                $clientType = $type;
                break;
            }
        }
        if (!$clientType instanceof CategoryType) {
            // Misconfiguration : CategoryTypeFixtures n'a pas tourne avant.
            throw new RuntimeException(
                'CategoryTypeFixtures doit avoir seede le type "CLIENT" avant CategoryFixtures.',
            );
        }
        foreach (self::CATEGORIES as $name => $code) {
            $this->ensureCategory($manager, $name, $code, $clientType);
        }
        $manager->flush();
    }
    /**
     * Cree la categorie (name, code) sous le type CLIENT si son code n'existe pas
     * encore parmi les categories actives, sinon la laisse en place. Lookup
     * aligne sur l'index unique partiel uq_category_code.
     */
    private function ensureCategory(ObjectManager $manager, string $name, string $code, CategoryType $type): void
    {
        $existing = $manager->getRepository(Category::class)->findOneBy([
            'code'      => $code,
            'deletedAt' => null,
        ]);
        if (null !== $existing) {
            return;
        }
        $category = new Category();
        $category->setName($name);
        $category->setCode($code);
        $category->setCategoryType($type);
        $manager->persist($category);
    }
 }
@@ -10,19 +10,17 @@ use Doctrine\Bundle\FixturesBundle\Fixture;
 use Doctrine\Persistence\ObjectManager;
 /**
- * Fixtures du module Catalog : seed du type de categorie (M1).
+ * Fixtures du module Catalog : seed des types de categorie metier (M1).
 *
- * Refonte taxonomie ERP-78 : le modele n'a plus qu'UN SEUL `category_type`,
+ * La table `category_type` est creee vide au M0 ; le M1 la peuple avec les 4
- * CLIENT (code CLIENT, label « Client »). Distributeur / Courtier / Secteur /
+ * types DISTRIBUTEUR / COURTIER / SECTEUR / AUTRE (cf. spec M1 § 3.3).
 * Autre (et les categories metier fines) sont desormais des `Category` codees
 * rattachees a ce type (cf. CategoryFixtures + migration Version20260602100000).
 *
- * Pourquoi une fixture EN PLUS du seed de la migration : `category_type` est une
+ * Pourquoi une fixture EN PLUS du seed de la migration (Version20260601000000) :
- * entite managee par l ORM, donc le purger Doctrine la vide avant chaque
+ * `category_type` est une entite managee par l ORM, donc le purger Doctrine la
- * `doctrine:fixtures:load`. Sans cette fixture, le type CLIENT seede par la
+ * vide avant chaque `doctrine:fixtures:load`. Sans cette fixture, les 4 types
- * migration disparaitrait apres `make db-reset` / setup de test. Le seed
+ * seedes par la migration disparaitraient apres `make db-reset` / setup de test.
- * migration couvre la prod (ou les fixtures ne tournent pas) ; cette fixture
+ * Le seed migration couvre la prod (ou les fixtures ne tournent pas) ; cette
- * re-aligne dev et test. Les deux chemins produisent un etat identique.
+ * fixture re-aligne dev et test. Les deux chemins produisent un etat identique.
 *
 * Idempotence : lookup par `code` parmi les types existants avant insertion,
 * sur le modele d AppFixtures::ensureSystemRole. Rejouable sans doublon meme
@@ -31,11 +29,14 @@ use Doctrine\Persistence\ObjectManager;
 class CategoryTypeFixtures extends Fixture
 {
    /**
-     * Source unique du type : code technique => libelle FR. Doit rester aligne
+     * Source unique des 4 types metier : code technique => libelle FR.
-     * sur le seed de la migration Version20260602100000 (type unique CLIENT).
+     * Doit rester aligne sur le seed de la migration Version20260601000000.
     */
    private const TYPES = [
-        'CLIENT' => 'Client',
+        'DISTRIBUTEUR' => 'Distributeur',
        'COURTIER'     => 'Courtier',
        'SECTEUR'      => 'Secteur',
        'AUTRE'        => 'Autre',
    ];
    public function __construct(
@@ -31,23 +31,6 @@ class DoctrineCategoryRepository extends ServiceEntityRepository implements Cate
        $this->getEntityManager()->flush();
    }
    public function existsActiveByCode(string $code, ?int $excludeId = null): bool
    {
        $qb = $this->createQueryBuilder('c')
            ->select('1')
            ->andWhere('c.code = :code')
            ->andWhere('c.deletedAt IS NULL')
            ->setParameter('code', $code)
            ->setMaxResults(1)
        ;
        if (null !== $excludeId) {
            $qb->andWhere('c.id != :excludeId')->setParameter('excludeId', $excludeId);
        }
        return [] !== $qb->getQuery()->getResult();
    }
    public function createListQueryBuilder(bool $includeDeleted = false): QueryBuilder
    {
        $qb = $this->createQueryBuilder('c')
@@ -10,15 +10,17 @@ use Symfony\Component\Validator\ConstraintViolation;
 use Symfony\Component\Validator\ConstraintViolationList;
 /**
- * Validator metier RG-1.04 (durcie ERP-74) : pour un utilisateur portant le
+ * Validator metier RG-1.04 : pour un utilisateur portant le role metier
- * role metier Commerciale, TOUS les champs de l'onglet Information sont
+ * Commerciale, TOUS les champs de l'onglet Information deviennent obligatoires
- * obligatoires sur POST comme sur tout PATCH, independamment des champs
+ * lors d'un PATCH touchant le groupe `client:write:information`.
 * reellement envoyes.
 *
- * Invoque par le ClientProcessor des que l'utilisateur courant porte le role
+ * Invoque par le ClientProcessor UNIQUEMENT quand les deux conditions sont
- * Commerciale (plus de condition d'intersection avec l'onglet Information).
+ * reunies (role Commerciale + payload touchant l'onglet Information). Pour les
- * Pour les autres roles, ces champs restent optionnels — le validator n'est
+ * autres roles, ces champs restent optionnels — le validator n'est pas appele.
- * pas appele.
+ *
 * Tant qu'aucun user ne porte le role `commerciale` (seede par ERP-74,
 * cf. App\Shared\Domain\Security\BusinessRoles::COMMERCIALE), cette regle reste
 * DORMANTE : aucun appelant ne la declenche.
 *
 * Leve une ValidationException (HTTP 422) listant chaque champ manquant, par
 * coherence avec les violations Symfony rendues par API Platform.
@@ -15,7 +15,6 @@ use App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientRepository;
 use App\Shared\Domain\Attribute\Auditable;
 use App\Shared\Domain\Contract\BlamableInterface;
 use App\Shared\Domain\Contract\CategoryInterface;
 use App\Shared\Domain\Contract\SiteInterface;
 use App\Shared\Domain\Contract\TimestampableInterface;
 use App\Shared\Domain\Trait\TimestampableBlamableTrait;
 use DateTimeImmutable;
@@ -59,57 +58,37 @@ use Symfony\Component\Validator\Constraints as Assert;
    operations: [
        new GetCollection(
            security: "is_granted('commercial.clients.view')",
-            // La liste embarque les categories (avec leur code, groupe
+            normalizationContext: ['groups' => ['client:read', 'default:read']],
            // category:read) et les sites agreges des adresses (groupe
            // site:read) pour alimenter les colonnes « Catégories » et
            // « Site(s) » du Repertoire (ERP-62). Cf. getSites() plus bas.
            normalizationContext: ['groups' => ['client:read', 'default:read', 'category:read', 'site:read']],
            provider: ClientProvider::class,
        ),
        new Get(
            security: "is_granted('commercial.clients.view')",
-            // Detail : client + sous-collections embarquees.
+            // Detail : client + sous-collections embarquees. Le groupe
-            //  - client:read:accounting est ajoute par le context builder selon la
+            // client:read:accounting est ajoute par le context builder selon la
-            //    permission (gate les scalaires comptables ET les RIB embarques),
+            // permission, donc absent ici volontairement.
            //    donc absent ici volontairement.
            //  - client_rib:read N'EST PLUS dans le contexte : le contenu des RIB
            //    embarques est desormais porte par client:read:accounting (gate),
            //    ce qui retire la fuite IBAN/BIC vers les users sans accounting.view.
            //  - category:read et site:read sont indispensables pour embarquer le
            //    code/libelle des categories et des sites (sinon stub IRI nu) :
            //    Category.code/name vivent sous category:read, Site.name sous site:read.
            normalizationContext: ['groups' => [
                'client:read',
                'client:item:read',
                'client_contact:read',
                'client_address:read',
-                'category:read',
+                'client_rib:read',
                'site:read',
                'default:read',
            ]],
            provider: ClientProvider::class,
        ),
        new Post(
            security: "is_granted('commercial.clients.manage')",
-            normalizationContext: ['groups' => ['client:read', 'default:read', 'category:read', 'site:read']],
+            normalizationContext: ['groups' => ['client:read', 'default:read']],
            denormalizationContext: ['groups' => ['client:write:main']],
            processor: ClientProcessor::class,
        ),
        new Patch(
-            // Security elargie (ERP-74) : `manage` OU `accounting.manage`. Le
+            security: "is_granted('commercial.clients.manage')",
            // role Compta n'a pas `manage` mais doit pouvoir editer l'onglet
            // Comptabilite d'un client existant (§ 2.7). Le ClientProcessor
            // re-gate ensuite onglet par onglet :
            //  - champs accounting -> accounting.manage (guardAccounting, RG-1.28) ;
            //  - champs main/information -> manage (guardManage : empeche Compta
            //    d'editer les autres onglets) ;
            //  - isArchived -> archive (guardArchive, RG-1.22).
            security: "is_granted('commercial.clients.manage') or is_granted('commercial.clients.accounting.manage')",
            // Le ClientProcessor inspecte les champs reellement envoyes pour
            // autoriser/refuser onglet par onglet (RG-1.22 / RG-1.28) : les
            // champs accounting exigent accounting.manage, isArchived exige
-            // archive, le reste (main/information) exige manage.
+            // archive.
-            normalizationContext: ['groups' => ['client:read', 'default:read', 'category:read', 'site:read']],
+            normalizationContext: ['groups' => ['client:read', 'default:read']],
            denormalizationContext: ['groups' => [
                'client:write:main',
                'client:write:information',
@@ -664,38 +643,8 @@ class Client implements TimestampableInterface, BlamableInterface
        return $this;
    }
    /**
     * Sites distincts rattaches a au moins une adresse du client (RG-1.10).
     * Le Client ne porte pas de sites en propre : ils vivent sur les adresses.
     * Agrege en lecture seule pour la colonne « Site(s) » du Repertoire (badges
     * colores) — expose en LISTE via le groupe client:read (les adresses
     * completes restent reservees au detail, client:item:read).
     *
     * @return list<SiteInterface>
     */
    #[Groups(['client:read'])]
    public function getSites(): array
    {
        $sites = [];
        foreach ($this->addresses as $address) {
            foreach ($address->getSites() as $site) {
                // Deduplication par identite d'objet : un meme site peut etre
                // rattache a plusieurs adresses du client.
                $sites[spl_object_id($site)] = $site;
            }
        }
        return array_values($sites);
    }
    // Embed gate sur le groupe COMPTABLE (et non client:item:read comme contacts/
    // adresses) : client:read:accounting n'est ajoute au contexte que si l'user a
    // accounting.view (ClientReadGroupContextBuilder). Resultat : la cle `ribs` est
    // TOTALEMENT ABSENTE du detail pour un user sans accounting.view (ex. Commerciale),
    // au meme titre que les scalaires comptables — corrige la fuite de RIB ou la
    // Commerciale recevait IBAN/BIC en clair.
    /** @return Collection<int, ClientRib> */
-    #[Groups(['client:read:accounting'])]
+    #[Groups(['client:item:read'])]
    public function getRibs(): Collection
    {
        return $this->ribs;
@@ -4,13 +4,6 @@ declare(strict_types=1);
 namespace App\Module\Commercial\Domain\Entity;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Delete;
 use ApiPlatform\Metadata\Get;
 use ApiPlatform\Metadata\Link;
 use ApiPlatform\Metadata\Patch;
 use ApiPlatform\Metadata\Post;
 use App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor\ClientAddressProcessor;
 use App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientAddressRepository;
 use App\Shared\Domain\Attribute\Auditable;
 use App\Shared\Domain\Contract\BlamableInterface;
@@ -22,64 +15,24 @@ use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\Common\Collections\Collection;
 use Doctrine\ORM\Mapping as ORM;
 use Symfony\Component\Serializer\Attribute\Groups;
 use Symfony\Component\Serializer\Attribute\SerializedName;
 use Symfony\Component\Validator\Constraints as Assert;
 use Symfony\Component\Validator\Context\ExecutionContextInterface;
 /**
 * Adresse d'un client (1:n) — onglet Adresse. Une adresse de prospection
 * (isProspect) est exclusive d'une adresse de livraison/facturation
- * (RG-1.06/07/08). Un email de facturation est obligatoire ssi isBilling
+ * (RG-1.06/07/08, CHECK BDD). Un email de facturation est obligatoire ssi
- * (RG-1.11). Au moins un site doit etre rattache (RG-1.10, Assert\Count). Ces
+ * isBilling (RG-1.11, CHECK BDD). Au moins un site doit etre rattache
- * regles sont portees par des Assert\Callback (cf. validateProspectExclusivity /
+ * (RG-1.10, Assert\Count).
 * validateBillingEmailPresence, ERP-76) qui remontent une 422 avant la base ;
 * les CHECK Postgres (chk_client_address_prospect_exclusive /
 * chk_client_address_billing_email) restent en filet de securite.
 *
 * Relations M2M :
 *  - sites : SiteInterface (module Sites) via resolve_target_entities
 *  - contacts : ClientContact (meme module)
 *  - categories : CategoryInterface (module Catalog) via resolve_target_entities
- *    — codes DISTRIBUTEUR/COURTIER interdits (RG-1.29, validateCategoryCodes, ERP-78)
+ *    — limitees aux types SECTEUR/AUTRE cote validation (RG-1.29, futur Processor)
 *
- * Audite (#[Auditable]) + Timestampable/Blamable.
+ * Audite (#[Auditable]) + Timestampable/Blamable. Aucun ApiResource au M1.1
- *
+ * (sous-ressources branchees a un ticket dedie).
 * Sous-ressource API (ERP-57, spec § 4.5) :
 *  - POST /api/clients/{clientId}/addresses : creation rattachee au client parent
 *    (Link toProperty 'client'), security commercial.clients.manage.
 *  - PATCH / DELETE /api/client_addresses/{id} : security commercial.clients.manage.
 *  - GET /api/client_addresses/{id} : lecture unitaire (security view) — la
 *    lecture courante reste via le parent. Pas de GET collection autonome.
 * Tout passe par le ClientAddressProcessor (normalisation RG-1.21 billingEmail).
 */
 #[ApiResource(
    operations: [
        new Get(
            security: "is_granted('commercial.clients.view')",
            normalizationContext: ['groups' => ['client_address:read']],
        ),
        new Post(
            uriTemplate: '/clients/{clientId}/addresses',
            uriVariables: [
                'clientId' => new Link(fromClass: Client::class, toProperty: 'client'),
            ],
            security: "is_granted('commercial.clients.manage')",
            normalizationContext: ['groups' => ['client_address:read']],
            denormalizationContext: ['groups' => ['client_address:write']],
            processor: ClientAddressProcessor::class,
        ),
        new Patch(
            security: "is_granted('commercial.clients.manage')",
            normalizationContext: ['groups' => ['client_address:read']],
            denormalizationContext: ['groups' => ['client_address:write']],
            processor: ClientAddressProcessor::class,
        ),
        new Delete(
            security: "is_granted('commercial.clients.manage')",
            processor: ClientAddressProcessor::class,
        ),
    ],
 )]
 #[ORM\Entity(repositoryClass: DoctrineClientAddressRepository::class)]
 #[ORM\Table(name: 'client_address')]
 #[ORM\Index(name: 'idx_client_address_client', columns: ['client_id'])]
@@ -88,13 +41,6 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
 {
    use TimestampableBlamableTrait;
    /**
     * RG-1.29 (ERP-78) : ces codes de categorie decrivent une relation entre
     * clients (distributeur / courtier) et n'ont pas de sens sur une adresse.
     * Toute autre categorie du type CLIENT est autorisee.
     */
    private const array FORBIDDEN_CATEGORY_CODES = ['DISTRIBUTEUR', 'COURTIER'];
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
@@ -105,23 +51,16 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
    #[ORM\JoinColumn(name: 'client_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
    private ?Client $client = null;
    // Groupe d'ECRITURE uniquement sur la propriete (denormalisation PATCH/POST).
    // Le groupe de LECTURE est porte par le getter isProspect()/isDelivery()/
    // isBilling() avec SerializedName : sans cela, Symfony strip le prefixe "is"
    // des getters booleens et exposerait les cles "prospect"/"delivery"/"billing"
    // — en pratique le #[Groups] etant sur la propriete `isX` et le getter
    // derivant l'attribut `x`, la cle etait totalement DROPPEE du JSON (meme bug
    // que Client::isArchived). Pattern corrige : Groups + SerializedName sur le getter.
    #[ORM\Column(name: 'is_prospect', options: ['default' => false])]
-    #[Groups(['client_address:write'])]
+    #[Groups(['client_address:read', 'client_address:write'])]
    private bool $isProspect = false;
    #[ORM\Column(name: 'is_delivery', options: ['default' => false])]
-    #[Groups(['client_address:write'])]
+    #[Groups(['client_address:read', 'client_address:write'])]
    private bool $isDelivery = false;
    #[ORM\Column(name: 'is_billing', options: ['default' => false])]
-    #[Groups(['client_address:write'])]
+    #[Groups(['client_address:read', 'client_address:write'])]
    private bool $isBilling = false;
    #[ORM\Column(length: 80, options: ['default' => 'France'])]
@@ -149,7 +88,7 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
    #[Groups(['client_address:read', 'client_address:write'])]
    private ?string $streetComplement = null;
-    // RG-1.11 : obligatoire ssi isBilling (validateBillingEmailPresence + CHECK BDD).
+    // RG-1.11 : obligatoire ssi isBilling (CHECK BDD + futur Processor).
    #[ORM\Column(length: 180, nullable: true)]
    #[Assert\Email]
    #[Groups(['client_address:read', 'client_address:write'])]
@@ -177,7 +116,7 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
    #[Groups(['client_address:read', 'client_address:write'])]
    private Collection $contacts;
-    // RG-1.29 : categories de code DISTRIBUTEUR/COURTIER interdites (validateCategoryCodes).
+    // RG-1.29 : categories de type SECTEUR/AUTRE uniquement (filtre au Processor).
    /** @var Collection<int, CategoryInterface> */
    #[ORM\ManyToMany(targetEntity: CategoryInterface::class)]
    #[ORM\JoinTable(name: 'client_address_category')]
@@ -193,80 +132,6 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
        $this->categories = new ArrayCollection();
    }
    /**
     * RG-1.06 / RG-1.07 / RG-1.08 : une adresse de prospection est exclusive
     * d'une adresse de livraison ou de facturation. Mirror applicatif (422) du
     * CHECK chk_client_address_prospect_exclusive, joue avant la base afin de
     * remonter une violation Hydra plutot qu'une 500 DBAL.
     */
    #[Assert\Callback]
    public function validateProspectExclusivity(ExecutionContextInterface $context): void
    {
        if ($this->isProspect && ($this->isDelivery || $this->isBilling)) {
            $context->buildViolation('Une adresse de prospection ne peut pas être une adresse de livraison ni de facturation.')
                ->atPath('isProspect')
                ->addViolation()
            ;
        }
    }
    /**
     * RG-1.11 : l'email de facturation est obligatoire si l'adresse est de
     * facturation, et interdit sinon. Mirror applicatif (422) du CHECK
     * chk_client_address_billing_email.
     *
     * On raisonne sur la PRESENCE effective de l'email : null ET chaine vide
     * sont traites comme « absent », car le ClientAddressProcessor normalise une
     * chaine vide en null APRES la validation (RG-1.21). Sans ce traitement,
     * billingEmail="" passerait les callbacks (null === "" est faux) puis serait
     * persiste en null avec is_billing=true -> violation du CHECK -> 500 au lieu
     * du 422 attendu (et symetriquement, "" sur une adresse non facturable
     * serait rejete a tort).
     */
    #[Assert\Callback]
    public function validateBillingEmailPresence(ExecutionContextInterface $context): void
    {
        $hasBillingEmail = null !== $this->billingEmail && '' !== trim($this->billingEmail);
        if ($this->isBilling && !$hasBillingEmail) {
            $context->buildViolation('L\'email de facturation est obligatoire pour une adresse de facturation.')
                ->atPath('billingEmail')
                ->addViolation()
            ;
        }
        if (!$this->isBilling && $hasBillingEmail) {
            $context->buildViolation('L\'email de facturation n\'est autorisé que sur une adresse de facturation.')
                ->atPath('billingEmail')
                ->addViolation()
            ;
        }
    }
    /**
     * RG-1.29 (ERP-78) : une adresse interdit les categories de code
     * DISTRIBUTEUR / COURTIER — elles decrivent une relation entre clients
     * (RG-1.03) et n'ont pas de sens sur une adresse physique -> 422 avec
     * violation sur le champ `categories`. Toute autre categorie (type unique
     * CLIENT) est acceptee. S'appuie sur CategoryInterface::getCode() (pas
     * d'import du module Catalog — regle ABSOLUE n°1).
     */
    #[Assert\Callback]
    public function validateCategoryCodes(ExecutionContextInterface $context): void
    {
        foreach ($this->categories as $category) {
            if ($category instanceof CategoryInterface
                && in_array($category->getCode(), self::FORBIDDEN_CATEGORY_CODES, true)) {
                $context->buildViolation('Type de catégorie non autorisé sur une adresse.')
                    ->atPath('categories')
                    ->addViolation()
                ;
                return;
            }
        }
    }
    public function getId(): ?int
    {
        return $this->id;
@@ -284,12 +149,6 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
        return $this;
    }
    // Groupe de lecture + nom serialise explicite (cf. note sur la propriete) :
    // sans SerializedName, Symfony exposerait la cle "prospect" (strip du prefixe
    // "is" sur les getters) et, le groupe etant declare sur la propriete `isProspect`,
    // droppait silencieusement la cle du JSON.
    #[Groups(['client_address:read'])]
    #[SerializedName('isProspect')]
    public function isProspect(): bool
    {
        return $this->isProspect;
@@ -302,8 +161,6 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
        return $this;
    }
    #[Groups(['client_address:read'])]
    #[SerializedName('isDelivery')]
    public function isDelivery(): bool
    {
        return $this->isDelivery;
@@ -316,8 +173,6 @@ class ClientAddress implements TimestampableInterface, BlamableInterface
        return $this;
    }
    #[Groups(['client_address:read'])]
    #[SerializedName('isBilling')]
    public function isBilling(): bool
    {
        return $this->isBilling;
@@ -4,13 +4,6 @@ declare(strict_types=1);
 namespace App\Module\Commercial\Domain\Entity;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Delete;
 use ApiPlatform\Metadata\Get;
 use ApiPlatform\Metadata\Link;
 use ApiPlatform\Metadata\Patch;
 use ApiPlatform\Metadata\Post;
 use App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor\ClientContactProcessor;
 use App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientContactRepository;
 use App\Shared\Domain\Attribute\Auditable;
 use App\Shared\Domain\Contract\BlamableInterface;
@@ -23,50 +16,13 @@ use Symfony\Component\Validator\Constraints as Assert;
 /**
 * Contact d'un client (1:n) — onglet Contact. Au moins firstName OU lastName
 * doit etre renseigne (RG-1.05) : la contrainte est portee par un CHECK BDD
- * (chk_client_contact_name) et validee dans le ClientContactProcessor ;
+ * (chk_client_contact_name) et validee dans le futur ClientContactProcessor ;
 * l'entite reste permissive (les deux champs sont nullable).
 *
 * Audite (#[Auditable]) + Timestampable/Blamable (pattern Shared standard).
- *
+ * Les operations CRUD (sous-ressources POST/PATCH/DELETE) sont branchees au
- * Sous-ressource API (ERP-57, spec § 4.5) :
+ * ticket dedie des sous-ressources — aucun ApiResource au M1.1 (ERP-54).
 *  - POST /api/clients/{clientId}/contacts : creation rattachee au client parent
 *    (Link toProperty 'client'), security commercial.clients.manage.
 *  - PATCH / DELETE /api/client_contacts/{id} : security commercial.clients.manage.
 *    Le DELETE est physique (sous-collection, pas le client) ; le processor
 *    refuse la suppression du dernier contact (RG-1.14, 409).
 *  - GET /api/client_contacts/{id} : lecture unitaire (security view) — la
 *    lecture courante reste via le parent (client embarque ses contacts). Pas de
 *    GET collection autonome : non concernee par la pagination ERP-72.
 * Tout passe par le ClientContactProcessor (normalisation RG-1.19/1.20/1.21).
 */
 #[ApiResource(
    operations: [
        new Get(
            security: "is_granted('commercial.clients.view')",
            normalizationContext: ['groups' => ['client_contact:read']],
        ),
        new Post(
            uriTemplate: '/clients/{clientId}/contacts',
            uriVariables: [
                'clientId' => new Link(fromClass: Client::class, toProperty: 'client'),
            ],
            security: "is_granted('commercial.clients.manage')",
            normalizationContext: ['groups' => ['client_contact:read']],
            denormalizationContext: ['groups' => ['client_contact:write']],
            processor: ClientContactProcessor::class,
        ),
        new Patch(
            security: "is_granted('commercial.clients.manage')",
            normalizationContext: ['groups' => ['client_contact:read']],
            denormalizationContext: ['groups' => ['client_contact:write']],
            processor: ClientContactProcessor::class,
        ),
        new Delete(
            security: "is_granted('commercial.clients.manage')",
            processor: ClientContactProcessor::class,
        ),
    ],
 )]
 #[ORM\Entity(repositoryClass: DoctrineClientContactRepository::class)]
 #[ORM\Table(name: 'client_contact')]
 #[ORM\Index(name: 'idx_client_contact_client', columns: ['client_id'])]
@@ -4,13 +4,6 @@ declare(strict_types=1);
 namespace App\Module\Commercial\Domain\Entity;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Delete;
 use ApiPlatform\Metadata\Get;
 use ApiPlatform\Metadata\Link;
 use ApiPlatform\Metadata\Patch;
 use ApiPlatform\Metadata\Post;
 use App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor\ClientRibProcessor;
 use App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientRibRepository;
 use App\Shared\Domain\Attribute\Auditable;
 use App\Shared\Domain\Contract\BlamableInterface;
@@ -23,7 +16,7 @@ use Symfony\Component\Validator\Constraints as Assert;
 /**
 * Coordonnees bancaires d'un client (1:n) — onglet Comptabilite. Au moins un
 * RIB est obligatoire si le type de reglement du client est LCR (RG-1.13,
- * verifie au ClientRibProcessor : refus du DELETE du dernier RIB sous LCR).
+ * verifie au futur Processor).
 *
 * Audit (#[Auditable]) : TOUS les champs sont audites, y compris `iban` et
 * `bic` — AUCUN #[AuditIgnore] (decision Matthieu en revue MR 29/05/2026 :
@@ -32,45 +25,8 @@ use Symfony\Component\Validator\Constraints as Assert;
 *
 * Validation IBAN/BIC : Assert\Iban + Assert\Bic standard Symfony au M1
 * (HP-M2-14 : pas de controle externe banque reelle). Timestampable/Blamable
- * standard.
+ * standard. Aucun ApiResource au M1.1 (sous-ressource branchee ulterieurement).
 *
 * Sous-ressource API (ERP-57, spec § 4.5) — gating comptable renforce :
 *  - POST /api/clients/{clientId}/ribs : creation rattachee au client parent
 *    (Link toProperty 'client'), security commercial.clients.accounting.manage.
 *  - PATCH / DELETE /api/client_ribs/{id} : security commercial.clients.accounting.manage.
 *  - GET /api/client_ribs/{id} : lecture unitaire, security
 *    commercial.clients.accounting.view (donnees bancaires sensibles). Pas de
 *    GET collection autonome.
 * Tout passe par le ClientRibProcessor (RG-1.13 sur DELETE).
 */
 #[ApiResource(
    operations: [
        new Get(
            security: "is_granted('commercial.clients.accounting.view')",
            normalizationContext: ['groups' => ['client_rib:read']],
        ),
        new Post(
            uriTemplate: '/clients/{clientId}/ribs',
            uriVariables: [
                'clientId' => new Link(fromClass: Client::class, toProperty: 'client'),
            ],
            security: "is_granted('commercial.clients.accounting.manage')",
            normalizationContext: ['groups' => ['client_rib:read']],
            denormalizationContext: ['groups' => ['client_rib:write']],
            processor: ClientRibProcessor::class,
        ),
        new Patch(
            security: "is_granted('commercial.clients.accounting.manage')",
            normalizationContext: ['groups' => ['client_rib:read']],
            denormalizationContext: ['groups' => ['client_rib:write']],
            processor: ClientRibProcessor::class,
        ),
        new Delete(
            security: "is_granted('commercial.clients.accounting.manage')",
            processor: ClientRibProcessor::class,
        ),
    ],
 )]
 #[ORM\Entity(repositoryClass: DoctrineClientRibRepository::class)]
 #[ORM\Table(name: 'client_rib')]
 #[ORM\Index(name: 'idx_client_rib_client', columns: ['client_id'])]
@@ -79,17 +35,10 @@ class ClientRib implements TimestampableInterface, BlamableInterface
 {
    use TimestampableBlamableTrait;
    // Double groupe de lecture :
    //  - `client_rib:read` : sous-ressource autonome GET /api/client_ribs/{id}
    //    (deja securisee par commercial.clients.accounting.view).
    //  - `client:read:accounting` : embed des RIB sous le detail Client, ajoute
    //    DYNAMIQUEMENT par ClientReadGroupContextBuilder uniquement si l'user a
    //    accounting.view. Ce double marquage gate les RIB embarques au meme titre
    //    que les scalaires comptables (RG : la Commerciale ne voit aucun RIB).
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
-    #[Groups(['client_rib:read', 'client:read:accounting'])]
+    #[Groups(['client_rib:read'])]
    private ?int $id = null;
    #[ORM\ManyToOne(targetEntity: Client::class, inversedBy: 'ribs')]
@@ -99,23 +48,23 @@ class ClientRib implements TimestampableInterface, BlamableInterface
    #[ORM\Column(length: 120)]
    #[Assert\NotBlank]
    #[Assert\Length(max: 120, normalizer: 'trim')]
-    #[Groups(['client_rib:read', 'client:read:accounting', 'client_rib:write'])]
+    #[Groups(['client_rib:read', 'client_rib:write'])]
    private ?string $label = null;
    #[ORM\Column(length: 20)]
    #[Assert\NotBlank]
    #[Assert\Bic]
-    #[Groups(['client_rib:read', 'client:read:accounting', 'client_rib:write'])]
+    #[Groups(['client_rib:read', 'client_rib:write'])]
    private ?string $bic = null;
    #[ORM\Column(length: 34)]
    #[Assert\NotBlank]
    #[Assert\Iban]
-    #[Groups(['client_rib:read', 'client:read:accounting', 'client_rib:write'])]
+    #[Groups(['client_rib:read', 'client_rib:write'])]
    private ?string $iban = null;
    #[ORM\Column(options: ['default' => 0])]
-    #[Groups(['client_rib:read', 'client:read:accounting', 'client_rib:write'])]
+    #[Groups(['client_rib:read', 'client_rib:write'])]
    private int $position = 0;
    public function getId(): ?int
@@ -16,52 +16,8 @@ interface ClientRepositoryInterface
    /**
     * Construit un QueryBuilder de liste pour le repertoire clients.
     * - Exclut toujours les clients soft-deletes (deleted_at IS NOT NULL, RG-1.24).
-     * - Archivage (RG-1.25) :
+     * - Exclut les archives sauf si $includeArchived = true (RG-1.25).
     *     - $archivedOnly = true  -> uniquement les archives (is_archived = true) ;
     *     - sinon $includeArchived = true -> actifs + archives (echappatoire) ;
     *     - sinon (defaut) -> uniquement les actifs (is_archived = false).
     *   $archivedOnly a la priorite sur $includeArchived.
     * - Tri par defaut : companyName ASC (RG-1.26).
     * - $search : recherche fuzzy insensible a la casse sur companyName +
     *   lastName + email (metacaracteres LIKE echappes). Ignore si null/vide.
     * - $categoryCodes : restreint aux clients possedant au moins une categorie
     *   dont le code est dans la liste (OR — ERP-78). Liste vide = pas de filtre.
     * - $siteIds : restreint aux clients ayant au moins une adresse rattachee a
     *   l'un des sites donnes (OR — RG-1.10). Liste vide = pas de filtre.
     *
     * Filtrage centralise ICI (et non dans les providers/controllers) pour que
     * la liste paginee (ClientProvider) et l'export (ClientExportController)
     * partagent strictement la meme logique de selection.
     *
     * Contrat = SELECTION uniquement (filtres + tri). Aucun fetch-join to-many :
     * l'hydratation des collections affichees est une decision de l'appelant
     * (cf. {@see self::hydrateListCollections()}), pour ne pas imposer le cout
     * d'un produit cartesien a un consommateur qui ne filtrerait/compterait que
     * (ERP-100).
     *
     * @param list<string> $categoryCodes
     * @param list<int>    $siteIds
     */
-    public function createListQueryBuilder(
+    public function createListQueryBuilder(bool $includeArchived = false): QueryBuilder;
        bool $includeArchived = false,
        ?string $search = null,
        array $categoryCodes = [],
        array $siteIds = [],
        bool $archivedOnly = false,
    ): QueryBuilder;
    /**
     * Hydrate en lot les collections affichees par le repertoire (categories,
     * adresses et leurs sites) sur un jeu de clients DEJA charges, via l'identity
     * map Doctrine (memes instances). A appeler apres une selection bornee (page
     * courante ou jeu d'export) pour eviter le N+1 a la serialisation, sans
     * imposer de fetch-join au QueryBuilder de selection (ERP-100).
     *
     * Charge les categories et les adresses/sites en DEUX requetes distinctes
     * (et non un triple fetch-join) pour ne pas multiplier categories x adresses
     * x sites en un seul produit cartesien.
     *
     * @param list<Client> $clients
     */
    public function hydrateListCollections(array $clients): void;
 }
@@ -6,7 +6,6 @@ namespace App\Module\Commercial\Infrastructure\ApiPlatform\Serializer;
 use ApiPlatform\Metadata\IriConverterInterface;
 use App\Shared\Domain\Contract\CategoryInterface;
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
 /**
@@ -41,18 +40,7 @@ final class CategoryReferenceDenormalizer implements DenormalizerInterface
        // est le comportement attendu pour une reference cassee.
        $resource = $this->iriConverter->getResourceFromIri($data);
-        // IRI syntaxiquement valide mais pointant sur une autre ressource (ex:
+        return $resource instanceof CategoryInterface ? $resource : null;
        // '/api/clients/5' la ou une categorie est attendue) : on refuse
        // explicitement plutot que de retourner null silencieusement, ce qui
        // perdrait la reference sans erreur. UnexpectedValueException -> 400.
        if (!$resource instanceof CategoryInterface) {
            throw new UnexpectedValueException(sprintf(
                'L\'IRI "%s" ne référence pas une catégorie.',
                $data,
            ));
        }
        return $resource;
    }
    public function supportsDenormalization(mixed $data, string $type, ?string $format = null, array $context = []): bool
@@ -1,71 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\ApiPlatform\Serializer;
 use ApiPlatform\Metadata\IriConverterInterface;
 use App\Shared\Domain\Contract\SiteInterface;
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
 /**
 * Denormalise un IRI (`/api/sites/{id}`) vers le Site concret quand la propriete
 * cible est type-hintee par le contrat SiteInterface (ClientAddress::$sites).
 *
 * Meme mecanisme que CategoryReferenceDenormalizer : API Platform deduit le type
 * d'element de collection depuis le phpdoc `@var Collection<int, SiteInterface>`,
 * donc l'INTERFACE. Le serializer ne sait pas denormaliser un IRI vers une
 * interface (« Could not denormalize object of type SiteInterface[] ») ; on
 * resout l'IRI via l'IriConverter (qui retourne le Site mappe a la route) sans
 * importer la classe Site du module Sites — la regle ABSOLUE n°1 (pas d'import
 * cross-module) reste respectee : dependance au seul contrat Shared + API Platform.
 *
 * En lecture (normalisation), aucun probleme : l'objet reel EST un Site,
 * ressource a part entiere, serialise en IRI par le normalizer standard.
 */
 final class SiteReferenceDenormalizer implements DenormalizerInterface
 {
    public function __construct(
        private readonly IriConverterInterface $iriConverter,
    ) {}
    public function denormalize(mixed $data, string $type, ?string $format = null, array $context = []): ?SiteInterface
    {
        if (!is_string($data) || '' === $data) {
            return null;
        }
        // getResourceFromIri leve une exception sur IRI invalide -> 400, ce qui
        // est le comportement attendu pour une reference cassee.
        $resource = $this->iriConverter->getResourceFromIri($data);
        // IRI syntaxiquement valide mais pointant sur une autre ressource : on
        // refuse explicitement plutot que de retourner null silencieusement.
        if (!$resource instanceof SiteInterface) {
            throw new UnexpectedValueException(sprintf(
                'L\'IRI "%s" ne référence pas un site.',
                $data,
            ));
        }
        return $resource;
    }
    public function supportsDenormalization(mixed $data, string $type, ?string $format = null, array $context = []): bool
    {
        // Support base sur le seul type cible : l'ArrayDenormalizer (collection
        // `SiteInterface[]`) interroge le support en passant le TABLEAU complet
        // comme $data avant de deleguer element par element. Tester
        // is_string($data) ici casserait la chaine pour les collections.
        return SiteInterface::class === $type;
    }
    /**
     * @return array<class-string|string, bool>
     */
    public function getSupportedTypes(?string $format): array
    {
        return [SiteInterface::class => true];
    }
 }
@@ -1,92 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor;
 use ApiPlatform\Metadata\DeleteOperationInterface;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\State\ProcessorInterface;
 use App\Module\Commercial\Application\Service\ClientFieldNormalizer;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Entity\ClientAddress;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 /**
 * Processor d'ecriture de la sous-ressource Adresse d'un client (M1, § 4.5).
 *
 * Sequence :
 *  - POST / PATCH : normalisation serveur du billingEmail en lowercase (RG-1.21)
 *    via le ClientFieldNormalizer partage. Les autres regles de l'onglet Adresse
 *    sont deja garanties en amont : RG-1.09 (code postal) et RG-1.10 (>= 1 site)
 *    par des contraintes Assert sur l'entite, RG-1.06/07/08/11 par des CHECK BDD.
 *  - DELETE : aucune regle metier specifique (suppression physique directe).
 *
 * La security de l'operation (commercial.clients.manage) est deja appliquee par
 * API Platform, de meme que la validation Symfony des contraintes d'attribut.
 *
 * @implements ProcessorInterface<ClientAddress, null|ClientAddress>
 */
 final class ClientAddressProcessor implements ProcessorInterface
 {
    public function __construct(
        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
        private readonly ProcessorInterface $persistProcessor,
        #[Autowire(service: 'api_platform.doctrine.orm.state.remove_processor')]
        private readonly ProcessorInterface $removeProcessor,
        private readonly ClientFieldNormalizer $normalizer,
        private readonly EntityManagerInterface $em,
    ) {}
    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
    {
        if (!$data instanceof ClientAddress) {
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
        }
        if ($operation instanceof DeleteOperationInterface) {
            return $this->removeProcessor->process($data, $operation, $uriVariables, $context);
        }
        $this->linkParent($data, $uriVariables);
        $this->normalize($data);
        return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
    }
    /**
     * Rattache l'adresse au client parent de la sous-ressource POST
     * (/clients/{clientId}/addresses) : la relation n'est pas peuplee
     * automatiquement par le Link sur une ecriture. Sur PATCH, no-op.
     */
    private function linkParent(ClientAddress $address, array $uriVariables): void
    {
        if (null !== $address->getClient()) {
            return;
        }
        $clientId = $uriVariables['clientId'] ?? null;
        if (null === $clientId) {
            return;
        }
        $client = $clientId instanceof Client
            ? $clientId
            : $this->em->getRepository(Client::class)->find($clientId);
        if ($client instanceof Client) {
            $address->setClient($client);
        }
    }
    /**
     * Normalisation serveur (RG-1.21) : email de facturation en minuscules. La
     * methode est null-safe — une adresse non facturable (billingEmail null)
     * reste null.
     */
    private function normalize(ClientAddress $address): void
    {
        $address->setBillingEmail($this->normalizer->normalizeEmail($address->getBillingEmail()));
    }
 }
@@ -1,151 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor;
 use ApiPlatform\Metadata\DeleteOperationInterface;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\State\ProcessorInterface;
 use ApiPlatform\Validator\Exception\ValidationException;
 use App\Module\Commercial\Application\Service\ClientFieldNormalizer;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Entity\ClientContact;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\HttpKernel\Exception\ConflictHttpException;
 use Symfony\Component\Validator\ConstraintViolation;
 use Symfony\Component\Validator\ConstraintViolationList;
 /**
 * Processor d'ecriture de la sous-ressource Contact d'un client (M1, § 4.5).
 *
 * Sequence :
 *  - POST / PATCH : normalisation serveur (RG-1.19 prenom/nom capitalize,
 *    RG-1.20 telephones reduits aux chiffres, RG-1.21 email lowercase) via le
 *    ClientFieldNormalizer partage (reutilise d'ERP-55), puis validation RG-1.05
 *    (au moins prenom OU nom) avant persistance.
 *  - DELETE : RG-1.14 — la suppression du DERNIER contact d'un client est
 *    refusee (409). Au M1, la completude de l'onglet Contact est purement front
 *    (pas de state machine back) : on garantit seulement qu'un client deja dote
 *    d'un contact n'en soit jamais vide via l'API.
 *
 * La security de l'operation (commercial.clients.manage) est deja appliquee par
 * API Platform en amont. La validation Symfony des contraintes d'attribut
 * (Assert\Email, Assert\Length...) est jouee avant ce processor.
 *
 * @implements ProcessorInterface<ClientContact, null|ClientContact>
 */
 final class ClientContactProcessor implements ProcessorInterface
 {
    public function __construct(
        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
        private readonly ProcessorInterface $persistProcessor,
        #[Autowire(service: 'api_platform.doctrine.orm.state.remove_processor')]
        private readonly ProcessorInterface $removeProcessor,
        private readonly ClientFieldNormalizer $normalizer,
        private readonly EntityManagerInterface $em,
    ) {}
    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
    {
        if (!$data instanceof ClientContact) {
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
        }
        if ($operation instanceof DeleteOperationInterface) {
            $this->guardLastContactDeletion($data);
            return $this->removeProcessor->process($data, $operation, $uriVariables, $context);
        }
        $this->linkParent($data, $uriVariables);
        $this->normalize($data);
        $this->validateName($data);
        return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
    }
    /**
     * Rattache le contact au client parent de la sous-ressource POST
     * (/clients/{clientId}/contacts). La relation n'est pas peuplee
     * automatiquement par le Link sur une operation d'ecriture : on resout donc
     * le parent depuis l'uri variable. Sur PATCH (entite existante), le client
     * est deja present -> no-op.
     */
    private function linkParent(ClientContact $contact, array $uriVariables): void
    {
        if (null !== $contact->getClient()) {
            return;
        }
        $clientId = $uriVariables['clientId'] ?? null;
        if (null === $clientId) {
            return;
        }
        $client = $clientId instanceof Client
            ? $clientId
            : $this->em->getRepository(Client::class)->find($clientId);
        if ($client instanceof Client) {
            $contact->setClient($client);
        }
    }
    /**
     * Normalisation serveur (RG-1.19 / 1.20 / 1.21). Toutes les methodes du
     * normalizer sont null-safe : une chaine vide apres trim devient null.
     */
    private function normalize(ClientContact $contact): void
    {
        $contact->setFirstName($this->normalizer->normalizePersonName($contact->getFirstName()));
        $contact->setLastName($this->normalizer->normalizePersonName($contact->getLastName()));
        $contact->setPhonePrimary($this->normalizer->normalizePhone($contact->getPhonePrimary()));
        $contact->setPhoneSecondary($this->normalizer->normalizePhone($contact->getPhoneSecondary()));
        $contact->setEmail($this->normalizer->normalizeEmail($contact->getEmail()));
    }
    /**
     * RG-1.05 : au moins le prenom OU le nom est obligatoire (double garde avec
     * le CHECK BDD chk_client_contact_name — leve un 422 propre plutot qu'une
     * erreur SQL). Joue apres normalisation, donc les chaines vides sont deja
     * ramenees a null.
     */
    private function validateName(ClientContact $contact): void
    {
        if (null === $contact->getFirstName() && null === $contact->getLastName()) {
            $violations = new ConstraintViolationList();
            $violations->add(new ConstraintViolation(
                'Le prénom ou le nom du contact est obligatoire.',
                null,
                [],
                $contact,
                'firstName',
                null,
            ));
            throw new ValidationException($violations);
        }
    }
    /**
     * RG-1.14 : refuse la suppression du dernier contact d'un client (409). La
     * collection inclut le contact en cours de suppression : un effectif <= 1
     * signifie qu'il ne resterait aucun contact. Sans client rattache (cas
     * theorique), on laisse passer.
     */
    private function guardLastContactDeletion(ClientContact $contact): void
    {
        $client = $contact->getClient();
        if (null === $client) {
            return;
        }
        if ($client->getContacts()->count() <= 1) {
            throw new ConflictHttpException(
                'Impossible de supprimer le dernier contact du client : au moins un contact est requis.',
            );
        }
    }
 }
@@ -15,8 +15,6 @@ use App\Shared\Domain\Contract\CategoryInterface;
 use App\Shared\Domain\Security\BusinessRoles;
 use DateTimeImmutable;
 use Doctrine\DBAL\Exception\UniqueConstraintViolationException;
 use Doctrine\ORM\EntityManagerInterface;
 use Doctrine\ORM\PersistentCollection;
 use JsonException;
 use Symfony\Bundle\SecurityBundle\Security;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
@@ -32,19 +30,16 @@ use Symfony\Component\Validator\ConstraintViolationList;
 * § 2.9 / § 4.3 / § 4.4 + RG-1.01 a RG-1.28.
 *
 * Sequence (POST / PATCH) :
- *  1. Autorisation additionnelle par groupe d'onglet. La security d'operation
+ *  1. Autorisation additionnelle par groupe d'onglet (le `security` de
- *     du PATCH a ete elargie (ERP-74) a `manage` OU `accounting.manage` pour
+ *     l'operation a deja exige commercial.clients.manage) :
- *     laisser entrer le role Compta ; ce processor re-gate alors finement :
+ *     - champ comptable dans le payload -> exige accounting.manage (RG-1.28, 403) ;
 *     - champ comptable modifie dans le payload -> exige accounting.manage (RG-1.28, 403) ;
 *     - champ main/information modifie -> exige manage (guardManage, 403) : empeche
 *       Compta d'editer un autre onglet que la Comptabilite (§ 2.7) ;
 *     - champ isArchived dans le payload -> exige archive (RG-1.22, 403) et
 *       interdit toute autre modification dans la meme requete (RG-1.22, 422).
 *  2. Normalisation serveur (RG-1.18 a 1.21) via ClientFieldNormalizer.
 *  3. Regles metier : RG-1.01 (prenom/nom), RG-1.03 (distributor/broker
 *     exclusifs + type de categorie), RG-1.12 (Virement -> banque),
- *     RG-1.13 (LCR -> >= 1 RIB), RG-1.04 (completude Information exigee sur POST
+ *     RG-1.13 (LCR -> >= 1 RIB), RG-1.04 (completude Information pour le role
- *     et tout PATCH pour le role Commerciale).
+ *     Commerciale).
 *  4. Pose / retrait de archivedAt (RG-1.22 true=now, RG-1.23 false=null).
 *  5. Persistance via le persist_processor Doctrine, avec traduction des
 *     collisions d'unicite en 409 (RG-1.16 doublon de nom ; RG-1.23 conflit de
@@ -79,23 +74,9 @@ final class ClientProcessor implements ProcessorInterface
    /** Champ d'archivage (groupe client:write:archive). */
    private const string ARCHIVE_FIELD = 'isArchived';
    private const string PERM_MANAGE            = 'commercial.clients.manage';
    private const string PERM_ACCOUNTING_MANAGE = 'commercial.clients.accounting.manage';
    private const string PERM_ARCHIVE           = 'commercial.clients.archive';
    /**
     * Memoisation du dernier corps de requete decode, clos par le contenu brut.
     * payloadKeys() est appele plusieurs fois par requete (writablePayloadKeys,
     * categoriesChanged...) : on evite de rejouer json_decode a chaque appel. La
     * cle etant le contenu lui-meme et le calcul une fonction pure de ce contenu,
     * aucune fuite n'est possible entre requetes sur ce service partage (un meme
     * corps redonne les memes cles).
     */
    private ?string $decodedContent = null;
    /** @var list<string> Cles de premier niveau correspondant au corps memoise. */
    private array $decodedPayloadKeys = [];
    public function __construct(
        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
        private readonly ProcessorInterface $persistProcessor,
@@ -103,7 +84,6 @@ final class ClientProcessor implements ProcessorInterface
        private readonly ClientInformationCompletenessValidator $informationValidator,
        private readonly Security $security,
        private readonly RequestStack $requestStack,
        private readonly EntityManagerInterface $em,
    ) {}
    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
@@ -112,22 +92,17 @@ final class ClientProcessor implements ProcessorInterface
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
        }
-        $writableKeys = $this->writablePayloadKeys();
+        $payloadKeys = $this->payloadKeys();
-        $isArchiveRequest = $this->guardArchive($data, $writableKeys);
+        $isArchiveRequest = $this->guardArchive($data, $payloadKeys);
-        $this->guardAccounting($data);
+        $this->guardAccounting($payloadKeys);
        $this->normalize($data);
        // guardManage apres normalize : la comparaison « change vs etat
        // persiste » des champs texte (companyName, email...) se fait sur des
        // valeurs normalisees des deux cotes (l'etat persiste l'a deja ete).
        $this->guardManage($data);
        $this->validateMainContact($data);
        $this->validateDistributorBroker($data);
        $this->validateAccountingConsistency($data);
-        $this->validateInformationCompleteness($data);
+        $this->validateInformationCompleteness($data, $payloadKeys);
        try {
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
@@ -151,28 +126,15 @@ final class ClientProcessor implements ProcessorInterface
    }
    /**
-     * RG-1.22 / RG-1.23 : si le payload bascule reellement isArchived, exige la
+     * RG-1.22 / RG-1.23 : si le payload porte isArchived, exige la permission
-     * permission archive (403), interdit toute autre modification (422) et
+     * archive (403), interdit toute autre modification (422) et pose/retire
-     * pose/retire archivedAt. Retourne true si la requete est une requete
+     * archivedAt. Retourne true si la requete est une requete d'archivage.
     * d'archivage.
     *
-     * Le gating est restreint a la mise a jour d'un client existant ET au seul
+     * @param list<string> $payloadKeys
     * cas ou isArchived change vraiment : un POST (entite non encore geree par
     * l'ORM) ou un PATCH « representation complete » renvoyant isArchived
     * inchange ne doit declencher ni 403 ni 422 parasite.
     *
     * @param list<string> $writableKeys cles ecrivables du payload (hors @* et champs inconnus)
     */
-    private function guardArchive(Client $data, array $writableKeys): bool
+    private function guardArchive(Client $data, array $payloadKeys): bool
    {
-        // POST / entite non geree : l'archivage est une action de mise a jour.
+        if (!in_array(self::ARCHIVE_FIELD, $payloadKeys, true)) {
        if (!$this->em->contains($data)) {
            return false;
        }
        // isArchived inchange par rapport a l'etat persiste : pas une requete
        // d'archivage (cas du PATCH representation complete).
        if (!$this->fieldChanged($data, 'isArchived', $data->isArchived())) {
            return false;
        }
@@ -184,8 +146,8 @@ final class ClientProcessor implements ProcessorInterface
            ));
        }
-        // RG-1.22 : une requete d'archivage ne modifie aucun autre champ ecrivable.
+        // RG-1.22 : une requete d'archivage ne modifie aucun autre champ.
-        if ([] !== array_diff($writableKeys, [self::ARCHIVE_FIELD])) {
+        if ([] !== array_diff($payloadKeys, [self::ARCHIVE_FIELD])) {
            throw new UnprocessableEntityHttpException(
                'Une requête d\'archivage ne peut modifier aucun autre champ que "isArchived".',
            );
@@ -198,227 +160,29 @@ final class ClientProcessor implements ProcessorInterface
    }
    /**
-     * RG-1.28 : la modification effective d'un champ comptable exige
+     * RG-1.28 : un champ comptable dans le payload exige accounting.manage,
-     * accounting.manage, sinon 403 sur l'ensemble du payload (mode strict, pas
+     * sinon 403 sur l'ensemble du payload (mode strict, pas de filtrage
-     * de filtrage silencieux). On ne gate que si un champ change reellement par
+     * silencieux). Le message precise le premier champ fautif.
-     * rapport a l'etat persiste : un POST/PATCH renvoyant des champs comptables
+     *
-     * inchanges (ou null en creation) ne declenche pas de 403 parasite. Le
+     * @param list<string> $payloadKeys
     * message precise le premier champ fautif.
     */
-    private function guardAccounting(Client $data): void
+    private function guardAccounting(array $payloadKeys): void
    {
-        $changed = $this->changedAccountingFields($data);
+        $touched = array_values(array_intersect($payloadKeys, self::ACCOUNTING_FIELDS));
-        if ([] === $changed) {
+        if ([] === $touched) {
            return;
        }
        if (!$this->security->isGranted(self::PERM_ACCOUNTING_MANAGE)) {
            throw new AccessDeniedHttpException(sprintf(
                'Le champ "%s" requiert la permission "%s".',
-                $changed[0],
+                $touched[0],
                self::PERM_ACCOUNTING_MANAGE,
            ));
        }
    }
    /**
     * § 2.7 / RG-1.28 (ERP-74) : la modification effective d'un champ « metier »
     * (onglets principal ou Information) exige `commercial.clients.manage`. Sans
     * cette permission -> 403 sur l'ensemble du payload (mode strict, miroir de
     * guardAccounting). C'est ce qui empeche le role Compta — qui entre dans le
     * PATCH via `accounting.manage` (security d'operation elargie) — d'editer
     * autre chose que l'onglet Comptabilite.
     *
     * Ne s'applique qu'aux mises a jour (entite geree) : la creation (POST) est
     * deja gardee par la security d'operation `manage`, donc inutile de la
     * re-gater ici (et un POST par un porteur de `manage` passerait de toute
     * facon).
     */
    private function guardManage(Client $data): void
    {
        if (!$this->em->contains($data)) {
            return;
        }
        $changed = $this->changedBusinessFields($data);
        if ([] === $changed) {
            return;
        }
        if (!$this->security->isGranted(self::PERM_MANAGE)) {
            throw new AccessDeniedHttpException(sprintf(
                'Le champ "%s" requiert la permission "%s".',
                $changed[0],
                self::PERM_MANAGE,
            ));
        }
    }
    /**
     * Champs « metier » (onglets principal + Information, hors comptabilite et
     * archivage) dont la valeur courante differe de l'etat persiste. Memes
     * regles de comparaison que changedAccountingFields (scalaires par valeur,
     * relations ManyToOne distributor/broker par identite via l'identity map).
     *
     * Cas particulier `categories` (M2M) : non trace par getOriginalEntityData,
     * compare par valeur via le snapshot de la PersistentCollection (cf.
     * categoriesChanged) — la simple presence dans le payload ne suffit pas, sous
     * peine de 403 parasite sur un PATCH representation complete reincluant des
     * categories inchangees.
     *
     * @return list<string>
     */
    private function changedBusinessFields(Client $data): array
    {
        $newValues = [
            'companyName'    => $data->getCompanyName(),
            'firstName'      => $data->getFirstName(),
            'lastName'       => $data->getLastName(),
            'phonePrimary'   => $data->getPhonePrimary(),
            'phoneSecondary' => $data->getPhoneSecondary(),
            'email'          => $data->getEmail(),
            'distributor'    => $data->getDistributor(),
            'broker'         => $data->getBroker(),
            'triageService'  => $data->isTriageService(),
            'description'    => $data->getDescription(),
            'competitors'    => $data->getCompetitors(),
            'foundedAt'      => $data->getFoundedAt(),
            'employeesCount' => $data->getEmployeesCount(),
            'revenueAmount'  => $data->getRevenueAmount(),
            'directorName'   => $data->getDirectorName(),
            'profitAmount'   => $data->getProfitAmount(),
        ];
        $changed = [];
        foreach ($newValues as $field => $newValue) {
            if ($this->fieldChanged($data, $field, $newValue)) {
                $changed[] = $field;
            }
        }
        if ($this->categoriesChanged($data)) {
            $changed[] = 'categories';
        }
        return $changed;
    }
    /**
     * Vrai si l'ensemble des categories (M2M) differe reellement de l'etat
     * persiste. La collection n'etant pas tracee par getOriginalEntityData, on
     * compare par identifiants (independamment de l'ordre) le snapshot de la
     * PersistentCollection (etat charge depuis la base) a l'etat courant (apres
     * application du payload). Symetrique de changedAccountingFields : seul un
     * changement effectif compte, pas la simple presence dans le payload.
     *
     * - POST / entite non geree : fournir des categories est un acte metier
     *   (comportement historique conserve) — branche defensive, guardManage ne
     *   s'execute de toute facon que sur entite geree.
     * - categories absent du payload (PATCH partiel) : aucun changement.
     */
    private function categoriesChanged(Client $data): bool
    {
        if (!$this->em->contains($data)) {
            return true;
        }
        if (!in_array('categories', $this->payloadKeys(), true)) {
            return false;
        }
        $collection = $data->getCategories();
        // Hors PersistentCollection (cas limite hors flux PATCH reel) : faute
        // d'etat persiste comparable, on se rabat sur la presence payload.
        if (!$collection instanceof PersistentCollection) {
            return true;
        }
        return $this->categoryIdSet($collection->toArray())
            !== $this->categoryIdSet($collection->getSnapshot());
    }
    /**
     * Ensemble trie des identifiants d'une liste de categories — pour une
     * comparaison par valeur independante de l'ordre.
     *
     * @param array<int, object> $categories
     *
     * @return list<mixed>
     */
    private function categoryIdSet(array $categories): array
    {
        $ids = array_map(
            static fn (object $category): mixed => method_exists($category, 'getId')
                ? $category->getId()
                : spl_object_id($category),
            array_values($categories),
        );
        sort($ids);
        return $ids;
    }
    /**
     * Champs comptables dont la valeur courante differe de l'etat persiste. Les
     * relations (tvaMode, paymentDelay, paymentType, bank) sont comparees par
     * identite d'objet : l'identity map Doctrine renvoie la meme instance tant
     * que la reference est inchangee.
     *
     * @return list<string>
     */
    private function changedAccountingFields(Client $data): array
    {
        $changed = [];
        foreach (self::ACCOUNTING_FIELDS as $field) {
            $newValue = match ($field) {
                'siren'         => $data->getSiren(),
                'accountNumber' => $data->getAccountNumber(),
                'tvaMode'       => $data->getTvaMode(),
                'nTva'          => $data->getNTva(),
                'paymentDelay'  => $data->getPaymentDelay(),
                'paymentType'   => $data->getPaymentType(),
                'bank'          => $data->getBank(),
            };
            if ($this->fieldChanged($data, $field, $newValue)) {
                $changed[] = $field;
            }
        }
        return $changed;
    }
    /**
     * Vrai si la valeur courante d'un champ differe de l'etat persiste. Pour une
     * entite non geree (creation/POST), l'etat persiste est vide : toute valeur
     * non-null est alors un changement.
     */
    private function fieldChanged(Client $data, string $field, mixed $newValue): bool
    {
        $original = $this->originalData($data);
        return $newValue !== ($original[$field] ?? null);
    }
    /**
     * Snapshot des valeurs persistees de l'entite (telles que chargees, avant
     * application du payload). Vide pour une entite non geree (POST).
     *
     * @return array<string, mixed>
     */
    private function originalData(Client $data): array
    {
        if (!$this->em->contains($data)) {
            return [];
        }
        return $this->em->getUnitOfWork()->getOriginalEntityData($data);
    }
    /**
     * Normalisation serveur (RG-1.18 a 1.21). Les setters non-nullables
     * (companyName, email, phonePrimary) ne sont touches que si une valeur est
@@ -457,9 +221,8 @@ final class ClientProcessor implements ProcessorInterface
    /**
     * RG-1.03 : distributor et broker mutuellement exclusifs ; un distributor
-     * doit referencer un client portant la categorie de code DISTRIBUTEUR (idem
+     * doit referencer un client de categorie DISTRIBUTEUR (idem broker ->
-     * broker -> COURTIER). Depuis ERP-78, le filtrage se fait sur le code de la
+     * COURTIER).
     * Category (et non plus sur le type, devenu unique CLIENT).
     */
    private function validateDistributorBroker(Client $data): void
    {
@@ -474,7 +237,7 @@ final class ClientProcessor implements ProcessorInterface
            );
        }
-        if (null !== $distributor && !$this->hasCategoryCode($distributor, 'DISTRIBUTEUR')) {
+        if (null !== $distributor && !$this->hasCategoryType($distributor, 'DISTRIBUTEUR')) {
            $this->throwViolation(
                'distributor',
                'Le distributeur référencé doit être un client de catégorie DISTRIBUTEUR.',
@@ -482,7 +245,7 @@ final class ClientProcessor implements ProcessorInterface
            );
        }
-        if (null !== $broker && !$this->hasCategoryCode($broker, 'COURTIER')) {
+        if (null !== $broker && !$this->hasCategoryType($broker, 'COURTIER')) {
            $this->throwViolation(
                'broker',
                'Le courtier référencé doit être un client de catégorie COURTIER.',
@@ -516,28 +279,29 @@ final class ClientProcessor implements ProcessorInterface
    }
    /**
-     * RG-1.04 (durcie ERP-74) : si l'utilisateur porte le role metier
+     * RG-1.04 : si l'utilisateur porte le role metier Commerciale ET que le
-     * Commerciale, TOUS les champs de l'onglet Information sont obligatoires sur
+     * payload touche l'onglet Information, tous les champs Information sont
-     * POST comme sur TOUT PATCH — independamment des champs reellement envoyes
+     * obligatoires. Dormant tant qu'aucun user ne porte le role `commerciale`.
-     * (plus de condition d'intersection avec INFORMATION_FIELDS). Garantit qu'un
+     *
-     * client cree/edite par une Commerciale ne reste jamais avec un onglet
+     * @param list<string> $payloadKeys
     * Information incomplet.
     */
-    private function validateInformationCompleteness(Client $data): void
+    private function validateInformationCompleteness(Client $data, array $payloadKeys): void
    {
-        if ($this->currentUserIsCommerciale()) {
+        $touchesInformation = [] !== array_intersect($payloadKeys, self::INFORMATION_FIELDS);
        if ($touchesInformation && $this->currentUserIsCommerciale()) {
            $this->informationValidator->validate($data);
        }
    }
    /**
-     * Vrai si au moins une categorie du client porte le code donne. S'appuie sur
+     * Vrai si au moins une categorie du client porte le type donne. S'appuie
-     * CategoryInterface::getCode() (pas d'import de Category — regle ABSOLUE n°1).
+     * sur CategoryInterface::getCategoryTypeCode() (pas d'import de Category).
     */
-    private function hasCategoryCode(Client $client, string $code): bool
+    private function hasCategoryType(Client $client, string $typeCode): bool
    {
        foreach ($client->getCategories() as $category) {
-            if ($category instanceof CategoryInterface && $category->getCode() === $code) {
+            if ($category instanceof CategoryInterface && $category->getCategoryTypeCode() === $typeCode) {
                return true;
            }
        }
@@ -553,32 +317,11 @@ final class ClientProcessor implements ProcessorInterface
            && $user->hasBusinessRole(BusinessRoles::COMMERCIALE);
    }
    /**
     * Cles ecrivables effectivement presentes dans le payload : on retire les
     * cles JSON-LD (@id, @context, @var...) et tout champ non rattache a un
     * groupe d'ecriture connu. C'est la base du 422 d'archivage (RG-1.22) et du
     * declenchement conditionnel de RG-1.04 — sans elles, un PATCH
     * « representation complete » porteur de @id ferait croire a une
     * modification multi-onglets.
     *
     * @return list<string>
     */
    private function writablePayloadKeys(): array
    {
        $writable = array_merge(
            self::MAIN_FIELDS,
            self::INFORMATION_FIELDS,
            self::ACCOUNTING_FIELDS,
            [self::ARCHIVE_FIELD],
        );
        return array_values(array_intersect($this->payloadKeys(), $writable));
    }
    /**
     * Cles de premier niveau effectivement envoyees par le client (payload JSON
-     * brut), filtrage compris. Pour un PATCH merge-patch+json, ce sont les seuls
+     * brut). Pour un PATCH merge-patch+json, ce sont les seuls champs modifies ;
-     * champs modifies.
+     * c'est ce qui permet le gating par onglet (RG-1.22 / RG-1.28) et le
     * declenchement conditionnel de RG-1.04.
     *
     * @return list<string>
     */
@@ -590,26 +333,6 @@ final class ClientProcessor implements ProcessorInterface
        }
        $content = $request->getContent();
        // Cache hit : meme corps brut que le dernier decodage -> memes cles.
        if ($content === $this->decodedContent) {
            return $this->decodedPayloadKeys;
        }
        $this->decodedContent     = $content;
        $this->decodedPayloadKeys = $this->extractPayloadKeys($content);
        return $this->decodedPayloadKeys;
    }
    /**
     * Decode le corps brut et en extrait les cles de premier niveau (chaines).
     * Corps vide ou JSON invalide -> aucune cle.
     *
     * @return list<string>
     */
    private function extractPayloadKeys(string $content): array
    {
        if ('' === $content) {
            return [];
        }
@@ -1,104 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\ApiPlatform\State\Processor;
 use ApiPlatform\Metadata\DeleteOperationInterface;
 use ApiPlatform\Metadata\Operation;
 use ApiPlatform\State\ProcessorInterface;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Entity\ClientRib;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\HttpKernel\Exception\ConflictHttpException;
 /**
 * Processor d'ecriture de la sous-ressource RIB d'un client (M1, § 4.5).
 *
 * Sequence :
 *  - POST / PATCH : aucune normalisation specifique. La validite de l'IBAN et du
 *    BIC est garantie par Assert\Iban / Assert\Bic sur l'entite (jouees en amont
 *    par API Platform). Aucun #[AuditIgnore] sur iban/bic : la tracabilite
 *    comptable est volontaire (decision Matthieu 29/05, spec § 6.1).
 *  - DELETE : RG-1.13 — si le client est en reglement LCR, la suppression de son
 *    DERNIER RIB est refusee (409), car LCR exige au moins un RIB.
 *
 * La security de l'operation (commercial.clients.accounting.manage) est deja
 * appliquee par API Platform en amont : un utilisateur sans cette permission
 * recoit 403 sur POST/PATCH/DELETE avant d'atteindre ce processor.
 *
 * @implements ProcessorInterface<ClientRib, null|ClientRib>
 */
 final class ClientRibProcessor implements ProcessorInterface
 {
    public function __construct(
        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
        private readonly ProcessorInterface $persistProcessor,
        #[Autowire(service: 'api_platform.doctrine.orm.state.remove_processor')]
        private readonly ProcessorInterface $removeProcessor,
        private readonly EntityManagerInterface $em,
    ) {}
    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
    {
        if (!$data instanceof ClientRib) {
            return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
        }
        if ($operation instanceof DeleteOperationInterface) {
            $this->guardLastRibDeletionUnderLcr($data);
            return $this->removeProcessor->process($data, $operation, $uriVariables, $context);
        }
        $this->linkParent($data, $uriVariables);
        return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
    }
    /**
     * Rattache le RIB au client parent de la sous-ressource POST
     * (/clients/{clientId}/ribs) : la relation n'est pas peuplee automatiquement
     * par le Link sur une ecriture. Sur PATCH, no-op.
     */
    private function linkParent(ClientRib $rib, array $uriVariables): void
    {
        if (null !== $rib->getClient()) {
            return;
        }
        $clientId = $uriVariables['clientId'] ?? null;
        if (null === $clientId) {
            return;
        }
        $client = $clientId instanceof Client
            ? $clientId
            : $this->em->getRepository(Client::class)->find($clientId);
        if ($client instanceof Client) {
            $rib->setClient($client);
        }
    }
    /**
     * RG-1.13 : un client dont le type de reglement est LCR doit conserver au
     * moins un RIB. La collection inclut le RIB en cours de suppression : un
     * effectif <= 1 signifie qu'il ne resterait aucun RIB -> 409. Pour tout autre
     * type de reglement, les RIBs sont optionnels (suppression libre).
     */
    private function guardLastRibDeletionUnderLcr(ClientRib $rib): void
    {
        $client = $rib->getClient();
        if (null === $client) {
            return;
        }
        if ('LCR' === $client->getPaymentType()?->getCode() && $client->getRibs()->count() <= 1) {
            throw new ConflictHttpException(
                'Impossible de supprimer le dernier RIB : le type de règlement LCR exige au moins un RIB.',
            );
        }
    }
 }
@@ -11,6 +11,7 @@ use ApiPlatform\State\Pagination\Pagination;
 use ApiPlatform\State\ProviderInterface;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Repository\ClientRepositoryInterface;
 use Doctrine\ORM\QueryBuilder;
 use Doctrine\ORM\Tools\Pagination\Paginator as DoctrinePaginator;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
@@ -24,7 +25,7 @@ use Symfony\Component\DependencyInjection\Attribute\Autowire;
 *    exclus au M1) — RG-1.25 ;
 *  - tri par defaut companyName ASC — RG-1.26 ;
 *  - filtres ?search=... (fuzzy companyName + lastName + email) et
- *    ?categoryCode=<code> (clients ayant >= 1 categorie de ce code — ERP-78) ;
+ *    ?categoryType=<code> (clients ayant >= 1 categorie de ce type) ;
 *  - pagination obligatoire (convention Starseed ERP-72) : Paginator ORM ;
 *    echappatoire ?pagination=false pour alimenter un <select> sans pagination.
 *
@@ -64,32 +65,16 @@ final class ClientProvider implements ProviderInterface
    {
        $filters         = $context['filters'] ?? [];
        $includeArchived = $this->readBool($filters['includeArchived'] ?? false);
        $archivedOnly    = $this->readBool($filters['archivedOnly'] ?? false);
        $search          = $filters['search'] ?? null;
        // categoryCode accepte un code unique (?categoryCode=DISTRIBUTEUR, selects
        // RG-1.03) OU une liste (?categoryCode[]=A&categoryCode[]=B, drawer multi).
        $categoryCodes = $this->readStringList($filters['categoryCode'] ?? []);
        $siteIds       = $this->readIntList($filters['siteId'] ?? []);
-        // Filtrage delegue au repository (logique partagee avec l'export XLSX).
+        $qb = $this->repository->createListQueryBuilder($includeArchived);
-        $qb = $this->repository->createListQueryBuilder(
+        $this->applySearch($qb, $filters['search'] ?? null);
-            $includeArchived,
+        $this->applyCategoryType($qb, $filters['categoryType'] ?? null);
            is_string($search) ? $search : null,
            $categoryCodes,
            $siteIds,
            $archivedOnly,
        );
        // Echappatoire ?pagination=false : collection complete sans Paginator
        // (cf. convention ERP-72 — utile pour un <select> cote front).
        if (!$this->pagination->isEnabled($operation, $context)) {
-            /** @var list<Client> $clients */
+            /** @var list<Client> $result */
-            $clients = $qb->getQuery()->getResult();
+            return $qb->getQuery()->getResult();
            // Hydratation batchee des collections affichees (cf. ERP-100) : evite
            // le N+1 si la serialisation touche categories/sites, sans cartesien.
            $this->repository->hydrateListCollections($clients);
            return $clients;
        }
        $limit  = $this->pagination->getLimit($operation, $context);
@@ -98,13 +83,9 @@ final class ClientProvider implements ProviderInterface
        $qb->setFirstResult($offset)->setMaxResults($limit);
-        // Le QB de selection ne porte plus de fetch-join to-many (ERP-100) : le
+        // fetchJoinCollection: true pour un COUNT correct des que des JOINs
-        // COUNT est simple, fetchJoinCollection inutile. On materialise la page
+        // to-many seront ajoutes (sous-collections embarquees en detail).
-        // puis on hydrate ses collections en lot (memes entites managees).
+        return new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: true));
        $paginator = new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: false));
        $this->repository->hydrateListCollections(iterator_to_array($paginator));
        return $paginator;
    }
    /**
@@ -131,6 +112,50 @@ final class ClientProvider implements ProviderInterface
        return $client;
    }
    /**
     * Recherche fuzzy insensible a la casse sur companyName + lastName + email.
     * Les metacaracteres LIKE (%, _, \) saisis sont echappes pour rester
     * litteraux.
     */
    private function applySearch(QueryBuilder $qb, mixed $search): void
    {
        if (!is_string($search) || '' === trim($search)) {
            return;
        }
        $escaped = str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], trim($search));
        $pattern = '%'.mb_strtolower($escaped, 'UTF-8').'%';
        $qb->andWhere(
            'LOWER(c.companyName) LIKE :search '
            .'OR LOWER(c.lastName) LIKE :search '
            .'OR LOWER(c.email) LIKE :search',
        )->setParameter('search', $pattern);
    }
    /**
     * Restreint aux clients possedant au moins une categorie du type donne.
     * Sous-requete IN (plutot qu'un JOIN sur la collection M2M) pour ne pas
     * perturber le DISTINCT / ORDER BY de la requete paginee principale.
     */
    private function applyCategoryType(QueryBuilder $qb, mixed $categoryType): void
    {
        if (!is_string($categoryType) || '' === trim($categoryType)) {
            return;
        }
        $sub = $this->repository->createQueryBuilder('c2')
            ->select('c2.id')
            ->join('c2.categories', 'cat2')
            ->join('cat2.categoryType', 'ct2')
            ->where('ct2.code = :categoryType')
        ;
        $qb->andWhere($qb->expr()->in('c.id', $sub->getDQL()))
            ->setParameter('categoryType', trim($categoryType))
        ;
    }
    /**
     * Lit un flag booleen issu des query params. Accepte true / "true" / "1".
     */
@@ -142,44 +167,4 @@ final class ClientProvider implements ProviderInterface
        return is_string($raw) && in_array(strtolower($raw), ['true', '1'], true);
    }
    /**
     * Normalise un filtre en liste de chaines. Tolere un code unique (string)
     * ou une liste (?key[]=a&key[]=b). Trim + retrait des vides.
     *
     * @return list<string>
     */
    private function readStringList(mixed $raw): array
    {
        $values = is_array($raw) ? $raw : [$raw];
        $out = [];
        foreach ($values as $value) {
            if (is_string($value) && '' !== trim($value)) {
                $out[] = trim($value);
            }
        }
        return $out;
    }
    /**
     * Normalise un filtre en liste d'identifiants entiers positifs. Tolere une
     * valeur unique ou une liste (?key[]=1&key[]=2).
     *
     * @return list<int>
     */
    private function readIntList(mixed $raw): array
    {
        $values = is_array($raw) ? $raw : [$raw];
        $out = [];
        foreach ($values as $value) {
            if ((is_int($value) || (is_string($value) && ctype_digit($value))) && (int) $value > 0) {
                $out[] = (int) $value;
            }
        }
        return $out;
    }
 }
@@ -1,253 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\Controller;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Repository\ClientRepositoryInterface;
 use App\Shared\Domain\Contract\CategoryInterface;
 use App\Shared\Domain\Contract\SiteInterface;
 use App\Shared\Domain\Contract\SpreadsheetExporterInterface;
 use DateTimeImmutable;
 use Symfony\Bundle\SecurityBundle\Security;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\Attribute\AsController;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
 /**
 * Export XLSX du repertoire clients (M1, spec-back § 4.6).
 *
 * Controller Symfony custom (et non operation API Platform) car il produit un
 * binaire de fichier, pas une representation Hydra. `priority: 1` est
 * OBLIGATOIRE sur la route : sans cela API Platform capterait
 * `/api/clients/export.xlsx` comme l'item `GET /api/clients/{id}.{_format}`
 * (id="export", _format="xlsx") — cf. CLAUDE.md « controller custom sous /api ».
 *
 * Separation des responsabilites :
 *  - le COMMENT (generation du fichier) est delegue au service Shared
 *    {@see SpreadsheetExporterInterface} — generique, reutilisable, sans metier ;
 *  - le QUOI vit ICI : selection des clients (memes filtres que
 *    `GET /api/clients`, via {@see ClientRepositoryInterface::createListQueryBuilder()})
 *    et mapping metier des colonnes.
 *
 * La colonne SIREN n'est ajoutee que si l'utilisateur a la permission
 * `commercial.clients.accounting.view` (gating identique a la lecture).
 */
 #[AsController]
 final class ClientExportController
 {
    public function __construct(
        #[Autowire(service: 'App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientRepository')]
        private readonly ClientRepositoryInterface $repository,
        private readonly SpreadsheetExporterInterface $exporter,
        private readonly Security $security,
    ) {}
    #[Route('/api/clients/export.xlsx', name: 'commercial_clients_export_xlsx', methods: ['GET'], priority: 1)]
    #[IsGranted('commercial.clients.view')]
    public function __invoke(Request $request): Response
    {
        $includeArchived = $this->readBool($request->query->get('includeArchived'));
        $archivedOnly    = $this->readBool($request->query->get('archivedOnly'));
        $search          = $request->query->getString('search') ?: null;
        // Memes filtres que la vue liste : categoryCode/siteId tolerent une valeur
        // unique ou une liste (?categoryCode[]=A&siteId[]=1). On lit via all() pour
        // ne pas lever d'exception sur une valeur scalaire.
        $query         = $request->query->all();
        $categoryCodes = $this->readStringList($query['categoryCode'] ?? []);
        $siteIds       = $this->readIntList($query['siteId'] ?? []);
        /** @var list<Client> $clients */
        $clients = $this->repository
            ->createListQueryBuilder($includeArchived, $search, $categoryCodes, $siteIds, $archivedOnly)
            ->getQuery()
            ->getResult()
        ;
        // Hydratation batchee des categories + adresses/sites (ERP-100) : le QB de
        // selection ne fetch-join plus, on remplit les collections en 2 requetes
        // IN bornees plutot que d'hydrater un produit cartesien sur tout le jeu.
        $this->repository->hydrateListCollections($clients);
        $withSiren = $this->security->isGranted('commercial.clients.accounting.view');
        $binary = $this->exporter->export(
            'Répertoire clients',
            $this->buildHeaders($withSiren),
            $this->buildRows($clients, $withSiren),
        );
        return $this->buildResponse($binary);
    }
    /**
     * Colonnes dans l'ordre impose par la spec § 4.6. SIREN inseree avant la
     * date de creation, uniquement si l'utilisateur a accounting.view.
     *
     * @return list<string>
     */
    private function buildHeaders(bool $withSiren): array
    {
        $headers = [
            'Nom entreprise',
            'Nom contact principal',
            'Prénom',
            'Téléphone principal',
            'Téléphone secondaire',
            'Email',
            'Catégories',
            'Sites',
        ];
        if ($withSiren) {
            $headers[] = 'SIREN';
        }
        $headers[] = 'Date de création';
        return $headers;
    }
    /**
     * @param list<Client> $clients
     *
     * @return iterable<list<null|scalar>>
     */
    private function buildRows(array $clients, bool $withSiren): iterable
    {
        foreach ($clients as $client) {
            $row = [
                $client->getCompanyName(),
                $client->getLastName(),
                $client->getFirstName(),
                $client->getPhonePrimary(),
                $client->getPhoneSecondary(),
                $client->getEmail(),
                $this->formatCategories($client),
                $this->formatSites($client),
            ];
            if ($withSiren) {
                $row[] = $client->getSiren();
            }
            $row[] = $client->getCreatedAt()?->format('d/m/Y');
            yield $row;
        }
    }
    /**
     * Libelles des categories du client, dedupliques, tries, joints par virgule.
     */
    private function formatCategories(Client $client): string
    {
        $names = [];
        foreach ($client->getCategories() as $category) {
            // @var CategoryInterface $category
            $name = $category->getName();
            if (null !== $name && '' !== $name) {
                $names[$name] = true;
            }
        }
        return $this->joinSorted($names);
    }
    /**
     * Le Client ne porte pas de sites en propre : ils sont rattaches aux
     * adresses (RG-1.10). La colonne « Sites » agrege donc l'union distincte des
     * sites de toutes les adresses du client (decision validee 01/06).
     */
    private function formatSites(Client $client): string
    {
        $names = [];
        foreach ($client->getAddresses() as $address) {
            foreach ($address->getSites() as $site) {
                // @var SiteInterface $site
                $name = $site->getName();
                if (null !== $name && '' !== $name) {
                    $names[$name] = true;
                }
            }
        }
        return $this->joinSorted($names);
    }
    /**
     * @param array<string, true> $names ensemble de libelles (cles)
     */
    private function joinSorted(array $names): string
    {
        $list = array_keys($names);
        sort($list);
        return implode(', ', $list);
    }
    private function buildResponse(string $binary): Response
    {
        $filename = sprintf('repertoire-clients-%s.xlsx', new DateTimeImmutable()->format('Ymd'));
        $response = new Response($binary);
        $response->headers->set('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
        $response->headers->set('Content-Disposition', sprintf('attachment; filename="%s"', $filename));
        return $response;
    }
    /**
     * Lit un flag booleen issu des query params. Accepte true / "true" / "1".
     * Aligne sur ClientProvider pour un comportement identique a la liste.
     */
    private function readBool(mixed $raw): bool
    {
        return is_string($raw) && in_array(strtolower($raw), ['true', '1'], true);
    }
    /**
     * Normalise un filtre en liste de chaines (valeur unique ou liste).
     * Aligne sur ClientProvider pour un comportement identique a la liste.
     *
     * @return list<string>
     */
    private function readStringList(mixed $raw): array
    {
        $values = is_array($raw) ? $raw : [$raw];
        $out = [];
        foreach ($values as $value) {
            if (is_string($value) && '' !== trim($value)) {
                $out[] = trim($value);
            }
        }
        return $out;
    }
    /**
     * Normalise un filtre en liste d'identifiants entiers positifs (valeur unique
     * ou liste). Aligne sur ClientProvider.
     *
     * @return list<int>
     */
    private function readIntList(mixed $raw): array
    {
        $values = is_array($raw) ? $raw : [$raw];
        $out = [];
        foreach ($values as $value) {
            if ((is_int($value) || (is_string($value) && ctype_digit($value))) && (int) $value > 0) {
                $out[] = (int) $value;
            }
        }
        return $out;
    }
 }
@@ -1,555 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Commercial\Infrastructure\DataFixtures;
 use App\Module\Catalog\Infrastructure\DataFixtures\CategoryFixtures;
 use App\Module\Commercial\Application\Service\ClientFieldNormalizer;
 use App\Module\Commercial\Domain\Entity\Bank;
 use App\Module\Commercial\Domain\Entity\Client;
 use App\Module\Commercial\Domain\Entity\ClientAddress;
 use App\Module\Commercial\Domain\Entity\ClientContact;
 use App\Module\Commercial\Domain\Entity\ClientRib;
 use App\Module\Commercial\Domain\Entity\PaymentType;
 use App\Module\Sites\Infrastructure\DataFixtures\SitesFixtures;
 use App\Shared\Domain\Contract\CategoryInterface;
 use App\Shared\Domain\Contract\SiteInterface;
 use App\Shared\Domain\Contract\SiteProviderInterface;
 use DateTimeImmutable;
 use Doctrine\Bundle\FixturesBundle\Fixture;
 use Doctrine\Common\DataFixtures\DependentFixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 use RuntimeException;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 /**
 * Fixtures dev/test du module Commercial : ~14 clients de demonstration couvrant
 * l'ensemble des cas metier RG-1.xx du repertoire clients (M1) :
 *  - client basique ; dependant distributeur / courtier (RG-1.03) ;
 *  - reglement LCR avec 2 RIB (RG-1.13) ; reglement Cheque sans RIB ;
 *  - multi-adresses Prospect / Livraison / Facturation (RG-1.06/07/08/11) ;
 *  - prospect seul ; 3 contacts dont un avec telephone secondaire (RG-1.05/1.02) ;
 *  - client archive (RG-1.22) ; onglet Information complet ; multi-categories M2M.
 *
 * Resolution inter-modules conforme a la regle n°1 (pas d'import direct) :
 *  - categories resolues via le contrat Shared CategoryInterface
 *    (resolve_target_entities -> Category) ;
 *  - sites resolus via le contrat Shared SiteProviderInterface.
 *
 * Normalisation : les valeurs sont fournies BRUTES (casse libre, telephones
 * formates) et normalisees par ClientFieldNormalizer avant persist, exactement
 * comme le ferait le ClientProcessor via l'API (companyName UPPERCASE,
 * first/last Capitalize, telephones chiffres seuls, emails lowercase).
 *
 * Distributeur / courtier auto-references (RG-1.03) : les tiers referencables
 * (GSO distributeur, Cabinet Leonard courtier) sont crees AVANT les clients qui
 * les referencent ; un unique flush en fin de load ordonne correctement les
 * inserts auto-references.
 *
 * Idempotence : lookup par companyName normalise (coherent avec l'index unique
 * partiel uq_client_company_name_active). Un client deja present n'est pas
 * reconstruit (ses sous-collections ne sont pas redupliquees). Rejouable sans
 * doublon meme si le purger Doctrine est desactive.
 *
 * Audit / Blamable : persist hors contexte HTTP -> created_by / updated_by
 * restent null (« Systeme » cote front), c'est attendu. Les donnees respectent
 * les CHECK BDD ET les validators applicatifs (exclusivite Prospect, billingEmail
 * ssi facturation, aucune categorie de code DISTRIBUTEUR/COURTIER sur une adresse
 * — RG-1.29, ERP-78).
 *
 * Depend de CategoryFixtures (categories), SitesFixtures (sites) et
 * CommercialReferentialFixtures (referentiels comptables Bank / PaymentType).
 *
 * Portee : DONNEES DE DEMONSTRATION (dev uniquement). En environnement `test`,
 * la fixture ne charge rien : les tests seedent et nettoient leurs propres
 * clients et comptent sur une table `client` vierge — y injecter 14 clients de
 * demo casserait les comptages de liste et les cleanups. Meme garde-fou que
 * CategoryFixtures.
 */
 class ClientFixtures extends Fixture implements DependentFixtureInterface
 {
    /** Cache des categories resolues par nom (evite des requetes repetees). */
    private array $categoryCache = [];
    /** Cache des sites resolus par nom. */
    private array $siteCache = [];
    /** ObjectManager courant, capture en debut de load (resolution categories). */
    private ObjectManager $manager;
    public function __construct(
        private readonly ClientFieldNormalizer $normalizer,
        private readonly SiteProviderInterface $siteProvider,
        #[Autowire('%kernel.environment%')]
        private readonly string $environment,
    ) {}
    /**
     * @return array<int, class-string>
     */
    public function getDependencies(): array
    {
        return [
            CategoryFixtures::class,
            SitesFixtures::class,
            CommercialReferentialFixtures::class,
        ];
    }
    public function load(ObjectManager $manager): void
    {
        // Donnees de demo : dev uniquement. En test, on laisse la table vierge.
        if ('test' === $this->environment) {
            return;
        }
        $this->manager = $manager;
        // === Tiers referencables (RG-1.03) : crees en premier ===
        // Distributeur reference par d'autres clients.
        [$gso, $gsoIsNew] = $this->ensureClient(
            $manager,
            companyName: 'Distrib Grand Sud-Ouest',
            firstName: 'Paul',
            lastName: 'Garnier',
            phonePrimary: '05 56 10 20 30',
            email: 'contact@distrib-gso.fr',
            categoryNames: ['Distributeur'],
        );
        if ($gsoIsNew) {
            $this->addContact($gso, 'Paul', 'Garnier', 'Directeur commercial', '05 56 10 20 30', null, 'paul.garnier@distrib-gso.fr');
            $this->addAddress($gso, ['Pommevic'], '82400', 'Pommevic', '1 Av. Jean Duquesne', isDelivery: true, categoryNames: ['Transport/Logistique']);
        }
        // Courtier reference par d'autres clients.
        [$leonard, $leonardIsNew] = $this->ensureClient(
            $manager,
            companyName: 'Cabinet Léonard Assurances',
            firstName: 'Sophie',
            lastName: 'Léonard',
            phonePrimary: '05 49 11 22 33',
            email: 'contact@cabinet-leonard.fr',
            categoryNames: ['Courtier'],
        );
        if ($leonardIsNew) {
            $this->addContact($leonard, 'Sophie', 'Léonard', 'Gérante', '05 49 11 22 33', null, 'sophie.leonard@cabinet-leonard.fr');
            $this->addAddress($leonard, ['Chatellerault'], '86100', 'Châtellerault', '5 rue des Courtiers', isBilling: true, billingEmail: 'Factures@Cabinet-Leonard.FR');
        }
        // === Client basique ===
        [$dubois, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Menuiserie Dubois',
            firstName: 'Jean',
            lastName: 'Dubois',
            phonePrimary: '05 49 00 00 01',
            email: 'contact@menuiserie-dubois.fr',
            categoryNames: ['BTP'],
        );
        if ($isNew) {
            $dubois->setPaymentType($this->paymentType($manager, 'VIREMENT'));
            $dubois->setBank($this->bank($manager, 'SG'));
            $this->addContact($dubois, 'Jean', 'Dubois', 'Gérant', '05 49 00 00 01', null, 'jean.dubois@menuiserie-dubois.fr');
            $this->addAddress($dubois, ['Chatellerault'], '86100', 'Châtellerault', '12 rue de l\'Atelier', isDelivery: true, categoryNames: ['BTP']);
        }
        // === Dependant d'un distributeur (RG-1.03) ===
        [$garage, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Garage Martin',
            firstName: 'Luc',
            lastName: 'Martin',
            phonePrimary: '05 56 44 55 66',
            email: 'accueil@garage-martin.fr',
            categoryNames: ['Services'],
        );
        if ($isNew) {
            $garage->setDistributor($gso);
            $this->addContact($garage, 'Luc', 'Martin', 'Gérant', '05 56 44 55 66', null, 'luc.martin@garage-martin.fr');
            $this->addAddress($garage, ['Pommevic'], '82400', 'Pommevic', '8 route de Moissac', isDelivery: true);
        }
        // === Dependant d'un courtier (RG-1.03) ===
        [$boulangerie, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Boulangerie Lemoine',
            firstName: 'Marie',
            lastName: 'Lemoine',
            phonePrimary: '05 49 77 88 99',
            email: 'bonjour@boulangerie-lemoine.fr',
            categoryNames: ['Agro-alimentaire'],
        );
        if ($isNew) {
            $boulangerie->setBroker($leonard);
            $this->addContact($boulangerie, 'Marie', 'Lemoine', 'Gérante', '05 49 77 88 99', null, 'marie.lemoine@boulangerie-lemoine.fr');
            $this->addAddress($boulangerie, ['Chatellerault'], '86100', 'Châtellerault', '3 place du Marché', isDelivery: true);
        }
        // === Reglement LCR avec 2 RIB (RG-1.13) ===
        [$transports, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Transports Rapides',
            firstName: null,
            lastName: 'Bernard',
            phonePrimary: '05 56 12 13 14',
            email: 'exploitation@transports-rapides.fr',
            categoryNames: ['Transport/Logistique'],
        );
        if ($isNew) {
            $transports->setPaymentType($this->paymentType($manager, 'LCR'));
            $this->addContact($transports, null, 'Bernard', 'Responsable exploitation', '05 56 12 13 14', null, 'expl@transports-rapides.fr');
            $this->addAddress($transports, ['Saint-Jean'], '17400', 'Fontenet', '2 zone industrielle', isDelivery: true, categoryNames: ['Transport/Logistique']);
            $this->addRib($transports, 'Compte principal', 'BNPAFRPPXXX', 'FR1420041010050500013M02606', 0);
            $this->addRib($transports, 'Compte secondaire', 'SOGEFRPPXXX', 'FR7630006000011234567890189', 1);
        }
        // === Multi-adresses Prospect / Livraison / Facturation (RG-1.06/07/08/11) ===
        [$industries, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Industries Vertes',
            firstName: 'Claire',
            lastName: 'Moreau',
            phonePrimary: '05 49 21 22 23',
            email: 'contact@industries-vertes.fr',
            categoryNames: ['Industrie'],
        );
        if ($isNew) {
            $this->addContact($industries, 'Claire', 'Moreau', 'Directrice', '05 49 21 22 23', null, 'claire.moreau@industries-vertes.fr');
            // Prospect : exclusif de livraison/facturation (sans billingEmail).
            $this->addAddress($industries, ['Chatellerault'], '86100', 'Châtellerault', '1 avenue de la Prospection', isProspect: true, position: 0);
            // Livraison.
            $this->addAddress($industries, ['Saint-Jean'], '17400', 'Fontenet', '4 rue de la Livraison', isDelivery: true, categoryNames: ['Industrie'], position: 1);
            // Facturation : billingEmail obligatoire.
            $this->addAddress($industries, ['Chatellerault'], '86100', 'Châtellerault', '7 boulevard des Factures', isBilling: true, billingEmail: 'Compta@Industries-Vertes.FR', position: 2);
        }
        // === 3 contacts dont un avec telephone secondaire (RG-1.05/1.02) ===
        [$agro, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Agro Distribution Sud',
            firstName: 'Thomas',
            lastName: 'Petit',
            phonePrimary: '05 56 31 32 33',
            email: 'contact@agro-sud.fr',
            categoryNames: ['Agro-alimentaire'],
            phoneSecondary: '06 01 02 03 04',
        );
        if ($isNew) {
            $this->addContact($agro, 'Thomas', 'Petit', 'Directeur des achats', '05 56 31 32 33', '06 01 02 03 04', 'thomas.petit@agro-sud.fr', 0);
            $this->addContact($agro, 'Julie', 'Roux', 'Assistante commerciale', '05 56 31 32 34', null, 'julie.roux@agro-sud.fr', 1);
            $this->addContact($agro, 'Marc', 'Girard', 'Logistique', '05 56 31 32 35', null, 'marc.girard@agro-sud.fr', 2);
            $this->addAddress($agro, ['Pommevic'], '82400', 'Pommevic', '10 rue des Producteurs', isDelivery: true);
        }
        // === Client archive (RG-1.22) ===
        [$ancienne, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Ancienne Société Oubliée',
            firstName: null,
            lastName: 'Durand',
            phonePrimary: '05 49 99 99 99',
            email: 'contact@ancienne-societe.fr',
            categoryNames: ['Association'],
            isArchived: true,
        );
        if ($isNew) {
            $this->addContact($ancienne, null, 'Durand', 'Ancien contact', '05 49 99 99 99', null, 'contact@ancienne-societe.fr');
            $this->addAddress($ancienne, ['Chatellerault'], '86100', 'Châtellerault', '99 rue Fermée', isDelivery: true);
        }
        // === Reglement Cheque sans RIB ===
        [$services, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Services Pro Conseil',
            firstName: 'Nadia',
            lastName: 'Benali',
            phonePrimary: '05 49 41 42 43',
            email: 'contact@services-pro.fr',
            categoryNames: ['Services'],
        );
        if ($isNew) {
            $services->setPaymentType($this->paymentType($manager, 'CHEQUE'));
            $this->addContact($services, 'Nadia', 'Benali', 'Consultante', '05 49 41 42 43', null, 'nadia.benali@services-pro.fr');
            $this->addAddress($services, ['Chatellerault'], '86100', 'Châtellerault', '15 rue du Conseil', isDelivery: true);
        }
        // === Onglet Information complet (RG-1.04) ===
        [$holding, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Holding Premium Invest',
            firstName: 'Antoine',
            lastName: 'Lefèvre',
            phonePrimary: '05 56 51 52 53',
            email: 'direction@holding-premium.fr',
            categoryNames: ['Industrie'],
        );
        if ($isNew) {
            $holding->setDescription('Holding industrielle diversifiée, présente sur le Grand Sud-Ouest.');
            $holding->setCompetitors('Groupe Atlantique, Sud Industries');
            $holding->setFoundedAt(new DateTimeImmutable('2005-03-15'));
            $holding->setEmployeesCount(240);
            $holding->setRevenueAmount('18500000.00');
            $holding->setDirectorName('Antoine Lefèvre');
            $holding->setProfitAmount('1250000.00');
            $this->addContact($holding, 'Antoine', 'Lefèvre', 'PDG', '05 56 51 52 53', null, 'antoine.lefevre@holding-premium.fr');
            $this->addAddress($holding, ['Pommevic'], '82400', 'Pommevic', '1 allée des Investisseurs', isDelivery: true, categoryNames: ['Industrie']);
        }
        // === Multi-categories M2M ===
        [$conglo, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Conglomérat Multi Activités',
            firstName: 'Hélène',
            lastName: 'Faure',
            phonePrimary: '05 49 61 62 63',
            email: 'contact@conglomerat-multi.fr',
            categoryNames: ['BTP', 'Industrie', 'Services'],
        );
        if ($isNew) {
            $this->addContact($conglo, 'Hélène', 'Faure', 'Directrice générale', '05 49 61 62 63', null, 'helene.faure@conglomerat-multi.fr');
            $this->addAddress($conglo, ['Chatellerault', 'Saint-Jean'], '86100', 'Châtellerault', '20 rue des Activités', isDelivery: true, categoryNames: ['BTP', 'Services']);
        }
        // === Prospect seul ===
        [$prospect, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Prospect Futur Client',
            firstName: 'Olivier',
            lastName: 'Renard',
            phonePrimary: '05 56 71 72 73',
            email: 'olivier.renard@prospect-futur.fr',
            categoryNames: ['BTP'],
        );
        if ($isNew) {
            $this->addContact($prospect, 'Olivier', 'Renard', 'Responsable projet', '05 56 71 72 73', null, 'olivier.renard@prospect-futur.fr');
            $this->addAddress($prospect, ['Chatellerault'], '86100', 'Châtellerault', '30 rue de la Découverte', isProspect: true);
        }
        // === Categorie AUTRE ===
        [$association, $isNew] = $this->ensureClient(
            $manager,
            companyName: 'Association des Riverains',
            firstName: null,
            lastName: 'Caron',
            phonePrimary: '05 49 81 82 83',
            email: 'contact@asso-riverains.fr',
            categoryNames: ['Association'],
        );
        if ($isNew) {
            $this->addContact($association, null, 'Caron', 'Président', '05 49 81 82 83', null, 'president@asso-riverains.fr');
            $this->addAddress($association, ['Saint-Jean'], '17400', 'Fontenet', '6 chemin du Village', isDelivery: true, categoryNames: ['Association']);
        }
        $manager->flush();
    }
    /**
     * Cree un client (base normalisee + categories) s'il n'existe pas encore,
     * sinon retourne l'existant. Retourne [Client, isNew] : isNew=false bloque la
     * reconstruction des sous-collections (idempotence sans doublon).
     *
     * @param list<string> $categoryNames
     *
     * @return array{0: Client, 1: bool}
     */
    private function ensureClient(
        ObjectManager $manager,
        string $companyName,
        ?string $firstName,
        ?string $lastName,
        string $phonePrimary,
        string $email,
        array $categoryNames,
        ?string $phoneSecondary = null,
        bool $isArchived = false,
    ): array {
        $normalizedName = (string) $this->normalizer->normalizeCompanyName($companyName);
        $existing = $manager->getRepository(Client::class)->findOneBy(['companyName' => $normalizedName]);
        if ($existing instanceof Client) {
            return [$existing, false];
        }
        $client = new Client();
        $client->setCompanyName($normalizedName);
        $client->setFirstName($this->normalizer->normalizePersonName($firstName));
        $client->setLastName($this->normalizer->normalizePersonName($lastName));
        $client->setPhonePrimary((string) $this->normalizer->normalizePhone($phonePrimary));
        $client->setPhoneSecondary($this->normalizer->normalizePhone($phoneSecondary));
        $client->setEmail((string) $this->normalizer->normalizeEmail($email));
        foreach ($categoryNames as $categoryName) {
            $client->addCategory($this->category($manager, $categoryName));
        }
        if ($isArchived) {
            $client->setIsArchived(true);
            $client->setArchivedAt(new DateTimeImmutable());
        }
        $manager->persist($client);
        return [$client, true];
    }
    /**
     * Ajoute un contact normalise au client (cascade persist via Client.contacts).
     * Au moins lastName est toujours fourni (RG-1.05, chk_client_contact_name).
     */
    private function addContact(
        Client $client,
        ?string $firstName,
        ?string $lastName,
        ?string $jobTitle,
        ?string $phonePrimary,
        ?string $phoneSecondary,
        ?string $email,
        int $position = 0,
    ): void {
        $contact = new ClientContact();
        $contact->setFirstName($this->normalizer->normalizePersonName($firstName));
        $contact->setLastName($this->normalizer->normalizePersonName($lastName));
        $contact->setJobTitle($jobTitle);
        $contact->setPhonePrimary($this->normalizer->normalizePhone($phonePrimary));
        $contact->setPhoneSecondary($this->normalizer->normalizePhone($phoneSecondary));
        $contact->setEmail($this->normalizer->normalizeEmail($email));
        $contact->setPosition($position);
        $client->addContact($contact);
    }
    /**
     * Ajoute une adresse au client (cascade persist via Client.addresses). Les
     * donnees respectent les validators : exclusivite Prospect, billingEmail ssi
     * facturation, aucune categorie de code DISTRIBUTEUR/COURTIER (RG-1.29).
     *
     * @param list<string> $siteNames     au moins un site (RG-1.10)
     * @param list<string> $categoryNames categories hors DISTRIBUTEUR/COURTIER (RG-1.29)
     */
    private function addAddress(
        Client $client,
        array $siteNames,
        string $postalCode,
        string $city,
        string $street,
        bool $isProspect = false,
        bool $isDelivery = false,
        bool $isBilling = false,
        ?string $billingEmail = null,
        array $categoryNames = [],
        int $position = 0,
    ): void {
        $address = new ClientAddress();
        $address->setIsProspect($isProspect);
        $address->setIsDelivery($isDelivery);
        $address->setIsBilling($isBilling);
        $address->setBillingEmail($this->normalizer->normalizeEmail($billingEmail));
        $address->setPostalCode($postalCode);
        $address->setCity($city);
        $address->setStreet($street);
        $address->setPosition($position);
        foreach ($siteNames as $siteName) {
            $address->addSite($this->site($siteName));
        }
        foreach ($categoryNames as $categoryName) {
            $address->addCategory($this->category($this->manager, $categoryName));
        }
        $client->addAddress($address);
    }
    /**
     * Ajoute un RIB au client (cascade persist via Client.ribs). IBAN/BIC valides
     * (Assert\Iban/Bic non rejouee sur persist direct mais donnees coherentes).
     */
    private function addRib(Client $client, string $label, string $bic, string $iban, int $position = 0): void
    {
        $rib = new ClientRib();
        $rib->setLabel($label);
        $rib->setBic($bic);
        $rib->setIban($iban);
        $rib->setPosition($position);
        $client->addRib($rib);
    }
    /**
     * Resout une categorie par son nom via le contrat Shared CategoryInterface
     * (resolve_target_entities -> Category), sans importer le module Catalog
     * (regle n°1). Mise en cache par nom.
     */
    private function category(ObjectManager $manager, string $name): CategoryInterface
    {
        if (isset($this->categoryCache[$name])) {
            return $this->categoryCache[$name];
        }
        $category = $manager->getRepository(CategoryInterface::class)->findOneBy([
            'name'      => $name,
            'deletedAt' => null,
        ]);
        if (!$category instanceof CategoryInterface) {
            throw new RuntimeException(sprintf(
                'Categorie "%s" introuvable : CategoryFixtures doit tourner avant ClientFixtures.',
                $name,
            ));
        }
        return $this->categoryCache[$name] = $category;
    }
    /**
     * Resout un site par son nom via le contrat Shared SiteProviderInterface,
     * sans importer le module Sites (regle n°1). Mise en cache par nom.
     */
    private function site(string $name): SiteInterface
    {
        if (isset($this->siteCache[$name])) {
            return $this->siteCache[$name];
        }
        $site = $this->siteProvider->findByName($name);
        if (!$site instanceof SiteInterface) {
            throw new RuntimeException(sprintf(
                'Site "%s" introuvable : SitesFixtures doit tourner avant ClientFixtures.',
                $name,
            ));
        }
        return $this->siteCache[$name] = $site;
    }
    private function paymentType(ObjectManager $manager, string $code): PaymentType
    {
        $type = $manager->getRepository(PaymentType::class)->findOneBy(['code' => $code]);
        if (!$type instanceof PaymentType) {
            throw new RuntimeException(sprintf(
                'PaymentType "%s" introuvable : CommercialReferentialFixtures doit tourner avant ClientFixtures.',
                $code,
            ));
        }
        return $type;
    }
    private function bank(ObjectManager $manager, string $code): Bank
    {
        $bank = $manager->getRepository(Bank::class)->findOneBy(['code' => $code]);
        if (!$bank instanceof Bank) {
            throw new RuntimeException(sprintf(
                'Bank "%s" introuvable : CommercialReferentialFixtures doit tourner avant ClientFixtures.',
                $code,
            ));
        }
        return $bank;
    }
 }
@@ -31,196 +31,17 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
        $this->getEntityManager()->flush();
    }
-    public function createListQueryBuilder(
+    public function createListQueryBuilder(bool $includeArchived = false): QueryBuilder
-        bool $includeArchived = false,
+    {
        ?string $search = null,
        array $categoryCodes = [],
        array $siteIds = [],
        bool $archivedOnly = false,
    ): QueryBuilder {
        // SELECTION uniquement (filtres + tri) : pas de fetch-join to-many ici.
        // L'hydratation des collections affichees (Catégories / Site(s)) est
        // deleguee a hydrateListCollections() une fois le jeu borne, pour ne pas
        // imposer un produit cartesien aux chemins non pagines (export,
        // ?pagination=false) — ERP-100.
        $qb = $this->createQueryBuilder('c')
            ->andWhere('c.deletedAt IS NULL')
            ->orderBy('c.companyName', 'ASC')
        ;
-        // Perimetre d'archivage : archivedOnly prioritaire sur includeArchived.
+        if (!$includeArchived) {
        if ($archivedOnly) {
            $qb->andWhere('c.isArchived = true');
        } elseif (!$includeArchived) {
            $qb->andWhere('c.isArchived = false');
        }
        $this->applySearch($qb, $search);
        $this->applyCategoryCodes($qb, $categoryCodes);
        $this->applySiteIds($qb, $siteIds);
        return $qb;
    }
    public function hydrateListCollections(array $clients): void
    {
        if ([] === $clients) {
            return;
        }
        // Ids des clients deja charges (entites managees). On rehydrate leurs
        // collections via l'identity map : les requetes ci-dessous renvoient les
        // MEMES instances Client, dont les collections sont alors remplies.
        $ids = [];
        foreach ($clients as $client) {
            $id = $client->getId();
            if (null !== $id) {
                $ids[] = $id;
            }
        }
        if ([] === $ids) {
            return;
        }
        // 1re passe : categories (colonne « Catégories »). Produit c x cat seul.
        $this->createQueryBuilder('c')
            ->leftJoin('c.categories', 'cat')->addSelect('cat')
            ->where('c.id IN (:ids)')->setParameter('ids', $ids)
            ->getQuery()
            ->getResult()
        ;
        // 2e passe : adresses + sites (colonne « Site(s) », sites portes par les
        // adresses — RG-1.10). Le join addr -> site reste imbrique mais n'est
        // plus multiplie par les categories : le cartesien global est casse.
        $this->createQueryBuilder('c')
            ->leftJoin('c.addresses', 'addr')->addSelect('addr')
            ->leftJoin('addr.sites', 'site')->addSelect('site')
            ->where('c.id IN (:ids)')->setParameter('ids', $ids)
            ->getQuery()
            ->getResult()
        ;
    }
    /**
     * Recherche fuzzy insensible a la casse sur companyName + lastName + email.
     * Les metacaracteres LIKE (%, _, \) saisis sont echappes pour rester
     * litteraux.
     */
    private function applySearch(QueryBuilder $qb, ?string $search): void
    {
        if (null === $search || '' === trim($search)) {
            return;
        }
        $escaped = str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], trim($search));
        $pattern = '%'.mb_strtolower($escaped, 'UTF-8').'%';
        $qb->andWhere(
            'LOWER(c.companyName) LIKE :search '
            .'OR LOWER(c.lastName) LIKE :search '
            .'OR LOWER(c.email) LIKE :search',
        )->setParameter('search', $pattern);
    }
    /**
     * Restreint aux clients possedant au moins une categorie dont le code figure
     * dans la liste (OR — ERP-78). Alimente le filtre « Catégories » du drawer
     * (multi) ainsi que les selects « distributeur »/« courtier » (un seul code,
     * RG-1.03). Sous-requete IN (plutot qu'un JOIN sur la collection M2M) pour ne
     * pas perturber le DISTINCT / ORDER BY principal.
     *
     * @param list<string> $categoryCodes
     */
    private function applyCategoryCodes(QueryBuilder $qb, array $categoryCodes): void
    {
        $codes = $this->normalizeStringList($categoryCodes);
        if ([] === $codes) {
            return;
        }
        $sub = $this->getEntityManager()->createQueryBuilder()
            ->select('c2.id')
            ->from(Client::class, 'c2')
            ->join('c2.categories', 'cat2')
            ->where('cat2.code IN (:categoryCodes)')
        ;
        $qb->andWhere($qb->expr()->in('c.id', $sub->getDQL()))
            ->setParameter('categoryCodes', $codes)
        ;
    }
    /**
     * Restreint aux clients ayant au moins une adresse rattachee a l'un des
     * sites donnes (OR — RG-1.10 : les sites vivent sur les adresses, pas sur le
     * client). Sous-requete IN pour ne pas perturber le tri/pagination principal.
     *
     * @param list<int> $siteIds
     */
    private function applySiteIds(QueryBuilder $qb, array $siteIds): void
    {
        $ids = $this->normalizeIntList($siteIds);
        if ([] === $ids) {
            return;
        }
        $sub = $this->getEntityManager()->createQueryBuilder()
            ->select('c3.id')
            ->from(Client::class, 'c3')
            ->join('c3.addresses', 'addr3')
            ->join('addr3.sites', 'site3')
            ->where('site3.id IN (:siteIds)')
        ;
        $qb->andWhere($qb->expr()->in('c.id', $sub->getDQL()))
            ->setParameter('siteIds', $ids)
        ;
    }
    /**
     * Nettoie une liste de chaines : trim, retrait des vides, reindexation.
     * Defensive : tolere des elements scalaires non-string (cast) et ignore le
     * reste sans lever de TypeError, le contrat etant justement de normaliser une
     * entree potentiellement brute (query params).
     *
     * @param array<mixed> $values
     *
     * @return list<string>
     */
    private function normalizeStringList(array $values): array
    {
        $out = [];
        foreach ($values as $value) {
            if (is_string($value) || is_int($value) || is_float($value)) {
                $trimmed = trim((string) $value);
                if ('' !== $trimmed) {
                    $out[] = $trimmed;
                }
            }
        }
        return $out;
    }
    /**
     * Nettoie une liste d'identifiants : cast int, retrait des <= 0, reindexation.
     * Defensive (cf. normalizeStringList) : accepte des entiers ou des chaines
     * numeriques ('1', '2') sans TypeError, ignore le reste.
     *
     * @param array<mixed> $values
     *
     * @return list<int>
     */
    private function normalizeIntList(array $values): array
    {
        $out = [];
        foreach ($values as $value) {
            if (is_numeric($value) && (int) $value > 0) {
                $out[] = (int) $value;
            }
        }
        return $out;
    }
 }
@@ -1,218 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Core\Application\Rbac;
 use App\Module\Core\Domain\Entity\Role;
 use App\Module\Core\Domain\Entity\User;
 use App\Module\Core\Domain\Exception\RbacSeedException;
 use App\Module\Core\Domain\Repository\PermissionRepositoryInterface;
 use App\Module\Core\Domain\Repository\RoleRepositoryInterface;
 use App\Module\Core\Domain\Repository\UserRepositoryInterface;
 use App\Shared\Domain\Contract\SiteProviderInterface;
 use App\Shared\Domain\Security\BusinessRoles;
 use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 /**
 * Source UNIQUE (anti-drift) du RBAC metier MALIO : les 4 roles
 * (bureau / compta / commerciale / usine), la matrice § 2.7 (role -> permissions)
 * et les comptes demo par role. Aucun de ces litteraux ne doit etre duplique
 * ailleurs (ni SQL en dur, ni autre fixture).
 *
 * Consomme par :
 *  - la commande applicative `app:seed-rbac` (presente dans le build prod, donc
 *    rejouable en recette/prod, contrairement aux fixtures `require-dev`) ;
 *  - la fixture Core dev/test (DRY : meme seeder).
 *
 * Toutes les operations sont idempotentes et non destructives :
 *  - ensureRoles() : cree un role par lookup de code (skip si present) ;
 *  - attachMatrix() : attache les permissions § 2.7 via la M2M role_permission,
 *    sans re-attacher un lien existant ; STOP explicite si un code manque ;
 *  - ensureDemoUsers() : cree un user par role (lookup par username, skip si
 *    present), rattache au role + a >= 1 site.
 */
 final class RbacSeeder
 {
    /**
     * Codes des roles metier (snake_case, regex Role respectee). `commerciale`
     * reference la constante Shared deja consommee par le ClientProcessor
     * (RG-1.04) pour eviter tout drift : un seul litteral pour ce code.
     */
    public const string ROLE_BUREAU      = 'bureau';
    public const string ROLE_COMPTA      = 'compta';
    public const string ROLE_COMMERCIALE = BusinessRoles::COMMERCIALE;
    public const string ROLE_USINE       = 'usine';
    /** Site de rattachement par defaut des comptes demo (cf. SitesFixtures). */
    private const string DEFAULT_SITE_NAME = 'Chatellerault';
    /**
     * Definition unique des 4 roles + matrice § 2.7. La cle est le code du role,
     * `label` le libelle FR affichable, `permissions` la liste des codes RBAC a
     * attacher (vide pour usine : aucun acces ; admin n'apparait pas car il
     * bypass tout via isAdmin ; `commercial.clients.archive` n'est attache a
     * aucun role metier — admin seul).
     *
     * @var array<string, array{label: string, permissions: list<string>}>
     */
    private const array MATRIX = [
        self::ROLE_BUREAU => [
            'label'       => 'Bureau',
            'permissions' => [
                'commercial.clients.view',
                'commercial.clients.manage',
            ],
        ],
        self::ROLE_COMPTA => [
            'label'       => 'Comptabilité',
            'permissions' => [
                'commercial.clients.view',
                'commercial.clients.accounting.view',
                'commercial.clients.accounting.manage',
            ],
        ],
        self::ROLE_COMMERCIALE => [
            'label'       => 'Commerciale',
            'permissions' => [
                'commercial.clients.view',
                'commercial.clients.manage',
            ],
        ],
        self::ROLE_USINE => [
            'label'       => 'Usine',
            'permissions' => [],
        ],
    ];
    public function __construct(
        private readonly RoleRepositoryInterface $roleRepository,
        private readonly PermissionRepositoryInterface $permissionRepository,
        private readonly UserRepositoryInterface $userRepository,
        private readonly SiteProviderInterface $siteProvider,
        private readonly UserPasswordHasherInterface $passwordHasher,
    ) {}
    /**
     * Cree chaque role metier absent (lookup par code). Idempotent.
     *
     * @return list<string> codes des roles effectivement crees (vide au rejeu)
     */
    public function ensureRoles(): array
    {
        $created = [];
        foreach (self::MATRIX as $code => $definition) {
            if (null !== $this->roleRepository->findByCode($code)) {
                continue;
            }
            // isSystem=false : ce sont des roles metier, supprimables par un
            // admin (contrairement aux roles systeme admin/user).
            $this->roleRepository->save(new Role($code, $definition['label'], isSystem: false));
            $created[] = $code;
        }
        return $created;
    }
    /**
     * Attache la matrice § 2.7 a chaque role via la M2M role_permission. Lookup
     * de la permission par code ; un code absent leve une RbacSeedException
     * (garde-fou : `app:sync-permissions` doit avoir tourne). Idempotent : un
     * lien deja present n'est pas recree.
     *
     * @return int nombre de liens role->permission effectivement ajoutes (0 au rejeu)
     *
     * @throws RbacSeedException si un role ou une permission de la matrice manque
     */
    public function attachMatrix(): int
    {
        $added = 0;
        foreach (self::MATRIX as $code => $definition) {
            $role = $this->roleRepository->findByCode($code);
            if (null === $role) {
                throw RbacSeedException::missingRole($code);
            }
            $touched = false;
            foreach ($definition['permissions'] as $permissionCode) {
                $permission = $this->permissionRepository->findByCode($permissionCode);
                if (null === $permission) {
                    throw RbacSeedException::missingPermission($permissionCode);
                }
                if (!$role->getPermissions()->contains($permission)) {
                    $role->addPermission($permission);
                    $touched = true;
                    ++$added;
                }
            }
            // Un seul flush par role, et seulement si un lien a change.
            if ($touched) {
                $this->roleRepository->save($role);
            }
        }
        return $added;
    }
    /**
     * Cree un compte demo par role metier (username = code du role), non-admin,
     * mot de passe hashe, rattache a son role et a >= 1 site. Lookup par
     * username : idempotent (un compte existant est laisse intact, mot de passe
     * inchange).
     *
     * @return list<string> usernames effectivement crees (vide au rejeu)
     *
     * @throws RbacSeedException si un role metier attendu est absent (ensureRoles non joue)
     */
    public function ensureDemoUsers(string $password): array
    {
        // Rattachement a un site par defaut s'il existe (les flux login / me en
        // ont besoin ; le repertoire clients n'est pas site-scope mais on reste
        // coherent avec les fixtures admin/alice/bob).
        $defaultSite = $this->siteProvider->findByName(self::DEFAULT_SITE_NAME);
        $created     = [];
        foreach (array_keys(self::MATRIX) as $code) {
            $username = $code;
            if (null !== $this->userRepository->findByUsername($username)) {
                continue;
            }
            $role = $this->roleRepository->findByCode($code);
            if (null === $role) {
                throw RbacSeedException::missingRole($code);
            }
            $user = new User();
            $user->setUsername($username);
            $user->setIsAdmin(false);
            $user->setPassword($this->passwordHasher->hashPassword($user, $password));
            $user->addRbacRole($role);
            if (null !== $defaultSite) {
                $user->addSite($defaultSite);
                $user->setCurrentSite($defaultSite);
            }
            $this->userRepository->save($user);
            $created[] = $username;
        }
        return $created;
    }
    /**
     * Liste des codes des roles metier definis (pour reporting / tests).
     *
     * @return list<string>
     */
    public static function roleCodes(): array
    {
        return array_keys(self::MATRIX);
    }
 }
@@ -1,38 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Core\Domain\Exception;
 use RuntimeException;
 /**
 * Erreur de seed RBAC (service RbacSeeder / commande app:seed-rbac).
 *
 * Deux causes possibles, toutes deux fatales et explicites :
 *  - role metier attendu introuvable (ensureRoles() n'a pas tourne avant
 *    attachMatrix() ou ensureDemoUsers()) ;
 *  - code de permission de la matrice § 2.7 absent du catalogue : signe que
 *    `app:sync-permissions` n'a pas ete joue. Le message embarque alors
 *    l'invite a lancer la synchronisation, exploitee telle quelle par la
 *    commande.
 */
 final class RbacSeedException extends RuntimeException
 {
    public static function missingRole(string $roleCode): self
    {
        return new self(sprintf(
            'Role metier "%s" introuvable. Appelle RbacSeeder::ensureRoles() avant attachMatrix()/ensureDemoUsers().',
            $roleCode,
        ));
    }
    public static function missingPermission(string $permissionCode): self
    {
        return new self(sprintf(
            'Permission "%s" (matrice § 2.7) absente du catalogue. '
            .'Lance d\'abord `bin/console app:sync-permissions` pour la poser en base, puis relance le seed RBAC.',
            $permissionCode,
        ));
    }
 }
@@ -29,16 +29,18 @@ use App\Module\Core\Infrastructure\ApiPlatform\State\Provider\AuditLogProvider;
 *   ?performed_at[after]=2026-04-01T00:00:00Z
 *   ?performed_at[before]=2026-04-30T23:59:59Z
 *
- * La pagination herite du standard global (10 items / page, max 50, cf.
+ * La pagination est assuree par le provider via DbalPaginator (implementant
- * `config/packages/api_platform.yaml`). Elle est materialisee par le
+ * ApiPlatform\State\Pagination\PaginatorInterface), ce qui genere
- * DbalPaginator du provider qui implemente PaginatorInterface — API Platform
+ * automatiquement hydra:view — aucune construction manuelle.
 * genere automatiquement hydra:view sans construction manuelle.
 */
 #[ApiResource(
    shortName: 'AuditLog',
    operations: [
        new GetCollection(
            uriTemplate: '/audit-logs',
            paginationItemsPerPage: 30,
            paginationClientItemsPerPage: true,
            paginationMaximumItemsPerPage: 50,
            security: "is_granted('core.audit_log.view')",
            provider: AuditLogProvider::class,
        ),
@@ -68,13 +68,6 @@ final readonly class AuditLogProvider implements ProviderInterface
     */
    private function provideCollection(Operation $operation, array $context): DbalPaginator
    {
        // Contrairement aux ressources ORM (cf. CategoryProvider), ce provider
        // ne gere PAS l'echappatoire `?pagination=false` : la pagination y est
        // toujours forcee. `audit_log` est une table append-only a croissance
        // infinie — la dumper entierement saturerait memoire/reseau et n'a aucun
        // usage front (pas de <select> alimente par l'audit). Le flag global
        // `pagination_client_enabled: true` reste donc volontairement inerte ici.
        //
        // `page` brut peut etre <= 0 (parametre client) → OFFSET negatif → 500 PG
        // (`SQLSTATE[22023] OFFSET must not be negative`). API Platform clampe
        // `itemsPerPage` au max de la resource mais pas `page` ; on impose un
@@ -1,138 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Core\Infrastructure\Console;
 use App\Module\Core\Application\Rbac\RbacSeeder;
 use App\Module\Core\Domain\Exception\RbacSeedException;
 use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console\Style\SymfonyStyle;
 /**
 * Seed RBAC metier idempotent et NON destructif (cf. ERP-74 / spec-back M1
 * § 2.7). Contrairement aux fixtures Doctrine (`require-dev`, absentes du build
 * prod `--no-dev`), cette commande applicative est presente dans l'image prod :
 * elle est donc rejouable en recette/staging/prod.
 *
 * Etape de release : a lancer APRES `doctrine:migrations:migrate` et
 * `app:sync-permissions`.
 *  - En prod : `app:seed-rbac` (roles + matrice § 2.7, sans comptes demo).
 *  - En recette : `app:seed-rbac --with-demo-users --password=<...>` pour
 *    disposer de logins de test.
 *
 * Toute la logique (litteraux des roles, matrice, comptes demo) vit dans
 * RbacSeeder — cette commande n'en est que l'enveloppe CLI.
 */
 #[AsCommand(
    name: 'app:seed-rbac',
    description: 'Seede les roles metier RBAC + la matrice § 2.7 (idempotent, non destructif).',
 )]
 final class SeedRbacCommand extends Command
 {
    /** Variable d'environnement de repli pour le mot de passe des comptes demo. */
    private const string PASSWORD_ENV = 'RBAC_DEMO_PASSWORD';
    public function __construct(private readonly RbacSeeder $seeder)
    {
        parent::__construct();
    }
    protected function configure(): void
    {
        $this
            ->addOption(
                'with-demo-users',
                null,
                InputOption::VALUE_NONE,
                'Cree aussi un compte demo par role metier (recette/dev — JAMAIS en prod).',
            )
            ->addOption(
                'password',
                null,
                InputOption::VALUE_REQUIRED,
                'Mot de passe des comptes demo (defaut : variable d\'env '.self::PASSWORD_ENV.'). Requis avec --with-demo-users.',
            )
        ;
    }
    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);
        // 1. Roles metier + matrice § 2.7. attachMatrix() exige que les
        // permissions soient en base : sinon RbacSeedException porteuse de
        // l'invite a lancer `app:sync-permissions`.
        try {
            $createdRoles = $this->seeder->ensureRoles();
            $addedLinks   = $this->seeder->attachMatrix();
        } catch (RbacSeedException $e) {
            $io->error($e->getMessage());
            return Command::FAILURE;
        }
        $io->text(sprintf(
            'Roles metier : %d cree(s), matrice § 2.7 : %d lien(s) ajoute(s).',
            count($createdRoles),
            $addedLinks,
        ));
        // 2. Comptes demo (optionnel, jamais en prod).
        if ((bool) $input->getOption('with-demo-users')) {
            $password = $this->resolveDemoPassword($input);
            if (null === $password) {
                $io->error(sprintf(
                    '--with-demo-users exige un mot de passe : passe --password=<...> ou definis la variable d\'env %s. '
                    .'(Aucun mot de passe en dur cote serveur.)',
                    self::PASSWORD_ENV,
                ));
                return Command::FAILURE;
            }
            try {
                $createdUsers = $this->seeder->ensureDemoUsers($password);
            } catch (RbacSeedException $e) {
                $io->error($e->getMessage());
                return Command::FAILURE;
            }
            $io->text(sprintf(
                'Comptes demo : %d cree(s)%s.',
                count($createdUsers),
                [] === $createdUsers ? '' : ' ['.implode(', ', $createdUsers).']',
            ));
        }
        $io->success('Seed RBAC metier termine (idempotent).');
        return Command::SUCCESS;
    }
    /**
     * Resout le mot de passe demo : option `--password` prioritaire, sinon
     * variable d'environnement. Renvoie null si aucun n'est fourni (la commande
     * refuse alors --with-demo-users plutot que d'inventer un mot de passe).
     */
    private function resolveDemoPassword(InputInterface $input): ?string
    {
        /** @var null|string $option */
        $option = $input->getOption('password');
        if (null !== $option && '' !== $option) {
            return $option;
        }
        $env = $_SERVER[self::PASSWORD_ENV] ?? $_ENV[self::PASSWORD_ENV] ?? getenv(self::PASSWORD_ENV);
        if (is_string($env) && '' !== $env) {
            return $env;
        }
        return null;
    }
 }
@@ -28,11 +28,6 @@ use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 * systeme de maniere idempotente avant de rattacher les utilisateurs, afin
 * que le workflow "make db-reset && make fixtures" reste one-shot.
 *
 * Idempotence complete (y compris `doctrine:fixtures:load --append`, sans
 * purge) : roles via ensureSystemRole, utilisateurs via ensureUser (lookup par
 * username). Rejouer la fixture ne cree donc aucun doublon ni violation
 * d'unicite de username.
 *
 * Dependance explicite a SitesFixtures (ticket 2) : les 3 sites Chatellerault,
 * Saint-Jean et Pommevic doivent etre presents en base avant d'etre rattaches
 * aux users. L'inversion volontaire de l'ordre (AppFixtures ← SitesFixtures)
@@ -80,7 +75,8 @@ class AppFixtures extends Fixture implements DependentFixtureInterface
        $saintJean     = $this->requireSite('Saint-Jean');
        $pommevic      = $this->requireSite('Pommevic');
-        $admin = $this->ensureUser($manager, 'admin');
+        $admin = new User();
        $admin->setUsername('admin');
        $admin->setIsAdmin(true);
        $admin->setPassword($this->passwordHasher->hashPassword($admin, 'admin'));
        $admin->addRbacRole($adminRole);
@@ -91,7 +87,8 @@ class AppFixtures extends Fixture implements DependentFixtureInterface
        $admin->setCurrentSite($chatellerault);
        $manager->persist($admin);
-        $alice = $this->ensureUser($manager, 'alice');
+        $alice = new User();
        $alice->setUsername('alice');
        $alice->setPassword($this->passwordHasher->hashPassword($alice, 'alice'));
        $alice->addRbacRole($userRole);
        // Alice : un seul site, site courant = ce site.
@@ -99,7 +96,8 @@ class AppFixtures extends Fixture implements DependentFixtureInterface
        $alice->setCurrentSite($chatellerault);
        $manager->persist($alice);
-        $bob = $this->ensureUser($manager, 'bob');
+        $bob = new User();
        $bob->setUsername('bob');
        $bob->setPassword($this->passwordHasher->hashPassword($bob, 'bob'));
        $bob->addRbacRole($userRole);
        // Bob : site different de Alice, pour prouver le filtrage par site
@@ -137,27 +135,6 @@ class AppFixtures extends Fixture implements DependentFixtureInterface
        return $role;
    }
    /**
     * Retourne l'utilisateur correspondant au username, en le creant s'il
     * n'existe pas encore. Rend la fixture idempotente y compris en
     * `doctrine:fixtures:load --append` (sans purge) : sans ce lookup, recreer
     * « admin » / « alice » / « bob » violerait l'unicite de username. Meme
     * esprit que ensureSystemRole ci-dessus et RbacDemoFixtures::ensureDemoUsers.
     */
    private function ensureUser(ObjectManager $manager, string $username): User
    {
        $user = $manager->getRepository(User::class)->findOneBy(['username' => $username]);
        if (null !== $user) {
            return $user;
        }
        $user = new User();
        $user->setUsername($username);
        return $user;
    }
    private function requireSite(string $name): SiteInterface
    {
        $site = $this->siteProvider->findByName($name);
@@ -1,56 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Module\Core\Infrastructure\DataFixtures;
 use App\Module\Core\Application\Rbac\RbacSeeder;
 use App\Module\Sites\Infrastructure\DataFixtures\SitesFixtures;
 use Doctrine\Bundle\FixturesBundle\Fixture;
 use Doctrine\Common\DataFixtures\DependentFixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 /**
 * Fixture dev/test des roles metier MALIO (bureau / compta / commerciale /
 * usine) + comptes demo associes. DRY : delegue au MEME service RbacSeeder que
 * la commande `app:seed-rbac`, de sorte que `make db-reset` reproduise l'etat
 * de recette.
 *
 * Depend de SitesFixtures : les comptes demo sont rattaches au site par defaut
 * (cf. RbacSeeder::DEFAULT_SITE_NAME).
 *
 * ⚠ N'attache PAS la matrice § 2.7 ici : `doctrine:fixtures:load` PURGE la table
 * `permission` avant de charger, donc les codes `commercial.clients.*` ne sont
 * pas encore en base au moment du load (cf. ordre du makefile : fixtures PUIS
 * `app:sync-permissions`). La matrice est attachee juste apres, par l'etape
 * `app:seed-rbac` du makefile (db-reset / test-db-setup), via le meme seeder.
 * Resultat final identique a la recette : roles + matrice + comptes demo.
 */
 final class RbacDemoFixtures extends Fixture implements DependentFixtureInterface
 {
    /**
     * Mot de passe DEV/TEST connu des comptes demo (bureau / compta /
     * commerciale / usine). Reference par les tests fonctionnels de matrice
     * RBAC. Sans rapport avec la prod : en recette/prod le mot de passe est
     * fourni explicitement a `app:seed-rbac --with-demo-users --password=...`.
     */
    public const string DEMO_PASSWORD = 'demo';
    public function __construct(private readonly RbacSeeder $seeder) {}
    /**
     * @return array<int, class-string>
     */
    public function getDependencies(): array
    {
        return [SitesFixtures::class];
    }
    public function load(ObjectManager $manager): void
    {
        // Idempotent : ensureRoles puis ensureDemoUsers (lookup par code /
        // username). La matrice est volontairement deferree (cf. docblock).
        $this->seeder->ensureRoles();
        $this->seeder->ensureDemoUsers(self::DEMO_PASSWORD);
    }
 }
@@ -20,25 +20,13 @@ interface CategoryInterface
    public function getName(): ?string;
    /**
     * Code technique stable de la categorie (Category::code), ou null si non
     * encore renseigne. Slug MAJUSCULE derive du nom a la creation, fige ensuite.
     * Expose pour permettre a un module tiers de filtrer/valider par categorie
     * metier sans dependre du libelle (`name`) ni de l'`id` (non deterministe
     * entre environnements) ni importer la classe concrete Category (regle
     * ABSOLUE n°1). Pilote, cote M1 Commercial :
     *  - RG-1.03 : un distributor doit referencer un client portant la categorie
     *    de code DISTRIBUTEUR (resp. COURTIER pour broker) ;
     *  - RG-1.29 : une adresse interdit les categories de code DISTRIBUTEUR /
     *    COURTIER (relations entre clients, pas des attributs d'adresse).
     */
    public function getCode(): ?string;
    /**
     * Code du type de categorie rattache (CategoryType::code), ou null si la
-     * categorie n'a pas de type. Depuis ERP-78, le modele n'a plus qu'un seul
+     * categorie n'a pas de type. Expose pour permettre a un module tiers de
-     * type (CLIENT) : le filtrage metier passe desormais par getCode() ci-dessus.
+     * raisonner sur le type metier (ex: M1 Commercial — RG-1.03 : un distributor
-     * Conserve pour l'affichage / la retrocompatibilite.
+     * doit referencer un client categorise DISTRIBUTEUR ; RG-1.29 : categorie
     * d'adresse limitee a SECTEUR/AUTRE) sans importer la classe concrete
     * Category (regle ABSOLUE n°1).
     */
    public function getCategoryTypeCode(): ?string;
 }
@@ -1,31 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Shared\Domain\Contract;
 /**
 * Contrat d'export d'une feuille de calcul tabulaire vers un binaire XLSX.
 *
 * Service GENERIQUE et reutilisable : il ne connait aucune entite metier. Le
 * module appelant decide QUOI exporter (en-tetes + lignes deja mappees) ; cette
 * interface decrit seulement COMMENT produire le fichier. Aucun module n'est
 * couple a une implementation concrete : on depend de ce contrat (dans Shared),
 * jamais l'inverse (regle ABSOLUE n°1).
 *
 * Implementee par App\Shared\Infrastructure\Export\PhpSpreadsheetExporter (on
 * ne la reference pas via @see pour ne pas creer un import Domain -> Infra).
 */
 interface SpreadsheetExporterInterface
 {
    /**
     * Genere un classeur XLSX a une feuille et retourne son contenu binaire.
     *
     * @param string                      $sheetTitle titre de l'onglet (assaini / tronque par l'implementation si besoin)
     * @param list<string>                $headers    libelles de la ligne d'en-tete (ligne 1)
     * @param iterable<list<null|scalar>> $rows       lignes de donnees ; chaque ligne est une liste de cellules alignee sur $headers
     *
     * @return string contenu binaire du fichier XLSX
     */
    public function export(string $sheetTitle, array $headers, iterable $rows): string;
 }
@@ -1,60 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Shared\Infrastructure\Database;
 /**
 * Miroir SQL de `CategoryCodeGenerator::slugify()` (module Catalog, ERP-78).
 *
 * Le `code` d'une `Category` est un slug MAJUSCULE deterministe du nom. A
 * l'execution (POST/PATCH API), il est genere en PHP par `CategoryCodeGenerator`
 * via `AsciiSlugger`. Mais la migration corrective `Version20260602100000` doit
 * backfiller le `code` des categories pre-existantes en SQL pur (le backfill
 * tourne dans le plan `addSql`, sans acces aux services applicatifs).
 *
 * Deux implementations d'un meme slug = risque de derive : un nom accentue
 * comme « Independant » doit produire le MEME code (`INDEPENDANT`) quel que soit
 * le chemin. Cette classe est la SOURCE UNIQUE de l'expression SQL ; son egalite
 * avec le générateur PHP est verrouillee par `CategoryCodeSqlSlugTest`.
 *
 * Domaine couvert : noms francais / Latin-1 (tous les accents, minuscule +
 * majuscule, translitteres vers l'ASCII comme le fait `AsciiSlugger`). Limite
 * connue et assumee : les ligatures (`Œ`->`OE`, `ß`->`SS`) ne sont PAS gerees
 * par `translate()` (mapping 1->1 uniquement) ; elles n'apparaissent pas dans
 * les noms de categories CLIENT et le backfill ne s'execute de toute facon que
 * sur des bases dev deja peuplees (en prod la table `category` est vide).
 */
 final class CategoryCodeSql
 {
    /** Longueur maximale de la colonne `category.code` (cf. CategoryCodeGenerator). */
    private const int MAX_LENGTH = 50;
    /**
     * Accents Latin-1 (minuscules puis majuscules) translitteres vers leur
     * equivalent ASCII minuscule — `UPPER()` repasse tout en majuscule ensuite.
     * `translate()` mappe caractere a caractere : `ACCENT_FROM` et `ACCENT_TO`
     * doivent avoir EXACTEMENT le meme nombre de caracteres.
     */
    private const string ACCENT_FROM = 'àâäáãåçéèêëíìîïñóòôöõúùûüýÿÀÂÄÁÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸ';
    private const string ACCENT_TO   = 'aaaaaaceeeeiiiinooooouuuuyyaaaaaaceeeeiiiinooooouuuuyy';
    /**
     * Expression SQL produisant le slug du `$column` donne (ex: `name`, `c.name`).
     * Reproduit fidelement `CategoryCodeGenerator::slugify` : translitteration des
     * accents, separateurs non alphanumeriques reduits a `_`, MAJUSCULE, borne a
     * 50, `_` de bord retires, fallback `CATEGORY` si vide.
     */
    public static function slugExpression(string $column): string
    {
        return sprintf(
            "COALESCE(NULLIF(TRIM(BOTH '_' FROM "
            ."LEFT(UPPER(REGEXP_REPLACE(translate(%s, '%s', '%s'), '[^A-Za-z0-9]+', '_', 'g')), %d)"
            ."), ''), 'CATEGORY')",
            $column,
            self::ACCENT_FROM,
            self::ACCENT_TO,
            self::MAX_LENGTH,
        );
    }
 }
@@ -53,7 +53,6 @@ final class ColumnCommentsCatalog
                '_table'           => 'Categories M0 — referentiel type par category_type, soft-delete via deleted_at, unicite (LOWER(name), category_type_id) parmi les actifs.',
                'id'               => 'Identifiant interne auto-incremente.',
                'name'             => 'Libelle de la categorie (≤ 120 caracteres) — unique par type parmi les actifs (RG-1.06).',
                'code'             => 'Code technique stable (slug MAJUSCULE du nom, ≤ 50) — unique parmi les actifs (uq_category_code). Fige a la creation. DISTRIBUTEUR/COURTIER pilotent RG-1.03/1.29.',
                'category_type_id' => 'Reference au type de la categorie — FK -> category_type.id, ON DELETE RESTRICT (un type ne peut etre supprime tant qu il a des categories).',
                'deleted_at'       => 'Horodatage UTC du soft-delete (archivage logique) — null si la categorie est active.',
            ] + self::timestampableBlamableComments(),
@@ -6,12 +6,12 @@ namespace App\Shared\Infrastructure\Doctrine;
 use App\Shared\Domain\Contract\BlamableInterface;
 use App\Shared\Domain\Contract\TimestampableInterface;
 use DateTimeImmutable;
 use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
 use Doctrine\ORM\Event\PrePersistEventArgs;
 use Doctrine\ORM\Event\PreUpdateEventArgs;
 use Doctrine\ORM\Events;
 use Symfony\Bundle\SecurityBundle\Security;
 use Symfony\Component\Clock\ClockInterface;
 use Symfony\Component\Security\Core\User\UserInterface;
 /**
@@ -30,19 +30,12 @@ use Symfony\Component\Security\Core\User\UserInterface;
 #[AsDoctrineListener(event: Events::preUpdate)]
 final class TimestampableBlamableSubscriber
 {
-    // L'horloge est injectee (et non un `new DateTimeImmutable()` direct) pour
+    public function __construct(private readonly Security $security) {}
    // que les tests puissent figer/avancer le temps de facon deterministe via
    // ClockSensitiveTrait (cf. ERP-98). En prod, le service `clock` delegue a
    // l'horloge systeme reelle.
    public function __construct(
        private readonly Security $security,
        private readonly ClockInterface $clock,
    ) {}
    public function prePersist(PrePersistEventArgs $args): void
    {
        $entity = $args->getObject();
-        $now    = $this->clock->now();
+        $now    = new DateTimeImmutable();
        $user   = $this->security->getUser();
        if ($entity instanceof TimestampableInterface) {
@@ -62,7 +55,7 @@ final class TimestampableBlamableSubscriber
        $user   = $this->security->getUser();
        if ($entity instanceof TimestampableInterface) {
-            $entity->setUpdatedAt($this->clock->now());
+            $entity->setUpdatedAt(new DateTimeImmutable());
        }
        if ($entity instanceof BlamableInterface && $user instanceof UserInterface) {
@@ -1,85 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Shared\Infrastructure\Export;
 use App\Shared\Domain\Contract\SpreadsheetExporterInterface;
 use PhpOffice\PhpSpreadsheet\Spreadsheet;
 use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
 use RuntimeException;
 /**
 * Implementation XLSX du contrat d'export via la librairie PhpSpreadsheet.
 *
 * Strictement technique : ecrit la ligne d'en-tete puis les lignes de donnees
 * dans l'unique feuille du classeur, et retourne le binaire. Aucune logique
 * metier, aucune reference a une entite d'un module — le mapping des colonnes
 * est de la responsabilite de l'appelant.
 */
 final class PhpSpreadsheetExporter implements SpreadsheetExporterInterface
 {
    // Excel limite le titre d'un onglet a 31 caracteres et interdit certains
    // caracteres ; on assainit pour ne jamais faire echouer setTitle().
    private const int MAX_SHEET_TITLE_LENGTH = 31;
    private const string INVALID_TITLE_CHARS = '*:/\?[]';
    public function export(string $sheetTitle, array $headers, iterable $rows): string
    {
        $spreadsheet = new Spreadsheet();
        $sheet       = $spreadsheet->getActiveSheet();
        $sheet->setTitle($this->sanitizeSheetTitle($sheetTitle));
        // Ligne 1 : en-tete.
        $sheet->fromArray($headers, null, 'A1');
        // Lignes 2..n : donnees. Iteration manuelle pour supporter un iterable
        // paresseux (generator) sans tout materialiser en memoire.
        $rowNumber = 2;
        foreach ($rows as $row) {
            $sheet->fromArray($row, null, 'A'.$rowNumber);
            ++$rowNumber;
        }
        return $this->toBinary($spreadsheet);
    }
    private function toBinary(Spreadsheet $spreadsheet): string
    {
        $writer = new Xlsx($spreadsheet);
        // Le writer ecrit vers un chemin de fichier : on passe par un fichier
        // temporaire puis on lit son contenu binaire.
        $tmpFile = tempnam(sys_get_temp_dir(), 'xlsx_export_');
        if (false === $tmpFile) {
            throw new RuntimeException('Impossible de creer un fichier temporaire pour l\'export XLSX.');
        }
        try {
            $writer->save($tmpFile);
            $binary = file_get_contents($tmpFile);
            if (false === $binary) {
                throw new RuntimeException('Lecture du fichier XLSX temporaire impossible.');
            }
            return $binary;
        } finally {
            // Libere les references internes de PhpSpreadsheet puis supprime le
            // fichier temporaire, meme en cas d'exception.
            $spreadsheet->disconnectWorksheets();
            @unlink($tmpFile);
        }
    }
    /**
     * Retire les caracteres interdits et tronque a 31 caracteres ; renvoie un
     * titre par defaut si la chaine resultante est vide.
     */
    private function sanitizeSheetTitle(string $title): string
    {
        $clean = str_replace(str_split(self::INVALID_TITLE_CHARS), '', $title);
        $clean = mb_substr($clean, 0, self::MAX_SHEET_TITLE_LENGTH);
        return '' === $clean ? 'Export' : $clean;
    }
 }
@@ -1,256 +0,0 @@
 {
    "api-platform/symfony": {
        "version": "4.3",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "4.0",
            "ref": "e9952e9f393c2d048f10a78f272cd35e807d972b"
        },
        "files": [
            "config/packages/api_platform.yaml",
            "config/routes/api_platform.yaml",
            "src/ApiResource/.gitignore"
        ]
    },
    "doctrine/deprecations": {
        "version": "1.1",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "1.0",
            "ref": "fdd756167454623e21f1d769c5b814b243782a67"
        }
    },
    "doctrine/doctrine-bundle": {
        "version": "3.2",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "3.0",
            "ref": "d39a3bd844edfe90c20ae520b804a3bf4f82b4ad"
        },
        "files": [
            "config/packages/doctrine.yaml",
            "src/Entity/.gitignore",
            "src/Repository/.gitignore"
        ]
    },
    "doctrine/doctrine-fixtures-bundle": {
        "version": "4.3",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "3.0",
            "ref": "1f5514cfa15b947298df4d771e694e578d4c204d"
        },
        "files": [
            "src/DataFixtures/AppFixtures.php"
        ]
    },
    "doctrine/doctrine-migrations-bundle": {
        "version": "4.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "3.1",
            "ref": "1d01ec03c6ecbd67c3375c5478c9a423ae5d6a33"
        },
        "files": [
            "config/packages/doctrine_migrations.yaml",
            "migrations/.gitignore"
        ]
    },
    "friendsofphp/php-cs-fixer": {
        "version": "3.94",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "3.39",
            "ref": "97aaf9026490db73b86c23d49e5774bc89d2b232"
        },
        "files": [
            ".php-cs-fixer.dist.php"
        ]
    },
    "lexik/jwt-authentication-bundle": {
        "version": "3.2",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "2.5",
            "ref": "e9481b233a11ef7e15fe055a2b21fd3ac1aa2bb7"
        },
        "files": [
            "config/packages/lexik_jwt_authentication.yaml"
        ]
    },
    "nelmio/cors-bundle": {
        "version": "2.6",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "1.5",
            "ref": "6bea22e6c564fba3a1391615cada1437d0bde39c"
        },
        "files": [
            "config/packages/nelmio_cors.yaml"
        ]
    },
    "nyholm/psr7": {
        "version": "1.8",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "1.0",
            "ref": "4a8c0345442dcca1d8a2c65633dcf0285dd5a5a2"
        },
        "files": [
            "config/packages/nyholm_psr7.yaml"
        ]
    },
    "phpunit/phpunit": {
        "version": "13.1",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "11.1",
            "ref": "ca0bc067abfb40a8de1b2561b96cbfc2b833c314"
        },
        "files": [
            ".env.test",
            "phpunit.dist.xml",
            "tests/bootstrap.php",
            "bin/phpunit"
        ]
    },
    "symfony/console": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "5.3",
            "ref": "1781ff40d8a17d87cf53f8d4cf0c8346ed2bb461"
        },
        "files": [
            "bin/console"
        ]
    },
    "symfony/flex": {
        "version": "2.10",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "2.4",
            "ref": "52e9754527a15e2b79d9a610f98185a1fe46622a"
        },
        "files": [
            ".env",
            ".env.dev"
        ]
    },
    "symfony/framework-bundle": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.4",
            "ref": "d5dcd308c8becd725c9d8b91e31aab1ff0bbc30b"
        },
        "files": [
            "config/packages/cache.yaml",
            "config/packages/framework.yaml",
            "config/preload.php",
            "config/routes/framework.yaml",
            "config/services.yaml",
            "public/index.php",
            "src/Controller/.gitignore",
            "src/Kernel.php",
            ".editorconfig"
        ]
    },
    "symfony/monolog-bundle": {
        "version": "4.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "3.7",
            "ref": "1b9efb10c54cb51c713a9391c9300ff8bceda459"
        },
        "files": [
            "config/packages/monolog.yaml"
        ]
    },
    "symfony/property-info": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.3",
            "ref": "dae70df71978ae9226ae915ffd5fad817f5ca1f7"
        },
        "files": [
            "config/packages/property_info.yaml"
        ]
    },
    "symfony/routing": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.4",
            "ref": "bc94c4fd86f393f3ab3947c18b830ea343e51ded"
        },
        "files": [
            "config/packages/routing.yaml",
            "config/routes.yaml"
        ]
    },
    "symfony/security-bundle": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.4",
            "ref": "c42fee7802181cdd50f61b8622715829f5d2335c"
        },
        "files": [
            "config/packages/security.yaml",
            "config/routes/security.yaml"
        ]
    },
    "symfony/twig-bundle": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "6.4",
            "ref": "f250159ebe99153d0c640a3e7742876fc7453f2c"
        },
        "files": [
            "config/packages/twig.yaml",
            "templates/base.html.twig"
        ]
    },
    "symfony/uid": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.0",
            "ref": "0df5844274d871b37fc3816c57a768ffc60a43a5"
        }
    },
    "symfony/validator": {
        "version": "8.0",
        "recipe": {
            "repo": "github.com/symfony/recipes",
            "branch": "main",
            "version": "7.0",
            "ref": "8c1c4e28d26a124b0bb273f537ca8ce443472bfd"
        },
        "files": [
            "config/packages/validator.yaml"
        ]
    }
 }
@@ -1,167 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Architecture;
 use App\Shared\Domain\Attribute\Auditable;
 use PHPUnit\Framework\TestCase;
 use ReflectionClass;
 use Symfony\Component\Finder\Finder;
 use function is_string;
 use function sprintf;
 use const JSON_THROW_ON_ERROR;
 /**
 * Garde-fou architecture : toute entite `#[Auditable]` doit avoir son libelle
 * i18n dans le bloc `audit.entity` du `fr.json` du shell.
 *
 * Pourquoi : le filtre « Type d'entite » de l'audit-log est dynamique
 * (`GET /audit-log-entity-types` renvoie les `entity_type` distincts presents
 * en base). Des qu'un module audite une entite, un nouveau type apparait. Le
 * rendu front (`formatEntityType`, audit-log.vue) construit la cle
 * `audit.entity.<module>_<entity>` et, faute de traduction, retombe
 * SILENCIEUSEMENT sur le type technique brut (ex: `commercial.Client`). Le
 * manque passe donc inapercu jusqu'a observation dans l'UI.
 *
 * Ce test rend le manque BLOQUANT (meme esprit que ColumnsHaveSqlCommentTest) :
 * il scanne les entites `#[Auditable]` sous `src/Module/<m>/Domain/Entity/`,
 * derive la cle attendue comme le fait le front, et echoue si elle est absente
 * du `fr.json`.
 *
 * Derivation de la cle (miroir exact de AuditListener::formatEntityType + de
 * formatEntityType cote front) :
 *   FQCN `App\Module\Commercial\Domain\Entity\ClientAddress`
 *     -> entity_type `commercial.ClientAddress`   (module en minuscules, Entity intacte)
 *     -> cle i18n    `commercial_clientaddress`   (tout en minuscules, `.` -> `_`)
 *
 * @internal
 */
 final class AuditableEntitiesHaveI18nLabelTest extends TestCase
 {
    /**
     * Chemin du fichier de traductions FR du shell. Source unique des libelles
     * d'entite audit (decision ERP-99 : emplacement centralise, schema flat).
     */
    private const LOCALE_FILE = __DIR__.'/../../frontend/i18n/locales/fr.json';
    public function testEveryAuditableEntityHasAnI18nLabel(): void
    {
        $labels = $this->loadAuditEntityLabels();
        $finder = new Finder()
            ->files()
            ->in(__DIR__.'/../../src/Module')
            ->path('Domain/Entity')
            ->name('*.php')
        ;
        // Garde : si le scan ne trouve rien, le chemin est casse — le test
        // deviendrait un faux positif vert. On verifie qu'il a du grain a moudre.
        self::assertNotEmpty(iterator_to_array($finder), 'Aucune entite scannee : chemin src/Module invalide ?');
        $checked = 0;
        foreach ($finder as $file) {
            $fqcn = $this->extractFqcn($file->getRealPath());
            if (null === $fqcn) {
                continue;
            }
            $reflection = new ReflectionClass($fqcn);
            // On ne s'interesse qu'aux entites reellement auditees.
            if ($reflection->isAbstract() || [] === $reflection->getAttributes(Auditable::class)) {
                continue;
            }
            $key = $this->deriveI18nKey($fqcn);
            self::assertNotNull(
                $key,
                sprintf('Entite %s hors structure modulaire attendue (App\Module\<M>\Domain\Entity\<E>).', $fqcn),
            );
            self::assertArrayHasKey(
                $key,
                $labels,
                sprintf(
                    'L\'entite auditable %s n\'a pas de libelle i18n. Ajouter "%s" dans le bloc '
                    .'`audit.entity` de frontend/i18n/locales/fr.json (sinon le filtre audit-log '
                    .'affiche le type technique brut). Cf. ERP-99 + .claude/rules/backend.md § Audit.',
                    $fqcn,
                    $key,
                ),
            );
            self::assertNotSame('', trim($labels[$key]), sprintf('Le libelle audit "%s" est vide.', $key));
            ++$checked;
        }
        // Garde : au moins une entite auditable doit avoir ete verifiee, sinon
        // la detection de l'attribut est cassee (faux positif vert).
        self::assertGreaterThan(0, $checked, 'Aucune entite #[Auditable] detectee : detection d\'attribut cassee ?');
    }
    /**
     * Charge le bloc `audit.entity` du fr.json sous forme de map cle -> libelle.
     *
     * @return array<string, string>
     */
    private function loadAuditEntityLabels(): array
    {
        $raw = file_get_contents(self::LOCALE_FILE);
        self::assertIsString($raw, sprintf('Fichier de locale introuvable : %s', self::LOCALE_FILE));
        /** @var array<string, mixed> $json */
        $json = json_decode($raw, true, flags: JSON_THROW_ON_ERROR);
        $entity = $json['audit']['entity'] ?? null;
        self::assertIsArray($entity, 'Bloc `audit.entity` absent ou invalide dans fr.json.');
        $labels = [];
        foreach ($entity as $key => $value) {
            if (is_string($key) && is_string($value)) {
                $labels[$key] = $value;
            }
        }
        return $labels;
    }
    /**
     * Derive la cle i18n `<module>_<entity>` depuis le FQCN, en miroir de
     * AuditListener::formatEntityType (module en minuscules) suivi de
     * l'aplatissement front (tout en minuscules, `.` -> `_`).
     *
     * Retourne null si le FQCN ne respecte pas la structure modulaire.
     */
    private function deriveI18nKey(string $fqcn): ?string
    {
        if (1 !== preg_match('#^App\\\Module\\\(?<module>[^\\\]+)\\\.+\\\(?<entity>[^\\\]+)$#', $fqcn, $m)) {
            return null;
        }
        return strtolower($m['module']).'_'.strtolower($m['entity']);
    }
    /**
     * Extrait le FQCN (namespace + classe) d'un fichier PHP par lecture du
     * source, sans charger le fichier.
     */
    private function extractFqcn(string $path): ?string
    {
        $source = file_get_contents($path);
        if (false === $source) {
            return null;
        }
        if (
            1 !== preg_match('/^namespace\s+([^;]+);/m', $source, $nsMatch)
            || 1 !== preg_match('/^(?:final\s+|abstract\s+|readonly\s+)*class\s+(\w+)/m', $source, $classMatch)
        ) {
            return null;
        }
        return trim($nsMatch[1]).'\\'.$classMatch[1];
    }
 }
@@ -1,126 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Architecture;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\GetCollection;
 use PHPUnit\Framework\TestCase;
 use ReflectionClass;
 use Symfony\Component\Finder\Finder;
 /**
 * Garde-fou architecture : toute operation `GetCollection` exposee via API Platform
 * doit avoir la pagination activee (ou laisser la valeur par defaut, qui est
 * activee globalement dans `config/packages/api_platform.yaml`).
 *
 * Interdit : `new GetCollection(paginationEnabled: false)` sans exception documentee.
 *
 * Raison : une collection non paginee peut retourner des milliers de lignes et
 * saturer la memoire du serveur, le reseau et le navigateur. La pagination est la
 * seule protection fiable contre ce risque sur un CRM a donnees croissantes.
 *
 * Quand ajouter une entree dans `EXCLUDED` :
 * - La collection est structurellement bornee (referentiel statique, < 100 items,
 *   jamais alimente par des utilisateurs) ET la suppression de la pagination est
 *   documentee avec une justification metier explicite.
 * - Format obligatoire : `FQCN => 'justification + reference ticket/spec'`
 *
 * @internal
 */
 final class CollectionsArePaginatedTest extends TestCase
 {
    /**
     * Resources API Platform dont un `GetCollection` peut desactiver la pagination.
     *
     * Laisser vide au demarrage. Pour ajouter une exception :
     *   'App\Module\Foo\Infrastructure\ApiPlatform\Resource\BarResource'
     *       => 'Referentiel statique < 50 items (types de contrat). Cf. ERP-XX.',
     *
     * @var array<class-string, string>
     */
    private const EXCLUDED = [];
    public function testAllGetCollectionOperationsHavePaginationEnabled(): void
    {
        $finder = new Finder()
            ->files()
            ->in(__DIR__.'/../../src')
            ->name('*.php')
            ->contains('#[ApiResource')
        ;
        // Garde : si le scan ne trouve rien, le chemin est casse — le test
        // deviendrait un faux positif vert. On verifie qu'il a du grain a moudre.
        self::assertNotEmpty(
            iterator_to_array($finder),
            'Aucun fichier #[ApiResource] trouve sous src/ : chemin invalide ou codebase vide.',
        );
        foreach ($finder as $file) {
            $fqcn = $this->extractFqcn($file->getRealPath());
            if (null === $fqcn || !class_exists($fqcn)) {
                continue;
            }
            $reflection            = new ReflectionClass($fqcn);
            $apiResourceAttributes = $reflection->getAttributes(ApiResource::class);
            if ([] === $apiResourceAttributes) {
                continue;
            }
            foreach ($apiResourceAttributes as $attribute) {
                /** @var ApiResource $apiResource */
                $apiResource = $attribute->newInstance();
                $operations  = $apiResource->getOperations()?->getIterator() ?? [];
                foreach ($operations as $operation) {
                    if (!$operation instanceof GetCollection) {
                        continue;
                    }
                    if (false !== $operation->getPaginationEnabled()) {
                        continue;
                    }
                    // La pagination est explicitement desactivee : verifier
                    // que la resource est dans la whitelist EXCLUDED.
                    self::assertArrayHasKey(
                        $fqcn,
                        self::EXCLUDED,
                        sprintf(
                            "La resource %s desactive la pagination sur une operation GetCollection.\n"
                            ."Regle : toute collection API Platform doit etre paginee (cf. .claude/rules/backend.md).\n"
                            ."Si cette collection est structurellement bornee et que la desactivation est justifiee,\n"
                            .'ajouter une entree dans CollectionsArePaginatedTest::EXCLUDED avec une justification.',
                            $fqcn,
                        ),
                    );
                }
            }
        }
    }
    /**
     * Extrait le FQCN (namespace + classe) d'un fichier PHP par lecture du
     * source, sans charger le fichier.
     */
    private function extractFqcn(string $path): ?string
    {
        $source = file_get_contents($path);
        if (false === $source) {
            return null;
        }
        if (
            1 !== preg_match('/^namespace\s+([^;]+);/m', $source, $nsMatch)
            || 1 !== preg_match('/^(?:final\s+|abstract\s+|readonly\s+)*class\s+(\w+)/m', $source, $classMatch)
        ) {
            return null;
        }
        return trim($nsMatch[1]).'\\'.$classMatch[1];
    }
 }
@@ -83,9 +83,6 @@ abstract class AbstractCatalogApiTestCase extends AbstractApiTestCase
        $suffix   = substr(bin2hex(random_bytes(4)), 0, 8);
        $category = new Category();
        $category->setName($name ?? self::TEST_CATEGORY_PREFIX.$suffix);
        // ERP-78 : code NOT NULL + unique parmi les actifs (uq_category_code).
        // Nonce aleatoire -> unicite garantie entre seeds successifs du test.
        $category->setCode('TEST_'.strtoupper($suffix));
        $category->setCategoryType($type);
        if (null !== $deletedAt) {
            $category->setDeletedAt($deletedAt);
@@ -1,73 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Module\Catalog\Api;
 use App\Module\Catalog\Application\Service\CategoryCodeGenerator;
 use App\Shared\Infrastructure\Database\CategoryCodeSql;
 use Doctrine\DBAL\Connection;
 use PHPUnit\Framework\Attributes\DataProvider;
 use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 /**
 * Garde-fou ERP-78 : l'expression SQL de slug (CategoryCodeSql, utilisee par le
 * backfill de la migration Version20260602100000) doit produire EXACTEMENT le
 * meme code que le generateur applicatif (CategoryCodeGenerator::slugify), sur
 * tout le domaine de noms francais / Latin-1.
 *
 * Verrouille la cause racine du bug initial : deux implementations d'un meme
 * slug qui derivent silencieusement (« Independant » -> IND_PENDANT cote SQL
 * faute de translitteration des accents, vs INDEPENDANT cote PHP). On ne couvre
 * volontairement PAS les ligatures (`Œ`, `ß`) : `translate()` est 1->1 et ne
 * peut produire `OE`/`SS` ; elles sont hors du domaine des categories CLIENT.
 *
 * @internal
 */
 final class CategoryCodeSqlSlugTest extends KernelTestCase
 {
    /**
     * Noms representatifs du domaine reel : accents, cedille, apostrophe,
     * separateurs varies, parentheses, majuscules accentuees.
     *
     * @return iterable<string, array{string}>
     */
    public static function nameProvider(): iterable
    {
        yield 'sans accent'         => ['Distributeur'];
        yield 'tiret'               => ['Agro-alimentaire'];
        yield 'slash'               => ['Transport/Logistique'];
        yield 'accent aigu'         => ['Indépendant'];
        yield 'apostrophe + accent' => ["L'Oréal"];
        yield 'esperluette'         => ['Forêt & Bûcheron'];
        yield 'cedille majuscule'   => ['Ça va'];
        yield 'accents multiples'   => ['Naïve façade'];
        yield 'circonflexe'         => ["Côte d'Azur"];
        yield 'parentheses'         => ['Zone (Sud)'];
    }
    #[DataProvider('nameProvider')]
    public function testSqlSlugMatchesPhpSlug(string $name): void
    {
        self::bootKernel();
        $container = self::getContainer();
        /** @var Connection $conn */
        $conn = $container->get('doctrine')->getConnection();
        /** @var CategoryCodeGenerator $generator */
        $generator = $container->get(CategoryCodeGenerator::class);
        // Evaluation pure de l'expression (aucune table requise) : le nom est
        // passe en parametre lie a la place de la colonne.
        $sqlSlug = $conn->fetchOne(
            'SELECT '.CategoryCodeSql::slugExpression(':name'),
            ['name' => $name],
        );
        self::assertSame(
            $generator->slugify($name),
            $sqlSlug,
            sprintf('SQL et PHP doivent produire le meme slug pour "%s".', $name),
        );
    }
 }
@@ -1,90 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Module\Catalog\Api;
 /**
 * Tests ERP-78 : le `code` technique stable de Category.
 *
 * Cas couverts :
 *  - POST : le code est auto-genere (slug MAJUSCULE du nom) et expose en lecture ;
 *  - le code est en lecture seule : un `code` envoye dans le payload est ignore
 *    (genere depuis le nom) ;
 *  - deux noms produisant le meme slug recoivent des codes distincts (suffixe).
 *
 * @internal
 */
 final class CategoryCodeTest extends AbstractCatalogApiTestCase
 {
    public function testPostGeneratesAndExposesCode(): void
    {
        $type   = $this->createCategoryType();
        $client = $this->createAdminClient();
        $response = $client->request('POST', '/api/categories', [
            'headers' => ['Content-Type' => 'application/ld+json'],
            'json'    => [
                'name'         => self::TEST_CATEGORY_PREFIX.'Agro-alimentaire',
                'categoryType' => '/api/category_types/'.$type->getId(),
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
        $payload = $response->toArray();
        // Slug MAJUSCULE du nom, separateurs non alphanumeriques -> `_`.
        self::assertSame(
            strtoupper(self::TEST_CATEGORY_PREFIX).'AGRO_ALIMENTAIRE',
            $payload['code'],
        );
    }
    public function testCodeIsReadOnlyAndIgnoredFromPayload(): void
    {
        $type   = $this->createCategoryType();
        $client = $this->createAdminClient();
        $response = $client->request('POST', '/api/categories', [
            'headers' => ['Content-Type' => 'application/ld+json'],
            'json'    => [
                'name'         => self::TEST_CATEGORY_PREFIX.'readonly',
                'categoryType' => '/api/category_types/'.$type->getId(),
                // Le client tente d'imposer un code : doit etre ignore.
                'code'         => 'CLIENT_FORGED',
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
        $payload = $response->toArray();
        self::assertNotSame('CLIENT_FORGED', $payload['code']);
        self::assertSame(strtoupper(self::TEST_CATEGORY_PREFIX).'READONLY', $payload['code']);
    }
    public function testCollidingSlugsGetDistinctCodes(): void
    {
        $type   = $this->createCategoryType();
        $client = $this->createAdminClient();
        // Deux noms differents (donc autorises par uq_category_name_type_active)
        // mais qui produisent le meme slug -> codes distincts (suffixe `_2`).
        $first = $client->request('POST', '/api/categories', [
            'headers' => ['Content-Type' => 'application/ld+json'],
            'json'    => [
                'name'         => self::TEST_CATEGORY_PREFIX.'Agro Plus',
                'categoryType' => '/api/category_types/'.$type->getId(),
            ],
        ])->toArray();
        $second = $client->request('POST', '/api/categories', [
            'headers' => ['Content-Type' => 'application/ld+json'],
            'json'    => [
                'name'         => self::TEST_CATEGORY_PREFIX.'Agro-Plus',
                'categoryType' => '/api/category_types/'.$type->getId(),
            ],
        ])->toArray();
        self::assertResponseStatusCodeSame(201);
        self::assertNotSame($first['code'], $second['code']);
        self::assertStringEndsWith('_2', (string) $second['code']);
    }
 }
@@ -29,7 +29,7 @@ final class CategoryListTest extends AbstractCatalogApiTestCase
        );
        $client   = $this->createAdminClient();
-        $response = $client->request('GET', '/api/categories?pagination=false');
+        $response = $client->request('GET', '/api/categories');
        self::assertSame(200, $response->getStatusCode());
        $data    = $response->toArray();
@@ -62,7 +62,7 @@ final class CategoryListTest extends AbstractCatalogApiTestCase
        );
        $client   = $this->createAdminClient();
-        $response = $client->request('GET', '/api/categories?includeDeleted=true&pagination=false');
+        $response = $client->request('GET', '/api/categories?includeDeleted=true');
        self::assertSame(200, $response->getStatusCode());
        $names = array_values(array_filter(
@@ -87,7 +87,7 @@ final class CategoryListTest extends AbstractCatalogApiTestCase
        $this->createCategory(self::TEST_CATEGORY_PREFIX.'mid', $type);
        $client   = $this->createAdminClient();
-        $response = $client->request('GET', '/api/categories?pagination=false');
+        $response = $client->request('GET', '/api/categories');
        self::assertSame(200, $response->getStatusCode());
        $names = array_values(array_filter(
@@ -1,171 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Module\Catalog\Api;
 use DateTimeImmutable;
 /**
 * Tests du contrat de pagination sur GET /api/categories (ERP-72).
 *
 * Invariants testes :
 *  - la collection expose les metadonnees Hydra (totalItems, view, member) ;
 *  - itemsPerPage est plafonne au maximum global (50) ;
 *  - une page hors limites retourne une collection vide, pas une 500 ;
 *  - ?pagination=false retourne tous les items sans troncature (select-box) ;
 *  - la pagination est compatible avec le flag ?includeDeleted=true.
 *
 * @internal
 */
 final class CategoryPaginationTest extends AbstractCatalogApiTestCase
 {
    /**
     * La collection expose les metadonnees de pagination JSON-LD sans prefixe :
     * `totalItems`, `view`, `member` (convention API Platform 4, pas hydra:*).
     *
     * On cree 12 categories pour depasser la limite par page (10) : la cle
     * `view` n'est presente que lorsqu'il y a plus d'items que la taille de page.
     */
    public function testCollectionExposesHydraPaginationMetadata(): void
    {
        $type = $this->createCategoryType();
        for ($i = 1; $i <= 12; ++$i) {
            $this->createCategory(self::TEST_CATEGORY_PREFIX.'meta_'.$i, $type);
        }
        $client   = $this->createAdminClient();
        $response = $client->request('GET', '/api/categories');
        self::assertSame(200, $response->getStatusCode());
        $data = $response->toArray();
        self::assertArrayHasKey('totalItems', $data, 'La collection doit exposer totalItems.');
        self::assertArrayHasKey('view', $data, 'La collection doit exposer view (pagination) quand totalItems > itemsPerPage.');
        self::assertIsArray($data['member'], 'member doit etre un tableau.');
    }
    /**
     * Un itemsPerPage arbitrairement grand (99999) doit etre plafonne au
     * maximum global configure (50). On cree 12 categories pour etre certain
     * de disposer de donnees ; le cap doit s'appliquer quelle que soit la taille
     * reelle de la collection.
     */
    public function testItemsPerPageIsCappedAtMaximum(): void
    {
        $type = $this->createCategoryType();
        for ($i = 1; $i <= 12; ++$i) {
            $this->createCategory(self::TEST_CATEGORY_PREFIX.'cap_'.$i, $type);
        }
        $client   = $this->createAdminClient();
        $response = $client->request('GET', '/api/categories?itemsPerPage=99999');
        self::assertSame(200, $response->getStatusCode());
        // Le cap global est 50 : jamais plus d'items par page que le maximum.
        self::assertLessThanOrEqual(
            50,
            count($response->toArray()['member']),
            'itemsPerPage doit etre plafonne au maximum global (50).',
        );
    }
    /**
     * Une page tres elevee (99999) sur une petite collection ne doit pas
     * produire une 500 PG (OFFSET negatif ou depassement de capacite) mais
     * retourner 200 avec un tableau member vide.
     */
    public function testOutOfBoundPageReturnsEmptyCollectionNot500(): void
    {
        $type = $this->createCategoryType();
        $this->createCategory(self::TEST_CATEGORY_PREFIX.'oob', $type);
        $client   = $this->createAdminClient();
        $response = $client->request('GET', '/api/categories?page=99999');
        self::assertSame(200, $response->getStatusCode());
        // La page 99999 est forcement vide (on a bien moins que 99999*10 items).
        self::assertSame(
            [],
            $response->toArray()['member'],
            'Une page hors limites doit retourner un member vide, jamais une 500.',
        );
    }
    /**
     * ?pagination=false permet au frontend de desactiver la pagination pour
     * alimenter un select-box. On cree exactement 12 categories dont les noms
     * commencent par `test_cat_select_` : le filtre sur ce prefixe isole nos
     * entrees des donnees concurrentes et prouve que les 12 items sont tous
     * retournes (et pas seulement les 10 premiers de la page 1).
     */
    public function testClientCanDisablePaginationToFeedASelect(): void
    {
        $type = $this->createCategoryType();
        for ($i = 1; $i <= 12; ++$i) {
            $this->createCategory(self::TEST_CATEGORY_PREFIX.'select_'.$i, $type);
        }
        $client   = $this->createAdminClient();
        $response = $client->request('GET', '/api/categories?pagination=false');
        self::assertSame(200, $response->getStatusCode());
        $members = $response->toArray()['member'];
        // Filtre sur le sous-prefixe pour ne pas comptabiliser les categories
        // d'autres tests qui partagent la meme base de donnees.
        $selectItems = array_values(array_filter(
            $members,
            fn (array $m): bool => str_starts_with($m['name'], self::TEST_CATEGORY_PREFIX.'select_'),
        ));
        self::assertCount(
            12,
            $selectItems,
            '?pagination=false doit retourner toutes les categories (pas seulement la page 1).',
        );
    }
    /**
     * La pagination doit fonctionner conjointement avec le flag ?includeDeleted=true.
     * On seed 3 categories actives + 2 soft-deleted, on demande itemsPerPage=5 :
     * la page 1 doit contenir exactement 5 items et totalItems doit valoir >= 5.
     */
    public function testPaginationCombinedWithIncludeDeletedFlag(): void
    {
        $type = $this->createCategoryType();
        // 3 categories actives.
        for ($i = 1; $i <= 3; ++$i) {
            $this->createCategory(self::TEST_CATEGORY_PREFIX.'pag_active_'.$i, $type);
        }
        // 2 categories soft-deleted.
        for ($i = 1; $i <= 2; ++$i) {
            $this->createCategory(
                self::TEST_CATEGORY_PREFIX.'pag_deleted_'.$i,
                $type,
                new DateTimeImmutable(),
            );
        }
        $client   = $this->createAdminClient();
        $response = $client->request('GET', '/api/categories?includeDeleted=true&itemsPerPage=5');
        self::assertSame(200, $response->getStatusCode());
        $data = $response->toArray();
        // La page retournee ne doit pas exceder itemsPerPage=5.
        self::assertCount(
            5,
            $data['member'],
            'La page 1 doit contenir exactement 5 items (itemsPerPage=5 avec >= 5 categories disponibles).',
        );
        self::assertGreaterThanOrEqual(
            5,
            $data['totalItems'],
            'totalItems doit refleter au moins les 5 categories seedees (actives + soft-deleted).',
        );
    }
 }
@@ -7,8 +7,6 @@ namespace App\Tests\Module\Catalog\Api;
 use App\Module\Catalog\Domain\Entity\Category;
 use App\Module\Core\Domain\Entity\User;
 use DateTimeImmutable;
 use Symfony\Component\Clock\ClockInterface;
 use Symfony\Component\Clock\Test\ClockSensitiveTrait;
 /**
 * Tests RG-1.15 / RG-1.16 : le TimestampableBlamableSubscriber doit remplir
@@ -22,39 +20,12 @@ use Symfony\Component\Clock\Test\ClockSensitiveTrait;
 *  - DELETE : deletedAt rempli ET updatedAt + updatedBy mis a jour (UPDATE
 *    Doctrine declenche le subscriber)
 *
 * ERP-98 : ces tests pilotent une horloge mockee (ClockSensitiveTrait) plutot
 * que de dependre d'un `sleep(1)` reel. Le subscriber lit le service `clock`,
 * que `self::mockTime()` remplace par un MockClock fige au niveau du process —
 * ce qui survit aux reboots de kernel entre requetes (POST admin / PATCH bob)
 * et reste insensible a la derive d'horloge WSL2 a l'origine des flakes.
 *
 * @internal
 */
 final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
 {
    use ClockSensitiveTrait;
    /**
     * Fige l'horloge globale sur l'instant courant DANS LE FUSEAU PHP par
     * defaut, et la retourne pour la piloter (`sleep()`).
     *
     * Subtilite : `self::mockTime()` cree par defaut un MockClock en UTC, or
     * les colonnes `TIMESTAMP WITHOUT TIME ZONE` round-trippent via le fuseau
     * PHP (Europe/Paris). Un MockClock UTC decalerait createdAt de l'offset
     * (2h) au rechargement. On seede donc avec `new DateTimeImmutable()`
     * (fuseau par defaut), exactement comme le NativeClock en prod.
     */
    private function freezeClock(): ClockInterface
    {
        return self::mockTime(new DateTimeImmutable());
    }
    public function testCreatedByAdminOnPost(): void
    {
        // Horloge figee : le subscriber posera createdAt/updatedAt sur cet
        // instant exact, insensible a tout decalage d'horloge reel.
        $clock = $this->freezeClock();
        $type = $this->createCategoryType();
        /** @var User $admin */
@@ -62,7 +33,9 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
        self::assertNotNull($admin);
        $adminId = $admin->getId();
-        $before = $clock->now();
+        $before = new DateTimeImmutable();
        // Petit decalage pour absorber les arrondis a la seconde de Postgres.
        sleep(1);
        $client   = $this->createAdminClient();
        $response = $client->request('POST', '/api/categories', [
@@ -130,8 +103,6 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
    public function testPatchUpdatesUpdatedFieldsOnly(): void
    {
        $clock = $this->freezeClock();
        // Etape 1 : creation par admin pour figer createdBy=admin.
        $type        = $this->createCategoryType();
        $adminClient = $this->createAdminClient();
@@ -156,9 +127,9 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
        $initialUpdatedAt   = $initial->getUpdatedAt();
        $initialCreatedById = $initial->getCreatedBy()->getId();
-        // Avance deterministe de l'horloge mockee : garantit un updatedAt
+        // Decalage temporel suffisant pour que la precision PG (seconde)
-        // strictement superieur cote PG (precision seconde) sans sleep reel.
+        // capte un updatedAt different.
-        $clock->sleep(1);
+        sleep(1);
        // Etape 2 : PATCH par un autre user (manager non-admin) — simule "bob".
        $manage    = $this->createManageClient();
@@ -209,8 +180,6 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
    public function testSoftDeleteAlsoUpdatesUpdatedFields(): void
    {
        $clock = $this->freezeClock();
        // RG-1.16 : le soft delete est un UPDATE Doctrine, donc le subscriber
        // doit aussi avancer updatedAt et updatedBy en plus de poser deletedAt.
        $type        = $this->createCategoryType();
@@ -233,8 +202,7 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
        $initial          = $em->getRepository(Category::class)->find($createdId);
        $initialUpdatedAt = $initial->getUpdatedAt();
-        // Avance deterministe de l'horloge mockee (cf. testPatch).
+        sleep(1);
        $clock->sleep(1);
        // Soft delete par un manager non-admin.
        $manage    = $this->createManageClient();
@@ -17,17 +17,13 @@ use DateTimeImmutable;
 * Base des tests fonctionnels du module Commercial (M1 — repertoire clients).
 *
 * Etend la base Core : ajoute des factories pour seeder vite des categories
- * codees (DISTRIBUTEUR / COURTIER / SECTEUR...) sous le type unique CLIENT et
+ * typees (DISTRIBUTEUR / COURTIER / SECTEUR) et des clients, plus un helper
- * des clients, plus un helper d'authentification admin.
+ * d'authentification admin.
 *
 * Refonte taxonomie ERP-78 : il n'y a plus qu'un type CLIENT ; le code metier
 * vit desormais sur la Category. `createCategory($code)` est un fetch-or-create
 * PAR CODE (idempotent) sous CLIENT — deux clients d'un meme test partagent ainsi
 * la categorie de meme code sans violer l'index unique partiel uq_category_code.
 *
 * Cleanup : tearDown purge clients, categories `test_cli_cat_*` et users/roles
- * `test_*`. Le type CLIENT est fetch-or-create (idempotent) et laisse en place.
+ * `test_*`. Les category_types business sont fetch-or-create (idempotents) et
- * Pas de DAMA en local -> purge manuelle obligatoire.
+ * laisses en place (pas de DELETE pour ne pas entrer en conflit avec d'autres
 * suites). Pas de DAMA en local -> purge manuelle obligatoire.
 *
 * @internal
 */
@@ -35,14 +31,6 @@ abstract class AbstractCommercialApiTestCase extends AbstractApiTestCase
 {
    protected const string TEST_CATEGORY_PREFIX = 'test_cli_cat_';
    /**
     * Codes pilotant les RG (RG-1.03 distributor/broker, RG-1.29 adresse) : ils
     * doivent matcher exactement, donc createCategory() les fetch-or-create par
     * code. Les autres codes sont traites comme de simples libelles generiques et
     * produisent une categorie a code UNIQUE (cf. createCategory).
     */
    private const array RG_EXACT_CODES = ['DISTRIBUTEUR', 'COURTIER'];
    protected function tearDown(): void
    {
        $this->cleanupCommercialTestData();
@@ -55,20 +43,20 @@ abstract class AbstractCommercialApiTestCase extends AbstractApiTestCase
    }
    /**
-     * Recupere (ou cree) le type unique CLIENT (refonte ERP-78). Idempotent : la
+     * Recupere (ou cree) un CategoryType par son code metier. Idempotent : la
     * contrainte d'unicite sur category_type.code interdit les doublons.
     */
-    protected function clientCategoryType(): CategoryType
+    protected function createCategoryType(string $code): CategoryType
    {
        $em       = $this->getEm();
-        $existing = $em->getRepository(CategoryType::class)->findOneBy(['code' => 'CLIENT']);
+        $existing = $em->getRepository(CategoryType::class)->findOneBy(['code' => $code]);
        if (null !== $existing) {
            return $existing;
        }
        $type = new CategoryType();
-        $type->setCode('CLIENT');
+        $type->setCode($code);
-        $type->setLabel('Client');
+        $type->setLabel(ucfirst(strtolower($code)));
        $em->persist($type);
        $em->flush();
@@ -76,38 +64,15 @@ abstract class AbstractCommercialApiTestCase extends AbstractApiTestCase
    }
    /**
-     * Cree une Category de test sous le type unique CLIENT (ERP-78).
+     * Cree une Category de test rattachee a un type metier donne (code).
     *
     * - Code RG (DISTRIBUTEUR / COURTIER) : fetch-or-create par code EXACT — le
     *   code doit matcher la regle de gestion, et l'appel repete dans un test
     *   renvoie la meme categorie (pas de violation de uq_category_code).
     * - Autre code (SECTEUR, AUTRE, ...) : simple libelle generique -> categorie
     *   a code UNIQUE (suffixe aleatoire). Garantit que deux categories
     *   « generiques » d'un meme test sont DISTINCTES (ex: detection de
     *   changement de categorie dans les tests RBAC).
     */
-    protected function createCategory(string $code = 'SECTEUR'): Category
+    protected function createCategory(string $typeCode = 'SECTEUR'): Category
    {
-        $em = $this->getEm();
+        $em       = $this->getEm();
-
+        $suffix   = substr(bin2hex(random_bytes(4)), 0, 8);
        if (in_array($code, self::RG_EXACT_CODES, true)) {
            $existing = $em->getRepository(Category::class)->findOneBy(['code' => $code, 'deletedAt' => null]);
            if (null !== $existing) {
                return $existing;
            }
            $effectiveCode = $code;
            $name          = self::TEST_CATEGORY_PREFIX.strtolower($code);
        } else {
            $suffix        = substr(bin2hex(random_bytes(4)), 0, 8);
            $effectiveCode = strtoupper($code).'_'.strtoupper($suffix);
            $name          = self::TEST_CATEGORY_PREFIX.strtolower($code).'_'.$suffix;
        }
        $category = new Category();
-        $category->setName($name);
+        $category->setName(self::TEST_CATEGORY_PREFIX.$suffix);
-        $category->setCode($effectiveCode);
+        $category->setCategoryType($this->createCategoryType($typeCode));
        $category->setCategoryType($this->clientCategoryType());
        $em->persist($category);
        $em->flush();
@@ -116,10 +81,9 @@ abstract class AbstractCommercialApiTestCase extends AbstractApiTestCase
    /**
     * Seede directement un Client en base (sans passer par l'API), pour les
-     * tests de liste / archivage. Le client porte une categorie du code donne
+     * tests de liste / archivage. Le client porte une categorie SECTEUR.
     * (defaut SECTEUR — categorie generique non interdite sur adresse).
     */
-    protected function seedClient(string $companyName, bool $isArchived = false, string $categoryCode = 'SECTEUR'): ClientEntity
+    protected function seedClient(string $companyName, bool $isArchived = false, string $categoryTypeCode = 'SECTEUR'): ClientEntity
    {
        $em     = $this->getEm();
        $client = new ClientEntity();
@@ -129,7 +93,7 @@ abstract class AbstractCommercialApiTestCase extends AbstractApiTestCase
        $client->setLastName('Seed');
        $client->setPhonePrimary('0102030405');
        $client->setEmail(strtolower(str_replace(' ', '', $companyName)).'@seed.test');
-        $client->addCategory($this->createCategory($categoryCode));
+        $client->addCategory($this->createCategory($categoryTypeCode));
        $client->setIsArchived($isArchived);
        if ($isArchived) {
            $client->setArchivedAt(new DateTimeImmutable());
@@ -1,299 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Tests\Module\Commercial\Api;
 use App\Module\Sites\Domain\Entity\Site;
 /**
 * Tests fonctionnels de l'onglet Adresse.
 *
 * RG-1.09 (code postal) et RG-1.10 (>= 1 site) sont DEJA couverts par
 * ClientSubResourceApiTest (ERP-57) et ne sont pas reduplique ici. Ce fichier
 * cible :
 *  - RG-1.06 / RG-1.07 / RG-1.08 : exclusivite is_prospect vs
 *    is_delivery / is_billing ;
 *  - RG-1.11 : billing_email obligatoire ssi is_billing ;
 *  - RG-1.29 (ERP-78) : les categories de code DISTRIBUTEUR / COURTIER sont
 *    interdites sur une adresse (-> 422) ; toute autre categorie est acceptee.
 *
 * Depuis ERP-76, ces regles sont portees par des Assert\Callback sur l'entite
 * ClientAddress (mirror applicatif des CHECK Postgres) : la combinaison invalide
 * est donc rejetee en 422 AVANT la base, et non plus par une violation CHECK
 * remontant en 500. Les CHECK BDD restent en filet de securite (non testes ici,
 * inatteignables tant que les validators applicatifs passent en premier).
 *
 * @internal
 */
 final class ClientAddressTest extends AbstractCommercialApiTestCase
 {
    private const string LD = 'application/ld+json';
    /**
     * RG-1.06 / RG-1.07 : une adresse de prospection ne peut pas etre une
     * adresse de livraison -> 422 (Assert\Callback, mirror du CHECK
     * chk_client_address_prospect_exclusive).
     */
    public function testProspectAddressCannotBeDelivery(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Prospect Delivery');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isProspect' => true,
                'isDelivery' => true,
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.06 / RG-1.08 : une adresse de prospection ne peut pas etre une
     * adresse de facturation -> 422. On fournit billingEmail pour que la seule
     * violation possible soit l'exclusivite prospect/billing.
     */
    public function testProspectAddressCannotBeBilling(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Prospect Billing');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isProspect'   => true,
                'isBilling'    => true,
                'billingEmail' => 'facturation@test.fr',
                'postalCode'   => '86100',
                'city'         => 'Châtellerault',
                'street'       => '1 rue du Test',
                'sites'        => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.11 : une adresse de facturation exige un billingEmail -> 422.
     */
    public function testBillingAddressRequiresBillingEmail(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Billing No Email');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isBilling'  => true,
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.11 (cas chaine vide) : une adresse de facturation avec un billingEmail
     * vide ("") doit etre rejetee en 422, et NON passer la validation pour finir
     * en 500 sur le CHECK BDD. Le ClientAddressProcessor normalise "" -> null
     * APRES la validation : le callback doit donc traiter "" comme « absent ».
     */
    public function testBillingAddressRejectsEmptyBillingEmail(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Billing Empty Email');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isBilling'    => true,
                'billingEmail' => '',
                'postalCode'   => '86100',
                'city'         => 'Châtellerault',
                'street'       => '1 rue du Test',
                'sites'        => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.11 (sens inverse) : une adresse NON facturable ne peut pas porter un
     * billingEmail -> 422.
     */
    public function testNonBillingAddressRejectsBillingEmail(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Non Billing With Email');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isBilling'    => false,
                'billingEmail' => 'parasite@test.fr',
                'postalCode'   => '86100',
                'city'         => 'Châtellerault',
                'street'       => '1 rue du Test',
                'sites'        => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.11 (sens inverse, cas chaine vide) : une adresse NON facturable avec
     * un billingEmail vide ("") est ACCEPTEE (201). Le "" equivaut a « pas
     * d'email » : il ne doit pas declencher la violation « email interdit hors
     * facturation » (sinon un champ simplement vide serait refuse a tort).
     */
    public function testNonBillingAddressAcceptsEmptyBillingEmail(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client = $this->createAdminClient();
        $seed   = $this->seedClient('Non Billing Empty Email');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'isBilling'    => false,
                'billingEmail' => '',
                'postalCode'   => '86100',
                'city'         => 'Châtellerault',
                'street'       => '1 rue du Test',
                'sites'        => [$this->firstSiteIri()],
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
    }
    /**
     * RG-1.29 : poster une categorie de type DISTRIBUTEUR sur une adresse -> 422
     * avec violation sur le champ `categories`.
     */
    public function testAddressRejectsDistributorCategory(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client   = $this->createAdminClient();
        $seed     = $this->seedClient('Address Distributor Cat');
        $category = $this->createCategory('DISTRIBUTEUR');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
                'categories' => ['/api/categories/'.$category->getId()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
        self::assertStringContainsString(
            'Type de catégorie non autorisé sur une adresse.',
            (string) $client->getResponse()->getContent(false),
        );
    }
    /**
     * RG-1.29 : poster une categorie de type COURTIER sur une adresse -> 422.
     */
    public function testAddressRejectsBrokerCategory(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client   = $this->createAdminClient();
        $seed     = $this->seedClient('Address Broker Cat');
        $category = $this->createCategory('COURTIER');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
                'categories' => ['/api/categories/'.$category->getId()],
            ],
        ]);
        self::assertResponseStatusCodeSame(422);
    }
    /**
     * RG-1.29 : une categorie de type SECTEUR est autorisee sur une adresse.
     */
    public function testAddressAcceptsSectorCategory(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client   = $this->createAdminClient();
        $seed     = $this->seedClient('Address Sector Cat');
        $category = $this->createCategory('SECTEUR');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
                'categories' => ['/api/categories/'.$category->getId()],
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
    }
    /**
     * RG-1.29 : une categorie de type AUTRE est autorisee sur une adresse.
     */
    public function testAddressAcceptsOtherCategory(): void
    {
        $this->skipIfSitesModuleDisabled();
        $client   = $this->createAdminClient();
        $seed     = $this->seedClient('Address Other Cat');
        $category = $this->createCategory('AUTRE');
        $client->request('POST', '/api/clients/'.$seed->getId().'/addresses', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'postalCode' => '86100',
                'city'       => 'Châtellerault',
                'street'     => '1 rue du Test',
                'sites'      => [$this->firstSiteIri()],
                'categories' => ['/api/categories/'.$category->getId()],
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
    }
    /**
     * Retourne l'IRI du premier site seede (fixtures Sites).
     */
    private function firstSiteIri(): string
    {
        $site = $this->getEm()->getRepository(Site::class)->findOneBy([]);
        self::assertNotNull($site, 'Aucun site seede : impossible de tester les adresses.');
        return '/api/sites/'.$site->getId();
    }
 }
@@ -4,11 +4,6 @@ declare(strict_types=1);
 namespace App\Tests\Module\Commercial\Api;
 use ApiPlatform\Symfony\Bundle\Test\Client;
 use App\Module\Commercial\Domain\Entity\Client as ClientEntity;
 use App\Module\Commercial\Domain\Entity\ClientAddress;
 use App\Module\Sites\Domain\Entity\Site;
 /**
 * Tests fonctionnels de l'API /api/clients (M1) — branche ERP-55.
 *
@@ -180,49 +175,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
        self::assertResponseStatusCodeSame(201);
    }
    public function testPostBrokerReferencingNonBrokerReturns422(): void
    {
        $client    = $this->createAdminClient();
        $cat       = $this->createCategory('SECTEUR');
        $notBroker = $this->seedClient('Pas Un Courtier', false, 'SECTEUR');
        $client->request('POST', '/api/clients', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'companyName'  => 'Bad Broker Ref',
                'firstName'    => 'A',
                'phonePrimary' => '0102030405',
                'email'        => 'badbroker@test.fr',
                'categories'   => ['/api/categories/'.$cat->getId()],
                'broker'       => '/api/clients/'.$notBroker->getId(),
            ],
        ]);
        // RG-1.03 (le broker doit porter la categorie de code COURTIER)
        self::assertResponseStatusCodeSame(422);
    }
    public function testPostValidBrokerReturns201(): void
    {
        $client = $this->createAdminClient();
        $cat    = $this->createCategory('SECTEUR');
        $broker = $this->seedClient('Vrai Courtier', false, 'COURTIER');
        $client->request('POST', '/api/clients', [
            'headers' => ['Content-Type' => self::LD],
            'json'    => [
                'companyName'  => 'Client Avec Courtier',
                'firstName'    => 'A',
                'phonePrimary' => '0102030405',
                'email'        => 'okbroker@test.fr',
                'categories'   => ['/api/categories/'.$cat->getId()],
                'broker'       => '/api/clients/'.$broker->getId(),
            ],
        ]);
        self::assertResponseStatusCodeSame(201);
    }
    public function testListSortedByCompanyNameAscAndExcludesArchived(): void
    {
        $client = $this->createAdminClient();
@@ -330,146 +282,4 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
        self::assertArrayHasKey('addresses', $data);
        self::assertArrayHasKey('ribs', $data);
    }
    /**
     * ERP-62 : la LISTE doit alimenter les colonnes « Catégories » (codes) et
     * « Site(s) » (badges name + color) du Repertoire. On verifie donc que la
     * collection embarque le `code` de chaque categorie et les sites agreges des
     * adresses (accessoire Client::getSites()).
     */
    public function testListEmbedsCategoryCodesAndAggregatedSites(): void
    {
        $client = $this->createAdminClient();
        // Client seede + une adresse rattachee a un site (fixtures Sites).
        $seed = $this->seedClient('Embed List Co', false, 'DISTRIBUTEUR');
        $em   = $this->getEm();
        $site = $em->getRepository(Site::class)->findOneBy([]);
        self::assertNotNull($site, 'Aucun site seede : impossible de tester la colonne Site(s).');
        $address = new ClientAddress();
        $address->setClient($seed);
        $address->setPostalCode('86100');
        $address->setCity('Châtellerault');
        $address->setStreet('1 rue du Test');
        $address->addSite($site);
        $em->persist($address);
        $em->flush();
        $member = $client->request('GET', '/api/clients?pagination=false', [
            'headers' => ['Accept' => self::LD],
        ])->toArray()['member'];
        $row = null;
        foreach ($member as $candidate) {
            if ('EMBED LIST CO' === $candidate['companyName']) {
                $row = $candidate;
                break;
            }
        }
        self::assertNotNull($row, 'Le client seede doit figurer dans la liste.');
        // Colonne « Catégories » : chaque categorie embarquee porte son code.
        self::assertNotEmpty($row['categories']);
        self::assertArrayHasKey('code', $row['categories'][0]);
        self::assertSame('DISTRIBUTEUR', $row['categories'][0]['code']);
        // Colonne « Site(s) » : sites agreges des adresses, avec name + color.
        self::assertArrayHasKey('sites', $row);
        self::assertNotEmpty($row['sites']);
        self::assertArrayHasKey('name', $row['sites'][0]);
        self::assertArrayHasKey('color', $row['sites'][0]);
        self::assertSame($site->getName(), $row['sites'][0]['name']);
    }
    /**
     * ERP-62 (drawer) : filtre Catégories multi (?categoryCode[]=A&categoryCode[]=B)
     * — union des clients possedant l'un OU l'autre code.
     */
    public function testListFilterByMultipleCategoryCodes(): void
    {
        $client = $this->createAdminClient();
        $this->seedClient('Filtre Distrib Co', false, 'DISTRIBUTEUR');
        $this->seedClient('Filtre Courtier Co', false, 'COURTIER');
        $this->seedClient('Filtre Secteur Co', false, 'SECTEUR');
        $names = $this->companyNames($client, '/api/clients?pagination=false&categoryCode[]=DISTRIBUTEUR&categoryCode[]=COURTIER');
        self::assertContains('FILTRE DISTRIB CO', $names);
        self::assertContains('FILTRE COURTIER CO', $names);
        self::assertNotContains('FILTRE SECTEUR CO', $names);
    }
    /**
     * ERP-62 (drawer) : filtre Sites (?siteId[]=X) — clients ayant >= 1 adresse
     * rattachee au site donne.
     */
    public function testListFilterBySite(): void
    {
        $client = $this->createAdminClient();
        $em     = $this->getEm();
        $sites = $em->getRepository(Site::class)->findBy([], null, 2);
        self::assertCount(2, $sites, 'Deux sites seedes requis pour ce test.');
        [$siteA, $siteB] = $sites;
        $onSiteA = $this->seedClient('Client Sur Site A');
        $this->attachAddressWithSite($onSiteA, $siteA);
        $onSiteB = $this->seedClient('Client Sur Site B');
        $this->attachAddressWithSite($onSiteB, $siteB);
        $names = $this->companyNames($client, '/api/clients?pagination=false&siteId[]='.$siteA->getId());
        self::assertContains('CLIENT SUR SITE A', $names);
        self::assertNotContains('CLIENT SUR SITE B', $names);
    }
    /**
     * ERP-62 (drawer) : statut « Archivés » (?archivedOnly=true) — uniquement les
     * archives, contrairement a includeArchived qui ajoute les archives aux actifs.
     */
    public function testListArchivedOnlyReturnsOnlyArchived(): void
    {
        $client = $this->createAdminClient();
        $this->seedClient('Actif Visible Co');
        $this->seedClient('Archive Visible Co', true);
        $names = $this->companyNames($client, '/api/clients?pagination=false&archivedOnly=true');
        self::assertContains('ARCHIVE VISIBLE CO', $names);
        self::assertNotContains('ACTIF VISIBLE CO', $names);
    }
    /**
     * Rattache une adresse minimale portant un site au client (les sites vivent
     * sur les adresses, RG-1.10).
     */
    private function attachAddressWithSite(ClientEntity $client, Site $site): void
    {
        $em      = $this->getEm();
        $address = new ClientAddress();
        $address->setClient($client);
        $address->setPostalCode('86100');
        $address->setCity('Châtellerault');
        $address->setStreet('1 rue du Test');
        $address->addSite($site);
        $em->persist($address);
        $em->flush();
    }
    /**
     * Helper : recupere les companyName d'une collection /api/clients.
     *
     * @return list<string>
     */
    private function companyNames(Client $client, string $url): array
    {
        $members = $client->request('GET', $url, [
            'headers' => ['Accept' => self::LD],
        ])->toArray()['member'];
        return array_map(static fn (array $c): string => $c['companyName'], $members);
    }
 }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Matthieu	3e2524ae58	feat(commercial) : expose accounting referentials read-only API Expose TvaMode, PaymentDelay, PaymentType et Bank en lecture seule (GetCollection + Get), security commercial.clients.view au niveau operations + ressource. Aucune ecriture declaree -> POST/PATCH/DELETE renvoient 405. Tri par defaut position ASC puis label ASC (spec M1 § 4.7). Pagination serveur conservee (ERP-72) avec paginationClientEnabled pour activer l'echappatoire ?pagination=false (alimenter un select sans pagination). Endpoints : GET /api/tva_modes, /api/payment_delays, /api/payment_types, /api/banks. Tests fonctionnels : 200 + seed, tri position/label, 405 ecritures, 403 sans permission, 401 anonyme, pagination toggle.	2026-06-01 11:50:11 +02:00
Matthieu	2efdb8fec1	feat(commercial) : declare commercial.clients permissions + sync RBAC mirrors Ajoute CommercialModule::permissions() (5 codes commercial.clients.* : view, manage, accounting.view, accounting.manage, archive) — alignes sur les is_granted deja references par ERP-55 (Client ApiResource, ClientProcessor, ClientReadGroupContextBuilder). Synchronise les 3 sources RBAC (regle ABSOLUE n8) : item sidebar "Repertoire clients" (commercial.clients.view), persona user-full dans personas.ts et SeedE2ECommand.php, cle i18n sidebar.commercial.clients. Les roles metier Bureau/Compta/Commerciale/Usine sont seedes par ERP-74 : les 5 permissions sont mappees ici sur le seul persona technique user-full en attendant, sans creer de nouveau persona (regle n7).	2026-06-01 09:45:17 +02:00
Matthieu	e1b8f8a28d	feat(commercial) : add Client API Platform provider + processor + business rules Branche l'API REST du repertoire clients (M1) sur l'entite Client preparee en ERP-54. Operations GetCollection / Get / Post / Patch (pas de Delete au M1 : l'archivage passe par PATCH isArchived). ClientProvider : - liste paginee (Paginator ORM, aligne sur la convention ERP-72) + echappatoire ?pagination=false - exclut archives + soft-deletes par defaut (RG-1.24), ?includeArchived=true reintegre les archives (RG-1.25) - tri companyName ASC (RG-1.26), filtres ?search (fuzzy companyName/lastName/ email) et ?categoryType=<code> - detail : 404 sur soft-delete, embarque contacts/adresses/ribs ClientProcessor : - normalisation serveur via ClientFieldNormalizer (RG-1.18 a 1.21) - 409 sur doublon de nom de societe (RG-1.16) ; 409 dedie sur conflit de restauration (RG-1.23) - gating par onglet : champ comptable -> accounting.manage, isArchived -> archive, mode strict 403 sur tout le payload (RG-1.28) ; archivage exclusif (RG-1.22) + pose/retrait archivedAt - regles metier RG-1.01 (prenom/nom), RG-1.03 (distributor/broker exclusifs + controle du type de categorie), RG-1.12 (Virement -> banque), RG-1.13 (LCR -> >= 1 RIB), RG-1.04 (completude Information pour le role Commerciale) Lecture comptable conditionnelle : ClientReadGroupContextBuilder ajoute le groupe client:read:accounting selon commercial.clients.accounting.view. Resolution des references categorie : CategoryReferenceDenormalizer resout les IRI vers Category quand la propriete est type-hintee par le contrat CategoryInterface (denormalisation impossible sur une interface sinon). Contrats Shared : - CategoryInterface::getCategoryTypeCode() (implemente par Category) pour la verification de type sans import inter-modules - BusinessRoleAwareInterface (implemente par User) + BusinessRoles::COMMERCIALE pour detecter le role metier ; le code de role sera seede par ERP-74 et reutilise par ERP-59/60. RG-1.04 reste dormante tant qu'aucun user ne porte ce role. Coordination stack : - chaines de permission commercial.clients.* referencees ici, declarees en ERP-59 (tests RBAC complets en ERP-60) - config globale de pagination (itemsPerPage client, max 50) portee par ERP-72 - referentiels comptables (PaymentType/Bank/...) exposes en ERP-56 Tests : 31 tests Commercial (integration admin sur les regles metier + unitaires sur le gating, RG-1.04/1.12/1.13 et le context builder). Suite complete verte (339 tests).	2026-05-29 16:41:40 +02:00
Matthieu	311e758dea	feat(commercial) : add M1 client entities + accounting referentials + repositories Entites metier (Client, ClientContact, ClientAddress, ClientRib) avec #[Auditable] + Timestampable/Blamable, et 4 referentiels comptables statiques (TvaMode, PaymentDelay, PaymentType, Bank). 8 repositories interfaces + impl Doctrine. Aucun ApiResource (Provider/Processor = ERP-55). - Client : 2 FK auto-referentes distributor/broker (mutuellement exclusives, CHECK en base), M2M categories, FK referentiels comptables, groupes de serialisation par onglet. Pas de #[ORM\UniqueConstraint] : unicite du nom de societe portee par l'index partiel Postgres (decision Q4). - ClientRib : tous les champs audites, aucun #[AuditIgnore] sur iban/bic (decision 29/05, audit admin-only). - M2M Category via le contrat Shared CategoryInterface + resolve_target_entities (regle n°1, pas d'import inter-modules) ; sites via SiteInterface. - CommercialReferentialFixtures : re-seed idempotent des 4 referentiels (sinon vides apres db-reset car desormais tables mappees, purgees par les fixtures). - Referentiels whitelistes dans EntitiesAreTimestampableBlamableTest::EXCLUDED. - doctrine.yaml : mapping ORM du module Commercial + resolve CategoryInterface. - ColumnCommentsCatalog : ajout des colonnes M1 (chemin schema:update/test) ; migration retrofit Version20260528120000 filtree sur les tables existantes pour ne pas casser sur les tables des modules crees plus tard. - makefile test-db-setup : recreation de l'index partiel uq_client_company_name_active. Refs ERP-54.	2026-05-29 15:36:14 +02:00
Matthieu	9f96d1c40d	feat(commercial) : migrate M1 client tables + accounting referentials + extend category_type seed Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Successful in 1m20s Details Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m36s Details	2026-05-29 14:48:40 +02:00
Matthieu	836f177ff9	docs(commercial) : migration racine + seed fixture CategoryType (blocages ERP-53 vérifiés)	2026-05-29 14:41:43 +02:00
`@@ -1,2 +1,2 @@`
	`parameters:`	`parameters:`
	`app.version: '0.1.70'`	`app.version: '0.1.54'`