150 lines
8.1 KiB
Markdown
150 lines
8.1 KiB
Markdown
## 1) "Manažerský souhrn"
|
||
|
||
- Pipeline je vícekroková, deterministická a auditovaná přes `EvaluationRunEvent`.
|
||
- Pořadí: Prepare → Parse → Build working set → Match → Unpaired → Duplicity → Score → Aggregate → Overrides → Ranks → Finalize.
|
||
- Kritické kontroly: párování QSO (včetně chyb exchange), klasifikace nenapárovaných (NIL/NO_COUNTERPART/UNIQUE), duplicity, out-of-window.
|
||
- Body se počítají podle rulesetu: FIXED_POINTS nebo DISTANCE; politika chyb rozhoduje o validitě, bodech a penalizacích.
|
||
- Systém má tři „čekací“ body pro ruční kontrolu (input, matching, score) a podporuje ruční override logů/QSO.
|
||
|
||
## 2) Podrobný popis pipeline (technicky)
|
||
|
||
### Spuštění a příprava
|
||
|
||
1) **StartEvaluationRunJob / EvaluationCoordinator**
|
||
- Kontrola locku pro dané kolo (`evaluation:round:{round_id}`), přechod do `RUNNING`.
|
||
- Spuštění řetězce jobů (prepare → parse logs).
|
||
|
||
2) **PrepareRunJob**
|
||
- Vyčistí staging data (`qso_results`, `log_results`, `working_qsos`) pro daný run.
|
||
- Sestaví scope skupin (band/category/power) a uloží do `evaluation_runs.scope`.
|
||
- Vytvoří skeleton `log_results` pro všechny logy (včetně aplikace log overrides na band/kategorii/power).
|
||
- Zapisuje auditní eventy.
|
||
|
||
### Parsování vstupů a working set
|
||
|
||
3) **DispatchParseLogsJobsJob → ParseLogJob**
|
||
- Pro každý log načte EDI a naplní `logs` + `log_qsos`.
|
||
- Průběžný progress, chybné soubory jsou hlášeny jako eventy.
|
||
- Pro `rules_version=CLAIMED` se aktualizují deklarované výsledky.
|
||
|
||
4) **DispatchBuildWorkingSetJobsJob → BuildWorkingSetLogJob**
|
||
- Vytvoří `working_qsos` (normalizace callsignů, lokátorů, band, match_key, dupe_key).
|
||
- Kontroly:
|
||
- validace lokátoru (invalid → error v `working_qsos.errors`),
|
||
- out-of-window podle času kola,
|
||
- normalizace a klíče pro matching/duplikace.
|
||
- Logy s override `IGNORED` se vynechají.
|
||
- Po dokončení: **PauseEvaluationRunJob → WAITING_REVIEW_INPUT**.
|
||
|
||
### Matching a klasifikace nenapárovaných
|
||
|
||
5) **DispatchMatchJobsJob → MatchQsoBucketJob (PASS 1 + PASS 2)**
|
||
- Matching běží v „bucketu“ (band + call_norm), dvě fáze:
|
||
- PASS 1: pouze exact shody.
|
||
- PASS 2: u zbylých QSO povolí fuzzy shody dle rulesetu (tolerance, time shift, Levenshtein).
|
||
- Kontroly během matchingu:
|
||
- časová tolerance (`time_tolerance_sec`),
|
||
- mismatch exchange (callsign/RST/serial/locator) dle `discard_qso_*`,
|
||
- time mismatch se jen označí, validita se řeší až ve scoringu,
|
||
- ruční QSO override může vynutit match nebo status.
|
||
- Výstup: `qso_results` s `matched_log_qso_id`, `error_code`, `error_side`, `match_type`.
|
||
|
||
6) **DispatchUnpairedJobsJob → UnpairedClassificationBucketJob**
|
||
- Pro nenapárované QSO určí:
|
||
- `NOT_IN_COUNTERPART_LOG` (protistanice log má),
|
||
- `NO_COUNTERPART_LOG` (protistanice log nemá),
|
||
- `UNIQUE` (pokud je zapnuté `require_unique_qso`).
|
||
- Nastaví `error_code`, `is_nil`, `is_valid=false` (validita se následně řeší policy ve scoringu).
|
||
|
||
7) **DuplicateResolutionJob**
|
||
- Zpracuje duplicity v rámci logu podle `dupe_scope` (BAND/BAND_MODE).
|
||
- Strategie výběru „přeživšího“ QSO: `dup_resolution_strategy` (typicky paired_first → ok_first → earlier_time → lower_id).
|
||
- Non‑survivory se označí `DUP` a připraví se na policy v bodech.
|
||
- Po dokončení: **PauseEvaluationRunJob → WAITING_REVIEW_MATCH**.
|
||
|
||
### Bodování a agregace
|
||
|
||
8) **DispatchScoreJobsJob → ScoreGroupJob**
|
||
- Pro každé QSO spočte základní body:
|
||
- `FIXED_POINTS`: `points_per_qso`
|
||
- `DISTANCE`: vzdálenost z lokátorů × `points_per_km`
|
||
- vzdálenost se zaokrouhluje (`distance_rounding`) a respektuje `min_distance_km`.
|
||
- Policy rozhodnutí (error_code → policy):
|
||
- `INVALID` → `is_valid=false`
|
||
- `ZERO_POINTS` → 0 bodů
|
||
- `FLAG_ONLY` → body beze změny
|
||
- `PENALTY` → 0 bodů + penalizace (u `BUSTED_RST` může body ponechat)
|
||
- Aplikuje se out‑of‑window policy (`out_of_window_policy`).
|
||
- Výsledky: `points`, `penalty_points`, multiplikátor (WWL/DXCC/SECTION/COUNTRY) pro pozdější agregaci.
|
||
|
||
9) **DispatchAggregateResultsJobsJob → AggregateLogResultsJob**
|
||
- Sečte `base_score` (validní QSO) a `penalty_score` (odečet penalizací).
|
||
- Pokud jsou multiplikátory aktivní: `multiplier_score = (base + penalty) × multiplier_count`.
|
||
- `official_score = max(0, multiplier_score)`.
|
||
- Počítá statistiky: valid/dupe/busted/unique/out-of-window/invalid, `score_per_qso`.
|
||
- DQ kontroly:
|
||
- `out_of_window_dq_threshold`,
|
||
- `time_diff_dq_threshold_percent` + `time_diff_dq_threshold_sec`,
|
||
- `bad_qso_dq_threshold_percent`.
|
||
- 6H: volí nejlepší operating window (pokud zapnuto).
|
||
- Navazuje **ApplyLogOverridesJob** + **RecalculateOfficialRanksJob**.
|
||
- Po dokončení: **PauseEvaluationRunJob → WAITING_REVIEW_SCORE**.
|
||
|
||
10) **FinalizeRunJob**
|
||
- Znov evidentně aplikuje overrides a přepočítá pořadí (pro jistotu).
|
||
- Uzavře běh (`SUCCEEDED`) a uvolní lock.
|
||
|
||
### Poznámky k ručním zásahům
|
||
|
||
- **Log overrides**: lze vynutit status/band/kategorii/power/6H; log lze i ignorovat.
|
||
- **QSO overrides**: lze vynutit match nebo stav QSO, případně body.
|
||
- Tři „čekací“ stavy jsou určeny pro ruční kontrolu a zásah rozhodčího.
|
||
|
||
## 3) Návrh prezentace (alfa verze a sběr feedbacku)
|
||
|
||
### Doporučená struktura prezentace (slide deck)
|
||
|
||
1) **Proč nový vyhodnocovač** – cíl: determinismus, auditovatelnost, pravidla v rulesetu.
|
||
2) **Pipeline v 1 minutě** – jediný graf s pořadím kroků + tři kontrolní „pause“.
|
||
3) **Matching principy** – 2 passy, tolerance času, co je „busted“ vs „time mismatch“.
|
||
4) **NIL/NO_COUNTERPART/UNIQUE** – kdy co vzniká a proč.
|
||
5) **Duplicity** – strategie přeživších, důvod pro samostatný krok.
|
||
6) **Bodování** – FIXED vs DISTANCE, validita až ve scoringu, policy + penalizace.
|
||
7) **Agregace a DQ** – multiplikátory, 6H window, limity DQ.
|
||
8) **UI a ruční zásahy** – ukázka overrides (log/QSO) + auditní eventy.
|
||
9) **Co umí alfa a co ještě ne** – rizika, co je stabilní, co se bude dolaďovat.
|
||
10) **Co od vás potřebujeme** – seznam dotazů, sběr pravidel a příkladů.
|
||
|
||
### Co získat
|
||
|
||
- Preferované policy pro NIL/DUP/BUSTED/TIME_MISMATCH (validita vs penalizace).
|
||
- Reálné hranice tolerancí (čas, matching pravidla, tiebreak priority).
|
||
- Pravidla pro 6H: reálná očekávání, jak interpretovat okno a pořadí.
|
||
- DQ prahy (out-of-window, bad QSO %, time diff).
|
||
- Seznam typických problémových situací z minulých ročníků.
|
||
|
||
### Otázky, na které se zeptat
|
||
|
||
- Co je v praxi považováno za „přijatelnou“ odchylku času?
|
||
- Kdy je chyba „busted“ vs jen „flag“ (nechat body)?
|
||
- Jak zacházet s unikátními QSO (UNIQUE) v různých soutěžích?
|
||
- Jaké ruční zásahy děláte dnes nejčastěji a proč?
|
||
- Jak má vypadat finální výstup pro rozhodčí (tabulka, export, log detail)?
|
||
|
||
|
||
## Slovníček pojmů a stavů
|
||
|
||
- **OK**: QSO bez chyb, standardni vstup do bodovani.
|
||
- **NIL**: nenaprovane QSO; protistanice se v matchingu nenasla.
|
||
- **NO_COUNTERPART_LOG**: protistanice nema zadny log; QSO je klasifikovano jako NIL.
|
||
- **NOT_IN_COUNTERPART_LOG**: protistanice log ma, ale konkretni QSO v nem chybi; QSO je klasifikovano jako NIL.
|
||
- **UNIQUE**: jediny zaznam o spojeni s danou protistanici v danem scope; pouziva se, pokud je zapnute `require_unique_qso`.
|
||
- **DUP**: duplicitni QSO v ramci logu podle `dupe_scope`; pouze "prezivsi" QSO boduje.
|
||
- **BUSTED_CALL**: neshoda volaciho znaku (callsign); urcuje se strana chyby (RX/TX).
|
||
- **BUSTED_RST**: neshoda RST reportu (pokud je RST soucasti exchange).
|
||
- **BUSTED_SERIAL**: neshoda serialu (nebo casti exchange, ktera se mapuje na serial).
|
||
- **BUSTED_LOCATOR**: neshoda lokatoru (WWL).
|
||
- **TIME_MISMATCH**: QSO sparovano, ale casovy rozdil mimo toleranci; resi se policy ve scoringu.
|
||
- **OUT_OF_WINDOW**: QSO mimo casove okno kola; bodovani urcuje `out_of_window_policy`.
|
||
- **ERROR_SIDE (RX/TX/NONE)**: kdo udelal chybu (prijem/vysilani/neurceno); ovlivnuje penalizace.
|