move into sonardesk

Categories/Config/config.php

@@ -0,0 +1,3 @@
+<?php
+
+return ['name' => 'Categories'];

Categories/Database/Migrations/2026_07_24_030100_create_categories_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('categories', function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('parent_id')->nullable()->constrained('categories')->nullOnDelete();
+            $table->string('name');
+            $table->string('slug')->unique();
+            $table->text('description')->nullable();
+            $table->string('type')->default('content')->index();
+            $table->unsignedInteger('sort_order')->default(0);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('categories');
+    }
+};

Categories/Http/Controllers/CategoryController.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Modules\Categories\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Modules\Categories\Models\Category;
+
+final class CategoryController extends Controller
+{
+    public function index(): View
+    {
+        return view('categories::admin.index', ['records' => Category::with('parent')->orderBy('type')->orderBy('sort_order')->paginate(30)]);
+    }
+
+    public function create(): View
+    {
+        return view('categories::admin.form', ['parents' => Category::orderBy('name')->get()]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        Category::create($this->validated($request));
+
+        return redirect()->route('administration.categories.index')->with('status', 'Category created.');
+    }
+
+    public function edit(Category $category): View
+    {
+        return view('categories::admin.form', ['record' => $category, 'parents' => Category::whereKeyNot($category->getKey())->orderBy('name')->get()]);
+    }
+
+    public function update(Request $request, Category $category): RedirectResponse
+    {
+        $category->update($this->validated($request));
+
+        return redirect()->route('administration.categories.index')->with('status', 'Category updated.');
+    }
+
+    public function destroy(Category $category): RedirectResponse
+    {
+        $category->delete();
+
+        return back()->with('status', 'Category deleted.');
+    }
+
+    private function validated(Request $request): array
+    {
+        $data = $request->validate(['parent_id' => ['nullable', 'exists:categories,id'], 'name' => ['required', 'string', 'max:255'], 'slug' => ['required', 'string', 'max:255'], 'description' => ['nullable', 'string'], 'type' => ['required', 'string', 'max:50'], 'sort_order' => ['nullable', 'integer', 'min:0'], 'is_active' => ['sometimes', 'boolean']]);
+        $data['is_active'] = $request->boolean('is_active');
+
+        return $data;
+    }
+}

Categories/Models/Category.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Modules\Categories\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+final class Category extends Model
+{
+    protected $fillable = ['parent_id', 'name', 'slug', 'description', 'type', 'sort_order', 'is_active'];
+
+    protected function casts(): array
+    {
+        return ['is_active' => 'boolean', 'sort_order' => 'integer'];
+    }
+
+    public function parent(): BelongsTo
+    {
+        return $this->belongsTo(self::class, 'parent_id');
+    }
+
+    public function children(): HasMany
+    {
+        return $this->hasMany(self::class, 'parent_id')->orderBy('sort_order');
+    }
+}

Categories/Providers/CategoriesServiceProvider.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Modules\Categories\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+final class CategoriesServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->register(RouteServiceProvider::class);
+        $this->mergeConfigFrom(module_path('Categories', 'Config/config.php'), 'categories');
+    }
+
+    public function boot(): void
+    {
+        $this->loadMigrationsFrom(module_path('Categories', 'Database/Migrations'));
+        $this->loadViewsFrom(module_path('Categories', 'Resources/views'), 'categories');
+    }
+}

Categories/Providers/RouteServiceProvider.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Modules\Categories\Providers;
+
+use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
+use Illuminate\Support\Facades\Route;
+
+final class RouteServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        parent::boot();
+        Route::middleware('web')->group(module_path('Categories', 'Routes/web.php'));
+    }
+}

Categories/Resources/views/admin/form.blade.php

@@ -0,0 +1 @@
+<x-layouts.app :title="isset($record) ? 'Edit category' : 'Create category'"><form method="POST" action="{{ isset($record) ? route('administration.categories.update',$record) : route('administration.categories.store') }}" class="max-w-3xl space-y-5">@csrf @isset($record) @method('PUT') @endisset <flux:input name="name" label="Name" value="{{ old('name',$record->name ?? '') }}" required/><flux:input name="slug" label="Slug" value="{{ old('slug',$record->slug ?? '') }}" required/><flux:select name="parent_id" label="Parent"><option value="">None</option>@foreach($parents as $parent)<option value="{{ $parent->id }}" @selected(old('parent_id',$record->parent_id ?? null)==$parent->id)>{{ $parent->name }}</option>@endforeach</flux:select><flux:input name="type" label="Type" value="{{ old('type',$record->type ?? 'content') }}"/><flux:textarea name="description" label="Description">{{ old('description',$record->description ?? '') }}</flux:textarea><flux:input name="sort_order" type="number" label="Sort order" value="{{ old('sort_order',$record->sort_order ?? 0) }}"/><flux:checkbox name="is_active" value="1" label="Active" :checked="old('is_active',$record->is_active ?? true)"/><flux:button type="submit" variant="primary">Save</flux:button></form></x-layouts.app>

Categories/Resources/views/admin/index.blade.php

@@ -0,0 +1 @@
+<x-layouts.app :title="__('Categories')"><div class="flex items-center justify-between mb-6"><div><h1 class="text-2xl font-semibold">Categories</h1><p class="text-sm text-zinc-500">Manage publishing categories.</p></div><flux:button variant="primary" :href="route('administration.categories.create')" wire:navigate>Create</flux:button></div>@if(session('status'))<div class="mb-4 rounded border border-green-300 bg-green-50 p-3 text-green-800">{{ session('status') }}</div>@endif<div class="overflow-hidden rounded-xl border border-zinc-200 bg-white"><table class="w-full text-sm"><thead class="bg-zinc-50"><tr><th class="p-3 text-left">Name / title</th><th class="p-3 text-left">Status</th><th class="p-3 text-right">Actions</th></tr></thead><tbody>@forelse($records as $record)<tr class="border-t"><td class="p-3 font-medium">{{ $record->title ?? $record->name }}</td><td class="p-3">{{ $record->status ?? ($record->is_active ? 'Active' : 'Inactive') }}</td><td class="p-3 text-right"><flux:button size="sm" :href="route('administration.categories.edit', $record)" wire:navigate>Edit</flux:button><form class="inline" method="POST" action="{{ route('administration.categories.destroy', $record) }}">@csrf @method('DELETE')<flux:button size="sm" variant="danger" type="submit">Delete</flux:button></form></td></tr>@empty<tr><td colspan="3" class="p-6 text-center text-zinc-500">No records yet.</td></tr>@endforelse</tbody></table></div><div class="mt-4">{{ $records->links() }}</div></x-layouts.app>

Categories/Routes/web.php

@@ -0,0 +1,13 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Categories\Http\Controllers\CategoryController;
+
+Route::middleware(['auth', 'verified'])->prefix('administration/categories')->name('administration.categories.')->group(function (): void {
+    Route::get('/', [CategoryController::class, 'index'])->name('index');
+    Route::get('/create', [CategoryController::class, 'create'])->name('create');
+    Route::post('/', [CategoryController::class, 'store'])->name('store');
+    Route::get('/{category}/edit', [CategoryController::class, 'edit'])->name('edit');
+    Route::match(['put', 'patch'], '/{category}', [CategoryController::class, 'update'])->name('update');
+    Route::delete('/{category}', [CategoryController::class, 'destroy'])->name('destroy');
+});

Categories/Tests/Feature/ModuleBootTest.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Categories\Tests\Feature;
+
+use Tests\TestCase;
+
+final class ModuleBootTest extends TestCase
+{
+    public function test_module_configuration_is_available(): void
+    {
+        $this->assertSame('Categories', config('categories.name'));
+    }
+}

Categories/module.json

@@ -0,0 +1,12 @@
+{
+  "name": "Categories",
+  "alias": "categories",
+  "version": "1.0.0",
+  "description": "Categories publishing module.",
+  "keywords": ["publishing", "categories"],
+  "priority": 30,
+  "providers": ["Modules\\Categories\\Providers\\CategoriesServiceProvider"],
+  "aliases": {},
+  "files": [],
+  "requires": ["Core", "Administration"]
+}