feat: create driver availability management

- Implement backend logic for getting instructor availability as driver and create pending events based on this availability.
- Add status enum
- migration with status column

Author: Finnick223

app/Enums/StatusEnum.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Enums;
+
+enum StatusEnum: string
+{
+    case AVAILABLE = 'available';
+    case BOOKED = 'booked';
+
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+}

app/Http/Controllers/DriverAvailabilityController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Resources\InstructorAvailabilityCollection;
+use App\Services\InstructorAvailabilityService;
+use Illuminate\Http\Request;
+
+class DriverAvailabilityController extends Controller
+{
+    public function __construct(protected InstructorAvailabilityService $availabilityService)
+    {
+    }
+
+    public function index(Request $request)
+    {
+        $driver = $request->user();
+        $instructorId = $driver->instructor_id;
+
+        return new InstructorAvailabilityCollection($this->availabilityService->getInstructorAvailabilities($instructorId));
+    }
+
+}

app/Http/Controllers/DriverEventController.php

@@ -2,19 +2,35 @@
 
 namespace App\Http\Controllers;
 
+use App\Http\Requests\StoreDriverEventRequest;
 use App\Http\Resources\DriverEventResource;
+use App\Services\DriverEventService;
 use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 use Illuminate\Http\Request;
 
 class DriverEventController extends Controller
 {
     use AuthorizesRequests;
 
+    public function __construct(protected DriverEventService $driverEventService)
+    {
+    }
+
+
     public function index(Request $request)
     {
         $driver = $request->user();
         $events = $driver->events;
 
         return DriverEventResource::collection($events);
     }
+
+    public function store(StoreDriverEventRequest $request)
+    {
+        $driver = $request->user();
+        $eventData = $request->validated();
+
+        return new DriverEventResource($this->driverEventService->createEvent($driver, $eventData));
+    }
+
 }

app/Http/Controllers/InstructorAvailabilityController.php

@@ -12,7 +12,9 @@
 
 class InstructorAvailabilityController extends Controller
 {
-    public function __construct(protected InstructorAvailabilityService $availabilityService) {}
+    public function __construct(protected InstructorAvailabilityService $availabilityService)
+    {
+    }
 
     public function index(Request $request): InstructorAvailabilityCollection
     {
@@ -28,10 +30,8 @@ public function index(Request $request): InstructorAvailabilityCollection
     public function store(StoreInstructorAvailabilityRequest $request): InstructorStoreAvailabilityResource
     {
         $validated = $request->validated();
-        $instructor = $request->user();
 
         return new InstructorStoreAvailabilityResource($this->availabilityService->storeAvailability(
-            $instructor,
             $validated['availability']
         ));
     }

app/Http/Requests/StoreDriverEventRequest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Rules\AvailableTimeSlot;
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreDriverEventRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        $instructorId = $this->user()->instructor_id;
+
+        return [
+            'start' => ['required', 'date', 'after_or_equal:now', new AvailableTimeSlot($instructorId)],
+            'end' => 'required|date|after:start',
+            'title' => 'required|string|max:255'
+        ];
+    }
+}
+

app/Models/InstructorAvailability.php

@@ -7,7 +7,7 @@
 
 class InstructorAvailability extends Model
 {
-    protected $fillable = ['start_time', 'end_time', 'instructor_id'];
+    protected $fillable = ['instructor_id', 'start_time', 'end_time', 'status'];
 
     protected $casts = [
         'start_time' => 'datetime',

app/Rules/AvailableTimeSlot.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Rules;
+
+use App\Models\InstructorAvailability;
+use Closure;
+use Illuminate\Contracts\Validation\ValidationRule;
+
+class AvailableTimeSlot implements ValidationRule
+{
+    protected $instructorId;
+
+    // Inject instructorId through the constructor
+    public function __construct($instructorId)
+    {
+        $this->instructorId = $instructorId;
+    }
+
+    /**
+     * Run the validation rule.
+     *
+     * @param string $attribute
+     * @param mixed $value
+     * @param Closure(string): void $fail
+     */
+    public function validate(string $attribute, mixed $value, Closure $fail): void
+    {
+        $endTime = request('end');
+
+        $exists = InstructorAvailability::where('instructor_id', $this->instructorId)
+            ->where('start_time', '<=', $value)
+            ->where('end_time', '>=', $endTime)
+            ->exists();
+
+        if (!$exists) {
+            $fail('The selected time slot is not available.');
+        }
+    }
+}

app/Services/DriverEventService.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Services;
+
+use App\Enums\EventsEnum;
+use App\Enums\StatusEnum;
+use App\Models\Event;
+use App\Models\InstructorAvailability;
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+
+class DriverEventService
+{
+    public function createEvent(User $driver, array $data): Event
+    {
+        return DB::transaction(function () use ($driver, $data) {
+            InstructorAvailability::where('status', StatusEnum::AVAILABLE->value)
+                ->where('instructor_id', $driver->instructor_id)
+                ->where('start_time', '<=', $data['start'])
+                ->where('end_time', '>=', $data['end'])
+                ->lockForUpdate()
+                ->firstOrFail()
+                ->update(['status' => StatusEnum::BOOKED->value]);
+
+            return Event::create([
+                ...$data,
+                'instructor_id' => $driver->instructor_id,
+                'driver_id' => $driver->id,
+                'status' => EventsEnum::PENDING->value,
+            ]);
+        });
+    }
+
+}

app/Services/InstructorAvailabilityService.php

@@ -2,8 +2,8 @@
 
 namespace App\Services;
 
+use App\Enums\StatusEnum;
 use App\Models\InstructorAvailability;
-use App\Models\User;
 use Exception;
 use Illuminate\Support\Facades\DB;
 
@@ -12,35 +12,37 @@ class InstructorAvailabilityService
     /**
      * @throws Exception
      */
-    public function storeAvailability(User $instructor, array $availabilities): array
+    public function storeAvailability(array $availabilities): array
     {
-        $savedSlots = [];
 
-        DB::beginTransaction();
-
-        try {
-            InstructorAvailability::where('instructor_id', $instructor->id)->delete(); //delete old availability
+        return DB::transaction(function () use ($availabilities) {
+            $savedSlots = [];
+            InstructorAvailability::where('instructor_id', auth()->id())->where(StatusEnum::AVAILABLE->value)->delete(); //delete old availability
             foreach ($availabilities as $slot) {
                 $start = $slot['start_time'];
                 $end = $slot['end_time'];
 
                 $savedSlots[] = InstructorAvailability::create([
-                    'instructor_id' => $instructor->id,
+                    'instructor_id' => auth()->id(),
                     'start_time' => $start,
                     'end_time' => $end,
+                    'status' => StatusEnum::AVAILABLE->value
                 ]);
             }
 
-            DB::commit();
-
             return [
                 'message' => 'Availability processed.',
                 'saved' => $savedSlots,
             ];
+        });
+    }
 
-        } catch (Exception $e) {
-            DB::rollBack();
-            throw $e;
-        }
+    public function getInstructorAvailabilities($instructorId)
+    {
+        return InstructorAvailability::where('instructor_id', $instructorId)
+            ->where('status', StatusEnum::AVAILABLE->value)
+            ->where('end_time', '>', now())
+            ->orderBy('start_time')
+            ->get();
     }
 }

database/migrations/2025_04_02_143203_add_status_to_instructor_availabilities.php

@@ -0,0 +1,31 @@
+<?php
+
+use App\Enums\StatusEnum;
+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::table('instructor_availabilities', function (Blueprint $table) {
+            $table->enum('status', [StatusEnum::AVAILABLE->value, StatusEnum::BOOKED->value])
+                ->default(StatusEnum::AVAILABLE->value)
+                ->after('instructor_id')
+                ->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('instructor_availabilities', function (Blueprint $table) {
+            $table->dropColumn('status');
+        });
+    }
+};