Panduan Penggunaan CafeResto

Setup & penggunaan untuk Super Admin, Owner, Admin Tenant, dan Staff (kasir/waiter/dapur/manager).

Pendahuluan

CafeResto adalah POS multi-tenant untuk cafe & rumah makan kecil dengan dukungan multi-cabang. Ada empat lapis akses yang perlu dipahami sebelum mulai:

Lapis Akses	Lingkup	Aplikasi
Super Admin	Seluruh platform, lintas-tenant	Web Admin (`/super-admin`)
Owner	Satu tenant (organisasi), semua cabang	Web Admin
Admin Tenant	Satu tenant, sesuai izin yang diberikan owner	Web Admin
Staff	Cabang tempat staff ditugaskan, sesuai role	Web POS (PWA/APK)

Catatan: Role "owner/admin/member" berlaku di level organisasi (tenant), sedangkan role "manager/kasir/waiter/dapur" berlaku di level cabang. Satu orang bisa punya beberapa role cabang sekaligus.

1. Super Admin Platform

Super Admin mengelola seluruh tenant yang terdaftar di platform (bukan hanya satu cafe). Akses ini tidak diberikan lewat menu — diatur lewat whitelist email di server (SUPER_ADMIN_EMAILS).

Cara mengakses

1Login di Web Admin menggunakan email yang sudah didaftarkan sebagai super admin.
2Buka halaman /super-admin.
3Dari sini bisa: melihat semua tenant & statistiknya, menyembunyikan/mengaktifkan kembali tenant, mengubah paket (plan), status, dan masa trial/kontrak tenant.

Perhatian: Menambah/menghapus akses super admin hanya bisa dilakukan dengan mengubah environment variable di server (bukan dari UI) — perlu akses ke konfigurasi deployment.

2. Owner (Pemilik Tenant) Tenant

Owner adalah pemilik cafe/resto yang mendaftarkan tenant baru di CafeResto. Owner punya akses penuh ke semua cabang miliknya.

2.1 Daftar & Onboarding (tenant baru)

1Buka halaman /signup di Web Admin, daftar dengan email & password.
2Buat organisasi (tenant) — isi nama cafe/resto. Trial 14 hari otomatis dimulai saat organisasi dibuat.
3Pilih mode setup:
- solo — satu orang pegang semua (cocok untuk warung kecil)
- multi_lean — beberapa staff, struktur sederhana
- enterprise — multi-cabang, struktur lengkap dengan approval
4Buat cabang pertama — isi nama & alamat cabang. Untuk mode solo/multi_lean, akun kas default langsung dibuat otomatis.

2.2 Kelola Cabang & Kas

Setelah onboarding selesai, owner bisa menambah cabang baru, mengatur produk/menu, kategori, supplier, gudang (warehouse), dan akun kas dari menu Web Admin sesuai kebutuhan operasional masing-masing cabang.

2.3 Undang Staff & Admin Tenant

1Buka menu /users di Web Admin.
2Klik undang, masukkan email calon staff/admin, lalu pilih role organisasi (admin atau member).
3Sistem mengirim undangan ke email tersebut.
4Calon staff membuka link undangan dan menerimanya di halaman /accept-invitation, lalu set password.
5Setelah diterima, owner/admin menetapkan role cabang (manager/kasir/waiter/dapur) untuk user tersebut — lihat bagian 4.1.

Batas jumlah staff: jumlah undangan dibatasi sesuai paket (plan) tenant. Jika sudah mencapai limit, perlu upgrade paket dulu sebelum mengundang staff baru.

3. Admin Tenant Tenant

Admin tenant adalah staff yang diberi role admin di level organisasi oleh owner. Hak akses serupa owner di operasional sehari-hari (kelola menu, staff, laporan), namun perubahan yang sangat sensitif (misalnya paket/billing) tetap di tangan owner.

Login dan navigasi menggunakan Web Admin yang sama dengan owner — menu yang tampil otomatis menyesuaikan dengan role yang dimiliki.

4. Staff (Manager/Kasir/Waiter/Dapur) Cabang

4.1 Role per Cabang

Role staff diatur per cabang (bukan per tenant), karena satu tenant bisa punya banyak cabang dan staff yang berbeda-beda di tiap cabang. Role yang tersedia:

Role	Fungsi Utama di POS
`manager`	Supervisi cabang: buka/tutup shift, approve void, lihat laporan cabang
`kasir`	Transaksi penjualan, pembayaran, cetak struk
`waiter`	Input pesanan meja, kirim ke dapur
`dapur`	Lihat & proses pesanan masuk (Kitchen Display)

Satu user bisa memiliki lebih dari satu role di cabang yang sama (misal kasir sekaligus waiter). Pengaturan role ini dilakukan owner/admin tenant di Web Admin saat menugaskan staff ke sebuah cabang.

1Buka aplikasi Web POS (PWA di browser, atau APK Android yang sudah di-install).
2Login menggunakan email & password yang sudah didaftarkan/diterima dari undangan.
3Tampilan menu otomatis menyesuaikan role cabang yang dimiliki (kasir melihat kasir, dapur melihat Kitchen Display, dst).

Catatan koneksi: Aplikasi POS terhubung langsung ke server cloud lewat internet — pastikan device staff terkoneksi internet (WiFi/data) saat digunakan.

5. Setup Printer Thermal (Bluetooth)

Berlaku untuk printer thermal seri RPP02N atau sejenis yang dipasangkan via Bluetooth Classic ke device Android.

1Pasangkan printer dulu di pengaturan Android (Settings → Bluetooth → pair dengan printer), bukan dari dalam aplikasi.
2Buka Web POS (APK) → masuk ke menu pemilihan printer.
3Aplikasi akan meminta izin Bluetooth (jika belum diberikan).
4Pilih printer dari daftar device yang sudah dipasangkan (paired).
5Setelah dipilih, koneksi printer akan tersimpan otomatis di device tersebut untuk transaksi berikutnya.

Penting: Setup printer disimpan per-device, jadi setiap device kasir yang baru perlu mengulang langkah pairing & pemilihan printer ini.

6. Troubleshooting Umum

Tidak bisa login (Web POS): pastikan device punya koneksi internet, dan akun staff sudah menerima undangan + set password.
Menu/role tidak muncul: minta owner/admin tenant cek penugasan role cabang untuk akun tersebut di Web Admin.
Printer tidak terdeteksi: cek printer sudah dipasangkan (paired) di Settings Bluetooth Android, dan Bluetooth dalam keadaan aktif.
Trial/akun terkunci: cek status trial & paket tenant — owner bisa upgrade paket, atau hubungi Super Admin bila ada masalah pada level platform.