Add in-app Ladill Queue integration for service queue consoles.

Settings toggle provisions Queue org via API; reception can call tickets from Frontdesk.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Http/Controllers/Frontdesk/ServiceQueueController.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace App\Http\Controllers\Frontdesk;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Frontdesk\Concerns\ScopesToAccount;
+use App\Models\Branch;
+use App\Services\Queue\QueueClient;
+use Illuminate\Http\Client\RequestException;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class ServiceQueueController extends Controller
+{
+    use ScopesToAccount;
+
+    public function index(Request $request, QueueClient $queue): View|RedirectResponse
+    {
+        $this->authorizeAbility($request, 'service_queues.console');
+        $organization = $this->organization($request);
+
+        if (! $this->integrationEnabled($organization)) {
+            return redirect()->route('frontdesk.settings')->with('error', 'Enable Ladill Queue integration in settings first.');
+        }
+
+        $owner = $this->ownerRef($request);
+
+        try {
+            $counters = $queue->counters($owner);
+        } catch (RequestException) {
+            return redirect()->route('frontdesk.settings')->with('error', 'Could not reach Ladill Queue. Enable Frontdesk integration in Queue settings and verify API keys.');
+        }
+
+        return view('frontdesk.service-queues.index', compact('counters', 'organization'));
+    }
+
+    public function console(Request $request, string $counterUuid, QueueClient $queue): View|RedirectResponse
+    {
+        $this->authorizeAbility($request, 'service_queues.console');
+        $organization = $this->organization($request);
+        $owner = $this->ownerRef($request);
+
+        if (! $this->integrationEnabled($organization)) {
+            return redirect()->route('frontdesk.settings');
+        }
+
+        try {
+            $state = $queue->console($owner, $counterUuid);
+        } catch (RequestException) {
+            return redirect()->route('frontdesk.service-queues.index')->with('error', 'Counter console unavailable.');
+        }
+
+        return view('frontdesk.service-queues.console', [
+            'state' => $state,
+            'counterUuid' => $counterUuid,
+            'organization' => $organization,
+        ]);
+    }
+
+    public function action(Request $request, string $counterUuid, QueueClient $queue): RedirectResponse
+    {
+        $this->authorizeAbility($request, 'service_queues.console');
+        $owner = $this->ownerRef($request);
+
+        $validated = $request->validate([
+            'action' => ['required', 'string'],
+            'queue_uuid' => ['nullable', 'uuid'],
+            'ticket_uuid' => ['nullable', 'uuid'],
+            'to_queue_uuid' => ['nullable', 'uuid'],
+            'reason' => ['nullable', 'string', 'max:500'],
+        ]);
+
+        try {
+            $queue->consoleAction($owner, $counterUuid, $validated);
+        } catch (RequestException) {
+            return back()->with('error', 'Queue action failed. Try again.');
+        }
+
+        return back()->with('success', 'Queue updated.');
+    }
+
+    protected function integrationEnabled(\App\Models\Organization $organization): bool
+    {
+        return (bool) data_get($organization->settings, 'queue_integration_enabled', false);
+    }
+}

app/Http/Controllers/Frontdesk/SettingsController.php

@@ -9,6 +9,7 @@ use App\Services\Frontdesk\FrontdeskPermissions;
 use App\Services\Frontdesk\NotificationPricingService;
 use App\Services\Frontdesk\NotificationUsageService;
 use App\Services\Frontdesk\PlanService;
+use App\Services\Queue\QueueClient;
 use App\Support\OrganizationBranding;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -52,10 +53,11 @@ class SettingsController extends Controller
         ]);
     }
 
-    public function update(Request $request): RedirectResponse
+    public function update(Request $request, QueueClient $queue): RedirectResponse
     {
         $this->authorizeAbility($request, 'settings.manage');
         $organization = $this->organization($request);
+        $owner = $this->ownerRef($request);
 
         $validated = $request->validate([
             'name' => ['required', 'string', 'max:255'],
@@ -71,10 +73,24 @@ class SettingsController extends Controller
             'logo' => ['nullable', 'image', 'mimes:jpeg,png,jpg,webp,svg', 'max:2048'],
             'remove_logo' => ['nullable', 'boolean'],
             'employee_kiosk_enabled' => ['nullable', 'boolean'],
+            'queue_integration_enabled' => ['nullable', 'boolean'],
         ]);
 
         $settings = $organization->settings ?? [];
         $settings['onboarded'] = true;
+
+        $wantsQueue = $request->boolean('queue_integration_enabled');
+        $hadQueue = (bool) data_get($settings, 'queue_integration_enabled', false);
+        $settings['queue_integration_enabled'] = $wantsQueue;
+
+        if ($wantsQueue && ! $hadQueue && $queue->configured()) {
+            $branch = Branch::owned($owner)->where('organization_id', $organization->id)->orderBy('name')->first();
+            try {
+                $queue->enable($owner, $organization->name, $branch?->name);
+            } catch (\Throwable) {
+                return back()->withInput()->with('error', 'Could not provision Ladill Queue for this account. Ensure Queue API keys are configured and Queue allows Frontdesk integration.');
+            }
+        }
         $settings['badge_expiry_hours'] = $validated['badge_expiry_hours'];
         $settings['kiosk_reset_seconds'] = $validated['kiosk_reset_seconds'];
         $settings['visitor_policy'] = $validated['visitor_policy'] ?? null;