new helpdesk module

Modules/Helpdesk/Database/Migrations/2026_04_24_000001_add_helpdesk_flags_to_users_table.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up(): void
+    {
+        Schema::table('users', static function (Blueprint $table): void {
+            if (! Schema::hasColumn('users', 'helpdesk_agent')) {
+                $table->boolean('helpdesk_agent')->default(false)->after('password');
+            }
+
+            if (! Schema::hasColumn('users', 'helpdesk_admin')) {
+                $table->boolean('helpdesk_admin')->default(false)->after('helpdesk_agent');
+            }
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down(): void
+    {
+        Schema::table('users', static function (Blueprint $table): void {
+            if (Schema::hasColumn('users', 'helpdesk_admin')) {
+                $table->dropColumn('helpdesk_admin');
+            }
+
+            if (Schema::hasColumn('users', 'helpdesk_agent')) {
+                $table->dropColumn('helpdesk_agent');
+            }
+        });
+    }
+};

Modules/Helpdesk/Database/Migrations/2026_04_24_000002_create_helpdesk_lookup_tables.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /** @return void */
+    public function up(): void
+    {
+        Schema::create('helpdesk_statuses', static function (Blueprint $table): void {
+            $table->id();
+            $table->string('name', 80);
+            $table->string('slug', 100)->unique();
+            $table->string('color', 30)->default('zinc');
+            $table->unsignedSmallInteger('sort_order')->default(0);
+            $table->boolean('is_closed')->default(false);
+            $table->timestamps();
+        });
+
+        Schema::create('helpdesk_priorities', static function (Blueprint $table): void {
+            $table->id();
+            $table->string('name', 80);
+            $table->string('slug', 100)->unique();
+            $table->string('color', 30)->default('zinc');
+            $table->unsignedSmallInteger('sort_order')->default(0);
+            $table->timestamps();
+        });
+
+        Schema::create('helpdesk_categories', static function (Blueprint $table): void {
+            $table->id();
+            $table->string('name', 120);
+            $table->string('slug', 140)->unique();
+            $table->string('color', 30)->default('blue');
+            $table->text('description')->nullable();
+            $table->timestamps();
+        });
+
+        Schema::create('helpdesk_projects', static function (Blueprint $table): void {
+            $table->id();
+            $table->string('title', 160);
+            $table->string('slug', 180)->unique();
+            $table->string('color', 30)->default('blue');
+            $table->text('description')->nullable();
+            $table->timestamp('archived_at')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+        });
+    }
+
+    /** @return void */
+    public function down(): void
+    {
+        Schema::dropIfExists('helpdesk_projects');
+        Schema::dropIfExists('helpdesk_categories');
+        Schema::dropIfExists('helpdesk_priorities');
+        Schema::dropIfExists('helpdesk_statuses');
+    }
+};

Modules/Helpdesk/Database/Migrations/2026_04_24_000003_create_helpdesk_tickets_table.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /** @return void */
+    public function up(): void
+    {
+        Schema::create('helpdesk_tickets', static function (Blueprint $table): void {
+            $table->id();
+            $table->string('reference', 32)->unique();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->foreignId('agent_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->foreignId('status_id')->constrained('helpdesk_statuses')->restrictOnDelete();
+            $table->foreignId('priority_id')->constrained('helpdesk_priorities')->restrictOnDelete();
+            $table->foreignId('category_id')->nullable()->constrained('helpdesk_categories')->nullOnDelete();
+            $table->foreignId('project_id')->nullable()->constrained('helpdesk_projects')->nullOnDelete();
+            $table->string('subject', 200);
+            $table->longText('body');
+            $table->timestamp('due_at')->nullable();
+            $table->timestamp('completed_at')->nullable();
+            $table->timestamp('last_activity_at')->nullable();
+            $table->timestamp('archived_at')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['status_id', 'priority_id']);
+            $table->index(['agent_id', 'completed_at']);
+            $table->index(['user_id', 'created_at']);
+            $table->index('last_activity_at');
+        });
+    }
+
+    /** @return void */
+    public function down(): void
+    {
+        Schema::dropIfExists('helpdesk_tickets');
+    }
+};

Modules/Helpdesk/Database/Migrations/2026_04_24_000004_create_helpdesk_comments_and_attachments_tables.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /** @return void */
+    public function up(): void
+    {
+        Schema::create('helpdesk_comments', static function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('ticket_id')->constrained('helpdesk_tickets')->cascadeOnDelete();
+            $table->foreignId('user_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->longText('body');
+            $table->boolean('is_internal')->default(false);
+            $table->timestamps();
+
+            $table->index(['ticket_id', 'created_at']);
+        });
+
+        Schema::create('helpdesk_attachments', static function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('ticket_id')->constrained('helpdesk_tickets')->cascadeOnDelete();
+            $table->foreignId('comment_id')->nullable()->constrained('helpdesk_comments')->cascadeOnDelete();
+            $table->foreignId('user_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->string('disk', 80);
+            $table->string('path', 500);
+            $table->string('original_name', 255);
+            $table->string('mime_type', 160)->nullable();
+            $table->unsignedBigInteger('size')->default(0);
+            $table->timestamps();
+
+            $table->index(['ticket_id', 'created_at']);
+        });
+    }
+
+    /** @return void */
+    public function down(): void
+    {
+        Schema::dropIfExists('helpdesk_attachments');
+        Schema::dropIfExists('helpdesk_comments');
+    }
+};

Modules/Helpdesk/Database/Migrations/2026_04_24_000005_create_helpdesk_category_user_table.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /** @return void */
+    public function up(): void
+    {
+        Schema::create('helpdesk_category_user', static function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('category_id')->constrained('helpdesk_categories')->cascadeOnDelete();
+            $table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
+            $table->timestamps();
+            $table->unique(['category_id', 'user_id']);
+        });
+    }
+
+    /** @return void */
+    public function down(): void
+    {
+        Schema::dropIfExists('helpdesk_category_user');
+    }
+};