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.
Gdzie co znaleźć
| Chcesz… | Wejdź |
|---|---|
| zobaczyć konia, jego właściciela, współwłaściciela i płatnika | Stajnia → Konie → kliknij konia — blok „Właściciel i rozliczenie” na górze karty |
| zmienić właściciela, współwłaściciela albo na kogo idzie faktura | karta konia → „Zmień” przy danej osobie (albo przycisk „Właściciel i płatnik” w nagłówku) |
| sprawdzić, ile koń „nabił” w tym miesiącu | karta konia → „Rozliczenie miesiąca” (stan na dziś) |
| zobaczyć faktury konia | karta konia → zakładka „Faktury” |
| dopisać jednorazową usługę (solarium, trociny, kowal) | „Dopisz usługę” — na liście koni (przycisk w nagłówku albo w wierszu konia) i na karcie konia |
| zobaczyć, co klient ma do zapłaty, i zarejestrować wpłatę | Stajnia → Klienci → kliknij klienta — zakładka „Faktury i płatności” |
| znaleźć klientów z zaległościami | Stajnia → Klienci → kolumna „Do zapłaty” i filtr „Ma zaległości” |
| sprawdzić i zatwierdzić faktury za miesiąc | Finanse → Faktury → zakładka „Szkice do sprawdzenia” → „Zatwierdź” (rozdział 9) |
| wysłać faktury do KSeF | Finanse → Faktury → filtr „Do wysłania do KSeF” → zaznacz → „Wyślij zaznaczone do KSeF” |
| przejść z faktury do klienta albo konia | podgląd faktury → przyciski z nazwą klienta i „Konie” w nagłówku; na liście faktur nazwa klienta to odnośnik |
| szablony karnetów / szablony zabiegów / pulę darmowych rezerwacji | przyciski w nagłówku list Karnety, Opieka i zdrowie i Ujeżdżalnie (Kalendarz) |
| import, eksport danych, dziennik zmian | grupa Narzędzia w menu |
| tę instrukcję | Pomoc — na samej górze menu |
1. Pierwsze kroki
Po zalogowaniu trafiasz na panel /app. Po lewej stronie masz nawigację podzieloną na grupy:
- Stajnia — konie, klienci, boksy, budynki, specjaliści, karnety, opieka, cennik pensji
- Kalendarz — plan dnia, rezerwacje, cykliczne zajęcia, instruktorzy, ujeżdżalnie
- Finanse — faktury
- Ustawienia — ustawienia stajni, faktury, płatności, KSeF, pracownicy
Na początek zalecamy:
- Ustawienia stajni — uzupełnij dane firmy, branding, godziny pracy
- Budynki — utwórz przynajmniej jeden ("Stajnia główna")
- Boksy — przypisz każdy do budynku
- Cennik pensji — zdefiniuj usługi (siano, sprzątanie boksu, transport)
- Instruktorzy + Ujeżdżalnie — żeby kalendarz mógł przyjmować rezerwacje
2. Ustawienia stajni
Ścieżka: /app/tenant-settings
Sekcje formularza:
- Identyfikacja — nazwa, nazwa prawna, NIP
- Lokalizacja — kraj, język domyślny, strefa czasowa, waluta
- Branding — kolor wiodący, logo, hero image (na stronie publicznej)
- Strona publiczna
/s/{slug}— tagline, godziny otwarcia, opis, kontakt, social media - Online booking — czy klienci mogą rezerwować przez stronę publiczną; długość lekcji, godziny pracy, wyprzedzenie
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:
- Imię (np. "Bucefał")
- Właściciel (Select z listy klientów; pusty = stajnia jest właścicielem)
- Box (Select z aktywnych boksów)
- Mikrochip / Nr paszportu / UELN (Universal Equine Life Number)
- Płeć: Klacz / Wałach / Ogier / Ogier kryjący
- Rasa, Maść, Data urodzenia
- Pensja — usługi naliczane (multi-select z cennika — tylko przy zakładaniu konia; potem usługi zmieniasz w zakładce „Usługi pensjonatu”)
Po zapisie koń trafia na listę. Kolumny: Imię, Rasa, Płeć, Maść, Wiek, Właściciel — nazwa właściciela to odnośnik do jego karty klienta.
Na liście koni:
- kliknięcie konia otwiera jego kartę (podgląd); edycję otwiera przycisk „Edytuj” w wierszu albo na karcie,
- „Dopisz usługę” w nagłówku listy (wybierasz konia w oknie) i w wierszu konia (koń już wybrany) — jednorazowa usługa bez wchodzenia w kartę, patrz §28a.
Karta konia
Karta wygląda tak samo, czy weszło się podglądem, czy edycją — ma te same przyciski w nagłówku.
Blok „Właściciel i rozliczenie” (na samej górze, zawsze rozwinięty):
- Właściciel — nazwa jest odnośnikiem do karty klienta; „Zmień” otwiera wybór nowego właściciela. Jeśli płatnikiem był poprzedni właściciel albo jego firma, faktury zaczną iść na nowego właściciela. Gdy właścicielem zostaje dotychczasowy współwłaściciel, przestaje być współwłaścicielem.
- Współwłaściciel — odnośnik do karty klienta; „Zmień” ustawia albo zdejmuje współwłaściciela (opcjonalnie z zaproszeniem do konta).
- Płatnik — na kogo idzie faktura (właściciel, współwłaściciel albo firma któregoś z nich) i w jakim trybie (faktura VAT albo zestawienie do paragonu); „Zmień” otwiera wybór płatnika. Pod spodem: ile płatnik ma do zapłaty i ile faktur jest po terminie.
- „Rozliczenie miesiąca →” — patrz niżej.
Te same zmiany są w nagłówku pod przyciskiem „Właściciel i płatnik”. Pole „Właściciel” w formularzu jest tylko przy zakładaniu konia — później zmieniaj właściciela przyciskiem, bo tylko on porządkuje płatnika i współwłaściciela.
Rozliczenie miesiąca (przycisk w nagłówku i w bloku, widzi biuro): wybierz miesiąc (domyślnie bieżący).
- Bieżący miesiąc — stan na dziś: opłaty stałe (boks, usługi miesięczne) za cały miesiąc, bo tak pójdą na fakturę, a dodatki i rezerwacje naliczone do dzisiaj. Widać, ile koń „nabił” w połowie miesiąca.
- Miesiąc zamknięty: faktury za ten miesiąc (numer jest odnośnikiem, obok status i kwota do zapłaty) oraz to, czego jeszcze nie ma na żadnej fakturze.
Zakładki — najpierw pieniądze, potem reszta:
- Faktury — wszystkie faktury, na których jest koń, także wystawione na firmę albo współwłaściciela: numer (odnośnik), okres, rodzaj, status z odznaką „po terminie”, brutto, do zapłaty. Filtr „Tylko do zapłaty”, w wierszu „Zarejestruj wpłatę”. Widzi biuro.
- Dodatki i materiały — jednorazowe usługi przy koniu; ikona „zafakturowane” prowadzi do faktury.
- Usługi pensjonatu — jedyne miejsce przypinania usług z cennika (i pakietów opieki) do konia, z ceną indywidualną.
- Karnety
- Zdrowie i opieka — opieka i zdrowie (szczepienia, kowal, dentysta), waga, plan żywienia, zalecenia.
- Aktywności, Dziennik, Kalendarz, Pobyty, Wiadomości (czat z właścicielem)
- Dokumenty i zdjęcia — paszport, umowa, ubezpieczenie (PDF/JPG, do 25 MB) i galeria.
W nagłówku są też: Dopisz usługę, Wpis do dziennika, Wyjazd / powrót konia, a pod „Więcej” raport miesięczny (PDF), kalendarz konia w telefonie i zamówienie transportu.
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:
- Budynek (z grupowaniem — można zwinąć "Stajnię czerwoną")
- Nazwa, Typ, m²
- Status — Wolny (zielony) / Zajęty (szary)
- Płeć konia (jeśli przypisany)
- Pensjonat (zł/m-c)
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
- Typ: osoba prywatna / rodzina / firma
- Imię i nazwisko / nazwa
- Email, telefon
- NIP (z opcją "Pobierz z GUS" jeśli skonfigurowane GUS API)
- Identyfikacja właściciela konia (ARMiR):
- Nr EP — numer producenta nadany przez ARMiR przy rejestracji konia w Centralnej Bazie Koniowatych
- PESEL — fallback, jeśli właściciel nie ma EP
Lista klientów
- Konie — liczba koni, których klient jest właścicielem albo współwłaścicielem.
- Do zapłaty — suma wszystkich wystawionych, nieopłaconych faktur (po odjęciu wpłat); na czerwono, gdy coś jest po terminie. Widzi biuro.
- Filtr „Ma zaległości (po terminie)” — tylko klienci z fakturą po terminie, na której coś zostało do zapłaty.
Karta klienta
Kliknij klienta na liście. Widzisz:
- Wszystkie pola formularza
- Zakładka „Faktury i płatności” (pierwsza; odznaka: liczba faktur do zapłaty i kwota, czerwona przy zaległości) — od razu pokazuje faktury do zapłaty (filtr „Tylko do zapłaty” jest włączony; wyłącz go, żeby zobaczyć wszystkie). W każdym wierszu: kwota do zapłaty, odznaka „po terminie” i „Zarejestruj wpłatę” — przelew spoza wyciągu albo gotówka, rozliczana jak przelew z wyciągu (wpłata częściowa zostawia fakturę otwartą na resztę). Numer faktury otwiera jej podgląd. Widzi biuro.
- Zakładka „Konie” — konie, których klient jest właścicielem albo współwłaścicielem; „Otwórz” prowadzi do karty konia, „Rozliczenie” zmienia płatnika i tryb.
- Zakładka „Karnety”
- Action "Skopiuj link portalu" — generuje magic link (TTL 30 min) do skopiowania
- Action "Wyślij link na e-mail" — wysyła email z linkiem logowania
Z faktury wrócisz na kartę klienta przyciskiem z jego nazwą w nagłówku podglądu faktury, a na listę faktur jednego klienta albo jednego konia — filtrami „Klient” i „Koń” na liście faktur.
6. Kalendarz i plan dnia
Plan dnia — Kalendarz → Plan dnia
Jeden ekran z tym, co trzeba dziś zrobić w stajni, po kolei według godzin: karmienia, zalecenia dla koni, jazdy, rezerwacje hali i placu, wizyty weterynarza i kowala oraz zaległe terminy zdrowotne. Stajenni odhaczają tu karmienie i zalecenia, a Ty od razu widzisz, kto i o której to zrobił.

Szczegóły pracy z planem — odhaczanie, widok „Według koni”, praca bez zasięgu — opisuje instrukcja „Pracownik / instruktor”.
Zalecenia dla koni — karta konia → zakładka „Zalecenia”
Zalecenie to stałe polecenie dla jednego konia: leki, padok, karuzela, lonża, solarium, derka, chłodzenie nóg, pielęgnacja kopyt. Raz wpisane pojawia się codziennie (albo w wybrane dni) w planie dnia, a stajenny je odhacza.
- Otwórz Stajnia → Konie i kliknij konia.
- Na dole karty wybierz zakładkę „Zalecenia” i kliknij „Utwórz”.

- Wybierz „Rodzaj”, opcjonalnie nazwę („Solarium po treningu”), godzinę i czas trwania.
- „Dni tygodnia” — nic nie zaznaczone znaczy „codziennie”. „Obowiązuje od / do” — np. na czas kuracji.
- W „Uwagi dla stajennego” napisz to, co ma przeczytać przy koniu („Lewa przednia, zimna woda”).
- Kliknij „Utwórz”.

Zalecenia dodają: Właściciel, Admin, Manager, Instruktor i Weterynarz. Pracownik je wykonuje i odhacza. Wykonanie („zrobione 11:00–11:30, Kasia” albo „nie zrobione — koń kulał”) zapisuje się w dzienniku konia.
Kalendarz — Kalendarz → Kalendarz
Widok dnia i tygodnia z podziałem na instruktorów i miejsca. Kliknij pusty termin, żeby dodać zajęcia; kliknij wpis, żeby go zmienić.
Rezerwacje i potwierdzanie zgłoszeń — Kalendarz → Rezerwacje
Pełna lista rezerwacji z filtrami: typ, status, koń, instruktor, „Tylko nadchodzące”.
Statusy: Zgłoszone (czeka na Ciebie) → Potwierdzone → Zakończone / Odwołane / Nieobecność.
Lekcje zamówione przez klienta w portalu, w aplikacji albo na stronie stajni przychodzą jako „Zgłoszone”. Liczba przy „Rezerwacje” w menu mówi, ile zgłoszeń czeka.
- Wejdź w Kalendarz → Rezerwacje.
- Przy zgłoszeniu kliknij „Potwierdź” — klient dostanie maila z potwierdzeniem.
- Termin nie pasuje? Kliknij „Odrzuć” i potwierdź — klient dostanie maila, że stajnia odwołała rezerwację.

Chcesz najpierw zmienić konia albo godzinę? Kliknij „Edytuj”, popraw i zapisz, a potem potwierdź.
Rezerwacje hali, placu i karuzeli nie wymagają potwierdzania — system przyjmuje je od razu, jeśli jest wolne miejsce (opis w punkcie 23). Wyjątek: rezerwacja opłacana online czeka na płatność do 30 minut.
Cykliczne zajęcia — Kalendarz → Cykliczne zajęcia
Seria zajęć, np. „Szkółka w poniedziałki 17:00 do końca roku”. Akcja „Wygeneruj wystąpienia” rozkłada serię na pojedyncze rezerwacje (do 365 naraz).
7. Specjaliści (kowale + weterynarze)
Ścieżka: /app/specialists
Lista zewnętrznych kontrahentów oraz pracowników stajni którzy podkuwają / leczą konie.
Dodawanie
- Specjalność: Weterynarz / Kowal
- Imię i nazwisko, email, telefon, kolor w kalendarzu
- Konto w systemie (opcjonalne) — jeśli specjalista jest pracownikiem (TenantMembership), powiąż go z User. Dzięki temu zalogowany pracownik widzi widok "Moje zadania" z listą swoich zabiegów do wykonania.
Powiązanie z wpisami zdrowotnymi
Przy tworzeniu HR (/app/health-records) wybierz typ:
- "Kowal" → lista specjalistów filtruje się do
farrier - inne typy → lista filtruje się do
vet
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:
- email, imię i nazwisko, rola
System automatycznie:
- jeśli user istnieje → tworzy
TenantMembership - jeśli nie istnieje → wysyła
UserInvitation(link aktywacyjny mailem, TTL 7 dni)
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
Przycisk „Wyślij link resetu hasła” przy pracowniku wysyła mu maila z linkiem do ustawienia nowego hasła (ważny 60 minut).
Wspólny tablet w stajni i PIN-y pracowników
Jeden tablet przy paszarni zamiast kont dla każdego stajennego. Tablet jest zalogowany na stałe, a każdy wpis stajenny podpisuje swoim PIN-em — wiesz, kto karmił i kto podał leki.
Krok 1 — pracownicy i PIN-y. Ustawienia → Pracownicy i PIN-y → „Utwórz”. Wpisz imię i nazwisko oraz PIN (od 4 do 8 cyfr) i przekaż go pracownikowi. PIN-u nikt potem nie zobaczy — gdy ktoś zapomni, wpisz nowy w edycji. Wyłączenie „Aktywny” odbiera dostęp bez kasowania historii. Kolumna „Ostatni wpis” pokazuje, kiedy ktoś ostatnio pracował.

Krok 2 — konto tabletu. Dodaj pracownika z osobnym adresem e-mail dla tabletu (np. tablet@twojastajnia.pl) i rolą Pracownik. Potem w Ustawienia → Pracownicy stajni kliknij przy nim „Edytuj” i włącz „Konto tabletu (wpisy podpisuje PIN pracownika)”.

Krok 3 — zaloguj tablet tym kontem (w przeglądarce albo w aplikacji Hovera). Od tej chwili przy każdym odhaczeniu tablet pyta „Kto pracuje?” i o PIN. Przez 5 minut od ostatniego wpisu nie pyta ponownie, a przycisk „Zmień osobę” kończy zmianę.

Aplikacja na tablecie sprawdza PIN także bez zasięgu.
9. Faktury
Konfiguracja — /app/invoicing-settings
- Numeracja FV / Proforma / Korekta — wzór z placeholderami
{seq},{YYYY},{MM},{prefix} - Reset numeracji — Rocznie / Miesięcznie / Nigdy
- Domyślny termin płatności — np. 7 dni
- Dane sprzedawcy — nazwa, NIP, adres i rachunek bankowy. Adres uzupełnia się sam: jeśli pole jest puste, a stajnia ma NIP, system pobiera adres z GUS / CEIDG i zapisuje go w ustawieniach. To, co wpiszesz ręcznie, zawsze wygrywa — poprawisz adres tutaj, a kolejne faktury wezmą już Twoją wersję.
Trzy kroki każdej faktury: szkic → zatwierdzenie → KSeF
Każda faktura powstaje jako szkic — z rozliczenia miesiąca, z karnetu, z ręcznego „Utwórz”. Szkic nie ma numeru, nie idzie do klienta ani do KSeF; możesz go dowolnie poprawić albo usunąć.
-
Szkic — Finanse → Faktury, zakładka „Szkice do sprawdzenia”. Ręcznie: „Utwórz” → wybierz klienta (dane nabywcy uzupełnią się same), dodaj pozycje, zapisz. Dane sprzedawcy wypełniają się z ustawień.
-
Zatwierdzenie — przycisk „Zatwierdź” przy fakturze albo zaznacz kilka szkiców i „Zatwierdź zaznaczone szkice”. Faktura dostaje numer i datę wystawienia, a termin płatności liczy się od dnia zatwierdzenia (szkic, który czekał tydzień, nie będzie od razu po terminie). Puste pola sprzedawcy uzupełniają się w tym momencie z aktualnych ustawień. Zatwierdzenie niczego nie wysyła do KSeF.
-
Wysyłka do KSeF — dopiero po sprawdzeniu:
- pojedynczo: „Wyślij do KSeF” przy fakturze,
- zbiorczo: filtr „Do wysłania do KSeF” → zaznacz faktury → „Wyślij zaznaczone do KSeF”. Wysyłka idzie w tle, a wynik (ile wysłano, które pominięto i dlaczego) przychodzi w powiadomieniach — ikona dzwonka.
Przed wysyłką system sprawdza dane wymagane na fakturze: NIP i adres sprzedawcy, nazwę i adres nabywcy, NIP nabywcy-firmy, pozycje. Faktura z brakami nie pójdzie do KSeF — dostaniesz listę, czego brakuje.
Mail do klienta (przełącznik „Wyślij klientowi mailem” przy zatwierdzaniu): przy skonfigurowanym KSeF klient dostaje fakturę dopiero po przyjęciu przez KSeF, z numerem KSeF. Bez KSeF i dla zestawienia do paragonu — od razu po zatwierdzeniu. Ręcznie: „Wyślij na e-mail” (z linkiem „Zapłać teraz”, jeśli masz bramkę płatności).
Korekty
- Otwórz Finanse → Faktury i przy wystawionej fakturze kliknij „Korekta”.

- System od razu tworzy szkic korekty: kopiuje sprzedawcę, nabywcę i wszystkie pozycje z minusem (pełne odwrócenie faktury). Pojawi się komunikat „Korekta utworzona” z przyciskiem „Otwórz szkic”.

- W szkicu zostaw tylko to, co naprawdę korygujesz — np. zmień ilość albo cenę, a pozostałe pozycje usuń. Zapisz.
- Wróć do listy Faktury. Szkic korekty jest na górze z oznaczeniem KOR — kliknij przy nim „Zatwierdź”. Korekta dostaje numer według wzoru z ustawień faktur.
5. Jeśli masz KSeF — „Wyślij do KSeF”, tak jak przy zwykłej fakturze.

Korekty nie da się skorygować drugi raz — w takim przypadku wystaw nową fakturę.
10. Płatności online — /app/payment-settings
Wybierz domyślną bramkę:
- Brak — wszystko offline (przelew, gotówka)
- Przelewy24 — wpisz Merchant ID + POS ID + CRC + API key
- PayU — POS ID + OAuth credentials
- Mollie — API key
Po skonfigurowaniu, każda wystawiona FV ma w mailu przycisk "Zapłać teraz".
11. KSeF (e-faktury) — /app/ksef-settings
Wymagane:
- NIP stajni (kontekst KSeF)
- Środowisko: test / demo / prod
- Certyfikat — PFX (.pfx) lub PEM (.crt + .key); klucz i hasło szyfrowane Laravel Crypt + AES-256
Po wgraniu zatwierdzona FV ma akcję „Wyślij do KSeF”, a lista faktur — filtr „Do wysłania do KSeF” i wysyłkę zbiorczą (rozdział 9). Nic nie idzie do KSeF samo: ani przy generowaniu szkiców, ani przy zatwierdzaniu. Zacznij od środowiska test — wyślij jedną fakturę, sprawdź numer KSeF i UPO, dopiero potem przełącz na prod.
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:
- Wolne boksy ("Mamy X wolnych boksów")
- Zarezerwuj online (CTA do booking flow)
- Cennik pensjonatu (tabela)
- Lista instruktorów
13. Portal klienta
Klient loguje się przez https://app.hovera.app/s/{slug}/portal/login:
- wpisuje email
- dostaje magic link mailem (TTL 30 min)
- klik → ląduje na dashboardzie
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:
- nadchodzące rezerwacje (z opcją "Przesuń" / "Odwołaj")
- swoje karnety (X / Y pozostało)
- historię rezerwacji
- niezapłacone faktury
- swoje konie (z alertami zdrowotnymi)
- wiadomości
14. Dashboard "Dziś" — /app
Po zalogowaniu na górze widzisz 4 kafelki:
- 🗓️ Rezerwacje dziś — klik wchodzi do kalendarza,
- 🟢 Wolne boksy — klik do listy boksów,
- 🔴 Przeterminowane zabiegi — klik do filtra w opiece i zdrowiu,
- 💸 Niezapłacone FV — suma zł + count, klik do filtra Wystawione.
Pod nimi tabela dzisiejszych aktywnych rezerwacji (godzina · koń · instruktor · ujeżdżalnia · status).
Pulpit to pierwszy ekran właściciela, admina, managera, weterynarza i obserwatora. Pracownik (stajenny) po zalogowaniu od razu trafia do Planu dnia, a instruktor / trener do Kalendarza — pulpit z kafelkami nie jest dla nich.
15. Szablony zabiegów — /app/treatment-templates
Wejście: przycisk „Szablony zabiegów” w nagłówku listy Stajnia → Opieka i zdrowie.
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-items
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):
- Przychody — sumy netto bucketed: pensjonat / lekcje / karnety / inne + top 10 pozycji.
- Wiekowanie należności — niezapłacone po terminie kubełkowane: 0–30 / 31–60 / 61–90 / 90+ dni z gradientem barw.
- Wykorzystanie konia — count lekcji per koń + suma godzin. >25 = ryzyko przeciążenia.
- Wykorzystanie instruktora — godziny + frekwencja % + cancelled + no-show.
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).
- Wybierz miesiąc (default: poprzedni),
- Sprawdź podgląd (per-client lista pozycji + sumy),
- Zaznacz klientów lub zostaw wszystkich,
- Generuj Drafty → tworzy Draft Invoice per client.
Karnety pomijane (szkic faktury powstaje przy sprzedaży karnetu). Szkice zatwierdzasz w Faktury → „Szkice do sprawdzenia” (pojedynczo albo zaznaczone), a do KSeF wysyłasz osobno — rozdział 9.
23. Rezerwacje online — lekcje i miejsca
Klienci zapisują się sami na dwa sposoby. Oba włączasz w Ustawienia → Ustawienia stajni.
Lekcje z instruktorem
W sekcji „Online booking” włącz „Włącz online booking” i ustaw długość lekcji, godziny i wyprzedzenie.

Klient wybiera w portalu (albo w aplikacji) konia, instruktora, dzień i godzinę i wysyła prośbę. Lekcja trafia do Kalendarz → Rezerwacje jako „Zgłoszone” — potwierdzasz ją przyciskiem „Potwierdź” (punkt 6). Osoby spoza stajni zapisują się przez stronę app.hovera.app/s/{adres-stajni}/book.

Hala, plac, karuzela
W sekcji „Rezerwacje miejsc” wybierz:
- „Kto rezerwuje” — tylko pensjonariusze; pensjonariusze i klienci stajni (portal); albo każdy, także przez stronę stajni,
- „Płatne rezerwacje” — zbiorczo na fakturze za miesiąc, płatność online przy rezerwacji albo na miejscu.

Potem w Kalendarz → Ujeżdżalnie przy każdym miejscu, które można rezerwować, włącz „Pensjonariusze rezerwują sami” i ustaw długość slotu, liczbę koni naraz, cenę, ile dni naprzód i do ilu godzin przed można odwołać.

Przy „Każdy — także przez stronę stajni” osoby z zewnątrz rezerwują pod adresem app.hovera.app/s/{adres-stajni}/miejsca: wybierają miejsce, dzień i godzinę, podają imię, e-mail, telefon i imię konia. Wolne miejsca widać od razu.

Rezerwacja miejsca jest przyjmowana od razu — dostajesz powiadomienie „Rezerwacja ze strony: …”, a wpis pojawia się w Rezerwacjach jako „Rezerwacja miejsca”. Karta klienta zakłada się sama (albo dopasowuje po e-mailu). Klient może odwołać rezerwację linkiem z maila, do wyznaczonej liczby godzin przed początkiem.
24. Co widzi która rola — matryca uprawnień
Menu i strony są filtrowane wg roli pracownika. Weterynarz nie zobaczy faktur i karnetów, pracownik nie zobaczy ustawień stajni — mniej pozycji to mniejsze ryzyko pomyłki i jaśniejszy interfejs.
Tabela opisuje, co rola widzi w menu. Dodatkowo stajenny, weterynarz i instruktor nie mają w menu pozycji, których nie używają na co dzień (np. instruktor nie widzi Boksów i Cennika pensji, stajenny — Obsady miejsc). Adres takiej strony nadal działa, o ile rola ma do niej wstęp; prawa zapisu opisuje osobna matryca (rola „Tylko podgląd” i pracownik nie zmieniają kart koni ani kalendarza).
Pierwszy ekran po zalogowaniu: pracownik → Plan dnia, instruktor / trener → Kalendarz, pozostałe role → Pulpit.
| Sekcja | owner | admin | manager | trener | pracownik | vet | viewer |
|---|---|---|---|---|---|---|---|
| Konie · Opieka i zdrowie · Plan dnia · Kalendarz · Kanały zespołu | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Rezerwacje | ✓ | ✓ | ✓ | ✓ | — | — | ✓ |
| Obsada miejsc · Obciążenie koni | ✓ | ✓ | ✓ | — | — | — | ✓ |
| Kalendarz w telefonie | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| Cykliczne zajęcia | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| Klienci · Ujeżdżalnie | ✓ | ✓ | ✓ | ✓ | — | — | ✓ |
| Boksy · Budynki · Cennik pensji · Instruktorzy | ✓ | ✓ | ✓ | — | — | — | ✓ |
| Specjaliści · Wiadomości — specjaliści | ✓ | ✓ | ✓ | — | — | ✓ | ✓ |
Magazyn paszy (/app/feed-items) |
✓ | ✓ | ✓ | — | ✓ | — | ✓ |
| Faktury · Karnety · Raporty | ✓ | ✓ | ✓ | — | — | — | ✓ |
| Rozliczanie zbiorcze (Bulk invoicing) | ✓ | ✓ | ✓ | — | — | — | — |
| Transport koni | ✓ | ✓ | ✓ | — | — | — | ✓ |
| Ustawienia (stajni · FV · KSeF · Płatności) · Pracownicy | ✓ | ✓ | — | — | — | — | — |
| Moje zadania (po powiązaniu konta ze specjalistą) | — | — | — | — | — | ✓ | — |
| 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 zamawiasz transport koni bezpłatnie, bez wychodzenia z panelu.
Skąd zacząć? Wejdź w sidebar → Transport koni (/app/transport) — znajdziesz tam
3 ścieżki:
- Wyślij zapytanie do wszystkich w regionie (broadcast) — najszybsze, otrzymasz oferty mailem od kilku przewoźników w ciągu 24h.
- Przeglądaj firmy — publiczny katalog wszystkich zweryfikowanych przewoźników (opinie, region, flota).
- 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:
- NIP polski (10 cyfr) → GUS BIR (REGON) + CEIDG + KRS. Wypełnia nazwę firmy, ulicę, kod, miasto.
- NIP UE (np.
DE123456789,IT12345678901) → VIES (publiczne API Komisji Europejskiej). Walidacja + opcjonalnie nazwa i adres (zależy od państwa — DE/ES zwracają „---" przy włączonej prywatności).
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. Abonament, odnowienie i zawieszenie
Abonament nie odnawia się sam i nie pobieramy karty bez Twojego udziału. Każdy kolejny okres opłacasz osobno.
- Faktura na kolejny okres trafia do panelu (
/app/billing) na 5 dni przed końcem bieżącego okresu, razem z linkiem do zapłaty. - Przypomnienia wysyłamy pięć razy (e-mail, SMS i komunikat w panelu): 5 dni i 1 dzień przed końcem okresu, w dniu jego końca oraz 3 i 7 dni po końcu.
- Karencja trwa 8 dni od końca okresu — przez ten czas dostęp działa bez zmian.
- Zawieszenie. Po karencji panel zostaje wstrzymany. Dostępny pozostaje tylko ekran rozliczeń — z niego opłacasz fakturę, a po zaksięgowaniu płatności dostęp wraca automatycznie. Dane stajni zostają nietknięte.
- Bez odsetek i opłat dodatkowych.
- Eksport danych pobierasz sam. Otwórz stronę Eksport danych (
/app/eksport-danych; dostęp mają właściciel i administrator stajni), kliknij „Przygotuj eksport” i pobierz archiwum ZIP. W środku są: pliki CSV z danymi (klienci, konie, kalendarz i zajęcia, karnety, faktury, dziennik zdrowia konia, dokumenty), czytelne zestawieniaclients.csv,horses.csv,invoices.csvi kalendarzcalendar.ics, katalogzalaczniki/(dokumenty i zdjęcia koni, PDF faktur) z listązalaczniki.csv, plikmeta.json(metadane eksportu) i instrukcjaREADME.txt. Haseł, tokenów i kluczy w archiwum nie ma. Limity: 3 eksporty na dobę, plik i link są ważne 24 godziny, załączniki do 25 MB na plik i 250 MB łącznie — pominięte wypisujezalaczniki.csv, a my przekażemy je na prośbę (office@hovera.app). - Eksport w zawieszeniu. Przy zawieszeniu z powodu nieopłaconej faktury eksport działa nadal — odnośnik jest na ekranie wyboru konta, na stronie zawieszenia i na ekranie rozliczeń. Działa też po końcu okresu próbnego bez płatności. Przy zawieszeniu administracyjnym (naruszenie regulaminu) i po anulowaniu konta eksport przekazujemy na żądanie: office@hovera.app.
- Po zakończeniu umowy dane są przechowywane 90 dni, w których możesz je wyeksportować; potem są usuwane albo zwracane według Twojego wyboru (umowa powierzenia, pkt 8).
- Okres próbny (30 dni, do 10 koni i 5 klientów) kończy się bez blokady: jeśli nie opłacisz planu, konto przechodzi na bezpłatny plan Stajnia Free — dane zostają, a faktury, KSeF, płatności online i SMS-y wracają po wyborze płatnego planu na ekranie rozliczeń. Na ekranie rozliczeń widzisz też komunikat o braku płatności i dane kontaktowe (office@hovera.app, +48 791 301 019, dni robocze 9:00–17:00).
- Limity planu (Stajnia Free: 10 koni, 25 klientów, 2 użytkowników, 1 GB; Szkółka: 20 / 100 / 3 / 5 GB; Pensjonat: 40 koni, bez limitu klientów, 6 użytkowników, 20 GB; Ośrodek: 100 koni, bez limitu klientów i użytkowników, 50 GB; dodatki „+10 koni” i „Dodatkowy użytkownik” podnoszą limit). Po osiągnięciu limitu — koni, klientów, użytkowników albo miejsca na pliki — nie dodasz kolejnej pozycji ponad limit. Zmień plan na ekranie rozliczeń, a limit wzrośnie; dotychczasowe dane i dostęp zostają bez zmian.
- Do limitu użytkowników liczą się czynni członkowie oraz oczekujące zaproszenia — zaproszenie zajmuje miejsce od wysłania.
- Miejsce na pliki liczymy z dokumentów i zdjęć koni zapisanych w Hoverze; załączniki wiadomości i logotypy nie są liczone.
- Zużycie limitów widzisz na ekranie rozliczeń (np. „Konie 12 / 15”); od 80% pojawia się ostrzeżenie.
- Wszystkie plany mają te same moduły — różnią się tylko limitami.
28a. Pakiety opieki i dodatki
Pakiet opieki — Stajnia → Cennik pensji
Pakiet to pozycja cennika z ceną miesięczną i listą zajęć, np. „Pakiet Podstawowy: siano, ściółka, padok codziennie, karuzela 3× w tygodniu”. Każda stajnia tworzy własne pakiety.
- W Cenniku pensji kliknij „Utwórz” (albo edytuj istniejącą pozycję), ustaw nazwę, cenę, VAT i częstotliwość „Miesięcznie”.
- W sekcji „Pakiet opieki” włącz „To jest pakiet opieki”.
- W „W cenie” wpisz to, co jest w pakiecie bez osobnych zajęć (siano, owies, ściółka).
- „Dodaj zajęcie” dla każdego zajęcia: rodzaj (karuzela, padok, solarium…), ile razy w tygodniu, czas, miejsce (np. Karuzela) i okno godzin („najwcześniej o / najpóźniej do”).


Przypisanie pakietu do konia
Na karcie konia, w zakładce „Usługi pensjonatu”, kliknij „Dodaj usługę” i wybierz pakiet (przy zakładaniu nowego konia możesz go też wybrać w sekcji „Pensja — usługi naliczane”). System sam:
- rozkłada zajęcia równo w tygodniu (3× = poniedziałek, środa, piątek),
- dobiera godzinę, w której miejsce (np. karuzela) ma wolne stanowisko, a koń nie ma innego zajęcia,
- wpisuje zajęcia jako zalecenia — trafiają do planu dnia stajennych i na tablet,
- pokazuje komunikat, co i o której zaplanował.

Odpięcie pakietu wygasza jego zajęcia (historia zostaje). Godzinę możesz potem zmienić ręcznie w zakładce „Zalecenia” — jeśli w nowej godzinie miejsce jest pełne, dostaniesz ostrzeżenie z dniami.
Zajęcia z pakietów zajmują stanowiska na karuzeli (i każdym innym miejscu z liczbą koni naraz, np. solarium dodane jako miejsce). Widać to w Kalendarz → Obsada miejsc, a pensjonariusze nie zarezerwują karuzeli ponad pojemność.

Kwota pakietu trafia co miesiąc na fakturę za pensję, jak każda usługa miesięczna. Jeśli pensjonat rozliczasz pakietem, a nie ceną boksu, wyłącz w Ustawienia → Faktury → Pensjonat opcję „Opłata za boks na fakturze zbiorczej” — inaczej koń zapłaci dwa razy.
Dodatki i zdarzenia jednorazowe
Dodatkowe solarium, worek trocin, opatrunek — wszystko, co ma się pojawić raz na fakturze za ten miesiąc.
- Cennik dodatków ustawiasz w Cenniku pensji jako pozycje „Za użycie” albo „Jednorazowo” (np. „Trociny — worek 20 kg”, 35 zł).
- „Dopisz usługę” jest w planie dnia, na liście koni (w nagłówku — z wyborem konia — i w wierszu każdego konia) oraz na karcie konia. Dopisuje każdy pracownik: stajenny, instruktor, weterynarz, kierownik. Na tablecie wpis podpisuje stajenny swoim PIN-em.
- Cenę podpowiadamy z cennika. Zmienić ją może tylko właściciel, admin i kierownik. Usługa wpisana z palca bez ceny czeka „do wyceny” i nie trafi na fakturę z zerem, dopóki jej nie wycenisz (zakładka „Dodatki i materiały” na karcie konia → Edytuj).
- Ile dodatków koń ma już w tym miesiącu, pokazuje „Rozliczenie miesiąca” na karcie konia (stan na dziś). Po wystawieniu faktury ikona „zafakturowane” w zakładce dodatków prowadzi do tej faktury.

Dodatki zamawiane przez właściciela konia
Przy pozycji cennika „Za użycie” / „Jednorazowo” włącz „Właściciel może zamówić w portalu”. Właściciel konia wybierze w portalu usługę, dzień i ilość — zamówienie pojawi się w planie dnia z przyciskiem „Wykonane”, a w zakładce dodatków z przyciskami „Wykonane” / „Odrzuć”. Na fakturę trafia dopiero wykonane.

Karnet na usługę z kalendarza — np. 5 × fizjoterapia
- Stajnia → Cennik pensji — usługa „Fizjoterapia”, „Za użycie”, cena jednej wizyty.
- Stajnia → Specjaliści — dodaj fizjoterapeutę (rodzaj „Fizjoterapeuta”).
- Karnety → przycisk „Szablony karnetów” — „Fizjoterapia 5×”: zakres „Usługi z cennika” → Fizjoterapia, 5 wejść, cena karnetu. Opcjonalnie „Tylko u wykonawców” — karnet działa wyłącznie u wskazanej osoby.
- Karta konia → Karnety → Przypisz — karnet dla tego konia (albo dla właściciela, na wszystkie jego konie).
- Kalendarz → nowy wpis „Opieka” — koń, usługa z cennika, wykonawca (specjalista albo pracownik stajni), miejsce — boks (puste = boks konia).
O godzinie rozpoczęcia wizyta trafia do dodatków konia i zdejmuje jedno wejście z karnetu. Odwołanie wpisu oddaje wejście. Bez karnetu (albo gdy się skończył) wizyta idzie na fakturę za miesiąc — po cenie indywidualnej konia albo z cennika. Na liście karnetów widać „zaplanowane w kalendarzu: N”.
Ustawienia faktur za pensjonat — Ustawienia → Faktury → „Pensjonat”

- Stawka VAT opłaty za boks (np. 8%).
- Ceny boksów są brutto — włącz, jeśli w boksach wpisujesz cenę z VAT-em; faktura policzy netto tak, żeby brutto zgadzało się co do grosza.
- Opłata za boks na fakturze zbiorczej — wyłącz, gdy pensjonat rozliczasz pakietem z cennika.
29. Wskazówki
- Skróty z klawiatury —
?w panelu pokazuje listę skrótów - Język — przełącz w user menu (PL / EN / DE / FR); preferencja zapisuje się per user
- Wsparcie — kontakt: support@hovera.app
Wersja systemu: zobacz stopkę panelu. Dokumentacja aktualizowana wraz z nowymi modułami.