Menu Pelanggan

Menu pelanggan ialah halaman web awam pada handy.cafe/{your-slug}. Pelanggan mengaksesnya dengan mengimbas kod QR pada meja mereka. Halaman ini menerangkan aliran pelanggan dari hujung ke hujung supaya anda boleh menerangkannya kepada staf dan merancang pelancaran anda.

Struktur URL

Setiap meja mempunyai URL unik dalam bentuk handy.cafe/{cafe-slug}/{table-code}. Kod QR menyandikan URL ini bersama token yang sah untuk tempoh singkat yang membuktikan pelekat itu asli. Apabila pelanggan mengimbas QR:

1. Telefon mereka membuka URL dalam penyemak imbas lalai.
2. Halaman menyelesaikan slug dan kod meja terhadap API awan.
3. Jika meja berada dalam keadaan out_of_order, halaman memaparkan notis tidak tersedia.
4. Jika meja berada dalam keadaan idle, halaman menerangkan bahawa staf belum menempatkan pelanggan dan meminta mereka memanggil bantuan.
5. Jika meja berada dalam keadaan in_use, halaman meminta kod keselamatan 6 digit.

Pengesahan Kod Keselamatan

Kod keselamatan memastikan hanya pelanggan yang sedang ditempatkan di meja itu boleh membuat pesanan. Ia menghalang seseorang yang melihat QR dari foto atau dari luar kafe anda daripada membuat pesanan palsu.

Selepas pelanggan memasukkan kod:

1. API mengesahkan kod terhadap nilai yang di-hash yang disimpan pada meja.
2. Jika sah, sesi dicipta dan token dikembalikan.
3. Token disimpan dalam kuki (hc_menu_session). Sandaran token Bearer turut disimpan dalam storan tempatan peranti. Ini perlu pada Safari iPhone, yang mungkin menyekat kuki pihak ketiga dalam sesetengah konfigurasi.
4. Pelanggan dialihkan ke menu.

Sesi sah selama 24 jam dari masa dikeluarkan. Jika pelanggan menutup penyemak imbas dan kembali pada peranti yang sama, sesi masih berfungsi dan mereka boleh masuk semula tanpa pengesahan semula.

Bahasa

Menu menyokong 24 bahasa: Arab, Jerman, Yunani, Inggeris, Sepanyol, Farsi, Perancis, Hindi, Indonesia, Itali, Jepun, Korea, Melayu, Poland, Portugis, Romania, Rusia, Thai, Tagalog, Turki, Ukraine, Urdu, Vietnam dan Cina.

Pada lawatan pertama, halaman memeriksa pengepala Accept-Language daripada penyemak imbas dan memilih padanan terbaik. Pelanggan boleh menukar bahasa pada bila-bila masa menggunakan pemilih di bahagian atas menu. Bahasa yang dipilih diingati untuk sesi itu.

Nama produk, penerangan dan ramuan tidak diterjemahkan secara automatik; ia dipaparkan dalam bahasa yang anda masukkan dalam penyunting menu. Label UI seperti "Add to Cart", "Checkout" dan mesej aliran pembayaran diterjemahkan sepenuhnya.

Tema

Menu menyokong tema cerah dan tema gelap. Lalai adalah peka peranti: jika sistem operasi pelanggan ditetapkan kepada mod gelap, menu dibuka dalam mod gelap. Suis tema di bahagian atas membolehkan pelanggan menukar tema.

Pengepala Berjenama

Pengepala di bahagian atas menu memaparkan:

Sesuaikan medan ini untuk memberi kesan terbaik kepada pelanggan. Pelanggan akan mengenali jenama anda apabila menu kelihatan sepadan dengan papan tanda fizikal venue.

Menjelajah Menu

Menu dikumpulkan mengikut kategori. Dalam setiap kategori, produk dipaparkan dengan imej kecil, nama, penerangan ringkas dan harga.

Mengetik produk membuka helaian produk. Helaian itu memaparkan:

• Foto penuh.
• Penerangan Markdown.
• Baris ramuan.
• Cip masa penyediaan (hanya apabila Tunjuk Masa Penyediaan pada Menu diaktifkan).
• Label unit jika dikonfigurasikan (contohnya "250 ml").
• Pemilih varian untuk mana-mana kumpulan varian yang dilampirkan pada produk.
• Pelaras kuantiti.
• Butang Tambah ke Troli.

Kumpulan varian yang wajib akan menyekat butang Tambah ke Troli sehingga pelanggan memilih pilihan.

Troli

Ikon troli berada di lokasi tetap supaya pelanggan boleh mencapainya dari mana-mana skrin. Kandungan troli kekal semasa navigasi dalam laman; melayari dari troli ke menu dan kembali semula tidak akan menghilangkan item.

Troli membolehkan pelanggan:

• Melaraskan kuantiti bagi setiap baris.
• Mengeluarkan baris.
• Menambah nota pilihan.
• Memberi nombor telefon (pilihan).

Subjumlah, VAT dan jumlah keseluruhan dipaparkan secara masa nyata.

Membuat Pesanan

Langkah Checkout menawarkan satu atau dua kaedah pembayaran bergantung pada konfigurasi anda:

Cash

Jika pembayaran dalam talian dimatikan dalam tetapan anda, hanya Cash dipaparkan. Pelanggan mengesahkan pesanan dan ia dihantar serta-merta. Pelanggan membayar juruwang apabila pesanan tiba.

Online (Stripe Checkout)

Jika pembayaran dalam talian diaktifkan, Online muncul sebagai pilihan. Semasa dihantar:

1. Pesanan dicipta dalam keadaan pending.
2. Client secret Stripe Checkout dikembalikan.
3. UI terbenam Stripe dibuka secara inline. Pelanggan memasukkan butiran kad.
4. Setelah pengesahan berjaya, Stripe mengesahkan caj dan pesanan bertukar kepada paid.
5. Pelanggan melihat halaman berjaya.

Pembayaran gagal atau terbengkalai akan meninggalkan pesanan dalam keadaan pending. Percubaan kedua boleh dibuat daripada sesi yang sama, atau staf boleh membatalkan pesanan dari papan pemuka Pesanan.

Halaman Berjaya

Selepas penghantaran berjaya, pelanggan akan tiba pada halaman resit yang memaparkan:

• Nombor pesanan dan masa.
• Setiap baris dengan kuantiti, varian dan jumlah baris.
• Subjumlah, VAT dan jumlah besar.
• Kaedah pembayaran.
• Ikon status pembayaran (pending untuk cash; paid untuk online).
• Panggilan tindakan "Place Another Order" yang kembali ke menu dengan sesi masih kekal.
• Pautan "Back to Menu".

Pengundian Status Pesanan

Selepas dihantar, paparan pelanggan bagi pesanan akan mengundi endpoint status untuk mencerminkan kemas kini dari dapur. Jika staf menggerakkan item daripada preparing ke ready, pelanggan akan melihat lencana pada baris itu dikemas kini secara automatik dalam masa beberapa saat.

Ini berguna untuk pengambilan layan diri di kaunter. Pelanggan boleh berehat di meja sehingga menu memberitahu bahawa pesanan sudah siap.

Apa Yang Pelanggan Tidak Boleh Lakukan

• Pelanggan tidak boleh menyemak menu tanpa kod keselamatan. Langkah pengesahan sentiasa diperlukan.
• Pelanggan tidak boleh membuat pesanan untuk meja yang berada dalam keadaan idle atau out_of_order.
• Pelanggan tidak boleh menyunting atau membatalkan pesanan selepas ia dihantar. Pembatalan ialah tindakan staf dari papan pemuka Pesanan.

Petua Untuk Pengalaman Pelanggan Yang Bersih

• Cetak pelekat QR dengan nama kafe dan arahan yang jelas seperti "Imbas untuk pesan. Tanya staf untuk kod." Pelanggan kadang-kadang terlepas langkah pengesahan.
• Kekalkan nama kategori dan produk pendek. Nama yang panjang akan membalut pada telefon dan menolak imej di bawah lipatan.
• Muat naik sekurang-kurangnya satu foto bagi setiap produk. Menu yang banyak imej biasanya menukar lebih baik daripada menu teks sahaja.
• Hidupkan Tunjuk Masa Penyediaan pada Menu hanya selepas anggaran dinamik anda telah dilatih. Dalam 30 hari pertama, nilai statik mungkin terlalu longgar atau terlalu ketat, dan pelanggan akan perasan.
• Uji aliran penuh sendiri dari telefon sebelum membuka kepada pelanggan. Imbas QR sebenar, masukkan kod, buat pesanan ujian dan sahkan pesanan muncul pada papan pemuka anda.