Compartilhe ou Incorpore seu Ledger

Beancount.io fornece opções flexíveis para compartilhar seus dados financeiros. Você pode incorporar seu ledger em sites para visualização pública ou convidar colaboradores para ajudar a editar e gerenciar suas contas.

Incorporando seu Ledger

A incorporação permite que você exiba seu ledger publicamente em sites, portfólios ou documentação. Isso é perfeito para relatórios de transparência, orçamentos de projetos de código aberto ou demonstrações educacionais.

Pré-requisitos: Torne seu Ledger Público

Importante: Antes de poder incorporar seu ledger, você deve primeiro configurá-lo para visibilidade pública.

1. Navegue até a página de configurações do seu ledger: https://beancount.io/ledger/{username}/{repo}/settings
2. Altere a configuração de visibilidade de "Privado" para "Público"
3. Salve suas alterações

Nota de Segurança

Torne seu ledger público apenas se você se sentir confortável em compartilhar todos os dados financeiros com qualquer pessoa. Ledgers públicos podem ser visualizados por qualquer pessoa na internet. Se o seu ledger contiver informações financeiras pessoais ou empresariais sensíveis, mantenha-o privado e use os recursos de colaboração em vez disso.

Incorporando com um iframe

Uma vez que seu ledger seja público, você pode incorporá-lo em qualquer site usando um iframe HTML. Aqui está um exemplo de incorporação da página de visão geral:

Exemplo de Código 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="Visão Geral do Ledger Beancount"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

Personalizando a Visualização Incorporada

Você pode incorporar diferentes páginas do seu ledger alterando o caminho da URL:

• Visão Geral: /ledger/{username}/{repo}/overview
• Balanço Patrimonial: /ledger/{username}/{repo}/balance-sheet
• Demonstração de Resultados: /ledger/{username}/{repo}/income-statement
• Diário: /ledger/{username}/{repo}/journal
• Estatísticas: /ledger/{username}/{repo}/statistics

Basta substituir {username} pelo seu nome de usuário e {repo} pelo nome do repositório do seu ledger.

Compartilhando seu Ledger para Edição

Se você deseja que outros ajudem a editar seu ledger (como um contador, parceiro de negócios ou membro da equipe), você pode convidá-los como colaboradores. Os colaboradores têm acesso total de leitura e escrita ao seu ledger e podem fazer commits através do fluxo de trabalho baseado em Git.

Passo a Passo: Convidar um Colaborador

1. Peça ao seu colaborador para se cadastrar Seu colaborador precisa criar uma conta gratuita em https://beancount.io primeiro.

2. Navegue até a página de colaboradores Go to https://beancount.io/ledger/{username}/{repo}/collaborators (substitua {username} e {repo} pelos detalhes do seu ledger).

3. Convide o colaborador Clique no botão "Convidar Colaborador" e insira o nome de usuário ou endereço de e-mail do seu colaborador.

O Que os Colaboradores Podem Fazer

Uma vez convidados e aceitos, os colaboradores podem:

• Visualizar todas as transações e dados financeiros
• Editar os arquivos do ledger diretamente através da interface web
• Fazer commits de Git e visualizar o histórico de commits
• Fazer upload de documentos e recibos
• Executar consultas e gerar relatórios
• Fazer push e pull de alterações usando comandos Git (se estiver trabalhando localmente)

Melhores Práticas de Colaboração

• Defina papéis claramente: Discuta quem é responsável por quais contas ou períodos de tempo
• Use mensagens de commit significativas: Isso ajuda a rastrear quem fez quais alterações e por quê
• Comunicação regular: Coordenar em grandes mudanças para evitar conflitos
• Revise as mudanças juntos: Use o histórico do Git para revisar o trabalho um do outro
• Faça backup regularmente: Mesmo que o Git forneça controle de versão, mantenha seus próprios backups

Fluxo de Trabalho Baseado em Git

Beancount.io usa Git para controle de versão. Colaboradores com conhecimento em Git podem clonar o repositório localmente, fazer alterações com seu editor de texto favorito e enviar atualizações de volta para o servidor. Isso fornece recursos poderosos de controle de versão para gerenciar seus dados financeiros.

Considerações de Privacidade

Ledgers Públicos vs. Privados

• Ledgers Públicos:

  • Podem ser incorporados em sites externos
  • Visíveis por qualquer pessoa com a URL
  • Indexados por motores de busca (dependendo das configurações)
  • Ótimos para transparência e fins educacionais

• Ledgers Privados (Padrão):

  • Acessíveis apenas para você e colaboradores convidados
  • Não podem ser incorporados externamente
  • Recomendados para finanças pessoais e empresariais

Quando Usar Cada Opção

• Use Público para: Orçamentos de projetos de código aberto, exemplos educacionais, relatórios de transparência, demonstrações de portfólio
• Use Privado para: Finanças pessoais, contabilidade empresarial, trabalho para clientes, dados financeiros sensíveis

Você pode sempre alterar as configurações de visibilidade a qualquer momento na página de configurações do seu ledger.