fix(logistique) : bon de pesée — cartouche tiers + filtrage des listes contrepartie par site (ERP-208)
- 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.
This commit is contained in:
@@ -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).
|
||||
Reference in New Issue
Block a user