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:
-
Task ma włączoną flagę na częstotliwość kontroli
task.chanceOfRandomInspection >= 0.0- Wartość musi być większa niż 0 (przypadek
chanceOfRandomInspection = 0oznacza brak kontroli) - Brak wartości również oznacza brak kontroli
-
Magazyn umożliwia przeprowadzenie kontroli
warehouse.inspectionIsPossible = true
-
Transport został wylosowany do kontroli
- Wynik losowania dla pary transport-task wynosi
wasSelected = true
- Wynik losowania dla pary transport-task wynosi
Proces losowania¶
Moment wykonania¶
Losowanie przeprowadzane jest w momencie tworzenia transportu.
Algorytm losowania¶
- Sprawdzenie czy task ma skonfigurowaną częstotliwość losowania
- Weryfikacja czy wynik losowania już istnieje dla danej pary transport-task
- 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¶
Ostatnia zmiana: 2025-05-30 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e