HandyCafe Docs
owner

Cara Menyiapkan Kafe Anda dari Awal

Panduan ini memandu Anda melalui setiap langkah instalasi HandyCafe baru untuk warnet, pusat gaming, atau arena esports Anda. Di akhir panduan ini Anda akan memiliki server yang berfungsi, setidaknya satu PC klien yang terhubung, harga yang dikonfigurasi, dan sesi uji yang selesai dengan pembayaran yang dicatat dalam laporan kas Anda.

Yang Anda Butuhkan

  • PC Windows untuk bertindak sebagai HandyCafe Server (Windows 10 atau lebih baru, minimal 4 GB RAM).
  • Setidaknya satu PC Windows tambahan untuk bertindak sebagai stasiun klien.
  • Jaringan lokal yang menghubungkan semua PC (kabel Ethernet disarankan untuk keandalan).
  • Kunci lisensi beta HandyCafe yang valid. Anda akan memasukkan ini selama pengaturan pertama.
  • Tarif per jam dan mata uang yang sudah Anda tentukan sebelumnya.

Fase 1: Instal dan Konfigurasikan Server

  1. Unduh installer HandyCafe Server terbaru dari dasbor HandyCafe Anda.
  2. Jalankan installer di PC yang telah Anda tetapkan sebagai server. Ikuti petunjuk di layar dan terima direktori instalasi default.
  3. Luncurkan HandyCafe Server. Wizard First Setup akan muncul secara otomatis pada pertama kali dijalankan.
  4. Masukkan kunci lisensi beta Anda saat diminta. Server akan memvalidasi kunci secara online dan menampilkan nama kafe serta batas PC Anda.
  5. Buat akun admin Anda. Masukkan username dan kata sandi yang kuat. Akun ini memiliki akses tak terbatas ke setiap fitur.
  6. Atur nama kafe Anda. Nama ini akan muncul di layar idle klien dan dalam laporan.
  7. Klik Finish untuk menyelesaikan wizard.

Hasil yang diharapkan: Jendela utama server terbuka menampilkan Admin Panel dengan nol klien yang terhubung. Nama kafe Anda muncul di bilah judul.

Fase 2: Konfigurasikan Harga

  1. Buka halaman Settings dengan mengklik ikon roda gigi di sidebar kiri.
  2. Navigasikan ke tab Pricing.
  3. Atur mata uang dasar Anda. Pilih dari dropdown mata uang. Semua harga, transaksi, dan laporan akan menggunakan mata uang ini.
  4. Masukkan tarif per jam Anda. Ini adalah harga dasar per jam untuk sesi pascabayar. Misalnya, masukkan 10.000 untuk sepuluh ribu unit mata uang Anda per jam.
  5. Atur tarif PPN. Masukkan persentase (0 hingga 100) yang berlaku untuk biaya sesi. Masukkan 0 jika PPN tidak berlaku.
  6. Atur biaya awal. Ini adalah biaya minimum per sesi terlepas dari durasi. Masukkan 0 jika Anda tidak menginginkan biaya minimum.
  7. Buat preset harga untuk durasi umum. Gulir ke bawah ke bagian Presets. Klik Add Preset. Buat preset seperti:
    • "30 Menit" dengan durasi 30 menit.
    • "1 Jam" dengan durasi 60 menit.
    • "2 Jam" dengan durasi 120 menit.
  8. Klik Save untuk menerapkan konfigurasi harga Anda.

Hasil yang diharapkan: Tab Pricing menampilkan tarif per jam, tarif PPN, biaya awal, dan semua preset yang terdaftar di bawah. Preset ini akan muncul sebagai tombol pilihan cepat saat memulai sesi prabayar.

Fase 3: Verifikasi Pengaturan Jaringan

  1. Masih di Settings, navigasikan ke tab Network.
  2. Verifikasi port yang mendengarkan. Defaultnya adalah 7842. Ubah hanya jika layanan lain di jaringan Anda menggunakan port tersebut.
  3. Atur atau catat kunci koneksi. Kunci ini mengautentikasi koneksi klien. Semua PC klien harus menggunakan kunci yang sama untuk terhubung.
  4. Pastikan firewall PC server mengizinkan koneksi TCP masuk pada port yang dikonfigurasi. Di Windows, HandyCafe biasanya menambahkan aturan ini selama instalasi. Jika Anda mengubah port, tambahkan aturan firewall baru secara manual.
  5. Catat alamat IP PC server yang ditampilkan di tab Network. Anda akan membutuhkannya jika klien tidak dapat menemukan server melalui penemuan otomatis.

Hasil yang diharapkan: Tab Network menampilkan port yang mendengarkan dan kunci koneksi. Indikator status server menampilkan "Listening" berwarna hijau.

Fase 4: Deploy Klien Pertama

  1. Unduh installer HandyCafe Client dari dasbor Anda.
  2. Instal di PC klien pertama Anda. Jalankan installer dan ikuti petunjuknya.
  3. Luncurkan HandyCafe Client. Klien akan mencoba menemukan server secara otomatis melalui mDNS di jaringan lokal.
  4. Jika penemuan otomatis gagal, masukkan alamat IP server dan port secara manual dalam dialog koneksi klien.
  5. Masukkan kunci koneksi yang Anda catat di Fase 3.
  6. Tunggu hingga koneksi terbentuk. Layar klien akan beralih ke halaman Idle yang menampilkan layar kunci dengan jam.

Hasil yang diharapkan: Di server, Admin Panel sekarang menampilkan satu klien yang terhubung. Ubin klien menampilkan nama host dan status biru "Idle". PC klien menampilkan layar kunci.

  1. Server akan secara otomatis menetapkan nama tampilan ke klien berdasarkan nama hostnya. Untuk mengubah namanya, pilih ubin klien di server dan klik Rename.

Fase 5: Jalankan Sesi Uji Pertama Anda

  1. Di Admin Panel server, klik Start pada ubin klien yang idle.
  2. Dalam dialog sesi, pilih Postpaid. Biarkan field anggota kosong untuk sesi tamu.
  3. Klik Confirm untuk memulai sesi.

Hasil yang diharapkan: Ubin klien berubah menjadi hijau dan menampilkan timer yang berjalan menghitung naik. Di PC klien, layar kunci menghilang dan desktop Online Page muncul.

  1. Biarkan sesi berjalan setidaknya 5 menit agar Anda dapat memverifikasi perhitungan harga.
  2. Klik Stop pada ubin klien hijau di server.
  3. Tinjau dialog rincian biaya. Dialog akan menampilkan:
    • Durasi (misalnya, 5 menit).
    • Tarif per jam yang diterapkan.
    • Jumlah PPN.
    • Total biaya.
  4. Pilih metode pembayaran (Cash adalah default).
  5. Klik Confirm untuk menutup sesi dan mencatat pembayaran.

Hasil yang diharapkan: Ubin klien kembali ke status biru "Idle". PC klien kembali menampilkan layar kunci. Transaksi dicatat dalam sistem.

Fase 6: Verifikasi di Laporan Kas

  1. Navigasikan ke halaman Cash Report menggunakan sidebar kiri.
  2. Konfirmasi bahwa laporan hari ini menampilkan satu transaksi sesi.
  3. Verifikasi bahwa jumlah transaksi sesuai dengan rincian biaya yang Anda lihat saat menghentikan sesi.
  4. Periksa bahwa kolom metode pembayaran menampilkan "Cash" (atau metode mana pun yang Anda pilih).

Hasil yang diharapkan: Laporan kas mencantumkan satu sesi yang selesai dengan jumlah, durasi, dan metode pembayaran yang benar. Kafe Anda sekarang beroperasi.

Fase 7: Langkah Selanjutnya Opsional

Setelah pengaturan dasar Anda berfungsi, pertimbangkan untuk mengonfigurasi fitur-fitur berikut:

  1. Tambahkan anggota. Navigasikan ke halaman Members. Klik Add untuk membuat akun anggota dengan username dan saldo dompet opsional. Anggota dapat masuk dari PC klien.
  2. Siapkan produk. Navigasikan ke halaman Products. Tambahkan item makanan dan minuman dengan harga agar kasir dapat membuat pesanan.
  3. Konfigurasikan menu klien. Navigasikan ke Settings > Client Menu. Tambahkan kategori aplikasi dan aplikasi agar pelanggan melihat grid peluncur di Online Page.
  4. Deploy klien tambahan. Instal HandyCafe Client di setiap PC stasiun di kafe Anda. Masing-masing akan muncul secara otomatis di server.
  5. Buat akun kasir. Navigasikan ke halaman Management. Tambahkan akun kasir dengan peran yang sesuai agar staf dapat masuk dan mengelola sesi.
  6. Siapkan harga jam sibuk/sepi. Navigasikan ke Settings > Pricing Schedule. Buat pengali berbasis waktu untuk mengenakan lebih banyak biaya selama jam sibuk.
  7. Aktifkan login OAuth. Navigasikan ke Settings > OAuth. Konfigurasikan Google atau penyedia lain agar pelanggan dapat masuk dengan akun sosial mereka.

Kesalahan Umum yang Harus Dihindari

  • Melewatkan aturan firewall. Jika klien tidak dapat terhubung, penyebab paling umum adalah aturan Windows Firewall yang memblokir port yang mendengarkan. Verifikasi aturan ada sebelum memecahkan masalah lain.
  • Kunci koneksi yang tidak cocok. Kunci di setiap klien harus sama persis dengan kunci di server. Salin-tempel untuk menghindari kesalahan ketik.
  • Menetapkan tarif per jam ke 0. Jika Anda membiarkan tarif per jam di nol, semua sesi pascabayar akan gratis. Selalu verifikasi harga sebelum mulai beroperasi.
  • Lupa menyimpan pengaturan. Perubahan di halaman Settings tidak berlaku hingga Anda mengklik Save. Jika pengaturan tampak tidak berubah setelah restart, kemungkinan besar Anda lupa menyimpan.
  • Menjalankan server dan klien di PC yang sama. Meskipun secara teknis memungkinkan untuk pengujian, ini tidak disarankan untuk produksi. PC server harus menjadi stasiun khusus.