7 дописів з тегом "Fava"

Якщо ваш реєстр зберігається у простому тексті, закриття місяця може бути і швидким, і аудиторським. Процес не повинен бути хаотичним бігом по електронних таблицях і калькуляторах. Цей посібник викладає чистий, повторюваний процес, адаптований для Beancount та його веб‑інтерфейсу Fava, побудований навколо балансних тверджень, розумного імпорту та легковагових перевірок.

Ось контрольний список для безболісного закриття:

1. Зберіть виписки та імпортуйте всі необроблені транзакції.
2. Нормалізуйте отримувачів, описи та метадані.
3. Звірте кожен готівковий, банківський та кредитний рахунок за допомогою тверджень balance.
4. Перевірте відповідність переказів та переміщень між рахунками.
5. Оновіть ціни інвестицій та перевірте їх оцінки.
6. Прикріпіть або вкажіть джерела документів (квитанції, рахунки) у вашому реєстрі.
7. Запустіть запити та панелі інструментів для перевірки прибутків і збитків та варіацій.
8. Відобразіть нарахування та коригування за потреби.
9. Валідуйте реєстр за допомогою автоматизованих перевірок.
10. Закомітьте, позначте тегом та заархівуйте місяць.

1. Встановіть базові правила (і використовуйте їх повторно)​

Для швидкого та безпомилкового закриття важливо мати чіткі параметри. Автоматичне застосування правил забезпечує послідовність і зменшує ризик помилок.

Порада: Розглядайте ваш файл параметрів як «інфраструктуру». Зміна його може вплинути на спосіб обчислення ваших цифр. Версіонуйте його обережно у Git.

2. Імпортуйте все — і більше ніколи не вводьте вручну​

Автоматизація імпорту даних — це найбільше прискорення процесу закриття книг. Використовуйте потужні інструменти імпорту Beancount та імпортери, створені спільнотою, щоб отримати банківські виписки, CSV/OFX файли кредитних карток, дані брокерських рахунків та звіти про зарплату.

Мета — імпорт однією командою, який генерує збалансовані проводки, які потрібно лише переглянути та закомітити. Це усуває ручне введення даних, головне джерело помилок і затримок.

3. Нормалізуйте отримувачів та метадані заздалегідь​

Чисті дані — це надійні дані. Стандартизуйте отримувачів, опис та теги під час процесу імпорту, щоб ваші пошуки, правила та звіти залишалися точними місяць за місяцем.

Система плагінів Beancount дозволяє додавати легковагові трансформації та валідації під час завантаження файлів. Це ідеально підходить для впровадження власних перевірок узгодженості або використання вбудованого плагіну noduplicates для позначення повторюваних транзакцій до того, як вони стануть проблемою.

4. Звірка за допомогою тверджень balance​

Для кожного рахунку, який має виписку (поточний, ощадний, кредитні картки), використовуйте директиву balance у Beancount, щоб задекларувати закривний баланс. Цей простий рядок перетворює звірку з ручної перевірки оком у точний, автоматизований тест.

2025-08-31 balance Assets:Cash  1234.56 USD

Оскільки баланси перевіряються на початку дня, найзручніше використовувати перший день наступного місяця для виписки за кінець місяця. Якщо розрахований Beancount баланс не збігається з вашим твердженням, ви отримаєте точну помилку та дату для початку розслідування. Завжди спочатку виправляйте джерело правди (ваші транзакції); не «примушуйте» звірку.

5. Перевірте відповідність міжрахункових переказів​

Переконайтеся, що кожен переказ відображається з обох сторін транзакції. Наприклад, платіж з вашого поточного рахунку на кредитну картку має бути відображений в обох рахунках. Невідповідність переказів — поширене джерело проблем зі звіркою.

Використовуйте директиву pad лише для встановлення історичних початкових балансів під час першого налаштування рахунку. Це інструмент налаштування, а не підпора для виправлення різниць у закритті місяця.

6. Перевірте позиції та ціни інвестицій​

Щоб отримати точний огляд вашого чистого капіталу, потрібні актуальні ринкові вартості ваших інвестицій та іноземних валют. Використовуйте директиву price у Beancount, щоб зафіксувати ці значення на дату вашого закриття.

2025-08-31 price AAPL  150.00 USD

Багато інструментів можуть автоматично отримувати ці ціни для вас. Після їх оновлення запустіть знову ваш баланс або звіти про чистий капітал, щоб побачити зміни оцінки.

7. Прикріпіть квитанції та вихідні документи​

Зберігайте чистий аудиторський слід, пов’язуючи транзакції з їхніми вихідними документами. Використовуйте параметр documents у вашому головному файлі Beancount, щоб вказати шлях до архіву квитанцій та рахунків.

2025-08-15 transaction "Coffee shop"
    expense:food  5.00 USD
    documents: "receipts/2025-08-15.coffee.pdf"

Якщо ви називаєте файли за датою (наприклад, 2025-08-13.vendor.receipt.pdf), Beancount і Fava можуть автоматично їх виявляти та зв’язувати, що дозволяє одним кліком відкрити квитанцію для будь‑якої транзакції.

8. Перегляньте місяць за допомогою Fava та BQL​

Швидкий цикл зворотного зв’язку є критичним. Використовуйте Fava для візуальної інспекції ваших фінансів. Його діаграми та звіти ідеально підходять для розподілу витрат за категоріями, перевірки тенденцій доходів та швидкого виявлення аномалій.

Для більш точних перевірок використовуйте Beancount Query Language (BQL). Цей запит, наприклад, дає вам ранжований розподіл усіх витрат за серпень 2025 року:

SELECT account, SUM(position) AS total
WHERE account ~ "Expenses"
GROUP BY account
ORDER BY total DESC

9. Відобразіть нарахування та коригування​

Якщо ви користуєтеся нарахувальною бухгалтерією, записуйте ваші місячні коригування як явні, датовані транзакції. Це може включати нараховані витрати (наприклад, рахунок за комунальні послуги, який ще не отримано), амортизацію передплачених витрат або визнання доходу. Тримайте їх простими та добре задокументованими у описі, щоб їх було легко зрозуміти під час майбутніх переглядів.

10. Валідація, тегування та архівація​

Перед тим як завершити місяць, запустіть фінальну перевірку структурної цілісності:

beancount -f myfile.beancount validate

Ця команда виявить дисбаланси, посилання на рахунки, які ви ще не відкрили, та інші поширені помилки. Виправте все, що вона позначить.

Коли все буде правильним, закомітьте зміни у систему контролю версій (наприклад, Git) з чітким повідомленням і тегом, наприклад close-2025-08. Нарешті, заархівуйте ваші банківські виписки і вважайте місяць закритим.

Простий скрипт закриття, який ви можете адаптувати​

Ви можете автоматизувати більшість цих кроків за допомогою простого shell‑скрипту. Це перетворює ваше закриття у одну, повторювану команду.

#!/bin/bash
# Приклад простого скрипту закриття
beancount -f myfile.beancount import bank.csv
beancount -f myfile.beancount balance Assets:Cash 1000 USD
git add myfile.beancount
git commit -m "Month close"

Чому це працює​

Цей процес швидкий і надійний, тому що він базується на кількох ключових принципах:

• Твердження, а не око: Директива balance перетворює звірку у точну, автоматизовану перевірку.
• Детерміновані входи: Автоматизовані імпортери та нормалізовані метадані роблять ваш реєстр відтворюваним і послідовним.
• Досліджувані дані: Fava та BQL надають потужні інструменти для валідації результатів і миттєвого аналізу відхилень.
• Аудиторські зміни: Коригування — це записи у простому тексті, що полегшує їх перегляд і розуміння через місяці чи роки.

Добре закриття місяця — це в основному логістика. За допомогою Beancount ви можете перетворити його на короткий, скриптовий ритуал: імпорт, твердження, ціна, запит і коміт. Підтримуйте стабільний робочий процес, і ваше закриття залишатиметься швидким — навіть коли ваше фінансове життя стає складнішим.

Ми раді оголосити про важливе оновлення екосистеми Beancount.io: офіційну інтеграцію beancount-dashboard. Ця потужна нова функція додає набір насичених, інтерактивних візуалізацій безпосередньо у Fava, дозволяючи вам бачити свою фінансову історію чітко, захопливо та дієво.

Що таке beancount-dashboard?​

beancount-dashboard — це плагін з відкритим кодом для Fava, веб‑інтерфейсу Beancount. Він перетворює ваші фінансові дані у простому тексті на динамічні та інформативні дашборди, роблячи розуміння фінансового стану простішим, ніж будь‑коли, і допомагаючи приймати обґрунтовані рішення.

Плагін пропонує широкий спектр потужних візуалізацій:

• 📊 Комплексні огляди активів: Слідкуйте за своїм багатством за допомогою лінійного графіка чистої вартості, моніторьте ефективність за допомогою детального відстеження портфеля та візуалізуйте розподіл за допомогою кругових діаграм розподілу активів.
• 💰 Аналіз доходів і витрат: Точно розумійте свій грошовий потік. Аналізуйте місячні середні значення, розбивайте витрати за категоріями та бачте, як змінилися ваші звички за допомогою річного аналізу.
• ✈️ Управління витратами на подорожі: Відстежуйте річні витрати на подорожі та аналізуйте патерни витрат за напрямками, щоб ефективніше планувати майбутні поїздки.
• 🔄 Діаграми Санкі: Візуалізуйте потік ваших грошей за допомогою інтерактивних діаграм, які показують, як кошти переміщуються між джерелами доходу, рахунками та категоріями витрат.
• 📈 Фінансові прогнози: Плануйте майбутнє, використовуючи історичні дані для встановлення цілей та проекції вашої фінансової траєкторії.

Чому ми інтегрували beancount-dashboard​

Ця інтеграція змінює правила гри для спільноти Beancount, пропонуючи чотири ключові переваги:

1. Покращений користувацький досвід​

Beancount базується на надійній системі подвійного запису, проте сирі дані можуть бути важкими для сприйняття. Плагін beancount-dashboard перетворює складні журнали у інтуїтивні візуалізації, роблячи фінансове управління доступним і захопливим для кожного.

2. Кращі фінансові рішення​

Візуальні дашборди дають змогу приймати розумніші фінансові рішення. Вони допомагають виявляти тренди, оптимізувати бюджети, відстежувати цілі та планувати наперед з упевненістю, подаючи ваші дані у легкозасвоюваній формі.

3. Професійна аналітика​

Ця інтеграція приносить корпоративний аналітичний потенціал прямо до ваших рук. Завдяки Apache ECharts дашборди пропонують інтерактивні графіки, кастомні вигляди та оновлення в реальному часі, що відображають ваші останні транзакції. Адаптивний дизайн забезпечує безшовний досвід на будь‑якому пристрої.

4. Відмінність відкритого коду​

І Beancount, і beancount-dashboard дотримуються принципів відкритого коду. Це означає повну прозорість у обробці ваших даних, гарантію приватності (оскільки дані залишаються у вашій інфраструктурі) та підтримку активної та інноваційної спільноти.

Реальні переваги​

Інтеграція приносить негайні та вимірювані вигоди для різних користувачів:

Для особистих фінансів:​

• Бюджетування: Дивіться точно, куди йдуть ваші гроші щомісяця.
• Цілі заощаджень: Візуалізуйте прогрес у створенні резервного фонду, відпустки чи пенсії.
• Моніторинг інвестицій: Слідкуйте за ефективністю портфеля та розподілом активів.

Для малого бізнесу:​

• Управління грошовим потоком: Контролюйте ліквідність компанії та розумійте патерни грошових потоків.
• Аналіз витрат: Аналізуйте витрати за підрозділами, проектами чи постачальниками.
• Фінансове планування: Використовуйте історичні дані для точнішого бюджету та прогнозування.

Для фінансових консультантів:​

• Презентації клієнтам: Створюйте професійні, зрозумілі фінансові звіти.
• Аналіз портфеля: Проводьте комплексний аналіз розподілу активів та відстеження ефективності.
• Відповідність вимогам: Підтримуйте детальні та доступні записи для аудиту та звітності.

Готові трансформувати своє фінансове життя?​

Ваш шлях до кращого фінансового управління починається зараз. Завдяки beancount-dashboard у вас є всі інструменти, необхідні для контролю над фінансами.

1. Відвідайте beancount.io
2. Створіть безкоштовний акаунт, щоб отримати доступ до повної екосистеми Beancount.
3. Приєднайтесь до тисяч користувачів, які вже впевнено керують своїми фінансами.

Ми цінуємо ваші відгуки​

Ваші враження надзвичайно важливі, коли ми вдосконалюємо платформу. Допоможіть нам стати кращими, ділячись історіями успіху з дашбордами, запитами на нові функції та будь‑якими звіти про помилки. Ви можете зв’язатися з командою Beancount.io через форум спільноти, GitHub Issues або в соціальних мережах.

Приєднуйтесь до активної спільноти​

Спілкуйтеся з іншими користувачами Beancount, діліться налаштуваннями дашбордів, вчіться у експертів та вносіть свій внесок. Будьте в курсі нових функцій і допомагайте формувати майбутнє фінансового управління.

Ця інтеграція — важливий крок уперед. Поєднавши потужний обліковий движок Beancount з візуалізаціями beancount-dashboard, ми надаємо корпоративну аналітику в пакеті з відкритим кодом та орієнтацією на приватність.

Готові революціонізувати відстеження фінансів? Зареєструйтесь на beancount.io сьогодні, випробуйте силу beancount-dashboard і разом будуймо майбутнє фінансового управління!

Основна функціональність та філософія Beancount​

Beancount — це система бухгалтерського обліку подвійного запису з відкритим вихідним кодом, яка використовує текстові файли для запису транзакцій. По суті, Beancount розглядає вашу бухгалтерську книгу як набір даних, визначений простою, суворою граматикою. Кожна фінансова подія (транзакції, відкриття рахунків, ціни на товари тощо) є директивою в текстовому файлі, яку Beancount аналізує та перетворює на базу даних записів у пам'яті. Ця архітектура забезпечує дотримання принципу подвійного запису: кожна транзакція повинна балансувати дебети та кредити між рахунками. Результатом є високопрозора та аудитована бухгалтерська книга, яку можна легко контролювати за версіями, перевіряти та запитувати.

Філософія – коректність та мінімалізм: Дизайн Beancount надає пріоритет цілісності даних та простоті. Його творець, Мартін Блейс, описує Beancount як "песимістичний", припускаючи, що користувач робитиме помилки, і тому накладає додаткові перевірки та обмеження. Наприклад, Beancount не дозволить вам видалити активи, які ніколи не були додані (запобігаючи від'ємним залишкам запасів або готівки), і може вимагати, щоб кожен рахунок був відкритий перед використанням. Йому бракує концепції "віртуальних" або автоматично збалансованих проводок Ledger – це свідомий вибір, щоб змусити використовувати повністю збалансовані записи. Beancount ефективно "йде напролом" у коректності, надаючи більше перехресних перевірок, ніж забезпечує базовий подвійний запис. Цей обережний підхід приваблює користувачів, які "не надто довіряють собі" і хочуть, щоб програмне забезпечення виявляло їхні помилки.

Мінімальні опції, максимальна послідовність: На відміну від безлічі прапорців командного рядка та параметрів налаштування Ledger, Beancount обирає мінімалізм. Існує дуже мало глобальних опцій, і жодна з них не змінює семантику транзакцій за межами файлу бухгалтерської книги. Всі конфігурації, що впливають на облік (наприклад, методи обліку собівартості товарів або припущення щодо обліку), виконуються у файлі за допомогою директив або плагінів, що гарантує, що завантаження одного й того ж файлу завжди дає однакові результати, незалежно від того, як генеруються звіти. Цей дизайн дозволяє уникнути складності численних налаштувань Ledger та тонких взаємодій між ними. Філософія Beancount полягає в тому, що інструмент обліку повинен бути стабільним, детермінованим конвеєром від вхідного файлу до звітів. Він досягає цього, розглядаючи бухгалтерську книгу як впорядкований потік директив, які можуть бути програмно оброблені послідовно. Навіть те, що Ledger розглядає як спеціальний синтаксис (наприклад, початкові залишки або заяви про ціни), є першокласними директивами в моделі даних Beancount, що робить систему дуже розширюваною.

Розширюваність за допомогою плагінів та мови запитів: Beancount реалізовано на Python і надає хуки для впровадження власної логіки в конвеєр обробки. Користувачі можуть писати плагіни на Python, які працюють з потоком транзакцій (наприклад, для застосування власного правила або генерації автоматичних записів). Ці плагіни запускаються під час обробки файлу, ефективно розширюючи основну функціональність Beancount без необхідності модифікації вихідного коду. Beancount також включає потужну мову запитів (на основі SQL) для аналізу та деталізації бухгалтерської книги. Інструмент bean-query розглядає проаналізовану бухгалтерську книгу як базу даних і дозволяє виконувати на ній аналітичні запити – наприклад, підсумовувати витрати за категоріями або витягувати всі транзакції для певного одержувача. У Beancount 3.x ця можливість запитів була перенесена в окремий пакет beanquery, але з точки зору користувача вона все ще забезпечує гнучку звітність за допомогою SQL-подібних запитів.

Простий текст та контроль версій: Як інструмент обліку на основі простого тексту, Beancount наголошує на контролі користувача та довговічності даних. Бухгалтерська книга – це просто текстовий файл .beancount, який можна редагувати в будь-якому текстовому редакторі. Це означає, що вся ваша фінансова історія зберігається в людиночитаному форматі, і ви можете розмістити її в Git або іншій VCS для відстеження змін з часом. Користувачі часто зберігають свій файл Beancount під контролем версій, щоб підтримувати аудиторський слід кожної зміни (з повідомленнями комітів, що описують зміни). Цей підхід відповідає філософії Beancount, згідно з якою облікові дані, особливо особисті фінанси або фінанси малого бізнесу, повинні бути прозорими та "стійкими до майбутніх змін" – не заблокованими у власницькій базі даних. За словами самого Мартіна Блейса, Beancount – це "плід праці", створений бути простим, довговічним та безкоштовним для спільноти. Він був вперше розроблений близько 2007 року і еволюціонував через значні переробки (з v1 до v2, а тепер v3 у 2024 році), щоб удосконалити свій дизайн, зберігаючи при цьому свою основну філософію мінімалізму та коректності.

Інструменти, Плагіни та Розширення в Екосистемі Beancount​

Екосистема Beancount розвинула багатий набір інструментів, плагінів та розширень, що покращують основну функціональність бухгалтерської книги. Вони охоплюють імпорт даних, редагування бухгалтерських книг, перегляд звітів та додавання спеціалізованих бухгалтерських функцій. Нижче наведено огляд ключових компонентів та додатків у світі Beancount:

Утиліти для імпорту даних (Імпортери)​

Однією з найважливіших потреб для практичного використання є імпортування транзакцій з банків, кредитних карток та інших фінансових установ. Beancount надає фреймворк для імпорту та скрипти для імпорту, надані спільнотою, для цієї мети. У Beancount 2.x вбудований модуль beancount.ingest (з командами, такими як bean-extract та bean-identify) використовувався для визначення плагінів імпортерів на Python та їх застосування до завантажених виписок. У Beancount 3.x це було замінено зовнішнім проєктом під назвою Beangulp. Beangulp — це спеціалізований фреймворк для імпортерів, який еволюціонував з beancount.ingest і тепер є рекомендованим способом автоматизації імпорту транзакцій для Beancount 3.0. Він дозволяє писати скрипти Python або інструменти командного рядка, які читають зовнішні файли (такі як виписки CSV або PDF) та виводять записи Beancount. Цей новий підхід відокремлює логіку імпорту від ядра Beancount – наприклад, стара команда bean-extract була видалена у версії 3, і натомість ваші скрипти імпорту самі генерують транзакції через інтерфейс командного рядка Beangulp.

Десятки готових імпортерів існують для різних банків та форматів, надані спільнотою. Існують скрипти імпортерів для установ по всьому світу – від Alipay та WeChat Pay у Китаї, до різних європейських банків (Commerzbank, ING, ABN AMRO тощо), до американських банків, таких як Chase та Amex. Багато з них зібрані у публічних репозиторіях (часто на GitHub) або в пакетах, таких як beancount-importers. Наприклад, проєкт Tarioch Beancount Tools (tariochbctools) надає імпортери для швейцарських та британських банків і навіть обробляє імпорт криптотранзакцій. Іншим прикладом є Lazy Beancount, який містить набір поширених імпортерів (для Wise, Monzo, Revolut, IBKR тощо) та надає налаштування на основі Docker для легкої автоматизації. Незалежно від того, який банк чи фінансовий сервіс ви використовуєте, ймовірно, хтось вже написав імпортер Beancount для нього – або ви можете написати свій власний, використовуючи фреймворк Beangulp. Гнучкість Python означає, що імпортери можуть обробляти парсинг файлів CSV/Excel, завантаження OFX/QIF або навіть скрапінг API, а потім генерувати транзакції у стандартизованому форматі Beancount.

Редагування та інтеграція з редакторами​

Оскільки бухгалтерські книги Beancount — це просто текст, користувачі часто використовують свої улюблені текстові редактори або IDE для їх ведення. Екосистема пропонує плагіни підтримки редакторів, щоб зробити цей досвід зручнішим. Існують розширення для багатьох популярних редакторів, які додають підсвічування синтаксису, автозаповнення назв рахунків та перевірку помилок у реальному часі:

• Режим Beancount для Emacs: Доступний основний режим Emacs (beancount-mode) для редагування файлів .beancount, що пропонує такі функції, як підсвічування синтаксису та інтеграцію з перевіркою Beancount. Він може навіть запускати bean-check у фоновому режимі, щоб помилки в бухгалтерській книзі (наприклад, незбалансована транзакція) позначалися під час редагування.
• Розширення VS Code: Розширення Beancount на VSCode Marketplace надає подібні зручності для користувачів Visual Studio Code. Воно підтримує підсвічування синтаксису, вирівнювання сум, автозаповнення для рахунків/одержувачів і навіть перевірку балансу на льоту при збереженні файлу. Воно також може інтегруватися з Fava, дозволяючи запускати веб-інтерфейс Fava з VSCode.
• Плагіни або режими також існують для Vim, Atom та інших редакторів. Наприклад, існує граматика Tree-sitter для Beancount, яка забезпечує підсвічування синтаксису в сучасних редакторах і навіть була прийнята у веб-компоненті редактора Fava. Коротко кажучи, незалежно від вашого середовища редагування, спільнота, ймовірно, надала плагін, щоб зробити редагування файлів Beancount зручним і безпомилковим.

Для швидкого введення транзакцій поза традиційними редакторами також існують такі інструменти, як Bean-add та мобільні додатки. Bean-add — це інструмент командного рядка, який дозволяє додавати нову транзакцію через запит або в один рядок, обробляючи пропозиції щодо дати та рахунку. На мобільних пристроях проєкт під назвою Beancount Mobile надає простий інтерфейс для введення транзакцій на ходу (наприклад, запис готівкової покупки з вашого телефону). Крім того, існує Telegram-бот Beancount для фіксації транзакцій через повідомлення — ви можете надіслати повідомлення з деталями транзакції, і бот відформатує його у файл вашої бухгалтерської книги.

Веб-інтерфейси та інструменти візуалізації​

(Fava) Веб-інтерфейс Fava надає інтерактивну панель інструментів для Beancount, що містить такі звіти, як звіт про прибутки та збитки з візуалізаціями (тут показано як деревоподібну діаграму витрат за категоріями) разом з таблицями рахунків та залишків.

Флагманським фронтендом для Beancount є Fava, сучасний веб-інтерфейс. Fava працює як локальний веб-додаток, який читає ваш файл Beancount і створює насичений інтерактивний досвід у вашому браузері. Він пропонує повний набір звітів: баланс, звіт про прибутки та збитки, чиста вартість з часом, склад портфеля, графіки ефективності, бюджети та багато іншого – все готове до використання. Користувачі часто називають Fava головною причиною вибору Beancount серед інших інструментів текстового обліку. За допомогою однієї команди (fava ledger.beancount) ви можете переглядати свої фінанси за допомогою графіків та таблиць замість тексту. Fava підтримує такі функції, як: деталізація рахунків, фільтрація транзакцій за отримувачем або тегом, редактор запитів (щоб ви могли виконувати запити Beancount та бачити результати в браузері), і навіть інтегрований веб-редактор для вашої книги обліку. Він дуже зручний у використанні, що робить текстовий облік доступним для тих, хто віддає перевагу візуальним інтерфейсам.

Під капотом Fava написана на Python (Flask на бекенді) та JavaScript (Svelte на фронтенді). Вона має власний цикл випуску та активно підтримується. Зокрема, Fava йшла в ногу з розробкою Beancount – наприклад, Fava 1.30 додала підтримку Beancount v3, перейшовши на використання нових пакетів beanquery та beangulp всередині. (Вона все ще підтримує Beancount 2 для старіших книг обліку.) Зосередженість Fava на зручності використання включає приємні дрібниці, такі як автозавершення у веб-редакторі, та елегантний інтерфейс користувача з темним режимом та адаптивними діаграмами. Існує також відгалуження під назвою Fava-GTK, яке пакує Fava в настільний додаток для користувачів GNOME/Linux, які віддають перевагу відчуттю нативного додатку.

Крім Fava, існують інші варіанти візуалізації та аналізу. Оскільки дані Beancount можуть бути експортовані або запитувані як таблиці, користувачі часто використовують такі інструменти, як Jupyter notebooks або Pandas для власного аналізу. Наприклад, один користувач описує витягування даних з Beancount через інтерфейс запитів у Pandas DataFrame для підготовки власного звіту. Існують також скрипти, надані спільнотою, для конкретних звітів – наприклад, інструмент аналізу розподілу портфеля або контрольна карта процесу для витрат порівняно з чистою вартістю. Однак, для більшості людей Fava надає більш ніж достатньо можливостей звітності без необхідності писати код. Вона навіть підтримує розширення: ви можете просто додати файли Python, які додають нові сторінки звітів або діаграми до Fava. Помітним розширенням є fava-envelope для конвертного бюджетування всередині Fava. Загалом, Fava слугує центральним вузлом візуалізації екосистеми Beancount.

Інструменти командного рядка та скрипти​

Beancount постачається з різноманітними інструментами командного рядка (особливо в старішій гілці v2, деякі з яких були скорочені у v3). Ці інструменти працюють з вашим файлом облікової книги для його перевірки або генерації певних звітів у текстовому форматі або HTML:

• bean-check: валідатор, який перевіряє файл на синтаксичні або бухгалтерські помилки. Запуск bean-check myfile.beancount повідомить вас про будь-який дисбаланс, відсутній рахунок або інші проблеми, і не виведе нічого, якщо файл не містить помилок.
• bean-format: форматувальник, який впорядковує вашу облікову книгу, вирівнюючи числа в акуратні стовпці, подібно до запуску форматувальника коду для вихідного коду. Це допомагає підтримувати файл чистим і читабельним.
• bean-query: інтерактивна оболонка або пакетний інструмент для виконання мови запитів Beancount у вашій обліковій книзі. Ви можете використовувати його для створення власних табличних звітів (наприклад, bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: універсальний генератор звітів (у v2), який може виводити попередньо визначені звіти (баланс, звіт про прибутки та збитки, пробний баланс тощо) на консоль або у файли. Наприклад, bean-report file.beancount balances виведе залишки на рахунках. (На практиці, багато з цих текстових звітів були замінені більш приємним представленням Fava.)
• bean-web / bean-bake: старіший веб-інтерфейс, який обслуговував звіти на localhost або "запікав" їх як статичні HTML-файли. Вони переважно використовувалися до того, як Fava стала популярною; bean-web надавав базовий веб-перегляд тих самих звітів, які міг генерувати bean-report. У Beancount 3 bean-web було видалено (оскільки Fava тепер є рекомендованим веб-інтерфейсом, що пропонує чудовий досвід).
• bean-example: утиліта для генерації прикладу файлу облікової книги (корисна для новачків, щоб побачити шаблон записів Beancount).
• bean-doctor: інструмент налагодження, який може діагностувати проблеми у вашій обліковій книзі або середовищі.

Варто зазначити, що станом на Beancount v3, багато з цих інструментів були винесені з основного проєкту. Основний пакет Beancount був оптимізований, а такі інструменти, як механізм запитів та імпортери, були розділені на окремі пакети (beanquery, beangulp тощо) для полегшення обслуговування. Наприклад, функціональність bean-query тепер надається інструментом beanquery, який встановлюється окремо. З точки зору користувача, функціональність залишається доступною; її просто було модулізовано. Спільнота Arch Linux відзначила цю зміну під час оновлення Fava: пакет Fava додав залежності від beanquery та beangulp для підтримки Beancount 3.x. Цей модульний підхід також дозволяє іншим членам спільноти робити внесок у ці допоміжні інструменти більш незалежно від циклу випуску Beancount.

Плагіни та розширення Beancount​

Однією з визначних переваг екосистеми Beancount є система плагінів. Додавши рядок plugin "module.name" до вашого файлу Beancount, ви можете інтегрувати власну логіку Python, яка виконується під час обробки книги. Спільнота створила багато плагінів для розширення можливостей Beancount:

• Якість даних та правила: Приклади включають beancount-balexpr, який дозволяє стверджувати рівняння за участю кількох рахунків (наприклад, Актив А + Актив Б = Зобов'язання X), та beancount-checkclosed, який автоматично вставляє твердження про баланс, коли ви закриваєте рахунок, щоб переконатися, що він дорівнює нулю. Існує навіть плагін для забезпечення сортування транзакцій у файлі за датою (autobean.sorted) для виявлення записів не за порядком.
• Автоматизація: Плагін beancount-asset-transfer може генерувати записи про перекази в натуральній формі між рахунками (корисно для переміщення акцій між брокерами зі збереженням бази витрат). Інший, autobean.xcheck, перевіряє вашу книгу Beancount на відповідність зовнішнім випискам щодо розбіжностей.
• Повторювані транзакції та бюджети: Плагін «repeat» або interpolate від Akuukis дозволяє визначати повторювані транзакції або розподіляти річні витрати на місяці. Для бюджетування розширення fava-envelope (використовується через Fava) підтримує методологію конвертного бюджетування у вигляді простого тексту. Існує також MiniBudget від Френка Девіса – невеликий автономний інструмент, натхненний Beancount, що допомагає з бюджетуванням для особистого використання або малого бізнесу.
• Податки та звітність: Деякі плагіни допомагають з податковим обліком, наприклад, той, що автоматично класифікує приріст капіталу на короткостроковий та довгостроковий. Інший (fincen_114 від Джастуса Пендлтона) генерує звіт FBAR для платників податків США з іноземними рахунками, ілюструючи, як дані Beancount можуть бути використані для регуляторної звітності.
• Репозиторії плагінів спільноти: Існують підібрані набори плагінів, такі як beancount-plugins (від Дейва Стівенса), що зосереджені на таких речах, як записи про амортизацію, та beancount-plugins-zack (від Стефано Заккіролі), які включають різноманітні допоміжні засоби, такі як сортування директив.

На додаток до плагінів, інші службові інструменти, що оточують Beancount, вирішують специфічні потреби. Наприклад, beancount-black – це автоматичний форматувальник, схожий на форматувальник коду Black, але для файлів книги Beancount. Існує Beancount Bot (Telegram/Mattermost) для додавання транзакцій через чат, як згадувалося, та робочий процес Alfred для macOS для швидкого додавання транзакцій до вашого файлу. Інструмент під назвою Pinto пропонує «потужний» інтерфейс командного рядка з інтерактивним введенням (як покращений bean-add). Для тих, хто мігрує з інших систем, існують конвертери (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount), які допомагають імпортувати дані з інших джерел.

Підсумовуючи, екосистема Beancount є досить розгалуженою. Таблиця 1 нижче перелічує деякі основні інструменти та розширення з їхніми ролями:

Порівняння з Ledger, hledger та подібними системами​

Beancount належить до сімейства інструментів обліку подвійного запису в текстовому форматі, серед яких виділяються Ledger CLI (Ledger Джона Віглі) та hledger. Хоча всі ці системи поділяють основну ідею текстових файлів обліку та подвійного запису, вони відрізняються синтаксисом, філософією та зрілістю екосистеми. Наступна таблиця висвітлює ключові відмінності між Beancount, Ledger та hledger:

Сценарії використання Beancount​

Beancount є достатньо універсальним, щоб використовувати його як для відстеження особистих фінансів, так і (в деяких випадках) для бухгалтерського обліку малого бізнесу. Його основний підхід подвійного запису є однаковим в обох сценаріях, але масштаб і конкретні практики можуть відрізнятися.

Особисті фінанси​

Багато користувачів Beancount використовують його для управління своїми особистими або сімейними фінансами. Типова конфігурація особистих фінансів у Beancount може включати рахунки для поточних та ощадних рахунків, кредитних карток, інвестицій, позик, категорій доходів (зарплата, відсотки тощо) та категорій витрат (оренда, продукти, розваги тощо). Користувачі записують щоденні транзакції або вручну (вводячи квитанції, рахунки тощо), або імпортуючи з банківських виписок за допомогою раніше обговорених інструментів імпорту. Переваги, які Beancount надає особистим фінансам, включають:

• Консолідація та аналіз: Усі ваші транзакції можуть зберігатися в одному текстовому файлі (або наборі файлів), що представляє роки фінансової історії. Це полегшує аналіз довгострокових тенденцій. За допомогою мови запитів Beancount або Fava ви можете за лічені секунди відповісти на запитання на кшталт «Скільки я витратив на подорожі за останні 5 років?» або «Який мій середній щомісячний рахунок за продукти?». Один користувач зазначив, що після переходу на Beancount, «аналіз фінансових даних (витрат, пожертвувань, податків тощо) є тривіальним» як через Fava, так і шляхом запитів до даних та використання таких інструментів, як Pandas. По суті, ваша бухгалтерська книга стає особистою фінансовою базою даних, яку ви можете запитувати за бажанням.
• Бюджетування та планування: Хоча Beancount не нав'язує систему бюджетування, ви можете її реалізувати. Деякі користувачі використовують конвертне бюджетування, створюючи бюджетні рахунки або використовуючи плагін fava-envelope. Інші просто використовують періодичні звіти для порівняння витрат із цільовими показниками. Оскільки це простий текст, інтеграція Beancount із зовнішніми інструментами бюджетування або електронними таблицями є простою (експорт даних або використання виводів CSV із запитів).
• Відстеження інвестицій та чистої вартості: Beancount чудово відстежує інвестиції завдяки надійній обробці собівартості та ринкових цін. Ви можете записувати купівлі/продажі акцій, криптовалюти тощо з деталями собівартості, а потім використовувати директиви Prices для відстеження ринкової вартості. Fava може відображати графік чистої вартості з часом та розбивку портфеля за класами активів. Це надзвичайно корисно для управління особистим капіталом – ви отримуєте інформацію, подібну до тієї, що надають комерційні інструменти, такі як Mint або Personal Capital, але повністю під вашим контролем. Обробка кількох валют також вбудована, тому, якщо ви тримаєте іноземні валюти або криптовалюту, Beancount може відстежувати їх та конвертувати для звітності.
• Звірка та точність: Особисті фінанси часто передбачають звірку з банківськими виписками. За допомогою Beancount можна регулярно звіряти рахунки, використовуючи твердження балансу або функцію документів. Наприклад, щомісяця ви можете додавати запис balance Assets:Bank:Checking <date> <balance>, щоб підтвердити, що ваша бухгалтерська книга відповідає банківській виписці на кінець місяця. Інструмент bean-check (або відображення помилок Fava) попередить вас, якщо щось не збігається. Один користувач згадує про щомісячну звірку всіх рахунків, що «допомагає виявити будь-яку незвичайну активність» – хороша практика гігієни особистих фінансів, яку полегшує Beancount.
• Автоматизація: Технічно підковані особи автоматизували значну частину свого робочого процесу особистих фінансів за допомогою Beancount. Використовуючи імпортери, завдання cron та, можливо, трохи Python, ви можете налаштувати свою систему так, щоб, наприклад, щодня ваші банківські транзакції завантажувалися (деякі використовують OFX або API) та додавалися до вашого файлу Beancount, класифіковані за правилами. З часом ваша бухгалтерська книга здебільшого оновлюється автоматично, і вам залишається лише переглядати та коригувати за потреби. Учасник спільноти на Hacker News поділився, що через 3 роки їхні бухгалтерські книги Beancount були «на 95% автоматичними». Такий рівень автоматизації можливий завдяки відкритості Beancount у простому тексті та можливостям сценаріїв.

Користувачі особистих фінансів часто обирають Beancount замість електронних таблиць або додатків, оскільки він надає їм повне володіння даними (без залежності від хмарного сервісу, який може припинити роботу – наприклад, як це сталося з Mint) і тому, що глибина аналізу більша, коли всі ваші дані інтегровані. Крива навчання є нетривіальною – потрібно вивчити основи бухгалтерського обліку та синтаксис Beancount – але такі ресурси, як офіційна документація та навчальні посібники спільноти, допомагають новачкам розпочати роботу. Після налаштування багато хто виявляє, що це приносить спокій, маючи чітку, надійну картину своїх фінансів у будь-який час.

Облік малого бізнесу​

Використання Beancount для малого бізнесу (або неприбуткової організації, клубу тощо) є менш поширеним, ніж для особистого використання, але це, безумовно, можливо, і деякі користувачі успішно це робили. Система подвійного запису Beancount насправді є тією ж системою, що лежить в основі корпоративного обліку, лише без деяких функцій вищого рівня, які надає спеціалізоване бухгалтерське програмне забезпечення (наприклад, модулі виставлення рахунків або інтеграції з розрахунком заробітної плати). Ось як Beancount може вписатися в контекст малого бізнесу:

• Головна книга та фінансова звітність: Малий бізнес може розглядати файл Beancount як свою головну книгу. Ви матимете рахунки активів для банківських рахунків, дебіторської заборгованості, можливо, запасів; рахунки зобов’язань для кредитних карток, позик, кредиторської заборгованості; власний капітал для капіталу власника; рахунки доходів для продажів або послуг; та рахунки витрат для всіх ділових витрат. Ведучи цю книгу, ви можете в будь-який час скласти Звіт про прибутки та збитки (Звіт про фінансові результати) та Баланс (Звіт про фінансовий стан), використовуючи звіти або запити Beancount. Фактично, вбудовані звіти Beancount або Fava можуть генерувати баланс та Звіт про прибутки та збитки за лічені секунди, які ідеально відповідають принципам бухгалтерського обліку. Цього може бути достатньо для невеликої операції, щоб оцінити прибутковість, фінансовий стан та грошовий потік (з невеликим запитом для грошового потоку, оскільки прямі звіти про рух грошових коштів не вбудовані, але можуть бути виведені).
• Рахунки-фактури та дебіторська/кредиторська заборгованість: Beancount не має вбудованої системи виставлення рахунків; користувачі зазвичай обробляють виставлення рахунків поза системою (наприклад, створюють рахунки-фактури в Word або додатку для рахунків-фактур), а потім записують результати в Beancount. Наприклад, коли ви виставляєте рахунок-фактуру, ви робите запис, дебетуючи рахунок дебіторської заборгованості та кредитуючи рахунок доходів. Коли надходить платіж, ви дебетуєте рахунок Готівка/Банк та кредитуєте рахунок дебіторської заборгованості. Таким чином, ви можете відстежувати непогашену дебіторську заборгованість, переглядаючи залишок на рахунку дебіторської заборгованості. Те саме стосується рахунків до сплати (кредиторської заборгованості). Хоча це більш ручний процес, ніж у спеціалізованому бухгалтерському програмному забезпеченні (яке може надсилати нагадування або інтегруватися з електронною поштою), це цілком можливо. Деякі користувачі ділилися шаблонами або робочими процесами щодо того, як вони керують рахунками-фактурами за допомогою Beancount та забезпечують, щоб вони не пропускали відкриті рахунки-фактури (наприклад, використовуючи метадані або користувацькі запити для переліку неоплачених рахунків-фактур).
• Запаси або собівартість реалізованої продукції: Для підприємств, що продають продукцію, Beancount може відстежувати закупівлі та продажі запасів, але це вимагає дисциплінованих записів. Ви можете використовувати функції Inventory (Запаси) та обліку витрат: купівля запасів збільшує рахунок активів (з вартістю, прив'язаною до товарів), продаж переміщує вартість у витрати (СОГС) та реєструє дохід. Оскільки Beancount наполягає на відповідності партій, він забезпечить належне зменшення запасів за правильною вартістю, що може фактично гарантувати точність ваших розрахунків валового прибутку, якщо все зроблено правильно. Однак, немає автоматичного відстеження SKU або чогось подібного – все відбувається на фінансовому рівні (кількість та вартість).
• Розрахунок заробітної плати та складні операції: Beancount може реєструвати операції з розрахунку заробітної плати (витрати на заробітну плату, утримання податків тощо), але розрахунок цих сум може здійснюватися зовнішньо або за допомогою іншого інструменту, а потім просто заноситися до

Спільнота та діяльність з розробки​

Beancount має віддану спільноту та історію розробки, що відображає його відкритий, нішевий, але пристрасний характер. Нижче наведено ключові моменти щодо його спільноти, мейнтейнерів та пов'язаних проєктів:

• Підтримка Проєкту: Основним автором Beancount є Мартін Блейс, який розпочав проєкт близько 2007 року і провів його через численні версії. Розробка протягом тривалого часу була переважно зусиллям однієї людини (окрім внесків спільноти у вигляді патчів). Філософія Мартіна полягала в створенні інструменту обліку, "корисного насамперед для мене, а також для інших, у найпростіший та найдовговічніший спосіб". Ця особиста мотивація підтримувала проєкт як працю з любові. Станом на 2025 рік Мартін Блейс все ще є провідним мейнтейнером (його ім'я з'являється в комітах, і він відповідає на запитання у списку розсилки/трекері проблем), але екосистема навколо Beancount має багато інших учасників у їхніх відповідних проєктах.

• GitHub та Репозиторії: Вихідний код розміщено на GitHub у репозиторії beancount/beancount. Проєкт ліцензований за GPL-2.0 і за роки залучив помірну кількість учасників. У середині 2024 року Beancount Версія 3 була офіційно випущена як нова стабільна гілка. Цей випуск передбачав розділення деяких компонентів: наприклад, репозиторій beangulp (для імпортерів) та репозиторій beanquery (для інструменту запитів) тепер є частиною організації beancount на GitHub, що підтримуються дещо незалежно. Основний репозиторій Beancount зосереджений на базовому обліковому двигуні та парсері файлів. Станом на 2025 рік GitHub Beancount показує активні обговорення проблем та деяку поточну розробку – хоча й невеликого обсягу, проблеми та запити на злиття надходять поступово, а періодичні оновлення вносяться для виправлення помилок або вдосконалення функцій.

• Розробка Fava: Fava, веб-інтерфейс, розпочався як окремий проєкт (створений Домініком Аумайром, який зареєстрував авторські права на нього у 2016 році). Він має власну спільноту учасників і також розміщений на GitHub під beancount/fava. Мейнтейнери та учасники Fava (наприклад, Якоб Шнец, Стефан Отте та інші в останні роки) активно вдосконалюють інтерфейс, випускаючи релізи кожні кілька місяців. Чат Fava на Gitter (посилання на документацію Fava) та трекер проблем GitHub – це місця, де користувачі та розробники обговорюють нові функції або помилки. Проєкт вітає внески, про що свідчить примітка в CHANGELOG, яка дякує численним членам спільноти за їхні PR. Тісне узгодження Fava з розробкою Beancount (таке як швидке додавання підтримки Beancount v3 та нового синтаксису beanquery) свідчить про хорошу співпрацю між двома проєктами.

• Списки Розсилки та Форуми: Beancount має офіційний список розсилки (раніше на Google Groups, під назвою "Beancount" або іноді обговорювався у загальному списку Ledger). Цей список розсилки є скарбницею знань – користувачі ставлять запитання про те, як моделювати певні сценарії, повідомляють про помилки та діляться порадами. Мартін Блейс відомий тим, що відповідає у списку розсилки з детальними поясненнями. Крім того, ширша спільнота Plain Text Accounting значно перетинається. Список розсилки Ledger CLI часто розглядає питання щодо Beancount, а також існує форум на plaintextaccounting.org та субреддіт r/plaintextaccounting, де часто з'являються теми Beancount. Користувачі на цих платформах обговорюють порівняння, діляться особистими налаштуваннями та допомагають новачкам. Загальний тон спільноти дуже співпрацюючий – користувачі Beancount часто допомагають користувачам Ledger і навпаки, визнаючи, що всі ці інструменти мають схожі цілі.

• Чат-групи: Окрім списків розсилки, існують чат-канали, такі як Plaintext Accounting Slack/Discord (організовані спільнотою) та Fava Gitter. Це менш формальні, більш оперативні способи отримати допомогу або обговорити функції. Наприклад, можна зайти в Slack, щоб запитати, чи є у когось імпортер для конкретного банку. Існує також канал Matrix/IRC (історично #ledger або #beancount на IRC), де перебувають деякі давні користувачі. Хоча ці канали не такі численні, як спільноти для масового програмного забезпечення, вони мають обізнаних людей, які часто можуть відповісти на незрозумілі бухгалтерські питання.

• Учасники та Ключові Члени Спільноти: Кілька імен виділяються у спільноті Beancount:

  • "Redstreet" (Red S): Плідний учасник, який написав багато плагінів (таких як beancount-balexpr, sellgains та інші) і часто надає підтримку. Він також підтримує набір скриптів-імпортерів та інструмент під назвою bean-download для отримання виписок.
  • Василь М (Evernight): Автор

Останні розробки та майбутні функції​

Станом на 2025 рік, екосистема Beancount зазнала значних розробок за останні кілька років, і тривають обговорення щодо майбутніх вдосконалень. Ось деякі важливі останні розробки та погляд на те, що може з'явитися:

• Випуск Beancount 3.0 (2024): Після тривалого періоду, коли Beancount 2.x був стандартом, версія 3 була офіційно випущена в середині 2024 року. Це була важлива віха, оскільки v3 представляє спрощення та модернізацію кодової бази. Мартін Блейс передбачав v3 як шанс "перегрупувати та спростити" систему далі. Хоча спочатку вважалося, що це буде велике переписування, на практиці оновлення для користувачів не було надто руйнівним. Основні зміни відбулися під капотом: новий парсер, деякі покращення продуктивності та виділення необов'язкових компонентів з ядра. Випуск впроваджувався поступово (v3 був у бета-версії з 2022 року, але до липня 2024 року він став рекомендованою стабільною версією). Користувачі, такі як Сіддхант Гоел, повідомили, що міграція з 2.x на 3.x була "переважно безпроблемною" лише з кількома змінами у робочому процесі.

• Модуляризація – інструменти переміщено в окремі пакети: Однією з великих змін у Beancount 3 є те, що багато інструментів, які раніше знаходилися в монолітному репозиторії, були виділені. Наприклад, bean-query тепер надається пакетом beanquery, а beancount.ingest було замінено пакетом beangulp. Команди, такі як bean-extract та bean-identify (для імпорту), були видалені з ядра Beancount. Натомість, філософія полягає у використанні окремих скриптів для імпорту. Це означає, що якщо ви оновитеся до v3, вам потрібно буде встановити beangulp та запускати скрипти імпорту (кожен імпортер – це, по суті, невелика програма), замість того, щоб мати центральний конфігураційний файл bean-extract. Аналогічно, запити виконуються через beanquery, який може встановлюватися та оновлюватися незалежно від ядра Beancount. Цей модульний підхід був розроблений для спрощення обслуговування та заохочення внесків спільноти. Він також зменшив ядро Beancount, тому ядро зосереджується виключно на логіці парсингу та обліку, тоді як допоміжна функціональність може розвиватися окремо. З точки зору користувача, після оновлення потрібно скоригувати команди (наприклад, використовувати bean-query з beanquery або використовувати Fava, яка все одно це абстрагує). Журнал змін Fava чітко зазначає ці зміни: Fava тепер залежить від beanquery та beangulp, і вона обробляє робочі процеси імпорту по-різному для Beancount 3 та 2.

• Покращення продуктивності: Продуктивність була однією з мотивацій для перегляду дизайну Beancount. План v3 (як викладено в документі Мартіна "Цілі V3") включав оптимізацію парсера та, можливо, прискорення процесу завантаження та зменшення споживання пам'яті. До 2025 року деякі з цих покращень були реалізовані. За словами користувачів, які мають дуже великі облікові книги (десятки тисяч транзакцій або багато операцій з акціями), вони повідомили про кращу продуктивність з останньою версією. Наприклад, користувач, який працює з "мікроінвестиційними транзакціями" і зіткнувся з проблемами продуктивності, зазначив ці занепокоєння в Google Group – такий зворотний зв'язок, ймовірно, вплинув на v3. Новий парсер є більш ефективним і написаний зрозуміліше, що може бути розширено в майбутньому. Крім того, Fava 1.29 перейшла на більш ефективний механізм відстеження файлів (використовуючи бібліотеку watchfiles) для покращення чуйності, коли змінюється облікова книга. Заглядаючи вперед, спільнота може дослідити інкрементальний парсинг (обробка лише змінених частин файлу замість всього) для швидшої обробки великих облікових книг – це було натякнуто в документації як ідея "сервера Beancount / інкрементального проведення операцій".

• Вдосконалення відстеження інвестицій: Триває робота над покращенням звітування про інвестиції та портфелі. Наприклад, детально обговорювалася обробка середньої собівартості проти FIFO. Хоча Beancount забезпечує відповідність партій, деякі користувачі віддають перевагу середній собівартості для певних юрисдикцій. Існує пропозиція та обговорення щодо того, щоб зробити проведення операцій за собівартістю більш гнучким (можливо, за допомогою плагіна або опції). До 2025 року вбудованого перемикача для середньої собівартості немає, але основа у v3 (переробка проведення операцій) полегшує реалізацію плагінами. Було випущено плагін спільноти "Gains Minimizer", який може пропонувати, які партії продати для мінімізації податків, показуючи тип розширених інструментів, що створюються навколо інвестицій. Fava також додала функції, такі як розширення зведення портфеля (з розрахунками норми прибутку). Щодо майбутніх функцій, можна очікувати більше в цій галузі: можливо, автоматичні пропозиції щодо ребалансування портфеля або аналіз ризиків, ймовірно, як зовнішні інструменти, які читають дані Beancount (оскільки всі дані є).

• Нові плагіни та розширення: Екосистема плагінів постійно зростає. Останні помітні доповнення включають:

  • Інструменти для звітування про бюджет – наприклад, простий CLI-звітник бюджету, якщо не використовується інтерфейс Fava.

  • Шифрування та безпека – було представлено налаштування fava-encrypt, що дозволяє розміщувати Fava онлайн із зашифрованою обліковою книгою в стані спокою, вирішуючи проблему самостійного розміщення ваших фінансів.

  • Плагіни для покращення якості життя – такі як autobean-format (новий форматер, який може обробляти більше особливих випадків шляхом парсингу та повторного друку файлу), та інтеграція beancheck в редакторах (flymake для Emacs).

    Заглядаючи вперед, спільнота, ймовірно, продовжить заповнювати прогалини за допомогою плагінів. Наприклад, ми можемо побачити більше плагінів, пов'язаних з податками (деякі користувачі поділилися скриптами для таких речей, як розрахунок фіктивних продажів або конкретних місцевих податкових звітів).

• Потенційні майбутні функції: На основі обговорень у трекері завдань та списку розсилки, на горизонті є кілька ідей (хоча не гарантовано):

  • Роздільна здатність часу: Наразі Beancount відстежує лише дати (без часових міток) для транзакцій. Були питання щодо додавання часу (для операцій з акціями або впорядкування транзакцій одного дня). Мартін Блейс чітко вирішив, що часові мітки в межах дня виходять за рамки, щоб зберегти простоту. Це навряд чи зміниться найближчим часом – тому майбутні версії, ймовірно, не додаватимуть роздільної здатності часу, дотримуючись позиції, що якщо вам потрібен час, ви включаєте його в опис або рахунок.
  • Покращене редагування графічного інтерфейсу: Fava постійно покращує свої можливості редагування. Можливим є більш повнофункціональний веб-редактор (з автозаповненням, можливо, введення нових транзакцій на основі форми). Було закладено основу для використання tree-sitter у редакторі Fava. Ми можемо побачити, як Fava стане не просто переглядачем, а більш потужним редактором, зменшуючи потребу взагалі відкривати текстовий редактор для багатьох завдань.
  • Краща підтримка кількох облікових книг: Деякі користувачі підтримують кілька файлів Beancount (для різних суб'єктів або для розділення особистих та ділових фінансів). Наразі включення файлів можливе, але мало обмеження (плагіни у включених файлах тощо). Нещодавно було створено плагін autobean.include для безпечного включення зовнішніх облікових книг. У майбутньому ми можемо побачити першокласну підтримку багатофайлових налаштувань – можливо, концепцію Beancount-«проєкту» з кількома файлами (на це натякають функції, такі як налаштування beancount.mainBeanFile розширення VSCode). Це допоможе тим, хто веде облік для кількох суб'єктів або хоче модуляризувати свою облікову книгу.
  • Обчислення в реальному часі або інкрементальне обчислення: Зі зростанням облікових книг здатність швидко перераховувати звіти стає важливою. Існує ідея сервера Beancount, який залишається запущеним і оновлює результати зі зміною транзакцій. Це може проявитися як оптимізація у Fava або демон, який плагіни редактора можуть запитувати. Можливо, майбутній випуск Fava використовуватиме безперервно працюючий процес Beancount, щоб зробити інтерфейс користувача більш чуйним для величезних облікових книг.
  • Облік фондів / функції для некомерційних організацій: Була пропозиція щодо вдосконалення обліку фондів у Beancount. Некомерційні організації мають облікові потреби (обмежені проти необмежених фондів), які потенційно можуть моделюватися за допомогою ієрархії тегів або рахунків Beancount. Обговорення ще не призвело до вбудованих функцій, але якщо більше некомерційних організацій почнуть використовувати Beancount, це може сприяти появі нових можливостей (можливо, просто задокументовані найкращі практики або плагіни для відстеження залишків фондів).

• Довгострокова перспектива: Мартін Блейс натякнув, що бачить майбутнє Beancount у перетворенні ядра на своєрідний двигун та перенесенні більшої функціональності до плагінів. Це відповідає тому, що ми бачимо (модуляризація у v3). Отже, "майбутня функція" у філософському сенсі – це більша розширюваність – можливо, навіть дозволяючи плагінам визначати нові типи директив або розширювати синтаксис контрольованими способами. Якщо це станеться, ядро Beancount може залишатися відносно невеликим і стабільним, тоді як екосистема надаватиме більшість нових функцій як доповнення. Це може призвести до маркетплейсу плагінів або більш централізованого списку плагінів, щоб користувачі могли вибирати (список Awesome Beancount є початком цього).

На завершення, екосистема Beancount у 2025 році є активною та розвивається. Випуск Beancount 3.0 став важливою останньою подією, що забезпечила міцну основу проєкту на майбутнє. Покращення продуктивності, інструментів та зручності використання (особливо через Fava) продовжували знижувати поріг входу. Хоча Beancount залишається інструментом, який вимагає певних знань, він набагато доступніший зараз, ніж кілька років тому, завдяки цим розробкам. Майбутні функції, ймовірно, зосереджуватимуться на удосконаленні досвіду – швидша продуктивність, кращі інтеграції та спеціалізовані розширення – а не на кардинальних змінах до основної філософії. Траєкторія розвитку спільноти св

Beancount, система бухгалтерського обліку за подвійним записом, яку люблять як розробники, так і фінансові ентузіасти, потужна у своїй простоті. Але для тих, хто прагне більшого контролю та швидшої навігації всередині Fava, вебінтерфейсу Beancount, користувацькі посилання бічної панелі та SQL-запити можуть вивести ваш робочий процес на новий рівень.

У цьому посібнику ми покажемо вам, як:

• Додавати посилання швидкого доступу до бічної панелі Fava
• Використовувати SQL-запити для розширеної фільтрації та аналізу
• Налаштовувати свій робочий процес для щомісячних оглядів або виявлення аномалій

Навіщо налаштовувати Fava?​

Fava вже є чудовим інтерфейсом для перегляду вашої бухгалтерської книги Beancount, але зі зростанням вашого журналу зростає і потреба в кращих ярликах та розумніших запитах.

Проблеми, які це вирішує:​

• Повторна навігація за часовими діапазонами
• Фільтрація транзакцій за вкладеними рахунками
• Швидше виявлення від'ємних залишків або аномалій

✨ Користувацькі посилання бічної панелі​

Почнімо з покращення вашого щоденного робочого процесу за допомогою простих ярликів бічної панелі. Ці посилання з'являються в лівій бічній панелі Fava і можуть перевести вас безпосередньо до відфільтрованих переглядів, таких як транзакції цього місяця або дохід минулого місяця.

Додайте ці рядки до вашого файлу Beancount:

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

Що вони роблять:​

• Поточний місяць: Відкриває перегляд транзакцій, відфільтрованих за поточним місяцем.
• Минулий місяць: Миттєво переходить до попереднього місяця — чудово для оглядів наприкінці місяця.
• Очистити все: Скидає фільтри, знову показуючи всі записи.

Ці ярлики усувають ручне введення часу та роблять ваш досвід роботи з Fava більш гнучким та персоналізованим.

🔍 Користувацькі SQL-запити​

Для глибшого аналізу SQL-інтерфейс Fava є неймовірно потужним. Ось запит, який знаходить усі від'ємні залишки на рахунках, що відповідають шаблону — ідеально для позначення незвичайних або проблемних транзакцій.

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
  AND account ~ '.*:BCM:.*'
  AND date >= DATE(2021,12,9)
  AND date < DATE(2022,1,9)

Розбір:​

• account ~ '.*:BCM:.*': Фільтрує рахунки, що містять :BCM: у своїй назві.
• number(units(position)) < 0: Позначає від'ємні залишки (наприклад, перевищені бюджети).
• Фільтри дати звужують результат до певного 1-місячного вікна.

Варіанти використання:​

• Виявлення помилок, таких як дубльовані витрати або неправильні проводки
• Проведення аудиту конкретного постачальника або категорії
• Швидке отримання дієвих висновків для бюджетування

🛠 Професійна порада: Комбінуйте посилання + запити​

Хоча Fava не дозволяє прямих посилань на користувацькі запити, ви можете створити звичку щомісячного огляду, зробивши наступне:

• Використовуючи посилання "Поточний місяць", щоб розпочати свій огляд
• Відкриваючи вкладку збережених запитів в іншій панелі
• Одночасно переглядаючи обидва — спочатку фільтруйте, потім заглиблюйтесь

Ця комбінація допомагає вам виявляти аномалії до того, як вони розростуться, і забезпечувати чистоту вашої бухгалтерської книги.

Заключні думки​

Beancount за задумом є мінімалістичним, але невеликі покращення, подібні до цих, приносять величезні вигоди в ефективності. Незалежно від того, чи переглядаєте ви свій бюджет, налагоджуєте дивні залишки або просто економите кліки, користувацькі посилання та SQL-запити дають вам більше можливостей та менше перешкод.

Бонус: Якщо ви використовуєте користувацькі звіти Fava, ви можете навіть створювати повноцінні інформаційні панелі, адаптовані до ваших ритуалів особистих фінансів.

Готові взяти під контроль?

Почніть з малого: додайте посилання "Поточний місяць". Потім створюйте власні запити. Ваше майбутнє "я" подякує вам.

Хочете більше таких порад? Підпишіться на нашу розсилку новин або досліджуйте більше рецептів Beancount на Beancount.io.

Ми оновили програмне забезпечення Fava з відкритим кодом, ліцензоване за MIT, до версії 1.19. Ось зміни з моменту нашого останнього оновлення:

• v1.19 (18.05.2021)
  • міграція з опцій conversion та interval на опцію default-page
  • додано опцію invert-income-liabilities-equity
  • оновлення до CodeMirror 6
  • додано болгарський переклад
  • інші невеликі покращення та виправлення помилок
• v1.18 (16.01.2021)
  • кілька невеликих покращень та різні виправлення помилок.

Відчуваєте захоплення? Спробуйте зараз за посиланням https://beancount.io/ledger/

Маєте запитання? Ми будемо поруч з вами за посиланням https://t.me/beancount :)

Амортизація розподіляє платежі на багато частин протягом певного часу. У beancount.io ви можете використовувати плагін fava.plugins.amortize_over для досягнення цієї мети.

Без амортизації, якщо ви хочете застрахувати свій автомобіль на 6 місяців вартістю $600, вам доведеться записати це як одноразову витрату на певну дату.

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto


2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

Однак, за допомогою амортизації ви можете розподілити витрати на шість місяців, додавши plugin "fava.plugins.amortize_over" на початку файлу та використовуючи amortize_months: 6 для транзакції.

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

І тоді в Журналі ви побачите, що транзакція розділена на 6 проводок.

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am

Підтримка безпечного та продуктивного онлайн-сервісу — це не одноразова справа. Це вимагає зусиль не лише для розробки нових функцій, а й для оновлення існуючих.

Застаріле програмне забезпечення наражає наших клієнтів на ризик вразливостей безпеки. Як ми зменшуємо цей ризик? З одного боку, ми проактивно співпрацюємо з дослідниками безпеки, щоб знаходити та вирішувати несподівані проблеми. З іншого боку, ми періодично інтегруємо найновіші версії вихідного програмного забезпечення.

Сьогодні ми раді поділитися деякими покращеннями, які ми зробили для Beancount.io.

1. Ми оновили сервер і прискорили роботу сервісу до 30%. Доступність сервісу також значно покращилася.
2. Ми оновили програмне забезпечення Fava з відкритим вихідним кодом, ліцензоване MIT, до версії 1.17. Воно виправляє різні помилки та додає багато нових функцій.

Відчуваєте захоплення? Спробуйте зараз на https://beancount.io/ledger/

Маєте запитання? Ми будемо поруч з вами на https://t.me/beancount :)