Jak skonfigurować kafejkę od podstaw

Ten przewodnik przeprowadzi Cię przez każdy krok nowej instalacji HandyCafe dla kafejki internetowej, centrum gamingowego lub areny e-sportowej. Na koniec będziesz mieć działający serwer, co najmniej jeden podłączony komputer kliencki, skonfigurowaną wycenę i ukończoną testową sesję z płatnością zarejestrowaną w raporcie kasowym.

Czego będziesz potrzebować

• Komputer z Windows jako HandyCafe Server (Windows 10 lub nowszy, minimum 4 GB RAM).
• Co najmniej jeden dodatkowy komputer z Windows jako stacja kliencka.
• Sieć lokalna łącząca wszystkie komputery (zalecany kablowy Ethernet dla niezawodności).
• Ważny klucz licencji beta HandyCafe. Wprowadzisz go podczas pierwszej konfiguracji.
• Z góry ustaloną pożądaną stawkę godzinową i walutę.

Faza 1: Instalacja i konfiguracja serwera

1. Pobierz najnowszy instalator HandyCafe Server ze swojego panelu HandyCafe.
2. Uruchom instalator na komputerze wyznaczonym jako serwer. Postępuj zgodnie z instrukcjami na ekranie i zaakceptuj domyślny katalog instalacji.
3. Uruchom HandyCafe Server. Kreator Pierwszej Konfiguracji pojawi się automatycznie przy pierwszym uruchomieniu.
4. Wpisz klucz licencji beta gdy zostaniesz poproszony. Serwer zwaliduje klucz online i wyświetli nazwę kafejki i limit komputerów.
5. Utwórz konto administratora. Wpisz nazwę użytkownika i silne hasło. To konto ma nieograniczony dostęp do każdej funkcji.
6. Ustaw nazwę kafejki. Ta nazwa będzie wyświetlana na ekranach bezczynności klientów i w raportach.
7. Kliknij Zakończ aby ukończyć kreator.

Oczekiwany rezultat: Otwiera się główne okno serwera wyświetlające Panel Administratora z zerową liczbą podłączonych klientów. Nazwa kafejki pojawia się na pasku tytułowym.

Faza 2: Konfiguracja wyceny

1. Otwórz stronę Ustawienia klikając ikonę zębatki w lewym pasku bocznym.
2. Przejdź do zakładki Wycena.
3. Ustaw walutę bazową. Wybierz z rozwijanej listy walut. Wszystkie ceny, transakcje i raporty będą używać tej waluty.
4. Wpisz stawkę godzinową. To bazowa cena za godzinę dla sesji postpaid. Na przykład wpisz 10,00 za dziesięć jednostek waluty za godzinę.
5. Ustaw stawkę VAT. Wpisz procent (0 do 100) stosowany do opłat za sesje. Wpisz 0 jeśli VAT nie obowiązuje.
6. Ustaw opłatę startową. To minimalna opłata za sesję niezależnie od czasu trwania. Wpisz 0 jeśli nie chcesz minimalnej opłaty.
7. Utwórz presety cenowe dla typowych czasów trwania. Przewiń do sekcji Presety. Kliknij Dodaj preset. Utwórz presety takie jak: "30 minut" z 30 minutami, "1 godzina" z 60 minutami, "2 godziny" z 120 minutami.
8. Kliknij Zapisz aby zastosować konfigurację wyceny.

Oczekiwany rezultat: Zakładka Wycena pokazuje Twoją stawkę godzinową, stawkę VAT, opłatę startową i wszystkie presety wymienione poniżej.

Faza 3: Weryfikacja ustawień sieciowych

1. Wciąż w Ustawieniach przejdź do zakładki Sieć.
2. Sprawdź port nasłuchiwania. Domyślny to 7842. Zmieniaj go tylko jeśli inny serwis w sieci używa tego portu.
3. Ustaw lub zanotuj klucz połączenia. Ten klucz uwierzytelnia połączenia klientów. Wszystkie komputery klienckie muszą używać tego samego klucza.
4. Upewnij się, że zapora sieciowa komputera serwera dopuszcza przychodzące połączenia TCP na skonfigurowanym porcie.
5. Zanotuj adres IP komputera serwera wyświetlany w zakładce Sieć. Będziesz go potrzebować jeśli klienty nie znajdą serwera przez automatyczne wykrywanie.

Oczekiwany rezultat: Zakładka Sieć wyświetla port nasłuchiwania i klucz połączenia. Wskaźnik statusu serwera pokazuje "Nasłuchuje" na zielono.

Faza 4: Wdrożenie pierwszego klienta

1. Pobierz instalator HandyCafe Client ze swojego panelu.
2. Zainstaluj go na pierwszym komputerze klienckim. Uruchom instalator i postępuj zgodnie z instrukcjami.
3. Uruchom HandyCafe Client. Klient spróbuje automatycznie wykryć serwer przez mDNS w sieci lokalnej.
4. Jeśli automatyczne wykrywanie nie powiedzie się, wpisz adres IP serwera i port ręcznie w oknie połączenia klienta.
5. Wpisz klucz połączenia zanotowany w Fazie 3.
6. Poczekaj na nawiązanie połączenia. Ekran klienta przełączy się na stronę Bezczynności wyświetlając ekran blokady z zegarem.

Oczekiwany rezultat: Na serwerze Panel Administratora teraz wyświetla jednego podłączonego klienta. Kafelka klienta wyświetla nazwę hosta i niebieski status "Bezczynny". Komputer kliencki wyświetla ekran blokady.

7. Serwer automatycznie przypisze nazwę wyświetlaną klientowi na podstawie jego nazwy hosta. Aby ją zmienić, zaznacz kafelkę klienta na serwerze i kliknij Zmień nazwę.

Faza 5: Uruchomienie pierwszej testowej sesji

1. Na Panelu Administratora serwera kliknij Start na bezczynnej kafelce klienta.
2. W oknie sesji wybierz Postpaid. Pozostaw pole członka puste dla sesji gościa.
3. Kliknij Potwierdź aby rozpocząć sesję.

Oczekiwany rezultat: Kafelka klienta zmienia kolor na zielony i wyświetla biegnący timer. Na komputerze klienckim ekran blokady znika i pojawia się pulpit Online Page.

5. Pozwól sesji działać przez co najmniej 5 minut aby zweryfikować obliczenia cenowe.
6. Kliknij Stop na zielonej kafelce klienta na serwerze.
7. Przejrzyj okno podsumowania kosztów. Pokaże: czas trwania, zastosowaną stawkę godzinową, kwotę VAT, łączną opłatę.
8. Wybierz metodę płatności (domyślnie Gotówka).
9. Kliknij Potwierdź aby zamknąć sesję i zarejestrować płatność.

Oczekiwany rezultat: Kafelka klienta wraca do niebieskiego statusu "Bezczynny". Komputer kliencki wyświetla ponownie ekran blokady. Transakcja jest zarejestrowana w systemie.

Faza 6: Weryfikacja w raporcie kasowym

1. Przejdź do strony Raport kasowy używając lewego paska bocznego.
2. Potwierdź że dzisiejszy raport wyświetla jedną transakcję sesyjną.
3. Sprawdź czy kwota transakcji odpowiada podsumowaniu kosztów widocznym przy zatrzymywaniu sesji.
4. Sprawdź czy kolumna metody płatności pokazuje "Gotówka" (lub wybraną metodę).

Oczekiwany rezultat: Raport kasowy wymienia jedną ukończoną sesję z prawidłową kwotą, czasem trwania i metodą płatności. Twoja kafejka jest teraz operacyjna.

Faza 7: Opcjonalne dalsze kroki

Po uruchomieniu podstawowej konfiguracji rozważ skonfigurowanie tych funkcji:

1. Dodaj członków. Przejdź do strony Członkowie. Kliknij Dodaj aby tworzyć konta członkowskie z nazwami użytkownika i opcjonalnymi saldami portfeli.
2. Skonfiguruj produkty. Przejdź do strony Produkty. Dodaj pozycje jedzenia i napojów z cenami aby kasjerzy mogli tworzyć zamówienia.
3. Skonfiguruj menu klienta. Przejdź do Ustawienia > Menu klienta. Dodaj kategorie aplikacji i aplikacje aby klienci widzieli siatkę launchera na Online Page.
4. Wdróż dodatkowych klientów. Zainstaluj HandyCafe Client na każdym komputerze stacyjnym w kafejce. Każdy pojawi się automatycznie na serwerze.
5. Utwórz konta kasjerów. Przejdź do strony Zarządzanie. Dodaj konta kasjerów z odpowiednimi rolami.
6. Skonfiguruj wycenę szczytową/poza szczytem. Przejdź do Ustawienia > Harmonogram wyceny. Stwórz mnożniki oparte na czasie.
7. Włącz logowanie OAuth. Przejdź do Ustawienia > OAuth. Skonfiguruj Google lub innych dostawców aby klienci mogli logować się kontami społecznościowymi.

Typowe błędy do uniknięcia

• Pominięcie reguły zapory. Jeśli klienty nie mogą się połączyć, najczęstszą przyczyną jest reguła Zapory Windows blokująca port nasłuchiwania.
• Niezgodne klucze połączenia. Klucz na każdym kliencie musi dokładnie odpowiadać kluczowi na serwerze. Kopiuj-wklejaj aby uniknąć literówek.
• Ustawienie stawki godzinowej na 0. Jeśli zostawisz stawkę godzinową na zero, wszystkie sesje postpaid będą darmowe. Zawsze zweryfikuj wycenę przed uruchomieniem.
• Zapomnienie o zapisaniu ustawień. Zmiany na stronie Ustawień nie obowiązują dopóki nie klikniesz Zapisz.
• Uruchamianie serwera i klienta na tym samym komputerze. Choć technicznie możliwe do testowania, nie jest to zalecane do produkcji. Komputer serwera powinien być dedykowaną stacją.