Przejdź do głównej zawartości

Wprowadzenie

Witaj w dokumentacji systemu AcePark! 🎾

🎯 O systemie​

AcePark to nowoczesny, kompleksowy system zarządzania obiektami sportowymi, zaprojektowany specjalnie dla parktronic Acepark. System oferuje pełne wsparcie dla zarządzania rezerwacjami, klientami, pracownikami oraz finansami obiektu.

Główne funkcjonalności​

  • 🏢 Zarządzanie obiektem - kompleksowa administracja obiektami sportowymi
  • 📅 System rezerwacji - rezerwacje pojedyncze, grupowe i cykliczne serie
  • 👥 Zarządzanie użytkownikami - klienci, pracownicy, trenerzy
  • 💳 Płatności online - Przelewy24, karty płatnicze, portfele użytkownika
  • 📊 Analityka i raporty - szczegółowe statystyki i wykresy
  • 🔔 Powiadomienia - email i SMS z przypomnieniami
  • 🧾 Fakturownia - automatyczne generowanie faktur
  • 🌍 Wielojęzyczność - polski i angielski

🚀 Stack Technologiczny​

System zbudowany jest w oparciu o najnowsze 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
  • Tailwind CSS - nowoczesny, responsywny design
  • Shadcn/ui - wysokiej jakości komponenty UI
  • Recharts - interaktywne wykresy i wizualizacje
  • React Hook Form - zaawansowane formularze z walidacją

📖 Struktura dokumentacji​

📚 Dokumentacja
├── 📄 Wprowadzenie (jesteś tutaj)
├── 🎯 Rodzaje zajęć
│   ├── Przegląd widoku
│   └── Dodawanie i edycja
├── 🚫 Odwoływanie zajęć
├── 🔔 Powiadomienia systemowe
└── 🔧 Konfiguracja (wkrótce)

🏗️ Architektura​

System wykorzystuje architekturę serverless z następującymi komponentami:

  • Frontend: Next.js 14 z React Server Components
  • Backend: Next.js API Routes + Server Actions
  • Database: Cloudflare D1 (SQLite)
  • Storage: Cloudflare R2 dla plików
  • CDN: Cloudflare Pages/Workers
  • Auth: Auth0 z RBAC (Role-Based Access Control)

🎓 Rozpoczęcie pracy​

Dla użytkowników​

  1. Zaloguj się przez Auth0 (Google, email/hasło)
  2. Uzupełnij swój profil
  3. Przeglądaj dostępne zajęcia i dokonuj rezerwacji
  4. Zarządzaj swoimi płatnościami i fakturami

Dla deweloperów​

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

# Instalacja zależności
npm install

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

# Uruchomienie w trybie deweloperskim
npm run dev

Więcej informacji w pliku README.md.

🔧 Wymagania​

  • Node.js 18.x lub nowszy
  • npm lub pnpm
  • Konto Cloudflare (dla D1 i R2)
  • Konto Auth0
  • Klucze API: Przelewy24, Fakturownia, SMS (opcjonalne)

📚 Dodatkowe zasoby​

� Wsparcie techniczne​

W przypadku pytań, problemów lub sugestii:

Wersja dokumentacji: 1.0.0
Ostatnia aktualizacja: Październik 2025