# 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](<https://docs.logintegra.com/infokiosk/integracja/index.md>).

## Strony dokumentacji

| Strona | Zawartość |
| --- | --- |
| [Przebieg obsługi kierowcy](<https://docs.logintegra.com/infokiosk/przebieg-obslugi/index.md>) | kolejne ekrany, warunki przejść i komunikaty błędów |
| [Integracja z Apollo i SMS](<https://docs.logintegra.com/infokiosk/integracja/index.md>) | wywołania zewnętrzne, autoryzacja tokenem, filtrowanie transportów |
| [Konfiguracja](<https://docs.logintegra.com/infokiosk/konfiguracja/index.md>) | wszystkie zmienne środowiskowe z domyślnymi wartościami |
| [Uruchomienie i budowanie](<https://docs.logintegra.com/infokiosk/uruchomienie/index.md>) | lokalnie, w IntelliJ i w Dockerze, testy |
| [Ustalenia i otwarte zadania](<https://docs.logintegra.com/infokiosk/ustalenia/index.md>) | 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`.
