Salta al contingut principal

Comparteix o incrusta el teu llibre major

Beancount.io ofereix opcions flexibles per compartir les teves dades financeres. Pots incrustar el teu llibre major en llocs web per a la visualització pública o convidar col·laboradors perquè t'ajudin a editar i gestionar els teus comptes.

Incrustar el teu llibre major

La incrustació et permet mostrar el teu llibre major públicament en llocs web, portafolis o documentació. Això és perfecte per a informes de transparència, pressupostos de projectes de codi obert o demostracions educatives.

Prerequisits: Fes públic el teu llibre major

Important: Abans de poder incrustar el teu llibre major, primer l'has de configurar amb visibilitat pública.

  1. Navega a la pàgina de configuració del teu llibre major: https://beancount.io/ledger/{username}/{repo}/settings
  2. Canvia la configuració de visibilitat de "Privat" a "Públic"
  3. Desa els canvis
Nota de seguretat

Fes públic el teu llibre major només si et sents còmode compartint totes les dades financeres amb qualsevol persona. Els llibres majors públics poden ser vists per tothom a Internet. Si el teu llibre major conté informació financera personal o empresarial sensible, mantén-lo privat i utilitza les funcions de col·laboració en el seu lloc.

Incrustació amb un iframe

Una vegada que el teu llibre major sigui públic, pots incrustar-lo en qualsevol lloc web utilitzant un iframe HTML. Aquí tens un exemple d'incrustació de la pàgina de vista general:

Exemple de codi 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="Vista general del llibre major de Beancount"
frameBorder="0"
allow="clipboard-write"
loading="lazy">
</iframe>
</div>

Personalització de la vista incrustada

Pots incrustar diferents pàgines del teu llibre major canviant la ruta de la URL:

  • Vista general: /ledger/{username}/{repo}/overview
  • Balanç de situació: /ledger/{username}/{repo}/balance-sheet
  • Estat de resultats: /ledger/{username}/{repo}/income-statement
  • Diari: /ledger/{username}/{repo}/journal
  • Estadístiques: /ledger/{username}/{repo}/statistics

Simplement substitueix {username} pel teu nom d'usuari i {repo} pel nom del repositori del teu llibre major.

Compartir el teu llibre major per a l'edició

Si vols que altres persones t'ajudin a editar el teu llibre major (com un comptable, un soci comercial o un membre de l'equip), pots convidar-los com a col·laboradors. Els col·laboradors obtenen accés complet de lectura i escriptura al teu llibre major i poden realitzar commits a través del flux de treball basat en Git.

Pas a pas: Convida un col·laborador

  1. Demana al teu col·laborador que es registri El teu col·laborador ha de crear primer un compte gratuït a https://beancount.io.

  2. Navega a la pàgina de col·laboradors Ves a https://beancount.io/ledger/{username}/{repo}/collaborators (substitueix {username} i {repo} per les dades del teu llibre major).

  3. Convida el col·laborador Fes clic al botó "Invite Collaborator" i introdueix el nom d'usuari o l'adreça de correu electrònic del teu col·laborador.

Què poden fer els col·laboradors

Una vegada convidats i hagin acceptat, els col·laboradors poden:

  • Veure totes les transaccions i dades financeres
  • Editar els fitxers del llibre major directament a través de la interfície web
  • Realitzar commits de Git i veure l'historial de commits
  • Pujar documents i rebuts
  • Executar consultes i generar informes
  • Enviar (push) i rebre (pull) canvis utilitzant ordres de Git (si treballen localment)

Bones pràctiques de col·laboració

  • Defineix els rols clarament: Acordeu qui és responsable de cada compte o període de temps
  • Utilitza missatges de commit significatius: Això ajuda a rastrejar qui ha fet cada canvi i per què
  • Comunicació regular: Coordineu els canvis importants per evitar conflictes
  • Reviseu els canvis junts: Utilitzeu l'historial de Git per revisar la feina dels altres
  • Fes còpies de seguretat regularment: Encara que Git ofereix control de versions, mantén les teves pròpies còpies de seguretat
Flux de treball basat en Git

Beancount.io utilitza Git per al control de versions. Els col·laboradors amb coneixements de Git poden clonar el repositori localment, fer canvis amb el seu editor de text preferit i enviar les actualitzacions al servidor. Això proporciona potents capacitats de control de versions per gestionar les teves dades financeres.

Consideracions de privadesa

Llibres majors públics vs. privats

  • Llibres majors públics:

    • Es poden incrustar en llocs web externs
    • Visibles per a qualsevol persona amb la URL
    • Indexats pels motors de cerca (segons la configuració)
    • Ideals per a la transparència i fins educatius
  • Llibres majors privats (per defecte):

    • Només accessibles per a tu i els col·laboradors convidats
    • No es poden incrustar externament
    • Recomanats per a finances personals i empresarials

Quan utilitzar cada opció

  • Utilitza Públic per a: Pressupostos de projectes de codi obert, exemples educatius, informes de transparència, demostracions de portafolis.
  • Utilitza Privat per a: Finances personals, comptabilitat empresarial, treballs per a clients, dades financeres sensibles.

Pots canviar la configuració de visibilitat en qualsevol moment des de la pàgina de configuració del teu llibre major.