Dokumentacja Platformy gymo.com

v2.4.0

Kompleksowy przewodnik po wszystkich funkcjach i modułach systemu

📅 Aktualizacja: 2026-06-17📦 26 modułów🗄️ 25+ encji danych⚙️ 20+ funkcji backend

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

Plan1 miesiąc3 miesiące12 miesięcyOszczędność (rok)
Free0 EUR0 EUR0 EUR—
Gold29 EUR79 EUR (≈26/m)290 EUR (≈24/m)–58 EUR vs 12×m
VIP97 EUR259 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

Wersja / Version:
DostępneNiedostępnemax 5Limit ilościowy—Niedostępne w tym planie

🗓️ Wydarzenia (Events)

FunkcjaFreeGoldVIP
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 2bez 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—GoldVIP
Czas aktywnościbezterminowobezterminowobezterminowo
Cena0 złwkrótcewkrótce
Tagimax 1max 3max 5

📢 Ogłoszenia (Classifieds)

FunkcjaFreeGoldVIP
Publikacja ogłoszenia
Tytuł i opis
Kategoria, sporty, miasto
Cena (z walutą, negocjowalna)
Email kontaktowy (publiczny)
Czas aktywności30 dni60 dni90 dni
Zdjęcie główne
Strona www (1 link)
Telefon kontaktowy
Odznaka Gold
Widoczność na stronie sportu
Wyróżnienie ponad Free
Dodatkowe zdjęciamax 5
Wiele linków z nazwamimax 5
Wiele krajów (filtrowanie po kraju)
Widoczność na stronie głównej
Top placement ponad Gold
Odznaka VIP
Cena0 złwkrótcewkrótce
Tagimax 1max 3max 5

🏢 Katalog (Directory)

FunkcjaFreeGoldVIP
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śćbezterminowobezterminowobezterminowo
Tagimax 1max 3max 5
Cena0 złwkrótcewkró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)

Email

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.

We use essential cookies to make this site work. By continuing, you agree to our Cookie Policy and Privacy Policy.