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>

database/.gitignore

@@ -0,0 +1 @@
+*.sqlite*

database/factories/UserFactory.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Str;
+
+/**
+ * @extends Factory<User>
+ */
+class UserFactory extends Factory
+{
+    /**
+     * The current password being used by the factory.
+     */
+    protected static ?string $password;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => fake()->name(),
+            'email' => fake()->unique()->safeEmail(),
+            'email_verified_at' => now(),
+            'password' => static::$password ??= Hash::make('password'),
+            'remember_token' => Str::random(10),
+        ];
+    }
+
+    /**
+     * Indicate that the model's email address should be unverified.
+     */
+    public function unverified(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'email_verified_at' => null,
+        ]);
+    }
+}

database/migrations/0001_01_01_000000_create_users_table.php

@@ -0,0 +1,52 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Local mirror of the platform identity, keyed by public_id (OIDC sub).
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->uuid('public_id')->unique();
+            $table->string('name')->nullable();
+            $table->string('email')->unique();
+            $table->string('avatar_url')->nullable();
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password')->nullable();
+            $table->rememberToken();
+            $table->timestamps();
+        });
+
+        Schema::create('password_reset_tokens', function (Blueprint $table) {
+            $table->string('email')->primary();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+
+        Schema::create('sessions', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->foreignId('user_id')->nullable()->index();
+            $table->string('ip_address', 45)->nullable();
+            $table->text('user_agent')->nullable();
+            $table->longText('payload');
+            $table->integer('last_activity')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('users');
+        Schema::dropIfExists('password_reset_tokens');
+        Schema::dropIfExists('sessions');
+    }
+};

database/migrations/0001_01_01_000001_create_cache_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('cache', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->mediumText('value');
+            $table->integer('expiration')->index();
+        });
+
+        Schema::create('cache_locks', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->string('owner');
+            $table->integer('expiration')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('cache');
+        Schema::dropIfExists('cache_locks');
+    }
+};

database/migrations/0001_01_01_000002_create_jobs_table.php

@@ -0,0 +1,57 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('queue')->index();
+            $table->longText('payload');
+            $table->unsignedTinyInteger('attempts');
+            $table->unsignedInteger('reserved_at')->nullable();
+            $table->unsignedInteger('available_at');
+            $table->unsignedInteger('created_at');
+        });
+
+        Schema::create('job_batches', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->string('name');
+            $table->integer('total_jobs');
+            $table->integer('pending_jobs');
+            $table->integer('failed_jobs');
+            $table->longText('failed_job_ids');
+            $table->mediumText('options')->nullable();
+            $table->integer('cancelled_at')->nullable();
+            $table->integer('created_at');
+            $table->integer('finished_at')->nullable();
+        });
+
+        Schema::create('failed_jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('uuid')->unique();
+            $table->text('connection');
+            $table->text('queue');
+            $table->longText('payload');
+            $table->longText('exception');
+            $table->timestamp('failed_at')->useCurrent();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('jobs');
+        Schema::dropIfExists('job_batches');
+        Schema::dropIfExists('failed_jobs');
+    }
+};

database/migrations/2026_05_28_200000_create_qr_product_tables.php

@@ -0,0 +1,101 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('qr_wallets', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->unique()->constrained()->cascadeOnDelete();
+            $table->decimal('credit_balance', 10, 4)->default(0);
+            $table->unsignedInteger('qr_codes_total')->default(0);
+            $table->unsignedBigInteger('scans_total')->default(0);
+            $table->string('status', 20)->default('active');
+            $table->timestamps();
+        });
+
+        Schema::create('qr_documents', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->string('title')->nullable();
+            $table->string('disk', 32)->default('qr');
+            $table->string('path');
+            $table->string('mime_type', 128)->default('application/pdf');
+            $table->unsignedBigInteger('size_bytes')->default(0);
+            $table->unsignedSmallInteger('page_count')->nullable();
+            $table->timestamps();
+
+            $table->index(['user_id', 'created_at']);
+        });
+
+        Schema::create('qr_codes', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->string('short_code', 16)->unique();
+            $table->string('type', 32);
+            $table->string('label');
+            $table->text('destination_url')->nullable();
+            $table->foreignId('qr_document_id')->nullable()->constrained('qr_documents')->nullOnDelete();
+            $table->json('payload')->nullable();
+            $table->boolean('is_active')->default(true);
+            $table->string('png_path')->nullable();
+            $table->string('svg_path')->nullable();
+            $table->unsignedBigInteger('scans_total')->default(0);
+            $table->unsignedBigInteger('unique_scans_total')->default(0);
+            $table->timestamp('last_scanned_at')->nullable();
+            $table->timestamp('destination_updated_at')->nullable();
+            $table->timestamps();
+
+            $table->index(['user_id', 'created_at']);
+            $table->index(['user_id', 'is_active']);
+        });
+
+        Schema::create('qr_transactions', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('qr_wallet_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('qr_code_id')->nullable()->constrained()->nullOnDelete();
+            $table->string('type', 16);
+            $table->decimal('amount_ghs', 10, 4);
+            $table->decimal('balance_after_ghs', 10, 4);
+            $table->string('reference')->nullable()->index();
+            $table->string('status', 20)->default('completed');
+            $table->string('description')->nullable();
+            $table->json('metadata')->nullable();
+            $table->timestamps();
+
+            $table->index(['qr_wallet_id', 'created_at']);
+        });
+
+        Schema::create('qr_scan_events', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('qr_code_id')->constrained()->cascadeOnDelete();
+            $table->timestamp('scanned_at');
+            $table->string('ip_hash', 64)->nullable();
+            $table->text('user_agent')->nullable();
+            $table->string('device_type', 32)->nullable();
+            $table->string('browser', 64)->nullable();
+            $table->string('os', 64)->nullable();
+            $table->string('country_code', 8)->nullable();
+            $table->string('referrer')->nullable();
+            $table->boolean('is_unique')->default(false);
+            $table->timestamps();
+
+            $table->index(['qr_code_id', 'scanned_at']);
+            $table->index(['qr_code_id', 'ip_hash']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('qr_scan_events');
+        Schema::dropIfExists('qr_transactions');
+        Schema::dropIfExists('qr_codes');
+        Schema::dropIfExists('qr_documents');
+        Schema::dropIfExists('qr_wallets');
+    }
+};

database/migrations/2026_05_31_000001_widen_qr_codes_short_code.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('qr_codes', function (Blueprint $table) {
+            $table->string('short_code', 32)->change();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('qr_codes', function (Blueprint $table) {
+            $table->string('short_code', 16)->change();
+        });
+    }
+};

database/migrations/2026_06_05_075448_create_personal_access_tokens_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('personal_access_tokens', function (Blueprint $table) {
+            $table->id();
+            $table->morphs('tokenable');
+            $table->text('name');
+            $table->string('token', 64)->unique();
+            $table->text('abilities')->nullable();
+            $table->timestamp('last_used_at')->nullable();
+            $table->timestamp('expires_at')->nullable()->index();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('personal_access_tokens');
+    }
+};

database/migrations/2026_06_06_200000_create_notifications_table.php

@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('notifications', function (Blueprint $table) {
+            $table->uuid('id')->primary();
+            $table->string('type');
+            $table->morphs('notifiable');
+            $table->text('data');
+            $table->timestamp('read_at')->nullable();
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('notifications');
+    }
+};

database/migrations/2026_06_06_210000_create_qr_team_members_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('qr_team_members', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('account_id')->index();
+            $table->unsignedBigInteger('user_id')->nullable()->index();
+            $table->string('email');
+            $table->string('role', 20)->default('member');
+            $table->string('status', 20)->default('invited');
+            $table->string('token', 64)->nullable();
+            $table->timestamp('accepted_at')->nullable();
+            $table->timestamps();
+
+            $table->unique(['account_id', 'email']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('qr_team_members');
+    }
+};

database/migrations/2026_06_06_220000_create_qr_settings_table.php

@@ -0,0 +1,27 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('qr_settings', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->unique()->constrained()->cascadeOnDelete();
+            $table->string('notify_email')->nullable();
+            $table->boolean('product_updates')->default(true);
+            $table->boolean('low_balance_alerts')->default(true);
+            $table->string('default_type', 32)->nullable();
+            $table->json('default_style')->nullable();
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('qr_settings');
+    }
+};

database/migrations/2026_06_07_200000_create_mini_payments_table.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('mini_payments', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('qr_code_id')->constrained('qr_codes')->cascadeOnDelete();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->string('reference', 32)->unique();
+            $table->unsignedInteger('amount_minor');
+            $table->string('currency', 3)->default('GHS');
+            $table->unsignedInteger('platform_fee_minor')->default(0);
+            $table->unsignedInteger('merchant_amount_minor')->default(0);
+            $table->string('payer_name')->nullable();
+            $table->string('payer_email')->nullable();
+            $table->string('payer_phone', 32)->nullable();
+            $table->string('payer_note')->nullable();
+            $table->string('status', 16)->default('pending');
+            $table->string('payment_reference', 64)->nullable()->unique();
+            $table->timestamp('paid_at')->nullable();
+            $table->json('metadata')->nullable();
+            $table->timestamps();
+
+            $table->index(['user_id', 'status', 'paid_at']);
+            $table->index(['qr_code_id', 'status']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('mini_payments');
+    }
+};

database/migrations/2026_06_08_130000_add_pay_order_id_to_mini_payments_table.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('mini_payments', function (Blueprint $table) {
+            $table->unsignedBigInteger('pay_order_id')->nullable()->after('id');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('mini_payments', function (Blueprint $table) {
+            $table->dropColumn('pay_order_id');
+        });
+    }
+};

database/migrations/2026_06_11_120000_create_user_push_tokens_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('user_push_tokens', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->string('token', 512)->unique();
+            $table->string('platform', 32)->default('android');
+            $table->string('device_name')->nullable();
+            $table->timestamp('last_seen_at')->nullable();
+            $table->timestamps();
+
+            $table->index(['user_id', 'updated_at']);
+        });
+
+        Schema::table('users', function (Blueprint $table) {
+            $table->timestamp('last_app_active_at')->nullable()->after('remember_token');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->dropColumn('last_app_active_at');
+        });
+
+        Schema::dropIfExists('user_push_tokens');
+    }
+};

database/migrations/2026_06_12_120000_add_auto_withdraw_to_qr_settings_table.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('qr_settings', function (Blueprint $table) {
+            $table->unsignedBigInteger('auto_withdraw_amount_minor')->nullable();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('qr_settings', function (Blueprint $table) {
+            $table->dropColumn('auto_withdraw_amount_minor');
+        });
+    }
+};

database/migrations/2026_06_26_100000_create_pos_tables.php

@@ -0,0 +1,76 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('pos_locations', function (Blueprint $table) {
+            $table->id();
+            $table->string('owner_ref')->index();
+            $table->string('name');
+            $table->string('currency', 3)->default('GHS');
+            $table->text('receipt_footer')->nullable();
+            $table->timestamps();
+        });
+
+        Schema::create('pos_products', function (Blueprint $table) {
+            $table->id();
+            $table->string('owner_ref')->index();
+            $table->foreignId('location_id')->nullable()->constrained('pos_locations')->nullOnDelete();
+            $table->string('name');
+            $table->string('sku')->nullable();
+            $table->unsignedInteger('price_minor');
+            $table->string('currency', 3)->default('GHS');
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+
+            $table->index(['owner_ref', 'is_active']);
+        });
+
+        Schema::create('pos_sales', function (Blueprint $table) {
+            $table->id();
+            $table->string('owner_ref')->index();
+            $table->foreignId('location_id')->nullable()->constrained('pos_locations')->nullOnDelete();
+            $table->string('reference')->unique();
+            $table->string('status')->default('pending'); // pending | paid | failed | cancelled
+            $table->string('payment_method')->default('pay'); // pay | cash
+            $table->unsignedBigInteger('pay_order_id')->nullable();
+            $table->string('payment_reference')->nullable()->index();
+            $table->string('customer_name')->nullable();
+            $table->string('customer_email')->nullable();
+            $table->string('customer_phone', 40)->nullable();
+            $table->unsignedBigInteger('crm_customer_id')->nullable();
+            $table->unsignedInteger('subtotal_minor')->default(0);
+            $table->unsignedInteger('total_minor')->default(0);
+            $table->string('currency', 3)->default('GHS');
+            $table->timestamp('paid_at')->nullable();
+            $table->timestamps();
+
+            $table->index(['owner_ref', 'status', 'created_at']);
+        });
+
+        Schema::create('pos_sale_lines', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('pos_sale_id')->constrained('pos_sales')->cascadeOnDelete();
+            $table->foreignId('product_id')->nullable()->constrained('pos_products')->nullOnDelete();
+            $table->string('name');
+            $table->unsignedInteger('unit_price_minor');
+            $table->unsignedInteger('quantity')->default(1);
+            $table->unsignedInteger('line_total_minor');
+            $table->unsignedSmallInteger('position')->default(0);
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('pos_sale_lines');
+        Schema::dropIfExists('pos_sales');
+        Schema::dropIfExists('pos_products');
+        Schema::dropIfExists('pos_locations');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\User;
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+use Database\Seeders\HostingProductSeeder;
+
+class DatabaseSeeder extends Seeder
+{
+    use WithoutModelEvents;
+
+    /**
+     * Seed the application's database.
+     */
+    public function run(): void
+    {
+        $this->call([
+            HostingProductSeeder::class,
+        ]);
+        // User::factory(10)->create();
+
+        User::factory()->create([
+            'name' => 'Test User',
+            'email' => 'test@example.com',
+        ]);
+    }
+}

database/seeders/HostingNodeSeeder.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\HostingNode;
+use Illuminate\Database\Seeder;
+
+class HostingNodeSeeder extends Seeder
+{
+    public function run(): void
+    {
+        HostingNode::firstOrCreate(
+            ['provider' => 'local', 'ip_address' => '127.0.0.1'],
+            [
+                'name' => 'Primary Server',
+                'hostname' => gethostname() ?: 'localhost',
+                'ip_address' => '127.0.0.1',
+                'ipv6_address' => '::1',
+                'type' => 'shared',
+                'segment' => 'general',
+                'provider' => 'local',
+                'cpu_cores' => 4,
+                'ram_mb' => 8192,
+                'disk_gb' => 150,
+                'oversell_ratio' => 3,
+                'bandwidth_tb' => 10,
+                'max_accounts' => 100,
+                'current_accounts' => 0,
+                'status' => 'active',
+                'ssh_port' => 22,
+                'features' => ['php', 'mysql', 'nginx', 'ssl'],
+                'installed_software' => [
+                    'php' => ['8.1', '8.2', '8.3'],
+                    'mysql' => '8.0',
+                    'nginx' => '1.24',
+                ],
+            ]
+        );
+    }
+}