# G7 — Cache napříč doplňkem a skinem

Cíl (Standa): jedna cache, rychlá, nenáročná, spolehlivá; nikdy zbytečně nevolat TMDB, Webshare ani nic dalšího.
Stejný mechanismus později pro ČSFD.

## Co už existuje (nestavět znovu)
| Vrstva | Soubor | Použití |
|---|---|---|
| JSON odpovědi TMDB/ČSFD | `wcs/metadata/TMDbCache.py` (tabulka `meta` v `library.db`) | `get_from_cache`, `set_to_cache`, `get_or_fetch` |
| Pro tebe / žánry API | `wcs/foryou/api.py:get` (TTL, počítadla cached/failed) → TMDbCache | discover, detail |
| Webshare dostupnost | `wcs/foryou/availability.py` (`avail:<media>:<id>`, nalezeno 7 d, nenalezeno 3 d, nové 12 h) | štítek CZ |
| Obrázky (loga služeb, plakáty) | texture cache Kodi (URL TMDB w154) | loga služeb — žádná druhá cache souborů |
| Widgety skinu | cache-only endpointy (`wcs/genres/widgets.py`, `wcs/foryou/widgets.py`) | skin nikdy nevolá síť |

## Pravidla
1. Klíč `<zdroj>:<druh>:<id|hash parametrů>`; zdroj `tmdb`, `ws`, `csfd`. Žádná druhá cache vedle `meta`.
2. TTL podle druhu (výchozí v nastavení doplňku, TMDb → Žánry/Služby):
   žánry 7 d · discover stránka 24 h · služby titulu 7 d (`services_ttl_days`) · logo = texture cache Kodi ·
   Webshare podle `availability.py`.
3. Čerstvé se nikdy nevolá znovu; prošlé se obnoví hned (stránky s progresem, řádky Home přes službu na pozadí),
   a když síť neodpoví, použije se prošlé (až 30 dní). Postaveno takhle místo stale-while-revalidate v procesu
   pluginu: ten po vrácení položek končí a vlákno na pozadí by obnovu nedokončilo (rozhodnutí G7, 900).
4. Chyba (síť, 4xx/5xx, prázdné tělo) se nikdy neukládá.
5. Souběžné požadavky na stejný klíč se slučují (jeden fetch, ostatní čekají na výsledek; zámek v procesu).
6. Služby titulu (`svc:<media>:<id>`): z detailů Pro tebe zdarma (`append_to_response=watch/providers`), pro stránku
   žánru a detail hned při načtení (s progresem), pro ostatní řádky Home dávkou ve službě na pozadí (`rows._services`).
7. Skin čte jen hotové výsledky (ListItem `milionar.svc.1/2/more`, detail `milionar.detail.svc.N` a `.services`);
   nic nestahuje.
8. Počítadla (cached / fetched / failed / stale) v logu harnessu, ať jde ověřit „druhé otevření = 0 dotazů“.

## Ověření (povinné)
- Headless: druhé otevření stejné stránky žánru = 0 síťových dotazů; souběžné otevření = 1 dotaz na klíč;
  chyba se neuloží; prošlá položka se vrátí okamžitě.
- Live Kodi: Pro tebe a stránka žánru podruhé bez progresu; log bez dotazů TMDB/Webshare.
