Kios Maksen - POS Retail & B2B Wholesale Supply Engine with Real-Time Customer Display

Latar Belakang & Tantangan Bisnis
Toko ritel dan distributor sembako/grosir sering kali menghadapi kendala efisiensi operasional akibat pemisahan antara sistem kasir toko fisik dan sistem pemesanan mitra gerai. Beberapa tantangan utama meliputi:

• Transparansi Transaksi Kasir: Pembeli tidak memiliki visibilitas langsung saat kasir memindai item dan menghitung uang kembalian.
• Audit Fisik & Kas Kasir: Sering terjadi selisih kas antara pergantian shift kerja tanpa rekonsiliasi yang ketat.
• Kompleksitas Multi-Satuan Produk: Penjualan dilakukan dalam eceran (pcs/satuan terkecil) maupun grosir (renceng, pak, dus, karton) yang membebani pencatatan stok fisik.
• Alur Pengadaan Mitra B2B: Pemesanan grosir dari gerai mitra masih manual, rentan kesalahan verifikasi pembayaran, serta lambat dalam penerbitan berkas resmi (Surat Jalan dan Faktur Penjualan).

Solusi yang Dikembangkan
Sistem Kios Maksen dibangun sebagai solusi full-stack end-to-end yang menyatukan lini penjualan langsung di kasir toko dan kanal distribusi B2B:

• Point of Sale (POS) & Audio Feedback: Fitur pemindaian barcode responsif menggunakan barcode scanner fisik maupun kamera perangkat terintegrasi, dilengkapi sintesis audio oscillator frekuensi tinggi/rendah via Web Audio API untuk konfirmasi scan.
• Reactive Customer-Facing Display (CFD): Layar monitor sekunder yang menghadap ke pelanggan untuk menampilkan daftar belanjaan, subtotal, nominal bayar, dan uang kembalian secara instan (0-latency) memanfaatkan browser BroadcastChannel API tanpa bergantung pada websocket eksternal.
• Siklus Laci Kasir (Cash Register): Validasi ketat buka-tutup shift laci kasir (open/close shift) dengan input saldo awal, audit setoran fisik, serta penguncian transaksi POS jika laci belum berstatus dibuka.
• Portal Pengadaan Mandiri Mitra B2B: Katalog khusus gerai mitra untuk memesan barang dalam satuan grosir, alur persetujuan PO (Purchase Order), penerbitan dokumen resmi siap cetak (Purchase Order, Delivery Order / Surat Jalan, dan Faktur Komersial), hingga notifikasi reaktif berbasis view composer.
• Keamanan & Otorisasi Bertingkat: Manajemen role-based access control (RBAC) via Spatie Laravel-Permission, mencakup peran Super Admin, Kepala Toko, Kasir, dan Mitra Terverifikasi dengan validasi status akun (pending approval).

Arsitektur & Teknologi (Tech Stack)

• Backend Framework: PHP 8.2+, Laravel 11 / 12
• Frontend & Interaktivitas: Tailwind CSS, Alpine.js, Blade Components
• Database & ORM: MySQL, Eloquent ORM dengan relasi multi-satuan & konversi otomatis kuantitas stok
• Autentikasi & Otorisasi: Laravel Breeze / Session Guard, Spatie Laravel-Permission
• Komunikasi Browser Real-Time: Web BroadcastChannel API & Web Audio API
• Barcode Processing: Html5-QRCode & Hardware Barcode Gun Buffer Listener

Fitur-Fitur Utama

• Real-time Dual Display Sync: Sinkronisasi data keranjang belanja dan kembalian uang kasir ke layar pelanggan tanpa perlu refresh halaman.
• Dynamic In-App Notification System: Notifikasi berbasis event operasional dengan mekanisme dismiss/mark-all-read persisten per akun tanpa bloating tabel.
• Multi-Unit Inventory Conversion: Satu produk dapat memiliki banyak barcode dan satuan berbeda (misal: 1 Dus = 40 Pcs), dengan pemotongan kuota otomatis pada basis unit terkecil.
• Onboarding Mitra Terkontrol: Registrasi gerai mitra dengan penahanan akses login (unauthorized block) hingga diverifikasi oleh admin toko.
• Print-Ready Document Templates: Templat blade terstandarisasi untuk cetak struk kasir termal serta dokumen faktur dan surat jalan berformat A4/Surat Niaga.

Dampak & Hasil Akhir
Platform ini memangkas waktu input transaksi kasir, meniadakan selisih uang kas saat pergantian shift melalui rekonsiliasi digital, meningkatkan transparansi pembeli di meja kasir, serta memberikan kemandirian penuh bagi mitra grosir dalam mengelola rantai pasok gerai mereka secara profesional.