Dokumentacja

Spis treści

1. Cel aplikacji
2. Wymagania i dostęp
3. Logowanie
4. Ekrany aplikacji
5. Pracownicy i karty
6. Import CSV
7. Historia kart pracownika
8. Generowanie raportu
9. Interpretacja wyników
10. Eksport raportu
11. Najczęstsze problemy
12. Checklista pracy
13. Słownik pojęć

1. Cel aplikacji

RCP WorkBox służy do przygotowywania raportów czasu pracy pracowników na podstawie odbić kart w systemie Navifleet. Aplikacja pobiera zdarzenia z API, przypisuje je do pracowników i wylicza czas pracy dla każdej zmiany.

System zakłada użycie dwóch czytników:

• czytnik wejść — zapisuje kod wejścia pracownika,
• czytnik wyjść — zapisuje kod wyjścia, generowany automatycznie jako pierwszy bajt kodu wejścia + pozostałe 5 bajtów w odwróconej kolejności.

2. Wymagania i dostęp

Do korzystania z aplikacji wymagane są:

• konto użytkownika Navifleet,
• nadane uprawnienie do aplikacji RCP WorkBox przez administratora,
• dostęp do przeglądarki internetowej,
• połączenie z internetem, jeżeli raport ma być generowany z rzeczywistych danych Navifleet.

Uprawnienie do aplikacji jest sprawdzane lokalnie. Oznacza to, że samo konto Navifleet nie wystarczy — login musi być dopisany do listy użytkowników uprawnionych.

3. Logowanie

4. Ekrany aplikacji

5. Pracownicy i karty

Przed wygenerowaniem raportu należy mieć wprowadzoną listę pracowników oraz przypisane do nich karty. Każdy pracownik może mieć jedną lub wiele kart w różnych okresach.

5.1 Dodanie pracownika ręcznie

1. Przejdź do ekranu Pracownicy i karty.
2. W sekcji Dodaj / edytuj pracownika wpisz imię i nazwisko albo nazwę pracownika.
3. Wybierz status: Aktywny albo Nieaktywny.
4. Kliknij Zapisz pracownika.
5. Na końcu kliknij Zapisz w bazie danych, aby utrwalić zmiany.

5.2 Dodanie karty pracownikowi

1. W sekcji Dodaj przypisanie karty wybierz pracownika.
2. Wpisz Kod wejścia.
3. Kod wyjścia zostanie wygenerowany automatycznie.
4. Podaj datę Ważna od.
5. Opcjonalnie podaj datę Ważna do. Puste pole oznacza „nadal”.
6. Kliknij Zapisz przypisanie karty.
7. Kliknij Zapisz w bazie danych.

6. Import CSV

Import CSV pozwala szybko dodać większą listę pracowników.

6.1 Format pliku CSV

Obsługiwany format:

kod_karty;Pracownik;data_od;data_do;

Przykłady:

0000009D3877;Jan Kowalski;2026-05-01;
0000009D4F69;Anna Nowak;2026-05-01;2026-05-31;
0000009DB3C8;Piotr Zieliński;;

6.2 Import krok po kroku

1. Przejdź do ekranu Pracownicy i karty i kliknij Importuj CSV w dolnym pasku. Z prawej otworzy się panel importu.
2. Wybierz plik CSV albo przeciągnij go na pole pliku. Wzór pliku pobierzesz linkiem Pobierz wzór CSV.
3. Ustaw Domyślną datę „ważna od” — zostanie użyta dla wierszy bez daty od.
4. Wybierz tryb importu:
   • Dopisz do obecnej listy — dodaje pracowników z pliku do aktualnej listy,
   • Zastąp całą listę — usuwa obecnych pracowników i ich karty, zostają tylko pracownicy z pliku. Aplikacja poprosi o potwierdzenie.
5. Sprawdź podgląd: liczbę kart do importu, pominięte wiersze (z numerem wiersza i powodem) oraz wynik walidacji konfliktów kart.
6. Kliknij Importuj. Dane zostaną od razu zapisane w bazie. Przycisk jest nieaktywny, dopóki plik zawiera konflikty kart.

Pierwszy wiersz z nagłówkiem (cardCode;Pracownik;validFrom;validTo;) i puste linie są pomijane.

7. Historia kart pracownika

System pozwala przypisać jednemu pracownikowi kilka kart w różnych okresach. Jest to potrzebne, gdy karta została zgubiona, uszkodzona albo oddana i później wykorzystana u innego pracownika.

7.1 Przykład poprawnej historii

Pracownik 1
- karta 0000009D3877 od 2026-05-01 do 2026-05-15
- karta 0000009DB3C8 od 2026-05-16 do nadal

7.2 Walidacja konfliktów

Aplikacja sprawdza, czy ta sama karta lub odpowiadający jej kod wyjścia nie występuje w nakładających się okresach.

8. Generowanie raportu

8.1 Wybór zakresu

Na ekranie Raport RCP wybierz:

• Od — początek raportu,
• Do — koniec raportu,
• Bufor pobierania danych — dodatkowy czas przed i po zakresie, przydatny przy zmianach przechodzących przez północ,
• Maksymalny czas pracy — zabezpieczenie przed błędnym sparowaniem wejścia i wyjścia,
• Ignoruj duplikat odbicia do — czas, w którym powtórne odbicie tego samego typu jest ignorowane jako duplikat.

8.2 Tryb demo

Jeżeli zaznaczony jest Tryb demo, aplikacja używa pliku demo-alerts.json zamiast pobierać rzeczywiste dane z Navifleet.

8.3 Uruchomienie raportu

1. Wybierz zakres dat.
2. Ustaw parametry raportu.
3. Odznacz tryb demo, jeśli chcesz pobrać dane rzeczywiste.
4. Kliknij Pobierz i przelicz.
5. Po zakończeniu sprawdź sekcję Wyniki i Nieznane odbicia.

9. Interpretacja wyników

9.1 Kolumny raportu

9.2 Statusy

9.3 Nieznane odbicia

Sekcja Nieznane odbicia pokazuje zdarzenia, których nie udało się przypisać do pracownika.

10. Eksport raportu

10.1 Eksport CSV

Po wygenerowaniu raportu można użyć przycisku eksportu CSV, jeżeli jest dostępny w danej wersji interfejsu. Plik CSV można otworzyć w Excelu, LibreOffice lub Google Sheets.

10.2 Eksport XLSX

Przycisk Eksportuj raport w sekcji Wyniki generuje plik XLSX. Eksport jest dostępny po wygenerowaniu raportu.

Plik XLSX może zawierać arkusze:

• Raport — szczegółowe pozycje raportu,
• Podsumowanie — suma czasu pracy per pracownik,
• Nieznane odbicia — zdarzenia nierozpoznane.

11. Najczęstsze problemy i rozwiązania

12. Checklista pracy użytkownika

12.1 Pierwsze uruchomienie

1. Zaloguj się do aplikacji.
2. Przejdź do Pracownicy i karty.
3. Zaimportuj plik CSV albo dodaj pracowników ręcznie.
4. Sprawdź komunikat walidacji.
5. Kliknij Zapisz w bazie danych.
6. Przejdź do Raport RCP.
7. Wygeneruj raport testowy.

12.2 Codzienna / cykliczna praca

1. Zaloguj się.
2. Sprawdź, czy lista pracowników jest aktualna.
3. Wybierz zakres raportu.
4. Odznacz tryb demo, jeśli generujesz raport produkcyjny.
5. Kliknij Pobierz i przelicz.
6. Sprawdź statusy problemowe i nieznane odbicia.
7. Wyeksportuj raport do XLSX lub CSV.
8. Wyloguj się po zakończeniu pracy.

13. Słownik pojęć

14. Uwagi końcowe

Instrukcja opisuje sposób pracy z aplikacją od strony użytkownika. W razie problemów z logowaniem, bazą danych, konfiguracją API lub wdrożeniem należy skontaktować się z administratorem technicznym aplikacji.