Case study · Fitness
System wejść i karnetów dla klubu fitness
Klub fitness potrzebował systemu, w którym recepcja wpuszcza klienta jednym skanem karty, a program sam sprawdza, czy karnet obejmuje daną strefę i porę dnia. Zbudowaliśmy aplikację do wejść, karnetów, zawieszeń i sprzedaży w recepcji, z przypomnieniami dla klientów i cotygodniową kopią danych.
- jeden skan karty przy wejściu
- 3 dni przed końcem karnetu przypomnienie mailem
- 8 ostatnich kopii danych na Dysku Google
System wejść do klubu fitness w skrócie
System wejść do klubu fitness to aplikacja, która po zeskanowaniu karty klienta sprawdza jego karnet i zapisuje wejście do strefy albo pokazuje recepcji powód odmowy. W tym wdrożeniu system obsługuje też sprzedaż i zawieszanie karnetów, sklepik w recepcji ze stanami magazynowymi, przypomnienia mailowe i kopie zapasowe na Dysku Google.
Klient.
Klub fitness z kilkoma strefami, np. siłownią, salą zajęć i sauną, oraz z różnymi typami karnetów.
Cel.
Szybka obsługa wejść w recepcji i karnety, których nie da się zmienić bez śladu.
Zakres.
Wejścia na kartę, karnety i zawieszenia, sklepik, raporty, przypomnienia, kopie zapasowe i przywracanie danych.
Integracje.
Czytniki kart i kodów kreskowych na USB, Dysk Google, poczta SMTP.
Recepcja bez systemu i z systemem
Bez systemu: Ważność karnetu sprawdzana ręcznie przy każdym wejściu
Z systemem: Skan karty i od razu wynik: wejście albo powód odmowy
Bez systemu: Wejście do strefy spoza karnetu łatwo przeoczyć
Z systemem: Strefy i godziny zapisane w typie karnetu, sprawdzane przy skanie
Bez systemu: Zawieszenie karnetu liczone w kalendarzu
Z systemem: Koniec karnetu przesuwa się o dni zawieszenia automatycznie
Bez systemu: Zmiana karnetu bez śladu, kto i dlaczego
Z systemem: Edycja tylko przez administratora, z zapisanym powodem
Bez systemu: Stan towaru w recepcji liczony na koniec dnia
Z systemem: Sprzedaż zdejmuje towar ze stanu, nie da się sprzedać więcej, niż jest
Bez systemu: Klient dowiaduje się o końcu karnetu przy wejściu
Z systemem: Mail 3 dni przed końcem karnetu
Recepcja skanuje kartę. Resztę sprawdza system.
Jak działa wejście na kartę krok po kroku
Skan karty
Czytnik kart albo kodów kreskowych na USB działa jak klawiatura. Pole skanowania w recepcji samo wraca do aktywności, więc kolejny skan zawsze trafia we właściwe miejsce.
Klient i karnet
System znajduje klienta po numerze karty, pokazuje zdjęcie i notatki oraz wybiera aktywny karnet. Klient, który już jest w klubie, nie wejdzie drugi raz.
Ważność i zawieszenie
Karnet czasowy musi być ważny, a karnet na wejścia musi mieć wejścia i nieprzekroczoną datę ważności. Zawieszony karnet blokuje wejście.
Strefa i godziny
Strefa musi być w karnecie, a karnet z ograniczeniem godzin działa tylko w ustalonych porach. W tym klubie przy płatności kartą sportową sauna jest niedostępna.
Wejście i licznik
System zapisuje wejście ze strefą i numerem szafki, a przy karnecie na wejścia odejmuje jedno wejście.
Wyjście
Przy wyjściu klienta recepcja zamyka wejście, a system zapisuje czas pobytu.
Co recepcja i administrator mają w systemie
Klienci i karty.
Karta klubowa, zdjęcie, szafka, notatki i historia wejść każdego klienta.
Typy karnetów.
Czasowe, na wejścia i jednorazowe, ze strefami, ograniczeniem godzin i limitem dni zawieszenia.
Zawieszenia.
Koniec karnetu przesuwa się o liczbę dni zawieszenia, a anulowanie przywraca poprzednią datę.
Sklepik w recepcji.
Produkty z kodem kreskowym, stany magazynowe, próg niskiego stanu i sprzedaż.
Raporty i dziennik zmian.
Raport dzienny i z zakresu dat, eksport do CSV oraz dziennik działań pracowników.
Kopie zapasowe.
Co tydzień archiwum z danymi w CSV na Dysku Google, 8 ostatnich kopii i przywracanie z pliku.
Technologie i integracje w tym wdrożeniu
Czytniki kart i kodów (USB)
Czytnik działa jak klawiatura, a pole skanowania samo odzyskuje fokus po każdym kliknięciu obok.
Dysk Google
Cotygodniowe kopie ZIP z plikami CSV, wysyłane przez konto serwisowe z dostępem tylko do plików aplikacji.
Poczta SMTP
Przypomnienia o końcu karnetu i o kończących się wejściach.
FastAPI i MySQL
Backend z regułami wejść, harmonogram zadań i baza danych klubu.
Next.js
Panel recepcji i administratora w przeglądarce, po polsku.
Wyzwanie: wejścia, karnety i strefy przy jednej ladzie
Klub ma kilka stref i różne typy karnetów: czasowe, na wejścia i jednorazowe, część z ograniczeniem godzin, część z możliwością zawieszenia. Przy każdym wejściu recepcja musi wiedzieć, czy karnet jest ważny, czy obejmuje strefę i czy nie jest zawieszony. Do tego sprzedaje karnety i drobne produkty, a klienci chcą wiedzieć, kiedy kończy się karnet.
Rozwiązanie: aplikacja recepcji z regułami wejść
Zbudowaliśmy aplikację webową z panelem recepcji i administratora oraz backendem, który pilnuje reguł. Wejście sprawdza kolejno: czy klient nie jest już w klubie, czy ma aktywny karnet, czy karnet nie jest zawieszony ani przeterminowany, czy ma wejścia, czy obejmuje strefę i porę dnia. Każda odmowa ma swój powód na ekranie.
- Karnety bez cichych zmian: sprzedany karnet jest zablokowany, edycja tylko z powodem, usunięcie tylko miękkie.
- Zawieszenia z limitem: typ karnetu określa, czy i na ile dni można go zawiesić, a koniec karnetu przesuwa się sam.
- Sklepik: sprzedaż po kodzie kreskowym zdejmuje towar ze stanu, a produkt z niskim stanem jest oznaczony.
- Role: pracownik recepcji obsługuje wejścia i klientów, karnety zmienia i dane przywraca administrator.
- Dziennik: działania pracowników zapisują się w dzienniku zmian.
Kopie zapasowe na Dysku Google i przywracanie danych
Co tydzień system eksportuje klientów, typy karnetów, karnety, zawieszenia, wejścia, produkty i sprzedaż do siedmiu plików CSV, dokłada plik z opisem kopii i pakuje całość do archiwum ZIP. Archiwum trafia na Dysk Google przez konto serwisowe, a starsze kopie ponad 8 ostatnich są usuwane.
- Pliki do otwarcia w arkuszu: CSV w UTF-8 ze średnikiem, a komórki zaczynające się od znaków formuły są zabezpieczone przed wstrzyknięciem formuły.
- Przywracanie z kontrolą: przed wczytaniem system sprawdza opis kopii, komplet plików i ich rozmiar.
- Czego nie ma w kopii: zdjęć klientów i kont pracowników.
- Co zostaje na stałe: wejścia, karnety i sprzedaż. Dzienniki powiadomień i kopii są czyszczone po 30 dniach.
Efekty wdrożenia systemu wejść i karnetów
- Wejście jednym skanem z wynikiem albo powodem odmowy na ekranie.
- Karnety ze śladem zmian: każda edycja i każde usunięcie z powodem.
- Stany w sklepiku na bieżąco, bo sprzedaż zdejmuje towar ze stanu.
- Dane klubu poza serwerem: co tydzień kopia na Dysku Google, z możliwością przywrócenia.
Dla kogo jest system wejść i karnetów?
Podobny system sprawdza się w siłowniach, klubach fitness, na basenach, w szkołach tańca i sztuk walki, czyli wszędzie tam, gdzie klient wchodzi na kartę albo karnet, a obiekt ma strefy i różne cenniki. Więcej przeczytasz na stronach aplikacje wewnętrzne i oprogramowanie dedykowane. Inne nasze wdrożenie w branży fitness to CRM dla studia treningu personalnego.
Chcesz podobny system w swoim klubie?
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak działa system wejść na kartę w klubie fitness?
Recepcja skanuje kartę klienta, a system od razu sprawdza karnet: ważność, liczbę wejść, zawieszenie, strefę i godziny. Gdy wszystko się zgadza, zapisuje wejście, a przy karnecie na wejścia odejmuje jedno. Gdy nie, pokazuje recepcji konkretny powód odmowy.
Czy czytnik kart wymaga specjalnej integracji?
Nie. Czytniki kart i kodów kreskowych na USB działają jak klawiatura, więc wystarczy pole skanowania w aplikacji. W tym systemie pole samo odzyskuje fokus, żeby skan nie trafił w inne miejsce na ekranie.
Jak działa zawieszenie karnetu?
Administrator ustawia daty zawieszenia, a koniec karnetu przesuwa się o tyle dni, ile trwa zawieszenie. System pilnuje limitu dni z typu karnetu i nie pozwala na nakładające się zawieszenia ani na zawieszenie wykraczające poza ważność karnetu. Anulowanie przywraca poprzednią datę końca.
Czy można zmienić albo usunąć karnet bez śladu?
Nie. Sprzedany karnet jest zablokowany do edycji. Zmienić go może tylko administrator, podając powód, a usunięcie jest miękkie: karnet znika z obsługi, ale zostaje w bazie razem z powodem usunięcia.
Czy klient dostaje przypomnienie o końcu karnetu?
Tak. Codziennie o 8:00 system wysyła mail do klientów, którym karnet kończy się za 3 dni, oraz do tych, którym na karnecie na wejścia zostały najwyżej 2 wejścia. Każda wysyłka trafia do dziennika, więc ten sam klient nie dostanie tego samego przypomnienia dwa razy jednego dnia.
Jak działają kopie zapasowe danych klubu?
Co tydzień, w nocy z soboty na niedzielę, system pakuje dane do archiwum ZIP z plikami CSV i wysyła je na Dysk Google przez konto serwisowe. Na Dysku zostaje 8 ostatnich kopii. Z takiego archiwum administrator może przywrócić dane, a system najpierw sprawdza, czy plik jest kompletny.
Czy system obsługuje karty sportowe?
Tak, jako formę płatności przy karnecie. System nie łączy się z operatorami kart sportowych, ale zapisuje, czym klient zapłacił, i stosuje do tego reguły wejść, np. w tym klubie płatność kartą sportową nie obejmuje sauny.

