🚀 Szybki Start

1. Wejdz na edit.flawzilla.com i zaloguj sie kontem Google, ktore dostales od administratora.
2. Jesli konto ma wlaczone MFA, podaj dodatkowo kod z aplikacji uwierzytelniajacej (patrz sekcja Logowanie i Dostep ponizej).
3. W prawym gornym rogu (Ekran) sprawdz, ze edytujesz wlasciwy ekran TV - jesli masz kilka lokalizacji, przelaczysz sie tam miedzy nimi.
4. Uzupelnij dane w Zarzadzanie, a na koniec kliknij Publikuj na TV - dopiero wtedy zmiany trafiaja na realny ekran (patrz sekcja Szkic i Publikacja).

Nic nie trzeba instalowac lokalnie. Caly panel dziala w przegladarce na komputerze, tablecie lub telefonie.

Do szybkich, lokalnych testow bez logowania istnieje tez osobny, lokalny tryb deweloperski (aplikacja/start.bat / start_mac.command) uruchamiany na wlasnym komputerze - to nie jest sciezka dla normalnej pracy z prawdziwym ekranem klienta, wiec nie jest tu dalej opisywany.

🔑 Logowanie i Dostęp

Panele administracyjne (edit.html, Uklad, Styl, CSV, Klienci, Monitoring) sa chronione logowaniem Google - nie ma juz osobnego hasla do samej aplikacji.

1. Wejdz na dowolny panel administracyjny - jesli nie masz aktywnej sesji, zobaczysz ekran logowania.
2. Kliknij przycisk logowania Google i wybierz konto, ktore administrator dodal do listy uprawnionych.
3. Konta z wlaczonym MFA zobacza dodatkowy krok: kod z aplikacji uwierzytelniajacej (np. Google Authenticator). Wpisz 6-cyfrowy kod i zatwierdz.
4. Sesja utrzymuje sie w przegladarce; wylogowanie jest w panelu Klienci (przycisk wylogowania) albo przez wyczyszczenie ciasteczek danej domeny.

Konto Google, ktorym sie logujesz, musi byc wczesniej dodane do listy uprawnionych przez administratora (zaproszenie albo dodanie w panelu Klienci → Bezpieczenstwo). Wpisanie dowolnego adresu Google, ktory nie jest na liscie, nie da dostepu.

Wlaczenie/zmiana MFA na koncie dokonuje sie dzis przez inne, juz zalogowane i zaufane konto z uprawnieniami - jesli stracisz dostep do aplikacji uwierzytelniajacej, skontaktuj sie z administratorem zamiast probowac zresetowac to samodzielnie.

ℹ️ Informacje o Systemie

Dane wersji pochodza z endpointu /api/version.

🖥️ Wiele Ekranów na Jednym Koncie

Jedno konto moze zarzadzac kilkoma ekranami TV (np. kilka sal, oddzialow albo lokalizacji).

1. W gornym pasku panelu Zarzadzanie uzyj listy Ekran, zeby przelaczyc sie na inny ekran - kazdy ma wlasne dane, uklad, styl i wlasny link TV.
2. Zmien nazwe zmienia czytelna nazwe biezacego ekranu (nie wplywa na dane ani link).
3. Nowy link TV uniewaznia poprzedni link/token do tego ekranu i tworzy nowy - uzyj tego, jesli stary link TV wyciekl albo zmieniasz urzadzenie i chcesz odciac stare.
4. Wariant linku TV (0 - WWW, 1 - auto orientacja, 3 - zawsze pion, 4 - zawsze poziom TV) decyduje, jak wygenerowany link TV bedzie sie zachowywal na ekranie docelowym. Zobacz tez sekcje Aplikacja Android (Kiosk).
5. Status ekranu pokazuje ostatnia publikacje, ostatni heartbeat od TV i podstawowe informacje o polaczeniu.

Zmiana Nowy link TV jest nieodwracalna dla starego linku - kazde urzadzenie uzywajace poprzedniego linku przestanie dostawac dane i trzeba je recznie przekonfigurowac na nowy adres.

📤 Szkic i Publikacja - Jak To Naprawdę Działa

To jest najwazniejsza roznica wzgledem starszych wersji aplikacji: wiekszosc zmian w Zarzadzanie NIE trafia od razu na ekran TV.

1. Wymaga publikacji (szkic): sale/recepcja, playlista i tryb playera (w tym YouTube), galeria, widocznosc widzetow, uklad i styl VIEW. Po kazdej takiej zmianie pasek u gory pokazuje ostrzezenie Ekran TV zobaczy zmiany dopiero po publikacji manifestu.
2. Dziala natychmiast (bez publikacji): Komunikat Alarmowy, Kontrola Timera i Pasek informacyjny - te trzy wysylaja sie na zywo na ekran TV od razu po kliknieciu, z pominieciem szkicu.
3. Zeby zmiany ze szkicu trafily na ekran: kliknij Zapisz szkic (zapisuje bez publikowania - mozna sprawdzic w Podglad telefonu), a potem Publikuj na TV.
4. Publikuj na TV mozna kliknac bezposrednio - automatycznie zapisze biezacy stan jako szkic i od razu go opublikuje.

Jesli wprowadziles zmiane i "nic sie nie dzieje" na TV - w 9 na 10 przypadkow chodzi o brakujace klikniecie Publikuj na TV, a nie o awarie.

📺 Aplikacja Android (Kiosk TV)

Na fizycznych telewizorach/boxach Android dzialajacych jako ekran Flawzilla dziala dedykowana aplikacja kioskowa, ktora sama laduje link TV na pelnym ekranie.

1. Ustawienia w aplikacji: na pilocie wcisnij WSTECZ 5 razy pod rzad (w ciagu ok. 4 sekund), zeby otworzyc ukryty ekran ustawien z polem adresu URL.
2. Wklej pelny link TV (z panelu Zarzadzanie → Ekran → link ze skopiowanego adresu) i kliknij ZAPISZ I OTWÓRZ.
3. Warianty linku w adresie: kiosk=0 zwykla przegladarka/WWW, kiosk=1 automatycznie dopasowuje sie do fizycznej orientacji ekranu, kiosk=3 zawsze pion (obraca sie programowo na ekranie poziomym), kiosk=4 zawsze poziom (obraca sie programowo na ekranie pionowym).
4. Przycisk USTAW JAKO EKRAN GŁÓWNY i ZEZWÓL NA WYŚWIETLANIE NAD INNYMI w ustawieniach nalezy wlaczyc od razu po instalacji - bez tego aplikacja moze nie wrocic sama na pierwszy plan po zaniku i powrocie zasilania.
5. WYCZYŚĆ PAMIĘĆ PODRĘCZNĄ I PRZEŁADUJ pomaga, gdy ekran TV utknal na starych danych mimo publikacji.

Jesli po wlaczeniu telewizora pokazuje sie wygaszacz Android TV zamiast Flawzilli: to ustawienie systemowe telewizora (wygaszacz ekranu), nie usterka aplikacji - wygaszacz nalezy wylaczyc w ustawieniach systemowych telewizora (Ustawienia → Ekran/Wygaszacz), tak zeby urzadzenie dedykowane do wyswietlania ekranu Flawzilla nigdy go nie uruchamialo.

Aplikacja Android aktualizuje sie sama w tle (raz dziennie sprawdza nowa wersje) - nie trzeba nic instalowac recznie po pierwszej konfiguracji urzadzenia.

📲 Instalacja VIEW jako aplikacji PWA (przeglądarka)

1. Otworz link TV (view.html) dla wybranego ekranu i orientacji w Chrome/Edge/Safari.
2. W Chrome/Edge kliknij ZAINSTALUJ APLIKACJĘ albo ikone instalacji w pasku adresu. Na iOS wybierz Udostępnij → Do ekranu początkowego.
3. Uruchom aplikacje z nowej ikony. VIEW przywroci ostatni ekran i tryb kiosk=3 lub kiosk=4; bez zapisanego trybu uruchomi kiosk=4.

Powłoka VIEW uruchomi sie bez sieci, ale aktualizacje danych, LIVE i niepobrane media wymagaja polaczenia. To rozwiazanie dla przegladarki/tabletu - na dedykowanym telewizorze Android uzyj aplikacji kioskowej opisanej wyzej.

➕ Jak Dodawac Dane - Krok Po Kroku

1. Sala (recznie): w Zarzadzanie wpisz nazwe, godzine, instruktora, opcjonalnie zdjecie (z pliku albo przyciskiem 📷 Zrób zdjęcie bezposrednio z kamery) i kliknij Wyslij.
2. Sala (AUTO): zaznacz AUTO z tabeli zajec, kliknij Wyslij. Dane beda pobierane z CSV dla dnia i godziny.
3. Recepcja: uzupelnij dane osoby i kliknij Wyslij.
4. Playlista plikow: wybierz filmy/zdjecia, kliknij Dodaj do playlisty, potem Uruchom na TV.
5. YouTube: w Tryb odtwarzania wybierz YouTube (link), wklej link (lub kolejke linkow, kazdy w osobnej linii) i opcjonalnie wlacz napisy CC.
6. LIVE: wybierz tryb LIVE, kliknij Udostępnij LIVE i wskaz okno do streamu.
7. Po kazdej z powyzszych zmian pamietaj kliknac Publikuj na TV (patrz sekcja Szkic i Publikacja) - wyjatkiem sa Alert, Timer i Pasek, ktore dzialaja od razu.

🗑 Jak Usuwac / Czyscic Dane

1. Sala: przycisk Wyczysc usuwa dane tej sali.
2. Recepcja: przycisk Wyczysc usuwa dane recepcji.
3. Pasek: puste pole wiadomosci + Ustaw kasuje dana wiadomosc (dziala natychmiast, bez publikacji).
4. Playlista: przy pliku kliknij X, aby usunac go z listy.
5. Galeria: przy zdjeciu kliknij ikone usuwania na liscie galerii.
6. CSV: wiersz usuwasz przyciskiem X, potem kliknij Zapisz.
7. Layout: Usun zaznaczony przenosi kafelek do magazynu; mozna go potem przywrocic.
8. Styl UI: Przywroc domyslne (DEF) cofa ustawienia stylu i etykiet.
9. Nie zapomnij Publikuj na TV po usunieciu danych ze sal/playlisty/galerii/ukladu/stylu - samo usuniecie w edytorze zostaje w szkicu.

🖥 Panel Zarzadzania (edit.html) - Mega Poradnik

Ten panel steruje tym, co widzisz na VIEW: ekran (jesli masz kilka), sale, recepcja, player, pasek, alert i timer.

1. Wysylanie zmian: po edycji klikaj Wyslij w konkretnym boksie, a na koniec pracy Publikuj na TV w gornym pasku (patrz Szkic i Publikacja).
2. Widocznosc widzetow: checkboxy Timer/Pogoda/Harmonogram/QR/Galeria decyduja, co jest widoczne na VIEW.
3. Zdjecie sali: wybierz plik albo zrob zdjecie przyciskiem 📷 Zrób zdjęcie i wyslij formularz sali.
4. AUTO harmonogram: dziala tylko gdy w CSV jest poprawny wpis (sala, godzina, dzien). Aktualne zajecia sa trzymane przez okolo 60 minut od startu, a gdy nic nie trwa system pokazuje kolejne.
5. Tryb TV: Playlista plikow, YouTube (link) lub LIVE Stream ustawiasz w sekcji odtwarzania.
6. Status playera: dolny status pokazuje, czy player jest wlaczony i w jakim trybie pracuje.
7. Kopia zapasowa: przycisk Eksportuj ustawienia pobiera plik z pelna konfiguracja biezacego ekranu; Importuj ustawienia (po wybraniu pliku kopii zapasowej) przywraca ja z powrotem.

📋 Listy CSV (lists_editor.html) - Mega Poradnik

1. Dodanie wiersza: kliknij Dodaj wiersz.
2. Edycja zajec: uzupelnij sala (1/2/3), nazwe, godzine, instruktora, dzien i opcjonalnie photo.
3. Wgrywanie zdjecia: przeciagnij plik obrazu na pole photo.
4. Usuniecie: kliknij X na koncu wiersza.
5. Zapis: kliknij Zapisz po kazdej serii zmian.

Walidacja sal: ID musi byc 1/2/3, a godzina w formacie HH:MM.

🧩 Uklad VIEW (layout_editor.html) - Mega Poradnik

1. Kliknij kafelek, aby go zaznaczyc.
2. Przeciagnij kafelek na nowe miejsce lub kliknij docelowe pole planszy.
3. Zmien szerokosc i wysokosc przyciskami W/H +/- albo polami numerycznymi.
4. Kliknij Usun zaznaczony, aby przeniesc kafelek do magazynu.
5. W magazynie kliknij przywracanie, aby dodac kafelek z powrotem.
6. Zapisz finalny uklad przyciskiem Zapisz uklad.
7. Przycisk Wczytaj z serwera odtwarza ostatni zapis, a Uklad domyslny resetuje plansze.

🎨 Styl VIEW (style_editor.html) - Mega Poradnik

1. Ustaw kolory tla i akcentu.
2. W sekcji czcionek wybierz font globalny i fonty per boks.
3. W sekcji rozmiaru czcionki ustaw skale dla kazdego boksu osobno.
4. W sekcji etykiet wpisz swoje nazwy boksow i podpisy pol.
5. Ustaw parametry paska: kierunek, timing, separator i liczbe powtorzen.
6. Zapisz przyciskiem Zapisz styl VIEW.

Przycisk Przywroc domyslne (DEF) cofa wszystkie ustawienia UI do wartosci domyslnych.

🔴 LIVE Stream - krok po kroku

1. W Zarzadzanie ustaw Tryb odtwarzania na LIVE Stream (przechwytywanie okna).
2. Kliknij Udostępnij LIVE.
3. W oknie uprawnien przegladarki wybierz okno/karte do udostepnienia.
4. Na ekranie TV stream pojawi sie automatycznie po publikacji.
5. Gdy cos sie zatnie, na ekranie VIEW kliknij ODSWIEZ LIVE.

Wazne: panel Zarzadzania i przegladarka udostepniajaca okno powinny byc otwarte w tej samej przegladarce/profilu.

📣 Pasek Informacyjny (Belt)

Przewijany pasek u dolu ekranu TV, z do trzech niezaleznych wiadomosci.

1. W Zarzadzanie → sekcja Pasek informacyjny wpisz tresc w polach Wiadomość 1/2/3 (mozna uzupelnic jedno, dwa albo wszystkie trzy).
2. Zapisz - pasek aktualizuje sie na ekranie TV natychmiast, bez publikacji.
3. Wyczyszczenie pola i ponowny zapis usuwa dana wiadomosc z paska.

Kierunek przewijania, predkosc i separator miedzy wiadomosciami ustawiasz w Styl VIEW (sekcja animacji paska).

⚖️ Odpowiedzialnosc Za Tresci

Autor aplikacji nie odpowiada za tresci wyswietlane w systemie. Pelna odpowiedzialnosc za komunikaty, multimedia, grafiki, QR kody i dane publikowane na ekranach spoczywa na operatorze lub wlascicielu instalacji.

👁 Widocznosc Widzetow (Widgets)

Mozesz decydowac, ktore elementy sa widoczne na ekranie VIEW bez zmiany ich ukladu.

1. W Zarzadzanie znajdz panel widocznosci widzetow.
2. Zaznacz lub odznacz: Timer, Pogoda, Harmonogram, QR, Galeria.
3. Kliknij Publikuj na TV, zeby zmiana widocznosci trafila na ekran.

Zegar, sale (klasy), trener/recepcja, pasek i player nie maja osobnego przelacznika widocznosci - pokazuja sie automatycznie, gdy maja jakies dane do wyswietlenia, i znikaja same, gdy sa puste/wylaczone.

Jesli widzet jest ukryty, jego miejsce na planszy pozostanie wolne (tlo biale/czarne zaleznie od stylu).

👥 Klienci i Monitoring (konta z uprawnieniami)

Linki Klienci i Monitoring w gornym menu prowadza do panelu operatora - to zaawansowane narzedzia dla kont z uprawnieniami administracyjnymi (nie kazde konto Google ma tam pelny dostep).

• Klienci: zarzadzanie wszystkimi klientami i ich ekranami, plany rozliczeniowe, zapytania cenowe ze strony flawzilla.tv/.com, statystyki uzycia oraz ustawienia bezpieczenstwa (lista kont z dostepem, MFA).
• Monitoring: stan techniczny wszystkich ekranow, bledy systemu, dziennik zdarzen, powiazane urzadzenia Android i zgloszenia od klientow.

Jesli klikniesz jeden z tych linkow i zobaczysz odmowe dostepu - to oczekiwane dla konta bez uprawnien operatorskich. Zwykla praca z ekranem TV (dane, uklad, styl) nie wymaga tych paneli.

🛠 Troubleshooting - Objaw / Przyczyna / Naprawa

Jesli problem nadal wystepuje: zrob zrzut ekranu danego panelu i podaj, w ktorym kroku problem sie pojawia.