feat: add booking time ranges and repeating series

src/Entity/BookingSeries.php

@@ -0,0 +1,191 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Entity;
+
+use App\Booking\RecurrenceRule;
+use App\Booking\TimeRange;
+use App\Repository\BookingSeriesRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+
+/**
+ * A repeating reservation.
+ *
+ * The series is a description, not a source of truth for availability: creating one writes real
+ * Booking rows for every occurrence up to endDate. That is what keeps the conflict check
+ * database-backed -- a rule that is only expanded at render time is invisible to every other
+ * booking attempt.
+ */
+#[ORM\Entity(repositoryClass: BookingSeriesRepository::class)]
+class BookingSeries
+{
+    /** A series may not run further out than this; desks are not booked years ahead. */
+    public const MAX_MONTHS = 12;
+
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column]
+    private ?int $id = null;
+
+    #[ORM\ManyToOne]
+    #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
+    private User $user;
+
+    #[ORM\ManyToOne]
+    #[ORM\JoinColumn(nullable: false, onDelete: 'RESTRICT')]
+    private Resource $resource;
+
+    #[ORM\Column(enumType: RecurrenceRule::class)]
+    private RecurrenceRule $rule;
+
+    /**
+     * ISO weekdays (1 = Monday) the series falls on. Empty for a DAILY rule, which means
+     * every calendar day.
+     *
+     * @var list<int>
+     */
+    #[ORM\Column]
+    private array $weekdays = [];
+
+    #[ORM\Column(type: 'date_immutable')]
+    private \DateTimeImmutable $startDate;
+
+    #[ORM\Column(type: 'date_immutable')]
+    private \DateTimeImmutable $endDate;
+
+    #[ORM\Column]
+    private int $startMinute;
+
+    #[ORM\Column]
+    private int $endMinute;
+
+    #[ORM\Column(type: 'datetime_immutable')]
+    private \DateTimeImmutable $createdAt;
+
+    /** @var Collection<int, Booking> */
+    #[ORM\OneToMany(targetEntity: Booking::class, mappedBy: 'series')]
+    private Collection $bookings;
+
+    /**
+     * @param list<int> $weekdays
+     */
+    public function __construct(
+        User $user,
+        Resource $resource,
+        RecurrenceRule $rule,
+        \DateTimeImmutable $startDate,
+        \DateTimeImmutable $endDate,
+        TimeRange $time,
+        array $weekdays = [],
+    ) {
+        $this->user = $user;
+        $this->resource = $resource;
+        $this->rule = $rule;
+        $this->startDate = $startDate->setTime(0, 0);
+        $this->endDate = $endDate->setTime(0, 0);
+        $this->startMinute = $time->startMinute;
+        $this->endMinute = $time->endMinute;
+        $this->weekdays = RecurrenceRule::WEEKLY === $rule ? array_values(array_unique($weekdays)) : [];
+        $this->createdAt = new \DateTimeImmutable();
+        $this->bookings = new ArrayCollection();
+    }
+
+    /**
+     * Every day this series falls on, in order.
+     *
+     * @return list<\DateTimeImmutable>
+     */
+    public function occurrences(): array
+    {
+        $dates = [];
+
+        for ($day = $this->startDate; $day <= $this->endDate; $day = $day->modify('+1 day')) {
+            if (RecurrenceRule::WEEKLY === $this->rule && !\in_array((int) $day->format('N'), $this->weekdays, true)) {
+                continue;
+            }
+
+            $dates[] = $day;
+        }
+
+        return $dates;
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getUser(): User
+    {
+        return $this->user;
+    }
+
+    public function getResource(): Resource
+    {
+        return $this->resource;
+    }
+
+    public function getRule(): RecurrenceRule
+    {
+        return $this->rule;
+    }
+
+    /**
+     * @return list<int>
+     */
+    public function getWeekdays(): array
+    {
+        return $this->weekdays;
+    }
+
+    public function getStartDate(): \DateTimeImmutable
+    {
+        return $this->startDate;
+    }
+
+    public function getEndDate(): \DateTimeImmutable
+    {
+        return $this->endDate;
+    }
+
+    public function setEndDate(\DateTimeImmutable $endDate): void
+    {
+        $this->endDate = $endDate->setTime(0, 0);
+    }
+
+    public function getTimeRange(): TimeRange
+    {
+        return TimeRange::fromMinutes($this->startMinute, $this->endMinute);
+    }
+
+    public function getCreatedAt(): \DateTimeImmutable
+    {
+        return $this->createdAt;
+    }
+
+    /**
+     * @return Collection<int, Booking>
+     */
+    public function getBookings(): Collection
+    {
+        return $this->bookings;
+    }
+
+    public function describe(): string
+    {
+        $description = $this->rule->label();
+
+        if (RecurrenceRule::WEEKLY === $this->rule && [] !== $this->weekdays) {
+            $names = ['', 'Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa', 'So'];
+            // Sort the numbers, not the names -- alphabetical would read "Di, Do, Fr, Mi, Mo".
+            $weekdays = $this->weekdays;
+            sort($weekdays);
+            $description .= ' ('.implode(', ', array_map(static fn (int $day): string => $names[$day], $weekdays)).')';
+        }
+
+        return $description.', '.$this->getTimeRange();
+    }
+}