new helpdesk module

Modules/Helpdesk/Livewire/TicketIndex.php

@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Livewire;
+
+use Illuminate\Contracts\View\View;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Facades\Auth;
+use Livewire\Attributes\Url;
+use Livewire\Component;
+use Livewire\WithPagination;
+use Modules\Helpdesk\Models\Priority;
+use Modules\Helpdesk\Models\Status;
+use Modules\Helpdesk\Models\Ticket;
+
+final class TicketIndex extends Component
+{
+    use WithPagination;
+
+    #[Url]
+    public string $search = '';
+
+    #[Url]
+    public string $status = '';
+
+    #[Url]
+    public string $priority = '';
+
+    #[Url]
+    public string $scope = 'open';
+
+    /**
+     * Reset pagination when filters change.
+     *
+     * @return void
+     */
+    public function updated(): void
+    {
+        $this->resetPage();
+    }
+
+    /**
+     * Render the ticket list.
+     *
+     * @return View
+     */
+    public function render(): View
+    {
+        return view('helpdesk::livewire.ticket-index', [
+            'tickets' => $this->tickets(),
+            'statuses' => Status::query()->orderBy('sort_order')->get(),
+            'priorities' => Priority::query()->orderBy('sort_order')->get(),
+        ])->layout('layouts.app');
+    }
+
+    /**
+     * Build paginated ticket results.
+     *
+     * @return LengthAwarePaginator<int, Ticket>
+     */
+    private function tickets(): LengthAwarePaginator
+    {
+        $user = Auth::user();
+
+        return Ticket::query()
+            ->with(['owner', 'agent', 'status', 'priority', 'category', 'project'])
+            ->visibleTo($user)
+            ->when($this->scope === 'open', static fn (Builder $query): Builder => $query->whereNull('completed_at'))
+            ->when($this->scope === 'closed', static fn (Builder $query): Builder => $query->whereNotNull('completed_at'))
+            ->when($this->status !== '', fn (Builder $query): Builder => $query->where('status_id', (int) $this->status))
+            ->when($this->priority !== '', fn (Builder $query): Builder => $query->where('priority_id', (int) $this->priority))
+            ->when($this->search !== '', function (Builder $query): Builder {
+                return $query->where(static function (Builder $subQuery): void {
+                    $subQuery->where('reference', 'like', '%' . $this->search . '%')
+                        ->orWhere('subject', 'like', '%' . $this->search . '%')
+                        ->orWhere('body', 'like', '%' . $this->search . '%');
+                });
+            })
+            ->latest('last_activity_at')
+            ->paginate(15);
+    }
+}