# Offline režim a synchronizace Livio ## 1. Cíl Livio musí umožnit otevřít dříve použitou aplikaci a vytvořit, upravit i odstranit všechny běžné typy záznamů bez sítě. Změny se bezpečně uloží v zařízení a po obnovení připojení se synchronizují bez duplicit a tichých ztrát. Offline režim není nouzová obrazovka, ale plnohodnotný pracovní stav. Tento dokument neznamená, že první návštěva, přihlášení, přijetí pozvánky, změna oprávnění nebo stažení dosud neuloženého originálního videa fungují bez sítě. ## 2. Model konzistence - Klient používá lokální pracovní kopii v IndexedDB a optimistické UI. - Server je autoritou pro členství, role, validaci, přidělení revizí a sdílený potvrzený stav. - Konzistence je dočasně eventual: zařízení mohou krátce vidět různé verze. - Každá entita má stabilní UUID a serverovou `revision`. - Každá mutace má stabilní `operation_id`, typ operace, cílové UUID, `base_revision` a payload. - Serverový `change_log.sequence` je přírůstkový kurzor pro změny rodiny. - Smazání se šíří jako náhrobek, nikoli okamžité fyzické odstranění. ## 3. IndexedDB ### 3.1 Databáze a verze Navržený název: `livio-{userUuid}`. Verze schématu je celé číslo a migruje se v `onupgradeneeded`. Selhání migrace nesmí odstranit původní databázi bez exportu nebo potvrzení. ### 3.2 Úložiště | Store | Klíč | Obsah | |---|---|---| | `entities` | `[familyUuid, entityType, uuid]` | Normalizované lokální entity včetně revize a stavu smazání. | | `outbox` | `operationId` | Čekající mutace v pořadí vzniku. | | `conflicts` | `conflictId` | Lokální a serverová varianta, metadata a stav řešení. | | `syncState` | `familyUuid` | Poslední kurzor, časy pokusů, stav a backoff. | | `mediaBlobs` | `mediaUuid` | Originální Blob nebo dočasná lokální kopie. | | `mediaUploads` | `mediaUuid` | Stav upload session, části a potvrzený hash. | | `drafts` | `[familyUuid, draftUuid]` | Rozpracované formuláře, které ještě nejsou doménovým záznamem. | | `referenceData` | `key` | Bezpečná číselníková data a verze. | Osobní data se neukládají do `localStorage`. Ten lze použít jen pro neosobní drobnou preferenci, pokud je to vůbec nutné. ### 3.4 Základ offline identity a Přehledu Aktuální implementace používá IndexedDB `livio-offline-v1` (schéma 5) pro klíč instalace, serverové offline oprávnění, šifrovaný snímek Přehledu, připravené jmenné prostory podle účtu/rodiny, šifrované profilové fotografie, zabalené rodinné klíče a budoucí frontu. Heslo ani cookie `LIVIO_REMEMBER` se do IndexedDB nekopírují. - Oprávnění vydá pouze server po ověření platné přihlášené relace s volbou „Zůstat přihlášen“. Platí 7 dní, zahrnuje pouze `overview.read` a je podepsané RSA-SHA256. Klient ověřuje podpis proti veřejnému klíči připnutému v `assets/js/offline-store.js`; veřejný klíč přijatý spolu s oprávněním se za důvěryhodný nepovažuje. - Každá instalace vytvoří neexportovatelný klíč ECDSA P-256. Server do podepsaného oprávnění zahrne SHA-256 otisk jeho veřejné části. Při offline startu klient ověří podpis, účet, rodinný rozsah, přítomnost šifrovaného snímku, platnost a důkaz držení privátního klíče. - Navigační dokument aktivního vydání se vrací nejprve z cache Service Workeru. Aktualizace se nadále zjišťuje existujícím mechanismem buildu a nové vydání projde samostatnou instalací cache; API zůstává mimo cache. - Přehledový snímek je šifrován AES-GCM 256 samostatným neexportovatelným klíčem pro účet a rodinu. HTML se před obnovením znovu skládá přes allowlist značek a atributů. Starší nebo chybějící snímek nevede k předstíranému přihlášení. - Soukromé profilové fotografie se ukládají do IndexedDB store `scopedPhotos` šifrované klíčem účtu a rodiny. Záznam je oddělen podle uživatele, rodiny a role fotografie (`self`, `matka`, `otec`) a nese stabilní SHA-256 otisk serverového klíče média jako verzi. Nová fotografie se navíc ještě před odesláním zašifruje AES-256-GCM rodinným klíčem; v R2 i ve frontě `outbox` je pouze binární obálka E2EE. Při otevření se použije lokální Blob; API metadata se mohou znovu ověřit na pozadí, ale binární fotografie se stáhne pouze při chybějící kopii nebo změně verze. R2 endpointy zůstávají soukromé `no-store`; Service Worker osobní API ani fotky necachuje. Bez sítě lze novou fotografii bezpečně zařadit do existujícího outboxu společně s lokální kopií, atomicky; po připojení se odešle idempotentně. Konflikt verze ponechá fotografii ve frontě a zachová místní kopii. Starší nešifrované objekty zůstávají čitelné pouze přes autorizovaný endpoint a nadále se zobrazují. Po potvrzeném odebrání přístupu se kopie dané rodiny i její čekající uploady odstraní. - Ukládání fotografií respektuje dostupný odhad úložiště, pokud jej prohlížeč poskytuje; IndexedDB však zůstává úložištěm typu best effort a operační systém může data odstranit. Při nedostatku místa se aplikace nespoléhá na veřejnou cache jako náhradní úložiště. - Oprávnění zaniká podle času zařízení i bez sítě. Klient si pamatuje poslední pozorovaný čas a odmítne zjevný návrat hodin. Prohlížeč však nemá důvěryhodné hardwarové hodiny; uživatel s ovládáním zařízení může manipulovat časem. Bez serveru nelze ověřit okamžité zrušení účtu nebo členství, proto je oprávnění krátké a pouze pro čtení. - Odhlášení bez sítě okamžitě zablokuje lokální přístup a uloží pouze požadavek na dokončení serverového odhlášení. Při návratu sítě se odhlášení odešle před obnovením relace. Šifrovaná data se automaticky nemažou, aby nedošlo ke ztrátě lokálních změn; bez platného podepsaného oprávnění se ale neotevřou. Toto je základ pro bezpečné otevření naposledy zobrazeného Přehledu, nikoliv hotová synchronizace. Současný serverový Přehled se stále vykresluje z `demo.php` / `demo.example.php`; rodičovská jména a fotografie se však ověřují přes autorizované rodinné API. Ostatní přehledový obsah zůstává zčásti ukázkový a práce nad normalizovanými lokálními entitami dosud není implementovaná. Snímek proto může obsahovat poslední vykreslený obsah, nikoli potvrzení, že všechny položky jsou osobní data z databáze. Před úplným offline-first přechodem je nutné dokončit doménová API a lokální entity. Profilová fotografie a dříve vykreslený snímek Přehledu jsou nyní dostupné offline, pokud byly předtím úspěšně načteny a platí podepsané offline oprávnění. Osobní nastavení se při otevření zobrazí nejprve z šifrované lokální kopie; serverové ověření probíhá následně na pozadí a nepřepisuje rozpracovaný formulář. Novou profilovou fotografii lze bez sítě zařadit do synchronizace, pokud je rodinný klíč již odemčený; textové změny profilu zůstávají místním návrhem a nejsou potvrzeny serverem. Po připojení se upload odešle přes autorizované API; do té doby funguje jen na tomto zařízení. Poslední uložený přehled kreditu lze zobrazit offline jako zastaralý snímek, ale změna tarifu, platby a aktuální potvrzení zůstatku vyžadují síť. Přihlášení, změna oprávnění, první stažení fotografie, přijetí pozvánky, rodinné mutace bez lokální fronty a média, která nebyla dříve uložena, stále vyžadují síť. Offline zápisy běžných entit, synchronizační fronta a konflikty nejsou touto změnou doplněny. Šifrování IndexedDB chrání uložený obsah při běžném čtení databázových záznamů. Klíč je však uložen jako neexportovatelný `CryptoKey` ve stejném profilu prohlížeče a skript stejného originu jej může použít. Model proto předpokládá zámek zařízení operačním systémem; nechrání před XSS, škodlivým rozšířením ani útočníkem s odemčeným profilem. PIN ani biometrie nejsou součástí této etapy. Soukromý RSA klíč nesmí být verzován ani zveřejněn. Produkční server musí bezpečně nakonfigurovat klíč odpovídající veřejnému klíči v aplikaci přes `security.offline_grant_private_key_file`. Lokální vývojový klíč je ignorovaný Gitem a musí být mimo repozitář bezpečně předán do produkční konfigurace; jeho výměna vyžaduje současnou rotaci připnutého veřejného klíče v klientu a nové vydání. ### 3.5 Rodinný šifrovací klíč – obnova frází Rodinný klíč a jeho 12slovná BIP-39 fráze vznikají v klientovi. Fráze se ukáže pouze při prvním zabezpečení rodiny správci a ověřují se dvě náhodně zvolená slova na následující obrazovce. Po dokončení se čitelná fráze zahodí a v nastavení se nezobrazuje. Server uchovává pouze AES-GCM obal klíče zašifrovaný klíčem odvozeným z fráze. Pro obnovu na novém zařízení se do IndexedDB ukládá pouze šifrovaný obnovovací obal, odděleně podle účtu a rodiny. Na autorizovaném zařízení se po běžném přihlášení rodinný klíč automaticky načte z druhého obalu zašifrovaného neexportovatelným klíčem Web Crypto, který zůstává v IndexedDB stejného původu. Čitelný rodinný klíč zůstává po dobu relace v paměti. Fráze se neukládá do IndexedDB, localStorage, Service Worker cache ani rozpracovaného průvodce. Vymazání či poškození místního úložiště a nové zařízení vyžadují vlastní obnovovací seed. Tento klíč není hardwarově vázaný; skript stejného původu jej může použít, proto nechrání před XSS. Čekající druhý rodič získá stejný rodinný klíč přes jednorázové QR předání po ověření e-mailového kódu. QR dekodér je součástí statického offline App Shell; samotné ověření, přijetí členství a uložení obnovovacího obalu vyžadují internet. Druhý rodič získá vlastní obnovovací frázi a samostatný zašifrovaný obal. Hosté rodinný klíč nezískávají. Tabulky PRF z migrace `0016_rodinne_e2ee_prf` zůstávají zachovány, ale klient je nepoužívá. Nové profilové fotografie jsou klientsky šifrovány podle části 3.4; rodinná metadata, videa a jiné vzpomínky zatím šifrovány nejsou, takže nejde o úplné E2EE rodinných dat. Přijetí pozvánky vyžaduje internet pro ověření kódu a atomické vytvoření členství. QR se dekóduje lokálně pomocí staticky uložené knihovny jsQR, která je součástí offline App Shell; obraz fotografie ani čitelné QR tajemství se neposílají do serverového API. Při vytvoření pozvánky se původní QR payload uloží v IndexedDB zašifrovaný samostatným neexportovatelným AES-GCM klíčem pro konkrétní účet a rodinu. Po restartu se původní payload načte z této lokální kopie bez seedu. Pokud starší pozvánka lokální kopii nemá, může ji klient sestavit pouze tehdy, když už je rodinný klíč na zařízení automaticky dostupný. Serverový seznam vrací oprávněnému správci pouze šifrovaný obal QR tajemství (zašifrovaný rodinným klíčem), nikoli čitelné tajemství. Při přijetí klient po naskenování předloží odvozený důkaz QR; samotný šestimístný e-mailový kód nestačí. Rodinný klíč se při zobrazení existujícího QR znovu negeneruje a pozvánka se nemění. Lokální QR kopie i obal rodinného klíče jsou best-effort: prohlížeč nebo operační systém může IndexedDB odstranit. Neexportovatelné klíče omezují čitelnost uložených záznamů mimo aplikaci, ale skript stejného původu je může použít; nechrání před XSS, škodlivým rozšířením ani útočníkem s odemčeným profilem prohlížeče. Nejde o hardwarově vázaný trezor. Starší pozvánka vytvořená před ukládáním QR do zařízení může vyžadovat dostupný klíč daného zařízení k jednorázovému vytvoření lokální kopie; aplikace nesmí QR domýšlet ani znovu generovat. Rodinné pozvánky, e-mail a změny členství nejsou offline operace. Offline zápisy, šifrované normalizované rodinné entity, konflikty a synchronizace nejsou touto základní implementací aktivované. Rezervovaná úložiště `outbox` a rozsahové klíče jsou pouze rozšiřující body, nikoli funkční fronta. ### 3.3 Lokální stav entity Každá lokální entita navíc obsahuje: ```json { "syncState": "synced | pending | conflict | rejected", "serverRevision": 12, "localVersion": 3, "pendingOperationIds": ["…"], "lastServerSnapshot": {}, "localUpdatedAt": "2026-11-04T14:30:00.000Z" } ``` `localUpdatedAt` slouží UI a diagnostice; nerozhoduje samo o vítězi konfliktu. ## 4. Uložení uživatelské změny Jedna IndexedDB transakce musí: 1. načíst aktuální lokální entitu; 2. provést klientskou validaci; 3. vytvořit nebo aktualizovat entitu a zvýšit `localVersion`; 4. vytvořit položku `outbox` s novým `operation_id`; 5. zapsat obě změny atomicky; 6. teprve po úspěšném commitu aktualizovat UI jako „uloženo v zařízení“. Pád mezi lokálním zápisem a síťovým přenosem je bezpečný, protože fronta již existuje. Fronta nesmí být udržována jen v paměti. ## 5. Tvar mutace ```json { "operation_id": "uuid", "device_id": "uuid", "family_uuid": "uuid", "entity_type": "record", "entity_uuid": "uuid", "operation": "create | update | delete", "base_revision": 12, "client_created_at": "2026-11-04T14:30:00.000Z", "changed_fields": ["title", "body"], "payload": {}, "schema_version": 1 } ``` - `create` má `base_revision: 0`. - `update` a `delete` nesou naposledy známou serverovou revizi. - Payload obsahuje úplnou novou hodnotu měněných polí nebo celé entity podle konkrétního typu; nesmí být nejednoznačný. - `client_created_at` není autorita pro pořadí serverových změn. - Server vypočítá hash normalizovaného payloadu a uloží jej k `operation_id`. ## 6. Synchronizační cyklus ### 6.1 Spouštěče - po přihlášení a otevření rodiny; - při startu aplikace; - při návratu karty do popředí; - na událost `online` jako impuls, nikoli důkaz funkční sítě; - po lokální změně, pokud je připojení pravděpodobně dostupné; - ručním tlačítkem „Synchronizovat“; - přes Background Sync, pouze pokud jej prohlížeč podporuje. Synchronizační zámek zajistí nejvýše jeden běh pro rodinu v jednom kontextu. Mezi kartami se koordinuje přes Web Locks API, pokud je dostupné, jinak pomocí časovaného lease v IndexedDB a BroadcastChannel. ### 6.2 Doporučené pořadí 1. ověř platnou session a načti aktuální členství; 2. odešli dávku čekajících nemediálních mutací (`push`); 3. zpracuj potvrzení, odmítnutí a konflikty atomicky; 4. stáhni změny od posledního kurzoru (`pull`), dokud server nevrátí konec; 5. aplikuj změny do IndexedDB v transakcích; 6. odešli metadata médií a následně binární obsah; 7. znovu odešli mutace, které čekaly na potvrzené médium; 8. proveď závěrečný `pull`; 9. aktualizuj čas a stav poslední úspěšné synchronizace. Push před pull umožní serveru posoudit změny proti očekávané revizi. Konflikt se neztratí následným pullem, protože lokální varianta je uložena samostatně. ### 6.3 Endpointy Navržené API: | Endpoint | Účel | |---|---| | `POST /api/v1/sync/push` | Dávka mutací, idempotentní výsledky po položkách. | | `GET /api/v1/sync/pull?family={uuid}&cursor={n}&limit={n}` | Změny po kurzoru. | | `POST /api/v1/media/uploads` | Založení nebo obnovení upload session. | | `PUT /api/v1/media/uploads/{uuid}/parts/{n}` | Odeslání části. | | `POST /api/v1/media/uploads/{uuid}/complete` | Ověření velikosti/hash a dokončení. | | `GET /api/v1/sync/status` | Bezpečný diagnostický stav a kompatibilita schématu. | **Návrh k potvrzení:** zda Webglobe limity vyžadují upload po částech. Pro fotografie může stačit opakovatelný celý upload, pro velká videa je chunking pravděpodobně nutný. ## 7. Idempotence a opakování - Server má `UNIQUE(operation_id)`. - První zpracování uloží výsledek do `sync_operations` ve stejné transakci jako změnu entity. - Opakování stejného ID a stejného payload hashe vrátí původní výsledek bez druhé změny. - Stejné ID s jiným payload hashem vrátí `OPERATION_ID_REUSED` a nic nezmění. - Síťový timeout po odeslání není důvod vytvořit nové ID; klient opakuje tutéž operaci. - Dávka vrací výsledek každé položky, protože část může uspět a část skončit konfliktem. ## 8. Konflikty ### 8.1 Kdy konflikt vznikne - serverová revize je vyšší než `base_revision` a změny se překrývají; - entita byla na serveru smazána, zatímco klient ji upravil; - klient maže entitu, kterou někdo jiný změnil; - unikátní nebo doménové pravidlo již po jiné změně neplatí; - uživatel ztratil oprávnění před synchronizací; - vazba míří na smazaný nebo nepřístupný objekt. ### 8.2 Automaticky bezpečné sloučení Automatické sloučení je povoleno pouze, když server zná základní snapshot a množiny změněných polí se nepřekrývají. Příklad: zařízení A změnilo `title`, zařízení B `is_favorite` ze stejné revize. Výsledek dostane novou serverovou revizi a audit obou autorů. Automaticky neslučovat: - dva různě upravené dlouhé texty; - změnu a smazání; - změnu stejného pole; - pořadí médií, pokud se překrývají přesuny; - role, členství, zapečetění dopisu a citlivá bezpečnostní nastavení. ### 8.3 Uživatelské řešení Konflikt uchová: - společnou základní verzi, pokud je dostupná; - lokální variantu; - aktuální serverovou variantu; - změněná pole, autory a časy; - bezpečné návrhy řešení. UI nabídne „ponechat moji verzi“, „použít verzi z rodiny“ nebo u textu ručně sestavit novou verzi. Vyřešení je nová mutace proti aktuální serverové revizi. Do té doby se žádná varianta nemaže. Oprávnění nelze konfliktním dialogem obejít. Pokud uživatel ztratil právo zapisovat, může svou lokální variantu pouze bezpečně exportovat pro vlastní potřebu, nikoli ji vnutit serveru. ## 9. Závislosti mezi mutacemi - Vytvoření rodiče musí předcházet vytvoření vazby, která jej používá. - `outbox` obsahuje `depends_on_operation_ids`. - Topologické řazení detekuje cyklus jako chybu dat, nikoli nekonečné čekání. - Server může přijmout dávku souvisejících nových UUID v jedné transakci, pokud jsou všechny entity platné. - Selhání rodiče označí závislou operaci jako blokovanou s vysvětlením; nemaže ji. ## 10. Smazání a obnova - Offline smazání vytvoří lokální náhrobek a mutaci `delete` s `base_revision`. - Server nastaví `deleted_at`, zvýší revizi a zapíše `change_log`. - Ostatní zařízení náhrobek stáhnou a skryjí objekt z běžného UI. - Obnova z koše je nová explicitní mutace proti aktuální revizi. - Médium se fyzicky nesmaže, dokud na něj existuje živá vazba, není po retenční době a není splněna zálohovací politika. - Staré zařízení za hranicí uchovávaného change logu musí provést úplnou resynchronizaci, ne hádat rozdíl. ## 11. Synchronizace médií ### 11.1 Offline vytvoření - Metadata záznamu a lokální `media` entita vzniknou ihned. - Originální Blob se uloží do `mediaBlobs`; zmenšený náhled může sloužit pro UI. - Aplikace zkontroluje dostupnou kvótu přes Storage API, pokud je podporováno. - Pokud originál nelze bezpečně uložit, aplikace musí před opuštěním obrazovky jasně říct, že soubor čeká jen v aktuální relaci, nebo vytvoření odmítnout. Nesmí předstírat trvalé uložení. ### 11.2 Přenos 1. vypočítat SHA-256, ideálně streamovaně/po částech; 2. založit upload session s metadaty; 3. server může potvrdit již existující identický originál v dané rodině; 4. odeslat chybějící části; 5. dokončit session; 6. server ověří celý hash, velikost, MIME a povolený formát; 7. klient označí Blob jako serverově potvrzený; 8. lokální originál lze odstranit až podle uživatelského nastavení a po ověřeném serverovém potvrzení. ### 11.3 Omezení prohlížeče - iOS může uvolnit úložiště a omezuje Background Sync. - Velká videa mohou překročit IndexedDB nebo hostingový limit. - Aplikace zobrazuje využití, varování a seznam médií čekajících na upload. - Pokud prohlížeč podporuje `navigator.storage.persist()`, aplikace může uživatele požádat o trvalé úložiště ve vhodný okamžik. ## 12. Service Worker a cache ### 12.1 Co se cachuje - základní HTML App Shell; - verzované CSS, JS, fonty a ikony; - statická offline obrazovka. ### 12.2 Co se necachuje jako běžná response - osobní API JSON; - originální média a autorizované download odpovědi; - exportní ZIP/PDF; - přihlášení, reset hesla a bezpečnostní endpointy. ### 12.3 Strategie - statická verzovaná aktiva: cache-first; - navigace: App Shell cache-first; nové vydání se načítá do samostatné cache a aktivuje existujícím mechanismem buildu; - API: network-only z pohledu Service Workeru, aplikační data obsluhuje IndexedDB; - aktualizace: nový worker čeká, UI oznámí dostupnou verzi a provede reload až po uložení formulářů. ## 13. Chyby, backoff a stav v UI ### 13.1 Klasifikace | Typ | Příklad | Chování | |---|---|---| | Přechodná síťová | timeout, 502, ztráta spojení | Opakovat se stejným ID a backoffem. | | Přihlášení | 401, expirovaná session | Zastavit push, vyžádat přihlášení, zachovat frontu. | | Oprávnění | 403 | Označit položku `rejected`, nabídnout bezpečný export lokální verze. | | Validace | 422 | Neopakovat automaticky; ukázat pole a možnost opravy. | | Konflikt | 409 | Uložit do `conflicts`, vyžádat řešení nebo bezpečně sloučit. | | Limit | 413/507 | Zastavit médium, vysvětlit limit a zachovat lokální data. | | Nekompatibilní klient | 426 nebo vlastní kód | Vyžádat aktualizaci App Shellu bez ztráty fronty. | ### 13.2 Backoff Exponenciální zpoždění s náhodnou odchylkou, například 2 s, 5 s, 15 s, 1 min, 5 min, maximálně 30 min. Ruční pokyn může čekání zkrátit, ale nesmí zahltit server. Odpověď `Retry-After` se respektuje. ### 13.3 Uživatelské stavy - „Uloženo v tomto zařízení“; - „Čeká na synchronizaci (3)“; - „Synchronizováno“ s časem posledního úspěchu; - „Je potřeba vyřešit konflikt“; - „Přihlášení vypršelo, data v zařízení zůstala zachována“; - „Médium čeká na nahrání“. Samotná zelená ikonka bez textové alternativy nestačí. ## 14. Více karet, zařízení a účtů - BroadcastChannel informuje ostatní karty o změně fronty a dokončené synchronizaci. - Jedna karta je vedoucím synchronizátorem, ostatní mohou číst lokální stav. - Každý účet má oddělenou IndexedDB. Přepnutí účtu nesmí zpřístupnit data předchozího účtu. - Odvolané zařízení/session nedostane nové změny. Lokální data se při příštím kontaktu uzamknou a nabídne se bezpečný postup dle oprávnění. - Změna role se synchronizuje před dalšími zápisy; UI okamžitě omezí dostupné akce. ## 15. Kompatibilita schématu - Každá mutace nese `schema_version`. - Server přijímá pouze dokumentované podporované verze a vrací bezpečný návod k aktualizaci. - Nové nepovinné pole může starší klient ignorovat jen tehdy, když tím nezmění význam dat. - Odstranění/přejmenování pole používá přechodné období dvojího čtení a případně zápisu. - Migrace IndexedDB nesmí vyprázdnit `outbox`, `conflicts` ani lokální média. ## 16. Zabezpečení offline dat IndexedDB není bezpečný trezor proti uživateli nebo malwaru v odemčeném profilu prohlížeče. Proto: - minimalizovat lokální data na rodiny, které uživatel skutečně otevřel; - respektovat odhlášení a vzdálené odvolání relace; - nezapisovat tokeny do IndexedDB nebo `localStorage`; autentizace zůstává v `HttpOnly` cookie; - omezit citlivý obsah v notifikacích a náhledech; - Content Security Policy a ochrana před XSS jsou kritické, protože XSS může číst IndexedDB; - u sdíleného zařízení zobrazit jasné upozornění. **Návrh k potvrzení:** volitelný lokální zámek/PIN a šifrování vybraných lokálních dat klíčem odvozeným od PIN. Musí být navrženo tak, aby PIN nevytvářel falešný pocit ochrany a aby ztráta klíče neohrozila serverová data. ## 17. Testovací matice Minimální automatické a ruční scénáře: 1. vytvoření každého typu záznamu offline, restart PWA, zobrazení a pozdější synchronizace; 2. úprava a smazání offline; 3. opakované odeslání stejné operace po timeoutu bez duplicity; 4. změna pořadí paketů a částečně úspěšná dávka; 5. dvě zařízení mění různá pole – bezpečné sloučení; 6. dvě zařízení mění stejné pole – konflikt se zachováním obou variant; 7. změna proti serverově smazané entitě; 8. ztráta role před synchronizací; 9. vytvoření záznamu s více médii, přerušení uploadu a pokračování; 10. nedostatek IndexedDB a serverové kvóty; 11. zavření prohlížeče uprostřed transakce a uploadu; 12. aktualizace Service Workeru s čekající frontou; 13. expirovaná session a opětovné přihlášení bez ztráty fronty; 14. starý klient mimo retenční okno change logu – úplná resynchronizace; 15. více otevřených karet bez dvojitého odeslání; 16. poškozený nebo záměrně změněný payload se stejným `operation_id`. ## 18. Provozní diagnostika Uživatel může zobrazit: - poslední úspěšnou synchronizaci pro každou rodinu; - počet čekajících změn a médií; - konflikty a odmítnuté položky; - přibližné využití lokálního úložiště; - ID zařízení a verzi aplikace; - bezpečný diagnostický balíček bez osobního obsahu, tokenů a binárních dat. Server sleduje počty a kódy chyb, stáří nejstarší čekající známé operace a selhání uploadů, ale neloguje obsah rodinných záznamů. ## 19. Návrhy k potvrzení 1. Velikost push dávky a pull stránky po měření na Webglobe. 2. Maximální velikost části uploadu a podpora resumable uploadu. 3. Retence serverového change logu a náhrobků. 4. Lokální zámek a případné šifrování IndexedDB. 5. Zda uživatel může vypnout ukládání originálních médií v zařízení ihned po potvrzeném uploadu. 6. Zda budou některé zdravotní či zapečetěné záznamy vůbec dostupné offline.