Membership + Check-In Wajah (Gym/Studio)

Terakhir diperbarui / Last updated: 2026-08-05 Modul / Module: /service-pack/plan, /member-checkin, /kiosk/[deviceId], /laporan/member-checkin Versi / Version: 1.0

---

Ringkasan / Overview

Membership + Check-In Wajah adalah fitur untuk bisnis tipe gym/studio/klub (mis. climbing gym, studio yoga, tempat olahraga) yang perlu mencatat member masuk pintu, memakai kuota kunjungan/sesi, dan (opsional) memakai pengenalan wajah di kiosk tanpa staf. Fitur ini memperluas modul Paket & Membership yang sudah ada — sebuah kartu member tetap sebuah "ServicePackCard" biasa, hanya ditambah lapisan check-in di pintu.

Keputusan desain penting: check-in di pintu dan "pakai sesi coaching" itu terpisah. Member bisa masuk pintu tanpa harus booking coach; memakai kuota sesi coaching (mis. paket Monthly Bundling) adalah aksi staf yang berbeda ("Pakai Sesi Coaching").

1. Pastikan modul Paket & Membership dan Member Check-In aktif di Pengaturan → Modul Bisnis.
2. Buat paket dulu di Paket & Membership → Daftar Paket (/service-pack/plan).
3. Untuk mencatat kedatangan member: buka Member Check-In (/member-checkin).
4. Untuk kiosk wajah tanpa staf: Member Check-In → Kelola Kiosk (/member-checkin/kiosk-devices) untuk pairing device, lalu buka /kiosk/[deviceId] di tablet.
5. Untuk laporan: Laporan → Member Check-In (/laporan/member-checkin).

Buka Paket & Membership → Daftar Paket, klik Tambah Paket. Anda bisa mulai dari template siap pakai (opsional, semua nilai tetap bisa diubah sebelum simpan):

• Kupon 6x / Kupon 12x — paket sesi (punch-card), bisa dipakai orang lain (kupon bersama). Setiap check-in di pintu langsung memakai 1 kuota.
• Monthly Bundling — paket bulanan, masuk pintu gratis (tidak memakai kuota), kuota 4 sesi coaching/bulan hanya dipakai lewat aksi staf "Pakai Sesi Coaching" — bukan otomatis saat check-in.
• Unlimited (VIP) — akses tanpa batas, pendapatan diakui merata (straight-line) tiap bulan, bukan per kunjungan. Paket ini khusus admin — disembunyikan dari katalog/pemilihan paket default, hanya Owner/Admin yang bisa memilihnya saat menjual kartu.

Field penting saat membuat paket:

Di /member-checkin, ada 3 cara staf mencatat kedatangan:

1. Telepon — ketik nomor HP member, sistem mencari otomatis, konfirmasi lalu check-in.
2. Cari Manual — cari berdasarkan nama/nomor HP, pilih dari daftar.
3. Kupon Teman/Keluarga — untuk member yang membagikan kartunya. Staf ketik nomor HP PEMILIK kartu, sistem menampilkan konfirmasi tersamar (nama+nomor HP+sisa kuota pemilik), lalu staf mengisi nama tamu (wajib) dan nomor HP tamu (opsional).

Sistem otomatis memilih kartu aktif yang tepat: kartu berkuota (mis. Kupon 6x) dipakai dulu (kuota terpotong 1), baru kartu unlimited/attendance-only kalau tidak ada kartu berkuota. Kalau member tidak punya kartu aktif sama sekali, check-in ditolak dengan pesan jelas.

Pakai Sesi Coaching adalah aksi TERPISAH (tombol sendiri di halaman yang sama) — staf pilih kartu + coach, sistem memakai 1 kuota sesi coaching dan mencatat komisi untuk coach tersebut.

Dari sisi member (kiosk):

1. Member mendekati tablet kiosk di depan pintu.
2. Kamera menangkap wajah, sistem mencocokkan dengan seluruh member terdaftar di organisasi (bukan cocok 1-ke-1, tapi mencari 1-dari-banyak).
3. Kalau cocok jelas → check-in otomatis tercatat, layar menampilkan konfirmasi.
4. Kalau tidak ada wajah cocok, atau ada 2 wajah mirip yang membingungkan sistem → kiosk minta member pakai jalur alternatif (kupon teman/keluarga via kiosk, atau minta bantuan staf).
5. Kiosk juga punya jalur mandiri "Pakai kupon teman/keluarga" untuk tamu yang datang memakai kartu member lain.

Pendaftaran wajah (dilakukan staf, bukan self-service):

• Staf membuka profil member → Daftar Wajah, menampilkan persetujuan (consent) yang menjelaskan apa yang disimpan (angka representasi wajah, bukan foto), tujuan pemakaian, dan hak member untuk menolak/mencabut consent kapan saja tanpa mempengaruhi layanan (tetap bisa pakai Telepon/Manual/Kupon).
• Kalau member di bawah 18 tahun, wajib mengisi nama wali sebagai bagian dari consent.
• Tombol "Hapus Data Wajah" selalu tersedia di profil member yang sudah terdaftar — data wajah dihapus permanen, riwayat pendaftaran tetap tercatat untuk audit.

Pairing kiosk device (Owner/Admin):

1. Buka Member Check-In → Kelola Kiosk (/member-checkin/kiosk-devices).
2. Klik Tambah Kiosk, beri nama (mis. "Tablet Pintu Depan").
3. Sistem menampilkan URL sekali pakai berisi token — buka URL itu SEKALI di tablet kiosk, token otomatis tersimpan di tablet dan hilang dari address bar.
4. Kiosk siap dipakai tanpa perlu staf login di tablet tersebut.
5. Kalau tablet hilang/rusak, klik Revoke untuk mencabut akses device itu — kiosk lama langsung berhenti bisa check-in.

Untuk paket yang ditandai "Bisa dipakai orang lain": member bisa membagikan kartunya ke teman/keluarga. Dari sisi front desk:

• Cara check-in tamu sama seperti jalur "Kupon Teman/Keluarga" di atas (staf ketik nomor HP pemilik, sistem tampilkan konfirmasi tersamar).
• Pendapatan dari pemakaian kartu selalu tercatat sebagai milik pembeli asli, bukan yang memakai kartu.
• Kalau paket punya batas jumlah orang berbeda, sistem menolak orang baru ke-N+1 begitu batas tercapai — pesan error menjelaskan batasnya.
• Laporan "Pemakai Kupon Bersama" di /laporan/member-checkin menunjukkan berapa orang berbeda sudah memakai tiap kartu — berguna untuk memantau pemakaian sebelum menetapkan batas.

Q: Kenapa member tidak bisa check-in padahal punya kartu? A: Kemungkinan kartu sudah kadaluarsa, kuota habis, atau kartu tidak aktif. Cek status kartu di profil member.

Q: Apakah check-in wajib pakai wajah? A: Tidak. Telepon/Manual/Kupon adalah jalur setara — kiosk wajah adalah opsi tambahan, bukan satu-satunya cara.

Q: Kalau member menolak didaftarkan wajahnya, apakah dia tetap bisa masuk? A: Ya, sepenuhnya. Menolak pendaftaran wajah tidak mengurangi layanan apa pun — pakai Telepon/Manual/Kupon seperti biasa.

Q: Apa bedanya "check-in" dan "Pakai Sesi Coaching"? A: Check-in = mencatat member masuk pintu (opsional memakai kuota kunjungan). Pakai Sesi Coaching = aksi staf terpisah untuk memakai kuota sesi coaching (mis. 4x/bulan di paket Monthly Bundling) dan mencatat komisi coach. Keduanya tidak otomatis terkait satu sama lain.