[#203] Réceptions — Parcours de pesée multi-étapes (première partie) (!3)

| Numéro du ticket | Titre du ticket |
|------------------|-----------------|
|        #203          |      Réceptions — Parcours de pesée multi-étapes         |

## Description de la PR
[#203] Réceptions — Parcours de pesée multi-étapes

## Modification du .env

## Check list

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

Reviewed-on: #3
Reviewed-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
Co-authored-by: AUTIN Tristan <tristan@yuno.malio.fr>
Co-committed-by: AUTIN Tristan <tristan@yuno.malio.fr>

src/Entity/Reception.php

@@ -0,0 +1,185 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\Patch;
+use ApiPlatform\Metadata\Post;
+use ApiPlatform\OpenApi\Model\Operation as OpenApiOperation;
+use App\Dto\PontBasculeReading;
+use App\State\ReceptionWeighingProvider;
+use DateTimeImmutable;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Serializer\Attribute\Context;
+use Symfony\Component\Serializer\Attribute\Groups;
+use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+#[ORM\Entity]
+#[ORM\HasLifecycleCallbacks]
+#[ORM\Table(name: 'reception')]
+#[ApiResource(
+    operations: [
+        new Get(
+            requirements: ['id' => '\d+'],
+            normalizationContext: ['groups' => ['reception:read']],
+        ),
+        new GetCollection(
+            normalizationContext: ['groups' => ['reception:read']],
+        ),
+        new Post(
+            normalizationContext: ['groups' => ['reception:read']],
+            denormalizationContext: ['groups' => ['reception:write']],
+        ),
+        new Patch(
+            requirements: ['id' => '\d+'],
+            normalizationContext: ['groups' => ['reception:read']],
+            denormalizationContext: ['groups' => ['reception:write']],
+        ),
+        new Get(
+            uriTemplate: '/receptions/weigh',
+            openapi: new OpenApiOperation(
+                summary: 'Fetch the current weight reading',
+                description: 'Queries the pont-bascule and returns the weight data.',
+            ),
+            normalizationContext: ['groups' => ['reception:weigh:read']],
+            output: PontBasculeReading::class,
+            provider: ReceptionWeighingProvider::class,
+        ),
+    ],
+)]
+class Reception
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    #[Groups(['reception:read'])]
+    private ?int $id = null;
+
+    #[ORM\Column(length: 20, nullable: true)]
+    #[Groups(['reception:read', 'reception:write'])]
+    private ?string $licensePlate = null;
+
+    #[ORM\Column(options: ['default' => 0])]
+    #[Groups(['reception:read', 'reception:write'])]
+    private int $currentStep = 0;
+
+    #[ORM\Column(options: ['default' => false])]
+    #[Groups(['reception:read', 'reception:write'])]
+    private bool $isValid = false;
+
+    #[ORM\Column(name: 'date_reception', type: 'datetime_immutable')]
+    #[Groups(['reception:read', 'reception:write'])]
+    #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+    private ?DateTimeImmutable $receptionDate = null;
+
+    #[ORM\OneToMany(targetEntity: Weight::class, mappedBy: 'reception', cascade: ['persist', 'remove'], orphanRemoval: true)]
+    #[Groups(['reception:read'])]
+    private Collection $weights;
+
+    public function __construct(
+        ?DateTimeImmutable $receptionDate = null,
+    ) {
+        $this->receptionDate = $receptionDate;
+        $this->weights       = new ArrayCollection();
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    #[Groups(['reception:read'])]
+    public function getLicensePlate(): ?string
+    {
+        return $this->licensePlate;
+    }
+
+    public function setLicensePlate(?string $licensePlate): self
+    {
+        $this->licensePlate = $licensePlate;
+
+        return $this;
+    }
+
+    #[Groups(['reception:read'])]
+    public function getCurrentStep(): int
+    {
+        return $this->currentStep;
+    }
+
+    public function setCurrentStep(int $currentStep): self
+    {
+        $this->currentStep = $currentStep;
+
+        return $this;
+    }
+
+    #[Groups(['reception:read'])]
+    public function isValid(): bool
+    {
+        return $this->isValid;
+    }
+
+    public function setIsValid(bool $isValid): self
+    {
+        $this->isValid = $isValid;
+
+        return $this;
+    }
+
+    #[Groups(['reception:read'])]
+    public function getReceptionDate(): ?DateTimeImmutable
+    {
+        return $this->receptionDate;
+    }
+
+    public function setReceptionDate(?DateTimeImmutable $receptionDate): self
+    {
+        $this->receptionDate = $receptionDate;
+
+        return $this;
+    }
+
+    /**
+     * @return Collection<int, Weight>
+     */
+    public function getWeights(): Collection
+    {
+        return $this->weights;
+    }
+
+    public function addWeight(Weight $weight): self
+    {
+        if (!$this->weights->contains($weight)) {
+            $this->weights->add($weight);
+            $weight->setReception($this);
+        }
+
+        return $this;
+    }
+
+    public function removeWeight(Weight $weight): self
+    {
+        if ($this->weights->removeElement($weight)) {
+            if ($weight->getReception() === $this) {
+                $weight->setReception(null);
+            }
+        }
+
+        return $this;
+    }
+
+    #[ORM\PrePersist]
+    public function initializeReceptionDate(): void
+    {
+        if (null === $this->receptionDate) {
+            $this->receptionDate = new DateTimeImmutable();
+        }
+    }
+}

src/Entity/Weight.php

@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\Patch;
+use ApiPlatform\Metadata\Post;
+use DateTimeImmutable;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+use Symfony\Component\Serializer\Attribute\Context;
+use Symfony\Component\Serializer\Attribute\Groups;
+use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+use Symfony\Component\Validator\Constraints as Assert;
+
+#[ORM\Entity]
+#[ORM\Table(name: 'weight')]
+#[ApiResource(
+    operations: [
+        new Get(normalizationContext: ['groups' => ['weight:read']]),
+        new GetCollection(normalizationContext: ['groups' => ['weight:read']]),
+        new Post(
+            normalizationContext: ['groups' => ['weight:read']],
+            denormalizationContext: ['groups' => ['weight:write']],
+        ),
+        new Patch(
+            normalizationContext: ['groups' => ['weight:read']],
+            denormalizationContext: ['groups' => ['weight:write']],
+        ),
+    ],
+)]
+#[UniqueEntity(fields: ['reception', 'type'], message: 'A weighing already exists for this type.')]
+class Weight
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    #[Groups(['reception:read', 'weight:read'])]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne(inversedBy: 'weights')]
+    #[ORM\JoinColumn(nullable: false)]
+    #[Groups(['weight:read', 'weight:write'])]
+    private ?Reception $reception = null;
+
+    #[ORM\Column(nullable: true)]
+    #[Groups(['reception:read', 'weight:read', 'weight:write'])]
+    #[Assert\PositiveOrZero]
+    private ?int $dsd = null;
+
+    #[ORM\Column(nullable: true)]
+    #[Groups(['reception:read', 'weight:read', 'weight:write'])]
+    #[Assert\PositiveOrZero]
+    private ?int $weight = null;
+
+    #[ORM\Column(type: 'datetime_immutable', nullable: true)]
+    #[Groups(['reception:read', 'weight:read', 'weight:write'])]
+    #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+    private ?DateTimeImmutable $weighedAt = null;
+
+    #[ORM\Column(length: 10)]
+    #[Groups(['reception:read', 'weight:read', 'weight:write'])]
+    #[Assert\NotBlank]
+    #[Assert\Choice(choices: ['gross', 'tare'])]
+    private string $type = 'gross';
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getReception(): ?Reception
+    {
+        return $this->reception;
+    }
+
+    public function setReception(?Reception $reception): self
+    {
+        $this->reception = $reception;
+
+        if (null !== $reception && !$reception->getWeights()->contains($this)) {
+            $reception->addWeight($this);
+        }
+
+        return $this;
+    }
+
+    public function getDsd(): ?int
+    {
+        return $this->dsd;
+    }
+
+    public function setDsd(?int $dsd): self
+    {
+        $this->dsd = $dsd;
+
+        return $this;
+    }
+
+    public function getWeight(): ?int
+    {
+        return $this->weight;
+    }
+
+    public function setWeight(?int $weight): self
+    {
+        $this->weight = $weight;
+
+        return $this;
+    }
+
+    public function getWeighedAt(): ?DateTimeImmutable
+    {
+        return $this->weighedAt;
+    }
+
+    public function setWeighedAt(?DateTimeImmutable $weighedAt): self
+    {
+        $this->weighedAt = $weighedAt;
+
+        return $this;
+    }
+
+    public function getType(): string
+    {
+        return $this->type;
+    }
+
+    public function setType(string $type): self
+    {
+        $this->type = $type;
+
+        return $this;
+    }
+}