feat: groups price calculator admin crud, booking/offer flow and api

src/Model/ContingentCalendarQuery.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Model;
+
+use Symfony\Component\Validator\Constraints as Assert;
+use Symfony\Component\Validator\Context\ExecutionContextInterface;
+
+final readonly class ContingentCalendarQuery
+{
+    private const int MAX_RANGE_DAYS = 366;
+
+    public function __construct(
+        #[Assert\NotBlank]
+        #[Assert\Length(max: 16)]
+        #[Assert\Regex(pattern: '/^[A-Za-z0-9_-]+$/')]
+        public string $hotelCode,
+
+        #[Assert\NotBlank]
+        #[Assert\Date]
+        public string $dateFrom,
+
+        #[Assert\NotBlank]
+        #[Assert\Date]
+        public string $dateTo,
+    ) {
+    }
+
+    #[Assert\Callback]
+    public function validateRange(ExecutionContextInterface $context): void
+    {
+        $dateFrom = self::parseDate($this->dateFrom);
+        $dateTo = self::parseDate($this->dateTo);
+
+        if (null === $dateFrom || null === $dateTo) {
+            return;
+        }
+
+        if ($dateTo < $dateFrom) {
+            $context->buildViolation('dateTo must not be before dateFrom.')
+                ->atPath('dateTo')
+                ->addViolation();
+
+            return;
+        }
+
+        if ($dateFrom->diff($dateTo)->days > self::MAX_RANGE_DAYS) {
+            $context->buildViolation(sprintf('The date range must not exceed %d days.', self::MAX_RANGE_DAYS))
+                ->atPath('dateTo')
+                ->addViolation();
+        }
+    }
+
+    public function dateFromDate(): \DateTimeImmutable
+    {
+        return self::parseDate($this->dateFrom)
+            ?? throw new \LogicException('ContingentCalendarQuery must be validated before use.');
+    }
+
+    public function dateToDate(): \DateTimeImmutable
+    {
+        return self::parseDate($this->dateTo)
+            ?? throw new \LogicException('ContingentCalendarQuery must be validated before use.');
+    }
+
+    private static function parseDate(string $value): ?\DateTimeImmutable
+    {
+        $date = \DateTimeImmutable::createFromFormat('!Y-m-d', $value);
+        $errors = \DateTimeImmutable::getLastErrors();
+
+        if (false === $date || (false !== $errors && ($errors['warning_count'] > 0 || $errors['error_count'] > 0))) {
+            return null;
+        }
+
+        return $date->format('Y-m-d') === $value ? $date : null;
+    }
+}