feat: split booking between participants and applicant

addresses #869f2q1vu

tests/Form/Service/ParticipantEmailFieldHandlerTest.php

@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Form\Service;
+
+use App\BusProNet\Model\Travel;
+use App\Form\Model\BookingDto;
+use App\Form\Model\ParticipantDto;
+use App\Form\Service\ParticipantDateOfBirthFieldHandler;
+use App\Form\Service\ParticipantEmailFieldHandler;
+use App\Form\Service\ParticipantFieldHandlerRegistry;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\NullLogger;
+
+class ParticipantEmailFieldHandlerTest extends TestCase
+{
+    private ParticipantEmailFieldHandler $handler;
+
+    protected function setUp(): void
+    {
+        $this->handler = new ParticipantEmailFieldHandler();
+    }
+
+    public function testChildWithoutEmailInheritsTheApplicants(): void
+    {
+        $bookingDto = $this->createBookingDto();
+
+        $this->handler->processField(['email' => ''], $bookingDto, 1);
+
+        $this->assertSame('[email protected]', $bookingDto->participants[1]->email);
+    }
+
+    public function testChildKeepsAnEmailThatWasTypedIn(): void
+    {
+        $bookingDto = $this->createBookingDto();
+
+        $this->handler->processField(['email' => '[email protected]'], $bookingDto, 1);
+
+        $this->assertSame(
+            '[email protected]',
+            $bookingDto->participants[1]->email,
+            'The pre-filled address stays overridable'
+        );
+    }
+
+    public function testAdultWithoutEmailDoesNotInherit(): void
+    {
+        $bookingDto = $this->createBookingDto();
+        $bookingDto->participants[1]->dateOfBirth = new \DateTimeImmutable('1990-01-01');
+
+        $this->handler->processField(['email' => ''], $bookingDto, 1);
+
+        $this->assertNull(
+            $bookingDto->participants[1]->email,
+            'An adult supplies their own address; NotBlank reports the gap'
+        );
+    }
+
+    public function testApplicantDoesNotInheritFromThemselves(): void
+    {
+        $bookingDto = $this->createBookingDto();
+        $bookingDto->participants[0]->dateOfBirth = new \DateTimeImmutable('2015-01-01');
+
+        $this->handler->processField(['email' => ''], $bookingDto, 0);
+
+        $this->assertNull($bookingDto->participants[0]->email);
+    }
+
+    public function testChildAtIndexZeroInheritsWhenTheApplicantDoesNotTravel(): void
+    {
+        $bookingDto = $this->createBookingDto();
+        $bookingDto->applicantTravels = false;
+        $bookingDto->applicant = $this->createParticipant('[email protected]', '1981-03-16');
+        $bookingDto->participants[0]->dateOfBirth = new \DateTimeImmutable('2015-01-01');
+
+        $this->handler->processField(['email' => ''], $bookingDto, 0);
+
+        $this->assertSame('[email protected]', $bookingDto->participants[0]->email);
+    }
+
+    public function testHandlerRunsAfterDateOfBirth(): void
+    {
+        $this->assertSame(
+            ['dateOfBirth'],
+            $this->handler->getDependencies(),
+            'Whether someone counts as a child is only known once their DOB is processed'
+        );
+    }
+
+    /**
+     * The handler runs in PRE_SUBMIT and writes to the DTO, but the form then binds the submitted
+     * data over it. Only fields the registry syncs back survive, so the pre-filled address has to
+     * reappear in the returned data - otherwise the blank wins and the field renders empty.
+     */
+    public function testPreFilledEmailIsSyncedBackIntoTheSubmittedData(): void
+    {
+        $bookingDto = $this->createBookingDto();
+        $registry = new ParticipantFieldHandlerRegistry([
+            new ParticipantDateOfBirthFieldHandler(new NullLogger()),
+            new ParticipantEmailFieldHandler(),
+        ]);
+
+        $synced = $registry->processFieldsForParticipantAndSync(['email' => ''], $bookingDto, 1);
+
+        $this->assertSame('[email protected]', $bookingDto->participants[1]->email);
+        $this->assertSame(
+            '[email protected]',
+            $synced['email'],
+            'Without the sync the form binds the blank back over the pre-filled address'
+        );
+    }
+
+    private function createBookingDto(): BookingDto
+    {
+        $bookingDto = new BookingDto(new Travel(), 1);
+        $bookingDto->participants = [
+            $this->createParticipant('[email protected]', '1980-01-01'),
+            $this->createParticipant('', '2015-01-01'),
+        ];
+        $bookingDto->participants[0]->index = 0;
+        $bookingDto->participants[1]->index = 1;
+        $bookingDto->participants[1]->email = null;
+
+        return $bookingDto;
+    }
+
+    private function createParticipant(string $email, string $dateOfBirth): ParticipantDto
+    {
+        $participant = new ParticipantDto();
+        $participant->email = '' !== $email ? $email : null;
+        $participant->dateOfBirth = new \DateTimeImmutable($dateOfBirth);
+
+        return $participant;
+    }
+}