Uživatelská dokumentace aplikace JaHoCa

JaHoCa je multiplatformní aplikace, která si klade za cíl centralizovat, zjednodušit a zpřehlednit evidenci domácích financí. K dispozici je možnost automatického evidování trvalých plateb, či sestavení grafů příjmů a výdajů za zvolená odbobí.

1. Ujistěte se, zda máte na vašem počítači nainstalováno Java Runtime Environment 1.6 (JRE 1.6)
2. Rozbalte archiv obsahující program
3. Nyní již můžete program spustit pomocí souboru jahoca.exe, který se nachází v rozbaleném adresáři

Ke spuštění programu lze též použít spustitelný *.jar soubor jahoca.jar.

JaHoCa nechce uživatele Windows obtěžovat přítomností zbytečného instalátoru a s ní, spojeným “špiněním registrů”. Pokud nebudete chtít program JaHoCa nadále využívat, stačí jej vyhodit do koše.

1. Ujistěte se, zda máte na vašem počítači nainstalováno Java Runtime Environment 1.6 (JRE 1.6)
2. Rozbalte archiv obsahující program
3. Nyní již můžete program spustit pomocí souboru jahoca.sh, který se nachází přímo v rozbaleném adresáři

Při prvním spuštení aplikace se uživateli zobrazí editační okno s titulkem Počáteční nastavení aplikace, ve kterém je možno provést výběr typu databázového systému, který bude použit pro uložení uživatelových dat.
V případě, že se neorientujete v databázových systémech, je doporučeno ponechat výchozí nastavení a pokračovat tlačítkem Budiž.

1. Po zobrazení dialogu Počáteční nastavení aplikace klikněte na Budiž
2. Nyní si již můžete vytvořit svůj účet v programu JaHoCa

K dispozici jsou dva typy databází: výchozí, souborová HSQLDB a volitelná MySQL.

V případě použití HSQLDB budou veškeré informace uživatele uloženy:

• ve složce .jahoca v uživatelově domovském adresáři, v případě operačního systému Linux.
• přímo v hlavním adresáři aplikace, v případě ostatních operačních systému, včetně Windows.

V případě použití MySQL je uživatel vyzván k zadání přihlašovacích údajů k lokálnímu MySQL serveru, na kterém je následně, pokud to práva uživatele k MySQL serveru dovolují, vytvořena databáze se zvoleným názvem.

Zvolené nastavení je možné kdykoliv změnit přímo z aplikace JaHoCa.

Pokud jste už používali starší verzi programu JaHoCa, může program vyžadovat přechod na vyšší verzi databáze, pokud tak učiníte, bude stará databáze nenávratně nahrazena novou a vaše data budou po vašem souhlasu převedena do nové databáze. S novou databází už dále není možné pracovat ve staršíh verzích programu.

Po úspěšné konfirmaci počátečního nastavení, v případě prvního spuštění aplikace, či ihned po spuštění aplikace, v případě opakovaného spuštění aplikace, se zobrazí dialog s titulkem Přihlášení uživatele. Zde je možno vytvořit nový účet v aplikaci JaHoCa, nebo použít účet stávající, pokud existuje.

1. V okně s názvem Přihlášení uživatele klikněte na Nový
2. Zobrazí se okno Vytvoření uživatele, zde zadejte nové, ještě nepoužité uživatelské jméno (Login), vyplňte heslo a jeho potvrzení
3. Po potvrzení kliknutím na Budiž se již zobrazí hlavní okno aplikace

1. V okně s názvem Přihlášení uživatele vyberte ze seznamu účtů (Login), účet, ke kterému se chcete přihlásit
2. Vyplňte heslo a klikněte na Budiž
3. Nyní se již zobrazí hlavní okno aplikace

Hlavní okno programu se skládá z velkého, ústředního panelu s šesti záložkami: “Operace, Trvalé příkazy, Předměty platby, Skupiny plateb, Osoby, Souhrny” a malé lišty s položkami: “Sobour, Nastavení, Aplikace“, v horní části programu.

Sekce Operace je hlavní a výchozí sekcí programu JaHoCa. Sekce obsahuje tabulku jednotlivých operací. Kde položka v tabulce operací představuje jeden finanční pohyb, u kterého jsou evidovány nákladová a příjmová část a další doplňující informace. Nad tabulkou operací se nachází editační panel. V dolní části okna se nachází sumační řádek.

• datum - datum provedení/evidování operace
• předmět platby - účel platby (za co se platilo)
• skupina platby - zařazení platby do určité skupiny
• plátce - kdo platil
• příjemce - komu platil
• komentář - prostor pro poznámky spojené s operací
• příjem - přijatá částka
• výdaj - zaplacená částka

• Nový záznam - přidání nového záznamu do tabulky operací
• Editace záznamu - editace stávajícího záznamu v tabulce operací
• Smazat záznam - smazání vybraného záznamu z tabulky operací
• Zobrazit detail záznamu - zobrazí podrobné informace o vybraném záznamu z tabulky operací
• Tisková sestava - sestavení tiskové sestavy z aktuálně zobrazených operací tabulky operací
• Exportovat (*.pdf, *.xls) - vyexportuje aktuálně zobrazené operace z tabulky operací do PDF nebo XLS formátu
• Filtr počáteční datum - nastavení počátečního data, aktuálně zobrazeného výběru operací
• Filtr koncové datum - nastavení koncového data, aktuálně zobrazeného výběru operací

Při startu aplikace se filtr pro počáteční a koncové datum nastavuje tak, aby byly zobrazeny všechny operace, provedené v aktuálním měsíci.

Detail záznamu je možné zobrazit dvojitým poklepáním na vybraný řádek v tabulce operací.

Po klinutí na Nový záznam se zobrazí dialog Nová operace, zde je možné vyplnit parametry nově přidávané operace. Položky Předmět platby, Příjemce, Plátce a Skupina se vybírají se seznamů existujících předmětů plateb, skupin a osob. Nový předmět platby, skupinu či osobu je možné založit přímo z vytváření nové operace, kliknutím na příslušné tlačítko +, vedle výběrového pole s předmětem platby, skupinou nebo osobou.

V sekci Trvalé příkazy lze nastavit automatizované přidávání operací. Po založení trvalého příkazu s uvedenou periodou, provede aplikace pokaždé po uplynutí dané časové periody automaticky zápis operace s uvedenými informacemi do tabulky operací. Zrušit automatické přidávání operace, lze smázáním příslušného trvalého příkazu.

• datum - datum provedení/evidování operace
• předmět platby - účel platby (za co se platilo)
• skupina patby - zařazení platby do určité skupiny
• plátce - kdo platil
• příjemce - komu platil
• komentář - prostor pro poznámky spojené s trvalým příkazem
• příjem - přijatá částka
• výdaj - zaplacená částka
• perioda - doba po které se provede opětovné zaúčtování operace

• Nový záznam - přidání nového záznamu do tabulky operací
• Editace záznamu - editace stávajícího záznamu v tabulce operací
• Smazat záznam - smazání vybraného záznamu z tabulky operací

Smazáním trvalého příkazu se nesmažou již zapsané operace v tabulce operací. Pokud je smazána operace, která vznikla automaticky z trvalého příkazu, dříve než samotný trvalý příkaz, může být znovu automaticky zaevidována.

Sekce Předměty plateb slouží k evidenci zboží a služeb, které jsou předmětem platby.

• název - název zboží/služby
• komentář - prostor pro poznámky spojené s daným zbožím/službou

• Nový záznam - přidání nového záznamu do tabulky předmětů
• Editace záznamu - editace stávajícího záznamu v tabulce předmětů
• Smazat záznam - smazání vybraného záznamu z tabulky předmětů

Sekce Skupiny plateb slouží k jednoduššímu třídění jednotlivých plateb.

• název - název skupiny
• komentář - prostor pro poznámky spojené s danou skupinou

• Nový záznam - přidání nového záznamu do tabulky skupin
• Editace záznamu - editace stávajícího záznamu v tabulce skupin
• Smazat záznam - smazání vybraného záznamu z tabulky skupin

Sekce Osoby slouží k evidenci osob, které mohou vystupovat jako plátci a příjemci při platebních operacích.

• název - název zboží/služby
• komentář - prostor pro poznámky spojené s daným zbožím/službou

• Nový záznam - přidání nového záznamu do tabulky osob
• Editace záznamu - editace stávajícího záznamu v tabulce osob
• Smazat záznam - smazání vybraného záznamu z tabulky osob

V sekci Souhrny je možné zobrazit si různé grafy za určité období.

• Osoby - obsahuje grafy týkající se příjmů/výdajů jednotlivých osob
• Předměty plateb - obsahuje grafy týkající se příjmů/výdajů pro jednotlivé předměty plateb
• Skupiny - obsahuje grafy zobrazující zastoupení jednotlivých skupin mezi příjmy/výdaji, jsou zde také grafy pro příjmy/výdaje osob a předmětů plateb použitých v rámci jedné skupiny
• Datumy - velikost příjmů/výdajů v jednotlivých měsících sledovaného období

Skrze záložku Nastavení v horní části aplikace je možné změnit některé z výchozích, nebo uživatelských nastavení.

• Přihlášení jiného uživatele - odhlášení stávajícího uživatele a přihlášení nového uživatele
• Změna loginu, hesla přihlášeného uživatele - formulář pro změnu přístupových údajů
• Smazání přihlášeného uživatele - formulář kompletní smazání účtu aktivního uživatele
• Změna výchozího nastavení aplikace - formulář s výběrem databázového systému a přihlašovacích údajů k databázi
• Změna vzhledu aplikace - formulář nabízející uživateli vybrat si z několika grafických témat programu

Veškerá nastavení programu JaHoCa se ukládají do adresáře .jahoca, který se vytváří v uživatelově domovském adresáři. Odstraněním tohoto adresáře budou resetovány všechny uživatelská nastavení programu, zároveň v případě že je využívána HSQLDB databáze pro uložení dat, bude celá tato databáze smazána. Zálohováním adresáře .jahoca lze provést zálohování aktuální podoby HSQLDB databáze a aktuálního nastavení aplikace.

Veškerá nastavení programu JaHoCa se ukládají přímo do adresáře, ve kterém se nachází soubor jahoca.jar. Vlastnímu nastavení aplikace přísluší textový soubor auditcfg, jeho smazáním lze provést reset nastavení programu JaHoCa. Databázi HSQLDB přísluší soubory <name>.properties a <name>.script, kde <name> je název databáze, zálohováním těchto souborů lze provést zálohování celé databáze.

Aby bylo minimalizováno riziko zcizení údajů, například hesla k mysql serveru, jsou důvěrná data uživatele uložena v šifrované podobě.