Функції інтерфейсу користувача

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

Explore the live ledger →

1. Редагування та введення даних​

Вбудований редактор​

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

• Автозаповнення: Натисніть Tab, щоб завершити назви рахунків, платників, теги та посилання.

• Комбінації клавіш:

  • Ctrl+Space: Активувати автозаповнення.
  • Ctrl+/: Закоментувати або розкоментувати рядки.
  • Ctrl+D: Дублювати поточний рядок.
  • Alt+Up/Down: Перемістити поточний рядок вгору або вниз.

• Розумне розміщення курсора: Використовуйте опцію $insert-entry$ у вашому файлі, щоб автоматично розмістити курсор у найновішому записі для конкретного рахунку, коли відкривається редактор.

  option "insert-entry" "Expenses:Food:Dining-Out"

Додавання транзакцій​

Натисніть кнопку + (або натисніть n), щоб відкрити форму транзакції.

• Швидке введення: Форма пропонує останні рахунки та запам'ятовує загальні суми для платників.

• Вбудовані теги/посилання: Додавайте теги та посилання безпосередньо в поле опису (наприклад, Lunch #food ^receipt-001).

• Шаблони транзакцій: Створюйте записи з майбутньою датою з тегом #template. Потім ви можете використовувати форму, щоб знайти та заповнити їх.

  2099-01-01 * "Monthly Rent Payment" #template
      Expenses:Housing:Rent      1500.00 USD
      Assets:Checking           -1500.00 USD

2. Управління документами​

Ефективно пов'язуйте квитанції, виписки та інші файли з вашими транзакціями.

• Завантаження за допомогою перетягування:

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

• Зберігання документів: Файли зберігаються у папці, вказаній директивою $option "documents" "path/to/your/documents"$ у вашому файлі Beancount.

• Автоматизоване зв'язування: Beancount може автоматично знаходити та пов'язувати документи з транзакціями. Увімкніть це за допомогою наступних плагінів:

  plugin "fava.plugins.link_documents"
  plugin "fava.plugins.tag_discovered_documents"

3. Запити та аналіз за допомогою BQL​

Сторінка Query дозволяє запускати запити мовою Beancount Query Language (BQL), подібно до інструменту командного рядка bean-query.

• Візуалізація: Результати запиту автоматично відображаються у вигляді таблиць. Якщо ваш запит повертає два стовпці (наприклад, дату/рядок і число), інтерфейс також згенерує лінійний, стовпчастий графік або деревоподібну карту.
• Експорт: Завантажте будь-який результат запиту як файл CSV.

Практичні приклади запитів​

• Підсумок щомісячних витрат:

  SELECT account, SUM(position) AS total
  FROM postings
  WHERE account ~ '^Expenses' AND date >= 2024-01-01 AND date < 2024-02-01
  GROUP BY account
  ORDER BY total DESC;

• Доходи проти витрат за місяць:

  SELECT YEAR(date) as year, MONTH(date) as month,
         SUM(IIF(account ~ '^Income', -position, 0)) as income,
         SUM(IIF(account ~ '^Expenses', position, 0)) as expenses
  FROM postings
  GROUP BY year, month
  ORDER BY year, month;

4. Налаштування та робочий процес​

Налаштування вигляду​

Налаштуйте відображення інтерфейсу за допомогою цих параметрів у вашому файлі Beancount:

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

  option "show-closed-accounts" "false"
  option "show-accounts-with-zero-balance" "false"
  option "collapse-pattern" "Assets:Investments:.*"

• Індикатори актуальності: Кольорові крапки поруч з рахунками показують їхній статус (зелений для проходження балансу, червоний для невдалого, жовтий для відсутності останньої перевірки балансу). Увімкніть це в директиві open рахунку:

  2020-01-01 open Assets:Checking   fava-uptodate-indication: "TRUE"

Посилання на бічній панелі​

Додайте власні посилання на часто використовувані звіти або відфільтровані перегляди на бічній панелі.

2024-01-01 custom "fava-sidebar-link" "This Month's Expenses" "/income_statement/?time=month"
2024-01-01 custom "fava-sidebar-link" "All Documents" "/journal/?show=document"

Загальна конфігурація​

• Кілька файлів: Якщо ви завантажуєте кілька файлів .beancount, ви можете перемикатися між ними за допомогою спадного списку у верхньому лівому куті.
• Зовнішній редактор: Налаштуйте інтерфейс для відкриття файлів безпосередньо у вашому локальному редакторі за допомогою опції $use-external-editor$ та обробника URL-адрес.
• Мова: Встановіть мову інтерфейсу за допомогою опції $language$ або дозвольте їй автоматично визначати її з вашого браузера.
• Експорт: Експортуйте будь-який відфільтрований перегляд журналу у форматі Beancount за допомогою кнопки Export.

5. Продуктивність і усунення несправностей​

Обробка великих файлів​

Для книг з тисячами транзакцій покращте продуктивність, виконавши такі дії:

• Використання Includes: Розділіть свою книгу на кілька файлів за роком або місяцем і використовуйте директиву include.

  include "accounts.beancount"
  include "transactions/2023.beancount"
  include "transactions/2024.beancount"

• Фільтрування: Використовуйте параметри часу та фільтра, щоб обмежити обсяг даних, що відображаються одночасно.

Поширені проблеми та виправлення​

• Інтерфейс не завантажується:

  1. Перевірте свій файл на наявність синтаксичних помилок за допомогою інструменту командного рядка bean-check.
  2. Шукайте повідомлення про помилки внизу веб-сторінки.
  3. Очистіть кеш вашого браузера.

• Низька продуктивність:

  1. Зменште активний діапазон дат в інтерфейсі користувача.
  2. Спростіть складні запити BQL.

• Помилки конфігурації: Переконайтеся, що назви опцій і типи спеціальних директив укладено в лапки.

  ; Правильно
  option "documents" "/path/to/docs"
  custom "fava-sidebar-link" "Label" "URL"
   
  ; Неправильно (викликає помилки)
  option documents "/path/to/docs"
  custom fava-sidebar-link "Label" "URL"