Initial Ladill Queue release — enterprise QMS standalone app.

Phases 1–6: tickets, counters, displays, appointments, workflows, rules, analytics, reports, feedback, admin, device API, and Gitea deploy workflow for queue.ladill.com. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-29 20:19:52 +00:00
commit cca98eefd2
297 changed files with 27263 additions and 0 deletions
@@ -0,0 +1,129 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Api\Concerns\ScopesApiToAccount;
+use App\Http\Controllers\Controller;
+use App\Models\ServiceQueue;
+use App\Models\Ticket;
+use App\Services\Qms\QueueEngine;
+use App\Services\Qms\TicketPresenter;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class TicketController extends Controller
+{
+    use ScopesApiToAccount;
+
+    public function __construct(
+        protected QueueEngine $engine,
+    ) {}
+
+    public function index(Request $request): JsonResponse
+    {
+        $this->authorizeAbility($request, 'tickets.view');
+        $owner = $this->ownerRef($request);
+        $organization = $this->organization($request);
+
+        $tickets = Ticket::owned($owner)
+            ->where('organization_id', $organization->id)
+            ->when($request->query('queue'), fn ($q, $uuid) => $q->whereHas('serviceQueue', fn ($sq) => $sq->where('uuid', $uuid)))
+            ->when($request->query('status'), fn ($q, $status) => $q->where('status', $status))
+            ->with(['serviceQueue', 'counter'])
+            ->latest('issued_at')
+            ->paginate(50);
+
+        return response()->json([
+            'data' => $tickets->getCollection()->map(fn (Ticket $t) => TicketPresenter::toArray($t)),
+            'meta' => [
+                'current_page' => $tickets->currentPage(),
+                'last_page' => $tickets->lastPage(),
+                'total' => $tickets->total(),
+            ],
+        ]);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $this->authorizeAbility($request, 'tickets.issue');
+        $owner = $this->ownerRef($request);
+
+        $validated = $request->validate([
+            'service_queue_id' => ['required', 'uuid'],
+            'customer_name' => ['nullable', 'string', 'max:255'],
+            'customer_phone' => ['nullable', 'string', 'max:50'],
+            'customer_email' => ['nullable', 'email', 'max:255'],
+            'priority' => ['nullable', 'string', 'in:'.implode(',', array_keys(config('qms.ticket_priorities')))],
+            'source' => ['nullable', 'string', 'in:'.implode(',', array_keys(config('qms.ticket_sources')))],
+        ]);
+
+        $queue = ServiceQueue::where('uuid', $validated['service_queue_id'])->firstOrFail();
+        $this->authorizeOwner($request, $queue);
+
+        $ticket = $this->engine->issueTicket($queue, $owner, [
+            ...$validated,
+            'source' => $validated['source'] ?? 'api',
+            'actor_ref' => $owner,
+        ]);
+
+        return response()->json(['data' => TicketPresenter::toArray($ticket)], 201);
+    }
+
+    public function show(Request $request, Ticket $ticket): JsonResponse
+    {
+        $this->authorizeAbility($request, 'tickets.view');
+        $this->authorizeOwner($request, $ticket);
+
+        return response()->json(['data' => TicketPresenter::toArray($ticket->load(['serviceQueue', 'counter']))]);
+    }
+
+    public function callNext(Request $request, ServiceQueue $serviceQueue): JsonResponse
+    {
+        $this->authorizeAbility($request, 'console.use');
+        $this->authorizeOwner($request, $serviceQueue);
+
+        $validated = $request->validate([
+            'counter_id' => ['required', 'uuid'],
+        ]);
+
+        $counter = \App\Models\Counter::where('uuid', $validated['counter_id'])->firstOrFail();
+        $this->authorizeOwner($request, $counter);
+
+        $ticket = $this->engine->callNext($serviceQueue, $counter, $this->ownerRef($request));
+
+        return response()->json(['data' => $ticket ? TicketPresenter::toArray($ticket) : null]);
+    }
+
+    public function action(Request $request, Ticket $ticket): JsonResponse
+    {
+        $this->authorizeAbility($request, 'tickets.manage');
+        $this->authorizeOwner($request, $ticket);
+        $actor = $this->ownerRef($request);
+
+        $validated = $request->validate([
+            'action' => ['required', 'string', 'in:recall,start,hold,skip,complete,no_show,cancel,delay'],
+            'minutes' => ['nullable', 'integer', 'min:5', 'max:120'],
+            'to_queue_id' => ['nullable', 'uuid'],
+            'reason' => ['nullable', 'string', 'max:500'],
+        ]);
+
+        $result = match ($validated['action']) {
+            'recall' => $this->engine->recall($ticket, $actor),
+            'start' => $this->engine->startServing($ticket, $actor),
+            'hold' => $this->engine->hold($ticket, $actor),
+            'skip' => $this->engine->skip($ticket, $actor),
+            'complete' => $this->engine->completeTicket($ticket, $actor),
+            'no_show' => $this->engine->markNoShow($ticket, $actor),
+            'cancel' => $this->engine->cancel($ticket, $actor),
+            'delay' => $this->engine->delayArrival($ticket, (int) ($validated['minutes'] ?? 15), $actor),
+            default => $ticket,
+        };
+
+        if ($validated['action'] === 'transfer' && ! empty($validated['to_queue_id'])) {
+            $toQueue = ServiceQueue::where('uuid', $validated['to_queue_id'])->firstOrFail();
+            $result = $this->engine->transfer($ticket, $toQueue, null, $validated['reason'] ?? null, $actor);
+        }
+
+        return response()->json(['data' => TicketPresenter::toArray($result->load(['serviceQueue', 'counter']))]);
+    }
+}