feat(commercial) : catégories de type Adresse pour les blocs adresse (client + fournisseur) (#147)

## Objectif

Introduit un `CategoryType` dédié **ADRESSE** (module Catalog) consommé par le champ « Catégorie » des blocs adresse, en remplacement de la réutilisation détournée des types CLIENT / FOURNISSEUR.

## Changements

**Backend**
- Migration de seed du type ADRESSE + 6 catégories : Siège, Contact issues, Facturation, Livraison, Approvisionnement, Méthaniseur (idempotente, réversible) ; fixtures alignées.
- `ClientAddress` : validation blacklist (DISTRIBUTEUR/COURTIER) remplacée par une whitelist « catégories de type ADRESSE uniquement ».
- `SupplierAddress` : type requis FOURNISSEUR → ADRESSE (le bloc principal fournisseur reste en FOURNISSEUR).

**Frontend**
- Ref dédiée `addressCategories` (`?typeCode=ADRESSE`) dans les composables référentiels client et fournisseur.
- Pages new/edit client et fournisseur câblées sur les blocs adresse.

**Tests**
- `CategoryAdresseSeedTest` (miroir du test PRESTATAIRE).
- Adaptation des tests d'adresse client/fournisseur (sémantique whitelist ADRESSE) + helper `createAddressCategory()`.

## Vérifications
- Back : suites Catalog + Architecture + adresse/fournisseur vertes (le flake JWT connu du hook est sans rapport, tests verts en isolation).
- Front : Vitest vert (composables référentiels + ciblés).
- php-cs-fixer : 0 correction ; eslint : OK.

Reviewed-on: #147
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

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

@@ -77,4 +77,23 @@ describe('useClientReferentials.loadCommon (resilience ERP-102)', () => {
         // Le libelle d'un site est son numero de departement (2 premiers chiffres du code postal).
         expect(refs.sites.value).toEqual([{ value: '/api/sites/1', label: '86' }])
     })
+
+    it('separe les categories CLIENT (formulaire) des categories ADRESSE (blocs adresse)', async () => {
+        // Le mock distingue les deux appels /categories par leur filtre typeCode.
+        mockGet.mockImplementation((url: string, query?: Record<string, unknown>) => {
+            if (url === '/categories' && query?.typeCode === 'CLIENT') {
+                return Promise.resolve({ member: [{ '@id': '/api/categories/1', code: 'SECTEUR', name: 'Secteur' }] })
+            }
+            if (url === '/categories' && query?.typeCode === 'ADRESSE') {
+                return Promise.resolve({ member: [{ '@id': '/api/categories/9', code: 'SIEGE', name: 'Siège' }] })
+            }
+            return Promise.resolve({ member: [] })
+        })
+
+        const refs = useClientReferentials()
+        await refs.loadCommon()
+
+        expect(refs.categories.value).toEqual([{ value: '/api/categories/1', label: 'Secteur', code: 'SECTEUR' }])
+        expect(refs.addressCategories.value).toEqual([{ value: '/api/categories/9', label: 'Siège', code: 'SIEGE' }])
+    })
 })

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

@@ -23,6 +23,16 @@ describe('useSupplierReferentials', () => {
         )
     })
 
+    it('charge les categories d\'adresse filtrees sur le type ADRESSE', async () => {
+        await useSupplierReferentials().loadCommon()
+
+        expect(mockGet).toHaveBeenCalledWith(
+            '/categories',
+            expect.objectContaining({ pagination: 'false', typeCode: 'ADRESSE' }),
+            expect.objectContaining({ toast: false }),
+        )
+    })
+
     it('mappe les categories en options { value: IRI, label: name, code }', async () => {
         mockGet.mockImplementation((url: string) => {
             if (url === '/categories') {

frontend/modules/commercial/composables/useClientReferentials.ts

@@ -68,6 +68,9 @@ export function useClientReferentials() {
     const api = useApi()
 
     const categories = ref<CategoryOption[]>([])
+    // Taxonomie dediee aux blocs adresse (type ADRESSE), distincte des categories
+    // CLIENT du formulaire principal.
+    const addressCategories = ref<CategoryOption[]>([])
     const sites = ref<RefOption[]>([])
     const tvaModes = ref<RefOption[]>([])
     const paymentDelays = ref<RefOption[]>([])
@@ -109,6 +112,9 @@ export function useClientReferentials() {
             // de type CLIENT (pas FOURNISSEUR) -> on filtre la collection cote API.
             fetchAll<CategoryMember>('/categories', { typeCode: 'CLIENT' })
                 .then((cats) => { categories.value = cats.map(c => ({ value: c['@id'], label: c.name, code: c.code })) }),
+            // Categories des blocs adresse : taxonomie dediee type ADRESSE.
+            fetchAll<CategoryMember>('/categories', { typeCode: 'ADRESSE' })
+                .then((cats) => { addressCategories.value = cats.map(c => ({ value: c['@id'], label: c.name, code: c.code })) }),
             fetchAll<SiteMember>('/sites')
                 // Libelle = numero de departement (2 premiers chiffres du code
                 // postal du site), ex: 86100 -> « 86 ». Le code postal est deja
@@ -151,6 +157,7 @@ export function useClientReferentials() {
 
     return {
         categories,
+        addressCategories,
         sites,
         tvaModes,
         paymentDelays,

frontend/modules/commercial/composables/useSupplierReferentials.ts

@@ -62,6 +62,9 @@ export function useSupplierReferentials() {
     const api = useApi()
 
     const categories = ref<CategoryOption[]>([])
+    // Taxonomie dediee aux blocs adresse (type ADRESSE), distincte des categories
+    // FOURNISSEUR du formulaire principal.
+    const addressCategories = ref<CategoryOption[]>([])
     const sites = ref<RefOption[]>([])
     const tvaModes = ref<RefOption[]>([])
     const paymentDelays = ref<RefOption[]>([])
@@ -97,6 +100,9 @@ export function useSupplierReferentials() {
             // categories de type FOURNISSEUR (RG-2.10) -> on filtre cote API.
             fetchAll<CategoryMember>('/categories', { typeCode: 'FOURNISSEUR' })
                 .then((cats) => { categories.value = cats.map(c => ({ value: c['@id'], label: c.name, code: c.code })) }),
+            // Categories des blocs adresse : taxonomie dediee type ADRESSE.
+            fetchAll<CategoryMember>('/categories', { typeCode: 'ADRESSE' })
+                .then((cats) => { addressCategories.value = cats.map(c => ({ value: c['@id'], label: c.name, code: c.code })) }),
             fetchAll<SiteMember>('/sites')
                 // Libelle = numero de departement (2 premiers chiffres du code
                 // postal du site), ex: 86100 -> « 86 ».
@@ -121,6 +127,7 @@ export function useSupplierReferentials() {
 
     return {
         categories,
+        addressCategories,
         sites,
         tvaModes,
         paymentDelays,

frontend/modules/commercial/pages/clients/[id]/edit.vue

@@ -479,9 +479,6 @@ import { readHistoryTab } from '~/shared/utils/historyTab'
 const SIREN_MASK = '#########'
 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()
@@ -573,15 +570,17 @@ function mergeOptions<T extends { value: string }>(primary: T[], extra: T[]): T[
     return [...primary, ...extra.filter(o => !seen.has(o.value))]
 }
 
-const embedCategoryOptions = computed<CategoryOption[]>(() => {
-    const fromClient = categoryOptionsOf(client.value?.categories)
-    const fromAddresses = (client.value?.addresses ?? []).flatMap(a => categoryOptionsOf(a.categories))
-    return mergeOptions(fromClient, fromAddresses)
-})
-const mainCategoryOptions = computed(() => mergeOptions(referentials.categories.value, embedCategoryOptions.value))
-// Categories autorisees sur une adresse : toutes SAUF DISTRIBUTEUR/COURTIER (RG-1.29).
+// Categories du formulaire principal (type CLIENT) : referentiel UNION categories
+// embarquees du client (fallback si le referentiel n'est pas chargeable).
+const embedClientCategoryOptions = computed<CategoryOption[]>(() => categoryOptionsOf(client.value?.categories))
+const mainCategoryOptions = computed(() => mergeOptions(referentials.categories.value, embedClientCategoryOptions.value))
+// Categories des blocs adresse (type ADRESSE) : referentiel dedie UNION categories
+// embarquees des adresses (fallback meme fonction qu'au-dessus).
+const embedAddressCategoryOptions = computed<CategoryOption[]>(() =>
+    mergeOptions([], (client.value?.addresses ?? []).flatMap(a => categoryOptionsOf(a.categories))),
+)
 const addressCategoryOptions = computed(() =>
-    mainCategoryOptions.value.filter(c => !FORBIDDEN_ADDRESS_CATEGORY_CODES.includes(c.code)),
+    mergeOptions(referentials.addressCategories.value, embedAddressCategoryOptions.value),
 )
 
 const embedSiteOptions = computed<RefOption[]>(() =>

frontend/modules/commercial/pages/clients/new.vue

@@ -456,9 +456,6 @@ 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()
@@ -816,10 +813,8 @@ async function submitContacts(): Promise<void> {
 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)),
-)
+// Categories autorisees sur une adresse : taxonomie dediee type ADRESSE.
+const addressCategoryOptions = computed(() => referentials.addressCategories.value)
 
 // Contacts deja crees, rattachables a une adresse (M2M, via leur IRI).
 const contactOptions = computed<RefOption[]>(() =>

frontend/modules/commercial/pages/suppliers/[id]/edit.vue

@@ -181,7 +181,7 @@
                             :model-value="address"
                             :title="t('commercial.suppliers.form.address.title', { n: index + 1 })"
                             :last="index === addresses.length - 1"
-                            :category-options="mainCategoryOptions"
+                            :category-options="addressCategoryOptions"
                             :site-options="siteOptions"
                             :contact-options="contactOptions"
                             :country-options="countryOptions"
@@ -536,15 +536,18 @@ function mergeOptions<T extends { value: string }>(primary: T[], extra: T[]): T[
     return [...primary, ...extra.filter(o => !seen.has(o.value))]
 }
 
-// Categories issues de l'embed (fournisseur + adresses), role-independantes.
-const embedCategoryOptions = computed<CategoryOption[]>(() => {
-    const fromSupplier = categoryOptionsOf(supplier.value?.categories)
-    const fromAddresses = (supplier.value?.addresses ?? []).flatMap(a => categoryOptionsOf(a.categories))
-    return mergeOptions(fromSupplier, fromAddresses)
-})
-// Toutes les categories de type FOURNISSEUR sont autorisees, sur le bloc principal
-// comme sur une adresse (pas de restriction Distributeur/Courtier comme au M1 — RG-2.10).
-const mainCategoryOptions = computed(() => mergeOptions(referentials.categories.value, embedCategoryOptions.value))
+// Categories du formulaire principal (type FOURNISSEUR) : referentiel UNION
+// categories embarquees du fournisseur (fallback si referentiel non chargeable).
+const embedSupplierCategoryOptions = computed<CategoryOption[]>(() => categoryOptionsOf(supplier.value?.categories))
+const mainCategoryOptions = computed(() => mergeOptions(referentials.categories.value, embedSupplierCategoryOptions.value))
+// Categories des blocs adresse (type ADRESSE) : referentiel dedie UNION categories
+// embarquees des adresses (meme logique de fallback).
+const embedAddressCategoryOptions = computed<CategoryOption[]>(() =>
+    mergeOptions([], (supplier.value?.addresses ?? []).flatMap(a => categoryOptionsOf(a.categories))),
+)
+const addressCategoryOptions = computed(() =>
+    mergeOptions(referentials.addressCategories.value, embedAddressCategoryOptions.value),
+)
 
 const embedSiteOptions = computed<RefOption[]>(() =>
     mergeOptions([], (supplier.value?.addresses ?? []).flatMap(a => siteOptionsOf(a.sites))),

frontend/modules/commercial/pages/suppliers/new.vue

@@ -179,7 +179,7 @@
                         :model-value="address"
                         :title="t('commercial.suppliers.form.address.title', { n: index + 1 })"
                         :last="index === addresses.length - 1"
-                        :category-options="referentials.categories.value"
+                        :category-options="referentials.addressCategories.value"
                         :site-options="referentials.sites.value"
                         :contact-options="contactOptions"
                         :country-options="countryOptions"