1. Dita e parë
GYMFLOW është një aplikacion i vetëm me dy fytyra: hapësira e stafit për pronarët, recepsionin, trajnerët dhe kontabilistët, dhe aplikacioni i anëtarit për anëtarët. Të dyja shërbehen nga e njëjta adresë. Faqja publike është ajo që sheh një vizitor para se të kyçet.

- Kyçuni si pronar me kredencialet e krijuara gjatë instalimit. Kyçja e stafit është në fund të faqes publike; anëtarët përdorin butonin lart.
- Cilësimet → Klubi: emri, email-i i kontaktit, kapaciteti, zona kohore dhe gjuha parazgjedhur. Ngarkoni logon dhe zgjidhni ngjyrat te Pamja.
- Cilësimet → Anëtarësitë: krijoni planet tuaja. Çmimi, kohëzgjatja në ditë, tarifa e regjistrimit, përfitimet në të dyja gjuhët, dhe rregullat e qasjes që bart secili plan: mënyrat e hyrjes, zonat, ditët, orari, kufiri i vizitave, ditët e lejuara të ngrirjes.
- Cilësimet → Tatimi: norma e TVSH-së, nëse çmimet e përfshijnë, dhe numri juaj i regjistrimit. Çdo kupon dhe faturë e përdor këtë që nga ai moment.
- Cilësimet → Ekipi dhe Rolet: shtoni llogaritë e stafit. Rolet janë lista aftësish; Pronari i ka gjithmonë të gjitha.
- Cilësimet → Të dhënat: importoni anëtarët ekzistues nga shablloni Excel.
- Cilësimet → Email: lidhni kutinë postare të klubit që mesazhet të dalin edhe me email.
2. Anëtarët & anëtarësitë
Ekrani i Anëtarëve është aty ku recepsioni e kalon pjesën më të madhe të ditës. Çdo anëtar bart statusin, planin, bilancin dhe foton, dhe filtrat lart u përgjigjen pyetjeve që stafi bën vërtet: kush është aktiv, kujt i ka skaduar, kush ka borxh, kush e ka të ngrirë.

Profili i anëtarit
Hapja e një anëtari ju jep gjithçka për të në një panel të vetëm, dhe çdo veprim që mund t'ju duhet pa dalë prej tij.

Regjistrimi
Anëtarët → Shto anëtar hap një udhëzues me katër hapa: të dhënat, fotoja, anëtarësia dhe kartela, pagesa.
- Të dhënat. Emri, mbiemri, kontakti, datëlindja, kontakti i urgjencës, numri personal dhe si mësuan për klubin.
- Fotoja. Me kamerë ose e ngarkuar. Fotot ruhen në bazën e të dhënave të vetë klubit dhe u shërbehen vetëm anëtarëve të stafit të kyçur, kurrë publikisht.
- Anëtarësia dhe kartela. Zgjidhni planin dhe datën e fillimit. Vendosni një kartelë RFID te një lexues USB dhe ajo e shkruan vetë numrin në fushë.
- Pagesa. Para në arkën e hapur, kartelë, bankë, llogaria e anëtarit, ose lëreni si faturë të papaguar. Kuponi është gati menjëherë.
Rinovimet, ngrirjet dhe historiku
Një rinovim i bërë para se të mbarojë termi aktual radhitet pas tij në vend që ta mbishkruajë, kështu nuk humbet asgjë e paguar. Skeda Historiku i anëtarësisë tregon çdo term me faturën e vet. Ngrirja e ndalon qasjen dhe e shtyn datën e mbarimit për aq ditë sa u ngri, brenda kufirit të planit.
Llogaritë e anëtarëve
Çdo anëtar ka një libër të vetëm llogarie. Mbushjet janë pagesa të vërteta përmes arkës, shitjet dhe rinovimet mund t'i ngarkohen llogarisë, dhe rimbursimet mund të kthehen si kredi. Cilësimet → Pagesat cakton borxhin maksimal të lejuar dhe shumën mbi të cilën bllokohet hyrja.
Të interesuarit
Kërkesat nga formulari publik i regjistrimit dhe nga kiosku vijnë te Anëtarët → Të interesuarit. Një klikim mbi Regjistro e mbush udhëzuesin paraprakisht dhe e shënon kërkesën si të konvertuar.
3. Pika e shitjes & arka



Në mbyllje zgjidhni nëse paratë e numëruara mbeten si fond për ndërrimin tjetër apo sa prej tyre kalojnë në kasafortë. Raporti Z e ngrin barazimin: shitjet sipas mënyrës dhe qëllimit, lëvizjet, shpenzimet dhe çdo transaksion i ndërrimit, të ruajtura që të lexohen muaj më vonë saktësisht ashtu si ishin.
4. Kalendari & rezervimet
Klasa, stërvitje personale dhe evente, secila me trajner, kapacitet dhe vendndodhje, të përsëritura javore nëse doni. Kalendari është ajo që shohin anëtarët kur hapin orarin në aplikacionin e tyre, prandaj çka vendosni këtu është çka mund të rezervojnë.

Stafi shënon pjesëmarrjen dhe mosparaqitjet nga vetë seanca, e cila ushqen numërimin e vizitave dhe automatizimet e arritjeve. Rezervimet e ndjekura dhe ato pa paraqitje llogariten prapë në kapacitet, kështu që listat e kaluara mbeten të vërteta.
5. Mesazhet & automatizimet
Mesazhet mban çdo bisedë me anëtarët. Shkruajini një anëtari ose një grupi të tërë, si të gjithë në një plan ose të gjithë që u skadon këtë muaj. Mesazhet mbërrijnë gjithmonë në aplikacionin e anëtarit, dhe me email kur e shënoni kutinë.

Mesazhe që dërgohen vetë

Vendmbajtësit si {first_name}, {club}, {plan}, {end_date} dhe {amount} mbushen vetë. Çdo dërgim regjistrohet një herë për çdo rast, kështu askush nuk bezdiset dy herë.
| Automatizimi | Kur dërgohet |
|---|---|
| Mirëseardhja | Në momentin që krijohet një anëtar |
| Kujtesa e rinovimit | Një numër ditësh para datës së mbarimit, një herë për term |
| Borxhi i papaguar | Javore sa kohë faturat janë të papaguara ose llogaria është negative |
| Anëtarësia e mbaruar | Një numër ditësh pas skadimit pa rinovim |
| Nuk ju kemi parë | Pas një periudhe pa hyrje, një herë për çdo mungesë |
| Ditëlindja | Në ditën e saj, sipas zonës kohore të klubit |
| Arritja e vizitave | Në vizitën e 10-të, 50-të, 100-të e kështu me radhë, e ndryshueshme |
| Kujtesa e klasës | Një numër orësh para një seance të rezervuar |
| Pagesa e pranuar | Pas çdo pagese për një anëtar, e fikur si parazgjedhje |
Muri i klubit

Anëtarët gjithashtu mund të ftojnë njëri-tjetrin për të biseduar, dhe pala tjetër duhet të pranojë para se ndonjëri të shkruajë. Askush nuk mund t'i shkruajë një të panjohuri pa u ftuar.
6. Aplikacioni i anëtarit
Aplikacioni i anëtarit është web. Dërgojuni anëtarëve lidhjen dhe janë brenda; nuk ka listim në app store, dhe asnjë përditësim që dikush duhet ta instalojë.


Anëtarët shohin kartelën e anëtarësisë, vizitat, pagesat dhe faturat, rezervojnë dhe anulojnë seanca, i shkruajnë klubit, lidhen me partnerë stërvitjeje, dhe ndërrojnë mes shqipes dhe anglishtes. Qasja aktivizohet për çdo anëtar nga profili me Aktivizo portalin, ose gjatë regjistrimit.
7. Kontrolli i qasjes
Çdo vendim për hyrje kalon nëpër rregullat e anëtarësisë: statusi aktiv, datat, faturat e papaguara mbi shumën e lejuar, mënyrat dhe zonat e lejuara, orari dhe ditët, anti-passback, dhe kufiri i vizitave.

Ka tri mënyra për të lidhur pajisjet:
- Një lexues në recepsion. Një lexues USB RFID e shkruan numrin e kartelës në kutinë te Qasja & vizitorët. Asgjë për t'u instaluar.
- Një turnike ose kontrollues dere. Një program i vogël urë në vend e përcjell çdo lexim kartele dhe e hap derën vetëm me
unlock: true. - Një skaner QR te dera. Anëtarët tregojnë kodin nga aplikacioni dhe skaneri e dërgon tekstin të pandryshuar.
curl -X POST https://club.example.com/api/gates/check \
-H "Content-Type: application/json" -H "X-Gate-Key: gfg_…" \
-d '{"credential":"<card UID>","method":"RFID","direction":"in"}'
Përgjigjja bart result, reason, member dhe unlock. Një skadim kohe, një gabim, ose çdo gjë përveç një unlock: true të qartë e mban derën të mbyllur. Një urë referencë për lexuesit e tipit tastierë vjen me aplikacionin; pjesa specifike për prodhuesin është një funksion i vetëm.

8. Financat & raportet


9. Cilësimet & gjuhët


Cilësimet përfshijnë Klubin, Pamjen, Anëtarësitë, Ekipin, Rolet, Pagesat, Tatimin, Orarin, Email-in, Njoftimet, Kontrollin e qasjes, Rezervimet dhe Të dhënat. Skedat shfaqen vetëm për rolet që kanë aftësinë përkatëse.
Secili ndërron mes shqipes dhe anglishtes me butonin EN / SQ, dhe zgjedhja ruhet në llogari. Përmbajtja e klubit që e lexojnë anëtarët, si teksti i faqes publike, emrat e planeve, përfitimet dhe mesazhet automatike, ka fusha shqip dhe anglisht krah për krah.
10. Hostimi & kopjet rezervë
GYMFLOW është një aplikacion Node.js me bazë të dhënash PostgreSQL. Punon në dy mënyra: në një server të vogël Linux që e kontrolloni ju, pas Caddy-t për HTTPS, ose i hostuar nga ne në infrastrukturë në BE. Fotot dhe logoja e klubit rrinë në bazën e të dhënave, kështu nuk ka skedarë veç për t'i ruajtur ose humbur.
DATABASE_URL=postgres://… SESSION_SECRET=… \ SEED_MODE=starter CLUB_NAME="My Club" \ ADMIN_EMAIL=owner@myclub.com ADMIN_PASSWORD=… \ npm start
Të dhënat fillestare. Nisja e parë me SEED_MODE=starter krijon pronarin, katër plane dygjuhëshe, katër produkte dhe tre anëtarë shembull qartësisht të shënuar, që asnjë ekran të mos jetë bosh derisa e mësoni. Fshijini shembujt sapo të hyjnë anëtarët e vërtetë. SEED_MODE=none fillon krejt bosh, dhe demo ndërton një klub të plotë shembull për prova.
Kopjet rezervë. Cilësimet → Të dhënat shkruan një kopje të çdo tabele, dhe mund ta shkarkoni nga i njëjti ekran. Mbani një kopje jashtë serverit. Në planin e hostuar baza ka edhe rikthim në pikë kohe, kështu një gabim mund të zhbëhet deri në minutë.
11. Zgjidhja e problemeve
Një anëtar nuk mund të hyjë
Arsyeja shfaqet në kartelën live të hyrjes dhe te Qasja & vizitorët: anëtarësi e skaduar ose e ngrirë, faturë e papaguar mbi shumën e lejuar, zonë ose mënyrë e gabuar për planin, jashtë orarit të qasjes, tashmë brenda (anti-passback), ose kufiri i vizitave i shterur. Rregulloni shkakun te profili, ose regjistrojeni hyrjen me dorë nga Qasja.
Email-at thonë "u anashkalua"
Ende nuk është lidhur asnjë kuti postare. Shkoni te Cilësimet → Email, ruani lidhjen SMTP dhe dërgoni mesazhin provë. Anëtarët prapë e marrin gjithçka në aplikacionin e tyre; mungon vetëm kopja me email.
Turnikja nuk reagon
Ekzekutoni komandën ping nga kompjuteri i urës. Një 401 do të thotë se çelësi është gabim ose pajisja është çaktivizuar. Asnjë përgjigje fare do të thotë adresa ose një mur zjarri. Rreshti i pajisjes te Cilësimet → Kontrolli i qasjes tregon kontaktin e fundit dhe vendimin e fundit.
Cili shfletues?
Çdo Chrome, Edge, Safari ose Firefox i tanishëm, në kompjuter ose telefon. Hapi me kamerë gjatë regjistrimit kërkon HTTPS, përveç kur punoni në localhost.
Provojeni në vend se ta lexoni
Klubi demo është i hapur, me anëtarë, kalendar dhe një muaj transaksione. Asgjë që bëni atje nuk prek një palestër të vërtetë.
Hap demon live →