feat: implement filtering and sorting on CourseController

- add locations GET endpoint to give possible cities
- install laravel-query-builder
- add filtering and sorting to GET Course endpoint

Author: Finnick223

app/Http/Controllers/CourseController.php

@@ -9,18 +9,25 @@
 use App\Models\Course;
 use App\Services\CourseService;
 use Illuminate\Http\Response;
+use Spatie\QueryBuilder\AllowedFilter;
+use Spatie\QueryBuilder\QueryBuilder;
 
 class CourseController extends Controller
 {
     public function __construct(protected CourseService $courseService) {}
 
     public function index(): CourseCollection
     {
-        return new CourseCollection(
-            Course::query()
-                ->with(['school', 'category'])
-                ->paginate()
-        );
+        $courses = QueryBuilder::for(Course::class)
+            ->allowedFilters(AllowedFilter::partial('school.name'),
+                AllowedFilter::exact('school.city'),
+                AllowedFilter::exact('category.name')
+            )
+            ->allowedSorts(['price', 'start_date'])
+            ->with(['school', 'category'])
+            ->paginate(10);
+
+        return new CourseCollection($courses);
     }
 
     public function store(StoreCourseRequest $request): CourseResource
@@ -44,4 +51,14 @@ public function destroy(Course $course): Response
 
         return response()->noContent();
     }
+
+    public function locations()
+    {
+        $cities = Course::query()
+            ->join('schools', 'courses.school_id', '=', 'schools.id')
+            ->distinct()
+            ->pluck('schools.city');
+
+            return response()->json($cities);
+    }
 }

composer.json

@@ -10,7 +10,8 @@
         "laravel/framework": "^11.9",
         "laravel/sanctum": "^4.0",
         "laravel/socialite": "^5.16",
-        "laravel/tinker": "^2.9"
+        "laravel/tinker": "^2.9",
+        "spatie/laravel-query-builder": "^6.3"
     },
     "require-dev": {
         "fakerphp/faker": "^1.23",

composer.lock

@@ -26,6 +26,7 @@
 })->middleware('auth:sanctum');
 
 Route::apiResource('/courses', CourseController::class)->except('update');
+Route::get('/courses-locations', [CourseController::class, 'locations']);
 
 Route::post('login', [AuthController::class, 'login']);
 Route::post('register', [AuthController::class, 'register']);