tristan
efded9fd40
Auto Tag Develop / tag (push) Successful in 12s
## 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>
48 lines
1.9 KiB
PHP
48 lines
1.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Shared\Domain\Contract;
|
|
|
|
/**
|
|
* Interface minimale exposant ce qu'un module tiers (Commercial...) doit
|
|
* connaitre d'une Category, sans creer de couplage direct vers le module
|
|
* Catalog (regle ABSOLUE n°1 : pas d'import inter-modules).
|
|
*
|
|
* Implementee par App\Module\Catalog\Domain\Entity\Category.
|
|
* Utilisee comme cible des ManyToMany Client.categories et
|
|
* ClientAddress.categories via resolve_target_entities (cf. doctrine.yaml),
|
|
* sur le meme modele que SiteInterface / UserInterface.
|
|
*/
|
|
interface CategoryInterface
|
|
{
|
|
public function getId(): ?int;
|
|
|
|
public function getName(): ?string;
|
|
|
|
/**
|
|
* Code technique stable de la categorie (Category::code), ou null si non
|
|
* encore renseigne. Slug MAJUSCULE derive du nom a la creation, fige ensuite.
|
|
* Expose pour permettre a un module tiers de filtrer/valider par categorie
|
|
* metier sans dependre du libelle (`name`) ni de l'`id` (non deterministe
|
|
* 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).
|
|
*/
|
|
public function getCode(): ?string;
|
|
|
|
/**
|
|
* 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 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>
|
|
*/
|
|
public function getCategoryTypeCodes(): array;
|
|
}
|