feat(commercial) : catégories de type Adresse pour les blocs adresse (client + fournisseur) (#147)

## Objectif Introduit un `CategoryType` dédié **ADRESSE** (module Catalog) consommé par le champ « Catégorie » des blocs adresse, en remplacement de la réutilisation détournée des types CLIENT / FOURNISSEUR. ## Changements **Backend** - Migration de seed du type ADRESSE + 6 catégories : Siège, Contact issues, Facturation, Livraison, Approvisionnement, Méthaniseur (idempotente, réversible) ; fixtures alignées. - `ClientAddress` : validation blacklist (DISTRIBUTEUR/COURTIER) remplacée par une whitelist « catégories de type ADRESSE uniquement ». - `SupplierAddress` : type requis FOURNISSEUR → ADRESSE (le bloc principal fournisseur reste en FOURNISSEUR). **Frontend** - Ref dédiée `addressCategories` (`?typeCode=ADRESSE`) dans les composables référentiels client et fournisseur. - Pages new/edit client et fournisseur câblées sur les blocs adresse. **Tests** - `CategoryAdresseSeedTest` (miroir du test PRESTATAIRE). - Adaptation des tests d'adresse client/fournisseur (sémantique whitelist ADRESSE) + helper `createAddressCategory()`. ## Vérifications - Back : suites Catalog + Architecture + adresse/fournisseur vertes (le flake JWT connu du hook est sans rapport, tests verts en isolation). - Front : Vitest vert (composables référentiels + ciblés). - php-cs-fixer : 0 correction ; eslint : OK. Reviewed-on: #147 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
2026-06-25 07:26:21 +00:00
parent 2e50a760c6
commit efded9fd40
22 changed files with 444 additions and 168 deletions
@@ -18,8 +18,10 @@ use Symfony\Component\DependencyInjection\Attribute\Autowire;
 * a leur CategoryType. Le type CLIENT porte ~11 categories clients (refonte
 * taxonomie ERP-78) ; le type FOURNISSEUR porte les categories fournisseurs
 * (ERP-84 : Negociant, Cooperative...) ; le type PRESTATAIRE porte les categories
- * prestataires (M3 1.1 : Maintenance industrielle, Nettoyage, Transport). Chaque
- * categorie porte un `code` stable.
+ * prestataires (M3 1.1 : Maintenance industrielle, Nettoyage, Transport) ; le type
+ * ADRESSE porte les categories des blocs adresse (Siege, Contact issues,
+ * Facturation, Livraison, Approvisionnement, Methaniseur). Chaque categorie porte
+ * un `code` stable.
 * Alimente le repertoire clients (ClientFixtures, module Commercial) avec des
 * donnees realistes couvrant RG-1.03 (codes DISTRIBUTEUR / COURTIER) et RG-1.29
 * (codes interdits sur adresse), et le multi-select Categorie fournisseur (M2).
@@ -78,6 +80,14 @@ class CategoryFixtures extends Fixture implements DependentFixtureInterface
            'Nettoyage'                => 'NETTOYAGE',
            'Transport'                => 'TRANSPORT',
        ],
+        'ADRESSE' => [
+            'Siège'             => 'SIEGE',
+            'Contact issues'    => 'CONTACT_ISSUES',
+            'Facturation'       => 'FACTURATION',
+            'Livraison'         => 'LIVRAISON',
+            'Approvisionnement' => 'APPROVISIONNEMENT',
+            'Méthaniseur'       => 'METHANISEUR',
+        ],
    ];

    public function __construct(
@@ -25,6 +25,10 @@ use Doctrine\Persistence\ObjectManager;
 * taxonomie distincte des prestataires (Maintenance industrielle, Nettoyage,
 * Transport). Mirroir de la migration Version20260612080000.
 *
+ * ADRESSE : ajout du type ADRESSE (code ADRESSE, label « Adresse »), taxonomie
+ * dediee au champ « Categorie » des blocs adresse (client + fournisseur). Mirroir
+ * de la migration Version20260625100000.
+ *
 * Pourquoi une fixture EN PLUS du seed de la migration : `category_type` est une
 * entite managee par l ORM, donc le purger Doctrine la vide avant chaque
 * `doctrine:fixtures:load`. Sans cette fixture, le type CLIENT seede par la
@@ -41,12 +45,14 @@ class CategoryTypeFixtures extends Fixture
    /**
     * Source unique des types : code technique => libelle FR. Doit rester aligne
     * sur le seed des migrations Version20260602100000 (CLIENT),
-     * Version20260605120000 (FOURNISSEUR) et Version20260612080000 (PRESTATAIRE).
+     * Version20260605120000 (FOURNISSEUR), Version20260612080000 (PRESTATAIRE) et
+     * Version20260625100000 (ADRESSE).
     */
    private const TYPES = [
        'CLIENT'      => 'Client',
        'FOURNISSEUR' => 'Fournisseur',
        'PRESTATAIRE' => 'Prestataire',
+        'ADRESSE'     => 'Adresse',
    ];

    public function __construct(
@@ -42,7 +42,7 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
 *  - sites : SiteInterface (module Sites) via resolve_target_entities
 *  - contacts : ClientContact (meme module)
 *  - categories : CategoryInterface (module Catalog) via resolve_target_entities
- *    — codes DISTRIBUTEUR/COURTIER interdits (RG-1.29, validateCategoryCodes, ERP-78)
+ *    — type ADRESSE attendu (validateCategoryType)
 *
 * Audite (#[Auditable]) + Timestampable/Blamable.
 *
@@ -96,11 +96,11 @@ class ClientAddress implements TimestampableInterface, BlamableInterface, Client
    use TimestampableBlamableTrait;

    /**
-     * RG-1.29 (ERP-78) : ces codes de categorie decrivent une relation entre
-     * clients (distributeur / courtier) et n'ont pas de sens sur une adresse.
-     * Toute autre categorie du type CLIENT est autorisee.
+     * Seules les categories PORTANT ce type sont autorisees sur une adresse client.
+     * S'appuie sur CategoryInterface::getCategoryTypeCodes() (multi-type — pas
+     * d'import du module Catalog, regle ABSOLUE n°1).
     */
-    private const array FORBIDDEN_CATEGORY_CODES = ['DISTRIBUTEUR', 'COURTIER'];
+    private const string REQUIRED_CATEGORY_TYPE_CODE = 'ADRESSE';

    #[ORM\Id]
    #[ORM\GeneratedValue]
@@ -215,7 +215,7 @@ class ClientAddress implements TimestampableInterface, BlamableInterface, Client
    private Collection $contacts;

    // Au moins une categorie est obligatoire sur une adresse (spec-front § Adresse).
-    // RG-1.29 : categories de code DISTRIBUTEUR/COURTIER interdites (validateCategoryCodes).
+    // Categories de type ADRESSE uniquement (validateCategoryType).
    /** @var Collection<int, CategoryInterface> */
    #[ORM\ManyToMany(targetEntity: CategoryInterface::class)]
    #[ORM\JoinTable(name: 'client_address_category')]
@@ -335,20 +335,19 @@ class ClientAddress implements TimestampableInterface, BlamableInterface, Client
    }

    /**
-     * RG-1.29 (ERP-78) : une adresse interdit les categories de code
-     * DISTRIBUTEUR / COURTIER — elles decrivent une relation entre clients
-     * (RG-1.03) et n'ont pas de sens sur une adresse physique -> 422 avec
-     * violation sur le champ `categories`. Toute autre categorie (type unique
-     * CLIENT) est acceptee. S'appuie sur CategoryInterface::getCode() (pas
-     * d'import du module Catalog — regle ABSOLUE n°1).
+     * Toute categorie posee sur une adresse client doit etre de type ADRESSE ->
+     * sinon 422 avec violation sur le champ `categories`. S'appuie sur
+     * CategoryInterface::getCategoryTypeCodes() (multi-type — la categorie est
+     * acceptee des qu'elle PORTE le type ADRESSE ; pas d'import du module Catalog,
+     * regle ABSOLUE n°1).
     */
    #[Assert\Callback]
-    public function validateCategoryCodes(ExecutionContextInterface $context): void
+    public function validateCategoryType(ExecutionContextInterface $context): void
    {
        foreach ($this->categories as $category) {
            if ($category instanceof CategoryInterface
-                && in_array($category->getCode(), self::FORBIDDEN_CATEGORY_CODES, true)) {
-                $context->buildViolation('Type de catégorie non autorisé sur une adresse.')
+                && !in_array(self::REQUIRED_CATEGORY_TYPE_CODE, $category->getCategoryTypeCodes(), true)) {
+                $context->buildViolation('Type de catégorie non autorisé (ADRESSE attendu).')
                    ->atPath('categories')
                    ->addViolation()
                ;
@@ -40,7 +40,7 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
 *    un site obligatoire (RG-2.06, Assert\Count). Site n'a pas de `code`.
 *  - contacts : SupplierContact (meme module).
 *  - categories : CategoryInterface (module Catalog) via resolve_target_entities —
- *    type FOURNISSEUR attendu (RG-2.10, Assert\Callback validateCategoryType).
+ *    type ADRESSE attendu (Assert\Callback validateCategoryType).
 *
 * Embarquee sous `supplier.addresses` au detail (groupe supplier:item:read,
 * maillon (a)).
@@ -110,11 +110,11 @@ class SupplierAddress implements TimestampableInterface, BlamableInterface, Supp
    public const array ADDRESS_TYPES = ['PROSPECT', 'DEPART', 'RENDU'];

    /**
-     * RG-2.10 : seules les categories PORTANT ce type sont autorisees sur une
-     * adresse fournisseur. S'appuie sur CategoryInterface::getCategoryTypeCodes()
-     * (pas d'import du module Catalog — regle ABSOLUE n°1).
+     * Seules les categories PORTANT ce type sont autorisees sur une adresse
+     * fournisseur. S'appuie sur CategoryInterface::getCategoryTypeCodes() (pas
+     * d'import du module Catalog — regle ABSOLUE n°1).
     */
-    private const string REQUIRED_CATEGORY_TYPE_CODE = 'FOURNISSEUR';
+    private const string REQUIRED_CATEGORY_TYPE_CODE = 'ADRESSE';

    #[ORM\Id]
    #[ORM\GeneratedValue]
@@ -208,8 +208,8 @@ class SupplierAddress implements TimestampableInterface, BlamableInterface, Supp
    #[Groups(['supplier:item:read', 'supplier:write:addresses'])]
    private Collection $contacts;

-    // RG-2.10 : au moins une categorie de type FOURNISSEUR par adresse (le type est
-    // controle par validateCategoryType ; le minimum par Assert\Count, miroir sites).
+    // Au moins une categorie de type ADRESSE par adresse (le type est controle par
+    // validateCategoryType ; le minimum par Assert\Count, miroir sites).
    /** @var Collection<int, CategoryInterface> */
    #[ORM\ManyToMany(targetEntity: CategoryInterface::class)]
    #[ORM\JoinTable(name: 'supplier_address_category')]
@@ -227,12 +227,12 @@ class SupplierAddress implements TimestampableInterface, BlamableInterface, Supp
    }

    /**
-     * RG-2.10 : toute categorie posee sur une adresse fournisseur doit etre de
-     * type FOURNISSEUR -> sinon 422 avec violation sur le champ `categories`
-     * (propertyPath aligne ERP-101, message FR ERP-107). S'appuie sur
+     * Toute categorie posee sur une adresse fournisseur doit etre de type ADRESSE
+     * -> sinon 422 avec violation sur le champ `categories` (propertyPath aligne
+     * ERP-101, message FR ERP-107). S'appuie sur
     * CategoryInterface::getCategoryTypeCodes() (multi-type — la categorie est
-     * acceptee des qu'elle PORTE le type FOURNISSEUR ; pas d'import du module
-     * Catalog, regle ABSOLUE n°1). Joue avant la base via la validation API Platform.
+     * acceptee des qu'elle PORTE le type ADRESSE ; pas d'import du module Catalog,
+     * regle ABSOLUE n°1). Joue avant la base via la validation API Platform.
     */
    #[Assert\Callback]
    public function validateCategoryType(ExecutionContextInterface $context): void
@@ -240,7 +240,7 @@ class SupplierAddress implements TimestampableInterface, BlamableInterface, Supp
        foreach ($this->categories as $category) {
            if ($category instanceof CategoryInterface
                && !in_array(self::REQUIRED_CATEGORY_TYPE_CODE, $category->getCategoryTypeCodes(), true)) {
-                $context->buildViolation('Type de catégorie non autorisé (FOURNISSEUR attendu).')
+                $context->buildViolation('Type de catégorie non autorisé (ADRESSE attendu).')
                    ->atPath('categories')
                    ->addViolation()
                ;
@@ -55,8 +55,7 @@ use Symfony\Component\DependencyInjection\Attribute\Autowire;
 * Audit / Blamable : persist hors contexte HTTP -> created_by / updated_by
 * restent null (« Systeme » cote front), c'est attendu. Les donnees respectent
 * les CHECK BDD ET les validators applicatifs (exclusivite Prospect, billingEmail
- * ssi facturation, aucune categorie de code DISTRIBUTEUR/COURTIER sur une adresse
- * — RG-1.29, ERP-78).
+ * ssi facturation, categories de type ADRESSE sur les adresses).
 *
 * Depend de CategoryFixtures (categories), SitesFixtures (sites) et
 * CommercialReferentialFixtures (referentiels comptables Bank / PaymentType).
@@ -116,7 +115,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
        );
        if ($gsoIsNew) {
            $this->addContact($gso, 'Paul', 'Garnier', 'Directeur commercial', '05 56 10 20 30', null, 'paul.garnier@distrib-gso.fr');
-            $this->addAddress($gso, ['Pommevic'], '82400', 'Pommevic', '1 Av. Jean Duquesne', isDelivery: true, categoryNames: ['Transport/Logistique']);
+            $this->addAddress($gso, ['Pommevic'], '82400', 'Pommevic', '1 Av. Jean Duquesne', isDelivery: true, categoryNames: ['Livraison']);
        }

        // Courtier reference par d'autres clients.
@@ -140,7 +139,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
            $dubois->setPaymentType($this->paymentType($manager, 'VIREMENT'));
            $dubois->setBank($this->bank($manager, 'SG'));
            $this->addContact($dubois, 'Jean', 'Dubois', 'Gérant', '05 49 00 00 01', null, 'jean.dubois@menuiserie-dubois.fr');
-            $this->addAddress($dubois, ['Chatellerault'], '86100', 'Châtellerault', '12 rue de l\'Atelier', isDelivery: true, categoryNames: ['BTP']);
+            $this->addAddress($dubois, ['Chatellerault'], '86100', 'Châtellerault', '12 rue de l\'Atelier', isDelivery: true, categoryNames: ['Livraison']);
        }

        // === Dependant d'un distributeur (RG-1.03) ===
@@ -176,7 +175,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
        if ($isNew) {
            $transports->setPaymentType($this->paymentType($manager, 'LCR'));
            $this->addContact($transports, null, 'Bernard', 'Responsable exploitation', '05 56 12 13 14', null, 'expl@transports-rapides.fr');
-            $this->addAddress($transports, ['Saint-Jean'], '17400', 'Fontenet', '2 zone industrielle', isDelivery: true, categoryNames: ['Transport/Logistique']);
+            $this->addAddress($transports, ['Saint-Jean'], '17400', 'Fontenet', '2 zone industrielle', isDelivery: true, categoryNames: ['Approvisionnement']);
            $this->addRib($transports, 'Compte principal', 'BNPAFRPPXXX', 'FR1420041010050500013M02606', 0);
            $this->addRib($transports, 'Compte secondaire', 'SOGEFRPPXXX', 'FR7630006000011234567890189', 1);
        }
@@ -192,9 +191,9 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
            // Prospect : exclusif de livraison/facturation (sans billingEmail).
            $this->addAddress($industries, ['Chatellerault'], '86100', 'Châtellerault', '1 avenue de la Prospection', isProspect: true, position: 0);
            // Livraison.
-            $this->addAddress($industries, ['Saint-Jean'], '17400', 'Fontenet', '4 rue de la Livraison', isDelivery: true, categoryNames: ['Industrie'], position: 1);
+            $this->addAddress($industries, ['Saint-Jean'], '17400', 'Fontenet', '4 rue de la Livraison', isDelivery: true, categoryNames: ['Livraison'], position: 1);
            // Facturation : billingEmail obligatoire.
-            $this->addAddress($industries, ['Chatellerault'], '86100', 'Châtellerault', '7 boulevard des Factures', isBilling: true, billingEmail: 'Compta@Industries-Vertes.FR', position: 2);
+            $this->addAddress($industries, ['Chatellerault'], '86100', 'Châtellerault', '7 boulevard des Factures', isBilling: true, billingEmail: 'Compta@Industries-Vertes.FR', categoryNames: ['Facturation'], position: 2);
        }

        // === 3 contacts dont un avec telephone secondaire (RG-1.05/1.02) ===
@@ -249,7 +248,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
            $holding->setDirectorName('Antoine Lefèvre');
            $holding->setProfitAmount('1250000.00');
            $this->addContact($holding, 'Antoine', 'Lefèvre', 'PDG', '05 56 51 52 53', null, 'antoine.lefevre@holding-premium.fr');
-            $this->addAddress($holding, ['Pommevic'], '82400', 'Pommevic', '1 allée des Investisseurs', isDelivery: true, categoryNames: ['Industrie']);
+            $this->addAddress($holding, ['Pommevic'], '82400', 'Pommevic', '1 allée des Investisseurs', isDelivery: true, categoryNames: ['Siège']);
        }

        // === Multi-categories M2M ===
@@ -260,7 +259,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
        );
        if ($isNew) {
            $this->addContact($conglo, 'Hélène', 'Faure', 'Directrice générale', '05 49 61 62 63', null, 'helene.faure@conglomerat-multi.fr');
-            $this->addAddress($conglo, ['Chatellerault', 'Saint-Jean'], '86100', 'Châtellerault', '20 rue des Activités', isDelivery: true, categoryNames: ['BTP', 'Services']);
+            $this->addAddress($conglo, ['Chatellerault', 'Saint-Jean'], '86100', 'Châtellerault', '20 rue des Activités', isDelivery: true, categoryNames: ['Livraison', 'Approvisionnement']);
        }

        // === Prospect seul ===
@@ -282,7 +281,7 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
        );
        if ($isNew) {
            $this->addContact($association, null, 'Caron', 'Président', '05 49 81 82 83', null, 'president@asso-riverains.fr');
-            $this->addAddress($association, ['Saint-Jean'], '17400', 'Fontenet', '6 chemin du Village', isDelivery: true, categoryNames: ['Association']);
+            $this->addAddress($association, ['Saint-Jean'], '17400', 'Fontenet', '6 chemin du Village', isDelivery: true, categoryNames: ['Contact issues']);
        }

        $manager->flush();
@@ -359,10 +358,10 @@ class ClientFixtures extends Fixture implements DependentFixtureInterface
    /**
     * Ajoute une adresse au client (cascade persist via Client.addresses). Les
     * donnees respectent les validators : exclusivite Prospect, billingEmail ssi
-     * facturation, aucune categorie de code DISTRIBUTEUR/COURTIER (RG-1.29).
+     * facturation, categories de type ADRESSE uniquement.
     *
     * @param list<string> $siteNames     au moins un site (RG-1.10)
-     * @param list<string> $categoryNames categories hors DISTRIBUTEUR/COURTIER (RG-1.29)
+     * @param list<string> $categoryNames categories de type ADRESSE (Siege, Livraison...)
     */
    private function addAddress(
        Client $client,
@@ -28,9 +28,7 @@ interface CategoryInterface
     * entre environnements) ni importer la classe concrete Category (regle
     * ABSOLUE n°1). Pilote, cote M1 Commercial :
     *  - RG-1.03 : un distributor doit referencer un client portant la categorie
-     *    de code DISTRIBUTEUR (resp. COURTIER pour broker) ;
-     *  - RG-1.29 : une adresse interdit les categories de code DISTRIBUTEUR /
-     *    COURTIER (relations entre clients, pas des attributs d'adresse).
+     *    de code DISTRIBUTEUR (resp. COURTIER pour broker).
     */
    public function getCode(): ?string;

@@ -38,9 +36,10 @@ interface CategoryInterface
     * Codes des types de categorie rattaches (CategoryType::code), tableau vide
     * si aucun. Depuis le passage en ManyToMany, une categorie peut porter
     * plusieurs types : un module tiers teste l'appartenance via
-     * `in_array($code, $category->getCategoryTypeCodes(), true)`. Pilote, cote
-     * M2 Commercial, la RG-2.10 (une categorie de fournisseur doit etre de type
-     * FOURNISSEUR).
+     * `in_array($code, $category->getCategoryTypeCodes(), true)`. Pilote la
+     * RG-2.10 (une categorie de fournisseur doit etre de type FOURNISSEUR) et la
+     * validation des blocs adresse (categories de type ADRESSE uniquement, client
+     * comme fournisseur).
     *
     * @return list<string>
     */
@@ -271,9 +271,9 @@ final class ColumnCommentsCatalog
            ],

            'client_address_category' => [
-                '_table'            => 'Jointure M2M client_address <-> category — categories d adresse (types SECTEUR/AUTRE uniquement, RG-1.29).',
+                '_table'            => 'Jointure M2M client_address <-> category — categories d adresse de type ADRESSE uniquement.',
                'client_address_id' => 'FK -> client_address.id, ON DELETE CASCADE — adresse concernee.',
-                'category_id'       => 'FK -> category.id, ON DELETE RESTRICT — categorie d adresse (type SECTEUR ou AUTRE, RG-1.29).',
+                'category_id'       => 'FK -> category.id, ON DELETE RESTRICT — categorie d adresse de type ADRESSE.',
            ],

            'client_rib' => [
@@ -360,9 +360,9 @@ final class ColumnCommentsCatalog
            ],

            'supplier_address_category' => [
-                '_table'              => 'Jointure M2M supplier_address <-> category — categories d adresse de type FOURNISSEUR (RG-2.10).',
+                '_table'              => 'Jointure M2M supplier_address <-> category — categories d adresse de type ADRESSE.',
                'supplier_address_id' => 'FK -> supplier_address.id, ON DELETE CASCADE — adresse concernee.',
-                'category_id'         => 'FK -> category.id, ON DELETE RESTRICT — categorie d adresse de type FOURNISSEUR (RG-2.10).',
+                'category_id'         => 'FK -> category.id, ON DELETE RESTRICT — categorie d adresse de type ADRESSE.',
            ],

            'supplier_rib' => [