Страхотен Beancount
Подбрано ръководство за екосистемата на Beancount. Beancount е мощна, отворена счетоводна система, която използва прост, текстово-базиран формат за управление на вашите финанси със стриктността на двустранното счетоводство. Тази страница съчетава курирани от общността списъци и прегледи на екосистемата в един цялостен ресурс.
Защо счетоводство с обикновен текст?
Счетоводството с обикновен текст (PTA) е методология за управление на финанси, използваща прости текстови файлове и мощни инструменти от командния ред. Този подход ви дава пълна собственост върху данните ви, осигурява дълготрайност и предлага несравнима гъвкавост за автоматизация и анализ.
- Официален PTA център: Plain Text Accounting
- Кратко въведение: Accounting for the simple minds with plain text accounting
- От уеб приложения до CLI: Command line accounting: From mint.com to Ledger
Екосистемата на Beancount
Екосистемата на Beancount е колекция от инструменти, плъгини и ресурси, изградени около основен двигател. Всеки компонент играе специфична роля в създаването на цялостен работен процес за финансово управление.
1. Основен двигател и официални ресурси
Това са основните елементи на Beancount, поддържани от създателя и официалните сътрудници.
| Ресурс | Описание |
|---|---|
| Beancount (Ядро) | Двигателят, който чете вашия счетоводен файл, прилага правила за двустранно счетоводство и генерира отчети. Той предоставя основни помощни програми от командния ред като bean-check и bean-format. Всички други инструменти са изградени върху него. |
| Начална страница | beancount.github.io |
| Изходен код | github.com/beancount/beancount |
| Документация | GitHub Pages и Google Docs |
| Външни приноси | Официален списък с приноси от общността |
| Beanquery | Мощен, подобен на SQL инструмент за заявки (v3) за стартиране на разширени заявки (напр. SELECT ... FROM ... WHERE ...) към вашия счетоводен файл за генериране на персонализирани анализи. |
2. Потребителски интерфейси
Тези инструменти предоставят визуални интерфейси за изследване и редактиране на вашите финансови данни.
| Инструмент | Описание |
|---|---|
| Fava | Окончателното, пълнофункционално уеб табло за Beancount. То предоставя интерактивни диаграми, подробни таблици, редактиране в браузъра и система от разширения за добавяне на функции като бюджетиране. |
| Fava-GTK | Нативно GNOME Desktop приложение, което обвива Fava за безпроблемно настолно изживяване. |
| Beancount Mobile | Мобилно приложение за въвеждане на данни за добавяне на транзакции в движение. |
| Beancount Telegram Bot | Telegram бот за бързо добавяне на транзакции към вашия счетоводен файл чрез чат. |
3. Импортиране на транзакции
Импортирането е процес на конвертиране на данни от финансови институции (като банкови CSV или PDF файлове) в записи на Beancount.
| Инструмент | Описание |
|---|---|
| Beangulp (v3) | Модерната, самостоятелна рамка за изграждане на импортери. Тя обработва външни файлове чрез Python скриптове (плъгини), за да генерира директиви на Beancount. |
| Smart Importer | Инструмент, който обогатява импортерите с машинно обучение за автоматично прогнозиране и присвояване на категории. |
| Beancount Reds Ingestor | Колекция от импортери с обща библиотека за обработка на CSV и OFX файлове. |
| double-entry-generator | Базиран на правила импортер, фокусиран върху китайски услуги като Alipay и WeChat Pay. |
Импортери на общността (по държави)
Огромна колекция от скриптове за конкретни банки и услуги, поддържани от общността.
- Китай
- 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
- Блокчейн
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. Плъгини (Разширения на главната книга)
In-ledger 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.
Обучение и общност
Книги и подробни ръководства
- Проследяване на лични финанси с Python: Книга, която предоставя изчерпателно ръководство за изграждане на система за лични финанси с Beancount. (Уебсайт)
- Поредица от китайски блогове (BYVoid): Част 1: Защо?, Част 2: Дебити и кредити
Избрани публикации в блогове
- Английски
- Френски
- Китайски
Общност
- Пощенски списък: Google Groups (Основен дискусионен форум)
- Чат на живо (IRC): #beancount on web.libera.chat
- Telegram (китайски): t.me/beancount_zh
Търговски услуги и приложения
За потребители, които искат силата на Beancount, без да управляват инфраструктурата сами.
| Услуга | Описание |
|---|---|
| Beancount.io | SaaS (Софтуер като услуга) платформа, предоставяща готова Beancount и Fava инстанция. Тя също така предлага специализирани мобилни приложения за iOS и Android. |