Glosarium

Referensi alfabet istilah domain yang digunakan di seluruh dokumentasi HandyCafe.

Panel Admin Dasbor pemantauan utama di HandyCafe Server. Menampilkan semua klien yang terhubung, status mereka, dan sesi aktif. Juga menyediakan tombol aksi pada setiap kartu klien untuk kontrol sesi dan operasi manajemen jarak jauh.

Tarif Komisi Persentase yang digunakan untuk menyatakan biaya pemrosesan pembayaran. Misalnya, 1% atau 5%. Digunakan dalam konfigurasi metode pembayaran untuk mendefinisikan biaya penerimaan metode pembayaran tertentu.

Protokol Biner Format pengkodean ringkas yang digunakan untuk komunikasi TCP antara HandyCafe Server dan klien. Dipilih karena kecepatan dan ukuran pesan yang kecil dibandingkan format berbasis teks.

Klien PC pelanggan yang menjalankan perangkat lunak HandyCafe Client. Klien terhubung ke server melalui jaringan lokal, menerima perintah sesi, dan melaporkan status serta data penggunaan. Setiap klien diidentifikasi berdasarkan alamat MAC dan nama hostnya.

Kunci Koneksi Rahasia bersama yang dikonfigurasi di server dan setiap klien selama pengaturan. Digunakan untuk menghasilkan token autentikasi kriptografis untuk komunikasi TCP, memastikan bahwa hanya perangkat yang berwenang yang dapat bertukar perintah dengan server.

Konsol Perangkat gaming seperti PlayStation atau Xbox yang dikelola oleh HandyCafe. Konsol mendukung sesi, harga, dan penggunaan anggota sama seperti PC klien tetapi tidak menjalankan perangkat lunak HandyCafe Client. Mereka dilacak berdasarkan alamat MAC.

Kafetaria Modul layanan makanan dan minuman terintegrasi di HandyCafe. Modul ini mencakup denah visual, manajemen meja, editor menu dengan kategori dan produk, dasbor pesanan langsung, dan menu pelanggan bermerek di handy.cafe/{slug}. Kafetaria menggunakan model data cloud-first; database lokal dan cloud tetap sinkron.

Cybercafe / Cyber Cafe Bisnis yang menyediakan akses publik ke komputer dan konektivitas internet, biasanya dengan tarif per jam. Juga disebut internet cafe. HandyCafe mengelola seluruh aspek operasi cybercafe, termasuk sesi, penagihan, dan keanggotaan.

Pembatasan Perangkat Pengaturan yang menentukan tipe perangkat mana yang berlaku untuk kredit dompet, kredit waktu, atau aturan harga. Nilai yang mungkin adalah: client (PC), console (konsol gaming), PCs only, consoles only, atau both (perangkat apa pun).

Arena Esports Tempat yang didedikasikan untuk gaming kompetitif dan acara esports, sering kali menampilkan PC berperforma tinggi, area pertandingan turnamen, dan tempat duduk penonton. HandyCafe mendukung arena esports dengan manajemen sesi, pelacakan anggota, dan penagihan konsol.

Hak Nilai yang diterima anggota dari pembelian paket. Ini bisa berupa kredit waktu (menit prabayar penggunaan sesi), saldo dompet moneter, atau kombinasi keduanya. Hak dicatat sebagai entri kredit di dompet atau saldo waktu anggota.

Denah Lantai Editor visual di Kafetaria untuk menata meja pada sebuah kanvas. Mendukung beberapa lantai, penempatan drag-and-drop, dan tampilan dimetrik 3D. Setiap meja ditetapkan tepat ke satu lantai. Lihat Kafetaria > Floor Plan.

Kurs Valuta Asing Kurs yang digunakan untuk mengonversi mata uang dasar ke mata uang tampilan lokal. Ini memungkinkan kafe di wilayah dengan mata uang berbeda untuk menetapkan harga dalam mata uang lokal mereka sambil mempertahankan basis akuntansi internal yang konsisten.

Pusat Gaming Tempat komersial di mana pelanggan membayar untuk menggunakan PC atau konsol gaming, biasanya menawarkan perangkat keras berperforma tinggi dan lingkungan gaming sosial. HandyCafe dibangun untuk mengelola operasi pusat gaming dari penagihan sesi hingga program keanggotaan.

Autentikasi Kriptografis Mekanisme verifikasi pesan yang digunakan untuk memastikan integritas dan keaslian pesan TCP antara server dan klien. Kedua pihak menggunakan Kunci Koneksi untuk menghitung dan memvalidasi kode autentikasi.

Warnet / Warung Internet Bisnis yang menyediakan akses berwaktu ke komputer dan layanan internet untuk pelanggan. Warnet adalah use case utama HandyCafe, yang menangani manajemen sesi, harga, program keanggotaan, dan operasi point-of-sale.

Idle Status klien saat PC terhubung ke server tetapi tidak ada sesi aktif. Dalam status idle, klien menampilkan layar kunci (IdlePage) dan menunggu dimulainya sesi, login anggota, atau tindakan administratif.

Klien Lawas Instalasi klien HandyCafe V3 atau V4 yang terhubung ke server modern melalui protokol lawas asli. Klien lawas muncul di Panel Admin dengan set aksi yang lebih terbatas (Masuk, Keluar, Tambah Waktu, Tangkapan Layar, Logoff, Reboot, Shutdown). Aktifkan dukungan runtime di Pengaturan > Klien Lawas.

Kredit Dompet / Kredit Waktu Entri diskret dari saldo dompet atau menit prabayar yang dibuat oleh pengisian atau pembelian paket. Setiap entri kredit mencatat asalnya (pengisian tunai, hak paket, bonus kampanye), nilai tersisa, dan pembatasan perangkat yang berlaku. Kredit dikonsumsi secara berurutan selama penyelesaian sesi.

Alamat MAC Pengenal perangkat keras yang ditetapkan ke antarmuka jaringan. HandyCafe menggunakan alamat MAC untuk mengidentifikasi klien dan konsol secara unik, memastikan bahwa perangkat dikenali bahkan jika alamat IP mereka berubah.

mDNS (Multicast DNS) Protokol untuk penemuan layanan otomatis di jaringan lokal. Klien HandyCafe mengumumkan kehadirannya melalui mDNS, memungkinkan server mendeteksi mereka tanpa konfigurasi IP manual.

Anggota Pelanggan terdaftar dengan profil di sistem HandyCafe. Anggota memiliki dompet, tingkat level, dan riwayat transaksi. Mereka dapat login di PC klien untuk sesi yang dipersonalisasi. Anggota juga dapat memiliki akun yang ditautkan OAuth.

Unit Minor Denominasi terkecil dari mata uang, digunakan secara internal untuk semua perhitungan keuangan guna menghindari kesalahan pembulatan floating-point. Misalnya, USD menggunakan sen (1 dolar = 100 unit minor), sementara JPY menggunakan yen langsung (1 yen = 1 unit minor).

Pengali Faktor yang diterapkan pada tarif per jam dasar dalam slot jadwal harga. Pengali 1.0 berarti tarif standar berlaku. Pengali 1.5 berarti tarif 50% lebih tinggi (misalnya jam sibuk), sementara 0.5 berarti setengah harga (misalnya diskon di luar jam sibuk).

PC Bang Warnet dan pusat gaming gaya Korea di mana pelanggan membayar untuk akses PC per jam. PC bang dikenal karena perangkat keras gaming kelas atas dan budaya gaming kompetitif. HandyCafe mendukung operasi PC bang dengan jadwal harga fleksibel dan manajemen sesi.

Online Status klien selama sesi aktif. Saat online, klien menampilkan antarmuka desktop (OnlinePage), memungkinkan pelanggan menggunakan aplikasi, menjelajah, dan berinteraksi dengan menu klien.

Pascabayar Mode penagihan sesi di mana pelanggan menggunakan PC secara bebas dan membayar di akhir berdasarkan durasi penggunaan aktual. Biaya akhir dihitung saat penutupan sesi menggunakan segmen jadwal harga yang berlaku.

Prabayar Mode penagihan sesi di mana pelanggan membayar di muka untuk durasi tetap. Sesi berakhir secara otomatis saat waktu yang dibeli habis, kecuali diperpanjang.

Segmen Harga Bagian dari sesi di mana satu pengali harga berlaku. Batas segmen dibuat oleh peristiwa seperti mulai sesi, jeda, lanjut, atau transisi slot harga dalam jadwal.

Slot Harga Zona berkode warna dalam grid jadwal harga mingguan. Setiap slot mendefinisikan rentang waktu dan pengali yang memodifikasi tarif per jam dasar. Slot dapat mencakup jam tertentu pada hari tertentu, memungkinkan harga berbeda untuk periode sibuk vs. tidak sibuk.

Peran Kumpulan izin bernama yang ditetapkan ke akun kasir. Peran mendefinisikan aksi apa yang dapat dilakukan kasir (misalnya memulai sesi, mengelola anggota, melihat laporan). Beberapa kasir dapat berbagi peran yang sama dan izin ditegakkan di seluruh antarmuka.

Kode Keamanan Kode 6 digit yang dibuat saat staf mendudukkan pelanggan di meja Kafetaria. Pelanggan mengetikkannya setelah memindai QR meja untuk membuktikan keberadaan fisik. Kode di-hash di sisi server dan kedaluwarsa saat Close Table atau Settle Check. Show Code menampilkan teks biasa yang tersimpan; Rotate QR membuat kode baru dan membatalkan stiker lama.

Batas Segmen Peristiwa yang memicu pembuatan segmen harga baru dalam sesi. Batas meliputi: mulai sesi, hentikan sesi, jeda sesi, lanjutkan sesi, dan perubahan slot harga (saat jam melintasi dari satu slot harga ke yang lain).

Sesi Periode berwaktu penggunaan PC atau konsol oleh pelanggan. Sesi melacak waktu mulai, waktu selesai, jeda, segmen harga, dan total jumlah yang dibebankan. Sesi dapat berupa prabayar atau pascabayar.

Penyelesaian Perhitungan yang dilakukan saat sesi berakhir untuk menentukan biaya akhir. Penyelesaian memproses semua segmen harga, menerapkan pengali yang relevan, menambahkan startup fee dan PPN, mengurangi diskon anggota, dan menghasilkan total jumlah yang harus dibayar. Di Kafetaria, penyelesaian juga merupakan aksi satu klik yang menutup setiap pesanan terbuka pada meja dengan metode pembayaran yang dipilih dan mengembalikan meja ke idle.

STE (Smart/Turbo Edition) Varian protokol untuk klien lawas. Frame STE menyertakan prefix info lisensi 70 byte; ukuran frame 1337 byte. Alternatifnya adalah Standard (1267 byte, tanpa prefix). Cocokkan varian dengan cara server lawas Anda dibangun, jika tidak frame akan dibuang atau salah dibaca. Setel varian di Pengaturan > Klien Lawas.

Shift Periode kerja kasir dari login hingga logout. Semua transaksi, operasi sesi, dan tindakan administratif yang dilakukan selama shift dikaitkan dengan kasir yang masuk. Data shift digunakan untuk akuntabilitas dan analisis kinerja.

Biaya Awal Biaya minimum yang diterapkan per sesi terlepas dari durasi. Jika biaya sesi yang dihitung (berdasarkan waktu dan harga) kurang dari biaya awal, biaya awal yang dibebankan. Ini memastikan pendapatan dasar per sesi.

Sinkronisasi Proses sinkronisasi file dari HandyCafe Server ke PC klien. Menggunakan perbandingan berbasis manifes dan transfer berbasis chunk untuk mendistribusikan file secara efisien di seluruh jaringan.

Tingkat Level loyalitas dalam sistem tingkat anggota. Tingkat didefinisikan oleh ambang poin dan memberikan tarif diskon pada sesi dan pesanan. Saat anggota mengakumulasi poin melalui pengeluaran, mereka naik ke tingkat yang lebih tinggi dengan manfaat yang lebih baik.

Transaksi Catatan keuangan dari pembayaran untuk sesi, pesanan, pengisian dompet, atau peristiwa yang dapat ditagih lainnya. Transaksi mencatat jumlah, metode pembayaran, anggota atau kasir terkait, dan stempel waktu.

PPN (Pajak Pertambahan Nilai) Persentase pajak yang diterapkan pada biaya sesi dan jumlah pesanan. Tarif PPN dikonfigurasi dalam pengaturan harga dan diperhitungkan dalam perhitungan penyelesaian. Jumlah PPN dilacak secara terpisah untuk tujuan pelaporan pajak.

Dompet Saldo moneter prabayar anggota yang disimpan dalam sistem HandyCafe. Dompet terdiri dari satu atau beberapa entri kredit dan dapat digunakan untuk membayar sesi, pesanan, dan layanan lainnya. Pengisian dapat dilakukan melalui tunai, paket, atau kampanye.