Matthieu
131 lines
4.8 KiB
PHP
131 lines
4.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Module\Commercial\Infrastructure\ApiPlatform\State\Provider;
|
|
|
|
use ApiPlatform\Doctrine\Orm\Paginator;
|
|
use ApiPlatform\Metadata\CollectionOperationInterface;
|
|
use ApiPlatform\Metadata\Operation;
|
|
use ApiPlatform\State\Pagination\Pagination;
|
|
use ApiPlatform\State\ProviderInterface;
|
|
use App\Module\Commercial\Domain\Entity\Client;
|
|
use App\Module\Commercial\Domain\Repository\ClientRepositoryInterface;
|
|
use Doctrine\ORM\Tools\Pagination\Paginator as DoctrinePaginator;
|
|
use Symfony\Component\DependencyInjection\Attribute\Autowire;
|
|
|
|
/**
|
|
* Provider du repertoire clients (M1). Cf. spec-back M1 § 4.1 / § 4.2.
|
|
*
|
|
* Collection (GET /api/clients) :
|
|
* - exclut par defaut les archives (is_archived = true) ET les soft-deletes
|
|
* (deleted_at IS NOT NULL) — RG-1.24 ;
|
|
* - ?includeArchived=true reintegre les archives (les soft-deletes restent
|
|
* exclus au M1) — RG-1.25 ;
|
|
* - tri par defaut companyName ASC — RG-1.26 ;
|
|
* - filtres ?search=... (fuzzy companyName + lastName + email) et
|
|
* ?categoryType=<code> (clients ayant >= 1 categorie de ce type) ;
|
|
* - pagination obligatoire (convention Starseed ERP-72) : Paginator ORM ;
|
|
* echappatoire ?pagination=false pour alimenter un <select> sans pagination.
|
|
*
|
|
* Item (GET /api/clients/{id} + provider de PATCH) :
|
|
* - 404 si introuvable OU soft-delete (deleted_at non null, jamais expose au
|
|
* M1) ; les archives restent consultables/restaurables en detail.
|
|
*
|
|
* Le filtrage des champs comptables en lecture (groupe client:read:accounting)
|
|
* n'est PAS fait ici mais dans ClientReadGroupContextBuilder (le provider ne
|
|
* peut pas influencer les groupes de serialisation).
|
|
*
|
|
* @implements ProviderInterface<Client>
|
|
*/
|
|
final class ClientProvider implements ProviderInterface
|
|
{
|
|
public function __construct(
|
|
#[Autowire(service: 'App\Module\Commercial\Infrastructure\Doctrine\DoctrineClientRepository')]
|
|
private readonly ClientRepositoryInterface $repository,
|
|
private readonly Pagination $pagination,
|
|
) {}
|
|
|
|
public function provide(Operation $operation, array $uriVariables = [], array $context = []): Client|iterable|Paginator|null
|
|
{
|
|
if ($operation instanceof CollectionOperationInterface) {
|
|
return $this->provideCollection($operation, $context);
|
|
}
|
|
|
|
return $this->provideItem($uriVariables);
|
|
}
|
|
|
|
/**
|
|
* @param array<string, mixed> $context
|
|
*
|
|
* @return list<Client>|Paginator<Client>
|
|
*/
|
|
private function provideCollection(Operation $operation, array $context): array|Paginator
|
|
{
|
|
$filters = $context['filters'] ?? [];
|
|
$includeArchived = $this->readBool($filters['includeArchived'] ?? false);
|
|
$search = $filters['search'] ?? null;
|
|
$categoryType = $filters['categoryType'] ?? null;
|
|
|
|
// Filtrage delegue au repository (logique partagee avec l'export XLSX).
|
|
$qb = $this->repository->createListQueryBuilder(
|
|
$includeArchived,
|
|
is_string($search) ? $search : null,
|
|
is_string($categoryType) ? $categoryType : null,
|
|
);
|
|
|
|
// Echappatoire ?pagination=false : collection complete sans Paginator
|
|
// (cf. convention ERP-72 — utile pour un <select> cote front).
|
|
if (!$this->pagination->isEnabled($operation, $context)) {
|
|
// @var list<Client> $result
|
|
return $qb->getQuery()->getResult();
|
|
}
|
|
|
|
$limit = $this->pagination->getLimit($operation, $context);
|
|
$page = max(1, $this->pagination->getPage($context));
|
|
$offset = ($page - 1) * $limit;
|
|
|
|
$qb->setFirstResult($offset)->setMaxResults($limit);
|
|
|
|
// fetchJoinCollection: true pour un COUNT correct des que des JOINs
|
|
// to-many seront ajoutes (sous-collections embarquees en detail).
|
|
return new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: true));
|
|
}
|
|
|
|
/**
|
|
* @param array<string, mixed> $uriVariables
|
|
*/
|
|
private function provideItem(array $uriVariables): ?Client
|
|
{
|
|
$id = $uriVariables['id'] ?? null;
|
|
if (!is_int($id) && !(is_string($id) && ctype_digit($id))) {
|
|
return null;
|
|
}
|
|
|
|
$client = $this->repository->findById((int) $id);
|
|
if (null === $client) {
|
|
return null;
|
|
}
|
|
|
|
// Soft-delete : jamais expose au M1 (HP-M2-1) — 404 via retour null.
|
|
// Les archives restent visibles en detail (consultation + restauration).
|
|
if (null !== $client->getDeletedAt()) {
|
|
return null;
|
|
}
|
|
|
|
return $client;
|
|
}
|
|
|
|
/**
|
|
* Lit un flag booleen issu des query params. Accepte true / "true" / "1".
|
|
*/
|
|
private function readBool(mixed $raw): bool
|
|
{
|
|
if (is_bool($raw)) {
|
|
return $raw;
|
|
}
|
|
|
|
return is_string($raw) && in_array(strtolower($raw), ['true', '1'], true);
|
|
}
|
|
}
|