test dated assignment listing

backend/tests/Unit/Schedule/UseCases/ListAssignmentsForDateTest.php

@@ -0,0 +1,143 @@
+<?php
+
+namespace Tests\Unit\Schedule\UseCases;
+
+use App\Exceptions\BadRequestException;
+use App\Schedule\CreateScheduleAssignmentDto;
+use App\Schedule\CreateScheduleDto;
+use App\Schedule\ScheduleAssignment;
+use App\Schedule\UseCases\ListAssignmentsForDate\ListAssignmentsForDate;
+use App\Schedule\UseCases\ListAssignmentsForDate\ListAssignmentsForDateRequest;
+use App\Shared\ValueObject\EmailAddress;
+use App\User\User;
+use DateTimeImmutable;
+use DateTimeZone;
+use PHPUnit\Framework\TestCase;
+use Tests\Fakes\FakeScheduleRepository;
+
+class ListAssignmentsForDateTest extends TestCase
+{
+    public function test_it_lists_the_users_assignments_for_the_date(): void
+    {
+        $user = $this->user(1, 'reader@example.com');
+        $otherUser = $this->user(2, 'other@example.com');
+        $repository = new FakeScheduleRepository;
+        $repository->create($this->schedule(
+            user: $user,
+            setName: 'Older plan',
+            date: '2026-08-15',
+            assignmentNames: ['First', 'Second'],
+        ));
+        $repository->create($this->schedule(
+            user: $user,
+            setName: 'Newer plan',
+            date: '2026-08-15',
+            assignmentNames: ['Third'],
+        ));
+        $repository->create($this->schedule(
+            user: $otherUser,
+            setName: 'Private plan',
+            date: '2026-08-15',
+            assignmentNames: ['Hidden'],
+        ));
+        $repository->create($this->schedule(
+            user: $user,
+            setName: 'Tomorrow plan',
+            date: '2026-08-16',
+            assignmentNames: ['Later'],
+        ));
+
+        $assignments = (new ListAssignmentsForDate($repository))->execute(
+            new ListAssignmentsForDateRequest(
+                user: $user,
+                date: '2026-08-15',
+            ),
+        );
+
+        $this->assertSame(
+            ['Newer plan', 'Older plan', 'Older plan'],
+            array_map(function ($assignment): string {
+                return $assignment->getSetName();
+            }, $assignments),
+        );
+        $this->assertSame(
+            ['Third', 'First', 'Second'],
+            array_map(function ($assignment): string {
+                return $assignment->getAssignment()->getName();
+            }, $assignments),
+        );
+        $this->assertSame(2, $assignments[0]->getScheduleId());
+    }
+
+    public function test_it_rejects_a_missing_date(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('date is required');
+
+        (new ListAssignmentsForDate(new FakeScheduleRepository))->execute(
+            new ListAssignmentsForDateRequest(
+                user: $this->user(1, 'reader@example.com'),
+                date: null,
+            ),
+        );
+    }
+
+    public function test_it_rejects_an_invalid_date(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage(
+            'date must be a valid date in YYYY-MM-DD format',
+        );
+
+        (new ListAssignmentsForDate(new FakeScheduleRepository))->execute(
+            new ListAssignmentsForDateRequest(
+                user: $this->user(1, 'reader@example.com'),
+                date: '2026-02-30',
+            ),
+        );
+    }
+
+    private function user(int $id, string $email): User
+    {
+        return new User(
+            id: $id,
+            email: new EmailAddress($email),
+            passwordHash: 'hashed-password',
+        );
+    }
+
+    /**
+     * @param list<string> $assignmentNames
+     */
+    private function schedule(
+        User $user,
+        string $setName,
+        string $date,
+        array $assignmentNames,
+    ): CreateScheduleDto {
+        $scheduledDate = new DateTimeImmutable(
+            $date,
+            new DateTimeZone('UTC'),
+        );
+        $assignments = [];
+
+        foreach ($assignmentNames as $index => $name) {
+            $assignments[] = new CreateScheduleAssignmentDto(
+                name: $name,
+                kind: 'lesson',
+                path: [$setName, $name],
+                scheduledDate: $scheduledDate,
+                position: $index + 1,
+            );
+        }
+
+        return new CreateScheduleDto(
+            user: $user,
+            setName: $setName,
+            elementKind: 'lesson',
+            startDate: $scheduledDate,
+            targetDate: $scheduledDate,
+            assignments: $assignments,
+        );
+    }
+}