Słownik pojęć¶

Definicje terminów — wyjaśnienie pojęć używanych w systemie Zajmij.to.

A¶

Activity (Aktywność)¶

Szablon zajęć grupowych — definicja zawierająca nazwę, opis, pojemność i cenę. Aktywność może mieć wiele sesji (ActivityItem).

Przykład: "Joga dla początkujących" to Activity, a "Joga w poniedziałek o 18:00" to ActivityItem.

ActivityItem (Sesja zajęć)¶

Konkretny termin zajęć — data, godzina, przypisany trener. Uczestnicy rezerwują miejsca na sesji, nie na aktywności.

Administrator¶

Użytkownik z pełnymi uprawnieniami do zarządzania systemem, wszystkimi organizacjami i konfiguracją.

Anulowanie¶

Odwołanie rezerwacji przez klienta lub system. Może wiązać się ze zwrotem płatności.

B¶

Blokada (Block)¶

Okres, w którym obiekt jest niedostępny do rezerwacji. Może być jednorazowa lub cykliczna.

Przykład: Blokada sali na remont od 1 do 15 marca.

BLIK¶

Polska metoda płatności mobilnych — 6-cyfrowy kod z aplikacji bankowej.

C¶

Cache¶

Pamięć podręczna przechowująca często używane dane dla szybszego dostępu. System używa cache z różnymi czasami ważności (TTL).

Category (Kategoria)¶

Klasyfikacja obiektów i zajęć — np. "Sport", "Kultura", "Edukacja". Ułatwia wyszukiwanie i filtrowanie.

Client (Klient)¶

Osoba lub firma dokonująca rezerwacji. Może być osobą fizyczną lub podmiotem z NIP.

Complaint (Reklamacja)¶

Zgłoszenie problemu przez klienta — może dotyczyć obiektu, zajęć lub płatności. Ma workflow: nowa → w trakcie → rozwiązana → zamknięta.

CRON¶

Harmonogram automatycznych zadań systemowych — np. wysyłka przypomnień, czyszczenie danych.

D¶

Dashboard¶

Panel główny z podsumowaniem najważniejszych informacji — statystyki, nadchodzące rezerwacje, alerty.

Deadline¶

Termin graniczny — np. deadline rezerwacji (do kiedy można się zapisać) lub deadline anulowania.

Domena (Domain)¶

W architekturze DDD — wydzielony obszar biznesowy systemu. System ma 31 domen (Reservation, Item, User, itp.).

E¶

Employee (Pracownik)¶

Użytkownik z uprawnieniami do zarządzania przypisanymi obiektami. Ma mniej uprawnień niż Supervisor.

Error (Błąd)¶

Zarejestrowany problem techniczny w systemie. Błędy są grupowane i śledzone dla diagnostyki.

F¶

Failed Job¶

Zadanie kolejki, które nie powiodło się po wszystkich próbach. Wymaga ręcznej interwencji lub analizy.

G¶

Gross (Brutto)¶

Cena zawierająca VAT. System przechowuje ceny netto i oblicza brutto na podstawie stawki VAT.

H¶

Health Check¶

Automatyczne sprawdzenie stanu systemu — połączenie z bazą, kolejki, miejsce na dysku.

I¶

Indeks (Index)¶

Struktura danych w bazie przyśpieszająca wyszukiwanie rekordów. System stosuje indeksy na kolumnach filtrowanych (is_active, status), sortowanych (created_at) i wyszukiwanych (email, name). Indeksy kompozytowe łączą kilka kolumn dla złożonych zapytań.

Item (Obiekt/Zasób)¶

Fizyczny obiekt do wynajęcia — sala konferencyjna, boisko, hala sportowa. Należy do organizacji.

J¶

Job (Zadanie)¶

Operacja wykonywana asynchronicznie w tle — np. wysyłka emaila, generowanie raportu. Nie blokuje użytkownika.

JWT¶

JSON Web Token — standard uwierzytelniania. System używa JWT do autoryzacji żądań API.

K¶

Kolejka (Queue)¶

Mechanizm przetwarzania zadań w tle oparty na bazie danych (tabela jobs). System ma 8 kolejek dla różnych typów operacji.

L¶

Legal Document (Dokument prawny)¶

Regulamin, polityka prywatności lub inne dokumenty wymagane prawnie. Mają automatyczne wersjonowanie.

M¶

Manager (Zarządca)¶

Pracownik odpowiedzialny za konkretny obiekt. Może zarządzać rezerwacjami i harmonogramem obiektu.

Media¶

Pliki multimedialne — zdjęcia obiektów i zajęć. System automatycznie tworzy miniatury i wersje webowe.

Middleware¶

Warstwa pośrednia przetwarzająca żądania HTTP — autoryzacja, transakcje, walidacja.

N¶

Net (Netto)¶

Cena bez VAT. System przechowuje ceny netto.

NIP¶

Numer Identyfikacji Podatkowej — polski numer podatkowy dla firm. System waliduje poprawność NIP.

Note (Notatka)¶

Wewnętrzna adnotacja widoczna tylko dla pracowników — przy kliencie, rezerwacji lub obiekcie.

Notification (Powiadomienie)¶

Automatyczna wiadomość do użytkownika — email z potwierdzeniem, przypomnienie, alert.

O¶

Omnibus¶

Dyrektywa UE wymagająca pokazywania najniższej ceny z ostatnich 30 dni. System automatycznie śledzi historię cen.

Organization (Organizacja)¶

Podmiot zarządzający obiektami — gmina, ośrodek kultury, centrum sportowe. Może mieć wielu pracowników.

OTP¶

One-Time Password — jednorazowy kod do logowania (6 cyfr, ważny 5 minut).

Observer¶

Wzorzec projektowy — klasa reagująca na zdarzenia modelu (tworzenie, aktualizacja, usuwanie).

P¶

Placeholder¶

Znacznik w szablonie dokumentu (np. {{client_name}}) zastępowany rzeczywistymi danymi.

Pricing (Cennik)¶

Definicja ceny za obiekt lub zajęcia — cena netto, stawka VAT, okres obowiązywania.

Przelewy24¶

Polska bramka płatności online obsługująca BLIK, przelewy i karty.

Q¶

Queue¶

Zobacz: Kolejka

R¶

REGON¶

Numer identyfikacyjny podmiotów gospodarczych w Polsce. System waliduje poprawność REGON.

Report (Raport)¶

Zestawienie danych analitycznych — rezerwacje, przychody, obłożenie. Generowany asynchronicznie jako CSV.

Reservation (Rezerwacja)¶

Zamówienie obiektu lub miejsca na zajęciach na określony termin. Ma status, płatność i powiązania.

Review (Opinia)¶

Ocena wystawiona przez klienta po rezerwacji — gwiazdki (1-5) i opcjonalny komentarz.

RODO¶

Rozporządzenie o Ochronie Danych Osobowych (GDPR) — europejskie prawo o prywatności danych.

Role (Rola)¶

Zestaw uprawnień przypisany użytkownikowi — Administrator, Supervisor, Employee.

S¶

Schedule (Harmonogram)¶

Widok kalendarza z dostępnością obiektu — dzienny, tygodniowy, miesięczny.

Session¶

Zobacz: ActivityItem

SIMC¶

System Identyfikatorów Miejscowości (część TERYT) — kody miejscowości w Polsce.

Slot¶

Pojedynczy przedział czasowy rezerwacji — np. 10:00-11:00.

Snapshot¶

Kopia danych zapisana w momencie tworzenia rezerwacji — zachowuje stan obiektu, cennika i klienta. Chroni przed utratą danych gdy powiązane rekordy zostaną zmodyfikowane lub usunięte.

Przykład: pricing_snapshot zawiera cenę jednostkową z momentu rezerwacji, nawet jeśli cennik został potem zmieniony.

Soft Delete¶

Usunięcie rekordu bez fizycznego kasowania — oznaczenie jako usunięty. Pozwala na odzyskanie.

Statistic (Statystyka)¶

Metryka obliczana w czasie rzeczywistym — liczba rezerwacji, przychód, średnia ocen.

Status Log¶

Historia zmian statusów encji — np. rezerwacja: nowa → potwierdzona → opłacona.

Supervisor¶

Użytkownik zarządzający przypisanymi organizacjami. Ma więcej uprawnień niż Employee.

T¶

TERC¶

Krajowy Rejestr Urzędowy Podziału Terytorialnego — kody województw, powiatów, gmin.

TERYT¶

Polski rejestr terytorialny GUS — oficjalne dane o jednostkach administracyjnych i miejscowościach.

Thumbnail¶

Miniatura zdjęcia — mniejsza wersja do wyświetlania w listach (np. 300×300 px).

Token¶

Ciąg znaków używany do autoryzacji (JWT) lub identyfikacji (refresh token, access code).

Trainer (Trener)¶

Instruktor prowadzący zajęcia — przypisywany do sesji ActivityItem.

Transaction (Transakcja)¶

Operacja bazodanowa wykonywana atomowo — albo cała się powiedzie, albo cała się cofnie.

TTL¶

Time To Live — czas ważności danych w cache (np. 5 minut, 1 dzień).

U¶

UUID¶

Universally Unique Identifier — unikalny identyfikator w formacie 550e8400-e29b-41d4-a716-446655440000. System używa UUID jako kluczy głównych.

V¶

VAT¶

Value Added Tax — podatek od towarów i usług. Polskie stawki: 23%, 8%, 5%, 0%, ZW, NP.

Validation (Walidacja)¶

Sprawdzanie poprawności danych wejściowych — np. format email, zakres dat, wymagane pola.

W¶

WebP¶

Format obrazów z dobrą kompresją. System konwertuje zdjęcia do WebP dla szybszego ładowania.

WebSocket¶

Technologia komunikacji w czasie rzeczywistym. System używa Laravel Reverb do WebSockets.

Workflow¶

Przepływ pracy — sekwencja stanów i przejść, np. workflow reklamacji: nowa → w trakcie → rozwiązana.

Z¶

Zwrot (Refund)¶

Oddanie środków klientowi po anulowaniu rezerwacji lub reklamacji. Może być automatyczny lub ręczny.