habit+timer

doxa-habit/MANUAL_CZ.md

@@ -0,0 +1,41 @@
+# Uživatelský manuál DOXA Habit 🎯
+
+Tento manuál popisuje použití aplikace DOXA Habit pro sledování návyků.
+
+## Spuštění programu
+
+Spusťte aplikaci příkazem:
+```bash
+doxa-habit
+```
+Na úvodní obrazovce stiskněte `Enter` pro přechod do hlavního rozhraní.
+
+## Rozhraní aplikace
+
+1. **SEZNAM NÁVYKŮ**: Zobrazuje všechny vaše návyky, aktuální streak (např. `🔥3` nebo `❄️0`) a mini heatmapu posledních 7 dní (`▓` splněno, `░` nesplněno).
+2. **DETAIL MODAL**: Zobrazí podrobnější popis návyku, frekvenci a úspěšnost v procentech za 7/30 dní.
+3. **STATISTIKY**: Tabulkový přehled všech vašich návyků a jejich úspěšnosti.
+4. **PŘIDAT / UPRAVIT**: Formulář pro zakládání či editaci návyků.
+
+## Ovládání
+
+### Hlavní obrazovka
+- `1`: Přidat nový návyk.
+- `2`: Upravit vybraný návyk.
+- `3`: Exportovat historii splnění do souboru `~/.doxa-habit/export/<název>_history.csv`.
+- `4`: Smazat vybraný návyk.
+- `t`: Označit návyk jako dnes splněný (střídá ✅ a ⬜).
+- `s`: Zobrazit celkové statistiky všech návyků.
+- `l`: Přepne jazyk rozhraní (čeština/angličtina).
+- `/`: Vyhledat/filtrovat návyky podle názvu.
+- `Enter`: Otevřít detail návyku v modálním okně.
+- `q` / `Esc`: Ukončit program.
+
+### Formulář (Přidat / Upravit)
+- `Tab`: Přechází mezi poli "Název" a "Popis".
+- `f`: Přepíná frekvenci návyku (Denní / Týdenní).
+- `Enter`: Uloží data.
+- `q` / `Esc`: Zruší změny a vrátí se zpět na hlavní seznam.
+
+### Okna detailu a statistik
+- `q` / `Esc`: Vrátí se na hlavní seznam návyků.