Merge branch 'master' into 3-category-crud

app/Http/Controllers/CategoryController.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreCategoryRequest;
+use App\Http\Requests\UpdateCategoryRequest;
+use App\Models\Category;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\View\View;
+
+class CategoryController extends Controller
+{
+    /**
+     * Display a listing of categories.
+     */
+    public function index(): View
+    {
+        $categories = Category::query()
+            ->latest()
+            ->paginate(10, ['id', 'name', 'slug', 'description', 'color', 'created_at']);
+
+        return view('category.index', [
+            'categories' => $categories,
+        ]);
+    }
+
+    /**
+     * Show the form for creating a new category.
+     */
+    public function create(): View
+    {
+        return view('category.create');
+    }
+
+    /**
+     * Store a newly created category.
+     */
+    public function store(StoreCategoryRequest $request): RedirectResponse
+    {
+        Category::query()->create($request->validated());
+
+        return redirect()
+            ->route('category.index')
+            ->with('status', 'category-created');
+    }
+
+    /**
+     * Show the form for editing the specified category.
+     */
+    public function edit(Category $category): View
+    {
+        return view('category.edit', [
+            'category' => $category,
+        ]);
+    }
+
+    /**
+     * Update the specified category.
+     */
+    public function update(UpdateCategoryRequest $request, Category $category): RedirectResponse
+    {
+        $category->update($request->validated());
+
+        return redirect()
+            ->route('category.edit', $category)
+            ->with('status', 'category-updated');
+    }
+
+    /**
+     * Remove the specified category.
+     */
+    public function destroy(Category $category): RedirectResponse
+    {
+        $category->delete();
+
+        return redirect()
+            ->route('category.index')
+            ->with('status', 'category-deleted');
+    }
+}

app/Http/Requests/StoreCategoryRequest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Support\Str;
+
+class StoreCategoryRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Prepare the data for validation.
+     */
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'slug' => Str::slug((string) ($this->filled('slug') ? $this->input('slug') : $this->input('name'))),
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:255', 'unique:categories,name'],
+            'slug' => ['required', 'string', 'max:255', 'alpha_dash:ascii', 'unique:categories,slug'],
+            'description' => ['nullable', 'string', 'max:1000'],
+            'color' => ['required', 'string', 'regex:/^#[0-9A-Fa-f]{6}$/'],
+        ];
+    }
+}

app/Http/Requests/UpdateCategoryRequest.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Support\Str;
+use Illuminate\Validation\Rule;
+
+class UpdateCategoryRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Prepare the data for validation.
+     */
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'slug' => Str::slug((string) ($this->filled('slug') ? $this->input('slug') : $this->input('name'))),
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        $categoryId = $this->route('category')?->id;
+
+        return [
+            'name' => ['required', 'string', 'max:255', Rule::unique('categories', 'name')->ignore($categoryId)],
+            'slug' => ['required', 'string', 'max:255', 'alpha_dash:ascii', Rule::unique('categories', 'slug')->ignore($categoryId)],
+            'description' => ['nullable', 'string', 'max:1000'],
+            'color' => ['required', 'string', 'regex:/^#[0-9A-Fa-f]{6}$/'],
+        ];
+    }
+}

app/Models/Category.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Models;
+
+use Database\Factories\CategoryFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+#[Fillable(['name', 'slug', 'description', 'color'])]
+class Category extends Model
+{
+    /** @use HasFactory<CategoryFactory> */
+    use HasFactory;
+}

database/factories/CategoryFactory.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Category;
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Str;
+
+/**
+ * @extends Factory<Category>
+ */
+class CategoryFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        $name = fake()->unique()->words(2, true);
+
+        return [
+            'name' => Str::title($name),
+            'slug' => Str::slug($name),
+            'description' => fake()->sentence(),
+            'color' => fake()->hexColor(),
+        ];
+    }
+}

database/migrations/2026_05_12_022545_create_categories_table.php

@@ -0,0 +1,31 @@
+<?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->string('name')->unique();
+            $table->string('slug')->unique();
+            $table->text('description')->nullable();
+            $table->string('color', 7)->default('#4f46e5');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('categories');
+    }
+};

database/seeders/CategorySeeder.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\Category;
+use Illuminate\Database\Seeder;
+
+class CategorySeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        $categories = [
+            ['name' => 'Product Updates', 'slug' => 'product-updates', 'description' => 'Announcements and release notes.', 'color' => '#4f46e5'],
+            ['name' => 'Operations', 'slug' => 'operations', 'description' => 'Internal workflow and process items.', 'color' => '#10b981'],
+            ['name' => 'Marketing', 'slug' => 'marketing', 'description' => 'Campaigns, content, and promotions.', 'color' => '#f59e0b'],
+            ['name' => 'Support', 'slug' => 'support', 'description' => 'Customer support and service categories.', 'color' => '#ec4899'],
+        ];
+
+        foreach ($categories as $category) {
+            Category::query()->updateOrCreate(
+                ['slug' => $category['slug']],
+                $category,
+            );
+        }
+    }
+}

database/seeders/DatabaseSeeder.php

@@ -17,6 +17,8 @@ class DatabaseSeeder extends Seeder
     {
         // User::factory(10)->create();
 
+        $this->call(CategorySeeder::class);
+
         User::factory()->create([
             'name' => 'Test User',
             'email' => 'test@example.com',

package-lock.json

@@ -32,29 +32,6 @@
                 "url": "https://github.com/sponsors/sindresorhus"
             }
         },
-        "node_modules/@emnapi/core": {
-            "version": "1.10.0",
-            "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
-            "integrity": "sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==",
-            "dev": true,
-            "license": "MIT",
-            "optional": true,
-            "dependencies": {
-                "@emnapi/wasi-threads": "1.2.1",
-                "tslib": "^2.4.0"
-            }
-        },
-        "node_modules/@emnapi/runtime": {
-            "version": "1.10.0",
-            "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
-            "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
-            "dev": true,
-            "license": "MIT",
-            "optional": true,
-            "dependencies": {
-                "tslib": "^2.4.0"
-            }
-        },
         "node_modules/@emnapi/wasi-threads": {
             "version": "1.2.1",
             "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.1.tgz",
@@ -964,6 +941,7 @@
                 }
             ],
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "baseline-browser-mapping": "^2.10.12",
                 "caniuse-lite": "^1.0.30001782",
@@ -2153,6 +2131,7 @@
             "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "engines": {
                 "node": ">=12"
             },
@@ -2200,6 +2179,7 @@
                 }
             ],
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "nanoid": "^3.3.11",
                 "picocolors": "^1.1.1",
@@ -2629,6 +2609,7 @@
             "integrity": "sha512-3ofp+LL8E+pK/JuPLPggVAIaEuhvIz4qNcf3nA1Xn2o/7fb7s/TYpHhwGDv1ZU3PkBluUVaF8PyCHcm48cKLWQ==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "@alloc/quick-lru": "^5.2.0",
                 "arg": "^5.0.2",
@@ -2806,6 +2787,7 @@
             "integrity": "sha512-Jz1mxtUBR5xTT65VOdJZUUeoyLtqljmFkiUXhPTLZka3RDc9vpi/xXkyrnsdRcm2lIi3l3GPMnAidTsEGIj3Ow==",
             "dev": true,
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "lightningcss": "^1.32.0",
                 "picomatch": "^4.0.4",

resources/views/category/create.blade.php

@@ -0,0 +1,63 @@
+<x-app-layout>
+    <x-slot name="header">
+        <div>
+            <p class="text-sm font-medium uppercase tracking-wider text-indigo-600">{{ __('Categories') }}</p>
+            <h2 class="text-2xl font-semibold leading-tight text-gray-900">
+                {{ __('Create Category') }}
+            </h2>
+        </div>
+    </x-slot>
+
+    <div class="py-10">
+        <div class="mx-auto max-w-4xl px-4 sm:px-6 lg:px-8">
+            <section class="overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm">
+                <div class="border-b border-gray-100 bg-gradient-to-r from-indigo-50 via-fuchsia-50 to-amber-50 px-6 py-5">
+                    <h3 class="text-lg font-semibold text-gray-900">{{ __('Category Details') }}</h3>
+                    <p class="mt-1 text-sm text-gray-600">{{ __('Choose a clear name and a color that stands out in lists.') }}</p>
+                </div>
+
+                <form method="POST" action="{{ route('category.store') }}" class="space-y-6 p-6">
+                    @csrf
+
+                    <div class="grid gap-6 md:grid-cols-2">
+                        <div>
+                            <x-input-label for="name" :value="__('Name')" />
+                            <x-text-input id="name" class="mt-2 block w-full" type="text" name="name" :value="old('name')" required autofocus autocomplete="off" />
+                            <x-input-error class="mt-2" :messages="$errors->get('name')" />
+                        </div>
+
+                        <div>
+                            <x-input-label for="slug" :value="__('Slug')" />
+                            <x-text-input id="slug" class="mt-2 block w-full" type="text" name="slug" :value="old('slug')" autocomplete="off" placeholder="auto-generated-from-name" />
+                            <x-input-error class="mt-2" :messages="$errors->get('slug')" />
+                        </div>
+                    </div>
+
+                    <div>
+                        <x-input-label for="description" :value="__('Description')" />
+                        <textarea id="description" name="description" rows="4" class="mt-2 block w-full rounded-lg border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500">{{ old('description') }}</textarea>
+                        <x-input-error class="mt-2" :messages="$errors->get('description')" />
+                    </div>
+
+                    <div>
+                        <x-input-label for="color" :value="__('Color')" />
+                        <div class="mt-2 flex items-center gap-3">
+                            <input id="color" type="color" name="color" value="{{ old('color', '#4f46e5') }}" class="h-11 w-16 cursor-pointer rounded-lg border border-gray-300 bg-white p-1 shadow-sm">
+                            <span class="text-sm text-gray-500">{{ __('Select a category accent color.') }}</span>
+                        </div>
+                        <x-input-error class="mt-2" :messages="$errors->get('color')" />
+                    </div>
+
+                    <div class="flex flex-col-reverse gap-3 border-t border-gray-100 pt-6 sm:flex-row sm:items-center sm:justify-end">
+                        <a href="{{ route('category.index') }}" class="inline-flex items-center justify-center rounded-lg border border-gray-300 px-4 py-2 text-sm font-semibold text-gray-700 transition hover:bg-gray-50">
+                            {{ __('Cancel') }}
+                        </a>
+                        <button type="submit" class="inline-flex items-center justify-center rounded-lg bg-indigo-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-indigo-500 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2">
+                            {{ __('Save Category') }}
+                        </button>
+                    </div>
+                </form>
+            </section>
+        </div>
+    </div>
+</x-app-layout>

resources/views/category/edit.blade.php

@@ -0,0 +1,92 @@
+<x-app-layout>
+    <x-slot name="header">
+        <div class="flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
+            <div>
+                <p class="text-sm font-medium uppercase tracking-wider text-indigo-600">{{ __('Categories') }}</p>
+                <h2 class="text-2xl font-semibold leading-tight text-gray-900">
+                    {{ __('Edit Category') }}
+                </h2>
+            </div>
+
+            <a href="{{ route('category.index') }}" class="inline-flex items-center justify-center rounded-lg border border-gray-300 px-4 py-2 text-sm font-semibold text-gray-700 transition hover:bg-white">
+                {{ __('Back to Categories') }}
+            </a>
+        </div>
+    </x-slot>
+
+    <div class="py-10">
+        <div class="mx-auto max-w-4xl px-4 sm:px-6 lg:px-8">
+            @if (session('status') === 'category-updated')
+                <div class="mb-6 rounded-lg border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm font-medium text-emerald-800">
+                    {{ __('Category updated successfully.') }}
+                </div>
+            @endif
+
+            <section class="overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm">
+                <div class="border-b border-gray-100 px-6 py-5" style="background: linear-gradient(90deg, {{ $category->color }}20, #ffffff)">
+                    <div class="flex items-center gap-4">
+                        <span class="h-12 w-12 rounded-xl shadow-sm ring-1 ring-black/5" style="background-color: {{ $category->color }}"></span>
+                        <div>
+                            <h3 class="text-lg font-semibold text-gray-900">{{ $category->name }}</h3>
+                            <p class="mt-1 font-mono text-sm text-gray-600">{{ $category->slug }}</p>
+                        </div>
+                    </div>
+                </div>
+
+                <form id="delete-category-form" method="POST" action="{{ route('category.destroy', $category) }}" onsubmit="return confirm('{{ __('Delete this category?') }}')">
+                    @csrf
+                    @method('DELETE')
+                </form>
+
+                <form method="POST" action="{{ route('category.update', $category) }}" class="space-y-6 p-6">
+                    @csrf
+                    @method('PATCH')
+
+                    <div class="grid gap-6 md:grid-cols-2">
+                        <div>
+                            <x-input-label for="name" :value="__('Name')" />
+                            <x-text-input id="name" class="mt-2 block w-full" type="text" name="name" :value="old('name', $category->name)" required autofocus autocomplete="off" />
+                            <x-input-error class="mt-2" :messages="$errors->get('name')" />
+                        </div>
+
+                        <div>
+                            <x-input-label for="slug" :value="__('Slug')" />
+                            <x-text-input id="slug" class="mt-2 block w-full" type="text" name="slug" :value="old('slug', $category->slug)" required autocomplete="off" />
+                            <x-input-error class="mt-2" :messages="$errors->get('slug')" />
+                        </div>
+                    </div>
+
+                    <div>
+                        <x-input-label for="description" :value="__('Description')" />
+                        <textarea id="description" name="description" rows="4" class="mt-2 block w-full rounded-lg border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500">{{ old('description', $category->description) }}</textarea>
+                        <x-input-error class="mt-2" :messages="$errors->get('description')" />
+                    </div>
+
+                    <div>
+                        <x-input-label for="color" :value="__('Color')" />
+                        <div class="mt-2 flex items-center gap-3">
+                            <input id="color" type="color" name="color" value="{{ old('color', $category->color) }}" class="h-11 w-16 cursor-pointer rounded-lg border border-gray-300 bg-white p-1 shadow-sm">
+                            <span class="text-sm text-gray-500">{{ __('Adjust the accent used across category lists.') }}</span>
+                        </div>
+                        <x-input-error class="mt-2" :messages="$errors->get('color')" />
+                    </div>
+
+                    <div class="flex flex-col gap-3 border-t border-gray-100 pt-6 sm:flex-row sm:items-center sm:justify-between">
+                        <button type="submit" form="delete-category-form" class="inline-flex items-center justify-center rounded-lg border border-rose-200 px-4 py-2 text-sm font-semibold text-rose-700 transition hover:bg-rose-50">
+                            {{ __('Delete Category') }}
+                        </button>
+
+                        <div class="flex flex-col-reverse gap-3 sm:flex-row sm:items-center">
+                            <a href="{{ route('category.index') }}" class="inline-flex items-center justify-center rounded-lg border border-gray-300 px-4 py-2 text-sm font-semibold text-gray-700 transition hover:bg-gray-50">
+                                {{ __('Cancel') }}
+                            </a>
+                            <button type="submit" class="inline-flex items-center justify-center rounded-lg bg-indigo-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-indigo-500 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2">
+                                {{ __('Update Category') }}
+                            </button>
+                        </div>
+                    </div>
+                </form>
+            </section>
+        </div>
+    </div>
+</x-app-layout>

resources/views/category/index.blade.php

@@ -0,0 +1,126 @@
+<x-app-layout>
+    <x-slot name="header">
+        <div class="flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
+            <div>
+                <p class="text-sm font-medium uppercase tracking-wider text-indigo-600">{{ __('Content Library') }}</p>
+                <h2 class="text-2xl font-semibold leading-tight text-gray-900">
+                    {{ __('Categories') }}
+                </h2>
+            </div>
+
+            <a href="{{ route('category.create') }}" class="inline-flex items-center justify-center rounded-lg bg-indigo-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-indigo-500 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2">
+                {{ __('New Category') }}
+            </a>
+        </div>
+    </x-slot>
+
+    <div class="py-10">
+        <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
+            @if (session('status'))
+                <div class="mb-6 rounded-lg border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm font-medium text-emerald-800">
+                    @if (session('status') === 'category-created')
+                        {{ __('Category created successfully.') }}
+                    @elseif (session('status') === 'category-updated')
+                        {{ __('Category updated successfully.') }}
+                    @elseif (session('status') === 'category-deleted')
+                        {{ __('Category deleted successfully.') }}
+                    @endif
+                </div>
+            @endif
+
+            <div class="grid gap-6 lg:grid-cols-[1fr_18rem]">
+                <section class="overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm">
+                    <div class="border-b border-gray-100 bg-gradient-to-r from-indigo-50 via-sky-50 to-emerald-50 px-6 py-5">
+                        <div class="flex flex-col gap-2 sm:flex-row sm:items-end sm:justify-between">
+                            <div>
+                                <h3 class="text-lg font-semibold text-gray-900">{{ __('Manage Categories') }}</h3>
+                                <p class="mt-1 text-sm text-gray-600">{{ __('Organize records with clear names, slugs, and color labels.') }}</p>
+                            </div>
+                            <span class="inline-flex w-fit items-center rounded-full bg-white px-3 py-1 text-sm font-medium text-gray-700 shadow-sm ring-1 ring-gray-200">
+                                {{ trans_choice(':count category|:count categories', $categories->total(), ['count' => $categories->total()]) }}
+                            </span>
+                        </div>
+                    </div>
+
+                    <div class="overflow-x-auto">
+                        <table class="min-w-full divide-y divide-gray-200">
+                            <thead class="bg-white">
+                                <tr>
+                                    <th scope="col" class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-wider text-gray-500">{{ __('Category') }}</th>
+                                    <th scope="col" class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-wider text-gray-500">{{ __('Slug') }}</th>
+                                    <th scope="col" class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-wider text-gray-500">{{ __('Created') }}</th>
+                                    <th scope="col" class="px-6 py-4 text-right text-xs font-semibold uppercase tracking-wider text-gray-500">{{ __('Actions') }}</th>
+                                </tr>
+                            </thead>
+                            <tbody class="divide-y divide-gray-100 bg-white">
+                                @forelse ($categories as $category)
+                                    <tr class="transition hover:bg-gray-50">
+                                        <td class="px-6 py-4">
+                                            <div class="flex items-center gap-3">
+                                                <span class="h-11 w-11 rounded-xl shadow-sm ring-1 ring-black/5" style="background-color: {{ $category->color }}"></span>
+                                                <div>
+                                                    <p class="font-semibold text-gray-900">{{ $category->name }}</p>
+                                                    <p class="mt-1 max-w-md truncate text-sm text-gray-500">
+                                                        {{ $category->description ?: __('No description added.') }}
+                                                    </p>
+                                                </div>
+                                            </div>
+                                        </td>
+                                        <td class="px-6 py-4 text-sm text-gray-600">
+                                            <span class="rounded-full bg-gray-100 px-3 py-1 font-mono text-xs text-gray-700">{{ $category->slug }}</span>
+                                        </td>
+                                        <td class="px-6 py-4 text-sm text-gray-600">{{ $category->created_at?->format('Y-m-d H:i') }}</td>
+                                        <td class="px-6 py-4 text-right text-sm">
+                                            <div class="flex justify-end gap-2">
+                                                <a href="{{ route('category.edit', $category) }}" class="rounded-lg border border-indigo-200 px-3 py-2 font-medium text-indigo-700 transition hover:bg-indigo-50">
+                                                    {{ __('Edit') }}
+                                                </a>
+                                                <form method="POST" action="{{ route('category.destroy', $category) }}" onsubmit="return confirm('{{ __('Delete this category?') }}')">
+                                                    @csrf
+                                                    @method('DELETE')
+
+                                                    <button type="submit" class="rounded-lg border border-rose-200 px-3 py-2 font-medium text-rose-700 transition hover:bg-rose-50">
+                                                        {{ __('Delete') }}
+                                                    </button>
+                                                </form>
+                                            </div>
+                                        </td>
+                                    </tr>
+                                @empty
+                                    <tr>
+                                        <td colspan="4" class="px-6 py-12 text-center">
+                                            <div class="mx-auto max-w-sm">
+                                                <div class="mx-auto h-12 w-12 rounded-2xl bg-indigo-100"></div>
+                                                <h3 class="mt-4 text-base font-semibold text-gray-900">{{ __('No categories yet') }}</h3>
+                                                <p class="mt-1 text-sm text-gray-500">{{ __('Create your first category to start organizing the system.') }}</p>
+                                                <a href="{{ route('category.create') }}" class="mt-5 inline-flex items-center justify-center rounded-lg bg-indigo-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-indigo-500">
+                                                    {{ __('Create Category') }}
+                                                </a>
+                                            </div>
+                                        </td>
+                                    </tr>
+                                @endforelse
+                            </tbody>
+                        </table>
+                    </div>
+
+                    @if ($categories->hasPages())
+                        <div class="border-t border-gray-100 px-6 py-4">
+                            {{ $categories->links() }}
+                        </div>
+                    @endif
+                </section>
+
+                <aside class="rounded-xl border border-gray-200 bg-white p-6 shadow-sm">
+                    <p class="text-sm font-medium uppercase tracking-wider text-gray-500">{{ __('Palette') }}</p>
+                    <div class="mt-4 grid grid-cols-4 gap-3">
+                        @foreach ($categories->take(8) as $category)
+                            <span class="h-12 rounded-xl shadow-sm ring-1 ring-black/5" style="background-color: {{ $category->color }}" title="{{ $category->name }}"></span>
+                        @endforeach
+                    </div>
+                    <p class="mt-5 text-sm leading-6 text-gray-600">{{ __('Use color to make category scanning faster while keeping names and slugs predictable.') }}</p>
+                </aside>
+            </div>
+        </div>
+    </div>
+</x-app-layout>

resources/views/layouts/navigation.blade.php

@@ -21,6 +21,9 @@
                     <x-nav-link :href="route('role.index')" :active="request()->routeIs('role.index')">
                         {{ __('Roles') }}
                     </x-nav-link>
+                    <x-nav-link :href="route('category.index')" :active="request()->routeIs('category.*')">
+                        {{ __('Categories') }}
+                    </x-nav-link>
                 </div>
             </div>
 
@@ -82,6 +85,9 @@
             <x-responsive-nav-link :href="route('role.index')" :active="request()->routeIs('role.index')">
                 {{ __('Roles') }}
             </x-responsive-nav-link>
+            <x-responsive-nav-link :href="route('category.index')" :active="request()->routeIs('category.*')">
+                {{ __('Categories') }}
+            </x-responsive-nav-link>
         </div>
 
         <!-- Responsive Settings Options -->

routes/web.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Http\Controllers\CategoryController;
 use App\Http\Controllers\ProfileController;
 use App\Http\Controllers\RoleController;
 use App\Http\Controllers\UserController;
@@ -20,6 +21,7 @@ Route::middleware('auth')->group(function () {
     Route::get('/role', [RoleController::class, 'index'])->name('role.index');
     Route::get('/role/create', [RoleController::class, 'create'])->name('role.create');
     Route::post('/role', [RoleController::class, 'store'])->name('role.store');
+    Route::resource('category', CategoryController::class)->except('show');
     Route::get('/profile', [ProfileController::class, 'edit'])->name('profile.edit');
     Route::patch('/profile', [ProfileController::class, 'update'])->name('profile.update');
     Route::delete('/profile', [ProfileController::class, 'destroy'])->name('profile.destroy');

tests/Feature/CategoryCrudTest.php

@@ -0,0 +1,96 @@
+<?php
+
+use App\Models\Category;
+use App\Models\User;
+
+test('category pages require authentication', function () {
+    $category = Category::factory()->create();
+
+    $this->get('/category')->assertRedirect('/login');
+    $this->get("/category/{$category->id}/edit")->assertRedirect('/login');
+});
+
+test('authenticated users can view categories', function () {
+    Category::factory()->create([
+        'name' => 'Design',
+        'slug' => 'design',
+        'description' => 'Visual work',
+        'color' => '#ec4899',
+    ]);
+
+    $response = $this
+        ->actingAs(User::factory()->create())
+        ->get('/category');
+
+    $response
+        ->assertSuccessful()
+        ->assertSee('Categories')
+        ->assertSee('Design')
+        ->assertSee('design')
+        ->assertSee('Visual work');
+});
+
+test('authenticated users can create a category', function () {
+    $response = $this
+        ->actingAs(User::factory()->create())
+        ->post('/category', [
+            'name' => 'Operations',
+            'slug' => '',
+            'description' => 'Internal workflows',
+            'color' => '#10b981',
+        ]);
+
+    $response->assertRedirect('/category');
+
+    $this->assertDatabaseHas('categories', [
+        'name' => 'Operations',
+        'slug' => 'operations',
+        'description' => 'Internal workflows',
+        'color' => '#10b981',
+    ]);
+});
+
+test('authenticated users can update a category', function () {
+    $category = Category::factory()->create([
+        'name' => 'Legacy',
+        'slug' => 'legacy',
+        'color' => '#4f46e5',
+    ]);
+
+    $response = $this
+        ->actingAs(User::factory()->create())
+        ->patch("/category/{$category->id}", [
+            'name' => 'Marketing',
+            'slug' => 'marketing',
+            'description' => 'Campaign planning',
+            'color' => '#f59e0b',
+        ]);
+
+    $response->assertRedirect("/category/{$category->id}/edit");
+
+    $this->assertDatabaseHas('categories', [
+        'id' => $category->id,
+        'name' => 'Marketing',
+        'slug' => 'marketing',
+        'description' => 'Campaign planning',
+        'color' => '#f59e0b',
+    ]);
+});
+
+test('authenticated users can delete a category', function () {
+    $category = Category::factory()->create([
+        'name' => 'Archive',
+        'slug' => 'archive',
+        'color' => '#64748b',
+    ]);
+
+    $response = $this
+        ->actingAs(User::factory()->create())
+        ->delete("/category/{$category->id}");
+
+    $response->assertRedirect('/category');
+
+    $this->assertDatabaseMissing('categories', [
+        'id' => $category->id,
+    ]);
+});