# G1 — TMDB engine

Nový balíček `wcs/genres/` (vzor: `wcs/foryou/`). Čistá logika bez Kodi importů kvůli offline testům;
HTTP přes stávající TMDB klienta (`wcs/metadata/TMDbClient.py`, klíč `get_tmdb_api_key`).

## Žánry
- `genre/movie/list` + `genre/tv/list` (cs-CZ). Sloučení pro Oboje přes `F.folded_genres` (`wcs/foryou/features.py`);
  TV „Sci-Fi & Fantasy“ → Sci-Fi i Fantasy, „Action & Adventure“ → Akční i Dobrodružný, „War & Politics“ → Válečný.
- Vlastní názvy cs/sk/en pro TV žánry, které TMDB nepřekládá.
- TV-only Kids/News/Reality/Soap/Talk: skryté (nastavení).

## Scoring žánrů
- Zdroj = profil Pro tebe (váhy `g:<id>`, `wcs/foryou/score.py:89`): knihovna, zhlédnuté, 👍/👎.
- Pořadí: žánry se skóre nad prahem sestupně, pak ostatní v pevném pořadí (popularita žánru).
- Váhy zdrojů a práh nastavitelné ve widget manageru (výchozí = chování profilu Pro tebe).

## Výpis (hlavní, stránkovaný)
- `discover/movie` (`primary_release_date`) a `discover/tv` (`first_air_date`), `with_genres`,
  `with_origin_country`, `.lte` = dnes (žádné budoucí tituly).
- **Strop TMDB 500 stran** → kurzor po datech: stránka = 20 položek; kurzor = (datum poslední položky, id-y
  na tom datu). Další stránka = `release_date.lte = kurzor`. Předchozí = zásobník kurzorů. Funguje pro „Vše roky“.
- Rok: jeden rok = `gte/lte` 1. 1. – 31. 12.
- Oboje: dva kurzory (film, TV), sloučení podle data do stránky po 20.
- Řazení Hodnocení/Popularita: `sort_by` TMDB (strop 500 stran zde nevadí, zapsat).

## Filtr „Výběr“ — žádný tvrdý práh hlasů
Problém (měřeno): ≥ 20 hlasů vyhodí známé i české tituly (CZ sci-fi 41 → 4). Proto:
- **Vše** — opravdu všechno.
- **Doporučené (default)** — vyhodí jen smetí, ne neznámé-ale-dobré. Položka zůstane, pokud splní **kterékoli**:
  vysoký rating i s málo hlasy (Bayesovský vážený rating ≥ R), nebo popularita ≥ P, nebo hlasy ≥ V,
  nebo je v knihovně / zhlédnutá / v Pro tebe. Bez plakátu + 0 hlasů + nízká popularita = smetí.
  Filtruje se na klientu; stránka se doplňuje dalšími stránkami TMDB do 20 položek (limit dotazů na stránku).
- **Top** — přísnější varianta (vyšší R/V).
- Řazení zůstává podle data; vysoký rating se zvýrazní badge (hodnocení na kartě), ne přeskládáním.
- R, P, V (a CZ/SK výjimka, pokud ji testy ukážou jako nutnou) **nastaví agent z headless testů** — viz 030.

## Země
- `configuration/countries` (251) → agent změří přes discover počty titulů na zemi a vybere nejvíce produkující
  (vzor: stávající výběr zemí v doplňku, najít a sjednotit). Vždy první položka **Vše** (default) a „Další…“
  se všemi zeměmi (jedna země najednou).

## Další řádky
- Doporučeno pro tebe: engine Pro tebe omezený žánrem (+ typ, rok, země), dostupnost Webshare (`wcs/foryou/availability.py`).
- Populární teď: `sort_by=popularity.desc`, posledních ~90 dní.
- Nejlépe hodnocené: vážený rating.
- Skryté klenoty: vysoký rating, nízká popularita, v duchu profilu (`wcs/foryou`).
- Nejlepší z desetiletí: vážený rating v dané dekádě.
Všechny řádky respektují filtry Typ/Země; Rok jen tam, kde dává smysl (agent rozhodne a zapíše).

## Výkon
- Stránka z cache okamžitě; nová stránka max. pár dotazů TMDB (limit z nastavení), paralelně, s progresem.
- Přednačíst další stránku výpisu na pozadí po zobrazení aktuální (bez blokování UI).

## Cache
- Seznam žánrů 7 dní, stránky výpisu a řádků 24 h, země 30 dní; přes `wcs/caching.py`.
- TTL nastavitelné v nastavení doplňku Milionář (`resources/settings.xml`).
