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>

app/Http/Controllers/Api/AppointmentController.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Api\Concerns\ScopesApiToAccount;
+use App\Http\Controllers\Controller;
+use App\Models\QueueAppointment;
+use App\Services\Qms\AppointmentService;
+use App\Services\Qms\AuditLogger;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+class AppointmentController extends Controller
+{
+    use ScopesApiToAccount;
+
+    public function index(Request $request): JsonResponse
+    {
+        $this->authorizeAbility($request, 'appointments.view');
+        $owner = $this->ownerRef($request);
+        $organization = $this->organization($request);
+
+        $items = QueueAppointment::owned($owner)
+            ->where('organization_id', $organization->id)
+            ->orderBy('scheduled_at')
+            ->paginate(50);
+
+        return response()->json(['data' => $items]);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $this->authorizeAbility($request, 'appointments.manage');
+        $owner = $this->ownerRef($request);
+        $organization = $this->organization($request);
+
+        $validated = $request->validate([
+            'branch_id' => ['required', 'exists:queue_branches,id'],
+            'service_queue_id' => ['nullable', 'exists:queue_service_queues,id'],
+            'customer_name' => ['required', 'string', 'max:255'],
+            'customer_phone' => ['nullable', 'string', 'max:50'],
+            'customer_email' => ['nullable', 'email', 'max:255'],
+            'scheduled_at' => ['required', 'date'],
+        ]);
+
+        $appointment = QueueAppointment::create([
+            'owner_ref' => $owner,
+            'organization_id' => $organization->id,
+            ...$validated,
+            'status' => 'scheduled',
+            'reference' => 'APT-'.Str::upper(Str::random(6)),
+        ]);
+
+        AuditLogger::record($owner, 'appointment.created', $organization->id, $owner, QueueAppointment::class, $appointment->id);
+
+        return response()->json(['data' => $appointment], 201);
+    }
+
+    public function checkIn(Request $request, QueueAppointment $appointment): JsonResponse
+    {
+        $this->authorizeAbility($request, 'appointments.manage');
+        $this->authorizeOwner($request, $appointment);
+
+        $ticket = app(AppointmentService::class)->checkIn($appointment, $this->ownerRef($request));
+
+        return response()->json(['data' => \App\Services\Qms\TicketPresenter::toArray($ticket)]);
+    }
+}