# EvaluationRuleSet - pravidla vyhodnocení pro rozhodčí

Tento dokument popisuje vyhodnocovací proces a jednotlivá nastavení rulesetu
(`EvaluationRuleSet`). Slouží jako nápověda a vysvětlení dopadu na
skóre a výsledky.

## Stručný popis vyhodnocovacího procesu

1. **Prepare** - příprava běhu, kontrola locku, vyčištění staging tabulek.
2. **ParseLogs** - parsování EDI souboru, naplnění `logs` a `log_qsos`.
3. **BuildWorkingSet** - normalizace volacích znaků, lokátorů, příprava `working_qsos`.
4. **Match** - párování QSO mezi logy, detekce neshod a typy chyb.
5. **UnpairedClassification** - NIL/NO_COUNTERPART/UNIQUE pro nenapárovaná QSO.
6. **DuplicateResolution** - výběr přeživších u duplicit podle strategie.
7. **Score** - bodování, aplikace policy, penalizací a multiplikátorů.
8. **Aggregate** - součty za log (score, counts), výpočet metrik.
9. **ApplyLogOverrides** - ruční zásahy do log_results.
10. **RecalculateRanks** - přepočet pořadí.
11. **Finalize** - uzavření běhu a uvolnění locku.

## Politiky (společné chování)

Používané policy hodnoty:
- **INVALID**: `is_valid=false`, body 0.
- **ZERO_POINTS**: `is_valid=true`, body 0.
- **FLAG_ONLY**: `is_valid=true`, body beze změny (jen flag).
- **PENALTY**: `is_valid=true`, body 0 (u některých chyb body zůstávají) + penalizace.

Poznámka: `valid_qso_count` se počítá podle `is_valid`.

## Nastavení rulesetu a dopad (kde se uplatňuje)

### Skóre a body
- `scoring_mode` (DISTANCE / FIXED_POINTS): určuje typ bodování.
  Uplatnění: scoring.
- `points_per_qso`: fixní body za QSO (FIXED_POINTS).
  Uplatnění: scoring.
- `points_per_km`: body za km (DISTANCE).
  Uplatnění: scoring.
- `distance_rounding` (FLOOR/ROUND/CEIL): zaokrouhlení vzdálenosti.
  Uplatnění: scoring.
- `min_distance_km`: minimální vzdálenost pro bodované QSO.
  Uplatnění: scoring.

### Multiplikátory
- `use_multipliers`: zapíná multiplikátory.
  Uplatnění: scoring + agregace.
- `multiplier_type` (WWL/DXCC/SECTION/COUNTRY/NONE): typ multiplikátoru.
  Uplatnění: scoring + agregace.
- `multiplier_scope` (PER_BAND/OVERALL): scope multiplikátoru.
  Uplatnění: agregace.
- `multiplier_source` (VALID_ONLY/ALL_MATCHED): z čeho se počítají.
  Uplatnění: agregace.
- `wwl_multiplier_level` (LOCATOR_2/4/6): délka WWL multiplikátoru.
  Uplatnění: scoring.

### Error policy a penalizace
- `dup_qso_policy`, `nil_qso_policy`: policy pro DUP/NIL.
  Uplatnění: scoring.
- `no_counterpart_log_policy`, `not_in_counterpart_log_policy`, `unique_qso_policy`,
  `time_mismatch_policy`: policy pro NIL/UNIQUE/TIME_MISMATCH.
  Uplatnění: scoring.
- `busted_call_policy`, `busted_exchange_policy`, `busted_serial_policy`,
  `busted_locator_policy`, `busted_rst_policy`: policy pro BUSTED chyby.
  Uplatnění: scoring.
- `penalty_*_points`: velikost penalizací pro jednotlivé chyby.
  Uplatnění: scoring.
- `out_of_window_policy`, `penalty_out_of_window_points`: chování mimo časové okno.
  Uplatnění: scoring.

### Matching (párování QSO)
- `time_tolerance_sec`: tolerance času pro match.
  Uplatnění: matching.
- `allow_time_shift_one_hour`, `time_shift_seconds`: povolený časový posun.
  Uplatnění: matching.
- `allow_time_mismatch_pairing`, `time_mismatch_max_sec`: párování mimo toleranci.
  Uplatnění: matching.
- `callsign_normalization` (STRICT/IGNORE_SUFFIX),
  `ignore_slash_part`, `ignore_third_part`,
  `callsign_suffix_max_len`, `callsign_levenshtein_max`:
  normalizace volacích znaků a fuzzy match.
  Uplatnění: matching.
- `match_tiebreak_order`: pořadí tiebreak kritérií (time_diff, exchange_match, ...).
  Uplatnění: matching (volba nejlepšího kandidáta).
- `match_require_locator_match`, `match_require_exchange_match`:
  vyžadování shody lokátoru/exchange pro match.
  Uplatnění: matching.
- `exchange_type`, `exchange_requires_*`, `exchange_pattern`:
  definice a kontrola exchange.
  Uplatnění: matching.
- `letters_in_rst`, `rst_ignore_third_char`: normalizace RST.
  Uplatnění: matching.
- `discard_qso_*`: určuje, zda se neshoda označí jako BUSTED a s jakou stranou (RX/TX).
  Uplatnění: matching.
- `checklog_matching`: zahrnout CHECK logy do matchingu.
  Uplatnění: matching.

### Duplicity a unikátní QSO
- `dupe_scope` (BAND/BAND_MODE): klíč pro duplicity.
  Uplatnění: working set + duplicity.
- `dup_resolution_strategy`: pořadí pravidel pro výběr přeživších DUP.
  Uplatnění: duplicate resolution.
- `require_unique_qso`: zapíná detekci UNIQUE.
  Uplatnění: unpaired klasifikace.

### DQ limity (log-level)
- `out_of_window_dq_threshold`: DQ při nadlimitních QSO mimo okno.
  Uplatnění: agregace.
- `time_diff_dq_threshold_percent`, `time_diff_dq_threshold_sec`: DQ při časovém rozptylu.
  Uplatnění: agregace.
- `bad_qso_dq_threshold_percent`: DQ při nadlimitním % chybných QSO.
  Uplatnění: agregace.

### 6H operating window
- `operating_window_mode` (NONE/BEST_CONTIGUOUS): zapíná 6H operating window.
  Uplatnění: agregace (vybere nejlepší 6H okno pro log).
- `operating_window_hours`: délka 6H okna (aktuálně pevně 6 h).
  Uplatnění: agregace.
- `sixhr_ranking_mode` (IARU/CRK): způsob pořadí pro 6H.
  Uplatnění: přepočet pořadí (IARU = jedna společná 6H tabulka bez SO/MO, CRK = odděleně SO/MO).

Poznámka: Pro IARU se 6H okno vybírá jako max. 2 segmenty s pauzou >= 2 h, součet délek <= 6 h.

### Options (JSON)
- `options`: fallback hodnoty, pokud není vyplněn sloupec.
  Uplatnění: napříč matching/scoring (viz metody `getOption`/`get*` v modelu).

## Výchozí ruleset (default_vhf_compat)

Zdroj: `database/seeders/EvaluationRuleSetSeeder.php`

Nastavení (zkrácené na podstatné hodnoty):
- Profil: **Default VHF (compat)**, permisivní matching.
- Scoring: `scoring_mode=DISTANCE`, `points_per_qso=1`, `points_per_km=1.0`
- Multiplikátory: `use_multipliers=false`, `multiplier_type=WWL`
- Policy:
  - `dup_qso_policy=ZERO_POINTS`
  - `nil_qso_policy=ZERO_POINTS`
  - `no_counterpart_log_policy=FLAG_ONLY`
  - `not_in_counterpart_log_policy=ZERO_POINTS`
  - `unique_qso_policy=FLAG_ONLY`
  - `busted_*_policy=ZERO_POINTS`
  - `time_mismatch_policy=ZERO_POINTS`
  - penalizace vše 0
- Matching:
  - `time_tolerance_sec=600`
  - `allow_time_shift_one_hour=true`, `time_shift_seconds=3600`
  - `allow_time_mismatch_pairing=false`
  - `callsign_normalization=IGNORE_SUFFIX`
  - `ignore_slash_part=true`, `ignore_third_part=true`
  - `letters_in_rst=false`, `rst_ignore_third_char=true`
  - `match_require_locator_match=false`, `match_require_exchange_match=false`
  - `match_tiebreak_order=[time_diff, exchange_match, locator_match, report_match, log_qso_id]`
  - `discard_qso_rec_diff_*=true`, `discard_qso_sent_diff_*=false`
- Duplicity:
  - `dupe_scope=BAND`
  - `dup_resolution_strategy=[paired_first, ok_first, earlier_time, lower_id]`
- Exchange:
  - `exchange_type=SERIAL_WWL`
  - `exchange_requires_wwl=true`, `exchange_requires_serial=true`, `exchange_requires_report=true`
- DQ limity:
  - `out_of_window_dq_threshold=600`
  - `time_diff_dq_threshold_percent=30`
  - `time_diff_dq_threshold_sec=600`
  - `bad_qso_dq_threshold_percent=30`

## Poznámky k interpretaci výsledků

- `valid_qso_count` = počet QSO s `is_valid=true`.
- `discarded_qso_count` = počet QSO s `is_valid=false`.
- Penalizace se uplatňuje v `penalty_score` a odčítá se od `base_score`.