# Pro tebe — plan of record

Status: **P1–P4 built and live in Kodi (2026-10-09); waiting for the user's test. Next: P5 (AI) later.** Decided with the user on 2026-10-09 in three rounds of questions;
every decision is in `900-decisions.md`. An agent picking this up reads `AGENTS.md`, this file, then the chapter of
the phase it takes.

## Goal

A new Home section **Pro tebe**: the first item of the side menu and the new start screen of `skin.milionar`,
a recommendation system on the level of Netflix / Apple TV that works **without AI** (AI is a later bonus phase).
Everything it shows can be played (verified on Webshare, CZ dub first).

## What the user sees (target)

- Side menu: **Pro tebe** first; Pokračovat stays as its own item.
- Top: chips **Vše / Filmy / Seriály**; a static cinematic hero that follows the focus (backdrop, TMDb logo,
  `94 % shoda · Protože jsi viděl Matrix`, buttons Přehrát / Více informací).
- Rows (mixed films and series; the chips filter them):
  1. Pokračovat (the existing Continue data)
  2. Pro tebe — best overall match
  3. Top 10 v ČR — big numbers next to the posters
  4. Protože jsi viděl X (two to three rows, each for another seed title)
  5. Na dnešní večer — by time of day and length
  6. Nově s CZ dabingem
  7. Skryté klenoty — high rating, low popularity, in the user's taste
- A title appears once per page.
- Old sections **AI doporučení** and **TMDb / ČSFD** are merged in: switched off by default, can be switched on.
- 👍 / 👎 / Nezajímá mě in the context menu and in the detail; a first-run pick of favourite titles.

## Phases

| # | Phase | Status | Chapter |
|---|-------|--------|---------|
| P1 | Engine: taste profile, TMDb candidates, match %, reason, rows, snapshot; offline tests + live harness | **built** | `010-engine.md` |
| P2 | Webshare availability in the service (cache, CZ dub / CZ subs badge, request budget) | **built** | `020-availability.md` |
| P3 | Skin section Pro tebe: menu, hero, chips, rows, Top 10 numbers, merge of old sections | **built** | `030-skin.md` |
| P4 | Feedback: 👍 / 👎 / Nezajímá mě, first-run pick | **built** | `040-feedback.md` |
| P5 | AI bonus (later): AI curator rows, mood chat | later | — |

Each phase ends with the user's test (numbered checklist), then the next one starts.

## Rules

1. Do not reopen decisions in `900-decisions.md`; if a fact contradicts one, ask the user.
2. No Kodi video library data; only `library.db` (the addon's own library) and TMDb.
3. Widgets never touch the network: the service builds a snapshot, rows read it (fast path, like `rows.py`).
4. Settings are never overridden in code; new knobs get defaults in `resources/settings.xml`.
5. Texts in cs / sk / en.