new helpdesk module

Modules/Helpdesk/Livewire/HelpdeskDashboardWidget.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Livewire;
+
+use Illuminate\Contracts\View\View;
+use Illuminate\Support\Facades\Auth;
+use Livewire\Component;
+use Modules\Helpdesk\Models\Ticket;
+
+final class HelpdeskDashboardWidget extends Component
+{
+    /** @return View */
+    public function render(): View
+    {
+        $user = Auth::user();
+
+        $base = Ticket::query()->visibleTo($user);
+
+        return view('helpdesk::livewire.dashboard-widget', [
+            'openCount' => (clone $base)->whereNull('completed_at')->count(),
+            'closedCount' => (clone $base)->whereNotNull('completed_at')->count(),
+            'criticalCount' => (clone $base)->whereNull('completed_at')->whereHas('priority', static fn ($q) => $q->where('slug', 'critical'))->count(),
+            'recentTickets' => (clone $base)->with(['status', 'priority'])->latest('last_activity_at')->limit(5)->get(),
+        ]);
+    }
+}

Modules/Helpdesk/Livewire/TicketCreate.php

@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Livewire;
+
+use Illuminate\Contracts\View\View;
+use Illuminate\Support\Facades\Auth;
+use Livewire\Attributes\Validate;
+use Livewire\Component;
+use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
+use Livewire\WithFileUploads;
+use Modules\Helpdesk\Models\Category;
+use Modules\Helpdesk\Models\Priority;
+use Modules\Helpdesk\Models\Project;
+use Modules\Helpdesk\Services\TicketService;
+
+final class TicketCreate extends Component
+{
+    use WithFileUploads;
+
+    #[Validate('required|string|max:200')]
+    public string $subject = '';
+
+    #[Validate('required|string|min:10')]
+    public string $body = '';
+
+    #[Validate('required|integer|exists:helpdesk_priorities,id')]
+    public ?int $priority_id = null;
+
+    #[Validate('nullable|integer|exists:helpdesk_categories,id')]
+    public ?int $category_id = null;
+
+    #[Validate('nullable|integer|exists:helpdesk_projects,id')]
+    public ?int $project_id = null;
+
+    #[Validate('nullable|date')]
+    public ?string $due_at = null;
+
+    /** @var array<int, TemporaryUploadedFile> */
+    #[Validate('array')]
+    public array $attachments = [];
+
+    /**
+     * Store a new helpdesk ticket.
+     *
+     * @param TicketService $tickets
+     * @return mixed
+     */
+    public function save(TicketService $tickets): mixed
+    {
+        $this->validate([
+            'attachments.*' => 'file|max:' . config('helpdesk.max_upload_kb') . '|mimes:' . implode(',', config('helpdesk.allowed_mimes')),
+        ]);
+
+        $ticket = $tickets->create(Auth::user(), [
+            'subject' => $this->subject,
+            'body' => $this->body,
+            'priority_id' => $this->priority_id,
+            'category_id' => $this->category_id,
+            'project_id' => $this->project_id,
+            'due_at' => $this->due_at,
+        ], $this->attachments);
+
+        session()->flash('success', 'Ticket ' . $ticket->reference . ' has been created.');
+
+        return $this->redirectRoute('helpdesk.tickets.show', $ticket, navigate: true);
+    }
+
+    /** @return View */
+    public function render(): View
+    {
+        return view('helpdesk::livewire.ticket-create', [
+            'priorities' => Priority::query()->orderBy('sort_order')->get(),
+            'categories' => Category::query()->orderBy('name')->get(),
+            'projects' => Project::query()->whereNull('archived_at')->orderBy('title')->get(),
+        ])->layout('layouts.app');
+    }
+}

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);
+    }
+}

Modules/Helpdesk/Livewire/TicketShow.php

@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Helpdesk\Livewire;
+
+use Illuminate\Contracts\View\View;
+use Illuminate\Support\Facades\Auth;
+use Livewire\Attributes\Validate;
+use Livewire\Component;
+use Livewire\Features\SupportFileUploads\TemporaryUploadedFile;
+use Livewire\WithFileUploads;
+use Modules\Helpdesk\Models\Status;
+use Modules\Helpdesk\Models\Ticket;
+use Modules\Helpdesk\Services\TicketService;
+
+final class TicketShow extends Component
+{
+    use WithFileUploads;
+
+    public Ticket $ticket;
+
+    #[Validate('required|string|min:2')]
+    public string $commentBody = '';
+
+    public bool $internal = false;
+
+    /** @var array<int, TemporaryUploadedFile> */
+    public array $attachments = [];
+
+    public ?int $status_id = null;
+
+    /**
+     * Mount the component.
+     *
+     * @param Ticket $ticket
+     * @return void
+     */
+    public function mount(Ticket $ticket): void
+    {
+        $this->authorize('view', $ticket);
+        $this->ticket = $ticket->load(['owner', 'agent', 'status', 'priority', 'category', 'project', 'attachments.user']);
+        $this->status_id = $this->ticket->status_id;
+    }
+
+    /**
+     * Add a comment to the ticket.
+     *
+     * @param TicketService $tickets
+     * @return void
+     */
+    public function addComment(TicketService $tickets): void
+    {
+        $this->authorize('comment', $this->ticket);
+
+        $this->validate([
+            'commentBody' => ['required', 'string', 'min:2'],
+            'attachments.*' => 'file|max:' . config('helpdesk.max_upload_kb') . '|mimes:' . implode(',', config('helpdesk.allowed_mimes')),
+        ]);
+
+        $tickets->comment($this->ticket, Auth::user(), $this->commentBody, $this->internal, $this->attachments);
+
+        $this->reset(['commentBody', 'internal', 'attachments']);
+        $this->ticket = $this->ticket->fresh(['owner', 'agent', 'status', 'priority', 'category', 'project', 'comments.user', 'comments.attachments', 'attachments.user']);
+        $this->dispatch('helpdesk-comment-added');
+    }
+
+    /**
+     * Update status using Livewire AJAX.
+     *
+     * @return void
+     */
+    public function updateStatus(): void
+    {
+        $this->authorize('update', $this->ticket);
+        $this->validate(['status_id' => ['required', 'integer', 'exists:helpdesk_statuses,id']]);
+
+        $status = Status::query()->findOrFail($this->status_id);
+        $this->ticket->forceFill([
+            'status_id' => $status->id,
+            'completed_at' => $status->is_closed ? now() : null,
+            'last_activity_at' => now(),
+        ])->save();
+
+        $this->ticket = $this->ticket->fresh(['owner', 'agent', 'status', 'priority', 'category', 'project', 'comments.user', 'comments.attachments', 'attachments.user']);
+        $this->dispatch('helpdesk-status-updated');
+    }
+
+    /** @return View */
+    public function render(): View
+    {
+        return view('helpdesk::livewire.ticket-show', [
+            'statuses' => Status::query()->orderBy('sort_order')->get(),
+        ])->layout('layouts.app');
+    }
+}