[ERP-76 + ERP-68] Validations d'adresse client (RG → 422) + fixtures démo Catalog/Commercial (#41)

Stack de 2 tickets sur une branche (squash sur `develop`). ## ERP-76 (#500) — Validations d'adresse Client → 422 Les règles d'intégrité de l'onglet Adresse étaient soit non implémentées (RG-1.29), soit rejetées en 500 par les CHECK Postgres (RG-1.06/07/08/11). Elles sont désormais portées par des `Assert\Callback` applicatifs sur `ClientAddress`, qui remontent une **422 Hydra avant la base** ; les CHECK BDD restent en filet de sécurité. - `validateProspectExclusivity` — `isProspect` exclusif de `isDelivery`/`isBilling` (RG-1.06/07/08). - `validateBillingEmailPresence` — `billingEmail` obligatoire ssi `isBilling` (RG-1.11). - `validateCategoryTypes` — refuse une catégorie de type DISTRIBUTEUR/COURTIER sur une adresse (RG-1.29, violation `categories`), via `CategoryInterface` (règle n°1 respectée). Tests `ClientAddressTest` durcis (≥400 → **422 explicite**) + 4 cas RG-1.29. Cahier de test M1 mis à jour. ## ERP-68 (#486) — Fixtures démo Catalog + Commercial (dev only) - `CategoryFixtures` (Catalog) : 12 catégories sur les 4 types. - `ClientFixtures` (Commercial) : 14 clients couvrant les cas RG (dépendant distributeur/courtier RG-1.03, LCR + 2 RIB RG-1.13, Chèque sans RIB, multi-adresses Prospect/Livraison/Facturation RG-1.06/07/08/11, prospect seul, 3 contacts + tél. secondaire RG-1.05/1.02, archivé RG-1.22, onglet Information complet, multi-catégories M2M). Résolution inter-modules via les seuls contrats Shared (`CategoryInterface`, `SiteProviderInterface`). Valeurs brutes normalisées par `ClientFieldNormalizer`. Données conformes aux CHECK BDD **et** aux validators ERP-76. Idempotentes (lookup `companyName`/`name`). **Garde-fou** : les deux fixtures sont no-op en environnement `test` (la base de test reste un socle minimal ; pas de pollution des comptages ni des cleanups FK). ## Bonus — idempotence fixtures `AppFixtures` (admin/alice/bob) rendu idempotent via lookup par username : `doctrine:fixtures:load --append` est désormais rejouable sans erreur sur tout le jeu de fixtures. ## Vérifications - `make test` : **436/436 vert** (0 échec/erreur). - `make php-cs-fixer-allow-risky` OK. - `make db-reset` charge sans erreur ; 2 runs `--append` consécutifs = idempotent (0 doublon ; 7 users / 14 clients / 12 catégories stables). - `admin/admin` intact. --------- Co-authored-by: Matthieu <contact@malio.fr> Reviewed-on: #41 Co-authored-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr> Co-committed-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
2026-06-01 22:14:23 +00:00
parent 865180e648
commit a52e3bec34
6 changed files with 1005 additions and 57 deletions
@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Catalog\Infrastructure\DataFixtures;
+
+use App\Module\Catalog\Domain\Entity\Category;
+use App\Module\Catalog\Domain\Entity\CategoryType;
+use App\Module\Catalog\Domain\Repository\CategoryTypeRepositoryInterface;
+use Doctrine\Bundle\FixturesBundle\Fixture;
+use Doctrine\Common\DataFixtures\DependentFixtureInterface;
+use Doctrine\Persistence\ObjectManager;
+use RuntimeException;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+/**
+ * Fixtures dev/test du module Catalog : ~12 categories de demonstration reparties
+ * sur les 4 types metier (DISTRIBUTEUR / COURTIER / SECTEUR / AUTRE). Alimente le
+ * repertoire clients (ClientFixtures, module Commercial) avec des donnees
+ * realistes couvrant les categorisations RG-1.03 (DISTRIBUTEUR/COURTIER) et
+ * RG-1.29 (SECTEUR/AUTRE sur adresse).
+ *
+ * Depend de CategoryTypeFixtures : les 4 CategoryType doivent etre seedes avant
+ * de pouvoir y rattacher des Category.
+ *
+ * Idempotence : lookup par (name, categoryType) parmi les categories non
+ * supprimees (deletedAt null), coherent avec l'index unique partiel
+ * uq_category_name_type_active (LOWER(name), category_type_id WHERE deleted_at
+ * IS NULL). Rejouable sans doublon meme si le purger Doctrine est desactive.
+ *
+ * Audit / Blamable : persist hors contexte HTTP -> created_by / updated_by
+ * restent null (« Systeme » cote front), c'est attendu.
+ *
+ * Portee : DONNEES DE DEMONSTRATION (dev uniquement). En environnement `test`,
+ * la fixture ne charge rien : les tests seedent et nettoient leurs propres
+ * categories (prefixe dedie) et comptent sur une table `category` vierge — y
+ * injecter 12 categories de demo casserait comptages et cleanups FK
+ * (client_category). Cf. ClientFixtures (meme garde-fou).
+ */
+class CategoryFixtures extends Fixture implements DependentFixtureInterface
+{
+    /**
+     * Source unique des categories de demonstration : code de type metier =>
+     * liste de noms. Les noms sont stockes tels quels (l'unicite est
+     * case-insensitive cote index).
+     *
+     * @var array<string, list<string>>
+     */
+    private const CATEGORIES = [
+        'SECTEUR' => [
+            'BTP',
+            'Industrie',
+            'Agro-alimentaire',
+            'Transport/Logistique',
+            'Services',
+        ],
+        'DISTRIBUTEUR' => [
+            'Distributeur Grand Sud-Ouest',
+            'Distributeur National Premium',
+            'Grossiste régional',
+        ],
+        'COURTIER' => [
+            'Cabinet de courtage Léonard',
+            'Cabinet de courtage Bernard',
+        ],
+        'AUTRE' => [
+            'Indépendant',
+            'Association',
+        ],
+    ];
+
+    public function __construct(
+        private readonly CategoryTypeRepositoryInterface $categoryTypeRepository,
+        #[Autowire('%kernel.environment%')]
+        private readonly string $environment,
+    ) {}
+
+    /**
+     * @return array<int, class-string>
+     */
+    public function getDependencies(): array
+    {
+        return [CategoryTypeFixtures::class];
+    }
+
+    public function load(ObjectManager $manager): void
+    {
+        // Donnees de demo : dev uniquement. En test, on laisse la table vierge.
+        if ('test' === $this->environment) {
+            return;
+        }
+
+        // Index des types metier par code (CategoryTypeFixtures les a seedes).
+        $typesByCode = [];
+        foreach ($this->categoryTypeRepository->findAllOrderedByLabel() as $type) {
+            $typesByCode[$type->getCode()] = $type;
+        }
+
+        foreach (self::CATEGORIES as $typeCode => $names) {
+            $type = $typesByCode[$typeCode] ?? null;
+            if (!$type instanceof CategoryType) {
+                // Misconfiguration : CategoryTypeFixtures n'a pas tourne avant.
+                throw new RuntimeException(sprintf(
+                    'CategoryTypeFixtures doit avoir seede le type "%s" avant CategoryFixtures.',
+                    $typeCode,
+                ));
+            }
+
+            foreach ($names as $name) {
+                $this->ensureCategory($manager, $name, $type);
+            }
+        }
+
+        $manager->flush();
+    }
+
+    /**
+     * Cree la categorie (name, type) si elle n'existe pas encore parmi les
+     * categories actives, sinon la laisse en place. Lookup aligne sur l'index
+     * unique partiel (nom + type, hors soft-deleted).
+     */
+    private function ensureCategory(ObjectManager $manager, string $name, CategoryType $type): void
+    {
+        $existing = $manager->getRepository(Category::class)->findOneBy([
+            'name'         => $name,
+            'categoryType' => $type,
+            'deletedAt'    => null,
+        ]);
+
+        if (null !== $existing) {
+            return;
+        }
+
+        $category = new Category();
+        $category->setName($name);
+        $category->setCategoryType($type);
+        $manager->persist($category);
+    }
+}