Awesome Beancount

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

Чому бухгалтерський облік у простому текстовому форматі?​

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

• Офіційний хаб PTA: Plain Text Accounting
• Лагідний вступ: Бухгалтерський облік для простих розумів за допомогою PTA
• Від вебдодатків до CLI: Бухгалтерський облік у командному рядку: Від mint.com до Ledger

Екосистема Beancount​

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

1. Основний рушій та офіційні ресурси​

Це основоположні елементи Beancount, які підтримуються автором та офіційними контриб'юторами.

2. Інтерфейси користувача​

Ці інструменти надають візуальні інтерфейси для вивчення та редагування ваших фінансових даних.

3. Імпорт транзакцій​

Імпорт — це процес перетворення даних із фінансових установ (наприклад, банківських CSV або PDF-файлів) у записи Beancount.

Спільнотні імпортери (за країнами)​

Велика колекція скриптів для конкретних банків та сервісів, що підтримується спільнотою.

• Китай
  • Alipay / 支付宝: deb-sig/double-entry-generator, wzyboy/importer
  • China Merchants Bank (CMB): Дебетова картка, Кредитна картка
  • WeChat Pay / 微信支付: deb-sig/double-entry-generator
• Франція
  • Caisse d'Epargne: beancount-ce
  • Boursorama, Amex: Beancount-myTools
• Німеччина
  • Commerzbank: beancount-commerzbank
  • Deutsche Kredit Bank (DKB): beancount-dkb
  • ING: beancount-ing
  • N26: beancount-n26
  • Volksbank & GLS-Bank: beancount-importer-volksbank
• Індія
  • SBI, BOI, Paytm, HSBC, ICICI: beancount-importers-india
• Нідерланди
  • ABN AMRO: beancount-abnamro
• Швейцарія
  • Загальні: tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  • Finpension: drnuke-bean
  • PostFinance: tariochbctools, drnuke-bean
• Велика Британія
  • Monzo, Revolut, Wise: Evernight/beancount-importers
  • Revolut, Wise: tariochbctools
• США
  • Amex, Chase, Citi, Schwab: mterwill/gist
  • Capital One: mtlynch/beancount-capitalone
  • Chase: mtlynch/beancount-chase-bank, ArthurFDLR/beancount-chase
  • Clipper: beancount-clipper
  • Mercury: mtlynch/beancount-mercury
• Блокчейн
  • tariochbctools

4. Підтримка редакторів та інструментарій​

Інструменти, які інтегрують Beancount у ваше середовище розробки для спрощення редагування та обслуговування.

• Підтримка IDE: Плагіни, що забезпечують підсвічування синтаксису, автодоповнення та перевірку балансу «на льоту».
  • VSCode
  • Emacs
  • Vim
  • Zed
  • Sublime Text
  • Atom
  • Beancount Language Server (для будь-якого LSP-сумісного редактора)
• Автоматизація та утиліти:
  • bean-add: Інтерактивне додавання транзакцій через командний рядок.
  • beancount-black: Безкомпромісний форматувальник коду для файлів Beancount.
  • beancount-categorizer: Автоматична категоризація транзакцій за допомогою правил регулярних виразів.
  • beanahead: Керування та прогнозування майбутніх транзакцій.
• Інструменти міграції даних: Утиліти для конвертації даних з інших систем обліку.
  • З GnuCash: henriquebastos/gc-to-bc, dtrai2/gc-to-bc
  • З Ledger/hledger: travisdahlke/gist, zacchiro/ledger2beancount
  • З YNAB: hoostus/beancount-ynab

5. Плагіни (Розширення книги)​

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

• Бюджетування:
  • fava-envelope: Розширення Fava для бюджетування за методом конвертів.
• Автоматизація та перевірки:
  • autobean.share: Розподіл витрат та управління боргами.
  • autobean.sorted: Забезпечує хронологічний порядок транзакцій.
  • beancount-checkclosed: Автоматична перевірка нульового балансу на закритих рахунках.
• Маніпуляції з даними:
  • autobean.narration: Автоматична генерація описів транзакцій.
  • beancount-lazy-plugins.filter_map: Застосовує операції до відфільтрованої групи транзакцій.

6. Джерела цін​

Скрипти, що отримують історичні та поточні ціни на товари, акції та валюти для відстеження вартості інвестицій.

• beancount-exchangerates: Для фіатних валют через API, такі як frankfurter.dev.
• pricehist: Інструмент для отримання цін з багатьох джерел.
• beancount-cryptoassets: Для отримання цін на криптовалюти.
• tariochbctools: Включає джерело цін для Interactive Brokers.

Навчання та спільнота​

Книги та поглиблені посібники​

• Tracking Personal Finances using Python: Книга, що містить вичерпний посібник зі створення системи управління особистими фінансами за допомогою Beancount. (Вебсайт)
• Серія блогів китайською мовою (BYVoid): Частина 1: Чому?, Частина 2: Дебет і Кредит

Вибрані дописи в блогах​

• Англійською
  • Рахуємо боби — і не тільки — з Beancount
  • Управління особистими фінансами за допомогою Python
  • Прямий вступ до Beancount
• Французькою
  • Beancount або бухгалтерський облік для хакерів
• Китайською
  • Beancount —— 命令行复式簿记

Спільнота​

• Список розсилки: Google Groups (Основний форум для обговорення)
• Живий чат (IRC): #beancount на web.libera.chat
• Telegram (китайською): t.me/beancount_zh

Комерційні послуги та додатки​

Для користувачів, які хочуть використовувати можливості Beancount, не займаючись керуванням інфраструктурою самостійно.