feat: create instructor availability management

Implement backend logic for getting and storing instructor availability. Each new submission replaces old availability to align with frontend design, where users set availability for the current and next week in bulk. Separate POST and UPDATE endpoints seems unnecessary.

Author: Finnick223

app/Http/Controllers/InstructorAvailabilityController.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreInstructorAvailabilityRequest;
+use App\Http\Resources\InstructorAvailabilityCollection;
+use App\Http\Resources\InstructorStoreAvailabilityResource;
+use App\Models\InstructorAvailability;
+use App\Services\InstructorAvailabilityService;
+use Exception;
+use Illuminate\Http\Request;
+
+class InstructorAvailabilityController extends Controller
+{
+    public function __construct(protected InstructorAvailabilityService $availabilityService) {}
+
+    public function index(Request $request): InstructorAvailabilityCollection
+    {
+        $instructorId = $request->user()->id;
+        $availabilities = InstructorAvailability::where('instructor_id', $instructorId)->get();
+
+        return new InstructorAvailabilityCollection($availabilities);
+    }
+
+    /**
+     * @throws Exception
+     */
+    public function store(StoreInstructorAvailabilityRequest $request): InstructorStoreAvailabilityResource
+    {
+        $validated = $request->validated();
+        $instructor = $request->user();
+
+        return new InstructorStoreAvailabilityResource($this->availabilityService->storeAvailability(
+            $instructor,
+            $validated['availability']
+        ));
+    }
+
+}

app/Http/Requests/StoreInstructorAvailabilityRequest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreInstructorAvailabilityRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'availability' => 'required|array|min:1', //min 1 time slot
+            'availability.*.start_time' => 'required|date|after:now',
+            'availability.*.end_time' => 'required|date|after:availability.*.start_time',
+        ];
+    }
+}

app/Http/Resources/InstructorAvailabilityCollection.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class InstructorAvailabilityCollection extends ResourceCollection
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'currentWeek' => InstructorAvailabilityResource::collection(
+                $this->collection->filter(fn ($item) => $item->start_time->isCurrentWeek())
+            ),
+            'nextWeek' => InstructorAvailabilityResource::collection(
+                $this->collection->filter(fn ($item) => $item->start_time->isNextWeek())
+            ),
+        ];
+    }
+}

app/Http/Resources/InstructorAvailabilityResource.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class InstructorAvailabilityResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'start_time' => $this->start_time->toIso8601String(),
+            'end_time' => $this->end_time->toIso8601String(),
+        ];
+    }
+
+}

app/Http/Resources/InstructorStoreAvailabilityResource.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class InstructorStoreAvailabilityResource extends JsonResource
+{
+    public function toArray($request): array
+    {
+        return [
+            'message' => 'Availability processed.',
+            'saved' => $this->resource['saved'],
+        ];
+    }
+}

app/Models/InstructorAvailability.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class InstructorAvailability extends Model
+{
+    protected $fillable = ['start_time', 'end_time', 'instructor_id'];
+
+    protected $casts = [
+        'start_time' => 'datetime',
+        'end_time' => 'datetime',
+    ];
+
+
+    public function instructor(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'instructor_id');
+    }
+}

app/Services/InstructorAvailabilityService.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\InstructorAvailability;
+use App\Models\User;
+use Exception;
+use Illuminate\Support\Facades\DB;
+
+class InstructorAvailabilityService
+{
+    /**
+     * @throws Exception
+     */
+    public function storeAvailability(User $instructor, array $availabilities): array
+    {
+        $savedSlots = [];
+
+        DB::beginTransaction();
+
+        try {
+            InstructorAvailability::where('instructor_id', $instructor->id)->delete(); //delete old availability
+            foreach ($availabilities as $slot) {
+                $start = $slot['start_time'];
+                $end = $slot['end_time'];
+
+                $savedSlots[] = InstructorAvailability::create([
+                    'instructor_id' => $instructor->id,
+                    'start_time' => $start,
+                    'end_time' => $end,
+                ]);
+            }
+
+            DB::commit();
+
+            return [
+                'message' => 'Availability processed.',
+                'saved' => $savedSlots,
+            ];
+
+        } catch (Exception $e) {
+            DB::rollBack();
+            throw $e;
+        }
+    }
+}

database/migrations/2025_03_28_151602_create_instructor_availability_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('instructor_availabilities', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('instructor_id')->constrained('users')->onDelete('cascade');
+            $table->dateTime('start_time');
+            $table->dateTime('end_time');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('instructor_availabilities');
+    }
+};

routes/api/instructor.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Enums\RolesEnum;
+use App\Http\Controllers\InstructorAvailabilityController;
 use App\Http\Controllers\InstructorDriverController;
 use App\Http\Controllers\InstructorEventController;
 use Illuminate\Support\Facades\Route;
@@ -10,5 +11,6 @@
     //define instructor routes
     Route::apiResource('events', InstructorEventController::class);
     Route::apiResource('drivers', InstructorDriverController::class)->only(['index']);
+    Route::apiResource('availability', InstructorAvailabilityController::class)->only(['index', 'store']);
 
 });