HandyCafe Docs
owner

Kafenizi Baştan Kurma Rehberi

Bu kılavuz, internet kafeniz, oyun merkeziniz veya e-spor arenanız için yeni bir HandyCafe kurulumunun her adımını size anlatır. Sonunda çalışan bir sunucunuz, en az bir bağlı istemci bilgisayarınız, yapılandırılmış fiyatlandırmanız ve ödeme kaydı yapılmış bir test oturumunuz olacak.

İhtiyacınız Olanlar

  • HandyCafe Sunucusu olarak kullanılacak bir Windows PC (Windows 10 veya daha yeni, en az 4 GB RAM).
  • İstemci istasyonu olarak kullanılacak en az bir ek Windows PC.
  • Tüm PC'leri bağlayan yerel bir ağ (güvenilirlik için kablolu Ethernet önerilir).
  • Geçerli bir HandyCafe beta lisans anahtarı. İlk kurulum sırasında bunu gireceksiniz.
  • Önceden belirlenmiş saatlik ücret ve para birimi.

Aşama 1: Sunucuyu Kur ve Yapılandır

  1. HandyCafe panonuzdan en son HandyCafe Sunucu yükleyicisini indirin.
  2. Sunucu olarak belirlediğiniz PC'de yükleyiciyi çalıştırın. Ekrandaki talimatları izleyin ve varsayılan kurulum dizinini kabul edin.
  3. HandyCafe Sunucusunu başlatın. İlk çalıştırmada İlk Kurulum sihirbazı otomatik olarak açılacaktır.
  4. İstendiğinde beta lisans anahtarınızı girin. Sunucu anahtarı çevrimiçi olarak doğrular ve kafe adınızı ve PC sınırınızı gösterir.
  5. Yönetici hesabınızı oluşturun. Bir kullanıcı adı ve güçlü bir şifre girin. Bu hesap tüm özelliklere sınırsız erişime sahiptir.
  6. Kafe adınızı belirleyin. Bu ad, istemci bekleme ekranlarında ve raporlarda görünecektir.
  7. Sihirbazı tamamlamak için Bitir'e tıklayın.

Beklenen sonuç: Sunucu ana penceresi, bağlı istemci olmayan Yönetim Panelini gösterir. Kafe adınız başlık çubuğunda görünür.


Aşama 2: Fiyatlandırmayı Yapılandır

  1. Sol kenar çubuğundaki dişli simgesine tıklayarak Ayarlar sayfasını açın.
  2. Fiyatlandırma sekmesine gidin.
  3. Temel para biriminizi ayarlayın. Para birimi açılır menüsünden seçin. Tüm fiyatlar, işlemler ve raporlar bu para birimini kullanacaktır.
  4. Saatlik ücretinizi girin. Bu, ön ödemeli oturumlar için saat başına temel fiyattır. Örneğin, saat başına para biriminizin on birimi için 10,00 girin.
  5. KDV oranını ayarlayın. Oturum ücretlerine uygulanan yüzdeyi (0'dan 100'e kadar) girin. KDV uygulanmıyorsa 0 girin.
  6. Başlangıç ücretini ayarlayın. Bu, süreden bağımsız olarak oturum başına minimum ücrettir. Minimum ücret istemiyorsanız 0 girin.
  7. Yaygın süreler için fiyatlandırma ön ayarları oluşturun. Ön Ayarlar bölümüne gidin. Ön Ayar Ekle'ye tıklayın. Şu ön ayarları oluşturun:
    • "30 Dakika" ile 30 dakika süre.
    • "1 Saat" ile 60 dakika süre.
    • "2 Saat" ile 120 dakika süre.
  8. Fiyatlandırma yapılandırmanızı uygulamak için Kaydet'e tıklayın.

Beklenen sonuç: Fiyatlandırma sekmesi, saatlik ücretinizi, KDV oranınızı, başlangıç ücretinizi ve aşağıda listelenen tüm ön ayarları gösterir. Bu ön ayarlar, ön ödemeli oturumlar başlatılırken hızlı seçim butonları olarak görünecektir.


Aşama 3: Ağ Ayarlarını Doğrula

  1. Hâlâ Ayarlar'dayken, Ağ sekmesine gidin.
  2. Dinleme portunu doğrulayın. Varsayılan 7842'dir. Ağınızdaki başka bir hizmet bu portu kullanıyorsa yalnızca değiştirin.
  3. Bağlantı anahtarını ayarlayın veya not edin. Bu anahtar, istemci bağlantılarını doğrular. Tüm istemci PC'ler bağlanmak için aynı anahtarı kullanmalıdır.
  4. Sunucu PC'nin güvenlik duvarının, yapılandırılmış port üzerinden gelen TCP bağlantılarına izin verdiğinden emin olun. Windows'ta, HandyCafe genellikle bu kuralı kurulum sırasında ekler. Portu değiştirdiyseniz, yeni bir güvenlik duvarı kuralı manuel olarak ekleyin.
  5. İstemciler sunucuyu otomatik keşif ile bulamazsa, Ağ sekmesinde gösterilen sunucu PC'nin IP adresini not edin.

Beklenen sonuç: Ağ sekmesi, dinleme portunu ve bağlantı anahtarını gösterir. Sunucu durum göstergesi yeşil renkte "Dinliyor" gösterir.


Aşama 4: İlk İstemciyi Dağıt

  1. Panonuzdan HandyCafe İstemci yükleyicisini indirin.
  2. İlk istemci PC'nize yükleyin. Yükleyiciyi çalıştırın ve talimatları izleyin.
  3. HandyCafe İstemciyi başlatın. İstemci, yerel ağda mDNS aracılığıyla sunucuyu otomatik olarak keşfetmeye çalışacaktır.
  4. Otomatik keşif başarısız olursa, istemci bağlantı diyalogunda sunucu IP adresini ve portunu manuel olarak girin.
  5. Aşama 3'te not ettiğiniz bağlantı anahtarını girin.
  6. Bağlantının kurulmasını bekleyin. İstemci ekranı, saatli bir kilit ekranı gösteren Bekleme sayfasına geçecektir.

Beklenen sonuç: Sunucuda, Yönetim Paneli artık bir bağlı istemci gösterir. İstemci kutucuğu, ana bilgisayar adını ve mavi "Bekleme" durumunu gösterir. İstemci PC kilit ekranını gösterir.

  1. Sunucu, istemciye ana bilgisayar adına göre otomatik bir görüntüleme adı atar. Yeniden adlandırmak için sunucudaki istemci kutucuğunu seçin ve Yeniden Adlandır'a tıklayın.

Aşama 5: İlk Test Oturumunuzu Çalıştırın

  1. Sunucu Yönetim Panelinde, bekleme durumundaki istemci kutucuğunda Başlat'a tıklayın.
  2. Oturum diyalogunda, Sonradan Ödeme'yi seçin. Üye alanını boş bırakın, misafir oturumu için.
  3. Oturumu başlatmak için Onayla'ya tıklayın.

Beklenen sonuç: İstemci kutucuğu yeşile döner ve yukarı doğru sayan bir zamanlayıcı gösterir. İstemci PC'de kilit ekranı kaybolur ve Çevrimiçi Sayfa masaüstü görünür.

  1. Fiyatlandırma hesaplamalarını doğrulamak için oturumu en az 5 dakika çalıştırın.
  2. Sunucudaki yeşil istemci kutucuğunda Durdur'a tıklayın.
  3. Maliyet dökümü diyalogunu inceleyin. Şunları gösterecektir:
    • Süre (örneğin, 5 dakika).
    • Uygulanan saatlik ücret.
    • KDV miktarı.
    • Toplam ücret.
  4. Bir ödeme yöntemi seçin (Varsayılan Nakit'tir).
  5. Oturumu kapatmak ve ödemeyi kaydetmek için Onayla'ya tıklayın.

Beklenen sonuç: İstemci kutucuğu mavi "Bekleme" durumuna döner. İstemci PC tekrar kilit ekranını gösterir. Sistemde bir işlem kaydedilir.


Aşama 6: Nakit Raporunda Doğrula

  1. Sol kenar çubuğunu kullanarak Nakit Raporu sayfasına gidin.
  2. Bugünün raporunun bir oturum işlemi gösterdiğini doğrulayın.
  3. Oturumu durdurduğunuzda gördüğünüz maliyet dökümü ile işlem tutarının eşleştiğini doğrulayın.
  4. Ödeme yöntemi sütununun "Nakit" (veya seçtiğiniz yöntem) gösterdiğini kontrol edin.

Beklenen sonuç: Nakit raporu, doğru miktar, süre ve ödeme yöntemi ile tamamlanmış bir oturum listeler. Kafeniz artık faaliyette.


Aşama 7: İsteğe Bağlı Sonraki Adımlar

Temel kurulumunuz çalışır durumda olduğunda, şu özellikleri yapılandırmayı düşünün:

  1. Üyeler ekleyin. Üyeler sayfasına gidin. Kullanıcı adları ve isteğe bağlı cüzdan bakiyeleri ile üye hesapları oluşturmak için Ekle'ye tıklayın. Üyeler istemci PC'lerden giriş yapabilir.
  2. Ürünleri ayarlayın. Ürünler sayfasına gidin. Kasiyerlerin sipariş oluşturabilmesi için fiyatları ile yiyecek ve içecek ürünleri ekleyin.
  3. İstemci menüsünü yapılandırın. Ayarlar > İstemci Menüsü'ne gidin. Müşterilerin Çevrimiçi Sayfa'da bir başlatıcı ızgarası görmesi için uygulama kategorileri ve uygulamalar ekleyin.
  4. Ek istemciler dağıtın. Kafenizdeki her istasyon PC'ye HandyCafe İstemciyi yükleyin. Her biri sunucuda otomatik olarak görünecektir.
  5. Kasiyer hesapları oluşturun. Yönetim sayfasına gidin. Personelin oturumları yönetebilmesi için uygun rollerle kasiyer hesapları ekleyin.
  6. Yoğun/yoğun olmayan fiyatlandırmayı ayarlayın. Ayarlar > Fiyatlandırma Takvimi'ne gidin. Yoğun saatlerde daha fazla ücret almak için zaman bazlı çarpanlar oluşturun.
  7. OAuth girişini etkinleştirin. Ayarlar > OAuth'a gidin. Müşterilerin sosyal hesaplarıyla giriş yapabilmesi için Google veya diğer sağlayıcıları yapılandırın.

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

  • Güvenlik duvarı kuralını atlamak. İstemciler bağlanamıyorsa, en yaygın neden Windows Güvenlik Duvarı kuralının dinleme portunu engellemesidir. Diğer sorunları çözmeden önce kuralın varlığını doğrulayın.
  • Uyumsuz bağlantı anahtarları. Her istemcideki anahtar, sunucudaki anahtarla tam olarak eşleşmelidir. Yazım hatalarından kaçınmak için kopyala-yapıştır yapın.
  • Saatlik ücreti 0 olarak ayarlamak. Saatlik ücreti sıfır bırakırsanız, tüm sonradan ödemeli oturumlar ücretsiz olur. Canlı yayına geçmeden önce fiyatlandırmanızı her zaman doğrulayın.
  • Ayarları kaydetmeyi unutmak. Ayarlar sayfasındaki değişiklikler, Kaydet'e tıklamadan uygulanmaz. Yeniden başlatmadan sonra ayarlar değişmemiş görünüyorsa, muhtemelen kaydetmeyi unuttunuz.
  • Sunucu ve istemciyi aynı PC'de çalıştırmak. Test için teknik olarak mümkün olsa da, üretim için önerilmez. Sunucu PC, özel bir istasyon olmalıdır.