test(logistique) : tests PHPUnit RG-5.01→5.10 + capture contrat JSON (ERP-187)

Couverture des règles de gestion du M5 (tickets de pesée) et capture de la
réponse JSON réelle (DoD § 4.0.bis) avant les écrans front.

Tests unitaires (Processor/Normalizer/Callback, sans BDD ni HTTP) :
- NetWeightTest (RG-5.05) : net = plein − vide, null si pesée manquante, recalcul PATCH.
- CounterpartyValidationTest (RG-5.03) : présence par branche (propertyPath) + exclusivité.
- ImmatriculationNormalizationTest (RG-5.01/5.10) : masque XX-000-XX, « Tout format », 422.

Tests fonctionnels (API réelle) :
- WeighingTicketNumberingTest (RG-5.02/5.09) : format {siteCode}-TP-{NNNN}, séquence
  par site, isolation inter-sites, immuabilité numéro/site au PATCH.
- WeighingTicketSerializationContractTest (DoD § 4.0.bis) : 4 pièges (client embarqué,
  plateFreeFormat présent, number formaté, netWeight = full − empty) + dump JSON.
- WeighingTicketRBACMatrixTest (§ 5.2) : admin/bureau/usine OK, compta/commerciale 403,
  anonyme 401.

DSD/stub/reading déjà couverts (ERP-184/185). spec-back.md § 4.0.bis : JSON réel collé.

tests/Module/Logistique/Api/WeighingTicketSerializationContractTest.php

@@ -0,0 +1,101 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Module\Logistique\Api;
+
+/**
+ * Contrat de serialisation du ticket de pesee (M5, spec-back § 4.0 / § 4.0.bis).
+ * Jumeau de {@see \App\Tests\Module\Transport\Api\CarrierSerializationContractTest}.
+ *
+ * Capture le JSON REEL (liste + detail) via un ticket cree par l'API (numerotation
+ * serveur reelle) et reverifie les 4 pieges du RETEX M1 transposes au M5 :
+ *  #1 : `client` (et `supplier`) sortent en OBJET embarque, pas en IRI nu
+ *       (read-groups client:read / supplier:read).
+ *  #2 : booleen `plateFreeFormat` present dans le JSON (getter + SerializedName).
+ *  #3 : `number` present, formate {siteCode}-TP-{NNNN}.
+ *  #4 : `netWeight` coherent = full - empty (plein - vide, RG-5.05).
+ *
+ * REGLE D'OR : on asserte sur le CORPS JSON reel, jamais sur les annotations.
+ * DoD (§ 4.0.bis) : avec WEIGHING_TICKET_DOD_DUMP positionnee, ecrit les corps
+ * liste + detail sous /tmp pour les coller dans la spec avant les ecrans front.
+ *
+ * @internal
+ */
+final class WeighingTicketSerializationContractTest extends AbstractWeighingTicketApiTestCase
+{
+    public function testListAndDetailSerializationContract(): void
+    {
+        $site         = $this->siteByCode('86');
+        $http         = $this->authManageOnSite($site);
+        $clientEntity = $this->seedTestClient('Negoce');
+
+        $created = $this->postTicket($http, $this->validClientTicketPayload($clientEntity));
+        self::assertResponseStatusCodeSame(201);
+        $createdBody = $created->toArray();
+
+        $id     = (int) $createdBody['id'];
+        $number = (string) $createdBody['number'];
+
+        $detail = $http->request('GET', '/api/weighing_tickets/'.$id, ['headers' => ['Accept' => self::LD]])->toArray();
+        $list   = $http->request('GET', '/api/weighing_tickets?search='.$number, ['headers' => ['Accept' => self::LD]])->toArray();
+
+        // Enveloppe Hydra AP4 (member/totalItems sans prefixe hydra:).
+        self::assertArrayHasKey('member', $list);
+        self::assertArrayNotHasKey('hydra:member', $list);
+
+        $row = $this->memberById($list, $id);
+        self::assertNotNull($row, 'Le ticket cree doit apparaitre dans la liste filtree.');
+
+        // === Piege #1 : relations embarquees en OBJET (pas IRI nu) ===
+        self::assertIsArray($row['client'], 'client doit etre un objet embarque (client:read), pas un IRI nu.');
+        self::assertArrayHasKey('companyName', $row['client']);
+        // supplier null sur une contrepartie Client (cle potentiellement omise par
+        // skip_null_values — tolerant aux deux cas, jamais un IRI nu).
+        self::assertNull($row['supplier'] ?? null);
+
+        // === Piege #2 : booleen plateFreeFormat present ===
+        self::assertArrayHasKey('plateFreeFormat', $row);
+        self::assertFalse($row['plateFreeFormat']);
+
+        // === Piege #3 : number formate {siteCode}-TP-{NNNN} ===
+        self::assertArrayHasKey('number', $row);
+        self::assertMatchesRegularExpression('/^86-TP-\d{4}$/', $row['number']);
+
+        // === Piege #4 : netWeight = full - empty (14300 - 7150) ===
+        self::assertSame(7150, $row['netWeight']);
+
+        // displayDate (date du ticket = fullDate ?? emptyDate) expose en liste.
+        self::assertArrayHasKey('displayDate', $row);
+
+        // === DETAIL : site embarque (avec code), immatriculation, les 2 pesees ===
+        self::assertIsArray($detail['site']);
+        self::assertSame('86', $detail['site']['code']);
+        self::assertSame('AB-123-CD', $detail['immatriculation']);
+        self::assertSame(7150, $detail['emptyWeight']);
+        self::assertSame(14300, $detail['fullWeight']);
+        self::assertSame(7150, $detail['netWeight']);
+        self::assertIsArray($detail['client']);
+        self::assertArrayHasKey('companyName', $detail['client']);
+
+        $this->dumpDodIfRequested($list, $detail);
+    }
+
+    /**
+     * DoD (§ 4.0.bis) : ecrit les corps JSON reels sous /tmp si WEIGHING_TICKET_DOD_DUMP
+     * est positionnee (sinon no-op). A coller dans spec-back.md § 4.0.bis.
+     *
+     * @param array<string, mixed> $list
+     * @param array<string, mixed> $detail
+     */
+    private function dumpDodIfRequested(array $list, array $detail): void
+    {
+        if (false === getenv('WEIGHING_TICKET_DOD_DUMP')) {
+            return;
+        }
+
+        $flags = JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES;
+        file_put_contents('/tmp/weighing-ticket-dod-list.json', json_encode($list, $flags));
+        file_put_contents('/tmp/weighing-ticket-dod-detail.json', json_encode($detail, $flags));
+    }
+}