Преминете към основното съдържание

Awesome Beancount

Подбран наръчник за екосистемата на Beancount. Beancount е мощна система за счетоводство с отворен код, която използва прост, текстово базиран формат за управление на вашите финанси със стриктността на двустранното счетоводство. Тази страница съчетава списъци, подбрани от общността, и прегледи на екосистемата в един изчерпателен ресурс.

Защо счетоводство в обикновен текст?

Счетоводството в обикновен текст (Plain text accounting - PTA) е методология за управление на финансите чрез обикновени текстови файлове и мощни инструменти за команден ред. Този подход ви дава пълна собственост върху вашите данни, гарантира дълготрайност и предлага несравнима гъвкавост за автоматизация и анализ.


Екосистемата на 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, което обвива Fava за безпроблемно изживяване на десктоп.
Beancount MobileМобилно приложение за въвеждане на данни за добавяне на транзакции в движение.
Beancount Telegram BotTelegram бот за бързо добавяне на транзакции към вашата главна книга чрез чат.

3. Импортиране на транзакции

Импортирането е процесът на конвертиране на данни от финансови институции (като банкови CSV или PDF файлове) в записи за Beancount.

ИнструментОписание
Beangulp (v3)Модерната, самостоятелна рамка за изграждане на импортьори. Обработва външни файлове чрез Python скриптове (плъгини) за генериране на директиви за Beancount.
Smart ImporterИнструмент, който допълва импортьорите с машинно обучение за автоматично предвиждане и задаване на категории.
Beancount Reds IngestorКолекция от импортьори с обща библиотека за работа с CSV и OFX файлове.
double-entry-generatorИмпортьор, базиран на правила, фокусиран върху китайски услуги като Alipay и WeChat Pay.

Импортери от общността (по държави)

Богата колекция от скриптове за конкретни банки и услуги, поддържана от общността.

4. Поддръжка за редактори и инструменти

Инструменти, които интегрират Beancount във вашата среда за разработка, за да улеснят редактирането и поддръжката.

  • Поддръжка за IDE: Плъгини, предоставящи подчертаване на синтаксиса, автоматично довършване и проверка на баланса в реално време.
  • Автоматизация и помощни инструменти:
    • bean-add: Интерактивно добавяне на трансакции от командния ред.
    • beancount-black: Стриктен инструмент за форматиране на код за Beancount файлове.
    • beancount-categorizer: Автоматично категоризиране на трансакции с правила чрез регулярни изрази (regex).
    • beanahead: Управление и прогнозиране на бъдещи трансакции.
  • Инструменти за миграция на данни: Помощни програми за конвертиране на данни от други счетоводни системи.

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.

Обучение и общност

Книги и подробни ръководства

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

Избрани публикации в блогове

Общност


Търговски услуги и приложения

За потребители, които искат мощта на Beancount, без да управляват инфраструктурата сами.

УслугаОписание
Beancount.ioSaaS (софтуер като услуга) платформа, предоставяща готова инстанция на Beancount и Fava. Предлага също и специализирани мобилни приложения за iOS и Android.