chore: bump version to v0.1.135

config/version.yaml

@@ -1,2 +1,2 @@
 parameters:
-    app.version: '0.1.131'
+    app.version: '0.1.135'

frontend/i18n/locales/fr.json

@@ -527,7 +527,9 @@
                 "error": "Une erreur est survenue. Réessayez.",
                 "exportError": "L'export du répertoire transporteurs a échoué. Réessayez.",
                 "createSuccess": "Transporteur créé avec succès",
-                "integrateSuccess": "Transporteur QUALIMAT intégré"
+                "integrateSuccess": "Transporteur QUALIMAT intégré",
+                "addressSaved": "Adresse enregistrée",
+                "contactSaved": "Contact enregistré"
             },
             "containerType": {
                 "BENNE": "Benne",
@@ -578,6 +580,34 @@
                     "indexationRequired": "Le taux d'indexation est obligatoire pour un transporteur affrété.",
                     "containerTypeRequired": "Le type de contenant est obligatoire pour un transporteur affrété.",
                     "volumeRequired": "Le volume est obligatoire pour un transporteur affrété."
+                },
+                "address": {
+                    "country": "Pays",
+                    "postalCode": "Code postal",
+                    "city": "Ville",
+                    "street": "Adresse",
+                    "streetComplement": "Adresse complémentaire",
+                    "streetNotFound": "Adresse introuvable ? Saisissez-la directement.",
+                    "add": "Nouvelle adresse",
+                    "remove": "Supprimer l'adresse",
+                    "degraded": "Service d'adresse indisponible : saisie de la ville et de l'adresse en mode libre."
+                },
+                "contact": {
+                    "lastName": "Nom",
+                    "firstName": "Prénom",
+                    "jobTitle": "Fonction",
+                    "phonePrimary": "Téléphone",
+                    "phoneSecondary": "Téléphone (2)",
+                    "addPhone": "Ajouter un numéro",
+                    "email": "Email",
+                    "add": "Nouveau contact",
+                    "remove": "Supprimer le contact"
+                },
+                "confirmDelete": {
+                    "title": "Supprimer ce bloc",
+                    "message": "Cette suppression est définitive. Confirmer ?",
+                    "cancel": "Annuler",
+                    "confirm": "Supprimer"
                 }
             }
         }

frontend/modules/transport/components/CarrierAddressBlock.vue

@@ -0,0 +1,237 @@
+<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 : modal de confirmation cote parent. -->
+        <MalioButtonIcon
+            v-if="removable && !readonly"
+            icon="mdi:delete-outline"
+            variant="ghost"
+            button-class="absolute top-3 right-3"
+            v-bind="{ ariaLabel: t('transport.carriers.form.address.remove') }"
+            @click="$emit('remove')"
+        />
+
+        <!-- Pays : prerempli « France » (RG-4.05). -->
+        <MalioSelect
+            :model-value="model.country"
+            :options="countryOptions"
+            :label="t('transport.carriers.form.address.country')"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.country"
+            @update:model-value="(v: string | number | null) => update('country', String(v ?? 'France'))"
+        />
+
+        <!-- Code postal (RG-4.06) : declenche l'autocomplete ville (BAN). -->
+        <MalioInputText
+            :model-value="model.postalCode"
+            :label="t('transport.carriers.form.address.postalCode')"
+            :mask="POSTAL_CODE_MASK"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.postalCode"
+            @update:model-value="onPostalCodeChange"
+        />
+
+        <!-- Ville : MalioSelect alimente par le code postal (BAN). Saisie libre si BAN indispo. -->
+        <MalioSelect
+            v-if="!degraded"
+            :model-value="model.city"
+            :options="cityOptions"
+            :label="t('transport.carriers.form.address.city')"
+            :readonly="readonly"
+            empty-option-label=""
+            :required="true"
+            :error="errors?.city"
+            @update:model-value="(v: string | number | null) => update('city', v === null ? null : String(v))"
+        />
+        <MalioInputText
+            v-else
+            :model-value="model.city"
+            :label="t('transport.carriers.form.address.city')"
+            :readonly="readonly"
+            :required="true"
+            :error="errors?.city"
+            @update:model-value="(v: string) => update('city', v)"
+        />
+
+        <!-- Filler : aligne le debut de la ligne suivante sur la grille. -->
+        <div aria-hidden="true" />
+
+        <!-- Adresse (BAN) sur 2 colonnes + Adresse complementaire. allow-create : le
+             texte saisi est conserve si la BAN ne propose rien (saisie manuelle). -->
+        <div class="col-span-2">
+            <MalioInputAutocomplete
+                v-if="!readonly"
+                :model-value="model.street"
+                :options="addressOptions"
+                :loading="addressLoading"
+                :min-search-length="3"
+                :label="t('transport.carriers.form.address.street')"
+                :readonly="readonly"
+                :required="true"
+                :error="errors?.street"
+                :allow-create="true"
+                :no-results-text="t('transport.carriers.form.address.streetNotFound')"
+                @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('transport.carriers.form.address.street')"
+                :readonly="readonly"
+                :required="true"
+                :error="errors?.street"
+                @update:model-value="(v: string) => update('street', v)"
+            />
+        </div>
+
+        <MalioInputText
+            :model-value="model.streetComplement"
+            :label="t('transport.carriers.form.address.streetComplement')"
+            :readonly="readonly"
+            :error="errors?.streetComplement"
+            @update:model-value="(v: string) => update('streetComplement', v)"
+        />
+    </div>
+</template>
+
+<script setup lang="ts">
+import { useAddressAutocomplete, type AddressSuggestion } from '~/shared/composables/useAddressAutocomplete'
+import type { CarrierAddressFormDraft } from '~/modules/transport/types/carrierForm'
+
+interface RefOption {
+    value: string
+    label: string
+}
+
+// Masque code postal FR : 5 chiffres.
+const POSTAL_CODE_MASK = '#####'
+
+const props = defineProps<{
+    /** Brouillon de l'adresse (v-model). */
+    modelValue: CarrierAddressFormDraft
+    /** Pays disponibles (France par defaut). */
+    countryOptions: RefOption[]
+    removable?: boolean
+    readonly?: boolean
+    /** Erreurs serveur 422 de cette ligne, indexees par champ (ERP-101). */
+    errors?: Record<string, string>
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: CarrierAddressFormDraft]
+    'remove': []
+    /** Emis une fois quand le service d'autocompletion bascule en indisponible. */
+    'degraded': []
+}>()
+
+const { t } = useI18n()
+const autocomplete = useAddressAutocomplete()
+
+const model = computed(() => props.modelValue)
+
+// Repli saisie libre de la VILLE quand la BAN est indisponible (recuperable).
+const degraded = ref(false)
+let unavailableNotified = false
+const banCityOptions = ref<RefOption[]>([])
+const banAddressOptions = ref<RefOption[]>([])
+
+// Options ville effectives : on garantit que la ville courante figure toujours
+// dans la liste, sinon MalioSelect afficherait un champ vide en lecture seule.
+const cityOptions = computed<RefOption[]>(() => {
+    const current = props.modelValue.city
+    if (current && !banCityOptions.value.some(o => o.value === current)) {
+        return [{ value: current, label: current }, ...banCityOptions.value]
+    }
+    return banCityOptions.value
+})
+
+// Meme garantie pour le champ Adresse : la rue courante doit toujours figurer
+// dans les options, sinon MalioInputAutocomplete laisse le champ vide.
+const addressOptions = computed<RefOption[]>(() => {
+    const current = props.modelValue.street
+    if (current && !banAddressOptions.value.some(o => o.value === current)) {
+        return [{ value: current, label: current }, ...banAddressOptions.value]
+    }
+    return banAddressOptions.value
+})
+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 CarrierAddressFormDraft>(field: K, value: CarrierAddressFormDraft[K]): void {
+    emit('update:modelValue', { ...props.modelValue, [field]: value })
+}
+
+/** Previent le parent (toast unique) que l'autocompletion est indisponible. */
+function notifyUnavailable(): void {
+    if (!unavailableNotified) {
+        unavailableNotified = 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)
+
+    const digits = (value ?? '').replace(/\D/g, '')
+    if (digits.length < 5) {
+        return
+    }
+    try {
+        const suggestions = await autocomplete.searchCity(digits)
+        banCityOptions.value = suggestions.map(s => ({ value: s.city, label: s.city }))
+        degraded.value = false
+    }
+    catch {
+        degraded.value = true
+        notifyUnavailable()
+    }
+}
+
+/** Recherche d'adresse assistee (event de MalioInputAutocomplete). */
+async function onAddressSearch(query: string): Promise<void> {
+    // La BAN exige au moins 3 caracteres : on n'envoie rien en deca (evite un 400).
+    if (query.trim().length < 3) {
+        banAddressOptions.value = []
+        return
+    }
+    addressLoading.value = true
+    try {
+        const postalCode = (model.value.postalCode ?? '').replace(/\D/g, '') || undefined
+        const suggestions = await autocomplete.searchAddress(query, postalCode)
+        lastAddressSuggestions = suggestions
+        banAddressOptions.value = suggestions.map(s => ({ value: s.street, label: s.label }))
+    }
+    catch {
+        // Erreur transitoire : on vide les suggestions, la prochaine frappe reessaie.
+        banAddressOptions.value = []
+        notifyUnavailable()
+    }
+    finally {
+        addressLoading.value = false
+    }
+}
+
+/** Selection d'une suggestion d'adresse → remplit rue + ville + CP. */
+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>

frontend/modules/transport/components/CarrierContactBlock.vue

@@ -0,0 +1,108 @@
+<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 côté parent. Masquée si
+             non supprimable (1er bloc) ou en lecture seule. -->
+        <MalioButtonIcon
+            v-if="removable && !readonly"
+            icon="mdi:delete-outline"
+            variant="ghost"
+            button-class="absolute top-3 right-3"
+            v-bind="{ ariaLabel: t('transport.carriers.form.contact.remove') }"
+            @click="$emit('remove')"
+        />
+
+        <MalioInputText
+            :model-value="model.lastName"
+            :label="t('transport.carriers.form.contact.lastName')"
+            :readonly="readonly"
+            :error="errors?.lastName"
+            @update:model-value="(v: string) => update('lastName', v)"
+        />
+        <MalioInputText
+            :model-value="model.firstName"
+            :label="t('transport.carriers.form.contact.firstName')"
+            :readonly="readonly"
+            :error="errors?.firstName"
+            @update:model-value="(v: string) => update('firstName', v)"
+        />
+        <!-- Fonction sur 2 colonnes : on wrappe car MalioInputText (inheritAttrs:false)
+             renvoie `class` sur l'input interne, pas sur la cellule de grille. -->
+        <div class="col-span-2">
+            <MalioInputText
+                :model-value="model.jobTitle"
+                :label="t('transport.carriers.form.contact.jobTitle')"
+                :readonly="readonly"
+                :error="errors?.jobTitle"
+                @update:model-value="(v: string) => update('jobTitle', v)"
+            />
+        </div>
+        <MalioInputEmail
+            :model-value="model.email"
+            :label="t('transport.carriers.form.contact.email')"
+            :readonly="readonly"
+            :lowercase="true"
+            :error="errors?.email"
+            @update:model-value="(v: string) => update('email', v)"
+        />
+        <!-- Téléphone principal + bouton « + » révélant le 2e numéro (max 2). -->
+        <MalioInputPhone
+            :model-value="model.phonePrimary"
+            :label="t('transport.carriers.form.contact.phonePrimary')"
+            :mask="PHONE_MASK"
+            :readonly="readonly"
+            :error="errors?.phonePrimary"
+            :addable="!model.hasSecondaryPhone && !readonly"
+            :add-button-label="t('transport.carriers.form.contact.addPhone')"
+            @update:model-value="(v: string) => update('phonePrimary', v)"
+            @add="revealSecondaryPhone"
+        />
+        <!-- 2e numéro : révélé à la demande (max 2 téléphones — RG-4.08). -->
+        <MalioInputPhone
+            v-if="model.hasSecondaryPhone"
+            :model-value="model.phoneSecondary"
+            :label="t('transport.carriers.form.contact.phoneSecondary')"
+            :mask="PHONE_MASK"
+            :readonly="readonly"
+            :error="errors?.phoneSecondary"
+            @update:model-value="(v: string) => update('phoneSecondary', v)"
+        />
+    </div>
+</template>
+
+<script setup lang="ts">
+import type { CarrierContactFormDraft } from '~/modules/transport/types/carrierForm'
+
+// Masque téléphone FR : 5 groupes de 2 chiffres (la normalisation finale reste serveur).
+const PHONE_MASK = '## ## ## ## ##'
+
+const props = defineProps<{
+    /** Brouillon du contact (v-model). */
+    modelValue: CarrierContactFormDraft
+    /** Affiche l'icône de suppression (1er bloc non supprimable). */
+    removable?: boolean
+    /** Bloc en lecture seule (onglet validé). */
+    readonly?: boolean
+    /** Erreurs serveur 422 de cette ligne, indexées par champ (ERP-101). */
+    errors?: Record<string, string>
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: CarrierContactFormDraft]
+    'remove': []
+}>()
+
+const { t } = useI18n()
+
+// Alias local pour la lisibilité du template.
+const model = computed(() => props.modelValue)
+
+/** Émet un nouveau brouillon avec le champ modifié (immutabilité). */
+function update<K extends keyof CarrierContactFormDraft>(field: K, value: CarrierContactFormDraft[K]): void {
+    emit('update:modelValue', { ...props.modelValue, [field]: value })
+}
+
+/** Révèle le 2e numéro (max 1 secondaire, le « + » disparaît). */
+function revealSecondaryPhone(): void {
+    emit('update:modelValue', { ...props.modelValue, hasSecondaryPhone: true })
+}
+</script>

frontend/modules/transport/components/__tests__/CarrierAddressBlock.spec.ts

@@ -0,0 +1,150 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { mount, flushPromises } from '@vue/test-utils'
+import { defineComponent, h, ref, computed } from 'vue'
+import { emptyCarrierAddress } from '~/modules/transport/types/carrierForm'
+import CarrierAddressBlock from '../CarrierAddressBlock.vue'
+
+/**
+ * Tests de l'autocomplétion BAN du bloc Adresse transporteur (ERP-167) — réutilise
+ * `useAddressAutocomplete` (M1/M2/M3). On vérifie le NOMINAL (CP → ville) et le
+ * DÉGRADÉ (BAN indisponible → saisie libre + event `degraded`).
+ */
+
+const { searchCityMock, searchAddressMock } = vi.hoisted(() => ({
+    searchCityMock: vi.fn(),
+    searchAddressMock: vi.fn(),
+}))
+vi.mock('~/shared/composables/useAddressAutocomplete', () => ({
+    useAddressAutocomplete: () => ({
+        searchCity: searchCityMock,
+        searchAddress: searchAddressMock,
+    }),
+}))
+
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('ref', ref)
+vi.stubGlobal('computed', computed)
+
+const MalioInputTextStub = defineComponent({
+    name: 'MalioInputText',
+    props: { modelValue: { default: null }, label: { type: String, default: '' }, error: { type: String, default: '' } },
+    emits: ['update:modelValue'],
+    setup(props) {
+        return () => h('div', { 'data-testid': 'input-text', 'data-label': props.label, 'data-error': props.error })
+    },
+})
+
+const MalioSelectStub = defineComponent({
+    name: 'MalioSelect',
+    props: { modelValue: { default: null }, options: { type: Array as () => { value: string }[], default: () => [] }, label: { type: String, default: '' }, error: { type: String, default: '' } },
+    emits: ['update:modelValue'],
+    setup(props) {
+        return () => h('div', { 'data-testid': 'select', 'data-label': props.label, 'data-options': JSON.stringify(props.options.map(o => o.value)) })
+    },
+})
+
+const MalioInputAutocompleteStub = defineComponent({
+    name: 'MalioInputAutocomplete',
+    props: { modelValue: { default: null }, options: { type: Array as () => { value: string }[], default: () => [] }, loading: { type: Boolean, default: false }, allowCreate: { type: Boolean, default: false } },
+    emits: ['update:modelValue', 'search', 'select'],
+    setup(props) {
+        return () => h('div', { 'data-testid': 'addr-autocomplete', 'data-options': JSON.stringify(props.options.map(o => o.value)) })
+    },
+})
+
+function mountBlock(overrides: Record<string, unknown> = {}) {
+    return mount(CarrierAddressBlock, {
+        props: {
+            modelValue: { ...emptyCarrierAddress(), ...overrides },
+            countryOptions: [{ value: 'France', label: 'France' }],
+        },
+        global: {
+            stubs: {
+                MalioButtonIcon: true,
+                MalioInputText: MalioInputTextStub,
+                MalioSelect: MalioSelectStub,
+                MalioInputAutocomplete: MalioInputAutocompleteStub,
+            },
+        },
+    })
+}
+
+/** Récupère le composant MalioInputText d'un label donné. */
+function inputTextByLabel(wrapper: ReturnType<typeof mountBlock>, label: string) {
+    return wrapper.findAllComponents(MalioInputTextStub).find(c => c.props('label') === label)
+}
+
+describe('CarrierAddressBlock — autocomplétion ville (BAN) NOMINAL', () => {
+    beforeEach(() => {
+        searchCityMock.mockReset()
+        searchAddressMock.mockReset()
+    })
+
+    it('saisie d\'un CP à 5 chiffres → searchCity + peuple le select Ville', async () => {
+        searchCityMock.mockResolvedValueOnce([{ city: 'Poitiers', postalCode: '86000' }])
+        const wrapper = mountBlock()
+
+        const cp = inputTextByLabel(wrapper, 'transport.carriers.form.address.postalCode')
+        cp?.vm.$emit('update:modelValue', '86000')
+        await flushPromises()
+
+        expect(searchCityMock).toHaveBeenCalledWith('86000')
+        const citySelect = wrapper.findAllComponents(MalioSelectStub).find(c => c.props('label') === 'transport.carriers.form.address.city')
+        const options = JSON.parse(citySelect?.attributes('data-options') ?? '[]')
+        expect(options).toContain('Poitiers')
+        expect(wrapper.emitted('degraded')).toBeUndefined()
+    })
+
+    it('n\'interroge pas la BAN sous 5 chiffres', async () => {
+        const wrapper = mountBlock()
+        inputTextByLabel(wrapper, 'transport.carriers.form.address.postalCode')?.vm.$emit('update:modelValue', '860')
+        await flushPromises()
+        expect(searchCityMock).not.toHaveBeenCalled()
+    })
+})
+
+describe('CarrierAddressBlock — autocomplétion DÉGRADÉE', () => {
+    beforeEach(() => {
+        searchCityMock.mockReset()
+        searchAddressMock.mockReset()
+    })
+
+    it('BAN ville indisponible → bascule en saisie libre + émet « degraded »', async () => {
+        searchCityMock.mockRejectedValueOnce(new Error('BAN indisponible'))
+        const wrapper = mountBlock()
+
+        inputTextByLabel(wrapper, 'transport.carriers.form.address.postalCode')?.vm.$emit('update:modelValue', '86000')
+        await flushPromises()
+
+        expect(wrapper.emitted('degraded')).toHaveLength(1)
+        // En dégradé, la Ville devient un MalioInputText (plus de MalioSelect ville).
+        const citySelect = wrapper.findAllComponents(MalioSelectStub).find(c => c.props('label') === 'transport.carriers.form.address.city')
+        expect(citySelect).toBeUndefined()
+        expect(inputTextByLabel(wrapper, 'transport.carriers.form.address.city')).toBeDefined()
+    })
+
+    it('autocomplétion adresse : pas d\'appel BAN sous 3 caractères', async () => {
+        const wrapper = mountBlock()
+        wrapper.findComponent(MalioInputAutocompleteStub).vm.$emit('search', 'ab')
+        await flushPromises()
+        expect(searchAddressMock).not.toHaveBeenCalled()
+    })
+
+    it('autocomplétion adresse : émet « degraded » une seule fois malgré plusieurs erreurs', async () => {
+        searchAddressMock.mockRejectedValue(new Error('BAN indisponible'))
+        const wrapper = mountBlock()
+        const auto = wrapper.findComponent(MalioInputAutocompleteStub)
+
+        auto.vm.$emit('search', 'rue de la paix')
+        await flushPromises()
+        auto.vm.$emit('search', 'rue de la paixx')
+        await flushPromises()
+
+        expect(wrapper.emitted('degraded')).toHaveLength(1)
+    })
+
+    it('active allow-create sur le champ Adresse (saisie manuelle libre)', () => {
+        const wrapper = mountBlock()
+        expect(wrapper.findComponent(MalioInputAutocompleteStub).props('allowCreate')).toBe(true)
+    })
+})

frontend/modules/transport/composables/__tests__/useCarrierForm.test.ts

@@ -19,13 +19,14 @@ import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 const mockPost = vi.hoisted(() => vi.fn())
 const mockPatch = vi.hoisted(() => vi.fn())
+const mockDelete = vi.hoisted(() => vi.fn())
 
 vi.stubGlobal('useApi', () => ({
     get: vi.fn(),
     post: mockPost,
     put: vi.fn(),
     patch: mockPatch,
-    delete: vi.fn(),
+    delete: mockDelete,
 }))
 vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
 vi.stubGlobal('useToast', () => ({
@@ -36,6 +37,8 @@ vi.stubGlobal('useToast', () => ({
 }))
 
 const { useCarrierForm, CARRIER_TAB_KEYS } = await import('../useCarrierForm')
+const { buildCarrierContactPayload, isCarrierContactBlank, isCarrierContactNamed } = await import('../../utils/forms/carrierContact')
+const { emptyCarrierContact } = await import('../../types/carrierForm')
 
 describe('useCarrierForm', () => {
     beforeEach(() => {
@@ -431,4 +434,268 @@ describe('useCarrierForm — copie QUALIMAT (ERP-166)', () => {
             certificationType: 'QUALIMAT',
         })
     })
+
+    it('applyQualimatSelection pré-remplit le 1er bloc d\'adresse (RG-4.05)', async () => {
+        const form = useCarrierForm()
+        form.main.name = 'Acme'
+
+        await form.applyQualimatSelection(QUALIMAT_ROW)
+
+        expect(form.addresses.value).toHaveLength(1)
+        expect(form.addresses.value[0]).toEqual({
+            id: null,
+            country: 'France',
+            postalCode: '86000',
+            city: 'Poitiers',
+            street: '1 rue du Port',
+            streetComplement: null,
+        })
+    })
+})
+
+describe('useCarrierForm — onglet Adresses (ERP-167)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        mockDelete.mockReset()
+    })
+
+    /** Transporteur créé, onglet Adresses accessible. */
+    function createdForm() {
+        const form = useCarrierForm()
+        form.carrierId.value = 7
+        return form
+    }
+
+    /** Remplit un bloc adresse complet (CP + ville + rue). */
+    function fillAddress(form: ReturnType<typeof useCarrierForm>, index = 0): void {
+        const a = form.addresses.value[index]
+        if (a) {
+            a.postalCode = '86100'
+            a.city = 'Châtellerault'
+            a.street = '1 rue du Test'
+        }
+    }
+
+    it('canAddAddress : désactivé tant que la dernière adresse est incomplète', () => {
+        const form = createdForm()
+        expect(form.canAddAddress.value).toBe(false)
+
+        form.addAddress()
+        expect(form.addresses.value).toHaveLength(1) // no-op tant qu'incomplète
+
+        fillAddress(form)
+        expect(form.canAddAddress.value).toBe(true)
+        form.addAddress()
+        expect(form.addresses.value).toHaveLength(2)
+    })
+
+    it('submitAddresses : POST des nouvelles adresses, capture l\'id, finalise l\'onglet', async () => {
+        mockPost.mockResolvedValueOnce({ id: 88 })
+        const form = createdForm()
+        fillAddress(form)
+
+        const ok = await form.submitAddresses(vi.fn())
+
+        expect(ok).toBe(true)
+        const [url, body, opts] = mockPost.mock.calls[0] ?? []
+        expect(url).toBe('/carriers/7/addresses')
+        expect(body).toEqual({
+            country: 'France',
+            postalCode: '86100',
+            city: 'Châtellerault',
+            street: '1 rue du Test',
+            streetComplement: null,
+        })
+        expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
+        expect(form.addresses.value[0]?.id).toBe(88)
+        expect(form.isValidated('addresses')).toBe(true)
+    })
+
+    it('submitAddresses : PATCH des adresses existantes sur /carrier_addresses/{id}', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillAddress(form)
+        const first = form.addresses.value[0]
+        if (first) first.id = 88
+
+        await form.submitAddresses(vi.fn())
+
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith('/carrier_addresses/88', expect.objectContaining({ city: 'Châtellerault' }), { toast: false })
+    })
+
+    it('submitAddresses : mappe les 422 PAR LIGNE et ne finalise pas l\'onglet (RG-4.05)', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'city', message: 'La ville est obligatoire pour un transporteur affrété.' }] },
+            },
+        })
+        const form = createdForm()
+        fillAddress(form)
+
+        const ok = await form.submitAddresses(vi.fn())
+
+        expect(ok).toBe(false)
+        expect(form.addressErrors.value[0]?.city).toBe('La ville est obligatoire pour un transporteur affrété.')
+        expect(form.isValidated('addresses')).toBe(false)
+    })
+
+    it('removeAddress : DELETE /carrier_addresses/{id} puis retrait du bloc', async () => {
+        mockDelete.mockResolvedValueOnce({})
+        const form = createdForm()
+        fillAddress(form)
+        const first = form.addresses.value[0]
+        if (first) first.id = 88
+        form.addAddress()
+        fillAddress(form, 1)
+
+        await form.removeAddress(0)
+
+        expect(mockDelete).toHaveBeenCalledWith('/carrier_addresses/88', {}, { toast: false })
+        expect(form.addresses.value).toHaveLength(1)
+    })
+})
+
+describe('carrierContact (util) — validité alignée M1/M2/M3 + max 2 téléphones', () => {
+    it('isCarrierContactBlank : vrai si vide, faux dès un champ comptant rempli (phoneSecondary exclu)', () => {
+        expect(isCarrierContactBlank(emptyCarrierContact())).toBe(true)
+        expect(isCarrierContactBlank({ ...emptyCarrierContact(), jobTitle: 'Acheteur' })).toBe(false)
+        expect(isCarrierContactBlank({ ...emptyCarrierContact(), phonePrimary: '0102030405' })).toBe(false)
+        // phoneSecondary seul ne compte pas (aligné M1/M2/M3).
+        expect(isCarrierContactBlank({ ...emptyCarrierContact(), phoneSecondary: '0605040302', hasSecondaryPhone: true })).toBe(true)
+    })
+
+    it('isCarrierContactNamed : nommé seulement avec un prénom OU un nom', () => {
+        expect(isCarrierContactNamed(emptyCarrierContact())).toBe(false)
+        expect(isCarrierContactNamed({ ...emptyCarrierContact(), firstName: 'Jean' })).toBe(true)
+        expect(isCarrierContactNamed({ ...emptyCarrierContact(), lastName: 'Doe' })).toBe(true)
+        // Fonction / téléphone / email seuls ne « nomment » pas (≠ RG-4.08 large).
+        expect(isCarrierContactNamed({ ...emptyCarrierContact(), jobTitle: 'Acheteur' })).toBe(false)
+        expect(isCarrierContactNamed({ ...emptyCarrierContact(), email: 'a@b.fr' })).toBe(false)
+    })
+
+    it('buildCarrierContactPayload : phones = 1 numéro sans secondaire', () => {
+        const body = buildCarrierContactPayload({ ...emptyCarrierContact(), phonePrimary: '0102030405' })
+        expect(body.phones).toEqual(['0102030405'])
+    })
+
+    it('buildCarrierContactPayload : phones = 2 numéros si secondaire révélé', () => {
+        const body = buildCarrierContactPayload({
+            ...emptyCarrierContact(),
+            phonePrimary: '0102030405',
+            phoneSecondary: '0605040302',
+            hasSecondaryPhone: true,
+        })
+        expect(body.phones).toEqual(['0102030405', '0605040302'])
+    })
+
+    it('buildCarrierContactPayload : 2e numéro ignoré tant que non révélé', () => {
+        const body = buildCarrierContactPayload({
+            ...emptyCarrierContact(),
+            phonePrimary: '0102030405',
+            phoneSecondary: '0605040302',
+            hasSecondaryPhone: false,
+        })
+        expect(body.phones).toEqual(['0102030405'])
+    })
+})
+
+describe('useCarrierForm — onglet Contacts (ERP-168)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+        mockDelete.mockReset()
+    })
+
+    /** Transporteur créé, onglet Contacts accessible. */
+    function createdForm() {
+        const form = useCarrierForm()
+        form.carrierId.value = 7
+        return form
+    }
+
+    it('« + Nouveau contact » désactivé tant que le bloc n\'est pas nommé (prénom OU nom, aligné M1/M2/M3)', () => {
+        const form = createdForm()
+        expect(form.canAddContact.value).toBe(false)
+
+        // addContact est un no-op tant que le bloc n'est pas nommé.
+        form.addContact()
+        expect(form.contacts.value).toHaveLength(1)
+
+        // Fonction seule ne suffit PAS à ajouter un nouveau bloc (≠ RG-4.08 large).
+        const first = form.contacts.value[0]
+        if (first) first.jobTitle = 'Acheteur'
+        expect(form.canAddContact.value).toBe(false)
+        form.addContact()
+        expect(form.contacts.value).toHaveLength(1)
+
+        // Un nom (ou prénom) débloque l'ajout.
+        if (first) first.lastName = 'Doe'
+        expect(form.canAddContact.value).toBe(true)
+        form.addContact()
+        expect(form.contacts.value).toHaveLength(2)
+    })
+
+    it('submitContacts : POST des nouveaux contacts (phones tableau), capture id, finalise', async () => {
+        mockPost.mockResolvedValueOnce({ id: 55 })
+        const form = createdForm()
+        const c = form.contacts.value[0]
+        if (c) { c.firstName = 'Jean'; c.phonePrimary = '0102030405' }
+
+        const ok = await form.submitContacts(vi.fn())
+
+        expect(ok).toBe(true)
+        const [url, body, opts] = mockPost.mock.calls[0] ?? []
+        expect(url).toBe('/carriers/7/contacts')
+        expect(body).toMatchObject({ firstName: 'Jean', phones: ['0102030405'] })
+        expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
+        expect(form.contacts.value[0]?.id).toBe(55)
+        expect(form.isValidated('contacts')).toBe(true)
+    })
+
+    it('submitContacts : PATCH des contacts existants sur /carrier_contacts/{id}', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = createdForm()
+        const c = form.contacts.value[0]
+        if (c) { c.id = 55; c.lastName = 'Doe' }
+
+        await form.submitContacts(vi.fn())
+
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith('/carrier_contacts/55', expect.objectContaining({ lastName: 'Doe' }), { toast: false })
+    })
+
+    it('RG-4.08 : onglet vide → soumet l\'amorce pour déclencher la 422 inline', async () => {
+        mockPost.mockRejectedValueOnce({
+            response: {
+                status: 422,
+                _data: { violations: [{ propertyPath: 'firstName', message: 'Au moins un champ du contact est obligatoire.' }] },
+            },
+        })
+        const form = createdForm()
+
+        const ok = await form.submitContacts(vi.fn())
+
+        expect(ok).toBe(false)
+        expect(mockPost).toHaveBeenCalledTimes(1)
+        expect(form.contactErrors.value[0]?.firstName).toBe('Au moins un champ du contact est obligatoire.')
+        expect(form.isValidated('contacts')).toBe(false)
+    })
+
+    it('removeContact : DELETE /carrier_contacts/{id} puis retrait du bloc', async () => {
+        mockDelete.mockResolvedValueOnce({})
+        const form = createdForm()
+        const c = form.contacts.value[0]
+        if (c) { c.id = 90; c.lastName = 'Doe' }
+        form.addContact()
+        const c2 = form.contacts.value[1]
+        if (c2) c2.firstName = 'Jean'
+
+        await form.removeContact(0)
+
+        expect(mockDelete).toHaveBeenCalledWith('/carrier_contacts/90', {}, { toast: false })
+        expect(form.contacts.value).toHaveLength(1)
+    })
 })

frontend/modules/transport/composables/useCarrierForm.ts

@@ -1,12 +1,20 @@
-import { computed, reactive, ref } from 'vue'
+import { computed, reactive, ref, type Ref } from 'vue'
 import { useFormErrors } from '~/shared/composables/useFormErrors'
+import { extractApiErrorMessage, mapViolationsToRecord } from '~/shared/utils/api'
+import { removeCollectionRow } from '~/shared/utils/collectionRow'
 import {
+    emptyCarrierAddress,
     emptyCarrierAddressCopy,
+    emptyCarrierContact,
     emptyCarrierMain,
     type CarrierAddressCopy,
+    type CarrierAddressFormDraft,
+    type CarrierContactFormDraft,
     type CarrierMainDraft,
     type CarrierMainResponse,
 } from '~/modules/transport/types/carrierForm'
+import { buildCarrierAddressPayload, isCarrierAddressValid } from '~/modules/transport/utils/forms/carrierAddress'
+import { buildCarrierContactPayload, isCarrierContactBlank, isCarrierContactNamed } from '~/modules/transport/utils/forms/carrierContact'
 import type { QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
 
 /** Nom du cas spécial « compte-propre » LIOT (comparaison insensible à la casse, RG-4.01). */
@@ -52,6 +60,7 @@ export function useCarrierForm() {
     const carrierId = ref<number | null>(null)
     const mainLocked = ref(false)
     const mainSubmitting = ref(false)
+    const tabSubmitting = ref(false)
 
     // ── Formulaire principal ──────────────────────────────────────────────────
     const main = reactive<CarrierMainDraft>(emptyCarrierMain())
@@ -255,6 +264,207 @@ export function useCarrierForm() {
         await api.patch(`/carriers/${carrierId.value}`, payload, { toast: false })
     }
 
+    /** Remontée d'erreur de suppression immédiate d'une sous-ressource (toast dédié). */
+    function notifyRemovalError(error: unknown): void {
+        toast.error({
+            title: t('transport.carriers.toast.error'),
+            message: extractApiErrorMessage((error as { data?: unknown })?.data) || t('transport.carriers.toast.error'),
+        })
+    }
+
+    /**
+     * Soumet TOUS les blocs d'une collection en collectant les erreurs PAR INDEX :
+     * on n'arrête pas au premier bloc en échec (décision ERP-101). Réinitialise la
+     * cible, tente chaque ligne via `saveRow`, mappe les 422 inline ou délègue le
+     * fallback à `onUnmappedError`. `shouldSkip` ignore les amorces vides. Retourne
+     * true si au moins un bloc a échoué. Miroir de `useProviderForm.submitRows`.
+     */
+    async function submitRows<T>(
+        rows: T[],
+        target: Ref<Record<string, string>[]>,
+        saveRow: (row: T, index: number) => Promise<void>,
+        onUnmappedError: (error: unknown, index: number) => void,
+        shouldSkip?: (row: T, index: number) => boolean,
+    ): Promise<boolean> {
+        target.value = []
+        let hasError = false
+        for (let index = 0; index < rows.length; index++) {
+            const row = rows[index] as T
+            if (shouldSkip?.(row, index)) {
+                continue
+            }
+            try {
+                await saveRow(row, index)
+            }
+            catch (error) {
+                const response = (error as { response?: { status?: number, _data?: unknown } })?.response
+                const mapped = response?.status === 422 ? mapViolationsToRecord(response._data) : {}
+                if (Object.keys(mapped).length > 0) {
+                    target.value[index] = mapped
+                }
+                else {
+                    onUnmappedError(error, index)
+                }
+                hasError = true
+            }
+        }
+        return hasError
+    }
+
+    // ── Onglet Adresses (ERP-167) ─────────────────────────────────────────────
+    const addresses = ref<CarrierAddressFormDraft[]>([emptyCarrierAddress()])
+    // Erreurs 422 par ligne (alignées sur l'index du v-for), peuplées par submitRows.
+    const addressErrors = ref<Record<string, string>[]>([])
+
+    // « + Nouvelle adresse » désactivé tant que la dernière adresse n'est pas
+    // complète (CP + ville + rue — RG-4.05, gate d'ajout).
+    const canAddAddress = computed(() => {
+        const last = addresses.value[addresses.value.length - 1]
+        return last !== undefined && isCarrierAddressValid(last)
+    })
+
+    function addAddress(): void {
+        if (canAddAddress.value) {
+            addresses.value.push(emptyCarrierAddress())
+        }
+    }
+
+    /** Suppression immédiate d'une adresse existante (DELETE /carrier_addresses/{id}). */
+    async function removeAddress(index: number): Promise<void> {
+        await removeCollectionRow({
+            rows: addresses.value,
+            errors: addressErrors.value,
+            index,
+            endpoint: '/carrier_addresses',
+            deleteRow: url => api.delete(url, {}, { toast: false }),
+            makeEmpty: emptyCarrierAddress,
+            onError: notifyRemovalError,
+        })
+    }
+
+    /**
+     * Valide l'onglet Adresses : POST des nouvelles adresses sur
+     * /carriers/{id}/addresses, PATCH des existantes sur /carrier_addresses/{id}
+     * (groupe carrier:write:addresses). Erreurs 422 collectées par ligne (RG-4.05
+     * « obligatoire si affrété » re-validée back). Retourne true si l'onglet a été
+     * validé (avancé/terminé).
+     */
+    async function submitAddresses(onError: (error: unknown) => void): Promise<boolean> {
+        if (carrierId.value === null || tabSubmitting.value) {
+            return false
+        }
+        tabSubmitting.value = true
+        try {
+            const hasError = await submitRows(
+                addresses.value,
+                addressErrors,
+                async (address) => {
+                    const body = buildCarrierAddressPayload(address)
+                    if (address.id === null) {
+                        const created = await api.post<{ id: number }>(
+                            `/carriers/${carrierId.value}/addresses`,
+                            body,
+                            { headers: { Accept: 'application/ld+json' }, toast: false },
+                        )
+                        address.id = created.id
+                    }
+                    else {
+                        await api.patch(`/carrier_addresses/${address.id}`, body, { toast: false })
+                    }
+                },
+                onError,
+            )
+            if (hasError) {
+                return false
+            }
+            completeTab('addresses')
+            return true
+        }
+        finally {
+            tabSubmitting.value = false
+        }
+    }
+
+    // ── Onglet Contacts (ERP-168) ─────────────────────────────────────────────
+    const contacts = ref<CarrierContactFormDraft[]>([emptyCarrierContact()])
+    // Erreurs 422 par ligne (alignées sur l'index du v-for), peuplées par submitRows.
+    const contactErrors = ref<Record<string, string>[]>([])
+
+    // « + Nouveau contact » désactivé tant que le DERNIER bloc n'est pas « nommé »
+    // (prénom OU nom) — aligné sur M1/M2/M3 (fonction / téléphone / email seuls ne
+    // suffisent pas à ajouter un nouveau bloc).
+    const canAddContact = computed(() => {
+        const last = contacts.value[contacts.value.length - 1]
+        return last !== undefined && isCarrierContactNamed(last)
+    })
+
+    function addContact(): void {
+        if (canAddContact.value) {
+            contacts.value.push(emptyCarrierContact())
+        }
+    }
+
+    /** Suppression immédiate d'un contact existant (DELETE /carrier_contacts/{id}). */
+    async function removeContact(index: number): Promise<void> {
+        await removeCollectionRow({
+            rows: contacts.value,
+            errors: contactErrors.value,
+            index,
+            endpoint: '/carrier_contacts',
+            deleteRow: url => api.delete(url, {}, { toast: false }),
+            makeEmpty: emptyCarrierContact,
+            onError: notifyRemovalError,
+        })
+    }
+
+    /**
+     * Valide l'onglet Contacts : POST des nouveaux contacts sur
+     * /carriers/{id}/contacts, PATCH des existants sur /carrier_contacts/{id}
+     * (groupe carrier:write:contacts). RG-4.08 (≥ 1 champ rempli, max 2 téléphones)
+     * re-validée back → 422 par ligne. Si l'onglet ne contient QUE des amorces
+     * vides, on soumet la 1re pour déclencher la 422 RG-4.08 inline plutôt que de
+     * finaliser un onglet vide. Retourne true si l'onglet a été validé.
+     */
+    async function submitContacts(onError: (error: unknown) => void): Promise<boolean> {
+        if (carrierId.value === null || tabSubmitting.value) {
+            return false
+        }
+        tabSubmitting.value = true
+        try {
+            const hasSubmittable = contacts.value.some(c => c.id !== null || !isCarrierContactBlank(c))
+            const hasError = await submitRows(
+                contacts.value,
+                contactErrors,
+                async (contact) => {
+                    const body = buildCarrierContactPayload(contact)
+                    if (contact.id === null) {
+                        const created = await api.post<{ id: number }>(
+                            `/carriers/${carrierId.value}/contacts`,
+                            body,
+                            { headers: { Accept: 'application/ld+json' }, toast: false },
+                        )
+                        contact.id = created.id
+                    }
+                    else {
+                        await api.patch(`/carrier_contacts/${contact.id}`, body, { toast: false })
+                    }
+                },
+                onError,
+                // Amorce vide neuve ignorée s'il reste un autre bloc soumettable ;
+                // sinon on la soumet pour déclencher la 422 RG-4.08 (sur firstName).
+                contact => hasSubmittable && contact.id === null && isCarrierContactBlank(contact),
+            )
+            if (hasError) {
+                return false
+            }
+            completeTab('contacts')
+            return true
+        }
+        finally {
+            tabSubmitting.value = false
+        }
+    }
+
     /**
      * Intègre une ligne QUALIMAT sélectionnée dans l'onglet Qualimat (RG-4.01 /
      * § 2.5) : copie le nom, force la certification à « QUALIMAT » (lecture seule),
@@ -290,6 +500,16 @@ export function useCarrierForm() {
             city: row.city ?? '',
             street: row.address ?? '',
         }
+        // RG-4.05 : pré-remplit le 1er bloc de l'onglet Adresses par copie (la FK
+        // QUALIMAT survit, les champs restent éditables — § 2.5).
+        addresses.value = [{
+            id: null,
+            country: 'France',
+            postalCode: row.postalCode || null,
+            city: row.city || null,
+            street: row.address || null,
+            streetComplement: null,
+        }]
         return true
     }
 
@@ -321,6 +541,7 @@ export function useCarrierForm() {
         carrierId,
         mainLocked,
         mainSubmitting,
+        tabSubmitting,
         mainErrors,
         // affichage conditionnel
         isLiot,
@@ -336,6 +557,20 @@ export function useCarrierForm() {
         validated,
         editMode,
         isValidated,
+        // adresses
+        addresses,
+        addressErrors,
+        canAddAddress,
+        addAddress,
+        removeAddress,
+        submitAddresses,
+        // contacts
+        contacts,
+        contactErrors,
+        canAddContact,
+        addContact,
+        removeContact,
+        submitContacts,
         // actions
         validateMainFront,
         buildMainPayload,
@@ -343,5 +578,6 @@ export function useCarrierForm() {
         patchCarrier,
         applyQualimatSelection,
         completeTab,
+        submitRows,
     }
 }

frontend/modules/transport/pages/carriers/new.vue

@@ -170,7 +170,77 @@
                 </div>
             </template>
 
-            <!-- Adresses / Contacts / Prix : contenu aux tickets suivants. -->
+            <!-- Onglet Adresses (ERP-167) : un bloc par adresse + BAN. RG-4.05
+                 préremplissage si QUALIMAT ; RG-4.07 pas de Valider si QUALIMAT. -->
+            <template #addresses>
+                <div class="mt-12 flex flex-col gap-6">
+                    <CarrierAddressBlock
+                        v-for="(address, index) in addresses"
+                        :key="index"
+                        :model-value="address"
+                        :country-options="countryOptions"
+                        :removable="isRowRemovable(addresses, index)"
+                        :readonly="isQualimat || isValidated('addresses')"
+                        :errors="addressErrors[index]"
+                        @update:model-value="(v) => addresses[index] = v"
+                        @remove="askRemoveAddress(index)"
+                        @degraded="onAddressDegraded"
+                    />
+                    <!-- RG-4.07 : pas de bouton Valider pour un transporteur QUALIMAT
+                         (adresse copiée et persistée automatiquement). -->
+                    <div v-if="!isQualimat && !isValidated('addresses')" class="flex justify-center gap-6">
+                        <MalioButton
+                            variant="secondary"
+                            icon-name="mdi:add-bold"
+                            icon-position="left"
+                            :label="t('transport.carriers.form.address.add')"
+                            :disabled="!canAddAddress"
+                            @click="addAddress"
+                        />
+                        <MalioButton
+                            variant="primary"
+                            :label="t('transport.carriers.form.submit')"
+                            :disabled="tabSubmitting || carrierId === null"
+                            @click="onSubmitAddresses"
+                        />
+                    </div>
+                </div>
+            </template>
+
+            <!-- Onglet Contacts (ERP-168) : un bloc par contact (RG-4.08 ≥ 1 champ,
+                 max 2 téléphones). Erreurs 422 par ligne. -->
+            <template #contacts>
+                <div class="mt-12 flex flex-col gap-6">
+                    <CarrierContactBlock
+                        v-for="(contact, index) in contacts"
+                        :key="index"
+                        :model-value="contact"
+                        :removable="isRowRemovable(contacts, index)"
+                        :readonly="isValidated('contacts')"
+                        :errors="contactErrors[index]"
+                        @update:model-value="(v) => contacts[index] = v"
+                        @remove="askRemoveContact(index)"
+                    />
+                    <div v-if="!isValidated('contacts')" class="flex justify-center gap-6">
+                        <MalioButton
+                            variant="secondary"
+                            icon-name="mdi:add-bold"
+                            icon-position="left"
+                            :label="t('transport.carriers.form.contact.add')"
+                            :disabled="!canAddContact"
+                            @click="addContact"
+                        />
+                        <MalioButton
+                            variant="primary"
+                            :label="t('transport.carriers.form.submit')"
+                            :disabled="tabSubmitting || carrierId === null"
+                            @click="onSubmitContacts"
+                        />
+                    </div>
+                </div>
+            </template>
+
+            <!-- Prix : contenu au ticket suivant. -->
             <template
                 v-for="key in placeholderTabs"
                 :key="key"
@@ -203,12 +273,38 @@
                 />
             </template>
         </MalioModal>
+
+        <!-- Modal de confirmation de suppression (bloc adresse). -->
+        <MalioModal v-model="deleteConfirm.open" modal-class="max-w-md">
+            <template #header>
+                <h2 class="text-[24px] font-bold">{{ t('transport.carriers.form.confirmDelete.title') }}</h2>
+            </template>
+            <p>{{ t('transport.carriers.form.confirmDelete.message') }}</p>
+            <template #footer>
+                <MalioButton
+                    variant="secondary"
+                    button-class="flex-1"
+                    :label="t('transport.carriers.form.confirmDelete.cancel')"
+                    @click="deleteConfirm.open = false"
+                />
+                <MalioButton
+                    variant="danger"
+                    button-class="flex-1"
+                    :label="t('transport.carriers.form.confirmDelete.confirm')"
+                    @click="runDeleteConfirm"
+                />
+            </template>
+        </MalioModal>
     </div>
 </template>
 
 <script setup lang="ts">
-import { computed, ref, watch } from 'vue'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
 import { debounce } from '~/shared/utils/debounce'
+import { extractApiErrorMessage } from '~/shared/utils/api'
+import { isRowRemovable } from '~/shared/utils/collectionRow'
+import CarrierAddressBlock from '~/modules/transport/components/CarrierAddressBlock.vue'
+import CarrierContactBlock from '~/modules/transport/components/CarrierContactBlock.vue'
 import { useCarrierForm } from '~/modules/transport/composables/useCarrierForm'
 import { useQualimatSearch, type QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
 
@@ -218,6 +314,7 @@ interface SelectOption {
 }
 
 const { t } = useI18n()
+const api = useApi()
 const router = useRouter()
 const toast = useToast()
 const { can } = usePermissions()
@@ -232,16 +329,32 @@ if (!can('transport.carriers.manage')) {
 
 const {
     main,
+    carrierId,
     mainLocked,
     mainSubmitting,
+    tabSubmitting,
     mainErrors,
     isLiot,
+    isQualimat,
     certificationReadonly,
     showCharteredFields,
     showDischarge,
     tabKeys,
     activeTab,
     unlockedIndex,
+    isValidated,
+    addresses,
+    addressErrors,
+    canAddAddress,
+    addAddress,
+    removeAddress,
+    submitAddresses,
+    contacts,
+    contactErrors,
+    canAddContact,
+    addContact,
+    removeContact,
+    submitContacts,
     submitMain,
     applyQualimatSelection,
 } = useCarrierForm()
@@ -335,8 +448,98 @@ const tabs = computed(() => tabKeys.value.map((key, index) => ({
     disabled: index > unlockedIndex.value,
 })))
 
-// Onglets dont le contenu arrive aux tickets suivants (tout sauf Qualimat).
-const placeholderTabs = computed(() => tabKeys.value.filter(key => key !== 'qualimat'))
+// Onglets dont le contenu arrive aux tickets suivants (Prix).
+const placeholderTabs = computed(() => tabKeys.value.filter(
+    key => key !== 'qualimat' && key !== 'addresses' && key !== 'contacts',
+))
+
+// ── Onglet Adresses (ERP-167) ────────────────────────────────────────────────
+// Pays : France garantie en tete meme si /countries echoue (resilience), pour
+// rester preselectionnable par defaut sur chaque adresse (RG-4.05).
+const countryOptions = ref<SelectOption[]>([{ value: 'France', label: 'France' }])
+
+/** Charge le referentiel pays (/api/countries) ; conserve France par defaut si echec. */
+async function loadCountries(): Promise<void> {
+    try {
+        const data = await api.get<{ member?: { name: string }[] }>(
+            '/countries',
+            { pagination: 'false' },
+            { headers: { Accept: 'application/ld+json' }, toast: false },
+        )
+        const list = (data.member ?? []).map(c => ({ value: c.name, label: c.name }))
+        countryOptions.value = list.some(c => c.value === 'France')
+            ? list
+            : [{ value: 'France', label: 'France' }, ...list]
+    }
+    catch {
+        // Reste sur le fallback France (non bloquant).
+    }
+}
+
+onMounted(() => {
+    loadCountries().catch(() => {})
+})
+
+// Avertissement unique quand l'autocompletion d'adresse bascule en degrade.
+const addressDegradedNotified = ref(false)
+
+function onAddressDegraded(): void {
+    if (addressDegradedNotified.value) {
+        return
+    }
+    addressDegradedNotified.value = true
+    toast.warning({
+        title: t('transport.carriers.toast.error'),
+        message: t('transport.carriers.form.address.degraded'),
+    })
+}
+
+/** Message d'erreur affichable (toast) extrait d'une erreur API — jamais undefined. */
+function apiErrorMessage(error: unknown): string {
+    const data = (error as { response?: { _data?: unknown } })?.response?._data
+    return extractApiErrorMessage(data) || t('transport.carriers.toast.error')
+}
+
+/** Valide l'onglet Adresses (POST/PATCH par ligne ; avance gere par le composable). */
+async function onSubmitAddresses(): Promise<void> {
+    const ok = await submitAddresses(error => toast.error({
+        title: t('transport.carriers.toast.error'),
+        message: apiErrorMessage(error),
+    }))
+    if (ok) {
+        toast.success({ title: t('transport.carriers.toast.addressSaved') })
+    }
+}
+
+// Modal de confirmation de suppression (générique : bloc adresse OU contact).
+const deleteConfirm = reactive({ open: false, action: null as null | (() => void) })
+
+function askRemoveAddress(index: number): void {
+    deleteConfirm.action = () => { void removeAddress(index) }
+    deleteConfirm.open = true
+}
+
+/** Valide l'onglet Contacts (POST/PATCH par ligne ; avance gérée par le composable). */
+async function onSubmitContacts(): Promise<void> {
+    const ok = await submitContacts(error => toast.error({
+        title: t('transport.carriers.toast.error'),
+        message: apiErrorMessage(error),
+    }))
+    if (ok) {
+        toast.success({ title: t('transport.carriers.toast.contactSaved') })
+    }
+}
+
+function askRemoveContact(index: number): void {
+    deleteConfirm.action = () => { void removeContact(index) }
+    deleteConfirm.open = true
+}
+
+function runDeleteConfirm(): void {
+    deleteConfirm.action?.()
+    deleteConfirm.action = null
+    deleteConfirm.open = false
+}
 
 // ── Saisie assistee QUALIMAT (onglet Qualimat) ───────────────────────────────
 const confirmOpen = ref(false)
@@ -417,8 +620,18 @@ function goBack(): void {
     router.push('/carriers')
 }
 
-/** Valide le formulaire principal (POST /carriers ; bascule geree par le composable). */
+/**
+ * Valide le formulaire principal (POST /carriers ; bascule geree par le composable).
+ * RG-4.07 : pour un transporteur QUALIMAT, l'adresse copiee est persistee
+ * automatiquement (pas de bouton Valider dans l'onglet Adresses).
+ */
 async function onSubmitMain(): Promise<void> {
-    await submitMain()
+    const ok = await submitMain()
+    if (ok && isQualimat.value) {
+        await submitAddresses(error => toast.error({
+            title: t('transport.carriers.toast.error'),
+            message: apiErrorMessage(error),
+        }))
+    }
 }
 </script>

frontend/modules/transport/types/carrierForm.ts

@@ -65,6 +65,70 @@ export function emptyCarrierAddressCopy(): CarrierAddressCopy {
     return { country: 'France', postalCode: '', city: '', street: '' }
 }
 
+/**
+ * Brouillon d'un bloc Adresse (onglet Adresses, ERP-167) — sous-ressource
+ * `CarrierAddress` (groupe `carrier:write:addresses`). Version SIMPLIFIÉE de
+ * l'adresse fournisseur (M2) / prestataire (M3) : pas de sites / catégories /
+ * contacts ni type d'adresse (les sites du M4 vivent dans l'onglet Prix).
+ */
+export interface CarrierAddressFormDraft {
+    /** Id serveur une fois l'adresse créée (null tant que non persistée). */
+    id: number | null
+    /** Pays (chaîne libre, défaut « France »). */
+    country: string
+    postalCode: string | null
+    city: string | null
+    street: string | null
+    streetComplement: string | null
+}
+
+/** Brouillon d'adresse vide (pays France par défaut, RG-4.05). */
+export function emptyCarrierAddress(): CarrierAddressFormDraft {
+    return {
+        id: null,
+        country: 'France',
+        postalCode: null,
+        city: null,
+        street: null,
+        streetComplement: null,
+    }
+}
+
+/**
+ * Brouillon d'un bloc Contact (onglet Contacts, ERP-168) — sous-ressource
+ * `CarrierContact` (groupe `carrier:write:contacts`). Les téléphones sont saisis
+ * en `phonePrimary` / `phoneSecondary` côté UI, puis envoyés au back sous forme du
+ * tableau `phones` (max 2 — RG-4.08). `hasSecondaryPhone` pilote l'affichage du 2e
+ * numéro (révélé via le bouton « + »). Pas d'`iri` : aucune relation M2M depuis
+ * l'adresse au M4 (≠ M3).
+ */
+export interface CarrierContactFormDraft {
+    /** Id serveur une fois le contact créé (null tant que non persisté). */
+    id: number | null
+    firstName: string | null
+    lastName: string | null
+    jobTitle: string | null
+    phonePrimary: string | null
+    phoneSecondary: string | null
+    email: string | null
+    /** UI : le 2e numéro a été révélé via le bouton « + » (max 2 téléphones). */
+    hasSecondaryPhone: boolean
+}
+
+/** Brouillon de contact vide (état initial d'un bloc Contact). */
+export function emptyCarrierContact(): CarrierContactFormDraft {
+    return {
+        id: null,
+        firstName: null,
+        lastName: null,
+        jobTitle: null,
+        phonePrimary: null,
+        phoneSecondary: null,
+        email: null,
+        hasSecondaryPhone: false,
+    }
+}
+
 /**
  * Réponse du POST / PATCH principal (groupe `carrier:read`). Le serveur renvoie
  * le nom normalisé (UPPERCASE, RG-4.13) que l'UI réaffiche tel quel.

frontend/modules/transport/utils/forms/carrierAddress.ts

@@ -0,0 +1,35 @@
+/**
+ * Helpers purs de l'onglet Adresse transporteur (M4 Transport, ERP-167) — miroir
+ * SIMPLIFIÉ de `providerAddress` (M3) / `SupplierAddressBlock` (M2), sans sites /
+ * catégories / contacts (les sites du M4 vivent dans l'onglet Prix). Testables
+ * sans Vue.
+ */
+
+import type { CarrierAddressFormDraft } from '~/modules/transport/types/carrierForm'
+
+/**
+ * RG-4.05 : gate du bouton « + Nouvelle adresse ». Une adresse est « complète »
+ * (donc on autorise l'ajout d'un nouveau bloc) dès qu'elle porte un code postal,
+ * une ville ET une rue. Les RG conditionnelles (obligatoire si affrété) restent
+ * validées par le back (422 inline) — ce gate empêche seulement d'empiler des
+ * blocs vides.
+ */
+export function isCarrierAddressValid(address: CarrierAddressFormDraft): boolean {
+    return Boolean(address.postalCode?.trim() && address.city?.trim() && address.street?.trim())
+}
+
+/**
+ * Payload de la sous-ressource addresses (groupe `carrier:write:addresses`). Les
+ * scalaires sont nullable côté entité : on envoie `null` quand le champ est vide
+ * (le `CarrierAddressProcessor` re-valide la présence si affrété — RG-4.05 — et
+ * renvoie une 422 par champ).
+ */
+export function buildCarrierAddressPayload(address: CarrierAddressFormDraft): Record<string, unknown> {
+    return {
+        country: address.country,
+        postalCode: address.postalCode || null,
+        city: address.city || null,
+        street: address.street || null,
+        streetComplement: address.streetComplement || null,
+    }
+}

frontend/modules/transport/utils/forms/carrierContact.ts

@@ -0,0 +1,61 @@
+/**
+ * Helpers purs de l'onglet Contact transporteur (M4 Transport, ERP-168) — ALIGNÉ
+ * sur `providerContact.ts` (M3) / les autres modules : mêmes règles de validité et
+ * de gating « + Nouveau contact » (un contact est « nommé » dès qu'il porte un
+ * prénom OU un nom). Seule spécificité M4 conservée : les téléphones partent au back
+ * dans le tableau virtuel `phones` (max 2), mappés par le CarrierContactProcessor.
+ * Testables sans Vue ni API.
+ */
+
+import type { CarrierContactFormDraft } from '~/modules/transport/types/carrierForm'
+
+/** Vrai si une chaîne porte au moins un caractère non-espace. */
+function isFilled(value: string | null | undefined): boolean {
+    return value !== null && value !== undefined && value.trim() !== ''
+}
+
+/**
+ * Un bloc Contact est VIDE tant qu'aucun champ comptant pour la validité n'est
+ * rempli — prénom / nom / fonction / téléphone principal / email. `phoneSecondary`
+ * est EXCLU (aligné M1/M2/M3 : un bloc ne portant qu'un 2e numéro reste vide). Sert
+ * le filtrage des amorces vides à la soumission.
+ */
+export function isCarrierContactBlank(contact: CarrierContactFormDraft): boolean {
+    return ![
+        contact.firstName,
+        contact.lastName,
+        contact.jobTitle,
+        contact.phonePrimary,
+        contact.email,
+    ].some(isFilled)
+}
+
+/**
+ * Un contact est « nommé » (valide) dès qu'il porte un prénom OU un nom — aligné
+ * sur M1/M2/M3. Pilote le gating « + Nouveau contact » : la fonction / le téléphone
+ * / l'email seuls ne suffisent pas pour ajouter un nouveau bloc.
+ */
+export function isCarrierContactNamed(contact: CarrierContactFormDraft): boolean {
+    return isFilled(contact.firstName) || isFilled(contact.lastName)
+}
+
+/**
+ * Payload de la sous-ressource contacts (groupe `carrier:write:contacts`). Les
+ * chaînes vides partent à null (le serveur normalise/trim). Les téléphones sont
+ * regroupés dans le tableau `phones` (numéros non vides, max 2 — RG-4.08) ; le 2e
+ * numéro n'est inclus que s'il a été révélé (`hasSecondaryPhone`).
+ */
+export function buildCarrierContactPayload(contact: CarrierContactFormDraft): Record<string, unknown> {
+    const phones = [
+        contact.phonePrimary,
+        contact.hasSecondaryPhone ? contact.phoneSecondary : null,
+    ].filter((phone): phone is string => isFilled(phone))
+
+    return {
+        firstName: contact.firstName || null,
+        lastName: contact.lastName || null,
+        jobTitle: contact.jobTitle || null,
+        email: contact.email || null,
+        phones,
+    }
+}

migrations/Version20260617120000.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * RG-4.08 (correctif) — aligne la regle de validite d'un contact transporteur sur
+ * le M1/M2/M3 : au moins le PRENOM OU le NOM (et non plus « un champ quelconque
+ * parmi prenom/nom/fonction/telephone/email »). Remplace le CHECK
+ * chk_carrier_contact_filled par chk_carrier_contact_name et met a jour les
+ * commentaires de colonnes. La garde applicative (CarrierContactProcessor::validateName)
+ * est alignee dans le meme commit ; le catalogue ColumnCommentsCatalog aussi.
+ *
+ * Placee au namespace racine DoctrineMigrations (et non en modulaire Transport) :
+ * elle ALTERE une table creee par une migration racine (Version20260615150000) ;
+ * le tri par version au sein du meme namespace garantit qu'elle joue APRES l'init
+ * (cf. CLAUDE.md regle 11 — le tri cross-namespace casserait l'ordre sur base vide).
+ */
+final class Version20260617120000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'RG-4.08 : contact transporteur valide si prenom OU nom (alignement M1/M2/M3) — CHECK chk_carrier_contact_name.';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE carrier_contact DROP CONSTRAINT chk_carrier_contact_filled');
+        $this->addSql('ALTER TABLE carrier_contact ADD CONSTRAINT chk_carrier_contact_name CHECK (first_name IS NOT NULL OR last_name IS NOT NULL)');
+
+        $this->addSql('COMMENT ON TABLE carrier_contact IS $_$Contacts d un transporteur (1:n) — onglet Contact (M4). Au moins le prenom OU le nom rempli (RG-4.08, chk_carrier_contact_name), max 2 telephones.$_$');
+        $this->addSql('COMMENT ON COLUMN carrier_contact.first_name IS $_$Prenom du contact (capitalise serveur). Prenom OU nom obligatoire (RG-4.08, chk_carrier_contact_name).$_$');
+        $this->addSql('COMMENT ON COLUMN carrier_contact.last_name IS $_$Nom du contact (capitalise serveur). Prenom OU nom obligatoire (RG-4.08, chk_carrier_contact_name).$_$');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE carrier_contact DROP CONSTRAINT chk_carrier_contact_name');
+        $this->addSql('ALTER TABLE carrier_contact ADD CONSTRAINT chk_carrier_contact_filled CHECK (first_name IS NOT NULL OR last_name IS NOT NULL OR job_title IS NOT NULL OR phone_primary IS NOT NULL OR email IS NOT NULL)');
+
+        $this->addSql('COMMENT ON TABLE carrier_contact IS $_$Contacts d un transporteur (1:n) — onglet Contact (M4). Au moins un champ rempli (RG-4.08, chk_carrier_contact_filled), max 2 telephones.$_$');
+        $this->addSql('COMMENT ON COLUMN carrier_contact.first_name IS $_$Prenom du contact (capitalise serveur). Au moins un champ du contact est requis (RG-4.08).$_$');
+        $this->addSql('COMMENT ON COLUMN carrier_contact.last_name IS $_$Nom du contact (capitalise serveur). Au moins un champ du contact est requis (RG-4.08).$_$');
+    }
+}

src/Module/Transport/Domain/Entity/CarrierContact.php

@@ -21,8 +21,8 @@ use Symfony\Component\Validator\Constraints as Assert;
 
 /**
  * Contact d'un transporteur (1:n) — onglet Contact (M4). Jumeau de
- * SupplierContact (M2) : au moins un champ rempli (RG-4.08, garanti par le
- * CHECK chk_carrier_contact_filled + le Processor), max 2 telephones.
+ * SupplierContact (M2) : au moins le prenom OU le nom (RG-4.08, garanti par le
+ * CHECK chk_carrier_contact_name + le Processor), max 2 telephones.
  *
  * Lecture : proprietes en `carrier:item:read` (embarquees au detail du
  * transporteur). Ecriture : groupe `carrier:write:contacts`.

src/Module/Transport/Infrastructure/ApiPlatform/State/Processor/CarrierContactProcessor.php

@@ -23,21 +23,21 @@ use function is_string;
 /**
  * Processor d'ecriture de la sous-ressource Contact d'un transporteur (M4,
  * spec-back § 4.5). Jumeau du SupplierContactProcessor (M2), recentre sur le
- * perimetre ERP-160, AVEC deux specificites M4 : RG-4.08 (≥ 1 champ rempli, max
- * 2 telephones) portee a la fois par le CHECK BDD chk_carrier_contact_filled et
- * par ce Processor.
+ * perimetre ERP-160. RG-4.08 (correctif, alignement M1/M2/M3) : un contact exige
+ * au moins le PRENOM OU le NOM (la fonction / le telephone / l'email seuls ne
+ * suffisent pas), porte a la fois par le CHECK BDD chk_carrier_contact_name et par
+ * ce Processor ; le « max 2 telephones » reste une specificite M4.
  *
  * Sequence :
  *  - POST / PATCH : rattachement au transporteur parent (linkParent),
  *    normalisation serveur RG-4.13 (prenom/nom Title Case, email lowercase),
  *    mapping du tableau d'ecriture `phones` -> phonePrimary/phoneSecondary
- *    (max 2, chiffres uniquement), puis garde RG-4.08 (≥ 1 champ) avant
- *    persistance.
+ *    (max 2, chiffres uniquement), puis garde « prenom OU nom » avant persistance.
  *  - DELETE : aucune regle metier specifique (suppression physique directe).
  *
- * RG-4.08 vit ICI (double du CHECK BDD) pour transformer une violation SQL (500
- * generique) en 422 propre rattachee au champ `firstName` (mapping inline
- * ERP-101). Le « max 2 telephones » est rattache au champ `phones` : seul
+ * La garde « prenom OU nom » vit ICI (double du CHECK BDD) pour transformer une
+ * violation SQL (500 generique) en 422 propre rattachee au champ `firstName`
+ * (mapping inline ERP-101). Le « max 2 telephones » est rattache au champ `phones` : seul
  * point de saisie des numeros (les colonnes phonePrimary/phoneSecondary sont en
  * lecture seule).
  *
@@ -77,7 +77,7 @@ final class CarrierContactProcessor implements ProcessorInterface
         $this->linkParent($data, $uriVariables);
         $this->normalize($data);
         $this->applyPhones($data);
-        $this->validateAtLeastOneField($data);
+        $this->validateName($data);
 
         return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
     }
@@ -187,25 +187,18 @@ final class CarrierContactProcessor implements ProcessorInterface
     }
 
     /**
-     * RG-4.08 : un bloc Contact est valide des qu'au moins 1 champ est rempli
-     * (firstName, lastName, jobTitle, phonePrimary ou email — meme perimetre que
-     * le CHECK BDD chk_carrier_contact_filled, qui exclut phoneSecondary). Double
-     * garde : leve une 422 propre rattachee a `firstName` plutot qu'une 500 SQL.
-     * Joue apres normalisation + mapping telephones, donc les chaines vides sont
-     * deja ramenees a null.
+     * RG-4.08 (alignement M1/M2/M3) : un bloc Contact exige au moins le PRENOM OU le
+     * NOM — un contact se materialise par son nom ; fonction / telephone / email
+     * seuls ne suffisent pas. Double garde avec le CHECK BDD chk_carrier_contact_name
+     * — leve une 422 propre rattachee a `firstName` plutot qu'une 500 SQL. Joue apres
+     * normalisation + mapping telephones, donc les chaines vides sont deja null.
      */
-    private function validateAtLeastOneField(CarrierContact $contact): void
+    private function validateName(CarrierContact $contact): void
     {
-        if (
-            null === $contact->getFirstName()
-            && null === $contact->getLastName()
-            && null === $contact->getJobTitle()
-            && null === $contact->getPhonePrimary()
-            && null === $contact->getEmail()
-        ) {
+        if (null === $contact->getFirstName() && null === $contact->getLastName()) {
             $violations = new ConstraintViolationList();
             $violations->add(new ConstraintViolation(
-                'Renseignez au moins un champ pour le contact.',
+                'Le prénom ou le nom du contact est obligatoire.',
                 null,
                 [],
                 $contact,
@@ -219,8 +212,8 @@ final class CarrierContactProcessor implements ProcessorInterface
 
     /**
      * Trim + chaine vide -> null (la fonction n'est pas normalisee en casse,
-     * contrairement aux noms de personne). Garantit que RG-4.08 detecte un champ
-     * « non rempli » meme si le client envoie une chaine vide.
+     * contrairement aux noms de personne). Evite de persister une chaine vide
+     * (« » devient null) cote fonction du contact.
      */
     private function blankToNull(?string $value): ?string
     {

src/Module/Transport/Infrastructure/DataFixtures/CarrierFixtures.php

@@ -194,7 +194,7 @@ class CarrierFixtures extends Fixture implements DependentFixtureInterface
 
     /**
      * Ajoute un contact normalise au transporteur (cascade persist via
-     * Carrier.contacts). Au moins un champ est toujours fourni (RG-4.08).
+     * Carrier.contacts). Prenom OU nom toujours fourni (RG-4.08, chk_carrier_contact_name).
      */
     private function addContact(
         Carrier $carrier,

src/Shared/Infrastructure/Database/ColumnCommentsCatalog.php

@@ -509,11 +509,11 @@ final class ColumnCommentsCatalog
             ] + self::timestampableBlamableComments(),
 
             'carrier_contact' => [
-                '_table'          => 'Contacts d un transporteur (1:n) — onglet Contact (M4). Au moins un champ rempli (RG-4.08, chk_carrier_contact_filled), max 2 telephones.',
+                '_table'          => 'Contacts d un transporteur (1:n) — onglet Contact (M4). Au moins le prenom OU le nom rempli (RG-4.08, chk_carrier_contact_name), max 2 telephones.',
                 'id'              => 'Identifiant interne auto-incremente.',
                 'carrier_id'      => 'FK -> carrier.id, ON DELETE CASCADE — transporteur proprietaire du contact.',
-                'first_name'      => 'Prenom du contact (capitalise serveur). Au moins un champ du contact est requis (RG-4.08).',
-                'last_name'       => 'Nom du contact (capitalise serveur). Au moins un champ du contact est requis (RG-4.08).',
+                'first_name'      => 'Prenom du contact (capitalise serveur). Prenom OU nom obligatoire (RG-4.08, chk_carrier_contact_name).',
+                'last_name'       => 'Nom du contact (capitalise serveur). Prenom OU nom obligatoire (RG-4.08, chk_carrier_contact_name).',
                 'job_title'       => 'Fonction / intitule de poste du contact (≤ 120 caracteres).',
                 'phone_primary'   => 'Telephone principal — chiffres uniquement (normalisation serveur).',
                 'phone_secondary' => 'Telephone secondaire — chiffres uniquement (max 2 telephones, RG-4.08).',

tests/Module/Transport/Api/CarrierContactApiTest.php

@@ -15,8 +15,8 @@ use Symfony\Component\Console\Output\NullOutput;
  * POST /api/carriers/{id}/contacts, PATCH/DELETE /api/carrier_contacts/{id}.
  *
  * Contrat verifie :
- *  - RG-4.08 : contact totalement vide -> 422 (au moins 1 champ requis) ;
- *  - RG-4.08 : 1 seul champ rempli -> 201 ;
+ *  - RG-4.08 : contact sans prenom ni nom -> 422 (alignement M1/M2/M3) ;
+ *  - RG-4.08 : un nom (ou prenom) suffit -> 201 ;
  *  - RG-4.08 : 3 telephones (tableau `phones`) -> 422 (max 2) ;
  *  - mapping `phones[]` -> phonePrimary / phoneSecondary + normalisation (RG-4.13) ;
  *  - PATCH / DELETE OK avec transport.carriers.manage, 403 sans (view seul).
@@ -51,7 +51,8 @@ final class CarrierContactApiTest extends AbstractCarrierApiTestCase
 
     public function testEmptyContactReturns422(): void
     {
-        // RG-4.08 : aucun champ rempli -> 422 (garde Processor, double du CHECK BDD).
+        // RG-4.08 (alignement M1/M2/M3) : sans prenom ni nom -> 422 (garde Processor,
+        // double du CHECK BDD chk_carrier_contact_name).
         $carrier = $this->seedCarrier('Contact Vide');
         $client  = $this->createAdminClient();
 
@@ -60,13 +61,13 @@ final class CarrierContactApiTest extends AbstractCarrierApiTestCase
             'json'    => [],
         ]);
         self::assertResponseStatusCodeSame(422);
-        // RG-4.08 : la violation est rattachee a `firstName` (mapping inline ERP-101).
+        // La violation est rattachee a `firstName` (mapping inline ERP-101).
         self::assertViolationOnPath($response, 'firstName');
     }
 
     public function testSingleFieldContactIsCreated(): void
     {
-        // RG-4.08 : un seul champ suffit a valider le bloc.
+        // RG-4.08 : un nom (ou prenom) suffit a valider le bloc.
         $carrier = $this->seedCarrier('Contact Mono');
         $client  = $this->createAdminClient();