feat: inventaire bovins (!49)

| 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: #49
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

src/ApiResource/BovineSyncInventoryResult.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Post;
+use ApiPlatform\OpenApi\Model\Operation as OpenApiOperation;
+use App\State\Bovin\BovineSyncInventoryProcessor;
+
+#[ApiResource(
+    operations: [
+        new Post(
+            uriTemplate: '/bovines/sync-inventory',
+            openapi: new OpenApiOperation(
+                summary: "Synchronise l'inventaire bovin local avec EDNOTIF.",
+                description: 'Upsert des bovins par numéro national ; marque comme sortis ceux absents de la réponse EDNOTIF.',
+                tags: ['Bovines'],
+            ),
+            security: "is_granted('ROLE_ADMIN')",
+            input: false,
+            output: self::class,
+            processor: BovineSyncInventoryProcessor::class,
+            read: false,
+        ),
+    ]
+)]
+final class BovineSyncInventoryResult
+{
+    #[ApiProperty(identifier: true)]
+    public string $id = 'current';
+
+    public int $created = 0;
+
+    public int $updated = 0;
+
+    public int $exited = 0;
+
+    public int $total = 0;
+}

src/Entity/Bovine.php

@@ -5,8 +5,10 @@ declare(strict_types=1);
 namespace App\Entity;
 
 use ApiPlatform\Doctrine\Orm\Filter\DateFilter;
+use ApiPlatform\Doctrine\Orm\Filter\ExistsFilter;
 use ApiPlatform\Doctrine\Orm\Filter\SearchFilter;
 use ApiPlatform\Metadata\ApiFilter;
+use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Get;
 use ApiPlatform\Metadata\GetCollection;
@@ -20,14 +22,19 @@ use Symfony\Component\Serializer\Attribute\Groups;
 use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
 #[ORM\Entity]
+#[ORM\HasLifecycleCallbacks]
 #[ORM\Table(name: 'bovine')]
 #[ORM\UniqueConstraint(name: 'uniq_bovine_national_number', columns: ['national_number'])]
 #[ApiFilter(SearchFilter::class, properties: [
     'nationalNumber' => 'ipartial',
+    'workNumber'     => 'ipartial',
+    'breedCode'      => 'ipartial',
+    'sex'            => 'exact',
     'buildingCase'   => 'exact',
     'receivedWeight' => 'exact',
 ])]
-#[ApiFilter(DateFilter::class, properties: ['arrivalDate'])]
+#[ApiFilter(DateFilter::class, properties: ['arrivalDate', 'birthDate', 'exitDate'])]
+#[ApiFilter(ExistsFilter::class, properties: ['exitedAt'])]
 #[ApiResource(
     operations: [
         new Get(
@@ -76,6 +83,7 @@ class Bovine
 
     #[ORM\ManyToOne(inversedBy: 'bovines')]
     #[Groups(['bovine:read', 'bovine:write'])]
+    #[ApiProperty(readableLink: true)]
     private ?BuildingCase $buildingCase = null;
 
     #[ORM\ManyToOne]
@@ -95,6 +103,24 @@ class Bovine
     #[Groups(['bovine:read', 'building_case:read'])]
     private ?string $breedCode = null;
 
+    #[ORM\Column(length: 1, nullable: true)]
+    #[Groups(['bovine:read', 'building_case:read'])]
+    private ?string $sex = null;
+
+    #[ORM\Column(type: 'integer', nullable: true)]
+    #[Groups(['bovine:read', 'building_case:read'])]
+    private ?int $ageMonths = null;
+
+    #[ORM\Column(type: 'date_immutable', nullable: true)]
+    #[Groups(['bovine:read', 'building_case:read'])]
+    #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+    private ?DateTimeImmutable $exitDate = null;
+
+    #[ORM\Column(type: 'datetime_immutable', nullable: true)]
+    #[Groups(['bovine:read', 'building_case:read'])]
+    #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+    private ?DateTimeImmutable $exitedAt = null;
+
     public function getId(): ?int
     {
         return $this->id;
@@ -195,4 +221,66 @@ class Bovine
 
         return $this;
     }
+
+    public function getSex(): ?string
+    {
+        return $this->sex;
+    }
+
+    public function setSex(?string $sex): static
+    {
+        $this->sex = $sex;
+
+        return $this;
+    }
+
+    public function getExitDate(): ?DateTimeImmutable
+    {
+        return $this->exitDate;
+    }
+
+    public function setExitDate(?DateTimeImmutable $exitDate): static
+    {
+        $this->exitDate = $exitDate;
+
+        return $this;
+    }
+
+    public function getExitedAt(): ?DateTimeImmutable
+    {
+        return $this->exitedAt;
+    }
+
+    public function setExitedAt(?DateTimeImmutable $exitedAt): static
+    {
+        $this->exitedAt = $exitedAt;
+
+        return $this;
+    }
+
+    public function getAgeMonths(): ?int
+    {
+        return $this->ageMonths;
+    }
+
+    public function setAgeMonths(?int $ageMonths): static
+    {
+        $this->ageMonths = $ageMonths;
+
+        return $this;
+    }
+
+    #[ORM\PrePersist]
+    #[ORM\PreUpdate]
+    public function refreshAgeMonths(): void
+    {
+        if (null === $this->birthDate) {
+            $this->ageMonths = null;
+
+            return;
+        }
+
+        $diff            = $this->birthDate->diff(new DateTimeImmutable());
+        $this->ageMonths = ($diff->y * 12) + $diff->m;
+    }
 }

src/Entity/Building.php

@@ -36,7 +36,7 @@ class Building
     private ?int $id = null;
 
     #[ORM\Column(length: 120)]
-    #[Groups(['building:read', 'building:summary', 'reception:read'])]
+    #[Groups(['building:read', 'building:summary', 'reception:read', 'bovine:read'])]
     private string $label = '';
 
     #[ORM\Column(length: 50)]

src/Entity/BuildingCase.php

@@ -43,7 +43,7 @@ class BuildingCase
     private ?int $id = null;
 
     #[ORM\Column]
-    #[Groups(['building:read', 'building_case:read'])]
+    #[Groups(['building:read', 'building_case:read', 'bovine:read'])]
     #[SerializedName('caseNumber')]
     private ?int $case_number = null;
 
@@ -62,7 +62,7 @@ class BuildingCase
     private Collection $id_case_position;
 
     #[ORM\ManyToOne(inversedBy: 'buildingCases')]
-    #[Groups(['building_case:read'])]
+    #[Groups(['building_case:read', 'bovine:read'])]
     #[SerializedName('building')]
     private ?Building $id_building = null;
 

src/State/Bovin/BovineSyncInventoryProcessor.php

@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State\Bovin;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProcessorInterface;
+use App\ApiResource\BovineSyncInventoryResult;
+use App\Entity\Bovine;
+use DateTimeImmutable;
+use Doctrine\ORM\EntityManagerInterface;
+use Malio\EdnotifBundle\Bovin\Api\BovinApiInterface;
+use Malio\EdnotifBundle\Bovin\Dto\AnimalSummaryDto;
+
+/**
+ * @implements ProcessorInterface<mixed, BovineSyncInventoryResult>
+ */
+final class BovineSyncInventoryProcessor implements ProcessorInterface
+{
+    public function __construct(
+        private BovinApiInterface $bovinApi,
+        private EntityManagerInterface $em,
+    ) {}
+
+    public function process(
+        mixed $data,
+        Operation $operation,
+        array $uriVariables = [],
+        array $context = [],
+    ): BovineSyncInventoryResult {
+        $inventory = $this->bovinApi->getInventory(new DateTimeImmutable('today'));
+
+        $result        = new BovineSyncInventoryResult();
+        $result->total = count($inventory->animals);
+
+        $existingByNationalNumber = [];
+        foreach ($this->em->getRepository(Bovine::class)->findAll() as $bovine) {
+            $existingByNationalNumber[$bovine->getNationalNumber()] = $bovine;
+        }
+
+        $seen = [];
+        foreach ($inventory->animals as $animal) {
+            $nationalNumber = $animal->identification?->bovin?->nationalNumber;
+            if (null === $nationalNumber || '' === $nationalNumber) {
+                continue;
+            }
+            $seen[$nationalNumber] = true;
+
+            if (isset($existingByNationalNumber[$nationalNumber])) {
+                $bovine = $existingByNationalNumber[$nationalNumber];
+                ++$result->updated;
+            } else {
+                $bovine = new Bovine();
+                $bovine->setNationalNumber($nationalNumber);
+                $this->em->persist($bovine);
+                ++$result->created;
+            }
+
+            $this->applyEdnotifData($bovine, $animal);
+            $bovine->setExitedAt(null);
+        }
+
+        $now = new DateTimeImmutable();
+        foreach ($existingByNationalNumber as $nationalNumber => $bovine) {
+            if (isset($seen[$nationalNumber])) {
+                continue;
+            }
+            if (null !== $bovine->getExitedAt()) {
+                continue;
+            }
+            $bovine->setExitedAt($now);
+            ++$result->exited;
+        }
+
+        $this->em->flush();
+
+        return $result;
+    }
+
+    private function applyEdnotifData(Bovine $bovine, AnimalSummaryDto $animal): void
+    {
+        $identification = $animal->identification;
+        if (null !== $identification) {
+            $bovine->setSex($identification->sex);
+            $bovine->setBreedCode($identification->breedType);
+            $bovine->setWorkNumber($identification->workNumber);
+            $bovine->setBirthDate($identification->birthDate?->date);
+        }
+
+        $latestEntry = null;
+        $latestExit  = null;
+        foreach ($animal->presencePeriods as $period) {
+            if (null !== $period->entry?->date && (null === $latestEntry || $period->entry->date > $latestEntry)) {
+                $latestEntry = $period->entry->date;
+            }
+            if (null !== $period->exit?->date && (null === $latestExit || $period->exit->date > $latestExit)) {
+                $latestExit = $period->exit->date;
+            }
+        }
+        $bovine->setArrivalDate($latestEntry);
+        $bovine->setExitDate($latestExit);
+        $bovine->refreshAgeMonths();
+    }
+}