HandyCafe Docs
owner it-admin

Kafetaria

Kafetaria adalah modul layanan makanan dan minuman terintegrasi di HandyCafe. Modul ini memungkinkan Anda membuat denah digital meja, menerbitkan menu swalayan bermerek di web pada handy.cafe/{your-slug}, dan melacak setiap pesanan masuk secara real-time dari dasbor server.

Pelanggan memindai kode QR di meja mereka, memasukkan kode keamanan 6 digit, menjelajahi menu dalam bahasa mereka sendiri, lalu memesan. Pesanan muncul di layar Pesanan Kafetaria dalam hitungan detik. Staf Anda mengakui setiap tahap persiapan, dan ketika layanan selesai, aksi "Selesaikan Tagihan" menutup bill dalam satu langkah.

Untuk Siapa Ini

Kafetaria dirancang untuk warnet, pusat gaming, dan arena esports yang juga melayani makanan dan minuman di kursi pelanggan. Modul ini menggantikan nota pesanan kertas dan permintaan verbal ke konter. Kafetaria bekerja berdampingan dengan sistem sesi dan harga HandyCafe standar; pesanan Kafetaria dilacak secara terpisah tetapi tetap memakai lisensi kafe yang sama.

Kemampuan Inti

Kemampuan Ringkasan
Denah lantai Editor visual untuk beberapa lantai. Seret meja ke posisi yang diinginkan, ganti ke tampilan 3D, tandai meja yang sedang tidak beroperasi.
Meja Atur jumlah kursi per meja, bentuk, ukuran (1 sampai 10), dan kode tampilan. Hasilkan kode QR dan putar ulang sesuai kebutuhan.
Menu Kategori dengan ikon MDI, produk dengan foto, deskripsi Markdown, daftar bahan, dan kelompok varian (misalnya Ukuran, Topping).
Pesanan Dasbor langsung dengan polling 3 detik, lencana jumlah tertunda, notifikasi desktop dan audio, serta status per pesanan dan per item.
Penyelesaian Aksi tutup tagihan satu klik yang menyelesaikan semua pesanan terbuka pada satu meja dengan metode pembayaran yang dipilih.
Menu pelanggan Menu web bermerek dalam 24 bahasa di handy.cafe/{slug}, dengan tema terang dan gelap serta bahasa bawaan yang menyesuaikan perangkat.
Pembayaran online Integrasi Stripe Checkout opsional untuk bayar saat memesan, dengan fallback ke pembayaran tunai di meja.
Printer Printer struk TCP opsional dengan auto-cut dan auto-print pada pesanan baru.

Di Mana Kafetaria Berada di UI Server

Kafetaria punya dua titik masuk:

  1. Bagian Kafetaria di bilah samping. Ini adalah ruang kerja operasional untuk penggunaan harian. Di dalamnya ada lima tab: Tables, Floor Plan, Menu, Orders, dan Schedule. Tab Orders menampilkan badge tertunda setiap kali ada pesanan baru menunggu.
  2. Pengaturan > Kafetaria. Ini adalah area konfigurasi. Di sini ada profil bisnis (slug, nama tampilan, logo, header image, alamat, mata uang, zona waktu), pengaturan printer, manajemen lantai, dan toggle fitur opsional.

Provisioning Kafe

Saat Anda mengaktifkan Kafetaria untuk pertama kali, server otomatis menggunakan lisensi HandyCafe Anda sebagai token otorisasi. Anda tidak perlu menempelkan apa pun secara manual. Wizard provisioning kemudian meminta empat informasi:

  1. Slug. Ini menjadi URL publik pada handy.cafe/{slug}. Karakter yang diizinkan adalah huruf kecil, angka, dan tanda minus. Panjang slug 3 sampai 62 karakter. Sistem memeriksa ketersediaan secara real-time dan menolak slug terlarang seperti "admin", "api", atau "dashboard".
  2. Display name. Nama yang mudah dibaca dan ditampilkan di bagian atas menu pelanggan.
  3. Country and currency. Mata uang default untuk harga menu. Harga disimpan dalam satuan minor (misalnya sen) dan ditampilkan dengan simbol mata uang yang dikonfigurasi.
  4. Timezone. Dipakai untuk perhitungan waktu persiapan dinamis, cap waktu pada pesanan, dan catatan penyelesaian.

Setelah provisioning selesai, kafe dibuat di database cloud dan ruang kerja Kafetaria terbuka. Anda kemudian bisa menambahkan lantai, meja, dan item menu.

Profil Bisnis

Profil bisnis dapat diedit kapan saja di Pengaturan > Kafetaria. Kolom utamanya:

Kolom Tujuan
Slug Segmen URL publik. Mengubah slug akan membuat kode QR yang sudah ada tidak berlaku sampai dibuat ulang.
Nama Tampilan Ditampilkan di bagian atas menu pelanggan.
Logo Gambar persegi. Disarankan WebP hingga 2 MB.
Header Image Gambar banner lebar di bagian atas menu pelanggan. Disarankan WebP hingga 2 MB.
Alamat dan Telepon Opsional. Ditampilkan di footer menu.
Mata Uang Diterapkan ke setiap harga produk di menu.
Negara Dipakai untuk pajak dan default regional.
Zona Waktu Diterapkan pada cap waktu pesanan dan penyelesaian.
Tampilkan Waktu Persiapan di Menu Toggle. Saat aktif, setiap produk menampilkan chip estimasi waktu persiapan.

Pengaturan Printer

Bagian printer menerima konfigurasi berikut:

  • Jenis. Disabled atau TCP. Pencetakan langsung via USB tidak didukung pada rilis ini.
  • IP dan Port. Alamat jaringan printer struk Anda. Sebagian besar printer ESC POS TCP mendengarkan di port 9100.
  • Auto Cut. Menambahkan perintah potong kertas setelah setiap struk dicetak.
  • Auto Print on New Order. Saat aktif, setiap pesanan baru akan otomatis memicu cetak struk.
  • Sound Notification. Memainkan notifikasi audio selain notifikasi desktop saat pesanan baru datang.
  • Test Print. Mengirim struk contoh ke printer yang dikonfigurasi untuk memeriksa koneksi.

Ringkasan Arsitektur

Kafetaria menggunakan model data cloud-first. Setiap tabel, kategori, produk, pesanan, dan catatan penyelesaian disimpan di database cloud handy.cafe. Server HandyCafe lokal Anda mencerminkan status ini dan melakukan polling ke endpoint Orders setiap 3 detik untuk aktivitas baru. Halaman yang terlihat oleh pelanggan disajikan langsung oleh cloud handy.cafe; halaman tersebut tidak memerlukan server Anda dapat dijangkau dari internet.

Karena data berada di cloud:

  • Kode QR tetap berfungsi meskipun server offline, tetapi staf tidak bisa melihat pesanan di dasbor sampai konektivitas kembali.
  • Perubahan menu dikirim ke handy.cafe dalam hitungan detik setelah disimpan.
  • Pesanan yang dibuat pelanggan sampai ke dasbor Orders setelah polling 3 detik berikutnya.

Langkah Berikutnya