feat(transport) : exclut les courtiers du select clients (filtre excludeCategoryCode)

src/Module/Commercial/Infrastructure/Doctrine/DoctrineClientRepository.php

@@ -37,6 +37,7 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
         array $categoryCodes = [],
         array $siteIds = [],
         bool $archivedOnly = false,
+        array $excludeCategoryCodes = [],
     ): QueryBuilder {
         // SELECTION uniquement (filtres + tri) : pas de fetch-join to-many ici.
         // L'hydratation des collections affichees (Catégories / Site(s)) est
@@ -57,6 +58,7 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
 
         $this->applySearch($qb, $search);
         $this->applyCategoryCodes($qb, $categoryCodes);
+        $this->applyExcludeCategoryCodes($qb, $excludeCategoryCodes);
         $this->applySiteIds($qb, $siteIds);
 
         return $qb;
@@ -151,6 +153,35 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
         ;
     }
 
+    /**
+     * EXCLUT les clients possedant au moins une categorie dont le code figure
+     * dans la liste (NOT IN). Miroir negatif d'{@see self::applyCategoryCodes()} :
+     * utilise par le module Transport pour ecarter les courtiers (code COURTIER)
+     * des selects clients, sans dependre du nombre de categories d'un client (un
+     * client [COURTIER, DISTRIBUTEUR] est bien exclu). Sous-requete NOT IN pour ne
+     * pas perturber le DISTINCT / ORDER BY principal.
+     *
+     * @param list<string> $excludeCategoryCodes
+     */
+    private function applyExcludeCategoryCodes(QueryBuilder $qb, array $excludeCategoryCodes): void
+    {
+        $codes = $this->normalizeStringList($excludeCategoryCodes);
+        if ([] === $codes) {
+            return;
+        }
+
+        $sub = $this->getEntityManager()->createQueryBuilder()
+            ->select('c3.id')
+            ->from(Client::class, 'c3')
+            ->join('c3.categories', 'cat3')
+            ->where('cat3.code IN (:excludeCategoryCodes)')
+        ;
+
+        $qb->andWhere($qb->expr()->notIn('c.id', $sub->getDQL()))
+            ->setParameter('excludeCategoryCodes', $codes)
+        ;
+    }
+
     /**
      * Restreint aux clients ayant au moins une adresse rattachee a l'un des
      * sites donnes (OR — RG-1.10 : les sites vivent sur les adresses, pas sur le