feat : cycle de vie brouillon/validé du ticket de pesée (ERP-193)

Une pesée (bascule ou manuelle) s'enregistre désormais dès la validation de sa modale, sans exiger la contrepartie ni l'immatriculation : le ticket naît « brouillon » (status DRAFT, sans numéro). Le bouton « Valider » finalise quand les 3 champs du haut (contrepartie + champ associé + immatriculation) ET les 2 pesées sont renseignés : attribution du numéro {siteCode}-TP-{NNNN} et passage en VALIDATED, puis ouverture du bon de pesée PDF. Back : counterparty_type/immatriculation/number nullables + colonne status (migration racine), contraintes strictes déplacées en groupe de validation finalize, opération PATCH /weighing_tickets/{id}/validate, numéro attribué à la validation. Front : 4 champs en haut hors blocs, persistance immédiate des pesées, écrans Ajouter/Modifier refondus, colonne Statut dans la liste, form à plat pleine largeur. Tests back (lifecycle brouillon/validate) + front à jour.
2026-06-24 15:13:12 +02:00
parent d5d7d2e2aa
commit 819ac5e608
20 changed files with 794 additions and 389 deletions
@@ -16,17 +16,17 @@ describe('useWeighingTicketForm', () => {
    })

    // ── Omission des requis vides (compact) ──────────────────────────────────
-    it('buildCreatePayload omet les clés null (requis vides absents, pas envoyés à null)', () => {
+    it('buildDraftPayload : brouillon vierge → pas de champ requis ni de bloc non pesé', () => {
        const form = useWeighingTicketForm()
-        // Formulaire vierge : counterpartyType / immatriculation non remplis.
-        const payload = form.buildCreatePayload()
-        // Absents (et non null) → le back applique NotBlank (message métier) plutôt
-        // qu'une erreur de type opaque (« doit être de type string »).
+        // Formulaire vierge : counterpartyType / immatriculation non remplis, aucune pesée.
+        const payload = form.buildDraftPayload()
+        // Absents (et non null) → le back laisse jouer les contraintes du groupe finalize.
        expect(payload).not.toHaveProperty('counterpartyType')
        expect(payload).not.toHaveProperty('immatriculation')
+        // Bloc non pesé → ni poids ni date (on n'envoie pas une date de pesée sans pesée).
        expect(payload).not.toHaveProperty('emptyWeight')
-        // Les non-null restent : date/heure courante + booléen Tout format.
-        expect(payload.emptyDate).toBe('2026-06-22T08:30:00')
+        expect(payload).not.toHaveProperty('emptyDate')
+        // Seul le booléen « Tout format » reste.
        expect(payload.plateFreeFormat).toBe(false)
    })

@@ -53,7 +53,7 @@ describe('useWeighingTicketForm', () => {
        expect(form.supplierIri.value).toBeNull()
        expect(form.otherLabel.value).toBeNull()

-        const payload = form.buildCreatePayload()
+        const payload = form.buildDraftPayload()
        expect(payload.counterpartyType).toBe('CLIENT')
        expect(payload.client).toBe('/api/clients/629')
        expect(payload).not.toHaveProperty('supplier')
@@ -68,7 +68,7 @@ describe('useWeighingTicketForm', () => {

        expect(form.counterpartyField.value).toBe('supplier')
        expect(form.clientIri.value).toBeNull()
-        expect(form.buildCreatePayload().supplier).toBe('/api/suppliers/7')
+        expect(form.buildDraftPayload().supplier).toBe('/api/suppliers/7')
    })

    it('AUTRE : ne conserve que le libellé libre', () => {
@@ -79,7 +79,7 @@ describe('useWeighingTicketForm', () => {

        expect(form.counterpartyField.value).toBe('other')
        expect(form.clientIri.value).toBeNull()
-        expect(form.buildCreatePayload().otherLabel).toBe('Reprise interne')
+        expect(form.buildDraftPayload().otherLabel).toBe('Reprise interne')
    })

    // ── Immatriculation / « Tout format » partagés entre blocs (RG-5.01) ──────
@@ -88,11 +88,11 @@ describe('useWeighingTicketForm', () => {
        form.immatriculation.value = 'AB-123-CD'
        form.plateFreeFormat.value = true

-        // Les 2 payloads (création + finalisation) reflètent la même valeur.
-        expect(form.buildCreatePayload().immatriculation).toBe('AB-123-CD')
-        expect(form.buildCreatePayload().plateFreeFormat).toBe(true)
-        expect(form.buildFullPayload().immatriculation).toBe('AB-123-CD')
-        expect(form.buildFullPayload().plateFreeFormat).toBe(true)
+        // Les 2 payloads (brouillon + validation) reflètent la même valeur.
+        expect(form.buildDraftPayload().immatriculation).toBe('AB-123-CD')
+        expect(form.buildDraftPayload().plateFreeFormat).toBe(true)
+        expect(form.buildValidatePayload().immatriculation).toBe('AB-123-CD')
+        expect(form.buildValidatePayload().plateFreeFormat).toBe(true)
    })

    // ── Application d'une lecture de pesée ────────────────────────────────────
@@ -113,23 +113,28 @@ describe('useWeighingTicketForm', () => {
        expect(form.full.manualNumber).toBe('PAP-555')
    })

-    it('buildCreatePayload porte la pesée à vide, buildFullPayload la pesée à plein', () => {
+    it('buildDraftPayload porte les pesées effectuées ; buildValidatePayload les 4 champs du haut', () => {
        const form = useWeighingTicketForm()
        form.setCounterpartyType('CLIENT')
        form.clientIri.value = '/api/clients/1'
+        form.immatriculation.value = 'AB-123-CD'
        form.applyReading(form.empty, { weight: 7150, dsd: 1, mode: 'AUTO' })
        form.applyReading(form.full, { weight: 14300, dsd: 2, mode: 'AUTO' })

-        const create = form.buildCreatePayload()
-        expect(create.emptyWeight).toBe(7150)
-        expect(create.emptyDsd).toBe(1)
-        expect(create.emptyMode).toBe('AUTO')
-        expect(create).not.toHaveProperty('fullWeight')
+        // Le brouillon porte LES DEUX pesées effectuées.
+        const draft = form.buildDraftPayload()
+        expect(draft.emptyWeight).toBe(7150)
+        expect(draft.emptyMode).toBe('AUTO')
+        expect(draft.fullWeight).toBe(14300)
+        expect(draft.fullMode).toBe('AUTO')

-        const full = form.buildFullPayload()
-        expect(full.fullWeight).toBe(14300)
-        expect(full.fullDsd).toBe(2)
-        expect(full.fullMode).toBe('AUTO')
+        // La validation ne porte que les 4 champs du haut (pesées déjà persistées).
+        const validate = form.buildValidatePayload()
+        expect(validate.counterpartyType).toBe('CLIENT')
+        expect(validate.client).toBe('/api/clients/1')
+        expect(validate.immatriculation).toBe('AB-123-CD')
+        expect(validate).not.toHaveProperty('emptyWeight')
+        expect(validate).not.toHaveProperty('fullWeight')
    })

    // ── Pré-remplissage (écran Modification, ERP-190) ─────────────────────────
@@ -174,10 +179,11 @@ describe('useWeighingTicketForm', () => {
        expect(form.empty.weight).toBeNull()
    })

-    it('buildUpdatePayload fusionne contrepartie + véhicule + les 2 pesées', () => {
+    it('buildDraftPayload après hydrate porte contrepartie + véhicule + les 2 pesées', () => {
        const form = useWeighingTicketForm()
        form.hydrate({
            id: 9,
+            status: 'VALIDATED',
            counterpartyType: 'CLIENT',
            client: { '@id': '/api/clients/629' },
            immatriculation: 'AB-123-CD',
@@ -185,7 +191,9 @@ describe('useWeighingTicketForm', () => {
            fullWeight: 14300, fullDsd: 2, fullMode: 'AUTO',
        })

-        const payload = form.buildUpdatePayload()
+        expect(form.status.value).toBe('VALIDATED')
+
+        const payload = form.buildDraftPayload()
        expect(payload.counterpartyType).toBe('CLIENT')
        expect(payload.client).toBe('/api/clients/629')
        expect(payload.emptyWeight).toBe(7150)
@@ -1,5 +1,5 @@
 import type { WeighbridgeMode } from '~/modules/logistique/composables/useWeighbridge'
-import type { CounterpartyType } from '~/modules/logistique/composables/useWeighingTicketForm'
+import type { CounterpartyType, WeighingTicketStatus } from '~/modules/logistique/composables/useWeighingTicketForm'

 /**
 * Détail d'un ticket de pesée (`GET /api/weighing_tickets/{id}`, spec-back
@@ -8,11 +8,13 @@ import type { CounterpartyType } from '~/modules/logistique/composables/useWeigh
 */
 export interface WeighingTicketDetail {
    id: number
-    /** Numéro `{siteCode}-TP-{NNNN}` — immuable (RG-5.09). */
-    number: string
+    /** Cycle de vie (DRAFT/VALIDATED, ERP-193). */
+    status?: WeighingTicketStatus
+    /** Numéro `{siteCode}-TP-{NNNN}` — null tant que brouillon, immuable ensuite (RG-5.09). */
+    number?: string | null
    /** Site rattaché (embarqué) — immuable (RG-5.09). */
    site?: { id: number, name: string, code: string } | null
-    counterpartyType: CounterpartyType
+    counterpartyType?: CounterpartyType | null
    client?: { '@id': string, companyName: string } | null
    supplier?: { '@id': string, companyName: string } | null
    otherLabel?: string | null
@@ -11,12 +11,13 @@ import type { WeighbridgeMode } from '~/modules/logistique/composables/useWeighb
 *  - **Contrepartie conditionnelle (RG-5.03)** : `counterpartyType` (CLIENT /
 *    FOURNISSEUR / AUTRE) pilote le champ requis (client / supplier / otherLabel).
 *    Changer de type purge les champs des autres types — aucune donnée fantôme.
- *  - **Immatriculation + « Tout format » partagés entre les 2 blocs (RG-5.01)** :
- *    une seule valeur (refs uniques) — modifier l'un met à jour l'autre puisque
- *    les 2 blocs bindent la même ref.
- *  - **Workflow 2 temps** : `buildCreatePayload()` (POST à l'« Enregistrer » du
- *    bloc vide) crée le ticket avec la pesée à vide ; `buildFullPayload()` (PATCH
- *    au « Valider ») ajoute la pesée à plein (net recalculé serveur, RG-5.05).
+ *  - **Immatriculation + « Tout format »** font partie des 4 champs du haut, hors
+ *    blocs (ERP-193). Une seule valeur, partagée entre les 2 pesées (RG-5.01).
+ *  - **Cycle brouillon -> validé (ERP-193)** : `buildDraftPayload()` persiste l'état
+ *    courant (pesée enregistrée dès la validation de sa modale, même sans
+ *    contrepartie/immat) via POST (création du brouillon) puis PATCH ; quand les 3
+ *    champs du haut + les 2 pesées sont là, `buildValidatePayload()` finalise via
+ *    `PATCH /weighing_tickets/{id}/validate` (numéro attribué, status VALIDATED).
 *
 * Composable UI-agnostique et testable : aucune dépendance API ici (les appels
 * vivent dans l'écran via `useApi`). Instancié PAR écran (refs locales).
@@ -39,10 +40,14 @@ export interface WeighingBlockState {
    manualNumber: string | null
 }

+/** Cycle de vie du ticket (miroir back, ERP-193). */
+export type WeighingTicketStatus = 'DRAFT' | 'VALIDATED'
+
 /** Forme minimale d'un détail de ticket consommée par `hydrate` (cf. useWeighingTicket). */
 export interface WeighingTicketHydration {
    id: number
-    counterpartyType: CounterpartyType
+    status?: WeighingTicketStatus
+    counterpartyType?: CounterpartyType | null
    client?: { '@id': string } | null
    supplier?: { '@id': string } | null
    otherLabel?: string | null
@@ -124,9 +129,13 @@ export function useWeighingTicketForm() {
    const empty = reactive<WeighingBlockState>(emptyBlock(now))
    const full = reactive<WeighingBlockState>(emptyBlock(now))

-    // Id du ticket créé (POST du bloc vide) — pilote le PATCH du bloc plein.
+    // Id du ticket persisté (POST du 1er enregistrement de pesée) — pilote ensuite
+    // les PATCH (brouillon) puis la validation. Null tant que rien n'est persisté.
    const ticketId = ref<number | null>(null)

+    // Cycle de vie courant (DRAFT tant que non validé, ERP-193).
+    const status = ref<WeighingTicketStatus>('DRAFT')
+
    /**
     * Champ de contrepartie attendu selon le type courant — utilisé par l'écran
     * pour afficher conditionnellement le bon champ (RG-5.03).
@@ -183,22 +192,35 @@ export function useWeighingTicketForm() {
    }

    /**
-     * Payload de CRÉATION (POST /weighing_tickets, spec-back § 4.3) : contrepartie
-     * + véhicule + pesée à VIDE. Le numéro, le site et le net sont attribués
-     * serveur (rien à envoyer). Les noms de champs miroir des `propertyPath` back
-     * pour que `useFormErrors` mappe les 422 inline.
+     * Champs d'un bloc de pesée, UNIQUEMENT s'il a été pesé (poids renseigné) — on
+     * n'envoie pas la date par défaut d'un bloc vierge (sinon le back stockerait une
+     * date de pesée sans poids). Noms de clés alignés sur les `propertyPath` back.
     */
-    function buildCreatePayload(): Record<string, unknown> {
+    function blockPayload(prefix: 'empty' | 'full', block: WeighingBlockState): Record<string, unknown> {
+        if (block.weight === null) return {}
+        return {
+            [`${prefix}Date`]: block.date,
+            [`${prefix}Weight`]: block.weight,
+            [`${prefix}Dsd`]: block.dsd,
+            [`${prefix}Mode`]: block.mode,
+            [`${prefix}ManualNumber`]: block.manualNumber || null,
+        }
+    }
+
+    /**
+     * Payload de BROUILLON (POST création / PATCH mise à jour, ERP-193) : l'état
+     * courant complet (4 champs du haut + pesées effectuées). Aucun champ n'est
+     * requis ici (le back valide en mode relâché) — une pesée s'enregistre sans
+     * contrepartie ni immatriculation. Numéro/site/net attribués serveur.
+     */
+    function buildDraftPayload(): Record<string, unknown> {
        return compact({
            counterpartyType: counterpartyType.value,
            ...counterpartyPayload(),
            immatriculation: immatriculation.value || null,
            plateFreeFormat: plateFreeFormat.value,
-            emptyDate: empty.date || null,
-            emptyWeight: empty.weight,
-            emptyDsd: empty.dsd,
-            emptyMode: empty.mode,
-            emptyManualNumber: empty.manualNumber || null,
+            ...blockPayload('empty', empty),
+            ...blockPayload('full', full),
        })
    }

@@ -211,6 +233,7 @@ export function useWeighingTicketForm() {
     */
    function hydrate(detail: WeighingTicketHydration): void {
        ticketId.value = detail.id
+        status.value = detail.status ?? 'DRAFT'
        counterpartyType.value = detail.counterpartyType ?? null
        clientIri.value = detail.client?.['@id'] ?? null
        supplierIri.value = detail.supplier?.['@id'] ?? null
@@ -232,30 +255,18 @@ export function useWeighingTicketForm() {
    }

    /**
-     * Payload de MODIFICATION (PATCH /weighing_tickets/{id}, ERP-190) : tous les
-     * champs éditables (contrepartie + véhicule + les 2 pesées). Le numéro et le
-     * site sont immuables (RG-5.09, ignorés par le back même si envoyés). Le net
-     * est recalculé serveur (RG-5.05).
+     * Payload de VALIDATION (PATCH /weighing_tickets/{id}/validate, ERP-193) : les
+     * 4 champs du haut (contrepartie + immatriculation + « Tout format »). Les pesées
+     * sont déjà persistées par les enregistrements brouillon ; le back rejoue ici la
+     * validation stricte (groupe `finalize` : 3 champs requis + 2 pesées) et attribue
+     * le numéro. Les `propertyPath` des 422 sont mappés inline par useFormErrors.
     */
-    function buildUpdatePayload(): Record<string, unknown> {
-        return { ...buildCreatePayload(), ...buildFullPayload() }
-    }
-
-    /**
-     * Payload de FINALISATION (PATCH /weighing_tickets/{id}, spec-back § 4.4) :
-     * pesée à PLEIN. Le véhicule (immat / tout format) peut avoir été ajusté entre
-     * les 2 blocs → on le repousse aussi (valeur partagée, RG-5.01). Le net est
-     * recalculé serveur (RG-5.05).
-     */
-    function buildFullPayload(): Record<string, unknown> {
+    function buildValidatePayload(): Record<string, unknown> {
        return compact({
+            counterpartyType: counterpartyType.value,
+            ...counterpartyPayload(),
            immatriculation: immatriculation.value || null,
            plateFreeFormat: plateFreeFormat.value,
-            fullDate: full.date || null,
-            fullWeight: full.weight,
-            fullDsd: full.dsd,
-            fullMode: full.mode,
-            fullManualNumber: full.manualNumber || null,
        })
    }

@@ -277,9 +288,9 @@ export function useWeighingTicketForm() {
        missingWeighingFields,
        // workflow
        ticketId,
+        status,
        hydrate,
-        buildCreatePayload,
-        buildFullPayload,
-        buildUpdatePayload,
+        buildDraftPayload,
+        buildValidatePayload,
    }
 }
@@ -1,4 +1,5 @@
 import { usePaginatedList } from '~/shared/composables/usePaginatedList'
+import type { WeighingTicketStatus } from '~/modules/logistique/composables/useWeighingTicketForm'

 /**
 * Vue MINIMALE d'une contrepartie embarquee (Client M1 ou Fournisseur M2) dans la
@@ -25,8 +26,10 @@ export interface WeighingTicketParty {
 */
 export interface WeighingTicket {
    id: number
-    /** Numero metier `{siteCode}-TP-{NNNN}` attribue par site (RG-5.02). */
-    number: string
+    /** Cycle de vie : DRAFT (« En attente ») ou VALIDATED (« Terminée ») — ERP-193. */
+    status: WeighingTicketStatus
+    /** Numero metier `{siteCode}-TP-{NNNN}` — null tant que brouillon (RG-5.02). */
+    number: string | null
    /** Embarque uniquement si contrepartie = Client (RG-5.03), sinon absent. */
    client: WeighingTicketParty | null
    /** Embarque uniquement si contrepartie = Fournisseur (RG-5.03), sinon absent. */