Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 17 miesięcy (ostatni commit: 2025-05-30, Dariusz Bąkowski). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

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
A-14925

Ostatnia zmiana: 2025-05-30 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e