HandyCafe Docs
owner cashier

Manajemen Sesi

Sesi adalah unit penagihan utama di HandyCafe. Setiap kali pelanggan di warnet atau pusat game Anda menggunakan PC atau konsol game, sesi melacak waktu penggunaan mereka dan menghitung biayanya. Halaman ini menjelaskan siklus hidup sesi lengkap, dari memulai sesi hingga mengumpulkan pembayaran.

Jenis Sesi

HandyCafe mendukung dua jenis sesi:

  • Sesi PC. Sesi pada PC klien yang dikelola melalui Admin Panel. Perangkat lunak klien mengunci PC saat tidak aktif dan membukanya saat sesi dimulai.
  • Sesi Konsol. Sesi pada konsol game (PlayStation, Xbox, dll.) yang dikelola melalui halaman Konsol. Ini dilacak hanya oleh server; tidak ada perangkat lunak klien pada konsol itu sendiri.

Kedua jenis sesi mengikuti mesin penetapan harga dan siklus hidup yang sama tetapi dikelola dari halaman yang berbeda di dashboard.

Siklus Hidup Sesi

Setiap sesi mengikuti siklus hidup yang ditentukan dengan transisi status yang jelas:

Mulai --> Berjalan --> (Jeda <--> Lanjutkan) --> Tambah Waktu --> Berhenti

Status secara rinci:

  1. Mulai. Kasir memulai sesi. PC klien terbuka atau timer konsol dimulai.
  2. Berjalan. Sesi aktif. Waktu dihitung dan penagihan bertambah.
  3. Jeda. Kasir menghentikan sementara sesi. Penagihan berhenti. Klien menunjukkan status dijeda.
  4. Lanjutkan. Kasir melanjutkan sesi yang dijeda. Penagihan dilanjutkan dari segmen harga baru.
  5. Tambah Waktu. Kasir menambah (atau mengurangi) menit ke sesi aktif.
  6. Berhenti. Sesi berakhir. Sistem menghitung biaya akhir dan meminta pembayaran.

Memulai Sesi

Untuk memulai sesi baru pada PC klien:

  1. Pilih klien. Di Admin Panel, klik PC yang dalam status Idle (sian) untuk menampilkan tombol aksi.
  2. Pilih jenis penagihan. Pilih antara Pascabayar (bayar di akhir) atau Prabayar (bayar di muka).
  3. Tetapkan anggota (opsional). Jika pelanggan adalah anggota terdaftar, cari akun mereka menggunakan bidang pencarian anggota otomatis. Menetapkan anggota memungkinkan pembayaran dompet dan melacak sesi dalam riwayat mereka.
  4. Tetapkan durasi atau jumlah (hanya prabayar). Untuk sesi prabayar, masukkan jumlah menit yang dibeli pelanggan atau jumlah uang yang mereka bayar. Sistem menghitung waktu yang sesuai berdasarkan slot harga saat ini.
  5. Pilih metode pembayaran. Pilih metode pembayaran (Tunai, Kartu Kredit, atau metode kustom yang telah Anda konfigurasikan).
  6. Konfirmasi. Tinjau detail dan konfirmasi. PC klien segera terbuka dan timer sesi dimulai.

Untuk sesi konsol, prosesnya serupa tetapi dimulai dari halaman Konsol.

Sesi Pascabayar

Dalam sesi pascabayar, pelanggan menggunakan PC terlebih dahulu dan membayar saat selesai. Ini adalah mode penagihan paling umum di warnet, kafe siber, dan pusat game.

Cara kerjanya:

  • Sesi dimulai tanpa pembayaran di muka.
  • Timer berjalan dan biaya bertambah secara real-time berdasarkan slot harga aktif.
  • Ketika sesi dihentikan, sistem menampilkan biaya akhir yang dihitung.
  • Kasir mengumpulkan pembayaran dan mengonfirmasi transaksi.

Sesi pascabayar tidak memiliki batas waktu. Mereka berjalan sampai kasir menghentikannya atau pelanggan meminta untuk pergi.

Sesi Prabayar

Dalam sesi prabayar, pelanggan membayar di muka untuk jumlah waktu tertentu. Sesi secara otomatis berakhir ketika waktu yang dibeli habis.

Ada dua mode harga prabayar, dikonfigurasi di Pengaturan > Harga:

Terkunci saat Pembelian

Biaya dibekukan pada saat sesi dimulai. Slot harga dan pengganda yang aktif pada saat pembelian digunakan untuk seluruh durasi sesi, terlepas dari perubahan jadwal yang terjadi saat sesi berjalan.

Contoh: Seorang pelanggan membeli 60 menit pada pukul 10:00 pagi selama slot tarif standar. Bahkan jika jadwal harga beralih ke slot setengah harga pada pukul 11:00 pagi, waktu yang tersisa pelanggan tidak terpengaruh. Mereka menerima persis apa yang mereka bayar pada tarif asli.

Jadwal Langsung

Biaya menyesuaikan secara real-time saat sesi melewati slot harga yang berbeda. Jika sesi pelanggan melintasi perubahan slot, waktu yang tersisa dihitung ulang berdasarkan harga baru.

Contoh: Seorang pelanggan membeli 60 menit pada pukul 10:00 pagi selama slot tarif standar. Pada pukul 11:00 pagi, jadwal beralih ke slot setengah harga. Karena setiap menit sekarang berharga setengahnya, waktu yang tersisa pelanggan secara efektif diperpanjang. Mereka mungkin berakhir dengan lebih banyak menit total daripada yang awalnya dibeli.

Menjeda Sesi

Menjeda sementara menghentikan penagihan tanpa mengakhiri sesi. Ini berguna ketika pelanggan perlu pergi sebentar.

Untuk menjeda sesi:

  1. Pilih PC aktif di Admin Panel dan klik tombol Jeda pada kartu.

Apa yang terjadi ketika sesi dijeda:

  • Penagihan berhenti segera. Tidak ada biaya yang bertambah selama jeda.
  • Segmen harga saat ini ditutup dengan batas "jeda".
  • PC klien menampilkan status dijeda dengan indikator status oranye.
  • Timer sesi membeku.

Sesi yang dijeda tetap dijeda tanpa batas waktu sampai kasir melanjutkan atau menghentikannya.

Melanjutkan Sesi

Melanjutkan melanjutkan sesi yang dijeda dari tempat terakhir.

Untuk melanjutkan sesi:

  1. Pilih PC yang dijeda di Admin Panel dan klik tombol Lanjutkan pada kartu.

Apa yang terjadi ketika sesi dilanjutkan:

  • Segmen harga baru dimulai pada waktu saat ini, menggunakan slot harga aktif.
  • Penagihan dilanjutkan.
  • PC klien kembali ke status aktif (hijau).

Perhatikan bahwa slot harga pada waktu melanjutkan mungkin berbeda dari slot saat sesi dijeda. Segmen baru menggunakan tarif apa pun yang saat ini aktif pada jadwal harga.

Menambah Waktu

Anda dapat menambah atau mengurangi menit dari sesi aktif kapan saja.

Untuk menambah waktu:

  1. Pilih PC aktif di Admin Panel dan klik tombol Tambah Waktu pada kartu.
  2. Masukkan jumlah menit yang akan ditambahkan. Gunakan nilai positif untuk memperpanjang sesi atau nilai negatif untuk menguranginya.
  3. Konfirmasi.

Apa yang terjadi ketika waktu ditambahkan:

  • Catatan transaksi dibuat dalam riwayat sesi.
  • Untuk sesi prabayar, waktu akhir disesuaikan maju (atau mundur) dengan jumlah menit yang ditentukan.
  • Untuk sesi pascabayar, acara tambah waktu dicatat tetapi tidak menetapkan waktu akhir yang pasti.

Menghentikan Sesi

Menghentikan sesi mengakhiri semua penagihan, mengunci PC klien, dan memicu proses pembayaran.

Untuk menghentikan sesi:

  1. Pilih PC aktif atau dijeda di Admin Panel dan klik tombol Berhenti pada kartu.
  2. Dialog Pembayaran muncul menampilkan ringkasan sesi.

Dialog Pembayaran

Dialog pembayaran menampilkan informasi berikut:

Bidang Deskripsi
Durasi Total waktu aktif (tidak termasuk periode dijeda)
Jumlah Dihitung Biaya yang dihitung berdasarkan segmen harga
Jumlah Dibebankan Jumlah yang harus dibebankan kepada pelanggan (default ke dihitung tetapi dapat diubah)
PPN Jumlah pajak, jika dikonfigurasi
Komisi Komisi metode pembayaran, jika berlaku
Biaya Tetap Biaya tetap metode pembayaran, jika berlaku
Metode Pembayaran Dropdown untuk memilih cara pelanggan membayar

Override kasir: Kasir dapat menyesuaikan jumlah yang dibebankan secara manual. Misalnya, kasir mungkin membulatkan ke bawah sebagai bentuk keramahan atau menerapkan diskon manual. Jumlah yang dihitung asli selalu disimpan dalam catatan untuk audit.

  1. Pilih metode pembayaran dan konfirmasi. Sesi dicatat, PC klien terkunci, dan transaksi disimpan.

Proses Penyelesaian

Ketika sesi dihentikan, mesin penyelesaian menjalankan langkah-langkah ini:

  1. Tutup segmen harga terbuka terakhir.
  2. Jumlahkan semua jumlah segmen tertutup.
  3. Terapkan aturan pembulatan (selalu dibulatkan ke atas ke langkah pembulatan yang dikonfigurasi).
  4. Terapkan biaya minimum startup (total tidak pernah kurang dari biaya startup).
  5. Hitung komisi metode pembayaran (berbasis BPS) dan biaya tetap.
  6. Tampilkan jumlah akhir dalam dialog pembayaran.

Untuk penjelasan rinci tentang cara kerja segmen harga dan perhitungan penyelesaian, lihat Session Pricing.

Sesi Anggota

Ketika seorang anggota ditetapkan ke sesi, opsi penagihan tambahan tersedia:

  • Pembayaran dompet. Biaya sesi dapat dikurangkan dari saldo dompet anggota.
  • Pengurangan paket waktu. Jika anggota telah membeli paket waktu, menit dikurangkan dari saldo paket mereka alih-alih membebankan jumlah uang.
  • Diskon anggota. Jika anggota memiliki diskon yang dikonfigurasi (dalam basis poin), itu diterapkan pada biaya sesi.
  • Riwayat sesi. Sesi ditautkan ke akun anggota dan muncul dalam riwayat sesi mereka.

Anggota juga dapat memulai sesi mereka sendiri dari layar idle klien dengan masuk menggunakan nama pengguna dan kata sandi mereka atau melalui OAuth (jika dikonfigurasi).

Nilai Status Sesi

Setiap PC klien menampilkan indikator status berwarna:

Status Warna Arti
Online Hijau Sesi aktif dan berjalan
Dijeda Oranye Sesi dijeda; penagihan dihentikan
Idle Sian Klien terhubung tetapi tidak ada sesi yang aktif
Offline Merah Klien tidak terhubung ke server
Admin Ungu Klien dalam mode admin/pemeliharaan
Sibuk Kuning Klien sedang memproses permintaan

Warna status ini muncul pada kartu klien di Admin Panel, memudahkan untuk melihat status setiap PC secara sekilas.

Segmen Harga Sesi

Setiap sesi dibagi menjadi satu atau lebih segmen harga. Segmen baru dibuat setiap kali terjadi peristiwa yang relevan dengan penagihan:

  • Mulai sesi
  • Jeda
  • Lanjutkan
  • Perubahan slot harga (ketika jam melintasi slot waktu yang berbeda pada jadwal)
  • Perubahan harga dasar (jika admin mengubah tarif per jam di tengah sesi)
  • Putus atau sambung kembali

Setiap segmen mencatat slot harga, pengganda, harga dasar, waktu mulai, waktu akhir, dan jumlah yang dihitung. Total sesi adalah jumlah dari semua segmen, tunduk pada aturan pembulatan dan biaya minimum.

Untuk detail lengkap tentang cara segmen dihitung, lihat Session Pricing.

Biaya Minimum dan Biaya Startup

Bahkan sesi yang sangat singkat dikenakan biaya setidaknya sebesar jumlah biaya startup. Ini dikonfigurasi di Pengaturan > Harga dan memastikan bahwa setiap sesi menghasilkan tingkat pendapatan minimum, terlepas dari seberapa singkat penggunaannya.

Contoh: Jika biaya startup Anda ditetapkan sebesar $1.00 dan pelanggan menggunakan PC hanya selama 30 detik, jumlah yang dibebankan adalah $1.00, bukan pecahan sen yang akan dikenakan biaya 30 detik pada tarif per jam.


Langkah Selanjutnya

  • Session Pricing: Penjelasan mendalam tentang mesin penetapan harga, segmen, dan matematika penyelesaian
  • Admin Panel: Memantau dan mengontrol PC klien
  • Members: Mengelola akun dan dompet anggota
  • Cash Report: Meninjau pendapatan sesi dan ringkasan shift