Configurations Beancount réelles
Introduction
Beancount est un système de comptabilité en texte brut polyvalent, et ses utilisateurs l'ont adapté pour répondre à une vaste gamme de besoins réels. Dans cette vitrine communautaire, nous présentons des exemples anonymisés de la manière dont différentes personnes structurent et utilisent leurs flux de travail comptables avec Beancount – des freelances et propriétaires de petites entreprises aux passionnés de finances personnelles. Ces exemples mettent en avant des pratiques créatives telles que le balisage des transactions avec des métadonnées, l'automatisation des mises à jour du grand livre avec des scripts personnalisés, la gestion de plusieurs devises, la budgétisation et la prévision, ainsi que l'extension de Beancount avec des plugins ou des intégrations (comme l'interface web Fava).
For living overviews of the same tooling cluster, see Beancount v3: What's New?, Essential Beancount Native Plugins You Should Know, The Beancount Ecosystem, and Beancount's Technical Edge. L'objectif est d'inspirer et d'informer les comptables, développeurs et utilisateurs avertis en finances sur les possibilités offertes par le système flexible de Beancount.
Interface exemple : De nombreux utilisateurs de Beancount s'appuient sur Fava – un tableau de bord web open-source – ou sur son équivalent hébergé sur beancount.io pour visualiser leurs finances. Ces outils transforment un grand livre Beancount en rapports et graphiques interactifs. Par exemple, cette vue Compte de résultat décompose les revenus et les dépenses par catégorie dans le temps, offrant un aperçu rapide des sources et des destinations des fonds. Les utilisateurs peuvent filtrer cette vue par période, compte ou étiquettes pour approfondir des projets ou périodes spécifiques. De telles visualisations rendent les données en texte brut plus accessibles, permettant aux utilisateurs de repérer rapidement tendances et anomalies.
Chaque configuration Beancount est unique, mais des thèmes communs émergent. Ci-dessous, nous explorons trois scénarios – un freelance, un propriétaire de petite entreprise, et un utilisateur avancé des finances personnelles – pour voir comment ils organisent leurs comptes et exploitent les fonctionnalités de Beancount. Tous les détails personnels ont été retirés ou généralisés, en se concentrant uniquement sur les techniques et configurations.
Freelance : balisage des projets et suivi des factures
Notre premier exemple est un consultant indépendant qui utilise Beancount comme base de la gestion financière de son activité. Le grand livre de ce travailleur indépendant est organisé pour suivre les revenus et dépenses par projet et gérer les factures pour plusieurs clients. Il a créé des comptes dédiés pour les comptes clients (A/R) dans les Actifs pour chaque client, ce qui permet de séparer qui doit quoi. Lorsqu'il termine un projet et facture un client, il enregistre une transaction débitant le compte A/R du client et créditant un compte de revenu. Par exemple, une nouvelle facture pourrait être enregistrée ainsi :
2025-08-01 * "Project X Completed" ^INV-0001
Assets:AccountsReceivable:ClientA 5,000 USD
Income:Consulting -5,000 USDIci, la notation ^INV-0001 est un lien (une fonctionnalité intégrée de métadonnées dans Beancount) utilisée pour étiqueter cette transaction avec le numéro de la facture. Lorsque le client paie une partie ou la totalité de cette facture, la transaction de paiement inclut le même lien ^INV-0001, ce qui relie les deux entrées. Ce lien facilite l'affectation des paiements aux factures spécifiques et la visualisation des soldes impayés. Comme l'a expliqué un membre de la communauté, vous pouvez utiliser de telles étiquettes ou liens pour marquer les paiements partiels – par exemple un paiement de $20 sur une facture de $30 – tant sur l'entrée de la facture que sur celle du paiement. En interrogeant le grand livre pour ce lien de facture, le freelance peut instantanément voir combien de la facture a été payé et ce qui reste à régler.
En plus des liens, le freelance utilise abondamment les tags pour la catégorisation. Les tags dans Beancount sont des étiquettes préfixées par # qui peuvent marquer les transactions pour un filtrage ultérieur. Cet utilisateur attribue à chaque dépense facturable à un client le code du projet, comme #ProjectX, et marque les dépenses remboursables avec #Reimbursable. Par exemple, s'il achète des billets d'avion pour un projet client, l'entrée de dépense pourrait inclure #ProjectX #Reimbursable. Cette pratique permet de générer des rapports par projet ou client en filtrant sur les tags. Après un projet, le freelance peut lancer une requête pour lister toutes les dépenses #Reimbursable de ce projet et s'assurer qu'il facture le client pour chacune d’elles. Un utilisateur de Beancount a noté que taguer les dépenses des déplacements professionnels aidait à détecter celles qui n’étaient pas remboursées – idéalement, les dépenses d’un voyage professionnel doivent s’équilibrer à $0 une fois tous les remboursements du client reçus. Cela illustre comment le taggage, combiné aux capacités de requête de Beancount, offre une couche supplémentaire de contrôle pour les freelances gérant des dépenses facturables.
Pour gérer le statut des paiements en attente, notre freelance utilise une convention spéciale pour les créances en suspens. Il applique le tag #UNRESOLVED à toute transaction de facture qui n'a pas encore été entièrement payée. Beancount (et Fava) n'impose pas ce tag, mais c'est un schéma établi par la communauté pour marquer les transactions en attente de règlement. Par exemple, tant que le Client A n’a pas payé les $5,000 complets, la transaction de facturation ci-dessus inclurait #UNRESOLVED. En filtrant sur ce tag, le freelance peut lister toutes les factures ouvertes à tout moment. Une fois le paiement reçu et appliqué (la transaction correspondante de comptes clients est saisie), il retire ou ignore le tag #UNRESOLVED, et le compte de créances de ce client sera à zéro. Ce système garantit qu’aucune facture ne « tombe entre les mailles du filet ». C’est essentiellement un rapport d’antériorité fait en texte brut – si un compte client reste non nul et tagué comme non résolu, il nécessite une attention particulière.
Parce que les freelances traitent souvent plusieurs méthodes de paiement et parfois plusieurs devises, la configuration Beancount prend cela en charge de manière fluide. Dans notre exemple, le consultant pourrait facturer certains clients en USD et d'autres en EUR. La gestion multi-devises est simple dans Beancount : tout compte peut contenir plusieurs marchandises (les devises sont traitées comme des marchandises). Le freelance peut soit garder des sous-comptes séparés pour chaque devise (par exemple Assets:AccountsReceivable:ClientA:EUR vs ...:USD), soit simplement enregistrer les transactions dans la devise appropriée sous le même compte. Beancount suivra automatiquement les soldes par devise. Un utilisateur a souligné à quel point c’est pratique que « Beancount puisse suivre les quantités dans n’importe quelle devise, qu’il s’agisse de USD ou d’un symbole boursier », le tout dans un seul grand livre. Notre freelance profite de cela en enregistrant les taux de change avec des directives price chaque fois qu’il doit convertir des devises pour les rapports. Il peut générer un rapport de revenus converti dans sa devise locale une fois qu’il a saisi les taux de change périodiques ou les prix du marché.
Enfin, ce freelance intègre son grand livre Beancount avec des outils pratiques pour rationaliser son flux de travail. Par exemple, il attache des copies PDF de chaque facture au grand livre via les métadonnées documentaires. Une entrée typique de paiement de facture pourrait ressembler à :
2025-08-30 * "ClientA" "Payment for INV-0001" ^INV-0001
Assets:Bank:Checking 5,000 USD
Assets:AccountsReceivable:ClientA -5,000 USD
document: "Invoices/ClientA/INV-0001.pdf"La directive document de Beancount ou les métadonnées permettent d'associer des fichiers aux écritures, et Fava affichera un lien hypertexte vers ces pièces jointes. Cela signifie que le travailleur indépendant (ou son comptable) peut cliquer directement depuis le rapport du grand livre pour consulter la facture PDF originale, assurant un accès facile aux documents justificatifs. Le travailleur indépendant utilise également les rapports de Fava pour suivre son activité : en filtrant le compte de résultat ou le bilan par client, elle peut voir la rentabilité par client et vérifier que tous les projets sont payés. En résumé, le système Beancount de ce travailleur indépendant montre un usage intensif du marquage et du lien pour gérer une comptabilité basée sur les projets. Il transforme un grand livre en texte brut en un outil robuste de comptabilité freelance, avec une visibilité claire sur les dépenses par projet, les revenus en plusieurs devises et les statuts des factures.
Pratiques clés dans la configuration Freelancer : Utilisation des tags pour regrouper les transactions par projet ou objectif, liaison des factures et paiements avec des identifiants uniques, marquage des créances en souffrance avec une étiquette #UNRESOLVED, attachement des documents de factures aux écritures du grand livre pour référence, et exploitation du support multi-devises de Beancount pour facturer facilement des clients internationaux. Tout cela est réalisé avec des écritures en texte brut et quelques outils d'aide, démontrant la puissance des métadonnées dans Beancount.
Petite entreprise : automatisation et comptabilité multi-devises
Ensuite, nous examinons un propriétaire de petite entreprise – plus précisément un fondateur de startup – qui a adopté Beancount pour gérer la comptabilité de l’entreprise. Les petites entreprises ont des besoins similaires à ceux des freelances (factures, dépenses, multi-devises) mais souvent à une plus grande échelle et avec une plus grande importance accordée à l'automatisation, à la cohérence et à la collaboration. Dans ce cas, le fondateur était techniquement compétent et a construit un flux de travail Beancount hautement automatisé pour minimiser la tenue manuelle des comptes. Après avoir évalué des logiciels comptables traditionnels comme QuickBooks, il a opté pour l’approche en texte brut de Beancount afin de conserver un contrôle total sur les données. Sur quelques années, il a développé de manière itérative des outils personnalisés pour atteindre un processus de comptabilité automatisé à 95 %.
Importations et rapprochements automatisés : L'un des premiers défis a été d'importer les transactions depuis diverses sources (comptes bancaires, cartes de crédit, processeurs de paiement) dans le grand livre. Au lieu de saisir chaque transaction manuellement, cet utilisateur a configuré des scripts d'importation pour récupérer et traduire les données au format Beancount. Ils ont écrit des importateurs Python personnalisés pour chaque format CSV ou API des institutions financières, de sorte qu'avec une seule commande ils peuvent extraire les nouvelles transactions et les ajouter au grand livre. Par exemple, en utilisant les importateurs beangulp, le fondateur peut lancer un script qui scanne un dossier de téléchargements pour les nouveaux relevés et les génère en entrées Beancount. Un autre utilisateur, Rhyd Lewis, a décrit une configuration similaire où il dispose de scripts importateurs séparés pour chaque banque et peut les invoquer via une commande simple (avec un Justfile) pour mettre à jour son grand livre. Notre propriétaire de petite entreprise fait de même – toutes les transactions bancaires, les paiements par carte de crédit et même les transactions PayPal ou Stripe sont automatiquement récupérées et ajoutées aux comptes, catégorisées avec les comptes appropriés.
Pour garantir l'intégrité des données même lorsque ces entrées sont ajoutées automatiquement, ils valident le grand livre avant chaque commit et utilisent les plugins de Beancount. Par exemple, le plugin beancount.plugins.noduplicates est activé pour empêcher l'importation accidentelle d'une transaction deux fois, et beancount.plugins.nounused signale tout compte sans écriture (utile pour nettoyer les comptes obsolètes). Nous recommandons bea check pour cette étape de validation. Le fondateur utilise aussi un formateur communautaire (comme beancount-black) pour garder un style homogène du fichier grand livre. Cela est important car avec de nombreuses modifications automatisées, un style uniforme facilite les diffs et les audits. En fait, le fondateur conserve le grand livre dans un dépôt Git, traitant les mises à jour du grand livre comme des modifications de code. Chaque nouvelle série de transactions importées devient un commit Git, et ils peuvent examiner les diffs pour voir ce qui a changé. Dans une capture d’écran, ils montrent un historique Git où une transaction de carte de crédit pour « Costco » passe d’un état en attente à validé dans le grand livre, sans intervention manuelle. Le contrôle de version fournit une piste d’audit : ils peuvent voir exactement quand une transaction a été ajoutée ou modifiée et même revenir en arrière si une importation est incorrecte. C’est un excellent exemple de l’application des meilleures pratiques du développement logiciel (comme le contrôle de source) aux enregistrements comptables.
Transactions multidevises et internationales : Les petites entreprises effectuent souvent des transactions dans plusieurs devises – par exemple, une startup peut avoir des dépenses en USD mais aussi recevoir des paiements en EUR ou détenir un compte bancaire en GBP. Notre entreprise exemple utilise les fonctionnalités multidevises de Beancount pour consolider tout cela dans un seul grand livre. Ils ont ouvert des comptes séparés pour chaque devise (par exemple, Assets:Bank:Checking:USD et Assets:Bank:Checking:EUR), ce qui est une approche courante. Cependant, même si différentes devises partagent un compte, Beancount suivra le solde de chaque devise séparément et exigera que les transactions soient équilibrées par devise. Le fondateur exécute fréquemment des rapports d'évaluation pour voir les soldes totaux de l'entreprise convertis en devise de base. Puisque Beancount supporte les recherches de prix, il a mis en place des flux de prix quotidiens pour les taux de change (et les cours des actions pour tout investissement) à l'aide d'un script planifié de récupération de cotations. Le résultat est qu'à tout moment il peut générer un bilan, par exemple en USD, qui inclut le compte EUR converti au taux le plus récent. Les membres de la communauté soulignent que gérer plusieurs devises dans une comptabilité de type grand livre est simple – il suffit d'ajouter des transactions dans la devise donnée et d'enregistrer les taux de change au besoin. Par exemple, un utilisateur a partagé un exemple de conversion USD vers EUR puis CAD via des comptes intermédiaires comme moyen de gérer les conversions de devises dans Beancount. Dans notre cas, la petite entreprise ne convertit pas nécessairement les devises dans les transactions (elles les conservent en devise native) mais utilise les rapports pour consolider. Cette flexibilité a été cruciale lors de l'expansion mondiale de la startup.
Scripts personnalisés et extensions : Tout ce dont le fondateur avait besoin n’était pas disponible immédiatement, alors il a étendu Beancount avec des plugins personnalisés. Au fil du temps, il a fini par écrire une bibliothèque d’analyse, un outil de formatage et un importateur de transactions basé sur des règles, en publiant une grande partie en tant que paquets open source. Par exemple, il a créé un moteur d’import basé sur des règles qui utilise une configuration YAML pour catégoriser automatiquement les transactions. Un extrait de cette configuration montre comment certains bénéficiaires ou descriptions (comme « Comcast » ou « PG&E ») sont associés à certains comptes de dépenses et narrations, de sorte que lorsque ceux-ci apparaissent dans un flux bancaire, l’écriture Beancount correcte est générée sans édition manuelle. C’est essentiellement une automatisation personnalisée pour appliquer des règles comptables (pour les services publics, abonnements, etc.) à la volée. Un autre plugin s’assure que le grand livre reste toujours équilibré et formaté. Tous ces outils s’exécutent dans le cadre du flux de travail du fondateur chaque fois que de nouvelles données sont ingérées. Le résultat est un grand livre qui « se met à jour lui-même » avec une intervention minimale, ce qui, selon le fondateur, lui procure une « joie pure » en tant que développeur obsédé par l’automatisation.
La sécurité et l’accessibilité étaient aussi des préoccupations. Le fondateur voulait que son équipe financière (et même son conjoint, en tant que superviseur) puisse consulter facilement les comptes. Pour cela, il a mis en place un déploiement privé de Fava dans le cloud. Chaque fois qu’il pousse un nouveau commit du grand livre vers le dépôt Git privé, un pipeline CI (utilisant GitHub Actions et AWS Elastic Beanstalk) déploie une instance de Fava mise à jour. L’interface web est protégée par mot de passe (via un proxy Nginx avec authentification de base), de sorte que seules les personnes autorisées peuvent y accéder. Ainsi, les derniers états financiers sont toujours disponibles via un tableau de bord dans un navigateur, sans nécessité d’installation locale. Le diagramme d’architecture ci-dessous illustre cette configuration : le fichier Beancount et la configuration nécessaire sont empaquetés dans une image Docker avec Fava, et servis sur AWS, avec Cloudflare en façade pour la sécurité.
flowchart LR
A[Edit ledger locally] --> B[Push to private Git repo]
B --> C[CI builds Docker image<br/>Fava + Nginx basic auth]
C --> D[Deploy to AWS<br/>Elastic Beanstalk]
D --> E[Cloudflare proxy]
E --> F[Owner & team view<br/>reports in browser]Automatisation de Beancount dans le cloud : l'utilisateur met à jour localement le fichier du grand livre puis pousse les modifications sur Git ; un conteneur Docker (incluant Fava et Nginx pour l'authentification) est construit et déployé sur un serveur AWS Beanstalk, et Cloudflare agit comme un proxy. Le résultat est un portail web sécurisé où les données financières de la petite entreprise peuvent être consultées en temps réel, de n'importe où (par le propriétaire ou l'équipe). Cette configuration avancée démontre comment une petite entreprise peut intégrer Beancount avec des outils cloud modernes pour obtenir la commodité sans renoncer à la propriété des données.
Dans l'utilisation quotidienne, le propriétaire de la petite entreprise se concentre sur la gestion des exceptions plutôt que sur la saisie des données. Chaque mois, il passe rapidement en revue les transactions importées automatiquement (en utilisant les diffs Git ou la vue journal de Fava) pour détecter les entrées non catégorisées ou incorrectes. Il utilise également les assertions de solde de Beancount pour réconcilier les comptes. Par exemple, après avoir saisi toutes les transactions de juin, il peut ajouter un contrôle de solde pour confirmer que le solde final du compte bancaire correspond au relevé ; sinon, Beancount générera une erreur, indiquant qu'une opération manque ou a été mal saisie. Cela garantit la précision des livres comptables.
Pratiques clés dans la configuration Petite Entreprise : Automatisation poussée grâce à des importateurs et scripts personnalisés (rendant le grand livre « 95 % automatique »), utilisation du contrôle de version pour les pistes d’audit et la collaboration, comptabilité multi-devises avec flux de prix pour l’évaluation, et déploiement de Fava pour un accès simple et partageable aux rapports financiers. Le scénario de la petite entreprise illustre jusqu’où Beancount peut être exploité avec un effort d’ingénierie – transformant la comptabilité en une chaîne largement automatisée tout en préservant transparence et flexibilité. Même sans être programmeur, de nombreux avantages peuvent être obtenus via des plugins communautaires (pour la mise en forme, la détection de doublons, etc.) et en adoptant le flux de travail en texte brut qui encourage des revues fréquentes et des sauvegardes.
Passionné de finances personnelles : budgétisation et analyses personnalisées
Notre dernier exemple est un passionné de finances personnelles – une personne utilisant Beancount pour gérer les finances et investissements familiaux avec un haut niveau de détail. Cet utilisateur traite ses finances personnelles avec la rigueur d’un comptable et la curiosité d’un analyste de données. Le résultat est un grand livre Beancount qui non seulement suit chaque centime, mais sert aussi de base pour la budgétisation, la prévision et les expériences analytiques.
Organisation du grand livre personnel : Beaucoup de particuliers commencent par un seul fichier Beancount pour tous leurs comptes, et cet amateur ne fait pas exception. Ils maintiennent un grand livre maître (par exemple main.beancount) qui inclut tous les comptes (comptes bancaires, cartes de crédit, prêts, portefeuilles d'investissement, etc.) et transactions. Avec le temps, ils ont introduit une certaine structure en séparant des sections – par exemple, ils ont un fichier pour l'ouverture/fermeture des comptes et des fichiers séparés pour les transactions annuelles – qui sont inclus dans le fichier principal. Cette organisation modulaire facilite la navigation dans des années de données (on peut archiver les anciennes années dans des fichiers séparés) tout en restant logiquement un seul grand livre. Un autre utilisateur personnel sur le forum communautaire a décrit une mise en page similaire : un fichier principal qui inclut d'autres par catégorie (par exemple Income.beancount, Expenses.beancount, Investments.beancount). Notre amateur maintient cela simple pour l’instant : un fichier synchronisé entre les appareils.
En parlant de synchronisation, comme il s'agit de finances personnelles, cet utilisateur souhaite enregistrer les transactions où qu’il soit. Il utilise une application mobile appelée Beancount Mobile pour ajouter rapidement des entrées en déplacement (par exemple, enregistrer une dépense en espèces directement au magasin). Le fichier du grand livre est partagé via une synchronisation cloud (Syncthing, dans ce cas) afin que son téléphone, son ordinateur portable et un VPS (serveur) disposent tous de la dernière copie. Sur un ordinateur, il préfère utiliser Emacs avec beancount-mode pour une édition confortable avec coloration syntaxique. Cette configuration garantit que, qu’il soit à son bureau ou en déplacement, il puisse enregistrer les transactions immédiatement et éviter d’oublier quoi que ce soit. C’est un excellent exemple d’adaptation des outils technologiques pour le confort personnel – construisant ainsi une alternative auto-hébergée aux applications commerciales de gestion budgétaire.
Étiquetage et métadonnées pour un suivi granulaire : Cet utilisateur profite des étiquettes pour ajouter une seconde dimension à ses données au-delà du plan comptable. Pour les catégories budgétaires régulières, les comptes suffisent (ils ont des comptes comme Expenses:Groceries, Expenses:Rent, etc.), mais pour des thématiques transversales comme les événements ou les objectifs, ils utilisent des étiquettes. Par exemple, ils étiquettent toutes les transactions liées à leur projet de rénovation domiciliaire avec #HomeReno, que ce soit l'achat de bois dans un magasin de bricolage (dépense) ou la réception d'un rabais d'un fabricant (revenu). Ainsi, ils peuvent générer facilement un rapport du coût total du projet sans que ces dépenses soient cloisonnées sous différents comptes. Un utilisateur de Reddit a démontré cette approche en étiquetant des dépenses comme #garage-improvement ou #lighting-improvement pour les projets domestiques, ce qui rend trivial le filtrage et la somme de celles-ci via les requêtes de Beancount. Notre passionné fait de même pour les vacances (#ItalyTrip2025), les achats importants, et les événements ponctuels.
Les métadonnées (paires clé-valeur sur les transactions) sont également utilisées à des fins spécifiques. Par exemple, ils ajoutent une métadonnée location: ... aux grosses dépenses pour suivre où ils ont dépensé l'argent, ou une note: ... pour un contexte supplémentaire au-delà du bénéficiaire et de la narration. Dans certains cas, ils ont même créé des champs de métadonnées personnalisés pour aider à la prévision. Un exemple est l'ajout de budget: X et frequency: monthly à certaines dépenses récurrentes – une idée inspirée d'une discussion sur la liste de diffusion de Beancount où un utilisateur stockait des projections budgétaires dans les métadonnées pour chaque dépense. Ces champs de métadonnées n'affectent pas le cœur de Beancount, mais le passionné a écrit un petit script Python qui les lit et compare les dépenses réelles au budget prévu. C'est une alternative à l'utilisation des budgets intégrés de Fava (décrits ci-dessous), montrant comment les métadonnées peuvent être adaptées à la volonté de l'utilisateur. Comme le créateur de Beancount l'a noté, les métadonnées sont « uniquement là pour vous [à utiliser dans des scripts personnalisés] – Beancount les analyse mais les ignore » par lui-même. En résumé, cet utilisateur n'a pas peur d'étendre le grand livre avec des informations supplémentaires pour appuyer son analyse personnelle.
Budgétisation avec Beancount : L’un des objectifs principaux de cet utilisateur est de respecter un budget mensuel. Il utilisait auparavant une application de budgétisation (YNAB) et voulait reproduire certains de ses concepts d’enveloppes budgétaires. Il existe plusieurs manières de faire de la budgétisation dans Beancount, mais la plus simple est d’utiliser les directives de budget de Fava. Notre passionné ajoute des entrées budget dans le grand livre de cette façon :
2025-01-01 custom "budget" Expenses:Groceries "monthly" 500 USD
2025-01-01 custom "budget" Expenses:DiningOut "monthly" 200 USD
2025-01-01 custom "budget" Expenses:Travel "yearly" 3000 USDChaque ligne définit un budget pour un compte (catégorie) sur une période. Fava affiche ensuite des barres budget vs réel dans l'interface web, permettant à l'utilisateur de voir, par exemple, qu'il a dépensé 480 USD en Épicerie ce mois-ci sur les 500 budgétés, et peut-être 220 en Restaurants (au-dessus du budget). L'enthousiaste consulte régulièrement les rapports Income Statement et Expenses de Fava, qui montrent à la fois les totaux mensuels et les objectifs budgétaires. Fava regroupe commodément les budgets quotidiens/hebdomadaires dans les plages temporelles appropriées. En utilisant l'interface Fava pour cela, l'utilisateur n'a pas besoin d'une feuille de calcul séparée pour le budget ; tout est intégré. (Ils ont également expérimenté un système plus automatisé de « pochettes » en déplaçant des fonds dans des comptes fictifs au début de chaque mois, comme suggéré sur les forums, mais ont trouvé les directives budgétaires personnalisées plus simples à maintenir.)
Pour les prévisions, au-delà des budgets, ils surveillent les factures à venir. Certains membres de la communauté ont créé des plugins pour générer des transactions futures pour les abonnements ou les calendriers d’amortissement de prêts, mais cet utilisateur a opté pour une approche plus simple : ils maintiennent une section séparée du grand livre avec des transactions datées dans le futur pour des éléments connus (comme le loyer du mois prochain ou un paiement annuel d’assurance à venir). Ceux-ci restent dans le grand livre mais n’affectent pas les soldes actuels, et une fois la date arrivée et la transaction devenue courante, cela sert de rappel (et ils ajusteront le montant si nécessaire pour correspondre à la charge réelle). C’est un peu un bricolage, mais cela fonctionne pour prévoir les flux de trésorerie sans outils complexes.
Suivi des investissements et comptabilité multi-marchandises : En tant que passionné de finance, cet utilisateur utilise également Beancount pour consolider les comptes d'investissement – actions, fonds communs de placement et crypto – aux côtés des comptes en espèces. Il possède des comptes de courtage dont les avoirs (par ex. actions AAPL, GOOG, etc.) sont enregistrés dans Beancount comme des marchandises. Par exemple, l'achat de 10 actions Apple serait une écriture qui crédite la trésorerie du courtage et débite un compte d’actif avec 10 AAPL comme quantité de marchandise. La capacité de Beancount à gérer n'importe quelle marchandise est très utile ici ; on peut mélanger librement devises et actions. « Beancount peut suivre les quantités dans n'importe quelle devise, que ce soit USD ou un symbole boursier », comme l'a souligné un utilisateur, ce qui représente une grosse amélioration par rapport aux applications de finances personnelles qui ne supportent souvent pas bien les positions en actions. Notre passionné utilise une tâche cron nocturne pour récupérer les derniers cours du marché pour tous ses titres et devises étrangères. Chaque nuit à 4h, un script récupère les prix (depuis Yahoo Finance ou une autre source) et ajoute des enregistrements de prix au grand livre pour cette journée. Ainsi, la prochaine fois qu'ils ouvrent Fava ou génèrent un rapport, ils peuvent voir les valeurs actualisées du portefeuille et même la performance des investissements dans le temps. La valeur nette totale, à travers les comptes bancaires, fonds de retraite et portefeuilles crypto, est disponible en une vue unifiée. C’est un rêve pour un investisseur axé sur les données : plus besoin de se connecter à plusieurs plateformes pour voir l’ensemble. Ils ont essentiellement construit un tableau de bord financier personnel propulsé par Beancount.
Analyse et intégration : Ce qui distingue vraiment cet utilisateur avancé en finance personnelle, c’est la façon dont il analyse les données une fois qu’elles sont dans Beancount. Avec toutes les transactions dans une base SQLite (Beancount peut interroger les données via son langage de requête intégré, similaire au SQL), l’utilisateur peut faire des analyses personnalisées. Il a écrit des scripts Python pour répondre à des questions comme « Quelle est la moyenne mobile sur 3 mois de mes dépenses en courses ? » ou « Comment les dépenses de cette année pour les services publics se comparent-elles à celles de l’année dernière ? » Un script interroge le grand livre pour des tags spécifiques et transmet les résultats dans un dataframe Pandas pour un traitement numérique ultérieur. Parce que le grand livre est en texte brut, ils ont aussi utilisé des notebooks Jupyter pour expérimenter différentes visualisations (au-delà de ce que Fava offre). Par exemple, ils ont produit un graphique à barres personnalisé du taux d’épargne mensuel avec Matplotlib en agrégeant les données Beancount dans Python. Ce type d’analyse ad hoc n’est possible que parce que Beancount garde les données accessibles et lisibles par machine. Comme un utilisateur l’a dit, extraire les données est trivial – « J’ai un script Python qui extrait les données de Beancount via le langage de requête, puis j’utilise un dataframe pandas pour préparer les données dans un rapport ». Notre passionné dispose d’un dépôt de petits scripts de ce genre qu’il lance pour sa revue financière annuelle.
Bien sûr, tout ne nécessite pas de coder – la plupart du temps, ils se reposent sur les graphiques intégrés de Fava. Fava propose un graphique linéaire de la valeur nette, une tendance revenus vs dépenses, et même un treemap (comme montré précédemment), accessibles en un simple clic. L’utilisateur apprécie que l’intégralité de l’historique de ses finances depuis 2018 soit interrogeable et auditables. Par exemple, s’il se demande « combien ai-je dépensé en réparations automobiles durant les 5 dernières années », il peut écrire une requête rapide ou appliquer un filtre dans Fava pour obtenir la réponse, au lieu de fouiller dans les reçus. Cette autonomie est précisément ce qui les a attirés vers Beancount : une pleine propriété des données et une flexibilité infinie dans l’analyse. En prime, le grand livre en texte brut est pérenne – il peut être versionné, migré, ou même analysé par d’autres outils si besoin. Contrairement à une application propriétaire, il n’y a aucun risque de perdre l’accès à leur historique financier.
Pratiques clés dans la configuration personnelle : Utilisation d’outils mobiles et de bureau pour une saisie de données pratique, usage de tags et métadonnées personnalisées pour suivre les événements de vie et les regroupements inter-catégories, mise en place de budgets via les directives budget de Fava pour des objectifs de dépenses continus, suivi des investissements et de multiples devises dans le même grand livre (avec mises à jour automatisées des prix), et réalisation d’analyses personnalisées en interrogeant directement les données du grand livre. Ce cas montre qu’avec un peu de configuration, même les amateurs de finances personnelles peuvent atteindre un niveau de compréhension et de contrôle généralement réservé aux entreprises – tout en gardant l’expérience ludique et engageante pour un utilisateur technophile.
Conclusion
À travers ces exemples communautaires, un thème clair émerge : la flexibilité de Beancount permet un système comptable hautement personnalisé. Les utilisateurs avancés de la communauté ont exploité de simples fichiers texte pour construire des solutions rivalisant en capacités avec des logiciels commerciaux, tout en étant adaptées sur mesure à leurs flux de travail. Les freelances taguent et lient les écritures pour gérer facilement les projets clients et les factures. Les propriétaires de petites entreprises automatisent les tâches comptables fastidieuses et intègrent Beancount avec les infrastructures modernes pour des finances toujours à jour. Les passionnés de finances personnelles utilisent le grand livre comme source unique de vérité pour la budgétisation, l’investissement, et la prise de décision, l’enrichissant de tags et d’outils pour répondre à quasiment toutes les questions sur leur argent. Tout cela est accompli tout en conservant les avantages fondamentaux de la comptabilité en texte brut : transparence, auditabilité et contrôle total sur ses données.
La communauté de Beancount a également produit un écosystème riche de plugins et d'intégrations. Des modes d'éditeur et applications mobiles pour la saisie, à l'interface web Fava pour la visualisation, en passant par d’innombrables importateurs et utilitaires sur GitHub, il existe des ressources pour répondre à presque tous les besoins. Les utilisateurs partagent fréquemment leurs configurations de grand livre sur des forums et blogs, afin que d’autres puissent apprendre et adopter les meilleures pratiques. Il est important de noter que les informations sensibles peuvent rester privées (ou facilement expurgées pour le partage) grâce au format lisible par l'humain – comme nous l’avons fait dans cette présentation. Les exemples ci-dessus démontrent que, que vous soyez développeur indépendant, fondateur de startup ou passionné de finances personnelles, vous pouvez plier Beancount à votre volonté. En utilisant de manière créative le système d’étiquetage et les métadonnées, en automatisant autant que possible, en gérant les transactions multi-devises, en planifiant avec des budgets, et en étendant via des plugins, la communauté continue de repousser les limites de ce qui est possible en texte brut. Le résultat est des grands livres comptables de qualité professionnelle, qui sont également agréables à maintenir, offrant aux utilisateurs à la fois clarté et contrôle sur leurs finances.