feat: improved contingents api performance with db backed snapshots

src/Entity/Groups/ContingentDay.php

@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity\Groups;
+
+use App\BpnConnect\Model\ContingentStatus;
+use App\Repository\Groups\ContingentDayRepository;
+use Doctrine\DBAL\Types\Types;
+use Doctrine\ORM\Mapping as ORM;
+
+/**
+ * Local snapshot of a single day of contingent availability as reported by bpn-connect.
+ *
+ * Written exclusively by the scheduled sync, never by a user, hence no Blameable/Timestampable.
+ */
+#[ORM\Entity(repositoryClass: ContingentDayRepository::class)]
+#[ORM\Table(name: 'contingent_day')]
+#[ORM\UniqueConstraint(name: 'uniq_contingent_day_accommodation_date', columns: ['accommodation_id', 'date'])]
+class ContingentDay
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne]
+    #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
+    private ?Accommodation $accommodation = null;
+
+    #[ORM\Column(type: Types::DATE_IMMUTABLE)]
+    private ?\DateTimeImmutable $date = null;
+
+    #[ORM\Column(length: 20, enumType: ContingentStatus::class)]
+    private ContingentStatus $status = ContingentStatus::Blocked;
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getAccommodation(): ?Accommodation
+    {
+        return $this->accommodation;
+    }
+
+    public function setAccommodation(?Accommodation $accommodation): self
+    {
+        $this->accommodation = $accommodation;
+
+        return $this;
+    }
+
+    public function getDate(): ?\DateTimeImmutable
+    {
+        return $this->date;
+    }
+
+    public function setDate(\DateTimeImmutable $date): self
+    {
+        $this->date = $date;
+
+        return $this;
+    }
+
+    public function getStatus(): ContingentStatus
+    {
+        return $this->status;
+    }
+
+    public function setStatus(ContingentStatus $status): self
+    {
+        $this->status = $status;
+
+        return $this;
+    }
+}