Centrum pomocy

Instrukcje obsługi per rola oraz pełna dokumentacja prawna hovera. Dostępne bez logowania, w 5 językach.

Instrukcja obsługi Dokumentacja prawna
Ostatnia aktualizacja: 2026-05-23

Instrukcja obsługi systemu hovera

Witaj w hovera. Ten przewodnik prowadzi Cię przez wszystkie funkcje panelu właściciela stajni. Większość kroków zaczyna się od głównej nawigacji w panelu klienta /app.

1. Pierwsze kroki

Po zalogowaniu trafiasz na panel /app. Po lewej stronie masz nawigację podzieloną na grupy:

Na początek zalecamy:

  1. Ustawienia stajni — uzupełnij dane firmy, branding, godziny pracy
  2. Budynki — utwórz przynajmniej jeden ("Stajnia główna")
  3. Boksy — przypisz każdy do budynku
  4. Cennik pensji — zdefiniuj usługi (siano, sprzątanie boksu, transport)
  5. Instruktorzy + Ujeżdżalnie — żeby kalendarz mógł przyjmować rezerwacje

2. Ustawienia stajni

Ścieżka: /app/tenant-settings

Sekcje formularza:

Przykład:

Pole Wartość
Nazwa Stajnia "Pod Lipami"
Tagline Pensjonat, lekcje, rekreacja od 1995
Godziny otwarcia Pn–Pt 9:00–20:00 · Sob–Nd 8:00–18:00
Min. wyprzedzenie 4 godziny
Max horyzont 30 dni

3. Konie

Ścieżka: /app/horses

Dodawanie konia

Klik "Utwórz koń" → wypełnij:

Po zapisie koń trafia na listę. Kolumny: Imię, Rasa, Płeć, Maść, Wiek, Właściciel.

Karta konia (zakładki)

4. Boksy i budynki

Budynki — /app/buildings

1 stajnia (jako miejsce) może mieć kilka budynków: "Stajnia czerwona", "Stajnia nowa", "Pawilon padokowy". Każdy budynek to grupa boksów.

Pola: nazwa, kolejność, aktywny.

Boksy — /app/boxes

Pola formularza: budynek, nazwa/numer, krótki kod (np. "12"), typ (wewnętrzny / padok / zewnętrzny / kwarantanna), rozmiar (m²), miesięczna cena pensji, aktywny.

Kolumny tabeli:

Przykład struktury:

Budynek "Stajnia czerwona"
  ├ Box 1 — wewnętrzny — Wolny
  ├ Box 2 — wewnętrzny — Zajęty (Klacz "Łucja")
  └ Box 3 — wewnętrzny — Zajęty (Wałach "Bucefał")

Budynek "Padok wschodni"
  ├ Pad 1 — padok — Wolny
  └ Pad 2 — padok — Zajęty (Ogier kryjący "Tytan")

5. Klienci

Ścieżka: /app/clients

Dodawanie klienta

Karta klienta

Po wejściu w Edytuj widzisz:

6. Kalendarz

Plan dnia — /app/calendar

Widok dnia z grupowaniem per instruktor/ujeżdżalnia. Kliknij pusty slot żeby dodać rezerwację. Kliknij wpis żeby edytować/usunąć.

Rezerwacje — /app/calendar-entries

Pełna tabela rezerwacji. Filtry: typ, status, koń, instruktor, "tylko nadchodzące".

Statusy: Zgłoszone (oczekuje na potwierdzenie) → Potwierdzone → Zakończone / Odwołane / Nieobecność.

Typy rezerwacji: Jazda indywidualna, Jazda grupowa, Trening, Opieka (wet/kowal), Wydarzenie, Blokada.

Cykliczne zajęcia — /app/recurring-calendar-entries

Tworzy serię (np. "Szkółka pon. 17:00, co tydzień, do końca roku"). Action "Wygeneruj wystąpienia" rozkłada serię na pojedyncze rezerwacje (max 365 jednorazowo).

7. Specjaliści (kowale + weterynarze)

Ścieżka: /app/specialists

Lista zewnętrznych kontrahentów oraz pracowników stajni którzy podkuwają / leczą konie.

Dodawanie

Powiązanie z wpisami zdrowotnymi

Przy tworzeniu HR (/app/health-records) wybierz typ:

W tabeli HR kolumna "Wykonał" pokazuje imię specjalisty zamiast pustego pola.

8. Pracownicy stajni

Ścieżka: /app/team-members (widoczne tylko dla owner / admin)

Dodawanie pracownika

Klik "Dodaj pracownika" → wpisz:

System automatycznie:

Role

Rola Opis
Właściciel Pełen dostęp
Admin j.w. minus usuwanie stajni
Manager Zarządzanie kalendarzem, fakturami
Instruktor Kalendarz, rezerwacje, swoje konie
Pracownik Activity log (karmienie, sprzątanie)
Weterynarz Powiązanie ze specjalistą + Moje zadania
Tylko podgląd Read-only

Reset hasła

Action "Wyślij link resetu hasła" (klucz przy aktywnym pracowniku) — wysyła email z linkiem do /app/password-reset/request. Link wygasa po 60 minutach.

9. Faktury

Konfiguracja — /app/invoicing-settings

Wystawianie — /app/invoices

  1. Klik "Utwórz" → wybierz klienta (auto-fill danych nabywcy)
  2. Dodaj pozycje (Repeater): nazwa, ilość, jedn., cena netto, VAT
  3. Save → status Draft → klik "Wystaw" → numer i data
  4. Klik "Wyślij na e-mail" → klient dostaje link do publicznego widoku (z opcją "Zapłać teraz" jeśli masz aktywną bramkę online)
  5. Klik "Wyślij do KSeF" (jeśli KSeF skonfigurowany) → podpis + wysyłka

Korekty

Klik "Korekta" na zaksięgowanej fakturze → tworzy draft korekty z zerowymi pozycjami; uzupełnij ilości "po zmianie" → wystaw.

10. Płatności online — /app/payment-settings

Wybierz domyślną bramkę:

Po skonfigurowaniu, każda wystawiona FV ma w mailu przycisk "Zapłać teraz".

11. KSeF (e-faktury) — /app/ksef-settings

Wymagane:

Po wgraniu wystawiona FV ma akcję "Wyślij do KSeF" — uwierzytelnienie certyfikatem + wysyłka XML.

12. Strona publiczna i widgety embed

Strona publiczna — https://app.hovera.app/s/{slug}

Renderuje się automatycznie na podstawie sekcji "Strona publiczna" z /app/tenant-settings. Kolor wiodący, logo, hero image, opis, godziny otwarcia, kontakt, social media. Opcjonalnie: lista instruktorów, cennik pensji, dostępność boksów.

Embed widgety

W /app/tenant-settings → sekcja "Widgety" — gotowe iframe-y do wklejenia w Wordpress / Squarespace / własna strona WWW:

13. Portal klienta

Klient loguje się przez https://app.hovera.app/s/{slug}/portal/login:

Z poziomu /app/clients/{id} możesz wygenerować link manualnie (do SMS/Messenger) lub wysłać mailem (akcja "Wyślij link na e-mail").

W portalu klient widzi:

14. Dashboard "Dziś" — /app

Po zalogowaniu na górze widzisz 4 kafelki:

Pod nimi tabela dzisiejszych aktywnych rezerwacji (godzina · koń · instruktor · manaż · status).

15. Szablony zabiegów — /app/treatment-templates

Predefiniowane preset'y do wpisów opieki — jeden klik wypełnia typ, opis i sugerowany termin następnej wizyty na podstawie interval_days.

Każdy nowy tenant dostaje 6 standardowych: szczepienie tężec/grypa (rocznie), EHV (półrocznie), odrobaczanie (3 mies.), kucie (6 tyg.), dentysta (rocznie), kontrola wet. (półrocznie). Możesz je edytować, dezaktywować lub dodać własne.

W formularzu nowego wpisu w Opieka i zdrowie pojawia się select „Szablon zabiegu" — wybór auto-fill type/summary/details/next_due_at.

16. Karta wagi konia — tab w karcie konia

Wpisuj pomiary co miesiąc (waga w kg + opcjonalnie obwód klatki). Kolumna „Zmiana" porównuje z poprzednim pomiarem: 🟢 przyrost, 🟡 spadek, ⚪ stabilnie (różnica < 5 kg).

17. Plan żywienia — tab w karcie konia

CRUD: pora dnia (rano/południe/wieczór/noc), pasza, ilość, notatki. Klient widzi plan w portalu w sekcji „Plan żywienia" karty konia (read-only).

18. Magazyn paszy — /app/feed-inventory

Lista pozycji paszowych ze stanem (SUM(delta)) i progiem alertu. Akcja „+ Ruch magazynowy" dodaje wpis (przyjęcie / wydanie / korekta / odpis); znaki ruchu wyliczane automatycznie. Karta pozycji ma tab Historia ruchów (audit log). Pozycje poniżej progu pokazują się z liczbowym badge'em w sidebarze.

19. Galeria zdjęć konia — tab w karcie konia

Upload JPG/PNG/WEBP/HEIC do 10 MB. Klient widzi grid w portalu (kafle 1:1, lightbox). Osobno od dokumentów (paszporty / polisy zostają w tabie „Dokumenty").

20. Eksport .ics instruktora

W Stajnia → Instruktorzy akcja „Kalendarz .ics" w wierszu → modal z URL feedu. Wklej w Google Calendar / Outlook / Apple jako „Dodaj kalendarz przez URL". Lekcje synchronizują się co kilka godzin. Window: 6 mies. wstecz + 12 wprzód. Anulowane lekcje = STATUS:CANCELLED.

21. Raporty — grupa nawigacji „Raporty"

4 strony miesięczne (z pickerem miesiąca):

22. Bulk invoicing — /app/bulk-invoicing

Masowe generowanie FV Draft za miesiąc dla wszystkich klientów na podstawie aktywnych usług pensji ich koni (Daily × dni miesiąca, Monthly × quantity).

  1. Wybierz miesiąc (default: poprzedni),
  2. Sprawdź podgląd (per-client lista pozycji + sumy),
  3. Zaznacz klientów lub zostaw wszystkich,
  4. Generuj Drafty → tworzy Draft Invoice per client.

Karnety pomijane (mają auto-FV przy sprzedaży). Każdą Draft zatwierdzasz osobno w Faktury → Wystaw (numer + KSeF + mail).

23. Self-booking klienta w portalu

Klient po zalogowaniu klika „+ Zarezerwuj lekcję" → wybiera swojego konia, instruktora, dzień + slot z dostępnych → submit. W panelu stajni rezerwacja pojawia się ze statusem Oczekuje + metadata.source = client_portal. Potwierdzasz tak samo jak inne rezerwacje.

24. Co widzi która rola — matryca uprawnień

Sidebar i strony są filtrowane wg roli pracownika. Vet nie zobaczy faktur i karnetów, pracownik nie zobaczy ustawień stajni — zminimalizowany widok = mniejsze ryzyko pomyłki i jaśniejszy interfejs.

Sekcja owner admin manager trener pracownik vet viewer
Konie · Opieka i zdrowie · Plan dnia · Rezerwacje ✓ ✓ ✓ ✓ ✓ ✓ ✓
Klienci ✓ ✓ ✓ ✓ — — ✓
Boksy · Cennik pensji · Budynki · Cykliczne · Instruktorzy · Manaże ✓ ✓ ✓ ✓ — — ✓
Specjaliści · Szablony zabiegów ✓ ✓ ✓ — — ✓ ✓
Magazyn paszy ✓ ✓ ✓ — ✓ — ✓
Faktury · Karnety · Raporty ✓ ✓ ✓ — — — ✓
Bulk invoicing ✓ ✓ ✓ — — — —
Ustawienia (stajni · FV · KSeF · Płatności) · Pracownicy ✓ ✓ — — — — —
Moje zadania — — — — — ✓ —
Pomoc ✓ ✓ ✓ ✓ ✓ ✓ ✓

Master admin (zewnętrzny support hovera) widzi wszystko niezależnie od roli — używany do impersonacji w celu debugowania.

Zmiana roli = zmiana widoczności od razu po refreshu strony. Możesz przełączać rolę pracownika w Ustawienia → Pracownicy.

25. Zamawianie transportu koni

W ramach swojego planu Hovery (Start i wyżej — free plan nie ma dostępu) zamawiasz transport koni bezpłatnie, bez wychodzenia z panelu.

Skąd zacząć? Wejdź w sidebar → Transport koni (/app/transport) — znajdziesz tam 3 ścieżki:

  1. Wyślij zapytanie do wszystkich w regionie (broadcast) — najszybsze, otrzymasz oferty mailem od kilku przewoźników w ciągu 24h.
  2. Przeglądaj firmy — publiczny katalog wszystkich zweryfikowanych przewoźników (opinie, region, flota).
  3. Ulubieni przewoźnicy — Twoja lista max 5 firm; przy zapytaniu direct pre-wypełniamy je do wyboru.

Skrót z karty konia: otwierając konkretnego konia (/app/horses/{id}/edit), zobaczysz w nagłówku przycisk "Zamów transport" — wypełnimy dane stajni oraz nazwę konia automatycznie.

Hovera = pośrednik marketplace. Umowa transportu zawierana jest BEZPOŚREDNIO między Tobą a wybranym przewoźnikiem po akceptacji jego oferty. Szczegóły w regulaminie marketplace.

26. Klient firmowy — pobieranie danych z GUS / VIES

Gdy dodajesz nowego klienta (Klienci → Dodaj) lub wystawiasz FV i wpisujesz NIP nabywcy — masz przycisk „Pobierz z GUS / VIES". Jeden przycisk obsługuje:

Spacjowanie i myślniki tolerowane (DE 123 456 789 / PL 526-025-02-74). Master admin Hovera konfiguruje globalnie klucze API (GUS / CEIDG / VIES base URL) w /admin/company-lookup-settings.

27. FV w walucie obcej (NBP, Art. 31a VAT)

Gdy faktura jest w walucie innej niż PLN (EUR, USD, CZK itd.) — Hovera automatycznie pobiera średni kurs NBP z tabeli A. Zgodnie z Art. 31a ust. 1 ustawy o VAT używany jest kurs z dnia ROBOCZEGO poprzedzającego dzień wystawienia FV (z fallback'iem do ostatniego dnia publikacji NBP przy weekendach / świętach).

Snapshot kursu (exchange_rate, exchange_rate_date, source = nbp_a) zapisany jest immutable na FV. Korekta tworzy NOWĄ FV z nowym snapshot'em.

Jeśli NBP API jest niedostępne podczas wystawienia, FV przechodzi do statusu Issued bez kursu (kolumny null + log warning). Możesz potem ręcznie uzupełnić kurs przed wysyłką do KSeF.

28. Wskazówki

Wersja systemu: zobacz stopkę panelu. Dokumentacja aktualizowana wraz z nowymi modułami.

Chcesz wypróbować hovera w swojej stajni? 30 dni za darmo, bez karty.

Załóż stajnię →