Feat/course registrations

app/Enums/RegistrationStatus.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Enums;
+
+enum RegistrationStatus: string
+{
+    case PENDING = 'pending';
+    case ACCEPTED = 'accepted';
+    case REJECTED = 'rejected';
+
+    // get all enum values as an array
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+
+    public static function acceptedAndRejectedValues(): array
+    {
+        return [
+            self::ACCEPTED->value,
+            self::REJECTED->value,
+        ];
+    }
+}

app/Http/Controllers/Admin/AdminStudentController.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\UserCollection;
+use App\Services\Admin\AdminStudentService;
+use Illuminate\Http\Request;
+
+class AdminStudentController extends Controller
+{
+    public function __construct(private readonly AdminStudentService $adminStudentService) {}
+
+    public function index(Request $request): UserCollection
+    {
+        return new UserCollection($this->adminStudentService->index($request)->paginate(self::PER_PAGE));
+    }
+}

app/Http/Controllers/CourseRegistration/AdminCourseRegistrationController.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Http\Controllers\CourseRegistration;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\CourseRegistration\StoreCourseRegistrationRequest;
+use App\Http\Resources\CourseRegistration\CourseRegistrationCollection;
+use App\Http\Resources\CourseRegistration\CourseRegistrationResource;
+use App\Http\Resources\CourseUserResource;
+use App\Models\CourseRegistration;
+use App\Services\CourseRegistrationService;
+
+class AdminCourseRegistrationController extends Controller
+{
+    public function __construct(protected CourseRegistrationService $courseRegistrationService) {}
+
+    public function index(): CourseRegistrationCollection
+    {
+        return new CourseRegistrationCollection($this->courseRegistrationService->index());
+    }
+
+    public function store(StoreCourseRegistrationRequest $request): CourseUserResource
+    {
+        return new CourseUserResource($this->courseRegistrationService->store($request->getRegistration()));
+    }
+
+    public function accept(CourseRegistration $courseRegistration): CourseRegistrationResource
+    {
+        return new CourseRegistrationResource($this->courseRegistrationService->accept($courseRegistration));
+    }
+
+    public function decline(CourseRegistration $courseRegistration): CourseRegistrationResource
+    {
+        return new CourseRegistrationResource($this->courseRegistrationService->decline($courseRegistration));
+    }
+}

app/Http/Controllers/CourseRegistration/GuestCourseRegistrationController.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Controllers\CourseRegistration;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\CourseRegistration\GuestCourseRegistrationRequest;
+use App\Http\Resources\CourseRegistration\CourseRegistrationResource;
+use App\Models\Course;
+use App\Services\GuestCourseRegistrationService;
+
+class GuestCourseRegistrationController extends Controller
+{
+    public function __construct(protected GuestCourseRegistrationService $guestCourseRegistrationService) {}
+
+    public function store(GuestCourseRegistrationRequest $request, Course $course): CourseRegistrationResource
+    {
+        return new CourseRegistrationResource($this->guestCourseRegistrationService->store($request->getGuestCourseRegistration($course)));
+    }
+}

app/Http/Requests/CourseRegistration/GuestCourseRegistrationRequest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Requests\CourseRegistration;
+
+use App\Models\Course;
+use App\ValueObjects\StoreGuestCourseRegistration;
+use Illuminate\Foundation\Http\FormRequest;
+
+class GuestCourseRegistrationRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => 'required|string|min:2|max:30|regex:/^[a-zA-ZÀ-ž\s\'-]+$/',
+            'last_name' => 'required|string|min:2|max:30|regex:/^[a-zA-ZÀ-ž\s\'-]+$/',
+            'email' => 'required|email|unique:users,email',
+            'phone' => 'required|regex:/^\+?\d{9,15}$/',
+        ];
+    }
+
+    public function getGuestCourseRegistration(Course $course): StoreGuestCourseRegistration
+    {
+        return new StoreGuestCourseRegistration(
+            $course->id,
+            $this->get('name'),
+            $this->get('last_name'),
+            $this->get('email'),
+            $this->get('phone'),
+        );
+    }
+}

app/Http/Requests/CourseRegistration/StoreCourseRegistrationRequest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Http\Requests\CourseRegistration;
+
+use App\ValueObjects\CreateCourseRegistration;
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreCourseRegistrationRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'user_id' => 'required|exists:users,id',
+            'course_id' => 'required|exists:courses,id',
+        ];
+    }
+
+    public function getRegistration(): CreateCourseRegistration
+    {
+        return new CreateCourseRegistration(
+            $this->get('user_id'),
+            $this->get('course_id')
+        );
+    }
+}

app/Http/Resources/CourseRegistration/CourseRegistrationCollection.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources\CourseRegistration;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class CourseRegistrationCollection extends ResourceCollection
+{
+    /**
+     * Transform the resource collection into an array.
+     *
+     * @return array<int|string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Http/Resources/CourseRegistration/CourseRegistrationResource.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Resources\CourseRegistration;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CourseRegistrationResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'course_id' => $this->course_id,
+            'name' => $this->name,
+            'last_name' => $this->last_name,
+            'email' => $this->email,
+            'phone' => $this->phone,
+            'status' => $this->status,
+            'created_at' => $this->created_at?->toDateTimeString(),
+            'updated_at' => $this->updated_at?->toDateTimeString(),
+        ];
+    }
+}

app/Http/Resources/CourseUserResource.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CourseUserResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Http/Resources/UserCollection.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class UserCollection extends ResourceCollection
+{
+    public function toArray($request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Models/Course.php

@@ -7,6 +7,8 @@
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 /**
  * @property int $id
@@ -41,4 +43,14 @@ public function category(): BelongsTo
     {
         return $this->belongsTo(Category::class);
     }
+
+    public function users(): BelongsToMany
+    {
+        return $this->belongsToMany(User::class, 'course_user')->withTimestamps();
+    }
+
+    public function registrations(): hasMany
+    {
+        return $this->hasMany(CourseRegistration::class);
+    }
 }

app/Models/CourseRegistration.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Models;
+
+use Database\Factories\CourseRegistrationFactory;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class CourseRegistration extends Model
+{
+    /** @use HasFactory<CourseRegistrationFactory> */
+    use HasFactory;
+
+    protected $fillable = [
+        'course_id',
+        'name',
+        'last_name',
+        'email',
+        'phone',
+        'status',
+    ];
+
+    public function course(): BelongsTo
+    {
+        return $this->belongsTo(Course::class);
+    }
+}

app/Models/User.php

@@ -5,6 +5,7 @@
 // use Illuminate\Contracts\Auth\MustVerifyEmail;
 use Database\Factories\UserFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
@@ -62,4 +63,14 @@ public function creditCard(): HasOne
     {
         return $this->hasOne(CreditCard::class);
     }
+
+    public function courses(): BelongsToMany
+    {
+        return $this->belongsToMany(Course::class, 'course_user')->withTimestamps();
+    }
+
+    public function isRegisteredToCourse($courseId): bool
+    {
+        return $this->courses()->where('course_id', $courseId)->exists();
+    }
 }

app/Services/Admin/AdminStudentService.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Services\Admin;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Http\Request;
+
+class AdminStudentService
+{
+    public function index(Request $request): Builder
+    {
+
+        $user = User::role('driver');
+
+        if ($request->has('search')) {
+            $search = strtolower($request->input('search'));
+            $user->where(function ($q) use ($search) {
+                $q->whereRaw('LOWER(name) LIKE ?', ["%{$search}%"])
+                    ->orWhereRaw('LOWER(last_name) LIKE ?', ["%{$search}%"]);
+            });
+        }
+
+        return $user;
+    }
+}