HandyCafe Docs
owner it-admin

Cara Menyediakan Kafeteria

Panduan ini menerangkan persediaan pertama kali modul Kafeteria secara lengkap. Pada akhirnya anda akan mempunyai menu pelanggan yang diterbitkan di handy.cafe/{your-slug}, pelan lantai dengan sekurang-kurangnya satu meja yang berfungsi, menu dengan produk dan pesanan ujian yang berjaya dihantar.

Apa Yang Anda Perlukan

  • Lesen HandyCafe yang aktif. Pengesahan Kafeteria menggunakan lesen itu secara automatik; anda tidak perlu menampal kunci secara manual.
  • Sambungan internet pada pelayan. Kafeteria berasaskan awan, jadi penyediaan, penyegerakan menu dan pengundian pesanan semuanya memerlukan akses keluar ke API awan.
  • Slug yang ingin anda gunakan untuk URL menu awam. Aksara yang dibenarkan ialah huruf kecil, nombor dan tanda sempang. Panjangnya 3 hingga 62 aksara.
  • Pilihan: logo dan imej pengepala. Format yang disyorkan ialah WebP sehingga 2 MB.
  • Pilihan: pencetak resit TCP pada rangkaian tempatan.

Langkah 1: Aktifkan Kafeteria

  1. Buka HandyCafe Server.
  2. Navigasi ke Tetapan di bar sisi.
  3. Buka tab Kafeteria.
  4. Togol Aktifkan Kafeteria kepada hidup.
  5. Pelayan akan menghubungi API awan menggunakan lesen anda sebagai token kebenaran. Jika berjaya, Wizard Penyediaan akan dibuka.

Hasil yang dijangka: Skrin Wizard Penyediaan muncul. Jika anda melihat ralat berkaitan lesen atau sambungan, semak sambungan internet anda dan sahkan lesen HandyCafe anda aktif.

Langkah 2: Sediakan Kafe Anda

Wizard akan meminta empat medan.

  1. Slug. Taip akhiran URL yang anda inginkan. Penunjuk ketersediaan akan dikemas kini dalam masa satu saat. Jika slug sudah digunakan atau terpelihara, pilih yang lain.
  2. Nama Paparan. Nama yang boleh dibaca manusia dan dipaparkan di bahagian atas menu pelanggan, contohnya "Atilla's Gaming Lounge".
  3. Negara dan Mata Wang. Pilih negara tempat kafe beroperasi. Mata wang akan lalai berdasarkan negara dan boleh ditukar.
  4. Zon Masa. Pilih zon masa untuk cap masa pesanan dan penyelesaian.
  5. Klik Cipta Kafe.

Hasil yang dijangka: Wizard ditutup dan ruang kerja Kafeteria dibuka. URL awam anda handy.cafe/{slug} kini aktif, walaupun menunya masih kosong.

Langkah 3: Isikan Profil Perniagaan

  1. Masih di bawah Tetapan > Kafeteria, tatal ke bahagian Profil Perniagaan.
  2. Muat naik Logo (imej segi empat).
  3. Muat naik Imej Pengepala (sepanduk lebar).
  4. Masukkan Alamat dan Telefon untuk dipaparkan di pengaki menu pelanggan.
  5. Togol Tunjuk Masa Penyediaan pada Menu hidup atau mati bergantung pada sama ada anda mahu pelanggan melihat anggaran masa penyediaan.
  6. Klik Simpan.

Hasil yang dijangka: Logo dan pengepala muncul dalam pratonton. Melawat handy.cafe/{slug} dalam penyemak imbas kini memaparkan pengepala berjenama tetapi kandungannya masih kosong.

Langkah 4: Cipta Tingkat

  1. Dalam Tetapan > Kafeteria, cari bahagian Tingkat.
  2. Klik Tambah Tingkat dan namakannya (contohnya "Dewan Utama").
  3. Tambah tingkat tambahan jika venue anda mempunyai banyak kawasan (contohnya "Mezanin", "Anjung Luar").
  4. Susun semula tingkat dengan butang naik dan turun. Tingkat paling atas menjadi lalai dalam penyunting Pelan Lantai.

Hasil yang dijangka: Tingkat anda muncul dalam senarai. Tab Kafeteria > Pelan Lantai kini memaparkan pil tingkat di bahagian atas.

Langkah 5: Bina Pelan Lantai

  1. Buka Kafeteria > Pelan Lantai.
  2. Pilih tingkat pertama daripada pil.
  3. Klik Tambah Meja. Meja segi empat akan muncul pada asal kanvas.
  4. Seret meja ke kedudukan yang dikehendaki. Lepaskan untuk menyimpan.
  5. Klik meja untuk membuka panel sifatnya. Konfigurasikan:
    • Kod (contohnya "T1", "Tingkap 3").
    • Nama Paparan (label lebih panjang pilihan).
    • Bilangan Tempat Duduk (jumlah tempat duduk).
    • Bentuk (segi empat, segi empat tepat mendatar, segi empat tepat menegak atau bulat).
    • Saiz (1 hingga 10).
  6. Ulang untuk setiap meja di tingkat tersebut.
  7. Secara pilihan tukar ke paparan 3D untuk menyemak susun atur dari perspektif arkitek.

Hasil yang dijangka: Pelan lantai anda memaparkan semua meja pada kedudukan sebenar. Seretan dilumpuhkan dalam paparan 3D; tukar semula ke 2D untuk mengalihkan meja.

Langkah 6: Bina Menu

  1. Buka Kafeteria > Menu.
  2. Klik Tambah Kategori. Masukkan nama dan pilih ikon MDI daripada pemilih ikon. Klik Simpan.
  3. Ulang untuk setiap kategori (contohnya "Minuman Panas", "Minuman Sejuk", "Burger", "Pencuci Mulut").
  4. Dalam kategori, klik Tambah Produk. Masukkan:
    • Nama.
    • Penerangan (Markdown disokong).
    • Baris bahan.
    • Harga Asas.
    • Kadar VAT.
    • Masa Penyediaan (sandaran statik).
    • Pilihan: label unit, bendera Jejak Stok, kiraan Dalam Stok.
  5. Muat naik Foto produk. Sebarang format diterima; WebP sehingga 2 MB disyorkan.
  6. Klik Simpan.
  7. Jika produk mempunyai pilihan, tatal ke bahagian Varian dan klik Tambah Varian. Cipta satu baris bagi setiap pilihan dengan perbezaan harga. Hidupkan Wajib jika pelanggan mesti memilih satu.
  8. Ulang untuk setiap produk dalam menu anda.

Hasil yang dijangka: Menu pelanggan di handy.cafe/{slug} kini memaparkan kategori dan produk anda. Lawatinya dalam penyemak imbas untuk mengesahkan.

Langkah 7: Konfigurasikan Pencetak (Pilihan)

  1. Masih di bawah Tetapan > Kafeteria, tatal ke Tetapan Pencetak.
  2. Tetapkan Jenis kepada TCP.
  3. Masukkan IP dan Port pencetak. Kebanyakan pencetak ESC POS TCP mendengar pada port 9100.
  4. Hidupkan Auto Cut jika pencetak menyokongnya.
  5. Hidupkan Auto Print on New Order untuk mencetuskan cetakan bagi setiap pesanan baharu yang masuk.
  6. Hidupkan Sound Notification untuk amaran audio bersama notifikasi desktop.
  7. Klik Test Print. Resit sampel sepatutnya dicetak dalam beberapa saat.

Hasil yang dijangka: Resit ujian dicetak dengan berjaya. Jika tiada apa-apa dicetak, sahkan IP, port dan bahawa pencetak berada pada rangkaian tempatan yang sama dengan pelayan.

Langkah 8: Tempatkan Meja dan Ambil Pesanan Ujian

  1. Buka Kafeteria > Meja (atau gunakan menu tindakan Pelan Lantai).
  2. Pilih satu meja dan klik Tempatkan Pelanggan (juga dilabelkan "Buka Meja").
  3. Catat kod keselamatan 6 digit yang dipaparkan. Tuliskannya atau biarkan dialog terbuka.
  4. Pada telefon, pergi ke handy.cafe/{slug}/{table-code}. Anda juga boleh mengimbas QR jika anda mempunyai pelekat yang dicetak.
  5. Masukkan kod 6 digit itu.
  6. Semak menu dan tambah satu item ke troli.
  7. Teruskan ke checkout. Pilih Cash sebagai kaedah pembayaran (persediaan Stripe adalah pilihan dan boleh ditambah kemudian).
  8. Hantar pesanan.
  9. Pada pelayan, tukar ke Kafeteria > Pesanan.

Hasil yang dijangka: Dalam masa 3 saat, kad pesanan baharu muncul pada papan pemuka Pesanan. Notifikasi desktop dipaparkan. Amaran audio dimainkan jika notifikasi bunyi diaktifkan. Lencana kiraan belum selesai meningkat pada tab Pesanan.

Langkah 9: Gerakkan dan Selesaikan Pesanan Ujian

  1. Pada kad pesanan, klik butang status seterusnya. Pesanan bergerak daripada placed ke confirmed.
  2. Terus klik untuk maju melalui preparing, ready dan served.
  3. Pada halaman Meja, buka meja yang sama dan klik Settle Check.
  4. Pilih Cash sebagai kaedah pembayaran dan sahkan.

Hasil yang dijangka: Meja kembali ke idle. Kod keselamatan tamat tempoh. Rekod penyelesaian dicipta dan boleh diaudit kemudian.

Kesilapan Lazim Yang Perlu Dielakkan

  • Melangkau profil perniagaan. Pelanggan akan melihat nama paparan lalai dan kawasan logo yang rosak jika anda melancarkan sebelum menyimpan profil.
  • Tidak mencetak semula kod QR selepas slug berubah. Menukar slug membatalkan setiap QR sedia ada. Cetak pelekat baharu dan gantikan pada setiap meja.
  • Menerbitkan terlalu banyak kategori semasa pelancaran. Sasarkan 6 hingga 10 kategori tahap atas. Pelanggan lebih cepat menyemak menu apabila ia muat pada skrin.
  • Lupa mengkonfigurasikan pencetak sebelum syif sebenar pertama. Tanpa Auto Print on New Order, staf mungkin terlepas pesanan semasa waktu sibuk. Sentiasa jalankan sekurang-kurangnya satu cetakan ujian.
  • Membiarkan Tunjuk Masa Penyediaan pada Menu lalai dihidupkan tanpa sejarah dinamik. Untuk 30 hari pertama, nilai statik ialah yang dilihat pelanggan. Tetapkan masa statik yang realistik atau matikan cip itu sehingga anggaran dinamik dilatih.
  • Menggunakan peranti yang sama untuk ujian staf dan pelanggan. Sesi pelanggan kekal selama 24 jam; jika peranti ujian anda kemudian diberikan kepada pelanggan, mereka sudah berada pada menu tanpa pengesahan. Kosongkan peranti atau gunakan profil penyemak imbas bersih untuk ujian.