🛒 Waroong POS

Aplikasi kasir modern untuk warung kelontong Indonesia

Dibangun di atas Laravel + FilamentPHP. Multi-tenant, mobile-friendly, dan siap pakai.

---

Fitur Utama

Fitur	Keterangan
🧾 Kasir	Keranjang belanja, auto-kalkulasi subtotal & total
💵 Nominal Kembalian	Pilih nominal uang diterima, sistem hitung kembalian otomatis
💳 Multi Pembayaran	Tunai, QRIS (upload bukti), Kasbon
📒 Manajemen Kasbon	Tracking utang & pelunasan per pelanggan
📊 Dashboard	Omset, keuntungan, kasbon aktif, produk terlaris & stok menipis
📈 Laporan	Export transaksi per periode ke CSV (Excel) atau cetak PDF
🗂️ Riwayat Stok	Log otomatis setiap keluar masuk stok
🖨️ Cetak Struk	Format thermal 58mm, auto-print, nama & alamat toko
📷 Barcode Scanner	Scanner fisik & kamera HP
🏪 Pengaturan Toko	Nama, alamat, dan nomor HP toko tampil di struk
🏪 Multi-Tenant	Tiap user punya warung & katalog sendiri
🔐 Login Google	Daftar & masuk cukup dengan akun Google

---

Tech Stack

• Laravel 10 — Backend framework
• FilamentPHP v3 — Admin panel (TALL Stack)
• Laravel Socialite — Google OAuth
• MySQL — Database

---

Instalasi

1. Clone & Install

git clone https://github.com/akbarr13/waroong.git
cd waroong
composer install
cp .env.example .env
php artisan key:generate

2. Konfigurasi Database

Edit .env:

DB_DATABASE=waroong
DB_USERNAME=root
DB_PASSWORD=

3. Setup Google OAuth

1. Buka Google Cloud Console
2. Buat project → APIs & Services → Credentials → Create OAuth 2.0 Client ID
3. Pilih tipe Web application
4. Tambahkan Authorized redirect URI:

   http://localhost:8000/auth/google/callback
   

5. Salin Client ID & Secret ke .env:

GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/google/callback

4. Migrasi & Jalankan

php artisan migrate
php artisan storage:link
php artisan serve

Buka http://localhost:8000/admin dan login dengan Google.

---

Pengaturan Toko

Setelah login, klik avatar di pojok kanan atas → Profile untuk mengisi:

• Nama Toko
• Alamat Toko
• No. HP Toko

Informasi ini akan otomatis tampil di setiap struk yang dicetak.

---

Lisensi

MIT — bebas digunakan dan dimodifikasi.