Dokumentacja Platformy gymo.com
v2.4.0Kompleksowy przewodnik po wszystkich funkcjach i modułach systemu
Spis treści
💰 Aktualny Cennik
Ceny w EUR, aktualne na dzień 2026-06-17
🗓️ Wydarzenia (Events) — jednorazowy
Free
0 EUR
bezterminowo
Gold
29 EUR
jednorazowo / bezterminowo
VIP
97 EUR
jednorazowo / bezterminowo
📢 Ogłoszenia (Classifieds)
Free
0 EUR
30 dni
Gold
19 EUR
60 dni
VIP
49 EUR
90 dni
🏢 Katalog (Directory) — subskrypcja miesięczna / roczna
| Plan | 1 miesiąc | 3 miesiące | 12 miesięcy | Oszczędność (rok) |
|---|---|---|---|---|
| Free | 0 EUR | 0 EUR | 0 EUR | — |
| Gold | 29 EUR | 79 EUR (≈26/m) | 290 EUR (≈24/m) | –58 EUR vs 12×m |
| VIP | 97 EUR | 259 EUR (≈86/m) | 970 EUR (≈81/m) | –194 EUR vs 12×m |
* Ceny netto EUR. Billing: 1m, 3m, 12m. Bezterminowo = brak automatycznego wygasania.
💎 Porównanie Planów
Funkcje dostępne w każdym planie dla każdego serwisu
🗓️ Wydarzenia (Events)
| Funkcja | Free | Gold | VIP |
|---|---|---|---|
| Publikacja na kalendarzu | |||
| Podstawowe info (tytuł, daty, lokalizacja) | |||
| Sporty, sub-dyscypliny, typ, zakres, ranga | |||
| Kategoria (Sports / Educational / Other) | |||
| Kategorie wiekowe | |||
| Nazwa organizatora (publiczna) | |||
| Dane kontaktowe organizatora (prywatne, tylko admin) | |||
| Krótki opis (max 200 znaków) | |||
| Widoczność na stronie sportu | |||
| Widoczność w What's New (Home) | |||
| Zdjęcie główne + crop | |||
| Pełny opis (rich text / HTML) | |||
| Publiczny email organizatora | |||
| Strona www | |||
| Facebook, Instagram | |||
| Link do transmisji live (streaming) | |||
| Odznaka LIVE na liście | |||
| Terminy zgłoszeń (rejestracji) | max 2 | bez limitu | |
| Wyróżnienie ponad Free | |||
| Publiczny telefon organizatora | |||
| Twitter / X | |||
| Link rejestracji / zapisu (virtual_link) | |||
| Partnerzy i sponsorzy (z logotypami) | |||
| Pliki do pobrania | |||
| Galeria zdjęć | |||
| Dodatkowe linki z opisami | — | max 5 | |
| Widoczność na stronie głównej (top) | |||
| Odznaka na liście | — | Gold | VIP |
| Czas aktywności | bezterminowo | bezterminowo | bezterminowo |
| Cena | 0 zł | wkrótce | wkrótce |
| Tagi | max 1 | max 3 | max 5 |
📢 Ogłoszenia (Classifieds)
| Funkcja | Free | Gold | VIP |
|---|---|---|---|
| Publikacja ogłoszenia | |||
| Tytuł i opis | |||
| Kategoria, sporty, miasto | |||
| Cena (z walutą, negocjowalna) | |||
| Email kontaktowy (publiczny) | |||
| Czas aktywności | 30 dni | 60 dni | 90 dni |
| Zdjęcie główne | |||
| Strona www (1 link) | |||
| Telefon kontaktowy | |||
| Odznaka Gold | |||
| Widoczność na stronie sportu | |||
| Wyróżnienie ponad Free | |||
| Dodatkowe zdjęcia | max 5 | ||
| Wiele linków z nazwami | max 5 | ||
| Wiele krajów (filtrowanie po kraju) | |||
| Widoczność na stronie głównej | |||
| Top placement ponad Gold | |||
| Odznaka VIP | |||
| Cena | 0 zł | wkrótce | wkrótce |
| Tagi | max 1 | max 3 | max 5 |
🏢 Katalog (Directory)
| Funkcja | Free | Gold | VIP |
|---|---|---|---|
| Wpis w katalogu | |||
| Nazwa, typ, miasto, kraj | |||
| Sporty (tagi) | |||
| Widoczność w katalogu i stronie sportu | |||
| Krótki opis (max 200 znaków) | |||
| Logo | |||
| Facebook, Instagram, YouTube | |||
| Publiczny email | |||
| Odznaka Gold | |||
| Wyróżnienie ponad Free | |||
| Zdjęcie okładkowe (cover image) | |||
| Pełny opis (rich text / HTML) | |||
| Twitter / X, TikTok | |||
| Publiczny telefon | |||
| Rok założenia, liczba członków | |||
| Wiele krajów (filtrowanie po kraju) | |||
| Linki z nazwami | — | max 5 | |
| Widoczność na stronie głównej | |||
| Top placement ponad Gold | |||
| Odznaka VIP | |||
| Aktywność | bezterminowo | bezterminowo | bezterminowo |
| Tagi | max 1 | max 3 | max 5 |
| Cena | 0 zł | wkrótce | wkrótce |
gymo.com to kompleksowa platforma dla społeczności gimnastycznej i sportowej. System łączy trzy główne serwisy: Kalendarz Wydarzeń, Katalog Organizacji (Directory) oraz Ogłoszenia (Classifieds). Platforma obsługuje model subskrypcyjny (Free / Gold / VIP), integrację z bazą danych FIG (Fédération Internationale de Gymnastique), automatyczne wysyłki emaili, kampanie marketingowe z Magic Links oraz zaawansowany panel administracyjny.
Stack: React 18 SPA · Base44 BaaS · TanStack Query · Leaflet (mapy) · Shadcn/ui · TailwindCSS · Deno Deploy (backend functions) · Base44 SendEmail (e-mail, domena gymo.com) · Google Drive API (sync dokumentów) · OpenStreetMap Nominatim (geocoding). Autentykacja: Base44 Auth z JWT. Baza: Base44 Entities (NoSQL). Automatyzacje: Base44 Automations (scheduled + entity triggers).
Administrator (role: admin)
Pełny dostęp do panelu admina. Może zarządzać wszystkimi danymi, moderować treści, zarządzać użytkownikami, uruchamiać synchronizacje FIG, wysyłać kampanie emailowe, przeglądać statystyki i konfigurować system.
Użytkownik zalogowany (role: user)
Może dodawać i edytować własne wpisy (wydarzenia, ogłoszenia, wpisy do katalogu), aktualizować profil, przeglądać własne zgłoszenia. Nowe wpisy trafiają do moderacji (status: draft).
Gość (niezalogowany)
Może przeglądać aktywne treści, korzystać z wyszukiwania i filtrów, udostępniać strony. Dane kontaktowe organizatorów widoczne zgodnie z planem (Gold: email, VIP: telefon).
Hero z wyszukiwarką
Wyszukiwanie real-time po wydarzeniach, katalogu i ogłoszeniach. Wyniki sortowane: upcoming VIP > Gold > Free, następnie archiwalne. Autocomplete z ikonami i badge'ami pakietów.
Featured Event
Wyróżnione wydarzenie VIP (lub najbliższe upcoming) z miniaturą, datą, lokalizacją i flagą kraju.
Statystyki (StatTiles)
Liczba aktywnych wydarzeń i wpisów w katalogu — klikalne linki do pełnych list.
Blok Events z zakładkami
Cztery widoki: Live (trwające), Next 7d (najbliższy tydzień), Last 7d (ostatni tydzień), Next… (kolejne). Każdy wiersz pokazuje datę, tytuł, kraj, wszystkie sporty oraz badge kategorii (EDU/Other) i VIP.
What's New
9 najnowszych wpisów: 3 wydarzenia (EVENT/EDU/OTHER), 3 wpisy Directory, 3 ogłoszenia. Sortowane: VIP > Gold > Free, następnie po dacie dodania.
Directory i Classifieds
Sekcje z podglądem 5 najnowszych wpisów z obu serwisów.
SEO
Meta title/description, Open Graph, Twitter Cards, JSON-LD WebSite.
Lista chronologiczna
Wszystkie aktywne wydarzenia posortowane po dacie. Paginacja (load more). Każdy wiersz: data-tile, tytuł, kraj/miasto, sporty, badge kategorii (Sports/EDU/Other), ranga, status VIP/Gold.
Filtry
Wyszukiwanie tekstowe, rok, sport (wielokrotny), kraj, typ (physical/virtual/hybrid), zakres (regional/national/international), kategoria (Sports/Educational/Other — z opcją Other).
Aktywne filtry jako chipy
Wyświetlanie aktywnych filtrów jako usuwalnych tagów nad listą. Chip kategorii pokazuje emoji: 🏆/📚/📋.
URL params
Filtry zapisywane w URL — możliwość linkowania do przefiltrowanej listy.
Informacje podstawowe
Tytuł, zdjęcie główne (z crop), opis (HTML renderowany bezpiecznie), daty (wielodniowe), godzina, lokalizacja.
Kategoria wydarzenia
Badge kategorii: 🏆 Sports / 📚 Educational / 📋 Other. Ranga zawodów (bez błędnego prefixu WC).
Sporty i sub-dyscypliny
Lista wszystkich dyscyplin (TMP/TUM/DMT/RGI/RGG dla gimnastyki).
Terminy zgłoszeń (Deadlines)
Widoczne dla Gold i VIP — lista z typem terminu i datą.
Dane kontaktowe (plan-gated)
Nazwa organizatora: wszyscy. Email publiczny: Gold+. Telefon publiczny: VIP only.
Partnerzy i sponsorzy (VIP)
Sekcja z logotypami, kategoriami, linkami — tylko plan VIP.
Pliki do pobrania (VIP)
Dokumenty FIG lub własne — nazwy, opisy, linki.
Galeria zdjęć (VIP)
Grid zdjęć z powiększeniem.
Social media i linki
Website (Gold+), Facebook/Instagram (Gold+), Twitter (VIP), dodatkowe linki z opisami (VIP, max 5).
Udostępnianie i QR
ShareDialog: kopiowanie linku, Facebook, Twitter, LinkedIn, Email, QR kod.
Zgłaszanie błędów
EventReportDialog — typy: błąd, sugestia, pytanie, partnerstwo, inne. Pytanie/partnerstwo wymagają emaila.
Licznik wyświetleń
PageView entity — zliczany raz na sesję, widoczny w szczegółach dla adminów.
JSON-LD
Structured data: SportingEvent / EducationEvent / Event wg kategorii.
Informacje o sporcie
Nazwa, opis, zdjęcie, linki do Events/Directory/Classifieds dla danego sportu.
Sub-dyscypliny (TRA/RG)
Filtrowanie po TMP/TUM/DMT (TRA) lub RGI/RGG (RG).
Blok Events
Live/Next7d/Last7d/Next — tak jak na Home. Wszystkie sporty widoczne w wierszu.
What's New (6 wpisów)
2 wydarzenia + 2 Directory + 2 Classifieds dla danego sportu.
Directory i Classifieds
Wpisy powiązane ze sportem — posortowane wg pakietu.
Interaktywna mapa (Leaflet)
Markery dla wszystkich wydarzeń ze współrzędnymi. Popup z nazwą, datą, sportem, linkiem.
Filtry mapy
Nadchodzące/archiwalne, sport (multiwybór), państwo (autocomplete + autozoom), rok.
Typy wpisów
federation_international, federation_national, club, company, portal, influencer, association, other.
Filtry
Tekst, typ, sport, kraj — zwijane domyślnie na mobile.
Dane podstawowe (Free)
Nazwa, typ, miasto, kraj, tagi sportów.
Dane Gold
Krótki opis, logo, Facebook/Instagram/YouTube, publiczny email, odznaka Gold.
Dane VIP
Zdjęcie okładkowe, pełny opis HTML, Twitter/TikTok, telefon publiczny, rok założenia, liczba członków, wiele krajów, linki z nazwami (max 5).
Dane FIG (federacje)
Kod federacji, status członkostwa FIG, unia kontynentalna, dyscypliny FIG, prezes, sekretarz.
Prywatne dane kontaktowe
Imię/stanowisko/email/telefon kontaktu — widoczne tylko dla admina.
Typy ogłoszeń
sale (sprzedaż), job (praca), wanted (szukam), service (usługa), rental (wynajem), other.
Filtry
Tekst, typ, sport, kraj — zwijane domyślnie na mobile.
Czas aktywności
Free: 30 dni. Gold: 60 dni. VIP: 90 dni. Automatyczne wygasanie przez cron.
Dane Gold
Zdjęcie główne, strona www, telefon kontaktowy, odznaka Gold.
Dane VIP
Do 5 zdjęć, wiele linków z nazwami, wiele krajów, widoczność na stronie głównej.
FIG Index Sync
Pobieranie listy wydarzeń z kalendarza FIG (fig-gymnastics.com). Opcje: zakres dat, zakres ID, ręczne ID. Filtrowanie duplikatów po fig_id.
Typy FIG
sport (zawody), judge (kurs sędziowski → kategoria Educational), coach (kurs trenerski → Educational), admin (administracyjne → Other).
Detail Fetch + dokumenty
Pobieranie szczegółów każdego wydarzenia FIG: venue, kontakty, lista dokumentów (PDF, XLS). Upload dokumentów do Base44 storage.
FIG Event Row — Sync UI
Porównanie danych FIG vs lokalnych z możliwością kopiowania pól. Edycja: sport ID, ranga, wiek, sub-dyscypliny, scope, status, kategoria.
Linkowanie do Events
Każdy wpis FIGEventIndex może być powiązany z wydarzeniem w bazie (linked_event_id).
Google Drive Sync (GDriveSyncTab)
Automatyczne wysyłanie plików FIG do Google Drive. Tworzenie folderów według schematu: rok/dyscyplina/nazwa. Log uploadu w GDriveUploadLog.
FIG Logs (FIGSyncLogsTab)
Historia synchronizacji: index_sync i detail_fetch. Statystyki: processed, failed, lista błędów.
Bulk Repair Tab
Narzędzia masowe: backfill rozmiarów plików, naprawa lokalizacji FIG, regeneracja slugów.
Kategorie wydarzeń FIG
Mapowanie: judge/coach → Educational, admin → Other, sport → Sports. Widoczne w kolumnie tabeli FIG Index.
addCoordinatesToLocations
Backend function: automatyczne geocoding lokalizacji bez współrzędnych przez OpenStreetMap Nominatim. Sekwencyjne requesty z 1.2s opóźnieniem (rate limiting). Exponential backoff przy błędach 429.
CoordsSyncLog entity
Logowanie każdego uruchomienia: total_without_coords, updated, failed, updated_list (miasto/kraj/venue/lat/lon/typ zapytania), error_list.
Automatyzacja dzienna
Scheduled automation: codziennie o wybranej godzinie uruchamia synchronizację lokalizacji bez coords.
Plany
Free (0 zł), Gold (premium), VIP (premium+) — dla każdego z trzech serwisów: Events, Classifieds, Directory.
PlanSubscription entity
Rejestruje zakup: entity_type, entity_id, plan_type, status, starts_at, expires_at, price, currency, billing_period, payment_method, Stripe IDs, promo_code, granted_by.
Billing periods
one_time, monthly, 3_months, 6_months, 12_months. Events i Directory: bezterminowo. Classifieds: 1 i 12 miesięcy.
Zarządzanie adminowe
AdminPlans: lista subskrypcji z filtrami (typ/plan/status), ręczne nadawanie/cofanie planów, PlanSubscriptionDialog.
managePlanExpiry
Backend function (cron dzienny): automatyczne wygaszanie subskrypcji po upływie expires_at, aktualizacja package_type na encji.
AppConfig — ceny
Konfiguracja cen w panelu AdminSettings — edytowalna przez admina, wyświetlana w PricingCards na formularzach.
EntryPreviewPanel
Podgląd wpisu z wizualnym wskaźnikiem pól FREE/GOLD/VIP z kłódkami dla zablokowanych poziomów.
EmailCampaign
Kampanie do segmentowanych odbiorców. Typy audytorium: all_events, events_by_sport, events_by_country, all_federations, federations_by_sport, all_clubs, all_companies, all_directory, fig_contacts, custom_emails.
AudienceBuilder
Sekwencyjny 3-krokowy builder: 1. Serwis (Events/Directory/Classifieds/FIG) → 2. Kategoria → 3. Sport / Kraj. Filtrowanie po kraju: exact string match.
Magic Links w kampanii
Opcja include_magic_link: unikalne linki per kampania (nie per odbiorca). Target: event, directory_entry, none.
sendEmailCampaign
Backend function: zbiera emaile z wielu źródeł (Events, Directory, Classifieds, FIG) z deduplikacją. Wysyłka przez Base44 SendEmail (domena gymo.com). Log do EmailSendLog.
EmailSendLog
Każda wysłana wiadomość: kampania, odbiorca, status (sent/failed/bounced), timestamp, tracking open/click.
emailTrackHandler
Backend function: tracking otwarć (pixel 1x1) i kliknięć (redirect). Aktualizuje EmailSendLog i EmailCampaign counters.
EmailMarketingTemplate
Szablony HTML z zmiennymi ({{name}}, {{event_title}} itp.), kategoryzowane: acquisition/notification/newsletter/invitation/other.
AdminEmailLogs
Przegląd wysłanych emaili z filtrem kampanii (searchable dropdown) i filtrem statusu (np. tylko te z wizytami MagicLink).
MagicLink entity
Unikalny token URL (/magic/:token). Powiązany z: kampanią emailową, adresem email odbiorcy, docelową encją (event/directory_entry).
magicLinkHandler
Backend function: weryfikacja tokenu, identyfikacja encji docelowej, zwrot danych encji do formularza pre-fill.
MagicLinkLanding
Strona /magic/:token: intro section z wyjaśnieniem, formularz pre-filled danymi encji. Zmiany zapisywane jako draft do zatwierdzenia przez admina.
AdminMagicLinks
Lista linków z oddzielnymi kolumnami: visit_count, last_visit_at. Filtrowanie po kampanii (searchable dropdown).
EventReport entity
Źródło: issue (błąd na wydarzeniu) lub contact (formularz kontaktowy). Typy: error, suggestion, question, partnership, other.
ContactWidget
Pływający widget dostępny na każdej stronie serwisu. Formularz w języku angielskim. Pytanie/partnerstwo wymagają emaila.
EventReportDialog
Dialog zgłaszania błędów bezpośrednio ze strony wydarzenia.
AdminReports
Dashboard zgłoszeń posortowany: New → In Progress → Resolved → Rejected. Domyślny filtr: pending (new + in_progress). Zmiana statusu, notatki admina, przejście do zgłoszonej strony.
reporter_name
Opcjonalne pole imienia zgłaszającego w formularzu kontaktowym.
AdminStatistics
Multi-metryczne karty KPI: nowe wpisy ostatnie 48h (events/classifieds/directory), wyświetlenia, zgłoszenia. Wykresy aktywności.
AdminAnalytics
PageView analytics: wyświetlenia per encja, per dzień, top 10 treści, rozkład geograficzny.
PageView entity
Każde wyświetlenie: entity_type, entity_id, entity_title, entity_slug, country, viewed_at, viewed_date.
AdminSearchStats
Analiza zapytań wyszukiwania: najczęściej szukane frazy, brak wyników.
Konfiguracja email raportów
Pole report_email w AppConfig — adres odbiorcy codziennych raportów systemowych.
Ręczne uruchomienie raportu
Przycisk 'Send Report Now' — wywołuje sendDailyReport bez czekania na cron.
Cennik (AppConfig)
Edytowalne ceny planów dla każdego serwisu — wyświetlane dynamicznie w PricingCards.
Harmonogram
Cron: codziennie o 05:00 czasu warszawskiego.
Zawartość raportu
KPI: nowe wpisy, aktywne events/classifieds/directory, FIG items do uzupełnienia. Aktywność 48h: nowe zgłoszenia kontaktowe, synchronizacje FIG, uploady GDrive.
Dostarczanie
Wysyłka przez Base44 SendEmail (domena gymo.com). Odbiorca konfigurowany przez AppConfig (klucz: daily_report_email).
FIGAthlete entity
Profil atlety FIG: fig_id, imię/nazwisko, kraj (IOC code), płeć, rok urodzenia, dyscypliny, klub, bio, kamienie milowe, języki, hobbies, zdjęcie.
syncFIGAthletes
Backend function: pobieranie listy atletów z FIG, batch processing po 10 rekordów.
parseAthleteMarkdown / uploadAthleteScrapedData
AI-parsowanie scraped HTML → ustrukturyzowane dane bio. Upload do storage.
FIGImportBatch
Entity śledząca postęp importu: processed/created/updated/skipped/failed z progress_percent i current_message.
syncFIGCalendar / syncFIGIndex
Synchronizacja kalendarza FIG: pobieranie listy eventów, parsowanie HTML, zapis do FIGEventIndex.
syncFilesToGDrive
Upload dokumentów FIG do Google Drive. Autoryzacja przez OAuth connector (googledrive). Tworzenie struktury folderów.
sendEmail
Wysyłka pojedynczego e-maila przez Base44 SendEmail (domena gymo.com). Parametry: to, subject, html lub template_name, text, from_name, category.
sendEmailCampaign
Masowa wysyłka kampanii. Zbiera emaile, deduplikuje, wysyła batch, tworzy MagicLinks, loguje do EmailSendLog.
sendDailyReport
Generuje i wysyła HTML raport dzienny na adres z AppConfig (daily_report_email) przez Base44 SendEmail.
sendDirectoryApprovalEmail
Email powiadomienie do organizatora o zatwierdzeniu wpisu w Directory.
magicLinkHandler
Obsługa /magic/:token — weryfikacja, pre-fill danych, zapis zmian jako draft.
addCoordinatesToLocations
Batch geocoding Nominatim z rate limiting 1.2s/request, exponential backoff, logowanie do CoordsSyncLog.
generateEventSlugs / generateSlugs
Automatyczne generowanie przyjaznych URL slugów dla wydarzeń i państw.
managePlanExpiry
Cron dzienny: wygaszanie subskrypcji po expires_at, aktualizacja package_type.
repairFIGDocuments / fetchDocumentSizes
Naprawianie i uzupełnianie metadanych dokumentów FIG (oryginalne URL, rozmiary plików).
fixFIGEventLocations
Jednorazowa naprawa przypisań lokalizacji do wydarzeń FIG.
importFederations / updateFederationsSports
Import i aktualizacja danych federacji FIG do Directory.
parseAthleteMarkdown / uploadAthleteScrapedData
AI-parsowanie profili atletów FIG + upload scraped danych.
generateEmailTemplate
AI-generowanie szablonów emaili na podstawie opisu.
emailTrackHandler
Tracking otwarć (pixel) i kliknięć linków w emailach kampanijnych.
resendWebhook
Nieaktywny — odbiornik zdarzeń dawnego dostawcy (Resend). Statusy wysyłki są dziś zapisywane bezpośrednio przez sendEmail/sendEmailCampaign.
sitemap
Dynamiczny sitemap.xml dla SEO: wszystkie aktywne wydarzenia, Directory i Classifieds.
testCoordinates
Testowy endpoint geocodingu — sprawdzenie zapytania Nominatim bez zapisu.
syncFIGAthletes / parseAthleteMarkdown / uploadAthleteScrapedData
Pipeline importu danych atletów FIG: scraping → AI parsing → baza danych.
Event
Główna encja wydarzeń: 60+ pól. RLS: read=active lub submitted_by lub admin; update/delete=submitted_by lub admin.
FIGEventIndex
Indeks wydarzeń FIG: fig_id (unique), fig_type, detail_fetched, documents[], documents_count, total_files_size, has_invitation/regulations/workplan itp.
FIGSyncLog
Logi synchronizacji FIG: index_sync / detail_fetch, processed/failed, events_processed[].
FIGAthlete
Profil atlety FIG z bio, foto, klubem, dyscyplinami.
FIGImportBatch / FIGImportLog
Śledzenie postępu importu atletów FIG.
GDriveUploadLog
Log uploadów do Google Drive: fig_event_id, file_url, gdrive_file_id, gdrive_folder_id, status, triggered_by.
CoordsSyncLog
Log geocodingu: total/updated/failed + listy ze szczegółami.
DirectoryEntry
Wpis katalogu organizacji. RLS jak Event.
Classified
Ogłoszenie. Pole expires_at — auto-wygasanie przez cron.
PlanSubscription
Subskrypcja planu: entity_type/id, plan_type, billing_period, Stripe IDs, granted_by.
AppConfig
Konfiguracja serwisu: key/value/label. Używana dla cen, emaila raportów, GA ID.
EmailCampaign
Kampania emailowa z audience_filters, Magic Link config, statystykami (sent/delivered/opened/clicked/bounced).
EmailSendLog
Log każdego wysłanego emaila z statusem i tracking.
EmailMarketingTemplate
Szablon HTML emaila z zmiennymi.
MagicLink
Jednorazowy/wielokrotny link z tokenem, visit_count, last_visit_at.
EventReport
Zgłoszenie (issue/contact): typy, opis, email zgłaszającego, status, notatki admina.
PageView
Wyświetlenia encji: entity_type/id/title/slug, country, viewed_at, viewed_date.
Sport / AgeCategory / CompetitionRank / DeadlineType
Słowniki: dyscypliny sportowe, kategorie wiekowe, rangi zawodów, typy terminów zgłoszeń.
Location / Country
Lokalizacje (z GPS) i baza państw (IOC codes, flagi, slegi PL/EN).
Partner / PartnerCategory
Baza partnerów/sponsorów z kategoriami (Gold Sponsor, Partner itp.).
LegalPage
Strony prawne (regulamin, polityka prywatności, GA ID) — edytowalne przez admina.
SearchLog
Logi zapytań wyszukiwania dla AdminSearchStats.
Codzienny raport systemowy
Scheduled: codziennie 05:00 Warsaw → sendDailyReport. Wysyła HTML raport KPI na report_email.
Wygaszanie planów subskrypcji
Scheduled: codziennie → managePlanExpiry. Aktualizuje status expired + package_type na encji.
Synchronizacja współrzędnych
Scheduled: codziennie → addCoordinatesToLocations. Geocoding lokalizacji bez GPS.
Google Drive webhook
Connector: googledrive changes → syncFilesToGDrive. Real-time sync dokumentów FIG.
Frontend
React 18, Vite, TailwindCSS, Shadcn/ui, Framer Motion, Lucide Icons, React Router v7
Data Fetching
TanStack Query v5 (caching, background refetch, optimistic updates)
Mapa
React Leaflet 4, OpenStreetMap tiles
Backend
Base44 BaaS Platform, Deno Deploy (edge functions)
Baza danych
Base44 Entities (NoSQL, real-time subscriptions)
Autentykacja
Base44 Auth (JWT, Google OAuth, Apple OAuth, Email OTP)
Base44 SendEmail (transakcyjne + kampanie) z domeny gymo.com, tracking otwarć/kliknięć
Geocoding
OpenStreetMap Nominatim API (rate-limited, sequential)
Storage
Base44 Core Integration (upload/download plików)
Google Drive
Google Drive API przez OAuth connector (BaaS shared)
AI / LLM
Base44 Core InvokeLLM (GPT-4o-mini domyślnie, opcjonalnie Claude/Gemini)
Płatności
Stripe (przygotowane pola w PlanSubscription, integracja w roadmap)
generateDirectoryEntries function
Backend function: AI-generowanie wpisów katalogu na podstawie promptu tekstowego lub przesłanego pliku (CSV, XLSX, PDF, obraz). Wykorzystuje InvokeLLM z modelem automatic (GPT-4o-mini). Ekstrakcja danych: nazwa, typ, kraj, miasto, sporty, opis, kontakt.
AIGenerationLog entity
Logowanie każdego procesu generowania: service (directory/event/classified), prompt, file_url, file_name, status (pending/processing/completed/failed), suggestions_count, added_count, suggestions[], added_entry_ids[], error_message, triggered_by (email admina), completed_at.
AIDirectoryGenerator component
Panel w AdminDirectory: textarea na prompt + upload pliku. Podgląd sugestii AI w kartach z możliwością dodania pojedynczego wpisu (jako draft) lub dodania wszystkich naraz. Walidacja duplikatów po nazwie + kraju.
AIGeneratorLogsTab component
Zakładka w AdminDirectory z historią generowania: filtr po statusie i serwisie, podgląd sugestii, liczniki (wygenerowane/dodane), przycisk 'Add all to draft' do masowego dodawania, progress bar podczas przetwarzania, przycisk 'Reset stuck state' dla zawieszonych procesów.
Bulk processing
Dodawanie wszystkich sugestii naraz z progress trackingiem. Sprawdzenie istniejących wpisów przed utworzeniem (name + country normalization). Progress bar aktualizowany w czasie rzeczywistym.
Prompt i załączniki
Możliwość użycia samego promptu tekstowego lub przesłania pliku z danymi (lista klubów, federacji, kontaktów). AI ekstrahuje strukturyzowane dane z nieustrukturyzowanych dokumentów.
Draft status
Wszystkie wygenerowane wpisy trafiają jako draft do moderacji. Admin musi zatwierdzić wpis przed publikacją (zmiana statusu na active).
Walidacja duplikatów
Przed dodaniem wpisu sprawdzane jest czy istnieje już wpis o tej samej nazwie w tym samym kraju. Zduplikowane wpisy oznaczane jako 'added: false' w logach.
TagCategory entity
Kategorie tagów: name, name_en, slug, description, status (active/draft/inactive), services (event/directory/classified), order. Przykłady: Event Format, Skill Level, Specialized Services.
Tag entity
Tagi: name, name_en, slug, category_id, description, status, services (event/directory/classified), color (hex), order. Każdy tag może należeć do kategorii i być przypisany do jednego lub wielu serwisów.
AdminTags panel
Zarządzanie tagami i kategoriami: dwie zakładki (Kategorie/Tagi), filtrowanie po serwisie, wyszukiwanie, CRUD (dodawanie, edycja, usuwanie). Licznik tagów w każdej kategorii.
Service-aware tags
Tagi mogą być przypisane do konkretnych serwisów (event/directory/classified). Filtr serwisu w AdminTags pokazuje tylko tagi/kategorie dla wybranego serwisu.
TagSelector component
Komponent używany w formularzach dodawania/edycji wpisów. Wyświetla tagi pogrupowane kategoriami. Blokuje wybór po przekroczeniu limitu planu.
Limity tagów wg planu
Free: 1 tag. Gold: 3 tagi. VIP: 5 tagów. Limity egzekwowane w formularzach (AddEvent, AddClassified, AddDirectoryEntry) oraz w admin panelu (EventFormDialog, ClassifiedEditDialog, DirectoryEditDialog). Informacja o limitach widoczna w PricingCards i PlanComparisonTables.
Wyszukiwanie po tagach
Funkcja searchSuggestions zwraca tagi i kategorie z liczbą wpisów. Używane w Home search autocomplete i filtrach na stronach Events/Directory/Classifieds.
Wyświetlanie tagów
Tagi widoczne na kartach wydarzeń/ogłoszeń/wpisów Directory oraz na stronach szczegółów. Kolor tagu zdefiniowany w entity (hex color). Filtrowanie list po tagach przez URL params.
Dla organizatorów wydarzeń
1. Zaloguj się lub zarejestruj. 2. Kliknij + (Dodaj) w nawigacji. 3. Wybierz plan i wypełnij formularz. 4. Wyślij — event trafia do moderacji (draft). 5. Po zatwierdzeniu przez admina pojawia się na kalendarzu. Formularz ma PricingCards z opisem funkcji każdego planu.
Dla uczestników
1. Przeglądaj Home → Events lub użyj wyszukiwarki. 2. Filtruj po sporcie, kraju, kategorii. 3. Kliknij wydarzenie aby zobaczyć szczegóły. 4. Udostępnij przez ShareDialog lub zgłoś błąd przez ContactWidget/EventReportDialog.
Dla administratorów
1. Zaloguj się jako admin → Panel Admin. 2. Moderuj nowe wpisy (zmień draft → active). 3. Zarządzaj FIG Sync (nowe eventy z FIG). 4. Wysyłaj kampanie emailowe (AdminEmailMarketing). 5. Sprawdzaj raporty kontaktowe (AdminReports). 6. Przeglądaj statystyki (AdminStatistics/Analytics). 7. Uruchamiaj narzędzia masowe (geocoding, slugi, naprawa dokumentów). 8. Zarządzaj tagami w AdminTags.
Dokumentacja v2.4.0 — 2026-06-17
Wszystkie opisane funkcje są zaimplementowane i działają produkcyjnie.