Ihr Ledger teilen oder einbetten

Beancount.io bietet flexible Optionen für die Freigabe Ihrer Finanzdaten. Sie können Ihren Ledger in Websites einbetten, damit er öffentlich eingesehen werden kann, oder Mitarbeiter einladen, die Sie bei der Bearbeitung und Verwaltung Ihrer Konten unterstützen.

Einbetten Ihres Ledgers

Das Einbetten ermöglicht es Ihnen, Ihren Ledger öffentlich auf Websites, Portfolios oder in Dokumentationen anzuzeigen. Dies eignet sich hervorragend für Transparenzberichte, Budgets von Open-Source-Projekten oder Bildungsdemonstrationen.

Voraussetzungen: Machen Sie Ihren Ledger öffentlich

Wichtig: Bevor Sie Ihren Ledger einbetten können, müssen Sie dessen Sichtbarkeit zuerst auf „Öffentlich“ (Public) setzen.

1. Navigieren Sie zur Einstellungsseite Ihres Ledgers: https://beancount.io/ledger/{username}/{repo}/settings
2. Ändern Sie die Sichtbarkeitseinstellung von „Privat“ auf „Öffentlich“
3. Speichern Sie Ihre Änderungen

Sicherheitshinweis

Geben Sie Ihren Ledger nur dann öffentlich frei, wenn Sie damit einverstanden sind, alle Finanzdaten mit jedem zu teilen. Öffentliche Ledger können von jedem im Internet eingesehen werden. Wenn Ihr Ledger sensible persönliche oder geschäftliche Finanzinformationen enthält, lassen Sie ihn privat und nutzen Sie stattdessen die Funktionen zur Zusammenarbeit.

Einbetten mit einem iframe

Sobald Ihr Ledger öffentlich ist, können Sie ihn über einen HTML-iframe in jede beliebige Website einbetten. Hier ist ein Beispiel für die Einbettung der Übersichtsseite:

iframe-Codebeispiel

<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 Übersicht"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

Anpassung der eingebetteten Ansicht

Sie können verschiedene Seiten Ihres Ledgers einbetten, indem Sie den URL-Pfad ändern:

• Übersicht: /ledger/{username}/{repo}/overview
• Bilanz: /ledger/{username}/{repo}/balance-sheet
• Gewinn- und Verlustrechnung: /ledger/{username}/{repo}/income-statement
• Journal: /ledger/{username}/{repo}/journal
• Statistiken: /ledger/{username}/{repo}/statistics

Ersetzen Sie einfach {username} durch Ihren Benutzernamen und {repo} durch den Namen Ihres Ledger-Repositorys.

Ihren Ledger zur Bearbeitung freigeben

Wenn Sie möchten, dass andere Personen bei der Bearbeitung Ihres Ledgers helfen (wie ein Steuerberater, Geschäftspartner oder Teammitglied), können Sie diese als Mitarbeiter (Collaborators) einladen. Mitarbeiter erhalten vollen Lese- und Schreibzugriff auf Ihren Ledger und können Commits über den Git-basierten Workflow durchführen.

Schritt-für-Schritt: Einen Mitarbeiter einladen

1. Bitten Sie Ihren Mitarbeiter, sich zu registrieren Ihr Mitarbeiter muss zuerst ein kostenloses Konto unter https://beancount.io erstellen.

2. Navigieren Sie zur Seite für Mitarbeiter Gehen Sie zu https://beancount.io/ledger/{username}/{repo}/collaborators (ersetzen Sie {username} und {repo} durch Ihre Ledger-Details).

3. Laden Sie den Mitarbeiter ein Klicken Sie auf die Schaltfläche „Invite Collaborator“ und geben Sie den Benutzernamen oder die E-Mail-Adresse Ihres Mitarbeiters ein.

Was Mitarbeiter tun können

Sobald sie eingeladen wurden und die Einladung angenommen haben, können Mitarbeiter:

• Alle Transaktionen und Finanzdaten einsehen
• Die Ledger-Dateien direkt über die Weboberfläche bearbeiten
• Git-Commits durchführen und den Commit-Verlauf einsehen
• Dokumente und Belege hochladen
• Abfragen ausführen und Berichte erstellen
• Änderungen mit Git-Befehlen pushen und pullen (bei lokaler Arbeit)

Best Practices für die Zusammenarbeit

• Rollen klar definieren: Besprechen Sie, wer für welche Konten oder Zeiträume verantwortlich ist.
• Aussagekräftige Commit-Nachrichten verwenden: Dies hilft nachzuvollziehen, wer welche Änderungen warum vorgenommen hat.
• Regelmäßige Kommunikation: Stimmen Sie sich bei größeren Änderungen ab, um Konflikte zu vermeiden.
• Änderungen gemeinsam prüfen: Nutzen Sie die Git-Historie, um die Arbeit der anderen zu überprüfen.
• Regelmäßige Backups: Obwohl Git eine Versionskontrolle bietet, sollten Sie eigene Backups pflegen.

Git-basierter Workflow

Beancount.io verwendet Git für die Versionskontrolle. Mitarbeiter mit Git-Kenntnissen können das Repository lokal klonen, Änderungen mit ihrem bevorzugten Texteditor vornehmen und Updates zurück auf den Server pushen. Dies bietet leistungsstarke Funktionen zur Versionskontrolle für die Verwaltung Ihrer Finanzdaten.

Datenschutzüberlegungen

Öffentliche vs. Private Ledger

• Öffentliche Ledger:

  • Können auf externen Websites eingebettet werden
  • Für jeden mit der URL einsehbar
  • Von Suchmaschinen indexiert (je nach Einstellungen)
  • Ideal für Transparenz und Bildungszwecke

• Private Ledger (Standard):

  • Nur für Sie und eingeladene Mitarbeiter zugänglich
  • Können nicht extern eingebettet werden
  • Empfohlen für persönliche und geschäftliche Finanzen

Wann welche Option zu verwenden ist

• Öffentlich verwenden für: Budgets von Open-Source-Projekten, Bildungsbeispiele, Transparenzberichte, Portfolio-Demonstrationen.
• Privat verwenden für: Persönliche Finanzen, geschäftliche Buchhaltung, Kundenprojekte, sensible Finanzdaten.

Sie können die Sichtbarkeitseinstellungen jederzeit auf der Einstellungsseite Ihres Ledgers ändern.