Starseed/tests/Module/Commercial/Api/SupplierListTest.php

<?php

declare(strict_types=1);

namespace App\Tests\Module\Commercial\Api;

/**
 * Tests fonctionnels de la liste fournisseurs (M2, spec § 4.1 + RG-2.17 + règle
 * ABSOLUE n°13) : exclusion des archives par défaut, ?includeArchived, tri
 * companyName ASC, enveloppe Hydra (member/totalItems/view), échappatoire
 * ?pagination=false, et ANTI N+1 (le nombre de requêtes SQL de la liste ne croît
 * pas avec le nombre de lignes — fetch-joins/hydratation batchée § 2.12).
 *
 * @internal
 */
final class SupplierListTest extends AbstractSupplierApiTestCase
{
    public function testListExcludesArchivedByDefaultAndIncludesWithFlag(): void
    {
        $http  = $this->createAdminClient();
        $token = $this->token();

        $this->seedSupplier($token.' Active');
        $this->seedSupplier($token.' Archived', true);

        $default = $http->request('GET', '/api/suppliers?search='.$token, ['headers' => ['Accept' => self::LD]])->toArray();
        self::assertSame(1, $default['totalItems'], 'RG-2.17 : archives exclus par defaut.');

        $all = $http->request('GET', '/api/suppliers?search='.$token.'&includeArchived=true', ['headers' => ['Accept' => self::LD]])->toArray();
        self::assertSame(2, $all['totalItems'], 'RG-2.17 : ?includeArchived reintegre les archives.');
    }

    public function testListIsSortedByCompanyNameAsc(): void
    {
        $http  = $this->createAdminClient();
        $token = $this->token();

        // Inseres dans le desordre ; le tri par defaut doit remonter ALPHA avant ZETA.
        $this->seedSupplier($token.' Zeta');
        $this->seedSupplier($token.' Alpha');

        $names = array_map(
            static fn (array $m): string => (string) $m['companyName'],
            $http->request('GET', '/api/suppliers?search='.$token, ['headers' => ['Accept' => self::LD]])->toArray()['member'],
        );

        self::assertCount(2, $names);
        self::assertStringContainsString('ALPHA', $names[0], 'RG-2.17 : tri companyName ASC.');
        self::assertStringContainsString('ZETA', $names[1]);
    }

    public function testPaginationDisabledReturnsFullCollection(): void
    {
        $http  = $this->createAdminClient();
        $token = $this->token();

        for ($i = 0; $i < 3; ++$i) {
            $this->seedSupplier($token.' Item'.$i);
        }

        // ?pagination=false : echappatoire pour alimenter un <select> (regle n°13).
        $data = $http->request('GET', '/api/suppliers?search='.$token.'&pagination=false', ['headers' => ['Accept' => self::LD]])->toArray();

        self::assertArrayHasKey('member', $data);
        self::assertCount(3, $data['member']);
    }

    /**
     * Anti N+1 (§ 2.12) : le nombre de requetes SQL de la liste ne doit PAS croitre
     * avec le nombre de fournisseurs. On mesure pour N=2 puis N=4 (memes relations
     * embarquees : categories + addresses.sites) et on exige un compte IDENTIQUE —
     * preuve que l'hydratation est batchee (WHERE IN) et non par ligne.
     */
    public function testListQueryCountDoesNotGrowWithRowCount(): void
    {
        $this->skipIfSitesModuleDisabled();
        $token = $this->token();

        // Premiere mesure : 2 fournisseurs complets (avec adresses/sites/categories).
        $this->seedCompleteSupplier($token.' A');
        $this->seedCompleteSupplier($token.' B');
        $countFor2 = $this->countListQueries($token);

        // Seconde mesure : 2 de plus (4 au total, tous sur la meme page).
        $this->seedCompleteSupplier($token.' C');
        $this->seedCompleteSupplier($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 car kernel.debug=true en test). 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/suppliers?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);
    }
}