Dokumentacja użytkownika SZKOL
Ten material prowadzi krok po kroku przez glowny przeplyw pracy: od logowania, przez obsługę moduow,
po eksport danych i zgłoszenia. Sekcje są przygotowane pod uzupelnienie o zrzuty ekranowe.
1. Start i zakres dokumentacji
Dokumentacja obejmuje działanie aplikacji ODO od momentu wejscia do systemu az po codzienna prace na rejestrach i formularzach.
Material jest napisany tak, aby nowy użytkownik mogl samodzielnie wykonać podstawowe i zaawansowane operacje.
Logowanie
Nawigacja
Rejestry
Zarzadzanie
Eksport
2. Logowanie i bezpieczenstwo
- Użytkownik otwiera strone logowania i podaje login oraz hasło.
- Po poprawnym logowaniu system przekierowuje do obszaru aplikacji.
- Uprawnienia do funkcji są nadawane rolami i zakresem dostępu.
- Brak uprawnień powoduje ukrycie opcji menu lub brak możliwości operacji.
Rekomendacja: po zakończeniu pracy wyloguj się i nie pozostawiaj aktywnej sesji bez nadzoru.
Miejsce na zrzut ekranu: logowanie
Podmien zawartosc tymczasowa na screenshot ekranu logowania i komunikatów walidacyjnych.
3. Uklad aplikacji i nawigacja
- Lewa kolumna: menu glowne z grupami funkcji.
- Gorny pasek: breadcrumb i szybki podgląd aktualnego miejsca.
- Środek: 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 modułów.
- Przejście do modułów zarzadzania i rejestrów.
- Kontrola kontekstu organizacyjnego (zależne od uprawnień).
- Szybki dostęp do codziennie uzywanych obszarow.
5. Zarzadzanie: Procesy Kafelki
Widok kafelkowy wspiera szybkie przejście do procesów wedlug obszarow organizacyjnych.
- Nawigacja po jednostkach i procesach.
- Podgląd statusu i podstawowych metryk procesu.
- Przejście do szczegółów procesu.
6. Zarzadzanie: Procesy Lista
Centralny widok listy procesów. Umożliwia wyszukiwanie, filtrowanie i akcje na rekordach.
- Filtry statusu i kryteriow wyszukiwania.
- Operacje na rekordzie: edycja, podgląd, usuwanie, pliki.
- Eksport listy do DOC/XLS/CSV/PDF.
Miejsce na zrzut ekranu: tabela procesów i przyciski akcji
Sugerowany plik: 02-procesy-lista.png
7. Zarzadzanie: Umowy Powierzenia
- Dodawanie i edycja umów powierzenia.
- Powiązanie umowy z podmiotem, zakresem i okresem obowiazywania.
- Obsługa dokumentów powiazanych z umowa.
- Zmiany statusu i usuwanie rekordów.
8. Zarzadzanie: Udostepnienia Danych
- Rejestrowanie podmiotu wnioskujacego i celu udostepnienia.
- Obsługa statusu zatwierdzenia przez IOD.
- Zapisywanie daty faktycznego udostepnienia.
- Historia operacji i edycja wpisów.
9. Zarzadzanie: Upoważnienia do PDO
- Nadawanie upowaznien i okreslanie zakresu.
- Data nadania i data odebrania upoważnienia.
- Status aktualnosci i przeglad szczegółów osoby.
- Obsuga dokumentów 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 procesów.
- Ocena postępu analizy i status roboczy/zapisany.
- Druk podglądu oraz eksport.
12. Zarzadzanie: Oceny Skutkow (DPIA)
- Tworzenie oceny skutkow dla wskazanych procesów.
- Kontrola stanu wykonania i dat zatwierdzenia.
- Widoki podglądu i raportowania.
13. Rejestr Czynności
- Wybieranie ADO i zatwierdzenie wyboru jako warunek aktywacji eksportu.
- Widok danych adresowych i szczegółów rejestru.
- Eksport danych i wydruki wg ustalonego standardu.
Jezeli ADO nie jest wybrane, akcje eksportu są nieaktywne, a system wyświetla komunikat podpowiedzi.
14. Rejestr Kategorii Czynności
- Widok rozszerzonych danych kategorii przetwarzan.
- Informacje o srodkach bezpieczenstwa i transferach danych.
- Eksport dokumentacyjny w orientacji poziomej.
15. Rejestr Umów Powierzenia
- Lista umów z danymi podmiotu i zakresem umowy.
- Status obowiazywania i historia dokumentów.
- 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
- Podgląd numerow upowaznien, statusów i zakresu.
- Dane osoby i przynaleznosc do komorek organizacyjnych.
- Eksport zbiorczy i wydruki dokumentów.
18. Dokumenty: Generator i Lista
- Wzory dokumentów: tworzenie i utrzymanie szablonów.
- Wygenerowane dokumenty: lista, filtrowanie, pobieranie.
- Spojnosc z danymi z rejestrów i procesów.
Miejsce na zrzut ekranu: generator dokumentów
Sugerowany plik: 03-generator-dokumentów.png
19. Zgłoszenia i obieg informacji
- Formularz: potrzeba kontaktu z IOD.
- Formularz: zgłoszenie nowego procesu.
- Formularz: zgłoszenie naruszenia.
- Widok "Moje zgłoszenia" do sledzenia statusów.
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/usunięcia/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 rekordów bez sprawdzenia powiązań i historii dokumentów.
- W zgloszeniach dodawaj komplet informacji, aby skrocic czas obslugi.
22. Najczestsze problemy i rozwiazania
- Brak przycisków lub sekcji: sprawdź role i zakres uprawnień.
- Brak eksportu: sprawdź czy wymagany kontekst (np. wybor ADO) został zatwierdzony.
- Nieprawidłowe dane na liscie: odswiez filtry i ustawienia sortowania.
- Brak reakcji po kliknieciu: sprawdź czy popup/modal nie jest blokowany przez przegladarke.
Miejsce na zrzut ekranu: przyklady komunikatów i błędów
Sugerowany plik: 04-komunikaty-systemowe.png
23. Mapa widoków ODO i funkcjonalnosci
Ponizej znajduje się praktyczna mapa najwazniejszych widoków ODO wraz z zakresem operacji, jakie użytkownik może wykonać.
| Widok / trasa |
Przeznaczenie |
Kluczowe operacje |
m_odo_proces_kafelki_dzial |
Szybki podgląd procesów po komorkach organizacyjnych. |
Wejscie do listy procesów, podgląd statusów i przejście do szczegółów procesu. |
m_odo_proces_lista_index |
Glowna lista procesów 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} |
Szczegóły 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 procesów, eksporty i podglady. |
m_odo_proces_udostepnienia_danych_rejestr* |
Rejestr udostepnien danych i obsługa statusów. |
Dodawanie wpisów, walidacja, zmiana statusu i kontrola dat potwierdzenia. |
m_odo_proces_upowaznienia_rejestr* |
Rejestr upowaznien do przetwarzania danych. |
Zarzadzanie statusem upoważnienia, 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 |
Obsługa analiz ryzyka i ocen skutkow (DPIA). |
Tworzenie i edycja analiz, podglady raportow, eksporty i wydruki. |
m_odo_rejestr_* |
Rejestry formalne ODO (czynności, kategorie, umowy, udostepnienia, upoważnienia). |
Przeglad i utrzymanie danych rejestrowych, eksport dokumentacyjny. |
m_odo_dokumenty_wzory
m_odo_dokumenty_lista |
Generator dokumentów i lista dokumentów wygenerowanych. |
Tworzenie dokumentu z danych systemowych, pobieranie i archiwizacja. |
m_odo_zgl_rejestr_zgloszen |
Obsługa zgłoszeń użytkownika. |
Podgląd statusów zgłoszeń 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-widoków-odo.png
24. Komponenty globalne - jak używać
Modul ODO wykorzystuje wspolne komponenty. Prawidlowe uzycie zapewnia spojna walidacje, styl i zachowanie we wszystkich widokach.
| Komponent |
Zastosowanie |
Jak używać 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 włącz doc-landscape. |
view-graph-export-buttons |
Eksport widoków grafowych (np. drzewo struktury). |
Użyj 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 są 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 filtrów wyświetla status i przycisk czyszczenia filtrów. |
ajax-pagination-controls + records-per-page-selector + ajax-records-count |
Paginacja i informacje o rekordach. |
Pokazuje liczbe rekordów po filtrach oraz liczbe wszystkich rekordów. |
view-close-button |
Zamykanie aktualnego widoku i powrót do nadrzednego. |
Dodawaj w prawym gornym rogu sekcji z akcjami. |
Komponenty powinny być 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, uzupełnij pola wymagane, zapisz, sprawdź komunikat i podswietlenie rekordu.
Scenariusz B - Zmiana statusu: na liscie kliknij status, zweryfikuj dane informacyjne w modalu, zatwierdz akcje i sprawdź powiadomienie.
Scenariusz C - Eksport raportu: ustaw filtry, wybierz kolumny, uruchom eksport PDF/DOC i porownaj, czy plik odzwierciedla aktualny widok.
Scenariusz D - Obsługa plików: w szczegolach procesu dodaj załącznik, sprawdź walidacje pola pliku, potwierdz widoczność pliku w sekcji "Załączniki".
Scenariusz E - Rejestr czynności: wybierz ADO i zatwierdz wybor, wygeneruj eksport i sprawdź 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-załączniki.png
26. Lista zrzutow ekranowych do uzupełnienia
- Widok logowania i komunikaty walidacji.
- Panel glowny ODO po zalogowaniu.
- Procesy lista: filtry, akcje i statusy.
- Szczegóły procesu i sekcja załączników.
- Modal add/edit/delete/status/info zgodny ze standardem.
- Rejestr czynności: wybor ADO i eksport.
- Dokumenty: wzory i lista dokumentów.
- Statystyki: wykresy i tabela porownawcza.
- Zgłoszenia: formularze i lista "Moje zgłoszenia".
Kazdy screenshot powinien zawierac krótki podpis: co użytkownik 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.