Sprievodca webovým rozhraním beancount.io

Webové rozhranie beancount.io (využíva Fava) poskytuje komplexný balík nástrojov na správu, vyhľadávanie a vizualizáciu vašich finančných údajov. Táto príručka sa zaoberá jeho hlavnými funkciami, od základného zadávania údajov až po pokročilé prispôsobenie a riešenie problémov.

1. Úprava a zadávanie údajov

Vstavaný editor

Rozhranie obsahuje výkonný textový editor na priame zmeny vo vašich súboroch Beancount. Medzi kľúčové funkcie patria:

• Automatické dopĺňanie: Stlačením klávesu Tab dokončite názvy účtov, príjemcov, značky a odkazy.

• Klávesové skratky:

  • Ctrl+Space: Spustenie automatického dopĺňania.
  • Ctrl+/: Pridanie alebo odstránenie komentárov z riadkov.
  • Ctrl+D: Duplikovanie aktuálneho riadku.
  • Alt+Up/Down: Presunutie aktuálneho riadku nahor alebo nadol.

• Inteligentné umiestnenie kurzora: Použite možnosť $insert-entry$ vo vašom súbore na automatické umiestnenie kurzora na najnovší záznam pre konkrétny účet pri otvorení editora.

  option "insert-entry" "Expenses:Food:Dining-Out"

Pridávanie transakcií

Kliknite na tlačidlo + (alebo stlačte n) pre otvorenie formulára transakcie.

• Rýchly záznam: Formulár navrhuje nedávne účty a pamätá si bežné sumy pre príjemcov.

• Inline značky/odkazy: Pridajte značky a odkazy priamo do poľa s popisom (napr. Obed #jedlo ^účtenka-001).

• Šablóny transakcií: Vytvorte budúce záznamy so značkou #template. Potom môžete použiť formulár na ich vyhľadanie a vyplnenie.

  2099-01-01 * "Mesačná platba za nájom" #template
      Expenses:Housing:Rent      1500.00 USD
      Assets:Checking           -1500.00 USD

2. Správa dokumentov

Efektívne prepojte účtenky, výpisy a iné súbory s vašimi transakciami.

• Nahrávanie pomocou Drag-and-Drop:

  • Presuňte súbor na názov účtu a uložte ho do priečinka daného účtu.
  • Presuňte súbor na transakciu v denníku a prepojte ho priamo.

• Ukladanie dokumentov: Súbory sa ukladajú do priečinka zadaného smernicou $option "documents" "path/to/your/documents"$ vo vašom súbore Beancount.

• Automatické prepojenie: Beancount môže automaticky objaviť a prepojiť dokumenty s transakciami. Aktivujte to pomocou nasledujúcich pluginov:

  plugin "fava.plugins.link_documents"
  plugin "fava.plugins.tag_discovered_documents"

3. Vyhľadávanie a analýza pomocou BQL

Stránka Query umožňuje spúšťať dotazy v jazyku Beancount Query Language (BQL), podobne ako nástroj príkazového riadku bean-query.

• Vizualizácia: Výsledky dotazov sa automaticky vykresľujú ako tabuľky. Ak váš dotaz vráti dva stĺpce (napríklad dátum/reťazec a číslo), rozhranie vygeneruje aj čiarový, stĺpcový alebo treemap graf.
• Export: Stiahnite si ľubovoľný výsledok dotazu ako súbor CSV.

Praktické príklady dotazov

• Mesačný prehľad výdavkov:

  SELECT account, SUM(position) AS total
  FROM postings
  WHERE account ~ '^Expenses' AND date >= 2024-01-01 AND date < 2024-02-01
  GROUP BY account
  ORDER BY total DESC;

• Príjmy vs. Výdavky podľa mesiaca:

  SELECT YEAR(date) as year, MONTH(date) as month,
         SUM(IIF(account ~ '^Income', -position, 0)) as income,
         SUM(IIF(account ~ '^Expenses', position, 0)) as expenses
  FROM postings
  GROUP BY year, month
  ORDER BY year, month;

4. Prispôsobenie a pracovný postup

Prispôsobenie zobrazenia

Prispôsobte zobrazenie rozhrania pomocou týchto možností vo vašom súbore Beancount:

• Viditeľnosť účtov: Ovládajte, ktoré účty sa zobrazujú v bočnom paneli.

  option "show-closed-accounts" "false"
  option "show-accounts-with-zero-balance" "false"
  option "collapse-pattern" "Assets:Investments:.*"

• Ukazovatele aktuálnosti: Farebné bodky vedľa účtov zobrazujú ich stav (zelená pre úspešnú kontrolu zostatku, červená pre neúspešnú, žltá pre žiadnu nedávnu kontrolu zostatku). Aktivujte to v smernici open účtu:

  2020-01-01 open Assets:Checking   fava-uptodate-indication: "TRUE"

Odkazy v bočnom paneli

Pridajte vlastné odkazy na často používané prehľady alebo filtrované zobrazenia v bočnom paneli.

2024-01-01 custom "fava-sidebar-link" "Výdavky za tento mesiac" "/income_statement/?time=month"
2024-01-01 custom "fava-sidebar-link" "Všetky dokumenty" "/journal/?show=document"

Všeobecná konfigurácia

• Viac súborov: Ak načítate viacero súborov .beancount, môžete medzi nimi prepínať pomocou rozbaľovacieho zoznamu v ľavom hornom rohu.
• Externý editor: Nakonfigurujte používateľské rozhranie na otváranie súborov priamo vo vašom lokálnom editore pomocou možnosti $use-external-editor$ a obslužného programu URL.
• Jazyk: Nastavte jazyk rozhrania pomocou možnosti $language$ alebo nechajte rozhranie automaticky zistiť jazyk z vášho prehliadača.
• Export: Exportujte ľubovoľné filtrované zobrazenie denníka vo formáte Beancount pomocou tlačidla Export.

5. Výkon a riešenie problémov

Spracovanie veľkých súborov

Pre knihy s tisíckami transakcií zlepšite výkon:

• Používanie Include: Rozdeľte svoju knihu na viacero súborov podľa roka alebo mesiaca a použite smernicu include.

  include "accounts.beancount"
  include "transactions/2023.beancount"
  include "transactions/2024.beancount"

• Filtrovanie: Použite časové a filtračné možnosti na obmedzenie množstva údajov zobrazených naraz.

Bežné problémy a opravy

• Rozhranie sa nenačítava:

  1. SkontrolujteSyntax errors vo vašom súbore pomocou nástroja príkazového riadku bean-check.
  2. Vyhľadajte chybové hlásenia v dolnej časti webovej stránky.
  3. Vymažte vyrovnávaciu pamäť prehliadača.

• Pomalý výkon:

  1. Znížte aktívny rozsah dátumov v používateľskom rozhraní.
  2. Zjednodušte zložité dotazy BQL.

• Chyby konfigurácie: Uistite sa, že názvy možností a vlastné typy smerníc sú uzavreté v úvodzovkách.

  ; Správne
  option "documents" "/path/to/docs"
  custom "fava-sidebar-link" "Label" "URL"
  
  ; Nesprávne (spôsobí chyby)
  option documents "/path/to/docs"
  custom fava-sidebar-link "Label" "URL"