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>

.env.example

@@ -23,6 +23,10 @@ SESSION_LIFETIME=1440
 CACHE_STORE=database
 QUEUE_CONNECTION=database
 
+# Ladill Queue service API (in-app service queue console)
+QUEUE_API_URL=https://queue.ladill.com/api/v1
+QUEUE_API_KEY_FRONTDESK=
+
 # --- Ladill SSO (Sign in with Ladill — auth.ladill.com OIDC client) ---
 LADILL_SSO_CLIENT_ID=
 LADILL_SSO_CLIENT_SECRET=

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;

app/Services/Frontdesk/FrontdeskPermissions.php

@@ -17,10 +17,12 @@ class FrontdeskPermissions
             'settings.view', 'admin.branches.view', 'admin.desks.view', 'admin.desks.manage',
             'watchlist.view', 'watchlist.manage', 'audit.view', 'audit.export',
             'devices.view', 'devices.manage', 'reports.view', 'reports.export',
+            'service_queues.console',
         ],
         'receptionist' => [
             'dashboard.view', 'visits.view', 'visits.manage', 'visitors.view', 'visitors.manage',
             'hosts.view', 'employees.view', 'kiosk.use', 'watchlist.view', 'devices.view',
+            'service_queues.console',
         ],
         'security_officer' => [
             'dashboard.view', 'visits.view', 'visitors.view', 'employees.view',

app/Services/Queue/QueueClient.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Services\Queue;
+
+use Illuminate\Http\Client\RequestException;
+use Illuminate\Support\Facades\Http;
+
+class QueueClient
+{
+    private function base(): string
+    {
+        return rtrim((string) config('frontdesk.queue.api_url'), '/');
+    }
+
+    private function token(): string
+    {
+        return (string) (config('frontdesk.queue.api_key') ?? '');
+    }
+
+    private function http(string $owner)
+    {
+        return Http::withToken($this->token())
+            ->acceptJson()
+            ->timeout(12)
+            ->withQueryParameters(['owner' => $owner]);
+    }
+
+    public function configured(): bool
+    {
+        return $this->token() !== '' && $this->base() !== '';
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function status(string $owner): array
+    {
+        $response = $this->http($owner)->get($this->base().'/integrations/status');
+        $response->throw();
+
+        return (array) ($response->json('data') ?? []);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function enable(string $owner, string $organizationName, ?string $branchName = null): array
+    {
+        $response = $this->http($owner)->post($this->base().'/integrations/provision', array_filter([
+            'organization_name' => $organizationName,
+            'branch_name' => $branchName,
+            'industry' => 'visitor',
+        ]));
+        $response->throw();
+
+        return (array) ($response->json('data') ?? []);
+    }
+
+    public function isLinked(string $owner): bool
+    {
+        if (! $this->configured()) {
+            return false;
+        }
+
+        try {
+            $status = $this->status($owner);
+
+            return (bool) ($status['provisioned'] ?? false)
+                && (bool) data_get($status, 'integrations.frontdesk', false);
+        } catch (RequestException) {
+            return false;
+        }
+    }
+
+    /**
+     * @return list<array<string, mixed>>
+     */
+    public function counters(string $owner): array
+    {
+        $response = $this->http($owner)->get($this->base().'/counters');
+        $response->throw();
+
+        return (array) ($response->json('data') ?? []);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function console(string $owner, string $counterUuid): array
+    {
+        $response = $this->http($owner)->get($this->base().'/counters/'.$counterUuid.'/console');
+        $response->throw();
+
+        return (array) ($response->json('data') ?? []);
+    }
+
+    /**
+     * @param  array<string, mixed>  $payload
+     */
+    public function consoleAction(string $owner, string $counterUuid, array $payload): void
+    {
+        $this->http($owner)->post($this->base().'/counters/'.$counterUuid.'/console', $payload)->throw();
+    }
+}

config/frontdesk.php

@@ -236,6 +236,12 @@ return [
         'lab' => 'Ladill Lab',
         'pos' => 'Ladill POS',
         'crm' => 'Ladill CRM',
+        'queue' => 'Ladill Queue',
+    ],
+
+    'queue' => [
+        'api_url' => env('QUEUE_API_URL', 'https://queue.ladill.com/api/v1'),
+        'api_key' => env('QUEUE_API_KEY_FRONTDESK'),
     ],
 
     'printers' => [

resources/views/frontdesk/service-queues/console.blade.php

@@ -0,0 +1,97 @@
+@php
+  $counter = $state['counter'] ?? [];
+  $current = $state['current_ticket'] ?? null;
+  $queues = $state['queues'] ?? [];
+  $waiting = $state['waiting_by_queue'] ?? [];
+  $transferQueues = $state['transfer_queues'] ?? [];
+@endphp
+
+<x-app-layout title="Console · {{ $counter['name'] ?? 'Counter' }}">
+  <div class="flex flex-wrap items-start justify-between gap-4">
+    <div>
+      <a href="{{ route('frontdesk.service-queues.index') }}" class="text-sm font-medium text-indigo-600">← Service queues</a>
+      <h1 class="mt-2 text-xl font-semibold text-slate-900">{{ $counter['name'] ?? 'Counter' }}</h1>
+      <p class="mt-1 text-sm text-slate-500">{{ $counter['branch'] ?? '' }} · Ladill Queue console</p>
+    </div>
+    <div class="flex gap-2">
+      <form method="POST" action="{{ route('frontdesk.service-queues.action', $counterUuid) }}">@csrf<input type="hidden" name="action" value="available"><button class="btn-secondary text-sm">Available</button></form>
+      <form method="POST" action="{{ route('frontdesk.service-queues.action', $counterUuid) }}">@csrf<input type="hidden" name="action" value="offline"><button class="btn-secondary text-sm">Offline</button></form>
+    </div>
+  </div>
+
+  @if ($current)
+    <section class="mt-6 overflow-hidden rounded-2xl border border-indigo-200 bg-gradient-to-br from-indigo-50 via-white to-white shadow-sm">
+      <div class="border-b border-indigo-100 px-6 py-4">
+        <p class="text-xs font-semibold uppercase tracking-wider text-indigo-600">Current customer</p>
+      </div>
+      <div class="px-6 py-5">
+        <p class="text-5xl font-bold tracking-tight text-slate-900">{{ $current['ticket_number'] }}</p>
+        <p class="mt-2 text-sm text-slate-600">{{ $current['queue']['name'] ?? '' }}</p>
+        <p class="mt-1 font-medium text-slate-800">{{ $current['customer_name'] ?? 'Walk-in customer' }}</p>
+        <div class="mt-6 grid gap-2 sm:grid-cols-2 lg:grid-cols-3">
+          @foreach ([
+            'recall' => 'Recall',
+            'start' => 'Start serving',
+            'hold' => 'Hold',
+            'skip' => 'Skip',
+            'complete' => 'Complete',
+            'no_show' => 'No show',
+          ] as $action => $label)
+            <form method="POST" action="{{ route('frontdesk.service-queues.action', $counterUuid) }}">
+              @csrf
+              <input type="hidden" name="action" value="{{ $action }}">
+              <input type="hidden" name="ticket_uuid" value="{{ $current['uuid'] }}">
+              <button type="submit" class="btn-secondary w-full text-sm">{{ $label }}</button>
+            </form>
+          @endforeach
+        </div>
+        @if (count($transferQueues) > 1)
+          <form method="POST" action="{{ route('frontdesk.service-queues.action', $counterUuid) }}" class="mt-4 flex flex-wrap items-end gap-2 border-t border-indigo-100 pt-4">
+            @csrf
+            <input type="hidden" name="action" value="transfer">
+            <input type="hidden" name="ticket_uuid" value="{{ $current['uuid'] }}">
+            <select name="to_queue_uuid" class="rounded-lg border-slate-300 text-sm">
+              @foreach ($transferQueues as $q)
+                @if (($q['uuid'] ?? '') !== ($current['queue']['uuid'] ?? ''))
+                  <option value="{{ $q['uuid'] }}">{{ $q['name'] }}</option>
+                @endif
+              @endforeach
+            </select>
+            <input type="text" name="reason" placeholder="Reason" class="rounded-lg border-slate-300 text-sm">
+            <button type="submit" class="btn-secondary text-sm">Transfer</button>
+          </form>
+        @endif
+      </div>
+    </section>
+  @else
+    <section class="mt-6 rounded-2xl border border-dashed border-slate-300 bg-slate-50 px-6 py-10 text-center text-sm text-slate-600">
+      No active customer — call the next ticket from a queue below.
+    </section>
+  @endif
+
+  <div class="mt-6 grid gap-4 lg:grid-cols-2">
+    @foreach ($queues as $queue)
+      <section class="rounded-2xl border border-slate-200 bg-white shadow-sm">
+        <div class="flex items-center justify-between border-b border-slate-100 px-5 py-4">
+          <h2 class="font-semibold text-slate-900">{{ $queue['name'] }}</h2>
+          <form method="POST" action="{{ route('frontdesk.service-queues.action', $counterUuid) }}">
+            @csrf
+            <input type="hidden" name="action" value="call_next">
+            <input type="hidden" name="queue_uuid" value="{{ $queue['uuid'] }}">
+            <button type="submit" class="btn-primary text-sm">Call next</button>
+          </form>
+        </div>
+        <ul class="divide-y divide-slate-50 px-2 py-2">
+          @forelse ($waiting[$queue['uuid']] ?? [] as $ticket)
+            <li class="flex items-center justify-between px-3 py-2.5 text-sm">
+              <span class="font-mono font-semibold">{{ $ticket['ticket_number'] }}</span>
+              <span class="text-slate-500">{{ $ticket['customer_name'] ?? 'Walk-in' }}</span>
+            </li>
+          @empty
+            <li class="px-3 py-6 text-center text-sm text-slate-500">Queue is empty</li>
+          @endforelse
+        </ul>
+      </section>
+    @endforeach
+  </div>
+</x-app-layout>

resources/views/frontdesk/service-queues/index.blade.php

@@ -0,0 +1,34 @@
+<x-app-layout title="Service queues">
+  <div class="flex flex-wrap items-start justify-between gap-4">
+    <div>
+      <h1 class="text-xl font-semibold text-slate-900">Service queues</h1>
+      <p class="mt-1 text-sm text-slate-500">Powered by Ladill Queue — call tickets and manage counters without leaving Frontdesk</p>
+    </div>
+    <a href="https://queue.ladill.com" target="_blank" class="btn-secondary text-sm">Open Queue admin</a>
+  </div>
+
+  @if (session('error'))
+    <div class="mt-4 rounded-lg bg-rose-50 px-4 py-3 text-sm text-rose-800">{{ session('error') }}</div>
+  @endif
+
+  <div class="mt-5 grid gap-4 md:grid-cols-2 xl:grid-cols-3">
+    @forelse ($counters as $counter)
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
+        <div class="flex items-start justify-between gap-3">
+          <div>
+            <h2 class="text-lg font-semibold text-slate-900">{{ $counter['name'] }}</h2>
+            <p class="mt-1 text-sm text-slate-500">{{ $counter['status'] ?? 'offline' }}</p>
+          </div>
+        </div>
+        <p class="mt-3 text-sm text-slate-600">
+          Queues: {{ collect($counter['queues'] ?? [])->join(', ') ?: 'None assigned' }}
+        </p>
+        <a href="{{ route('frontdesk.service-queues.console', $counter['uuid']) }}" class="btn-primary mt-4 inline-block w-full text-center text-sm">Open console</a>
+      </article>
+    @empty
+      <div class="col-span-full rounded-2xl border border-dashed border-slate-300 bg-slate-50 px-6 py-12 text-center text-sm text-slate-600">
+        No counters found in Ladill Queue. Create counters in Queue admin, then return here.
+      </div>
+    @endforelse
+  </div>
+</x-app-layout>

resources/views/frontdesk/settings/edit.blade.php

@@ -114,6 +114,14 @@
                         @checked(old('employee_kiosk_enabled', $settings['employee_kiosk_enabled'] ?? true))>
                     Enable employee sign-in on kiosk (code + PIN)
                 </label>
+                <div class="rounded-xl border border-slate-200 p-4">
+                    <h2 class="text-sm font-semibold text-slate-900">Ladill Queue</h2>
+                    <p class="mt-1 text-xs text-slate-500">Manage service queues and counters in Frontdesk. You must also enable Frontdesk integration in Ladill Queue settings.</p>
+                    <label class="mt-3 flex items-center gap-2 text-sm">
+                        <input type="checkbox" name="queue_integration_enabled" value="1" @checked(data_get($settings, 'queue_integration_enabled'))>
+                        Enable Ladill Queue integration
+                    </label>
+                </div>
                 <div>
                     <p class="text-sm font-medium text-slate-700">Notification channels</p>
                     <p class="mt-1 text-xs text-slate-500">Alerts go to each host's email and/or phone — no Ladill account required.</p>

resources/views/partials/sidebar.blade.php

@@ -9,6 +9,9 @@
             ? app(\App\Services\Frontdesk\OrganizationResolver::class)->memberFor(auth()->user())
             : null;
         $permissions = app(\App\Services\Frontdesk\FrontdeskPermissions::class);
+        $organization = auth()->user()
+            ? app(\App\Services\Frontdesk\OrganizationResolver::class)->resolveForUser(auth()->user())
+            : null;
         $linkedHost = auth()->user()
             ? app(\App\Services\Frontdesk\OrganizationResolver::class)->hostFor(auth()->user())
             : null;
@@ -74,6 +77,11 @@
              'icon' => '<path stroke-linecap="round" stroke-linejoin="round" d="M8.25 3v1.5M4.5 8.25H3m18 0h-1.5M4.5 12H3m18 0h-1.5m-15 3.75H3m18 0h-1.5M8.25 19.5V21M12 3v1.5m0 15V21m3.75-18v1.5m0 15V21" />'];
         }
 
+        if ($organization && data_get($organization->settings, 'queue_integration_enabled') && $permissions->can($member, 'service_queues.console')) {
+            $nav[] = ['name' => 'Service queues', 'route' => route('frontdesk.service-queues.index'), 'active' => request()->routeIs('frontdesk.service-queues.*'),
+             'icon' => '<path stroke-linecap="round" stroke-linejoin="round" d="M16.5 6v.75m0 3v.75m0 3v.75m0 3V18m-9-5.25h5.25M7.5 15h3M3.375 5.25c-.621 0-1.125.504-1.125 1.125v3.026a2.999 2.999 0 0 1 0 5.198v3.026c0 .621.504 1.125 1.125 1.125h17.25c.621 0 1.125-.504 1.125-1.125v-3.026a2.999 2.999 0 0 1 0-5.198V6.375c0-.621-.504-1.125-1.125-1.125H3.375Z" />'];
+        }
+
         if ($permissions->can($member, 'watchlist.view')) {
             $nav[] = ['name' => 'Watchlist', 'route' => route('frontdesk.watchlist.index'), 'active' => request()->routeIs('frontdesk.watchlist.*'),
              'icon' => '<path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126ZM12 15.75h.007v.008H12v-.008Z" />'];

routes/web.php

@@ -23,6 +23,7 @@ use App\Http\Controllers\Frontdesk\QrScanController;
 use App\Http\Controllers\Frontdesk\ReceptionDeskController;
 use App\Http\Controllers\Frontdesk\ReportController;
 use App\Http\Controllers\Frontdesk\SecurityController;
+use App\Http\Controllers\Frontdesk\ServiceQueueController;
 use App\Http\Controllers\Frontdesk\SettingsController;
 use App\Http\Controllers\Frontdesk\VisitController;
 use App\Http\Controllers\Frontdesk\VisitorController;
@@ -145,6 +146,10 @@ Route::middleware(['auth', 'platform.session'])->group(function () {
         Route::delete('/devices/{device}', [DeviceController::class, 'destroy'])->name('frontdesk.devices.destroy');
         Route::post('/devices/{device}/regenerate-token', [DeviceController::class, 'regenerateToken'])->name('frontdesk.devices.regenerate-token');
 
+        Route::get('/service-queues', [ServiceQueueController::class, 'index'])->name('frontdesk.service-queues.index');
+        Route::get('/service-queues/console/{counterUuid}', [ServiceQueueController::class, 'console'])->name('frontdesk.service-queues.console');
+        Route::post('/service-queues/console/{counterUuid}/action', [ServiceQueueController::class, 'action'])->name('frontdesk.service-queues.action');
+
         Route::get('/security', [SecurityController::class, 'index'])->name('frontdesk.security.index');
         Route::get('/security/evacuation', [SecurityController::class, 'evacuation'])->name('frontdesk.security.evacuation');
         Route::get('/security/evacuation/export', [SecurityController::class, 'evacuationExport'])->name('frontdesk.security.evacuation.export');