refactor(commercial) : suppression du contact principal inline du Client (M1 · back 1/3) (#55)

## Contexte

M1 · Ticket 1/3 (Backend) de la refonte contact. Le contact principal inline du `Client` (firstName, lastName, phonePrimary, phoneSecondary, email) faisait doublon avec la sous-entité `ClientContact` (onglet Contact). Il est supprimé : les contacts vivent désormais **uniquement** dans `client_contact`.

RG-1.01 (firstName OU lastName sur Client) et RG-1.02 (max 2 téléphones sur Client) sont **supprimées** du Client — leur équivalent vit déjà sur `ClientContact` (RG-1.05 / RG-1.14).

## Changements

- **Migration** `Version20260603120000` (namespace racine `DoctrineMigrations` — tri par timestamp, cf. AlphabeticalComparator) : **backfill** des clients sans contact vers `client_contact` (position 0) **avant** le `DROP` des 5 colonnes. `down()` best-effort documenté.
- **Entité `Client`** : retrait des 5 propriétés + getters/setters + groupes de sérialisation.
- **`ClientProcessor`** : `MAIN_FIELDS` / `changedBusinessFields()` / `normalize()` allégés ; `validateMainContact()` (RG-1.01) supprimée.
- **Recherche répertoire (D1)** : sur `companyName` seul (les anciens critères lastName/email vivaient sur les colonnes supprimées).
- **Export XLSX (D2)** : colonnes de contact retirées (Nom entreprise / Catégories / Sites / [SIREN] / Date).
- **Fixtures** + **catalogue de commentaires SQL** (`ColumnCommentsCatalog`) alignés.
- **Tests** fonctionnels et unitaires mis à jour.

## Décisions actées

- **Migration** au namespace racine (et non modulaire Commercial) : une migration `App\Module\Commercial\…` trierait avant le `CREATE TABLE client` sur base fraîche → casse. Conforme à la règle ABSOLUE n°11.
- **D1** = recherche `companyName` seul. **D2** = retrait des colonnes contact de l'export.

## Vérifications

- ✅ `make db-reset && make migration-migrate` : migration rejouable sur base fraîche (backfill no-op si contacts déjà présents).
- ✅ `make test` : 466 tests verts.
- ✅ `make php-cs-fixer-allow-risky` : clean.
- ✅ Contrat réel `GET /api/clients/{id}` : les 5 champs ont disparu de la racine, `contacts[]` porte l'info.

---------

Co-authored-by: admin malio <malio@yuno.malio.fr>
Co-authored-by: Matthieu <contact@malio.fr>
Reviewed-on: #55
Co-authored-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
Co-committed-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>

tests/Module/Commercial/Api/ClientFormulaireMainTest.php

@@ -7,12 +7,15 @@ namespace App\Tests\Module\Commercial\Api;
 use App\Module\Commercial\Domain\Entity\Client as ClientEntity;
 
 /**
- * Tests fonctionnels du formulaire principal — combler les trous (ERP-60).
+ * Tests fonctionnels du formulaire principal apres la refonte contact.
  *
- * RG-1.01 (prenom OU nom obligatoire) et RG-1.03 (distributor/broker exclusifs
- * + type de categorie) sont DEJA couverts par ClientApiTest (ERP-55) : on ne les
- * reduplique pas ici. Ce fichier ne couvre que RG-1.02 (telephone secondaire),
- * non encore testee.
+ * RG-1.01 (prenom OU nom) et RG-1.02 (telephone secondaire) ont ete SUPPRIMEES
+ * du Client : le contact principal n'est plus porte inline, il vit uniquement
+ * dans ClientContact (onglet Contact). Ce fichier verifie que :
+ *  - le formulaire principal se cree avec les seuls champs subsistants
+ *    (companyName + categories), sans aucun champ de contact ;
+ *  - les anciens champs de contact (firstName, lastName, phonePrimary,
+ *    phoneSecondary, email) ne sont plus exposes ni persistes.
  *
  * @internal
  */
@@ -21,11 +24,10 @@ final class ClientFormulaireMainTest extends AbstractCommercialApiTestCase
     private const string LD = 'application/ld+json';
 
     /**
-     * RG-1.02 : le telephone secondaire est optionnel mais persiste (2 colonnes
-     * distinctes). Verifie aussi la normalisation chiffres-seuls (RG-1.20) sur
-     * la colonne secondaire.
+     * Le formulaire principal n'exige plus que companyName + au moins une
+     * categorie (RG-1.16 / RG sur categories). Aucun champ de contact requis.
      */
-    public function testPostPersistsSecondaryPhoneNormalized(): void
+    public function testPostMainFormWithoutContactFields(): void
     {
         $client = $this->createAdminClient();
         $cat    = $this->createCategory('SECTEUR');
@@ -33,26 +35,28 @@ final class ClientFormulaireMainTest extends AbstractCommercialApiTestCase
         $data = $client->request('POST', '/api/clients', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
-                'companyName'    => 'Two Phones SARL',
-                'firstName'      => 'A',
-                'phonePrimary'   => '06.12.34.56.78',
-                'phoneSecondary' => '05 49 00 11 22',
-                'email'          => 'twophones@test.fr',
-                'categories'     => ['/api/categories/'.$cat->getId()],
+                'companyName' => 'Main Form SARL',
+                'categories'  => ['/api/categories/'.$cat->getId()],
             ],
         ])->toArray();
 
         self::assertResponseStatusCodeSame(201);
-        self::assertSame('0612345678', $data['phonePrimary']);
-        self::assertSame('0549001122', $data['phoneSecondary']);
+        self::assertSame('MAIN FORM SARL', $data['companyName']);
+
+        // Les champs de contact inline ont disparu de la representation.
+        self::assertArrayNotHasKey('firstName', $data);
+        self::assertArrayNotHasKey('lastName', $data);
+        self::assertArrayNotHasKey('phonePrimary', $data);
+        self::assertArrayNotHasKey('phoneSecondary', $data);
+        self::assertArrayNotHasKey('email', $data);
     }
 
     /**
-     * RG-1.02 : maximum 2 telephones — le modele n'expose que phonePrimary et
-     * phoneSecondary. Un eventuel 3e champ envoye par un appel API direct est
-     * ignore (aucune 3e colonne), il ne peut donc pas creer un troisieme numero.
+     * Les anciens champs de contact envoyes par un appel API direct (payload
+     * historique) sont ignores par le denormaliseur : ils n'apparaissent pas
+     * dans la representation et ne creent aucune colonne sur le client.
      */
-    public function testThirdPhoneFieldIsIgnored(): void
+    public function testLegacyContactFieldsAreIgnored(): void
     {
         $client = $this->createAdminClient();
         $cat    = $this->createCategory('SECTEUR');
@@ -60,25 +64,25 @@ final class ClientFormulaireMainTest extends AbstractCommercialApiTestCase
         $data = $client->request('POST', '/api/clients', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
-                'companyName'    => 'Third Phone SARL',
-                'firstName'      => 'A',
+                'companyName'    => 'Legacy Fields SARL',
+                'firstName'      => 'Ignored',
+                'lastName'       => 'Ignored',
                 'phonePrimary'   => '0612345678',
                 'phoneSecondary' => '0549001122',
-                'phoneTertiary'  => '0700000000',
-                'email'          => 'thirdphone@test.fr',
+                'email'          => 'ignored@test.fr',
                 'categories'     => ['/api/categories/'.$cat->getId()],
             ],
         ])->toArray();
 
         self::assertResponseStatusCodeSame(201);
-        // Le champ inconnu est ignore par le denormaliseur : il n'apparait pas
-        // dans la representation et n'a pas ete persiste.
-        self::assertArrayNotHasKey('phoneTertiary', $data);
+        self::assertArrayNotHasKey('firstName', $data);
+        self::assertArrayNotHasKey('phonePrimary', $data);
+        self::assertArrayNotHasKey('email', $data);
 
-        // Confirmation cote base : seules les 2 colonnes telephone existent.
+        // Confirmation cote base : le client cree ne porte aucun contact inline
+        // (les colonnes n'existent plus, l'entite n'a plus les proprietes).
         $persisted = $this->getEm()->getRepository(ClientEntity::class)->find($data['id']);
         self::assertNotNull($persisted);
-        self::assertSame('0612345678', $persisted->getPhonePrimary());
-        self::assertSame('0549001122', $persisted->getPhoneSecondary());
+        self::assertSame('LEGACY FIELDS SARL', $persisted->getCompanyName());
     }
 }