Aprimorando Sua Experiência com o Beancount com Links e Consultas Personalizadas

Beancount, o sistema de contabilidade de partidas dobradas adorado por desenvolvedores e entusiastas de finanças, é poderoso em sua simplicidade. Mas, para aqueles que desejam mais controle e navegação mais rápida dentro do Fava, a interface web do Beancount, links personalizados na barra lateral e consultas SQL podem levar seu fluxo de trabalho para o próximo nível.

Neste guia, mostraremos como:

• Adicionar links de acesso rápido à barra lateral do Fava
• Usar consultas SQL para filtragem e análise avançadas
• Personalizar seu fluxo de trabalho para revisões mensais ou detecção de anomalias

Por Que Personalizar o Fava?

O Fava já é uma interface bonita para visualizar seu livro razão do Beancount, mas à medida que seu diário cresce, também aumenta a necessidade de melhores atalhos e consultas mais inteligentes.

Pontos problemáticos que isso resolve:

• Navegar repetidamente por intervalos de tempo
• Filtrar transações em contas aninhadas
• Identificar saldos negativos ou anomalias mais rapidamente

✨ Links Personalizados na Barra Lateral

Vamos começar melhorando seu fluxo de trabalho diário com atalhos simples na barra lateral. Esses links aparecem na barra lateral esquerda do Fava e podem levá-lo diretamente a visualizações filtradas, como as transações deste mês ou a receita do mês passado.

Adicione estas linhas ao seu arquivo Beancount:

2021-01-01 custom "fava-sidebar-link" "Mês Atual" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Mês Passado" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Limpar Tudo" "/jump?account=&time=&filter="

O Que Eles Fazem:

• Mês Atual: Abre a visualização de transações filtrada para o mês atual.
• Mês Passado: Salta instantaneamente para o mês anterior — ótimo para revisões de final de mês.
• Limpar Tudo: Redefine os filtros, mostrando todas as entradas novamente.

Esses atalhos eliminam a entrada manual de tempo e tornam sua experiência com o Fava mais fluida e personalizada.

🔍 Consultas SQL Personalizadas

Para uma visão mais profunda, a interface SQL do Fava é incrivelmente poderosa. Aqui está uma consulta que encontra todos os saldos negativos em contas que correspondem a um padrão — perfeito para sinalizar transações incomuns ou problemáticas.

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
  AND account ~ '.*:BCM:.*'
  AND date >= DATE(2021,12,9)
  AND date < DATE(2022,1,9)

Detalhamento:

• account ~ '.*:BCM:.*': Filtra contas que contenham :BCM: em seu nome.
• number(units(position)) < 0: Sinaliza saldos negativos (por exemplo, orçamentos estourados).
• Os filtros de data restringem o resultado a uma janela específica de 1 mês.

Casos de uso:

• Identificar erros como despesas duplicadas ou lançamentos incorretos
• Auditar um fornecedor ou categoria específica
• Extrair rapidamente insights acionáveis para o orçamento

🛠 Dica Profissional: Combine Links + Consultas

Embora o Fava não permita links diretos para consultas personalizadas, você pode criar um hábito de revisão mensal:

• Usando o link “Mês Atual” para iniciar sua revisão
• Abrindo sua aba de consultas salvas em outro painel
• Revisando ambos simultaneamente — filtre primeiro, depois investigue

Essa combinação ajuda você a detectar anomalias antes que elas saiam do controle e garante que seu livro razão permaneça limpo.

Considerações Finais

Beancount é mínimo por design, mas pequenas melhorias como essas trazem grandes ganhos em eficiência. Esteja você revisando seu orçamento, depurando saldos estranhos ou simplesmente economizando cliques, links personalizados e consultas SQL oferecem mais poder e menos atrito.

Bônus: Se você estiver usando os relatórios personalizados do Fava, você pode até criar painéis completos adaptados aos seus rituais de finanças pessoais.

Pronto para assumir o controle?

Comece pequeno: adicione o link “Mês Atual”. Em seguida, crie suas próprias consultas. Seu eu futuro agradecerá.

Quer mais dicas como esta? Assine nossa newsletter ou explore mais receitas do Beancount em Beancount.io.