new helpdesk module

2026-06-12 09:41:57 +01:00
parent 67c9bb22d9
commit da35c7eb95
50 changed files with 1874 additions and 270 deletions
@@ -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');
+    }
+}