*) Karena keterbatasan ketentuan ukuran file, master file ini tidak termasuk folder vendor (library) jadi anda harus lakukan composer install mandiri.
*) Jika ingin full dengan folder vendor (library) silahkan kirim pesan melalui inbox.

Sistem Loyalitas Poin Multi-Bisnis Multi-Outlet: satu instalasi melayani banyak
bisnis (contoh: Kopi Senja, Barokah Mart, Glamour Salon), setiap bisnis punya
banyak outlet cabang, setiap outlet punya kasir, dan setiap bisnis punya member
pelanggan sendiri.

Satu nomor HP yang sama di dua bisnis berbeda adalah dua akun member yang
terpisah — login member selalu lewat slug bisnis (`{slug}/login`), tidak ada
pilihan bisnis setelah login.

Ada empat interface aplikasi dalam satu codebase:

1. Panel admin
- URL: `/admin/*`
- Pengguna: `super_admin`, `business_admin`, `outlet_staff`, `cashier`
- Login: username + password (`/admin/login`)

2. Portal member
- URL: `/member/*` via slug
- Pengguna: `member`
- Login: nomor HP + password (`{slug}/login`)

3. Halaman publik
- URL: `/{slug}` dan `/`
- Pengguna: pengunjung tanpa login
- Login: tidak perlu

4. REST API v1
- URL: `/api/v1/*`
- Pengguna: sistem POS eksternal
- Autentikasi: header `X-API-Key`
- End Point: /simulate, /earn


User Role:
Peran: `super_admin`
Tabel: `users`
Login: username + password di `/admin/login`

Peran: `business_admin`
Tabel: `users`
Login: username + password di `/admin/login`

Peran: `outlet_staff`
Tabel: `users`
Login: username + password di `/admin/login`

Peran: `cashier`
Tabel: `users`
Login: username + password di `/admin/login`

Peran: `member`
Tabel: `members`
Login: nomor HP + password di `{slug}/login`

Alur bisnis singkat

1. Setup bisnis
- `super_admin` membuat bisnis, aturan poin, outlet pertama, lalu akun `business_admin` dan kasir/staf per outlet.

2. Member terdaftar
- Admin mendaftarkan member, atau member mendaftar mandiri melalui `{slug}/register`.
- Pendaftaran mandiri kemudian diverifikasi oleh admin.
- Kode verifikasi dikirim melalui WhatsApp.

3. Belanja dapat poin
- Kasir mencatat transaksi melalui POS (`admin/pos`) atau POS eksternal melalui API.
- Poin otomatis dicatat sebagai `earning`.
- Saldo poin member bertambah.

4. Tukar reward
- Member menukar poin dengan reward melalui portal.
- Poin dipotong dan stok berkurang saat kode dibuat.
- Kasir memvalidasi kode di outlet, kemudian status menjadi `used`.
- Kode yang belum digunakan dapat di-void sehingga poin dan stok dikembalikan.

5. Klaim program
- Member mengklaim bonus program.
- Kode berada dalam status pending dan poin belum masuk.
- Poin masuk ketika kasir memvalidasi kode.
- Admin juga dapat membuat klaim secara langsung, sehingga poin langsung masuk.

6. Pembatalan transaksi
- Transaksi yang dibatalkan memicu reversal poin secara otomatis (`earning_reversal`).
- Saldo poin member diperbolehkan menjadi minus.

7. Laporan & audit
- Dasbor menampilkan ringkasan bisnis.
- Laporan tersedia per tab dan dapat diekspor.
- Log aktivitas mencatat siapa melakukan apa.

Panel Admin (Semua Menu terlepas dari user role)

1. Dasbor

2. Navigasi Utama (Header)
- Dasbor

3. Operasional (Header)
- POS Kasir
- Validasi Kode
- Laporan

4. Data (Header)
- Member
- Reset Member
- Verifikasi Member
- Reward
- Program Poin
- Klaim Poin
- Redeem Reward
- Riwayat Poin
- Transaksi

5. Sistem (Header)
- Bisnis
- Outlet
- User / Kasir
- Pengaturan
- Log Aktivitas
- API Keys

Portal Member

1. Dasbor
2. Program
3. Reward
4. Kode Saya
5. Riwayat
6. Akun


Akun Live Demo superadmin:
username: superadmin
password: Abc*1234567890

user lain atau member silahkan lihat di aplikasi. semua password nya sama = Abc*1234567890
Jika sudah berubah silahkan kontak untuk reset data demo.