feat(transport) : export XLSX répertoire + prix transporteur (ERP-162)

GET /api/carriers/export.xlsx (mêmes filtres que la liste : includeArchived,
search, certificationType) et GET /api/carriers/{id}/prices/export.xlsx (tableau
Prix regroupé Benne / Fond Mouvant). Controllers Symfony custom avec
#[Route(priority: 1)] pour éviter le conflit API Platform {id}, génération
déléguée au service Shared SpreadsheetExporterInterface.
This commit is contained in:
Matthieu
2026-06-16 11:07:46 +02:00
parent 7d2812cea6
commit e688fe7e0b
4 changed files with 646 additions and 0 deletions
@@ -0,0 +1,157 @@
<?php
declare(strict_types=1);
namespace App\Tests\Module\Transport\Api;
use PhpOffice\PhpSpreadsheet\IOFactory;
/**
* Tests fonctionnels de l'export XLSX du repertoire transporteurs (M4, § 4.6).
* Jumeau du {@see \App\Tests\Module\Commercial\Api\SupplierExportControllerTest}.
*
* Couvre : reponse 200 (Content-Type + Content-Disposition + en-tetes), exclusion
* des archives par defaut, respect du filtre ?search, peuplement des colonnes
* QUALIMAT (statut + date de validite, RG-4.04), 403 sans transport.carriers.view,
* 401 anonyme.
*
* @internal
*/
final class CarrierExportControllerTest extends AbstractCarrierApiTestCase
{
private const string XLSX_MIME = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
private const string EXPORT_URL = '/api/carriers/export.xlsx';
public function testExportReturnsXlsxResponseWithAttachmentFilename(): void
{
$client = $this->createAdminClient();
$this->seedCarrier('Export Alpha');
$response = $client->request('GET', self::EXPORT_URL);
self::assertResponseIsSuccessful();
$headers = $response->getHeaders(false);
self::assertStringContainsString(self::XLSX_MIME, $headers['content-type'][0] ?? '');
$disposition = $headers['content-disposition'][0] ?? '';
self::assertStringContainsString('attachment; filename="repertoire-transporteurs-', $disposition);
self::assertMatchesRegularExpression(
'/filename="repertoire-transporteurs-\d{8}\.xlsx"/',
$disposition,
);
// Le binaire est un XLSX relisible dont la 1re ligne porte les en-tetes.
$headers = $this->gridFromResponse($response->getContent())[0];
self::assertSame('Nom', $headers[0]);
self::assertContains('Certification', $headers);
self::assertContains('Statut QUALIMAT', $headers);
self::assertContains('Date de validité', $headers);
self::assertContains('Affrété', $headers);
self::assertContains('Volume m³', $headers);
self::assertContains('Date de création', $headers);
}
public function testExportExcludesArchivedByDefault(): void
{
$client = $this->createAdminClient();
$this->seedCarrier('Active One');
$this->seedCarrier('Archived One', true);
$names = $this->carrierNames($client->request('GET', self::EXPORT_URL)->getContent());
self::assertContains('ACTIVE ONE', $names);
self::assertNotContains('ARCHIVED ONE', $names);
}
public function testExportRespectsSearchFilter(): void
{
$client = $this->createAdminClient();
$this->seedCarrier('Searchable Alpha');
$this->seedCarrier('Other Beta');
$names = $this->carrierNames(
$client->request('GET', self::EXPORT_URL.'?search=alpha')->getContent(),
);
self::assertContains('SEARCHABLE ALPHA', $names);
self::assertNotContains('OTHER BETA', $names);
}
/**
* Colonnes « Statut QUALIMAT » et « Date de validite » : alimentees par le
* referentiel QUALIMAT lie (RG-4.04). Un transporteur complet seede un lien
* QUALIMAT (statut « Valide », validite 31/12/2027).
*/
public function testExportPopulatesQualimatColumns(): void
{
$client = $this->createAdminClient();
$this->seedCompleteCarrier('Grelillier');
$flat = $this->flatten($this->gridFromResponse($client->request('GET', self::EXPORT_URL)->getContent()));
self::assertStringContainsString('QUALIMAT', $flat);
self::assertStringContainsString('Valide', $flat);
self::assertStringContainsString('31/12/2027', $flat);
}
public function testForbiddenWithoutCarriersViewPermission(): void
{
$creds = $this->createUserWithPermission('core.users.view');
$client = $this->authenticatedClient($creds['username'], $creds['password']);
$client->request('GET', self::EXPORT_URL);
self::assertResponseStatusCodeSame(403);
}
public function testUnauthorizedWhenAnonymous(): void
{
$client = self::createClient();
$client->request('GET', self::EXPORT_URL);
self::assertResponseStatusCodeSame(401);
}
/**
* Relit le binaire XLSX d'une reponse et renvoie la grille de cellules.
*
* @return array<int, array<int, mixed>>
*/
private function gridFromResponse(string $binary): array
{
$tmp = tempnam(sys_get_temp_dir(), 'xlsx_carrier_export_test_');
self::assertIsString($tmp);
file_put_contents($tmp, $binary);
try {
return IOFactory::load($tmp)->getActiveSheet()->toArray();
} finally {
@unlink($tmp);
}
}
/**
* Extrait la colonne « Nom » (1re colonne) des lignes de donnees.
*
* @return list<string>
*/
private function carrierNames(string $binary): array
{
$rows = array_slice($this->gridFromResponse($binary), 1); // saute l'en-tete
return array_values(array_map(static fn (array $row): string => (string) ($row[0] ?? ''), $rows));
}
/**
* Aplatit toute la grille en une chaine, pour les assertions de presence.
*
* @param array<int, array<int, mixed>> $grid
*/
private function flatten(array $grid): string
{
return implode('|', array_map(
static fn (array $row): string => implode('|', array_map(static fn ($cell): string => (string) $cell, $row)),
$grid,
));
}
}
@@ -0,0 +1,161 @@
<?php
declare(strict_types=1);
namespace App\Tests\Module\Transport\Api;
use App\Module\Transport\Domain\Entity\Carrier;
use PhpOffice\PhpSpreadsheet\IOFactory;
/**
* Tests fonctionnels de l'export XLSX du tableau Prix d'un transporteur (M4,
* § 4.6 / spec-front « Onglet Prix »).
*
* Couvre : reponse 200 (Content-Type + Content-Disposition + en-tetes), rendu des
* lignes regroupees par type de contenant (Benne / Fond Mouvant) avec ventilation
* Forfait/Tonne, libelles d'etat FR, points de depart/livraison cross-module,
* 404 sur transporteur inconnu, 403 sans transport.carriers.view, 401 anonyme.
*
* @internal
*/
final class CarrierPriceExportControllerTest extends AbstractCarrierApiTestCase
{
private const string XLSX_MIME = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
public function testExportReturnsXlsxResponseWithAttachmentFilename(): void
{
$client = $this->createAdminClient();
$carrier = $this->seedCompleteCarrier('Price Alpha');
$response = $client->request('GET', $this->exportUrl($carrier));
self::assertResponseIsSuccessful();
$headers = $response->getHeaders(false);
self::assertStringContainsString(self::XLSX_MIME, $headers['content-type'][0] ?? '');
$disposition = $headers['content-disposition'][0] ?? '';
self::assertStringContainsString('attachment; filename="prix-transporteur-', $disposition);
self::assertMatchesRegularExpression(
'/filename="prix-transporteur-\d+-\d{8}\.xlsx"/',
$disposition,
);
$headerRow = $this->gridFromResponse($response->getContent())[0];
self::assertSame('Type de contenant', $headerRow[0]);
self::assertContains('Transporteurs', $headerRow);
self::assertContains('Adresse APRO ou Adresse Sites', $headerRow);
self::assertContains('Adresse livraisons', $headerRow);
self::assertContains('Forfait €', $headerRow);
self::assertContains('Tonne €', $headerRow);
self::assertContains('Indexation', $headerRow);
self::assertContains('État du prix', $headerRow);
}
/**
* Le transporteur complet seede 2 prix : une branche CLIENT (Benne / Tonne /
* 42.50 / Valide) et une branche FOURNISSEUR (Fond Mouvant / Forfait / 320.00 /
* En cours). On verifie le regroupement par contenant, la ventilation
* Forfait/Tonne, les libelles d'etat FR et les points de depart/livraison
* cross-module (le prix CLIENT livre chez le client, le prix FOURNISSEUR part
* de l'adresse du fournisseur).
*/
public function testExportRendersGroupedPriceRows(): void
{
$client = $this->createAdminClient();
$carrier = $this->seedCompleteCarrier('Price Grouping');
$grid = $this->gridFromResponse($client->request('GET', $this->exportUrl($carrier))->getContent());
$benne = $this->rowForContainer($grid, 'Benne');
self::assertNotNull($benne, 'Ligne « Benne » introuvable dans l\'export prix.');
self::assertSame($carrier->getName(), $benne[1]);
// Branche CLIENT : prix en Tonne (42.50 -> 42.5 apres typage numerique du
// classeur), colonne Forfait vide, etat « Valide », livraison chez le client.
self::assertEmpty($benne[4]);
self::assertEqualsWithDelta(42.5, (float) $benne[5], 0.001);
self::assertSame('Validé', $benne[7]);
self::assertStringContainsString('TESTCARRIERREF CLI', (string) $benne[3]);
$fondMouvant = $this->rowForContainer($grid, 'Fond Mouvant');
self::assertNotNull($fondMouvant, 'Ligne « Fond Mouvant » introuvable dans l\'export prix.');
// Branche FOURNISSEUR : prix au Forfait (320.00 -> 320), colonne Tonne vide,
// etat « En cours », depart depuis l'adresse du fournisseur (APRO).
self::assertEqualsWithDelta(320.0, (float) $fondMouvant[4], 0.001);
self::assertEmpty($fondMouvant[5]);
self::assertSame('En cours', $fondMouvant[7]);
self::assertStringContainsString('TESTCARRIERREF FRN', (string) $fondMouvant[2]);
}
public function testNotFoundForUnknownCarrier(): void
{
$client = $this->createAdminClient();
$client->request('GET', '/api/carriers/99999999/prices/export.xlsx');
self::assertResponseStatusCodeSame(404);
}
public function testForbiddenWithoutCarriersViewPermission(): void
{
$carrier = $this->seedCompleteCarrier('Price Forbidden');
$creds = $this->createUserWithPermission('core.users.view');
$client = $this->authenticatedClient($creds['username'], $creds['password']);
$client->request('GET', $this->exportUrl($carrier));
self::assertResponseStatusCodeSame(403);
}
public function testUnauthorizedWhenAnonymous(): void
{
$carrier = $this->seedCompleteCarrier('Price Anonymous');
$client = self::createClient();
$client->request('GET', $this->exportUrl($carrier));
self::assertResponseStatusCodeSame(401);
}
private function exportUrl(Carrier $carrier): string
{
return sprintf('/api/carriers/%d/prices/export.xlsx', (int) $carrier->getId());
}
/**
* Relit le binaire XLSX d'une reponse et renvoie la grille de cellules.
*
* @return array<int, array<int, mixed>>
*/
private function gridFromResponse(string $binary): array
{
$tmp = tempnam(sys_get_temp_dir(), 'xlsx_carrier_price_export_test_');
self::assertIsString($tmp);
file_put_contents($tmp, $binary);
try {
return IOFactory::load($tmp)->getActiveSheet()->toArray();
} finally {
@unlink($tmp);
}
}
/**
* Renvoie la 1re ligne de donnees dont la colonne « Type de contenant »
* (1re colonne) vaut $container, ou null.
*
* @param array<int, array<int, mixed>> $grid
*
* @return null|array<int, mixed>
*/
private function rowForContainer(array $grid, string $container): ?array
{
foreach (array_slice($grid, 1) as $row) {
if ((string) ($row[0] ?? '') === $container) {
return $row;
}
}
return null;
}
}