REHAGYM to platforma SaaS do zarządzania centrum rehabilitacyjno-treningowym. System obsługuje trzy role użytkowników (administrator, trener, klient), zapewniając pełny cykl życia rezerwacji — od wyboru usługi i trenera, przez zarządzanie dostępnością, po śledzenie historii treningów i notatek klinicznych.

Główne moduły funkcjonalne

Frontend

Backend (BaaS)

Środowisko budowania

• Vite — bundler, HMR, szybki build
• Tailwind CSS PostCSS plugin z tailwindcss-animate
• Aliasy ścieżek: @/ → src/
• class-variance-authority (cva) — warianty komponentów
• clsx + tailwind-merge — bezpieczne łączenie klas

Wszystkie dane przechowywane są w bazie Base44. Każda encja ma wbudowane pola systemowe:id, created_date, updated_date, created_by.

Diagram zależności (uproszczony)

Atomy danych wrażliwych

• User.email — adres e-mail (PII)
• User.full_name — imię i nazwisko (PII)
• Trainer.phone — telefon kontaktowy trenera (PII)
• TrainingNote.content / recommendations / exercise_plan — dane zdrowotne / rehabilitacyjne (dane szczególne kategorii RODO Art. 9)
• Booking.notes — notatki klienta (mogą zawierać informacje zdrowotne)

Mechanizm sesji

System używa JWT-based session management zarządzanego przez platformę Base44. Token sesji jest wstrzykiwany przez platformę do parametrów aplikacji (appParams.token) i przekazywany do klienta SDK przy każdym żądaniu.

Przepływ autoryzacji

Ochrona routów

Każdy URL jest dostępny tylko po uwierzytelnieniu. Role są egzekwowane przez Sidebar (renderuje tylko menu przypisane do roli) oraz przez warunki w App.jsx (root route /przekierowuje do odpowiedniego dashboardu na podstawie user.role).

System implementuje trójpoziomowy RBAC (Role-Based Access Control) z rolami: admin trainer user

Kreator rezerwacji (BookingWizard) — 4-krokowy wizard

Algorytm kalkulacji przychodów (AdminAnalytics / AdminDashboard)

• Pobierz wszystkie Booking[] z bazy
• Grupuj po miesiącu: booking.date.slice(0, 7) → klucz YYYY-MM
• Sumuj booking.price dla każdej grupy miesięcznej
• Oblicz wzrost MoM: (currentMonth - prevMonth) / prevMonth * 100
• Filtruj: tylko opłacone (is_paid = true) dla "real revenue", wszystkie dla prognoz

Algorytm wydajności trenerów

• Dla każdego trenera zlicz bookings.filter(b => b.trainer_id === trainer.id)
• Sumuj przychody: bookings.reduce((sum, b) => sum + (b.price || 0), 0)
• Zlicz aktywnych klientów: unikalne b.user_id z ostatnich 30 dni
• Sortuj trendin: po liczbie sesji malejąco

Zarządzanie dostępnością trenera

• Trener tworzy TrainerAvailability (slot) z: date, start_time, end_time, max_clients
• Przy rezerwacji: booked_clients++ na slocie (optymistyczne, bez locka)
• Slot widoczny dla klientów tylko gdy: is_available=true AND booked_clients < max_clients AND date >= dziś
• Usunięcie slotu przez trenera: DELETE z ostrzeżeniem (slot może mieć istniejące rezerwacje)

Przypisanie trener–klient (TrainerClient)

• Admin tworzy rekord TrainerClient { trainer_id, user_id, status: "active" }
• Przy zmianie trenera: poprzedni rekord status → "inactive", nowy rekord CREATE
• Trener widzi klientów przez: TrainerClient.filter({ trainer_id: user.id, status: "active" })
• Historia: zachowane nieaktywne rekordy dla audytu

Anulowanie rezerwacji

• Booking.update({ status_id: cancelledStatusId })
• TrainerAvailability.update({ booked_clients: max(0, booked_clients - 1) })
• Dostępne tylko dla rezerwacji przyszłych (date >= dziś)

W obecnej wersji (v1.0) REHAGYM nie używa aktywnie AI w runtime aplikacji. AI zostało zastosowane na etapie tworzenia systemu oraz zostało przygotowane architektonicznie do przyszłej integracji.

AI na etapie developmentu

• Cały kod aplikacji wygenerowany przez AI (Base44 Agent) na podstawie specyfikacji funkcjonalnej
• Architektura encji, relacje i walidacje zaprojektowane przez AI zgodnie z wymaganiami domeny rehabilitacyjnej
• Automatyczne generowanie komponentów UI, logiki biznesowej i algorytmów analitycznych
• Iteracyjne poprawki i refactoring przez AI w odpowiedzi na feedback użytkownika

Przygotowanie infrastruktury dla AI (przyszłe wdrożenia)

Platforma integracji AI (Base44 Core)

• InvokeLLM — dostęp do GPT-4o-mini, Claude Sonnet, Gemini Pro przez jednolite API
• GenerateImage — generowanie obrazów (dokumentacja, materiały marketingowe)
• GenerateSpeech — synteza mowy (TTS) dla powiadomień głosowych
• TranscribeAudio — transkrypcja sesji audio/wideo (przyszłe notatki głosowe)
• ExtractDataFromUploadedFile — ekstrakcja danych z PDF/Excel (import historii klientów)

Warstwy ochrony

Potencjalne ryzyka i mitygacje

Brak implementacji (wymagane przed produkcją)

• Rate limiting na BookingWizard — ochrona przed spam-rezerwacjami
• Audit log dla operacji adminowych (kto i kiedy zmienił status/płatność)
• Two-Factor Authentication (2FA) — szczególnie dla konta admin
• Automatyczne wygasanie sesji po czasie bezczynności
• Content Security Policy (CSP) headers

Podstawa prawna przetwarzania

Prawa podmiotów danych

Dane szczególnych kategorii (Art. 9)

Retencja danych

Lokalizacja danych

• Wszystkie dane przechowywane na infrastrukturze Base44 (EU datacenter)
• Brak transferu danych do krajów trzecich poza EOG
• Backup i replikacja zarządzane przez Base44 (SLA 99.9%)

Hierarchia komponentów

Wzorce projektowe

Przepływ danych

• Dane pobierane przez useEffect + Promise.all() przy montowaniu komponentu
• Stan lokalny (useState) dla UI state (filtry, otwarte dialogi, edytowany rekord)
• Mutacje: bezpośrednie wywołanie base44.entities.*.create/update/delete + reload
• Real-time: base44.entities.*.subscribe() dostępne (nie używane w v1.0)
• @tanstack/react-query skonfigurowany (queryClientInstance) ale używany selektywnie