feat: ajout des 3 derniers WS en lecture du bundle malio ednotif (!47)

- 3 nouveaux endpoints API Platform pass-through sur /api/bovins/{inventory|returned-dossiers|presumed-exits} consommant BovinApiInterface v0.0.6
- AnimalSummaryMapper (src/Service/) factorisant le mapping DTO EDNOTIF -> ressource
- src/State/ réorganisé par domaine (Bovin/, Reception/, Shipment/, Building/, User/, System/)
- tag OpenAPI "Bovins" pour regrouper les endpoints ednotif dans Swagger
- malio/ednotif-bundle passé à v0.0.6

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

| Numéro du ticket | Titre du ticket |
|------------------|-----------------|
|                  |                 |

## Description de la PR

## Modification du .env

## Check list

- [ ] Pas de régression
- [ ] TU/TI/TF rédigée
- [ ] TU/TI/TF OK
- [ ] CHANGELOG modifié

Reviewed-on: #47
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

src/State/Bovin/BovinIdentificationProvider.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\ApiResource\BovinIdentification;
+use App\ApiResource\PresencePeriod;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+
+/**
+ * @implements ProviderInterface<null|BovinIdentification>
+ */
+final class BovinIdentificationProvider implements ProviderInterface
+{
+    public function __construct(
+        private BovinApiInterface $bovinApi
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): ?BovinIdentification
+    {
+        $numeroNational = (string) ($uriVariables['numeroNational'] ?? '');
+        if ('' === $numeroNational) {
+            return null;
+        }
+
+        $animalFileDto = $this->bovinApi->getAnimalFile(
+            nationalNumber: $numeroNational,
+            countryCode: 'FR'
+        );
+
+        $identificationDto = $animalFileDto->identification;
+
+        $resource                 = new BovinIdentification();
+        $resource->numeroNational = $numeroNational;
+
+        $resource->sex        = $identificationDto?->sex;
+        $resource->breedType  = $identificationDto?->breedType;
+        $resource->workNumber = $identificationDto?->workNumber;
+
+        $resource->birthDate                 = $identificationDto?->birthDate?->date?->format('Y-m-d');
+        $resource->birthDateCompletenessFlag = $identificationDto?->birthDate?->completenessFlag;
+
+        $resource->isFilie = $identificationDto?->isFilie;
+
+        $resource->motherNationalNumber = $identificationDto?->motherCarrier?->bovin?->nationalNumber;
+        $resource->motherBreedType      = $identificationDto?->motherCarrier?->breedType;
+
+        $resource->fatherNationalNumber = $identificationDto?->fatherIpg?->bovin?->nationalNumber;
+        $resource->fatherBreedType      = $identificationDto?->fatherIpg?->breedType;
+
+        $resource->birthExploitationNumber = $identificationDto?->birthExploitation?->exploitationNumber;
+
+        foreach ($animalFileDto->presencePeriods as $presencePeriodDto) {
+            $presencePeriod = new PresencePeriod();
+
+            $presencePeriod->entryDate  = $presencePeriodDto->entry?->date?->format('Y-m-d');
+            $presencePeriod->entryCause = $presencePeriodDto->entry?->cause;
+
+            $presencePeriod->exitDate  = $presencePeriodDto->exit?->date?->format('Y-m-d');
+            $presencePeriod->exitCause = $presencePeriodDto->exit?->cause;
+
+            $resource->presencePeriods[] = $presencePeriod;
+        }
+
+        return $resource;
+    }
+}

src/State/Bovin/BovinInventoryProvider.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\ApiResource\BovinInventory;
+use App\Service\AnimalSummaryMapper;
+use DateTimeImmutable;
+use Exception;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+use Symfony\Component\HttpFoundation\RequestStack;
+
+use function count;
+use function is_string;
+
+/**
+ * @implements ProviderInterface<null|BovinInventory>
+ */
+final class BovinInventoryProvider implements ProviderInterface
+{
+    public function __construct(
+        private BovinApiInterface $bovinApi,
+        private RequestStack $requestStack,
+        private AnimalSummaryMapper $animalSummaryMapper,
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): ?BovinInventory
+    {
+        $startDateRaw = (string) ($uriVariables['startDate'] ?? '');
+        if ('' === $startDateRaw) {
+            return null;
+        }
+
+        try {
+            $startDate = new DateTimeImmutable($startDateRaw);
+        } catch (Exception) {
+            return null;
+        }
+
+        $request = $this->requestStack->getCurrentRequest();
+
+        $endDate    = null;
+        $endDateRaw = $request?->query->get('endDate');
+        if (is_string($endDateRaw) && '' !== $endDateRaw) {
+            try {
+                $endDate = new DateTimeImmutable($endDateRaw);
+            } catch (Exception) {
+                return null;
+            }
+        }
+
+        $includeEarTagStock = (bool) $request?->query->getBoolean('includeEarTagStock', false);
+
+        $inventoryDto = $this->bovinApi->getInventory(
+            startDate: $startDate,
+            endDate: $endDate,
+            includeEarTagStock: $includeEarTagStock,
+        );
+
+        $resource                      = new BovinInventory();
+        $resource->startDate           = $inventoryDto->startDate?->format('Y-m-d') ?? $startDate->format('Y-m-d');
+        $resource->endDate             = $inventoryDto->endDate?->format('Y-m-d');
+        $resource->includesEarTagStock = $inventoryDto->includesEarTagStock;
+        $resource->nbBovins            = $inventoryDto->nbBovins;
+        $resource->earTagSeriesCount   = count($inventoryDto->earTagSeries);
+
+        foreach ($inventoryDto->animals as $animalDto) {
+            $resource->animals[] = $this->animalSummaryMapper->map($animalDto);
+        }
+
+        return $resource;
+    }
+}

src/State/Bovin/BovinPresumedExitsProvider.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\ApiResource\BovinPresumedExit;
+use App\ApiResource\BovinPresumedExits;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+
+/**
+ * @implements ProviderInterface<BovinPresumedExits>
+ */
+final class BovinPresumedExitsProvider implements ProviderInterface
+{
+    public function __construct(
+        private BovinApiInterface $bovinApi,
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): BovinPresumedExits
+    {
+        $dto = $this->bovinApi->getPresumedExits();
+
+        $resource           = new BovinPresumedExits();
+        $resource->nbBovins = $dto->nbBovins;
+
+        foreach ($dto->presumedExits as $exitDto) {
+            $exit                 = new BovinPresumedExit();
+            $exit->countryCode    = $exitDto->bovin?->countryCode;
+            $exit->nationalNumber = $exitDto->bovin?->nationalNumber;
+            $exit->exitDate       = $exitDto->exitDate?->format('Y-m-d');
+
+            $resource->presumedExits[] = $exit;
+        }
+
+        return $resource;
+    }
+}

src/State/Bovin/BovinReturnedDossiersProvider.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\ApiResource\BovinReturnedDossiers;
+use App\Service\AnimalSummaryMapper;
+use DateTimeImmutable;
+use Exception;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+
+/**
+ * @implements ProviderInterface<null|BovinReturnedDossiers>
+ */
+final class BovinReturnedDossiersProvider implements ProviderInterface
+{
+    public function __construct(
+        private BovinApiInterface $bovinApi,
+        private AnimalSummaryMapper $animalSummaryMapper,
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): ?BovinReturnedDossiers
+    {
+        $startDateRaw = (string) ($uriVariables['startDate'] ?? '');
+        if ('' === $startDateRaw) {
+            return null;
+        }
+
+        try {
+            $startDate = new DateTimeImmutable($startDateRaw);
+        } catch (Exception) {
+            return null;
+        }
+
+        $dto = $this->bovinApi->getReturnedDossiers($startDate);
+
+        $resource            = new BovinReturnedDossiers();
+        $resource->startDate = $dto->startDate?->format('Y-m-d') ?? $startDate->format('Y-m-d');
+        $resource->nbBovins  = $dto->nbBovins;
+
+        foreach ($dto->animals as $animalDto) {
+            $resource->animals[] = $this->animalSummaryMapper->map($animalDto);
+        }
+
+        return $resource;
+    }
+}

src/State/Bovin/BovineProcessor.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProcessorInterface;
+use App\Entity\Bovine;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
+use Throwable;
+
+final class BovineProcessor implements ProcessorInterface
+{
+    public function __construct(
+        private readonly BovinApiInterface $bovinApi,
+        #[Autowire(service: 'api_platform.doctrine.orm.state.persist_processor')]
+        private readonly ProcessorInterface $persistProcessor,
+    ) {}
+
+    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
+    {
+        if ($data instanceof Bovine && '' !== $data->getNationalNumber()) {
+            $this->enrichFromEdnotif($data);
+        }
+
+        return $this->persistProcessor->process($data, $operation, $uriVariables, $context);
+    }
+
+    private function enrichFromEdnotif(Bovine $bovine): void
+    {
+        try {
+            $animalFile = $this->bovinApi->getAnimalFile(
+                nationalNumber: $bovine->getNationalNumber(),
+                countryCode: 'FR',
+            );
+
+            $identification = $animalFile->identification;
+            if (null === $identification) {
+                return;
+            }
+
+            $bovine->setWorkNumber($identification->workNumber);
+            $bovine->setBirthDate($identification->birthDate?->date);
+            $bovine->setBreedCode($this->normalizeBreedCode($identification->breedType));
+        } catch (Throwable) {
+            // External service unavailable — persist bovine without enrichment.
+        }
+    }
+
+    private function normalizeBreedCode(mixed $breedType): ?string
+    {
+        if (null === $breedType) {
+            return null;
+        }
+
+        if (is_numeric($breedType)) {
+            return (string) $breedType;
+        }
+
+        if (is_string($breedType) && preg_match('/\d+/', $breedType, $matches)) {
+            return $matches[0];
+        }
+
+        return null;
+    }
+}