new-doxa-monorepo

doxa-notes/02_manuals.md

@@ -0,0 +1,64 @@
+# Návod k použití — DOXA (v26.07.01)
+
+### Vytvoření nové poznámky
+
+    Klikni na tlačítko ➕ Nová poznámka a zadej název.
+    Položka se objeví v seznamu. Klikem načteš název a obsah do editoru nahoře.
+    Uprav obsah a klikni Uložit nyní.
+
+## Tagy
+
+Tagy jsou slova nebo fráze, která popisuje obsah poznámky. V aplikaci Doxa díky nim můžete filtrovat poznámky podle tagu.
+
+  * Klikni do pole tagy a zadej název tagu (uloží se stejně s poznámkou).
+  * Poznámku pomocí tagu pak vyhledáš v poli s lupou Filtrovat poznámky podle tagu....
+
+### Editace a mazání
+
+    * Inline: klikni na poznámku, uprav obsah a stiskni Uložit nyní.
+    * Modal: klikni na ikonu ✎ vedle položky pro pokročilou editaci v modal okně.
+    * Mazání: ikona 🗑 u položky — po potvrzení se poznámka smaže.
+
+### Přesouvání pořadí poznámek
+
+    Použij šipky ↑ / ↓ u položek.
+    Nebo přetahuj položky (drag & drop) na požadované místo — při přetažení se ukáže indikátor vložení.
+
+### Přepínání vzhledu
+
+V horním menu najdeš tlačítko pro přepínání vzhledu. Aplikace podporuje tři režimy:
+
+    * Světlý — ikona: ☀️
+    * Tmavý — ikona: 🌙
+    * Respektovat systém — ikona: 🌓 — aplikace bude sledovat systémovou volbu (prefers-color-scheme) a automaticky se přepne, pokud se změní systémový motiv.
+
+Kliknutím na tlačítko v menu cyklíš mezi režimy (Light → Dark → System). Vybraná volba se uloží do localStorage pod klíčem doxa_theme a přetrvá mezi stránkami a obnovami. Pokud chceš volbu resetovat, otevři konzoli prohlížeče a spusť: localStorage.removeItem('doxa_theme') nebo vymaž storage v nástrojích pro vývojáře.
+
+### Automatické ukládání
+
+Aplikace nyní automaticky ukládá změny poznámek lokálně během psaní (autosave). V běžném prohlížeči se změny ukládají do localStorage (klíč doxa_notes_v1) bez nutnosti manuálního ukládání — data se uloží po krátké prodlevě. Pokud aplikaci spouštíš v Electron/Node režimu, změny se zapisují přímo do lokálního souboru.
+
+**Průběžně si úkládej i JSON soubor manuálně!!**
+
+### Manuální uložení
+
+Vedle editoru najdeš tlačítko Uložit nyní. I když autosave ukládá průběžně, tlačítko je užitečné v těchto případech:
+
+    Okamžité uložení — provede persist bez čekání na autosave (užitečné před zavřením aplikace nebo pokud chcete rychlou jistotu, že jsou změny zapsány).
+    Vizuální potvrzení — po uložení se zobrazí stav „Uloženo“, což dává uživateli okamžitou zpětnou vazbu.
+    Bez stažení — tlačítko Uložit poznámku neprovádí stažení souboru; pokud chcete stáhnout JSON, použijte tlačítko Exportovat JSON.
+
+Pro přenos dat mezi zařízeními použijte tlačítko Exportovat JSON (stáhne soubor doxa.json), nebo z konzole spusťte saveNotesToFile(true).
+
+### Import / Export
+
+Pro import klikni Importovat JSON a vyber soubor. Podporované formáty:
+
+    Objekt s polem notes: { "notes": [ ... ] }
+    Přímo pole: [ { ... }, { ... } ]
+
+Export je nyní dostupný přes tlačítko Exportovat JSON (vedle tlačítka Uložit). Aplikace zároveň provádí autosave lokálně — nic neztratíte, pokud zapomenete manuálně uložit. Chcete-li stáhnout JSON přes skript, můžete také spustit v konzoli saveNotesToFile(true).
+
+### Bezpečnost a zálohy
+
+Výchozí režim je local‑first: data zůstávají ve tvém prohlížeči (localStorage) nebo lokálním souboru, aplikace je sama neodesílá.