Przejdź do treści

Przebieg obsługi kierowcy

Strona opisuje kolejne ekrany kiosku i warunki przejść między nimi. Jest dla programistów, którzy zmieniają przepływ, i dla osób, które diagnozują zgłoszenia kierowców.

Cały przepływ obsługuje jeden kontroler, AppController. Stan kierowcy trzyma obiekt SessionData zapisany w sesji HTTP.

Przepływ

flowchart TD
    start["/ ekran startowy i wybór języka"] --> step["/selectStepType"]
    step --> input["/inputData numer rejestracyjny"]
    input -->|"jeden transport albo wybór automatyczny"| accept{"BHP wymagane?"}
    input -->|"kilka transportów, wybiera kierowca"| select["/selectTransport"]
    input -->|"brak, za wcześnie, za późno"| fail["/validationFalse"]
    input -->|"wyjątek"| err["/error"]
    select --> accept
    accept -->|"tak"| cond["/acceptConditions"]
    accept -->|"nie"| sms["/inputSms"]
    cond --> sms
    sms -->|"poprawny kod"| done["/end"]
    sms -->|"zły kod, są próby"| sms
    sms -->|"zły kod, brak prób"| fail
    classDef problem stroke:#d9534f,stroke-width:2px;
    class fail,err problem

Czerwone obramowanie oznacza ekran kończący obsługę błędem.

Ekrany

Adres Co się dzieje
/ ekran powitalny z wyborem języka, kończy poprzednią sesję
/selectStepType wybór typu kroku, gdy KIOSK_SELECT_STEP_TYPE=true, w przeciwnym razie przekierowanie do /inputData
/inputData wpisanie numeru rejestracyjnego, wysłanie formularza szuka transportu w Apollo
/selectTransport lista transportów, gdy numer pasuje do kilku i KIOSK_AUTO_SELECT_EARLIEST=false, posortowana po początku okna czasowego
/transportSelected wybór jednego transportu z listy, parametr transportId
/acceptConditions dokument PDF z BHP w języku kierowcy, tylko gdy REQUIRE_ACCEPTATION=true
/documentAccepted zapamiętanie akceptacji i przejście do /inputSms
/inputSms GET wysyła kod SMS, POST sprawdza kod wpisany przez kierowcę
/end potwierdzenie rejestracji, kończy sesję
/validationFalse komunikat o nieudanej weryfikacji, kończy sesję
/error ogólny komunikat o błędzie

Dwa dodatkowe adresy zwracają pliki z dysku serwera:

Adres Plik
/customerLogo obraz PNG ze ścieżki CUSTOMER_LOGO_SOURCE
/customerDocumentPdf/{plik} dokument PDF z katalogu ACCEPTATION_FILES_PATH

Pliki dokumentów BHP nazywamy kodem języka, np. pl.pdf, en.pdf i ukr.pdf.

Wyszukanie transportu

Wysłanie formularza z numerem rejestracyjnym woła ApolloService.getTransports. Numer jest zamieniany na wielkie litery, a spacje są usuwane. Rezultat zależy od liczby znalezionych transportów.

Wynik Następny ekran
jeden transport /acceptConditions, gdy BHP wymagane, w przeciwnym razie /inputSms
kilka transportów /selectTransport, a przy KIOSK_AUTO_SELECT_EARLIEST=true kiosk obsługuje transport z najwcześniejszym oknem i pomija listę
brak transportów /validationFalse z błędem TRANSPORT_NOT_FOUND

Zasady, według których kiosk odrzuca i wybiera transporty, opisują sekcje "Filtrowanie transportów" i "Dwa zapytania i wybór transportu" na stronie Integracja z Apollo i SMS.

Błędy weryfikacji

Ekran /validationFalse dostaje typ błędu i pokazuje odpowiedni komunikat.

Typ błędu Przyczyna
TRANSPORT_NOT_FOUND Apollo nie zwróciło transportu albo żaden nie ma okna czasowego w magazynach kiosku
TRANSPORT_OUTSIDE_OF_INTERVAL Apollo odpowiedziało kodem 302 z opisem błędu
DRIVER_TOO_EARLY koniec najbliższego okna czasowego jest późniejszy niż teraz plus KIOSK_TIME_WINDOW_INTERVAL godzin
DRIVER_TOO_LATE początek najbliższego okna czasowego jest wcześniejszy niż teraz minus KIOSK_TIME_WINDOW_INTERVAL godzin

W obu komunikatach o czasie kiosk pokazuje kierowcy okno czasowe, które znalazł. Po błędzie kierowca wraca na ekran startowy i próbuje ponownie.

Kod SMS

Pierwsze wejście na /inputSms generuje kod i wysyła go przez mikroserwis SMS. Kod ma KIOSK_SMS_CODE_LENGTH znaków i składa się z wielkich liter oraz cyfr. Kolejne wejścia na ten adres w tej samej sesji nie wysyłają SMS ponownie.

Porównanie kodu nie rozróżnia wielkości liter. Po złym kodzie licznik prób rośnie, a kiosk pokazuje ekran kodu jeszcze raz. Gdy licznik osiągnie KIOSK_MAX_NUMBER_OF_SMS_RETRIES, kolejny zły kod kończy obsługę na /validationFalse.

Przy domyślnej wartości 1 kierowca ma więc dwie próby wpisania kodu.

Potwierdzenie w Apollo

Poprawny kod uruchamia dwa wywołania do Apollo. Najpierw kiosk potwierdza status przyjazdu transportu. Jeśli kierowca zaakceptował dokument BHP, kiosk potwierdza też warunki.

Błąd potwierdzenia statusu przerywa obsługę i kieruje na /error. Błąd potwierdzenia warunków BHP trafia tylko do logu, a obsługa kończy się na /end.

Ostatnia zmiana: 2026-10-08 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e