Qasirku adalah platform kasir pintar (Point of Sale) dan manajemen inventori modern yang dirancang khusus untuk mempermudah operasional ritel, grosir, minimarket, dan UMKM. Sistem ini mengintegrasikan transaksi kasir harian dengan kontrol stok berbasis metode FIFO (First In First Out) untuk perhitungan HPP (Harga Pokok Penjualan) dan margin keuntungan kotor yang presisi secara real-time.

Aplikasi ini dibangun menggunakan arsitektur modern berbasis Laravel 13, Inertia.js, dan Vue 3 (TypeScript). Desain antarmukanya premium bergaya dashboard minimalis profesional dengan dukungan Dark Mode penuh dan skema warna aksen Biru (Blue Theme).

---

✨ High Value & Keunggulan Sistem

Qasirku bukan sekadar aplikasi kasir biasa, melainkan alat kontrol finansial dan stok terintegrasi dengan nilai tinggi bagi pemilik usaha:

1. Metode FIFO & HPP Presisi Tinggi
   Harga kulakan barang sering kali naik-turun akibat fluktuasi pasar. Qasirku melacak stok per batch masuk beserta harga belinya. Saat penjualan terjadi, sistem otomatis memotong stok dari batch tertua dan mencatat harga modal beli aslinya sebagai HPP. Margin laba kotor Anda terhitung 100% akurat.
2. Offline-First POS Terminal
   Katalog produk disimpan di IndexedDB browser lokal secara terenkripsi. Ketika koneksi internet terputus, kasir tetap bisa memindai barcode, memasukkan keranjang, dan melakukan transaksi. Begitu sinyal online kembali, transaksi akan otomatis tersinkronisasi ke server.
3. Shift Control Kasir (Anti-Selisih)
   Mengamankan arus uang laci kasir (cash drawer). Kasir diwajibkan melakukan Buka Shift dengan memasukkan modal awal. Saat Tutup Shift, sistem menampilkan kas yang diharapkan (modal awal + penjualan tunai bersih) dan membandingkannya dengan uang fisik aktual di laci untuk mendeteksi selisih secara otomatis.
4. Loyalty Membership & Poin Reward
   Tingkatkan retensi pelanggan dengan sistem membership. Setiap pembelanjaan kelipatan Rp10.000 otomatis memberikan 1 Poin Reward kepada member yang dapat diakumulasikan. POS Terminal menampilkan proyeksi poin baru secara langsung di layar kasir.
5. Retur Barang Konsisten Berbasis FIFO
   • Retur Penjualan: Mengembalikan kuantitas barang ke batch asal transaksi tersebut untuk memulihkan umur produk dan HPP asli.
   • Retur Pembelian: Mengurangi stok dari batch pembelian ke supplier. Sistem menolak retur jika stok batch tersebut sudah terlanjur terjual demi mencegah selisih stok.
6. Multi-Outlet dengan Hak Akses Terisolasi (RBAC)
   Pengaturan cabang terisolasi memastikan staff outlet hanya bisa mengelola stok, mutasi, dan transaksi cabang tempat mereka bertugas, sementara owner memantau seluruh cabang dari dashboard tunggal.

---

🚀 Fitur Utama & Modul

1. Master Data & Inventori

• Kategori Produk: Pengelompokan produk terstruktur untuk memudahkan pencarian dan penyaringan laporan.
• Multi-Satuan Produk (ProductUnit): Mendukung penjualan dalam unit dasar (Pcs) maupun unit kemasan grosir (Dus, Karton, Pack) dengan auto-konversi stok.
• Manajemen Supplier: Pencatatan data supplier untuk memantau asal pengadaan stok barang.
• FIFO Batch Inventory: Pelacakan kedaluwarsa (expiry date) dan lokasi rak (rack location) per batch produk.
• Mutasi Stok Antar-Outlet: Pengiriman stok fisik antar-cabang dengan sistem persetujuan (approval flow) formal.

2. POS Kasir (Point of Sale)

• Diskon Fleksibel per Item: Input diskon flat (Rupiah/Rp) maupun persentase (%) pada masing-masing item keranjang belanja.
• Diskon & Pajak Transaksi: Input diskon global transaksi dan perhitungan otomatis PPN 11% secara real-time.
• Multi Metode Pembayaran: Tunai (Cash), E-Wallet (QRIS), Debit/Kredit, dan Split Payment.
• Scan Barcode Cepat: Pemindai barcode otomatis dengan Web Audio API beep indicator.
• Hold & Resume: Tunda transaksi pelanggan saat antrean kasir sedang ramai.

3. Keuangan & Laporan

• Dashboard Grafik Dinamis (ApexCharts): Visualisasi omset bulanan, pertumbuhan persentase dibanding bulan lalu, tren harian, dan diagram donat pembayaran.
• Laporan Laba Rugi & Margin: Deteksi real-time gross profit margin per transaksi berdasarkan HPP FIFO asli.
• Outlet Terbaik (KPI): Menampilkan outlet cabang dengan kinerja penjualan tertinggi bulan berjalan.

---

📊 Alur Kerja Sistem (Workflow)

1. Alur Kontrol Shift Kasir POS

Mencegah kasir melakukan checkout sebelum membuka shift kerja di laci kasir cabang.

2. Alur Transaksi Kasir POS (FIFO Cost & Margin Tracking)

Proses pemotongan batch FIFO terlama dan pencatatan laba kotor presisi.

3. Alur Retur Penjualan (FIFO Stock Recovery)

Mengembalikan produk ke batch asal demi menjaga keakuratan umur dan HPP barang.

---

🗄️ Struktur Database & Relasi (ERD)

Rincian Tabel Database:

1. users: Profil kasir, manager, dan admin.
2. outlets: Daftar outlet/cabang usaha toko fisik.
3. user_outlet: Tabel jembatan pembatas hak akses outlet pengguna (RBAC).
4. categories: Menyimpan kategori produk (kategori makanan, minuman, dll).
5. suppliers: Data supplier pengadaan barang.
6. customers: Data pelanggan & membership poin loyalitas.
7. products: Data barang (SKU, nama, barcode, harga jual default, kategori).
8. product_units: Satuan kemasan multi-unit konversi (misal: Dus = 40 Pcs) beserta barcode unitnya.
9. inventory_batches: Buku pencatatan batch FIFO (menyimpan sisa kuantitas, lokasi rak, harga modal beli, tanggal kedaluwarsa).
10. cashier_shifts: Rekap shift kasir (mulai, selesai, modal awal, kas diharapkan, kas aktual, selisih kas).
11. transactions: Invoice penjualan POS (total belanja, diskon global, pajak PPN, metode pembayaran, cash/ewallet/card amount, kembalian, member, status).
12. transaction_items: Rincian item terjual yang mengikat ke batch asal untuk penarikan HPP modal beli asli dan menyimpan diskon per baris item.
13. sale_returns: Dokumen retur penjualan barang dari pelanggan.
14. sale_return_items: Rincian produk dan batch asal yang diretur pada retur penjualan.
15. purchases: Transaksi pembelian barang masuk (supplier, outlet penerima, tanggal, total nominal).
16. purchase_items: Rincian produk yang dibeli beserta informasi batch stok FIFO yang digenerate.
17. purchase_returns: Dokumen retur pembelian barang kembali ke supplier.
18. purchase_return_items: Rincian produk dan batch yang dikurangi akibat retur pembelian.
19. stock_mutations: Master dokumen perpindahan stok fisik antar-outlet.
20. stock_mutation_items: Detail item produk/batch yang didelegasikan untuk dimutasi.
21. settings: Konfigurasi global sistem (site logo, favicon, QRIS image, opsi min stock).
22. licenses: Penyimpan kunci verifikasi lisensi lokal terenkripsi.

---

📂 Struktur Folder Utama Proyek

qasirku/
├── app/                         # 🧠 LOGIK BACKEND UTAMA (PHP)
│   ├── Http/
│   │   ├── Controllers/         # Controller logika data & render Inertia
│   │   │   ├── POSController.php      # Logika kasir offline/online & FIFO
│   │   │   ├── ShiftController.php    # Buka/tutup shift & riwayat shift
│   │   │   ├── ReturnController.php   # Retur penjualan & pembelian (FIFO)
│   │   │   └── ...
│   │   └── Middleware/          # Filter Keamanan (CheckLicense, DemoModeMiddleware)
│   ├── Models/                  # Model Eloquent Database (Relationship)
│   │   ├── License.php
│   │   ├── InventoryBatch.php
│   │   ├── CashierShift.php
│   │   ├── Customer.php
│   │   └── ...
├── database/                    # 🗄️ SKEMA & SEEDER
│   ├── migrations/              # Berkas migrasi pembuatan tabel POS & FIFO
│   └── seeders/                 # Seeder master (Roles, Settings, Menus) & DummyDataSeeder
├── resources/                   # 🎨 FRONTEND VUE 3 & TYPESCRIPT
│   ├── css/                     # CSS & custom styling
│   └── js/                      # Kode Vue 3
│       ├── Components/          # Komponen UI (AlertDialog, Modal, DemoModeBanner)
│       ├── Layouts/             # Layout Dashboard (AdminLayout dengan global flash alerts)
│       └── Pages/               # Halaman UI (POS, Products, Inventory, Shifts, Customers)

---

💻 Panduan Instalasi Lokal di Windows (Non-Docker)

Tahap 1: Prasyarat Software

• Pasang Laragon atau XAMPP dengan PHP minimal versi 8.2.
• Pasang Node.js (Rekomendasi versi LTS 20).
• Pasang Composer & Git for Windows.

Tahap 2: Langkah Instalasi

1. Clone / Download Source Code:

   git clone <repository-url> qasirku
   cd qasirku
   

2. Salin Konfigurasi Environment:

   cp .env.example .env
   

3. Setup Database di File .env:
   Pastikan Anda telah membuat database kosong bernama qasirku di MySQL Anda, kemudian sesuaikan parameter koneksi di file .env:

   DB_C
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=qasirku
   DB_USERNAME=root
   DB_PASSWORD=your_mysql_password
   

4. Instal Dependensi & Generate Key:

   composer install
   npm install
   php artisan key:generate
   

5. Migrasi Tabel & Dummy Data:
   Untuk mempermudah pengujian alur penjualan POS, sangat disarankan menggunakan pilihan seeding dummy data agar database terisi data outlet, produk multi-satuan, kategori, supplier, member, batch aktif, histori grafik trend laporan, dan shift kasir aktif:

   php artisan migrate:fresh --seed
   php artisan db:seed --class=DummyDataSeeder
   

6. Jalankan Server Lokal:
   Aktifkan web server PHP dan compiler Vue secara bersamaan di dua terminal:
   • Terminal 1: php artisan serve
   • Terminal 2: npm run dev
     Akses aplikasi melalui browser di: http://127.0.0.1:8000

---

🔑 Akun Demo Pengujian

Gunakan akun demo di bawah ini untuk menguji hak akses RBAC (Role-Based Access Control) Qasirku:

Role Peran	Email Login	Password	Penugasan Outlet Default
Super Admin	superadmin@example.com	password	Bebas Akses Semua Outlet
Admin User	admin@example.com	password	Outlet Jakarta & Surabaya
Manager User	manager@example.com	password	Outlet Jakarta & Bandung
Kasir User	cashier@example.com	password	Dibatasi ke Outlet Jakarta Saja

---

🐳 Panduan Deployment Menggunakan Docker

Sistem orkestrasi Docker Compose Qasirku telah dikonfigurasi lengkap untuk siap di-deploy pada server Linux VPS Ubuntu produksi menggunakan container Nginx + PHP-FPM + MySQL + Redis.

Cara Deploy Cepat:

1. Clone Project atau Upload Folder ke Server:

   git clone <repository-url> /var/www/qasirku
   cd /var/www/qasirku
   

2. Buat File Environment Produksi:

   cp .env.example .env
   nano .env
   

   Atur APP_ENV=production, APP_DEBUG=false, DB_C DB_HOST=mysql`, dan atur password database MySQL yang aman.
3. Bangun Container (Multi-stage Node & PHP Build):

   docker compose -f docker-compose.prod.yml up -d --build
   

4. Inisialisasi Laravel Dalam Container:

   docker compose -f docker-compose.prod.yml exec app php artisan key:generate
   docker compose -f docker-compose.prod.yml exec app php artisan migrate --force
   docker compose -f docker-compose.prod.yml exec app php artisan db:seed --force
   docker compose -f docker-compose.prod.yml exec app php artisan storage:link
   
   # Caching optimasi rute & config
   docker compose -f docker-compose.prod.yml exec app php artisan config:cache
   docker compose -f docker-compose.prod.yml exec app php artisan route:cache
   docker compose -f docker-compose.prod.yml exec app php artisan view:cache
   

---

🔑 Modul Proteksi Lisensi

1. Bypass Lisensi Otomatis (Local/Dev):
   Sistem verifikasi lisensi tidak akan aktif bila dijalankan di lingkungan pengembangan lokal:
   • .env diatur APP_ENV=local atau APP_ENV=testing.
   • Host domain berupa: localhost, 127.0.0.1, IP private LAN (192.168.*, 10.*), domain .test atau .local.
2. Kunci Lisensi Produksi:
   Di server produksi online, middleware license.verify akan mengunci sistem dan memaksa redirect ke /admin/license/activate sampai dimasukkan lisensi valid. Lisensi terikat pada APP_KEY. Jangan men-generate ulang APP_KEY setelah melakukan aktivasi lisensi.

---

Developed with ❤️ for Retailers. Copyright © 2026. All rights reserved.