Ako Beancount a Fava poháňajú dashboardy v reálnom čase

Úvod​

Beancount je open-source systém podvojného účtovníctva, ktorý ako hlavnú knihu používa súbory v čistom texte. Kladie dôraz na jednoduchosť, transparentnosť a flexibilitu pri sledovaní financií. Fava je výkonné webové rozhranie pre Beancount, ktoré poskytuje interaktívne rozhranie na prezeranie reportov, vizualizácií a správu vašej hlavnej knihy. V tomto reporte skúmame základné schopnosti Beancountu a Favy a to, ako pomocou týchto nástrojov dosiahnuť finančnú analytiku v reálnom alebo takmer reálnom čase. Pokrývame tipy na konfiguráciu pre automatizáciu a obnovu dát, vizualizačné funkcie Favy (pre okamžité zobrazenie peňažných tokov a odhaľovanie trendov), integráciu s externými dashboardmi (Grafana, Metabase atď.), príklady vlastných dashboardov a pluginov, prípady použitia v osobných financiách a financiách malých podnikov, porovnania s inými platformami (Power BI, QuickBooks) a výhody/nevýhody používania Favy + Beancountu pre dátami podložené poznatky.

Preskúmajte živý príklad hlavnej knihy:

Preskúmajte živú hlavnú knihu →

Základné schopnosti Beancountu a Favy​

Beancount (účtovný engine na báze obyčajného textu)​

• Podvojná hlavná kniha v čistom texte: Beancount ukladá transakcie do jedného textového súboru .beancount (alebo viacerých vzájomne zahrnutých súborov). Každá transakcia musí byť vyrovnaná (celkové strany Má dať = celkové strany Dal) naprieč účtami, čím sa vynucuje účtovná integrita. Formát čistého textu znamená, že vaše dáta sú čitateľné pre človeka, podliehajú verzovaniu a nie sú uzamknuté u žiadneho dodávateľa.
• Flexibilné hierarchické účty: Môžete definovať ľubovoľné účty (napr. Assets:Bank:Checking, Expenses:Food:Coffee) v hierarchii. Beancount nevnucuje názor na vašu účtovú osnovu, takže funguje pre osobné financie, účtovníctvo malých podnikov, investície atď. – je "flexibilný: funguje pre osobné financie, účtovníctvo malých podnikov, kryptomeny, akciové investície a viac."
• Viacero mien a komodít: Beancount má prvotriednu podporu pre viacero mien a komodít (napr. akcie, kryptomeny). Môžete zaznamenávať transakcie v rôznych menách, definovať výmenné kurzy (cenové direktívy) a sledovať nákladové základne. Ak sú k dispozícii cenové dáta, dokáže vytvárať reporty "v nákladovej cene" alebo "v trhovej hodnote". To ho robí vhodným pre portfóliá a medzinárodné financie.
• Automatizované kontroly a rovnováhy: Systém podporuje kontrolné zostatky (môžete deklarovať, aký zostatok účtu by mal byť k určitému dátumu, a Beancount nahlási chybu, ak nesúhlasí) a vyrovnávacie transakcie na uzatváranie kníh. Podporuje tiež počiatočné/záverečné zápisy vlastného imania a výpočet nerozdeleného zisku pre uzávierky období. Tieto pomáhajú udržiavať vaše knihy konzistentné a včas zachytávať chyby.
• Výkonný engine pre dotazy a reporty: Beancount prichádza s dopytovacím jazykom BQL (Beancount Query Language). Použite bea query pre BQL v termináli a bea report pre štandardné výkazy; nainštalujte rýchly štart CLI namiesto starších upstream konzolových skriptov. Môžete dotazovať hlavnú knihu pre vlastné reporty (napr. zoznam výdavkov podľa príjemcu platby, peňažný tok za obdobie) – v podstate zaobchádzate s hlavnou knihou ako s databázou. Zostáva rýchla aj s tisíckami transakcií. Exportujte CSV pomocou bea query -f csv -o report.csv "BQL", pričom BQL nahraďte svojím dotazom. Kompletné príklady nájdete v Šablónach finančného reportingu.
• Rozšíriteľnosť pomocou pluginov: Beancount je napísaný v Pythone a umožňuje vlastné pluginy na rozšírenie jeho funkčnosti. Pluginy môžu pri spracovaní súboru vynucovať ďalšie pravidlá alebo výpočty. (Napríklad existujú pluginy na spracovanie daňových položiek alebo na zabezpečenie, aby pri žiadnom nákupe nechýbala nákladová cena.) Systém pluginov a Python API umožňujú pokročilým používateľom skriptovať vlastné správanie alebo integrovať Beancount s inými systémami.
• Importéry pre externé dáta: Kľúčovou praktickou funkciou je rámec importérov v samostatnom balíku beangulp (v Beancounte 3.2.3 neexistuje modul beancount.ingest). Napíšete triedu importéra, ktorá dedí z beangulp.Importer a implementuje identify, extract a account. Analyzuje stiahnutý súbor (CSV, OFX, PDF výpisy atď.) a konvertuje ho na Beancount zápisy. To je nevyhnutné pre automatizáciu (viac o tom neskôr).
• Audítovateľný a vhodný pre verzovanie: Keďže ide o čistý text, môžete svoju hlavnú knihu uchovávať v Git-e alebo inom systéme na správu verzií. Každá zmena je transparentná a máte kompletnú históriu úprav. To robí audity alebo kontrolu zmien priamočiarymi (mnohí používatelia commit-ujú zmeny každého dňa do Git repozitára, čím získavajú log všetkých finančných zápisov odolný voči neoprávneným úpravám). Táto úroveň transparentnosti je hlavným odlišovačom od uzavretého účtovného softvéru – "žiadne SaaS uzamknutie – len čisté, transparentné účtovníctvo s výkonným reportingom."

Fava (Webové rozhranie pre Beancount)​

• Interaktívne webové UI: Fava poskytuje lokálny webový server, ktorý vykresľuje vašu Beancount hlavnú knihu do bohatého UI. V prehliadači zobrazuje základné reporty (výkaz ziskov a strát, súvahu atď.), registre účtov a denníky s interaktívnymi ovládacími prvkami. UI je dynamické a používateľsky prívetivé v porovnaní s príkazovým riadkom. Spustíte ho jednoduchým fava yourfile.beancount a získate webovú aplikáciu pre svoje knihy.
• Vstavané grafy a diagramy: Fava generuje grafy, ktoré pomáhajú vizualizovať vaše dáta. Napríklad obsahuje čiarový graf čistého imania v čase, stĺpcové grafy pre príjmy vs. výdavky za mesiac a koláčové/treemap grafy pre rozpis výdavkov. Tieto vizualizácie sa aktualizujú s vašimi dátami a podporujú rôzne zobrazenia (napr. "v nákladovej cene" vs "trhová hodnota" pre investície). Tieto vizualizačné schopnosti preskúmame podrobne neskôr.
• Filtrovanie a vyhľadávanie: V hornej časti stránok Favy umožňuje filtračný panel deliť a krájať vaše dáta v reálnom čase. Môžete filtrovať podľa času (napr. rok, štvrťrok, mesiac), podľa regexu účtu, podľa príjemcu platby, podľa popisu alebo podľa štítkov/odkazov. To uľahčuje inšpekciu dát v reálnom čase – napríklad rýchlo filtrovať na "Tag=Travel" a "Year=2025", aby ste videli všetky cestovné výdavky v roku 2025 s súčtami. Rozhranie podporuje komplexné dotazy prostredníctvom tohto filtračného panela alebo cez stránku Query (kde môžete priamo spúšťať BQL dotazy).
• Podpora viacerých súborov a konsolidácia: Fava dokáže načítať viacero Beancount súborov naraz (užitočné, ak máte oddelené hlavné knihy) a prepínať medzi nimi. Môže ich tiež v prípade potreby konsolidovať (napríklad osobné a podnikové knihy zobrazené spolu).
• Zadávanie a úprava dát: Fava nie je jedinečne len na čítanie – má editor a formulár na zadávanie transakcií. Môžete pridávať nové transakcie cez webový formulár (zápis sa vloží do vášho .beancount súboru). Zdrojový súbor môžete tiež otvoriť v externom editore priamo z Favy. Fava tiež podporuje klávesové skratky pre pokročilých používateľov. To z Favy robí ľahký účtovný systém, kde môžete zadávať a prezerať dáta z rovnakého rozhrania.
• Reporty a rozbalenie účtov: Fava poskytuje štandardné účtovné reporty: výkaz ziskov a strát, súvahu, skúšobný zostatok a zoznam držaných pozícií pre investície. Súvaha a výkaz ziskov a strát sú interaktívne – môžete kliknúť na účet a rozbaliť jeho detaily alebo prepínať medzi zobrazením v nákladovej cene vs trhovej hodnote pri aktívach. Fava tiež zobrazuje "nerealizované zisky" pre investície, ak máte cenové dáta. Generuje denník všetkých zápisov a umožňuje filtrovať tento denník podľa rôznych kritérií (skvelé na nájdenie konkrétnych transakcií).
• Správa dokumentov: Ak prikladáte účtenky alebo výpisy, Fava pomáha tieto organizovať. Beancount má koncept priečinka dokumentov a Fava umožňuje pretiahnuť súbory na účty alebo transakcie – uloží ich a pridá do vašej hlavnej knihy zápis dokumentu. To je užitočné na uchovávanie podporných dokumentov prepojených s dátami vašej hlavnej knihy.
• Prispôsobenie pomocou rozšírení: Fava môže byť rozšírená o pluginy (napísané v Pythone) na pridanie nových reportov alebo funkčnosti. Niektoré rozšírenia sú pribalené (napr. report portfolio list pre investície). Vlastné rozšírenia prediskutujeme neskôr, ale v podstate dizajn Favy umožňuje vkladať nové stránky a dokonca vlastný JavaScript prostredníctvom jej rozšírovacieho API. To znamená, že ak určitá analýza alebo dashboard nie je vstavaný, pokročilý používateľ ho môže pridať.
• Výkon: Fava je efektívna – znovu načíta dáta do pamäte a rýchlo obsluhuje stránky. Podkladové parsovanie Beancountu je rýchle, takže typické osobné hlavné knihy sa načítajú za sekundu alebo dve. V praxi Fava zvládne osobné hlavné knihy mnohých rokov, hoci extrémne veľké súbory (desiatky tisíc transakcií) môžu profitovať z určitej optimalizácie (napr. archivácia starých zápisov).
• Webový prístup a mobilita: Spustením Favy na serveri alebo dokonca na vašom notebooku môžete pristupovať k svojim financiám z akéhokoľvek prehliadača. Niektorí používatelia hostujú Favu na súkromnom serveri alebo Raspberry Pi, aby mohli kontrolovať svoje financie na cestách (prípadne ju zabezpečia heslom alebo VPN, keďže Fava nemá vstavanú autentifikáciu). To vám v podstate dáva vlastný hostovaný "web app" pre vaše financie bez odovzdania dát tretej strane.

Zhrnutím, Beancount poskytuje robustný základ pre transparentné účtovníctvo založené na texte s prísnymi pravidlami podvojného účtovníctva a podporou viacerých mien. Fava na tom stavia tým, že ponúka prístupné rozhranie s okamžitými poznatkami (reporty, grafy) a schopnosťou interagovať s vašimi dátami. Spolu tvoria vysoko flexibilný účtovný a analytický systém, ktorý ovládate od začiatku do konca.

Analýzy v reálnom čase (alebo takmer v reálnom čase) s Beancount a Fava​

Dosiahnutie analytiky v reálnom alebo takmer reálnom čase s Beancountom a Favou zahŕňa automatizáciu toku dát do vašej hlavnej knihy a zabezpečenie, aby nástroje zobrazovali aktuálne informácie. Štandardne je Beancount dávkový proces (pridáte zápisy do súboru a potom si prezriete reporty) a Fava rozpozná zmeny a vyžiada obnovenie. So správnym nastavením však môžete aktualizácie zefektívniť tak, že nové transakcie a zmeny sa objavia takmer okamžite.

Detekcia zmien súboru: Fava sleduje hlavnú knihu na zmeny. Ak upravíte .beancount súbor (alebo zahrnuté súbory) v editore, stránka zobrazí oznámenie "File change detected. Click to reload." (Zistená zmena súboru. Kliknite na obnovenie.) Fava pravidelne kontroluje svoj get_changed endpoint. Keď sledovač nahlási zmenu, Fava znovu načíta hlavnú knihu na strane servera a oznámenie ponúkne jedno kliknutie na obnovenie zobrazenia. V praxi je toto opätovné načítanie veľmi rýchle (zvyčajne pod sekundu pre typické hlavné knihy). To znamená, že Fava môže slúžiť ako živý dashboard, ak je váš súbor hlavnej knihy často aktualizovaný. Štandardne čaká na vaše kliknutie, aby nenarušila vaše zobrazenie.

Nepretržitý import/aktualizačný pipeline: Na získanie dát v reálnom čase musíte automatizovať pridávanie transakcií do Beancount súboru. Existuje niekoľko bežných stratégií:

• Naplánované importné úlohy (Cron): Mnohí používatelia nastavia cron úlohu (alebo naplánovanú úlohu) na pravidelné načítavanie nových transakcií z finančných inštitúcií (povedzme každú noc alebo každú hodinu) a ich pripojenie k hlavnej knihe. Napríklad môžete spustiť importér beangulp nad najnovším bankovým stiahnutím (CSV alebo OFX). Jeden používateľ Beancountu vytvoril automatizačný pipeline tak, že sa jeho knihy aktualizujú samé: "vidieť, ako sa moja účtovná kniha aktualizuje bez toho, aby som sa jej dotkol, v otvorenom formáte, mi prináša čistú radosť". Dosiahol to pripojením k bankovým API a naplánovaním pravidelných aktualizácií. Vlastný Python skript používajúci bankové API (napr. Plaid) môže bežať podľa plánu a zapisovať nové zápisy do hlavnej knihy. Každé spustenie overte pomocou bea check, kým sa dotkne vášho hlavného súboru. Po každom naplánovanom importe, ak máte spustenú Favu, jednoducho obnovte Favu, aby ste videli nové dáta.

• Sledovače súborov a spúšťače: Namiesto časových plánov môžete použiť sledovače súborov na reakciu na udalosti. Napríklad, ak vám banka môže posielať denný výpis e-mailom alebo vložíte CSV do priečinka, skript by mohol tento súbor rozpoznať (pomocou inotify na Linuxe alebo podobne) a okamžite spustiť importnú rutinu a potom signalizovať Fave, aby sa znovu načítala. Hoci Fava zatiaľ nepodporuje push živého obnovenia do prehliadača, dáta by boli aspoň aktualizované, takže pri ďalšej kontrole stránky alebo kliknutí na obnovenie sú aktuálne. Niektoré komunitné projekty zachádzajú ďalej: pre ledger (príbuzný Beancountu) jeden používateľ vytvoril malý server, ktorý sprístupňuje dáta ledger v reálnom čase pre Grafanu, čo ukazuje, že podobný prístup možno použiť s Beancountom – v podstate vytvoriť démona, ktorý nepretržite napája vaše dashboardy dátami.

• Priama integrácia API: Namiesto prechodu cez súbory môžu pokročilí používatelia pripojiť priamo k bankovým API (ako Plaid alebo regionálne Open Banking API) na časté sťahovanie transakcií. Motivovaný jednotlivec môže skriptovať "živé" importy v slučke (s primeraným obmedzením rýchlosti) – fakticky sa dopytovať banky na nové dáta každých pár minút. Nič vám nebráni "zaregistrovať sa v Plaid API a robiť to isté [automatizáciu] lokálne". Každá nová transakcia môže byť pripojená k Beancount súboru, ako prichádza. S týmto prístupom sa Fava skutočne stáva dashboardom v reálnom čase pre vaše účty, konkurujúc aktuálnemu feedu v komerčných aplikáciách.

Obnovenie dát vo Fave: Keď sa vaše dáta aktualizujú, dostať Favu na ich zobrazenie je priamočiare: obnovenie prehliadača (F5) alebo kliknutie na oznámenie o obnovení načíta najnovší stav hlavnej knihy. Upozorňujeme, že fava --debug neposúva zmeny hlavnej knihy do prehliadača. Jeho text nápovedy je "Turn on debugging" (Zapnúť ladenie). Spúšťa Werkzeug debugger a code reloader pre vlastný kód Favy a nastavuje automatické načítanie Jinja šablón. To opätovne načíta kód servera a šablóny stránok počas vývoja rozšírení. Nesúvisí to so sledovačom súborov, ktorý deteguje zmeny hlavnej knihy. Alternatívne, ak vytvárate vlastný front-end, môžete, aby pravidelne kontroloval get_changed endpoint Favy a obnovil sa, keď nahlási nové dáta.

Okamžité výpočty: Rýchle parsovanie Beancountu znamená, že aj keď aktualizujete súbor hlavnej knihy každých pár minút, obrat z načítania dát → aktualizácie súboru → obnovenia Favy je rýchly. Napríklad jeden používateľ poznamenáva, že opätovné načítanie Favy po úprave súboru "je sotva postrehnuteľné… rozhodne menej než sekunda" pre primerane veľké hlavné knihy. Takže môžete mať otvorené okno Favy a pravidelne obnovovať, čím napodobníte živý dashboard. (Pre skutočne živý zážitok by ste mohli vytvoriť malý skript na automatické obnovenie prehliadača alebo použiť funkciu obnovenia prehliadača každých N sekúnd.)

Vyrovnávanie a upozornenia: Aby ste mohli dôverovať dátam v reálnom čase, chcete tiež často vyrovnávať zostatky. Beancount to uľahčuje kontrolnými zostatkami a indikátorom "up-to-date". V skutočnosti Fava farbí účty na zeleno, žlto alebo červeno, keď direktíva open nesie metadata fava-uptodate-indication. Farba odráža, či nedávne kontroly zostatku pokrývajú najnovšie zápisy účtu. To sa dá použiť na rýchle zistenie, či zostatok účtu v hlavnej knihe zodpovedá najnovšiemu výpisu z banky. V nastavení takmer v reálnom čase môžete automatizovať denné kontroly zostatku (takže každé ráno má hlavná kniha včerajší konečný zostatok z banky pre každý účet). Indikátor Favy by vám potom povedal, či váš automatický import niečo nezmeškal alebo či existuje nesúlad, čím poskytuje istotu, že "živé" dáta, ktoré vidíte, sú presné.

Príklad automatizácie: Predpokladajme, že chcete denné aktualizácie peňažných tokov. Mohli by ste nastaviť cron úlohu, ktorá beží každú noc o 3:00: spustí Python skript, ktorý pomocou API vašej banky načíta transakcie z posledného dňa, zapíše ich do import_today.beancount a potom tento súbor pripojí k vašej hlavnej knihe. Tiež zapíše kontrolný zostatok pre koniec dňa. Keď sa zobudíte, otvoríte Favu – zobrazí všetky transakcie do včerajška a vidíte aktualizované príjmy/výdavky aktuálneho mesiaca. Ak počas dňa uskutočníte výdavok, môžete ho pridať manuálne (napríklad cez formulár novej transakcie Favy na telefóne) alebo počkať na nočný import. Tento hybridný prístup (väčšinou automatizovaný, so schopnosťou manuálne pridávať ad-hoc) poskytuje obraz takmer v reálnom čase. Ďalší prístup je nechať otvorenú stránku Journal Favy a používať ju ako register: ako míňate, rýchlo zaznamenáte transakciu (ako zápis do šekovej knižky) – potom vy ste živým feedom. To je manuálnejšie, ale niektorí používatelia si užívajú to povedomie, ktoré to prináša. Pre skutočne streamované aktualizácie bez manuálnych krokov budete musieť investovať do skriptovania a prípadne použiť API tretích strán, ako sme diskutovali.

Zhrnutím, kombináciou automatizácie importu Beancountu s rýchlym obnovením Favy môžete získať finančné dáta takmer v reálnom čase. Nemusí byť "na jedno kliknutie" dosiahnuť rovnakú úroveň živého feedu ako služba typu QuickBooks (ktorá automaticky sťahuje bankové feedy), ale je to možné – a čo je dôležité, zachováte si plnú kontrolu a transparentnosť procesu. Ako poznamenal jeden zástanca účtovníctva v čistom texte, trocha úsilia na začiatku môže priniesť automatizovaný systém, ktorý je "oveľa lepší než komerčné riešenia a oveľa flexibilnejší a rozšíriteľnejší". V ďalšej sekcii uvidíme, ako vizualizačné schopnosti Favy umožňujú okamžite pochopiť tieto aktuálne dáta a premeniť surové transakcie na poznatky.

Spravované ceny pre hostované ocenenia​

Živé ceny dodávajú podporované oceňovacie kotácie hostovaným hlavným knihám Beancount.io. Nástroj na načítanie kontroluje nové dáta pri načítaní hlavnej knihy po päťminútovom okne obnovenia; pozorovanie poskytovateľa môže byť staršie. Toto nie je streamovaný feed.

Ovládacie prvky Favy opísané tu patria Fave. Pridanie spravovaného include nepridáva tieto ovládacie prvky do hostovaného prehliadača ani nemení nákladové zobrazenie na zobrazenie trhovej hodnoty. Upstream Fava potrebuje lokálne cenové súbory. Kompatibilná verzia bea ich dokáže exportovať; kompatibilitu nájdete v príručke nastavenia.

Vizualizačné schopnosti vo Fava (Cash Flow, Trendy, Kontrola v reálnom čase)​

(GitHub - beancount/fava: Fava - web interface for Beancount) Report výkazu ziskov a strát Favy (vo webovom UI) podporuje bohaté vizualizácie ako treemapy (na obrázku) a sunburst diagramy pre rýchly prehľad o zložení príjmov a výdavkov. V tomto treemape každý obdĺžnik predstavuje kategóriu výdavkov, s veľkosťou podľa sumy – okamžite vidíte, že Rent (veľký zelený blok) dominuje výdavkom. Horný filtračný panel a ovládacie prvky (vpravo hore) umožňujú meniť menu, typ grafu a časové obdobie (napr. zobrazenie mesačných dát). Fava tiež poskytuje čiarové grafy (napr. čisté imanie v čase) a stĺpcové grafy (napr. príjmy vs. výdavky za mesiac) na pomoc pri odhaľovaní trendov vo vašich finančných dátach.

Jednou z najväčších predností Favy je okamžité premieňanie dát hlavnej knihy na vizuálne, interaktívne reporty. Hneď ako sa hlavná kniha načíta, Fava generuje grafy, ktoré uľahčujú pochopenie peňažných tokov a trendov na prvý pohľad:

• Treemap/Sunburst príjmov a výdavkov: Na stránke výkazu ziskov a strát môže Fava zobraziť vaše príjmy a výdavky buď ako treemap, alebo sunburst diagram. Tieto sú skvelé na vizualizáciu peňažných tokov "na prvý pohľad". Napríklad, ak sú vaše mesačné výdavky zobrazené ako treemap, plocha každého obdĺžnika zodpovedá veľkosti každej kategórie výdavkov. Veľké bloky okamžite ukazujú, kam išlo najviac vašich peňazí (napr. nájom alebo hypotéka, dane atď.), zatiaľ čo menšie bloky ukazujú menšie výdavky. To je mimoriadne užitočné na odhaľovanie trendov vo výdavkoch – ak blok "Dining Out" rástol každý mesiac, vizuálne si to všimnete. Môžete prepnúť na sunburst diagram na zobrazenie hierarchických rozpadov (napr. vonkajší kruh môže zobrazovať podkategórie ako Groceries vs Restaurants v rámci kategórie Food). Tieto grafy sa aktualizujú pre akékoľvek filtrované obdobie (jeden mesiac, rok do dnešného dňa atď.), čo vám poskytuje okamžitú vizualizáciu peňažných tokov pre dané obdobie. Používateľ na fóre o účtovníctve v čistom texte poznamenal: "Hodne využívam treemapy príjmov a výdavkov. Dávajú skvelý vizuálny pocit z našich fiškálnych pohybov." – tento druh okamžitého pochopenia je presne to, o čo sa grafy Favy snažia.

• Čisté imanie a zostatok v čase: Fava poskytuje čiarový graf čistého imania v čase (na stránke "Balance Sheet" alebo "Statistics"). Tento graf vykresľuje súčet vašich aktív mínus pasíva v každom časovom bode (podľa dňa, týždňa alebo mesiaca). Je neoceniteľný na odhaľovanie trendov – môžete vidieť trajektóriu svojich financií (napr. stabilne rastúcu alebo poklesy v určitých časoch). Ak máte investície, môžete prepínať medzi zobrazením hodnoty v nákladovej cene vs trhovej (ak sú zaznamenané cenové dáta) – napríklad môžete vidieť, že vaše čisté imanie v trhovej hodnote kolíše s cenami akcií, zatiaľ čo v nákladovej cene je plynulejšie. Fava tiež dokáže zobrazovať zostatky účtov v čase. Ak kliknete na účet (povedzme Assets:Bank:Checking), stránka účtu zobrazí graf histórie zostatku tohto účtu. Môžete okamžite skúmať, ako sa váš hotovostný účet pohybuje – čo je fakticky graf peňažných tokov (sklon čiary zostatku indikuje čistý peňažný tok). Ak klesá, viete, že v danom období míňate viac, než zarábate. Skúmaním týchto trendov môžete odhaliť vzorce ako "každý december moje úspory klesnú (sviatočné výdavky)" alebo "moje investície tento štvrťrok prudko vzrástli".

• Stĺpcové grafy pre periodické porovnanie: V zobrazení výkazu ziskov a strát má Fava záložky "Monthly Profit", "Monthly Income", "Monthly Expenses" atď. Ich výberom sa zobrazia stĺpcové grafy podľa mesiacov. Napríklad Monthly Net Profit zobrazí prebytok/deficit každého mesiaca ako stĺpec, čo uľahčuje porovnanie výkonnosti naprieč mesiacmi. Môžete rýchlo identifikovať odľahlé hodnoty (napr. veľký negatívny stĺpec v apríli znamená, že ten mesiac mal nezvyčajnú stratu/výdavok). Podobne stĺpcový graf "Monthly Expenses" skladá alebo zoskupuje výdavky podľa kategórie za každý mesiac, takže vidíte, ktoré kategórie kolíšu. To je skvelé na odhaľovanie trendov v čase – napríklad si môžete všimnúť, že vaše výdavky na "Travel" každé leto vyskočia alebo že účty za "Utilities" sú v zime vyššie. Fava vám v podstate dáva niektoré schopnosti budgetovacej aplikácie (sledovanie trendov), ale s plnou prispôsobiteľnosťou (keďže kategórie a ich zoskupenie definujete vy).

• Filtrovanie a inšpekcia dát v reálnom čase: Vizualizácie vo Fave nie sú statické; fungujú v spojení s filtrovaním Favy. Predpokladajme, že chcete skúmať konkrétny scenár: "Ako vyzerajú moje štvrťročné peňažné toky len pre moje podnikové účty?" Môžete nastaviť časový filter na Q1 2025 a filtrovať účty na vašu podnikovú hierarchiu – Fava okamžite aktualizuje grafy tak, aby zobrazovali čistý príjem, treemap výdavkov atď., ale len pre túto podmnožinu. Toto interaktívne krájanie znamená, že môžete robiť ad-hoc analýzu veľmi rýchlo bez písania dotazov. Zobrazenie Journal tiež podporuje živé filtrovanie: môžete vyhľadávať podľa príjemcu platby alebo podreťazca popisu a okamžite vidieť filtrovaný zoznam transakcií. Ak sa pozeráte na dáta v reálnom čase (povedzme ste práve importovali transakcie z minulého týždňa), môžete filtrovať podľa štítku ako #uncategorized na zobrazenie nových transakcií, ktoré môžu potrebovať kategorizáciu, alebo podľa @pending (ak označujete čakajúce zápisy) na zobrazenie toho, čo ešte nie je vyrovnané. Táto schopnosť inšpekcie v reálnom čase pomáha zabezpečiť aj kvalitu dát – pretože môžete izolovať a riešiť anomálie za behu.

• Výkaz peňažných tokov (nepriamy): Hoci Beancount/Fava neprodukuje formálny výkaz peňažných tokov (rozpad na prevádzkové/investičné/finančné) priamo z krabice, môžete ho napodobniť vlastnými dotazmi alebo štruktúrovaním účtov. Napríklad by ste mohli označiť určité transakcie alebo použiť špecifické účty pre investovanie a financovanie a potom dotazovať súčty. Rozhranie dotazov Favy spúšťa BQL ako SELECT sum(position) WHERE account ~ 'Assets:Bank:Checking'. Vráti zostatok bežného účtu za grafmi. Nižšie uvedený vypracovaný príklad ukazuje celú cestu. To povedané, väčšina osobných používateľov považuje kombináciu trendov zostatkov a grafov príjmov/výdavkov za dostatočnú na pochopenie peňažných tokov.

• Držané pozície a vizualizácia portfólia: Na stránke Holdings Fava uvádza vaše aktuálne držané komodity (napr. akcie, dlhopisy, kryptomeny) s množstvami, nákladmi, trhovou hodnotou a nerealizovanými ziskami. Hoci je to tabuľka, nie graf, je veľmi užitočná na inšpekciu stavu vášho portfólia v reálnom čase. Niektoré komunitné rozšírenia (ako fava-investor, diskutované neskôr) pridávajú viac vizuálov pre portfóliá, ako koláčové grafy alokácie alebo grafy výkonnosti. Aj bez rozšírení môžete vidieť napríklad, ako sa mení hodnota vášho akciového portfólia k najnovším cenám – ak pravidelne aktualizujete cenové kotácie (čo by sa dalo automatizovať denne), grafy Favy budú odrážať najnovšie dostupné datované ceny, ktoré môžu byť staršie než čas, keď report otvoríte.

Pracovný príklad: dva mesiace výdavkov​

Tento príklad beží od začiatku do konca na Beancounte 3.2.3 s beanquery 0.2.0. Uložte hlavnú knihu ako example.beancount. Obsahuje dve výplaty mzdy a štyri výdavky.

option "title" "Analytics example"
option "operating_currency" "USD"
 
2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Expenses:Food:Groceries USD
2024-01-01 open Expenses:Food:Dining USD
2024-01-01 open Expenses:Housing:Rent USD
2024-01-01 open Income:Salary USD
2024-01-01 open Equity:Opening-Balances USD
 
2024-01-05 * "Employer" "January salary"
  Income:Salary  -3000.00 USD
  Assets:Bank:Checking  3000.00 USD
 
2024-01-08 * "Grocery Store" "Weekly groceries"
  Expenses:Food:Groceries  120.00 USD
  Assets:Bank:Checking  -120.00 USD
 
2024-01-12 * "Restaurant" "Dinner out"
  Expenses:Food:Dining  80.00 USD
  Assets:Bank:Checking  -80.00 USD
 
2024-02-01 * "Landlord" "February rent"
  Expenses:Housing:Rent  1000.00 USD
  Assets:Bank:Checking  -1000.00 USD
 
2024-02-05 * "Employer" "February salary"
  Income:Salary  -3000.00 USD
  Assets:Bank:Checking  3000.00 USD
 
2024-02-10 * "Grocery Store" "Weekly groceries"
  Expenses:Food:Groceries  150.00 USD
  Assets:Bank:Checking  -150.00 USD

Najprv ju overte. Potom spustite dotaz na výdavky podľa kategórie.

bea --file example.beancount check
bea --file example.beancount query "SELECT account, sum(position) WHERE account ~ 'Expenses' GROUP BY account ORDER BY account"

Čistá hlavná kniha skončí s návratovým kódom 0 z bea check; chyby sú uvedené s nenulovým návratovým kódom. Dotaz vráti jeden riadok na účet výdavkov.

        account          sum(position)
-----------------------  ------------
Expenses:Food:Dining        80.00 USD
Expenses:Food:Groceries    270.00 USD
Expenses:Housing:Rent     1000.00 USD

Dva ďalšie dotazy dokresľujú obraz. Celkové príjmy a celkové výdavky:

SELECT sum(position) WHERE account ~ 'Income'
SELECT sum(position) WHERE account ~ 'Expenses'

Vrátia (-6000.00 USD) a (1350.00 USD). Domácnosť teda zarobila 6 000,00 USD, minula 1 350,00 USD a ušetrila 77,5 %. Zostatok bežného účtu to potvrdzuje:

SELECT sum(position) WHERE account ~ 'Assets:Bank:Checking'

Vráti (4650.00 USD). Tie isté dotazy bežia nezmenené na stránke Query Favy. Fava 1.30.16 vykresľuje tie isté tri riadky výdavkov ako interaktívnu tabuľku.

V praxi sa vizuálne reporty Favy aktualizujú tak rýchlo ako podkladové dáta. V momente, keď je pridaná nová transakcia a stránka obnovená, grafy sa prepočítajú. Nie je potrebné žiadne zdĺhavé opätovné spracovanie. To znamená, že ak máte poloautomatizovaný pipeline, ktorý počas dňa napája dáta, môžete nechať Favu otvorenú a pravidelne obnovovať, aby ste získali aktualizované grafy – fakticky finančné monitorovanie v reálnom čase.

Predstavte si napríklad, že prevádzkujete malý podnik a chcete monitorovať hotovosť na ruke a denné výdavky. Mohli by ste mať Favu otvorenú na vlastnom dashboarde (možno pomocou rozšírenia alebo obrazovky dotazov), ktorý zobrazuje "Zostatok hotovostného účtu dnes" a "Výdavky – dnes vs. včera". Pri každom obnovení po príchode nových dát by ste videli, ako sa tieto čísla aktualizujú. To je podobné tomu, čo poskytujú drahé dashboardy v reálnom čase, ale pomocou open-source nástrojov. Rozdiel je v tom, že možno budete musieť obnovovať manuálne alebo naplánovať obnovenia, zatiaľ čo tie nástroje posúvajú aktualizácie automaticky. Funkčne je však poznatok, ktorý získate, rovnaký, s pridanou výhodou, že môžete rozbaliť akékoľvek číslo vo Fave (kliknutím zobrazíte podkladové transakcie) – čo mnohým BI dashboardom chýba.

Zhrnutím, Fava premieňa vaše účtovné dáta na okamžité vizuálne poznatky: rozpady peňažných tokov, trendové línie, porovnania v čase a interaktívne filtrovanie – to všetko vám pomáha vidieť príbeh za číslami. Či už skúmate výdavky z minulého týždňa kvôli anomáliám alebo prezeráte viacročné trendy čistého imania, grafy a reporty Favy poskytujú jasnosť v reálnom čase (hneď ako sú vaše dáta k dispozícii). Ďalej uvidíme, ako môžete tieto schopnosti rozšíriť alebo integrovať s externými nástrojmi, ak potrebujete ešte viac prispôsobenú analytiku.

Integrácia s externými palubnými doskami a vizualizačnými nástrojmi​

Hoci Fava poskytuje bohatú sadu vstavaných reportov a grafov, možno budete chcieť integrovať dáta Beancountu s inými nástrojmi business intelligence (BI) alebo dashboardov, ako sú Grafana, Metabase alebo vlastné webové front-endy (napr. React aplikácia). Motiváciou môže byť kombinovať finančné dáta s inými zdrojmi dát, využiť pokročilé možnosti grafov alebo zdieľať dashboardy s ostatnými v inom formáte. Vďaka otvorenosti Beancountu existuje viacero spôsobov, ako dosiahnuť integráciu:

• Integrácia s databázou (BeanSQL / Beanpost): Jedným priamočiarym prístupom je exportovať alebo synchronizovať vašu Beancount hlavnú knihu do SQL databázy. Keď je v SQL, akýkoľvek BI nástroj môže dotazovať dáta. Členovia komunity v skutočnosti vytvorili na to nástroje. Napríklad Beanpost je experiment, ktorý zrkadlí Beancount hlavnú knihu do PostgreSQL databázy a implementuje veľkú časť logiky Beancountu ako SQL funkcie. To poskytuje "flexibilný backend, ktorý sa dá integrovať s inými nástrojmi, ako sú webové aplikácie alebo reportovacie systémy." Môžete spustiť Beanpost na nepretržitú synchronizáciu vašej textovej hlavnej knihy do Postgres. Potom sa nástroj ako Metabase alebo Tableau môže pripojiť k tejto Postgres databáze a môžete vytvárať akékoľvek grafy alebo dashboardy (aktualizujúce sa naživo, ako sa DB aktualizuje). Jeden používateľ uviedol, že pomocou Postgres + PostGraphile automaticky vystavil GraphQL API pre dáta hlavnej knihy a potom napísal vlastný React front-end na tom – v podstate zaobchádzal s hlavnou knihou ako s webovou službou. Tento prístup rieši prípady, kde rozhranie Favy nemusí stačiť (napr. prístup viacerých používateľov alebo UI priateľnejšie pre mobil). Je to náročnejšie na inžinierstvo, ale ukazuje potenciál: môžete integrovať Beancount s modernými webovými technológiami pomerne ľahko. Ľahšou variantou je exportovať výsledky dotazov do SQLite – spustenie bea --file ledger.beancount query "SELECT ..." vytlačí tabuľku, ktorú môžete vložiť alebo presmerovať, a tabuľkový CSV z CLI čaká na natívne možnosti exportu pre bea query. Niektorí ľudia používajú SQLite ako medzikrok na pripojenie k nástrojom ako Metabase (ktoré dokážu čítať SQLite súbory cez pripojenie).

• Grafana (dashboardy časových radov): Grafana je populárna na monitorovanie a dáta časových radov. Finančné dáta v čase (výdavky, zostatky) sa dajú považovať za časové rady. V komunite sa diskutovalo o prepojení Beancountu s Grafanou. Jednou z myšlienok bol Data Source Plugin pre Grafanu, ktorý by mohol spúšťať BQL dotazy proti Beancount súboru za behu. To by umožnilo panelom Grafanu priamo zobrazovať napríklad "Zostatok bežného účtu" ako meradlo alebo "Výdavky za posledných 30 dní" ako graf, dotazovaním hlavnej knihy. K roku 2025 zatiaľ nie je publikovaný žiadny špecializovaný plugin, ale nadšenci vytvorili ad-hoc riešenia. Napríklad Reddit používateľ aquilax vytvoril jednoduchý server, ktorý sprístupňuje dáta Ledger CLI pre Grafanu, a zdieľal ho ako grafana-ledger-datasource-server. Podobný koncept sa dá aplikovať na Beancount: napísali by ste malý HTTP server v Pythone, ktorý načíta Beancount hlavnú knihu (pomocou API Beancountu na dotazovanie dát) a vystaví endpointy, ktoré vracajú JSON dátové rámce pre Grafanu. Grafana má generický JSON data source plugin, ktorý by potom mohol čerpať z tohto API. V praxi to znamená, že by ste mohli navrhnúť Grafana dashboard s panelmi ako "Mesačné príjmy (stĺpcový graf)" alebo "Denný hotovostný zostatok (čiarový graf)" a tieto panely by načítavali dáta z vášho API poháňaného Beancountom. Grafana by umožnila bohaté možnosti vizualizácie (anotácie, prahy, kombinácia s metrikami servera atď.). Andreas Gerstmayr (jeden z maintainerov Favy) navrhol presne tento prístup a dokonca spomenul, že vytvoril rozšírenie Favy s názvom fava-dashboards (viac o tom nižšie) na vykresľovanie grafov z BQL dotazov ako alternatívu k plnému nastaveniu Grafanu. Ak uprednostňujete UI Grafanu, integrácia je uskutočniteľná – vyžaduje len vytvorenie dátového mosta.

• Metabase (ad-hoc dotazy a dashboardy): Metabase je používateľsky prívetivý BI nástroj, ktorý vám umožňuje spúšťať dotazy a vytvárať dashboardy bez kódu. Ak exportujete svoju hlavnú knihu do relačného formátu (cez Beanpost alebo vypísaním tabuliek transakcií, postings atď.), môžete namieriť Metabase na túto databázu. Môžete vytvoriť vlastné tabuľky ako expenses (date, category, amount) zo svojej hlavnej knihy a potom v Metabase môžete ľahko generovať grafy (napr. koláčový graf výdavkov podľa kategórie za minulý mesiac). Výhodou je, že netechnickí používatelia (alebo kolegovia) by potom mohli interagovať s dátami cez GUI Metabase bez toho, aby sa museli dotknúť Beancount súboru. Nevýhodou je, že musíte udržiavať export/synchronizáciu. Niektorí používatelia automatizovali nočnú konverziu Beancount hlavnej knihy na SQLite a potom nechali Metabase čítať SQLite; iní môžu použiť spomínaný Postgres prístup. Kľúčom je, že prenosnosť dát Beancountu to umožňuje – máte voľnosť duplikovať dáta do akéhokoľvek formátu, ktorý váš externý nástroj potrebuje.

• Vlastné front-endy / aplikácie: Ak máte špecifické potreby, vždy môžete napísať vlastnú aplikáciu nad Beancountom. Python knižnica Beancountu vám dáva prístup ku všetkým naparsovaným zápisom, zostatkom atď., takže Python webový framework (Flask, Django, FastAPI) sa dá použiť na vytvorenie aplikácie na mieru. Napríklad malý podnik môže vytvoriť dashboard, ktorý zobrazuje KPI metriky (ako hrubá marža, denné tržby atď.) dotazovaním hlavnej knihy a prípadne kombinovaním s ne-ledgerovými dátami (ako počet obsluhovaných zákazníkov). Jeden člen komunity vytvoril webové UI priateľské pre mobil, pretože Fava nebola intuitívna pre jeho manželku – využil hlavnú knihu v databáze na poháňanie tohto vlastného UI. Ak uprednostňujete JavaScript/TypeScript, mohli by ste použiť nástroj na konverziu hlavnej knihy na JSON a stavať odtiaľ. Fava sama vystavuje svoju stránku Query cez JSON query API, takže vlastný front-end jej môže poslať BQL a vykresliť vrátené tabuľky namiesto vytvárania nového backendu dotazov.

• Integrácia s Excelom/PowerBI: Stojí za zmienku, že môžete dokonca integrovať s Excelom alebo PowerBI. Kým bea query nezíska natívny export CSV, použite export stránky Query Favy pre tabuľkové súbory, ktoré Excel otvára priamo. Pracovný postup by mohol byť: nočná úloha vygeneruje CSV súbor kľúčových finančných ukazovateľov z Beancountu a PowerBI je nastavené na import tohto súboru. Je to trochu nepriame, ale pre organizácie, ktoré už intenzívne používajú Excel/PowerBI, je to integrácia s nízkym trením. PowerBI tiež podporuje Python dátové zdroje, takže by ste mohli napísať krátky Python skript, ktorý spúšťa BQL dotazy, a použiť ho ako dátový zdroj v PowerBI, čím by ste dosiahli priame pripojenie.

Prípadová štúdia – myšlienka integrácie s Grafanou: Josh, používateľ Beancountu, sa na mailing liste pýtal na posúvanie metrík Beancountu do Prometheus a ich zobrazovanie v Grafane. Hlavní vývojári odpovedali, že namiesto duplikovania dát v Prometheus je lepším prístupom plugin alebo služba pre Grafanu, ktorá priamo dotazuje Beancount hlavnú knihu. Andreas zdieľal svoje rozšírenie fava-dashboards, ktoré vykresľuje vlastné grafy priamo vo Fave, ako príklad riešenia. Poučenie je: máte možnosti – buď integrovať cez existujúcu BI infraštruktúru (Prometheus+Grafana alebo SQL+Metabase), alebo rozšíriť Favu podľa svojich potrieb (do toho sa ponorí ďalšia sekcia).

Bezpečnosť a úvahy o viacerých používateľoch: Pri integrácii do externých nástrojov majte na pamäti citlivosť dát. Čistý text Beancountu často obsahuje súkromné finančné informácie, takže akýkoľvek server, ktorý ich vystavuje, by mal byť zabezpečený (autentifikovaný). Ak presuniete dáta do cloudového BI nástroja, môžete stratiť časť súkromia. Vlastné hostované nástroje (open-source verzie Grafana/Metabase) sa dajú spustiť lokálne, aby sa to zmiernilo. Tiež, ak potrebuje dashboardy prezerať viacero ľudí, externý dashboard len na čítanie môže byť vhodnejší než dať všetkým prístup k Fave (kde by mohli neopatrne upraviť dáta). Napríklad startup by mohol interne používať Beancount, ale Metabase na to, aby vedúci oddelení videli výdavky vs rozpočet bez toho, aby sa dotkli súborom hlavnej knihy.

Zhrnutím, Beancount a Fava si rozumejú s ostatnými. Môžete využiť celý ekosystém dátových nástrojov s trochou lepiaceho kódu: posunúť dáta hlavnej knihy do SQL databázy pre BI nástroje, obsluhovať ich cez API pre webové aplikácie alebo dokonca použiť špecializované knižnice na ich streamovanie do systémov časových radov. Táto flexibilita znamená, že nikdy nezostanete zaseknutí, ak vstavané vizuály Favy nesplnia nejakú špeciálnu požiadavku – vždy sa môžete integrovať do inej platformy a pokračovať v používaní Beancountu ako zdroja pravdy. Ďalej sa pozrieme na rozširovanie samotnej Favy pomocou pluginov a vlastných dashboardov, čo je často ľahšia cesta než externá integrácia, ak potrebujete len zopár extra funkcií.

Vlastné dashboardy a rozširovanie Fava pomocou pluginov (ukážky kódu)​

Fava je navrhnutá tak, aby bola rozšíriteľná: môžete pridávať nové stránky, grafy a správanie písaním pluginov (rozšírení) Favy v Pythone. To umožňuje prispôsobiť webové rozhranie vašim konkrétnym potrebám bez vytvárania celej samostatnej aplikácie. Preskúmame dve kľúčové cesty prispôsobenia: (1) používanie alebo písanie rozšírení Favy a (2) nastavenie vlastných dashboardov cez komunitné pluginy ako fava-dashboards.

Fava rozšírenia (vlastné pluginy)​

Rozšírenie Favy je v podstate Python modul, ktorý definuje podtriedu fava.ext.FavaExtensionBase. Keď sa Fava spustí, môže načítať tento modul a integrovať ho do aplikácie. Rozšírenia môžu registrovať nové stránky reportov, pripájať sa k udalostiam a dokonca zahrnúť vlastný JavaScript pre interaktivitu. Fava 1.30.16 pribaľuje dve: fava.ext.auto_commit a fava.ext.portfolio_list. Ďalšie sa dajú nainštalovať cez pip alebo napísať od nuly.

Na povolenie rozšírenia použijete vlastnú direktívu Beancountu vo vašom súbore hlavnej knihy:

2010-01-01 custom "fava-extension" "my_extension_module" "{'option': 'value'}"

To hovorí Fave, aby načítala daný modul. Ak ste rozšírenie nainštalovali cez pip, odkazovali by ste tu na jeho názov modulu. Voliteľný reťazec na konci je konfigurácia pre rozšírenie. Fava ho parsuje ako Python literál, takže "{'option': 'value'}" dorazí ako dict.

Príklad – rozšírenie Auto-Commit: Pribalené fava.ext.auto_commit commit-uje zmeny do git-u, keď upravíte súbor cez Favu. Ak by ste chceli použiť, pridali by ste:

2025-01-01 custom "fava-extension" "fava.ext.auto_commit"

Prepísava after_write_source, after_insert_entry, after_entry_modified, after_delete_entry a after_insert_metadata. Každý hook spustí git commit v adresári samotného súboru hlavnej knihy. Takže hlavná kniha už musí žiť v git checkout-e. Demonštruje, ako sa rozšírenia napájajú na udalosti úprav Favy.

Príklad – rozšírenie Portfolio List: Pribalené fava.ext.portfolio_list pridáva stránku, ktorá uvádza vaše investičné účty. Nastavuje report_title = "Portfolio List" a dodáva šablónu. Fava to rozpozná a pridá novú položku v bočnom paneli "Portfolio List" pod Reports. Tiež nastavuje has_js_module = True na načítanie svojho sprievodného JavaScriptu. Na jeho explicitné povolenie by ste pridali:

2025-01-01 custom "fava-extension" "fava.ext.portfolio_list"

(V tomto prípade nie je potrebná žiadna konfigurácia.)

Písanie vlastného rozšírenia: Predpokladajme, že chcete vlastnú stránku reportu, povedzme "Receivables Aging" pre faktúry. Mohli by ste vytvoriť súbor receivables.py takto:

# receivables.py
from fava.ext import FavaExtensionBase
 
 
class ReceivablesReport(FavaExtensionBase):
    report_title = "Receivables Aging"
 
    def after_load_file(self):
        # Runs after Fava loads the ledger. Summarise open
        # invoices here so the template only renders.
        self.overdue = [
            txn for txn in self.ledger.all_entries
            if "invoice" in getattr(txn, "tags", set())
        ]

Tiež by ste vytvorili templates/ReceivablesReport.html vedľa modulu na definovanie HTML pre stránku. V tejto šablóne môžete čítať atribúty ako self.overdue, ktoré váš hook pripravil. Keď je toto rozšírenie napísané, pridáte do svojej hlavnej knihy:

2025-01-01 custom "fava-extension" "receivables"

(za predpokladu, že receivables.py je v adresári Beancount súboru alebo v PYTHONPATH, Fava ho dokáže nájsť podľa názvu). Po spustení Favy by ste teraz videli stránku "Receivables Aging".

Pod kapotou Fava volá metódy vášho rozšírenia v pevných bodoch. Dostupné hooky vo Fave 1.30.16 sú after_load_file, before_request, after_entry_modified, after_insert_entry, after_delete_entry, after_insert_metadata a after_write_source. Metóda dekorovaná s @extension_endpoint sa navyše stáva JSON API endpointom pod rozšírením. Typicky poskytnuté hooky plus šablóna stačia.

Dokumentácia Favy poznamenáva, že systém rozšírení sa stále vyvíja, ale je použiteľný. V skutočnosti mnohé pokročilé funkcie boli prototypované ako rozšírenia.

Vlastné dashboardy s fava-dashboards (komunitné rozšírenie)​

Namiesto písania rozšírenia od nuly môžete použiť plugin tretej strany fava-dashboards vytvorený jedným z maintainerov Favy. Toto rozšírenie vám umožňuje definovať ľubovoľné dashboardy cez YAML konfiguračný súbor, kombinujúc text, tabuľky a grafy, poháňané BQL dotazmi. Je to v podstate spôsob, ako vytvoriť nové "stránky" vo Fave, ktoré obsahujú viacero vlastných panelov.

Inštalácia a nastavenie: Najprv nainštalujte balík (napr. pip install fava-dashboards). Verzia 2.0.2 sa načítava čisto vedľa Favy 1.30.16. Potom vo svojom Beancount súbore ju aktivujte vlastnou direktívou ukazujúcou na vašu konfiguráciu dashboardov. Napríklad:

2010-01-01 custom "fava-extension" "fava_dashboards" "{ 'config': '/path/to/dashboards.yaml' }"

(fava-dashboards/README.md at main · andreasgerstmayr/fava-dashboards · GitHub). To hovorí Fave, aby načítala modul fava_dashboards a prečítala váš YAML súbor na konfiguráciu.

Formát YAML dashboardov: V dashboards.yaml definujete jeden alebo viac dashboardov a ich panelov. Z vlastného pipeline rozšírenia vyplývajú dve pravidlá. Agregačné stĺpce potrebujú alias AS. A platí znamienková konvencia BQL: súčty príjmov prichádzajú negatívne, výdavky pozitívne. Napríklad:

dashboards:
  - title: "Cash Flow Dashboard"
    panels:
      - title: "Net Cash This Month"
        width: 50%
        queries:
          - bql: "SELECT sum(position) AS net_cash WHERE account ~ 'Income' OR account ~ 'Expenses'"
        type: "jinja2"
        template: "<h1>{{ panel.queries[0].result[0][0] }}</h1>"
      - title: "Spending by Category"
        width: 50%
        queries:
          - bql: "SELECT account AS category, sum(position) AS total WHERE account ~ 'Expenses' GROUP BY account ORDER BY account"
        type: "jinja2"
        template: "<table>{% for row in panel.queries[0].result %}<tr><td>{{ row[0] }}</td><td>{{ row[1] }}</td></tr>{% endfor %}</table>"

Prvý panel zobrazuje sčítanú pozíciu priamo. Na hlavnej knihe z vypracovaného príkladu vykresľuje (-4650.00 USD). To je 6 000,00 USD príjmov po odpočítaní 1 350,00 USD výdavkov. Druhý panel prechádza riadkami dotazu do tabuľky. Projekt tiež vykresľuje panely grafov z tých istých dotazov. API skriptov grafov nájdete v prepojenom README.

Rozšírenie sa stará o ich vykreslenie, keď otvoríte stránku dashboardu vo Fave. Môžete vytvoriť viacero dashboardov (každý sa zobrazí ako karta alebo samostatná stránka). To je mimoriadne výkonné na vytváranie vlastných finančných dashboardov. Napríklad by ste mohli vytvoriť dashboard "Rozpočet vs Skutočnosť": jeden panel zobrazuje tabuľku rozpočtu vs skutočnosti podľa kategórie (cez dotaz porovnávajúci dve sady účtov), ďalší panel zobrazuje stĺpcový graf výdavkov od začiatku roka vs predchádzajúci rok atď. To všetko len s konfiguráciou a minimálnym skriptovaním, využívajúc dáta vašej hlavnej knihy cez BQL.

Príklad kódu – povolenie fava-dashboards: Ako je uvedené vyššie, pridanie rozšírenia je jeden riadok vo vašej hlavnej knihe. Pre úplnosť tu je minimálny príklad v kontexte:

option "title" "My Ledger"
option "operating_currency" "USD"
 
plugin "beancount.plugins.auto_accounts"  ; (auto-opens accounts)
 
1970-01-01 custom "fava-extension" "fava_dashboards" "{ 'config': 'dashboards.yaml' }"

A v dashboards.yaml:

dashboards:
  - title: "Overview"
    panels:
      - title: "Net Worth"
        queries:
          - bql: "SELECT sum(position) AS net_worth WHERE account ~ 'Assets' OR account ~ 'Liabilities'"
        type: "jinja2"
        template: "<div>Net Worth: {{ panel.queries[0].result[0][0] }}</div>"

Na hlavnej knihe z vypracovaného príkladu to vykresľuje <div>Net Worth: (4650.00 USD)</div>. Skutočný dashboard by pekne formátoval a pridal viac panelov.

Keď je to na mieste, keď spustíte Favu a prejdete na dashboard "Overview", zobrazí vaše vypočítané čisté imanie. Potom môžete šablónu doladiť alebo podľa potreby pridať grafy.

Ďalšie pozoruhodné rozšírenia: Okrem fava-dashboards členovia komunity vytvorili pluginy ako fava-investor na analýzu investícií a fava-review na kontrolu transakcií. Ide o balíky tretích strán s vlastnými krokmi inštalácie a rozsahmi kompatibility s Favou. Pred inštaláciou si prečítajte ich README. Komunita udržiava zoznam pluginov a nástrojov "awesome-beancount". Jeho prezeraním môžete nájsť hotové rozšírenie, ktoré vyhovuje vašim potrebám.

Kedy rozširovať vs integrovať externe: Vo všeobecnosti, ak je vaša potreba čisto prezentácia alebo výpočet na existujúcich dátach hlavnej knihy, rozšírenie Favy je ideálne (všetko na jednom mieste, rešpektuje filtre atď.). Ak vaša potreba zahŕňa kombinovanie externých dát alebo vyžadujete výrazne odlišné UI, externá integrácia (predchádzajúca sekcia) môže byť opodstatnená. Napríklad zobrazenie analytiky webovej stránky vedľa financií – lepšie v Grafane/Metabase; ale pridanie novej finančnej KPI alebo reportu – lepšie ako plugin Favy.

Príklad – vlastná KPI vo Fave: Povedzme, že chcete sledovať "Mieru úspor" (percento príjmu ušetreného). Mohli by ste to urobiť rozšírením, ktoré ju vypočíta a zobrazí malý box na hlavnej stránke. Alebo s fava-dashboards by jeden panel mohol byť Jinja2, ktorý vypíše Savings Rate: X% dotazovaním celkových príjmov a celkových výdavkov. Tento druh vlastnej metriky je veľmi ľahké vložiť pomocou týchto nástrojov, zatiaľ čo v uzavretom systéme ako QuickBooks by mohlo byť nemožné vytvoriť novú metriku na dashboarde.

Tie isté dva dotazy napájajú panel miery úspor. Dávajte pozor na znamienka: BQL sum(position) vracia príjmy ako negatívnu pozíciu a výdavky ako pozitívnu a Jinja nedokáže odčítať jednu pozíciu od druhej. Preto zobrazte obe strany a uveďte mieru v texte šablóny:

- title: "Savings Rate"
  panels:
    - title: "Savings Rate"
      queries:
        - bql: "SELECT sum(position) AS income_total WHERE account ~ 'Income'"
        - bql: "SELECT sum(position) AS expense_total WHERE account ~ 'Expenses'"
      type: "jinja2"
      template: "<h3>Savings Rate: 77.5% ({{ panel.queries[0].result[0][0] }} earned, {{ panel.queries[1].result[0][0] }} spent)</h3>"

Na hlavnej knihe z vypracovaného príkladu to vykresľuje Savings Rate: 77.5% ((-6000.00 USD) earned, (1350.00 USD) spent). Miera je (6 000,00 − 1 350,00) / 6 000,00. Vypočítajte ju z absolútnych hodnôt. Neznegujte ani neodčítajte pozície vo vnútri šablóny.

Kľúčový bod: Fava nie je statický nástroj – je to rozšíriteľná platforma. S trochou Pythonu alebo dokonca len konfiguračného kódu ju môžete rozsiahlo prispôsobiť. Mnohí používatelia zdieľajú malé skripty alebo rozšírenia na fórach, aby robili veci ako zobrazovanie nadchádzajúcich účtov, generovanie PDF faktúr z transakcií alebo integráciu Beancountu s knižnicami na výpočet daní. Keď investujete do učenia sa alebo používania týchto rozšírení, získate veľmi na mieru šitý systém finančnej analytiky bez toho, aby ste začínali od nuly.

Použitia: Osobné financie vs účtovníctvo malých podnikov​

Beancount a Fava sa dajú použiť pre osobné aj podnikové účtovníctvo malých podnikov, ale prípady použitia a výhody sa mierne líšia v dôraze:

Osobné financie​

Pre jednotlivcov Beancount+Fava vyniká v poskytovaní plnej viditeľnosti a poznatkov o vlastných financiách bez spoliehania sa na proprietárne aplikácie. Bežné prípady použitia osobných financií zahŕňajú:

• Sledovanie výdavkov a rozpočtovanie: Mnohí používajú Beancount na zaznamenávanie každého výdavku a potom analyzujú vzorce míňania. S Favou vidia, kam peniaze každý mesiac idú (treemap výdavkov) a sledujú rozpočty porovnaním s očakávanými hodnotami (niektorí to robia cez rozšírenie Budgets alebo vlastné dotazy). Jeden používateľ opísal, že po prijatí Beancountu "analýza finančných dát (výdavky, dary, dane atď.) je triviálna. Je ľahké to urobiť s Favou, ale aj ľahké so skriptami... Mám jeden Python skript, ktorý vytiahne dáta z Beancountu pomocou BQL, potom použijem pandas na prípravu reportu.". To demonštruje, ako osobní používatelia profitujú z vstavaného UI aj zo schopnosti skriptovať vlastnú analýzu, keď je to potrebné.

• Čisté imanie a sledovanie cieľov: Pretože môžete zahrnúť všetky aktíva (bankové účty, investície, dokonca fyzické aktíva, ak chcete) do jednej hlavnej knihy, získate jeden pohľad na čisté imanie. Nadšenci osobných financií to používajú na sledovanie pokroku k cieľom (napr. "FI číslo" alebo splatenie dlhu). Grafy Favy zobrazujúce čisté imanie v čase sú motivujúce – môžete doslova vidieť krivku svojho bohatstva. Je bežné sledovať pasíva ako študentské pôžičky alebo hypotéky v Beancounte a aktualizovať ich zostatky; hlavná kniha potom poskytuje kompletný obraz finančného zdravia.

• Investície a kryptomeny: Osobné použitie sa často rozširuje na sledovanie portfólia. Beancount dokáže spracovať akcie, kryptomeny atď. s výpočtami nákladovej základne a realizovaných ziskov (cez pluginy alebo dotazy). Výhodou oproti stránke brokera je, že môžete konsolidovať naprieč všetkými účtami a vidieť skutočnú alokáciu aktív. Komunitné pluginy ako fava-investor napríklad pridávajú stránky analýzy investícií do Favy. To je niečo, čo hobby investori bežne robia v Exceli; Beancount poskytuje rigoróznejší, automatizovaný spôsob. Blogový príspevok s názvom "Beancount: DeFi Accounting For Noobs" dokonca ilustruje jeho použitie na sledovanie transakcií s kryptomenami a yield farming, čo ukazuje jeho flexibilitu v moderných scenároch osobných financií.

• Osobné financie vo viacerých menách: Ak žijete v zahraničí alebo držíte zahraničné investície, Beancount je mimoriadne užitočný, pretože dokáže konvertovať a agregovať meny. Používatelia poznamenali, že "mnohé účtovné softvéry nie sú dobré v multi-menách… S Beancountom môžete definovať akúkoľvek komoditu, akú chcete" a získať reporty vo vašej preferovanej mene. Pre osobného používateľa zaobchádzajúceho napríklad s platom v USD, ale výdavkami v EUR, je to veľké plus.

• Sledovanie života a vedenie denníka: Netradičný, ale skutočný prípad použitia: niektorí považujú hlavnú knihu za log života, označujú transakcie štítkami životných udalostí (ako #wedding alebo #vacation2025) a potom ju používajú na výpočet nákladov udalostí alebo dokonca ako denník aktivít (finančné metadata ako zástupca životných udalostí). Formát čistého textu a označovanie to umožňujú spôsobom, ktorý tradičné nástroje ľahko neumožňujú.

• Jednoduchosť a vlastníctvo: Osobné financie sú aj o mentalite. Mnohí si vyberajú Beancount, pretože "chceli vlastniť tieto dáta a ľahko ich analyzovať a nechceli byť uzamknutí v predplatnom alebo u dodávateľa". Nedávny zánik Mint.com (populárneho bezplatného budgetovacieho nástroja) hnal nadšencov k účtovníctvu v čistom texte pre jeho dlhovekosť. S Beancountom vedia, že svoju hlavnú knihu budú môcť otvoriť aj o 20 rokov. Pre financie jedného jednotlivca dávajú dáta Beancountu (možno synchronizované cez Dropbox alebo Git) a webové UI Favy (ktoré sa dá spustiť lokálne alebo na súkromnom serveri) rovnováhu pohodlia a kontroly, ktorú je ťažké nájsť inde.

Potenciálne výzvy pre osobné použitie: počiatočné nastavenie a učenie sa podvojného účtovníctva môže byť pre niektorých prekážkou. Ale mnohé zdroje (ako tutoriál Beancountu a komunitné fóra) pomáhajú novým používateľom. Po nastavení môže byť údržba zväčša automatizovaná, ako je opísané, čo je skvelé pre niekoho, kto spravuje svoje domáce financie s minimálnym úsilím.

Účtovníctvo pre malé firmy​

Malé podniky, startupy a freelanceri môžu tiež používať Beancount+Fava, hoci požiadavky tu zahŕňajú formálnejší reporting a možno spoluprácu:

• Účtovníctvo a finančné výkazy: Firma môže viesť svoju hlavnú knihu v Beancounte, zaznamenávať faktúry, účty, mzdy atď. a produkovať súvahu a výkaz ziskov a strát. Beancount podporuje potrebné akruálne účtovníctvo (môžete označiť účty ako pohľadávky/záväzky a zaznamenať faktúry so zápismi na príjmy a pohľadávky, potom neskôr platbu na vyrovnanie pohľadávok). Fava ich potom zobrazí pod aktívami alebo pasívami podľa potreby. Diskusia na Reddite sa pýtala, či je Beancount vhodný pre firmy a či dokáže generovať správne finančné výkazy – áno, dokáže produkovať súvahy, výkazy ziskov a strát a (s trochou pomoci s dotazmi) výkazy peňažných tokov, keďže tieto sú len pohľadmi na dáta podvojného účtovníctva. Háčik je v tom, že Beancount nevynucuje žiadne konkrétne účtovné štandardy (to závisí od toho, ako ho používate). Takže znalý používateľ (alebo účtovník) by mal správne nastaviť účtovú osnovu pre podnik. Existujú komunitné príklady použitia Beancountu pre startupy – jeden komentujúci na HN povedal: "Naozaj ma baví používať Beancount + Git na správu účtovnej knihy pre moju vlastnú startupovú spoločnosť", hoci poznamenal, že pridávanie zápisov periodicky bolo trochu únavné. Táto únavnosť sa dá zmierniť automatizáciou importu, ako sme videli.

• Monitorovanie financií v reálnom čase: Pre malý podnik je peňažný tok kráľom. Pomocou Favy môže majiteľ podniku monitorovať bankové zostatky a peňažný tok takmer v reálnom čase, podobne ako osobne – ale tu je to ešte kritickejšie. Automatizáciou bankových feedov alebo importov môžu zachytiť, či prišla platba od klienta alebo či sa vyrovnal veľký výdavok. QuickBooks ponúka bankové feedy, ktoré "vám umožňujú vidieť, ako si vaše podnikanie vedie v reálnom čase"; s Beancountom to replikujete vlastnou bankovou integráciou. Výhodou Beancountu je transparentnosť – vidíte presne, čo bolo importované a ako je to kategorizované, namiesto dôvery v niekedy nevyzpytateľnú logiku párovania QuickBooks.

• Fakturácia a pohľadávky/záväzky: Beancount nemá vstavaný modul fakturácie (ako generovanie PDF faktúr alebo sledovanie čísel faktúr). Kreatívni používatelia to však zvládli pomocou doplnkov. Napríklad by ste mohli vygenerovať PDF faktúru z transakcie pomocou Jinja2 šablóny alebo dokonca externého skriptu, ktorý číta otvorené pohľadávky. Existuje projekt "Beanie", ktorý funguje ako ľahký systém pohľadávok nad Beancountom. Malé podniky môžu používať Beancount pre hlavnú knihu a iný nástroj na vystavovanie faktúr, potom importovať údaje faktúr do Beancountu. Je to krok navyše v porovnaní s QuickBooks (ktoré dokáže posielať faktúry a potom ich automaticky zaznamenať po zaplatení), ale zabezpečuje, že všetky dáta skončia v otvorenej hlavnej knihe.

• Mzdy a odpisy: Toto sú účtovné úlohy, ktoré malé podniky riešia. Beancount dokáže určite zaznamenať mzdové zápisy (rozdelene hrubej mzdy, daní, zrážok atď. na príslušné účty) – ale zvyčajne by ste ich vypočítali externými nástrojmi alebo vaším poskytovateľom miezd a potom ich zadali. Rozvrhy odpisov dlhodobého majetku by sa rovnako zadávali manuálne (alebo by ste mohli napísať plugin na automatizáciu mesačných odpisových zápisov). Beancount na to nemá mágiu, ale ani mnohé softvéry pre malé podniky okrem ponuky niekoľkých šablón. Výhodou je, že môžete skriptovať čokoľvek nezvyčajné. Napríklad, ak máte vlastný rozvrh uznávania výnosov, mohli by ste tieto denníkové zápisy skriptovať v Pythone a zahrnúť ich.

• Transparentnosť a audítovateľnosť: Podniky môžu oceniť, že Beancount poskytuje jasnú audítorskú stopu. Každá transakcia je jednoduchá a môže byť opatrená odkazmi na dokumenty (účtenky, zmluvy). Ak príde k auditu, môžete ukázať súbor hlavnej knihy spolu s priloženými dokumentmi, čo je pomerne priamočiare. Verzovanie tiež znamená, že máte audítorský log o tom, kto/kedy urobil zmeny (ak viacero ľudí spolupracuje cez Git). Porovnajte to s QuickBooks, kde účtovník možno bude musieť skúmať logy zmien, ktoré nie sú ľahko prístupné používateľovi.

• Náklady: Beancount+Fava je zadarmo, čo je atraktívne pre startupy alebo malé podniky snažiace sa minimalizovať softvérové náklady. QuickBooks, Xero atď. majú mesačné poplatky. Kompromisom však je, že tieto prinášajú podporu a jednoduchšie nastavenie. Technicky zdatný majiteľ podniku môže ochotne vymeniť trochu času za úsporu nákladov a získanie flexibility.

Reálne príklady: Ďalší používateľ na HN povedal, že to používal pre konzultačnú LLC a fungovalo to dobre, ale keď transakcie rástli, začali rozdeľovať súbory ročne, aby udržali rýchlosť. Konsenzus je: pre malý podnik (povedzme desiatky tisíc transakcií ročne alebo menej) je Beancount dokonale schopný. Ak by ste boli väčší SME so stovkami tisíc transakcií, výkon by mohol odôvodniť buď použitie databázového prístupu, alebo výber účelového účtovného systému – hoci máme Beanpost, ktorý sa to snaží riešiť použitím Postgres ako backendu.

Spolupráca: Jedna oblasť rozdielu – QuickBooks Online umožňuje viacerým používateľom (majiteľ, účtovník atď.) pracovať súčasne. S Beancountom by spolupráca mohla prebiehať cez Git (viacero používateľov commit-uje zmeny). To funguje, ale vyžaduje určité znalosti Gitu a riešenie konfliktov, ak ľudia upravujú súčasne. Niektorí používali online Git platformy alebo dokonca Google Drive na zdieľanie súboru hlavnej knihy. Je to uskutočniteľné, ale nie také bezproblémové ako cloudový účtovný softvér. Pre malý tím (alebo sólo účtovníka + majiteľa) je to však zvládnuteľné a vždy môžete poskytnúť prístup len na čítanie cez Favu (hostite ju na internom serveri a nechajte ostatných prezerať reporty bez úprav).

Regulačná zhoda: Pre osobné financie nie je problém. Pre podnikanie možno budete musieť produkovať oficiálne reporty alebo dodržiavať účtovné štandardy. Beancount sa dá použiť na generovanie výkazov v súlade s GAAP, ale vyžaduje, aby používateľ zodpovedajúco zadal dáta. Neexistuje žiadne vstavané vynucovanie pravidiel GAAP (napr. žiadny vstavaný modul dlhodobého majetku na zabezpečenie správneho odpisovania). Externý účtovník môže stále pracovať s Beancount hlavnou knihou (keďže je to v podstate zovšeobecnený denník) – mohol by ju exportovať do Excelu a v prípade potreby urobiť úpravy. Niektoré podniky môžu z tohto dôvodu uprednostniť známy softvér alebo aspoň mať účtovníka, ktorému vyhovujú dáta v čistom texte.

Kto to používa pre podnikanie? Pravdepodobne power-users: technologické startupy, freelanceri s programátorským zázemím alebo firmy, ktoré vysoko oceňujú kontrolu nad dátami (napr. možno obchodné firmy chcúce vlastný reporting). V jednom vlákne na Reddite sa niekto pýtal, či by Beancount vyhovoval obchodnej firme – odpovede naznačili áno, zvláda viacero mien a dokáže produkovať potrebné výkazy, ale budete okolo neho budovať nejaké nástroje.

Na záver tejto sekcie: Používatelia osobných financií milujú Beancount pre poznatky a kontrolu, ktoré dáva nad ich osobnými peniazmi – premieňa financie na dataset, ktorý môžu dotazovať a učiť sa z neho, čím prináša veci ako ľahké sledovanie každého výdavku a výpočet metrík, ktoré typické budgetovacie nástroje nedokážu. Používatelia malých podnikov oceňujú transparentnosť, úsporu nákladov a hackovateľnosť – môžu integrovať účtovníctvo so zvyškom svojho softvérového stacku a vyhnúť sa uzamknutiu u dodávateľa alebo mesačným poplatkom. Oba prípady použitia profitujú z analytiky v reálnom čase: človek môže sledovať pokrok svojho mesačného rozpočtu, podnik môže sledovať denné peňažné toky – v oboch prípadoch Fava dokáže prezentovať aktuálne informácie, keď je napájaná aktuálnymi dátami.

Porovnanie s inými platformami pre analýzu v reálnom čase​

Je užitočné porovnať Beancount+Fava s inými riešeniami, ktoré ponúkajú finančnú analytiku "v reálnom čase", ako sú QuickBooks (s živými bankovými feedmi) a Power BI (alebo podobné BI dashboardy). Každý prístup má svoje silné stránky a kompromisy v zmysle transparentnosti, flexibility a responzívnosti:

Zhrnutím, Beancount+Fava vs QuickBooks: Beancount ponúka vynikajúcu transparentnosť (vidíte a ovládate všetko a vaše dáta nezmiznú ani nebudú uzamknuté) a flexibilitu (môžete modelovať čokoľvek v hlavnej knihe, nielen to, čo QuickBooks očakáva). Vyžaduje viac DIY, najmä pre automatizáciu a pekné UI detaily. QuickBooks je riešenie plug-and-play optimalizované pre potreby malých podnikov – bankové feedy, fakturácia, mzdy (s doplnkami) – a poskytuje aktualizácie takmer v reálnom čase s minimálnym úsilím používateľa. Je to však v mnohých ohľadoch čierna skrinka; dôverujete softvéru, že správne spracuje vaše dáta, a niekedy to znamená, že je ťažké opraviť chyby alebo pochopiť, ako dospel k číslu. Mnohí používatelia Beancountu sú ľudia, ktorých tieto čierne skrinky frustrovali. Vymieňajú trochu pohodlia za jasnosť.

Beancount+Fava vs Power BI (alebo iné BI): Môžu sa dopĺňať. Power BI nie je účtovný systém; je na analýzu. Pokročilé nastavenie by dokonca mohlo použiť Beancount na konsolidáciu a zabezpečenie presnosti dát, potom použiť Power BI na vytvorenie exekutívnych dashboardov z týchto dát. Ak porovnáme priamo, Power BI je viac o vizuálnej flexibilite a kombinovaní zdrojov dát. Grafy Favy sú jednoduchšie od dizajnu (zamerané na účtovné potreby), ale vyžadujú oveľa menej práce na rozbehnutie (fungujú z krabice na vašej hlavnej knihe, žiadne modelovanie nie je potrebné). Ak je vaším cieľom čisto získať poznatky a pekné vizuály a ste ochotní pripraviť dáta, BI nástroj môže byť vhodný. Ale ak je vaším cieľom viesť knihy a získať interaktívne reporty ako vedľajší produkt, Fava sama často stačí.

Dalo by sa tiež porovnať s inými nástrojmi osobných financií (napr. Mint alebo YNAB) alebo ERP systémami, ale otázka konkrétne spomína platformy analytiky v reálnom čase. V oblasti zobrazenia financií v reálnom čase: Beancount+Fava je ako mať vlastný, open-source "živý" finančný dashboard, QuickBooks je uzavreté automatizované účtovníctvo so živou bankovou synchronizáciou a Power BI je flexibilná analytická platforma (nie finančne špecifická, ale dá sa použiť pre financie, ak je napájaná dátami).

Výpovedná citácia kontrastujúca open-source vs komerčné: "S trochou úsilia na začiatku môžu byť open source nástroje v skutočnosti oveľa lepšie než komerčné riešenia a oveľa flexibilnejšie a rozšíriteľnejšie." To sumarizuje kompromis. QuickBooks je vyladené a funguje z krabice pre bežné scenáre s minimálnym úsilím. Ale akonáhle chcete niečo, čo nerobí, narazíte na stenu. S Beancountom zriedka narazíte na stenu – máte zdrojový kód a dáta, môžete rozširovať alebo integrovať podľa potreby. Cenou je, že musíte byť ochotní sa s tým hrať.

Výhody a nevýhody používania Fava a Beancount pre dátovo riadené poznatky​

Nakoniec zhrňme výhody a nevýhody Beancountu+Favy ako riešenia pre finančnú analytiku:

Výhody​

• Transparentnosť a dôvera: Všetky výpočty (súčty, zostatky) sú odvodené z hlavnej knihy v čistom texte, ktorú môžete skontrolovať. Neexistuje žiadne záhadné správanie. To buduje veľkú dôveru v čísla – kľúčové, ak na nich zakladáte rozhodnutia. Je to "čisté, transparentné účtovníctvo" bez uzamknutia. Vždy môžete vystopovať uvedené číslo späť k podkladovým transakciám, čo je esenciou dátami podloženého poznatku.

• Reprodukovateľnosť a audítorská stopa: Pretože môžete hlavnú knihu verzovať, máte časovú líniu zmien. Ak sa tento mesiac niečo zdá byť nesprávne, môžete porovnať hlavnú knihu, aby ste videli, čo sa zmenilo. To tiež znamená, že môžete experimentovať ("čo ak preklasifikujem tento výdavok?") a ľahko vrátiť zmeny. Práca podložená dátami často zahŕňa iterácie a audítovateľná hlavná kniha to podporuje.

• Flexibilita v analýze: Nie ste obmedzení na vopred vytvorené reporty. Kombinácia BQL dotazov, Python skriptovania a filtrov Favy znamená, že môžete odpovedať na takmer akúkoľvek finančnú otázku. Chcete vedieť "Koľko som minul v Starbucks každý rok za posledných 5 rokov?" – jeden dotaz. Alebo "Aký je kĺzavý priemer mojich 3-mesačných výdavkov vs príjmov?" – skriptovateľné pomocou Python+pandas na vrchu dotazu. Táto flexibilita je obrovské plus pre tých, ktorí radi skúmajú dáta. Power users dokonca vytvorili rozšírenia na výpočet finančných ukazovateľov (napr. metriky výkonnosti portfólia) v rámci Favy. Stručne, môžete získať veľmi granulárne poznatky, ktoré mnohé hotové softvéry nedokážu poskytnúť.

• Integrácia a rozšíriteľnosť: Systém pluginov Favy a prístupné API Beancountu znamenajú, že nástroje môžu rásť s vašimi potrebami. Ak zajtra začnete potrebovať sledovať nový typ aktíva alebo chcete integrovať nový dátový feed, môžete systém rozšíriť. Architektúra (čistý text na vstupe, rôzne výstupy) je veľmi rozšíriteľná. To stojí v kontraste s uzavretými systémami, kde možno musíte požiadať o funkciu a čakať.

• Konsolidácia dát: Pre jednotlivcov a dokonca podniky je schopnosť konsolidovať všetky účty (viacero bánk, brokerov atď.) do jedného systému výkonná. Mnohé komerčné riešenia vás silujú (alebo účtujú extra za viacero mien alebo entít). S Beancountom môžete všetko spojiť. To poskytuje holistický pohľad na dáta, umožňujúci poznatky naprieč celým spektrom. Napríklad môžete vypočítať svoju skutočnú celkovú alokáciu aktív alebo čistý peňažný tok naprieč osobným a podnikovým, ak by ste chceli, keďže sú to len dátové záznamy.

• Nákladová efektívnosť: Je zadarmo a open-source. Pre osobné použitie je to veľké plus (žiadne predplatné ako mnohé budgetovacie aplikácie). Pre startupy alebo malé organizácie sa tieto úspory môžu nazbierať. Ale okrem peňažných nákladov je to tiež efektívne v zmysle prevádzky (Fava sa dá spustiť na malom serveri) a prenosu (žiadne drahé migrácie, ak prerastiete – je to len text).

• Komunita a zdieľanie znalostí: Komunita účtovníctva v čistom texte (Beancount, Ledger atď.) je veľmi kolaboratívna. Ľudia zdieľajú svoje konfigurácie, vlastné skripty a tipy na fórach a blogoch. To znamená, že ak máte špeciálnu potrebu, niekto možno riešil niečo podobné. Napríklad viacero používateľov prispelo k nástrojom inteligentného importu a dokonca kategorizácii strojovým učením (napr. knižnica "smartimporter", ktorá používa scikit-learn na automatickú kategorizáciu príjemcov platieb na základe minulých dát). Časom sa používanie Beancountu môže v skutočnosti stať _inteligentnejším, ak využijete tieto komunitné nástroje – približujúc sa pohodliu komerčného softvéru pri zachovaní transparentnosti.

• Posilnenie a učenie: Používanie Favy/Beancountu vás núti zaoberať sa svojimi finančnými dátami na hlbšej úrovni. Mnohí používatelia uvádzajú, že prostredníctvom tohto systému získali oveľa lepšie pochopenie svojich financií, než kedy mali s automatickými aplikáciami. Je to trochu ako rozdiel medzi varením vlastného jedla vs kupovaním fast foodu – viac úsilia, ale presne viete, čo v ňom je, a z dlhodobého hľadiska to môže byť zdravšie. Pre dátami podložené poznatky môže toto "vlastníctvo" procesu viesť k zmysluplnejším objavom, pretože môžete ľahko rámovať a prerámovať, ako sa na dáta pozeráte.

Nevýhody​

• Počiatočné nastavenie a krivka učenia: Buďme úprimní – Beancount a Fava nie sú také plug-and-play ako napríklad QuickBooks alebo Mint. Musíte sa naučiť základy podvojného účtovníctva (ak ich nepoznáte), syntax Beancount súboru a možno trochu Pythonu, ak chcete vysoko prispôsobiť. Táto počiatočná investícia môže byť prekážkou. Pre netechnických používateľov to môže byť odstrašujúce (hoci rozhranie Favy veľmi pomáha tým, že po nastavení poskytuje priateľskejší zážitok). Naopak, mnohé komerčné nástroje skrývajú účtovné koncepty za jednoduchšími rozhraniami (čo môže byť aj plus aj mínus).

• Žiadna vstavaná banková synchronizácia: Od dizajnu sa nepripája automaticky k bankovým API (ktoré sú často proprietárne alebo vyžadujú dohody). Takže buď manuálne sťahujete výpisy, alebo si nastavíte vlastnú automatizáciu (cez Python skripty alebo služby ako Plaid, ktoré často stoja peniaze). Pre tých zvyknutých na bankové feedy, ktoré "jednoducho fungujú", to môže pôsobiť ako krok späť. Ako poznamenal jeden používateľ, pri skúšaní Beancountu "nenašiel rozumný spôsob, ako získať bankové feedy" – to môže byť frustrácia, ak nie ste ochotní kódovať alebo používať riešenia tretích strán.

• Reálny čas znamená váš čas: Dosiahnutie responzívnosti v reálnom čase je možné, ale nie z krabice. Musíte nastaviť cron úlohy alebo spúšťače, ako je opísané. Ak sa niečo pokazí (napr. banka zmení formát svojho CSV), musíte opraviť svoj importér. So službou ako QuickBooks sa takéto zmeny rieši dodávateľ. V podstate ste svojou vlastnou IT podporou. To je klasický open-source kompromis. Pre hobbyistu to môže byť v poriadku alebo dokonca zábava; pre zaneprázdneného majiteľa malého podniku to môže byť otrava.

• Limity škálovania a výkonu: Pre veľmi veľké datasety (mnoho rokov detailných transakcií) sa Beancount môže spomaliť. Vo všeobecnosti je efektívny (ľudia majú desiatky tisíc zápisov bez problémov). Ale ako vidno vo vlákne na HN, jeden používateľ musel po 3 rokoch "uzatvárať knihy" ročne, keď súbor rástol, aby udržal dotazy rýchle. Kód Beancountu v2 je Python a pri obrovských dátach môže byť trochu pomalý, hoci v3 (vo vývoji s C++ jadrom) to zlepšuje. Existujú zmiernenia (rozdelenie súborov, použitie Beanpost na odľahčenie do DB atď.), ale je to úvaha. QuickBooks má pravdepodobne interné škálovanie a väčšina BI nástrojov je postavená na databázach určených pre veľké dáta – takže môžu zvládnuť veľké datasety elegantnejšie.

• Chýbajúce funkcie (v porovnaní s dedikovaným softvérom): Beancount+Fava sa zameriava na účtovníctvo a analýzu. Chýbajú mu niektoré pomocné funkcie: napr. žiadne spracovanie miezd, žiadne generovanie faktúr (bez vlastného skriptovania), žiadne integrované formuláre na prípravu daní atď. Ak je vaším cieľom komplexná finančná správa, možno budete musieť doplniť inými nástrojmi. Napríklad by ste mohli robiť mzdy cez mzdovú službu a len importovať denníkové zápisy. To funguje, ale nie je to také bezproblémovo integrované ako niečo ako ERP, ktoré robí všetko v jednom. Pre osobné financie Beancount nemá veci ako vstavaní plánovači splácania dlhu alebo budgetovacie obálky (hoci tieto môžete simulovať). Očakáva sa, že odvodíte poznatky a potom sa rozhodnete, namiesto poskytovania predpisujúcich rád alebo plánovacích modulov.

• Používateľské rozhranie a vycibrenosť: Hoci Fava je celkom pekná, nie je taká vyladená alebo vedená ako niektoré komerčné ponuky. Neexistuje žiadny "sprievodca", ktorý by vás previedol nastavením alebo zabezpečil, že neurobíte chyby. Možno budete musieť čítať dokumentáciu, aby ste vedeli, ako urobiť X. A určité UI funkcie, ktoré by ste mohli očakávať (kategorizácia drag-and-drop, viackrokové vrátenie, mobilné push notifikácie atď.), tam nie sú. UI Favy sa stále zlepšuje (s príspevkami), ale buduje ho malá komunita. Ak ste zvyknutí na elegantné moderné SaaS UI, Fava môže pôsobiť trochu utilitárne (hoci niektorí v skutočnosti uprednostňujú jej čistú jednoduchosť). Na mobile Fava funguje (najmä len na čítanie), ale nie je plne optimalizovaná pre malé obrazovky; QuickBooks má napríklad dedikované mobilné aplikácie.

• Spoliehanie sa na komunitu/maintainera: Martin Blais (autor Beancountu) a prispievatelia udržiavajú Beancount a iní udržiavajú Favu. Vývoj môže byť sporadický (ako je v OSS normálne). Hoci softvér je teraz veľmi použiteľný, ak potrebujete novú funkciu alebo existuje chyba, možno budete musieť opraviť ju sami alebo čakať. S plateným produktom máte podporu, na ktorú môžete zavolať (kvalita sa líši, ale aspoň je tam). To povedané, komunita je zvyčajne dosť nápomocná cez mailing list alebo GitHub issues.

• Vyžadujú sa účtovné znalosti: Najmä pre podnikové použitie musíte vedieť, čo robíte. Beancount vám nezabráni urobiť zápis, ktorý je z účtovného hľadiska "nesprávny" (okrem nevyrovnanej alebo nepárovej transakcie). QuickBooks naopak má ochranné zábradlia (a tiež skrytú komplexitu ako automatické sledovanie odložených výnosov atď., ak ich povolíte). Ak v Beancounte nie ste opatrní, mohli by ste pokaziť akruálny zápis a neuvědomiť si to, kým si nevšimnete problém v reporte. V podstate Beancount predpokladá, že buď máte základy účtovníctva zvládnuté, alebo ste ochotní sa ich naučiť. To je pre niektorých vlastne plus (núti robiť to správne), ale mínus, ak chcete systém, ktorý nevyžaduje premýšľanie.

Na zhrnutie výhod a nevýhod: Beancount + Fava poskytuje neporovnateľnú kontrolu a prispôsobivosť pre tých, ktorí sa chcú hlboko zaoberať svojimi finančnými dátami, čo z neho robí výkonný nástroj pre dátami podložené poznatky. Premieňa vaše knihy na dotazovateľný dataset a vaše reporty na rozšíriteľnú webovú aplikáciu. Cenou za túto silu je práca, ktorú investujete do nastavenia a údržby, a potreba byť do istej miery sebestačný pri správe svojho systému. Na rozdiel od niečoho ako QuickBooks alebo BI sada, ktoré viac vedú za ruku a dodávajú určité funkcie automaticky, Beancount vám dáva sadu nástrojov. Ak ste analyticky naklonení, táto sada nástrojov môže byť neuveriteľne oslobodzujúca – môžete extrahovať poznatky, ktoré hotové reporty možno nikdy neukážu. Ako napísal jeden používateľ, ktorý v priebehu rokov automatizoval svoju Beancount hlavnú knihu, "open-source nástroje (ako Beancount) nespĺňajú všetky moje potreby [z krabice]… Som posadnutý automatizáciou všetkého… Postavil som, čo som potreboval". To vystihuje prístup: ak ste ochotní postaviť, čo potrebujete, či už malé alebo veľké, Fava/Beancount vás podporí a nikdy pred vami neskryje vaše dáta. Pre dátami podložené myslenie je to obrovská výhoda.

Na záver, používanie Favy a Beancountu pre finančnú analytiku v reálnom čase je trochu ako mať vlastné prispôsobiteľné laboratórium pre svoje financie. Získate jasnosť, flexibilitu a vlastníctvo, ktoré je ťažké vyrovnať s proprietárnymi platformami, čo ho robí ideálnym pre tých, ktorí tieto aspekty oceňujú a sú ochotní vymeniť trochu pohodlia, aby ich získali. Moderná krajina dokonca ukazuje hybridné prístupy – napríklad niektorí môžu používať komerčný nástroj, ale pravidelne exportovať do Beancountu na hlbšiu analýzu, alebo naopak používať Beancount ako primárny a BI nástroj na prezentáciu. S poznatkami z tohto skúmania sa človek môže informovane rozhodnúť, či Fava+Beancount zodpovedá jeho potrebám, a ak áno, s istotou pokračovať vo využívaní jeho schopností pre bohaté finančné poznatky v reálnom čase.

Zdroje:

• Blais, M. (2020). Beancount Documentation – Design principles and usage. [Online]. Dostupné: beancount.github.io
• Aumayr, D., Gerstmayr, A. (2025). Fava Documentation & GitHub Repository. [Online]. Dostupné: beancount.github.io/fava/ a github.com/beancount/fava
• LowEndBox. (2025). "Beancount: Lightweight FOSS Double-Entry Accounting...from the Command Line!" LowEndBox Tutorial.
• Fang-Pen Lin. (2024). "My Beancount books are 95% automatic after 3 years." Personal Blog Post.
• Google Groups – Beancount Forum. (2023). Diskusia o integrácii s Grafanou (Josh D. a Andreas G.)
• QuickBooks Marketing Page. "Bank Feeds – Understand all your transactions in an instant." Intuit QuickBooks.
• Watt, A. (2023). "Beancount for Personal Finance." Alex Watt Blog.
• Reddit – r/plaintextaccounting. Rôzne diskusie (2021-2023) o podnikovom použití Beancountu a vizualizácii hlavnej knihy.
• Fava Extension Documentation – Help: Extensions.
• fava-dashboards GitHub README – plugin vlastných dashboardov Andreasa Gerstmayra.
• Awesome Beancount zoznam – komunitou spravované zdroje pre Beancount.