user-manual.md

@@ -4,7 +4,7 @@
 
 [[_TOC_]]
 
-## 1. Datové schránky
+## 1. Co je to Datová schránka?
 
 [Datové schránky](https://cs.wikipedia.org/wiki/Datov%C3%A1_schr%C3%A1nka) (dále jen DS) jsou prostředkem komunikace s orgány vládní moci (OVM). Pro potřeby této dokumentace se omezíme pouze na některé technické aspekty fungování DS, které jsou důležité pro porozumění programu Datovka. Zpráva v systému DS vzdáleně připomíná emailovou zprávu. Datové schránky mají následující charakteristické vlastnosti:
 
@@ -23,9 +23,9 @@ Všechny způsoby jsou popsány dále v tomto dokumentu.
 
 O zřízení datové schránky lze požádat na každém místě [Czech Point](http://www.czechpoint.cz). Po obdržení přihlašovacích údajů je nezbytné se nejprve přihlásit pomocí [webového rozhraní datových schránek](https://www.mojedatovaschranka.cz) a změnit uživatelské heslo. Teprve po této aktivaci datové schránky ji bude možné obsluhovat pomocí aplikace Datovka.
 
-## 2. ![datovka](https://gitlab.labs.nic.cz/labs/qdatovka/uploads/12d3470fb0affae2db01f2777b4a5459/datovka.png) **Datovka** - ovládání aplikace
+## 2. **Aplikce Datovka** - popis ovládání aplikace
 
-Datovka je program, který umožňuje přistupovat k datové schránce, procházet její obsah a vytvářet nové zprávy. Více informací o vlastnostech aplikace naleznete na [stránkách projektu](https://labs.nic.cz/cs/datovka.html). Datovka navíc realizuje do jisté míry placenou službu "Datový trezor", protože uchovává zprávy starší 90 dnů. Zprávy, které byly na serveru ISDS již odstraněny, v Datovce zůstávají uloženy jako lokální kopie, dokud si je uživatel sám nevymaže z lokální databáze.
+Datovka je aplikace pro mobilní zařízení s operačním systémem Android či iOS. Aplikace umožňuje přistupovat k jedné nebo více datovým schránkám, procházet jejich obsah, procházet obálky zpráv a manipulovat s přílohami. 
 
 ### 2.1 Zpráva v Datovce
 
@@ -39,13 +39,9 @@ Systém DS si sám uchovává informace o stavu zprávy (doručená, přečtená
 
 #### 2.2.1 Vytvoření účtu a přihlášení do DS
 
-Pokud spustíte Datovku poprvé, automaticky bude zobrazen dialog na vyplnění přihlašovacích údajů pro první schránku. Dokud údaje nevyplníte, nebude většina prvků ovládání aktivní. Přihlašovací údaje se skládají z kombinace uživatelského jména a hesla, nebo souboru s klientským certifikátem ve formátu PKCS12/PEM a hesla či jiné možné/zvolené metody přihlašování.
+Pokud spustíte Datovku poprvé, je třeba do ní nejprve přidat schránky. nění přihlašovacích údajů pro první schránku. Dokud údaje nevyplníte, nebude většina prvků ovládání aktivní. Přihlašovací údaje se skládají z kombinace uživatelského jména a hesla, nebo souboru s klientským certifikátem ve formátu PKCS12/PEM a hesla či jiné možné/zvolené metody přihlašování. Datovka si přihlašovací údaje a další údaje automaticky ukládá při ukončení aplikace. Při dalším spuštění aplikace se automaticky načtou a použijí pro přihlášení do DS. Účet bude v aplikaci vytvořen jen tehdy, podaří-li se úspěšně přihlásit na server DS a získat informace o uživateli a jeho datové schránce. Povinné informace na stránce pro vytvoření či úpravu účtu jsou název účtu, přihlašovací jméno, heslo. Dále je potřeba vybrat metodu přihlášení a případně zatrhnout tlačítko, že se jedná o DS v testovací provozu (speciální testovací server mimo reálný provoz). Lze zvolit možnost zapamatování hesla a vybrat, jestli se obash této schránky bude ukládat do lokálního uložiště zařízení (doporučeno) nebo dočasně do operační paměti zařízení (data budou po ukončení aplikace ztraceny).
 
-Datovka si přihlašovací údaje a další údaje automaticky ukládá při ukončení aplikace. Při dalším spuštění aplikace se automaticky načtou a použijí pro přihlášení do DS.
-
-Účet bude v aplikaci vytvořen jen tehdy, podaří-li se úspěšně přihlásit na server DS a získat informace o uživateli a jeho datové schránce. Povinné informace v dialogu pro vytvoření či úpravu účtu jsou název účtu, přihlašovací jméno, heslo. Dále je potřeba vybrat metodu přihlášení a případně zatrhnout tlačítko, že se jedná o DS v testovací provozu (speciální testovací server mimo reálný provoz). Lze zvolit možnost zapamatování hesla a možnost automaticky synchronizovat účet s ostatními účty.
-
-*Poznámka: V případě uložení hesla v aplikaci je třeba dostatečně zabezpečit přístup k vašemu domovskému adresáři!*
+*Poznámka: V případě uložení hesla v aplikaci se doporučuje nastavit bezpečnostní PIN, kterým budou uložená hesla šifrována*
 
 ##### **2.2.1.1 Přihlášení certifikátem**
 
@@ -69,31 +65,6 @@ Pro tento způsob autentizace je třeba jej nejprve aktivovat v [systému DS](ht
 
 *Poznámka: Po 30 minutách neaktivity je uživatel ze systému automaticky odhlášen a pro další práci se musí opět autentizovat jednorázovým kódem! Jde o vlastnost systému DS, nikoli Datovky.*
 
-##### **2.2.1.3 Vytvoření účtu z existující databáze**
-
-V Datovce je možné vytvořit účet z již existující databáze zpráv. Přes "Soubor" -> "Vytvořit účet z databáze" je možné vybrat požadovaný databázový soubor. Pokud se jedná o platný obsah databázového souboru zpráv a má-li název souboru správný formát, bude v Datovce vytvořen účet s názvem souboru nad touto databází. Tímto způsobem lze do Datovky vložit například databáze, pro které již neexistuje účet na serveru ISDS.
-
-Jedná-li se o aktivní účet a je požadováno jej synchronizovat se serverem ISDS, je potřeba přes vlastnosti účtu dodatečně doplnit chybějící přihlašovací údaje a zvolit správný typ autentizace.
-
-#### 2.2.2 Úložiště zpráv a konfigurační soubor
-
-Konfigurační data a nastavení Datovky se ukládají do souboru "dsgui.conf". Obálky zpráv a jejich obsahy se ukládají do databázových souborů, jejíchž názvy jsou "username{\_rok}\___0.db", kde:
-
-* username = vaše přihlašovací jméno do schránky
-* {_rok} = nepovinný údaj, avšak v novějších verzích Datovky určuje, že databáze obsahuje pouze zprávy dodané v rámci tohoto roku
-* 0 = označení, že se jedná o standardní datovou schránku mimo testovací prostředí ISDS (1 = testovací)
-* Příklad: *b5dr7e___0.db* nebo *b5dr7e_2015___0.db*
-
-Konfigurační soubor a jednotlivé databáze ke všem účtům naleznete v těchto adresářích (neplatí pro přenosnou verzi Datovky):
-
-* Windows XP: `c:\Documents and Settings\{user}\.dsgui\`
-* Windows Vista a novější: `c:\Users\{user}\AppData\Roaming\.dsgui\`
-* Linux a OS X: `/home/{user}/.dsgui/`
-
-Pokud požíváte vlastní umístění databázových souborů (v aplikaci jste si je přesměrovali jinam) a pokud si již nepamatujete jejich umístění, pak tuto informaci naleznete v souboru `dsgui.conf`. Hledejte záznamy označené jako `database_dir`. Další možnost nalezení databázových souborů je přepnout na název účtu v levém sloupci Datovky a v informacích o účtě v pravém panelu naleznete aktuální umístění databázových souborů.
-
-Pro přenosnou verzi se konfigurační soubor a databáze nacházejí přímo v adresáři s Datovkou ve složce `.dsgui` (pokud jste si jej nepřesměrovali jinam).
-
 #### 2.2.3 Organizace zpráv do složek
 
 Pro lepší přehlednost jsou zprávy v Datovce rozděleny do několika virtuálních složek. Tyto složky nemají žádnou souvislost s fyzickým umístěním zpráv v databázi a na serveru DS a slouží pouze pro zjednodušení orientace. Zprávy se v jednotlivých složkách zobrazují automaticky podle níže popsaných pravidel a uživatel nemůže zprávy mezi složkami přesunovat.
@@ -117,6 +88,11 @@ prostě všechny soubory z přílohy uložit do zvoleného adresáře najednou v
 
 *Upozornění: Proces stahování kompletní zprávy se všemi přílohami může trvat delší dobu v závislosti na rychlosti vašeho připojení k síti internet. Aktivita během stahování zprávy je zobrazována taktéž ve stavovém/progress panelu. Nedoporučujeme během stahování provádět další operace s Datovkou a raději vyčkat na dokončení započaté operace.*
 
+#### 2.2.6 Odeslání zprávy
+
+Tato operce není momentálně podporována.
+
+
 #### 2.2.6 Odeslání zprávy
 
 Tato operce není momentálně podporována.