From 527e47d822cdc26f4222e601e33b244552b92fd7 Mon Sep 17 00:00:00 2001
From: tristan <tristan@yuno.malio.fr>
Date: Thu, 25 Jun 2026 14:09:33 +0200
Subject: [PATCH] =?UTF-8?q?fix(logistique)=20:=20bon=20de=20pes=C3=A9e=20?=
 =?UTF-8?q?=E2=80=94=20cartouche=20tiers=20+=20filtrage=20des=20listes=20c?=
 =?UTF-8?q?ontrepartie=20par=20site=20(ERP-208)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- PDF : cartouche bordé en haut à droite avec le type (Client/Fournisseur/Autre) et le nom du tiers (getCounterpartyName + getCounterpartyTypeLabel).
- Écran ticket : listes Client/Fournisseur filtrées sur le site courant (param siteId[]) et rechargées au changement de site ; reset du tiers sélectionné s'il sort du périmètre du nouveau site.
---
 .../2026-06-25-erp-208-fix-ticket-pesee.md    | 353 ++++++++++++++++++
 ...6-06-25-erp-208-fix-ticket-pesee-design.md | 124 ++++++
 .../useWeighingTicketReferentials.spec.ts     |  44 +++
 .../useWeighingTicketReferentials.ts          |  23 +-
 .../__tests__/weighingTicketEdit.spec.ts      |   2 +
 .../pages/__tests__/weighingTicketNew.spec.ts |  11 +-
 .../pages/weighing-tickets/[id]/edit.vue      |  25 +-
 .../logistique/pages/weighing-tickets/new.vue |  25 +-
 .../Domain/Entity/WeighingTicket.php          |  29 ++
 .../weighing_ticket_print.html.twig           |  36 +-
 .../WeighingTicketCounterpartyNameTest.php    |  59 +++
 11 files changed, 712 insertions(+), 19 deletions(-)
 create mode 100644 docs/superpowers/plans/2026-06-25-erp-208-fix-ticket-pesee.md
 create mode 100644 docs/superpowers/specs/2026-06-25-erp-208-fix-ticket-pesee-design.md
 create mode 100644 frontend/modules/logistique/composables/__tests__/useWeighingTicketReferentials.spec.ts
 create mode 100644 tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php

diff --git a/docs/superpowers/plans/2026-06-25-erp-208-fix-ticket-pesee.md b/docs/superpowers/plans/2026-06-25-erp-208-fix-ticket-pesee.md
new file mode 100644
index 0000000..a612126
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-25-erp-208-fix-ticket-pesee.md
@@ -0,0 +1,353 @@
+# ERP-208 — Fix ticket de pesée — Plan d'implémentation
+
+> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:subagent-driven-development ou superpowers:executing-plans. Étapes en cases à cocher (`- [ ]`).
+
+**Goal:** Ajouter le nom du tiers dans un cartouche bordé en haut à droite du bon de pesée PDF, et filtrer les listes Client/Fournisseur du formulaire de ticket sur le site courant (avec recharge au changement de site).
+
+**Architecture:** Le filtre back `?siteId[]=` existe déjà sur `/clients` et `/suppliers` (joint adresses→sites) → point 2 = front uniquement. Point 1 = une méthode entité `getCounterpartyName()` + refonte du header du template Twig en table 2 colonnes (Dompdf = CSS 2.1).
+
+**Tech Stack:** PHP 8.4 / Symfony / API Platform / Doctrine / Twig + Dompdf ; Nuxt 4 / Vue 3 / Vitest.
+
+## Global Constraints
+
+- `declare(strict_types=1);` en tête de tout fichier PHP.
+- Commentaires en **français**, code (noms) en anglais.
+- Front : `useApi()` uniquement, composants `Malio*`, 4 espaces, TS strict.
+- Dompdf : **CSS 2.1 uniquement** (pas de flex/grid) → mise en page par tableaux.
+- **Aucun commit sans demande explicite de Tristan** (les étapes « commit » sont différées en fin de chantier, sur demande).
+- Vérif finale : `make test` + `make nuxt-test` + `make php-cs-fixer-allow-risky`. Pas d'E2E.
+
+---
+
+### Task 1 : `WeighingTicket::getCounterpartyName()` (back)
+
+**Files:**
+- Modify: `src/Module/Logistique/Domain/Entity/WeighingTicket.php` (ajout méthode près de `getOtherLabel`, ~ligne 449)
+- Test: `tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php` (create)
+
+**Interfaces:**
+- Produces: `WeighingTicket::getCounterpartyName(): ?string` — companyName du client/fournisseur ou otherLabel selon `counterpartyType`, null sinon. Consommé par le template Twig (Task 2).
+
+- [ ] **Step 1 : test qui échoue**
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Module\Logistique\Domain;
+
+use App\Module\Commercial\Domain\Entity\Client;
+use App\Module\Commercial\Domain\Entity\Supplier;
+use App\Module\Logistique\Domain\Entity\WeighingTicket;
+use PHPUnit\Framework\TestCase;
+
+final class WeighingTicketCounterpartyNameTest extends TestCase
+{
+    public function testReturnsClientCompanyNameForClientCounterparty(): void
+    {
+        $client = (new Client())->setCompanyName('Ferme du Pré');
+        $ticket = (new WeighingTicket())->setCounterpartyType('CLIENT')->setClient($client);
+
+        self::assertSame('Ferme du Pré', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsSupplierCompanyNameForSupplierCounterparty(): void
+    {
+        $supplier = (new Supplier())->setCompanyName('Coop Sud');
+        $ticket = (new WeighingTicket())->setCounterpartyType('FOURNISSEUR')->setSupplier($supplier);
+
+        self::assertSame('Coop Sud', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsOtherLabelForOtherCounterparty(): void
+    {
+        $ticket = (new WeighingTicket())->setCounterpartyType('AUTRE')->setOtherLabel('Particulier');
+
+        self::assertSame('Particulier', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsNullWhenNoCounterparty(): void
+    {
+        self::assertNull((new WeighingTicket())->getCounterpartyName());
+    }
+}
+```
+
+- [ ] **Step 2 : lancer le test → échec**
+
+`make test` filtré : `docker exec php-starseed-fpm php bin/phpunit tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php`
+Attendu : FAIL (`getCounterpartyName` n'existe pas). Vérifier au passage que `Client`/`Supplier` ont bien un constructeur sans argument et `setCompanyName` (sinon adapter l'instanciation du test au pattern existant des entités).
+
+- [ ] **Step 3 : implémentation minimale**
+
+Dans `WeighingTicket.php`, après `getOtherLabel()`/`setOtherLabel()` :
+
+```php
+    /**
+     * Nom du tiers à afficher (bon de pesée PDF, ERP-208) : raison sociale du
+     * client/fournisseur ou libellé libre selon le type de contrepartie (RG-5.03).
+     * Null si aucune contrepartie cohérente (brouillon).
+     */
+    public function getCounterpartyName(): ?string
+    {
+        return match ($this->counterpartyType) {
+            'CLIENT' => $this->client?->getCompanyName(),
+            'FOURNISSEUR' => $this->supplier?->getCompanyName(),
+            'AUTRE' => $this->otherLabel,
+            default => null,
+        };
+    }
+```
+
+- [ ] **Step 4 : lancer le test → succès**
+
+`docker exec php-starseed-fpm php bin/phpunit tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php` → PASS.
+
+---
+
+### Task 2 : Cartouche tiers dans le template PDF
+
+**Files:**
+- Modify: `templates/logistique/weighing_ticket_print.html.twig`
+
+**Interfaces:**
+- Consumes: `ticket.counterpartyName` (Task 1).
+
+- [ ] **Step 1 : ajouter le style du cartouche + header 2 colonnes**
+
+Dans le `<style>`, ajouter :
+
+```css
+        .header { width: 100%; border-collapse: collapse; }
+        .header td { vertical-align: top; }
+        .header .h-right { text-align: right; }
+        .party-box { display: inline-block; border: 1px solid #000; padding: 8px 12px; min-width: 160px; text-align: center; font-weight: bold; font-size: 12px; }
+```
+
+- [ ] **Step 2 : remplacer le bloc logo + identité par une table 2 colonnes**
+
+Remplacer (logo + 3 lignes company) par :
+
+```twig
+    <table class="header">
+        <tr>
+            <td>
+                {% if logoSrc %}
+                    <div class="logo"><img src="{{ logoSrc }}" alt="LPC LIOT"></div>
+                {% endif %}
+                <div class="company-name">SA LIOT Châtellerault</div>
+                <div class="company-line">Email : lpc.contacts@lpc-liot.fr</div>
+                <div class="company-line">RCS Châtellerault B 339 505 612</div>
+            </td>
+            <td class="h-right">
+                {% if ticket.counterpartyName %}
+                    <div class="party-box">{{ ticket.counterpartyName }}</div>
+                {% endif %}
+            </td>
+        </tr>
+    </table>
+```
+
+(Le `.title` « Ticket de pesée » et la suite restent inchangés, sous la table.)
+
+- [ ] **Step 3 : vérifier le rendu PDF**
+
+Le test existant `WeighingTicketPrintApiTest` doit rester vert :
+`docker exec php-starseed-fpm php bin/phpunit tests/Module/Logistique/Api/WeighingTicketPrintApiTest.php` → PASS (`%PDF`, content-type, disposition inchangés).
+
+---
+
+### Task 3 : `useWeighingTicketReferentials.load(siteId?)` (front)
+
+**Files:**
+- Modify: `frontend/modules/logistique/composables/useWeighingTicketReferentials.ts`
+- Test: `frontend/modules/logistique/composables/__tests__/useWeighingTicketReferentials.spec.ts` (create)
+
+**Interfaces:**
+- Produces: `load(siteId?: number | null): Promise<void>` — passe `siteId[]=<siteId>` aux fetch `/clients` et `/suppliers` quand `siteId` est fourni ; sinon comportement actuel (liste complète).
+
+- [ ] **Step 1 : test qui échoue**
+
+```ts
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+
+const getMock = vi.fn()
+vi.stubGlobal('useApi', () => ({ get: getMock }))
+
+import { useWeighingTicketReferentials } from '~/modules/logistique/composables/useWeighingTicketReferentials'
+
+describe('useWeighingTicketReferentials', () => {
+    beforeEach(() => {
+        getMock.mockReset()
+        getMock.mockResolvedValue({ member: [] })
+    })
+
+    it('passe siteId[] aux deux endpoints quand un site est fourni', async () => {
+        const { load } = useWeighingTicketReferentials()
+        await load(7)
+
+        const clientsCall = getMock.mock.calls.find(c => c[0] === '/clients')
+        const suppliersCall = getMock.mock.calls.find(c => c[0] === '/suppliers')
+        expect(clientsCall?.[1]).toMatchObject({ pagination: 'false', 'siteId[]': [7] })
+        expect(suppliersCall?.[1]).toMatchObject({ pagination: 'false', 'siteId[]': [7] })
+    })
+
+    it('ne passe pas siteId[] quand aucun site (liste complète)', async () => {
+        const { load } = useWeighingTicketReferentials()
+        await load(null)
+
+        const clientsCall = getMock.mock.calls.find(c => c[0] === '/clients')
+        expect(clientsCall?.[1]).not.toHaveProperty('siteId[]')
+    })
+})
+```
+
+- [ ] **Step 2 : lancer → échec**
+
+`make nuxt-test` (ou ciblé) → FAIL (`load` n'accepte pas d'argument / `siteId[]` absent).
+
+- [ ] **Step 3 : implémentation**
+
+Modifier `fetchAll` et `load` :
+
+```ts
+    /** Récupère une collection complète (pagination désactivée) en Hydra, filtrée site si fourni. */
+    async function fetchAll(url: string, siteId?: number | null): Promise<PartyMember[]> {
+        const query: Record<string, unknown> = { pagination: 'false' }
+        // Filtre par site courant (ERP-208) : un tiers est rattaché à un site via
+        // les sites de ses adresses. Param `siteId[]` déjà géré par les providers M1/M2.
+        if (siteId !== null && siteId !== undefined) {
+            query['siteId[]'] = [siteId]
+        }
+        const res = await api.get<{ member?: PartyMember[] }>(
+            url,
+            query,
+            { headers: LD_JSON_HEADERS, toast: false },
+        )
+        return res.member ?? []
+    }
+
+    async function load(siteId?: number | null): Promise<void> {
+        await Promise.allSettled([
+            fetchAll('/clients', siteId).then((list) => {
+                clients.value = list.map(c => ({ value: c['@id'], label: c.companyName }))
+            }),
+            fetchAll('/suppliers', siteId).then((list) => {
+                suppliers.value = list.map(s => ({ value: s['@id'], label: s.companyName }))
+            }),
+        ])
+    }
+```
+
+- [ ] **Step 4 : lancer → succès**
+
+`make nuxt-test` ciblé sur le spec → PASS.
+
+---
+
+### Task 4 : Brancher site courant + recharge dans new.vue et edit.vue (front)
+
+**Files:**
+- Modify: `frontend/modules/logistique/pages/weighing-tickets/new.vue`
+- Modify: `frontend/modules/logistique/pages/weighing-tickets/[id]/edit.vue`
+- Test: `frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts` (étendre)
+
+**Interfaces:**
+- Consumes: `useCurrentSite().currentSite` (ref `Site | null`), `useWeighingTicketReferentials().load(siteId?)`, `form.clientIri` / `form.supplierIri` / `referentials.clients` / `referentials.suppliers`.
+
+- [ ] **Step 1 : helper de reset partagé**
+
+Logique commune aux deux pages : après recharge, vider le tiers sélectionné s'il n'est plus dans les options. Implémenté inline dans chaque page (2 lignes) — pas de nouveau composable pour si peu.
+
+- [ ] **Step 2 : new.vue — brancher currentSite + watch**
+
+Remplacer le bloc `onMounted` final :
+
+```ts
+const { currentSite } = useCurrentSite()
+
+/** Recharge les référentiels pour le site donné puis purge le tiers devenu hors-site (ERP-208). */
+async function reloadReferentials(siteId: number | null): Promise<void> {
+    await referentials.load(siteId)
+    if (form.clientIri.value && !referentials.clients.value.some(o => o.value === form.clientIri.value)) {
+        form.clientIri.value = null
+    }
+    if (form.supplierIri.value && !referentials.suppliers.value.some(o => o.value === form.supplierIri.value)) {
+        form.supplierIri.value = null
+    }
+}
+
+onMounted(() => {
+    reloadReferentials(currentSite.value?.id ?? null).catch(() => {})
+})
+
+// Changement de site pendant la saisie → recharge les listes du nouveau site (ERP-208).
+watch(() => currentSite.value?.id, (siteId) => {
+    reloadReferentials(siteId ?? null).catch(() => {})
+})
+```
+
+Ajouter `watch` à l'import `vue` et `useCurrentSite` (auto-importé Nuxt — sinon import explicite `~/modules/sites/composables/useCurrentSite`).
+
+- [ ] **Step 3 : edit.vue — même branchement**
+
+Adapter le `onMounted` async existant (qui fait aussi `fetchTicket`/`hydrate`) :
+
+```ts
+const { currentSite } = useCurrentSite()
+
+async function reloadReferentials(siteId: number | null): Promise<void> {
+    await referentials.load(siteId)
+    if (form.clientIri.value && !referentials.clients.value.some(o => o.value === form.clientIri.value)) {
+        form.clientIri.value = null
+    }
+    if (form.supplierIri.value && !referentials.suppliers.value.some(o => o.value === form.supplierIri.value)) {
+        form.supplierIri.value = null
+    }
+}
+
+onMounted(async () => {
+    reloadReferentials(currentSite.value?.id ?? null).catch(() => {})
+    try {
+        const detail = await fetchTicket(ticketId)
+        ticketNumber.value = detail.number ?? ''
+        form.hydrate(detail)
+    }
+    catch {
+        error.value = true
+    }
+    finally {
+        loading.value = false
+    }
+})
+
+watch(() => currentSite.value?.id, (siteId) => {
+    reloadReferentials(siteId ?? null).catch(() => {})
+})
+```
+
+- [ ] **Step 4 : étendre le spec front**
+
+Dans `weighingTicketNew.spec.ts`, ajouter un cas vérifiant que `load` est appelé avec l'id du site courant au montage (mock `useCurrentSite` retournant un `currentSite` avec `id`). Adapter au style de mock déjà en place dans le fichier.
+
+- [ ] **Step 5 : lancer les tests front**
+
+`make nuxt-test` → PASS (specs new/edit + referentials).
+
+---
+
+## Vérification finale
+
+- [ ] `make test` (back) — vert.
+- [ ] `make nuxt-test` (front) — vert.
+- [ ] `make php-cs-fixer-allow-risky` — pas de diff non voulu.
+- [ ] **STOP** : remettre la main à Tristan pour les tests manuels (impression PDF + switch de site). Commits différés jusqu'à sa demande.
+
+## Self-review (couverture spec)
+
+- Point 1 (cartouche PDF nom seul) → Task 1 + Task 2. ✓
+- Point 2 (filtre site + recharge au switch + reset-si-absent) → Task 3 + Task 4. ✓
+- Définition « lié au site » via adresses → param `siteId[]` (back déjà OK). ✓
+- Portée ticket-seulement (pas de modif répertoires) → on n'édite que le composable du ticket + ses pages. ✓
+- Pas de migration / RBAC / E2E. ✓
diff --git a/docs/superpowers/specs/2026-06-25-erp-208-fix-ticket-pesee-design.md b/docs/superpowers/specs/2026-06-25-erp-208-fix-ticket-pesee-design.md
new file mode 100644
index 0000000..6d6fbd8
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-25-erp-208-fix-ticket-pesee-design.md
@@ -0,0 +1,124 @@
+# ERP-208 — Fix ticket de pesée
+
+> Module : **Logistique (M5)** — écrans « Ajouter / Modifier un ticket de pesée » + bon de pesée imprimé (PDF).
+> Branche : `fix/erp-208-ticket-pesee`.
+> Date : 2026-06-25.
+
+## 1. Contexte
+
+Le ticket de pesée (M5) est implémenté (ERP-181 → ERP-193). Deux retours client sont
+regroupés dans ce fix :
+
+1. **Bon de pesée PDF** : il manque un **cartouche bordé en haut à droite** de la
+   page contenant le **nom du tiers** (client / fournisseur / champ « autre »). Le
+   PDF actuel n'affiche que l'identité société (SA LIOT) en haut à gauche.
+2. **Écran de saisie** : quand l'utilisateur a **plusieurs sites autorisés**, les
+   listes déroulantes Client / Fournisseur doivent être **filtrées sur le site
+   courant** (le tiers est rattaché à un site via les sites de ses adresses), et
+   **rechargées si l'utilisateur change de site** en restant sur la page.
+
+## 2. État du code existant (constats de cadrage)
+
+- **Le tiers n'a pas de site en propre.** Client (M1) et Supplier (M2) sont
+  rattachés à un site **via les sites de leurs adresses** (`getSites()` agrège ;
+  RG-2.06). « Lié au site » = a au moins une adresse rattachée à ce site.
+- **Le filtre back existe déjà.** `ClientProvider` / `SupplierProvider` lisent un
+  filtre répétable `?siteId[]=<id>` (drawers des répertoires M1/M2) et le délèguent
+  à `createListQueryBuilder(..., array $siteIds, ...)` → `applySiteIds()` qui joint
+  `addresses → sites` (`site3.id IN (:siteIds)` / `site4.id IN (:siteIds)`).
+  **Aucun travail back n'est nécessaire pour le filtre.**
+- **La donnée du PDF est déjà chargée.** `DoctrineWeighingTicketRepository::findById()`
+  fetch-joine `client` et `supplier` ; le `WeighingTicketPrintProvider` charge le
+  ticket par cette méthode. Le template a donc accès au nom du tiers.
+- **Le changement de site est global** (`SiteSelector` header → `useCurrentSite.switchSite`
+  → `PATCH /me/current-site` + `loadSidebar()` + `refreshNuxtData()`). `currentSite`
+  est un ref singleton de module. Les référentiels du ticket sont chargés en
+  `onMounted` **uniquement** (pas via `useAsyncData`) → ils ne se rechargent pas au
+  switch : **c'est le bug du point 2.**
+- Le template PDF (`templates/logistique/weighing_ticket_print.html.twig`) est rendu
+  par Dompdf → **CSS 2.1 uniquement (pas de flexbox/grid)**, mise en page par tableaux.
+
+## 3. Décisions (validées avec Tristan)
+
+| Sujet | Décision |
+|---|---|
+| Définition « lié au site » | Tiers ayant ≥ 1 adresse rattachée au site sélectionné (via les adresses). |
+| Portée du filtre | **Ticket de pesée seulement.** On ne modifie PAS le comportement des répertoires M1/M2 (déjà validés). On réutilise le param `?siteId[]=` existant côté front. |
+| Switch de site avec tiers sélectionné | **Reset si absent** : après rechargement, si le tiers sélectionné n'est plus dans la liste du nouveau site, on vide sa valeur (le type de contrepartie reste). S'il y est encore, on le garde. |
+| Contenu du cartouche PDF | **Nom seul** (pas de libellé « Client » / « Fournisseur » au-dessus). |
+
+## 4. Conception
+
+### 4.1 Point 1 — Cartouche tiers sur le bon de pesée (back + template)
+
+**a. Résolution du nom — `WeighingTicket::getCounterpartyName(): ?string`**
+
+Nouvelle méthode sur l'entité qui retourne, selon `counterpartyType` :
+- `CLIENT` → `client?->getCompanyName()`
+- `FOURNISSEUR` → `supplier?->getCompanyName()`
+- `AUTRE` → `otherLabel`
+- défaut → `null`
+
+Rationale : garde le Twig « bête » (un seul `{{ ticket.counterpartyName }}`) et rend
+la logique testable unitairement, sans toucher le provider ni le renderer.
+
+**b. Template `weighing_ticket_print.html.twig`**
+
+Passer le bloc d'en-tête en **table 2 colonnes** (contrainte Dompdf CSS 2.1) :
+- colonne gauche (`width:auto`, `vertical-align:top`) : logo + identité société
+  (contenu **inchangé**) ;
+- colonne droite (`text-align:right`, `vertical-align:top`) : un cartouche
+  `border:1px solid #000; padding:8px;` (largeur fixe, ~200px) contenant
+  `{{ ticket.counterpartyName }}` (nom seul, en gras).
+
+Le reste du template (titre, table des pesées, poids net) est inchangé.
+
+Cas `counterpartyName` null : en pratique l'impression a lieu après validation, où la
+contrepartie est requise (groupe `finalize`). Par robustesse, si null → ne pas rendre
+le cartouche (pas de cadre vide).
+
+**c. Provider / renderer** : aucun changement (relations déjà fetch-jointes).
+
+### 4.2 Point 2 — Listes filtrées par site + recharge au switch (front uniquement)
+
+**a. `useWeighingTicketReferentials.ts`**
+
+`load()` accepte un identifiant de site optionnel et l'injecte comme `siteId[]` dans
+les requêtes `/clients` et `/suppliers` (en plus de `pagination=false`) :
+- site fourni → `{ pagination: 'false', 'siteId[]': [siteId] }` ;
+- site absent (`null`) → comportement actuel (liste complète, dégradé gracieux).
+
+**b. Pages `weighing-tickets/new.vue` et `weighing-tickets/[id]/edit.vue`**
+
+- récupèrent `currentSite` via `useCurrentSite()` ;
+- `onMounted` → `referentials.load(currentSite.value?.id ?? null)` ;
+- `watch(currentSite)` (sur l'id) → `referentials.load(newId)` puis **reset-si-absent** :
+  - si `form.clientIri` est défini et absent de `referentials.clients` → `form.clientIri = null` ;
+  - si `form.supplierIri` est défini et absent de `referentials.suppliers` → `form.supplierIri = null` ;
+  - `counterpartyType` et `otherLabel` ne sont pas touchés.
+
+Note : le reset s'appuie sur les options (IRI `@id`) renvoyées par le référentiel ;
+la comparaison se fait sur `value` (l'IRI Hydra).
+
+**c. Cohérence avec la liste des tickets** : la liste `/weighing_tickets` est déjà
+cloisonnée par site (provider M5). Filtrer les selects sur le site courant aligne la
+saisie sur la liste.
+
+## 5. Tests & vérification
+
+| Niveau | Test | Contenu |
+|---|---|---|
+| Back (PHPUnit) | unitaire `WeighingTicket::getCounterpartyName()` | 3 cas : CLIENT → companyName, FOURNISSEUR → companyName, AUTRE → otherLabel ; + null si type absent. |
+| Back | `WeighingTicketPrintApiTest` (existant) | reste vert (`%PDF`, content-type, disposition). |
+| Front (Vitest) | `weighingTicketNew.spec.ts` / `weighingTicketEdit.spec.ts` | `load` passe `siteId[]` quand un site courant existe ; au changement de `currentSite` → rechargement + reset-si-absent du tiers sélectionné. |
+
+Commandes : `make test` + `make nuxt-test` + `make php-cs-fixer-allow-risky`.
+Pas de test E2E (règle d'or : Vitest privilégié).
+
+## 6. Hors périmètre / non-objectifs
+
+- Pas de modification du comportement des répertoires Clients / Fournisseurs (M1/M2).
+- Pas de nouvelle permission RBAC, pas de migration, pas de changement de schéma.
+- Pas de cloisonnement par site « global » sur `/clients` et `/suppliers` (rejeté :
+  on garde le filtre opt-in via `?siteId[]`).
+- L'identité société du PDF reste fixe (décision ERP-192, ne change pas selon le site).
diff --git a/frontend/modules/logistique/composables/__tests__/useWeighingTicketReferentials.spec.ts b/frontend/modules/logistique/composables/__tests__/useWeighingTicketReferentials.spec.ts
new file mode 100644
index 0000000..5f33167
--- /dev/null
+++ b/frontend/modules/logistique/composables/__tests__/useWeighingTicketReferentials.spec.ts
@@ -0,0 +1,44 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { useWeighingTicketReferentials } from '../useWeighingTicketReferentials'
+
+const mockApiGet = vi.hoisted(() => vi.fn())
+vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
+
+/**
+ * Tests des référentiels Client/Fournisseur de l'écran ticket de pesée (M5).
+ * Contrat couvert (ERP-208) : `load(siteId)` filtre les deux endpoints par site
+ * courant via `siteId[]` ; sans site → listes complètes (param absent).
+ */
+describe('useWeighingTicketReferentials', () => {
+    beforeEach(() => {
+        mockApiGet.mockReset()
+        mockApiGet.mockResolvedValue({ member: [] })
+    })
+
+    it('passe siteId[] aux deux endpoints quand un site courant est fourni', async () => {
+        const { load } = useWeighingTicketReferentials()
+        await load(7)
+
+        const clientsCall = mockApiGet.mock.calls.find(c => c[0] === '/clients')
+        const suppliersCall = mockApiGet.mock.calls.find(c => c[0] === '/suppliers')
+        expect(clientsCall?.[1]).toMatchObject({ pagination: 'false', 'siteId[]': [7] })
+        expect(suppliersCall?.[1]).toMatchObject({ pagination: 'false', 'siteId[]': [7] })
+    })
+
+    it('ne passe pas siteId[] quand aucun site (liste complète)', async () => {
+        const { load } = useWeighingTicketReferentials()
+        await load(null)
+
+        const clientsCall = mockApiGet.mock.calls.find(c => c[0] === '/clients')
+        expect(clientsCall?.[1]).not.toHaveProperty('siteId[]')
+        expect(clientsCall?.[1]).toMatchObject({ pagination: 'false' })
+    })
+
+    it('mappe les membres Hydra en options { value: @id, label: companyName }', async () => {
+        mockApiGet.mockResolvedValue({ member: [{ '@id': '/api/clients/3', companyName: 'ACME' }] })
+        const { load, clients } = useWeighingTicketReferentials()
+        await load(7)
+
+        expect(clients.value).toEqual([{ value: '/api/clients/3', label: 'ACME' }])
+    })
+})
diff --git a/frontend/modules/logistique/composables/useWeighingTicketReferentials.ts b/frontend/modules/logistique/composables/useWeighingTicketReferentials.ts
index 15c592e..06c4d6f 100644
--- a/frontend/modules/logistique/composables/useWeighingTicketReferentials.ts
+++ b/frontend/modules/logistique/composables/useWeighingTicketReferentials.ts
@@ -32,11 +32,19 @@ export function useWeighingTicketReferentials() {
     const clients = ref<RefOption[]>([])
     const suppliers = ref<RefOption[]>([])
 
-    /** Récupère une collection complète (pagination désactivée) en Hydra. */
-    async function fetchAll(url: string): Promise<PartyMember[]> {
+    /**
+     * Récupère une collection complète (pagination désactivée) en Hydra. Filtre par
+     * site courant si `siteId` est fourni (ERP-208) : un tiers est rattaché à un site
+     * via les sites de ses adresses — param `siteId[]` déjà géré par les providers M1/M2.
+     */
+    async function fetchAll(url: string, siteId?: number | null): Promise<PartyMember[]> {
+        const query: Record<string, unknown> = { pagination: 'false' }
+        if (siteId !== null && siteId !== undefined) {
+            query['siteId[]'] = [siteId]
+        }
         const res = await api.get<{ member?: PartyMember[] }>(
             url,
-            { pagination: 'false' },
+            query,
             { headers: LD_JSON_HEADERS, toast: false },
         )
         return res.member ?? []
@@ -45,14 +53,15 @@ export function useWeighingTicketReferentials() {
     /**
      * Charge en parallèle clients + fournisseurs (résilient : un référentiel en
      * échec — ex. 403 selon le rôle — laisse simplement son select vide sans
-     * faire échouer l'autre).
+     * faire échouer l'autre). `siteId` (site courant) filtre les listes par site
+     * (ERP-208) ; absent → listes complètes.
      */
-    async function load(): Promise<void> {
+    async function load(siteId?: number | null): Promise<void> {
         await Promise.allSettled([
-            fetchAll('/clients').then((list) => {
+            fetchAll('/clients', siteId).then((list) => {
                 clients.value = list.map(c => ({ value: c['@id'], label: c.companyName }))
             }),
-            fetchAll('/suppliers').then((list) => {
+            fetchAll('/suppliers', siteId).then((list) => {
                 suppliers.value = list.map(s => ({ value: s['@id'], label: s.companyName }))
             }),
         ])
diff --git a/frontend/modules/logistique/pages/__tests__/weighingTicketEdit.spec.ts b/frontend/modules/logistique/pages/__tests__/weighingTicketEdit.spec.ts
index 62e10d5..c807609 100644
--- a/frontend/modules/logistique/pages/__tests__/weighingTicketEdit.spec.ts
+++ b/frontend/modules/logistique/pages/__tests__/weighingTicketEdit.spec.ts
@@ -28,6 +28,8 @@ vi.stubGlobal('useRouter', () => ({ push: mockPush }))
 vi.stubGlobal('usePermissions', () => ({ can: () => true }))
 vi.stubGlobal('navigateTo', vi.fn())
 vi.stubGlobal('useFormErrors', () => ({ errors: reactive({}), setError: vi.fn(), clearErrors: vi.fn(), handleApiError: vi.fn() }))
+// Site courant (ERP-208) : nécessaire depuis que l'écran filtre les référentiels par site.
+vi.stubGlobal('useCurrentSite', () => ({ currentSite: ref({ id: 7, name: 'Site 7', color: '#000000' }) }))
 globalThis.open = mockOpen
 
 const EditPage = (await import('../weighing-tickets/[id]/edit.vue')).default
diff --git a/frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts b/frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts
index ca5bccb..c2b2abb 100644
--- a/frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts
+++ b/frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts
@@ -7,9 +7,10 @@ const mockPost = vi.hoisted(() => vi.fn())
 const mockPatch = vi.hoisted(() => vi.fn())
 const mockPush = vi.hoisted(() => vi.fn())
 const mockOpen = vi.hoisted(() => vi.fn())
+const mockRefLoad = vi.hoisted(() => vi.fn())
 
 vi.mock('~/modules/logistique/composables/useWeighingTicketReferentials', () => ({
-    useWeighingTicketReferentials: () => ({ clients: ref([]), suppliers: ref([]), load: vi.fn().mockResolvedValue(undefined) }),
+    useWeighingTicketReferentials: () => ({ clients: ref([]), suppliers: ref([]), load: mockRefLoad }),
 }))
 vi.mock('~/modules/logistique/composables/useWeighbridge', () => ({
     useWeighbridge: () => ({ triggerAuto: vi.fn(), triggerManual: vi.fn(), extractWeighbridgeError: () => 'err' }),
@@ -23,6 +24,8 @@ vi.stubGlobal('useRouter', () => ({ push: mockPush }))
 vi.stubGlobal('usePermissions', () => ({ can: () => true }))
 vi.stubGlobal('navigateTo', vi.fn())
 vi.stubGlobal('useFormErrors', () => ({ errors: reactive({}), setError: vi.fn(), clearErrors: vi.fn(), handleApiError: vi.fn() }))
+// Site courant (ERP-208) : id 7 → les référentiels doivent être chargés filtrés sur ce site.
+vi.stubGlobal('useCurrentSite', () => ({ currentSite: ref({ id: 7, name: 'Site 7', color: '#000000' }) }))
 globalThis.open = mockOpen
 
 const NewPage = (await import('../weighing-tickets/new.vue')).default
@@ -70,6 +73,12 @@ describe('Écran Ajouter ticket de pesée (page /weighing-tickets/new)', () => {
         mockPatch.mockReset().mockResolvedValue({})
         mockPush.mockReset()
         mockOpen.mockReset()
+        mockRefLoad.mockReset().mockResolvedValue(undefined)
+    })
+
+    it('charge les référentiels filtrés sur le site courant au montage (ERP-208)', async () => {
+        await mountPage()
+        expect(mockRefLoad).toHaveBeenCalledWith(7)
     })
 
     it('un seul bouton « Valider » (pas de « Enregistrer » séparé)', async () => {
diff --git a/frontend/modules/logistique/pages/weighing-tickets/[id]/edit.vue b/frontend/modules/logistique/pages/weighing-tickets/[id]/edit.vue
index 4686a8d..9b1d233 100644
--- a/frontend/modules/logistique/pages/weighing-tickets/[id]/edit.vue
+++ b/frontend/modules/logistique/pages/weighing-tickets/[id]/edit.vue
@@ -186,7 +186,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, reactive, ref } from 'vue'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
 import { useWeighingTicketForm, type WeighingBlockState } from '~/modules/logistique/composables/useWeighingTicketForm'
 import { useWeighbridge } from '~/modules/logistique/composables/useWeighbridge'
 import { useWeighingTicket } from '~/modules/logistique/composables/useWeighingTicket'
@@ -404,8 +404,24 @@ function printTicket(): void {
     window.open(`/api/weighing_tickets/${ticketId}/print.pdf`, '_blank')
 }
 
+const { currentSite } = useCurrentSite()
+
+/**
+ * Recharge les référentiels Client/Fournisseur pour le site donné, puis purge le
+ * tiers sélectionné s'il n'appartient plus à la liste du nouveau site (ERP-208).
+ */
+async function reloadReferentials(siteId: number | null): Promise<void> {
+    await referentials.load(siteId)
+    if (form.clientIri.value && !referentials.clients.value.some(o => o.value === form.clientIri.value)) {
+        form.clientIri.value = null
+    }
+    if (form.supplierIri.value && !referentials.suppliers.value.some(o => o.value === form.supplierIri.value)) {
+        form.supplierIri.value = null
+    }
+}
+
 onMounted(async () => {
-    referentials.load().catch(() => {})
+    reloadReferentials(currentSite.value?.id ?? null).catch(() => {})
     try {
         const detail = await fetchTicket(ticketId)
         ticketNumber.value = detail.number ?? ''
@@ -418,4 +434,9 @@ onMounted(async () => {
         loading.value = false
     }
 })
+
+// Changement de site pendant l'édition → recharge les listes du nouveau site (ERP-208).
+watch(() => currentSite.value?.id, (siteId) => {
+    reloadReferentials(siteId ?? null).catch(() => {})
+})
 </script>
diff --git a/frontend/modules/logistique/pages/weighing-tickets/new.vue b/frontend/modules/logistique/pages/weighing-tickets/new.vue
index 73bb45c..780eaa6 100644
--- a/frontend/modules/logistique/pages/weighing-tickets/new.vue
+++ b/frontend/modules/logistique/pages/weighing-tickets/new.vue
@@ -176,7 +176,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, reactive, ref } from 'vue'
+import { computed, onMounted, reactive, ref, watch } from 'vue'
 import { useWeighingTicketForm, type WeighingBlockState } from '~/modules/logistique/composables/useWeighingTicketForm'
 import { useWeighbridge } from '~/modules/logistique/composables/useWeighbridge'
 import { useWeighingTicketReferentials, type RefOption } from '~/modules/logistique/composables/useWeighingTicketReferentials'
@@ -375,7 +375,28 @@ async function submitValidate(): Promise<void> {
     }
 }
 
+const { currentSite } = useCurrentSite()
+
+/**
+ * Recharge les référentiels Client/Fournisseur pour le site donné, puis purge le
+ * tiers sélectionné s'il n'appartient plus à la liste du nouveau site (ERP-208).
+ */
+async function reloadReferentials(siteId: number | null): Promise<void> {
+    await referentials.load(siteId)
+    if (form.clientIri.value && !referentials.clients.value.some(o => o.value === form.clientIri.value)) {
+        form.clientIri.value = null
+    }
+    if (form.supplierIri.value && !referentials.suppliers.value.some(o => o.value === form.supplierIri.value)) {
+        form.supplierIri.value = null
+    }
+}
+
 onMounted(() => {
-    referentials.load().catch(() => {})
+    reloadReferentials(currentSite.value?.id ?? null).catch(() => {})
+})
+
+// Changement de site pendant la saisie → recharge les listes du nouveau site (ERP-208).
+watch(() => currentSite.value?.id, (siteId) => {
+    reloadReferentials(siteId ?? null).catch(() => {})
 })
 </script>
diff --git a/src/Module/Logistique/Domain/Entity/WeighingTicket.php b/src/Module/Logistique/Domain/Entity/WeighingTicket.php
index 8118d32..e9a067d 100644
--- a/src/Module/Logistique/Domain/Entity/WeighingTicket.php
+++ b/src/Module/Logistique/Domain/Entity/WeighingTicket.php
@@ -458,6 +458,35 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
         return $this;
     }
 
+    /**
+     * Nom du tiers à afficher (cartouche du bon de pesée PDF, ERP-208) : raison
+     * sociale du client/fournisseur ou libellé libre selon le type de contrepartie
+     * (RG-5.03). Null si aucune contrepartie cohérente (brouillon).
+     */
+    public function getCounterpartyName(): ?string
+    {
+        return match ($this->counterpartyType) {
+            'CLIENT'      => $this->client?->getCompanyName(),
+            'FOURNISSEUR' => $this->supplier?->getCompanyName(),
+            'AUTRE'       => $this->otherLabel,
+            default       => null,
+        };
+    }
+
+    /**
+     * Libellé FR du type de contrepartie (cartouche du bon de pesée PDF, ERP-208),
+     * affiché au-dessus du nom. Null si aucun type défini (brouillon).
+     */
+    public function getCounterpartyTypeLabel(): ?string
+    {
+        return match ($this->counterpartyType) {
+            'CLIENT'      => 'Client',
+            'FOURNISSEUR' => 'Fournisseur',
+            'AUTRE'       => 'Autre',
+            default       => null,
+        };
+    }
+
     public function getImmatriculation(): ?string
     {
         return $this->immatriculation;
diff --git a/templates/logistique/weighing_ticket_print.html.twig b/templates/logistique/weighing_ticket_print.html.twig
index 06bf820..f40af05 100644
--- a/templates/logistique/weighing_ticket_print.html.twig
+++ b/templates/logistique/weighing_ticket_print.html.twig
@@ -27,6 +27,14 @@
         .company-name { font-weight: bold; font-size: 12px; }
         .company-line { font-size: 12px; }
 
+        /* En-tête 2 colonnes (Dompdf = CSS 2.1, pas de flex/grid) : identité
+           société à gauche, cartouche du tiers à droite (ERP-208). */
+        .header { width: 100%; border-collapse: collapse; }
+        .header td { vertical-align: top; }
+        .header .h-right { text-align: right; }
+        .party-box { display: inline-block; border: 1px solid #000; padding: 8px 12px; min-width: 160px; text-align: left; font-weight: normal; font-size: 11px; }
+        .party-label { font-weight: bold; font-size: 14px; margin-bottom: 4px; }
+
         .title { font-size: 22px; font-weight: bold; margin: 22px 0 18px; }
 
         /* Lignes des deux pesées : tableau sans bordure, colonnes alignées. */
@@ -41,13 +49,27 @@
     </style>
 </head>
 <body>
-    {% if logoSrc %}
-        <div class="logo"><img src="{{ logoSrc }}" alt="LPC LIOT"></div>
-    {% endif %}
-
-    <div class="company-name">SA LIOT Châtellerault</div>
-    <div class="company-line">Email : lpc.contacts@lpc-liot.fr</div>
-    <div class="company-line">RCS Châtellerault B 339 505 612</div>
+    <table class="header">
+        <tr>
+            <td>
+                {% if logoSrc %}
+                    <div class="logo"><img src="{{ logoSrc }}" alt="LPC LIOT"></div>
+                {% endif %}
+                <div class="company-name">SA LIOT Châtellerault</div>
+                <div class="company-line">Email : lpc.contacts@lpc-liot.fr</div>
+                <div class="company-line">RCS Châtellerault B 339 505 612</div>
+            </td>
+            {# Cartouche tiers (ERP-208) : nom du client / fournisseur / « autre ». #}
+            <td class="h-right">
+                {% if ticket.counterpartyName %}
+                    <div class="party-box">
+                        <div class="party-label">{{ ticket.counterpartyTypeLabel }} :</div>
+                        {{ ticket.counterpartyName }}
+                    </div>
+                {% endif %}
+            </td>
+        </tr>
+    </table>
 
     <div class="title">Ticket de pesée</div>
 
diff --git a/tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php b/tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php
new file mode 100644
index 0000000..5b1fa22
--- /dev/null
+++ b/tests/Module/Logistique/Domain/WeighingTicketCounterpartyNameTest.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Module\Logistique\Domain;
+
+use App\Module\Commercial\Domain\Entity\Client;
+use App\Module\Commercial\Domain\Entity\Supplier;
+use App\Module\Logistique\Domain\Entity\WeighingTicket;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Couvre WeighingTicket::getCounterpartyName() (ERP-208) : nom du tiers affiché
+ * dans le cartouche du bon de pesée selon le type de contrepartie (RG-5.03).
+ *
+ * @internal
+ */
+final class WeighingTicketCounterpartyNameTest extends TestCase
+{
+    public function testReturnsClientCompanyNameForClientCounterparty(): void
+    {
+        $client = new Client()->setCompanyName('Ferme du Pré');
+        $ticket = new WeighingTicket()->setCounterpartyType('CLIENT')->setClient($client);
+
+        self::assertSame('Ferme du Pré', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsSupplierCompanyNameForSupplierCounterparty(): void
+    {
+        $supplier = new Supplier()->setCompanyName('Coop Sud');
+        $ticket   = new WeighingTicket()->setCounterpartyType('FOURNISSEUR')->setSupplier($supplier);
+
+        self::assertSame('Coop Sud', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsOtherLabelForOtherCounterparty(): void
+    {
+        $ticket = new WeighingTicket()->setCounterpartyType('AUTRE')->setOtherLabel('Particulier');
+
+        self::assertSame('Particulier', $ticket->getCounterpartyName());
+    }
+
+    public function testReturnsNullWhenNoCounterparty(): void
+    {
+        self::assertNull(new WeighingTicket()->getCounterpartyName());
+    }
+
+    public function testTypeLabelIsFrenchPerCounterpartyType(): void
+    {
+        self::assertSame('Client', new WeighingTicket()->setCounterpartyType('CLIENT')->getCounterpartyTypeLabel());
+        self::assertSame('Fournisseur', new WeighingTicket()->setCounterpartyType('FOURNISSEUR')->getCounterpartyTypeLabel());
+        self::assertSame('Autre', new WeighingTicket()->setCounterpartyType('AUTRE')->getCounterpartyTypeLabel());
+    }
+
+    public function testTypeLabelIsNullWhenNoCounterparty(): void
+    {
+        self::assertNull(new WeighingTicket()->getCounterpartyTypeLabel());
+    }
+}