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

src/Controller/Api/ContingentController.php

@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller\Api;
+
+use App\BpnConnect\ContingentsClient;
+use App\BpnConnect\Exception\BpnConnectException;
+use App\Entity\Groups\AccommodationPrice;
+use App\Enum\Groups\PriceType;
+use App\Model\ContingentCalendarQuery;
+use App\Model\ContingentPricesQuery;
+use App\Repository\Groups\AccommodationPriceRepository;
+use App\Repository\Groups\AccommodationRepository;
+use App\Service\PriceTimelineBuilder;
+use Psr\Cache\InvalidArgumentException;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+use Symfony\Contracts\Cache\CacheInterface;
+use Symfony\Contracts\Cache\ItemInterface;
+
+#[Route('/api')]
+#[IsGranted('ROLE_OAUTH2_API')]
+class ContingentController extends AbstractController
+{
+    public function __construct(
+        private readonly ContingentsClient $contingentsClient,
+        private readonly AccommodationRepository $accommodationRepository,
+        private readonly AccommodationPriceRepository $priceRepository,
+        private readonly CacheInterface $cache,
+        private readonly PriceTimelineBuilder $priceTimelineBuilder,
+    ) {
+    }
+
+    #[Route(path: '/contingents/prices', name: 'api_contingents_prices', methods: ['GET'])]
+    public function prices(
+        #[MapQueryString(validationFailedStatusCode: Response::HTTP_BAD_REQUEST)]
+        ContingentPricesQuery $query,
+    ): JsonResponse {
+        $accommodation = $this->accommodationRepository->findOneBy(['calendarCode' => $query->hotelCode]);
+
+        if (null === $accommodation) {
+            return $this->json(['error' => 'hotel not found for hotelCode.'], Response::HTTP_BAD_REQUEST);
+        }
+
+        $yearStart = new \DateTimeImmutable("{$query->year}-01-01");
+        $yearEnd = new \DateTimeImmutable("{$query->year}-12-31");
+
+        $prices = $this->priceRepository->findByHotelCodeAndDateRange($query->hotelCode, $yearStart, $yearEnd);
+
+        $currency = $accommodation->getCurrency();
+
+        return $this->json($this->priceTimelineBuilder->buildTimeline($prices, $yearStart, $yearEnd, $currency));
+    }
+
+    #[Route(path: '/contingents/calendar', name: 'api_contingents_calendar', methods: ['GET'])]
+    public function calendar(
+        #[MapQueryString(validationFailedStatusCode: Response::HTTP_BAD_REQUEST)]
+        ContingentCalendarQuery $query,
+    ): JsonResponse {
+        $dateFrom = $query->dateFromDate();
+        $dateTo = $query->dateToDate();
+
+        $accommodation = $this->accommodationRepository->findOneBy(['calendarCode' => $query->hotelCode]);
+
+        if (null === $accommodation) {
+            return $this->json(['error' => 'hotel not found for hotelCode.'], Response::HTTP_BAD_REQUEST);
+        }
+
+        try {
+            $cacheKey = sprintf('contingents_calendar_%s_%s_%s', $query->hotelCode, $query->dateFrom, $query->dateTo);
+            $calendar = $this->cache->get($cacheKey, function (ItemInterface $item) use ($query) {
+                $item->expiresAfter(3600);
+
+                return $this->contingentsClient->getContingentCalendar($query->hotelCode, $query->dateFrom, $query->dateTo);
+            });
+        } catch (BpnConnectException|InvalidArgumentException $e) {
+            return $this->json(['error' => 'Failed to fetch contingent data.'], Response::HTTP_BAD_GATEWAY);
+        }
+
+        $prices = $this->priceRepository->findByHotelCodeAndDateRange($query->hotelCode, $dateFrom, $dateTo);
+
+        $currency = $accommodation->getCurrency();
+
+        $data = array_map(
+            fn ($entry) => $this->enrichEntry($entry->date, $entry->status->value, $prices, $currency),
+            $calendar->data,
+        );
+
+        return $this->json($data);
+    }
+
+    /**
+     * @param AccommodationPrice[] $prices
+     *
+     * @return array{date: string, status: string, type: string|null, pricePerNight: float|null, defaultPricePerNight: float|null, priceAdditionalPerson: float|null, defaultPriceAdditionalPerson: float|null, includedPax: int|null, minNights: int|null}
+     */
+    private function enrichEntry(string $date, string $status, array $prices, string $currency): array
+    {
+        $day = (new \DateTimeImmutable($date))->setTime(0, 0);
+
+        // dateFrom and dateTo are both inclusive (last night, not checkout day)
+        $candidates = array_filter(
+            $prices,
+            fn ($p) => $p->getDateFrom() <= $day && $p->getDateTo() >= $day,
+        );
+
+        $winner = $this->priceTimelineBuilder->resolveWinner($candidates);
+
+        $defaultPrice = null;
+        if (PriceType::DISCOUNT === $winner?->getType()) {
+            $defaults = array_filter($candidates, fn ($p) => null === $p->getType());
+            $defaultPrice = $this->priceTimelineBuilder->resolveWinner($defaults);
+        }
+
+        return [
+            'date' => $date,
+            'status' => $status,
+            'type' => $winner?->getType()?->value,
+            'pricePerNight' => null !== $winner ? round($winner->getPricePerNight() / 100, 2) : null,
+            'defaultPricePerNight' => null !== $defaultPrice ? round($defaultPrice->getPricePerNight() / 100, 2) : null,
+            'priceAdditionalPerson' => null !== $winner ? round($winner->getPriceAdditionalPerson() / 100, 2) : null,
+            'defaultPriceAdditionalPerson' => null !== $defaultPrice ? round($defaultPrice->getPriceAdditionalPerson() / 100, 2) : null,
+            'currency' => $currency,
+            'includedPax' => $winner?->getIncludedPax(),
+            'minNights' => $winner?->getMinNights(),
+        ];
+    }
+}