# Losowanie Kontroli Transportów

## Cele

- Generowanie checkpoint-ów związanych z kontrolą w oparciu o wynik losowania
- Wykorzystanie parametru częstotliwości kontroli z taska
- Sprawdzenie możliwości przeprowadzenia kontroli w magazynie

## Komponenty w kodzie

### 1\. Domena - InspectionLotteryResult

Klasa domenowa przechowująca wyniki losowania kontroli:

**Pola:** - `transport` - transport, dla którego przeprowadzono losowanie - `task` - task zawierający konfigurację losowania - `wasSelected` - wynik losowania (true = wylosowano do kontroli) - `dateCreated` - data utworzenia wpisu

**Indeksy:** - `inspection_lottery_result_transport_index` - dla wydajnego wyszukiwania po transporcie - `inspection_lottery_result_task_index` - dla wydajnego wyszukiwania po tasku

### 2\. Serwis losowania - InspectionLotteryService

Główny serwis odpowiedzialny za przeprowadzanie losowania kontroli.

#### Metody

**`handleInspectionLotteryForTransportCreation(Transport transport)`** - Wywoływana przy tworzeniu nowego transportu - Przeprowadza losowanie dla wszystkich tasków w typie transportu spełniających warunek `chanceOfRandomInspection > 0`

**`doLottery(Transport transport, Task task)`** - Przeprowadza losowanie dla konkretnej pary transport-task - Sprawdza czy task ma skonfigurowaną częstotliwość losowania (`chanceOfRandomInspection`) - Zapewnia jednorazowość losowania - jeśli wynik już istnieje, zwraca istniejący - Porównuje wylosowaną wartość z progiem określonym w tasku

### 3\. Logika generowania checkpoint-ów

Implementowana w metodzie `isTaskApplicable()`, która określa czy task powinien wygenerować checkpoint.

## Warunki generowania checkpoint-u

Checkpoint związany z kontrolą zostanie wygenerowany tylko wtedy, gdy spełnione są **wszystkie** następujące warunki:

1. **Task ma włączoną flagę na częstotliwość kontroli**

   - `task.chanceOfRandomInspection >= 0.0`
   - Wartość musi być większa niż 0 (przypadek `chanceOfRandomInspection = 0` oznacza brak kontroli)
   - Brak wartości również oznacza brak kontroli
2. **Magazyn umożliwia przeprowadzenie kontroli**

   - `warehouse.inspectionIsPossible = true`
3. **Transport został wylosowany do kontroli**

   - Wynik losowania dla pary transport-task wynosi `wasSelected = true`

## Proces losowania

### Moment wykonania

Losowanie przeprowadzane jest w momencie **tworzenia transportu**.

### Algorytm losowania

1. Sprawdzenie czy task ma skonfigurowaną częstotliwość losowania
2. Weryfikacja czy wynik losowania już istnieje dla danej pary transport-task
3. Jeśli wynik nie istnieje:

   - Wygenerowanie liczby losowej z zakresu \[0.0, 1.0)
   - Porównanie z progiem `task.chanceOfRandomInspection`
   - Zapisanie wyniku w bazie danych

### Zapewnienie spójności

Dla tej samej pary transport-task losowanie zostanie przeprowadzone tylko raz. Kolejne wywołania zwracają już istniejący wynik.

## Przykłady użycia

### Scenariusz 1: Transport wylosowany do kontroli

```
Transport ID: 12345
Task: chanceOfRandomInspection = 0.3 (30%)
Wylosowana wartość: 0.25
Wynik: wasSelected = true (0.25 < 0.3)
Checkpoint kontroli: WYGENEROWANY
```

### Scenariusz 2: Transport nie wylosowany do kontroli

```
Transport ID: 12346
Task: chanceOfRandomInspection = 0.2 (20%)
Wylosowana wartość: 0.75
Wynik: wasSelected = false (0.75 >= 0.2)
Checkpoint kontroli: NIE WYGENEROWANY
```

## Konfiguracja

### Parametry tasku

- `chanceOfRandomInspection` - prawdopodobieństwo wylosowania do wygenerowania checkpointu (zakres 0.0-1.0)

  - 0.0 = brak kontroli
  - 1.0 = każdy transport do kontroli
  - null/undefined = brak losowania kontroli

### Parametry magazynu

- `inspectionIsPossible` - flaga określająca czy magazyn może przeprowadzać kontrole

## Powiązane zadania

[PR-25](<https://youtrack.logintegra.com/issue/PR-25/Hochland-kontrola>)  
[A-14925](<https://youtrack.logintegra.com/issue/A-14925>)
