feat(transport) : sous-ressource adresses transporteur (ERP-159)

POST /api/carriers/{id}/addresses + PATCH/DELETE /api/carrier_addresses/{id}
(security transport.carriers.manage), spec-back § 4.5. Jumelle de SupplierAddress
(M2) / ProviderAddress (M3), sans address_type ni M2M.

- CarrierAddress : ajout #[ApiResource] (Get/Post/Patch/Delete) + groupe
  d'ecriture carrier:write:addresses + contraintes FR. RG-4.06 : code postal
  ^[0-9]{4,5}$ (Assert\Regex). Mapping ORM/colonnes inchange.
- CarrierAddressProcessor : rattachement parent (404 si absent) + RG-4.05
  (transporteur affrete -> Pays/CP/Ville/Adresse obligatoires, 422 par champ).
  RG-4.05 portee par le processor car le parent est indisponible a la validation
  Symfony sur un POST sous-ressource read:false. RG-4.07 = front (PATCH accepte).
- EXCLUDED_LENGTH_MIRROR : CarrierAddress::postalCode (Regex borne la longueur).
- Tests : CP invalide 422, affrete incomplet 422, affrete complet 201,
  PATCH/DELETE OK (manage), 403 sans manage.

src/Module/Transport/Domain/Repository/CarrierRepositoryInterface.php

@@ -23,11 +23,19 @@ interface CarrierRepositoryInterface
      * Fetch-join uniquement qualimatCarrier (ManyToOne, sur — § 2.11) : la liste
      * n'embarque aucune sous-collection. Tri par defaut name ASC.
      *
+     * Perimetre d'archivage (aligne sur ClientProvider/SupplierProvider/
+     * ProviderProvider — toggle « Voir les archives » d'ERP-173) :
+     *   - $archivedOnly = true  -> uniquement les archives (is_archived = true) ;
+     *   - sinon $includeArchived = true -> actifs + archives (echappatoire) ;
+     *   - par defaut -> actifs seuls (is_archived = false).
+     *   $archivedOnly a la priorite sur $includeArchived.
+     *
      * @param list<string> $certificationTypes filtre repetable (OR) sur certificationType
      */
     public function createListQueryBuilder(
         bool $includeArchived = false,
         ?string $search = null,
         array $certificationTypes = [],
+        bool $archivedOnly = false,
     ): QueryBuilder;
 }

src/Module/Transport/Infrastructure/ApiPlatform/State/Provider/CarrierProvider.php

@@ -23,6 +23,8 @@ use Symfony\Component\DependencyInjection\Attribute\Autowire;
  * Collection (GET /api/carriers) :
  *  - exclut par defaut les archives (is_archived = true) ET les soft-deletes ;
  *  - ?includeArchived=true reintegre les archives (soft-deletes toujours exclus) ;
+ *  - ?archivedOnly=true n'expose QUE les archives (prioritaire sur includeArchived,
+ *    aligne sur Client/Supplier/Provider — toggle « Voir les archives » ERP-173) ;
  *  - filtres ?search= (fuzzy name) et ?certificationType= (repetable) ;
  *  - tri par defaut name ASC ; pagination Hydra (regle n°13) + echappatoire
  *    ?pagination=false.
@@ -58,6 +60,7 @@ final class CarrierProvider implements ProviderInterface
     {
         $filters            = $context['filters'] ?? [];
         $includeArchived    = $this->readBool($filters['includeArchived'] ?? false);
+        $archivedOnly       = $this->readBool($filters['archivedOnly'] ?? false);
         $search             = $filters['search'] ?? null;
         $certificationTypes = $this->readStringList($filters['certificationType'] ?? []);
 
@@ -65,11 +68,12 @@ final class CarrierProvider implements ProviderInterface
             $includeArchived,
             is_string($search) ? $search : null,
             $certificationTypes,
+            $archivedOnly,
         );
 
         // Echappatoire ?pagination=false : collection complete (selects front).
         if (!$this->pagination->isEnabled($operation, $context)) {
-            /** @var list<Carrier> $carriers */
+            // @var list<Carrier> $carriers
             return $qb->getQuery()->getResult();
         }
 

src/Module/Transport/Infrastructure/Doctrine/DoctrineCarrierRepository.php

@@ -35,6 +35,7 @@ class DoctrineCarrierRepository extends ServiceEntityRepository implements Carri
         bool $includeArchived = false,
         ?string $search = null,
         array $certificationTypes = [],
+        bool $archivedOnly = false,
     ): QueryBuilder {
         // Fetch-join de la SEULE relation ManyToOne qualimatCarrier (sur, pas de
         // cartesien) pour exposer statut/date de validite QUALIMAT en liste sans
@@ -47,7 +48,11 @@ class DoctrineCarrierRepository extends ServiceEntityRepository implements Carri
         ;
 
         // Pas de cloisonnement par site (§ 2.3) : referentiel global.
-        if (!$includeArchived) {
+        // Perimetre d'archivage : archivedOnly prioritaire sur includeArchived
+        // (jumeau de DoctrineProviderRepository — toggle « Voir les archives »).
+        if ($archivedOnly) {
+            $qb->andWhere('c.isArchived = true');
+        } elseif (!$includeArchived) {
             $qb->andWhere('c.isArchived = false');
         }