Add Ladill POS v1 — register, Pay checkout, and commerce links.

Staff-facing counter register at pos.ladill.com with catalog cart, cash and
MoMo/card checkout via Ladill Pay, CRM timeline/import, invoice prefill, and
Merchant catalog import.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Http/Controllers/Pos/Concerns/ScopesToAccount.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Controllers\Pos\Concerns;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\Request;
+
+trait ScopesToAccount
+{
+    protected function ownerRef(Request $request): string
+    {
+        $user = ladill_account() ?? $request->user();
+
+        return (string) $user->public_id;
+    }
+
+    protected function authorizeOwner(Request $request, Model $model): void
+    {
+        abort_unless($model->getAttribute('owner_ref') === $this->ownerRef($request), 404);
+    }
+}

app/Http/Controllers/Pos/DashboardController.php

@@ -0,0 +1,43 @@
+<?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\Services\Pos\PosLocationService;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class DashboardController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private PosLocationService $locations) {}
+
+    public function index(Request $request): View
+    {
+        $owner = $this->ownerRef($request);
+        $todayStart = now()->startOfDay();
+
+        $todaySales = PosSale::owned($owner)
+            ->where('status', PosSale::STATUS_PAID)
+            ->where('paid_at', '>=', $todayStart);
+
+        $stats = [
+            'today_total_minor' => (int) (clone $todaySales)->sum('total_minor'),
+            'today_count' => (clone $todaySales)->count(),
+            'product_count' => PosProduct::owned($owner)->active()->count(),
+            'open_pending' => PosSale::owned($owner)->where('status', PosSale::STATUS_PENDING)->count(),
+        ];
+
+        $recentSales = PosSale::owned($owner)
+            ->with('lines')
+            ->latest()
+            ->limit(8)
+            ->get();
+
+        return view('pos.dashboard', compact('stats', 'recentSales'));
+    }
+}

app/Http/Controllers/Pos/ProductController.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosProduct;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class ProductController extends Controller
+{
+    use ScopesToAccount;
+
+    public function index(Request $request): View
+    {
+        $products = PosProduct::owned($this->ownerRef($request))
+            ->orderBy('name')
+            ->paginate(30)
+            ->withQueryString();
+
+        return view('pos.products.index', compact('products'));
+    }
+
+    public function create(): View
+    {
+        return view('pos.products.create', ['product' => new PosProduct([
+            'currency' => config('pos.default_currency', 'GHS'),
+            'is_active' => true,
+        ])]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        PosProduct::create([
+            ...$this->validated($request),
+            'owner_ref' => $this->ownerRef($request),
+        ]);
+
+        return redirect()->route('pos.products.index')->with('success', 'Product added.');
+    }
+
+    public function edit(Request $request, PosProduct $product): View
+    {
+        $this->authorizeOwner($request, $product);
+
+        return view('pos.products.edit', compact('product'));
+    }
+
+    public function update(Request $request, PosProduct $product): RedirectResponse
+    {
+        $this->authorizeOwner($request, $product);
+        $product->update($this->validated($request));
+
+        return redirect()->route('pos.products.index')->with('success', 'Product updated.');
+    }
+
+    public function destroy(Request $request, PosProduct $product): RedirectResponse
+    {
+        $this->authorizeOwner($request, $product);
+        $product->delete();
+
+        return redirect()->route('pos.products.index')->with('success', 'Product removed.');
+    }
+
+    /** @return array<string, mixed> */
+    private function validated(Request $request): array
+    {
+        $data = $request->validate([
+            'name' => ['required', 'string', 'max:200'],
+            'sku' => ['nullable', 'string', 'max:80'],
+            'price' => ['required', 'numeric', 'min:0.01'],
+            'currency' => ['nullable', 'string', 'size:3'],
+            'is_active' => ['sometimes', 'boolean'],
+        ]);
+
+        return [
+            'name' => $data['name'],
+            'sku' => $data['sku'] ?? null,
+            'price_minor' => (int) round(((float) $data['price']) * 100),
+            'currency' => strtoupper($data['currency'] ?? config('pos.default_currency', 'GHS')),
+            'is_active' => $request->boolean('is_active', true),
+        ];
+    }
+}

app/Http/Controllers/Pos/RegisterController.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\PosProduct;
+use App\Models\PosSale;
+use App\Services\Pos\PosLocationService;
+use App\Services\Pos\PosSaleService;
+use App\Services\Crm\CrmClient;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use RuntimeException;
+
+class RegisterController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private PosSaleService $sales, private PosLocationService $locations) {}
+
+    public function index(Request $request): View
+    {
+        $owner = $this->ownerRef($request);
+        $location = $this->locations->ensureDefault($owner);
+
+        $products = PosProduct::owned($owner)
+            ->active()
+            ->orderBy('name')
+            ->get();
+
+        return view('pos.register', [
+            'products' => $products,
+            'location' => $location,
+            'crmCustomers' => $this->crmCustomers($owner),
+        ]);
+    }
+
+    /** @return list<array<string, mixed>> */
+    private function crmCustomers(string $owner): array
+    {
+        try {
+            return (array) ((CrmClient::for($owner)->customers(['per_page' => 200])['data']) ?? []);
+        } catch (\Throwable) {
+            return [];
+        }
+    }
+
+    public function charge(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'lines' => ['required', 'array', 'min:1'],
+            'lines.*.product_id' => ['nullable', 'integer'],
+            'lines.*.name' => ['required', 'string', 'max:200'],
+            'lines.*.unit_price_minor' => ['required', 'integer', 'min:1'],
+            'lines.*.quantity' => ['required', 'integer', 'min:1', 'max:999'],
+            'customer_name' => ['nullable', 'string', 'max:120'],
+            'customer_email' => ['nullable', 'email', 'max:255'],
+            'customer_phone' => ['nullable', 'string', 'max:40'],
+            'crm_customer_id' => ['nullable', 'integer'],
+            'payment_method' => ['required', 'in:pay,cash'],
+        ]);
+
+        $merchant = ladill_account() ?? $request->user();
+        $location = $this->locations->ensureDefault($this->ownerRef($request));
+
+        try {
+            $sale = $this->sales->createSale($merchant, $data['lines'], [
+                'location_id' => $location->id,
+                'currency' => $location->currency,
+                'customer_name' => $data['customer_name'] ?? null,
+                'customer_email' => $data['customer_email'] ?? null,
+                'customer_phone' => $data['customer_phone'] ?? null,
+                'crm_customer_id' => $data['crm_customer_id'] ?? null,
+            ]);
+
+            if ($data['payment_method'] === 'cash') {
+                $this->sales->recordCashPayment($sale);
+
+                return redirect()
+                    ->route('pos.sales.show', $sale)
+                    ->with('success', 'Cash sale recorded.');
+            }
+
+            $result = $this->sales->initiatePayCheckout($sale, $merchant);
+
+            return redirect()->away($result['checkout_url']);
+        } catch (RuntimeException $e) {
+            return back()->withInput()->with('error', $e->getMessage());
+        }
+    }
+}

app/Http/Controllers/Pos/SaleController.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Models\PosSale;
+use App\Services\CrossApp\CrossAppLinkService;
+use App\Services\Pos\PosSaleService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use RuntimeException;
+
+class SaleController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(
+        private PosSaleService $sales,
+        private CrossAppLinkService $links,
+    ) {}
+
+    public function index(Request $request): View
+    {
+        $sales = PosSale::owned($this->ownerRef($request))
+            ->with('lines')
+            ->latest()
+            ->paginate(25)
+            ->withQueryString();
+
+        return view('pos.sales.index', compact('sales'));
+    }
+
+    public function show(Request $request, PosSale $sale): View
+    {
+        $this->authorizeOwner($request, $sale);
+        $sale->load('lines', 'location');
+
+        $invoiceUrl = $sale->isPaid()
+            ? $this->links->invoiceFromSale($sale)
+            : null;
+
+        return view('pos.sales.show', compact('sale', 'invoiceUrl'));
+    }
+
+    public function callback(Request $request, PosSale $sale): RedirectResponse
+    {
+        $reference = trim((string) $request->query('reference', $sale->payment_reference ?? ''));
+
+        if ($reference === '') {
+            return redirect()->route('pos.sales.show', $sale)->with('error', 'Missing payment reference.');
+        }
+
+        try {
+            $sale = $this->sales->completePayCheckout($reference);
+        } catch (RuntimeException $e) {
+            return redirect()->route('pos.sales.show', $sale)->with('error', $e->getMessage());
+        }
+
+        return redirect()
+            ->route('pos.sales.show', $sale)
+            ->with('success', 'Payment received.');
+    }
+}

app/Http/Controllers/Pos/SettingsController.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Http\Controllers\Pos;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
+use App\Services\Import\CrmProductImportService;
+use App\Services\Import\MerchantCatalogImportService;
+use App\Services\Pos\PosLocationService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use RuntimeException;
+
+class SettingsController extends Controller
+{
+    use ScopesToAccount;
+
+    public function __construct(private PosLocationService $locations) {}
+
+    public function index(Request $request): View
+    {
+        $location = $this->locations->ensureDefault($this->ownerRef($request));
+
+        return view('pos.settings', [
+            'location' => $location,
+            'merchantImportEnabled' => (bool) config('pos.merchant_import_enabled', true),
+        ]);
+    }
+
+    public function update(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'name' => ['required', 'string', 'max:120'],
+            'currency' => ['required', 'string', 'size:3'],
+            'receipt_footer' => ['nullable', 'string', 'max:1000'],
+        ]);
+
+        $location = $this->locations->ensureDefault($this->ownerRef($request));
+        $location->update([
+            'name' => $data['name'],
+            'currency' => strtoupper($data['currency']),
+            'receipt_footer' => $data['receipt_footer'] ?? null,
+        ]);
+
+        return back()->with('success', 'Settings saved.');
+    }
+
+    public function importCrm(Request $request, CrmProductImportService $import): RedirectResponse
+    {
+        try {
+            $result = $import->import($this->ownerRef($request));
+
+            return back()->with('success', "Imported {$result['imported']} product(s), updated {$result['updated']}.");
+        } catch (RuntimeException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+    }
+
+    public function importMerchant(Request $request, MerchantCatalogImportService $import): RedirectResponse
+    {
+        try {
+            $result = $import->import($this->ownerRef($request));
+
+            return back()->with('success', "Imported {$result['imported']} item(s) from {$result['storefronts']} storefront(s), updated {$result['updated']}.");
+        } catch (RuntimeException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+    }
+}