Una guia per a la interfície web de beancount.io

La interfície web de beancount.io (amb tecnologia Fava) proporciona un conjunt complet d'eines per gestionar, consultar i visualitzar les teves dades financeres. Aquesta guia cobreix les seves principals funcionalitats, des de l'entrada de dades bàsica fins a la personalització avançada i la resolució de problemes.

1. Edició i entrada de dades

L'editor integrat

La interfície inclou un potent editor de text per fer canvis directes als teus fitxers Beancount. Les característiques clau inclouen:

• Autocompletat: Premeu Tab per completar noms de comptes, beneficiaris, etiquetes i enllaços.

• Dreceres de teclat:

  • Ctrl+Espai: Activa l'autocompletat.
  • Ctrl+/: Comenta o descomenta línies.
  • Ctrl+D: Duplica la línia actual.
  • Alt+Amunt/Avall: Mou la línia actual amunt o avall.

• Col·locació intel·ligent del cursor: Utilitzeu l'opció $insert-entry$ al vostre fitxer per col·locar automàticament el cursor a l'entrada més recent d'un compte específic quan s'obre l'editor.

  option "insert-entry" "Expenses:Food:Dining-Out"

Afegir transaccions

Feu clic al botó + (o premeu n) per obrir el formulari de transacció.

• Entrada ràpida: El formulari suggereix comptes recents i recorda les quantitats comunes per als beneficiaris.

• Etiquetes/Enllaços en línia: Afegiu etiquetes i enllaços directament al camp de narració (p. ex., Dinar #menjar ^rebut-001).

• Plantilles de transacció: Creeu entrades amb data futura amb una etiqueta #template. Llavors podeu utilitzar el formulari per trobar-les i omplir-les.

  2099-01-01 * "Pagament mensual del lloguer" #template
      Expenses:Housing:Rent      1500.00 USD
      Assets:Checking           -1500.00 USD

2. Gestió de documents

Enllaceu de manera eficient rebuts, extractes i altres fitxers a les vostres transaccions.

• Pujeu arrossegant i deixant anar:

  • Deixeu anar un fitxer sobre un nom de compte per emmagatzemar-lo a la carpeta d'aquest compte.
  • Deixeu anar un fitxer sobre una transacció al diari per enllaçar-lo directament.

• Emmagatzematge de documents: Els fitxers es guarden a la carpeta especificada per la directiva $option "documents" "path/to/your/documents"$ al vostre fitxer Beancount.

• Enllaç automatitzat: Beancount pot descobrir i enllaçar automàticament documents a les transaccions. Activeu-ho amb els plugins següents:

  plugin "fava.plugins.link_documents"
  plugin "fava.plugins.tag_discovered_documents"

3. Consulta i anàlisi amb BQL

La pàgina Consulta us permet executar consultes del llenguatge de consulta de Beancount (BQL), de manera similar a l'eina de línia d'ordres bean-query.

• Visualització: Els resultats de la consulta es renderitzen automàticament com a taules. Si la vostra consulta retorna dues columnes (com una data/cadena i un número), la interfície també generarà un gràfic de línies, barres o mapes d'arbre.
• Exportació: Descarregueu qualsevol resultat de consulta com a fitxer CSV.

Exemples pràctics de consultes

• Resum mensual de despeses:

  SELECT account, SUM(position) AS total
  FROM postings
  WHERE account ~ '^Expenses' AND date >= 2024-01-01 AND date < 2024-02-01
  GROUP BY account
  ORDER BY total DESC;

• Ingressos vs. Despeses per mes:

  SELECT YEAR(date) as year, MONTH(date) as month,
         SUM(IIF(account ~ '^Income', -position, 0)) as income,
         SUM(IIF(account ~ '^Expenses', position, 0)) as expenses
  FROM postings
  GROUP BY year, month
  ORDER BY year, month;

4. Personalització i flux de treball

Personalitzar la visualització

Adapteu la visualització de la interfície amb aquestes opcions al vostre fitxer Beancount:

• Visibilitat del compte: Controleu quins comptes apareixen a la barra lateral.

  option "show-closed-accounts" "false"
  option "show-accounts-with-zero-balance" "false"
  option "collapse-pattern" "Assets:Investments:.*"

• Indicadors d'actualització: Els punts de colors al costat dels comptes mostren el seu estat (verd per al balanç aprovat, vermell per al fallat, groc per a cap comprovació de balanç recent). Activeu-ho a la directiva open d'un compte:

  2020-01-01 open Assets:Checking   fava-uptodate-indication: "TRUE"

Enllaços de la barra lateral

Afegiu enllaços personalitzats a informes d'ús freqüent o visualitzacions filtrades a la barra lateral.

2024-01-01 custom "fava-sidebar-link" "Despeses d'aquest mes" "/income_statement/?time=month"
2024-01-01 custom "fava-sidebar-link" "Tots els documents" "/journal/?show=document"

Configuració general

• Múltiples fitxers: Si carregueu múltiples fitxers .beancount, podeu canviar entre ells mitjançant el menú desplegable a la part superior esquerra.
• Editor extern: Configureu la IU per obrir fitxers directament al vostre editor local mitjançant l'opció $use-external-editor$ i un gestor d'URL.
• Idioma: Definiu l'idioma de la interfície amb l'opció $language$, o deixeu que es detecti automàticament des del vostre navegador.
• Exportació: Exporteu qualsevol vista de diari filtrada en format Beancount mitjançant el botó Exporta.

5. Rendiment i resolució de problemes

Gestió de fitxers grans

Per als llibres majors amb milers de transaccions, milloreu el rendiment fent el següent:

• Ús d'inclusions: Dividiu el vostre llibre major en diversos fitxers per any o mes i utilitzeu la directiva include.

  include "accounts.beancount"
  include "transactions/2023.beancount"
  include "transactions/2024.beancount"

• Filtratge: Utilitzeu les opcions de temps i filtre per limitar la quantitat de dades que es mostren alhora.

Problemes i solucions comuns

• La interfície no es carrega:

  1. Comproveu si hi ha errors de sintaxi al vostre fitxer mitjançant l'eina de línia d'ordres bean-check.
  2. Cerqueu missatges d'error a la part inferior de la pàgina web.
  3. Esborreu la memòria cau del vostre navegador.

• Rendiment lent:

  1. Reduïu l'interval de dates actiu a la IU.
  2. Simplifiqueu les consultes BQL complexes.

• Errors de configuració: Assegureu-vos que els noms de les opcions i els tipus de directiva personalitzats estiguin entre cometes.

  ; Correcte
  option "documents" "/path/to/docs"
  custom "fava-sidebar-link" "Label" "URL"
  
  ; Incorrecte (causarà errors)
  option documents "/path/to/docs"
  custom fava-sidebar-link "Label" "URL"