update project

app/Http/Requests/Attendance/AttendanceSessionRequest.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+final class AttendanceSessionRequest extends FormRequest
+{
+    public function authorize(): bool { return true; }
+
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string'],
+            'session_type' => ['required', 'string'],
+            'starts_at' => ['required', 'date'],
+            'ends_at' => ['required', 'date', 'after:starts_at'],
+            'timezone' => ['nullable', 'timezone'],
+            'metadata' => ['nullable', 'array'],
+        ];
+    }
+}

app/Http/Requests/Attendance/AttendanceSummaryRequest.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+use App\Domain\SchoolCore\Attendance\DTO\AttendanceSummaryQuery;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class AttendanceSummaryRequest extends FormRequest
+{
+    public function authorize(): bool { return true; }
+
+    public function rules(): array
+    {
+        return [
+            'from_date' => ['nullable', 'date'],
+            'to_date' => ['nullable', 'date'],
+            'session_id' => ['nullable', 'integer'],
+            'subject_type' => ['nullable', 'string'],
+        ];
+    }
+
+    public function toDTO(): AttendanceSummaryQuery
+    {
+        $validated = $this->validated();
+        return new AttendanceSummaryQuery(
+            fromDate: $validated['from_date'] ?? null,
+            toDate: $validated['to_date'] ?? null,
+            sessionId: isset($validated['session_id']) ? (int) $validated['session_id'] : null,
+            subjectType: $validated['subject_type'] ?? null,
+        );
+    }
+}

app/Http/Requests/Attendance/ManualStaffAttendanceOverrideRequest.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+final class ManualStaffAttendanceOverrideRequest extends RecordStaffAttendanceRequest
+{
+    public function rules(): array
+    {
+        return parent::rules() + [
+            'override_reason' => ['required', 'string', 'min:3'],
+        ];
+    }
+}

app/Http/Requests/Attendance/ManualStudentAttendanceOverrideRequest.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+final class ManualStudentAttendanceOverrideRequest extends RecordStudentAttendanceRequest
+{
+    public function rules(): array
+    {
+        return parent::rules() + [
+            'override_reason' => ['required', 'string', 'min:3'],
+        ];
+    }
+}

app/Http/Requests/Attendance/ProcessScanRequest.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+use App\Domain\SchoolCore\Attendance\DTO\ProcessScanData;
+use DateTimeImmutable;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class ProcessScanRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'badge_value' => ['required', 'string', 'max:191'],
+            'station_id' => ['nullable', 'string', 'max:191'],
+            'scan_action' => ['nullable', 'string', 'in:check_in,check_out,lookup'],
+            'scan_source' => ['nullable', 'string', 'in:scanner,manual,api'],
+            'scanned_at' => ['nullable', 'date'],
+            'device_id' => ['nullable', 'string', 'max:191'],
+            'client_request_id' => ['nullable', 'string', 'max:191'],
+            'idempotency_key' => ['nullable', 'string', 'max:191'],
+            'metadata' => ['nullable', 'array'],
+        ];
+    }
+
+    public function toDTO(): ProcessScanData
+    {
+        $validated = $this->validated();
+
+        return new ProcessScanData(
+            badgeValue: (string) $validated['badge_value'],
+            stationId: $validated['station_id'] ?? null,
+            scanAction: $validated['scan_action'] ?? 'check_in',
+            scanSource: $validated['scan_source'] ?? 'scanner',
+            scannedAt: new DateTimeImmutable($validated['scanned_at'] ?? 'now'),
+            deviceId: $validated['device_id'] ?? null,
+            clientRequestId: $validated['client_request_id'] ?? null,
+            idempotencyKey: $validated['idempotency_key'] ?? null,
+            metadata: $validated['metadata'] ?? [],
+        );
+    }
+}

app/Http/Requests/Attendance/RecordStaffAttendanceRequest.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+use App\Domain\SchoolCore\Attendance\DTO\RecordStaffAttendanceData;
+use DateTimeImmutable;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class RecordStaffAttendanceRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'staff_id' => ['required', 'integer'],
+            'session_id' => ['nullable', 'integer'],
+            'attendance_date' => ['required', 'date'],
+            'status' => ['required', 'string'],
+            'source' => ['nullable', 'string'],
+            'recorded_at' => ['nullable', 'date'],
+            'reason' => ['nullable', 'string'],
+            'notes' => ['nullable', 'string'],
+            'override_reason' => ['nullable', 'string'],
+            'idempotency_key' => ['nullable', 'string'],
+            'metadata' => ['nullable', 'array'],
+        ];
+    }
+
+    public function toDTO(): RecordStaffAttendanceData
+    {
+        $validated = $this->validated();
+
+        return new RecordStaffAttendanceData(
+            staffId: (int) $validated['staff_id'],
+            sessionId: isset($validated['session_id']) ? (int) $validated['session_id'] : null,
+            attendanceDate: (string) $validated['attendance_date'],
+            status: (string) $validated['status'],
+            source: $validated['source'] ?? 'manual',
+            recordedAt: new DateTimeImmutable($validated['recorded_at'] ?? 'now'),
+            reason: $validated['reason'] ?? null,
+            notes: $validated['notes'] ?? null,
+            overrideReason: $validated['override_reason'] ?? null,
+            idempotencyKey: $validated['idempotency_key'] ?? null,
+            metadata: $validated['metadata'] ?? [],
+        );
+    }
+}

app/Http/Requests/Attendance/RecordStudentAttendanceRequest.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Attendance;
+
+use App\Domain\SchoolCore\Attendance\DTO\RecordStudentAttendanceData;
+use DateTimeImmutable;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class RecordStudentAttendanceRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'student_id' => ['required', 'integer'],
+            'session_id' => ['nullable', 'integer'],
+            'attendance_date' => ['required', 'date'],
+            'status' => ['required', 'string'],
+            'source' => ['nullable', 'string'],
+            'recorded_at' => ['nullable', 'date'],
+            'reason' => ['nullable', 'string'],
+            'notes' => ['nullable', 'string'],
+            'override_reason' => ['nullable', 'string'],
+            'idempotency_key' => ['nullable', 'string'],
+            'metadata' => ['nullable', 'array'],
+        ];
+    }
+
+    public function toDTO(): RecordStudentAttendanceData
+    {
+        $validated = $this->validated();
+
+        return new RecordStudentAttendanceData(
+            studentId: (int) $validated['student_id'],
+            sessionId: isset($validated['session_id']) ? (int) $validated['session_id'] : null,
+            attendanceDate: (string) $validated['attendance_date'],
+            status: (string) $validated['status'],
+            source: $validated['source'] ?? 'manual',
+            recordedAt: new DateTimeImmutable($validated['recorded_at'] ?? 'now'),
+            reason: $validated['reason'] ?? null,
+            notes: $validated['notes'] ?? null,
+            overrideReason: $validated['override_reason'] ?? null,
+            idempotencyKey: $validated['idempotency_key'] ?? null,
+            metadata: $validated['metadata'] ?? [],
+        );
+    }
+}