HandyCafe Docs
owner it-admin

Cara Menyiapkan Kafetaria

Panduan ini menjelaskan pengaturan awal Kafetaria secara lengkap. Pada akhirnya Anda akan memiliki menu pelanggan yang diterbitkan di handy.cafe/{your-slug}, denah lantai dengan setidaknya satu meja yang berfungsi, menu berisi produk, dan pesanan uji yang berhasil dibuat.

Yang Anda Butuhkan

  • Lisensi HandyCafe yang aktif. Autentikasi Kafetaria memakai lisensi secara otomatis; Anda tidak perlu menempelkan kunci secara manual.
  • Konektivitas internet di server. Karena Kafetaria cloud-first, provisioning, sinkronisasi menu, dan polling pesanan semuanya memerlukan akses keluar ke cloud API.
  • Slug yang ingin Anda pakai untuk URL menu publik. Karakter yang diizinkan adalah huruf kecil, angka, dan tanda minus. Panjangnya 3 sampai 62 karakter.
  • Opsional: logo dan header image. Format yang disarankan adalah WebP hingga 2 MB.
  • Opsional: printer struk TCP di jaringan lokal.

Langkah 1: Aktifkan Kafetaria

  1. Buka HandyCafe Server.
  2. Navigasikan ke Pengaturan di bilah samping.
  3. Buka tab Kafetaria.
  4. Aktifkan Enable Kafetaria.
  5. Server menghubungi cloud API memakai lisensi Anda sebagai token otorisasi. Jika berhasil, Wizard Penyediaan akan terbuka.

Hasil yang Diharapkan: Layar Wizard Penyediaan muncul. Jika Anda melihat error tentang lisensi atau konektivitas, periksa koneksi internet dan pastikan lisensi HandyCafe Anda masih aktif.

Langkah 2: Provisioning Kafe Anda

Wizard meminta empat kolom.

  1. Slug. Ketik akhiran URL yang Anda inginkan. Indikator ketersediaan diperbarui dalam waktu kurang dari satu detik. Jika slug sudah dipakai atau terlarang, pilih yang lain.
  2. Nama Tampilan. Nama yang mudah dibaca dan ditampilkan di bagian atas menu pelanggan, misalnya "Atilla's Gaming Lounge".
  3. Negara dan Mata Uang. Pilih negara tempat kafe beroperasi. Mata uang akan default berdasarkan negara dan bisa diubah.
  4. Zona Waktu. Pilih zona waktu untuk cap waktu pesanan dan penyelesaian.
  5. Klik Buat Kafe.

Hasil yang Diharapkan: Wizard menutup dan ruang kerja Kafetaria terbuka. URL publik Anda handy.cafe/{slug} kini aktif, walaupun menunya masih kosong.

Langkah 3: Isi Profil Bisnis

  1. Masih di Pengaturan > Kafetaria, scroll ke bagian Profil Bisnis.
  2. Unggah Logo (gambar persegi).
  3. Unggah Gambar Header (banner lebar).
  4. Masukkan Address dan Phone untuk ditampilkan di footer menu pelanggan.
  5. Aktifkan atau nonaktifkan Tampilkan Waktu Siap di Menu sesuai apakah Anda ingin pelanggan melihat estimasi waktu persiapan.
  6. Klik Simpan.

Hasil yang Diharapkan: Logo dan header muncul di preview. Mengunjungi handy.cafe/{slug} di browser sekarang menampilkan header bermerek tetapi isinya masih kosong.

Langkah 4: Buat Lantai

  1. Di Pengaturan > Kafetaria, temukan bagian Floors.
  2. Klik Tambah Lantai dan beri nama (misalnya "Main Hall").
  3. Tambahkan lantai lain jika venue Anda punya beberapa area (misalnya "Mezzanine", "Outdoor Patio").
  4. Urutkan ulang lantai dengan tombol naik dan turun. Lantai teratas menjadi default di editor Denah Lantai.

Hasil yang Diharapkan: Lantai Anda muncul di daftar. Tab Kafetaria > Denah Lantai sekarang menampilkan pil lantai di bagian atas.

Langkah 5: Bangun Denah Lantai

  1. Buka Kafetaria > Denah Lantai.
  2. Pilih lantai pertama dari pil.
  3. Klik Tambah Meja. Meja kotak muncul di titik awal kanvas.
  4. Seret meja ke posisi yang diinginkan. Lepaskan untuk menyimpan.
  5. Klik meja untuk membuka panel propertinya. Atur:
    • Kode (misalnya "T1", "Window 3").
    • Nama Tampilan (label panjang opsional).
    • Jumlah Kursi (jumlah kursi).
    • Bentuk (persegi, persegi panjang horizontal, persegi panjang vertikal, atau bundar).
    • Ukuran (1 sampai 10).
  6. Ulangi untuk setiap meja di lantai itu.
  7. Opsional, beralih ke tampilan 3D untuk meninjau tata letak dari perspektif arsitek.

Hasil yang Diharapkan: Denah Anda merender semua meja pada posisi dunia nyata. Drag dinonaktifkan di tampilan 3D; kembali ke 2D untuk memindahkan meja.

Langkah 6: Bangun Menu

  1. Buka Kafetaria > Menu.
  2. Klik Tambah Kategori. Masukkan nama dan pilih ikon MDI dari pemilih ikon. Klik Simpan.
  3. Ulangi untuk setiap kategori (misalnya "Hot Drinks", "Cold Drinks", "Burgers", "Desserts").
  4. Di dalam kategori, klik Tambah Produk. Masukkan:
    • Nama.
    • Deskripsi (Markdown didukung).
    • Baris bahan.
    • Harga Dasar.
    • Tarif PPN.
    • Waktu Persiapan (cadangan statis).
    • Opsional: label satuan, penanda Lacak Stok, jumlah Tersedia.
  5. Unggah Foto produk. Format apa pun diterima; WebP hingga 2 MB disarankan.
  6. Klik Simpan.
  7. Jika produk punya pilihan, scroll ke bagian Varian dan klik Tambah Varian. Buat satu baris untuk setiap opsi dengan selisih harga. Aktifkan Wajib jika pelanggan harus memilih satu.
  8. Ulangi untuk setiap produk di menu Anda.

Hasil yang Diharapkan: Menu pelanggan di handy.cafe/{slug} sekarang menampilkan kategori dan produk Anda. Buka di browser untuk memeriksa.

Langkah 7: Konfigurasikan Printer (Opsional)

  1. Masih di Pengaturan > Kafetaria, scroll ke Pengaturan Printer.
  2. Atur Jenis ke TCP.
  3. Masukkan IP dan Port printer. Sebagian besar printer ESC POS TCP mendengarkan di port 9100.
  4. Aktifkan Potong Otomatis jika printer mendukungnya.
  5. Aktifkan Cetak Otomatis Saat Pesanan Baru untuk memicu cetak pada setiap pesanan masuk.
  6. Aktifkan Notifikasi Suara untuk peringatan audio bersama notifikasi desktop.
  7. Klik Tes Cetak. Struk contoh seharusnya tercetak dalam beberapa detik.

Hasil yang Diharapkan: Struk uji tercetak dengan sukses. Jika tidak ada yang tercetak, verifikasi IP, port, dan bahwa printer berada di jaringan lokal yang sama dengan server.

Langkah 8: Dudukkan Meja dan Ambil Pesanan Uji

  1. Buka Kafetaria > Meja (atau gunakan menu aksi Denah Lantai).
  2. Pilih satu meja lalu klik Dudukkan Pelanggan (juga berlabel "Buka Meja").
  3. Catat kode keamanan 6 digit yang ditampilkan. Tulis atau biarkan dialog tetap terbuka.
  4. Di ponsel, buka handy.cafe/{slug}/{table-code}. Anda juga bisa memindai QR jika memiliki stiker cetak.
  5. Masukkan kode 6 digit.
  6. Jelajahi menu dan tambahkan item ke keranjang.
  7. Lanjut ke pembayaran. Pilih Tunai sebagai metode pembayaran (penyiapan Stripe opsional dan bisa ditambahkan nanti).
  8. Kirim pesanan.
  9. Di server, pindah ke Kafetaria > Pesanan.

Hasil yang Diharapkan: Dalam 3 detik, kartu pesanan baru muncul di dasbor Pesanan. Notifikasi desktop muncul. Peringatan audio berbunyi jika notifikasi suara diaktifkan. Badge jumlah tertunda bertambah di tab Pesanan.

Langkah 9: Majukan dan Selesaikan Pesanan Uji

  1. Pada kartu pesanan, klik tombol status berikutnya. Pesanan berpindah dari placed ke confirmed.
  2. Terus klik untuk maju melalui preparing, ready, dan served.
  3. Di halaman Meja, buka meja yang sama dan klik Selesaikan Tagihan.
  4. Pilih Tunai sebagai metode pembayaran dan konfirmasi.

Hasil yang Diharapkan: Meja kembali ke idle. Kode keamanan kedaluwarsa. Catatan penyelesaian dibuat dan bisa diaudit nanti.

Kesalahan Umum yang Perlu Dihindari

  • Melewati business profile. Pelanggan akan melihat display name default dan area logo rusak jika Anda meluncurkan sebelum menyimpan profil.
  • Tidak mencetak ulang kode QR setelah slug berubah. Mengubah slug akan membuat semua QR yang sudah ada tidak valid. Cetak stiker baru dan ganti di setiap meja.
  • Menerbitkan terlalu banyak kategori saat peluncuran. Targetkan 6 sampai 10 kategori tingkat atas. Pelanggan menelusuri lebih cepat saat menu muat di layar.
  • Lupa mengonfigurasi printer sebelum shift nyata pertama. Tanpa Cetak Otomatis Saat Pesanan Baru, staf bisa melewatkan pesanan saat periode sibuk. Selalu jalankan setidaknya satu tes cetak.
  • Membiarkan Tampilkan Waktu Siap di Menu aktif dengan riwayat dinamis yang belum cukup. Selama 30 hari pertama, nilai statis adalah yang dilihat pelanggan. Setel waktu statis yang realistis atau matikan chip sampai estimasi dinamis cukup terlatih.
  • Memakai perangkat yang sama untuk tes staf dan pelanggan. Sesi pelanggan bertahan 24 jam; jika perangkat uji Anda kemudian diberikan ke pelanggan, mereka sudah akan berada di menu tanpa verifikasi. Bersihkan perangkat atau gunakan profil browser yang bersih untuk pengujian.