taktik - laravel

app/Http/Controllers/CategoryController.php

@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\Category\DestroyCategoryRequest;
+use App\Http\Requests\Category\ListCategoryRequest;
+use App\Http\Requests\Category\ShowCategoryRequest;
+use App\Http\Requests\Category\StoreCategoryRequest;
+use App\Http\Requests\Category\UpdateCategoryRequest;
+use App\Http\Resources\CategoryCollection;
+use App\Http\Resources\CategoryResource;
+use App\Http\Resources\PaginableResource;
+use App\Services\Category\CategoryServiceInterface;
+use Illuminate\Http\JsonResponse;
+use OpenApi\Annotations as OA;
+
+final class CategoryController
+{
+    public function __construct(
+        private readonly CategoryServiceInterface $categoryService,
+    )
+    {
+    }
+
+    public function list(ListCategoryRequest $request, int $page): JsonResponse
+    {
+        $categories = $this->categoryService->fetchCategories(
+            $page,
+            $request->filters(),
+            $request->order()
+        );
+        return response()->json(PaginableResource::make($categories, CategoryCollection::class));
+    }
+
+    /**
+     * @OA\Post(
+     *     path="/api/v1/categories",
+     *     operationId="storeCategory",
+     *     tags={"Categories"},
+     *     summary="Create a new category",
+     *     description="Creates a new category and returns the created category data.",
+     *     @OA\RequestBody(
+     *         required=true,
+     *         @OA\JsonContent(
+     *             type="object",
+     *             required={"name"},
+     *             @OA\Property(property="name", type="string", example="Technology", description="The name of the category")
+     *         )
+     *     ),
+     *     @OA\Response(
+     *         response=201,
+     *         description="Category successfully created",
+     *         @OA\JsonContent(
+     *             type="object",
+     *                 ref="#/components/schemas/CategoryResource"
+     *             )
+     *         )
+     *     ),
+     * @OA\Response(
+     *         response=422,
+     *         description="Validation error",
+     *         @OA\JsonContent(ref="#/components/schemas/ValidationError")
+     *     )
+     * )
+     */
+    public function store(StoreCategoryRequest $request): JsonResponse
+    {
+        return response()->json(CategoryResource::make($this->categoryService->storeCategory($request->all())), 201);
+    }
+
+    public function show(ShowCategoryRequest $request, int $id): JsonResponse
+    {
+        $post = $this->categoryService->findCategory($id);
+
+        if ($post === null) {
+            return response()->json(null, 404);
+        }
+
+        return response()->json(CategoryResource::make($post));
+    }
+
+    public function update(UpdateCategoryRequest $request, int $id): JsonResponse
+    {
+        $post = $this->categoryService->updateCategory($request->all(), $id);
+
+        if ($post === null) {
+            return response()->json(null, 404);
+        }
+
+        return response()->json(CategoryResource::make($post));
+    }
+
+    public function destroy(DestroyCategoryRequest $post, int $id): JsonResponse
+    {
+        $isSuccessfullyDeleted = $this->categoryService->deleteCategory($id);
+        return match ($isSuccessfullyDeleted) {
+            false => response()->json(null, 404),
+            true => response()->json(null, 204),
+        };
+    }
+}