# Účtovný cyklus, štýl Beancount

Finančné výkazy sa neobjavujú ako kúzlo. Sú konečným produktom štruktúrovaného, opakovateľného procesu známeho ako **účtovný cyklus**. Hoci princípy sú univerzálne, nástroje, ktoré používate, môžu dramaticky zmeniť skúsenosť. Tento sprievodca vás prevedie účtovným cyklom so zameraním na **Beancount**, výkonný nástroj pre účtovanie v čistom texte.

Uvidíme, ako prístup Beancountu založený na texte eliminuje únavné kroky, čo by ste mali automatizovať a ktoré výkazy vám poskytnú najjasnejší obraz o vašom finančnom zdraví. 🧑‍💻

---

## TL;DR: Pracovný postup v Beancount

- **Capture & Journal:** Zaznamenajte každú transakciu ako čistý, dvojzápisný zápis vo vašom `.beancount` textovom súbore.
- **Validate & Reconcile:** Použite `balance` asertácie na potvrdenie, že vaša hlavná kniha zodpovedá bankovým výpisom, a spustite `bean-check` na zachytenie chýb.
- **Review:** Vygenerujte neupravený skúšobný súpis pre rýchlu kontrolu.
- **Adjust:** Zaznamenajte položky pre akumulácie, odkladania, odpisy a ďalšie položky konca obdobia.
- **Re-review:** Skontrolujte upravený skúšobný súpis, aby ste sa uistili, že je všetko v poriadku.
- **Publish & Close:** Vygenerujte Výkaz ziskov a strát, Rozvahu a Výkaz peňažných tokov. Uzavretie kníh je v Beancounte voliteľné, pretože výkazy sú dátovo‑vedomé.

Tento tok môžete vizualizovať takto:

```mermaid
graph TD
  A[Raw data - bank exports, receipts, invoices] --> B[Beancount Journal .beancount file]
  B --> C[Validation & Reconciliation<br/><code>balance</code> assertions · <code>bean-check</code>]
  C --> D[Unadjusted Trial Balance<br/><code>bean-query</code> · Fava]
  D --> E[Adjusting Entries<br/>accruals · deferrals · tax]
  E --> F[Adjusted Trial Balance]
  F --> G[Financial Statements<br/>P&amp;L · Balance Sheet · Cash Flow]
  G --> H[Closing - Retained Earnings]
  H -- new period --> B
```

---

## Krok 1: Zachytenie a zaznamenanie transakcií

Toto je základný krok. Každá finančná udalosť – predaj, nákup, bankový poplatok – musí byť zaznamenaná. V Beancountu to robíte vytváraním transakcií v jednoduchom textovom súbore, zvyčajne nazvanom `main.beancount` alebo rozdelenom do viacerých súborov podľa rokov.

Každá transakcia musí spĺňať pravidlá dvojzápisného účtovania, čo znamená, že súčet všetkých položiek musí byť nula. Beancount to vynúti za vás.

```beancount
2025-08-10 * "Walmart" "Purchase of office supplies"
  Expenses:Office:Supplies      45.67 USD
  Assets:Bank:Checking         -45.67 USD
```

- **Tip:** Používajte značky ako `#project-phoenix` alebo `#client-acme` na pridanie dimenzií k vašim dátam. To neskôr umožní mimoriadne flexibilné dotazovanie a výkazovanie.

### Hygiena zosúladenia ✅

Najvýkonnejšia funkcia pre zabezpečenie presnosti je **balance assertion**. Na konci výpisového obdobia (napr. na konci mesiaca) deklarujete, aký by mal byť zostatok účtu.

```beancount
2025-08-31 balance Assets:Bank:Checking  12345.67 USD
```

Ak súčet všetkých transakcií ovplyvňujúcich `Assets:Bank:Checking` do tohto dátumu nie je rovný `12345.67 USD`, Beancount vyhodí chybu. Tento jednoduchý príkaz premení vašu hlavnu knihu na samoauditný dokument.

Pre tých, ktorí dopĺňajú historické údaje, príkaz `pad` môže automaticky vytvoriť vyrovnávaciu transakciu, aby sa vaše počiatočné zostatky zhodovali s prvou asertáciou.

---

## Krok 2: „Postovať do hlavnej knihy“ (Zdarma!)

V tradičných účtovných systémoch najprv zapisujete položky do „denníka“ a potom ich samostatným krokom „postujete“ do „hlavnej knihy“.

V Beancounte je **váš `.beancount` súbor zároveň denník aj hlavná kniha**. Keď napíšete a uložíte transakciu, už ste ju postovali. Neexistuje samostatný krok. Táto priamosť je hlavnou výhodou účtovania v čistom texte – čo vidíte, je to, čo máte.

---

## Krok 3: Pripraviť neupravený skúšobný súpis

Predtým, než začnete robiť úpravy, potrebujete rýchlu kontrolu „súčet sa rovná“. **Skúšobný súpis** je jednoduchý výkaz, ktorý vypíše každý účet a jeho celkový zostatok. Celkový súčet všetkých debetových zostatkov musí byť rovný celkovému súčtu všetkých kreditových zostatkov.

Môžete ho vygenerovať jednoduchým dotazom:

```bash
bean-query main.beancount \
  "SELECT account, sum(position) GROUP BY 1 ORDER BY 1"
```

Alebo, pre vizuálnejší prístup, otvorte svoj ledger v **Fava** (webové rozhranie pre Beancount) a prejdite na výkaz „Trial Balance“. Hľadajte čokoľvek podozrivé – napríklad majetkový účet s kreditným zostatkom alebo výdavkový účet s neobvyklou hodnotou.

---

## Krok 4: Zaznamenať opravné položky

Opravné položky sú kľúčové pre presné výkazovanie podľa **akruálneho princípu** účtovania. Zabezpečujú, že príjmy sú uznané, keď sú zarobené, a výdavky, keď vzniknú, nezávisle od toho, kedy sa peniaze skutočne pohybujú.

Bežné úpravy zahŕňajú:

- **Akumulácie:** Zaznamenanie príjmu, ktorý ste zarobili, ale ešte fakturovali, alebo výdavku, ktorý ste vynaložili, ale ešte nezaplatili.
- **Odkladania:** Spracovanie predplatených platieb. Ak vám zákazník zaplatí za rok služby vopred, zaúčtujete to ako záväzok (`Liabilities:UnearnedRevenue`) a každý mesiac uznáte 1/12 príjmu.
- **Nepeňažné položky:** Odpisy majetku.
- **Korekcie:** Oprava chýb alebo doplnenie položiek, ktoré chýbali v bankových výpisoch, napríklad malý úrok.

#### **Príklad: Akumulácia príjmu**

Dokončili ste projekt 31. augusta, faktúru však pošlete až v septembri. Aby ste príjem uznali v správnom období (august), vytvoríte opravný zápis:

```beancount
2025-08-31 * "Accrue revenue for client project #1042"
  Assets:AccountsReceivable      3000.00 USD
  Income:Consulting             -3000.00 USD
```

#### **Príklad: Zaznamenanie odpisov**

Vaša spoločnosť má odpisový plán pre svoje aktíva. Na konci obdobia zaúčtujete výdavok:

```beancount
2025-12-31 * "Annual depreciation on computer equipment"
  Expenses:Depreciation                  4800.00 USD
  Assets:Fixed:AccumulatedDepreciation  -4800.00 USD
```

---

## Krok 5: Spustiť upravený skúšobný súpis a overiť

Po zaznamenaní opravných položiek spustite výkaz skúšobného súpisu znova. Toto je váš **upravený skúšobný súpis**. Poskytuje konečnú sadu čísel, ktoré budú použité na tvorbu finančných výkazov.

Je to tiež ideálny čas na spustenie vstavaného sanity checku Beancountu:

```bash
bean-check main.beancount
```

Tento príkaz overí všetku syntax, pravidlá vyváženia a asertácie. Ak nevráti žiadny výstup, vaše knihy sú mechanicky v poriadku.

---

## Krok 6: Publikovať finančné výkazy 📊

Tu je odmena. Pomocou čísel z upraveného skúšobného súpisu môžete teraz vygenerovať kľúčové finančné správy. Fava je najjednoduchší spôsob, pretože poskytuje interaktívne, detailné výkazy priamo „out‑of‑the‑box“.

- **Výkaz ziskov a strát (P&L):** Zobrazuje vaše príjmy a výdavky za obdobie, čo vedie k čistému zisku alebo strate.
- **Rozvaha:** Prehľad toho, čo vlastníte (aktíva) a čo dlžíte (záväzky), plus váš čistý majetok (vlastné imanie) k určitému dátumu.
- **Výkaz peňažných tokov:** Zosumarizuje, odkiaľ peniaze prišli a kam išli, čím prepočíta počiatočný a konečný stav hotovosti.

Pre vlastné výkazy môžete použiť Beancount Query Language (BQL). Tu je dotaz na mesačný výkaz ziskov a strát:

```sql
-- P&L for August 2025
SELECT account, sum(position)
WHERE account   '^(Income|Expenses)'
  AND date >= 2025-08-01 AND date <= 2025-08-31
GROUP BY account ORDER BY account;
```

---

## Krok 7: Uzavretie knih (voliteľné)

V tradičnom účtovaní proces „uzavretia“ zahŕňa vytvorenie zápisov, ktoré vynulujú všetky dočasné účty (príjmy a výdavky) a prevedú čistý zisk do účtu vlastného imania nazývaného **Retained Earnings**. Tým sa dočasné účty oficiálne resetujú pre nasledujúci rok.

**V Beancounte je tento krok zvyčajne zbytočný.** Výkazy vo Fave sú dátovo‑vedomé; ak požiadate o P&L za rok 2025, použije len dáta z roku 2025. Zostatky „neprelievajú“ do ďalších období. Väčšina používateľov jednoducho ponechá zostatky tak, ako sú.

Ak však potrebujete formálne uzavretie kvôli regulácii alebo správaniu akcionárov, môžete ho vykonať jednoduchou ročnou transakciou, ktorá presunie celkové zostatky príjmov a výdavkov do `Equity:Retained-Earnings`.

---

## Praktický mesačný kontrolný zoznam uzávierky

Tu je opakovateľný kontrolný zoznam na uzavretie kníh každý mesiac pomocou Beancountu.

```mermaid
flowchart TD
  cap[Capture Transactions] --> rec[Reconcile Accounts]
  rec --> review[Unadjusted Review]
  review --> adj[Post Adjustments]
  adj --> atb[Adjusted Review & Validate]
  atb --> pub[Publish Reports]
  pub --> wrap[Wrap-up & Archive]
  wrap --> cap
```

- [ ] **Capture:** Importujte všetky transakcie z bánk a kreditných kariet. Manuálne zadajte hotovostné výdavky alebo iné položky mimo systému.
- [ ] **Reconcile:** Pridajte `balance` asertácie pre všetky bankové účty, kreditné karty a úvery, aby zodpovedali výpisom.
- [ ] **Review:** Skontrolujte neupravený skúšobný súpis vo Fave. Preskúmajte akékoľvek podivné alebo neočakávané zostatky. Skontrolujte neplatené faktúry (`Assets:AccountsReceivable`) alebo nezaplatené záväzky (`Liabilities:AccountsPayable`).
- [ ] **Adjust:** Zaznamenajte položky pre akumulovaný príjem/výdavky, odkladania, nepeňažné položky a korekcie.
- [ ] **Validate:** Spustite `bean-check` na overenie integrity.
- [ ] **Publish:** Vygenerujte a exportujte Výkaz ziskov a strát, Rozvahu a Výkaz peňažných tokov.
- [ ] **Wrap‑up:** Archivujte aktuálny ledger a pripravte ho na ďalšie obdobie.

---

## Prečo Beancount vyniká v účtovnom cykle

- **Transparentnosť a auditovateľnosť:** Balance asertácie a ďalšie mechanizmy zabezpečujú, že každá položka je sledovateľná a overiteľná.
- **Úplná kontrola:** Všetko je uložené v textových súboroch, takže môžete použiť akýkoľvek editor, verzovací systém alebo skript na manipuláciu s dátami.
- **Nezrovnateľná sila:** Kombinácia jednoduchosti čistého textu s výkonnými nástrojmi ako Fava, `bean-check` a BQL poskytuje neprekonateľnú flexibilitu a rýchlosť.

---

## Kópie a vloženie úryvkov pre začiatok

### Jednoduchý plán účtov:

```beancount
option "title" "My Personal Ledger"
option "operating_currency" "USD"

;; --- Accounts ---
1970-01-01 open Assets:Bank:Checking
1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:CreditCard
1970-01-01 open Liabilities:UnearnedRevenue
1970-01-01 open Equity:Owner:Capital
1970-01-01 open Equity:Retained-Earnings
1970-01-01 open Income:Consulting
1970-01-01 open Expenses:Office:Supplies
1970-01-01 open Expenses:Software
1970-01-01 open Expenses:Depreciation
```

### Užitočný BQL dotaz:

```sql
SELECT account, sum(position) WHERE account ~ "Assets" GROUP BY account
```

Mapovaním nadčasového účtovného cyklu na moderné textové nástroje Beancount získate systém, ktorý je robustný, transparentný a navrhnutý tak, aby vydržal. Šťastné účtovanie!
