96ddd15c86
Auto Tag Develop / tag (push) Successful in 9s
## 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>
99 lines
3.9 KiB
PHP
99 lines
3.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Tests\Module\Commercial\Api;
|
|
|
|
/**
|
|
* Tests de structure / migration M1 (ERP-60).
|
|
*
|
|
* Verifie la decision Q4 (29/05/2026) au niveau du schema Postgres :
|
|
* - l'unique index partiel fonctionnel uq_client_company_name_active existe
|
|
* (un seul, sur LOWER(company_name), partiel sur les actifs non archives /
|
|
* non supprimes) — seule unicite metier conservee (RG-1.16) ;
|
|
* - les anciens index uq_client_siren_active (RG-1.15) et uq_client_email_active
|
|
* (RG-1.17) ont ete supprimes / ne sont jamais crees.
|
|
*
|
|
* Verifie aussi la refonte contact (Version20260603120000) : les 5 colonnes de
|
|
* contact principal inline ont ete supprimees de la table `client`.
|
|
*
|
|
* @internal
|
|
*/
|
|
final class ClientMigrationTest extends AbstractCommercialApiTestCase
|
|
{
|
|
/**
|
|
* Refonte contact : first_name / last_name / phone_primary / phone_secondary
|
|
* / email ne doivent plus exister sur la table `client` (deplaces vers
|
|
* client_contact). NB : le backfill de la migration ne s'exerce que sur une
|
|
* base portant des donnees pre-refonte ; sur le schema de test (table client
|
|
* vierge au moment de la migration) il est un no-op, donc non assertable ici
|
|
* au runtime — seul l'etat de schema final est verifie.
|
|
*/
|
|
public function testInlineContactColumnsAreDropped(): void
|
|
{
|
|
self::bootKernel();
|
|
|
|
/** @var list<array{column_name: string}> $columns */
|
|
$columns = $this->getEm()->getConnection()->fetchAllAssociative(
|
|
"SELECT column_name FROM information_schema.columns "
|
|
."WHERE table_schema = 'public' AND table_name = 'client'",
|
|
);
|
|
$names = array_map(static fn (array $r): string => $r['column_name'], $columns);
|
|
|
|
foreach (['first_name', 'last_name', 'phone_primary', 'phone_secondary', 'email'] as $dropped) {
|
|
self::assertNotContains(
|
|
$dropped,
|
|
$names,
|
|
sprintf('La colonne client.%s aurait du etre supprimee (refonte contact).', $dropped),
|
|
);
|
|
}
|
|
}
|
|
|
|
public function testCompanyNameActivePartialIndexExistsExactlyOnce(): void
|
|
{
|
|
$rows = $this->clientIndexes();
|
|
|
|
$companyNameIndexes = array_filter(
|
|
$rows,
|
|
static fn (array $r): bool => 'uq_client_company_name_active' === $r['indexname'],
|
|
);
|
|
|
|
self::assertCount(
|
|
1,
|
|
$companyNameIndexes,
|
|
'Il doit exister exactement UN index uq_client_company_name_active.',
|
|
);
|
|
|
|
// Confirme la nature fonctionnelle (LOWER) + partielle (WHERE) de l'index.
|
|
// Postgres serialise l'expression sous la forme `lower((company_name)::text)`,
|
|
// d'ou des verifications de sous-chaines distinctes.
|
|
$def = strtolower((string) array_values($companyNameIndexes)[0]['indexdef']);
|
|
self::assertStringContainsString('unique', $def);
|
|
self::assertStringContainsString('lower', $def);
|
|
self::assertStringContainsString('company_name', $def);
|
|
self::assertStringContainsString('where', $def, 'L\'index doit etre partiel (clause WHERE sur les actifs).');
|
|
}
|
|
|
|
public function testNoSirenOrEmailUniqueIndex(): void
|
|
{
|
|
$names = array_map(static fn (array $r): string => $r['indexname'], $this->clientIndexes());
|
|
|
|
// RG-1.15 / RG-1.17 supprimees (Q4) : aucun index unique siren / email.
|
|
self::assertNotContains('uq_client_siren_active', $names);
|
|
self::assertNotContains('uq_client_email_active', $names);
|
|
}
|
|
|
|
/**
|
|
* @return list<array{indexname: string, indexdef: string}>
|
|
*/
|
|
private function clientIndexes(): array
|
|
{
|
|
self::bootKernel();
|
|
|
|
/** @var list<array{indexname: string, indexdef: string}> $rows */
|
|
return $this->getEm()->getConnection()->fetchAllAssociative(
|
|
"SELECT indexname, indexdef FROM pg_indexes WHERE schemaname = 'public' AND tablename = 'client'",
|
|
);
|
|
}
|
|
}
|