SpikePCPodręcznik użytkownikaUKRUENPL

Podręcznik użytkownika SpikePC

Instrukcja dla właściciela i administratorów klubu gamingowego: co potrafi system, gdzie co się konfiguruje i co oznacza każdy parametr.

To podręcznik do panelu organizacji (interfejs webowy). Dokumentacja techniczna dla twórców oprogramowania stanowiska, serwera klubu i aplikacji mobilnej dostarczana jest osobno.

---

1. Czym jest SpikePC

System zarządzania klubem gamingowym. Składa się z czterech części:

CzęśćCo robi
Panel organizacjiInterfejs webowy: kluby, stanowiska, klienci, pieniądze, towary, analityka
Oprogramowanie stanowiskaProgram na komputerze do gier: logowanie klienta, katalog gier, sklep, naliczanie czasu
Serwer klubuJeden serwer na klub: włączanie stanowisk (Wake-on-LAN), złote obrazy, stan dysków
Aplikacja mobilnaDla klienta: rejestracja, logowanie na stanowisku kodem QR, historia wizyt

Wszystko łączy usługa czasu rzeczywistego: stanowisko utrzymuje stałe połączenie z serwerem, dlatego mapa klubu pokazuje stan od razu, a polecenia operatora docierają natychmiast.

Role

RolaCo jest dostępne
Właściciel organizacjiWszystko bez ograniczeń; grupy uprawnień go nie dotyczą
PracownikTylko to, na co pozwala jego grupa uprawnień i przypisane kluby
FranczyzaOsobny panel: katalog i ustawienia klubów sieci z różnych organizacji
Administrator systemuObsługa platformy: organizacje, rejestr, dzienniki wymiany

Dokumenty. Przy pierwszym logowaniu — i po każdej nowej redakcji — panel prosi o przeczytanie i potwierdzenie umowy licencyjnej oraz informacji o danych osobowych. Okno nie zamyka się bez potwierdzenia: bez zgody nie mamy prawa dalej przetwarzać danych. Odnośniki otwierają się w nowej karcie, panel zostaje na miejscu. Oba dokumenty są zawsze w stopce serwisu, a klub musi przekazać informację o danych osobowych swoim klientom i pracownikom: administratorem ich danych jest klub, serwis jest tylko podmiotem przetwarzającym.

---

2. Interfejs

U góry jest jeden pasek:

Kwoty przychodu i bonusów to odnośniki do kasy: widzisz liczbę — przechodzisz sprawdzić, z czego się złożyła. Odnośnik pojawia się tylko u tych, którzy mają dostęp do tej sekcji.

Język interfejsu wybiera się w profilu (menu użytkownika → „Profil”, lista języków obok imienia i telefonu) — osobnego przełącznika w pasku już nie ma. Język zapisuje się tym samym przyciskiem co pozostałe pola karty i działa od razu: panel otwiera się ponownie na tej samej sekcji.

Sekcje systemu (ikona siatki) otwierają okno ze wszystkimi sekcjami panelu, z wyszukiwaniem. Sekcje są pogrupowane według sensu: Klub, Klienci (razem z historią rozmów), Sklep (razem z magazynem), Taryfy i płatności (razem z kasą i zmianami kasowymi), Gry, Personel, Franczyza, System. Menu użytkownika (ikona osoby) — profil, zmiana hasła i wylogowanie.

Wskaźniki liczone są dla klubów dostępnych dla Ciebie: właściciel widzi wszystkie, pracownik — tylko swoje.

Z telefonu

Panel otwiera się na telefonie i tablecie — nie ma osobnej aplikacji dla personelu. W górnym pasku zostają znak organizacji i jeden przycisk menu: wszystkie sekcje, a razem z nimi profil, zmiana hasła i wylogowanie są w jego wnętrzu (wyszukiwanie sekcji na telefonie usunięto, jego miejsce zajmuje nazwa i zamknięcie okna). Na telefonie w górnym pasku nie ma wskaźników, zegara ani pogody: cały pas należy do treści sekcji, a przychód i obłożenie czyta się w kasie i w analityce. Pełne zestawienie zostaje na monitorze i tablecie. Listy przewijają się w bok wewnątrz własnej ramki, okna zajmują niemal cały ekran, a filtry są złożone pod ikoną leja po prawej stronie wiersza z nazwą sekcji — dotknięcie je rozwija, kolejne składa, a ustawione wartości zostają.

Listy pokazują się jako karty. Wiersz to osobny blok: główne pole jako nagłówek, pozostałe kolumny jako pary „podpis: wartość”, przyciski wiersza na dole. Przycisk tworzenia wpisu przenosi się do wiersza z nazwą sekcji, bo nagłówek tabeli nie jest na telefonie pokazywany.

Cztery ekrany zostają tabelami i przewijają się: harmonogramy taryf i karnetów, tablica zamówień, rezerwacja stanowisk i kasa. Tam sens jest właśnie w siatce — godziny tygodnia, kolumny statusów, stanowiska w czasie — i nie da się jej rozłożyć na karty.

Na mapie klubu zamiast leja jest koło zębate, a pod nim nie tylko wybór klubu: trafiają tam również liczniki stanowisk według statusów, skala, zapytanie o stan serwera i przejście do edycji planu. W wierszu z nazwą zostają nazwa otwartego klubu i dwa przyciski po prawej: czaty z licznikiem nieprzeczytanych oraz koło zębate — resztę miejsca dostaje sala.

Co działa inaczej:

GdzieJak na telefonie
Mapa klubuMenu stacji otwiera dotknięcie zamiast prawego przycisku (w trybie edycji planu, gdzie dotknięcie stawia elementy — długie przytrzymanie). Plan przesuwa się palcem, skalę ustawiają przyciski „− / % / +” w nagłówku
Tablica zamówieńKolumny statusów przewija się w bok, po jednej na ekran
RezerwacjeDoba po godzinach jest szersza niż każdy telefon, siatkę przesuwa się palcem. Zaznaczenie kilku stacji ramką nie jest możliwe: dotknięcie wybiera jedną godzinę, resztę załatwia okno „+” z dokładnym czasem
ZamówieniaW górnym pasku nie ma licznika nowych zamówień (jest tam jeden przycisk menu), ale dźwięk nowego zamówienia nadal się odtwarza; tablica zamówień otwiera się z menu
Rozkładanie planu sali i obszaru baneraOba wymagają przeciągania myszą — robi się je z monitora

---

3. Kluby

Sekcja Kluby to lista lokali organizacji. Parametry karty:

ParametrZnaczenie
Nazwa, adres, opisPokazywane klientowi na stanowisku
Współrzędne (lat / lon)Potrzebne do pogody w nagłówku i do map
TelefonyKontakty dla klienta
WalutaTrzyliterowy kod (UAH, EUR, USD, PLN…) z listy. Nią podpisywane są kwoty tego klubu. Każdy klub ma swoją walutę — sieć może działać w kilku krajach, a kwoty w różnych walutach nigdy nie są sumowane ani przeliczane po kursie
Darmowe minutyIle pierwszych minut sesji nie jest w ogóle naliczanych (ani pieniędzmi, ani abonamentem). Domyślnie 3, maksymalnie 1440, 0 — wyłączone
Przyjmowanie zamówieńPrzełącznik: wyłączony — stanowiska dostają odmowę i zamówienie nie powstaje
Kontrola bezczynnościDwie liczby: po ilu minutach bezczynności ostrzec operatora (domyślnie 7) i po ilu wyłączyć stanowisko (10). 0 w polu wyłącza swój krok
Ostrzegaj przy zajętym miejscu na dyskuProcent zapełnienia dysku serwera klubu, od którego panel zaczyna ostrzegać: domyślnie 90, 0 — nie ostrzegaj. Sprawdzany jest zarówno cały dysk serwera, jak i każda jego przestrzeń osobno
Kanał Telegram dla zamówieńJeśli wypełniony, powiadomienia o zamówieniach tego klubu trafiają tam, w przeciwnym razie do wspólnego kanału organizacji
Hasło administratora WindowsGenerowane przy tworzeniu klubu, pokazywane tylko do odczytu. Stanowisko pobiera je samo, do dzienników nie trafia

Przy tworzeniu klubu system automatycznie zakłada 10 klientów testowych (login i hasło są równe adresowi e-mail postaci <club><org>NN@domena) — żeby od razu było na kim sprawdzić logowanie, taryfy i zamówienia.

---

4. Stacje gier

Stanowiska do gier to lista komputerów i konsol. Parametry:

ParametrZnaczenie
NumerNazwa stanowiska, widzi ją operator i klient
TypPC albo konsola
IP, MACIdentyfikacja urządzenia. MAC jest unikalny i służy do Wake-on-LAN
Grupa stanowiskOd niej zależy taryfa: harmonogram cen jest przypisany do grupy
Częstotliwość odświeżania ekranuHz, domyślnie 60 (dopuszczalne 24–480). Stanowisko stosuje ją przy połączeniu
Odnośnik do QR ExpirenzaKażde stanowisko ma swój QR — klient skanuje go prosto z ekranu. Wpisuje się odnośnik (https://…); puste — QR nie jest pokazywany
Wersja oprogramowaniaTylko do odczytu: wersję zgłasza samo stanowisko przy połączeniu. Kreska oznacza, że jeszcze nie zgłosiło (stary program albo maszyna nie była włączana). Po kolumnie widać, gdzie park nie jest zaktualizowany; podpowiedź nad wartością mówi, kiedy wersję zgłoszono

Odnośnik Expirenza można zmieniać niezależnie od karty stanowiska: na liście obok ikony QR jest ołówek. To działanie ma własne uprawnienie („Expirenza link”), więc odnośnik powierza się personelowi zmianowemu, nie otwierając mu edycji IP, MAC i grupy — tam jedna literówka odłącza stanowisko od serwera.

Grupy stanowisk to sekcja do podziału sali na strefy (na przykład Standard, VIP, PS5). Grupa ma nazwę i kolor; według grup liczone są taryfy, obłożenie i analityka.

Jeśli w ustawieniach organizacji włączono autowykrywanie, nowe stanowisko może zarejestrować się samo przy pierwszym połączeniu — pozostanie wskazać jego grupę i numer.

Nowa organizacja ma już trzy stanowiska — „1”, „2” i „3”, po jednym w każdej grupie startowej. To zaślepki: IP 192.168.1.1–3 i MAC aa:aa:aa:aa:aa:aa…cc są w nich umowne i nic się po nich nie połączy. Otwórz kartę i wpisz prawdziwe IP oraz MAC swojej maszyny — stanowisko zacznie działać. Zbędne zaślepki usuń.

---

5. Grupy stacji gier

Podział sali na strefy: Standard, VIP, PS5, stanowiska z kierownicą. Grupa ma nazwę i kolor — kolorem jest podpisana na mapie klubu i w siatce rezerwacji.

Grupa to nie ozdoba, a podstawa rozliczeń: harmonogram cen jest przypisany do grupy, a nie do stanowiska. Dlatego abonament działa w tej grupie, w której został kupiony, obłożenie i analityka liczą się po grupach, a baner można pokazać tylko w wybranych strefach.

Stanowisko wskazuje swoją grupę we własnej karcie (sekcja Stacje gier). Stanowisko bez grupy zostaje bez taryfy — czas na nim nie będzie rozliczany.

Nowa organizacja ma już trzy grupy — pro, vip i normal, w każdej po jednym stanowisku. Zmień im nazwy pod swoją salę albo usuń zbędne; najważniejsze, żeby nie zostawić stanowiska bez grupy i nie zapomnieć o harmonogramie cen: dopóki grupa nie jest zamalowana taryfą, czas w niej idzie bezpłatnie.

6. Mapa klubu

Mapa klubu: statusy stanowisk odświeżają się w czasie rzeczywistym
Mapa klubu: statusy stanowisk odświeżają się w czasie rzeczywistym

Główny ekran roboczy administratora. Pokazuje salę w czasie rzeczywistym.

Co widać na mapie

OznaczenieZnaczenie
Kolor stanowiskaSzary — wyłączone, zielony — włączone i wolne, zajęte — trwa sesja
Ikona osobyNa stanowisku zalogowany jest klient
Ikona identyfikatoraNa stanowisku pracuje pracownik
Ikona narzędziStanowisko w serwisie (tryb serwisowy)
Ikona osoby z kołem zębatym, bursztynowa obwódkaPrzy stanowisku pracuje administrator (tryb administracyjny)
Przygaszone stanowisko z przekreślonym numeremWycofane z wynajmu
Pomarańczowa obwódkaJest rezerwacja: ciągła — trwa teraz, przerywana — wkrótce się zacznie (na ile minut wcześniej ostrzegać, ustawia się w karcie klubu, domyślnie 30)
Ikona karty (niebieska/czerwona)Klient dostał kredyt / ma już dług
Czas u góryPozostały czas klienta; poniżej 15 minut — na czerwono

Bycie online ustala się na podstawie faktu połączenia stanowiska z serwerem, a nie ostatniej aktywności — wyłączony komputer robi się szary od razu.

Skalę planu zmienia się przyciskami „− / % / +” w nagłówku (kliknięcie w procent przywraca początkowe 90%, Ctrl+kółko myszy też działa). Wybrana wartość jest zapamiętywana przy operatorze i przetrwa przejście do innej sekcji oraz ponowne logowanie: przy jednym komputerze pracuje cała zmiana, a ustawienie podąża za człowiekiem, nie za maszyną.

Działania pod prawym przyciskiem

DziałanieKiedy dostępneCo robi
Informacje o stanowisku, zdarzenia sesjizawszePokazuje dane stanowiska i dziennik bieżącej sesji
Wiersz „Klient przy stanowisku”przy stanowisku jest klientKto teraz gra; ikona „i” po prawej otwiera kartę klienta — kontakty, pieniądze, rabaty, abonamenty, bieżąca sesja
Historia logowańzawszeOstatnie 10 sesji: data, e-mail klienta, czas trwania
Włącz / wyłączzależnie od stanuWłączanie idzie przez serwer klubu (Wake-on-LAN), wyłączanie to polecenie do stanowiska
Uruchom ponownie PCstanowisko jest onlinePolecenie restartu samego stanowiska. Stanowiska w trybie szczególnym go nie dostają — ktoś w tym momencie na maszynie pracuje
Wyślij wiadomośćstanowisko jest onlineTekst do 1000 znaków i czas wyświetlania (0 — do zamknięcia przez klienta)
Zaloguj klientastanowisko wolne i onlineOperator wpisuje e-mail i hasło klienta; sesję otwiera samo stanowisko
Zakończ sesjęprzy stanowisku jest klientStanowisko zamyka sesję samo: naliczana jest ostatnia minuta, klient zostaje odłączony, ekran wraca do logowania
Doładuj kontoprzy stanowisku jest klientNatychmiastowe zasilenie salda z wyborem kasy
Sprzedaj abonamentprzy stanowisku jest klientKlient już gra i prosi o abonament: wybierz abonament i kasę — pieniądze trafią do kasy, a abonament pojawi się u klienta od razu
Doładuj po zalogowaniuzawszeZgłoszenie na 30 minut: kwota trafi do tego, kto się zaloguje na tym stanowisku — hasłem, biletem operatora, kodem QR albo rejestrując się i logując. Tu też można wybrać abonament: przy logowaniu system zaksięguje pieniądze i od razu go kupi
Udziel kredytuprzy stanowisku jest klientZgoda na zejście poniżej zera do końca sesji (zob. rozdział 9)
Tryb stanowiskastanowisko jest wolneLista trzech trybów: serwis, administracja, wycofane z wynajmu (zob. niżej)
Utwórz złoty obrazstanowisko wyłączoneZdejmuje wzorcowy obraz dysku przez serwer klubu

Osobnych pozycji „Zablokuj” i „Odblokuj stanowisko” w menu nie ma: mówiły o tym samym, co „Zakończ sesję” i „Zaloguj klienta”. Dla człowieka stan stanowiska jest jeden — albo gra przy nim klient, albo nie; dlatego te dwie pozycje wzajemnie się wykluczają.

Tryby stanowiska

Zwykle stanowisko jest „w pracy”: klient się loguje, kontrola bezczynności działa, operator zarządza nim jak zawsze. Poza tym są trzy tryby szczególne — ustawia je i zdejmuje wyłącznie administrator z panelu, prawym przyciskiem na stanowisku:

TrybKiedy się stosujeCzy klient może się zalogować
Serwismaszyna jest naprawiana, czyszczona, wymieniany jest sprzętnie
Administracjaprzy stanowisku pracuje administrator: instaluje gry, poprawia ustawieniatak — maszyna zostaje w wynajmie
Wycofane z wynajmuzepsute, sprzedane, stoi w kącienie

Administracja różni się od serwisu jedną rzeczą, ale istotną: dopóki stanowisko jest w tym trybie, serwer klubu nie cofa jego dysku do wzorcowego obrazu przy restarcie. Inaczej wszystko, co administrator zainstalował, znikałoby przy pierwszym ponownym uruchomieniu.

Zasady wspólne dla wszystkich trzech:

Działania grupowe

Zaznacz stanowiska ramką — pojawi się panel działań. Są w nim tylko te działania, które pasują do zaznaczenia: przycisk pojawia się, gdy wśród zaznaczonych stanowisk jest choć jedno odpowiednie, a obok podpisu stoi liczba takich stanowisk. Działanie idzie dokładnie do nich, pozostałych nie dotyka.

DziałanieDo kogo pasuje
Włączstanowiska wyłączone
Wyłącz, uruchom ponowniestanowiska włączone, poza trybem szczególnym
Zakończ sesję, wyślij wiadomośćstanowiska z zalogowanym klientem
Doładuj konto, sprzedaj abonamentstanowiska z zalogowanym klientem
Doładuj po zalogowaniu, sprzedaj abonament przy logowaniustanowiska wolne — włączone i wyłączone: zgłoszenie czeka na tego, kto usiądzie

Przed wykonaniem zobaczysz podział zaznaczenia: dwie grupy — do kogo działanie trafi i kogo pomijamy. Stanowiska są narysowane tą samą ikoną i kolorem, co na planie sali, a po najechaniu widać powód pominięcia. Przy działaniach z wpisywaniem danych (kwota, tekst, abonament) podział stoi w nagłówku formularza — skład grupy widzisz, wypełniając pola.

Wynik dla każdego stanowiska pokazuje osobny panel statusu: „wykonano”, „dostarczono”, „poza siecią” albo „pominięto” — stan mógł się zmienić między ostatnim odświeżeniem mapy a kliknięciem, i takie stanowiska serwer pomija sam.

Abonament od razu na miejscu

Abonamentu nie trzeba sprzedawać z karty klienta — można go sprzedać tam, gdzie człowiek siedzi. Dwa przypadki:

Klient już gra. Prawy przycisk na jego stanowisku → „Sprzedaj abonament”. W okienku są abonamenty klubu z ceną dla tego klienta (stały rabat jest uwzględniony, jeśli abonament na to pozwala), kasa i komentarz. Pieniądze przyjmuje kasa, abonament pojawia się u klienta od razu i jest przypisany do grupy tego stanowiska, przy którym gra.

Abonament, którego nie ma w cenniku tej sali, jest w liście opisany — sprzedać go można, ale rozbieżność widzisz, zanim weźmiesz pieniądze.

Klient jeszcze nie usiadł. Prawy przycisk na wolnym stanowisku → „Doładuj po zalogowaniu”, a obok kwoty wybierz abonament. Gdy tylko człowiek zaloguje się na tym stanowisku, system wykona dwa działania po kolei: zaksięguje przyjęte pieniądze i kupi za nie abonament. Tak wygodnie pracuje się przy wejściu: przyjąłeś opłatę, przydzieliłeś stanowisko, człowiek usiadł i już gra na abonamencie.

Kwota w zgłoszeniu pozostaje osobnym polem i jest podstawiana według ceny abonamentu. To nie drobiazg: zgłoszenie dotyczy stanowiska, a kto przy nim usiądzie — jeszcze nie wiadomo, i może mieć własny rabat. Do kasy idzie to, co przyjąłeś, abonament kupowany jest w swojej cenie, a różnica zostaje klientowi na saldzie.

W obu przypadkach potrzebna jest otwarta zmiana kasowa — jak przy każdym przyjmowaniu pieniędzy. Uprawnienie do sprzedaży jest to samo, co w karcie klienta: „Sprzedaż abonamentu”.

Stanowiska, które stoją bezczynnie

Stanowisko jest włączone, ale nikogo przy nim nie ma: ani klienta, ani pracownika, i nie jest w trybie szczególnym. Po liczbie minut z ustawień klubu (domyślnie 7) w lewym dolnym rogu mapy pojawia się okno z listą takich stanowisk: ile już stoi bezczynnie i ile zostało do wyłączenia. Przycisk „Zresetuj” obok stanowiska zeruje licznik — to odpowiedź „widzę, jest zajęte, nie wyłączaj”; przycisk w nagłówku okna resetuje od razu wszystkie.

Jeśli licznika nie zresetować, po drugiej liczbie minut (domyślnie 10) stanowisko wyłącza się samo. Odliczanie zaczyna się od nowa za każdym razem, gdy stanowisko się zwalnia, a stanowiska w trybie szczególnym (serwis, administracja, wycofane z wynajmu) pod kontrolę nie trafiają — trzyma się je włączone celowo.

Czaty z klientami

Klient przy stanowisku może napisać do administratora, nie wstając z miejsca — na przykład „nie działa myszka” albo „proszę o colę”. Rozmowa jest związana z bieżącą sesją klienta: wyszedł — rozmowa się skończyła, następny przy tym stanowisku zaczyna od czystej karty.

Przycisk „Czaty z klientami” w nagłówku mapy pokazuje liczbę nieprzeczytanych wiadomości i otwiera panel po prawej stronie planu sali. Są w nim dwa ekrany:

1. Lista czatów — wiersz na stanowisko: ikona stanowiska z numerem i tym samym podświetleniem, co na planie, imię klienta, ostatnia wiadomość i licznik nieprzeczytanych. Najpierw pokazywane są stanowiska z nieprzeczytanymi, potem ze świeżymi rozmowami. Na liście są tylko stanowiska, przy których ktoś jest teraz zalogowany — nie ma do kogo pisać. 2. Rozmowa — otwiera się kliknięciem w tym samym miejscu, wstecz prowadzi strzałka. Historia, pole wpisywania, zestaw emoji (razem z fajką wodną). Enter wysyła, Shift+Enter przenosi wiersz.

Obok imienia klienta jest ikona „i”: otwiera jego kartę bez wychodzenia z czatu. Są tam kontakty i data urodzenia, saldo i dług, rabaty, język, notatki, bieżąca sesja (początek, czas trwania, pozostały czas, wydatki na czas i zakupy, kredyt), niewykorzystane abonamenty i pięć ostatnich operacji na koncie.

Status wiadomości widać po znaczkach, jak w komunikatorach: bez ikony — wysłano, jeden znaczek — stanowisko odebrało, dwa — klient przeczytał. Wiadomość wysłana do wyłączonego stanowiska dotrze, gdy znów będzie online.

Dawne rozmowy zostają w sekcji Historia rozmów: zamknięta sesja znika z czatu na mapie, ale sama rozmowa nigdzie się nie podziewa. Jest tam lista wszystkich dialogów — data, stanowisko, klient, liczba wiadomości i nieprzeczytanych — z filtrami po klubie i okresie oraz wyszukiwaniem po treści wiadomości: to, o czym się umawiano, zwykle da się przypomnieć tylko po zwrocie. Kliknięcie otwiera całą rozmowę; nie da się jej kontynuować — klienta przy stanowisku już nie ma.

Nowej wiadomości towarzyszy dźwięk. Czat ma własny — wybiera się go w ustawieniach organizacji obok sygnału zamówienia: na słuch wiadomość musi różnić się od zamówienia, inaczej personel idzie do kasy zamiast odpowiedzieć w rozmowie. Dopóki klub nie wybierze osobnego sygnału dla czatu, odzywa się ten od zamówień. Dźwięk włącza się po pierwszym kliknięciu na stronie (wymóg przeglądarki) i nie odzywa się, jeśli masz już otwartą rozmowę z tym stanowiskiem.

Serwer klubu

Osobny obiekt na mapie. Pod prawym przyciskiem: stan (obciążenie, dyski), żądanie świeżych danych, restart (z potwierdzeniem). Przez niego idą też włączanie stanowisk i praca ze złotymi obrazami.

Panel sam powie, że kończy się miejsce na dysku. Serwer melduje o sobie co kilka sekund i gdy zajęte miejsce przekroczy próg klubu (ustawienie „Ostrzegaj przy zajętym miejscu na dysku”, domyślnie 90%), w nagłówku panelu pojawia się ikona dysku z najgorszym procentem — widać ją w każdej sekcji, nie tylko na mapie. Kliknij ją: otworzy się to samo okno stanu serwera, a przepełniony dysk będzie w nim podświetlony na czerwono. Gdy ostrzeżeń jest kilka, u góry okna pojawią się przyciski klubów. Sprawdzany jest zarówno cały dysk serwera, jak i każda jego przestrzeń: miejsce na obrazy stanowisk kończy się właśnie w przestrzeni, a dysk systemowy bywa wtedy prawie pusty. Ikona nie zniknie, dopóki miejsce nie zostanie zwolnione — nawet jeśli serwer przestanie się zgłaszać: dysk sam się nie czyści, a czas ostatniego meldunku widać w oknie.

---

7. Klienci

Sekcja Klienci to ludzie grający w Twoich klubach.

Konto klienta jest globalne: jeden adres e-mail to jeden klient w całym systemie. Dlatego imię, nazwisko, e-mail, telefon, data urodzenia, płeć i hasło są w panelu organizacji tylko pokazywane: ich właściciel zmienia je sam przez stanowisko albo aplikację mobilną.

Organizacja zarządza swoimi danymi o kliencie:

ParametrZnaczenie
SaldoPieniądze klienta w Twojej organizacji
StatusAktywny albo nie
ŹródłoSkąd przyszedł (do statystyk)
RabatStały rabat klienta, % — działa na czas i na cenę abonamentu (zob. rozdział 7.1)
Ocena, notatki, awatarWewnętrzne adnotacje klubu
JęzykJęzyk, w którym klient widzi stanowisko
BlokadaLokalna (tylko Twoja organizacja) albo globalna — po kontakcie, więc nowe konto na ten sam telefon lub e-mail nie pomaga

Operacje pieniężne

OperacjaGdzieCo się dzieje
Doładowaniekarta klienta albo mapa klubuKwota trafia na saldo i do wybranej kasy. Kasa jest obowiązkowa
Sprzedaż abonamentukarta klientaPobiera cenę i wydaje pakiet czasu
Wyzerowanie saldalista klientówSpisuje resztę korektą; kasy nie dotyczy
Zwrotsekcja operacjiAnuluje doładowanie: zdejmuje kwotę z salda (może zejść poniżej zera) i robi zapis odwrotny w kasie

Każdy ruch pieniędzy jest zapisywany w sekcji Operacje na koncie: data, klient, typ, kwota, kasa, saldo po operacji. Nic nie jest usuwane — anulowanie to zapis odwrotny.

Komentarz do doładowania. Przy zasilaniu można podać, za co jest. Dla kasy bonusowej komentarz jest obowiązkowy — inaczej system nie przyjmie operacji: bonusu bez wyjaśnienia nie da się rozliczyć w raportach.

---

8. Taryfy

Sekcja Taryfy to koszt godziny gry.

ParametrZnaczenie
NazwaNa przykład „Dzienna”, „Nocna”, „VIP”
Cena za godzinęIle pobiera się za godzinę gry
KolorDla czytelności w siatce harmonogramu
StatusPrzełącznik na liście: w obiegu albo wyłączona. Wyłączonej taryfy nie można przypisać do harmonogramu, ale godziny, w których już stoi, nadal liczą się po jej cenie

Harmonogram to siatka „dzień tygodnia × godzina”. Wybierasz taryfę jak pędzel i zamalowujesz godziny dla potrzebnej grupy stanowisk. Godzina zaznaczona w siatce wchodzi w całości: „10:00–14:00” oznacza, że opłata według tej taryfy idzie do 13:59:59 włącznie.

Jeśli na bieżącą godzinę taryfa nie jest ustawiona, stanowisko o tym poinformuje, a czas nie będzie naliczany — pilnuj, żeby w siatce nie zostawały dziury.

Jak wycofać taryfę z obiegu, nie usuwając jej. Każda taryfa na liście ma przełącznik statusu. Wyłączona taryfa zostaje w sekcji ze swoją ceną i kolorem, ale nie można jej już przypisać do harmonogramu — ani nowym interwałem, ani przez podmianę taryfy w istniejącym.

Wyłączenie nie zdejmuje taryfy z godzin, w których już stoi. Zrobiono to celowo: minuta bez taryfy jest bezpłatna, więc przełącznik czyszczący taryfę z siatki po cichu sprawiłby, że lokal gra darmo. Obok statusu na liście jest kolumna „W harmonogramie” — ile interwałów nadal liczy się po tej taryfie; dopóki nie ma tam kreski, taryfa dalej pobiera pieniądze. Aby przestała obowiązywać, zdejmij ją z tych godzin w harmonogramie (w siatce są zakreskowane) albo zamaluj je inną taryfą.

Właśnie dlatego wyłączenie jest potrzebne zamiast usuwania, gdy taryfę zdejmuje się na czas: usunięcie zabiera razem z taryfą wszystkie jej interwały, a te godziny zostaną bez taryfy, czyli bezpłatne.

---

8.1 Rabaty

Rabaty są dwa i do jednego klienta stosuje się tylko jeden — nie sumują się.

Stały znajduje się w karcie klienta. Działa na naliczanie czasu z salda i na cenę abonamentu przy zakupie. Właśnie nim daje się 100% pracownikom klubu: grają przy zerowym saldzie.

Okazjonalny pochodzi z osobnej sekcji Rabaty: lista powodów z procentem (urodziny, przeprosiny za zepsutą mysz, promocja weekendowa). Działa tylko na czas — również w płatności po grze — a na abonamenty nigdy. Taki rabat zastępuje stały i żyje do końca sesji.

Nadaje się go z mapy klubu: prawy przycisk na stanowisku → „Nadaj rabat” → wybór powodu z listy. Pozycja pojawia się tylko przy włączonym stanowisku i tylko gdy rabaty zostały utworzone w sekcji „Rabaty” — procentu nie wymyśla się na miejscu. Jeśli przy stanowisku gra klient, rabat trafia do jego sesji; jeśli stanowisko jest wolne, czeka 30 minut na tego, kto siądzie. Tym samym menu rabat się usuwa.

Na mapie stanowisko z rabatem jest opisane procentem („−20%”); rabat oczekujący jest przygaszony — obietnica jest, ale zacznie działać wraz z zalogowaniem klienta.

W karcie taryfy i abonamentu jest pole „Rabaty działają”. Odznacz je tam, gdzie cena i tak jest niższa niż zwykle (taryfa nocna, pakiet promocyjny) — żaden rabat tam nie zadziała.

Procent, przy którym przeszło naliczenie, widać w operacjach na koncie: odpowiada on na pytanie „dlaczego za godzinę pobrano 52, a nie 60”.

Lista klientów ma kolumnę rabatu, filtr „z rabatem / bez rabatu” i sortowanie według wielkości — wygodnie sprawdzić, komu i ile rozdano.

---

9. Abonamenty

Sekcja Abonamenty to pakiety czasu za stałą cenę.

Abonament należy do klubu: ma własną cenę i własne siatki harmonogramu, dlatego lista zawsze pokazuje jeden wybrany klub (tak jak rozdział taryf), a tworzony abonament trafia właśnie do niego. Opcji „wszystkie kluby” w filtrze celowo nie ma: przy niej nowy abonament zapisywał się bez klubu — nie dawało się go wybrać w harmonogramie i nie pojawiał się na stacji.

ParametrZnaczenie
Nazwa, cenaCo widzi klient
Czas trwaniaIle godzin daje pakiet. Podaje się w godzinach ułamkiem, z krokiem 0,1 godziny = 6 minut: „0,5” to pół godziny, „1,5” — półtorej. Pod polem od razu widać „g:mm”, czyli ile dokładnie dostanie klient. Minimum to 0,1 godziny; krócej niż 6 minut nie da się wyrazić
KolorDo siatki harmonogramu
Włączaj automatycznieTak — abonament włącza się sam, gdy jest u klienta jedynym pasującym. Nie — stacja zapyta. Gdy pasujących abonamentów jest kilka, stacja pyta w każdym przypadku
StatusPrzełącznik na liście: w sprzedaży albo wyłączony. Wyłączony abonament zostaje w sekcji, ale nie można go kupić nigdzie

Abonament ma dwie siatki harmonogramu:

Ważna zasada: abonament wypala się według zegara od chwili aktywacji. Kupiony o 12:00 na 3 godziny — o 15:00 już go nie ma, niezależnie od tego, czy klient grał, czy poszedł na kawę. Przerwa czasu nie zachowuje.

Abonament działa tylko w tej grupie stanowisk, w której został kupiony. Jeśli klient przesiądzie się do innej strefy, czas pójdzie za pieniądze według jej taryfy.

Kiedy abonament włącza się sam, a kiedy wybiera klient. Sam — tylko wtedy, gdy pasujący abonament jest u klienta jeden i ma zaznaczone „Włączaj automatycznie”. Gdy pasujących jest kilka, stacja zawsze pyta, który włączyć: włączony abonament od razu zaczyna wypalać się według zegara, a decyzja, który z dwóch spalić, należy do człowieka. Odmowę („płacę pieniędzmi”) stacja zapamiętuje do końca sesji; klient może włączyć abonament później sam z menu.

Jeśli stacja nie odpowie w ciągu minuty, abonament włącza się sam — pierwszy w kolejce, nawet przy odznaczonym polu. Tak zrobiono na czas, gdy nie wszystkie lokale zaktualizowały program na maszynach: klient z abonamentem na koncie nie powinien płacić pieniędzmi z powodu wersji programu. Milczenie stacji to nie to samo co odmowa klienta: odmowę system pamięta i abonamentu po niej nie włącza.

Gdy abonamentowi kończy się okno ważności z harmonogramu, przestaje działać, a stacja zaproponuje wybór kolejnego. Zegar przy tym nie staje — już idzie.

W ustawieniach organizacji można ograniczyć maksimum przechowywanego czasu oraz wymóc „nie więcej niż jeden niewykorzystany abonament”.

Jak wycofać abonament ze sprzedaży, nie usuwając go. Każdy abonament na liście ma przełącznik statusu. Wyłączony abonament znika ze sprzedaży wszędzie: z menu na stacji, z aplikacji mobilnej, z kasy i z okna „Sprzedaj abonament” na mapie klubu. Pozostaje przy tym w sekcji ze swoją ceną i oboma harmonogramami — ten sam przełącznik przywraca go do sprzedaży.

Już kupione abonamenty działają dalej i odliczają się zgodnie z zegarem: wyłączenie wycofuje abonament ze sprzedaży, a nie odbiera klientom tego, co kupili. Dlatego nie trzeba usuwać abonamentu, gdy skończyła się promocja albo przeliczana jest cena — wystarczy wyłączyć.

Jeśli abonament zostanie wyłączony, gdy klient ma już otwarte menu zakupu, stacja odpowie „Ten abonament nie jest w sprzedaży” i odświeży listę.

---

10. Kredyt: gra na dług

Gdy klientowi kończą się pieniądze, a chce dograć, administrator udziela kredytu: prawy przycisk na stanowisku → „Udziel kredytu” → kwota.

To nie jest przelew pieniędzy, tylko zgoda, by saldo zeszło poniżej zera do końca bieżącej sesji. Klient gra dalej, saldo schodzi na minus, a na mapie stanowisko jest oznaczane ikoną karty (czerwoną, gdy dług już powstał).

Po grze klient się rozlicza, a Ty przeprowadzasz zwykłe doładowanie na kwotę długu — saldo wraca do zera. Dopóki dług nie jest spłacony, klient nie będzie mógł się zalogować na stanowisku: pokaże ono „Na koncie jest dług, zgłoś się do administratora”.

Kasa i płatność po grze

Sekcja „Kasa” zbiera pracę kasjera na jednej stronie, w zakładkach:

ZakładkaCo tam jest
ZmianaOtwarcie i zamknięcie zmiany, przychód według kas. Zamknąć zmianę może ten, kto ją otworzył, albo właściciel
DoładowanieStatystyka zmiany, historia doładowań i formularz: wyszukiwanie klienta po imieniu, e-mailu lub telefonie, kwota, kasa
Płatności po grzeTrwające i oczekujące na zapłatę, niżej zakończone; formularz włączenia
SklepZamówienia i przychód sklepu za zmianę

Historię doładowań można filtrować: lista kas oraz szukanie po kliencie, komentarzu kasjera i kwocie — „oddaj mi ten tysiąc” zwykle szuka się właśnie po kwocie, gdy nazwiska nie da się przypomnieć. Filtr działa na serwerze, więc znajduje operacje z całej zmiany, a nie tylko wśród ostatnich pokazanych wierszy; obok jest podpis „znaleziono N z M”. Krzyżyk przy wyszukiwaniu czyści oba filtry.

Wbito na złą kasę? W wierszu historii jest przycisk ze strzałkami — otwiera pod wierszem wybór kasy i pole komentarza. To nie zwrot: pieniądze zostają u klienta, kwota ani czas operacji się nie zmieniają — zmienia się tylko to, w której kasie są liczone. Przychód zmiany, stany kas i „powinno być w szufladzie” przeliczają się od razu. Kasę można zmienić w doładowaniach bieżącej otwartej zmiany (właśnie je pokazuje historia) i tylko dopóki doładowanie nie zostało zwrócone; przeniesienie do kasy bonusowej wymaga komentarza — „za co”. Każda taka poprawka trafia do dziennika zmian: widać, kto i gdzie przeniósł pieniądze. Jeśli przycisku nie ma, Twoja grupa dostępu nie ma prawa „Change payment method” w bloku „Kasa”.

Płatność po grze oznacza, że klient gra, a czas nie jest pobierany z salda, lecz zbiera się do zapłaty; po zakończeniu sesji administrator przyjmuje płatność do kasy. Można ją włączyć:

To samo dostępne jest pod prawym przyciskiem na stanowisku na mapie; stanowisko w tym trybie jest oznaczone ikoną, żółtą, gdy czeka na zapłatę. Limit to pułap kwoty: po jego osiągnięciu sesja się kończy. Nie ustawiono — działa maksimum z ustawień organizacji; w trwającej płatności po grze limit można zmienić, ale nie powyżej maksimum. W tym trybie nie zużywają się abonamenty i nie przeszkadza dług na saldzie; darmowe minuty klubu działają. Wyszło zero — płatność po grze zamyka się sama. Wymagana jest otwarta zmiana.

---

11. Sklep

Kategorie produktów

Sekcja Grupy towarów to kategorie (napoje, jedzenie, przekąski). Są wspólne dla całej organizacji, każda ma nazwę i obrazek.

Produkty

Sekcja Towary. Parametry karty:

ParametrZnaczenie
Nazwa i opisTłumaczone na języki organizacji (zakładki w karcie)
Indeks, kod kreskowyDo ewidencji i skanera; po nich działa też wyszukiwanie na liście
KategoriaGrupa towarów
CenaUstawiana osobno dla każdego klubu
ObrazekPokazywany klientowi
AktywnośćWyłączony towar zostaje na liście, ale nie jest wysyłany na stanowiska i nie da się go zamówić
18+ (alkohol / fajka wodna)Takie towary są ukrywane przed klientami, których wiek nie został potwierdzony
Stan magazynowyBieżąca ilość
Minimalny stanPo jego osiągnięciu na Telegram idzie ostrzeżenie; 0 — nie ostrzegać
Kanał ostrzeżeńGdzie wysyłać sygnał o niskim stanie (w przeciwnym razie kanał klubu, potem organizacji)
Towary powiązane„Do tego biorą jeszcze”: podpowiedź dla klienta przy zamówieniu
Zestaw comboTowar z pozycji z wyborem: „Pierwsze danie: kasza/zupa” + „Napój: kawa/sok”
Godziny dostępności„Dostępny zawsze” albo dni tygodnia, każdy z własnym oknem czasu

Zdejmowanie towarów ze stanu włącza się w ustawieniach organizacji (rozdział 15).

Godziny dostępności — kiedy towar w ogóle jest w sprzedaży. Domyślnie „dostępny zawsze” i większości towarów to wystarcza. Po wybraniu „według harmonogramu” pojawia się siedem wierszy — dzień tygodnia i okno czasu: poniedziałek 00:00–23:59, wtorek 18:00–22:00, a niedzieli można po prostu nie zaznaczać i tego dnia towar nie będzie sprzedawany. Poza swoimi godzinami towar wcale nie jest pokazywany klientowi na stacji — tak jak wyłączony, więc kuchni pracującej do 22:00 nie trzeba już co wieczór wyłączać i włączać ręcznie. Jeśli koszyk zebrano przed zamknięciem, a zamówienie wysłano po nim, stacja dostanie odmowę „ten produkt nie jest teraz w sprzedaży”.

Koniec okna obejmuje wybraną minutę w całości, dlatego „00:00–23:59” to dokładnie doba. Jeśli koniec jest wcześniejszy niż początek, okno przechodzi na kolejną dobę: „piątek 20:00–04:00” oznacza noc z piątku na sobotę. Na liście towarów kolumna „Dostępność” pokazuje ikonę u tych, które mają harmonogram (godziny widać po zatrzymaniu na niej kursora), a u pozostałych kreskę.

Magazyn: ruch towaru

Sekcja Magazyn to dziennik, w którym widać każdą zmianę stanu: co przyjęto, co sprzedano, co spisano. Wcześniej stan był po prostu liczbą w karcie towaru i nie było czym odpowiedzieć na pytanie „gdzie podziało się dwadzieścia puszek coli”.

Typ ruchuSkąd się bierze
Przyjęcieprzyjęto dostawę
Rozchódzniszczenie, stłuczka, zużycie wewnętrzne
Sprzedażzamówienie ze stanowiska — zapisuje się automatycznie
Zwrotanulowanie zamówienia — towar wraca na magazyn
Korektawynik inwentaryzacji

Przyjęcie towaru odbywa się w jednym oknie. Po lewej wyszukiwanie po towarach klubu: po nazwie, indeksie lub kodzie kreskowym, więc można po prostu skanować kody skanerem (Enter dodaje znaleziony towar). Po prawej buduje się lista: ilość i cena dla każdej pozycji, na dole liczba pozycji i suma. Komentarz to dostawca albo numer dokumentu. Przycisk „Zatwierdź dokument” zapisuje wszystko jedną operacją: albo dokument przechodzi w całości, albo nie przechodzi wcale.

Tym samym oknem robi się rozchód i inwentaryzację. Różnica jest w sensie ilości: w przyjęciu się dodaje, w rozchodzie odejmuje, w inwentaryzacji wpisuje się ze znakiem — +10 nadwyżka, −10 niedobór.

W dzienniku są filtry po klubie, typie ruchu i okresie, wyszukiwanie po nazwie, indeksie i kodzie kreskowym, a nad tabelą podsumowania za wybrany okres. Każdy wiersz pokazuje „było → jest”, a numer dokumentu otwiera całe przyjęcie.

Prawo do przeglądania dziennika nadaje się razem z towarami, a zatwierdzanie dokumentów jest osobne: patrzeć na stany może cały personel, ale przyjmować dostawę już nie każdy.

---

12. Zamówienia

Klient składa zamówienie ze stanowiska; pieniądze nie są pobierane — płatność na miejscu.

Tablica zamówień to ekran roboczy: kolumny „Nowe”, „W trakcie”, „Gotowe”, „Anulowane”. Karta pokazuje stanowisko, klienta, pozycje (razem z wyborem w combo), kwotę i komentarz klienta. Przyciski przesuwają zamówienie po statusach. Tablica odświeża się sama, a lista zamówień również: obie strony przerysowują się w tej samej chwili, w której zmienia się licznik w nagłówku, dlatego sygnał i pojawienie się zamówienia są zgodne.

Zamówienie ma trzy stany robocze: nowe → w realizacji → gotowe (albo anulowane). Nie ma osobnego „przygotowywane” — na tablicy trafiało do tej samej kolumny „W realizacji”, niczym nie różniło się od „w realizacji”, a personel naciskał zbędny przycisk.

Filtry: klub, okres (doba, 3 dni, tydzień, wszystko), wyszukiwanie po kliencie.

Przełącznik „Przyjmowanie zamówień” wyłącza przyjmowanie dla wybranego klubu — stanowiska dostaną odmowę.

Anulowanie zamówienia zwraca towar na magazyn, jeśli był z niego zdjęty.

Powiadomienia. Nowe zamówienie i zmiana statusu idą na kanał Telegram: klubu, jeśli jest wskazany w karcie klubu, w przeciwnym razie organizacji. Tam też pojawiają się ostrzeżenia o niskim stanie towaru.

W nagłówku panelu wisi koszyk. Licznik pokazuje tylko nowe zamówienia — te, które wymagają uwagi właśnie teraz; zamówienia w realizacji i gotowe widać na liście po najechaniu, z podziałem na statusy. Kliknięcie koszyka prowadzi na tablicę.

Nowe zamówienie sygnalizuje dźwięk. Dźwięk wybiera się w ustawieniach organizacji — ostre wbudowane sygnały albo własny wgrany plik, z głośnością i powtórzeniem. Wiadomość klienta na czacie ma własny sygnał, ustawia się go w tym samym miejscu. Przeglądarka pozwala na dźwięk dopiero po pierwszym kliknięciu na stronie — do tego czasu na koszyku widać pomarańczowy dzwonek.

---

Tablica zamówień

Te same zamówienia, ale jako kanban: kolumny Nowe / W trakcie / Gotowe / Anulowane oraz karta z dużym numerem stanowiska w lewym górnym rogu — z nim pracownik idzie do klienta. Tablica odświeża się sama raz na dziesięć sekund, przyciski na karcie przesuwają zamówienie między kolumnami.

Jest tu też przełącznik „Przyjmowanie zamówień”: wyłączony — stanowiska dostają odmowę i zamówienie nie powstaje. Przydaje się, gdy kuchnia zamyka się wcześniej niż sala.

12.1 Zmiany kasowe

Zmiana to okres pracy kasjera w klubie. Dopóki zmiana nie jest otwarta, salda klienta nie da się doładować w żaden sposób: ani z karty klienta, ani z mapy klubu, ani zgłoszeniem „po zalogowaniu”. Dzięki temu pieniądze zawsze są przypisane do tego, kto je przyjął.

Sekcja Zmiany kasowe:

DziałanieCo się wprowadzaPo co
Otwarcie zmianyGotówka w szufladzie na początek, komentarzOd tej kwoty liczy się „powinno być” przy zamknięciu
Zamknięcie zmianyPrzeliczona gotówka, komentarzSystem sam pokaże różnicę wobec oczekiwanej kwoty

Na liście dla każdej zmiany widać: klub, kto i kiedy ją otworzył i zamknął, ile przyjęto gotówką, bezgotówkowo i bonusami, oraz „w kasie” — ile powinno być (przy otwartej) albo ile przeliczono i o ile się rozeszło (przy zamkniętej). Różnica jest podświetlana: nadwyżka na zielono, niedobór na czerwono.

Jedna otwarta zmiana na klub. Zmiany sąsiednich klubów sobie nie przeszkadzają.

> Dopóki zmiana jest otwarta, w nagłówku pieniądze pokazywane są za zmianę, a nie za dobę > kalendarzową — zmiana często przechodzi przez północ. Podpis obok liczby mówi, jakiego okresu > dotyczy kwota.

---

13. Metody płatności i operacje płatnicze

Sposoby płatności (potocznie kasy) to miejsca, do których trafiają pieniądze. W menu sekcja nazywa się „Sposoby płatności”, żeby nie mylić jej z sekcją „Kasa” — stanowiskiem pracy kasjera.

ParametrZnaczenie
NazwaNa przykład „Gotówka”, „Terminal”, „Bonusy”
TypGotówkowy, bezgotówkowy, bonusowy
KlubKasa konkretnego klubu albo wspólna dla organizacji
StatusAktywna albo wyłączona
SaldoLiczy się samo: suma wszystkich operacji kasy

Kasa bonusowa salda nie gromadzi: to naliczenia, a nie realne pieniądze. Właśnie dlatego przychód w nagłówku i w analityce liczony jest tylko z kas gotówkowych i bezgotówkowych, a naliczenia bonusowe pokazywane są osobną liczbą.

Operacje na koncie to dziennik wszystkich ruchów: doładowania, opłaty za czas, zakupy abonamentów, zwroty, korekty. Filtry po dacie, typie, źródle i kasie, wyszukiwanie po kliencie. Przy doładowaniach dostępny jest zwrot (jeśli nadano uprawnienie).

---

14. Kody promocyjne

Sekcja Kody promocyjne.

ParametrZnaczenie
KodUnikalny w organizacji; litery, cyfry, myślnik, podkreślenie
KlubTylko w tym klubie albo we wszystkich
ZdarzenieKiedy działa: przy rejestracji albo przy doładowaniu
DziałanieDoładować tego, kto wpisał, albo konkretnego klienta
KwotaIle naliczyć
Limit aktywacji0 — bez ograniczeń
Okno datOd którego do którego dnia działa
StatusGotowy, wykorzystany, przeterminowany, wyłączony

Obecnie kody promocyjne stosowane są przy rejestracji klienta na stanowisku: wpisuje kod i dostaje naliczenie.

---

15. Banery

Obrazki na ekranie stanowiska. Ustawia się obszar wyświetlania (siatka 16×9, zaznaczana myszą), okres (zawsze albo zakres dat), czas (dni tygodnia i godziny, okno przez północ jest dozwolone), grupy stanowisk i czas wyświetlania w sekundach.

16. Gry

Katalog gier klubu: nazwa i opis z tłumaczeniami, obrazek, ocena (rośnie przy uruchomieniach) i sposób uruchamiania. Dla plików lokalnych podaje się ścieżkę, dla launcherów (Steam, Battle.net, Epic, Riot, Ubisoft, EA, GOG, Rockstar, Wargaming) tylko ID gry — odnośnik system złoży sam. W karcie jest podpowiedź, gdzie wziąć ID, i podgląd gotowego polecenia uruchomienia.

W karcie gry zaznacza się gatunki — dowolnie wiele na grę. Na liście widać je jako plakietki, a obok wyboru klubu pojawia się filtr po gatunku. Stanowisko dostaje gatunki razem z katalogiem i pokazuje klientowi ten sam filtr, co operatorowi.

Klient może oznaczyć grę gwiazdką — ulubione przechowywane są dla pary „klient + klub” i docierają na stanowisko od razu przy logowaniu. Z panelu ulubionych się nie edytuje: to wybór klienta.

17. Gatunki gier

Osobny słownik organizacji: lista gatunków jest jedna dla całej sieci, a gry należą do klubów i się do niej odwołują — inaczej „Strzelankę” trzeba by zakładać w każdym klubie od nowa.

ParametrZnaczenie
NazwaOsobne pole dla każdego języka organizacji
SortowanieKolejność na listach i w menu stanowiska
AktywnośćWyłączony gatunek zostaje w panelu, ale nie jest wysyłany na stanowiska

Na liście widać, ile gier jest w każdym gatunku. Usunięcie gatunku zdejmuje go także z gier — same gry zostają na miejscu.

18. Rezerwacja stacji gier

Czas rezerwacji wybiera się godziną i minutami, minuty co 5 (00, 05, … 55; domyślnie 00): klient nie przychodzi równo o pełnej godzinie, a zaokrąglanie do pół godziny dawało mu — albo zabierało — prawie trzydzieści minut.

Siatka „stanowiska × czas” jest rozpisana na godziny — zwykle 24 kolumny na dobę. Rezerwacja zajmująca część godziny jest też narysowana częścią: od 13:20 do 14:40 pasek zaczyna się w jednej trzeciej pierwszej komórki i urywa w dwóch trzecich drugiej. Widać przez to i dokładny czas, i obraz całego wieczoru, a 288 pięciominutowych kolumn nie zmieściłoby się na ekranie.

Dwa razy w roku doba nie ma 24 godzin. W ostatnią niedzielę marca zegary przesuwa się w przód i godziny 03:00 tego dnia nie ma wcale — siatka ma jedną kolumnę mniej. W ostatnią niedzielę października przesuwa się je w tył i jedna godzina idzie dwa razy: kolumna przed nią trwa dwie godziny, czyli rezerwacja „02:00–03:00” tego dnia to dwie godziny gry. Takie kolumny są oznaczone w nagłówku kropkowanym podkreśleniem, a podpowiedź po najechaniu wyjaśnia, co się dzieje.

Zaznaczenie myszą od razu na kilku stanowiskach tworzy rezerwację grupową; minuty ustala się potem w oknie. Zajętych godzin i minionych wybrać się nie da; rezerwacje, które już się odbyły, pokazywane są przygaszone, ale pozostają dostępne do edycji.

Klient może zarezerwować stanowisko sam — z aplikacji mobilnej. Wybiera klub, datę i stanowisko, a rezerwacja pojawia się w tej samej sekcji i na mapie klubu: osobnego „świata” dla aplikacji nie ma, administrator widzi ją na równi ze swoimi. System sam sprawdza, że czas jest w przyszłości i nie dalej niż 30 dni, że długość mieści się między 30 minutami a 12 godzinami, że stanowisko jest wtedy wolne i klub przyjmuje rezerwacje; jednocześnie klient może mieć nie więcej niż pięć rezerwacji. Swoją rezerwację może też odwołać, dopóki się nie skończyła.

Stanowiska nie można zarezerwować dwukrotnie. Nachodzenie terminów sprawdza serwer — i w siatce, i przy zaznaczeniu grupowym, i w aplikacji mobilnej. Styk „koniec w koniec” jest dozwolony: rezerwacja do 15:00 i rezerwacja od 15:00 nie kolidują. W rezerwacji grupowej stanowiska, u których ten czas jest już zajęty, są pomijane, a ich numery wymienione w komunikacie.

Przypomnienie o rezerwacji. Zadany czas przed początkiem klient dostaje przypomnienie — na Telegramie, jeśli powiązał bota w aplikacji mobilnej, w przeciwnym razie e-mailem. Włączenie i czas „na ile minut przed” to wspólne ustawienie systemu: administrator serwisu ustawia je raz, osobno dla klubów i organizacji się tego nie konfiguruje. Rezerwacje bez klienta (te administrator zakłada „na nazwisko po telefonie”) przypomnień nie dostają, a przypomnienie o jednej rezerwacji wychodzi raz.

19. Obrazy stacji

Lista wzorcowych obrazów serwera klubu: data, ścieżki i rozmiary, oznaczenie aktywnego. Synchronizuje się z serwerem przy otwarciu sekcji. Tu też wybiera się, który obraz uchodzi za bieżący, i usuwa niepotrzebne.

20. Sesje

Dziennik sesji klientów: kiedy, kto, na którym stanowisku, ile czasu i na jaką kwotę. Tylko podgląd.

21. Historia zdarzeń

Kto i co zmieniał w panelu: użytkownik, sekcja, działanie, wartości przed i po. Filtry po datach i pracowniku. Domyślnie otwiera się na dziś — żeby zobaczyć starsze wpisy, przesuń okres.

22. Lokalizacja

Lokalizacje to języki, w których działają stanowiska i katalog. Każdy język ma kod (uk, ru, en, pl…), nazwę, flagę i oznaczenie „domyślny”. Klient widzi stanowisko w swoim języku, a katalog — nazwy gier i towarów — bierze się z tłumaczeń tego języka; nie ma tłumaczenia, zostaje język domyślny.

Wyłączony język nie jest wydawany stanowiskom, ale wprowadzone tłumaczenia nie przepadają: można go włączyć z powrotem.

23. Historia czatu

Rozmowy z klientami, które już się skończyły. Czat na mapie działa tylko z aktywną sesją, więc zakończoną rozmowę da się przeczytać wyłącznie tutaj: lista z datami, stanowiskiem, klientem, liczbą wiadomości i nieprzeczytanymi, filtry po klubie i okresie oraz szukanie po treści wiadomości — rozmowę zwykle przypomina się właśnie po zdaniu.

Klik otwiera całą rozmowę, tymi samymi bąbelkami i znacznikami statusu, co na mapie, i oznacza wiadomości przychodzące jako przeczytane. Rozmowy nie można kontynuować — klienta przy stanowisku już nie ma.

24. Opinie i oceny klubów

Klient wystawia klubowi ocenę od 1 do 5 i może napisać opinię — ze stanowiska (dokładnie tam, gdzie gra) albo w aplikacji mobilnej. Opinia jest jedna na klub: nowe wysłanie nadpisuje poprzednie, więc nie da się nakręcić oceny powtórkami.

Ocenić może tylko ten, kto w tym klubie grał. Sprawdzenie idzie po historii wizyt, więc opinie „na zamówienie” z cudzych kont są odcinane na wejściu.

Opinia nie jest publikowana od razu — przechodzi weryfikację. Trzy stopnie, od darmowego do płatnego:

1. Proste reguły: odnośniki i kontakty, numery telefonów, wulgaryzmy. 2. Darmowa weryfikacja OpenAI: groźby, nękanie, nieprzyzwoitości. 3. Weryfikacja modelem: reklama innych klubów, spam, oskarżanie konkretnych pracowników, tekst nie na temat.

Ostra krytyka klubu — brud, hałas, ceny, chamstwo — jest traktowana jako normalna opinia i zostaje opublikowana. Filtr usuwa śmieci, a nie niewygodne zdania.

Odrzuconą opinię widzi tylko jej autor, razem z powodem. Jeśli weryfikacja jest niedostępna (na przykład skończyły się pieniądze na koncie OpenAI), opinia zostaje opublikowana z adnotacją — inaczej opinie gromadziłyby się w kolejce i nikt by się o tym nie dowiedział.

Klucz OpenAI i model ustawia raz administrator systemu (ustawienia systemu, grupa AI). Bez klucza działają tylko proste reguły — system nadal przyjmuje opinie.

25. Klucze API

Klucz, którym zewnętrzny partner sięga po dane twojej organizacji: kasa, system lojalnościowy, strona z rezerwacją online, witryna sieci. Klucz tworzysz ty i przekazujesz partnerowi — tak jak hasło: kto go ma, działa w imieniu twojej organizacji.

ParametrZnaczenie
NazwaDla kogo jest klucz. Po niej poznasz, który odwołać
WygasaBez terminu, 1 dzień, 1 tydzień, 1 miesiąc, 1 rok albo dowolna data. Przy dowolnej wybiera się tylko datę: wybrany dzień jest ostatnim dniem pracy klucza, działa do 23:59:59. Po wygaśnięciu żądanie nie przechodzi — termin liczy serwer, zegar partnera nie ma znaczenia. Na liście klucz bez terminu oznaczony jest kreską
Tryb dostępuPełny dostęp — wszystko, co możesz ty sam; Grupa dostępu — uprawnienia wybranej grupy, jak u pracownika; Własny zestaw — tylko zaznaczone funkcje
Dziennik żądańPole wyboru: każde wywołanie tym kluczem jest przechowywane 7 dni — akcja, kod odpowiedzi, czas trwania i treść żądania. Włącz, gdy sprawdzasz, dlaczego u partnera nie działa; na stałe nie jest potrzebny

Wybór funkcji w trybie „własny zestaw” wygląda tak samo jak uprawnienia grupy dostępu: bloki, grupy, pozycje i wyszukiwanie. Przy każdej pozycji podpisana jest nazwa funkcji w systemie — właśnie ją partner podaje w żądaniu i właśnie tę pozycję zaznaczasz, gdy prosi o dostęp.

Na liście klucz pokazany jest pierwszymi i ostatnimi czterema znakami: wychodzi na zewnątrz i nie ma powodu czytać go w całości ze wspólnej tabeli. Cały klucz widać w karcie, a przycisk w wierszu go kopiuje.

Termin przydaje się na próbę: daj partnerowi klucz na tydzień i wyłączy się sam, nawet jeśli wszyscy o nim zapomną. Odwołać klucz wcześniej można tylko tutaj — usunąć albo nadać termin.

Co partner może zrobić kluczem. Na razie — tylko czytać: salę i stanowiska, katalog (gry, towary, ceny, stany), taryfy i abonamenty z harmonogramami, klientów i ich abonamenty, operacje, zmiany, sesje, zamówienia, rezerwacje, rozmowy, analitykę. Kluczem nie da się nic zmienić: doładować salda, sprzedać abonamentu, przesunąć statusu zamówienia ani wyłączyć stanowiska przez API.

Częstotliwość jest ograniczona: 120 żądań na minutę na klucz. Odpytywanie stanu sali raz na kilka sekund mieści się w tym z zapasem.

Dokumentacja dla partnera to API dla partnerów: adres, format żądania i odpowiedzi, lista akcji, kody błędów, gotowa kolekcja Postman. Przekaż ten link razem z kluczem — programista nie potrzebuje niczego więcej. ---

26. Ustawienia globalne (ustawienia organizacji)

Klienci i zamówienia

UstawienieZnaczenie
Logowanie z ujemnym saldemNie (domyślnie) — klient z długiem nie siądzie przy stanowisku, dopóki się nie rozliczy. Tak — loguje się i dogrywa na dług
Potwierdzanie zamówień w sklepieUstawienie jest zapisywane, ale na razie na nic nie wpływa — czekamy na opis scenariusza
Limit doładowaniaPułap kwoty jednego doładowania salda klienta; domyślnie 100 000, 0 — bez ograniczenia. Sprawdzany na wszystkich drogach kasowych: karta klienta, doładowanie z mapy klubu, zgłoszenie „po autoryzacji” i API partnerskie. To zabezpieczenie przed pomyłką w zerach, a nie przed nadużyciem
Maksymalny limit płatności po grzePułap kwoty płatności po grze i limit domyślny, jeśli administrator go nie ustawił; 0 — bez ograniczenia
Zaokrąglanie płatności po grzeJak zaokrąglić sumę: bez zaokrąglania (do groszy), w górę do całości, zwykłe albo w dół do całości. Zaokrąglenie następuje raz — gdy płatność po grze zamyka się i czeka na zapłatę
Sygnał nowego zamówieniaDźwięk, którym panel sygnalizuje nowe zamówienie: ostre piski, syrena, alarm, klakson, seria albo bez dźwięku. Sygnały są celowo ostre — muszą być słyszalne, nawet gdy pracownik jest kilka metrów od monitora. Obok są głośność i przycisk „Posłuchaj”
Podwójny sygnałTak — sygnał powtarza się jeszcze raz po sekundzie. Pojedynczy dźwięk łatwo wziąć za przypadkowy, powtórzenie czyta się jako zwrócenie się do człowieka
Własny plik dźwiękowyMożna wgrać własny dźwięk (MP3, OGG lub WAV do 1 MB) — zastąpi wbudowany sygnał. Najlepiej krótkie nagranie na 1–3 sekundy. Usunięto plik — znów gra wybrany z listy
Sygnał wiadomości na czacieTen sam zestaw sygnałów, ale dla wiadomości klienta na mapie klubu. Pierwsza pozycja to „Jak przy zamówieniach”: póki jest wybrana, czat odzywa się sygnałem zamówienia i nie trzeba nic ustawiać. Wybierz inny — i na słuch będzie jasne, czy wołają cię do kasy, czy piszą w rozmowie
Głośność sygnału czatu, podwójny sygnał czatu, własny plik dźwiękowy czatuTo samo, co przy zamówieniu, ale dla czatu: własna głośność, własne powtórzenie i własne nagranie. Przycisk „Posłuchaj” obok listy gra dokładnie to, co usłyszy zmiana

Sekcja Ustawienia ogólne.

BlokParametry
MagazynCzy zdejmować towary przy zamówieniu; czy pozwalać schodzić poniżej zera (inaczej stanowisko dostanie „brak w magazynie”); czy ukrywać wyprzedane towary przed klientami
AbonamentyMaksimum przechowywanego czasu u klienta (godzin, 0 — bez limitu) i zakaz posiadania więcej niż jednego niewykorzystanego abonamentu
TelegramBot organizacji i kanał powiadomień dla pracowników
Poczta (SMTP)Wysyłka listów do klientów
Strefa czasowaWedług niej liczone są granice doby w analityce
JęzykiJęzyki, w których pracują stanowiska i katalog
WebhookAdres, na który serwis sam zgłasza zdarzenia: początek i koniec sesji, nowe zamówienie i zmianę jego statusu, doładowanie salda. Tutaj też włączenie, lista zdarzeń i klucz podpisu — odbiorca sprawdza nim, że żądanie naprawdę jest nasze. Wysyłka idzie przez kolejkę z trzema próbami, więc niedostępny odbiorca niczego w panelu nie wstrzymuje. Przydaje się do własnego CRM, bota Telegram albo tablicy na sali

Import z innego systemu (SENET)

Kreator w czterech krokach: zestaw danych → dane dostępowe → cel → uruchomienie.

ZestawCo przenosi
KlienciKonta wybranej grupy razem z saldem pieniężnym
SaldoTylko aktualizuje saldo już zaimportowanych klientów
Strefy, stanowiska, taryfy, abonamentyInfrastrukturę wybranego lokalu do wybranego klubu
Kategorie i towaryKatalog sklepu z obrazkami i tłumaczeniami
Indeksy i kody kreskoweTylko kody i oznaczenie aktywności istniejących towarów
Wszystko narazCałą infrastrukturę plus klientów wybranej grupy

Opcja „wyczyść bieżącą listę” usuwa poprzednie wpisy przed wczytaniem — stosuj ją świadomie. Import idzie w tle, wynik zostaje przy zadaniu.

---

27. Pracownicy i grupy dostępu

Pracownicy

Sekcja Pracownicy: login, imię, e-mail, telefon, hasło, grupa uprawnień, awatar, lista klubów i oznaczenie „może logować się na stanowiskach” (do logowania służbowego na sali).

Pracownik widzi tylko przypisane mu kluby — dotyczy to i mapy, i zamówień, i wskaźników w nagłówku.

Grupy dostępu

Sekcja Grupy uprawnień to zestawy dozwolonych funkcji.

W oknie grupy uprawnienia są pogrupowane w bloki (Klub, Sklep, Klienci, Naliczanie, Personel i dostęp, Organizacja) oraz sekcje. Jest wyszukiwanie po nazwie i pole „wybierz całą grupę”.

Na liście grup każdy wiersz ma ikonę z licznikiem pracowników: otwiera ona skład grupy, gdzie zaznacza się pracowników organizacji. Pracownik ma jedną grupę uprawnień, więc zaznaczenie przenosi go tutaj z poprzedniej (jest podpisana obok), a odznaczenie zostawia bez grupy.

Właściciel grup nie potrzebuje: ma pełny dostęp zawsze.

---

28. Analityka

Sekcja Analityka to pulpit za wybrany okres.

Okres: gotowe warianty (dziś, wczoraj, 7 dni, miesiąc, rok…) albo własny okres. Dla własnego ustawia się nie tylko daty, ale i czas początku i końca — można spojrzeć na przykład tylko na godziny wieczorne. Koniec wlicza się w całości: 00:00–23:59 to dokładnie doba.

Szczegółowość — po dniach albo po miesiącach.

Wskaźniki: przychód całkowity, przychód stanowisk i sklepu, osobno fajka wodna i alkohol, obłożenie, klienci aktywni i nowi.

Wykresy: przychód według okresów, obłożenie, przychód według grup stanowisk, średnie obłożenie według godzin doby i mapa cieplna obłożenia.

Kasy: tabela odczytów (doładowania, zwroty, suma, liczba operacji, udział) i wykres „Kasy w czasie” — osobna linia dla każdego sposobu płatności z przełącznikiem dzień / tydzień / miesiąc. Kliknięcie legendy usuwa zbędne kasy, a w podpowiedzi widać sumę pokazanych.

Przychód według zmian — tabela dyżurów za ostatnie 30 dni: data otwarcia, klub, kasjer, ile godzin trwała zmiana, przyjęto gotówką i bezgotówkowo, bonusy osobno, przychód w pieniądzach i liczba operacji; na dole podsumowanie i „średnio na zmianę”. Przychód zmiany to pieniądze przyjęte przez kasjera (gotówka plus bezgotówkowe, bez zwróconych doładowań); liczony jest tą samą formułą, co w sekcji zmian kasowych, więc liczby na obu ekranach są zgodne. Bonusy pokazane są przygaszone: to nie pieniądze w kasie.

Przychód tygodniowy — wykres za ostatnie 18 tygodni: słupki to suma tygodnia, linia to średni przychód na dzień tego tygodnia. Tydzień liczy się od poniedziałku; bieżący, jeszcze niezakończony, dzielony jest przez dni, które minęły, i w podpowiedzi jest opisany jako „niepełny tydzień” — inaczej zawsze wyglądałby na spadek.

Okna tych dwóch bloków są stałe — 30 dni i 18 tygodni; nie zależą od filtra okresu w nagłówku (zmienia się tylko wybór klubu). Każda karta mówi o tym w podpisie.

Dane za minione dni liczy nocne przeliczenie, dzisiejszy dzień — na bieżąco. Jeśli ustawisz czas, cały okres jest przeliczany z danych źródłowych.

---

29. Jak klient korzysta ze stanowiska

1. Rejestracja — na stanowisku przez e-mail i hasło, kod potwierdzający przychodzi listem. Można od razu wpisać kod promocyjny. 2. Logowanie — e-mail i hasło, kod QR przez aplikację mobilną albo pomoc administratora (wpisuje dane z mapy klubu, stanowisko potwierdza logowanie). 3. Sesja — najpierw idą darmowe minuty klubu, potem abonament, potem pieniądze z salda. Klient widzi pozostały czas i saldo. 4. Katalog — gry (uruchomienie jednym kliknięciem), towary z cenami swojego klubu. 5. Zamówienie — koszyk z zestawami combo i towarami powiązanymi; zamówienie pojawia się na tablicy u personelu, pieniądze nie są pobierane. 6. Zakończenie — klient wylogowuje się sam albo sesja kończy się z wyczerpaniem środków. Porzuconą sesję system zamknie sam i nie pobierze nic ponad.

---

30. Częste zadania

ZadanieJak to zrobić
Przyjąć pieniądze od klientaKarta klienta albo mapa klubu → „Doładuj konto”, wybrać kasę
Naliczyć bonusDoładowanie kasą bonusową; komentarz obowiązkowy
Pozwolić dograć na długMapa klubu → prawy przycisk na stanowisku → „Udziel kredytu”
Zamknąć długZwykłe doładowanie na kwotę długu
Pomyłka przy doładowaniuOperacje na koncie → „Zwrot” w potrzebnym wierszu
Wbito na złą kasęKasa → „Doładowanie” → przycisk ze strzałkami w wierszu historii → inna kasa
Posadzić klienta bez jego telefonuMapa klubu → „Zaloguj klienta” (e-mail i hasło klienta)
Przygotować stanowisko do naprawyPrawy przycisk → „Tryb stanowiska” → „Serwis”
Zainstalować gry, nie tracąc ich przy restarciePrawy przycisk → „Tryb stanowiska” → „Administracja”
Zdjąć wzorcowy obraz po instalacji gierW trybie administracyjnym wyłączyć stanowisko → prawy przycisk → „Utwórz złoty obraz”
Włączyć całą salęZaznaczyć stanowiska ramką → „Włącz”
Dowiedzieć się, że na serwerze kończy się miejsceIkona dysku w nagłówku → okno stanu serwera (próg — w karcie klubu)
Rozdać pieniądze gościomZaznaczyć stanowiska → „Doładuj po zalogowaniu”
Tymczasowo zamknąć kuchnięTablica zamówień → wyłączyć „Przyjmowanie zamówień”
Zrozumieć, gdzie poszły pieniądze ze zmianyAnalityka → okres z godzinami zmiany → „Kasy w czasie”
Dać pracownikowi dostępGrupy uprawnień → potrzebna grupa → ikona składu → zaznaczyć pracownika

---

31. O czym warto pamiętać