# Ustalenia i otwarte zadania

Strona zbiera decyzje o Infokiosku zapisane w projekcie INF w YouTrack oraz zadania, które jeszcze nie weszły do kodu. Jest dla programistów i testerów, którzy zmieniają wyszukiwanie transportu albo obsługę BHP.

Stan na 2026-10-08, według zgłoszeń [INF-1](<https://youtrack.logintegra.com/issue/INF-1>), [INF-19](<https://youtrack.logintegra.com/issue/INF-19>), [INF-27](<https://youtrack.logintegra.com/issue/INF-27>), [INF-28](<https://youtrack.logintegra.com/issue/INF-28>), [INF-33](<https://youtrack.logintegra.com/issue/INF-33>) i [INF-34](<https://youtrack.logintegra.com/issue/INF-34>). Każdy wiersz podaje zgłoszenie, w którym decyzja jest opisana.

## Wdrożenia

Infokioski działają dziś u dwóch klientów.

| Klient | Wersja API wyszukiwania | BHP |
| --- | --- | --- |
| Atlas | API v2, token `Bearer` | tak, dokument PDF per magazyn i język |
| Netbox | API v1, stara wersja | nie, proces działa bez BHP |

Zmiana dla jednego klienta nie może zepsuć pozostałych, które nie mają kiosków albo mają starszą konfigurację ([INF-19](<https://youtrack.logintegra.com/issue/INF-19>)).

## Decyzje obowiązujące

| Temat | Decyzja | Źródło |
| --- | --- | --- |
| Wyszukiwanie transportu | dwa osobne zapytania do API v2: najpierw transport oczekujący na wjazd, potem wahadło lub przerzut | [INF-28](<https://youtrack.logintegra.com/issue/INF-28>), zweryfikowane w [INF-1](<https://youtrack.logintegra.com/issue/INF-1>) |
| Wybór transportu przy wątpliwości | kierujemy się datą okna czasowego i bierzemy transport z najstarszym oknem | [INF-1](<https://youtrack.logintegra.com/issue/INF-1>), [INF-28](<https://youtrack.logintegra.com/issue/INF-28>) |
| Transporty połączone przez Transport Combining | do obsługi wybieramy dowolny realny transport z grupy, nigdy łączący, bo ma pusty `internalIndex` | [INF-1](<https://youtrack.logintegra.com/issue/INF-1>), [INF-28](<https://youtrack.logintegra.com/issue/INF-28>) |
| Zmiany po stronie Apollo | nie robimy ich w zadaniach kiosku, brak funkcji w Apollo opisujemy osobnym zadaniem | [INF-1](<https://youtrack.logintegra.com/issue/INF-1>), [INF-28](<https://youtrack.logintegra.com/issue/INF-28>) |
| Dokument BHP | plik PDF z dysku serwera, serwowany lokalnym endpointem i wyświetlany przez pdf.js | [INF-19](<https://youtrack.logintegra.com/issue/INF-19>) |
| Języki dokumentu BHP | osobny plik PDF dla każdego języka, nazwany kodem języka | [INF-19](<https://youtrack.logintegra.com/issue/INF-19>), [INF-23](<https://youtrack.logintegra.com/issue/INF-23>) |
| Potwierdzenie BHP | przycisk akceptacji dostępny po przewinięciu dokumentu, data i godzina trafiają do Apollo razem z transportem | [INF-19](<https://youtrack.logintegra.com/issue/INF-19>) |
| Brak akcji kierowcy | po `KIOSK_SESSION_TIMEOUT` kiosk wraca na ekran startowy | [INF-19](<https://youtrack.logintegra.com/issue/INF-19>) |
| Konfiguracja kiosku | zmienne środowiskowe, część w `apollo-docker`, bez bazy danych i bez panelu administracyjnego | [INF-19](<https://youtrack.logintegra.com/issue/INF-19>) |

Szczegóły techniczne wyszukiwania opisuje strona [Integracja z Apollo i SMS](<https://docs.logintegra.com/infokiosk/integracja/index.md>). Ekrany BHP opisuje strona [Przebieg obsługi kierowcy](<https://docs.logintegra.com/infokiosk/przebieg-obslugi/index.md>).

## Znane ryzyka

Biblioteka pdf.js miała w przeszłości luki bezpieczeństwa, np. CVE-2024-4367, która pozwalała wykonać JavaScript przez spreparowany plik PDF. Implementacja z [INF-19](<https://youtrack.logintegra.com/issue/INF-19>) wyświetla PDF-y przez pdf.js, więc bibliotekę trzeba aktualizować. Pliki PDF pochodzą od klienta, więc przed wdrożeniem warto sprawdzić ich źródło.
