Add restaurant/café mode: floor, open tabs, and kitchen display (Phase 1)

Gated by a per-location service_style (retail | restaurant). Restaurant mode adds:
- Floor screen with tables (areas, seats, status) — tap a free table to open a
  dine-in tab; takeaway/counter orders open from the same screen.
- Open tickets (tabs): a sale stays pending while items are added; lines persist
  as you go (posTicket Alpine component posts each change to the server).
- Send-to-kitchen fires un-sent lines; a polling Kitchen Display (KDS) shows
  active tickets and bumps items queued → preparing → ready → served.
- Settlement reuses the existing cash / Ladill Pay flow; paying closes the tab
  and frees the table (PosSaleService::closeTicket, wired into both pay paths).
- Settings gains the mode toggle and a tables manager.

Schema is additive (new pos_tables; service_style on locations; order/kitchen
columns on sales + lines). Retail flow is untouched. Sidebar surfaces Floor +
Kitchen only in restaurant mode. New PosRestaurantTest covers the dine-in
lifecycle end to end; suite green (10 passed).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

app/Http/Controllers/Pos/KitchenController.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosSale;
+use App\Models\PosSaleLine;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class KitchenController extends Controller
+{
+    use ScopesToAccount;
+
+    public function index(Request $request): View
+    {
+        return view('pos.kitchen.index');
+    }
+
+    /**
+     * Active kitchen tickets — open sales with fired-but-not-served lines.
+     */
+    public function feed(Request $request): JsonResponse
+    {
+        $owner = $this->ownerRef($request);
+
+        $sales = PosSale::owned($owner)
+            ->openTickets()
+            ->where('kitchen_status', PosSale::KITCHEN_ACTIVE)
+            ->with(['table', 'lines' => fn ($q) => $q->orderBy('position')])
+            ->orderBy('kitchen_sent_at')
+            ->get();
+
+        $tickets = $sales->map(function (PosSale $sale) {
+            $lines = $sale->lines
+                ->filter(fn (PosSaleLine $l) => in_array($l->kitchen_state, [
+                    PosSaleLine::KITCHEN_QUEUED,
+                    PosSaleLine::KITCHEN_PREPARING,
+                    PosSaleLine::KITCHEN_READY,
+                ], true))
+                ->values();
+
+            if ($lines->isEmpty()) {
+                return null;
+            }
+
+            return [
+                'id' => $sale->id,
+                'reference' => $sale->reference,
+                'order_type' => $sale->order_type,
+                'table' => $sale->table?->label,
+                'sent_at' => optional($sale->kitchen_sent_at)->toIso8601String(),
+                'lines' => $lines->map(fn (PosSaleLine $l) => [
+                    'id' => $l->id,
+                    'name' => $l->name,
+                    'quantity' => $l->quantity,
+                    'notes' => $l->notes,
+                    'state' => $l->kitchen_state,
+                ])->all(),
+            ];
+        })->filter()->values();
+
+        return response()->json(['tickets' => $tickets, 'server_time' => now()->toIso8601String()]);
+    }
+
+    /**
+     * Advance one line to the next kitchen state (queued → preparing → ready → served).
+     */
+    public function bump(Request $request, PosSaleLine $line): JsonResponse
+    {
+        $owner = $this->ownerRef($request);
+        abort_unless($line->sale && $line->sale->owner_ref === $owner, 404);
+
+        $flow = PosSaleLine::KITCHEN_FLOW;
+        $idx = array_search($line->kitchen_state, $flow, true);
+        $next = $idx === false ? PosSaleLine::KITCHEN_PREPARING : ($flow[$idx + 1] ?? PosSaleLine::KITCHEN_SERVED);
+
+        $line->forceFill(['kitchen_state' => $next])->save();
+
+        // When every fired line is served, the ticket leaves the kitchen board.
+        $sale = $line->sale;
+        $remaining = $sale->lines()
+            ->whereIn('kitchen_state', [PosSaleLine::KITCHEN_QUEUED, PosSaleLine::KITCHEN_PREPARING, PosSaleLine::KITCHEN_READY])
+            ->count();
+        if ($remaining === 0) {
+            $sale->forceFill(['kitchen_status' => PosSale::KITCHEN_SERVED])->save();
+        }
+
+        return response()->json(['state' => $next]);
+    }
+}

app/Http/Controllers/Pos/SettingsController.php

@@ -4,6 +4,8 @@ namespace App\Http\Controllers\Pos;
 
 use App\Http\Controllers\Controller;
 use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosLocation;
+use App\Models\PosTable;
 use App\Services\Import\CrmProductImportService;
 use App\Services\Import\MerchantCatalogImportService;
 use App\Services\Pos\PosLocationService;
@@ -20,11 +22,13 @@ class SettingsController extends Controller
 
     public function index(Request $request): View
     {
-        $location = $this->locations->ensureDefault($this->ownerRef($request));
+        $owner = $this->ownerRef($request);
+        $location = $this->locations->ensureDefault($owner);
 
         return view('pos.settings', [
             'location' => $location,
             'merchantImportEnabled' => (bool) config('pos.merchant_import_enabled', true),
+            'tables' => PosTable::owned($owner)->orderBy('area')->orderBy('position')->orderBy('label')->get(),
         ]);
     }
 
@@ -33,6 +37,7 @@ class SettingsController extends Controller
         $data = $request->validate([
             'name' => ['required', 'string', 'max:120'],
             'currency' => ['required', 'string', 'size:3'],
+            'service_style' => ['required', 'in:retail,restaurant'],
             'receipt_footer' => ['nullable', 'string', 'max:1000'],
         ]);
 
@@ -40,12 +45,50 @@ class SettingsController extends Controller
         $location->update([
             'name' => $data['name'],
             'currency' => strtoupper($data['currency']),
+            'service_style' => $data['service_style'],
             'receipt_footer' => $data['receipt_footer'] ?? null,
         ]);
 
         return back()->with('success', 'Settings saved.');
     }
 
+    public function storeTable(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'area' => ['nullable', 'string', 'max:60'],
+            'label' => ['required', 'string', 'max:60'],
+            'seats' => ['nullable', 'integer', 'min:1', 'max:99'],
+        ]);
+
+        $owner = $this->ownerRef($request);
+        $location = $this->locations->ensureDefault($owner);
+
+        PosTable::create([
+            'owner_ref' => $owner,
+            'location_id' => $location->id,
+            'area' => $data['area'] ?? null,
+            'label' => $data['label'],
+            'seats' => $data['seats'] ?? 2,
+            'status' => PosTable::STATUS_FREE,
+            'position' => (int) PosTable::owned($owner)->max('position') + 1,
+        ]);
+
+        return back()->with('success', 'Table added.');
+    }
+
+    public function destroyTable(Request $request, PosTable $table): RedirectResponse
+    {
+        $this->authorizeOwner($request, $table);
+
+        if (! $table->isFree()) {
+            return back()->with('error', 'Settle the open ticket before removing this table.');
+        }
+
+        $table->delete();
+
+        return back()->with('success', 'Table removed.');
+    }
+
     public function importCrm(Request $request, CrmProductImportService $import): RedirectResponse
     {
         try {

app/Http/Controllers/Pos/TableController.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosSale;
+use App\Models\PosTable;
+use App\Services\Pos\PosLocationService;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class TableController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private PosLocationService $locations) {}
+
+    public function index(Request $request): View
+    {
+        $owner = $this->ownerRef($request);
+        $location = $this->locations->ensureDefault($owner);
+
+        $tables = PosTable::owned($owner)
+            ->with('currentSale')
+            ->orderBy('area')
+            ->orderBy('position')
+            ->orderBy('label')
+            ->get();
+
+        $openTickets = PosSale::owned($owner)
+            ->openTickets()
+            ->with('table')
+            ->withCount('lines')
+            ->latest('opened_at')
+            ->get();
+
+        return view('pos.floor', [
+            'location' => $location,
+            'tables' => $tables,
+            'tablesByArea' => $tables->groupBy(fn (PosTable $t) => $t->area ?: 'Floor'),
+            'openTickets' => $openTickets,
+        ]);
+    }
+}

app/Http/Controllers/Pos/TicketController.php

@@ -0,0 +1,204 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosProduct;
+use App\Models\PosSale;
+use App\Models\PosSaleLine;
+use App\Services\Pos\PosLocationService;
+use App\Services\Pos\PosSaleService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use RuntimeException;
+
+class TicketController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private PosSaleService $sales, private PosLocationService $locations) {}
+
+    public function open(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'order_type' => ['required', 'in:dine_in,takeaway,counter'],
+            'table_id' => ['nullable', 'integer'],
+            'covers' => ['nullable', 'integer', 'min:1', 'max:99'],
+        ]);
+
+        $merchant = ladill_account() ?? $request->user();
+        $location = $this->locations->ensureDefault($this->ownerRef($request));
+
+        try {
+            $sale = $this->sales->openTicket($merchant, [
+                'order_type' => $data['order_type'],
+                'table_id' => $data['table_id'] ?? null,
+                'covers' => $data['covers'] ?? null,
+                'location_id' => $location->id,
+                'currency' => $location->currency,
+            ]);
+        } catch (RuntimeException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+
+        return redirect()->route('pos.tickets.show', $sale);
+    }
+
+    public function show(Request $request, PosSale $sale): View
+    {
+        $this->authorizeOwner($request, $sale);
+
+        if (! $sale->isOpen()) {
+            return redirect()->route('pos.sales.show', $sale);
+        }
+
+        $owner = $this->ownerRef($request);
+        $sale->load('lines', 'table');
+
+        $products = PosProduct::owned($owner)->active()->orderBy('name')->get();
+
+        return view('pos.tickets.show', [
+            'sale' => $sale,
+            'products' => $products,
+            'lines' => $this->lineData($sale),
+        ]);
+    }
+
+    public function addLine(Request $request, PosSale $sale): JsonResponse
+    {
+        $this->authorizeOpen($request, $sale);
+
+        $data = $request->validate([
+            'product_id' => ['nullable', 'integer'],
+            'name' => ['required', 'string', 'max:200'],
+            'unit_price_minor' => ['required', 'integer', 'min:1'],
+            'quantity' => ['nullable', 'integer', 'min:1', 'max:999'],
+            'notes' => ['nullable', 'string', 'max:200'],
+        ]);
+
+        try {
+            $this->sales->addLine($sale, $data);
+        } catch (RuntimeException $e) {
+            return response()->json(['message' => $e->getMessage()], 422);
+        }
+
+        return $this->ticketJson($sale);
+    }
+
+    public function updateLine(Request $request, PosSale $sale, PosSaleLine $line): JsonResponse
+    {
+        $this->authorizeOpen($request, $sale);
+        abort_unless($line->pos_sale_id === $sale->id, 404);
+
+        $data = $request->validate([
+            'quantity' => ['required', 'integer', 'min:0', 'max:999'],
+            'notes' => ['nullable', 'string', 'max:200'],
+        ]);
+
+        $this->sales->updateLine($line, $data['quantity'], $data['notes'] ?? null);
+
+        return $this->ticketJson($sale);
+    }
+
+    public function removeLine(Request $request, PosSale $sale, PosSaleLine $line): JsonResponse
+    {
+        $this->authorizeOpen($request, $sale);
+        abort_unless($line->pos_sale_id === $sale->id, 404);
+
+        $this->sales->removeLine($line);
+
+        return $this->ticketJson($sale);
+    }
+
+    public function sendToKitchen(Request $request, PosSale $sale): JsonResponse
+    {
+        $this->authorizeOpen($request, $sale);
+
+        $fired = $this->sales->sendToKitchen($sale);
+        $sale->refresh();
+
+        return response()->json([
+            'lines' => $this->lineData($sale),
+            'subtotal_minor' => $sale->subtotal_minor,
+            'total_minor' => $sale->total_minor,
+            'kitchen_status' => $sale->kitchen_status,
+            'fired' => $fired,
+        ]);
+    }
+
+    public function settle(Request $request, PosSale $sale): RedirectResponse
+    {
+        $this->authorizeOpen($request, $sale);
+
+        $data = $request->validate([
+            'payment_method' => ['required', 'in:pay,cash'],
+            'customer_name' => ['nullable', 'string', 'max:120'],
+            'customer_phone' => ['nullable', 'string', 'max:40'],
+        ]);
+
+        $sale->loadCount('lines');
+        if ($sale->lines_count === 0) {
+            return back()->with('error', 'Add at least one item before settling.');
+        }
+
+        if (! empty($data['customer_name']) || ! empty($data['customer_phone'])) {
+            $sale->forceFill([
+                'customer_name' => $data['customer_name'] ?? $sale->customer_name,
+                'customer_phone' => $data['customer_phone'] ?? $sale->customer_phone,
+            ])->save();
+        }
+
+        $merchant = ladill_account() ?? $request->user();
+
+        try {
+            if ($data['payment_method'] === 'cash') {
+                $this->sales->recordCashPayment($sale);
+
+                return redirect()->route('pos.sales.show', $sale)->with('success', 'Ticket settled (cash).');
+            }
+
+            $result = $this->sales->initiatePayCheckout($sale, $merchant);
+
+            return redirect()->away($result['checkout_url']);
+        } catch (RuntimeException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+    }
+
+    private function authorizeOpen(Request $request, PosSale $sale): void
+    {
+        $this->authorizeOwner($request, $sale);
+        abort_unless($sale->isOpen(), 409, 'This ticket is already settled.');
+    }
+
+    private function ticketJson(PosSale $sale): JsonResponse
+    {
+        $sale->refresh();
+
+        return response()->json([
+            'lines' => $this->lineData($sale),
+            'subtotal_minor' => $sale->subtotal_minor,
+            'total_minor' => $sale->total_minor,
+            'kitchen_status' => $sale->kitchen_status,
+        ]);
+    }
+
+    /** @return list<array<string,mixed>> */
+    private function lineData(PosSale $sale): array
+    {
+        return $sale->lines()->orderBy('position')->get()->map(fn (PosSaleLine $l) => [
+            'id' => $l->id,
+            'product_id' => $l->product_id,
+            'name' => $l->name,
+            'unit_price_minor' => $l->unit_price_minor,
+            'quantity' => $l->quantity,
+            'line_total_minor' => $l->line_total_minor,
+            'kitchen_state' => $l->kitchen_state,
+            'notes' => $l->notes,
+            'fired' => $l->kitchen_state !== PosSaleLine::KITCHEN_NEW,
+        ])->all();
+    }
+}