Add dual-screen customer display for the register.

Token-gated full-screen customer view shows order, payment QR, tips,
signature, receipt, and promo phases while the till keeps operator UI.

app/Http/Controllers/Pos/CustomerDisplayController.php

@@ -0,0 +1,122 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosCustomerDisplay;
+use App\Services\Pos\CustomerDisplayService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+
+class CustomerDisplayController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private CustomerDisplayService $displays) {}
+
+    /** Operator: open/link info for the customer-facing screen. */
+    public function info(Request $request): JsonResponse
+    {
+        $location = $this->location($request);
+        $display = $this->displays->ensureForLocation($location);
+
+        return response()->json([
+            'url' => $this->displays->displayUrl($display),
+            'token' => $display->token,
+            'phase' => $display->phase,
+        ]);
+    }
+
+    public function rotate(Request $request): JsonResponse
+    {
+        $location = $this->location($request);
+        $display = $this->displays->rotateToken($this->displays->ensureForLocation($location));
+
+        return response()->json([
+            'url' => $this->displays->displayUrl($display),
+            'token' => $display->token,
+        ]);
+    }
+
+    /** Operator: push cart / phase updates from the register. */
+    public function push(Request $request): JsonResponse
+    {
+        $data = $request->validate([
+            'phase' => ['nullable', 'string', Rule::in(PosCustomerDisplay::PHASES)],
+            'lines' => ['nullable', 'array'],
+            'lines.*.name' => ['required_with:lines', 'string', 'max:200'],
+            'lines.*.quantity' => ['required_with:lines', 'numeric', 'min:0'],
+            'lines.*.unit_price_minor' => ['required_with:lines', 'integer', 'min:0'],
+            'lines.*.discount_minor' => ['nullable', 'integer', 'min:0'],
+            'lines.*.note' => ['nullable', 'string', 'max:200'],
+            'discount_minor' => ['nullable', 'integer', 'min:0'],
+            'tax_minor' => ['nullable', 'integer', 'min:0'],
+            'customer_name' => ['nullable', 'string', 'max:120'],
+            'loyalty' => ['nullable', 'array'],
+            'loyalty.points_balance' => ['nullable', 'integer'],
+            'loyalty.points_earn' => ['nullable', 'integer'],
+            'loyalty.points_redeem' => ['nullable', 'integer'],
+            'loyalty.label' => ['nullable', 'string', 'max:120'],
+            'payment' => ['nullable', 'array'],
+            'tip' => ['nullable', 'array'],
+            'signature' => ['nullable', 'array'],
+            'receipt' => ['nullable', 'array'],
+            'promo' => ['nullable', 'array'],
+            'message' => ['nullable', 'string', 'max:500'],
+            'sale_reference' => ['nullable', 'string', 'max:64'],
+        ]);
+
+        $location = $this->location($request);
+        $phase = $data['phase'] ?? null;
+        $lines = $data['lines'] ?? null;
+
+        $extras = array_filter([
+            'discount_minor' => $data['discount_minor'] ?? null,
+            'tax_minor' => $data['tax_minor'] ?? null,
+            'customer_name' => $data['customer_name'] ?? null,
+            'loyalty' => $data['loyalty'] ?? null,
+            'payment' => $data['payment'] ?? null,
+            'tip' => $data['tip'] ?? null,
+            'signature' => $data['signature'] ?? null,
+            'receipt' => $data['receipt'] ?? null,
+            'promo' => $data['promo'] ?? null,
+            'message' => $data['message'] ?? null,
+            'sale_reference' => $data['sale_reference'] ?? null,
+        ], fn ($v) => $v !== null);
+
+        if ($phase === PosCustomerDisplay::PHASE_CART || ($lines !== null && $phase === null)) {
+            $display = $this->displays->pushCart($location, $lines ?? [], $extras);
+        } elseif ($phase !== null) {
+            if ($lines !== null) {
+                $extras['lines'] = $lines;
+            }
+            $display = $this->displays->push($location, $phase, $extras);
+        } else {
+            $display = $this->displays->push($location, PosCustomerDisplay::PHASE_IDLE, $extras);
+        }
+
+        return response()->json([
+            'ok' => true,
+            'phase' => $display->phase,
+            'updated_at' => optional($display->last_pushed_at)->toIso8601String(),
+        ]);
+    }
+
+    /** Operator: read (and optionally clear) the latest customer action (tip, signature, email). */
+    public function actions(Request $request): JsonResponse
+    {
+        $location = $this->location($request);
+        $display = $this->displays->ensureForLocation($location);
+        $action = $display->customer_action;
+
+        if ($request->boolean('clear') && $action) {
+            $this->displays->clearCustomerAction($display);
+        }
+
+        return response()->json([
+            'action' => $action,
+        ]);
+    }
+}

app/Http/Controllers/Pos/RegisterController.php

@@ -7,6 +7,7 @@ use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
 use App\Models\PosLocation;
 use App\Models\PosProduct;
 use App\Models\PosSale;
+use App\Services\Pos\CustomerDisplayService;
 use App\Services\Pos\PosBarcodeLookupService;
 use App\Services\Pos\PosLocationService;
 use App\Services\Pos\PosSaleService;
@@ -25,18 +26,24 @@ class RegisterController extends Controller
         private PosSaleService $sales,
         private PosLocationService $locations,
         private PosBarcodeLookupService $barcodes,
+        private CustomerDisplayService $customerDisplays,
     ) {}
 
     public function index(Request $request): View
     {
         $owner = $this->ownerRef($request);
         $location = $this->location($request);
+        $display = $this->customerDisplays->ensureForLocation($location);
 
         return view('pos.register', [
             'products' => $this->registerProducts($owner, $location),
             'location' => $location,
             'crmCustomers' => $this->crmCustomers($owner),
             'barcodeLookupUrl' => route('pos.register.lookup'),
+            'customerDisplayUrl' => $this->customerDisplays->displayUrl($display),
+            'customerDisplayPushUrl' => route('pos.customer-display.push'),
+            'customerDisplayActionsUrl' => route('pos.customer-display.actions'),
+            'isRestaurant' => $location->isRestaurant(),
         ]);
     }
 
@@ -163,6 +170,7 @@ class RegisterController extends Controller
 
             if ($data['payment_method'] === 'cash') {
                 $this->sales->recordCashPayment($sale);
+                $this->customerDisplays->pushReceipt($location, $sale->fresh(['lines']));
 
                 if ($location->printer_auto_print) {
                     return redirect()
@@ -176,18 +184,26 @@ class RegisterController extends Controller
             }
 
             $result = $this->sales->initiatePayCheckout($sale, $merchant);
+            $checkoutUrl = $result['checkout_url'] ?? null;
+
+            $this->customerDisplays->pushPayment($location, $sale->fresh(['lines']), [
+                'checkout_url' => $checkoutUrl,
+                'qr_url' => $checkoutUrl,
+                'message' => 'Complete payment with card or MoMo',
+                'options' => ['Card / MoMo'],
+            ]);
 
             if ($request->expectsJson() || $request->ajax()) {
                 return response()->json([
-                    'checkout_url' => $result['checkout_url'],
+                    'checkout_url' => $checkoutUrl,
                     'sale_id' => $sale->id,
                 ]);
             }
 
             return redirect()
                 ->route('pos.sales.show', $sale)
-                ->with('checkout_url', $result['checkout_url'])
-                ->with('success', 'Payment sheet ready — hand the device to the customer for card or MoMo.');
+                ->with('checkout_url', $checkoutUrl)
+                ->with('success', 'Payment sheet ready — customer screen shows the QR; till sheet is for the operator.');
         } catch (RuntimeException $e) {
             return back()->withInput()->with('error', $e->getMessage());
         }

app/Http/Controllers/Public/CustomerDisplayController.php

@@ -0,0 +1,146 @@
+<?php
+
+namespace App\Http\Controllers\Public;
+
+use App\Http\Controllers\Controller;
+use App\Models\PosCustomerDisplay;
+use App\Services\Pos\CustomerDisplayService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+
+class CustomerDisplayController extends Controller
+{
+    public function __construct(private CustomerDisplayService $displays) {}
+
+    public function show(string $token): View
+    {
+        $display = $this->find($token);
+
+        return view('pos.customer-display', [
+            'display' => $display,
+            'state' => $this->displays->publicState($display),
+            'stateUrl' => route('pos.customer-display.state', ['token' => $token]),
+            'streamUrl' => route('pos.customer-display.stream', ['token' => $token]),
+            'actionUrl' => route('pos.customer-display.action', ['token' => $token]),
+        ]);
+    }
+
+    public function state(string $token): JsonResponse
+    {
+        $display = $this->find($token);
+
+        return response()->json($this->displays->publicState($display));
+    }
+
+    public function stream(Request $request, string $token): StreamedResponse
+    {
+        $display = $this->find($token);
+        $id = $display->id;
+        $request->session()->save();
+
+        $response = new StreamedResponse(function () use ($id) {
+            while (ob_get_level() > 0) {
+                @ob_end_flush();
+            }
+            @set_time_limit(0);
+
+            $start = time();
+            $lastHash = null;
+
+            while (true) {
+                $display = PosCustomerDisplay::query()->find($id);
+                if (! $display) {
+                    echo "event: end\ndata: {}\n\n";
+                    break;
+                }
+
+                $payload = $this->displays->publicState($display);
+                $json = json_encode($payload);
+                $hash = md5((string) $json);
+
+                if ($hash !== $lastHash) {
+                    echo 'data: '.$json."\n\n";
+                    $lastHash = $hash;
+                } else {
+                    echo ": ping\n\n";
+                }
+                @ob_flush();
+                @flush();
+
+                if (connection_aborted() || (time() - $start) >= 25) {
+                    break;
+                }
+                usleep(400000);
+            }
+        });
+
+        $response->headers->set('Content-Type', 'text/event-stream');
+        $response->headers->set('Cache-Control', 'no-cache');
+        $response->headers->set('Connection', 'keep-alive');
+        $response->headers->set('X-Accel-Buffering', 'no');
+
+        return $response;
+    }
+
+    public function action(Request $request, string $token): JsonResponse
+    {
+        $display = $this->find($token);
+
+        $data = $request->validate([
+            'type' => ['required', 'string', 'in:tip,signature,receipt_email,payment_option'],
+            'tip_percent' => ['nullable', 'numeric', 'min:0', 'max:100'],
+            'tip_minor' => ['nullable', 'integer', 'min:0'],
+            'signature_data_url' => ['nullable', 'string', 'max:500000'],
+            'email' => ['nullable', 'email', 'max:255'],
+            'payment_option' => ['nullable', 'string', 'max:40'],
+        ]);
+
+        $action = ['type' => $data['type']];
+
+        if ($data['type'] === 'tip') {
+            $action['tip_percent'] = $data['tip_percent'] ?? null;
+            $action['tip_minor'] = $data['tip_minor'] ?? null;
+            // Reflect selection on the screen immediately.
+            $payload = $display->payload ?? [];
+            $tip = $payload['tip'] ?? [];
+            $tip['selected_percent'] = $data['tip_percent'] ?? null;
+            $tip['selected_minor'] = $data['tip_minor'] ?? null;
+            $payload['tip'] = $tip;
+            $display->update(['payload' => $payload, 'last_pushed_at' => now()]);
+        }
+
+        if ($data['type'] === 'signature') {
+            $action['signature_data_url'] = $data['signature_data_url'] ?? null;
+            $payload = $display->payload ?? [];
+            $sig = $payload['signature'] ?? [];
+            $sig['data_url'] = $data['signature_data_url'] ?? null;
+            $payload['signature'] = $sig;
+            $display->update(['payload' => $payload, 'last_pushed_at' => now()]);
+        }
+
+        if ($data['type'] === 'receipt_email') {
+            $action['email'] = $data['email'] ?? null;
+        }
+
+        if ($data['type'] === 'payment_option') {
+            $action['payment_option'] = $data['payment_option'] ?? null;
+        }
+
+        $this->displays->recordCustomerAction($display->fresh(), $action);
+
+        return response()->json([
+            'ok' => true,
+            'state' => $this->displays->publicState($display->fresh()),
+        ]);
+    }
+
+    private function find(string $token): PosCustomerDisplay
+    {
+        return PosCustomerDisplay::query()
+            ->where('token', $token)
+            ->with('location')
+            ->firstOrFail();
+    }
+}