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>
2026-06-24 08:38:18 +00:00
parent e9a0c92308
commit d9e4b6e06e
19 changed files with 1299 additions and 1 deletions
@@ -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();
+    }
+}