From b5a264d92f9c57d88b58c62c87f71cf32221e453 Mon Sep 17 00:00:00 2001
From: KKlochko <KKlochko@protonmail.com>
Date: Wed, 14 Jun 2023 16:58:35 +0300
Subject: [PATCH] Added Category model, resource and its API.

Updated Company model to have Categories.
---
 .../Controllers/API/v2/CategoryController.php | 71 +++++++++++++++++++
 app/Http/Requests/StoreCategoryRequest.php    | 28 ++++++++
 app/Http/Requests/UpdateCategoryRequest.php   | 28 ++++++++
 .../Resources/API/v2/CategoryCollection.php   | 19 +++++
 .../Resources/API/v2/CategoryResource.php     | 24 +++++++
 app/Models/Category.php                       | 23 ++++++
 app/Models/Company.php                        |  6 ++
 app/Policies/CategoryPolicy.php               | 66 +++++++++++++++++
 database/factories/CategoryFactory.php        | 23 ++++++
 ...3_06_14_133652_create_categories_table.php | 35 +++++++++
 database/seeders/CategorySeeder.php           | 17 +++++
 routes/api.php                                |  1 +
 12 files changed, 341 insertions(+)
 create mode 100644 app/Http/Controllers/API/v2/CategoryController.php
 create mode 100644 app/Http/Requests/StoreCategoryRequest.php
 create mode 100644 app/Http/Requests/UpdateCategoryRequest.php
 create mode 100644 app/Http/Resources/API/v2/CategoryCollection.php
 create mode 100644 app/Http/Resources/API/v2/CategoryResource.php
 create mode 100644 app/Models/Category.php
 create mode 100644 app/Policies/CategoryPolicy.php
 create mode 100644 database/factories/CategoryFactory.php
 create mode 100644 database/migrations/2023_06_14_133652_create_categories_table.php
 create mode 100644 database/seeders/CategorySeeder.php

diff --git a/app/Http/Controllers/API/v2/CategoryController.php b/app/Http/Controllers/API/v2/CategoryController.php
new file mode 100644
index 0000000..f8867b2
--- /dev/null
+++ b/app/Http/Controllers/API/v2/CategoryController.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Http\Controllers\API\v2;
+
+use App\Http\Requests\StoreCategoryRequest;
+use App\Http\Requests\UpdateCategoryRequest;
+use App\Models\Category;
+use Illuminate\Http\Request;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\API\v2\CategoryResource;
+use App\Http\Resources\API\v2\CategoryCollection;
+
+class CategoryController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        return new CategoryCollection(Category::all());
+    }
+
+    /**
+     * Show the form for creating a new resource.
+     */
+    public function create()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(StoreCategoryRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(Category $category)
+    {
+        return new CategoryResource($category);
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     */
+    public function edit(Category $category)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(UpdateCategoryRequest $request, Category $category)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(Category $category)
+    {
+        //
+    }
+}
diff --git a/app/Http/Requests/StoreCategoryRequest.php b/app/Http/Requests/StoreCategoryRequest.php
new file mode 100644
index 0000000..0bd6f68
--- /dev/null
+++ b/app/Http/Requests/StoreCategoryRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreCategoryRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/UpdateCategoryRequest.php b/app/Http/Requests/UpdateCategoryRequest.php
new file mode 100644
index 0000000..836eb1e
--- /dev/null
+++ b/app/Http/Requests/UpdateCategoryRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateCategoryRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Resources/API/v2/CategoryCollection.php b/app/Http/Resources/API/v2/CategoryCollection.php
new file mode 100644
index 0000000..a6083b2
--- /dev/null
+++ b/app/Http/Resources/API/v2/CategoryCollection.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources\API\v2;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class CategoryCollection extends ResourceCollection
+{
+    /**
+     * Transform the resource collection into an array.
+     *
+     * @return array<int|string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}
diff --git a/app/Http/Resources/API/v2/CategoryResource.php b/app/Http/Resources/API/v2/CategoryResource.php
new file mode 100644
index 0000000..0681979
--- /dev/null
+++ b/app/Http/Resources/API/v2/CategoryResource.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Resources\API\v2;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CategoryResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'uuid' => $this->uuid,
+            'name' => $this->name,
+            'url' => $this->url,
+        ];
+    }
+}
diff --git a/app/Models/Category.php b/app/Models/Category.php
new file mode 100644
index 0000000..b5b1b1d
--- /dev/null
+++ b/app/Models/Category.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Category extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'uuid',
+        'name',
+        'url',
+    ];
+
+    public function company(): BelongsTo
+    {
+        return $this->belongsTo(Company::class);
+    }
+}
diff --git a/app/Models/Company.php b/app/Models/Company.php
index 3e2f1a1..101aa67 100644
--- a/app/Models/Company.php
+++ b/app/Models/Company.php
@@ -4,6 +4,7 @@ namespace App\Models;
 
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Company extends Model
 {
@@ -15,4 +16,9 @@ class Company extends Model
         'image',
         'description',
     ];
+
+    public function categories(): HasMany
+    {
+        return $this->hasMany(Category::class);
+    }
 }
diff --git a/app/Policies/CategoryPolicy.php b/app/Policies/CategoryPolicy.php
new file mode 100644
index 0000000..b7782e8
--- /dev/null
+++ b/app/Policies/CategoryPolicy.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Category;
+use App\Models\User;
+use Illuminate\Auth\Access\Response;
+
+class CategoryPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, Category $category): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, Category $category): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, Category $category): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, Category $category): bool
+    {
+        //
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, Category $category): bool
+    {
+        //
+    }
+}
diff --git a/database/factories/CategoryFactory.php b/database/factories/CategoryFactory.php
new file mode 100644
index 0000000..43be7f4
--- /dev/null
+++ b/database/factories/CategoryFactory.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Category>
+ */
+class CategoryFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/database/migrations/2023_06_14_133652_create_categories_table.php b/database/migrations/2023_06_14_133652_create_categories_table.php
new file mode 100644
index 0000000..fc7061d
--- /dev/null
+++ b/database/migrations/2023_06_14_133652_create_categories_table.php
@@ -0,0 +1,35 @@
+<?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('categories', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBiginteger('company_id')->unsigned();
+            $table->string('uuid');
+            $table->string('name');
+            $table->string('url');
+
+            $table->foreign('company_id')->references('id')
+                 ->on('companies')->onDelete('cascade');
+
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('categories');
+    }
+};
diff --git a/database/seeders/CategorySeeder.php b/database/seeders/CategorySeeder.php
new file mode 100644
index 0000000..bc3c0e2
--- /dev/null
+++ b/database/seeders/CategorySeeder.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class CategorySeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        //
+    }
+}
diff --git a/routes/api.php b/routes/api.php
index 2ed36cb..6b24bb1 100644
--- a/routes/api.php
+++ b/routes/api.php
@@ -26,6 +26,7 @@ Route::group([
     function(){
         Route::apiResource('cities', CityController::class);
         Route::apiResource('companies', CompanyController::class);
+        Route::apiResource('categories', CategoryController::class);
     }
 );