feat : M5 — Tickets de pesée (ERP-188 → ERP-193) (#144)

MR unique regroupant tout le module M5 « Tickets de pesée » (remplace les MR empilées #140/#141/#142/#143).

## Périmètre
- **ERP-188** — Page liste des tickets de pesée + export XLSX (colonnes Fournisseur/Client/Autre + Statut).
- **ERP-189** — Écran « Ajouter » (4 champs en haut, 2 blocs de pesée, pesée bascule/manuelle, date+heure horodatée à la validation).
- **ERP-190** — Écran « Modifier » + bouton Imprimer.
- **ERP-191** — i18n + libellés + branchement site courant.
- **ERP-192** — Bon de pesée PDF généré côté back (template Twig → Dompdf), endpoint `GET /api/weighing_tickets/{id}/print.pdf`.
- **ERP-193** — Cycle de vie brouillon/validé (status DRAFT/VALIDATED, numéro attribué à la validation), DSD saisi conservé en pesée manuelle, retours métier design.

## Vérifications
- Back : tests Logistique + architecture verts, php-cs-fixer propre, migrations appliquées (dev + test).
- Front : suite Vitest complète verte, ESLint propre.

Base : `develop` — contient les 16 commits du M5 (rien d'autre).
Reviewed-on: #144
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

frontend/modules/logistique/pages/__tests__/weighingTicketEdit.spec.ts

@@ -0,0 +1,144 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { mount, flushPromises } from '@vue/test-utils'
+import { defineComponent, h, ref, reactive, Suspense } from 'vue'
+
+// ── Mocks des composables modules (le form RÉEL est conservé pour vérifier le
+//    pré-remplissage via hydrate). ─────────────────────────────────────────────
+const mockFetchTicket = vi.hoisted(() => vi.fn())
+const mockPatch = vi.hoisted(() => vi.fn())
+const mockPush = vi.hoisted(() => vi.fn())
+const mockOpen = vi.hoisted(() => vi.fn())
+
+vi.mock('~/modules/logistique/composables/useWeighingTicket', () => ({
+    useWeighingTicket: () => ({ fetchTicket: mockFetchTicket }),
+}))
+vi.mock('~/modules/logistique/composables/useWeighingTicketReferentials', () => ({
+    useWeighingTicketReferentials: () => ({ clients: ref([]), suppliers: ref([]), load: vi.fn().mockResolvedValue(undefined) }),
+}))
+vi.mock('~/modules/logistique/composables/useWeighbridge', () => ({
+    useWeighbridge: () => ({ triggerAuto: vi.fn(), triggerManual: vi.fn(), extractWeighbridgeError: () => 'err' }),
+}))
+
+// ── Auto-imports Nuxt stubbes globalement ───────────────────────────────────
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('useHead', () => undefined)
+vi.stubGlobal('useApi', () => ({ get: vi.fn(), post: vi.fn(), patch: mockPatch }))
+vi.stubGlobal('useRoute', () => ({ params: { id: '9' } }))
+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() }))
+globalThis.open = mockOpen
+
+const EditPage = (await import('../weighing-tickets/[id]/edit.vue')).default
+
+// ── Stubs de composants ──────────────────────────────────────────────────────
+const ButtonStub = defineComponent({
+    props: { label: { type: String, default: '' }, disabled: { type: Boolean, default: false } },
+    emits: ['click'],
+    setup(props, { emit }) {
+        return () => h('button', { 'data-label': props.label, onClick: () => emit('click') }, props.label)
+    },
+})
+
+const InputStub = defineComponent({
+    props: { label: { type: String, default: '' }, modelValue: { default: null } },
+    setup(props) {
+        return () => h('input', { 'data-label': props.label, 'value': props.modelValue as string })
+    },
+})
+
+// WeighingBlock stubbé (Date/Poids/DSD + boutons) — la contrepartie vit désormais
+// dans les 4 champs du haut, hors bloc (ERP-193).
+const BlockStub = defineComponent({
+    setup() { return () => h('div', { 'data-testid': 'block' }) },
+})
+
+const ModalStub = defineComponent({
+    props: { modelValue: { type: Boolean, default: false } },
+    setup(_, { slots }) { return () => h('div', {}, [slots.header?.(), slots.default?.(), slots.footer?.()]) },
+})
+
+const stubs = {
+    MalioButtonIcon: ButtonStub,
+    MalioButton: ButtonStub,
+    MalioInputText: InputStub,
+    MalioInputNumber: InputStub,
+    MalioSelect: InputStub,
+    MalioDateTime: InputStub,
+    MalioCheckbox: InputStub,
+    MalioModal: ModalStub,
+    WeighingBlock: BlockStub,
+}
+
+// Monte la page (setup async : top-level await) via Suspense.
+async function mountPage() {
+    const wrapper = mount(defineComponent({
+        components: { EditPage },
+        setup: () => () => h(Suspense, null, { default: () => h(EditPage) }),
+    }), { global: { stubs } })
+    await flushPromises()
+    return wrapper
+}
+
+const DETAIL = {
+    id: 9,
+    status: 'VALIDATED',
+    number: '86-TP-0001',
+    site: { id: 1, name: 'Chatellerault', code: '86' },
+    counterpartyType: 'CLIENT',
+    client: { '@id': '/api/clients/629', companyName: 'NÉGOCE MÉTAUX ATLANTIQUE' },
+    immatriculation: 'AB-123-CD',
+    plateFreeFormat: false,
+    emptyDate: '2026-06-17T09:00:00+02:00', emptyWeight: 7150, emptyDsd: 1, emptyMode: 'AUTO',
+    fullDate: '2026-06-17T09:12:00+02:00', fullWeight: 14300, fullDsd: 2, fullMode: 'AUTO',
+}
+
+describe('Écran Modification ticket de pesée (page /weighing-tickets/{id}/edit)', () => {
+    beforeEach(() => {
+        mockFetchTicket.mockReset().mockResolvedValue({ ...DETAIL })
+        mockPatch.mockReset().mockResolvedValue({})
+        mockPush.mockReset()
+        mockOpen.mockReset()
+    })
+
+    it('charge le ticket au montage (pré-remplissage via hydrate)', async () => {
+        await mountPage()
+        expect(mockFetchTicket).toHaveBeenCalledWith('9')
+    })
+
+    it('ticket validé : action principale « Enregistrer » + « Imprimer » (pas « Valider »)', async () => {
+        const wrapper = await mountPage()
+        // DETAIL.status = VALIDATED → l'action principale s'intitule « Enregistrer ».
+        expect(wrapper.find('[data-label="logistique.weighingTickets.form.save"]').exists()).toBe(true)
+        expect(wrapper.find('[data-label="logistique.weighingTickets.form.print"]').exists()).toBe(true)
+        expect(wrapper.find('[data-label="logistique.weighingTickets.form.validate"]').exists()).toBe(false)
+    })
+
+    it('« Imprimer » ouvre le bon de pesée PDF servi par le back (RG-5.08)', async () => {
+        const wrapper = await mountPage()
+        await wrapper.find('[data-label="logistique.weighingTickets.form.print"]').trigger('click')
+        expect(mockOpen).toHaveBeenCalledWith('/api/weighing_tickets/9/print.pdf', '_blank')
+    })
+
+    it('« Enregistrer » : PATCH brouillon puis PATCH /validate, retour à la liste', async () => {
+        const wrapper = await mountPage()
+        await wrapper.find('[data-label="logistique.weighingTickets.form.save"]').trigger('click')
+        await flushPromises()
+        // 1. Persistance de l'état courant (brouillon) avec les 2 pesées.
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/weighing_tickets/9',
+            expect.objectContaining({ counterpartyType: 'CLIENT', client: '/api/clients/629', fullWeight: 14300 }),
+            expect.objectContaining({ toast: false }),
+        )
+        // 2. Validation (back autoritaire) — ne porte que les 4 champs du haut.
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/weighing_tickets/9/validate',
+            expect.objectContaining({ counterpartyType: 'CLIENT', immatriculation: 'AB-123-CD' }),
+            expect.objectContaining({ toast: false }),
+        )
+        // « Enregistrer » ouvre aussi le bon de pesée PDF (RG-5.08).
+        expect(mockOpen).toHaveBeenCalledWith('/api/weighing_tickets/9/print.pdf', '_blank')
+        expect(mockPush).toHaveBeenCalledWith('/weighing-tickets')
+    })
+})

frontend/modules/logistique/pages/__tests__/weighingTicketNew.spec.ts

@@ -0,0 +1,102 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { mount, flushPromises } from '@vue/test-utils'
+import { defineComponent, h, ref, reactive, Suspense } from 'vue'
+
+// ── Mocks des composables modules (le form RÉEL est conservé). ────────────────
+const mockPost = vi.hoisted(() => vi.fn())
+const mockPatch = vi.hoisted(() => vi.fn())
+const mockPush = vi.hoisted(() => vi.fn())
+const mockOpen = vi.hoisted(() => vi.fn())
+
+vi.mock('~/modules/logistique/composables/useWeighingTicketReferentials', () => ({
+    useWeighingTicketReferentials: () => ({ clients: ref([]), suppliers: ref([]), load: vi.fn().mockResolvedValue(undefined) }),
+}))
+vi.mock('~/modules/logistique/composables/useWeighbridge', () => ({
+    useWeighbridge: () => ({ triggerAuto: vi.fn(), triggerManual: vi.fn(), extractWeighbridgeError: () => 'err' }),
+}))
+
+// ── Auto-imports Nuxt stubbés globalement ───────────────────────────────────
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('useHead', () => undefined)
+vi.stubGlobal('useApi', () => ({ get: vi.fn(), post: mockPost, patch: mockPatch }))
+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() }))
+globalThis.open = mockOpen
+
+const NewPage = (await import('../weighing-tickets/new.vue')).default
+
+const ButtonStub = defineComponent({
+    props: { label: { type: String, default: '' }, disabled: { type: Boolean, default: false } },
+    emits: ['click'],
+    setup(props, { emit }) {
+        return () => h('button', { 'data-label': props.label, onClick: () => emit('click') }, props.label)
+    },
+})
+const InputStub = defineComponent({
+    props: { label: { type: String, default: '' }, modelValue: { default: null } },
+    setup(props) { return () => h('input', { 'data-label': props.label, 'value': props.modelValue as string }) },
+})
+const BlockStub = defineComponent({ setup() { return () => h('div', { 'data-testid': 'block' }) } })
+const ModalStub = defineComponent({
+    props: { modelValue: { type: Boolean, default: false } },
+    setup(_, { slots }) { return () => h('div', {}, [slots.header?.(), slots.default?.(), slots.footer?.()]) },
+})
+
+const stubs = {
+    MalioButtonIcon: ButtonStub,
+    MalioButton: ButtonStub,
+    MalioInputText: InputStub,
+    MalioSelect: InputStub,
+    MalioDateTime: InputStub,
+    MalioCheckbox: InputStub,
+    MalioModal: ModalStub,
+    WeighingBlock: BlockStub,
+}
+
+async function mountPage() {
+    const wrapper = mount(defineComponent({
+        components: { NewPage },
+        setup: () => () => h(Suspense, null, { default: () => h(NewPage) }),
+    }), { global: { stubs } })
+    await flushPromises()
+    return wrapper
+}
+
+describe('Écran Ajouter ticket de pesée (page /weighing-tickets/new)', () => {
+    beforeEach(() => {
+        mockPost.mockReset().mockResolvedValue({ id: 42 })
+        mockPatch.mockReset().mockResolvedValue({})
+        mockPush.mockReset()
+        mockOpen.mockReset()
+    })
+
+    it('un seul bouton « Valider » (pas de « Enregistrer » séparé)', async () => {
+        const wrapper = await mountPage()
+        expect(wrapper.find('[data-label="logistique.weighingTickets.form.validate"]').exists()).toBe(true)
+        expect(wrapper.find('[data-label="logistique.weighingTickets.form.save"]').exists()).toBe(false)
+    })
+
+    it('« Valider » : POST brouillon (création) puis PATCH /validate, PDF + retour liste', async () => {
+        const wrapper = await mountPage()
+        await wrapper.find('[data-label="logistique.weighingTickets.form.validate"]').trigger('click')
+        await flushPromises()
+
+        // 1. Création du brouillon (POST) → récupère l'id.
+        expect(mockPost).toHaveBeenCalledWith(
+            '/weighing_tickets',
+            expect.any(Object),
+            expect.objectContaining({ toast: false }),
+        )
+        // 2. Validation (back autoritaire) sur l'id retourné.
+        expect(mockPatch).toHaveBeenCalledWith(
+            '/weighing_tickets/42/validate',
+            expect.any(Object),
+            expect.objectContaining({ toast: false }),
+        )
+        // 3. Ouverture du bon de pesée PDF + retour à la liste.
+        expect(mockOpen).toHaveBeenCalledWith('/api/weighing_tickets/42/print.pdf', '_blank')
+        expect(mockPush).toHaveBeenCalledWith('/weighing-tickets')
+    })
+})

frontend/modules/logistique/pages/__tests__/weighingTicketsIndex.spec.ts

@@ -0,0 +1,200 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { mount, flushPromises, type VueWrapper } from '@vue/test-utils'
+import { defineComponent, h, ref } from 'vue'
+
+// ── Auto-imports Nuxt stubbes globalement ───────────────────────────────────
+// La page ne les importe pas (auto-import) : on les expose en globals pour le
+// runtime de test (happy-dom). Meme philosophie que les specs M1→M4.
+const mockPush = vi.hoisted(() => vi.fn())
+const mockApiGet = vi.hoisted(() => vi.fn())
+const mockCan = vi.hoisted(() => vi.fn())
+const mockFetch = vi.hoisted(() => vi.fn())
+const mockReset = vi.hoisted(() => vi.fn())
+const mockToastError = vi.hoisted(() => vi.fn())
+
+vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+vi.stubGlobal('useHead', () => undefined)
+vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
+vi.stubGlobal('useRouter', () => ({ push: mockPush }))
+vi.stubGlobal('useToast', () => ({ error: mockToastError, success: vi.fn() }))
+vi.stubGlobal('usePermissions', () => ({ can: mockCan }))
+// Site courant (switcher global) : ref pilotable pour simuler un changement de site.
+const currentSiteRef = ref<{ id: number } | null>(null)
+vi.stubGlobal('useCurrentSite', () => ({ currentSite: currentSiteRef }))
+
+// Le repository est lui aussi un auto-import : on controle les items renvoyes.
+// Contrepartie CLIENT (RG-5.03) → supplier / otherLabel absents (skip_null_values).
+vi.stubGlobal('useWeighingTicketsRepository', () => ({
+    items: ref([
+        {
+            id: 9,
+            number: '86-TP-0001',
+            client: { id: 629, companyName: 'NÉGOCE MÉTAUX ATLANTIQUE' },
+            supplier: null,
+            otherLabel: null,
+            displayDate: '2026-06-17T09:12:00+02:00',
+            netWeight: 7150,
+        },
+    ]),
+    totalItems: ref(1),
+    currentPage: ref(1),
+    itemsPerPage: ref(10),
+    itemsPerPageOptions: ref([10, 25, 50]),
+    fetch: mockFetch,
+    goToPage: vi.fn(),
+    setItemsPerPage: vi.fn(),
+    setFilters: vi.fn(),
+    reset: mockReset,
+}))
+
+// happy-dom n'implemente pas createObjectURL : on ajoute les methodes statiques
+// sur la classe URL existante (sans la remplacer — sinon `new URL()` casse).
+globalThis.URL.createObjectURL = vi.fn(() => 'blob:fake')
+globalThis.URL.revokeObjectURL = vi.fn()
+
+// Import APRES les stubs (la page resout les auto-imports au top-level du module).
+const WeighingTicketsIndex = (await import('../weighing-tickets/index.vue')).default
+
+// ── Stubs de composants ──────────────────────────────────────────────────────
+const ButtonStub = defineComponent({
+    props: { label: { type: String, default: '' }, disabled: { type: Boolean, default: false } },
+    emits: ['click'],
+    setup(props, { emit }) {
+        return () => h('button', { 'data-label': props.label, onClick: () => emit('click') }, props.label)
+    },
+})
+
+// Capture les `items` (rows) passes par la page : on rend chaque ligne avec ses
+// cellules formatees (date / poids) pour pouvoir asserter le mapping des colonnes.
+const capturedRows = ref<Array<Record<string, unknown>>>([])
+const DataTableStub = defineComponent({
+    props: { items: { type: Array, default: () => [] } },
+    emits: ['row-click', 'update:page', 'update:per-page'],
+    setup(props, { emit }) {
+        return () => {
+            capturedRows.value = props.items as Array<Record<string, unknown>>
+            return h('div', { 'data-testid': 'datatable' },
+                (props.items as Array<Record<string, unknown>>).map(it =>
+                    h('tr', { 'data-row-id': it.id as number, onClick: () => emit('row-click', it) }, [
+                        h('td', { 'data-cell': 'displayDate' }, it.displayDate as string),
+                        h('td', { 'data-cell': 'netWeight' }, it.netWeight as string),
+                        h('td', { 'data-cell': 'client' }, it.client as string),
+                        h('td', { 'data-cell': 'supplier' }, it.supplier as string),
+                    ]),
+                ),
+            )
+        }
+    },
+})
+
+const PageHeaderStub = defineComponent({
+    setup(_, { slots }) { return () => h('div', {}, [slots.default?.(), slots.actions?.()]) },
+})
+
+// Suivi des wrappers montés pour les démonter entre tests : sans cela, les
+// watchers sur la ref module-level `currentSiteRef` (site courant) fuiteraient
+// d'un test à l'autre et se déclencheraient en double.
+const mountedWrappers: VueWrapper[] = []
+
+function mountPage() {
+    const wrapper = mount(WeighingTicketsIndex, {
+        global: {
+            stubs: {
+                PageHeader: PageHeaderStub,
+                MalioButton: ButtonStub,
+                MalioDataTable: DataTableStub,
+            },
+        },
+    })
+    mountedWrappers.push(wrapper)
+    return wrapper
+}
+
+describe('Liste des tickets de pesée (page /weighing-tickets)', () => {
+    beforeEach(() => {
+        mockPush.mockReset()
+        mockApiGet.mockReset().mockResolvedValue(new Blob())
+        mockCan.mockReset().mockReturnValue(true)
+        mockFetch.mockReset()
+        mockReset.mockReset()
+        mockToastError.mockReset()
+        capturedRows.value = []
+        currentSiteRef.value = null
+    })
+
+    afterEach(() => {
+        // Démonte les composants montés → libère leurs watchers (site courant).
+        while (mountedWrappers.length > 0) {
+            mountedWrappers.pop()?.unmount()
+        }
+    })
+
+    it('charge la liste au montage', async () => {
+        mountPage()
+        await flushPromises()
+        expect(mockFetch).toHaveBeenCalled()
+    })
+
+    it('recharge la liste (page 1) quand le site courant change', async () => {
+        mountPage()
+        await flushPromises()
+        expect(mockReset).not.toHaveBeenCalled()
+
+        // Simule un switch de site via le switcher global.
+        currentSiteRef.value = { id: 2 }
+        await flushPromises()
+        expect(mockReset).toHaveBeenCalledTimes(1)
+    })
+
+    it('formate la date au format JJ-MM-AAAA', async () => {
+        const wrapper = mountPage()
+        await flushPromises()
+        expect(wrapper.find('[data-cell="displayDate"]').text()).toBe('17-06-2026')
+    })
+
+    it('formate le poids net en kg avec separateur de milliers', async () => {
+        const wrapper = mountPage()
+        await flushPromises()
+        expect(wrapper.find('[data-cell="netWeight"]').text()).toBe('7 150 Kg')
+    })
+
+    it('mappe la contrepartie Client (supplier vide car contrepartie ≠ Fournisseur)', async () => {
+        const wrapper = mountPage()
+        await flushPromises()
+        expect(wrapper.find('[data-cell="client"]').text()).toBe('NÉGOCE MÉTAUX ATLANTIQUE')
+        expect(wrapper.find('[data-cell="supplier"]').text()).toBe('')
+    })
+
+    it('affiche « + Ajouter » uniquement avec la permission manage', async () => {
+        mockCan.mockImplementation((perm: string) => perm === 'logistique.weighing_tickets.manage')
+        const wrapper = mountPage()
+        await flushPromises()
+        expect(wrapper.find('[data-label="logistique.weighingTickets.add"]').exists()).toBe(true)
+    })
+
+    it('masque « + Ajouter » sans la permission manage (view seul)', async () => {
+        mockCan.mockImplementation((perm: string) => perm === 'logistique.weighing_tickets.view')
+        const wrapper = mountPage()
+        await flushPromises()
+        expect(wrapper.find('[data-label="logistique.weighingTickets.add"]').exists()).toBe(false)
+    })
+
+    it('navigue vers la modification au clic sur une ligne', async () => {
+        const wrapper = mountPage()
+        await flushPromises()
+        await wrapper.find('tr[data-row-id="9"]').trigger('click')
+        expect(mockPush).toHaveBeenCalledWith('/weighing-tickets/9/edit')
+    })
+
+    it('appelle l\'export XLSX sur /weighing_tickets/export.xlsx en blob', async () => {
+        const wrapper = mountPage()
+        await flushPromises()
+        await wrapper.find('[data-label="logistique.weighingTickets.export"]').trigger('click')
+        await flushPromises()
+        expect(mockApiGet).toHaveBeenCalledWith(
+            '/weighing_tickets/export.xlsx',
+            expect.any(Object),
+            expect.objectContaining({ responseType: 'blob', toast: false }),
+        )
+    })
+})