# Etapy vývoje Livio ## 1. Zásady plánu Plán rozděluje vývoj na ověřitelné přírůstky. Každá etapa končí funkčním, otestovaným stavem a aktualizovanou dokumentací. Žádná etapa automaticky neopravňuje k produkčnímu nasazení. Priority: 1. ochrana dat a schopnost obnovy; 2. správný datový model a synchronizace; 3. hlavní každodenní tok záznamů; 4. média; 5. kroniky a dlouhodobý archiv; 6. rozšiřující komfort. ## 2. Vstupní rozhodnutí před implementací – etapa 0 ### Cíl Odstranit technické nejistoty, které mohou změnit architekturu nebo datový model, a připravit bezpečné lokální prostředí. ### Úkoly - ověřit tarif Webglobe: PHP, MySQL/MariaDB, GD/Imagick, cron, limity uploadu, paměti, času, disku, databáze a možnost neveřejného úložiště; - potvrdit produkční document root, HTTPS, bezpečnostní hlavičky a způsob e-mailu; - potvrdit barvy, logo, PWA ikony a základní navigaci podle existujícího návrhu; - rozhodnout formát textu záznamů; - rozhodnout základní mediální formáty a kvóty; - rozhodnout role a sporná oprávnění exportů/originálů; - určit zálohovací cíl, odpovědnost, frekvenci, retenci, RPO a RTO; - ověřit možnosti generování PDF/PDF-A bez Composeru a licenci fontů; - vytvořit anonymní testovací datovou sadu; - nastavit Laragon s verzemi odpovídajícími hostingu; - vytvořit evidenci schválených rozhodnutí aktualizací dokumentů. ### Výstup - potvrzené nebo upravené dokumenty v `docs/`; - funkční lokální PHP/MySQL/HTTPS prostředí; - zapsané hostingové limity a bezpečný způsob konfigurace; - jednoduchý technický prototyp uploadu velkého souboru a PDF s českou diakritikou, nikoli uživatelská funkce. ### Kritéria dokončení - žádná zásadní hostingová neznámá neblokuje datový model, média ani export; - všechny položky označené jako nutné pro první etapu mají rozhodnutí; - záloha prázdné/testovací databáze a její obnova byly vyzkoušeny. ## 3. Technický základ – etapa 1 ### Cíl Vytvořit bezpečnou kostru jedné SPA/PWA, databázové migrace a testovací základ bez produktových zkratek. ### Rozsah - adresářová struktura a neveřejná konfigurace; - malý PHP front controller/router, JSON odpovědi a korelační ID; - PDO připojení, migrace a `schema_migrations`; - App Shell, směrování SPA, CSS tokeny a responzivní layout; - manifest a minimální Service Worker pouze pro statický App Shell; - základ IndexedDB s verzováním; - bezpečnostní hlavičky, jednotná validace a chybový formát; - automatické testovací příkazy a izolovaná testovací databáze; - deployment checklist bez automatického nasazení. ### Testy - PHP syntaxe a základní unit testy; - migrace na čisté databázi a opakované bezpečné spuštění; - otevření App Shellu offline po první návštěvě; - navigace na 360, 768, 1024 a 1440 px; - CSP bez chyb u základní obrazovky; - neveřejnost konfigurace, logů a storage přes HTTP. ### Kritéria dokončení - aplikace běží lokálně přes HTTPS a po první návštěvě se otevře bez sítě; - databázová verze je reprodukovatelná migracemi; - produkční chyba neodhalí stack trace ani tajné údaje. ## 4. Identity, rodiny a oprávnění – etapa 2 ### Cíl Bezpečné účty, relace, rodiny, děti a role jako základ všech dalších funkcí. ### Rozsah - registrace, ověření e-mailu, přihlášení, odhlášení a reset hesla; - bezpečné session cookies, CSRF a rate limiting; - rodiny, členství, pozvánky a role `owner`, `editor`, `viewer`; - profily dětí, rodinné osoby a základ vztahů; - přepínání rodin a serverová objektová autorizace; - aktivní relace/zařízení a jejich odvolání; - audit citlivých akcí; - základ přístupného mobilního a desktopového shellu. ### Testy - přihlášení, reset, expirovaný a opakovaný token; - session fixation, CSRF, hrubé pokusy a bezpečné cookies; - přístup k cizí rodině přes změněné UUID; - úplná matice rolí; - zákaz odebrání posledního vlastníka; - pozvánka po expiraci a opakovaném použití; - klávesnice, focus a čtečka pro kritické formuláře. ### Kritéria dokončení - žádná rodinná entita není čitelná nebo měnitelná bez odpovídajícího členství; - role jsou ověřeny na serveru a shodují se s `FUNKCE.md`; - rodina může založit dítě a pozvat dalšího člena. ## 5. Offline jádro a synchronizace – etapa 3 ### Cíl Ověřit nejtěžší technickou část dříve, než vznikne mnoho formulářů: trvalá fronta, idempotence, push/pull a konflikty. ### Rozsah - IndexedDB stores `entities`, `outbox`, `conflicts`, `syncState` a `drafts`; - UUID a `operation_id` generované klientem; - atomické lokální uložení entity a mutace; - serverové `sync_operations` a `change_log`; - `push`/`pull`, kurzor a stránkování; - retry/backoff, session expiry a ruční synchronizace; - více karet, vedoucí synchronizátor a BroadcastChannel; - měkké smazání, koš a obnova; - automatické sloučení různých polí a UI ručního konfliktu; - migrační test IndexedDB bez ztráty fronty. Nejprve se použije jednoduchý generický záznam bez médií. Teprve po ověření protokolu se přidají ostatní entity. ### Testy - všechny scénáře z kapitoly 17 v `OFFLINE_SYNC.md` relevantní bez médií; - chaos test změny pořadí, timeoutu a opakování; - dvě zařízení a stejná/různá pole; - ztráta role, smazání rodiče, neplatná závislost; - restart prohlížeče a aktualizace Service Workeru s frontou; - plná resynchronizace starého zařízení. ### Kritéria dokončení - opakování mutace nikdy nevytvoří duplicitu; - konflikt nikdy tiše nezahodí variantu; - čekající data přežijí restart a expirovanou session; - stav v UI rozlišuje lokální uložení a serverovou synchronizaci. ## 6. Časová osa a všechny typy záznamů – etapa 4 ### Cíl Zprovoznit hlavní každodenní funkci Livio od těhotenství do dospělosti. ### Rozsah - společný model `records`, subjekty, štítky a filtry; - časová osa rodiny i dítěte; - běžná vzpomínka, těhotenství, narození, porodnice, růst, milník, výlet, rodinná událost a dopis do budoucna; - datum s různou přesností a období; - hledání v lokálních a serverových datech; - oblíbené, koš a obnova; - koncepty formulářů a všechny typy plně offline; - tabulkový a grafický přehled růstu bez diagnostiky; - citlivé zobrazení porodních a zdravotních údajů. ### Testy - validní i nevalidní vstup a hraniční hodnoty každého typu; - časová pásma, letní čas, datum bez času a přibližné datum; - záznam patřící více dětem bez duplicity; - dlouhá časová osa a stránkování kurzorem; - offline vytvoření, změna, smazání a konflikt každého typu; - responzivita, 200% zoom, klávesnice a prázdné stavy. ### Kritéria dokončení - časová osa je použitelná s nejméně tisíci anonymními testovacími záznamy; - každý požadovaný typ funguje online i offline; - filtry a hledání nikdy neuniknou mimo aktivní rodinu. ## 7. Média – etapa 5 ### Cíl Bezpečně uchovat originální fotografie a videa a propojit je se záznamy i offline. ### Rozsah - lokální Blob, náhled a stav kapacity; - `media`, `media_variants`, `record_media` a upload sessions; - hash SHA-256, detekce duplicit a idempotentní upload; - obnovení přerušeného přenosu a případný chunking; - serverová kontrola MIME, velikosti a povolených formátů; - generování náhledů a posterů podle potvrzených možností; - neveřejné uložení a autorizovaný výdej, včetně Range pro video, je-li možné; - popisky, alt texty, pořadí a hlavní médium; - přehled čekajících/selhaných médií; - ochrana originálu před přepsáním. ### Testy - podvržený MIME, dvojitá přípona, škodlivý/nepodporovaný soubor; - limit klienta, PHP, hostingu a rodinné kvóty; - přerušení každé fáze uploadu a bezpečné pokračování; - cizí rodina a přímý odkaz na originál; - hash před/po uploadu a exportu; - velká fotografie, video, rotace EXIF a český název; - uvolnění IndexedDB a chybějící lokální Blob; - výkon galerie na mobilu. ### Kritéria dokončení - originální soubor má po uploadu a stažení stejný SHA-256; - nikdo bez oprávnění nezíská soubor znalostí URL/UUID; - přerušený upload nevede k duplicitě ani falešnému stavu „synchronizováno“. ## 8. Krásná PDF kronika – etapa 6 ### Cíl Dodat hlavní prezentační výstup produktu. ### Rozsah - průvodce dítě/rodina, období, typy, osoby, média a vzhled; - snapshot zdrojových revizí a opakovatelné zadání; - kapitoly, titulní strana, obsah, texty, fotografie, růst a milníky; - náhled výběru a ořezu; - dávkové serverové generování kompatibilní s Webglobe; - stav průběhu, opakování po chybě a časově omezené stažení; - české fonty, tiskové styly a validace zvoleného PDF profilu; - audit vytvoření a stažení. ### Testy - malé i velmi rozsáhlé období; - česká diakritika, dlouhé nadpisy, prázdné kapitoly; - portrét/krajina, nízké rozlišení a různé poměry stran; - výpadek během dávky a pokračování bez duplicity; - oprávnění a zapečetěný dopis; - otevření ve více PDF prohlížečích, tisk a kontrola textové vrstvy; - pokud je potvrzeno PDF/A, validace nezávislým nástrojem. ### Kritéria dokončení - uživatel vytvoří estetickou kroniku pro dítě i rodinu a zvolené období; - výsledek přesně odpovídá uloženému snapshotu; - PDF nepředstírá archiv originálních videí a jasně odkazuje na samostatný archiv. ## 9. Úplný archiv, zálohy a obnova – etapa 7 ### Cíl Splnit přenositelnost, ověřitelnost a dlouhodobou uchovatelnost. ### Rozsah - archivní ZIP podle dítěte/rodiny a období; - JSON, CSV, archivní PDF, originály, náhledy, manifest, README a SHA-256; - verzování exportního formátu; - dělení velkého archivu, pokud bylo potvrzeno; - bezpečný dočasný výdej a automatické vypršení; - databázová a mediální záloha na potvrzené druhé úložiště; - kontrola integrity originálů; - dokumentovaný postup a automatizované bezpečné části obnovy; - první plný test obnovy do izolovaného prostředí; - audit exportu, stažení a obnovy. ### Testy - ověření všech hashů a počtů; - otevření exportu bez Livio podle README; - vazby JSON/CSV na originální soubory; - chybějící nebo změněný soubor je detekován; - obnova databáze a médií do čistého prostředí; - zákaz zahrnutí cizích či zapečetěných dat; - velký archiv a vypršení downloadu. ### Kritéria dokončení - nezávislý kontrolní postup ověří integritu exportu; - testovací rodinu lze obnovit z definované zálohy; - existuje záznam data, výsledku a doby posledního testu obnovy. ## 10. Stabilizace, přístupnost a pilot – etapa 8 ### Cíl Připravit aplikaci na bezpečný omezený pilot s reálným používáním, nikoli ještě automaticky na veřejné spuštění. ### Rozsah - kompletní threat review a oprava zjištění; - WCAG 2.2 AA audit kritických toků; - výkon na slabším mobilu a pomalé síti; - dlouhodobý offline test a více zařízení; - migrace z předchozí interní verze; - provozní monitoring bez osobních dat; - návody k záloze, obnově, exportu a incidentu; - retenční úlohy a kontrola volného místa; - pilotní zpětná vazba k časové ose, editoru a kronice; - finální revize dokumentace. ### Testy - regresní sada všech předchozích etap; - penetrační test nejrizikovějších toků; - zátěž realistickým počtem záznamů a médií; - dostupnost při 360 px, 200% zoomu, klávesnici a čtečce; - obnova po neúspěšném nasazení bez ztráty dat; - ověřené zálohy před a po aktualizaci. ### Kritéria dokončení - nejsou otevřené kritické bezpečnostní nebo datové chyby; - pilotní uživatel dokončí hlavní scénáře bez asistence; - záloha, obnova, export a kontrola integrity mají prokazatelný úspěšný výsledek; - známá omezení jsou viditelná a dokumentovaná. ## 11. Pozdější volitelné etapy Bez nového rozhodnutí nejsou součástí první verze: - percentilové křivky s odborným zdrojem; - mapy a import tras; - pokročilý rodokmen; - push/e-mailová oznámení; - veřejné nebo časově omezené sdílení; - kryptograficky zapečetěné dopisy a správa obnovy klíčů; - další jazyky; - import z jiných služeb; - nativní mobilní aplikace; - automatická klasifikace médií. Každá taková etapa vyžaduje dopadovou analýzu bezpečnosti, soukromí, offline režimu, datového modelu, exportu a 50letého horizontu. ## 12. Průběžné činnosti v každé etapě - aktualizovat migrace a dokumentaci současně s kódem; - testovat čistou instalaci i upgrade; - zálohovat před rizikovou změnou a ověřovat obnovitelnost; - kontrolovat závislosti a licence; nepřidávat je bez souhlasu; - měřit výkon a velikost App Shellu; - testovat online, offline, prázdné, chybové a konfliktní stavy; - kontrolovat přístupnost a responzivitu; - nepracovat s reálnými rodinnými daty ve vývoji a testech; - zapisovat návrhy k potvrzení, nepřeměňovat je tiše na rozhodnutí. ## 13. Brány před produkčním nasazením Produkční nasazení lze doporučit až po splnění všech bodů: 1. aktuální plná záloha databáze a médií; 2. úspěšný nedávný test obnovy; 3. migrace ověřená na kopii předchozí verze; 4. regresní, synchronizační, autorizační a exportní testy bez kritické chyby; 5. ověřené hostingové limity a volné místo; 6. bezpečná produkční konfigurace bez debug režimu; 7. plán návratu aplikace a postup při nekompatibilní databázové změně; 8. výslovné oprávnění k nasazení; 9. smoke test po nasazení a kontrola logů; 10. uživatelé nejsou nuceni aktualizací zahodit čekající offline změny. ## 14. Orientační pořadí, ne časový slib Etapy se mají provádět v uvedeném pořadí. Překrývat lze dokumentaci, design prototypy a testovací přípravu, nikoli obejít bezpečnostní závislosti. Časový odhad se stanoví až po etapě 0, protože rozhodujícím rizikem jsou omezení Webglobe, zpracování videa/PDF a požadovaný rozsah zálohování. **Návrh k potvrzení:** konkrétní termíny, kapacita týmu, rozpočet hostingu a definice pilotní skupiny.