HandyCafe Docs
owner it-admin

Kafeterya Nasıl Kurulur

Bu rehber, Kafeterya modülünün ilk kurulumunu adım adım anlatır. Sonunda handy.cafe/{your-slug} adresinde yayınlanmış bir müşteri menünüz, en az bir çalışan masası olan bir kat planınız, ürünlü bir menünüz ve başarıyla verilmiş bir test siparişiniz olacak.

Gerekecekler

  • Aktif bir HandyCafe lisansı. Kafeterya kimlik doğrulaması lisansı otomatik olarak kullanır; elle anahtar girmezsiniz.
  • Sunucuda internet bağlantısı. Kafeterya bulut öncelikli olduğu için sağlama, menü eşitleme ve sipariş yoklaması için buluta giden erişim gerekir.
  • Herkese açık menü URL'si için kullanmak istediğiniz bir slug. İzin verilen karakterler küçük harfler, rakamlar ve tire işaretidir. Uzunluk 3 ile 62 karakter arasında olmalıdır.
  • İsteğe bağlı: logo ve başlık görseli. Önerilen biçim 2 MB'a kadar WebP'dir.
  • İsteğe bağlı: yerel ağda bir TCP fiş yazıcısı.

1. Adım: Kafeterya'yı Etkinleştirin

  1. HandyCafe Server'ı açın.
  2. Kenar çubuğundan Settings bölümüne gidin.
  3. Kafeterya sekmesini açın.
  4. Enable Kafeterya anahtarını açın.
  5. Sunucu, lisansınızı yetkilendirme belirteci olarak kullanarak bulut API'siyle iletişime geçer. Başarılı olursa Provisioning Wizard açılır.

Beklenen sonuç: Provisioning Wizard ekranı görünür. Lisans veya bağlantı hatası görürseniz internet bağlantınızı kontrol edin ve HandyCafe lisansınızın aktif olduğundan emin olun.

2. Adım: Kafenizi Sağlayın

Sihirbaz dört alan ister.

  1. Slug. İstediğiniz URL son ekini yazın. Uygunluk göstergesi bir saniye içinde güncellenir. Slug alınmışsa ya da ayrılmışsa başka bir tane seçin.
  2. Display Name. Müşteri menüsünün üst kısmında görünen okunabilir ad; örneğin "Atilla's Gaming Lounge".
  3. Country and Currency. Kafenin faaliyet gösterdiği ülkeyi seçin. Para birimi ülkeye göre varsayılan olarak gelir ve değiştirilebilir.
  4. Timezone. Sipariş ve hesap kapatma zaman damgaları için saat dilimini seçin.
  5. Create Cafe düğmesine tıklayın.

Beklenen sonuç: Sihirbaz kapanır ve Kafeterya çalışma alanı açılır. Herkese açık handy.cafe/{slug} adresiniz artık canlıdır, ancak menü boştur.

3. Adım: İşletme Profilini Doldurun

  1. Hala Settings > Kafeterya altındayken Business Profile bölümüne gidin.
  2. Bir Logo yükleyin (kare görsel).
  3. Bir Header Image yükleyin (geniş banner).
  4. Müşteri menüsünün alt kısmında gösterilecek Address ve Phone bilgilerini girin.
  5. Müşterilerin tahmini hazırlık sürelerini görmesini isteyip istemediğinize göre Show Prep Time on Menu anahtarını açın ya da kapatın.
  6. Save düğmesine tıklayın.

Beklenen sonuç: Logo ve başlık önizlemede görünür. handy.cafe/{slug} adresine tarayıcıdan girdiğinizde markalı başlık görünür, ancak içerik hala boştur.

4. Adım: Katlar Oluşturun

  1. Settings > Kafeterya altında Floors bölümünü bulun.
  2. Add Floor düğmesine tıklayın ve adını verin (örneğin "Main Hall").
  3. Mekanınızda birden fazla alan varsa ek katlar ekleyin (örneğin "Mezzanine", "Outdoor Patio").
  4. Katları yukarı-aşağı taşıma düğmeleriyle yeniden sıralayın. En üstteki kat Floor Plan düzenleyicisinde varsayılan olur.

Beklenen sonuç: Katlar listenizde görünür. Kafeterya > Floor Plan sekmesi artık üstte kat rozetlerini gösterir.

5. Adım: Kat Planını Oluşturun

  1. Kafeterya > Floor Plan öğesini açın.
  2. İlk katı rozetlerden seçin.
  3. Add Table düğmesine tıklayın. Tuvalin başlangıç noktasında kare bir masa görünür.
  4. Masayı istediğiniz konuma sürükleyin. Bıraktığınızda kaydedilir.
  5. Masa özellik panelini açmak için masaya tıklayın. Şunları yapılandırın:
    • Code (örneğin "T1", "Window 3").
    • Display Name (isteğe bağlı daha uzun etiket).
    • Seat Count (oturma sayısı).
    • Shape (square, rectangle horizontal, rectangle vertical veya round).
    • Size (1 ile 10 arası).
  6. Katınızdaki her masa için tekrarlayın.
  7. İsterseniz yerleşimi mimari açıdan incelemek için 3D view'a geçin.

Beklenen sonuç: Kat planınız tüm masaları gerçek konumlarında gösterir. 3D görünümde sürükleme devre dışıdır; masaları taşımak için 2D'ye geri dönün.

6. Adım: Menüyü Oluşturun

  1. Kafeterya > Menu öğesini açın.
  2. Add Category düğmesine tıklayın. Bir ad girin ve simge seçiciden bir MDI simgesi seçin. Kaydet'e tıklayın.
  3. Her kategori için işlemi tekrarlayın (örneğin "Hot Drinks", "Cold Drinks", "Burgers", "Desserts").
  4. Bir kategorinin içinde Add Product düğmesine tıklayın. Şunları girin:
    • Name.
    • Description (Markdown desteklenir).
    • Ingredients satırı.
    • Base Price.
    • VAT Rate.
    • Preparation Time (statik yedek).
    • İsteğe bağlı: Unit etiketi, Track Stock bayrağı, In Stock sayısı.
  5. Ürünün Photo alanına görsel yükleyin. Her format kabul edilir; 2 MB'a kadar WebP önerilir.
  6. Kaydet'e tıklayın.
  7. Üründe seçenekler varsa Variants bölümüne gidin ve Add Variant düğmesine tıklayın. Her seçenek için fiyat farkıyla bir satır oluşturun. Müşteri bir seçim yapmak zorundaysa Required anahtarını açın.
  8. Menünüzdeki her ürün için tekrarlayın.

Beklenen sonuç: handy.cafe/{slug} adresindeki müşteri menüsü artık kategorilerinizi ve ürünlerinizi gösterir. Doğrulamak için bir tarayıcıda ziyaret edin.

7. Adım: Yazıcıyı Yapılandırın (İsteğe Bağlı)

  1. Hala Settings > Kafeterya altındayken Printer Settings bölümüne gidin.
  2. Kind değerini TCP olarak ayarlayın.
  3. Yazıcının IP ve Port bilgilerini girin. Çoğu ESC POS TCP yazıcısı 9100 portunu dinler.
  4. Yazıcı destekliyorsa Auto Cut seçeneğini açın.
  5. Gelen her sipariş için yazdırma başlatmak üzere Auto Print on New Order seçeneğini açın.
  6. Masaüstü bildirimin yanında sesli uyarı için Sound Notification seçeneğini açın.
  7. Test Print düğmesine tıklayın. Birkaç saniye içinde örnek bir fiş basılmalıdır.

Beklenen sonuç: Test fişi başarıyla basılır. Hiçbir şey basılmıyorsa IP'yi, portu ve yazıcının sunucuyla aynı yerel ağda olduğunu doğrulayın.

8. Adım: Bir Masayı Oturtun ve Test Siparişi Verin

  1. Kafeterya > Tables öğesini açın (veya Floor Plan işlem menüsünü kullanın).
  2. Bir masa seçin ve Seat Customer düğmesine tıklayın (bazı yerlerde "Open Table" olarak da görünür).
  3. Görünen 6 haneli güvenlik kodunu not alın. Yazın ya da iletişim kutusunu açık bırakın.
  4. Telefonda handy.cafe/{slug}/{table-code} adresine gidin. Basılı etiketiniz varsa QR'ı da tarayabilirsiniz.
  5. 6 haneli kodu girin.
  6. Menüye göz atın ve sepete bir ürün ekleyin.
  7. Ödeme adımına geçin. Ödeme yöntemi olarak Cash seçin (Stripe kurulumu isteğe bağlıdır ve daha sonra eklenebilir).
  8. Siparişi gönderin.
  9. Sunucuda Kafeterya > Orders bölümüne geçin.

Beklenen sonuç: 3 saniye içinde Orders panelinde yeni bir sipariş kartı görünür. Masaüstü bildirimi gelir. Sesli bildirim açıksa bir uyarı çalar. Orders sekmesindeki bekleyen sayı rozeti artar.

9. Adım: Test Siparişini İlerletin ve Hesabı Kapatın

  1. Sipariş kartında bir sonraki durum düğmesine tıklayın. Sipariş placed durumundan confirmed durumuna geçer.
  2. preparing, ready ve served üzerinden ilerleyene kadar tıklamaya devam edin.
  3. Tables sayfasında aynı masayı açın ve Settle Check düğmesine tıklayın.
  4. Ödeme yöntemi olarak Cash seçin ve onaylayın.

Beklenen sonuç: Masa idle durumuna döner. Güvenlik kodunun süresi dolar. Bir hesap kapatma kaydı oluşturulur ve daha sonra denetlenebilir.

Kaçınılması Gereken Yaygın Hatalar

  • İşletme profilini atlamak. Profili kaydetmeden yayına çıkarsanız müşteriler varsayılan görünen adı ve bozuk logo alanını görür.
  • Slug değişikliğinden sonra QR kodlarını yeniden basmamak. Slug değiştirildiğinde mevcut tüm QR'lar geçersiz olur. Tüm masalar için yeni etiketler bastırın.
  • Açılışta çok fazla kategori yayımlamak. 6 ila 10 üst seviye kategori hedefleyin. Menü ekrana sığdığında müşteriler daha hızlı gezer.
  • İlk gerçek vardiyadan önce yazıcıyı yapılandırmayı unutmak. Auto Print on New Order kapalıysa yoğun dönemde personel siparişleri kaçırabilir. En az bir test yazdırma çalıştırın.
  • Dinamik geçmiş yokken varsayılan Show Prep Time on Menu ayarını açık bırakmak. İlk 30 gün boyunca müşterilerin gördüğü değer statik değerdir. Gerçekçi statik süreler ayarlayın ya da dinamik tahmin eğitilene kadar rozeti kapatın.
  • Personel ve müşteri testleri için aynı cihazı kullanmak. Müşteri oturumu 24 saat sürer; test cihazınız daha sonra bir müşteriye verilirse doğrulama olmadan zaten menüde olur. Testler için cihazı temizleyin ya da temiz bir tarayıcı profili kullanın.