HandyCafe Docs
owner it-admin

Kafeterya

Kafeterya, HandyCafe içindeki entegre yiyecek ve içecek hizmeti modülüdür. Masalarınız için dijital bir kat planı oluşturmanıza, web üzerinde handy.cafe/{your-slug} adresinde markalı bir self servis menü yayımlamanıza ve gelen her siparişi sunucu panelinden gerçek zamanlı izlemenize olanak tanır.

Müşteriler masalarındaki QR kodu tarar, 6 haneli güvenlik kodunu girer, menüyü kendi dillerinde inceler ve sipariş verir. Sipariş birkaç saniye içinde Kafeterya Siparişler ekranında görünür. Personeliniz hazırlığın her aşamasını onaylar ve servis tamamlandığında "Hesap Kes" işlemi hesabı tek adımda kapatır.

Kimler İçin

Kafeterya; müşterilerin oturduğu yerden yiyecek ve içecek de servis eden internet kafeler, oyun merkezleri ve espor arenaları için tasarlanmıştır. Kağıt sipariş fişlerinin ve kasaya sözlü isteklerin yerini alır. Standart HandyCafe oturum ve fiyatlandırma sistemiyle birlikte çalışır; Kafeterya siparişleri ayrı izlenir ama aynı kafe lisansı üzerinde tutulur.

Temel Özellikler

Özellik Özet
Kat planı Birden fazla kata kadar görsel düzenleyici. Masaları sürükleyip yerleştirin, 3D görünüme geçin, masaları hizmet dışı olarak işaretleyin.
Masalar Masa başına oturma sayısını, şekli, boyutu (1 ile 10 arası) ve görüntü kodunu yapılandırın. QR kodları üretin ve gerektiğinde yenileyin.
Menü MDI simgeli kategoriler, fotoğraflı ürünler, Markdown açıklamaları, içerik listeleri ve varyant grupları (örneğin Boyut, Ek Malzeme).
Siparişler 3 saniyelik sorgulamayla çalışan canlı panel, bekleyen sayı rozeti, masaüstü ve sesli bildirimler, sipariş ve ürün bazlı durum takibi.
Hesap kapatma Seçilen ödeme yöntemiyle bir masadaki tüm açık siparişleri tek tıkla kapatan işlem.
Müşteri menüsü handy.cafe/{slug} adresinde 24 dilli markalı web menüsü; açık/koyu tema ve cihaza duyarlı varsayılan dil desteğiyle.
Çevrimiçi ödeme Sipariş sırasında ödeme için isteğe bağlı Stripe Checkout entegrasyonu ve masa başında nakit ödeme seçeneği.
Yazıcı Yeni siparişlerde otomatik kes ve otomatik yazdır destekli isteğe bağlı TCP fiş yazıcısı.

Kafeterya Sunucu Arayüzünde Nerede Bulunur

Kafeterya'nın iki giriş noktası vardır:

  1. Kenar çubuğundaki Kafeterya bölümü. Günlük kullanım için operasyon alanıdır. Tables, Floor Plan, Menu, Orders ve Schedule olmak üzere beş sekme içerir. Orders sekmesinde yeni siparişler bekliyorsa bir bekleyen rozeti görünür.
  2. Ayarlar > Kafeterya. Yapılandırma alanıdır. İşletme profilini (slug, görüntü adı, logo, başlık görseli, adres, para birimi, saat dilimi), yazıcı ayarlarını, kat yönetimini ve isteğe bağlı özellik anahtarlarını içerir.

Bir Kafe Sağlama

Kafeterya'yı ilk kez etkinleştirdiğinizde, sunucu HandyCafe lisansınızı otomatik olarak yetkilendirme belirteci olarak kullanır. Elle hiçbir şey yapıştırmazsınız. Sağlama sihirbazı ardından dört bilgi ister:

  1. Slug. Bu, handy.cafe/{slug} adresindeki herkese açık URL olur. İzin verilen karakterler küçük harfler, rakamlar ve tire işaretidir. Slug 3 ile 62 karakter arasında olmalıdır. Sistem uygunluğu anlık olarak kontrol eder ve "admin", "api" veya "dashboard" gibi ayrılmış slug'ları reddeder.
  2. Görünen ad. Müşteri menüsünün üst kısmında gösterilen okunabilir ad.
  3. Ülke ve para birimi. Menü fiyatları için varsayılan para birimi. Fiyatlar küçük birimlerde tutulur (örneğin kuruş) ve yapılandırılan para birimi simgesiyle gösterilir.
  4. Saat dilimi. Dinamik hazırlık süresi hesaplamaları, sipariş zaman damgaları ve hesap kapatma kayıtları için kullanılır.

Sağlama tamamlandığında kafe bulut veritabanında oluşturulur ve Kafeterya çalışma alanı açılır. Ardından katlar, masalar ve menü öğeleri ekleyebilirsiniz.

İşletme Profili

İşletme profili, Ayarlar > Kafeterya altında istenildiği zaman düzenlenebilir. Temel alanlar:

Alan Amaç
Slug Herkese açık URL bölümü. Slug değişirse mevcut QR kodlar yeniden üretilene kadar çalışmaz.
Görünen Ad Müşteri menüsünün üst kısmında gösterilir.
Logo Kare görsel. 2 MB'a kadar WebP önerilir.
Başlık Görseli Müşteri menüsünün üst kısmındaki geniş banner görseli. 2 MB'a kadar WebP önerilir.
Adres ve Telefon İsteğe bağlıdır. Menü altbilgisinde gösterilir.
Para Birimi Menüdeki tüm ürün fiyatlarına uygulanır.
Ülke Vergi ve bölgesel varsayılanlar için kullanılır.
Saat Dilimi Sipariş ve hesap kapatma zaman damgalarına uygulanır.
Menüde Hazırlık Süresini Göster Aç/kapat anahtarı. Açıkken her ürün tahmini bir hazırlık süresi rozeti gösterir.

Yazıcı Ayarları

Yazıcı bölümü aşağıdaki yapılandırmaları kabul eder:

  • Tür. Devre dışı veya TCP. USB doğrudan yazdırma bu sürümde desteklenmez.
  • IP ve Port. Fiş yazıcınızın ağ adresi. Çoğu ESC POS TCP yazıcısı 9100 numaralı portu dinler.
  • Otomatik Kes. Her yazdırılan fişin ardından kağıt kesme komutunu ekler.
  • Yeni Siparişte Otomatik Yazdır. Açıkken gelen her sipariş otomatik olarak fiş yazdırır.
  • Sesli Bildirim. Yeni sipariş geldiğinde masaüstü bildirime ek olarak sesli uyarı çalar.
  • Test Yazdırma. Bağlantıyı doğrulamak için yapılandırılan yazıcıya örnek bir fiş gönderir.

Mimari Özeti

Kafeterya, bulut öncelikli bir veri modeli kullanır. Her masa, kategori, ürün, sipariş ve hesap kapatma kaydı handy.cafe bulut veritabanında saklanır. Yerel HandyCafe sunucunuz bu durumu yansıtır ve yeni etkinlikler için Orders uç noktasını her 3 saniyede bir yoklar. Müşteri tarafındaki sayfalar doğrudan handy.cafe bulutundan sunulur; internetten erişilebilir olması için sunucunuzun dışarıdan ulaşılabilir olması gerekmez.

Veriler bulutta tutulduğu için:

  • Sunucu çevrimdışı olsa bile QR kodlar çalışmaya devam eder; ancak bağlantı geri gelene kadar personel siparişleri panelde göremez.
  • Menü değişiklikleri kaydedildikten birkaç saniye sonra handy.cafe'ye yansır.
  • Müşterilerin verdiği siparişler, bir sonraki 3 saniyelik yoklamadan sonra Orders paneline ulaşır.

Sonraki Adımlar