Instrukcja użytkownika

Wprowadzenie

Generator Planu zbiórek to aplikacja webowa, która pomaga w tworzeniu i zarządzaniu miesięcznymi planami zbiórek. Aplikacja pozwala na szybkie generowanie tabel, automatyczne wypełnianie miejsc i prowadzących oraz eksport planów do formatów PDF i JPG.

Krok 1: Wybór miesiąca i roku

W pierwszym kroku musisz wybrać miesiąc i rok, dla którego chcesz wygenerować plan.

• Miesiąc: Wybierz z listy rozwijanej (1-12)
• Rok: Wprowadź rok ręcznie (np. 2024)

Możesz również zaimportować niedokończoną tabelę z pliku JSON, jeśli wcześniej zapisałeś swoją pracę.

Krok 2: Zarządzanie danymi

W drugim kroku dodajesz podstawowe dane potrzebne do utworzenia planu:

Miejsca zbiórek

• Kliknij "Dodaj miejsce" aby dodać nowe miejsce
• Wprowadź nazwę miejsca (np. "Sala A", "Plac zabaw")
• Wybierz kolor dla miejsca - każdy kolor będzie widoczny jako kropka przy miejscu w tabeli
• Możesz edytować lub usunąć istniejące miejsca

Godziny zbiórek

• Kliknij "Dodaj godzinę" aby dodać nową godzinę
• Wprowadź godzinę w formacie HH:MM (np. "18:00", "19:30")
• Możesz edytować lub usunąć istniejące godziny

Prowadzący

• Kliknij "Dodaj prowadzącego" aby dodać nowego prowadzącego
• Wprowadź imię i nazwisko (lub tylko imię)
• Możesz edytować lub usunąć istniejących prowadzących

Zarządzanie danymi

• Eksportuj kopię zapasową: Zapisuje wszystkie dane (miejsca, godziny, prowadzący) do pliku JSON
• Importuj kopię zapasową: Wczytuje dane z pliku JSON
• Resetuj do domyślnych: Przywraca domyślne wartości (usuwa wszystkie wprowadzone dane)
• Usuń wszystkie dane: Usuwa wszystkie dane z pamięci przeglądarki

Krok 3: Konfiguracja

W trzecim kroku konfigurujesz ustawienia generowania planu:

Pomijane dni

• Zaznacz checkboxy przy dniach tygodnia, które mają być pominięte w planie
• Najczęściej pomija się dni w których nie ma zbiórek
• Pominięte dni nie pojawią się w wygenerowanej tabeli

Domyślne wartości

Dla każdego dnia tygodnia możesz ustawić domyślne wartości, które będą automatycznie wstawiane do tabeli:

• Domyślna godzina: Godzina, która będzie domyślnie wstawiana dla tego dnia
• Domyślne miejsce: Miejsce, które będzie domyślnie wstawiane dla tego dnia
• Domyślny prowadzący: Prowadzący, który będzie domyślnie wstawiany dla tego dnia

Dni scalone

• Dni scalone to dni, które są wyświetlane jako jeden wiersz w tabeli
• Najczęściej scala się soboty (dzień 6)
• Możesz ustawić tekst, który będzie wyświetlany dla scalonego dnia (np. "Zbiórki w grupach")
• Możesz również ustawić własny tekst dla każdego scalonego dnia

Style tabeli

Możesz dostosować wygląd tabeli:

• Kolor tła tabeli
• Kolor tła nagłówka
• Kolor tekstu w nagłówku
• Kolor tekstu w komórkach
• Kolor obramowania
• Kolory podświetleń (dla różnych typów wierszy)

Style można zmienić w dowolnym momencie, również po wygenerowaniu tabeli.

Kopia zapasowa konfiguracji

Funkcje eksportu i importu kopii zapasowej w tym kroku obejmują również całą konfigurację (ustawienia dni, domyślne wartości, style).

Krok 4: Generowanie i edycja planu

Po kliknięciu "Dalej" w kroku 3, aplikacja wygeneruje tabelę z planem dla wybranego miesiąca.

Edycja planu

W wygenerowanej tabeli możesz:

• Edytować datę: Kliknij na datę aby ją zmienić
• Edytować godzinę: Kliknij na pole z godziną aby wprowadzić lub zmienić godzinę
• Wybrać miejsce: Użyj listy rozwijanej aby wybrać miejsce (kolor miejsca będzie widoczny jako kropka)
• Wybrać prowadzącego: Użyj listy rozwijanej aby wybrać prowadzącego
• Scalone dni: Kliknij na scalony dzień (np. soboty) aby edytować jego tekst

Automatyzacja

Menu "Automatyzacja" oferuje kilka funkcji do szybkiego wypełniania planu:

• Uzupełnij puste komórki: Automatycznie wypełnia wszystkie puste miejsca i prowadzących losowymi wartościami, zachowując równomierne obciążenie
• Uzupełnij tylko miejsca: Wypełnia tylko puste pola z miejscami
• Uzupełnij tylko prowadzących: Wypełnia tylko puste pola z prowadzącymi

Automatyzacja stara się równomiernie rozłożyć obciążenie - każdy prowadzący i każde miejsce będzie użyte podobną liczbę razy.

Zapisywanie i wczytywanie pracy

• Zapisz niedokończoną tabelę: Zapisuje aktualny stan tabeli do pliku JSON, aby móc kontynuować pracę później
• Wczytaj niedokończoną tabelę: Wczytuje zapisaną tabelę z pliku JSON

Wyczyść tabelę

Walidacja i analityka

Aplikacja automatycznie sprawdza kompletność planu i wyświetla:

• Wskaźniki kompletności wierszy (zielone/żółte/czerwone kropki)
• Wykrywanie konfliktów (ten sam prowadzący w kilku miejscach jednocześnie)
• Statystyki użycia miejsc i prowadzących
• Wykresy pokazujące rozkład obciążenia

Eksport planu

Po wypełnieniu planu możesz go wyeksportować:

• Eksport do PDF: Tworzy plik PDF z planem, gotowy do druku
• Eksport do JPG: Tworzy obraz JPG z planem

Wyeksportowane pliki zachowują wszystkie style i kolory ustawione w konfiguracji.

Czego aplikacja NIE robi automatycznie

• Nie uzupełnia godzin: Godziny muszą być wprowadzone ręcznie lub ustawione jako domyślne wartości
• Nie generuje planu bez wyboru miesiąca/roku: Musisz najpierw wybrać miesiąc i rok
• Nie zapisuje automatycznie: Zmiany nie są automatycznie zapisywane - użyj funkcji "Zapisz"
• Nie synchronizuje z chmurą: Wszystkie dane są przechowywane lokalnie
• Nie waliduje przy wprowadzaniu: Walidacja odbywa się dopiero w kroku 4

PWA - Instalacja aplikacji

Aplikacja może być zainstalowana jako Progressive Web App (PWA) na Twoim urządzeniu:

• Na komputerze: W Chrome/Edge kliknij ikonę instalacji w pasku adresu
• Na telefonie Android: Chrome automatycznie zaproponuje instalację
• Na iPhone/iPad: Użyj opcji "Dodaj do ekranu głównego" w Safari

Wskazówki i najlepsze praktyki

• Regularnie twórz kopie zapasowe: Użyj funkcji "Eksportuj kopię zapasową" po pierwszym prawidłowym uzupełnieniu danych
• Ustaw domyślne wartości: Jeśli masz powtarzające się wzorce (np. zawsze poniedziałki o 18:00 w Sali A), ustaw je jako domyślne wartości w kroku 3
• Użyj automatyzacji mądrze: Automatyzacja pomaga szybko wypełnić plan, ale zawsze sprawdź wynik i dostosuj ręcznie
• Sprawdź konflikty: Użyj funkcji walidacji aby upewnić się, że nie ma konfliktów (ten sam prowadzący w kilku miejscach jednocześnie)
• Zapisz pracę przed wyczyszczeniem: Jeśli chcesz wyczyścić tabelę, najpierw zapisz aktualną pracę

Rozwiązywanie problemów

Tabela nie generuje się

• Sprawdź czy wybrałeś miesiąc i rok w kroku 1
• Sprawdź czy dodałeś przynajmniej jedno miejsce i jednego prowadzącego w kroku 2
• Odśwież stronę i spróbuj ponownie

Dane zniknęły

• Sprawdź czy nie wyczyściłeś danych przeglądarki
• Jeśli masz kopię zapasową, zaimportuj ją
• Pamiętaj, że dane są przechowywane lokalnie - po wyczyszczeniu przeglądarki zostaną utracone

Automatyzacja nie działa

• Upewnij się, że masz dodane miejsca i prowadzących w kroku 2
• Sprawdź czy są puste komórki do wypełnienia
• Odśwież stronę i spróbuj ponownie

Eksport nie działa

• Sprawdź czy przeglądarka pozwala na pobieranie plików
• Spróbuj użyć innej przeglądarki
• Sprawdź czy masz wystarczająco miejsca na dysku

Prywatność i bezpieczeństwo

Wszystkie dane są przechowywane lokalnie w Twojej przeglądarce. Aplikacja nie wysyła żadnych danych na zewnętrzne serwery.

Więcej informacji znajdziesz w Polityce Prywatności.