feat: record category management

Author: chrisvanlier2005

app/Http/Controllers/RecordCategoryController.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\RecordCategories\StoreRecordCategoryRequest;
+use App\Http\Requests\RecordCategories\UpdateRecordCategoryRequest;
+use App\Models\RecordCategory;
+use Illuminate\Contracts\View\View;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+
+final class RecordCategoryController extends Controller
+{
+    use AuthorizesRequests;
+
+    public function index(Request $request): View
+    {
+        /** @var \App\Models\User $user */
+        $user = $request->user();
+
+        $categories = $user
+            ->recordCategories()
+            ->paginate();
+
+        return view('record-categories.index', [
+            'recordCategories' => $categories->withQueryString(),
+        ]);
+    }
+
+    /**
+     * @throws \Illuminate\Auth\Access\AuthorizationException
+     */
+    public function create(): View
+    {
+        $this->authorize('create', RecordCategory::class);
+
+        return view('record-categories.create');
+    }
+
+    public function store(StoreRecordCategoryRequest $request): RedirectResponse
+    {
+        $category = new RecordCategory();
+        $category->user()->associate($request->user());
+        $category->name = $request->validated('name');
+        $category->save();
+
+        return redirect()->route('record-categories.edit', $category);
+    }
+
+    /**
+     * @throws \Illuminate\Auth\Access\AuthorizationException
+     */
+    public function edit(RecordCategory $recordCategory): View
+    {
+        $this->authorize('update', $recordCategory);
+
+        return view('record-categories.edit', [
+            'recordCategory' => $recordCategory,
+        ]);
+    }
+
+    public function update(UpdateRecordCategoryRequest $request, RecordCategory $recordCategory): RedirectResponse
+    {
+        $recordCategory->name = $request->validated('name');
+        $recordCategory->save();
+
+        return redirect()->route('record-categories.index');
+    }
+
+
+    /**
+     * @throws \Illuminate\Auth\Access\AuthorizationException
+     */
+    public function destroy(Request $request, RecordCategory $recordCategory): RedirectResponse
+    {
+        $this->authorize('delete', $recordCategory);
+
+        $recordCategory->delete();
+
+        return redirect()->route('record-categories.index');
+    }
+}

app/Http/Controllers/RecordController.php

@@ -11,7 +11,6 @@
 use Illuminate\Contracts\View\View;
 use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 use Illuminate\Http\RedirectResponse;
-use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
 
 final class RecordController extends Controller
@@ -20,16 +19,18 @@ final class RecordController extends Controller
 
     public function index(IndexRecordRequest $request): View
     {
+        /** @var \App\Models\User $user */
         $user = $request->user();
 
+        /** @var \Illuminate\Pagination\LengthAwarePaginator<int, \App\Models\Record> $records */
         $records = $user->records()
             ->with('recordImages')
             ->tap(new ApplyRecordFilters($request->filters()))
             ->latest()
-            ->paginate();
+            ->paginate(9);
 
         return view('records.index', [
-            'records' => $records,
+            'records' => $records->withQueryString(),
         ]);
     }
 

app/Http/Requests/RecordCategories/StoreRecordCategoryRequest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Requests\RecordCategories;
+
+use App\Models\RecordCategory;
+use Illuminate\Foundation\Http\FormRequest;
+
+final class StoreRecordCategoryRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return $this->user()->can('create', RecordCategory::class);
+    }
+
+    public function rules(): array
+    {
+        return [
+            'name' => [
+                'required',
+                'string',
+                'max:255',
+            ],
+        ];
+    }
+}

app/Http/Requests/RecordCategories/UpdateRecordCategoryRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests\RecordCategories;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+final class UpdateRecordCategoryRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        $category = $this->route('record_category');
+
+        return $this->user()->can('update', $category);
+    }
+
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:255'],
+        ];
+    }
+}

app/Models/RecordCategory.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property-read int $id
+ * @property int $user_id
+ * @property string $name
+ * @property \Carbon\Carbon $created_at
+ * @property \Carbon\Carbon $updated_at
+ * @property-read \App\Models\User $user
+ */
+final class RecordCategory extends Model
+{
+    /** @use HasFactory<\Database\Factories\RecordCategoryFactory> */
+    use HasFactory;
+
+    /**
+     * Query the user.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo<\App\Models\User, $this>
+     */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/User.php

@@ -18,6 +18,7 @@
  * @property \Illuminate\Support\Carbon $created_at
  * @property \Illuminate\Support\Carbon $updated_at
  * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Record> $records
+ * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecordCategory> $recordCategories
  */
 class User extends Auth\User
 {
@@ -67,4 +68,14 @@ public function records(): HasMany
     {
         return $this->hasMany(Record::class);
     }
+
+    /**
+     * Query the record categories.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany<\App\Models\Record, $this>
+     */
+    public function recordCategories(): HasMany
+    {
+        return $this->hasMany(RecordCategory::class);
+    }
 }

app/Policies/RecordCategoryPolicy.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\RecordCategory;
+use App\Models\User;
+
+class RecordCategoryPolicy
+{
+    /**
+     * Determine whether the use can view any record category.
+     *
+     * @param \App\Models\User $user
+     * @return true
+     */
+    public function viewAny(User $user): true
+    {
+        return true;
+    }
+
+    /**
+     * Determine whether the user can view the record category.
+     *
+     * @param \App\Models\User $user
+     * @param \App\Models\RecordCategory $recordCategory
+     * @return bool
+     */
+    public function view(User $user, RecordCategory $recordCategory): bool
+    {
+        return $user->id === $recordCategory->user_id;
+    }
+
+    /**
+     * Determine whether the user can create record categories.
+     *
+     * @param \App\Models\User $user
+     * @return bool
+     */
+    public function create(User $user): bool
+    {
+        return $user->can('viewAny', RecordCategory::class);
+    }
+
+    /**
+     * Determine whether the user can update the specified category.
+     *
+     * @param \App\Models\User $user
+     * @param \App\Models\RecordCategory $recordCategory
+     * @return bool
+     */
+    public function update(User $user, RecordCategory $recordCategory): bool
+    {
+        return $user->can('view', $recordCategory);
+    }
+
+    /**
+     * Determine whether the user can delete the specified category.
+     *
+     * @param \App\Models\User $user
+     * @param \App\Models\RecordCategory $recordCategory
+     * @return bool
+     */
+    public function delete(User $user, RecordCategory $recordCategory): bool
+    {
+        return $user->can('update', $recordCategory);
+    }
+}

database/factories/RecordCategoryFactory.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\RecordCategory>
+ */
+class RecordCategoryFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}

database/migrations/2024_12_21_151626_create_record_categories_table.php

@@ -0,0 +1,29 @@
+<?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('record_categories', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->string('name');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('record_categories');
+    }
+};

resources/views/components/layouts/main.blade.php

@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta
         name="viewport"
-        content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+        content="width=device-width, initial-scale=1.0, maximum-scale=5.0, minimum-scale=1.0">
     <meta http-equiv="X-UA-Compatible" content="ie=edge">
     <title>{{ config('app.name', 'Disk union') }}</title>