# 340 — Beta verze přes náš aktualizační dialog

Stav: postaveno a ověřeno 2026-11-16 (vydání 2.3.5 a první beta níže). Navazuje na `250-update.md` (okno 1124, `wcs/skin/update.py`, `update_apply.py`).

## Rozhodnutí (Standa 2026-11-16)

| # | Rozhodnutí |
|---|------------|
| B1 | Volba „Beta verze“ je v nastavení doplňku, Hlavní nastavení → Aktualizace. Vidí ji každý, popisek říká, že beta může obsahovat chyby. |
| B2 | Se zapnutou volbou dialog aktualizace vždy nabízí obě řady: betu i produkční (stabilní) verzi. |
| B3 | Z bety se jde vždy vrátit na produkční verzi, i s vypnutou volbou. Návrat betu v nastavení nevypíná. |
| B4 | Text novinek bety se píše do `changelog.txt` jako horní záznam `[B]beta[/B]`; `release.py publish --beta` ho přejmenuje na verzi bety. Nic napevno v kódu. |
| B5 | Beta smí data jen přidávat (tabulky, sloupce s výchozí hodnotou nebo NULL, nastavení), nic nepřejmenuje ani nesmaže. `release.py --beta` to ověří proti vydané stabilní verzi a jinak betu nevydá. |
| B6 | Pojistka: při přechodu ze stabilní verze na betu se zazálohuje `library.db`. Před návratem na stabilní verzi její vlastní kód ověří, že data přečte; když ne, vrátí se záloha. |
| B7 | Volba bety platí jen pro zařízení, přes účet se nesynchronizuje (není v serverovém schématu nastavení). Synchronizace v betě běží normálně (díky B5). |

## Jak to funguje

### Server (`https://hosting.pilsfree.net/chudy/kodi/`)

- `repo/` jako dosud: stabilní řada, kterou čte i Kodi.
- `beta/addons.xml`: index jen s nejnovější betou (s `<news>`), Kodi ho nezná, čte ho jen náš dialog.
- `beta/plugin.video.milionar/plugin.video.milionar-<verze>.zip`: stejné rozložení jako `repo/`, takže dialog stahuje
  oběma řadami stejným kódem. Starší bety se po přepnutí indexu přesouvají do `old/beta/`, nic se nemaže.
- Adresa beta indexu se odvozuje z indexu repozitáře (`…/repo/addons.xml` → `…/beta/addons.xml`).

### Verze

- Beta má verzi `<základ>~beta<UTC čas>`, např. `2.3.6~beta20261116190000`; Kodi i doplněk ji řadí pod `2.3.6`.
- Porovnání verzí je jediné, `wcs/addon_version.py`, přepis `CAddonVersion` z Kodi 21 (Omega `AddonVersion.cpp`).
- Stabilní vydání s tímto systémem má verzi 2.3.5: staré bety 2.3.4~beta… měly porovnání jen čísel a 2.3.4 by
  nepovažovaly za novější.

### Dialog (okno 1124)

- Nabídky: stabilní verze, když se liší od nainstalované a je vyšší, nebo je nainstalovaná beta (návrat); beta, když
  je volba zapnutá, je vyšší než nainstalovaná i než stabilní.
- Hlavní tlačítko (11) = první nabídka, druhé tlačítko (13) = druhá nabídka, poslední (12) = Později/Zavřít.
- Instalace i návrat jsou jedna cesta: `install(verze)` stáhne balíček z řady té verze, ověří ho a předá `update_apply`.
  `resume` uspěje, jen když běží přesně cílová verze (funguje pro vyšší i nižší).

### Vydání (`scripts/release.py`)

- `publish`: jako dosud; odmítne, když je nahoře `changelog.txt` záznam `[B]beta[/B]` (při povýšení bety na stabilní ho
  přejmenuj na verzi).
- `publish --beta`: izolovaná kopie, verze nad vydanou stabilní, kontrola dat B5 proti vydanému stabilnímu ZIPu, ZIP do
  `beta/plugin.video.milionar/`, ověření SHA256, přepnutí `beta/addons.xml`, starší bety do `old/beta/`.

## Postup této práce

1. Beta změny od 2.3.3 (detail seriálu, sezóny, správce řádků) odložit mimo workspace a workspace vrátit na 2.3.3.
2. Postavit beta kanál (release.py, doplněk, okno), testy offline, okno v Mac Kodi, instalace v izolovaném Kodi.
3. Vydat stabilní 2.3.5.
4. Vrátit beta změny do workspace a vydat první betu novým `--beta`.
5. Ověřit v izolovaném Kodi proti skutečnému serveru: 2.3.5 → beta → zpět 2.3.5.

## Pokrok

- 2026-11-16: plán, rozhodnutí B1–B7.
- 2026-11-16: postaveno. `wcs/addon_version.py` (Kodi `CAddonVersion`), `wcs/skin/update.py` (obě řady, `offers`,
  záloha a kontrola dat), okno 1124 (třetí tlačítko 13, sestavení bety pod verzí), `store.readable`, `release.py`
  (`--beta [--dry-run]`, `beta/addons.xml`, `old/beta/`, kontrola dat), `update_lab.py --series beta`.
- Ověřeno: testy `scripts/skin_harness/test_update.py` (41), `test_release_beta.py` (9),
  `scripts/library_harness/test_store_readable.py` (5), `tests.test_release`; okno a volba v Mac Kodi (snímky);
  izolované Kodi s HTTPS laboratoří: 2.3.5 → beta (záloha `beta-backup/library.db`) → zpět 2.3.5 s knihovnou, kterou
  stabilní verze nepřečetla (přejmenovaný sloupec): záloha se vrátila, po návratu se smazala; nová verze, jejíž služba
  nenaběhne, se po 90 s vrátí (stará vlastnost, vidět při otevřeném průvodci).
- Beta změny od 2.3.3 (detail seriálu, sezóny, správce řádků) byly po dobu vydání 2.3.5 odložené v
  `~/.milionar-test/beta-park-20261116/` (`beta/` = workspace, `base/` = 2.3.3) a vrátily se do workspace.
- 2026-11-16: první beta `2.3.6~beta20261116185656` vydaná přes `--beta`. Krok 5 ověřen v izolovaném Kodi proti
  skutečnému serveru: 2.3.5 → beta (okno 1124, záloha `beta-backup`) → „Vrátit na 2.3.5“ (skin 1.3.117 zpět, záloha
  smazaná) → okno betu znovu nabízí (B3).
- 2026-11-16: beta povýšena na stabilní 2.3.6 (skin 1.3.118): záznam `[B]beta[/B]` přejmenovaný na `[B]2.3.6[/B]`,
  `release.py publish`. Beta index zůstává na `2.3.6~beta…`, která je pod 2.3.6, takže ji okno nenabízí.
