added support for legacy tickets, fixed switching of modes and also style updates

Modules/Documentation/Console/ImportDocumentationCommand.php

@@ -5,31 +5,19 @@ declare(strict_types=1);
 namespace Modules\Documentation\Console;
 
 use Illuminate\Console\Command;
-
 use Illuminate\Support\Facades\DB;
-
 use Illuminate\Support\Str;
-
 use Modules\Documentation\Models\DocumentationCategory;
-
 use Modules\Documentation\Models\DocumentationDocument;
-
 use SplFileInfo;
-
 use Symfony\Component\Finder\Finder;
-
 use Throwable;
 
 final class ImportDocumentationCommand extends Command
-
 {
-
     /**
-
      * The console command signature.
-
      */
-
     protected $signature = 'helpdesk:import-documentation
 
         {path? : Directory containing Markdown files; defaults to the bundled Sentinel documentation}
@@ -39,21 +27,14 @@ final class ImportDocumentationCommand extends Command
         {--fresh : Remove previously imported documents in this category before importing}';
 
     /**
-
      * The console command description.
-
      */
-
     protected $description = 'Import Markdown documentation into the Helpdesk Documentation module.';
 
     /**
-
      * Execute the console command.
-
      */
-
     public function handle(): int
-
     {
 
         $path = $this->resolvePath();
@@ -164,7 +145,7 @@ final class ImportDocumentationCommand extends Command
 
                 $this->importFile($category, $file, $path);
 
-                ++$imported;
+                $imported++;
 
                 $progress->advance();
 
@@ -217,13 +198,9 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Resolve the requested documentation source directory.
-
      */
-
     private function resolvePath(): string
-
     {
 
         $argument = $this->argument('path');
@@ -247,17 +224,13 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Find Markdown files recursively.
 
      *
 
      * @return list<SplFileInfo>
-
      */
-
     private function markdownFiles(string $path): array
-
     {
 
         $finder = Finder::create()
@@ -273,7 +246,6 @@ final class ImportDocumentationCommand extends Command
             ->sortByName();
 
         /** @var list<SplFileInfo> $files */
-
         $files = iterator_to_array($finder, false);
 
         return $files;
@@ -281,11 +253,8 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Import one Markdown document.
-
      */
-
     private function importFile(
 
         DocumentationCategory $category,
@@ -301,7 +270,6 @@ final class ImportDocumentationCommand extends Command
         if ($realPath === false || ! is_readable($realPath)) {
 
             throw new \RuntimeException(
-
                 sprintf('Unable to read documentation file: %s', $file->getPathname()),
 
             );
@@ -313,7 +281,6 @@ final class ImportDocumentationCommand extends Command
         if ($body === false) {
 
             throw new \RuntimeException(
-
                 sprintf('Unable to read documentation file: %s', $realPath),
 
             );
@@ -377,13 +344,9 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Extract the first Markdown H1 heading.
-
      */
-
     private function extractTitle(string $body, SplFileInfo $file): string
-
     {
 
         if (preg_match('/^\s*#\s+(.+?)\s*$/m', $body, $matches) === 1) {
@@ -417,13 +380,9 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Extract a useful summary from the first normal Markdown paragraph.
-
      */
-
     private function extractSummary(string $body): ?string
-
     {
 
         $lines = preg_split('/\R/', $body);
@@ -507,13 +466,9 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Generate a stable globally unique slug from the source path.
-
      */
-
     private function makeSlug(string $relativePath, string $title): string
-
     {
 
         $withoutExtension = preg_replace(
@@ -545,13 +500,9 @@ final class ImportDocumentationCommand extends Command
     }
 
     /**
-
      * Remove a UTF-8 byte-order mark.
-
      */
-
     private function stripBom(string $contents): string
-
     {
 
         if (str_starts_with($contents, "\xEF\xBB\xBF")) {
@@ -563,6 +514,4 @@ final class ImportDocumentationCommand extends Command
         return $contents;
 
     }
-
 }
-

Modules/Documentation/Models/DocumentationCategory.php

@@ -67,7 +67,6 @@ class DocumentationCategory extends Model
      * Active category scope.
      *
      * @param  Builder<DocumentationCategory>  $query
-     *
      * @return Builder<DocumentationCategory>
      */
     public function scopeActive(Builder $query): Builder
@@ -79,7 +78,6 @@ class DocumentationCategory extends Model
      * Ordered category scope.
      *
      * @param  Builder<DocumentationCategory>  $query
-     *
      * @return Builder<DocumentationCategory>
      */
     public function scopeOrdered(Builder $query): Builder

Modules/Documentation/Models/DocumentationDocument.php

@@ -102,7 +102,6 @@ class DocumentationDocument extends Model
      * Published document scope.
      *
      * @param  Builder<DocumentationDocument>  $query
-     *
      * @return Builder<DocumentationDocument>
      */
     public function scopePublished(Builder $query): Builder
@@ -114,7 +113,6 @@ class DocumentationDocument extends Model
      * Featured document scope.
      *
      * @param  Builder<DocumentationDocument>  $query
-     *
      * @return Builder<DocumentationDocument>
      */
     public function scopeFeatured(Builder $query): Builder

Modules/Documentation/Providers/DocumentationServiceProvider.php

@@ -7,6 +7,7 @@ namespace Modules\Documentation\Providers;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\ServiceProvider;
+use Modules\Documentation\Console\ImportDocumentationCommand;
 
 final class DocumentationServiceProvider extends ServiceProvider
 {
@@ -43,7 +44,7 @@ final class DocumentationServiceProvider extends ServiceProvider
         }
 
         $this->commands([
-            \Modules\Documentation\Console\ImportDocumentationCommand::class,
+            ImportDocumentationCommand::class,
         ]);
     }
 

Modules/Documentation/Tests/Feature/DocumentationArchiveTest.php

@@ -7,7 +7,6 @@ namespace Modules\Documentation\Tests\Feature;
 use App\Models\User;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Storage;
-use Modules\Documentation\Models\DocumentationAttachment;
 use Modules\Documentation\Models\DocumentationDocument;
 use Tests\TestCase;
 

Modules/Documentation/Tests/Feature/DocumentationModuleTest.php

@@ -18,7 +18,6 @@ class DocumentationModuleTest extends TestCase
      * Add a CSRF token for projects that keep web middleware enabled during tests.
      *
      * @param  array<string, mixed>  $payload
-     *
      * @return array<string, mixed>
      */
     private function csrfPayload(array $payload): array

Modules/Helpdesk/Console/ImportLegacyHelpdeskCommand.php

@@ -16,6 +16,7 @@ use Throwable;
 final class ImportLegacyHelpdeskCommand extends Command
 {
     protected $signature = 'helpdesk:import-legacy {--connection= : Laravel database connection containing the old tickets tables} {--fresh : Clear previously imported legacy records first}';
+
     protected $description = 'Import the old Helpdesk tickets and categories into the read-only Legacy System';
 
     public function handle(): int
@@ -33,6 +34,7 @@ final class ImportLegacyHelpdeskCommand extends Command
         foreach (['tickets', 'tickets_categories'] as $table) {
             if (! $schema->hasTable($table)) {
                 $this->error("Source table {$table} was not found on connection [{$connectionName}].");
+
                 return self::FAILURE;
             }
         }
@@ -49,6 +51,7 @@ final class ImportLegacyHelpdeskCommand extends Command
         $this->refreshCategoryCounts();
 
         $this->info(sprintf('Legacy import complete: %d tickets, %d categories, %d comments.', LegacyTicket::count(), LegacyCategory::count(), LegacyComment::count()));
+
         return self::SUCCESS;
     }
 
@@ -72,7 +75,7 @@ final class ImportLegacyHelpdeskCommand extends Command
             'user' => $this->lookup($source, $schema, 'users'),
         ];
 
-        $source->table('tickets')->orderBy('id')->chunk(250, function ($rows) use ($columns, $lookups): void {
+        $source->table('tickets')->orderBy('id')->chunk(250, function ($rows) use ($lookups): void {
             foreach ($rows as $row) {
                 $data = (array) $row;
                 LegacyTicket::updateOrCreate(['legacy_id' => $row->id], [
@@ -99,7 +102,9 @@ final class ImportLegacyHelpdeskCommand extends Command
 
     private function importComments(ConnectionInterface $source, $schema): void
     {
-        if (! $schema->hasTable('tickets_comments')) return;
+        if (! $schema->hasTable('tickets_comments')) {
+            return;
+        }
         $users = $this->lookup($source, $schema, 'users');
         $source->table('tickets_comments')->orderBy('id')->chunk(500, function ($rows) use ($users): void {
             foreach ($rows as $row) {
@@ -118,11 +123,19 @@ final class ImportLegacyHelpdeskCommand extends Command
 
     private function lookup(ConnectionInterface $source, $schema, string $table): array
     {
-        if (! $schema->hasTable($table)) return [];
+        if (! $schema->hasTable($table)) {
+            return [];
+        }
         $columns = $schema->getColumnListing($table);
         $nameColumn = in_array('name', $columns, true) ? 'name' : (in_array('username', $columns, true) ? 'username' : null);
-        if ($nameColumn === null) return [];
+        if ($nameColumn === null) {
-        try { return $source->table($table)->pluck($nameColumn, 'id')->map(fn ($v) => (string) $v)->all(); } catch (Throwable) { return []; }
+            return [];
+        }
+        try {
+            return $source->table($table)->pluck($nameColumn, 'id')->map(fn ($v) => (string) $v)->all();
+        } catch (Throwable) {
+            return [];
+        }
     }
 
     private function refreshCategoryCounts(): void

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

@@ -6,7 +6,8 @@ use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 
-return new class extends Migration {
+return new class extends Migration
+{
     public function up(): void
     {
         Schema::create('helpdesk_legacy_categories', function (Blueprint $table): void {

Modules/Helpdesk/Http/Controllers/LegacySystemController.php

@@ -39,6 +39,7 @@ final class LegacySystemController
     public function show(LegacyTicket $ticket): View
     {
         $ticket->load('comments');
+
         return view('helpdesk::legacy.show', compact('ticket'));
     }
 

Modules/Helpdesk/Livewire/ArchivedTicketIndex.php

@@ -26,8 +26,11 @@ final class ArchivedTicketIndex extends Component
     public string $search = '';
 
     public bool $deleteModalOpen = false;
+
     public ?int $pendingDeleteTicketId = null;
+
     public ?string $pendingDeleteTicketReference = null;
+
     public ?string $pendingDeleteTicketSubject = null;
 
     public function updatedSearch(): void
@@ -75,6 +78,7 @@ final class ArchivedTicketIndex extends Component
     {
         if ($this->pendingDeleteTicketId === null) {
             $this->resetDeleteState();
+
             return;
         }
 

Modules/Helpdesk/Livewire/HelpdeskDashboardWidget.php

@@ -17,7 +17,9 @@ final class HelpdeskDashboardWidget extends Component
 
     public function updatedDays(): void
     {
-        if (! in_array($this->days, [7, 14, 30], true)) $this->days = 7;
+        if (! in_array($this->days, [7, 14, 30], true)) {
+            $this->days = 7;
+        }
     }
 
     public function render(): View
@@ -33,6 +35,7 @@ final class HelpdeskDashboardWidget extends Component
         $trendRows = (clone $base)->where('created_at', '>=', now()->subDays($this->days - 1)->startOfDay())->get(['created_at', 'completed_at']);
         $trend = collect($period)->map(function ($date) use ($trendRows): array {
             $day = $date->toDateString();
+
             return [
                 'label' => $date->format('M j'),
                 'created' => $trendRows->filter(fn ($ticket) => optional($ticket->created_at)->toDateString() === $day)->count(),

Modules/Helpdesk/Livewire/SettingsManager.php

@@ -39,17 +39,29 @@ final class SettingsManager extends Component
     public bool $teamModalOpen = false;
 
     public bool $statusModalOpen = false;
+
     public bool $priorityModalOpen = false;
+
     public bool $categoryModalOpen = false;
+
     public bool $projectModalOpen = false;
+
     public bool $boardModalOpen = false;
+
     public bool $repositoryModalOpen = false;
+
     public bool $workflowModalOpen = false;
+
     public bool $cannedModalOpen = false;
+
     public bool $slaModalOpen = false;
+
     public bool $automationModalOpen = false;
+
     public bool $checklistModalOpen = false;
+
     public bool $tagModalOpen = false;
+
     public bool $productModalOpen = false;
 
     /** @var array<string, mixed> */

Modules/Helpdesk/Models/LegacyCategory.php

@@ -9,5 +9,6 @@ use Illuminate\Database\Eloquent\Model;
 final class LegacyCategory extends Model
 {
     protected $table = 'helpdesk_legacy_categories';
+
     protected $guarded = [];
 }

Modules/Helpdesk/Models/LegacyComment.php

@@ -9,6 +9,8 @@ use Illuminate\Database\Eloquent\Model;
 final class LegacyComment extends Model
 {
     protected $table = 'helpdesk_legacy_comments';
+
     protected $guarded = [];
+
     protected $casts = ['legacy_created_at' => 'datetime', 'legacy_updated_at' => 'datetime'];
 }

Modules/Helpdesk/Models/LegacyTicket.php

@@ -10,7 +10,9 @@ use Illuminate\Database\Eloquent\Relations\HasMany;
 final class LegacyTicket extends Model
 {
     protected $table = 'helpdesk_legacy_tickets';
+
     protected $guarded = [];
+
     protected $casts = ['legacy_data' => 'array', 'legacy_created_at' => 'datetime', 'legacy_updated_at' => 'datetime', 'completed_at' => 'datetime', 'archived_at' => 'datetime'];
 
     public function comments(): HasMany

Modules/Helpdesk/Models/Team.php

@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace Modules\Helpdesk\Models;
 
 use App\Models\User;
-
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;

Modules/Helpdesk/Models/Ticket.php

@@ -62,7 +62,6 @@ final class Ticket extends Model
         return $this->belongsTo(User::class, 'user_id');
     }
 
-
     /**
      * Compatibility alias for the requester.
      *

Modules/Helpdesk/Services/HelpdeskSyncService.php

@@ -11,7 +11,6 @@ use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Facades\Storage;
 use Illuminate\Support\Str;
 use RuntimeException;
-use Throwable;
 
 final class HelpdeskSyncService
 {

Modules/UserManagement/Http/Controllers/UserController.php

@@ -120,7 +120,7 @@ final class UserController extends Controller
     public function createRole(): View
     {
         return view('modules.user-management.role-form', [
-            'role' => new Role(),
+            'role' => new Role,
             'permissions' => Permission::query()->orderBy('name')->get(),
         ]);
     }
@@ -165,7 +165,7 @@ final class UserController extends Controller
 
     public function createPermission(): View
     {
-        return view('modules.user-management.permission-form', ['permission' => new Permission()]);
+        return view('modules.user-management.permission-form', ['permission' => new Permission]);
     }
 
     public function storePermission(Request $request): RedirectResponse

app/Livewire/Settings/Appearance.php

@@ -18,5 +18,4 @@ class Appearance extends Component
             resource_path('themes/backend/views/livewire/settings/appearance.blade.php')
         );
     }
-
 }

app/Livewire/Settings/DeleteUserForm.php

@@ -2,9 +2,9 @@
 
 namespace App\Livewire\Settings;
 
-use Illuminate\Contracts\View\View;
 use App\Concerns\PasswordValidationRules;
 use App\Livewire\Actions\Logout;
+use Illuminate\Contracts\View\View;
 use Illuminate\Support\Facades\Auth;
 use Livewire\Component;
 
@@ -27,11 +27,11 @@ class DeleteUserForm extends Component
 
         $this->redirect('/', navigate: true);
     }
+
     public function render(): View
     {
         return view()->file(
             resource_path('themes/backend/views/livewire/settings/delete-user-form.blade.php')
         );
     }
-
 }

app/Livewire/Settings/Profile.php

@@ -2,13 +2,13 @@
 
 namespace App\Livewire\Settings;
 
-use Illuminate\Contracts\View\View;
 use App\Concerns\ProfileValidationRules;
 use Flux\Flux;
 use Illuminate\Contracts\Auth\MustVerifyEmail;
+use Illuminate\Contracts\View\View;
 use Illuminate\Support\Facades\Auth;
-use Livewire\Attributes\Layout;
 use Livewire\Attributes\Computed;
+use Livewire\Attributes\Layout;
 use Livewire\Attributes\Title;
 use Livewire\Component;
 
@@ -83,6 +83,7 @@ class Profile extends Component
 
         return ! $user instanceof MustVerifyEmail || $user->hasVerifiedEmail();
     }
+
     #[Layout('layouts.app')]
     public function render(): View
     {
@@ -90,5 +91,4 @@ class Profile extends Component
             resource_path('themes/backend/views/livewire/settings/profile.blade.php')
         );
     }
-
 }

app/Livewire/Settings/Security.php

@@ -2,10 +2,10 @@
 
 namespace App\Livewire\Settings;
 
-use Illuminate\Contracts\View\View;
 use App\Concerns\PasswordValidationRules;
 use Exception;
 use Flux\Flux;
+use Illuminate\Contracts\View\View;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Validation\ValidationException;
 use Laravel\Fortify\Actions\ConfirmTwoFactorAuthentication;
@@ -14,8 +14,8 @@ use Laravel\Fortify\Actions\EnableTwoFactorAuthentication;
 use Laravel\Fortify\Features;
 use Laravel\Fortify\Fortify;
 use Laravel\Passkeys\Actions\DeletePasskey;
-use Livewire\Attributes\Layout;
 use Livewire\Attributes\Computed;
+use Livewire\Attributes\Layout;
 use Livewire\Attributes\Locked;
 use Livewire\Attributes\Title;
 use Livewire\Attributes\Validate;
@@ -311,6 +311,7 @@ class Security extends Component
             'buttonText' => __('Continue'),
         ];
     }
+
     #[Layout('layouts.app')]
     public function render(): View
     {
@@ -318,5 +319,4 @@ class Security extends Component
             resource_path('themes/backend/views/livewire/settings/security.blade.php')
         );
     }
-
 }

app/Livewire/Settings/TwoFactor/RecoveryCodes.php

@@ -2,8 +2,8 @@
 
 namespace App\Livewire\Settings\TwoFactor;
 
-use Illuminate\Contracts\View\View;
 use Exception;
+use Illuminate\Contracts\View\View;
 use Laravel\Fortify\Actions\GenerateNewRecoveryCodes;
 use Livewire\Attributes\Locked;
 use Livewire\Component;
@@ -49,11 +49,11 @@ class RecoveryCodes extends Component
             }
         }
     }
+
     public function render(): View
     {
         return view()->file(
             resource_path('themes/backend/views/livewire/settings/two-factor/recovery-codes.blade.php')
         );
     }
-
 }

app/Models/User.php

@@ -6,6 +6,7 @@ use Database\Factories\UserFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Attributes\Hidden;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Illuminate\Support\Carbon;
@@ -14,7 +15,6 @@ use Laravel\Fortify\Contracts\PasskeyUser;
 use Laravel\Fortify\PasskeyAuthenticatable;
 use Laravel\Fortify\TwoFactorAuthenticatable;
 use Modules\UserManagement\Models\Role;
-use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 
 /**
  * @property int $id
@@ -50,8 +50,6 @@ class User extends Authenticatable implements PasskeyUser
             : $initials;
     }
 
-
-
     public function gravatarUrl(int $size = 160): string
     {
         $email = strtolower(trim((string) $this->email));

deploy.php

@@ -34,7 +34,6 @@ host('mpba')
     ->set('branch', 'main')
     ->set('deploy_path', '/var/www/helpdesk_mpba');
 
-
 /*
  * Install the root npm tree, then every module that owns its own lock file,
  * then run ONE root Vite build. Because Vite is compiling a module source file,