Infokiosk¶
Infokiosk to aplikacja webowa z ekranem dotykowym, która stoi na bramie magazynu i rejestruje przyjazd kierowcy. Dokumentacja jest dla programistów i administratorów, którzy rozwijają, konfigurują albo uruchamiają kiosk.
Kierowca wpisuje numer rejestracyjny pojazdu i kiosk szuka jego transportu w Apollo. Na numer telefonu z awizacji przychodzi kod SMS. Po wpisaniu poprawnego kodu kiosk potwierdza w Apollo status przyjazdu.
Czym jest aplikacja¶
| Element | Wartość |
|---|---|
| Język | Kotlin 1.8.21 |
| Framework | Spring Boot 3.1.0, Spring MVC, Thymeleaf |
| Klient HTTP | OkHttp 4.10.0 |
| Serializacja | kotlinx-serialization 1.5.0 i Jackson |
| Runtime | Java 17 |
| Budowanie | Gradle z Kotlin DSL, style kompilowane z SCSS |
| Wersja aplikacji | 1.2.0 w build.gradle.kts na gałęzi develop |
| Baza danych | brak |
Aplikacja nie ma bazy danych. Stan obsługi jednego kierowcy trzyma w sesji HTTP, a sesja kończy się po zakończeniu albo odrzuceniu weryfikacji.
Zależności od innych systemów¶
| System | Po co |
|---|---|
| Apollo | wyszukanie transportu, potwierdzenie statusu, potwierdzenie warunków BHP, odświeżanie tokenu |
| Mikroserwis SMS | wysyłka kodu SMS do kierowcy |
Szczegóły wywołań opisuje strona Integracja z Apollo i SMS.
Strony dokumentacji¶
| Strona | Zawartość |
|---|---|
| Przebieg obsługi kierowcy | kolejne ekrany, warunki przejść i komunikaty błędów |
| Integracja z Apollo i SMS | wywołania zewnętrzne, autoryzacja tokenem, filtrowanie transportów |
| Konfiguracja | wszystkie zmienne środowiskowe z domyślnymi wartościami |
| Uruchomienie i budowanie | lokalnie, w IntelliJ i w Dockerze, testy |
| Ustalenia i otwarte zadania | decyzje z projektu INF w YouTrack i zmiany jeszcze niewdrożone |
Języki interfejsu¶
Kiosk ma pliki komunikatów dla czterech języków: angielskiego, polskiego, rosyjskiego i ukraińskiego.
Domyślny jest angielski, a język wybiera kierowca na ekranie startowym.
Flaga rosyjska pojawia się tylko wtedy, gdy ustawimy KIOSK_SHOW_RUSSIAN_LANGUAGE=true.
Ostatnia zmiana: 2026-10-28 · pawel.staniszewski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e