myep/src/Form/Service/ParticipantParkingFieldHandler.php

<?php

declare(strict_types=1);

namespace App\Form\Service;

use App\BusProNet\Constants;
use App\BusProNet\Model\Service;
use App\BusProNet\Utility\DirectionMapper;
use App\Form\Model\BookingDto;
use App\Form\Model\ParticipantDto;
use App\Form\Service\Abstract\AbstractParticipantFieldHandler;

/**
 * Handles parking service selection for self-organized transportation.
 *
 * Parking is only available when outbound transportation is PKW (car) AND
 * participant is at least 18 years old (minimum driving age in Germany).
 * Automatically clears parking when conditions are not met.
 */
class ParticipantParkingFieldHandler extends AbstractParticipantFieldHandler
{
    public function getFieldName(): string
    {
        return 'parking';
    }

    private const MINIMUM_DRIVING_AGE = 18;

    public function getDependencies(): array
    {
        return ['transportationOutbound', 'transportationInbound', 'dateOfBirth'];
    }

    /**
     * Determines if this handler should process the field based on submitted data.
     *
     * For parking selection fields, we always need to process to handle cases
     * where the parking is cleared due to transportation changes. This ensures the
     * participant DTO is updated correctly when transportation switches to bus-only.
     *
     * @param array<string, mixed> $submittedData    The submitted participant form data
     * @param string               $mode             The booking mode (BookingDto::MODE_CREATE or MODE_EDIT)
     * @param int                  $participantIndex The index of the participant being processed
     *
     * @return bool Always returns true for parking selection fields
     */
    public function shouldProcess(array $submittedData, string $mode, int $participantIndex): bool
    {
        return true; // Always process for state changes
    }

    public function processField(array $submittedData, BookingDto $bookingDto, int $participantIndex): void
    {
        $participant = $this->getParticipant($bookingDto, $participantIndex);
        if (null === $participant) {
            return;
        }

        // Check if parking is applicable (outbound transportation is PKW AND participant is 18+)
        if (false === $this->isParkingApplicable($participant)) {
            $participant->parking = false;
            $participant->parkingService = null;

            return;
        }

        $parkingSelected = $this->getFieldValue($submittedData, $this->getFieldName());
        $isParkingSelected = $this->normalizeCheckboxValue($parkingSelected);

        // Store boolean value for backward compatibility
        $participant->parking = $isParkingSelected;

        // Store parking service object for pricing calculation
        if (true === $isParkingSelected) {
            $participant->parkingService = $this->findParkingService($bookingDto, $participantIndex);
        } else {
            $participant->parkingService = null;
        }
    }

    /**
     * Checks if parking is applicable based on outbound transportation and age.
     *
     * Parking is only applicable when:
     * 1. Outbound transportation is PKW (arriving by car at destination)
     * 2. Participant is at least 18 years old (minimum driving age in Germany)
     *
     * @param ParticipantDto $participant The participant DTO
     *
     * @return bool True if parking is applicable, false otherwise
     */
    private function isParkingApplicable(ParticipantDto $participant): bool
    {
        // Must have PKW outbound transportation
        if (DirectionMapper::SUBTYPE_CAR_API !== $participant->transportationOutbound?->subType) {
            return false;
        }

        // Must be at least minimum driving age
        $age = $participant->getAge();
        if (null === $age || $age < self::MINIMUM_DRIVING_AGE) {
            return false;
        }

        return true;
    }

    /**
     * Finds the parking service from available services.
     *
     * Gets the first (and typically only) parking service for pricing calculation.
     * Returns null if no parking services are available.
     *
     * @param BookingDto $bookingDto       The booking DTO containing travel data
     * @param int        $participantIndex The participant index for booked services lookup
     *
     * @return Service|null The parking service object, or null if not found
     */
    private function findParkingService(BookingDto $bookingDto, int $participantIndex): ?Service
    {
        // Get available parking services (includes booked parking in edit mode)
        $parkingServices = $this->getAvailableServicesWithBooked(
            $bookingDto,
            $participantIndex,
            Constants::TOKEN_PARKING
        );

        if (empty($parkingServices)) {
            return null;
        }

        // Return the first parking service (there's typically only one parking type)
        return reset($parkingServices);
    }
}