tristan
ee1521384e
Auto Tag Develop / tag (push) Successful in 8s
## ERP-62 — Page Répertoire clients (datatable + Ajouter / Exporter) Tâche Lesstime #480. **Stacke sur ERP-61** (clés i18n `commercial.clients.*`) — non encore mergé : la diff vers `develop` inclut le commit ERP-61 tant qu'il n'est pas mergé. ### Front - Page `/clients` (route à plat) : `MalioDataTable` 6 colonnes (Nom entreprise / Contact / Téléphone formaté / Email / codes Catégories / badges Site(s)), toggle « Voir les archivés » (état 100 % local), boutons **+ Ajouter** (visible si `commercial.clients.manage`) et **Exporter** (visible si `view`, télécharge `clients/export.xlsx` via `useApi`), clic ligne → `/clients/{id}`, empty state. - Composable `useClientsRepository` = wrapper de `usePaginatedList<Client>({ url: '/clients' })` + toggle `includeArchived` (repasse page 1). - Util `formatPhoneFR` (signature cible à coordonner avec ERP-66 / 1.13) + clé i18n `showArchived`. ### Back — ⚠️ MAJ contrat de sérialisation (incluse dans cette MR) Le `GET /api/clients` n'exposait ni les codes catégories ni les sites en liste (le bloc Lesstime l'affirmait à tort). Corrigé : - `Client` : `category:read` + `site:read` ajoutés aux `normalizationContext` (GetCollection/Get/Post/Patch) + accesseur agrégé `getSites()` (`#[Groups(client:read)]`). - `DoctrineClientRepository::createListQueryBuilder` : jointures + `addSelect` (categories / addresses / sites) anti N+1. - Aucune migration (pure sérialisation). ### Tests - Back : `ClientApiTest` (codes catégories + sites name/color en liste). `make test` ✅ 454. - Front : `useClientsRepository.spec.ts` + `phone.test.ts`. `vitest` ✅ 111. `nuxi typecheck` ✅ (mes fichiers). ### Non couvert Golden path navigateur non joué : dev-nuxt (conteneur) cassé (résolution `@malio/layer-ui/tailwind.config.ts`) + BDD sans clients démo (nécessite `make db-reset`). Aspects front restants traités séparément. --------- Co-authored-by: Matthieu <contact@malio.fr> Reviewed-on: #44 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
54 lines
1.8 KiB
TypeScript
54 lines
1.8 KiB
TypeScript
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' })
|
|
}
|