Pomoc
Ten przewodnik opisuje, jak korzystac z najwazniejszych modulow systemu w codziennej pracy.
Opisy sa celowo praktyczne. Skupiaja sie na tym, co uzytkownik widzi i robi w systemie, bez technicznych detali.
Start i logowanie
- Po wejsciu do systemu widzisz strone glowna i menu z dostepnymi modulami.
- Niezalogowany uzytkownik moze przejsc do logowania, a w odpowiednim trybie kiosku takze do rejestracji.
- Po zalogowaniu menu rozszerza sie o moduly wynikajace z Twoich uprawnien.
- Wylogowanie jest zawsze dostepne z gornego menu.
- Jesli nie pamietasz hasla, mozesz skorzystac z odzyskiwania dostepu.
Profil uzytkownika
- W profilu znajduja sie Twoje podstawowe dane, przynaleznosc organizacyjna i status aktywnosci.
- Aktywny profil wymaga zaakceptowania potrzebnych zgod oraz uzupelnienia podpisu.
- Organizacja moze byc przypisana do profilu, jesli jest potrzebna do pracy w klubie lub na strzelnicy.
- Na profilu widac tez praktyczne uprawnienia nadane przez administratora.
- Jesli brakuje Ci dostepu do modulu, zwykle oznacza to brak odpowiedniej roli albo nieaktywny profil.
Karta klubowa i QR
- Karta klubowa sluzy do identyfikacji uzytkownika w systemie i przy pracy z kioskiem.
- Karte mozna wyswietlic, zapisac i wydrukowac.
- Front podgladu i wydruku karty zachowuje pelna zlota ramke wokol wzoru.
- Pojedynczy wydruk karty jest przygotowany na nosnik nominalny 55 x 85 mm i rozmiar pikselowy Zebry 1006 x 640. W oknie druku wybierz ten rozmiar, brak marginesow i skale 100%; obraz wypelnia strone bez dodatkowego obrotu CSS.
- Karta, obrazy analiz i PDF-y otwieraja sie pod zwyklym adresem systemu, bez osobnego portalu plikow.
- Kody QR z karty sa wykorzystywane przy wejsciach, wyjsciach i niektorych przeplywach kiosku, ale sama karta nie nadaje dodatkowych uprawnien.
- Pole RFID w profilu jest opcjonalne. Najwazniejsze jest to, aby profil byl aktywny i poprawnie uzupelniony.
- Lista kart wszystkich uzytkownikow jest dostepna tylko dla osob z odpowiednimi uprawnieniami.
- Jesli karta nie dziala poprawnie, najpierw sprawdz, czy profil uzytkownika jest aktywny.
Kiosk i Handset
- Kiosk to tryb obslugi skanowania przy stanowisku stacjonarnym.
- Handset to podobny tryb pracy, ale przygotowany do obslugi mobilnej.
- Po uruchomieniu kiosku lub handsetu system czeka na zeskanowanie odpowiedniego kodu.
- W tym trybie mozna realizowac przeplywy wejscia, wyjscia i obslugi zwiazanej z karta klubowa.
- Jesli instruktor ma aktywne wejscie, moze w kiosku wyszukac zarejestrowanego uzytkownika i zarejestrowac mu wejscie bez fizycznej karty tylko wtedy, gdy ta osoba rzeczywiscie wymaga instruktora.
- Zamykanie sesji kiosku lub handsetu jest dostepne tylko dla osob z odpowiednimi uprawnieniami.
Wejscia i wyjscia
- System pozwala rejestrowac wejscia na strzelnice i wyjscia z obiektu.
- Samodzielne wejscie jest mozliwe dla uzytkownika z aktywnym profilem, numerem pozwolenia i organizacja domowa.
- Jesli brakuje pozwolenia albo organizacji domowej, wejscie jest mozliwe tylko wtedy, gdy na strzelnicy jest aktywny instruktor.
- Aktywny instruktor musi sam miec numer pozwolenia i nalezec do organizacji domowej.
- Takie wejscie moze byc zarejestrowane samodzielnie ze skanu albo recznie przez aktywnego instruktora dla zarejestrowanego uzytkownika bez karty, ale tylko wtedy, gdy ten uzytkownik nie spelnia warunkow samodzielnego wejscia.
- Jesli wejscie odbywa sie pod opieka instruktora, formularz wyboru typow broni moze pokazywac tez prywatna bron tego instruktora.
- Jesli takie wejscie wymaga instruktora, uzytkownik pozostaje pod jego opieka az do wyjscia.
- Instruktor nie moze zakonczyc swojego wejscia, jesli ma jeszcze osoby pod opieka. Musi najpierw zakonczyc ich wejscia albo potwierdzic wspolne wyjscie.
- Jesli uzytkownik zapomni zarejestrowac wyjscie, administrator moze zamknac takie wejscie recznie z zapisem audytu.
- System moze tez automatycznie zamknac stare otwarte wejscia przy generowaniu dziennego raportu wejsc, a administrator nadal moze pozniej poprawic ustalony czas wyjscia.
- Grupa reports dostaje codzienny email, w ktorym najpierw widac aktualnie otwarte wejscia, a potem wpisy z biezacego dnia.
- Jesli podczas generowania raportu doszlo do auto-zamkniec starych wejsc, sa one widoczne w tym samym emailu jako osobna sekcja.
- System nie pozwala otworzyc drugiego wejscia, jesli poprzednie nie zostalo jeszcze zamkniete wyjsciem.
- Historia wejsc i wyjsc moze byc pozniej przegladana w raportach.
- Przy problemach z wejsciem najpierw warto sprawdzic status profilu i aktualne warunki dostepu.
Bron i zbrojownia
- Modul zbrojowni sluzy do ewidencji broni i obslugi jej wydan oraz zwrotow.
- W systemie mozna rozrozniac bron prywatna, klubowa i bron obiektu.
- Na liscie broni sekcja "Moja bron" jest u gory, a tabele broni strzelnicy lub klubu sa pokazane pod nia.
- Nie kazdy uzytkownik ma dostep do zarzadzania bronia. To zalezy od nadanych uprawnien.
- Przy pracy z bronia obiektowa system pilnuje celu wydania i historii operacji.
- Osoby z obiema grupami armory i reports dostaja codzienne emaile z raportem zbrojowni: lista niezwroconej broni oraz dzienny rejestr wydan i zwrotow razem ze stanem magazynu amunicji.
- Bron mozna tez oznaczyc jako sprzedana. Wtedy system zapisuje date sprzedazy, imie, nazwisko, PESEL, numer promesy nabywcy oraz opcjonalna notatke formalna.
- Sprzedana bron automatycznie dostaje status sprzedanej, wiec nie moze byc dalej wydana ani traktowana jako dostepna w zbrojowni.
- Dzieki temu latwo sprawdzic, kto, kiedy i w jakim celu korzystal z danego egzemplarza.
Amunicja
- Modul amunicji sluzy do kontroli stanu magazynowego i historii ruchow amunicji.
- W praktyce obsluguje przyjecia, wydania i zwroty.
- Kazda operacja jest zapisywana w historii i mozna do niej wrocic pozniej w raportach.
- Dostep do tego modulu maja tylko osoby, ktore rzeczywiscie obsluguja ten obszar.
- Jesli nie widzisz modulu amunicji, oznacza to brak wymaganych uprawnien albo niewlasciwy kontekst organizacyjny.
Wzory tarcz
- Wzory tarcz sa utrzymywane oddzielnie i wybierane przy analizie wyniku albo w zawodach.
- To z nich wynika, jak system rozumie uklad tarczy, ringi i znaczniki potrzebne do pracy.
- Na wygenerowanym wzorze numery punktow sa umieszczane w srodkach swoich pol punktowych: pojedyncza 10 w centrum, potem 9, 8 i kolejne az do 1 na nastepnych ringach, zarowno pionowo, jak i poziomo.
- Dodawanie i zmiana wzorow odbywa sie przez panel administracyjny.
- Zwykly operator punktacji korzysta z gotowych wzorow i nie musi ich tworzyc samodzielnie.
- Jesli analiza lub podglad z kamery nie pasuje do tarczy, najpierw sprawdza sie, czy wybrano poprawny wzor.
Punktacja
- W module Punktacja wgrywasz zdjecie tarczy, wskazujesz wzor tarczy i wybierasz strzelca.
- Po analizie system tworzy wynik i pokazuje widok tarczy z zaznaczonymi trafieniami.
- Jesli odczyt wzoru z QR sie nie powiedzie, wzor trzeba wybrac recznie.
- Na widoku wyniku mozna dodawac trafienia kliknieciem, usuwac je, wyczyscic cala liste albo skorzystac z podpowiedzi AI, jesli sa dostepne.
- W tabeli trafien mozna poprawic punktacje pojedynczego trafienia recznie. Tylko ten jeden wpis zmienia swoja wartosc, a reszta pozostaje bez zmian.
- Automatyczne punkty sa liczone z geometrii wzoru tarczy. Gdy wzor ma zdefiniowany byk i odstepy pierscieni, wynik korzysta z tych danych zamiast z prostego podzialu promienia na rowne czesci.
- Technicznie system rozdziela promien czarnego srodka tarczy od promienia pola 10, dzieki czemu kalibracja obrazu i punktacja nie myla tych dwoch wielkosci.
- Kolory trafien sa grupowane po ringach: byk ma osobny kolor, a kolejne kolory zmieniaja sie co 2 pierscienie.
- Recznie skorygowany punkt jest oznaczony innym kolorem, ale nadal widoczny w tym samym miejscu listy.
- Po zmianach trzeba zapisac wynik, aby nowe oznaczenia i suma zostaly utrwalone.
- Historia punktacji pozwala wrocic do starszych analiz i przegladac wczesniej zapisane wyniki.
Zawody i konkurencje
- Zawody skladaja sie z konkurencji. Kazda konkurencja ma wlasne zasady i przypisany wzor tarczy.
- Do konkurencji zapisuje sie konkretnego uzytkownika systemu, a nie anonimowego zawodnika.
- Konkurencja moze liczyc na przyklad najlepsza tarcze, srednia z kilku tarcz albo sume wybranych wynikow.
- Ta sama analiza tarczy moze brac udzial w wiecej niz jednej konkurencji, jesli organizator tak to przewidzial.
- Strzelec moze sam zglosic swoja tarcze do konkurencji z poziomu widoku wyniku, jesli jest do niej zapisany.
- Takie zgloszenie nie trafia od razu do klasyfikacji. Najpierw czeka na decyzje sedziego.
- Do tabeli wynikow licza sie tylko tarcze zatwierdzone.
- Jesli tarcza zostanie odrzucona, strzelec moze ja poprawic i zglosic ponownie.
- Po zamknieciu zawodow nie mozna dopisywac nowych zawodnikow ani nowych tarcz.
Sedzia zawodow
- Kazda konkurencja moze miec przypisanego konkretnego sedziego.
- To nie sama grupa sedziow decyduje o edycji tarczy, tylko przypisanie do konkretnej konkurencji.
- Sedzia widzi oczekujace tarcze, moze je zatwierdzac albo odrzucac i dodawac uwagi.
- Jesli tarcza jest juz przypieta do zawodow, zwykly uzytkownik nie moze jej dowolnie poprawiac.
- Edycje przypietej tarczy moze wykonac tylko przypisany sedzia danej konkurencji albo administrator.
- Dzieki temu wynik zawodow nie jest zmieniany przypadkowo przez osobe nieuprawniona.
Kamery
- Modul Kamery sluzy do podgladu obrazu z przypisanych zrodel i do prostowania obrazu tarczy.
- Na liscie kamer wybierasz konkretna kamere i przechodzisz do jej podgladu.
- Lista kamer najpierw pokazuje miniatury wyprostowane, a gdy nie ma jeszcze kalibracji lub markerow, automatycznie pokazuje surowa klatke z kamery.
- Na podgladzie glowny obraz pokazuje tarcze wyprostowana, a przycisk Surowy otwiera surowy obraz z kamery.
- Wyprostowany obraz pomaga zobaczyc tarcze tak, jakby byla ustawiona na wprost, nawet jesli kamera patrzy pod katem.
- Tryby Canvas 2D i WebGL pokazuja ten sam wycinek i te sama orientacje tarczy; WebGL sluzy do plynniejszego podgladu strumienia, nie do zmiany kadru.
- Gdy nie ma gotowej homografii, lista kamer zostaje na zwyklej miniaturze zamiast pokazywac pelna, nieprzycieta klatke WebGL.
- Rodzaj tarczy mozna zmienic z poziomu podgladu. Da sie go wybrac z listy albo sprobowac odczytac z kodu QR widocznego na tarczy.
- Kolory markerow trafien w podgladzie kamer i w ekranie anotacji probek odpowiadaja tym samym strefom co w module Punktacja.
- Dodawanie samych kamer odbywa sie w panelu administracyjnym, nie w zwyklym widoku uzytkowym.
- Jesli administrator nie zna pelnej sciezki RTSP, moze lokalnie uruchomic probe_rtsp_camera, aby sprawdzic port kamery i przetestowac typowe adresy strumienia.
- W formularzu kamery w panelu admina dostepny jest tez przycisk Test RTSP, ktory uruchamia te sama diagnostyke dla zapisanego adresu.
- W instalacjach kontenerowych definicje zrodel streamow go2rtc dla camera1..camera32 moga byc przekazywane przez zmienne srodowiskowe zamiast byc wpisane na stale w pliku konfiguracyjnym. Obowiazujace nazwy streamow to camera1..camera32 oraz camera1_sub..camera32_sub.
- Po poprawieniu adresu RTSP podglad moze potrzebowac 2-3 odswiezen, zanim pojawi sie pierwsza klatka. System sam ponawia zawieszone polaczenie, wiec zwykle nie trzeba restartowac serwera.
- Przy krotkiej przerwie odswiezania ostatnia poprawna klatka pozostaje widoczna. Komunikat o braku obrazu zaslania podglad dopiero wtedy, gdy kamera dluzsza chwile nie daje nowej klatki.
- Jesli inne kamery w systemie sa offline, aplikacja robi krotka przerwe przed kolejnymi probami laczenia z nimi. To ogranicza przeciaganie calego procesu przez niedostepne zrodla RTSP.
- Surowy i wyprostowany podglad tej samej kamery korzystaja z jednego odczytu per zrodlo, zeby rownolegle odswiezanie obu paneli nie zatrzymywalo obrazu po pierwszej klatce.
- Na liscie probek AI przycisk usuwania probki dziala od razu i nie pokazuje dodatkowego okna potwierdzenia.
- Po kliknieciu "Zbierz klatke" anotacja probki otwiera sie w tej samej karcie, a nie w nowym oknie.
- Przycisk "Probki AI" w widoku kamery pozwala wejsc do listy zapisanych probek tej kamery bez robienia nowej klatki.
- Surowy podglad dziala dla URL snapshotu, go2rtc oraz zwyklych zrodel RTSP/device://, dla ktorych system sam koduje klatke do JPEG.
- Podglad surowy i miniatury sa odswiezane przez proste przeladowanie obrazka z nowym timestampem, bez warstwy fetch/blob.
- Modul kamer sluzy przede wszystkim do pracy operatorskiej i kontroli obrazu, a nie do bezposredniego zarzadzania sprzetem.
Raporty
- Raporty zbieraja dane z roznych obszarow systemu w jednej czesci interfejsu.
- To tam najczesciej sprawdza sie historie wejsc, operacje, zestawienia i inne dane administracyjne.
- W raporcie wejsc i wyjsc mozna filtrowac wpisy otwarte, stare otwarte wejscia oraz wejscia zamkniete automatycznie.
- Raport wejsc i wyjsc pozwala tez odfiltrowac osoby aktualnie pod opieka instruktorow.
- W tabeli raportu i w eksporcie Excel widoczna jest kolumna Instruktor, ktora pokazuje opiekuna wpisu, jesli taki istnieje.
- Raport pokazuje tez sposob rejestracji wejscia i wyjscia, osobe rejestrujaca oraz ewentualna pozniejsza korekte czasu wyjscia.
- Przy korekcie czasu wyjscia administrator musi zostawic notatke z podstawa tej korekty.
- Automatyczny raport dzienny wejsc wysyla email z wpisami z biezacego dnia, lista nadal otwartych wejsc oraz ewentualna lista wejsc zamknietych automatycznie w tym raporcie.
- Raporty sa przeznaczone glownie dla osob nadzorujacych prace systemu.
- Jesli nie masz odpowiednich uprawnien, modul raportow moze byc niewidoczny.
Uprawnienia i administracja
- Administrator zarzadza kontami, profilami, organizacjami, wzorami tarcz, zawodami, bronia, amunicja i kamerami.
- Uprawnienia decyduja, jakie moduly sa widoczne w menu i jakie akcje mozna wykonac.
- Niektore role daja tylko podglad, a inne pozwalaja na wykonywanie operacji i zmian.
- Uprawnienie instruktora mozna nadac tylko uzytkownikowi z organizacja domowa i numerem pozwolenia na bron.
- Jesli uzytkownik straci te warunki, uprawnienie instruktora jest automatycznie odbierane.
- Administrator moze recznie zamknac zapomniane wyjscie i zapisac audyt takiej operacji.
- Administrator moze tez poprawic czas wyjscia po automatycznym zamknieciu, a system zapisuje kto i kiedy wprowadzil korekte.
- Administrator i osoby obslugujace zbrojownie widza tez dane sprzedazy broni, jesli egzemplarz zostal sprzedany i wycofany z uzycia.
- Administrator serwera ma gotowe komendy manage.py do backupow:
backup_db,backup_media,backup_configibackup_all. - Jesli ktos nie widzi modulu albo przycisku, zwykle jest to kwestia roli albo statusu profilu.
- W razie watpliwosci najlepiej sprawdzic profil uzytkownika i przypisane mu uprawnienia.