Dodawanie Nowego Księdza do Systemu

Dwie drogi do formularza

Sposób 1: Z wykazu księży

1. Otwórz Admin | Wykaz księży
2. Nad tabelą znajdź zielony przycisk Dodaj księdza
3. Kliknij go
4. Zostaniesz przekierowany na stronę z formularzem

Sposób 2: Bezpośredni link w menu (jeśli istnieje)

1. W menu głównym znajdź sekcję administracyjną
2. Szukaj opcji typu "Dodaj księdza" lub podobnej
3. Kliknij - otworzy się formularz

Layout formularza

Formularz jest podzielony na 4 równe kolumny (4 × col-lg-3):

Na dole formularza (poza kolumnami):

• Przycisk Anuluj - powrót do wykazu bez zapisywania
• Przycisk Dodaj do bazy - zapis i opcje co dalej

Lista wszystkich pól obowiązkowych

Nie musisz wypełniać - ale warto

Ikona klucza - przełączanie widoczności hasła

Obok każdego pola hasła jest ikona klucza

• Domyślnie hasło jest ukryte (typ pola: password) - widać tylko kropki: ••••••••
• Kliknij ikonę klucza - hasło stanie się widoczne (typ pola: text)
• Kliknij ponownie - hasło znów się ukryje
• Działa to samo dla "Hasło" i "Powtórz hasło"
• Każde pole ma swoją niezależną ikonę przełączania

Wymagania dotyczące hasła

Hasło MUSI spełniać wszystkie poniższe kryteria:

1. Długość: Co najmniej 8 znaków
2. Wielka litera: Przynajmniej jedna duża litera (A-Z)
3. Mała litera: Przynajmniej jedna mała litera (a-z)
4. Cyfra: Przynajmniej jedna cyfra (0-9)
5. Znak specjalny: Przynajmniej jeden znak spośród: ! @ # $ % ^ & * ( ) _ + - = { } [ ] | \ : ; " ' < > , . ? /

Przykłady dobrych haseł:

• ParAfiA2024! ✅
• Ks.JaN#2024 ✅
• WiZytY@Dom123 ✅

Przykłady złych haseł:

• parafia ❌ (za krótkie, brak wielkich liter, cyfr, znaków specjalnych)
• Parafia2024 ❌ (brak znaku specjalnego, w dodatku typowe słowa i rok)
• parafia! ❌ (za krótkie, brak wielkich liter i cyfr)

Walidacja na żywo - komunikaty

System sprawdza hasło podczas wpisywania (waliduje) i pokazuje komunikaty:

Komunikaty błędów (czerwone tło)

• "Hasło musi mieć co najmniej 8 znaków"
• "Hasło musi zawierać co najmniej jedną wielką literę"
• "Hasło musi zawierać co najmniej jedną małą literę"
• "Hasło musi zawierać co najmniej jedną cyfrę"
• "Hasło musi zawierać co najmniej jeden znak specjalny (!@#$%^&*)"

Komunikaty mają jasnoczerwone tło i ciemnoczerwony tekst.

Komunikat sukcesu (zielone tło)

Komunikat sukcesu - hasło spełnia wszystkie wymagania

• "Hasło spełnia wszystkie wymagania ✓"

Komunikat ma jasnozielone tło i ciemnozielony tekst.

Walidacja pola "Powtórz hasło"

System sprawdza czy oba hasła są identyczne:

• Jeśli się różnią - komunikat błędu: "Hasła nie są identyczne"
• Jeśli są takie same - komunikat sukcesu: "Hasła są identyczne ✓"
• Walidacja działa na bieżąco (event blur - po opuszczeniu pola)

Czym jest 'przełącznik' ?

To interaktywny przycisk, który przełącza się między dwoma stanami:

• TAK - konto AKTYWNE (zielony przycisk)
• NIE - konto NIEAKTYWNE (czerwony przycisk)

Domyślnie: Ustawiony na TAK - nowy ksiądz powinien mieć aktywne konto od razu.

Jak działa przełącznik?

1. Kliknij na przycisk
2. Przycisk zmienia kolor i tekst:
   • Z TAK na NIE
   • Lub odwrotnie: z NIE na TAK
3. Ukryte pole formularza `active` zmienia wartość (1 lub 0)
4. Ta wartość zostanie zapisana do bazy po kliknięciu "Dodaj do bazy"

Kiedy ustawić NIE przy dodawaniu?

Rzadko, ale możliwe scenariusze:

• Ksiądz zostanie dodany do systemu, ale nie od razu dostanie dostęp (np. czeka na szkolenie)
• Przygotowujesz konta z wyprzedzeniem (np. tydzień przed przybyciem księdza)
• Testujesz konto - nie chcesz aby ksiądz się już logował

W większości przypadków: Zostaw domyślne TAK - ksiądz powinien mieć od razu dostęp.

Trzy niezależne role

Jak przypisywać role?

Zależy od funkcji księdza w parafii:

Proboszcz / Administrator parafii

• Rola 1: TAK - pełen dostęp administracyjny
• Rola 2: TAK - może edytować parafian
• Rola 3: TAK

Wikariusz prowadzący wizyty i zarządzający parafianami

• Rola 1: TAK lub NIE - w zależności czy ma zajmować się administracją
• Rola 2: TAK - musi móc edytować dane parafian
• Rola 3: TAK

Ksiądz tylko prowadzący wizyty (bez zarządzania danymi)

• Rola 1: NIE - brak dostępu admin
• Rola 2: NIE - tylko przegląda dane, nie edytuje
• Rola 3: NIE lub TAK

Ksiądz rezydent (w parafii, ale mały dostęp)

• Rola 1: NIE
• Rola 2: NIE
• Rola 3: NIE

Krok po kroku - od wypełnienia do zapisu

1. Wypełnij wszystkie pola obowiązkowe (te z czerwoną gwiazdką *)
2. Sprawdź hasło - upewnij się, że widzisz zielony komunikat "Hasło spełnia wszystkie wymagania ✓"
3. Sprawdź "Powtórz hasło" - upewnij się, że komunikat pokazuje "Hasła są identyczne ✓"
4. Ustaw "Konto aktywne" - zazwyczaj TAK (zielony)
5. Sprawdź role - domyślnie wszystkie TAK, zmień jeśli trzeba
6. Opcjonalnie wypełnij pozostałe pola (miejscowość, kod, ulica, uwagi)
7. Kliknij przycisk Dodaj do bazy na dole formularza
8. System waliduje wszystkie dane
9. Jeśli są błędy - podświetli pierwsze błędne pole i wyświetli komunikat
10. Jeśli wszystko OK - zapisze dane i wyświetli alert

- alert z opcjami po zapisaniu

Po poprawnym zapisaniu wyświetli się komunikat - alert z pytaniem:

Dwa przyciski do wyboru:

Przycisk "Anuluj"

Jeśli w trakcie wypełniania formularza zmienisz zdanie:

1. Kliknij przycisk Anuluj na dole formularza
2. Zostaniesz przekierowany do Admin | Wykaz księży
3. Żadne dane NIE zostaną zapisane
4. To bezpieczny sposób na wyjście bez zapisywania

Problem: "Nie mogę kliknąć 'Dodaj do bazy' - nic się nie dzieje"

Przyczyny:

• Brakuje któregoś z pól obowiązkowych (czerwona gwiazdka *)
• Przeglądarka podświetla pierwsze puste pole - przewiń do góry formularza
• Hasło nie spełnia wymogów - sprawdź komunikaty pod polami hasła

Rozwiązanie:

1. Przewiń formularz do samej góry
2. Sprawdź wszystkie pola z czerwoną gwiazdką
3. Uzupełnij brakujące
4. Spróbuj ponownie

Problem: "Hasło ma czerwony komunikat - nie mogę zapisać"

Przyczyny:

• Hasło za krótkie (mniej niż 8 znaków)
• Brak wielkiej litery
• Brak małej litery
• Brak cyfry
• Brak znaku specjalnego (!@#$%^&*)

Rozwiązanie:

• Przeczytaj dokładnie komunikat błędu - wskaże czego brakuje
• Popraw hasło zgodnie ze wskazówką
• Czekaj aż zobaczysz zielony komunikat "Hasło spełnia wszystkie wymagania ✓"

Problem: "System mówi 'Login już istnieje w bazie'"

Przyczyna: Próbujesz użyć loginu, który już jest przypisany do innego księdza.

Rozwiązanie:

• Zmień login na inny (np. dodaj cyfrę, kropkę, podkreślenie)
• Przykład: j.kowalski → j.kowalski2 lub jan.kowalski

Problem: "Hasła nie są identyczne - co robić?"

Przyczyna: W polach "Hasło" i "Powtórz hasło" są różne teksty (nawet jeden znak różnicy blokuje zapis).

Rozwiązanie:

1. Kliknij ikonę klucza przy obu polach - zobacz hasła jawnie
2. Sprawdź dokładnie czy są identyczne
3. Jeśli się różnią - popraw (najlepiej skopiuj hasło z pierwszego pola i wklej do drugiego)
4. Kliknij poza pole "Powtórz hasło" - system zwaliduje
5. Czekaj na zielony komunikat "Hasła są identyczne ✓"

Problem: "Inicjały wpisałem małymi literami - czy to błąd?"

Odpowiedź: Nie, to nie problem! System automatycznie przekształca inicjały na wielkie litery przy zapisie.

Przykład: Wpiszesz jk → System zapisze JK

Kluczowe elementy formularza dodawania

• ✅ Formularz 4-kolumnowy z podziałem na sekcje
• ✅ 13 pól obowiązkowych (oznaczonych czerwoną gwiazdką *)
• ✅ 6 pól opcjonalnych (adres, uwagi)
• ✅ Walidacja hasła na żywo z komunikatami błędów/sukcesu
• ✅ Przełącznik widoczności hasła (ikona klucza )
• ✅ Przełącznik "Konto aktywne" TAK/NIE
• ✅ 3 przełączniki z rolami (uprawnienia)
• ✅ Alert po zapisie z opcjami "Do wykazu" / "Dodaj nowy"
• ✅ Przycisk "Anuluj" - bezpieczne wyjście