Поділіться або вбудуйте свій гросбух

Beancount.io надає гнучкі можливості для спільного використання ваших фінансових даних. Ви можете вбудувати свій гросбух на вебсайти для публічного перегляду або запросити співавторів, щоб вони допомогли редагувати та керувати вашими рахунками.

Вбудовування вашого гросбуха

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

Попередні умови: Зробіть свій гросбух публічним

Важливо: Перш ніж ви зможете вбудувати свій гросбух, ви повинні спочатку встановити для нього публічну видимість.

1. Перейдіть на сторінку налаштувань вашого гросбуха: https://beancount.io/ledger/{username}/{repo}/settings
2. Змініть налаштування видимості з «Приватний» (Private) на «Публічний» (Public)
3. Збережіть зміни

Примітка щодо безпеки

Робіть свій гросбух публічним лише в тому випадку, якщо ви готові ділитися всіма фінансовими даними з будь-ким. Публічні гросбухи може переглядати будь-хто в інтернеті. Якщо ваш гросбух містить чутливу особисту або бізнес-фінансову інформацію, залиште його приватним і використовуйте натомість функції спільної роботи.

Вбудовування за допомогою iframe

Після того як ваш гросбух стане публічним, ви зможете вбудувати його на будь-який вебсайт за допомогою HTML-тегу iframe. Ось приклад вбудовування сторінки огляду:

Приклад коду iframe

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 2rem;">
  <iframe
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
    src="https://beancount.io/ledger/puncsky/example/overview"
    title="Beancount Ledger Overview"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

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

Ви можете вбудовувати різні сторінки вашого гросбуха, змінюючи шлях URL:

• Огляд: /ledger/{username}/{repo}/overview
• Балансовий звіт: /ledger/{username}/{repo}/balance-sheet
• Звіт про прибутки та збитки: /ledger/{username}/{repo}/income-statement
• Журнал: /ledger/{username}/{repo}/journal
• Статистика: /ledger/{username}/{repo}/statistics

Просто замініть {username} на ваше ім'я користувача, а {repo} — на назву репозиторію вашого гросбуха.

Спільний доступ до гросбуха для редагування

Якщо ви хочете, щоб інші допомагали редагувати ваш гросбух (наприклад, бухгалтер, діловий партнер або член команди), ви можете запросити їх як співавторів. Співавтори отримують повний доступ до читання та запису вашого гросбуха і можуть робити коміти через робочий процес на базі Git.

Крок за кроком: Як запросити співавтора

1. Попросіть вашого співавтора зареєструватися Вашому співавтору спочатку потрібно створити безкоштовний обліковий запис на https://beancount.io.

2. Перейдіть на сторінку співавторів Перейдіть за адресою https://beancount.io/ledger/{username}/{repo}/collaborators (замініть {username} та {repo} на дані вашого гросбуха).

3. Запросіть співавтора Натисніть кнопку «Invite Collaborator» і введіть ім'я користувача або електронну адресу вашого співавтора.

Що можуть робити співавтори

Після запрошення та прийняття співавтори можуть:

• Переглядати всі транзакції та фінансові дані
• Редагувати файли гросбуха безпосередньо через веб-інтерфейс
• Робити Git-коміти та переглядати історію комітів
• Завантажувати документи та чеки
• Виконувати запити та створювати звіти
• Надсилати (push) та отримувати (pull) зміни за допомогою команд Git (якщо робота ведеться локально)

Найкращі практики співпраці

• Чітко визначте ролі: Обговоріть, хто відповідає за які рахунки або періоди часу
• Використовуйте зрозумілі повідомлення комітів: Це допомагає відстежувати, хто вніс зміни і чому
• Регулярне спілкування: Координуйте основні зміни, щоб уникнути конфліктів
• Спільно переглядайте зміни: Використовуйте історію Git, щоб перевіряти роботу один одного
• Регулярно робіть резервні копії: Хоча Git забезпечує контроль версій, зберігайте власні резервні копії

Робочий процес на базі Git

Beancount.io використовує Git для контролю версій. Співавтори зі знанням Git можуть клонувати репозиторій локально, вносити зміни у своєму улюбленому текстовому редакторі та надсилати оновлення назад на сервер. Це забезпечує потужні можливості контролю версій для управління вашими фінансовими даними.

Питання конфіденційності

Публічні проти приватних гросбухів

• Публічні гросбухи:

  • Можуть бути вбудовані на зовнішні вебсайти
  • Доступні для перегляду всім, хто має URL-адресу
  • Індексуються пошуковими системами (залежно від налаштувань)
  • Чудово підходять для забезпечення прозорості та навчальних цілей

• Приватні гросбухи (за замовчуванням):

  • Доступні лише вам та запрошеним співавторам
  • Не можуть бути вбудовані ззовні
  • Рекомендовано для особистих і ділових фінансів

Коли використовувати кожен варіант

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

Ви завжди можете змінити налаштування видимості в будь-який час на сторінці налаштувань вашого гросбуха.