Przejdź do głównej zawartości

Wprowadzenie do systemu AcePark

Witaj w instrukcji obsługi systemu AcePark! 🎾

Niniejszy przewodnik został stworzony z myślą o użytkownikach panelu administracyjnego. Dokumentacja zawiera niezbędne informacje dotyczące zarządzania rezerwacjami, weryfikacji płatności oraz nawigacji po systemie.

👤 Instrukcja dla pracownika​

🎯 O systemie​

AcePark to kompleksowy system przeznaczony do zarządzania obiektami sportowymi. Główne moduły platformy obejmują:

  • Zarządzanie obiektem - obsługa kalendarza zajęć, dyspozycyjności trenerów oraz kortów.
  • Rezerwacje klientów - rejestracja na zajęcia indywidualne, grupowe i cykliczne turnusy (m.in. półkolonie).
  • Karty klientów - centralna baza danych uczestników, informacji kontaktowych oraz historii aktywności.
  • Rozliczenia i finanse - monitorowanie statusów płatności, wystawianie faktur oraz statystyki wpłat.
  • Komunikacja - zautomatyzowana wysyłka powiadomień SMS i e-mail (np. potwierdzenia rezerwacji, wezwania do zapłaty).

🚀 Rozpoczęcie pracy​

  1. Logowanie do systemu: Dostęp do panelu uzyskuje się poprzez stronę logowania, autoryzując się za pomocą służbowego konta e-mail (poprzez SSO Google lub tradycyjne dane uwierzytelniające).
  2. Nawigacja w panelu (Dashboard): Główne menu nawigacyjne znajduje się po lewej stronie ekranu. Umożliwia ono bezpośredni dostęp do kluczowych modułów, takich jak Kalendarz, Uczestnicy, Płatności, Zajęcia grupowe czy Półkolonie.
  3. Wyszukiwanie klientów: Wyszukiwarka globalna (dostępna w nagłówku lub w zakładce Uczestnicy) pozwala na szybkie odnalezienie klienta na podstawie imienia, nazwiska lub adresu e-mail.

📖 Struktura dokumentacji​

W menu bocznym dokumentacji wyszczególniono instrukcje do poszczególnych modułów. Zaleca się zapoznanie z poniższymi sekcjami:

  • Rodzaje zajęć – zasady funkcjonowania zapisów na zajęcia próbne, indywidualne oraz grupowe.
  • Odwoływanie zajęć – procedury obsługi rezygnacji, w tym mechanizmy zwrotów środków i odrabiania zajęć.
  • Płatności i finanse – interpretacja statusów transakcji oraz rejestracja płatności stacjonarnych.
  • Półkolonie – zarządzanie zapisami na turnusy oraz automatyzacja pozyskiwania opinii.
  • Powiadomienia systemowe – wykaz zautomatyzowanych komunikatów kierowanych do klientów.

W przypadku problemów technicznych, należy skontaktować się z działem wsparcia (support).

🛠️ Dokumentacja techniczna​

Poniższa sekcja przeznaczona jest dla programistów i deweloperów zajmujących się utrzymaniem i rozwojem systemu AcePark.

Stack Technologiczny​

System zbudowany jest w oparciu o nowoczesne technologie webowe:

  • Next.js 14 - React framework z App Router i Server Components
  • TypeScript - bezpieczne typowanie dla całej aplikacji
  • Cloudflare D1 - serverless baza danych SQLite
  • Auth0 - zaawansowana autoryzacja z rolami użytkowników (RBAC - Role-Based Access Control)
  • Tailwind CSS - responsywny design
  • Shadcn/ui - komponenty interfejsu (UI)
  • Recharts - interaktywne wykresy i wizualizacje danych
  • React Hook Form - zarządzanie formularzami i walidacja

Architektura​

System wykorzystuje architekturę serverless:

  • Frontend: Next.js 14 z React Server Components
  • Backend: Next.js API Routes + Server Actions
  • Database: Cloudflare D1 (SQLite)
  • Storage: Cloudflare R2 (do przechowywania plików np. grafik)
  • CDN: Cloudflare Pages / Workers

Środowisko deweloperskie (Rozpoczęcie pracy)​

# Klonowanie repozytorium
git clone https://github.com/DMT-Softwares/Acepark_Rezerwacje.git

# Instalacja zależności (zalecany yarn lub npm)
npm install

# Konfiguracja zmiennych środowiskowych
cp env.example.txt .env.local

# Uruchomienie w trybie deweloperskim
npm run dev

Wymagania:

  • Node.js 18.x lub nowszy
  • npm / yarn / pnpm
  • Konto Cloudflare (dla dostępu do D1 i R2)
  • Konto Auth0 (zarządzanie tożsamością)
  • Opcjonalne klucze API: Przelewy24, Fakturownia, SMSAPI / SendGrid

Dodatkowe zasoby i wsparcie techniczne​