aucun filtre ; * - site courant null (module Sites off / user sans site) -> no-op (l'user voit * tout, decision site-aware.md § 5) ; * - sinon -> liste restreinte aux tickets du site courant, AVANT pagination * (totalItems reflete le perimetre). * * Item (GET /api/weighing_tickets/{id} + provider de PATCH) : * - 404 si introuvable OU soft-delete (deleted_at non null) ; * - 404 si hors perimetre site (ne pas reveler l'existence d'une ligne d'un autre * site — anti-enumeration). * * @implements ProviderInterface */ final class WeighingTicketProvider implements ProviderInterface { public function __construct( #[Autowire(service: 'App\Module\Logistique\Infrastructure\Doctrine\DoctrineWeighingTicketRepository')] private readonly WeighingTicketRepositoryInterface $repository, private readonly Pagination $pagination, private readonly CurrentSiteProviderInterface $currentSiteProvider, private readonly Security $security, ) {} public function provide(Operation $operation, array $uriVariables = [], array $context = []): iterable|Paginator|WeighingTicket|null { if ($operation instanceof CollectionOperationInterface) { return $this->provideCollection($operation, $context); } return $this->provideItem($uriVariables); } /** * @param array $context * * @return list|Paginator */ private function provideCollection(Operation $operation, array $context): array|Paginator { $filters = $context['filters'] ?? []; $search = $filters['search'] ?? null; $qb = $this->repository->createListQueryBuilder(is_string($search) ? $search : null); $this->applyDisplayDateOrder($qb, $filters); $this->applySiteScope($qb); // Echappatoire ?pagination=false : collection complete sans Paginator // (regle n°13 — utile pour alimenter un cote front). if (!$this->pagination->isEnabled($operation, $context)) { /** @var list $tickets */ 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); // Les fetch-joins du repository sont tous ManyToOne (client/supplier/site) : // pas de demultiplication de lignes -> fetchJoinCollection: false (COUNT // simple, page correcte). return new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: false)); } /** * @param array $uriVariables */ private function provideItem(array $uriVariables): ?WeighingTicket { $id = $uriVariables['id'] ?? null; if (!is_int($id) && !(is_string($id) && ctype_digit($id))) { return null; } $ticket = $this->repository->findById((int) $id); if (null === $ticket) { return null; } // Soft-delete : jamais expose au M5 (§ 2.13) -> 404 via retour null. if (null !== $ticket->getDeletedAt()) { return null; } // Cloisonnement par site : un ticket hors perimetre -> 404 (anti-enumeration). $scopeSite = $this->currentScopeSite(); if (null !== $scopeSite && $ticket->getSite()?->getId() !== $scopeSite->getId()) { return null; } return $ticket; } /** * Tri par date du ticket (§ 4.1) : displayDate = full_date ?? empty_date, donc * un getter calcule (pas une colonne) -> on trie sur l'expression DQL * COALESCE(full_date, empty_date). Absent du payload -> on garde le tri par * defaut du repository (number DESC). * * @param array $filters */ private function applyDisplayDateOrder(QueryBuilder $qb, array $filters): void { $order = $filters['order'] ?? null; if (!is_array($order) || !isset($order['displayDate'])) { return; } $direction = 'asc' === strtolower((string) $order['displayDate']) ? 'ASC' : 'DESC'; $rootAlias = $qb->getRootAliases()[0]; $qb->orderBy(sprintf('COALESCE(%1$s.fullDate, %1$s.emptyDate)', $rootAlias), $direction); } /** * Restreint la liste au site courant si l'user n'a pas le bypass et qu'un site * est selectionne (cf. docblock de classe). No-op sinon. */ private function applySiteScope(QueryBuilder $qb): void { $scopeSite = $this->currentScopeSite(); if (null === $scopeSite) { return; } $rootAlias = $qb->getRootAliases()[0]; $qb->andWhere(sprintf('%s.site = :scopeSite', $rootAlias)) ->setParameter('scopeSite', $scopeSite) ; } /** * Site servant a cloisonner, ou null si aucun cloisonnement ne s'applique * (bypass_scope, ou pas de site courant). Replique les conditions de * SiteScopedQueryExtension. */ private function currentScopeSite(): ?Site { if ($this->security->isGranted('sites.bypass_scope')) { return null; } return $this->currentSiteProvider->get(); } }