Pisang Goreng Wijen

Pengenalan

👥 Tiga Peran Utama Aplikasi

Sistem ini tidak memerlukan kartu fisik. Pelanggan hanya perlu menggunakan Nomor WhatsApp mereka.

📱 Halaman Utama (`/`)

Pelanggan (Customer)

✔️ Cek Stamp Mandiri cukup ketik nomor HP.
✔️ Klaim Kode Unik dari struk pembelian.
✔️ Klaim Hadiah (Tier 3, 6, 10 Stamp).
✔️ Notifikasi WhatsApp saat stamp bertambah.

🏪 Halaman Kasir (`/cashier`)

Kasir (Cashier)

✔️ Beri Stamp Langsung di meja kasir (Walk-in).
✔️ Buat Kode Batch untuk dicetak di struk.
✔️ Void Batch membatalkan kode yang salah buat.
✔️ Validasi Hadiah menukarkan voucher pelanggan.

👑 Dasbor Owner (`/owner`)

Pemilik (Owner)

✔️ Analitik Bisnis total pelanggan & stamp.
✔️ Manajemen Kasir tambah/nonaktifkan kasir.
✔️ Audit Ketat pantau kasir pembuat kode.
✔️ 2-Step Security Login Password + PIN 6 Digit.

Sandbox / Testing

🔑 Akun Demo Siap Pakai

Gunakan kredensial berikut untuk melakukan pengujian langsung pada aplikasi.

👑 Akun Pemilik (Owner)Buka `/owner` →

Email: owner@dev.test

Password: test

PIN 6 Digit: 000000

💡 Wajib melewati Step 1 (Email & Password), lalu Step 2 (PIN 6-digit).

🏪 Akun Kasir (Cashier)Buka `/cashier` →

Username: test

PIN Kasir: 000000

💡 Gunakan ini untuk memberi stamp walk-in atau mencetak kode batch.

Panduan Praktis

📖 Alur Penggunaan Lengkap

Langkah-langkah operasional yang dilakukan dalam kegiatan sehari-hari di toko.

Skenario 1: Kasir Memberi Stamp Walk-in (Langsung di Kasir)

Kasir membuka /cashier dan masuk dengan username test & PIN 000000.
Pelanggan berbelanja dan menyebutkan nomor WhatsApp (misal: 08123456789).
Kasir mengetik nomor tersebut di kolom "Beri Stamp (Walk-in)" dan menekan "Tambah".
Stamp langsung masuk ke akun pelanggan! Sistem mencatat Kasir test sebagai pemberi stamp pada waktu tersebut.

Skenario 2: Kasir Mencetak Kode Batch (Untuk Struk Kasir)

Kasir membuka /cashier.
Di bagian "Buat Kode Batch", kasir menginput jumlah (misalnya 10) lalu klik Generate.
Sistem membuat 10 kode unik (contoh: A8X2B). Kasir mencetaknya di struk belanja.
Pelanggan membuka HP di /, memasukkan nomor HP dan mengetik kode A8X2B.
Pelanggan sukses mengklaim +1 Stamp mandiri!
Fitur Void: Jika kasir salah buat, kasir cukup klik tombol "Void/Batal" agar kode hangus.

Skenario 3: Pelanggan Menukarkan Hadiah (Redeem Voucher)

Pelanggan membuka / dan memasukkan nomor HP-nya.
Jika stamp pelanggan telah mencapai target (3, 6, atau 10 stamp), tombol "Klaim Hadiah" akan aktif.
Pelanggan menekan Klaim dan menunjukkan layar HP (Bukti Voucher / Barcode) ke kasir.
Kasir di /cashier membuka menu "Cari & Validasi", mengetik nomor HP pelanggan, dan menekan "Setuju (Proses)".
Hadiah (Pisang Goreng Wijen) diserahkan ke pelanggan!

Proteksi & Privasi

🔒 Sistem Keamanan Enterprise

Didesain aman tanpa celah kecurangan (fraud prevention).

🛡️ Privasi Antar Kasir

Kasir A tidak dapat melihat kode atau aktivitas Kasir B. Sesi kasir diisolasi 100% secara ketat di backend.

📜 Audit Trail Transparan

Pemilik dapat melihat siapa pembuat setiap kode stamp hingga detik transaksi dilakukan melalui Dasbor Owner.

⛔ Lockout Otomatis (15 Menit)

Jika terjadi kesalahan PIN/Password sebanyak 5 kali berturut-turut, sistem otomatis mengunci akses demi keamanan.

🔐 Enkripsi Hashing Scrypt

PIN dan Password tidak pernah disimpan dalam bentuk teks biasa di database. Selalu diacak menggunakan enkripsi scrypt.

Pertanyaan Umum

❓ Pertanyaan Sering Ditanyakan (FAQ)

Apakah kode batch kasir akan hilang jika halaman di-refresh?▼

Tidak! Sistem secara otomatis menyimpan batch aktif di database session. Saat kasir men-refresh halaman, kode aktif akan kembali tampil otomatis.

Bagaimana jika kasir lupa PIN atau ingin mengganti PIN?▼

Pemilik dapat membuka halaman /owner, lalu memilih tab Manajemen Kasir untuk melakukan reset PIN atau menonaktifkan akun kasir terkait.

Apakah pelanggan harus mengunduh aplikasi di PlayStore/AppStore?▼

Tidak perlu. Sistem ini berbasis Web (PWA) yang dapat dibuka langsung dari browser HP (Chrome/Safari) tanpa menginstal apapun.