chore: bump version to v0.1.139

Nouveau module Logistique (M5), sans entité ni migration (ticket 1.2) :
- LogistiqueModule (ID logistique, permissions weighing_tickets.view/manage)
  enregistré dans config/modules.php
- layer front frontend/modules/logistique (auto-détecté)
- sidebar : section Logistique + item /weighing-tickets (gate ...view)
  + clés i18n sidebar.logistique.*
- 3 miroirs RBAC alignés : sidebar.php, personas.ts (user-full),
  SeedE2ECommand (user-full)
- matrice métier RbacSeeder : Bureau + Usine = view/manage ;
  Compta + Commerciale = aucun accès (spec § 5.2)

config/modules.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 use App\Module\Catalog\CatalogModule;
 use App\Module\Commercial\CommercialModule;
 use App\Module\Core\CoreModule;
+use App\Module\Logistique\LogistiqueModule;
 use App\Module\Sites\SitesModule;
 use App\Module\Technique\TechniqueModule;
 use App\Module\Transport\TransportModule;
@@ -15,4 +16,5 @@ return [
     CatalogModule::class,
     TechniqueModule::class,
     TransportModule::class,
+    LogistiqueModule::class,
 ];

config/sidebar.php

@@ -78,6 +78,25 @@ return [
             ],
         ],
     ],
+    // Section "Logistique" (M5, ERP-181) : nouveau pole "operations physiques sur
+    // site", distinct du repertoire Transport (M4, desormais rattache a la section
+    // Administration cote develop). Porte le ticket de pesee au pont bascule.
+    // L'item est gate par `logistique.weighing_tickets.view` ; la section disparait
+    // automatiquement (SidebarProvider) si le module `logistique` est desactive ou
+    // si l'user n'a pas la permission (Compta / Commerciale).
+    [
+        'label' => 'sidebar.logistique.section',
+        'icon'  => 'mdi:scale',
+        'items' => [
+            [
+                'label'      => 'sidebar.logistique.weighing_tickets',
+                'to'         => '/weighing-tickets',
+                'icon'       => 'mdi:scale',
+                'module'     => 'logistique',
+                'permission' => 'logistique.weighing_tickets.view',
+            ],
+        ],
+    ],
     // Section "Administration" : regroupe toutes les pages de configuration
     // applicative (RBAC, users, sites, audit log).
     //

config/version.yaml

@@ -1,2 +1,2 @@
 parameters:
-    app.version: '0.1.136'
+    app.version: '0.1.139'

frontend/i18n/locales/fr.json

@@ -39,6 +39,10 @@
             "section": "Transport",
             "carriers": "Répertoire transporteurs"
         },
+        "logistique": {
+            "section": "Logistique",
+            "weighing_tickets": "Tickets de pesée"
+        },
         "core": {
             "roles": "Gestion des rôles",
             "users": "Utilisateurs",
@@ -530,7 +534,48 @@
                 "integrateSuccess": "Transporteur QUALIMAT intégré",
                 "addressSaved": "Adresse enregistrée",
                 "contactSaved": "Contact enregistré",
-                "priceSaved": "Prix enregistré"
+                "priceSaved": "Prix enregistré",
+                "updateSuccess": "Transporteur mis à jour avec succès",
+                "archiveSuccess": "Transporteur archivé avec succès",
+                "restoreSuccess": "Transporteur restauré avec succès"
+            },
+            "action": {
+                "edit": "Modifier",
+                "archive": "Archiver",
+                "restore": "Restaurer"
+            },
+            "consultation": {
+                "title": "Consultation transporteur",
+                "back": "Retour au répertoire",
+                "loading": "Chargement du transporteur…",
+                "notFound": "Transporteur introuvable.",
+                "confirmArchive": {
+                    "title": "Archiver le transporteur",
+                    "message": "Ce transporteur n'apparaîtra plus dans le répertoire actif. Confirmer l'archivage ?"
+                },
+                "confirmRestore": {
+                    "title": "Restaurer le transporteur",
+                    "message": "Ce transporteur réapparaîtra dans le répertoire actif. Confirmer la restauration ?"
+                },
+                "price": {
+                    "group": "Type de transport",
+                    "carrier": "Transporteurs",
+                    "aproOrSite": "Adresse sites",
+                    "delivery": "Adresse livraisons",
+                    "forfait": "Forfait (€)",
+                    "tonne": "Tonne (€)",
+                    "indexation": "Indexation",
+                    "state": "État du prix",
+                    "export": "Exporter",
+                    "empty": "Aucun prix pour ce transporteur."
+                }
+            },
+            "edit": {
+                "title": "Modifier le transporteur",
+                "back": "Retour à la consultation",
+                "loading": "Chargement du transporteur…",
+                "notFound": "Transporteur introuvable.",
+                "save": "Enregistrer"
             },
             "containerType": {
                 "BENNE": "Benne",
@@ -580,7 +625,8 @@
                     "dischargeRequired": "La décharge est obligatoire pour une certification « Autre ».",
                     "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é."
+                    "volumeRequired": "Le volume est obligatoire pour un transporteur affrété.",
+                    "uploadFailed": "Le téléversement de la décharge a échoué."
                 },
                 "address": {
                     "country": "Pays",
@@ -589,8 +635,6 @@
                     "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": {

frontend/modules/logistique/nuxt.config.ts

@@ -0,0 +1 @@
+export default defineNuxtConfig({})

frontend/modules/transport/components/CarrierAddressBlock.vue

@@ -1,15 +1,6 @@
 <template>
+    <!-- Adresse UNIQUE par transporteur (ERP-172) : un seul bloc, jamais supprimable. -->
     <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"
@@ -114,7 +105,6 @@ const props = defineProps<{
     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>
@@ -122,7 +112,6 @@ const props = defineProps<{
 
 const emit = defineEmits<{
     'update:modelValue': [value: CarrierAddressFormDraft]
-    'remove': []
     /** Emis une fois quand le service d'autocompletion bascule en indisponible. */
     'degraded': []
 }>()

frontend/modules/transport/components/CarrierPriceBlock.vue

@@ -17,7 +17,7 @@
             <div class="flex h-12 items-center gap-6">
                 <MalioRadioButton
                     :model-value="model.direction"
-                    name="price-direction"
+                    :name="`price-direction-${uid}`"
                     value="CLIENT"
                     :label="t('transport.carriers.form.price.directionClient')"
                     :disabled="readonly"
@@ -26,7 +26,7 @@
                 />
                 <MalioRadioButton
                     :model-value="model.direction"
-                    name="price-direction"
+                    :name="`price-direction-${uid}`"
                     value="FOURNISSEUR"
                     :label="t('transport.carriers.form.price.directionSupplier')"
                     :disabled="readonly"
@@ -112,7 +112,7 @@
                 <div class="flex h-12 items-center gap-4">
                     <MalioRadioButton
                         :model-value="model.containerType"
-                        name="price-container"
+                        :name="`price-container-${uid}`"
                         value="BENNE"
                         :label="t('transport.carriers.containerType.BENNE')"
                         :disabled="readonly"
@@ -121,7 +121,7 @@
                     />
                     <MalioRadioButton
                         :model-value="model.containerType"
-                        name="price-container"
+                        :name="`price-container-${uid}`"
                         value="FOND_MOUVANT"
                         :label="t('transport.carriers.containerType.FOND_MOUVANT')"
                         :disabled="readonly"
@@ -137,7 +137,7 @@
                 <div class="flex h-12 items-center gap-4">
                     <MalioRadioButton
                         :model-value="model.pricingUnit"
-                        name="price-unit"
+                        :name="`price-unit-${uid}`"
                         value="FORFAIT"
                         :label="t('transport.carriers.form.price.pricingForfait')"
                         :disabled="readonly"
@@ -146,7 +146,7 @@
                     />
                     <MalioRadioButton
                         :model-value="model.pricingUnit"
-                        name="price-unit"
+                        :name="`price-unit-${uid}`"
                         value="TONNE"
                         :label="t('transport.carriers.form.price.pricingTonne')"
                         :disabled="readonly"
@@ -181,7 +181,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed, ref, watch } from 'vue'
+import { computed, ref, useId, watch } from 'vue'
 import type { CarrierPriceFormDraft } from '~/modules/transport/types/carrierForm'
 
 interface SelectOption {
@@ -212,6 +212,11 @@ const emit = defineEmits<{
 const { t } = useI18n()
 const api = useApi()
 
+// Identifiant unique par instance : les groupes de radios (sens / contenant / tarif)
+// doivent avoir un `name` PROPRE à chaque bloc prix, sinon plusieurs blocs partagent
+// le même groupe HTML et leurs radios se désélectionnent mutuellement.
+const uid = useId()
+
 const model = computed(() => props.modelValue)
 
 const priceStateOptions = computed<SelectOption[]>(() => [

frontend/modules/transport/components/CarrierQualimatTab.vue

@@ -0,0 +1,201 @@
+<script setup lang="ts">
+import { computed, ref, watch } from 'vue'
+import { debounce } from '~/shared/utils/debounce'
+import { useQualimatSearch, type QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
+
+/**
+ * Onglet « Qualimat » — saisie assistée par recherche dans le référentiel QUALIMAT
+ * (RG-4.01 / RG-4.04). Datatable paginé filtré par le NOM (`searchName`), sélection
+ * d'une ligne → modal de confirmation → `integrate`. Mutualisé entre l'écran
+ * d'AJOUT (ERP-166) et l'écran de MODIFICATION (ERP-172, « actualiser le
+ * transporteur »). La persistance (copie nom / certification / FK) est portée par
+ * le parent via `useCarrierForm.applyQualimatSelection`.
+ */
+const props = defineProps<{
+    /** Terme de recherche (nom du transporteur saisi dans le formulaire principal). */
+    searchName: string
+    /** IRI QUALIMAT actuellement lié (coche le radio de la ligne correspondante). */
+    selectedIri: string | null
+}>()
+
+const emit = defineEmits<{
+    (event: 'integrate', row: QualimatCarrierRow): void
+}>()
+
+const { t } = useI18n()
+
+const {
+    items: qualimatItems,
+    totalItems: qualimatTotal,
+    currentPage: qualimatPage,
+    itemsPerPage: qualimatPerPage,
+    itemsPerPageOptions: qualimatPerPageOptions,
+    goToPage: qualimatGoToPage,
+    setItemsPerPage: qualimatSetPerPage,
+    setFilters: qualimatSetFilters,
+} = useQualimatSearch()
+
+// Colonnes du datatable de sélection QUALIMAT (radio / Nom / Adresse / Validité).
+const qualimatColumns = [
+    { key: 'select', label: '' },
+    { key: 'name', label: t('transport.carriers.form.qualimat.columns.name') },
+    { key: 'address', label: t('transport.carriers.form.qualimat.columns.address') },
+    { key: 'validityDate', label: t('transport.carriers.form.qualimat.columns.validityDate') },
+]
+
+// Le datatable n'affiche QUE des résultats de recherche : vide tant que le Nom n'est
+// pas saisi (pas de liste complète par défaut).
+const hasQualimatSearch = computed(() => props.searchName.trim() !== '')
+
+const qualimatRows = computed(() => {
+    if (!hasQualimatSearch.value) {
+        return []
+    }
+    return qualimatItems.value.map(row => ({
+        id: row.id,
+        iri: row['@id'],
+        name: row.name,
+        address: formatQualimatAddress(row),
+        validityDate: row.validityDate,
+    }))
+})
+
+const qualimatTotalDisplay = computed(() => (hasQualimatSearch.value ? qualimatTotal.value : 0))
+const qualimatEmptyMessage = computed(() => hasQualimatSearch.value
+    ? t('transport.carriers.form.qualimat.empty')
+    : t('transport.carriers.form.qualimat.searchHint'))
+
+// Re-filtrage debouncé sur le nom ; aucune recherche tant que le Nom est vide.
+const filterQualimatByName = debounce((term: string) => {
+    if (term.trim() === '') {
+        return
+    }
+    void qualimatSetFilters({ search: term })
+}, 300)
+
+watch(() => props.searchName, term => filterQualimatByName(term), { immediate: true })
+
+/** Adresse QUALIMAT condensée pour la colonne « Adresse » (voie · CP · ville). */
+function formatQualimatAddress(row: QualimatCarrierRow): string {
+    return [row.address, row.postalCode, row.city].filter(Boolean).join(' · ')
+}
+
+/** RG-4.04 : un agrément est périmé si sa date de validité est < aujourd'hui. */
+function isExpired(value: string): boolean {
+    const date = new Date(value)
+    if (Number.isNaN(date.getTime())) {
+        return false
+    }
+    const today = new Date()
+    today.setHours(0, 0, 0, 0)
+    date.setHours(0, 0, 0, 0)
+    return date.getTime() < today.getTime()
+}
+
+/** Format court français JJ-MM-AAAA (chaîne vide si date absente / invalide). */
+function formatDateFr(value: string | null | undefined): string {
+    if (!value) {
+        return ''
+    }
+    const date = new Date(value)
+    if (Number.isNaN(date.getTime())) {
+        return ''
+    }
+    const day = String(date.getDate()).padStart(2, '0')
+    const month = String(date.getMonth() + 1).padStart(2, '0')
+    return `${day}-${month}-${date.getFullYear()}`
+}
+
+// ── Confirmation d'intégration ───────────────────────────────────────────────
+const confirmOpen = ref(false)
+const pendingRow = ref<QualimatCarrierRow | null>(null)
+
+/** Clic sur une ligne → retrouve la ligne QUALIMAT source + ouvre la modal. */
+function onQualimatRowClick(item: Record<string, unknown>): void {
+    const row = qualimatItems.value.find(r => r.id === item.id)
+    if (row) {
+        pendingRow.value = row
+        confirmOpen.value = true
+    }
+}
+
+/** Confirme l'intégration : délègue la persistance au parent via `integrate`. */
+function confirmIntegrate(): void {
+    const row = pendingRow.value
+    confirmOpen.value = false
+    if (row !== null) {
+        emit('integrate', row)
+    }
+}
+</script>
+
+<template>
+    <div class="mt-12 flex flex-col gap-6">
+        <!-- table-fixed : 1re colonne (radio) étroite, les 3 autres à parts égales. -->
+        <MalioDataTable
+            class="qualimat-table"
+            table-class="table-fixed"
+            :columns="qualimatColumns"
+            :items="qualimatRows"
+            :total-items="qualimatTotalDisplay"
+            :page="qualimatPage"
+            :per-page="qualimatPerPage"
+            :per-page-options="qualimatPerPageOptions"
+            row-clickable
+            :empty-message="qualimatEmptyMessage"
+            @row-click="onQualimatRowClick"
+            @update:page="qualimatGoToPage"
+            @update:per-page="qualimatSetPerPage"
+        >
+            <!-- Radio reflétant la ligne QUALIMAT intégrée (lecture). -->
+            <template #cell-select="{ item }">
+                <MalioRadioButton
+                    :model-value="selectedIri"
+                    name="qualimat-row"
+                    :value="item.iri"
+                    group-class="mt-0"
+                />
+            </template>
+            <!-- Date de validité : fond rouge si périmée (RG-4.04). -->
+            <template #cell-validityDate="{ item }">
+                <span
+                    v-if="item.validityDate"
+                    :class="isExpired(item.validityDate as string) ? 'inline-block rounded px-2 py-0.5 bg-m-danger text-white' : ''"
+                >
+                    {{ formatDateFr(item.validityDate as string) }}
+                </span>
+            </template>
+        </MalioDataTable>
+
+        <!-- Modal de confirmation d'intégration QUALIMAT. -->
+        <MalioModal v-model="confirmOpen" modal-class="max-w-md">
+            <template #header>
+                <h2 class="text-[24px] font-bold">{{ t('transport.carriers.form.qualimat.confirm.title') }}</h2>
+            </template>
+            <p>{{ t('transport.carriers.form.qualimat.confirm.message') }}</p>
+            <template #footer>
+                <MalioButton
+                    variant="secondary"
+                    button-class="flex-1"
+                    :label="t('transport.carriers.form.qualimat.confirm.cancel')"
+                    @click="confirmOpen = false"
+                />
+                <MalioButton
+                    variant="primary"
+                    button-class="flex-1"
+                    :label="t('transport.carriers.form.qualimat.confirm.confirm')"
+                    @click="confirmIntegrate"
+                />
+            </template>
+        </MalioModal>
+    </div>
+</template>
+
+<style scoped>
+/* Datatable QUALIMAT en table-fixed : la colonne radio (1re) reste étroite,
+   les 3 autres (nom / adresse / validité) se partagent l'espace à parts égales. */
+.qualimat-table :deep(th:first-child),
+.qualimat-table :deep(td:first-child) {
+    width: 56px;
+}
+</style>

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

@@ -111,6 +111,8 @@ describe('useCarrierForm', () => {
         form.main.name = 'Acme'
         form.main.certificationType = 'GMP_PLUS'
         form.main.isChartered = true
+        // Annule le défaut « BENNE » pour vérifier la garde « contenant obligatoire ».
+        form.main.containerType = null
 
         const created = await form.submitMain()
 
@@ -323,16 +325,18 @@ describe('useCarrierForm — champs conditionnels (ERP-166)', () => {
         })
     })
 
-    it('RG-4.03 affrété mais champs vides : omis du payload (422 NotBlank back)', () => {
+    it('RG-4.03 affrété, indexation/volume vides : omis du payload (containerType garde son défaut BENNE)', () => {
         const form = useCarrierForm()
         form.main.name = 'Acme'
         form.main.certificationType = 'GMP_PLUS'
         form.main.isChartered = true
 
+        // indexation / volume vides → omis (422 NotBlank back) ; containerType défaut « BENNE » envoyé.
         expect(form.buildMainPayload()).toEqual({
             name: 'Acme',
             certificationType: 'GMP_PLUS',
             isChartered: true,
+            containerType: 'BENNE',
         })
     })
 
@@ -346,6 +350,52 @@ describe('useCarrierForm — champs conditionnels (ERP-166)', () => {
         form.main.dischargeDocumentIri = '/api/uploaded_documents/7'
         expect(form.buildMainPayload()).toMatchObject({ dischargeDocument: '/api/uploaded_documents/7' })
     })
+
+    it('RG-4.02 upload différé : selectDischarge ne POST pas ; submitMain upload PUIS crée', async () => {
+        mockPost.mockReset()
+        // 1er POST = /uploaded_documents (renvoie l'IRI) ; 2e = /carriers (création).
+        mockPost
+            .mockResolvedValueOnce({ '@id': '/api/uploaded_documents/7' })
+            .mockResolvedValueOnce({ id: 12, name: 'ACME', certificationType: 'AUTRE' })
+
+        const form = useCarrierForm()
+        form.main.name = 'Acme'
+        form.main.certificationType = 'AUTRE'
+
+        // Sélection du fichier : aucun appel réseau (upload différé à l'enregistrement).
+        form.selectDischarge(new File(['x'], 'decharge.pdf', { type: 'application/pdf' }))
+        expect(mockPost).not.toHaveBeenCalled()
+        // La validation est satisfaite par le fichier en attente (pas encore d'IRI).
+        expect(form.mainErrors.errors.dischargeDocument).toBeUndefined()
+
+        const created = await form.submitMain()
+        expect(created).toBe(true)
+
+        // 1er appel : upload multipart ; 2e : création carrier avec l'IRI résolu.
+        expect(mockPost.mock.calls[0][0]).toBe('/uploaded_documents')
+        expect(mockPost.mock.calls[1][0]).toBe('/carriers')
+        expect(mockPost.mock.calls[1][1]).toMatchObject({ dischargeDocument: '/api/uploaded_documents/7' })
+    })
+
+    it('RG-4.02 upload différé : un 422 MIME bloque la création (message inline, pas de POST /carriers)', async () => {
+        mockPost.mockReset()
+        // Le POST /uploaded_documents échoue (MIME hors whitelist) → 422.
+        mockPost.mockRejectedValueOnce(Object.assign(new Error('422'), {
+            data: { 'hydra:description': 'Type de fichier non autorisé.' },
+        }))
+
+        const form = useCarrierForm()
+        form.main.name = 'Acme'
+        form.main.certificationType = 'AUTRE'
+        form.selectDischarge(new File(['x'], 'malware.exe', { type: 'application/x-msdownload' }))
+
+        const created = await form.submitMain()
+        expect(created).toBe(false)
+        // Message back affiché inline sous le champ ; aucune création de carrier.
+        expect(form.mainErrors.errors.dischargeDocument).toBe('Type de fichier non autorisé.')
+        expect(mockPost).toHaveBeenCalledTimes(1)
+        expect(mockPost.mock.calls[0][0]).toBe('/uploaded_documents')
+    })
 })
 
 describe('useCarrierForm — copie QUALIMAT (ERP-166)', () => {
@@ -436,14 +486,13 @@ describe('useCarrierForm — copie QUALIMAT (ERP-166)', () => {
         })
     })
 
-    it('applyQualimatSelection pré-remplit le 1er bloc d\'adresse (RG-4.05)', async () => {
+    it('applyQualimatSelection pré-remplit l\'adresse unique à la création (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({
+        expect(form.address.value).toEqual({
             id: null,
             country: 'France',
             postalCode: '86000',
@@ -454,53 +503,38 @@ describe('useCarrierForm — copie QUALIMAT (ERP-166)', () => {
     })
 })
 
-describe('useCarrierForm — onglet Adresses (ERP-167)', () => {
+describe('useCarrierForm — onglet Adresse (ERP-167 / ERP-172 : adresse unique)', () => {
     beforeEach(() => {
         mockPost.mockReset()
         mockPatch.mockReset()
         mockDelete.mockReset()
     })
 
-    /** Transporteur créé, onglet Adresses accessible. */
+    /** Transporteur créé, onglet Adresse 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'
-        }
+    /** Remplit l'unique bloc adresse (CP + ville + rue). */
+    function fillAddress(form: ReturnType<typeof useCarrierForm>): void {
+        const a = form.address.value
+        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 () => {
+    it('submitAddress : POST sur /carriers/{id}/address, capture l\'id, finalise l\'onglet', async () => {
         mockPost.mockResolvedValueOnce({ id: 88 })
         const form = createdForm()
         fillAddress(form)
 
-        const ok = await form.submitAddresses(vi.fn())
+        const ok = await form.submitAddress(vi.fn())
 
         expect(ok).toBe(true)
         const [url, body, opts] = mockPost.mock.calls[0] ?? []
-        expect(url).toBe('/carriers/7/addresses')
+        expect(url).toBe('/carriers/7/address')
         expect(body).toEqual({
             country: 'France',
             postalCode: '86100',
@@ -509,24 +543,23 @@ describe('useCarrierForm — onglet Adresses (ERP-167)', () => {
             streetComplement: null,
         })
         expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
-        expect(form.addresses.value[0]?.id).toBe(88)
+        expect(form.address.value.id).toBe(88)
         expect(form.isValidated('addresses')).toBe(true)
     })
 
-    it('submitAddresses : PATCH des adresses existantes sur /carrier_addresses/{id}', async () => {
+    it('submitAddress : PATCH de l\'adresse existante sur /carrier_addresses/{id}', async () => {
         mockPatch.mockResolvedValueOnce({})
         const form = createdForm()
         fillAddress(form)
-        const first = form.addresses.value[0]
-        if (first) first.id = 88
+        form.address.value.id = 88
 
-        await form.submitAddresses(vi.fn())
+        await form.submitAddress(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 () => {
+    it('submitAddress : mappe les 422 inline par champ et ne finalise pas l\'onglet (RG-4.05)', async () => {
         mockPost.mockRejectedValueOnce({
             response: {
                 status: 422,
@@ -536,27 +569,12 @@ describe('useCarrierForm — onglet Adresses (ERP-167)', () => {
         const form = createdForm()
         fillAddress(form)
 
-        const ok = await form.submitAddresses(vi.fn())
+        const ok = await form.submitAddress(vi.fn())
 
         expect(ok).toBe(false)
-        expect(form.addressErrors.value[0]?.city).toBe('La ville est obligatoire pour un transporteur affrété.')
+        expect(form.addressErrors.value.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', () => {
@@ -912,3 +930,118 @@ describe('useCarrierForm — onglet Prix (ERP-169)', () => {
         expect(form.prices.value).toHaveLength(1)
     })
 })
+
+describe('useCarrierForm — édition (ERP-170)', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+    })
+
+    it('prefillFrom : peuple carrierId + principal + sous-collections, passe en editMode', () => {
+        const form = useCarrierForm()
+        form.prefillFrom({
+            '@id': '/api/carriers/7',
+            id: 7,
+            name: 'TRANSPORTS ACME',
+            certificationType: 'GMP_PLUS',
+            address: { '@id': '/api/carrier_addresses/3', id: 3, city: 'Poitiers' },
+            contacts: [{ '@id': '/api/carrier_contacts/9', id: 9, lastName: 'Doe', phonePrimary: '0102030405' }],
+            prices: [{ '@id': '/api/carrier_prices/5', id: 5, direction: 'CLIENT', client: { '@id': '/api/clients/3' }, containerType: 'BENNE', pricingUnit: 'FORFAIT', price: '120', priceState: 'EN_COURS' }],
+        })
+
+        expect(form.carrierId.value).toBe(7)
+        expect(form.editMode.value).toBe(true)
+        expect(form.main.name).toBe('TRANSPORTS ACME')
+        expect(form.main.certificationType).toBe('GMP_PLUS')
+        expect(form.address.value.id).toBe(3)
+        expect(form.contacts.value[0]?.id).toBe(9)
+        expect(form.prices.value[0]?.clientIri).toBe('/api/clients/3')
+    })
+
+    it('updateMain : PATCH /carriers/{id} (pas de POST), réaffiche le nom normalisé', async () => {
+        mockPatch.mockResolvedValueOnce({ id: 7, name: 'TRANSPORTS ACME', certificationType: 'GMP_PLUS' })
+        const form = useCarrierForm()
+        form.prefillFrom({ '@id': '/api/carriers/7', id: 7, name: 'Transports Acme', certificationType: 'GMP_PLUS' })
+
+        const ok = await form.updateMain()
+
+        expect(ok).toBe(true)
+        expect(mockPost).not.toHaveBeenCalled()
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/carriers/7',
+            expect.objectContaining({ name: 'Transports Acme', certificationType: 'GMP_PLUS' }),
+            { toast: false },
+        )
+        expect(form.main.name).toBe('TRANSPORTS ACME')
+    })
+})
+
+describe('useCarrierForm — modification : Qualimat + certification (ERP-172)', () => {
+    const QUALIMAT_ROW = {
+        '@id': '/api/qualimat_carriers/42',
+        id: '42',
+        name: 'TRANSPORTS QUALIMAT',
+        address: '1 rue du Port',
+        postalCode: '86000',
+        city: 'Poitiers',
+        validityDate: '2027-01-15',
+        status: 'VALIDE',
+    }
+
+    beforeEach(() => {
+        mockPost.mockReset()
+        mockPatch.mockReset()
+    })
+
+    it('setCertification : quitter QUALIMAT délie la FK qualimatCarrier', () => {
+        const form = useCarrierForm()
+        form.main.qualimatCarrierIri = '/api/qualimat_carriers/42'
+        form.main.certificationType = 'QUALIMAT'
+
+        form.setCertification('GMP_PLUS')
+
+        expect(form.main.certificationType).toBe('GMP_PLUS')
+        expect(form.main.qualimatCarrierIri).toBeNull()
+    })
+
+    it('certificationReadonly : éditable en modification même pour un QUALIMAT', () => {
+        const form = useCarrierForm()
+        form.prefillFrom({
+            '@id': '/api/carriers/7', id: 7, name: 'ACME', certificationType: 'QUALIMAT',
+            qualimatCarrier: { '@id': '/api/qualimat_carriers/42' },
+        })
+        expect(form.isQualimat.value).toBe(true)
+        expect(form.certificationReadonly.value).toBe(false)
+    })
+
+    it('buildMainPayload : en modification, délie le Qualimat (qualimatCarrier: null) sans lien', () => {
+        const form = useCarrierForm()
+        form.prefillFrom({
+            '@id': '/api/carriers/7', id: 7, name: 'ACME', certificationType: 'QUALIMAT',
+            qualimatCarrier: { '@id': '/api/qualimat_carriers/42' },
+        })
+        form.setCertification('GMP_PLUS')
+
+        expect(form.buildMainPayload()).toMatchObject({ certificationType: 'GMP_PLUS', qualimatCarrier: null })
+    })
+
+    it('applyQualimatSelection : en modification, conserve l\'adresse existante (PATCH nom/certif/FK)', async () => {
+        mockPatch.mockResolvedValueOnce({})
+        const form = useCarrierForm()
+        form.prefillFrom({
+            '@id': '/api/carriers/7', id: 7, name: 'OLD', certificationType: 'GMP_PLUS',
+            address: { '@id': '/api/carrier_addresses/3', id: 3, city: 'Poitiers', street: 'rue A' },
+        })
+        const addressBefore = { ...form.address.value }
+
+        const ok = await form.applyQualimatSelection(QUALIMAT_ROW)
+
+        expect(ok).toBe(true)
+        // Décision « conserver » (ERP-172) : l'adresse n'est pas réécrite en modification.
+        expect(form.address.value).toEqual(addressBefore)
+        // Nom + certification + FK actualisés via PATCH.
+        expect(form.main.name).toBe('TRANSPORTS QUALIMAT')
+        expect(form.main.certificationType).toBe('QUALIMAT')
+        expect(form.main.qualimatCarrierIri).toBe('/api/qualimat_carriers/42')
+    })
+})

frontend/modules/transport/composables/useCarrier.ts

@@ -0,0 +1,68 @@
+import { ref } from 'vue'
+import type { CarrierDetail } from '~/modules/transport/utils/forms/carrierMappers'
+
+/**
+ * Chargement et actions d'archivage d'un transporteur unique (écrans Consultation /
+ * Modification, ERP-170). Miroir de `useProvider` (M3) / `useSupplier` (M2). Lit le
+ * détail embarqué via `GET /api/carriers/{id}` (qualimatCarrier + addresses /
+ * contacts / prices sous `carrier:item:read`, relations cross-module via leurs
+ * read-groups) — une SEULE requête peuple les deux écrans (embed borné, pas de N+1).
+ *
+ * L'en-tête `Accept: application/ld+json` est imposé pour obtenir le payload Hydra
+ * complet (avec les `@id` des relations embarquées, indispensables au préremplissage).
+ *
+ * État 100 % local à l'instance (refs). Les erreurs d'archivage / restauration
+ * (notamment le 409 d'homonyme actif à la restauration) sont PROPAGÉES à l'appelant.
+ */
+export function useCarrier(id: number | string) {
+    const api = useApi()
+
+    const carrier = ref<CarrierDetail | null>(null)
+    const loading = ref(false)
+    const error = ref(false)
+
+    /** Récupère le détail complet (embed qualimatCarrier + addresses / contacts / prices). */
+    function fetchDetail(): Promise<CarrierDetail> {
+        return api.get<CarrierDetail>(
+            `/carriers/${id}`,
+            {},
+            { headers: { Accept: 'application/ld+json' }, toast: false },
+        )
+    }
+
+    /** Charge le détail du transporteur. En cas d'échec : `error = true`, `carrier = null`. */
+    async function load(): Promise<void> {
+        loading.value = true
+        error.value = false
+        try {
+            carrier.value = await fetchDetail()
+        }
+        catch {
+            error.value = true
+            carrier.value = null
+        }
+        finally {
+            loading.value = false
+        }
+    }
+
+    /**
+     * Bascule l'archivage (PATCH `isArchived` SEUL — groupe carrier:write:archive ;
+     * tout autre champ → 422, security archive = Admin seul), puis RECHARGE le détail
+     * complet (la réponse du PATCH ne porte pas l'embed des sous-collections). Toute
+     * erreur est propagée à l'appelant AVANT le rechargement.
+     */
+    async function setArchived(isArchived: boolean): Promise<void> {
+        await api.patch(`/carriers/${id}`, { isArchived }, { toast: false })
+        carrier.value = await fetchDetail()
+    }
+
+    return {
+        carrier,
+        loading,
+        error,
+        load,
+        archive: () => setArchived(true),
+        restore: () => setArchived(false),
+    }
+}

frontend/modules/transport/composables/useCarrierForm.ts

@@ -1,5 +1,6 @@
 import { computed, reactive, ref, type Ref } from 'vue'
 import { useFormErrors } from '~/shared/composables/useFormErrors'
+import { useUpload } from '~/shared/composables/useUpload'
 import { extractApiErrorMessage, mapViolationsToRecord } from '~/shared/utils/api'
 import { removeCollectionRow } from '~/shared/utils/collectionRow'
 import {
@@ -15,9 +16,16 @@ import {
     type CarrierMainResponse,
     type CarrierPriceFormDraft,
 } from '~/modules/transport/types/carrierForm'
-import { buildCarrierAddressPayload, isCarrierAddressValid } from '~/modules/transport/utils/forms/carrierAddress'
+import { buildCarrierAddressPayload } from '~/modules/transport/utils/forms/carrierAddress'
 import { buildCarrierContactPayload, isCarrierContactBlank, isCarrierContactNamed } from '~/modules/transport/utils/forms/carrierContact'
 import { buildCarrierPricePayload, isCarrierPriceValid } from '~/modules/transport/utils/forms/carrierPrice'
+import {
+    mapAddressToDraft,
+    mapContactToDraft,
+    mapMainToDraft,
+    mapPriceToDraft,
+    type CarrierDetail,
+} from '~/modules/transport/utils/forms/carrierMappers'
 import type { QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
 
 /** Nom du cas spécial « compte-propre » LIOT (comparaison insensible à la casse, RG-4.01). */
@@ -59,6 +67,11 @@ export function useCarrierForm() {
     // Erreurs de validation par champ (ERP-101) du formulaire principal.
     const mainErrors = useFormErrors()
 
+    // Upload de la décharge (RG-4.02) — infra partagée /api/uploaded_documents.
+    // L'upload est DIFFÉRÉ : le fichier choisi attend ici jusqu'à l'enregistrement.
+    const { uploading: dischargeUploading, upload: uploadFile } = useUpload()
+    const pendingDischargeFile = ref<File | null>(null)
+
     // ── État du transporteur créé ─────────────────────────────────────────────
     const carrierId = ref<number | null>(null)
     const mainLocked = ref(false)
@@ -78,8 +91,10 @@ export function useCarrierForm() {
     // Transporteur QUALIMAT : la FK est posée → certification figée à « QUALIMAT ».
     const isQualimat = computed(() => main.qualimatCarrierIri !== null)
     // Certification masquée en cas LIOT ; lecture seule si QUALIMAT (ou bloc verrouillé).
+    // En MODIFICATION (ERP-172) : éditable même pour un QUALIMAT (le métier doit pouvoir
+    // changer la certification) — la sortie de QUALIMAT délie le référentiel.
     const showCertification = computed(() => !isLiot.value)
-    const certificationReadonly = computed(() => isQualimat.value || mainLocked.value)
+    const certificationReadonly = computed(() => (isQualimat.value && !editMode.value) || mainLocked.value)
     // RG-4.03 : champs d'affrètement (indexation / contenant / volume) visibles et
     // obligatoires si « Affréter » coché — masqués en cas LIOT.
     const showCharteredFields = computed(() => main.isChartered && !isLiot.value)
@@ -133,8 +148,9 @@ export function useCarrierForm() {
             valid = false
         }
 
-        // RG-4.02 : décharge obligatoire si certification AUTRE.
-        if (main.certificationType === 'AUTRE' && !main.dischargeDocumentIri) {
+        // RG-4.02 : décharge obligatoire si certification AUTRE — satisfaite par un
+        // IRI déjà posé OU un fichier en attente d'upload (différé à l'enregistrement).
+        if (main.certificationType === 'AUTRE' && !main.dischargeDocumentIri && !pendingDischargeFile.value) {
             mainErrors.setError('dischargeDocument', t('transport.carriers.form.errors.dischargeRequired'))
             valid = false
         }
@@ -158,6 +174,58 @@ export function useCarrierForm() {
         return valid
     }
 
+    /**
+     * Sélection de la décharge (RG-4.02) via `@file-selected` : le fichier est mis
+     * EN ATTENTE, l'upload réel est DIFFÉRÉ à l'enregistrement (`submitMain` /
+     * `updateMain`). Évite les binaires orphelins si l'utilisateur abandonne le
+     * formulaire après avoir choisi un fichier.
+     */
+    function selectDischarge(file: File): void {
+        mainErrors.clearError('dischargeDocument')
+        pendingDischargeFile.value = file
+    }
+
+    /** Annulation du choix de décharge : oublie le fichier en attente et l'IRI. */
+    function clearDischarge(): void {
+        pendingDischargeFile.value = null
+        main.dischargeDocumentIri = null
+    }
+
+    /**
+     * Résout l'upload différé au moment de l'enregistrement : s'il y a un fichier
+     * en attente, l'envoie (POST /uploaded_documents) et pose l'IRI sur le
+     * brouillon. Retourne false au 422 (MIME / taille → message inline) pour
+     * interrompre la sauvegarde du transporteur. Pas de fichier en attente → no-op.
+     */
+    async function resolveDischargeUpload(): Promise<boolean> {
+        if (!pendingDischargeFile.value) {
+            return true
+        }
+        try {
+            main.dischargeDocumentIri = await uploadFile(pendingDischargeFile.value)
+            pendingDischargeFile.value = null
+            return true
+        } catch (error) {
+            const message = extractApiErrorMessage((error as { data?: unknown })?.data)
+                || t('transport.carriers.form.errors.uploadFailed')
+            mainErrors.setError('dischargeDocument', message)
+            return false
+        }
+    }
+
+    /**
+     * Change la certification (sélecteur). Quitter « QUALIMAT » délie le référentiel
+     * (FK qualimatCarrier vidée — ERP-172) : un transporteur n'est QUALIMAT que tant
+     * que sa certification l'est. La FK null est propagée au back par buildMainPayload
+     * (en modification uniquement).
+     */
+    function setCertification(value: string | null): void {
+        main.certificationType = value
+        if (value !== 'QUALIMAT') {
+            main.qualimatCarrierIri = null
+        }
+    }
+
     /**
      * Payload du POST principal (groupe `carrier:write:main`). `name` et
      * `certificationType` sont omis s'ils sont vides afin que la 422 porte la
@@ -183,9 +251,14 @@ export function useCarrierForm() {
             payload.certificationType = main.certificationType
         }
         // FK QUALIMAT (saisie assistée, § 2.5) envoyée si une ligne a été intégrée.
+        // En MODIFICATION, on délie explicitement (null) si plus de lien — ex: la
+        // certification a changé de QUALIMAT vers autre chose (ERP-172).
         if (main.qualimatCarrierIri) {
             payload.qualimatCarrier = main.qualimatCarrierIri
         }
+        else if (editMode.value) {
+            payload.qualimatCarrier = null
+        }
         // RG-4.02 : décharge envoyée seulement en certification AUTRE ; omise quand
         // absente pour que la 422 « obligatoire » porte sur le champ.
         if (main.certificationType === 'AUTRE' && main.dischargeDocumentIri) {
@@ -220,6 +293,9 @@ export function useCarrierForm() {
 
         mainSubmitting.value = true
         try {
+            // Upload différé de la décharge : envoyé seulement maintenant (au Valider).
+            if (!(await resolveDischargeUpload())) return false
+
             const created = await api.post<CarrierMainResponse>('/carriers', buildMainPayload(), {
                 headers: { Accept: 'application/ld+json' },
                 toast: false,
@@ -257,6 +333,71 @@ export function useCarrierForm() {
         }
     }
 
+    /**
+     * MODIFICATION du formulaire principal (ERP-170) : PATCH /api/carriers/{id} sur le
+     * groupe carrier:write:main (PAS de re-POST). Pré-check front + 409 doublon / 422
+     * inline comme `submitMain`. Ne verrouille rien et ne bascule pas d'onglet (édition
+     * = navigation libre). Retourne true si le PATCH a réussi.
+     */
+    async function updateMain(): Promise<boolean> {
+        if (carrierId.value === null || mainSubmitting.value) return false
+        mainErrors.clearErrors()
+        if (!validateMainFront()) return false
+
+        mainSubmitting.value = true
+        try {
+            // Upload différé de la décharge : envoyé seulement maintenant (à l'Enregistrer).
+            if (!(await resolveDischargeUpload())) return false
+
+            const updated = await api.patch<CarrierMainResponse>(
+                `/carriers/${carrierId.value}`,
+                buildMainPayload(),
+                { toast: false },
+            )
+            main.name = updated.name ?? main.name
+            main.certificationType = updated.certificationType ?? main.certificationType
+            return true
+        }
+        catch (error) {
+            const status = (error as { response?: { status?: number } })?.response?.status
+            if (status === 409) {
+                const message = t('transport.carriers.form.duplicateName')
+                mainErrors.setError('name', message)
+                toast.error({ title: t('transport.carriers.toast.error'), message })
+            }
+            else {
+                mainErrors.handleApiError(error, { fallbackMessage: t('transport.carriers.toast.error') })
+            }
+            return false
+        }
+        finally {
+            mainSubmitting.value = false
+        }
+    }
+
+    /**
+     * Pré-remplit le formulaire depuis le détail `GET /api/carriers/{id}` (écran
+     * Modification) : peuple carrierId + principal + adresses / contacts / prix via les
+     * mappers, passe en `editMode` (navigation libre, tous onglets accessibles, bloc
+     * principal éditable). Au moins un bloc Adresse / Contact affiché même sans donnée.
+     */
+    function prefillFrom(detail: CarrierDetail): void {
+        carrierId.value = detail.id
+        editMode.value = true
+        mainLocked.value = false
+        unlockedIndex.value = tabKeys.value.length - 1
+
+        Object.assign(main, mapMainToDraft(detail))
+
+        // Adresse UNIQUE (ERP-172) : objet `address` (ou null) au lieu d'une liste.
+        address.value = detail.address ? mapAddressToDraft(detail.address) : emptyCarrierAddress()
+
+        const mappedContacts = (detail.contacts ?? []).map(mapContactToDraft)
+        contacts.value = mappedContacts.length > 0 ? mappedContacts : [emptyCarrierContact()]
+
+        prices.value = (detail.prices ?? []).map(mapPriceToDraft)
+    }
+
     /**
      * PATCH partiel du transporteur (mode strict : un seul groupe de sérialisation
      * par appel — spec-back § 2.9). Servira les onglets à champs scalaires des
@@ -314,75 +455,52 @@ export function useCarrierForm() {
         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,
-        })
-    }
+    // ── Onglet Adresse (ERP-167 / ERP-172 : adresse UNIQUE) ───────────────────
+    // Un transporteur a au plus UNE adresse (décision métier ERP-172) : un seul
+    // bloc, pas d'ajout/suppression. `id` null tant que l'adresse n'est pas créée.
+    const address = ref<CarrierAddressFormDraft>(emptyCarrierAddress())
+    // Erreurs 422 du bloc adresse (mapping inline par champ, ERP-101).
+    const addressErrors = ref<Record<string, string>>({})
 
     /**
-     * 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é).
+     * Valide l'onglet Adresse : POST sur /carriers/{id}/address (création) ou PATCH
+     * sur /carrier_addresses/{id} (mise à jour), groupe carrier:write:addresses.
+     * Erreurs 422 mappées inline par champ (RG-4.05 « obligatoire si affrété »
+     * re-validée back). Retourne true si l'onglet a été validé.
      */
-    async function submitAddresses(onError: (error: unknown) => void): Promise<boolean> {
+    async function submitAddress(onError: (error: unknown) => void): Promise<boolean> {
         if (carrierId.value === null || tabSubmitting.value) {
             return false
         }
         tabSubmitting.value = true
+        addressErrors.value = {}
         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
+            const body = buildCarrierAddressPayload(address.value)
+            if (address.value.id === null) {
+                const created = await api.post<{ id: number }>(
+                    `/carriers/${carrierId.value}/address`,
+                    body,
+                    { headers: { Accept: 'application/ld+json' }, toast: false },
+                )
+                address.value.id = created.id
+            }
+            else {
+                await api.patch(`/carrier_addresses/${address.value.id}`, body, { toast: false })
             }
             completeTab('addresses')
             return true
         }
+        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) {
+                addressErrors.value = mapped
+            }
+            else {
+                onError(error)
+            }
+            return false
+        }
         finally {
             tabSubmitting.value = false
         }
@@ -620,16 +738,20 @@ 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,
-        }]
+        // RG-4.05 : à la CRÉATION, pré-remplit l'adresse (unique) par copie du
+        // référentiel QUALIMAT (champs éditables, la FK QUALIMAT survit — § 2.5).
+        // En MODIFICATION (ERP-172) : on NE TOUCHE PAS l'adresse déjà saisie — la
+        // re-sélection Qualimat actualise seulement nom + certification + FK.
+        if (!editMode.value) {
+            address.value = {
+                id: null,
+                country: 'France',
+                postalCode: row.postalCode || null,
+                city: row.city || null,
+                street: row.address || null,
+                streetComplement: null,
+            }
+        }
         return true
     }
 
@@ -663,6 +785,7 @@ export function useCarrierForm() {
         mainSubmitting,
         tabSubmitting,
         mainErrors,
+        dischargeUploading,
         // affichage conditionnel
         isLiot,
         isQualimat,
@@ -677,13 +800,10 @@ export function useCarrierForm() {
         validated,
         editMode,
         isValidated,
-        // adresses
-        addresses,
+        // adresse (unique)
+        address,
         addressErrors,
-        canAddAddress,
-        addAddress,
-        removeAddress,
-        submitAddresses,
+        submitAddress,
         // contacts
         contacts,
         contactErrors,
@@ -699,9 +819,14 @@ export function useCarrierForm() {
         removePrice,
         submitPrices,
         // actions
+        setCertification,
+        selectDischarge,
+        clearDischarge,
         validateMainFront,
         buildMainPayload,
         submitMain,
+        updateMain,
+        prefillFrom,
         patchCarrier,
         applyQualimatSelection,
         completeTab,

frontend/modules/transport/pages/carriers/[id]/edit.vue

@@ -0,0 +1,420 @@
+<template>
+    <div>
+        <!-- En-tête : retour consultation + titre. -->
+        <div class="flex items-center gap-3 pt-11">
+            <MalioButtonIcon
+                icon="mdi:arrow-left-bold"
+                icon-size="24"
+                variant="ghost"
+                v-bind="{ ariaLabel: t('transport.carriers.edit.back') }"
+                @click="goBack"
+            />
+            <h1 class="text-[30px] font-semibold text-m-primary">{{ t('transport.carriers.edit.title') }}</h1>
+        </div>
+
+        <p v-if="loading" class="mt-12 text-center text-black/60">{{ t('transport.carriers.edit.loading') }}</p>
+        <p v-else-if="error" class="mt-12 text-center text-m-danger">{{ t('transport.carriers.edit.notFound') }}</p>
+
+        <template v-else>
+            <!-- ── Formulaire principal (éditable, PATCH partiel) ─────────────── -->
+            <div class="mt-[48px] grid grid-cols-3 xl:grid-cols-4 gap-x-[44px] gap-y-4">
+                <MalioInputText
+                    v-model="main.name"
+                    :label="t('transport.carriers.form.main.name')"
+                    :required="true"
+                    :error="mainErrors.errors.name"
+                />
+                <MalioInputText
+                    v-if="isLiot"
+                    v-model="main.liotPlates"
+                    :label="t('transport.carriers.form.main.liotPlates')"
+                    :hint="t('transport.carriers.form.main.liotPlatesHint')"
+                    :required="true"
+                    :error="mainErrors.errors.liotPlates"
+                />
+                <template v-if="!isLiot">
+                    <MalioSelect
+                        :model-value="main.certificationType"
+                        :options="certificationOptions"
+                        :label="t('transport.carriers.form.main.certificationType')"
+                        empty-option-label=""
+                        :required="true"
+                        :readonly="certificationReadonly"
+                        :error="mainErrors.errors.certificationType"
+                        @update:model-value="(v: string | number | null) => setCertification(v === null ? null : String(v))"
+                    />
+                    <MalioInputUpload
+                        v-if="showDischarge"
+                        :model-value="dischargeFileName"
+                        :label="t('transport.carriers.form.main.discharge')"
+                        accept="application/pdf,image/*"
+                        :required="true"
+                        :readonly="dischargeUploading"
+                        :clearable="true"
+                        :error="mainErrors.errors.dischargeDocument"
+                        @update:model-value="(v: string) => dischargeFileName = v"
+                        @file-selected="selectDischarge"
+                        @clear="onClearDischarge"
+                    />
+                    <div v-else class="hidden xl:block"></div>
+                    <div class="flex h-12 items-center">
+                        <MalioCheckbox
+                            id="carrier-edit-chartered"
+                            :label="t('transport.carriers.form.main.isChartered')"
+                            :model-value="main.isChartered"
+                            :reserve-message-space="false"
+                            @update:model-value="(val: boolean) => main.isChartered = val"
+                        />
+                    </div>
+                    <template v-if="showCharteredFields">
+                        <MalioInputAmount
+                            :key="indexationKey"
+                            :model-value="main.indexationRate"
+                            :label="t('transport.carriers.form.main.indexationRate')"
+                            icon-name="mdi:percent"
+                            icon-position="right"
+                            :required="true"
+                            :error="mainErrors.errors.indexationRate"
+                            @update:model-value="onIndexationInput"
+                        />
+                        <!-- Contenant : Benne / Fond mouvant en radios, centrés (h-12) comme
+                             à l'onglet Prix (Benne par défaut). -->
+                        <div>
+                            <div class="flex h-12 items-center gap-4">
+                                <MalioRadioButton
+                                    :model-value="main.containerType"
+                                    name="carrier-main-container"
+                                    value="BENNE"
+                                    :label="t('transport.carriers.containerType.BENNE')"
+                                    group-class="mt-0"
+                                    @update:model-value="(v: string | number | boolean | null) => main.containerType = v === null ? null : String(v)"
+                                />
+                                <MalioRadioButton
+                                    :model-value="main.containerType"
+                                    name="carrier-main-container"
+                                    value="FOND_MOUVANT"
+                                    :label="t('transport.carriers.containerType.FOND_MOUVANT')"
+                                    group-class="mt-0"
+                                    @update:model-value="(v: string | number | boolean | null) => main.containerType = v === null ? null : String(v)"
+                                />
+                            </div>
+                            <p v-if="mainErrors.errors.containerType" class="ml-[2px] text-xs text-m-danger">{{ mainErrors.errors.containerType }}</p>
+                        </div>
+                        <MalioInputText
+                            :model-value="main.volumeM3"
+                            :label="t('transport.carriers.form.main.volumeM3')"
+                            :required="true"
+                            :error="mainErrors.errors.volumeM3"
+                            @update:model-value="(v: string) => main.volumeM3 = sanitizeDecimal(v)"
+                        />
+                    </template>
+                </template>
+            </div>
+
+            <div class="mt-12 flex justify-center">
+                <MalioButton
+                    variant="primary"
+                    :label="t('transport.carriers.edit.save')"
+                    :disabled="mainSubmitting"
+                    @click="onUpdateMain"
+                />
+            </div>
+
+            <!-- ── Onglets éditables (navigation libre, PATCH partiel par onglet) ── -->
+            <MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
+                <!-- Qualimat : actualiser nom + certification depuis le référentiel (ERP-172). -->
+                <template #qualimat>
+                    <CarrierQualimatTab
+                        :search-name="main.name"
+                        :selected-iri="main.qualimatCarrierIri"
+                        @integrate="onIntegrateQualimat"
+                    />
+                </template>
+
+                <template #addresses>
+                    <div class="mt-12 flex flex-col gap-6">
+                        <!-- Adresse UNIQUE (ERP-172) : un seul bloc, sans ajouter/supprimer. -->
+                        <CarrierAddressBlock
+                            :model-value="address"
+                            :country-options="countryOptions"
+                            :errors="addressErrors"
+                            @update:model-value="(v) => address = v"
+                            @degraded="onAddressDegraded"
+                        />
+                        <div class="flex justify-center gap-6">
+                            <MalioButton variant="primary" :label="t('transport.carriers.edit.save')" :disabled="tabSubmitting" @click="onSubmitAddresses" />
+                        </div>
+                    </div>
+                </template>
+
+                <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)"
+                            :errors="contactErrors[index]"
+                            @update:model-value="(v) => contacts[index] = v"
+                            @remove="askRemoveContact(index)"
+                        />
+                        <div 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.edit.save')" :disabled="tabSubmitting" @click="onSubmitContacts" />
+                        </div>
+                    </div>
+                </template>
+
+                <template #prices>
+                    <div class="mt-12 flex flex-col gap-6">
+                        <CarrierPriceBlock
+                            v-for="(price, index) in prices"
+                            :key="index"
+                            :model-value="price"
+                            :client-options="clientOptions"
+                            :supplier-options="supplierOptions"
+                            :site-options="siteOptions"
+                            removable
+                            :errors="priceErrors[index]"
+                            @update:model-value="(v) => prices[index] = v"
+                            @remove="askRemovePrice(index)"
+                        />
+                        <div class="flex justify-center gap-6">
+                            <MalioButton variant="secondary" icon-name="mdi:add-bold" icon-position="left" :label="t('transport.carriers.form.price.add')" :disabled="!canAddPrice" @click="addPrice" />
+                            <MalioButton variant="primary" :label="t('transport.carriers.edit.save')" :disabled="tabSubmitting" @click="onSubmitPrices" />
+                        </div>
+                    </div>
+                </template>
+            </MalioTabList>
+        </template>
+
+        <!-- Modal de confirmation de suppression de bloc. -->
+        <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, onMounted, reactive, ref } from 'vue'
+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 CarrierPriceBlock from '~/modules/transport/components/CarrierPriceBlock.vue'
+import CarrierQualimatTab from '~/modules/transport/components/CarrierQualimatTab.vue'
+import { useCarrierForm } from '~/modules/transport/composables/useCarrierForm'
+import { useCarrier } from '~/modules/transport/composables/useCarrier'
+import type { QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
+import { clampPercent, sanitizeDecimal } from '~/modules/transport/utils/forms/numberInput'
+
+interface SelectOption {
+    value: string
+    label: string
+}
+
+const { t } = useI18n()
+const route = useRoute()
+const router = useRouter()
+const toast = useToast()
+const api = useApi()
+const { can } = usePermissions()
+
+const carrierId = route.params.id as string
+useHead({ title: t('transport.carriers.edit.title') })
+
+// Gating route : l'édition est réservée à `manage` ; sinon retour consultation.
+if (!can('transport.carriers.manage')) {
+    await navigateTo(`/carriers/${carrierId}`)
+}
+
+const { carrier, loading, error, load } = useCarrier(carrierId)
+
+const {
+    main,
+    mainSubmitting,
+    tabSubmitting,
+    mainErrors,
+    dischargeUploading,
+    selectDischarge,
+    clearDischarge,
+    setCertification,
+    isLiot,
+    certificationReadonly,
+    showCharteredFields,
+    showDischarge,
+    applyQualimatSelection,
+    address,
+    addressErrors,
+    submitAddress,
+    contacts,
+    contactErrors,
+    canAddContact,
+    addContact,
+    removeContact,
+    submitContacts,
+    prices,
+    priceErrors,
+    canAddPrice,
+    addPrice,
+    removePrice,
+    submitPrices,
+    updateMain,
+    prefillFrom,
+} = useCarrierForm()
+
+const SELECTABLE_CERTIFICATIONS = ['GMP_PLUS', 'OVOCOM', 'COMPTE_PROPRE', 'AUTRE'] as const
+const certificationOptions = computed<SelectOption[]>(() => {
+    const codes: string[] = [...SELECTABLE_CERTIFICATIONS]
+    if (main.certificationType === 'QUALIMAT') codes.unshift('QUALIMAT')
+    return codes.map(code => ({ value: code, label: t(`transport.carriers.certification.${code}`) }))
+})
+
+
+const TAB_ICONS: Record<string, string> = {
+    qualimat: 'mdi:truck-fast-outline',
+    addresses: 'mdi:map-marker-outline',
+    contacts: 'mdi:account-box-plus-outline',
+    prices: 'mdi:payment',
+}
+const activeTab = ref('addresses')
+// Onglet Qualimat disponible en modif (ERP-172) : « actualiser » nom + certification.
+const tabs = computed(() => ['qualimat', 'addresses', 'contacts', 'prices'].map(key => ({
+    key,
+    label: t(`transport.carriers.tab.${key}`),
+    icon: TAB_ICONS[key],
+})))
+
+// ── Référentiels (pays + clients / fournisseurs / sites pour l'onglet Prix) ───
+const countryOptions = ref<SelectOption[]>([{ value: 'France', label: 'France' }])
+const clientOptions = ref<SelectOption[]>([])
+const supplierOptions = ref<SelectOption[]>([])
+const siteOptions = ref<SelectOption[]>([])
+
+async function loadOptions(url: string, target: typeof clientOptions, labelOf: (m: Record<string, unknown>) => string): Promise<void> {
+    try {
+        const data = await api.get<{ member?: Record<string, unknown>[] }>(url, { pagination: 'false' }, { headers: { Accept: 'application/ld+json' }, toast: false })
+        target.value = (data.member ?? []).map(m => ({ value: String(m['@id']), label: labelOf(m) }))
+    }
+    catch {
+        target.value = []
+    }
+}
+
+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 { /* fallback France */ }
+}
+
+// ── Chargement + préremplissage ──────────────────────────────────────────────
+onMounted(async () => {
+    await load()
+    if (carrier.value) {
+        prefillFrom(carrier.value)
+        // Pré-affiche le nom du fichier de décharge déjà rattaché (s'il existe).
+        const doc = carrier.value.dischargeDocument
+        if (doc && typeof doc !== 'string') {
+            const meta = doc as Record<string, unknown>
+            dischargeFileName.value = String(meta.originalFilename ?? meta.name ?? '')
+        }
+    }
+    loadCountries().catch(() => {})
+    void loadOptions('/clients', clientOptions, m => String(m.companyName ?? m['@id']))
+    void loadOptions('/suppliers', supplierOptions, m => String(m.companyName ?? m['@id']))
+    void loadOptions('/sites', siteOptions, m => String(m.name ?? m['@id']))
+})
+
+function apiErrorMessage(err: unknown): string {
+    const data = (err as { response?: { _data?: unknown } })?.response?._data
+    return extractApiErrorMessage(data) || t('transport.carriers.toast.error')
+}
+
+// Nom de fichier affiché dans le champ Décharge (alimenté à la sélection ou au
+// chargement d'un transporteur ayant déjà une décharge).
+const dischargeFileName = ref('')
+
+/** Vidage du champ Décharge : oublie le fichier en attente / l'IRI + le nom affiché. */
+function onClearDischarge(): void {
+    clearDischarge()
+    dischargeFileName.value = ''
+}
+
+// Indexation plafonnée à 100 % : la clé force le ré-affichage du MalioInputAmount
+// (contrôlé) quand le plafonnement laisse le modelValue inchangé.
+const indexationKey = ref(0)
+
+/** Saisie de l'indexation : plafonne à 100 et re-synchronise le champ si plafonné. */
+function onIndexationInput(value: string): void {
+    const clamped = clampPercent(value)
+    main.indexationRate = clamped
+    if (clamped !== value) {
+        indexationKey.value += 1
+    }
+}
+
+function goBack(): void {
+    router.push(`/carriers/${carrierId}`)
+}
+
+/** PATCH du formulaire principal (pas de re-POST). */
+async function onUpdateMain(): Promise<void> {
+    const ok = await updateMain()
+    if (ok) {
+        toast.success({ title: t('transport.carriers.toast.updateSuccess') })
+    }
+}
+
+/** Intégration d'une ligne QUALIMAT (onglet Qualimat) : actualise nom + certification
+ *  + FK via PATCH (applyQualimatSelection). L'adresse existante n'est pas touchée. */
+async function onIntegrateQualimat(row: QualimatCarrierRow): Promise<void> {
+    const ok = await applyQualimatSelection(row)
+    if (ok) {
+        toast.success({ title: t('transport.carriers.toast.integrateSuccess') })
+    }
+}
+
+async function onSubmitAddresses(): Promise<void> {
+    const ok = await submitAddress(err => toast.error({ title: t('transport.carriers.toast.error'), message: apiErrorMessage(err) }))
+    if (ok) toast.success({ title: t('transport.carriers.toast.addressSaved') })
+}
+async function onSubmitContacts(): Promise<void> {
+    const ok = await submitContacts(err => toast.error({ title: t('transport.carriers.toast.error'), message: apiErrorMessage(err) }))
+    if (ok) toast.success({ title: t('transport.carriers.toast.contactSaved') })
+}
+async function onSubmitPrices(): Promise<void> {
+    const ok = await submitPrices(err => toast.error({ title: t('transport.carriers.toast.error'), message: apiErrorMessage(err) }))
+    if (ok) toast.success({ title: t('transport.carriers.toast.priceSaved') })
+}
+
+// ── Suppression de bloc (modal de confirmation générique) ────────────────────
+const deleteConfirm = reactive({ open: false, action: null as null | (() => void) })
+
+function askRemoveContact(index: number): void {
+    deleteConfirm.action = () => { void removeContact(index) }
+    deleteConfirm.open = true
+}
+function askRemovePrice(index: number): void {
+    deleteConfirm.action = () => { void removePrice(index) }
+    deleteConfirm.open = true
+}
+function runDeleteConfirm(): void {
+    deleteConfirm.action?.()
+    deleteConfirm.action = null
+    deleteConfirm.open = false
+}
+
+function onAddressDegraded(): void {
+    toast.warning({ title: t('transport.carriers.toast.error'), message: t('transport.carriers.form.address.degraded') })
+}
+</script>

frontend/modules/transport/pages/carriers/[id]/index.vue

@@ -0,0 +1,506 @@
+<template>
+    <div>
+        <!-- En-tête : retour répertoire + nom + actions. -->
+        <div class="flex items-center gap-3 pt-11">
+            <MalioButtonIcon
+                icon="mdi:arrow-left-bold"
+                icon-size="24"
+                variant="ghost"
+                v-bind="{ ariaLabel: t('transport.carriers.consultation.back') }"
+                @click="goBack"
+            />
+            <h1 class="text-[30px] font-semibold text-m-primary">{{ headerTitle }}</h1>
+
+            <div class="ml-auto flex items-center gap-12">
+                <MalioButton
+                    v-if="canEdit"
+                    variant="secondary"
+                    icon-name="mdi:pencil-outline"
+                    icon-position="left"
+                    :label="t('transport.carriers.action.edit')"
+                    @click="goEdit"
+                />
+                <MalioButton
+                    v-if="showArchive"
+                    variant="secondary"
+                    icon-name="mdi:archive-arrow-down-outline"
+                    icon-position="left"
+                    :label="t('transport.carriers.action.archive')"
+                    @click="askToggleArchive"
+                />
+                <MalioButton
+                    v-if="showRestore"
+                    variant="secondary"
+                    icon-name="mdi:archive-arrow-up-outline"
+                    icon-position="left"
+                    :label="t('transport.carriers.action.restore')"
+                    @click="askToggleArchive"
+                />
+            </div>
+        </div>
+
+        <p v-if="loading" class="mt-12 text-center text-black/60">{{ t('transport.carriers.consultation.loading') }}</p>
+        <p v-else-if="error" class="mt-12 text-center text-m-danger">{{ t('transport.carriers.consultation.notFound') }}</p>
+
+        <template v-else-if="carrier">
+            <!-- ── Bloc principal (lecture seule) — même disposition que l'ajout ── -->
+            <div class="mt-[48px] grid grid-cols-3 xl:grid-cols-4 gap-x-[44px] gap-y-4">
+                <MalioInputText :model-value="main.name" :label="t('transport.carriers.form.main.name')" readonly />
+
+                <!-- Cas LIOT : seul le champ immatriculations. -->
+                <MalioInputText
+                    v-if="isLiot"
+                    :model-value="main.liotPlates"
+                    :label="t('transport.carriers.form.main.liotPlates')"
+                    readonly
+                />
+
+                <!-- Cas standard : certification + décharge (col 3 réservée) + affrètement (col 4). -->
+                <template v-if="!isLiot">
+                    <MalioInputText
+                        :model-value="certificationLabel"
+                        :label="t('transport.carriers.form.main.certificationType')"
+                        readonly
+                    />
+
+                    <!-- Colonne 3 réservée à la décharge (si AUTRE), sinon vide (xl). -->
+                    <MalioInputText
+                        v-if="main.certificationType === 'AUTRE'"
+                        :model-value="dischargeLabel"
+                        :label="t('transport.carriers.form.main.discharge')"
+                        readonly
+                    />
+                    <div v-else class="hidden xl:block"></div>
+
+                    <!-- Affréter : colonne 4, centré (h-12) comme à l'ajout. -->
+                    <div class="flex h-12 items-center">
+                        <MalioCheckbox
+                            id="carrier-view-chartered"
+                            :label="t('transport.carriers.form.main.isChartered')"
+                            :model-value="main.isChartered"
+                            readonly
+                            :reserve-message-space="false"
+                        />
+                    </div>
+
+                    <!-- Champs d'affrètement (ligne 2) si affrété. -->
+                    <template v-if="main.isChartered">
+                        <MalioInputText :model-value="indexationDisplay" :label="t('transport.carriers.form.main.indexationRate')" readonly />
+                        <!-- Contenant : radios désactivés (lecture seule), aligné sur l'ajout / la modif. -->
+                        <div>
+                            <div class="flex h-12 items-center gap-4">
+                                <MalioRadioButton
+                                    :model-value="main.containerType"
+                                    name="carrier-view-container"
+                                    value="BENNE"
+                                    :label="t('transport.carriers.containerType.BENNE')"
+                                    readonly
+                                    group-class="mt-0"
+                                />
+                                <MalioRadioButton
+                                    :model-value="main.containerType"
+                                    name="carrier-view-container"
+                                    value="FOND_MOUVANT"
+                                    :label="t('transport.carriers.containerType.FOND_MOUVANT')"
+                                    readonly
+                                    group-class="mt-0"
+                                />
+                            </div>
+                        </div>
+                        <MalioInputText :model-value="main.volumeM3" :label="t('transport.carriers.form.main.volumeM3')" readonly />
+                    </template>
+                </template>
+            </div>
+
+            <!-- ── Onglets (Adresses · Contacts · Prix) — ouvre sur Adresses ──── -->
+            <MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
+                <template #addresses>
+                    <div class="mt-12 flex flex-col gap-6">
+                        <!-- Adresse UNIQUE (ERP-172). -->
+                        <CarrierAddressBlock
+                            :model-value="address"
+                            :country-options="countryOptionsFor(address.country)"
+                            readonly
+                        />
+                    </div>
+                </template>
+
+                <template #contacts>
+                    <div class="mt-12 flex flex-col gap-6">
+                        <CarrierContactBlock
+                            v-for="(contact, index) in contacts"
+                            :key="index"
+                            :model-value="contact"
+                            readonly
+                        />
+                    </div>
+                </template>
+
+                <!-- Prix : tableau présentationnel regroupé par contenant + export. -->
+                <template #prices>
+                    <div class="mt-12 flex flex-col gap-6">
+                        <!-- Police / bordures / radius alignés sur MalioDataTable (header
+                             16px, corps 14px). 1re colonne « Contenant » : libellé du
+                             groupe (Fond Mouvant / Benne) fusionné en rowspan ; séparateur
+                             épais entre les deux groupes. -->
+                        <table class="w-full table-fixed border-separate border-spacing-0 overflow-hidden rounded-malio border border-black text-left text-black">
+                            <!-- Répartition (table-fixed) : « Type de transport » un peu plus
+                                 large ; Transporteurs et Adresse livraisons larges ; Forfait /
+                                 Tonne / Indexation / État réduits. -->
+                            <colgroup>
+                                <col class="w-[170px]" />
+                                <col class="w-[20%]" />
+                                <col class="w-[11%]" />
+                                <col class="w-[24%]" />
+                                <col class="w-[9%]" />
+                                <col class="w-[9%]" />
+                                <col class="w-[9%]" />
+                                <col class="w-[9%]" />
+                            </colgroup>
+                            <thead>
+                                <tr>
+                                    <!-- En-tête centré pour matcher les cellules fusionnées Benne / Fond mouvant. -->
+                                    <th class="border-b border-r border-black bg-m-surface px-3 py-3 text-center align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.group') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.carrier') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.aproOrSite') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.delivery') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.forfait') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.tonne') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.indexation') }}</th>
+                                    <th class="border-b border-black bg-m-surface px-3 py-3 align-middle text-[16px] font-semibold">{{ t('transport.carriers.consultation.price.state') }}</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <template v-for="(group, gi) in priceGroups" :key="group.label">
+                                    <tr
+                                        v-for="(row, i) in group.rows"
+                                        :key="`${gi}-${i}`"
+                                    >
+                                        <!-- Cellule de groupe fusionnée (rowspan), centrée verticalement ;
+                                             séparateur épais en bas entre les groupes (sauf dernier). -->
+                                        <td
+                                            v-if="i === 0"
+                                            :rowspan="group.rows.length"
+                                            class="border-r border-black px-3 text-center align-middle text-[14px] font-medium"
+                                            :class="groupBorder(gi)"
+                                        >
+                                            {{ group.label }}
+                                        </td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ headerTitle }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.apro }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.delivery }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.forfait }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.tonne }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.indexation }}</td>
+                                        <td class="px-3 py-4 text-[14px]" :class="dataBorder(group, i, gi)">{{ row.state }}</td>
+                                    </tr>
+                                </template>
+                                <tr v-if="!hasPrices">
+                                    <td colspan="8" class="px-3 py-4 text-center text-[14px] text-m-muted">
+                                        {{ t('transport.carriers.consultation.price.empty') }}
+                                    </td>
+                                </tr>
+                            </tbody>
+                        </table>
+
+                        <div v-if="hasPrices" class="flex justify-center">
+                            <MalioButton
+                                variant="primary"
+                                :label="t('transport.carriers.consultation.price.export')"
+                                :disabled="exporting"
+                                @click="exportPrices"
+                            />
+                        </div>
+                    </div>
+                </template>
+            </MalioTabList>
+        </template>
+
+        <!-- Modal de confirmation archivage / restauration. -->
+        <MalioModal v-model="confirmArchive.open" modal-class="max-w-md">
+            <template #header>
+                <h2 class="text-[24px] font-bold">{{ confirmArchive.title }}</h2>
+            </template>
+            <p>{{ confirmArchive.message }}</p>
+            <template #footer>
+                <MalioButton
+                    variant="secondary"
+                    button-class="flex-1"
+                    :label="t('transport.carriers.form.confirmDelete.cancel')"
+                    @click="confirmArchive.open = false"
+                />
+                <MalioButton
+                    variant="danger"
+                    button-class="flex-1"
+                    :label="confirmArchive.confirmLabel"
+                    @click="runToggleArchive"
+                />
+            </template>
+        </MalioModal>
+    </div>
+</template>
+
+<script setup lang="ts">
+import { computed, onMounted, reactive, ref } from 'vue'
+import CarrierAddressBlock from '~/modules/transport/components/CarrierAddressBlock.vue'
+import CarrierContactBlock from '~/modules/transport/components/CarrierContactBlock.vue'
+import { useCarrier } from '~/modules/transport/composables/useCarrier'
+import {
+    canEditCarrier,
+    labelOfRelation,
+    mapAddressToDraft,
+    mapContactToDraft,
+    mapMainToDraft,
+    showArchiveAction,
+    showRestoreAction,
+    type CarrierPriceRead,
+    type Relation,
+} from '~/modules/transport/utils/forms/carrierMappers'
+import { extractApiErrorMessage } from '~/shared/utils/api'
+
+interface SelectOption {
+    value: string
+    label: string
+}
+
+const { t } = useI18n()
+const route = useRoute()
+const router = useRouter()
+const toast = useToast()
+const api = useApi()
+const { can } = usePermissions()
+
+const carrierId = route.params.id as string
+const { carrier, loading, error, load, archive, restore } = useCarrier(carrierId)
+
+const isArchived = computed(() => carrier.value?.isArchived ?? false)
+const canEdit = computed(() => canEditCarrier(can))
+const showArchive = computed(() => showArchiveAction(can, isArchived.value))
+const showRestore = computed(() => showRestoreAction(can, isArchived.value))
+
+const headerTitle = computed(() => carrier.value?.name || t('transport.carriers.consultation.title'))
+useHead({ title: t('transport.carriers.consultation.title') })
+
+// ── Bloc principal mappé (lecture seule) ─────────────────────────────────────
+const main = computed(() => mapMainToDraft(carrier.value ?? { id: 0, '@id': '' }))
+const isLiot = computed(() => main.value.name.trim().toUpperCase() === 'LIOT')
+const certificationLabel = computed(() => main.value.certificationType
+    ? t(`transport.carriers.certification.${main.value.certificationType}`)
+    : '')
+// Indexation affichée avec le « % » (comme l'icône du champ amount de l'ajout).
+const indexationDisplay = computed(() => main.value.indexationRate ? `${main.value.indexationRate} %` : '')
+// Décharge : nom du fichier embarqué si présent (sinon vide ; la colonne reste réservée).
+const dischargeLabel = computed(() => {
+    const doc = carrier.value?.dischargeDocument
+    if (doc && typeof doc !== 'string') {
+        const meta = doc as Record<string, unknown>
+        return String(meta.originalFilename ?? meta.name ?? '')
+    }
+    return ''
+})
+
+// ── Onglets : Adresses · Contacts · Prix (ouvre sur Adresses, pas de Qualimat) ──
+const activeTab = ref('addresses')
+const TAB_ICONS: Record<string, string> = {
+    addresses: 'mdi:map-marker-outline',
+    contacts: 'mdi:account-box-plus-outline',
+    prices: 'mdi:payment',
+}
+const tabs = computed(() => ['addresses', 'contacts', 'prices'].map(key => ({
+    key,
+    label: t(`transport.carriers.tab.${key}`),
+    icon: TAB_ICONS[key],
+})))
+
+// Adresse UNIQUE (ERP-172) : un seul bloc en lecture seule (vide si pas d'adresse).
+const address = computed(() => carrier.value?.address
+    ? mapAddressToDraft(carrier.value.address)
+    : mapAddressToDraft({ id: 0, '@id': '' }))
+const contacts = computed(() => {
+    const list = (carrier.value?.contacts ?? []).map(mapContactToDraft)
+    return list.length > 0 ? list : [mapContactToDraft({ id: 0, '@id': '' })]
+})
+
+/** Pays : une seule option (valeur courante), suffisant pour l'affichage readonly. */
+function countryOptionsFor(country: string): SelectOption[] {
+    return country ? [{ value: country, label: country }] : []
+}
+
+// ── Tableau Prix consultation (regroupé par contenant Fond Mouvant / Benne) ───
+const PRICE_GROUP_ORDER = ['FOND_MOUVANT', 'BENNE'] as const
+
+interface PriceRowView {
+    apro: string
+    delivery: string
+    forfait: string
+    tonne: string
+    indexation: string
+    state: string
+}
+
+/** Groupe de prix d'un même contenant (Fond Mouvant / Benne) — cellule fusionnée. */
+interface PriceGroupView {
+    label: string
+    rows: PriceRowView[]
+}
+
+/** Formate un montant décimal en « 1 000,00 € » (chaîne vide si absent). */
+function formatAmount(value: string | null | undefined): string {
+    if (!value) {
+        return ''
+    }
+    const n = Number(value)
+    if (Number.isNaN(n)) {
+        return ''
+    }
+    return `${n.toLocaleString('fr-FR', { minimumFractionDigits: 2, maximumFractionDigits: 2 })} €`
+}
+
+/** Code du site = département (2 premiers chiffres du code postal, ex: 86 / 17 / 82). */
+function siteCode(relation: Relation): string {
+    if (!relation || typeof relation === 'string') {
+        return ''
+    }
+    const postalCode = relation.postalCode as string | undefined
+    return postalCode ? postalCode.slice(0, 2) : ''
+}
+
+/**
+ * Construit une ligne d'affichage depuis un prix embarqué (maquette Prix) :
+ *  - « Adresse sites » = le CODE du site (département, ex: 86 / 17 / 82) ;
+ *  - « Adresse livraisons » = l'adresse (voie) du client/fournisseur ;
+ *  - le prix tombe dans Forfait € OU Tonne € selon `pricingUnit`.
+ */
+function toPriceRow(price: CarrierPriceRead): PriceRowView {
+    const isClient = price.direction === 'CLIENT'
+    return {
+        apro: isClient ? siteCode(price.departureSite) : siteCode(price.deliverySite),
+        delivery: isClient ? labelOfRelation(price.clientDeliveryAddress) : labelOfRelation(price.supplierSupplyAddress),
+        forfait: price.pricingUnit === 'FORFAIT' ? formatAmount(price.price) : '',
+        tonne: price.pricingUnit === 'TONNE' ? formatAmount(price.price) : '',
+        // CarrierPrice n'a pas de taux d'indexation propre → on affiche celui du
+        // transporteur (formulaire principal). À faire évoluer si un taux par prix
+        // est requis (gap back).
+        indexation: main.value.indexationRate ? `${main.value.indexationRate} %` : '',
+        state: price.priceState ? t(`transport.carriers.form.price.state${stateSuffix(price.priceState)}`) : '',
+    }
+}
+
+/** EN_COURS → EnCours, VALIDE → Valide, NON_VALIDE → NonValide (clés i18n existantes). */
+function stateSuffix(state: string): string {
+    const map: Record<string, string> = { EN_COURS: 'EnCours', VALIDE: 'Valide', NON_VALIDE: 'NonValide' }
+    return map[state] ?? ''
+}
+
+// Prix regroupés par contenant (Fond Mouvant puis Benne) — une cellule fusionnée
+// par groupe (rowspan) à gauche, conformément à la maquette.
+const priceGroups = computed<PriceGroupView[]>(() => {
+    const list = carrier.value?.prices ?? []
+    return PRICE_GROUP_ORDER
+        .map(container => ({
+            label: t(`transport.carriers.containerType.${container}`),
+            rows: list.filter(p => p.containerType === container).map(toPriceRow),
+        }))
+        .filter(group => group.rows.length > 0)
+})
+
+const hasPrices = computed(() => priceGroups.value.length > 0)
+
+/**
+ * Bordure basse d'une cellule de données :
+ *  - ligne interne d'un groupe → fine grise ;
+ *  - dernière ligne d'un groupe NON final → épaisse noire (séparateur de groupe) ;
+ *  - dernière ligne du DERNIER groupe → aucune (le cadre du tableau s'en charge,
+ *    évite la double bordure tout en bas).
+ */
+function dataBorder(group: PriceGroupView, i: number, gi: number): string {
+    const isLastRow = i === group.rows.length - 1
+    const isLastGroup = gi === priceGroups.value.length - 1
+    if (!isLastRow) {
+        return 'border-b border-m-muted/30'
+    }
+    return isLastGroup ? '' : 'border-b-2 border-black'
+}
+
+/** Bordure basse de la cellule de groupe fusionnée (séparateur épais sauf dernier groupe). */
+function groupBorder(gi: number): string {
+    return gi === priceGroups.value.length - 1 ? '' : 'border-b-2 border-black'
+}
+
+// ── Export XLSX des prix ─────────────────────────────────────────────────────
+const exporting = ref(false)
+
+async function exportPrices(): Promise<void> {
+    if (exporting.value) return
+    exporting.value = true
+    try {
+        const blob = await api.get<Blob>(`/carriers/${carrierId}/prices/export.xlsx`, {}, {
+            responseType: 'blob',
+            toast: false,
+        } as unknown as Parameters<typeof api.get>[2])
+        triggerDownload(blob, `transporteur-${carrierId}-prix.xlsx`)
+    }
+    catch {
+        toast.error({ title: t('transport.carriers.toast.error'), message: t('transport.carriers.toast.exportError') })
+    }
+    finally {
+        exporting.value = false
+    }
+}
+
+function triggerDownload(blob: Blob, filename: string): void {
+    const url = URL.createObjectURL(blob)
+    const link = document.createElement('a')
+    link.href = url
+    link.download = filename
+    document.body.appendChild(link)
+    link.click()
+    link.remove()
+    URL.revokeObjectURL(url)
+}
+
+// ── Navigation / archivage ───────────────────────────────────────────────────
+function goBack(): void {
+    router.push('/carriers')
+}
+
+function goEdit(): void {
+    router.push(`/carriers/${carrierId}/edit`)
+}
+
+const confirmArchive = reactive({ open: false, title: '', message: '', confirmLabel: '' })
+
+function askToggleArchive(): void {
+    const archiving = !isArchived.value
+    confirmArchive.title = archiving ? t('transport.carriers.action.archive') : t('transport.carriers.action.restore')
+    confirmArchive.message = archiving
+        ? t('transport.carriers.consultation.confirmArchive.message')
+        : t('transport.carriers.consultation.confirmRestore.message')
+    confirmArchive.confirmLabel = archiving ? t('transport.carriers.action.archive') : t('transport.carriers.action.restore')
+    confirmArchive.open = true
+}
+
+async function runToggleArchive(): Promise<void> {
+    const archiving = !isArchived.value
+    confirmArchive.open = false
+    try {
+        await (archiving ? archive() : restore())
+        toast.success({
+            title: archiving
+                ? t('transport.carriers.toast.archiveSuccess')
+                : t('transport.carriers.toast.restoreSuccess'),
+        })
+    }
+    catch (err) {
+        // Surface le message back (ex. 409 « homonyme actif » à la restauration),
+        // propagé exprès par useCarrier ; fallback générique sinon.
+        const data = (err as { response?: { _data?: unknown } })?.response?._data
+        toast.error({
+            title: t('transport.carriers.toast.error'),
+            message: extractApiErrorMessage(data) || undefined,
+        })
+    }
+}
+
+onMounted(load)
+</script>

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

@@ -53,18 +53,20 @@
                 <!-- Colonne 3 RÉSERVÉE à la Décharge (RG-4.02 : visible et obligatoire
                      si certification AUTRE). Si elle n'apparaît pas, on garde la colonne
                      vide (xl) pour qu'« Affréter » reste en colonne 4 de la ligne 1.
-                     L'upload reel (File → IRI via useUpload) arrive a ERP-171. -->
-                <!-- TODO ERP-171 : brancher useUpload pour resoudre le File en IRI
-                     (main.dischargeDocumentIri). Le champ est deja visible/obligatoire. -->
+                     Upload DIFFÉRÉ (ERP-171) : le fichier choisi est mis en attente
+                     et envoyé seulement à la validation du formulaire. -->
                 <MalioInputUpload
                     v-if="showDischarge"
+                    :model-value="dischargeFileName"
                     :label="t('transport.carriers.form.main.discharge')"
                     accept="application/pdf,image/*"
                     :required="true"
-                    :readonly="mainLocked"
+                    :readonly="mainLocked || dischargeUploading"
                     :clearable="true"
                     :error="mainErrors.errors.dischargeDocument"
-                    @clear="main.dischargeDocumentIri = null"
+                    @update:model-value="(v: string) => dischargeFileName = v"
+                    @file-selected="selectDischarge"
+                    @clear="onClearDischarge"
                 />
                 <div v-else class="hidden xl:block"></div>
 
@@ -86,32 +88,55 @@
                      « Affreter ». La ligne 1 étant pleine (4 colonnes), ils démarrent
                      naturellement en colonne 1 de la ligne 2. -->
                 <template v-if="showCharteredFields">
-                    <MalioInputNumber
-                        v-model="main.indexationRate"
+                    <!-- Indexation : montant en % (icône à droite), plafonné à 100. La
+                         :key force le ré-affichage du champ contrôlé quand on plafonne
+                         (sinon le modelValue inchangé n'est pas re-synchronisé par Vue). -->
+                    <MalioInputAmount
+                        :key="indexationKey"
+                        :model-value="main.indexationRate"
                         :label="t('transport.carriers.form.main.indexationRate')"
+                        icon-name="mdi:percent"
+                        icon-position="right"
                         :required="true"
                         :readonly="mainLocked"
                         :error="mainErrors.errors.indexationRate"
+                        @update:model-value="onIndexationInput"
                     />
 
-                    <!-- Contenant : Benne / Fond mouvant (RG-4.03). -->
-                    <MalioSelect
-                        :model-value="main.containerType"
-                        :options="containerOptions"
-                        :label="t('transport.carriers.form.main.containerType')"
-                        empty-option-label=""
-                        :required="true"
-                        :readonly="mainLocked"
-                        :error="mainErrors.errors.containerType"
-                        @update:model-value="(v: string | number | null) => main.containerType = v === null ? null : String(v)"
-                    />
+                    <!-- Contenant : Benne / Fond mouvant en radios, centrés (h-12) comme
+                         à l'onglet Prix (Benne par défaut). -->
+                    <div>
+                        <div class="flex h-12 items-center gap-4">
+                            <MalioRadioButton
+                                :model-value="main.containerType"
+                                name="carrier-main-container"
+                                value="BENNE"
+                                :label="t('transport.carriers.containerType.BENNE')"
+                                :disabled="mainLocked"
+                                group-class="mt-0"
+                                @update:model-value="(v: string | number | boolean | null) => main.containerType = v === null ? null : String(v)"
+                            />
+                            <MalioRadioButton
+                                :model-value="main.containerType"
+                                name="carrier-main-container"
+                                value="FOND_MOUVANT"
+                                :label="t('transport.carriers.containerType.FOND_MOUVANT')"
+                                :disabled="mainLocked"
+                                group-class="mt-0"
+                                @update:model-value="(v: string | number | boolean | null) => main.containerType = v === null ? null : String(v)"
+                            />
+                        </div>
+                        <p v-if="mainErrors.errors.containerType" class="ml-[2px] text-xs text-m-danger">{{ mainErrors.errors.containerType }}</p>
+                    </div>
 
-                    <MalioInputNumber
-                        v-model="main.volumeM3"
+                    <!-- Volume m³ : champ texte restreint aux nombres à décimales (point). -->
+                    <MalioInputText
+                        :model-value="main.volumeM3"
                         :label="t('transport.carriers.form.main.volumeM3')"
                         :required="true"
                         :readonly="mainLocked"
                         :error="mainErrors.errors.volumeM3"
+                        @update:model-value="(v: string) => main.volumeM3 = sanitizeDecimal(v)"
                     />
                 </template>
             </template>
@@ -131,72 +156,32 @@
              assistee (table de selection) ; Adresses / Contacts / Prix arrivent aux
              tickets suivants (placeholders « A venir »). -->
         <MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
-            <!-- Onglet Qualimat : datatable paginé filtré par le NOM du transporteur
-                 (pas de champ de recherche dédié — RG-4.01 / 4.04). -->
+            <!-- Onglet Qualimat : saisie assistée (recherche par nom). Composant
+                 mutualisé avec l'écran de modification (ERP-172). -->
             <template #qualimat>
-                <div class="mt-12 flex flex-col gap-6">
-                    <MalioDataTable
-                        :columns="qualimatColumns"
-                        :items="qualimatRows"
-                        :total-items="qualimatTotalDisplay"
-                        :page="qualimatPage"
-                        :per-page="qualimatPerPage"
-                        :per-page-options="qualimatPerPageOptions"
-                        row-clickable
-                        :empty-message="qualimatEmptyMessage"
-                        @row-click="onQualimatRowClick"
-                        @update:page="qualimatGoToPage"
-                        @update:per-page="qualimatSetPerPage"
-                    >
-                        <!-- Radio reflétant la ligne QUALIMAT intégrée (lecture). -->
-                        <template #cell-select="{ item }">
-                            <MalioRadioButton
-                                :model-value="main.qualimatCarrierIri"
-                                name="qualimat-row"
-                                :value="item.iri"
-                                group-class="mt-0"
-                            />
-                        </template>
-                        <!-- Date de validité : fond rouge si périmée (RG-4.04). -->
-                        <template #cell-validityDate="{ item }">
-                            <span
-                                v-if="item.validityDate"
-                                :class="isExpired(item.validityDate as string) ? 'inline-block rounded px-2 py-0.5 bg-m-danger text-white' : ''"
-                            >
-                                {{ formatDateFr(item.validityDate as string) }}
-                            </span>
-                        </template>
-                    </MalioDataTable>
-                </div>
+                <CarrierQualimatTab
+                    :search-name="main.name"
+                    :selected-iri="main.qualimatCarrierIri"
+                    @integrate="onIntegrateQualimat"
+                />
             </template>
 
             <!-- 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">
+                    <!-- Adresse UNIQUE (ERP-172) : un seul bloc, sans ajouter/supprimer. -->
                     <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)"
+                        :errors="addressErrors"
+                        @update:model-value="(v) => address = v"
                         @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')"
@@ -288,29 +273,7 @@
             </template>
         </MalioTabList>
 
-        <!-- Modal de confirmation d'integration QUALIMAT (RG-4.01). -->
-        <MalioModal v-model="confirmOpen" modal-class="max-w-md">
-            <template #header>
-                <h2 class="text-[24px] font-bold">{{ t('transport.carriers.form.qualimat.confirm.title') }}</h2>
-            </template>
-            <p>{{ t('transport.carriers.form.qualimat.confirm.message') }}</p>
-            <template #footer>
-                <MalioButton
-                    variant="secondary"
-                    button-class="flex-1"
-                    :label="t('transport.carriers.form.qualimat.confirm.cancel')"
-                    @click="confirmOpen = false"
-                />
-                <MalioButton
-                    variant="primary"
-                    button-class="flex-1"
-                    :label="t('transport.carriers.form.qualimat.confirm.confirm')"
-                    @click="confirmIntegrate"
-                />
-            </template>
-        </MalioModal>
-
-        <!-- Modal de confirmation de suppression (bloc adresse). -->
+        <!-- Modal de confirmation de suppression (bloc contact / prix). -->
         <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>
@@ -335,15 +298,16 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, reactive, ref, watch } from 'vue'
-import { debounce } from '~/shared/utils/debounce'
+import { computed, onMounted, reactive, ref } from 'vue'
 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 CarrierPriceBlock from '~/modules/transport/components/CarrierPriceBlock.vue'
+import CarrierQualimatTab from '~/modules/transport/components/CarrierQualimatTab.vue'
 import { useCarrierForm } from '~/modules/transport/composables/useCarrierForm'
-import { useQualimatSearch, type QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
+import type { QualimatCarrierRow } from '~/modules/transport/composables/useQualimatSearch'
+import { clampPercent, sanitizeDecimal } from '~/modules/transport/utils/forms/numberInput'
 
 interface SelectOption {
     value: string
@@ -371,6 +335,9 @@ const {
     mainSubmitting,
     tabSubmitting,
     mainErrors,
+    dischargeUploading,
+    selectDischarge,
+    clearDischarge,
     isLiot,
     isQualimat,
     certificationReadonly,
@@ -380,12 +347,9 @@ const {
     activeTab,
     unlockedIndex,
     isValidated,
-    addresses,
+    address,
     addressErrors,
-    canAddAddress,
-    addAddress,
-    removeAddress,
-    submitAddresses,
+    submitAddress,
     contacts,
     contactErrors,
     canAddContact,
@@ -402,16 +366,14 @@ const {
     applyQualimatSelection,
 } = useCarrierForm()
 
-const {
-    items: qualimatItems,
-    totalItems: qualimatTotal,
-    currentPage: qualimatPage,
-    itemsPerPage: qualimatPerPage,
-    itemsPerPageOptions: qualimatPerPageOptions,
-    goToPage: qualimatGoToPage,
-    setItemsPerPage: qualimatSetPerPage,
-    setFilters: qualimatSetFilters,
-} = useQualimatSearch()
+// Nom de fichier affiché dans le champ Décharge (alimenté à la sélection).
+const dischargeFileName = ref('')
+
+/** Vidage du champ Décharge : oublie le fichier en attente / l'IRI + le nom affiché. */
+function onClearDischarge(): void {
+    clearDischarge()
+    dischargeFileName.value = ''
+}
 
 // Certifications selectionnables manuellement (spec § Formulaire principal) :
 // GMP+ / OVOCOM / Compte-propre / Autre. QUALIMAT n'y figure PAS — il est posé par
@@ -431,55 +393,12 @@ const certificationOptions = computed<SelectOption[]>(() => {
     }))
 })
 
-// Colonnes du datatable de selection QUALIMAT (radio / Nom / Adresse / Validite).
-const qualimatColumns = [
-    { key: 'select', label: '' },
-    { key: 'name', label: t('transport.carriers.form.qualimat.columns.name') },
-    { key: 'address', label: t('transport.carriers.form.qualimat.columns.address') },
-    { key: 'validityDate', label: t('transport.carriers.form.qualimat.columns.validityDate') },
-]
-
-// Le datatable n'affiche QUE des résultats de recherche : vide tant que le Nom n'est
-// pas saisi (pas de liste complète par défaut). `main.name` pilote l'affichage.
-const hasQualimatSearch = computed(() => main.name.trim() !== '')
-
-// Lignes « plates » pour MalioDataTable (l'IRI sert au radio + à retrouver la ligne
-// source au clic). Le détail QUALIMAT complet reste dans `qualimatItems`.
-const qualimatRows = computed(() => {
-    if (!hasQualimatSearch.value) {
-        return []
-    }
-    return qualimatItems.value.map(row => ({
-        id: row.id,
-        iri: row['@id'],
-        name: row.name,
-        address: formatQualimatAddress(row),
-        validityDate: row.validityDate,
-    }))
-})
-
-// Total / message vide alignés sur « tableau vide tant qu'on n'a pas recherché ».
-const qualimatTotalDisplay = computed(() => (hasQualimatSearch.value ? qualimatTotal.value : 0))
-const qualimatEmptyMessage = computed(() => hasQualimatSearch.value
-    ? t('transport.carriers.form.qualimat.empty')
-    : t('transport.carriers.form.qualimat.searchHint'))
-
-// Contenant (RG-4.03) : Benne / Fond mouvant — select simple.
-const CONTAINER_TYPES = ['BENNE', 'FOND_MOUVANT'] as const
-
-const containerOptions = computed<SelectOption[]>(() =>
-    CONTAINER_TYPES.map(code => ({
-        value: code,
-        label: t(`transport.carriers.containerType.${code}`),
-    })),
-)
-
 // Icone (Iconify) affichee dans chaque onglet, par cle.
 const TAB_ICONS: Record<string, string> = {
-    qualimat: 'mdi:truck-check-outline',
+    qualimat: 'mdi:truck-fast-outline',
     addresses: 'mdi:map-marker-outline',
     contacts: 'mdi:account-box-plus-outline',
-    prices: 'mdi:currency-eur',
+    prices: 'mdi:payment',
 }
 
 // Onglets desactives tant que le formulaire principal n'est pas valide
@@ -577,7 +496,7 @@ function apiErrorMessage(error: unknown): string {
 
 /** 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({
+    const ok = await submitAddress(error => toast.error({
         title: t('transport.carriers.toast.error'),
         message: apiErrorMessage(error),
     }))
@@ -586,14 +505,9 @@ async function onSubmitAddresses(): Promise<void> {
     }
 }
 
-// Modal de confirmation de suppression (générique : bloc adresse OU contact).
+// Modal de confirmation de suppression (générique : bloc contact OU prix).
 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({
@@ -610,7 +524,10 @@ function askRemoveContact(index: number): void {
     deleteConfirm.open = true
 }
 
-/** Valide l'onglet Prix (POST/PATCH par ligne ; avance gérée par le composable). */
+/**
+ * Valide l'onglet Prix = DERNIER onglet du flux de création. Au succès, l'ajout est
+ * terminé : toast final + retour au répertoire transporteurs (aligné sur M1/M2/M3).
+ */
 async function onSubmitPrices(): Promise<void> {
     const ok = await submitPrices(error => toast.error({
         title: t('transport.carriers.toast.error'),
@@ -618,6 +535,7 @@ async function onSubmitPrices(): Promise<void> {
     }))
     if (ok) {
         toast.success({ title: t('transport.carriers.toast.priceSaved') })
+        await navigateTo('/carriers')
     }
 }
 
@@ -632,80 +550,28 @@ function runDeleteConfirm(): void {
     deleteConfirm.open = false
 }
 
-// ── Saisie assistee QUALIMAT (onglet Qualimat) ───────────────────────────────
-const confirmOpen = ref(false)
-const pendingRow = ref<QualimatCarrierRow | null>(null)
-
-// Le datatable QUALIMAT est filtré par le NOM saisi dans le formulaire principal
-// (RG-4.01) — pas de champ de recherche dédié. Aucune recherche tant que le Nom est
-// vide (tableau vide par défaut) ; sinon re-filtrage debouncé à chaque frappe.
-const filterQualimatByName = debounce((term: string) => {
-    if (term.trim() === '') {
-        return
-    }
-    void qualimatSetFilters({ search: term })
-}, 300)
-
-watch(() => main.name, term => filterQualimatByName(term))
-
-/** Adresse QUALIMAT condensee pour la colonne « Adresse » (voie · CP · ville). */
-function formatQualimatAddress(row: QualimatCarrierRow): string {
-    return [row.address, row.postalCode, row.city].filter(Boolean).join(' · ')
-}
-
-/** RG-4.04 : un agrement est perime si sa date de validite est < aujourd'hui. */
-function isExpired(value: string): boolean {
-    const date = new Date(value)
-    if (Number.isNaN(date.getTime())) {
-        return false
-    }
-    const today = new Date()
-    today.setHours(0, 0, 0, 0)
-    date.setHours(0, 0, 0, 0)
-    return date.getTime() < today.getTime()
-}
-
-/** Format court francais JJ-MM-AAAA (chaine vide si date absente / invalide). */
-function formatDateFr(value: string | null | undefined): string {
-    if (!value) {
-        return ''
-    }
-    const date = new Date(value)
-    if (Number.isNaN(date.getTime())) {
-        return ''
-    }
-    const day = String(date.getDate()).padStart(2, '0')
-    const month = String(date.getMonth() + 1).padStart(2, '0')
-    return `${day}-${month}-${date.getFullYear()}`
-}
-
-/** Clic sur une ligne du datatable → retrouve la ligne QUALIMAT source + modal. */
-function onQualimatRowClick(item: Record<string, unknown>): void {
-    const row = qualimatItems.value.find(r => r.id === item.id)
-    if (row) {
-        askIntegrate(row)
-    }
-}
-
-/** Ouvre la modal de confirmation d'integration pour une ligne QUALIMAT. */
-function askIntegrate(row: QualimatCarrierRow): void {
-    pendingRow.value = row
-    confirmOpen.value = true
-}
-
-/** Confirme l'integration : copie + PATCH (cf. useCarrierForm.applyQualimatSelection). */
-async function confirmIntegrate(): Promise<void> {
-    const row = pendingRow.value
-    confirmOpen.value = false
-    if (row === null) {
-        return
-    }
+/** Intégration d'une ligne QUALIMAT (émise par CarrierQualimatTab) : copie + PATCH
+ *  (cf. useCarrierForm.applyQualimatSelection). */
+async function onIntegrateQualimat(row: QualimatCarrierRow): Promise<void> {
     const ok = await applyQualimatSelection(row)
     if (ok) {
         toast.success({ title: t('transport.carriers.toast.integrateSuccess') })
     }
 }
 
+// Indexation plafonnée à 100 % : la clé force le ré-affichage du MalioInputAmount
+// (contrôlé) quand le plafonnement laisse le modelValue inchangé.
+const indexationKey = ref(0)
+
+/** Saisie de l'indexation : plafonne à 100 et re-synchronise le champ si plafonné. */
+function onIndexationInput(value: string): void {
+    const clamped = clampPercent(value)
+    main.indexationRate = clamped
+    if (clamped !== value) {
+        indexationKey.value += 1
+    }
+}
+
 /** Retour vers le repertoire transporteurs (fleche d'en-tete). */
 function goBack(): void {
     router.push('/carriers')
@@ -719,7 +585,7 @@ function goBack(): void {
 async function onSubmitMain(): Promise<void> {
     const ok = await submitMain()
     if (ok && isQualimat.value) {
-        await submitAddresses(error => toast.error({
+        await submitAddress(error => toast.error({
             title: t('transport.carriers.toast.error'),
             message: apiErrorMessage(error),
         }))

frontend/modules/transport/types/carrierForm.ts

@@ -40,7 +40,8 @@ export function emptyCarrierMain(): CarrierMainDraft {
         certificationType: null,
         isChartered: false,
         indexationRate: '',
-        containerType: null,
+        // Défaut métier : Benne pré-sélectionné (radio du formulaire principal).
+        containerType: 'BENNE',
         volumeM3: '',
         liotPlates: '',
         dischargeDocumentIri: null,

frontend/modules/transport/utils/forms/__tests__/carrierMappers.test.ts

@@ -0,0 +1,120 @@
+import { describe, it, expect } from 'vitest'
+import {
+    canEditCarrier,
+    iriOf,
+    labelOfRelation,
+    mapAddressToDraft,
+    mapContactToDraft,
+    mapMainToDraft,
+    mapPriceToDraft,
+    showArchiveAction,
+    showRestoreAction,
+    type CarrierDetail,
+} from '../carrierMappers'
+
+/**
+ * Tests des mappers détail → brouillons (M4 Transport, ERP-170) : peuplent les écrans
+ * Consultation / Modification depuis la SEULE réponse `GET /api/carriers/{id}`, et
+ * helpers de visibilité des boutons (Modifier / Archiver / Restaurer) selon la permission.
+ */
+describe('carrierMappers', () => {
+    it('iriOf : objet embarqué, IRI nu, ou null', () => {
+        expect(iriOf({ '@id': '/api/clients/3' })).toBe('/api/clients/3')
+        expect(iriOf('/api/sites/1')).toBe('/api/sites/1')
+        expect(iriOf(null)).toBeNull()
+        expect(iriOf(undefined)).toBeNull()
+    })
+
+    it('labelOfRelation : name (site) à défaut adresse condensée', () => {
+        expect(labelOfRelation({ '@id': '/api/sites/1', name: 'Châtellerault' })).toBe('Châtellerault')
+        expect(labelOfRelation({ '@id': '/api/client_addresses/8', street: '1 rue X', postalCode: '86000', city: 'Poitiers' })).toBe('1 rue X · 86000 · Poitiers')
+        expect(labelOfRelation('/api/sites/1')).toBe('')
+        expect(labelOfRelation(null)).toBe('')
+    })
+
+    it('mapMainToDraft : scalaires + IRI décharge / qualimat', () => {
+        const detail: CarrierDetail = {
+            '@id': '/api/carriers/7',
+            id: 7,
+            name: 'TRANSPORTS ACME',
+            certificationType: 'QUALIMAT',
+            isChartered: true,
+            indexationRate: '5.00',
+            containerType: 'BENNE',
+            volumeM3: '30.00',
+            dischargeDocument: { '@id': '/api/uploaded_documents/4' },
+            qualimatCarrier: { '@id': '/api/qualimat_carriers/42' },
+        }
+        expect(mapMainToDraft(detail)).toEqual({
+            name: 'TRANSPORTS ACME',
+            certificationType: 'QUALIMAT',
+            isChartered: true,
+            indexationRate: '5.00',
+            containerType: 'BENNE',
+            volumeM3: '30.00',
+            liotPlates: '',
+            dischargeDocumentIri: '/api/uploaded_documents/4',
+            qualimatCarrierIri: '/api/qualimat_carriers/42',
+        })
+    })
+
+    it('mapAddressToDraft : pays par défaut France si absent', () => {
+        expect(mapAddressToDraft({ '@id': '/api/carrier_addresses/3', id: 3, postalCode: '86000', city: 'Poitiers' }))
+            .toEqual({ id: 3, country: 'France', postalCode: '86000', city: 'Poitiers', street: null, streetComplement: null })
+    })
+
+    it('mapContactToDraft : hasSecondaryPhone vrai seulement si 2e numéro présent', () => {
+        const one = mapContactToDraft({ '@id': '/api/carrier_contacts/1', id: 1, firstName: 'Jean', phonePrimary: '0102030405' })
+        expect(one.hasSecondaryPhone).toBe(false)
+        expect(one.firstName).toBe('Jean')
+
+        const two = mapContactToDraft({ '@id': '/api/carrier_contacts/2', id: 2, phonePrimary: '0102030405', phoneSecondary: '0605040302' })
+        expect(two.hasSecondaryPhone).toBe(true)
+        expect(two.phoneSecondary).toBeTruthy()
+    })
+
+    it('mapPriceToDraft : direction + IRIs des relations de branche', () => {
+        const draft = mapPriceToDraft({
+            '@id': '/api/carrier_prices/5',
+            id: 5,
+            direction: 'CLIENT',
+            client: { '@id': '/api/clients/3' },
+            clientDeliveryAddress: { '@id': '/api/client_addresses/8' },
+            departureSite: '/api/sites/1',
+            containerType: 'BENNE',
+            pricingUnit: 'FORFAIT',
+            price: '120.00',
+            priceState: 'EN_COURS',
+        })
+        expect(draft).toMatchObject({
+            id: 5,
+            direction: 'CLIENT',
+            clientIri: '/api/clients/3',
+            clientDeliveryAddressIri: '/api/client_addresses/8',
+            departureSiteIri: '/api/sites/1',
+            supplierIri: null,
+            containerType: 'BENNE',
+            pricingUnit: 'FORFAIT',
+            price: '120.00',
+            priceState: 'EN_COURS',
+        })
+    })
+
+    it('visibilité des boutons selon la permission', () => {
+        const can = (granted: string[]) => (code: string) => granted.includes(code)
+
+        // Modifier : seulement avec manage.
+        expect(canEditCarrier(can(['transport.carriers.manage']))).toBe(true)
+        expect(canEditCarrier(can(['transport.carriers.view']))).toBe(false)
+
+        // Archiver : permission archive ET actif ; Restaurer : archive ET archivé.
+        const withArchive = can(['transport.carriers.archive'])
+        const noArchive = can(['transport.carriers.manage'])
+        expect(showArchiveAction(withArchive, false)).toBe(true)
+        expect(showArchiveAction(withArchive, true)).toBe(false)
+        expect(showRestoreAction(withArchive, true)).toBe(true)
+        expect(showRestoreAction(withArchive, false)).toBe(false)
+        expect(showArchiveAction(noArchive, false)).toBe(false)
+        expect(showRestoreAction(noArchive, true)).toBe(false)
+    })
+})

frontend/modules/transport/utils/forms/__tests__/numberInput.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest'
+import { clampPercent, sanitizeDecimal } from '../numberInput'
+
+describe('numberInput — saisie volume / indexation (ERP-170)', () => {
+    it('sanitizeDecimal : ne garde que chiffres + un seul point', () => {
+        expect(sanitizeDecimal('30')).toBe('30')
+        expect(sanitizeDecimal('30.5')).toBe('30.5')
+        expect(sanitizeDecimal('30,5 kg')).toBe('30.5') // virgule FR → point ; espace + lettres retirés
+        expect(sanitizeDecimal('1.2.3')).toBe('1.23') // un seul point conservé
+        expect(sanitizeDecimal('abc12.3x')).toBe('12.3')
+        expect(sanitizeDecimal('')).toBe('')
+    })
+
+    it('clampPercent : plafonne à 100, laisse le reste tel quel', () => {
+        expect(clampPercent('50')).toBe('50')
+        expect(clampPercent('100')).toBe('100')
+        expect(clampPercent('150')).toBe('100')
+        expect(clampPercent('100.01')).toBe('100')
+        expect(clampPercent('12,5')).toBe('12,5') // ≤ 100 → inchangé
+        expect(clampPercent('')).toBe('')
+    })
+})

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

@@ -8,18 +8,7 @@
 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
+ * Payload de la sous-ressource address (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).

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

@@ -0,0 +1,191 @@
+/**
+ * Helpers purs des écrans Consultation / Modification transporteur (M4, ERP-170) —
+ * miroir de `providerDetail.ts` (M3). Mappent le payload `GET /api/carriers/{id}`
+ * (relations embarquées via les groupes `carrier:item:read` + `qualimat:read` +
+ * read-groups cross-module client/supplier/site/adresses) vers les brouillons
+ * « plats » partagés avec les blocs Adresse / Contact / Prix.
+ *
+ * Ne touchent ni à l'API ni à l'état réactif (testables unitairement). Les champs
+ * nuls peuvent être OMIS (skip_null_values) → toujours lire avec `?? null`.
+ */
+
+import { formatPhoneFR } from '~/shared/utils/phone'
+import type {
+    CarrierAddressFormDraft,
+    CarrierContactFormDraft,
+    CarrierMainDraft,
+    CarrierPriceFormDraft,
+} from '~/modules/transport/types/carrierForm'
+
+/** Référence Hydra embarquée minimale (@id toujours présent). */
+export interface HydraRef {
+    '@id': string
+    [key: string]: unknown
+}
+
+/** Une relation peut être embarquée (objet), un IRI nu (chaîne) ou absente. */
+export type Relation = HydraRef | string | null | undefined
+
+/** Adresse embarquée (groupe carrier:item:read). */
+export interface CarrierAddressRead extends HydraRef {
+    id: number
+    country?: string | null
+    postalCode?: string | null
+    city?: string | null
+    street?: string | null
+    streetComplement?: string | null
+}
+
+/** Contact embarqué (groupe carrier:item:read). */
+export interface CarrierContactRead extends HydraRef {
+    id: number
+    firstName?: string | null
+    lastName?: string | null
+    jobTitle?: string | null
+    phonePrimary?: string | null
+    phoneSecondary?: string | null
+    email?: string | null
+}
+
+/** Prix embarqué (groupe carrier:item:read + relations cross-module). */
+export interface CarrierPriceRead extends HydraRef {
+    id: number
+    direction?: string | null
+    client?: Relation
+    clientDeliveryAddress?: Relation
+    departureSite?: Relation
+    supplier?: Relation
+    supplierSupplyAddress?: Relation
+    deliverySite?: Relation
+    containerType?: string | null
+    pricingUnit?: string | null
+    price?: string | null
+    priceState?: string | null
+}
+
+/**
+ * Détail d'un transporteur (`GET /api/carriers/{id}`). Tous les champs optionnels :
+ * skip_null_values peut omettre n'importe quelle clé.
+ */
+export interface CarrierDetail extends HydraRef {
+    id: number
+    name?: string | null
+    certificationType?: string | null
+    isChartered?: boolean
+    indexationRate?: string | null
+    containerType?: string | null
+    volumeM3?: string | null
+    liotPlates?: string | null
+    dischargeDocument?: Relation
+    qualimatCarrier?: Relation
+    isArchived?: boolean
+    // Adresse UNIQUE (OneToOne, ERP-172) : objet embarqué (ou absent), pas une liste.
+    address?: CarrierAddressRead | null
+    contacts?: CarrierContactRead[]
+    prices?: CarrierPriceRead[]
+}
+
+/** Extrait l'IRI d'une relation (objet embarqué, IRI nu, ou null si absente). */
+export function iriOf(relation: Relation): string | null {
+    if (relation === null || relation === undefined) {
+        return null
+    }
+    if (typeof relation === 'string') {
+        return relation
+    }
+    return relation['@id'] ?? null
+}
+
+/**
+ * Libellé d'affichage d'une relation embarquée : `name` (site) à défaut une adresse
+ * condensée (voie · CP · ville). Chaîne vide si la relation est un IRI nu / absente.
+ */
+export function labelOfRelation(relation: Relation): string {
+    if (!relation || typeof relation === 'string') {
+        return ''
+    }
+    const name = relation.name as string | undefined
+    if (name) {
+        return name
+    }
+    const parts = [relation.street, relation.postalCode, relation.city].filter(Boolean)
+    return parts.join(' · ')
+}
+
+/** Mappe le détail vers le brouillon du formulaire principal. */
+export function mapMainToDraft(detail: CarrierDetail): CarrierMainDraft {
+    return {
+        name: detail.name ?? '',
+        certificationType: detail.certificationType ?? null,
+        isChartered: detail.isChartered ?? false,
+        indexationRate: detail.indexationRate ?? '',
+        containerType: detail.containerType ?? null,
+        volumeM3: detail.volumeM3 ?? '',
+        liotPlates: detail.liotPlates ?? '',
+        dischargeDocumentIri: iriOf(detail.dischargeDocument),
+        qualimatCarrierIri: iriOf(detail.qualimatCarrier),
+    }
+}
+
+/** Mappe une adresse embarquée vers un brouillon. */
+export function mapAddressToDraft(address: CarrierAddressRead): CarrierAddressFormDraft {
+    return {
+        id: address.id,
+        country: address.country ?? 'France',
+        postalCode: address.postalCode ?? null,
+        city: address.city ?? null,
+        street: address.street ?? null,
+        streetComplement: address.streetComplement ?? null,
+    }
+}
+
+/** Mappe un contact embarqué vers un brouillon (téléphones formatés XX XX XX XX XX). */
+export function mapContactToDraft(contact: CarrierContactRead): CarrierContactFormDraft {
+    const secondary = contact.phoneSecondary ?? null
+    return {
+        id: contact.id,
+        firstName: contact.firstName ?? null,
+        lastName: contact.lastName ?? null,
+        jobTitle: contact.jobTitle ?? null,
+        phonePrimary: contact.phonePrimary ? formatPhoneFR(contact.phonePrimary) : null,
+        phoneSecondary: secondary ? formatPhoneFR(secondary) : null,
+        email: contact.email ?? null,
+        hasSecondaryPhone: secondary !== null && secondary !== '',
+    }
+}
+
+/** Mappe un prix embarqué vers un brouillon (relations en IRI). */
+export function mapPriceToDraft(price: CarrierPriceRead): CarrierPriceFormDraft {
+    const direction = price.direction === 'CLIENT' || price.direction === 'FOURNISSEUR'
+        ? price.direction
+        : null
+    return {
+        id: price.id,
+        direction,
+        clientIri: iriOf(price.client),
+        clientDeliveryAddressIri: iriOf(price.clientDeliveryAddress),
+        departureSiteIri: iriOf(price.departureSite),
+        supplierIri: iriOf(price.supplier),
+        supplierSupplyAddressIri: iriOf(price.supplierSupplyAddress),
+        deliverySiteIri: iriOf(price.deliverySite),
+        containerType: price.containerType ?? null,
+        pricingUnit: price.pricingUnit ?? null,
+        price: price.price ?? null,
+        priceState: price.priceState ?? null,
+    }
+}
+
+/** Bouton « Modifier » : visible avec la permission `manage` (Admin / Bureau). */
+export function canEditCarrier(can: (code: string) => boolean): boolean {
+    return can('transport.carriers.manage')
+}
+
+/** Bouton « Archiver » : permission archive ET transporteur encore actif (Admin seul). */
+export function showArchiveAction(can: (code: string) => boolean, isArchived: boolean): boolean {
+    return can('transport.carriers.archive') && !isArchived
+}
+
+/** Bouton « Restaurer » : permission archive ET transporteur déjà archivé (Admin seul). */
+export function showRestoreAction(can: (code: string) => boolean, isArchived: boolean): boolean {
+    return can('transport.carriers.archive') && isArchived
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Helpers de saisie numérique du formulaire principal transporteur (ERP-170).
+ * Champs texte restreints (volume m³ décimal, indexation plafonnée). Purs / testables.
+ */
+
+/**
+ * Restreint une saisie à un nombre décimal : chiffres + UN seul point (RG volume m³,
+ * « nombres avec des points » comme les autres modules). La virgule décimale FR est
+ * convertie en point (« 30,5 » → « 30.5 ») ; tout autre caractère est supprimé.
+ */
+export function sanitizeDecimal(value: string): string {
+    let cleaned = (value ?? '').replace(/,/g, '.').replace(/[^0-9.]/g, '')
+    const dot = cleaned.indexOf('.')
+    if (dot !== -1) {
+        // Conserve le 1er point, retire les suivants.
+        cleaned = cleaned.slice(0, dot + 1) + cleaned.slice(dot + 1).replace(/\./g, '')
+    }
+    return cleaned
+}
+
+/**
+ * Plafonne un pourcentage à 100 (contrainte FRONT : l'indexation n'a pas de max back).
+ * Renvoie « 100 » si la valeur saisie dépasse 100, sinon la valeur telle quelle.
+ */
+export function clampPercent(value: string): string {
+    const n = Number(String(value ?? '').replace(',', '.').replace(/\s/g, ''))
+    return (!Number.isNaN(n) && n > 100) ? '100' : value
+}

frontend/shared/composables/__tests__/useUpload.test.ts

@@ -0,0 +1,59 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+/**
+ * Tests du composable d'upload générique (ERP-171) :
+ *  - succès : POST multipart /uploaded_documents (champ « file »), toast désactivé,
+ *    renvoie l'IRI (@id) du document créé, `uploading` retombe à false ;
+ *  - erreur MIME hors whitelist → 422 : l'erreur est RELAYÉE à l'appelant (pour un
+ *    affichage inline sous le champ), `uploading` ré-armé via le finally.
+ */
+
+const mockPost = vi.hoisted(() => vi.fn())
+
+vi.stubGlobal('useApi', () => ({
+    get: vi.fn(),
+    post: mockPost,
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+}))
+
+const { useUpload } = await import('../useUpload')
+
+describe('useUpload', () => {
+    beforeEach(() => {
+        mockPost.mockReset()
+    })
+
+    it('succès : POST multipart champ « file » + toast:false → renvoie l\'IRI', async () => {
+        mockPost.mockResolvedValue({ '@id': '/api/uploaded_documents/9', originalFilename: 'decharge.pdf' })
+        const { upload, uploading } = useUpload()
+        const file = new File(['contenu'], 'decharge.pdf', { type: 'application/pdf' })
+
+        const iri = await upload(file)
+
+        expect(iri).toBe('/api/uploaded_documents/9')
+
+        const [url, body, options] = mockPost.mock.calls[0]
+        expect(url).toBe('/uploaded_documents')
+        expect(body).toBeInstanceOf(FormData)
+        const stored = (body as FormData).get('file')
+        expect(stored).toBeInstanceOf(File)
+        expect((stored as File).name).toBe('decharge.pdf')
+        expect(options).toMatchObject({ toast: false })
+
+        expect(uploading.value).toBe(false)
+    })
+
+    it('erreur MIME → 422 : l\'erreur est remontée à l\'appelant', async () => {
+        const error = Object.assign(new Error('422'), {
+            data: { 'hydra:description': 'Type de fichier non autorisé.' },
+        })
+        mockPost.mockRejectedValue(error)
+        const { upload, uploading } = useUpload()
+        const file = new File(['x'], 'malware.exe', { type: 'application/x-msdownload' })
+
+        await expect(upload(file)).rejects.toBe(error)
+        expect(uploading.value).toBe(false)
+    })
+})

frontend/shared/composables/useUpload.ts

@@ -0,0 +1,53 @@
+import { ref } from 'vue'
+import type { AnyObject } from '~/shared/composables/useApi'
+
+/**
+ * Réponse JSON-LD de POST /api/uploaded_documents (groupe `uploaded_document:read`).
+ * Seul l'IRI (`@id`) est exploité pour le poser sur la relation cible.
+ */
+export interface UploadedDocumentResponse {
+    '@id': string
+    originalFilename?: string
+    mimeType?: string
+}
+
+/**
+ * Upload d'un document générique vers l'infra partagée (ERP-154) :
+ * POST /api/uploaded_documents en multipart/form-data, champ « file », via
+ * `useApi()` (cookie JWT, parsing Hydra/erreurs). Renvoie l'IRI du document créé,
+ * à poser sur la relation cible (ex: `carrier.dischargeDocument` — RG-4.02).
+ *
+ * Les erreurs (MIME hors whitelist / fichier trop volumineux → 422) sont relayées
+ * (rethrow) à l'appelant pour un affichage inline sous le champ. `toast: false` par
+ * défaut : pas de toast fourre-tout, le formulaire mappe le message au bon champ.
+ */
+export function useUpload() {
+    // Indicateur d'upload en cours (désactivation UI / spinner éventuel).
+    const uploading = ref(false)
+
+    /**
+     * Envoie `file` et renvoie l'IRI du `UploadedDocument` créé.
+     * @throws relaie l'erreur réseau / 422 (MIME, taille) à l'appelant.
+     */
+    async function upload(file: File, options: { toast?: boolean } = {}): Promise<string> {
+        const formData = new FormData()
+        formData.append('file', file)
+
+        uploading.value = true
+        try {
+            // useApi() détecte le FormData et n'impose pas de Content-Type JSON :
+            // le navigateur pose lui-même la frontière multipart.
+            const doc = await useApi().post<UploadedDocumentResponse>(
+                '/uploaded_documents',
+                formData as unknown as AnyObject,
+                { toast: options.toast ?? false },
+            )
+
+            return doc['@id']
+        } finally {
+            uploading.value = false
+        }
+    }
+
+    return { uploading, upload }
+}

frontend/tests/e2e/_fixtures/personas.ts

@@ -103,6 +103,12 @@ export const personas: Record<PersonaKey, Persona> = {
             'transport.carriers.view',
             'transport.carriers.manage',
             'transport.carriers.archive',
+            // Logistique — Tickets de pesee (M5, ERP-181). Meme logique : mappe sur
+            // le persona "tout", pas de nouveau persona (regle ABSOLUE n°7).
+            // logistique.weighing_tickets.view n'ajoute pas de lien dans la section
+            // Administration, donc expectedAdminLinks reste inchange.
+            'logistique.weighing_tickets.view',
+            'logistique.weighing_tickets.manage',
         ],
         expectedAdminLinks: ['users', 'roles', 'sites', 'categories', 'audit-log'],
     },

migrations/Version20260617140000.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * ERP-172 — adresse UNIQUE par transporteur (decision metier : un transporteur a
+ * au plus une adresse). Bascule la relation carrier_address.carrier_id en OneToOne :
+ * remplace l'index simple idx_carrier_address_carrier par une contrainte d'unicite
+ * uniq_carrier_address_carrier. La garde applicative (CarrierAddressProcessor) renvoie
+ * un 409 explicite avant d'atteindre cette contrainte.
+ *
+ * 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 Version20260617140000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'ERP-172 : adresse unique par transporteur — index unique sur carrier_address.carrier_id (OneToOne).';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('DROP INDEX idx_carrier_address_carrier');
+        $this->addSql('CREATE UNIQUE INDEX uniq_carrier_address_carrier ON carrier_address (carrier_id)');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP INDEX uniq_carrier_address_carrier');
+        $this->addSql('CREATE INDEX idx_carrier_address_carrier ON carrier_address (carrier_id)');
+    }
+}

migrations/Version20260617160000.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * ERP-172 — nettoyage des reliquats du multi-adresses sur carrier_address, suite a
+ * la bascule en adresse UNIQUE (Version20260617140000). La colonne `position`
+ * servait a ordonner une LISTE d'adresses ; avec une seule adresse par transporteur
+ * (OneToOne) elle n'a plus de sens -> on la supprime. On reactualise aussi le
+ * COMMENT ON TABLE qui annoncait encore une relation 1:n.
+ *
+ * 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
+ * et apres la bascule OneToOne (cf. CLAUDE.md regle 11).
+ */
+final class Version20260617160000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'ERP-172 : retire la colonne carrier_address.position (relique multi-adresses) + COMMENT ON TABLE 1:1.';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE carrier_address DROP COLUMN position');
+        $this->addSql("COMMENT ON TABLE carrier_address IS 'Adresse d un transporteur (1:1, OneToOne — ERP-172 : adresse UNIQUE) — onglet Adresse (M4). Pre-remplie depuis QUALIMAT si applicable (RG-4.05).'");
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE carrier_address ADD COLUMN position INT DEFAULT 0 NOT NULL');
+        $this->addSql("COMMENT ON COLUMN carrier_address.position IS 'Ordre d affichage de l adresse dans la liste du transporteur (croissant).'");
+        $this->addSql("COMMENT ON TABLE carrier_address IS 'Adresses d un transporteur (1:n) — onglet Adresse (M4). Pre-remplie depuis QUALIMAT si applicable (RG-4.05).'");
+    }
+}

src/Module/Core/Application/Rbac/RbacSeeder.php

@@ -80,6 +80,9 @@ final class RbacSeeder
                 // Transporteurs (M4 § 5.2, ERP-153) : view + manage (PAS archive -> admin seul).
                 'transport.carriers.view',
                 'transport.carriers.manage',
+                // Tickets de pesee (M5 § 5.2, ERP-181) : view + manage (« Tout »).
+                'logistique.weighing_tickets.view',
+                'logistique.weighing_tickets.manage',
                 // Visibilite multi-site des prestataires (M3 § 2.13) : voit tous les sites.
                 'sites.bypass_scope',
                 // Lecture des referentiels transverses pour les selects client (ERP-102).
@@ -137,9 +140,14 @@ final class RbacSeeder
             'label' => 'Usine',
             // Prestataires (M3 § 2.9 + § 2.13, ERP-138) : view en lecture seule,
             // SANS `sites.bypass_scope` -> cloisonne aux prestataires de son site
-            // courant. Aucun autre acces metier.
+            // courant.
             'permissions' => [
                 'technique.providers.view',
+                // Tickets de pesee (M5 § 5.2, ERP-181) : view + manage. L'Usine
+                // pese sur site -> reste cloisonnee a son site courant (pas de
+                // bypass_scope ; les tickets sont filtres par SiteScopedQueryExtension).
+                'logistique.weighing_tickets.view',
+                'logistique.weighing_tickets.manage',
             ],
         ],
     ];

src/Module/Core/Infrastructure/Console/SeedE2ECommand.php

@@ -217,6 +217,10 @@ final class SeedE2ECommand extends Command
                     'transport.carriers.view',
                     'transport.carriers.manage',
                     'transport.carriers.archive',
+                    // Logistique — Tickets de pesee (M5, ERP-181). Meme logique :
+                    // mappe sur le persona "tout". Miroir de personas.ts.
+                    'logistique.weighing_tickets.view',
+                    'logistique.weighing_tickets.manage',
                 ],
             ],
             [

src/Module/Logistique/LogistiqueModule.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Logistique;
+
+final class LogistiqueModule
+{
+    public const string ID     = 'logistique';
+    public const string LABEL  = 'Logistique';
+    public const bool REQUIRED = false;
+
+    /**
+     * Liste declarative des permissions RBAC exposees par le module Logistique.
+     *
+     * Socle des tickets de pesee (M5 § 5.1, ERP-181) :
+     *  - `view`   : consultation de la liste / fiche d'un ticket de pesee ;
+     *  - `manage` : creation / modification d'un ticket de pesee.
+     *
+     * Consommee par `app:sync-permissions`. Matrice role -> permissions dans
+     * `RbacSeeder::MATRIX` (§ 5.2 : Bureau / Usine = view + manage ; Compta /
+     * Commerciale = aucun acces).
+     *
+     * @return array<int, array{code: string, label: string}>
+     */
+    public static function permissions(): array
+    {
+        return [
+            ['code' => 'logistique.weighing_tickets.view', 'label' => 'Voir les tickets de pesée'],
+            ['code' => 'logistique.weighing_tickets.manage', 'label' => 'Créer / modifier les tickets de pesée'],
+        ];
+    }
+}

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

@@ -81,6 +81,9 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
                 'supplier:read',
                 'supplier_address:read',
                 'site:read',
+                // Embarque le nom de fichier de la decharge (RG-4.02) au lieu d'un
+                // IRI nu, pour l'affichage en consultation / modification (ERP-171).
+                'uploaded_document:reference',
                 'default:read',
             ]],
             provider: CarrierProvider::class,
@@ -195,10 +198,13 @@ class Carrier implements TimestampableInterface, BlamableInterface
     #[Groups(['carrier:read', 'carrier:write:main'])]
     private ?string $liotPlates = null;
 
+    // === Adresse UNIQUE (OneToOne) — EMBARQUEE dans le DETAIL (read-group sur le getter) ===
+    // Metier : un transporteur a au plus UNE adresse (decision metier ERP-172). La
+    // FK porte un index UNIQUE (cote CarrierAddress.carrier en OneToOne owning side).
+    #[ORM\OneToOne(mappedBy: 'carrier', targetEntity: CarrierAddress::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
+    private ?CarrierAddress $address = null;
+
     // === Sous-collections — EMBARQUEES dans le DETAIL (read-group sur le getter) ===
-    /** @var Collection<int, CarrierAddress> */
-    #[ORM\OneToMany(mappedBy: 'carrier', targetEntity: CarrierAddress::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
-    private Collection $addresses;
 
     /** @var Collection<int, CarrierContact> */
     #[ORM\OneToMany(mappedBy: 'carrier', targetEntity: CarrierContact::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
@@ -225,9 +231,8 @@ class Carrier implements TimestampableInterface, BlamableInterface
 
     public function __construct()
     {
-        $this->addresses = new ArrayCollection();
-        $this->contacts  = new ArrayCollection();
-        $this->prices    = new ArrayCollection();
+        $this->contacts = new ArrayCollection();
+        $this->prices   = new ArrayCollection();
     }
 
     /**
@@ -406,32 +411,22 @@ class Carrier implements TimestampableInterface, BlamableInterface
         return $this;
     }
 
-    /** @return Collection<int, CarrierAddress> */
     #[Groups(['carrier:item:read'])]
-    public function getAddresses(): Collection
+    public function getAddress(): ?CarrierAddress
     {
-        return $this->addresses;
+        return $this->address;
     }
 
-    public function addAddress(CarrierAddress $address): static
+    public function setAddress(?CarrierAddress $address): static
     {
-        if (!$this->addresses->contains($address)) {
-            $this->addresses->add($address);
+        $this->address = $address;
+        if (null !== $address && $address->getCarrier() !== $this) {
             $address->setCarrier($this);
         }
 
         return $this;
     }
 
-    public function removeAddress(CarrierAddress $address): static
-    {
-        if ($this->addresses->removeElement($address) && $address->getCarrier() === $this) {
-            $address->setCarrier(null);
-        }
-
-        return $this;
-    }
-
     /** @return Collection<int, CarrierContact> */
     #[Groups(['carrier:item:read'])]
     public function getContacts(): Collection

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

@@ -20,9 +20,10 @@ use Symfony\Component\Serializer\Attribute\Groups;
 use Symfony\Component\Validator\Constraints as Assert;
 
 /**
- * Adresse d'un transporteur (1:n) — onglet Adresse (M4). Jumelle de
- * SupplierAddress (M2), version simplifiee (pas de type d'adresse, pas de M2M
- * sites/categories sur l'adresse : les sites du M4 vivent dans l'onglet Prix).
+ * Adresse d'un transporteur (1:1, OneToOne — decision metier ERP-172) — onglet
+ * Adresse (M4). Jumelle de SupplierAddress (M2), version simplifiee (pas de type
+ * d'adresse, pas de M2M sites/categories sur l'adresse : les sites du M4 vivent
+ * dans l'onglet Prix), et UNIQUE par transporteur (la jumelle M2 est 1:n).
  *
  * Lecture : proprietes en `carrier:item:read` (embarquees au detail du
  * transporteur). Ecriture : groupe `carrier:write:addresses`.
@@ -30,9 +31,10 @@ use Symfony\Component\Validator\Constraints as Assert;
  * Sous-ressource API (ERP-159, spec § 4.5) — jumelle de SupplierAddress (M2) /
  * ProviderAddress (M3), sans address_type ni M2M (les sites du M4 vivent dans
  * l'onglet Prix) :
- *  - POST /api/carriers/{carrierId}/addresses : creation rattachee au
+ *  - POST /api/carriers/{carrierId}/address : creation rattachee au
  *    transporteur parent (Link toProperty 'carrier'), security
- *    transport.carriers.manage.
+ *    transport.carriers.manage. 409 si le transporteur a deja une adresse
+ *    (CarrierAddressProcessor::guardSingleAddress, avant la contrainte d'unicite).
  *  - PATCH / DELETE /api/carrier_addresses/{id} : security
  *    transport.carriers.manage.
  *  - GET /api/carrier_addresses/{id} : lecture unitaire (security view) — la
@@ -58,14 +60,13 @@ use Symfony\Component\Validator\Constraints as Assert;
             normalizationContext: ['groups' => ['carrier:item:read', 'default:read']],
         ),
         new Post(
-            uriTemplate: '/carriers/{carrierId}/addresses',
+            uriTemplate: '/carriers/{carrierId}/address',
             uriVariables: [
                 'carrierId' => new Link(fromClass: Carrier::class, toProperty: 'carrier'),
             ],
-            // read:false : pas de stade lecture du parent. Le Link toProperty
-            // resoudrait l'enfant (SELECT CarrierAddress ... WHERE carrier = :id)
-            // et casse en NonUniqueResult des >= 2 enfants. Le parent est rattache
-            // manuellement par CarrierAddressProcessor::linkParent (404 si absent).
+            // read:false : pas de stade lecture du parent. Le parent est rattache
+            // manuellement par CarrierAddressProcessor::linkParent (404 si absent),
+            // qui refuse aussi une 2e adresse (RG metier : adresse UNIQUE — 409).
             read: false,
             security: "is_granted('transport.carriers.manage')",
             normalizationContext: ['groups' => ['carrier:item:read', 'default:read']],
@@ -86,7 +87,9 @@ use Symfony\Component\Validator\Constraints as Assert;
 )]
 #[ORM\Entity]
 #[ORM\Table(name: 'carrier_address')]
-#[ORM\Index(name: 'idx_carrier_address_carrier', columns: ['carrier_id'])]
+// Adresse UNIQUE par transporteur (OneToOne owning side) : contrainte d'unicite
+// sur carrier_id (decision metier ERP-172).
+#[ORM\UniqueConstraint(name: 'uniq_carrier_address_carrier', columns: ['carrier_id'])]
 #[ORM\Index(name: 'idx_carrier_address_created_by', columns: ['created_by'])]
 #[ORM\Index(name: 'idx_carrier_address_updated_by', columns: ['updated_by'])]
 #[Auditable]
@@ -100,7 +103,7 @@ class CarrierAddress implements TimestampableInterface, BlamableInterface
     #[Groups(['carrier:item:read'])]
     private ?int $id = null;
 
-    #[ORM\ManyToOne(targetEntity: Carrier::class, inversedBy: 'addresses')]
+    #[ORM\OneToOne(targetEntity: Carrier::class, inversedBy: 'address')]
     #[ORM\JoinColumn(name: 'carrier_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
     private ?Carrier $carrier = null;
 
@@ -133,9 +136,6 @@ class CarrierAddress implements TimestampableInterface, BlamableInterface
     #[Groups(['carrier:item:read', 'carrier:write:addresses'])]
     private ?string $streetComplement = null;
 
-    #[ORM\Column(options: ['default' => 0])]
-    private int $position = 0;
-
     public function getId(): ?int
     {
         return $this->id;
@@ -212,16 +212,4 @@ class CarrierAddress implements TimestampableInterface, BlamableInterface
 
         return $this;
     }
-
-    public function getPosition(): int
-    {
-        return $this->position;
-    }
-
-    public function setPosition(int $position): static
-    {
-        $this->position = $position;
-
-        return $this;
-    }
 }

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

@@ -6,12 +6,14 @@ namespace App\Module\Transport\Infrastructure\ApiPlatform\State\Processor;
 
 use ApiPlatform\Metadata\DeleteOperationInterface;
 use ApiPlatform\Metadata\Operation;
+use ApiPlatform\Metadata\Post;
 use ApiPlatform\State\ProcessorInterface;
 use ApiPlatform\Validator\Exception\ValidationException;
 use App\Module\Transport\Domain\Entity\Carrier;
 use App\Module\Transport\Domain\Entity\CarrierAddress;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
+use Symfony\Component\HttpKernel\Exception\ConflictHttpException;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use Symfony\Component\Validator\ConstraintViolation;
 use Symfony\Component\Validator\ConstraintViolationList;
@@ -63,6 +65,7 @@ final class CarrierAddressProcessor implements ProcessorInterface
         }
 
         $this->linkParent($data, $uriVariables);
+        $this->guardSingleAddress($data, $operation);
         $this->guardCharteredAddress($data);
 
         return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
@@ -70,7 +73,7 @@ final class CarrierAddressProcessor implements ProcessorInterface
 
     /**
      * Rattache l'adresse au transporteur parent de la sous-ressource POST
-     * (/carriers/{carrierId}/addresses) : la relation n'est pas peuplee
+     * (/carriers/{carrierId}/address) : la relation n'est pas peuplee
      * automatiquement par le Link sur une ecriture. Sur PATCH, no-op.
      */
     private function linkParent(CarrierAddress $address, array $uriVariables): void
@@ -98,6 +101,29 @@ final class CarrierAddressProcessor implements ProcessorInterface
         $address->setCarrier($carrier);
     }
 
+    /**
+     * Adresse UNIQUE par transporteur (decision metier ERP-172) : un POST sur un
+     * transporteur qui a deja une adresse -> 409 explicite (plutot qu'un 500 sur la
+     * contrainte d'unicite carrier_id). No-op sur PATCH (mise a jour de l'adresse
+     * existante). Lookup repository pour rester robuste a la synchro bidirectionnelle.
+     */
+    private function guardSingleAddress(CarrierAddress $address, Operation $operation): void
+    {
+        if (!$operation instanceof Post) {
+            return;
+        }
+
+        $carrier = $address->getCarrier();
+        if (!$carrier instanceof Carrier) {
+            return;
+        }
+
+        $existing = $this->em->getRepository(CarrierAddress::class)->findOneBy(['carrier' => $carrier]);
+        if (null !== $existing && $existing->getId() !== $address->getId()) {
+            throw new ConflictHttpException('Ce transporteur a déjà une adresse.');
+        }
+    }
+
     /**
      * RG-4.05 : si le transporteur parent est affrete (isChartered), l'adresse doit
      * porter Pays / Code postal / Ville / Adresse. Chaque champ manquant -> une

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

@@ -189,7 +189,8 @@ class CarrierFixtures extends Fixture implements DependentFixtureInterface
         $address->setPostalCode($postalCode);
         $address->setCity($city);
         $address->setStreet($street);
-        $carrier->addAddress($address);
+        // Adresse UNIQUE (OneToOne) — ERP-172.
+        $carrier->setAddress($address);
     }
 
     /**

src/Shared/Domain/Entity/UploadedDocument.php

@@ -75,8 +75,12 @@ class UploadedDocument
     #[Groups(['uploaded_document:read'])]
     private ?int $id = null;
 
+    // `uploaded_document:reference` : groupe minimal d'EMBARQUEMENT (nom de fichier
+    // seul, sans `storedPath`/`checksum`) pour qu'une entite parente (ex: Carrier)
+    // affiche le libelle du document au lieu d'un simple IRI. La parente l'ajoute a
+    // son `normalizationContext`.
     #[ORM\Column(name: 'original_filename', length: 255)]
-    #[Groups(['uploaded_document:read'])]
+    #[Groups(['uploaded_document:read', 'uploaded_document:reference'])]
     private string $originalFilename;
 
     #[ORM\Column(name: 'stored_path', length: 512)]

src/Shared/Infrastructure/Database/ColumnCommentsCatalog.php

@@ -497,15 +497,14 @@ final class ColumnCommentsCatalog
             ] + self::timestampableBlamableComments(),
 
             'carrier_address' => [
-                '_table'            => 'Adresses d un transporteur (1:n) — onglet Adresse (M4). Pre-remplie depuis QUALIMAT si applicable (RG-4.05).',
+                '_table'            => 'Adresse d un transporteur (1:1, OneToOne — ERP-172 : adresse UNIQUE) — onglet Adresse (M4). Pre-remplie depuis QUALIMAT si applicable (RG-4.05).',
                 'id'                => 'Identifiant interne auto-incremente.',
-                'carrier_id'        => 'FK -> carrier.id, ON DELETE CASCADE — transporteur proprietaire de l adresse.',
+                'carrier_id'        => 'FK -> carrier.id, ON DELETE CASCADE, UNIQUE (uniq_carrier_address_carrier) — transporteur proprietaire de l unique adresse.',
                 'country'           => 'Pays de l adresse — defaut France.',
                 'postal_code'       => 'Code postal (saisie assistee BAN cote front, RG-4.06).',
                 'city'              => 'Ville — preremplie depuis le code postal via API BAN cote front.',
                 'street'            => 'Numero et voie de l adresse.',
                 'street_complement' => 'Complement d adresse (etage, batiment...) — optionnel.',
-                'position'          => 'Ordre d affichage de l adresse dans la liste du transporteur (croissant).',
             ] + self::timestampableBlamableComments(),
 
             'carrier_contact' => [

tests/Module/Transport/Api/AbstractCarrierApiTestCase.php

@@ -149,7 +149,7 @@ abstract class AbstractCarrierApiTestCase extends AbstractApiTestCase
         $address->setPostalCode('86000');
         $address->setCity('Poitiers');
         $address->setStreet('12 rue des Acacias');
-        $carrier->addAddress($address);
+        $carrier->setAddress($address);
         $em->persist($address);
 
         $contact = new CarrierContact();

tests/Module/Transport/Api/CarrierAddressApiTest.php

@@ -13,7 +13,7 @@ use Symfony\Component\Console\Output\NullOutput;
 
 /**
  * Sous-ressource Adresse d'un transporteur (spec-back M4 § 4.5, ERP-159).
- * POST /api/carriers/{id}/addresses, PATCH/DELETE /api/carrier_addresses/{id}.
+ * POST /api/carriers/{id}/address, PATCH/DELETE /api/carrier_addresses/{id}.
  *
  * Contrat verifie :
  *  - RG-4.06 : code postal hors ^[0-9]{4,5}$ -> 422 ;
@@ -55,7 +55,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         $carrier = $this->seedCarrierWithChartered('Cp Invalide', false);
         $client  = $this->createAdminClient();
 
-        $response = $client->request('POST', '/api/carriers/'.$carrier->getId().'/addresses', [
+        $response = $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => ['postalCode' => '123'], // 3 chiffres -> Regex KO
         ]);
@@ -73,7 +73,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         $carrier = $this->seedCarrierWithChartered('Cp Ville Incoherents', false);
         $client  = $this->createAdminClient();
 
-        $client->request('POST', '/api/carriers/'.$carrier->getId().'/addresses', [
+        $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'postalCode' => '86000', // Poitiers
@@ -91,7 +91,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         $carrier = $this->seedCarrierWithChartered('Affrete Incomplet', true);
         $client  = $this->createAdminClient();
 
-        $response = $client->request('POST', '/api/carriers/'.$carrier->getId().'/addresses', [
+        $response = $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => ['postalCode' => '86000'],
         ]);
@@ -107,7 +107,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         $carrier = $this->seedCarrierWithChartered('Affrete Complet', true);
         $client  = $this->createAdminClient();
 
-        $client->request('POST', '/api/carriers/'.$carrier->getId().'/addresses', [
+        $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'country'    => 'France',
@@ -119,13 +119,30 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         self::assertResponseStatusCodeSame(201);
     }
 
+    public function testSecondAddressReturns409(): void
+    {
+        // Adresse UNIQUE (ERP-172) : un 2e POST sur un transporteur qui a deja une
+        // adresse -> 409 explicite (garde CarrierAddressProcessor avant la contrainte
+        // d'unicite carrier_id).
+        $address = $this->seedAddress('Deja Une Adresse', false);
+        $carrier = $address->getCarrier();
+        self::assertNotNull($carrier);
+
+        $client = $this->createAdminClient();
+        $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
+            'headers' => ['Content-Type' => self::LD],
+            'json'    => ['postalCode' => '17000', 'city' => 'La Rochelle', 'street' => '2 rue Neuve'],
+        ]);
+        self::assertResponseStatusCodeSame(409);
+    }
+
     public function testPostAddressOnUnknownCarrierReturns404(): void
     {
         // Sous-ressource en read:false : le parent introuvable n'est plus intercepte
         // en amont -> le processor doit lever un 404 explicite (sinon 500 au persist).
         $client = $this->createAdminClient();
 
-        $client->request('POST', '/api/carriers/999999/addresses', [
+        $client->request('POST', '/api/carriers/999999/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => ['postalCode' => '86000', 'city' => 'Poitiers', 'street' => '1 rue X'],
         ]);
@@ -156,7 +173,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         self::assertNotNull($carrier);
         $client = $this->authenticatedClient('commerciale', self::PWD); // view seul
 
-        $client->request('POST', '/api/carriers/'.$carrier->getId().'/addresses', [
+        $client->request('POST', '/api/carriers/'.$carrier->getId().'/address', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => ['postalCode' => '86000', 'city' => 'Poitiers', 'street' => '1 rue X'],
         ]);
@@ -201,7 +218,7 @@ final class CarrierAddressApiTest extends AbstractCarrierApiTestCase
         $address->setPostalCode('86000');
         $address->setCity('Poitiers');
         $address->setStreet('12 rue des Acacias');
-        $carrier->addAddress($address);
+        $carrier->setAddress($address);
         $em->persist($address);
         $em->flush();
 

tests/Module/Transport/Api/CarrierSerializationContractTest.php

@@ -4,9 +4,14 @@ declare(strict_types=1);
 
 namespace App\Tests\Module\Transport\Api;
 
+use App\Module\Transport\Domain\Entity\Carrier;
+use App\Shared\Domain\Entity\UploadedDocument;
+use App\Tests\Module\Commercial\Api\SupplierSerializationContractTest;
+use DateTimeImmutable;
+
 /**
  * Tests du CONTRAT DE SERIALISATION du repertoire transporteurs (M4, spec-back
- * § 4.0 / § 4.0.bis). Jumeau de {@see \App\Tests\Module\Commercial\Api\SupplierSerializationContractTest}.
+ * § 4.0 / § 4.0.bis). Jumeau de {@see SupplierSerializationContractTest}.
  * Reverifie sur le JSON REEL les pieges silencieux du M1 transposes au M4 :
  *  - #1/#2 : relations embarquees en OBJET (pas IRI nu) — qualimatCarrier, et au
  *            detail prices[].client / .supplier / .departureSite / .deliverySite.
@@ -88,8 +93,9 @@ final class CarrierSerializationContractTest extends AbstractCarrierApiTestCase
         self::assertArrayHasKey('isChartered', $data);
         self::assertFalse($data['isArchived']);
 
-        self::assertNotEmpty($data['addresses']);
-        self::assertSame('Poitiers', $data['addresses'][0]['city']);
+        // Adresse UNIQUE (OneToOne, ERP-172) : embarquee en OBJET (pas une liste).
+        self::assertIsArray($data['address']);
+        self::assertSame('Poitiers', $data['address']['city']);
 
         self::assertNotEmpty($data['contacts']);
         self::assertSame('Marie', $data['contacts'][0]['firstName']);
@@ -133,6 +139,43 @@ final class CarrierSerializationContractTest extends AbstractCarrierApiTestCase
         self::assertIsArray($supplierPrice['deliverySite']);
     }
 
+    // === Decharge (RG-4.02) embarquee en OBJET avec son nom de fichier (ERP-171) ===
+
+    public function testDetailEmbedsDischargeDocumentFilename(): void
+    {
+        $em = $this->getEm();
+
+        // Decharge (UploadedDocument) rattachee a un transporteur certifie AUTRE.
+        $document = new UploadedDocument(
+            originalFilename: 'decharge-test.pdf',
+            storedPath: '2026/06/'.bin2hex(random_bytes(8)).'.pdf',
+            mimeType: 'application/pdf',
+            sizeBytes: 1234,
+            checksum: hash('sha256', 'contenu'),
+            createdAt: new DateTimeImmutable(),
+        );
+        $em->persist($document);
+
+        $carrier = new Carrier();
+        $carrier->setName('AUTRE DISCHARGE CO');
+        $carrier->setCertificationType('AUTRE');
+        $carrier->setDischargeDocument($document);
+        $em->persist($carrier);
+        $em->flush();
+
+        $http = $this->createAdminClient();
+        $data = $http->request('GET', '/api/carriers/'.$carrier->getId(), ['headers' => ['Accept' => self::LD]])->toArray();
+
+        // dischargeDocument embarque en OBJET (uploaded_document:reference) avec son
+        // nom de fichier — sinon le front n'a qu'un IRI nu et affiche un champ vide.
+        self::assertArrayHasKey('dischargeDocument', $data);
+        self::assertIsArray($data['dischargeDocument'], 'dischargeDocument doit etre un objet embarque, pas un IRI nu.');
+        self::assertSame('decharge-test.pdf', $data['dischargeDocument']['originalFilename']);
+        // Le groupe minimal n'expose PAS les metadonnees internes (storedPath / checksum).
+        self::assertArrayNotHasKey('storedPath', $data['dischargeDocument']);
+        self::assertArrayNotHasKey('checksum', $data['dischargeDocument']);
+    }
+
     // === RBAC : 403 sans la permission view ===
 
     public function testForbiddenWithoutViewPermission(): void
@@ -167,7 +210,7 @@ final class CarrierSerializationContractTest extends AbstractCarrierApiTestCase
 
         self::assertArrayHasKey('member', $list);
         self::assertArrayHasKey('qualimatCarrier', $detail);
-        self::assertArrayHasKey('addresses', $detail);
+        self::assertArrayHasKey('address', $detail);
         self::assertArrayHasKey('contacts', $detail);
         self::assertArrayHasKey('prices', $detail);
 
@@ -183,7 +226,7 @@ final class CarrierSerializationContractTest extends AbstractCarrierApiTestCase
      *
      * @param array<string, mixed> $collection
      *
-     * @return array<string, mixed>|null
+     * @return null|array<string, mixed>
      */
     private function memberById(array $collection, int $id): ?array
     {