6 записей с тегом "fava"

We're excited to announce a major enhancement to the Beancount.io ecosystem: the official integration of beancount-dashboard. This powerful new feature brings a suite of rich, interactive visualizations directly into Fava, allowing you to see your financial story in a clear, compelling, and actionable way.

What is beancount-dashboard?​

beancount-dashboard is an open-source plugin for Fava, the web interface for Beancount. It transforms your plain-text financial data into dynamic and insightful dashboards, making it easier than ever to understand your financial health and make informed decisions.

The plugin provides a wide range of powerful visualizations:

• 📊 Comprehensive Asset Views: Track your wealth with a Net Worth Line Chart, monitor performance with detailed Portfolio Tracking, and visualize your distribution with Asset Allocation pie charts.
• 💰 Income & Expenses Analytics: Understand your cash flow with precision. Analyze Monthly Averages, break down spending by Category, and see how your habits have changed with Year-over-Year Analysis.
• ✈️ Travel Cost Management: Track annual travel costs and analyze spending patterns by destination to budget more effectively for future trips.
• 🔄 Sankey Diagrams: Visualize the flow of your money with interactive charts that show how funds move between income sources, accounts, and expense categories.
• 📈 Financial Projections: Plan for the future by using your historical data to set goals and project your financial trajectory.

Why We Integrated beancount-dashboard​

This integration is a game-changer for the Beancount community, offering four key benefits:

1. Enhanced User Experience​

Beancount is built on a robust foundation of double-entry bookkeeping, but raw data can be overwhelming. The beancount-dashboard plugin transforms complex ledgers into intuitive visualizations, making financial management accessible and engaging for everyone.

2. Better Financial Decision Making​

Visual dashboards empower you to make smarter financial choices. They help you identify trends, optimize budgets, track goals, and plan ahead with confidence by presenting your data in an easy-to-digest format.

3. Professional-Grade Analytics​

This integration brings enterprise-grade analytical power to your fingertips. Powered by Apache ECharts, the dashboards offer interactive charts, custom views, and real-time updates that reflect your latest transactions. Its responsive design ensures a seamless experience on any device.

4. Open-Source Excellence​

Both Beancount and beancount-dashboard are committed to open-source principles. This means you get complete transparency in how your data is handled, the assurance of privacy (since your data stays on your own infrastructure), and the support of an active and innovative community.

Real-World Benefits​

This integration provides immediate and tangible benefits for various users:

For Personal Finance:​

• Budgeting: See exactly where your money goes each month.
• Savings Goals: Visualize your progress toward an emergency fund, a vacation, or retirement.
• Investment Monitoring: Keep a close eye on your portfolio performance and asset allocation.

For Small Businesses:​

• Cash Flow Management: Monitor business liquidity and understand cash flow patterns.
• Expense Analysis: Analyze business costs by department, project, or vendor.
• Financial Planning: Use historical data for more accurate budgeting and forecasting.

For Financial Advisors:​

• Client Presentations: Create professional, easy-to-understand financial reports.
• Portfolio Analysis: Conduct comprehensive asset allocation and performance tracking.
• Compliance: Maintain detailed and accessible records for auditing and reporting.

Ready to Transform Your Financial Life?​

Your journey to better financial management starts now. With the power of beancount-dashboard, you have all the tools you need to take control of your finances.

1. Visit beancount.io
2. Create your free account to access the complete Beancount ecosystem.
3. Join thousands of users already managing their finances with confidence.

We Want Your Feedback​

Your insights are invaluable as we continue to refine our platform. Help us improve by sharing your dashboard success stories, feature requests, and any bug reports you encounter. You can connect with the Beancount.io team through our Community Forums, GitHub Issues, or on social media.

Join a Thriving Community​

Connect with fellow Beancount users to share dashboard configurations, learn from experts, and contribute your own knowledge. Stay updated on new features and help shape the future of financial management.

This integration represents a significant step forward. By combining Beancount's robust accounting engine with the powerful visualizations of beancount-dashboard, we are providing enterprise-grade analytics in an open-source, privacy-focused package.

Ready to revolutionize your financial tracking? Register at beancount.io today, experience the power of beancount-dashboard, and help us build the future of financial management together!

Основные функции и философия 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, и вместо этого ваши скрипты импорта сами генерируют транзакции через CLI-интерфейс 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 для их ведения. Экосистема предлагает плагины поддержки редакторов, чтобы сделать этот процесс более удобным. Существуют расширения для многих популярных редакторов, которые добавляют подсветку синтаксиса, автозаполнение названий счетов и проверку ошибок в реальном времени:

• Emacs Beancount-Mode: Основной режим 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 предоставляет простой интерфейс для ввода транзакций на ходу (например, запись покупки наличными с вашего телефона). Кроме того, существует Бот Beancount для Telegram для захвата транзакций через сообщения — вы можете отправить сообщение с деталями транзакции, и бот отформатирует его в ваш файл учетной книги.

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

(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 поставляется с различными CLI-инструментами (особенно в старой ветке 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, который позволяет утверждать уравнения, включающие несколько счетов (например, Актив A + Актив B = Обязательство 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 (Telegram/Mattermost) для добавления транзакций через чат, как упоминалось, и рабочий процесс Alfred для macOS для быстрого добавления транзакций в ваш файл. Инструмент под названием Pinto предлагает «усовершенствованный» CLI с интерактивным вводом (подобно улучшенному bean-add). Для тех, кто переходит с других систем, существуют конвертеры (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount), которые помогают импортировать данные из других источников.

Таким образом, экосистема Beancount весьма обширна. Таблица 1 ниже перечисляет некоторые основные инструменты и расширения с их ролями:

| Converters (Migration tools) | Утилиты для конвертации данных из других форматов в Beancount, например, из GnuCash или Ledger CLI в формат Beancount. Облегчают внедрение Beancount без необходимости начинать с нуля. |

Сравнение с Ledger, hledger и аналогичными системами​

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

| Аспект | Beancount (Python)

Сценарии использования 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. Для очень малого бизнеса (например, с одним или двумя сотрудниками) это управляемо. Вы бы, например, записывали одну бухгалтерскую проводку за каждый расчетный период, которая разделяет заработную плату, удержанные налоги, расходы работодателя на налоги, выплаченные денежные средства и т. д. Выполнение этого вручную похоже на то, как это делается в бухгалтерских проводках QuickBooks – это требует знания того, какие счета задействовать.
• Многопользовательский режим и аудит: Одной из проблем в бизнес-среде является ситуация, когда нескольким людям нужен доступ к бухгалтерским книгам или когда бухгалтеру необходимо их проверить. Поскольку Beancount является текстовым файлом, он не поддерживает многопользовательский режим в реальном времени. Однако размещение файла в репозитории Git может обеспечить совместную работу: каждый человек может редактировать и фиксировать изменения, а различия могут быть объединены.
• Соблюдение нормативных требований: Для подачи налоговой отчетности или соблюдения нормативных требований данные Beancount могут быть использованы для генерации необходимых отчетов, но это может потребовать пользовательских запросов или плагинов. Мы видели пример плагина сообщества для отчетности по требованиям индийского правительства и один для отчетности FinCEN FBAR. Это показывает, что при определенных усилиях Beancount может быть адаптирован для удовлетворения конкретных требований к отчетности. Малые предприятия в юрисдикциях с простыми требованиями (кассовый метод учета или базовый метод начисления) безусловно могут вести учет в Beancount и формировать финансовую отчетность для налоговых деклараций. Однако такие функции, как графики амортизации или амортизация нематериальных активов, могут потребовать от вас самостоятельного ввода записей или использования плагина (например, плагины амортизации Дэйва Стивенса помогают автоматизировать это). Нет графического интерфейса для «нажатия кнопки амортизации актива», как в некоторых бухгалтерских программах; вы бы кодировали амортизацию как транзакции (что в некотором смысле демистифицирует ее – каждая запись является тем, что вы можете проверить).

На практике многие технически подкованные владельцы малого бизнеса использовали Beancount (или Ledger/hledger), если они предпочитают контроль и прозрачность удобству QuickBooks. В обсуждении на Reddit отмечалось, что для стандартного учета малого бизнеса с ограниченным объемом транзакций Beancount работает отлично. Ограничивающим фактором обычно является уровень комфорта – насколько владелец бизнеса (или его бухгалтер) чувствует себя комфортно с текстовым инструментом. Одним из преимуществ является стоимость: Beancount бесплатен, тогда как бухгалтерское программное обеспечение может быть дорогостоящим для малого бизнеса. С другой стороны, отсутствие официальной поддержки и характер «сделай сам» означают, что он лучше всего подходит для тех, кто является одновременно владельцем бизнеса и в некоторой степени технически подкован. Для фрилансеров или индивидуальных предпринимателей с навыками программирования Beancount может быть привлекательным выбором для управления финансами без использования облачных бухгалтерских услуг.

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

В итоге, Beancount может справляться с учетом для малого бизнеса, при условии, что пользователь готов вручную управлять тем, что коммерческое программное обеспечение автоматизирует. Он обеспечивает высокую степень прозрачности – вы глубоко понимаете свои книги, потому что сами их ведете – и для прилежного пользователя он может создавать безупречные записи. Как личные, так и бизнес-пользователи извлекают выгоду из основных преимуществ Beancount: надежного бухгалтерского движка, полного аудиторского следа и гибкости для адаптации к уникальным сценариям (с помощью скриптов и плагинов). Будь то отслеживание домашнего бюджета или финансов стартапа, Beancount предлагает набор инструментов для выполнения этой работы с точностью и открытостью.

Сообщество и активность в разработке​

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

• Сопровождение проекта: Основным автором Beancount является Мартин Блейс, который начал проект около 2007 года и провел его через множество версий. Долгое время разработка была в основном усилием одного человека (помимо вкладов сообщества в виде патчей). Философия Мартина заключалась в создании инструмента для учета, «полезного прежде всего для меня, а также для других, самым простым и долговечным способом». Эта личная мотивация поддерживала проект как труд любви. По состоянию на 2025 год Мартин Блейс по-прежнему является ведущим сопровождающим (его имя фигурирует в коммитах, и он отвечает на вопросы в списке рассылки/трекере задач), но экосистема вокруг Beancount имеет множество других участников в их соответствующих проектах.

• GitHub и репозитории: Исходный код размещен на GitHub в репозитории beancount/beancount. Проект лицензирован под GPL-2.0 и за годы привлек умеренное количество участников. В середине 2024 года Beancount Version 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): Автор некоторых фреймворков для импортеров и плагинов, таких как beancount-valuation, а также вкладов в Fava, касающихся инвестиций.
  • Стефано Заккироли (zack): Разработчик Debian, создавший beancount-mode для Emacs и свой собственный репозиторий плагинов. Он также выступал за учет в виде простого текста в академических кругах.
  • Саймон Майкл: Хотя он в основном является руководителем hledger, он управляет plaintextaccounting.org, который включает Beancount. Это перекрестное опыление помогло привлечь внимание пользователей Ledger/hledger к Beancount.
  • Франк Хелл (Tarioch): Участник Tarioch Beancount Tools, крупного набора импортеров и сборщиков цен, особенно для европейских учреждений.
  • Сиддхант Гоэл: Член сообщества, который ведет блог о Beancount (например, его руководство по миграции на v3) и поддерживает некоторые импортеры. Его посты в блоге помогли многим новым пользователям.

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

• Статистика GitHub и форки: Репозиторий Beancount на GitHub набрал несколько сотен звезд (что указывает на интерес) и форков. Заметные форки самого Beancount редки – нет широко известного расходящегося форка, который пытался бы быть «Beancount, но с функцией X». Вместо этого, когда пользователи хотели чего-то другого, они либо писали плагин, либо использовали другой инструмент (например, hledger), а не форкали Beancount. Можно считать hledger своего рода форком Ledger (не Beancount), а сам Beancount – независимым переосмыслением идей Ledger, но внутри репозитория Beancount нет крупных разрозненных проектов. Сообщество в целом объединилось вокруг основного репозитория и расширило его через интерфейс плагинов вместо фрагментации кодовой базы. Это, вероятно, связано с тем, что Мартин Блейс был открыт для внешних вкладов (в его документации даже есть раздел, посвященный внешним вкладам и модулям), а архитектура плагинов сделала ненужным поддержание форка для большинства новых функций.

• Ресурсы сообщества: Существует несколько высококачественных ресурсов для изучения и использования Beancount, созданных сообществом:

  • Документация Beancount на GitHub Pages (и исходные Google Docs, которые поддерживает Мартин) – очень полная, включая теорию бухгалтерского учета и то, как Beancount ее реализует.
  • Многочисленные посты в блогах и личные заметки – например, на LWN.net была статья «Counting beans… with Beancount», и многие личные блоги (перечисленные в разделе «Blog Posts» Awesome Beancount) делятся опытом и советами. Это помогает накапливать знания и привлекать новых пользователей.
  • Доклады и презентации: Beancount был представлен на встречах и конференциях (например, доклад на PyMunich 2018 о управлении финансами с помощью Python/Beancount). Такие доклады знакомят инструмент с более широкой аудиторией и часто вызывают интерес на форумах, таких как Hacker News.

• Заметные связанные проекты: Помимо Fava, некоторые другие проекты, связанные с Beancount, имеют свои собственные сообщества:

  • Сайт Plain Text Accounting – поддерживаемый Саймоном Майклом, он агрегирует информацию обо всех подобных инструментах и имеет форум, где люди делятся опытом использования различных инструментов, включая Beancount.
  • Интеграция с финансовыми инструментами: Некоторые пользователи интегрируют Beancount с инструментами бизнес-аналитики или базами данных. Например, одна ветка Google Groups подробно описывает использование PostgreSQL с данными Beancount через пользовательские функции. Хотя это не является мейнстримом, это показывает экспериментальный дух сообщества в расширении возможностей Beancount (например, для обработки очень больших наборов данных или сложных запросов, выходящих за рамки встроенных).

В заключение, сообщество Beancount, хотя и меньше, чем у крупных проектов с открытым исходным кодом, является высоко вовлеченным и знающим. Проект постоянно получает улучшения и имеет очень полезные каналы поддержки. Совместный подход (обмен импортерами, написание плагинов, ответы на вопросы) означает, что новичок в 2025 году может полагаться на обширную предыдущую работу и мудрость сообщества для настройки своей системы учета. Разработка активна в смысле экосистемы – выпуски Fava, разработка плагинов и т. д. – даже если изменения в ядре происходят реже. Рост экосистемы (о чем свидетельствует список Awesome Beancount, включающий десятки инструментов) говорит о здоровом сообществе, делающем Beancount все более функциональным.

Последние разработки и предстоящие функции​

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

• Выпуск Beancount 3.0 (2024): После долгого периода, когда Beancount 2.x был стандартом, версия 3 была официально выпущена в середине 2024 года. Это стало важной вехой, поскольку v3 представляет собой упрощение и модернизацию кодовой базы. Мартин Бле (Martin Blais) видел v3 как возможность «перестроить и упростить» систему еще больше. Хотя изначально предполагалось, что это будет масштабная переработка, на практике обновление для пользователей не было слишком разрушительным. Основные изменения произошли под капотом: новый парсер, некоторые улучшения производительности и выделение необязательных компонентов из ядра. Выпуск осуществлялся постепенно (v3 находилась в бета-версии с 2022 года, но к июлю 2024 года стала рекомендованной стабильной версией). Пользователи, такие как Сиддхант Гоэл (Siddhant Goel), сообщали, что миграция с 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 по сравнению с Beancount 2.

• Улучшения производительности: Производительность была одной из мотиваций для пересмотра дизайна Beancount. План v3 (изложенный в документе Мартина «Цели V3») включал оптимизацию парсера и, возможно, ускорение процесса загрузки с меньшим потреблением памяти. К 2025 году некоторые из этих улучшений реализованы. По отзывам, пользователи с очень большими гроссбухами (десятки тысяч транзакций или множество сделок с акциями) сообщают о лучшей производительности с последней версией. Например, пользователь, работающий с «микроинвестиционными транзакциями», который сталкивался с проблемами производительности, отметил эти опасения в Google Group – такого рода обратная связь, вероятно, повлияла на v3. Новый парсер более эффективен и написан более понятно, что может быть расширено в будущем. Кроме того, Fava 1.29 перешла на более эффективный механизм отслеживания файлов (используя библиотеку watchfiles) для улучшения отзывчивости при изменении гроссбуха. В будущем сообщество может рассмотреть инкрементальный парсинг (повторная обработка только измененных частей файла вместо всего), чтобы быстрее обрабатывать большие гроссбухи – это упоминалось в документации как идея «сервера Beancount / инкрементального учета».

• Улучшения отслеживания инвестиций: Продолжается работа по улучшению отчетности по инвестициям и портфелям. Например, подробно обсуждалась обработка средней себестоимости по сравнению с FIFO. Хотя Beancount обеспечивает сопоставление партий, некоторые пользователи предпочитают среднюю себестоимость для определенных юрисдикций. Существует предложение и обсуждение о том, как сделать учет себестоимости более гибким (возможно, через плагин или опцию). К 2025 году встроенного переключателя для средней себестоимости нет, но основа в v3 (переработка учета) облегчает реализацию этого для плагинов. Был выпущен плагин сообщества «Gains Minimizer», который может предлагать, какие партии продать для минимизации налогов, демонстрируя тип продвинутых инструментов, создаваемых вокруг инвестиций. Fava также добавила функции, такие как расширение сводки портфеля (с расчетом нормы доходности). Что касается предстоящих функций, можно ожидать большего в этой области: возможно, автоматические предложения по ребалансировке портфеля или анализ рисков, вероятно, в виде внешних инструментов, которые считывают данные Beancount (поскольку все данные там есть).

• Новые плагины и расширения: Экосистема плагинов постоянно растет. Среди недавних заметных дополнений:

  • Инструменты для составления бюджетных отчетов – например, простой CLI-отчетчик бюджета, если пользователь не использует UI Fava.
  • Шифрование и безопасность – была представлена настройка fava-encrypt, позволяющая размещать Fava онлайн с зашифрованным гроссбухом в состоянии покоя, что решает проблему самостоятельного хостинга ваших финансов.
  • Плагины для улучшения удобства использования – такие как autobean-format (новый форматер, который может обрабатывать больше пограничных случаев путем парсинга и перепечатки файла), и интеграция beancheck в редакторы (flymake для Emacs).

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

• Потенциальные предстоящие функции: Основываясь на обсуждениях в трекере задач и списке рассылки, на горизонте есть несколько идей (хотя и не гарантированных):

  • Разрешение времени: В настоящее время Beancount отслеживает только даты (без временных меток) для транзакций. Возникали вопросы о добавлении времени (для сделок с акциями или упорядочивания транзакций в один день). Мартин Бле явно решил, что временные метки внутри дня выходят за рамки, чтобы сохранить простоту. Это вряд ли изменится в ближайшее время – поэтому предстоящие версии, вероятно, не будут добавлять разрешение времени, придерживаясь позиции, что если вам нужно время, вы включаете его в описание или счет.
  • Расширенное редактирование в GUI: Fava постоянно улучшает свои возможности редактирования. Возможен более полнофункциональный веб-редактор (с автоподсказками, возможно, с вводом новых транзакций через формы). Была заложена основа для использования tree-sitter в редакторе Fava. Мы можем увидеть, как Fava станет не просто просмотрщиком, но и более мощным редактором, уменьшая необходимость открывать текстовый редактор для многих задач.
  • Улучшенная поддержка нескольких гроссбухов: Некоторые пользователи ведут несколько файлов Beancount (для разных сущностей или для разделения личных и деловых финансов). В настоящее время включение файлов возможно, но имеет ограничения (плагины во включенных файлах и т.д.). Недавно был создан плагин autobean.include для безопасного включения внешних гроссбухов. В будущем мы можем увидеть первоклассную поддержку многофайловых настроек – возможно, концепцию «проекта» Beancount с несколькими файлами (на это намекают такие функции, как настройка beancount.mainBeanFile в расширении VSCode). Это поможет тем, кто ведет учет для нескольких сущностей или хочет модулировать свой гроссбух.
  • Вычисления в реальном времени или инкрементальные вычисления: По мере роста гроссбухов, способность быстро пересчитывать отчеты становится важной. Существует идея сервера Beancount, который постоянно работает и обновляет результаты по мере изменения транзакций. Это может проявиться как оптимизация в Fava или как демон, к которому могут обращаться плагины редактора. Возможно, будущий выпуск Fava будет использовать постоянно работающий процесс Beancount, чтобы сделать пользовательский интерфейс более отзывчивым для огромных гроссбухов.
  • Учет фондов / Функции для некоммерческих организаций: Было предложение по улучшению, касающееся учета фондов в Beancount. Некоммерческие организации имеют потребности в учете (ограниченные против неограниченных фондов), которые потенциально могут быть смоделированы с помощью иерархии тегов или счетов Beancount. Обсуждение пока не привело к встроенным функциям, но если больше некоммерческих организаций начнут использовать Beancount, это может стимулировать появление новых возможностей (возможно, просто документированные лучшие практики или плагины для отслеживания остатков фондов).

• Долгосрочная перспектива: Мартин Бле намекнул, что видит будущее 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 :)