feat(commercial) : filtres répertoire clients via drawer (recherche, catégories, sites, archivés)

Front :
- Bouton « Filtres » (à droite d'Ajouter) ouvrant un drawer accordion (façon
  audit-log) : Recherche, Catégories (multi), Sites (multi), Statut (archivés).
  État brouillon → appliqué, 100 % local. Compteur de filtres actifs sur le bouton.
- Suppression du toggle « Voir les archivés » (remplacé par le bool du drawer).
- Export et liste partagent les mêmes filtres.
- useClientsRepository redevient un simple wrapper de usePaginatedList.

Back (contrat liste partagé liste + export) :
- createListQueryBuilder : categoryCodes[] (OR), siteIds[] (clients ayant ≥1
  adresse sur le site), archivedOnly (archives seules, prioritaire sur
  includeArchived). search inchangé.
- ClientProvider + ClientExportController lisent les nouveaux params (valeur
  unique ou liste ?key[]=). Tests fonctionnels (catégories multi, site, archivés).

frontend/modules/commercial/composables/__tests__/useClientsRepository.spec.ts

@@ -29,11 +29,10 @@ describe('useClientsRepository', () => {
         mockGet.mockResolvedValue(makeHydra(25))
     })
 
-    it('charge /clients sans includeArchived par defaut (clients actifs)', async () => {
+    it('cible la ressource /clients en page 1 par defaut', async () => {
         const repo = useClientsRepository()
         await repo.fetch()
 
-        expect(repo.includeArchived.value).toBe(false)
         expect(mockGet).toHaveBeenLastCalledWith(
             '/clients',
             { page: 1, itemsPerPage: 10 },
@@ -41,35 +40,42 @@ describe('useClientsRepository', () => {
         )
     })
 
-    it('pousse le filtre serveur includeArchived=true quand le toggle est actif', async () => {
-        const repo = useClientsRepository()
-        await repo.fetch()
-        await repo.setIncludeArchived(true)
-
-        expect(repo.includeArchived.value).toBe(true)
-        expect(mockGet).toHaveBeenLastCalledWith(
-            '/clients',
-            { includeArchived: true, page: 1, itemsPerPage: 10 },
-            expect.objectContaining({ toast: false }),
-        )
-    })
-
-    it('retombe en page 1 lorsqu on bascule le toggle archives', async () => {
+    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.setIncludeArchived(true)
+        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('retire le filtre (query propre) quand le toggle repasse a false', async () => {
+    it('repasse a une query propre apres reinitialisation des filtres', async () => {
         const repo = useClientsRepository()
-        await repo.setIncludeArchived(true)
-        await repo.setIncludeArchived(false)
+        await repo.setFilters({ search: 'acme', archivedOnly: true }, { replace: true })
+        await repo.setFilters({}, { replace: true })
 
-        expect(repo.includeArchived.value).toBe(false)
         expect(mockGet).toHaveBeenLastCalledWith(
             '/clients',
             { page: 1, itemsPerPage: 10 },

frontend/modules/commercial/composables/useClientsRepository.ts

@@ -1,4 +1,3 @@
-import { ref } from 'vue'
 import { usePaginatedList } from '~/shared/composables/usePaginatedList'
 
 /**
@@ -41,11 +40,8 @@ export interface Client {
  * sur la ressource `/clients` (RG-13 : pagination serveur obligatoire ; jamais
  * de chargement integral en memoire).
  *
- * N'ajoute qu'un seul comportement metier : le toggle « Voir les archivés ».
- * Desactive par defaut (la liste n'expose que les clients actifs — RG-1.24).
- * Active, il pousse le filtre serveur `?includeArchived=true` (consomme par le
- * ClientProvider, RG-1.25) et — garantie de `usePaginatedList` — retombe en
- * page 1.
+ * 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
@@ -53,28 +49,5 @@ export interface Client {
  * gerer.
  */
 export function useClientsRepository() {
-    // Etat local du toggle « Voir les archivés » — JAMAIS reflete dans l'URL
-    // (regle ABSOLUE n°6).
-    const includeArchived = ref(false)
-
-    const list = usePaginatedList<Client>({ url: '/clients' })
-
-    /**
-     * Bascule l'inclusion des clients archives et relance la liste. La remise
-     * en page 1 est assuree par `setFilters` (usePaginatedList). Quand le toggle
-     * repasse a false, on RETIRE le filtre (valeur `undefined`) plutot que
-     * d'envoyer `includeArchived=false`, pour une query propre.
-     */
-    async function setIncludeArchived(value: boolean): Promise<void> {
-        includeArchived.value = value
-        await list.setFilters(
-            value ? { includeArchived: true } : { includeArchived: undefined },
-        )
-    }
-
-    return {
-        ...list,
-        includeArchived,
-        setIncludeArchived,
-    }
+    return usePaginatedList<Client>({ url: '/clients' })
 }