Stabilize modular school API scaffold

app/Domain/SchoolCore/Attendance/Contracts/AttendanceSessionResolverContract.php

@@ -11,5 +11,9 @@ use DateTimeInterface;
 
 interface AttendanceSessionResolverContract
 {
-    public function resolveForScan(SchoolContext $context, AttendanceSubjectView $subject, DateTimeInterface $timestamp): AttendanceSessionView;
-}
+    public function resolveForScan(
+        SchoolContext $context,
+        AttendanceSubjectView $subject,
+        DateTimeInterface $timestamp
+    ): AttendanceSessionView;
+}

app/Domain/SchoolCore/Attendance/Contracts/AttendanceStatusPolicyContract.php

@@ -11,5 +11,9 @@ use DateTimeInterface;
 
 interface AttendanceStatusPolicyContract
 {
-    public function statusForScan(SchoolContext $context, AttendanceSessionView $session, DateTimeInterface $timestamp): AttendanceStatusResult;
-}
+    public function statusForScan(
+        SchoolContext $context,
+        AttendanceSessionView $session,
+        DateTimeInterface $timestamp
+    ): AttendanceStatusResult;
+}

app/Domain/SchoolCore/Attendance/Contracts/BadgeLookupServiceContract.php

@@ -11,4 +11,4 @@ use App\Domain\SchoolCore\Attendance\DTO\BadgeLookupResult;
 interface BadgeLookupServiceContract
 {
     public function lookup(SchoolContext $context, BadgeLookupData $data): BadgeLookupResult;
-}
+}

app/Domain/SchoolCore/Attendance/Services/AttendanceSessionResolver.php

@@ -7,34 +7,17 @@ namespace App\Domain\SchoolCore\Attendance\Services;
 use App\Domain\SchoolCore\Attendance\Contracts\AttendanceSessionResolverContract;
 use App\Domain\SchoolCore\Attendance\DTO\AttendanceSubjectView;
 use App\Domain\SchoolCore\Attendance\DTO\AttendanceSessionView;
-use App\Domain\SchoolCore\Attendance\Exceptions\AttendanceSessionNotFoundException;
-use App\Domain\SchoolCore\Attendance\Repositories\AttendanceSessionRepository;
 use App\Domain\SchoolCore\Context\SchoolContext;
-use DateTimeImmutable;
 use DateTimeInterface;
+use RuntimeException;
 
 final class AttendanceSessionResolver implements AttendanceSessionResolverContract
 {
-    public function __construct(private AttendanceSessionRepository $sessions) {}
-
-    public function resolveForScan(SchoolContext $context, AttendanceSubjectView $subject, DateTimeInterface $timestamp): AttendanceSessionView
-    {
-        $session = $this->sessions->currentForTimestamp($context, $timestamp);
-
-        if (! $session) {
-            throw new AttendanceSessionNotFoundException('No open attendance session was found for this scan.');
-        }
-
-        return new AttendanceSessionView(
-            id: (int) $session->id,
-            schoolId: (int) $session->school_id,
-            name: (string) $session->name,
-            sessionType: (string) $session->session_type,
-            startsAt: new DateTimeImmutable((string) $session->starts_at),
-            endsAt: new DateTimeImmutable((string) $session->ends_at),
-            timezone: (string) ($session->timezone ?? $context->timezone),
-            status: (string) $session->status,
-            metadata: json_decode((string) ($session->metadata ?? '[]'), true) ?: [],
-        );
+    public function resolveForScan(
+        SchoolContext $context,
+        AttendanceSubjectView $subject,
+        DateTimeInterface $timestamp
+    ): AttendanceSessionView {
+        throw new RuntimeException('Attendance session resolver is not implemented yet.');
     }
-}
+}

app/Domain/SchoolCore/Attendance/Services/AttendanceStatusPolicy.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\SchoolCore\Attendance\Services;
+
+use App\Domain\SchoolCore\Attendance\Contracts\AttendanceStatusPolicyContract;
+use App\Domain\SchoolCore\Attendance\DTO\AttendanceSessionView;
+use App\Domain\SchoolCore\Attendance\DTO\AttendanceStatusResult;
+use App\Domain\SchoolCore\Context\SchoolContext;
+use DateTimeInterface;
+use RuntimeException;
+
+final class AttendanceStatusPolicy implements AttendanceStatusPolicyContract
+{
+    public function statusForScan(
+        SchoolContext $context,
+        AttendanceSessionView $session,
+        DateTimeInterface $timestamp
+    ): AttendanceStatusResult {
+        throw new RuntimeException('Attendance status policy is not implemented yet.');
+    }
+}

app/Domain/SchoolCore/Communication/Exceptions/CommunicationException.php

@@ -1,3 +1,3 @@
 <?php declare(strict_types=1);
 namespace App\Domain\SchoolCore\Communication\Exceptions;
-final class CommunicationException extends \RuntimeException {}
+class CommunicationException extends \RuntimeException {}