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/ClientApiTest.php

@@ -25,7 +25,7 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
 {
     private const string LD = 'application/ld+json';
 
-    public function testPostNormalizesTextFields(): void
+    public function testPostNormalizesCompanyName(): void
     {
         $client = $this->createAdminClient();
         $cat    = $this->createCategory('SECTEUR');
@@ -33,23 +33,18 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
         $response = $client->request('POST', '/api/clients', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
-                'companyName'  => 'acme sas',
-                'firstName'    => 'JEAN',
-                'lastName'     => 'dupont',
-                'phonePrimary' => '06.12.34.56.78',
-                'email'        => 'Jean.DUPONT@ACME.FR',
-                'categories'   => ['/api/categories/'.$cat->getId()],
+                'companyName' => 'acme sas',
+                'categories'  => ['/api/categories/'.$cat->getId()],
             ],
         ]);
 
         self::assertResponseStatusCodeSame(201);
         $data = $response->toArray();
-        // RG-1.18 / 1.19 / 1.20 / 1.21
+        // RG-1.18 : companyName normalise en MAJUSCULES. Les champs de contact
+        // inline ont disparu (refonte contact) -> plus de normalisation ici.
         self::assertSame('ACME SAS', $data['companyName']);
-        self::assertSame('Jean', $data['firstName']);
-        self::assertSame('Dupont', $data['lastName']);
-        self::assertSame('0612345678', $data['phonePrimary']);
-        self::assertSame('jean.dupont@acme.fr', $data['email']);
+        self::assertArrayNotHasKey('firstName', $data);
+        self::assertArrayNotHasKey('email', $data);
         self::assertFalse($data['isArchived']);
     }
 
@@ -60,41 +55,18 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
         $iri    = '/api/categories/'.$cat->getId();
 
         $payload = [
-            'companyName'  => 'Doublon SARL',
-            'firstName'    => 'A',
-            'phonePrimary' => '0102030405',
-            'email'        => 'dup@test.fr',
-            'categories'   => [$iri],
+            'companyName' => 'Doublon SARL',
+            'categories'  => [$iri],
         ];
 
         $client->request('POST', '/api/clients', ['headers' => ['Content-Type' => self::LD], 'json' => $payload]);
         self::assertResponseStatusCodeSame(201);
 
         // Meme nom (insensible a la casse via l'index LOWER) -> 409 (RG-1.16).
-        $payload['email'] = 'dup2@test.fr';
         $client->request('POST', '/api/clients', ['headers' => ['Content-Type' => self::LD], 'json' => $payload]);
         self::assertResponseStatusCodeSame(409);
     }
 
-    public function testPostWithoutFirstOrLastNameReturns422(): void
-    {
-        $client = $this->createAdminClient();
-        $cat    = $this->createCategory('SECTEUR');
-
-        $client->request('POST', '/api/clients', [
-            'headers' => ['Content-Type' => self::LD],
-            'json'    => [
-                'companyName'  => 'No Contact Name',
-                'phonePrimary' => '0102030405',
-                'email'        => 'nc@test.fr',
-                'categories'   => ['/api/categories/'.$cat->getId()],
-            ],
-        ]);
-
-        // RG-1.01
-        self::assertResponseStatusCodeSame(422);
-    }
-
     public function testPostWithoutCategoryReturns422(): void
     {
         $client = $this->createAdminClient();
@@ -102,11 +74,8 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
         $client->request('POST', '/api/clients', [
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
-                'companyName'  => 'No Category',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'nocat@test.fr',
-                'categories'   => [],
+                'companyName' => 'No Category',
+                'categories'  => [],
             ],
         ]);
 
@@ -124,9 +93,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'companyName'  => 'Mutex Client',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'mutex@test.fr',
                 'categories'   => ['/api/categories/'.$cat->getId()],
                 'distributor'  => '/api/clients/'.$distributor->getId(),
                 'broker'       => '/api/clients/'.$distributor->getId(),
@@ -147,9 +113,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'companyName'  => 'Bad Distrib Ref',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'baddistrib@test.fr',
                 'categories'   => ['/api/categories/'.$cat->getId()],
                 'distributor'  => '/api/clients/'.$notDistro->getId(),
             ],
@@ -169,9 +132,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'companyName'  => 'Client Avec Distrib',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'okdistrib@test.fr',
                 'categories'   => ['/api/categories/'.$cat->getId()],
                 'distributor'  => '/api/clients/'.$distributor->getId(),
             ],
@@ -190,9 +150,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'companyName'  => 'Bad Broker Ref',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'badbroker@test.fr',
                 'categories'   => ['/api/categories/'.$cat->getId()],
                 'broker'       => '/api/clients/'.$notBroker->getId(),
             ],
@@ -212,9 +169,6 @@ final class ClientApiTest extends AbstractCommercialApiTestCase
             'headers' => ['Content-Type' => self::LD],
             'json'    => [
                 'companyName'  => 'Client Avec Courtier',
-                'firstName'    => 'A',
-                'phonePrimary' => '0102030405',
-                'email'        => 'okbroker@test.fr',
                 'categories'   => ['/api/categories/'.$cat->getId()],
                 'broker'       => '/api/clients/'.$broker->getId(),
             ],