Partager ou intégrer votre grand livre

Beancount.io offre des options flexibles pour partager vos données financières. Vous pouvez intégrer votre grand livre sur des sites web pour une consultation publique ou inviter des collaborateurs pour vous aider à éditer et gérer vos comptes.

Intégrer votre grand livre

L'intégration vous permet d'afficher publiquement votre grand livre sur des sites web, des portfolios ou de la documentation. C'est idéal pour les rapports de transparence, les budgets de projets open-source ou les démonstrations éducatives.

Prérequis : Rendre votre grand livre public

Important : Avant de pouvoir intégrer votre grand livre, vous devez d'abord régler sa visibilité sur "Public".

1. Accédez à la page des paramètres de votre grand livre : https://beancount.io/ledger/{username}/{repo}/settings
2. Modifiez le paramètre de visibilité de « Privé » à « Public »
3. Enregistrez vos modifications

Note de sécurité

Ne rendez votre grand livre public que si vous êtes à l'aise avec le partage de toutes vos données financières avec n'importe qui. Les grands livres publics peuvent être consultés par n'importe qui sur Internet. Si votre grand livre contient des informations financières personnelles ou professionnelles sensibles, gardez-le privé et utilisez plutôt les fonctionnalités de collaboration.

Intégration avec une iframe

Une fois votre grand livre public, vous pouvez l'intégrer sur n'importe quel site web à l'aide d'une iframe HTML. Voici un exemple d'intégration de la page d'aperçu :

Exemple de code 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="Aperçu du grand livre Beancount"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

Personnaliser la vue intégrée

Vous pouvez intégrer différentes pages de votre grand livre en modifiant le chemin de l'URL :

• Aperçu : /ledger/{username}/{repo}/overview
• Bilan : /ledger/{username}/{repo}/balance-sheet
• Compte de résultat : /ledger/{username}/{repo}/income-statement
• Journal : /ledger/{username}/{repo}/journal
• Statistiques : /ledger/{username}/{repo}/statistics

Remplacez simplement {username} par votre nom d'utilisateur et {repo} par le nom du dépôt de votre grand livre.

Partager votre grand livre pour édition

Si vous souhaitez que d'autres personnes vous aident à éditer votre grand livre (comme un comptable, un associé ou un membre de l'équipe), vous pouvez les inviter en tant que collaborateurs. Les collaborateurs bénéficient d'un accès complet en lecture et en écriture à votre grand livre et peuvent effectuer des commits via le flux de travail basé sur Git.

Étape par étape : Inviter un collaborateur

1. Demandez à votre collaborateur de s'inscrire Votre collaborateur doit d'abord créer un compte gratuit sur https://beancount.io.

2. Accédez à la page des collaborateurs Allez sur https://beancount.io/ledger/{username}/{repo}/collaborators (remplacez {username} et {repo} par les détails de votre grand livre).

3. Invitez le collaborateur Cliquez sur le bouton "Invite Collaborator" et saisissez le nom d'utilisateur ou l'adresse e-mail de votre collaborateur.

Ce que les collaborateurs peuvent faire

Une fois invités et après avoir accepté, les collaborateurs peuvent :

• Consulter toutes les transactions et les données financières
• Éditer les fichiers du grand livre directement via l'interface web
• Effectuer des commits Git et consulter l'historique des commits
• Télécharger des documents et des reçus
• Exécuter des requêtes et générer des rapports
• Effectuer des push et pull de modifications en utilisant les commandes Git (si vous travaillez localement)

Meilleures pratiques de collaboration

• Définir clairement les rôles : Discutez de qui est responsable de quels comptes ou de quelles périodes
• Utiliser des messages de commit explicites : Cela aide à suivre qui a effectué quels changements et pourquoi
• Communication régulière : Coordonnez-vous sur les changements majeurs pour éviter les conflits
• Examiner les modifications ensemble : Utilisez l'historique Git pour examiner le travail de chacun
• Sauvegarder régulièrement : Même si Git fournit un contrôle de version, conservez vos propres sauvegardes

Flux de travail basé sur Git

Beancount.io utilise Git pour le contrôle de version. Les collaborateurs ayant des connaissances en Git peuvent cloner le dépôt localement, effectuer des modifications avec leur éditeur de texte préféré et pousser les mises à jour vers le serveur. Cela offre de puissantes capacités de contrôle de version pour la gestion de vos données financières.

Considérations relatives à la confidentialité

Grands livres publics vs privés

• Grands livres publics :

  • Peuvent être intégrés sur des sites web externes
  • Consultables par toute personne disposant de l'URL
  • Indexés par les moteurs de recherche (selon les paramètres)
  • Excellents pour la transparence et à des fins éducatives

• Grands livres privés (par défaut) :

  • Uniquement accessibles par vous et les collaborateurs invités
  • Ne peuvent pas être intégrés à l'extérieur
  • Recommandés pour les finances personnelles et professionnelles

Quand utiliser chaque option

• Utilisez le mode Public pour : les budgets de projets open-source, les exemples éducatifs, les rapports de transparence, les démonstrations de portfolio
• Utilisez le mode Privé pour : les finances personnelles, la comptabilité d'entreprise, le travail client, les données financières sensibles

Vous pouvez modifier les paramètres de visibilité à tout moment depuis la page des paramètres de votre grand livre.