Dokumentacja uzytkownika SZKOL
Ten material prowadzi krok po kroku przez glowny przeplyw pracy: od logowania, przez obsluge moduow,
po eksport danych i zgloszenia. Sekcje sa przygotowane pod uzupelnienie o zrzuty ekranowe.
1. Start i zakres dokumentacji
Dokumentacja obejmuje dzialanie aplikacji ODO od momentu wejscia do systemu az po codzienna prace na rejestrach i formularzach.
Material jest napisany tak, aby nowy uzytkownik mogl samodzielnie wykonac podstawowe i zaawansowane operacje.
Logowanie
Nawigacja
Rejestry
Zarzadzanie
Eksport
2. Logowanie i bezpieczenstwo
- Uzytkownik otwiera strone logowania i podaje login oraz haslo.
- Po poprawnym logowaniu system przekierowuje do obszaru aplikacji.
- Uprawnienia do funkcji sa nadawane rolami i zakresem dostepu.
- Brak uprawnien powoduje ukrycie opcji menu lub brak mozliwosci operacji.
Rekomendacja: po zakonczeniu pracy wyloguj sie i nie pozostawiaj aktywnej sesji bez nadzoru.
Miejsce na zrzut ekranu: logowanie
Podmien zawartosc tymczasowa na screenshot ekranu logowania i komunikatow walidacyjnych.
3. Uklad aplikacji i nawigacja
- Lewa kolumna: menu glowne z grupami funkcji.
- Gorny pasek: breadcrumb i szybki podglad aktualnego miejsca.
- Srodek: glowna przestrzen robocza aktualnego widoku.
- Wiele list posiada ten sam standard: filtry, tabela, akcje, modale i export.
Miejsce na zrzut ekranu: uklad po zalogowaniu
Sugerowany plik: 01-uklad-aplikacji.png
4. Panel glowny ODO
Panel glowny sluzy jako punkt startowy i dashboard nawigacyjny. Z tego miejsca przechodzisz do kluczowych modulow.
- Przejscie do modulow zarzadzania i rejestrow.
- Kontrola kontekstu organizacyjnego (zalezne od uprawnien).
- Szybki dostep do codziennie uzywanych obszarow.
5. Zarzadzanie: Procesy Kafelki
Widok kafelkowy wspiera szybkie przejscie do procesow wedlug obszarow organizacyjnych.
- Nawigacja po jednostkach i procesach.
- Podglad statusu i podstawowych metryk procesu.
- Przejscie do szczegolow procesu.
6. Zarzadzanie: Procesy Lista
Centralny widok listy procesow. Umozliwia wyszukiwanie, filtrowanie i akcje na rekordach.
- Filtry statusu i kryteriow wyszukiwania.
- Operacje na rekordzie: edycja, podglad, usuwanie, pliki.
- Eksport listy do DOC/XLS/CSV/PDF.
Miejsce na zrzut ekranu: tabela procesow i przyciski akcji
Sugerowany plik: 02-procesy-lista.png
7. Zarzadzanie: Umowy Powierzenia
- Dodawanie i edycja umow powierzenia.
- Powiazanie umowy z podmiotem, zakresem i okresem obowiazywania.
- Obsluga dokumentow powiazanych z umowa.
- Zmiany statusu i usuwanie rekordow.
8. Zarzadzanie: Udostepnienia Danych
- Rejestrowanie podmiotu wnioskujacego i celu udostepnienia.
- Obsluga statusu zatwierdzenia przez IOD.
- Zapisywanie daty faktycznego udostepnienia.
- Historia operacji i edycja wpisow.
9. Zarzadzanie: Upowaznienia do PDO
- Nadawanie upowaznien i okreslanie zakresu.
- Data nadania i data odebrania upowaznienia.
- Status aktualnosci i przeglad szczegolow osoby.
- Obsuga dokumentow PDF upowaznien.
10. Zarzadzanie: Szkolenia ODO
- Planowanie szkolen i rejestracja uczestnikow.
- Statusy procesu szkoleniowego.
- Wydruki list i raporty szkoleniowe.
11. Zarzadzanie: Analizy Ryzyka
- Tworzenie analiz i podpinanie procesow.
- Ocena postepu analizy i status roboczy/zapisany.
- Druk podgladu oraz eksport.
12. Zarzadzanie: Oceny Skutkow (DPIA)
- Tworzenie oceny skutkow dla wskazanych procesow.
- Kontrola stanu wykonania i dat zatwierdzenia.
- Widoki podgladu i raportowania.
13. Rejestr Czynnosci
- Wybieranie ADO i zatwierdzenie wyboru jako warunek aktywacji eksportu.
- Widok danych adresowych i szczegolow rejestru.
- Eksport danych i wydruki wg ustalonego standardu.
Jezeli ADO nie jest wybrane, akcje eksportu sa nieaktywne, a system wyswietla komunikat podpowiedzi.
14. Rejestr Kategorii Czynnosci
- Widok rozszerzonych danych kategorii przetwarzan.
- Informacje o srodkach bezpieczenstwa i transferach danych.
- Eksport dokumentacyjny w orientacji poziomej.
15. Rejestr Umow Powierzenia
- Lista umow z danymi podmiotu i zakresem umowy.
- Status obowiazywania i historia dokumentow.
- Standardowy eksport listy.
16. Rejestr Udostepnien
- Rejestrowanie celu i podstawy prawnej udostepnienia.
- Daty potwierdzenia oraz daty faktycznego udostepnienia.
- Status obslugi wpisu i filtrowanie listy.
17. Rejestr Upowaznien
- Podglad numerow upowaznien, statusow i zakresu.
- Dane osoby i przynaleznosc do komorek organizacyjnych.
- Eksport zbiorczy i wydruki dokumentow.
18. Dokumenty: Generator i Lista
- Wzory dokumentow: tworzenie i utrzymanie szablonow.
- Wygenerowane dokumenty: lista, filtrowanie, pobieranie.
- Spojnosc z danymi z rejestrow i procesow.
Miejsce na zrzut ekranu: generator dokumentow
Sugerowany plik: 03-generator-dokumentow.png
19. Zgloszenia i obieg informacji
- Formularz: potrzeba kontaktu z IOD.
- Formularz: zgloszenie nowego procesu.
- Formularz: zgloszenie naruszenia.
- Widok "Moje zgloszenia" do sledzenia statusow.
20. Funkcje wspolne (filtry, export, modal)
- Filtrowanie i sortowanie tabel po kolumnach.
- Wspolny zestaw eksportu: DOC, XLS, CSV, PDF.
- Okna modalne zgodne ze standardem globalnym.
- Powiadomienia po akcjach zapisu/usuniecia/aktualizacji.
W eksportach listowych stosowany jest standard ukladu landscape dla PDF i DOC tam, gdzie tabela wymaga szerokiego ukladu.
21. Dobre praktyki pracy
- Przed eksportem ustaw filtry i status, aby raport odzwierciedlal oczekiwany zakres.
- Regularnie uzupelniaj dane slownikowe i statusowe.
- Nie usuwaj rekordow bez sprawdzenia powiazan i historii dokumentow.
- W zgloszeniach dodawaj komplet informacji, aby skrocic czas obslugi.
22. Najczestsze problemy i rozwiazania
- Brak przyciskow lub sekcji: sprawdz role i zakres uprawnien.
- Brak eksportu: sprawdz czy wymagany kontekst (np. wybor ADO) zostal zatwierdzony.
- Nieprawidlowe dane na liscie: odswiez filtry i ustawienia sortowania.
- Brak reakcji po kliknieciu: sprawdz czy popup/modal nie jest blokowany przez przegladarke.
Miejsce na zrzut ekranu: przyklady komunikatow i bledow
Sugerowany plik: 04-komunikaty-systemowe.png
23. Mapa widokow ODO i funkcjonalnosci
Ponizej znajduje sie praktyczna mapa najwazniejszych widokow ODO wraz z zakresem operacji, jakie uzytkownik moze wykonac.
| Widok / trasa |
Przeznaczenie |
Kluczowe operacje |
m_odo_proces_kafelki_dzial |
Szybki podglad procesow po komorkach organizacyjnych. |
Wejscie do listy procesow, podglad statusow i przejscie do szczegolow procesu. |
m_odo_proces_lista_index |
Glowna lista procesow w ukladzie tabelarycznym. |
Filtry, wyszukiwanie, sortowanie, add/edit/delete, statusy, eksport i wydruk. |
m_odo_proces_lista_info/{id}
m_odo_proces_lista_info_extend/{id} |
Szczegoly procesu oraz dane rozszerzone. |
Edycja danych procesu, zarzadzanie plikami i umowami powiazanymi z procesem. |
m_odo_proces_umowy_powierzenia_rejestr* |
Operacje na umowach powierzenia PDO. |
CRUD, zmiana statusu, przypisywanie do procesow, eksporty i podglady. |
m_odo_proces_udostepnienia_danych_rejestr* |
Rejestr udostepnien danych i obsluga statusow. |
Dodawanie wpisow, walidacja, zmiana statusu i kontrola dat potwierdzenia. |
m_odo_proces_upowaznienia_rejestr* |
Rejestr upowaznien do przetwarzania danych. |
Zarzadzanie statusem upowaznienia, eksporty i widoki szczegolowe. |
m_odo_proces_szkolenia_rejestr* |
Ewidencja szkolen i uczestnikow. |
CRUD szkolen, lista uczestnikow, import z CSV, kontrola duplikatow. |
m_odo_analiza_ryzyka_index
m_odo_ocena_skutkow_index |
Obsluga analiz ryzyka i ocen skutkow (DPIA). |
Tworzenie i edycja analiz, podglady raportow, eksporty i wydruki. |
m_odo_rejestr_* |
Rejestry formalne ODO (czynnosci, kategorie, umowy, udostepnienia, upowaznienia). |
Przeglad i utrzymanie danych rejestrowych, eksport dokumentacyjny. |
m_odo_dokumenty_wzory
m_odo_dokumenty_lista |
Generator dokumentow i lista dokumentow wygenerowanych. |
Tworzenie dokumentu z danych systemowych, pobieranie i archiwizacja. |
m_odo_zgl_rejestr_zgloszen |
Obsluga zgloszen uzytkownika. |
Podglad statusow zgloszen i historia obiegu informacji. |
m_odo_statystyka_proces_* |
Wykresy i raporty statystyczne. |
Widoki kolowe i zbiorcze, eksporty DOC/PDF/PNG/HTML/Print. |
Miejsce na zrzut: mapa menu ODO i aktywne grupy
Sugerowany plik: 05-mapa-widokow-odo.png
24. Komponenty globalne - jak uzywac
Modul ODO wykorzystuje wspolne komponenty. Prawidlowe uzycie zapewnia spojna walidacje, styl i zachowanie we wszystkich widokach.
| Komponent |
Zastosowanie |
Jak uzywac na widoku |
global-form-modal |
Okna modalne add/edit/delete/info/status. |
Przekaz id modala, tytul, akcje formularza i pola. Logike zapisu pozostawiasz w kontrolerze. |
view-export-buttons |
Eksport calego widoku: DOC/PDF/PNG/HTML + wydruk. |
Ustaw target-selector i filename-prefix; dla szerokich tabel wlacz doc-landscape. |
view-graph-export-buttons |
Eksport widokow grafowych (np. drzewo struktury). |
Uzyj na widokach z grafami i ustaw selektor kontenera z grafem. |
ajax-crud-table |
Globalna tabela DataGrid (index + CRUD + AJAX). |
Konfigurujesz kolumny, filtry, akcje, endpoint danych i endpointy operacji. |
ajax-search-box + search-columns-selector |
Wyszukiwanie tekstowe i wybor kolumn przeszukiwania. |
Kolumny ukryte nie sa przeszukiwane; licznik pokazuje liczbe aktywnych kolumn. |
column-visibility-selector |
Wlaczanie/ukrywanie kolumn i ich kolejnosc. |
Kolumna Lp jest stale pierwsza, Akcje stale ostatnia. |
ajax-filters + ajax-filters-status-indicator |
Filtry slownikowe i status ich aktywnosci. |
Dla zdefiniowanych filtrow wyswietla status i przycisk czyszczenia filtrow. |
ajax-pagination-controls + records-per-page-selector + ajax-records-count |
Paginacja i informacje o rekordach. |
Pokazuje liczbe rekordow po filtrach oraz liczbe wszystkich rekordow. |
view-close-button |
Zamykanie aktualnego widoku i powrot do nadrzednego. |
Dodawaj w prawym gornym rogu sekcji z akcjami. |
Komponenty powinny byc stosowane bez zmiany logiki biznesowej. Najpierw przepiecie stylu i walidacji, potem ewentualna refaktoryzacja danych.
25. Scenariusze pracy krok po kroku
Scenariusz A - Dodanie procesu: wejdz na m_odo_proces_lista_index, kliknij add, uzupelnij pola wymagane, zapisz, sprawdz komunikat i podswietlenie rekordu.
Scenariusz B - Zmiana statusu: na liscie kliknij status, zweryfikuj dane informacyjne w modalu, zatwierdz akcje i sprawdz powiadomienie.
Scenariusz C - Eksport raportu: ustaw filtry, wybierz kolumny, uruchom eksport PDF/DOC i porownaj, czy plik odzwierciedla aktualny widok.
Scenariusz D - Obsluga plikow: w szczegolach procesu dodaj zalacznik, sprawdz walidacje pola pliku, potwierdz widocznosc pliku w sekcji "Załączniki".
Scenariusz E - Rejestr czynnosci: wybierz ADO i zatwierdz wybor, wygeneruj eksport i sprawdz podzial sekcji na strony.
Miejsce na zrzut: scenariusz A
Sugerowany plik: 06-scenariusz-dodanie-procesu.png
Miejsce na zrzut: scenariusz B
Sugerowany plik: 07-scenariusz-zmiana-statusu.png
Miejsce na zrzut: scenariusz C
Sugerowany plik: 08-scenariusz-eksport.png
Miejsce na zrzut: scenariusz D
Sugerowany plik: 09-scenariusz-zalaczniki.png
26. Lista zrzutow ekranowych do uzupelnienia
- Widok logowania i komunikaty walidacji.
- Panel glowny ODO po zalogowaniu.
- Procesy lista: filtry, akcje i statusy.
- Szczegoly procesu i sekcja zalacznikow.
- Modal add/edit/delete/status/info zgodny ze standardem.
- Rejestr czynnosci: wybor ADO i eksport.
- Dokumenty: wzory i lista dokumentow.
- Statystyki: wykresy i tabela porownawcza.
- Zgloszenia: formularze i lista "Moje zgloszenia".
Kazdy screenshot powinien zawierac krotki podpis: co uzytkownik robi, jaki jest efekt i gdzie to widac na ekranie.
27. Aktualizacje: blokady i statusy szkolenia
W module m_szkol wdrożono rozszerzone reguły blokowania edycji i operacji na szkoleniu po zmianie statusu lub po rozpoczęciu testów.
- Dla statusu Zatwierdzony blokowane są akcje edycji i usuwania szkolenia (widoki list oraz szczegółów).
- Po publikacji (zatwierdzeniu) zablokowane jest dodawanie i usuwanie uczestników.
- Dla e-Learningu w trybie Szkolenie Wewnętrzne edycja wyników uczestników jest blokowana (tylko podgląd).
- Jeżeli co najmniej jedna osoba wykonała test kontrolny, edycja wyników oraz modyfikacje uczestników pozostają zablokowane.
- Na wybranych widokach ukrywane są ikony/akcje oznaczone jako niedostępne dla bieżącego statusu.
Zasada biznesowa: po przejściu szkolenia do etapu realizacji/publikacji system preferuje integralność danych nad elastycznością edycji.
28. Aktualizacje: prezentacja i testy użytkownika
- Widok
/szkolenia/user/my-trainings otrzymał rozszerzone statusy kafelków (aktywne, zaliczone, limit podejść).
- Domyślne filtrowanie listy: Status = Aktywne oraz Wynik/Postęp = Do zrobienia; jeśli brak rekordów, stosowany jest fallback.
- Kliknięcie w kafelek szkolenia otwiera szkolenie (nie tylko przycisk).
- W prezentacji szkolenia zapamiętywany jest wylosowany zestaw pytań do momentu zapisu podejścia.
- Przy nowym podejściu odpowiedzi są resetowane, aby nie przenosić poprzednich zaznaczeń.
- Dla pytań typu „dopasowanie par” przypisany element znika z listy dostępnych wyborów.
- Jeżeli wykorzystano limit podejść, przycisk startu testu jest zastępowany komunikatem i przyciskiem do listy podejść.
- Widok wyniku testu zawiera podgląd treści pytania, Twojej odpowiedzi i odpowiedzi prawidłowej (z kolorowaniem poprawności).
29. Aktualizacje: raporty i eksporty
- Dodano raport kompleksowy szkolenia (HTML/PDF/DOCX) dostępny z poziomu listy uczestników szkolenia.
- Raport posiada konfigurację sekcji i pól (w tym konfigurację kolumn list uczestników).
- Wspierane są wykresy analityczne w wariantach: pionowy słupkowy oraz donut.
- Raporty generowane są w orientacji pionowej (portrait).
- Dostępna jest prezentacja list obecnych i nieobecnych jako osobnych sekcji konfigurowanych w ustawieniach raportu.
- Sekcja materiałów szkoleniowych została uproszczona do listy punktowanej z pomijaniem kategorii o wartości 0.
30. Aktualizacje: panel administratora szkolenia
- Widok
/szkolenia/admin/trainings/{id} otrzymał uspójnioną nawigację zakładkową i klikalne kafelki sekcji.
- W sekcji uczestników dodano kolumny Stanowisko i Komórka org. wraz z filtrami i sortowaniem.
- Tabela uczestników wspiera przewijanie pionowe wierszy ze stałym nagłówkiem.
- Dodawanie uczestników odbywa się modalnie (wielopoziomowo) i pozostawia użytkownika na tym samym widoku/zakładce.
- Usuwanie uczestnika szkolenia posiada modal potwierdzający zgodny ze standardem aplikacji.
- Kolumna „Zaliczono” pokazuje „-” przed podejściem do testu oraz „TAK/NIE” po zakończonych podejściach.
31. Aktualizacje: konfiguracja testów i pytań
- Widok edycji testu (
/szkolenia/admin/tests/{id}/edit) został uporządkowany do układu analogicznego jak w szkoleniach.
- Zakładka „Pytania statyczne” jest widoczna dla trybu doboru pytań: Statyczny.
- Dodawanie pytań odbywa się przez wysuwane okno z listą pytań, wyszukiwarką i wyborem wielokrotnym (checkbox).
- Dostępne są akcje „zaznacz widoczne / odznacz widoczne” dla pytań po filtracji.
- Usuwanie pytania z testu korzysta z modala potwierdzenia (zamiast alert).
- Na widoku tworzenia testu dla konkretnego szkolenia pole wyboru szkolenia jest zablokowane (kontekst szkolenia narzucony trasą).
- Domyślna nazwa nowego testu: Test wiedzy.
32. Aktualizacje: dashboard i nawigacja m_szkol
- Dodano nowy dashboard modułu m_szkol w pastelowej stylistyce z klikalnymi kafelkami KPI.
- Kafelki przekierowują do odpowiednich widoków z filtrem zgodnym z kontekstem kafelka.
- Rozszerzono logikę breadcrumb/my_navbar: wejście bezpośrednio z menu resetuje ścieżkę do
home > bieżący widok.
- Przyciski „Powrót” na kluczowych widokach testów/prezentacji wykorzystują kontekst nawigacji zamiast prostego
back().
- Wprowadzono kontrolę sesji na poziomie interfejsu, aby odświeżyć widok po wygaśnięciu sesji i bezpiecznie zamknąć dostęp do danych.