test(transport) : couverture RG-4.01→4.14 + contrat + fixtures (ERP-163)

- CarrierListTest : anti-N+1 liste (fetch-join qualimat), tri name ASC, echappatoire ?pagination=false (regle n°13) - CarrierAuditTest : POST/PATCH/archive -> audit_log entity_type='transport.Carrier' - CarrierAddressApiTest : CP/ville incoherents acceptes (RG-4.06, pas de controle de coherence serveur) - CarrierFixtures : fixtures dev completes et idempotentes (QUALIMAT validite passee, AUTRE+decharge, affrete, LIOT, complet prix CLIENT+FOURNISSEUR, archive) ; env-gated dev uniquement - spec-back § 4.0.bis : JSON reel capture (liste + detail) via CarrierSerializationContractTest
2026-06-16 11:40:47 +02:00
parent f0c09d6961
commit ba7a93c9de
5 changed files with 688 additions and 56 deletions
@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Module\Transport\Api;
+
+/**
+ * Tests fonctionnels de la liste transporteurs (M4, spec § 4.1 + RG-4.14 + regle
+ * ABSOLUE n°13) : tri name ASC, echappatoire ?pagination=false (selects), et
+ * ANTI N+1 (le nombre de requetes SQL de la liste ne croit pas avec le nombre de
+ * lignes — fetch-join qualimatCarrier batche, § 2.11). L'exclusion des archives
+ * et la forme de l'enveloppe Hydra sont couvertes par
+ * {@see CarrierSerializationContractTest::testCollectionEnvelopeShapeAndArchivedExcluded}.
+ *
+ * @internal
+ */
+final class CarrierListTest extends AbstractCarrierApiTestCase
+{
+    public function testListIsSortedByNameAsc(): void
+    {
+        $http  = $this->createAdminClient();
+        $token = $this->token();
+
+        // Inseres dans le desordre ; le tri par defaut doit remonter ALPHA avant ZETA.
+        $this->seedCarrier($token.' Zeta');
+        $this->seedCarrier($token.' Alpha');
+
+        $names = array_map(
+            static fn (array $m): string => (string) $m['name'],
+            $http->request('GET', '/api/carriers?search='.$token, ['headers' => ['Accept' => self::LD]])->toArray()['member'],
+        );
+
+        self::assertCount(2, $names);
+        self::assertStringContainsString('ALPHA', $names[0], 'Tri name ASC (spec § 4.1).');
+        self::assertStringContainsString('ZETA', $names[1]);
+    }
+
+    public function testPaginationDisabledReturnsFullCollection(): void
+    {
+        $http  = $this->createAdminClient();
+        $token = $this->token();
+
+        for ($i = 0; $i < 3; ++$i) {
+            $this->seedCarrier($token.' Item'.$i);
+        }
+
+        // ?pagination=false : echappatoire pour alimenter un <select> (regle n°13).
+        $data = $http->request('GET', '/api/carriers?search='.$token.'&pagination=false', ['headers' => ['Accept' => self::LD]])->toArray();
+
+        self::assertArrayHasKey('member', $data);
+        self::assertCount(3, $data['member']);
+    }
+
+    /**
+     * Anti N+1 (§ 2.11) : le nombre de requetes SQL de la liste ne doit PAS croitre
+     * avec le nombre de transporteurs. On mesure pour N=2 puis N=4 (chacun avec son
+     * lien QUALIMAT embarque) et on exige un compte IDENTIQUE — preuve que le
+     * fetch-join `qualimatCarrier` est batche et non par ligne.
+     */
+    public function testListQueryCountDoesNotGrowWithRowCount(): void
+    {
+        $this->skipIfSitesModuleDisabled();
+        $token = $this->token();
+
+        // Premiere mesure : 2 transporteurs complets (lien QUALIMAT embarque en liste).
+        $this->seedCompleteCarrier($token.' A');
+        $this->seedCompleteCarrier($token.' B');
+        $countFor2 = $this->countListQueries($token);
+
+        // Seconde mesure : 2 de plus (4 au total, tous sur la meme page).
+        $this->seedCompleteCarrier($token.' C');
+        $this->seedCompleteCarrier($token.' D');
+        $countFor4 = $this->countListQueries($token);
+
+        self::assertSame(
+            $countFor2,
+            $countFor4,
+            sprintf('Anti N+1 : le nombre de requetes liste doit etre constant (%d pour 2, %d pour 4).', $countFor2, $countFor4),
+        );
+    }
+
+    /**
+     * Compte les requetes SQL emises par UN GET liste filtre, via le data holder de
+     * debug Doctrine (actif en test grace a `profiling: true` dans la config test,
+     * independamment d'APP_DEBUG — sinon le compte casse en CI). Le holder est remis
+     * a zero juste avant la requete pour isoler ses requetes (hors login).
+     */
+    private function countListQueries(string $token): int
+    {
+        $http   = $this->createAdminClient();
+        $holder = self::getContainer()->get('doctrine.debug_data_holder');
+        $holder->reset();
+
+        $http->request('GET', '/api/carriers?search='.$token, ['headers' => ['Accept' => self::LD]]);
+
+        $data = $holder->getData();
+
+        return count($data['default'] ?? []);
+    }
+
+    private function token(): string
+    {
+        return 'List'.substr(bin2hex(random_bytes(4)), 0, 8);
+    }
+}