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>

src/Module/Logistique/Domain/Entity/WeighingTicket.php

@@ -12,6 +12,7 @@ use ApiPlatform\Metadata\Post;
 use App\Module\Commercial\Domain\Entity\Client;     // relation ORM partagee (§ 2.1)
 use App\Module\Commercial\Domain\Entity\Supplier;   // relation ORM partagee (§ 2.1)
 use App\Module\Logistique\Infrastructure\ApiPlatform\State\Processor\WeighingTicketProcessor;
+use App\Module\Logistique\Infrastructure\ApiPlatform\State\Provider\WeighingTicketPrintProvider;
 use App\Module\Logistique\Infrastructure\ApiPlatform\State\Provider\WeighingTicketProvider;
 use App\Module\Logistique\Infrastructure\Doctrine\DoctrineWeighingTicketRepository;
 use App\Module\Sites\Domain\Entity\Site;            // relation ORM partagee (§ 2.1)
@@ -84,6 +85,18 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
             ]],
             provider: WeighingTicketProvider::class,
         ),
+        // Bon de pesee PDF (RG-5.08, spec § 2.12 / § 4.6) : operation dediee qui
+        // sert un binaire (pas une representation Hydra). Le provider retourne une
+        // Response -> la serialisation est court-circuitee. Pas de controller
+        // (decision spec § 4.6). Pas de format API Platform negocie : `.pdf` est
+        // litteral dans l'URI.
+        new Get(
+            uriTemplate: '/weighing_tickets/{id}/print.pdf',
+            security: "is_granted('logistique.weighing_tickets.view')",
+            provider: WeighingTicketPrintProvider::class,
+            output: false,
+            read: true,
+        ),
         new Post(
             security: "is_granted('logistique.weighing_tickets.manage')",
             normalizationContext: ['groups' => [
@@ -95,6 +108,10 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
                 'default:read',
             ]],
             denormalizationContext: ['groups' => ['weighing_ticket:write']],
+            // Erreurs de denormalisation (date non parsable, type/IRI invalide)
+            // remontees en 422 avec propertyPath (et non 400 opaque) -> mapping
+            // inline par champ cote front via useFormErrors (miroir M1 Client).
+            collectDenormalizationErrors: true,
             processor: WeighingTicketProcessor::class,
         ),
         new Patch(
@@ -108,6 +125,30 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
                 'default:read',
             ]],
             denormalizationContext: ['groups' => ['weighing_ticket:write']],
+            collectDenormalizationErrors: true,
+            provider: WeighingTicketProvider::class,
+            processor: WeighingTicketProcessor::class,
+        ),
+        // Validation (« Valider », ERP-193) : transition brouillon -> valide. Seule
+        // operation qui exige le groupe `finalize` (contrepartie + immatriculation +
+        // les 2 pesees, § 2.14) ; le Processor y attribue le numero et passe status
+        // a VALIDATED. Le POST/PATCH standard restent « brouillon » (validation
+        // Default relachee, on enregistre une pesee sans contrepartie/immat).
+        new Patch(
+            uriTemplate: '/weighing_tickets/{id}/validate',
+            name: 'weighing_ticket_validate',
+            security: "is_granted('logistique.weighing_tickets.manage')",
+            normalizationContext: ['groups' => [
+                'weighing_ticket:read',
+                'weighing_ticket:item:read',
+                'client:read',
+                'supplier:read',
+                'site:read',
+                'default:read',
+            ]],
+            denormalizationContext: ['groups' => ['weighing_ticket:write']],
+            validationContext: ['groups' => ['Default', 'finalize']],
+            collectDenormalizationErrors: true,
             provider: WeighingTicketProvider::class,
             processor: WeighingTicketProcessor::class,
         ),
@@ -128,14 +169,20 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
 {
     use TimestampableBlamableTrait;
 
+    /** Brouillon : pesee(s) enregistree(s), pas encore valide (« En attente »). */
+    public const string STATUS_DRAFT = 'DRAFT';
+
+    /** Valide : contrepartie + immatriculation + 2 pesees OK, numero attribue (« Terminée »). */
+    public const string STATUS_VALIDATED = 'VALIDATED';
+
     #[ORM\Id]
     #[ORM\GeneratedValue]
     #[ORM\Column]
     #[Groups(['weighing_ticket:read'])]
     private ?int $id = null;
 
-    /** Numero {siteCode}-TP-{NNNN} — attribue serveur, lecture seule, immuable (RG-5.02). */
-    #[ORM\Column(length: 20)]
+    /** Numero {siteCode}-TP-{NNNN} — attribue serveur a la VALIDATION, null tant que brouillon, immuable ensuite (RG-5.02, ERP-193). */
+    #[ORM\Column(length: 20, nullable: true)]
     #[Groups(['weighing_ticket:read'])]
     private ?string $number = null;
 
@@ -145,9 +192,9 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
     #[Groups(['weighing_ticket:item:read'])]
     private ?Site $site = null;
 
-    /** CLIENT | FOURNISSEUR | AUTRE (RG-5.03) — pilote le champ associe obligatoire. */
-    #[ORM\Column(name: 'counterparty_type', length: 12)]
-    #[Assert\NotBlank(message: 'La contrepartie (Client / Fournisseur / Autre) est obligatoire.')]
+    /** CLIENT | FOURNISSEUR | AUTRE (RG-5.03) — null tant que brouillon, requis a la validation. Pilote le champ associe obligatoire. */
+    #[ORM\Column(name: 'counterparty_type', length: 12, nullable: true)]
+    #[Assert\NotBlank(message: 'La contrepartie (Client / Fournisseur / Autre) est obligatoire.', groups: ['finalize'])]
     #[Assert\Choice(choices: ['CLIENT', 'FOURNISSEUR', 'AUTRE'], message: 'Type de contrepartie invalide.')]
     #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
     private ?string $counterpartyType = null;
@@ -170,9 +217,9 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
     #[Groups(['weighing_ticket:read', 'weighing_ticket:write'])]
     private ?string $otherLabel = null;
 
-    /** Plaque du vehicule, partagee entre les 2 formulaires (RG-5.01). Masque XX-000-XX sauf plateFreeFormat. */
-    #[ORM\Column(length: 20)]
-    #[Assert\NotBlank(message: 'L\'immatriculation est obligatoire.', normalizer: 'trim')]
+    /** Plaque du vehicule, partagee entre les 2 formulaires (RG-5.01). Null tant que brouillon, requise a la validation. Masque XX-000-XX sauf plateFreeFormat. */
+    #[ORM\Column(length: 20, nullable: true)]
+    #[Assert\NotBlank(message: 'L\'immatriculation est obligatoire.', normalizer: 'trim', groups: ['finalize'])]
     #[Assert\Length(max: 20, maxMessage: 'L\'immatriculation ne peut pas dépasser {{ limit }} caractères.', normalizer: 'trim')]
     #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
     private ?string $immatriculation = null;
@@ -190,7 +237,12 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
     #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
     private ?DateTimeImmutable $emptyDate = null;
 
-    /** Poids a vide (tare) en kg — readonly UI, rempli par la pesee (RG-5.07). */
+    /**
+     * Poids a vide (tare) en kg — readonly UI, rempli par la pesee (RG-5.07).
+     * Nullable au brouillon (on peut enregistrer la seule pesee a plein d'abord,
+     * ERP-193). L'obligation des DEUX pesees est portee par validateFinalization
+     * (groupe `finalize`), jouee uniquement a la validation.
+     */
     #[ORM\Column(name: 'empty_weight', nullable: true)]
     #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
     private ?int $emptyWeight = null;
@@ -205,12 +257,6 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
     #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
     private ?string $emptyMode = null;
 
-    /** Numero de pesee saisi en manuelle (distinct du DSD) — RG-5.04. */
-    #[ORM\Column(name: 'empty_manual_number', length: 50, nullable: true)]
-    #[Assert\Length(max: 50, maxMessage: 'Le numéro de pesée ne peut pas dépasser {{ limit }} caractères.', normalizer: 'trim')]
-    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
-    private ?string $emptyManualNumber = null;
-
     // === Pesee a plein (§ 2.4) ===
 
     #[ORM\Column(name: 'full_date', type: 'datetime_immutable', nullable: true)]
@@ -232,17 +278,21 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
     #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
     private ?string $fullMode = null;
 
-    /** Numero de pesee saisi en manuelle (distinct du DSD) — RG-5.04. */
-    #[ORM\Column(name: 'full_manual_number', length: 50, nullable: true)]
-    #[Assert\Length(max: 50, maxMessage: 'Le numéro de pesée ne peut pas dépasser {{ limit }} caractères.', normalizer: 'trim')]
-    #[Groups(['weighing_ticket:item:read', 'weighing_ticket:write'])]
-    private ?string $fullManualNumber = null;
-
     /** Poids net derive plein - vide (kg) — calcule serveur (RG-5.05). Colonne Poids de la liste. */
     #[ORM\Column(name: 'net_weight', nullable: true)]
     #[Groups(['weighing_ticket:read'])]
     private ?int $netWeight = null;
 
+    /**
+     * Cycle de vie (ERP-193) : DRAFT (« En attente » — pesee enregistree sans
+     * contrepartie/immat) -> VALIDATED (« Terminée » — valide avec numero). Pose
+     * serveur (DRAFT a la creation, VALIDATED par l'operation `validate`) ; pas de
+     * groupe d'ecriture (jamais pilote par le client).
+     */
+    #[ORM\Column(length: 12, options: ['default' => self::STATUS_DRAFT])]
+    #[Groups(['weighing_ticket:read'])]
+    private string $status = self::STATUS_DRAFT;
+
     /** Soft-delete technique prepare mais non expose au M5 (§ 2.13) — pas de groupe. */
     #[ORM\Column(name: 'deleted_at', type: 'datetime_immutable', nullable: true)]
     private ?DateTimeImmutable $deletedAt = null;
@@ -259,7 +309,7 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
      * (chk_wt_*_branch) et la normalisation du Processor (qui null-ifie les
      * champs hors-branche — ERP-185).
      */
-    #[Assert\Callback]
+    #[Assert\Callback(groups: ['finalize'])]
     public function validateCounterpartyConsistency(ExecutionContextInterface $context): void
     {
         switch ($this->counterpartyType) {
@@ -295,6 +345,31 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
         }
     }
 
+    /**
+     * Validation finale (ERP-193, § 2.14) : un ticket ne peut etre VALIDE qu'avec
+     * ses DEUX pesees renseignees (le poids net plein - vide n'a de sens que
+     * complet). Jouee uniquement dans le groupe `finalize` (operation `validate`) ;
+     * un brouillon peut ne porter qu'une seule pesee. Violations posees sur les
+     * champs poids -> mapping inline front (useFormErrors, ERP-101).
+     */
+    #[Assert\Callback(groups: ['finalize'])]
+    public function validateFinalization(ExecutionContextInterface $context): void
+    {
+        if (null === $this->emptyWeight) {
+            $context->buildViolation('La pesée à vide est obligatoire pour valider le ticket.')
+                ->atPath('emptyWeight')
+                ->addViolation()
+            ;
+        }
+
+        if (null === $this->fullWeight) {
+            $context->buildViolation('La pesée à plein est obligatoire pour valider le ticket.')
+                ->atPath('fullWeight')
+                ->addViolation()
+            ;
+        }
+    }
+
     /**
      * Date du ticket affichee en LISTE (§ 4.0) : date de la pesee a plein si
      * disponible, sinon date de la pesee a vide. Getter calcule (jamais
@@ -459,18 +534,6 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
         return $this;
     }
 
-    public function getEmptyManualNumber(): ?string
-    {
-        return $this->emptyManualNumber;
-    }
-
-    public function setEmptyManualNumber(?string $emptyManualNumber): static
-    {
-        $this->emptyManualNumber = $emptyManualNumber;
-
-        return $this;
-    }
-
     public function getFullDate(): ?DateTimeImmutable
     {
         return $this->fullDate;
@@ -519,18 +582,6 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
         return $this;
     }
 
-    public function getFullManualNumber(): ?string
-    {
-        return $this->fullManualNumber;
-    }
-
-    public function setFullManualNumber(?string $fullManualNumber): static
-    {
-        $this->fullManualNumber = $fullManualNumber;
-
-        return $this;
-    }
-
     public function getNetWeight(): ?int
     {
         return $this->netWeight;
@@ -543,6 +594,23 @@ class WeighingTicket implements TimestampableInterface, BlamableInterface
         return $this;
     }
 
+    public function getStatus(): string
+    {
+        return $this->status;
+    }
+
+    public function setStatus(string $status): static
+    {
+        $this->status = $status;
+
+        return $this;
+    }
+
+    public function isValidated(): bool
+    {
+        return self::STATUS_VALIDATED === $this->status;
+    }
+
     public function getDeletedAt(): ?DateTimeImmutable
     {
         return $this->deletedAt;