@extends('layouts.site') @php $my_name_view = 'SZKOL - Baza Wiedzy'; $my_short_view_name = 'Baza wiedzy'; @endphp @section('title','Baza Wiedzy') @section('content')

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.
@endsection @section('menu') @include('sites.szkol.menu_szkol') @endsection @section('navbar') @include('sites.szkol._navbar_szkol') @endsection @push('scripts') @endpush