"Fava" 태그로 연결된 7개 게시물개의 게시물이 있습니다.

원장이 플레인 텍스트로 저장된다면, 월말 마감은 빠르고 감사 가능하게 할 수 있습니다. 이 과정은 스프레드시트와 계산기에 대한 급박한 뒤죽박죽이 될 필요가 없습니다. 이 가이드는 잔액(assertion), 스마트 가져오기, 경량 검증을 중심으로 Beancount와 그 웹 인터페이스인 Fava에 맞춘 깔끔하고 반복 가능한 프로세스를 정리합니다.

아래는 고통 없는 마감을 위한 체크리스트입니다:

1. 명세서를 수집하고 모든 원시 거래를 가져옵니다.
2. 거래처, 설명, 메타데이터를 정규화합니다.
3. balance 어설션을 사용해 현금, 은행, 신용 계정을 모두 조정합니다.
4. 이체와 계정 간 이동을 맞춥니다.
5. 투자 가격을 업데이트하고 평가액을 검증합니다.
6. 원장에 영수증·청구서 등 문서를 첨부하거나 연결합니다.
7. 손익 및 변동성 검사를 위해 쿼리와 대시보드를 실행합니다.
8. 필요에 따라 발생액과 조정 항목을 기록합니다.
9. 자동 검사를 통해 원장을 검증합니다.
10. 커밋하고 태그를 붙인 뒤 월을 보관합니다.

1. 기본 규칙 설정 (그리고 재사용)​

일관된 마감은 안정적인 기반에서 시작됩니다. 계정표와 핵심 Beancount 옵션은 중앙에서 선언하고 거의 변경하지 않아야 합니다. operating_currency와 documents 옵션과 같은 설정은 보고서와 가져오기가 매번 예측 가능하게 동작하도록 보장합니다.

팁: 옵션 파일을 “인프라”처럼 다루세요. 옵션을 변경하면 숫자 계산 방식이 바뀔 수 있습니다. Git에 신중히 버전 관리하세요.

2. 모든 것을 가져오고, 다시는 수동 입력하지 않기​

데이터 가져오기를 자동화하는 것이 장부 마감 속도를 가장 크게 높이는 방법입니다. Beancount의 강력한 가져오기 도구와 커뮤니티가 만든 임포터를 활용해 은행 피드, 신용카드 CSV/OFX 파일, 증권 데이터, 급여 보고서를 끌어옵니다.

목표는 한 번의 명령으로 균형 잡힌 포스팅을 생성하고, 검토 후 커밋만 하면 되는 것입니다. 이렇게 하면 수동 입력이라는 오류와 지연의 주요 원천을 없앨 수 있습니다.

3. 거래처와 메타데이터 사전 정규화​

깨끗한 데이터는 신뢰할 수 있는 데이터입니다. 가져오기 과정에서 거래처, 내러션, 태그를 표준화하면 검색, 규칙, 보고서가 매월 정확하게 유지됩니다.

Beancount 플러그인 시스템을 이용해 파일이 로드될 때 가벼운 변환과 검증을 추가할 수 있습니다. 이는 맞춤 일관성 검사를 강제하거나, 내장 noduplicates 플러그인을 사용해 중복 거래를 문제 발생 전에 표시하는 데 완벽합니다.

4. balance 어설션으로 조정​

명세서가 있는 모든 계정(당좌, 저축, 신용카드)에 대해 Beancount의 balance 지시문을 사용해 마감 잔액을 선언합니다. 이 한 줄은 수동 눈대중 검사를 정확하고 자동화된 테스트로 바꿔줍니다.

; 하루 시작 시점에 정확히 1234.56 USD 잔액을 선언
2025-09-01 balance Assets:Bank:Checking   1234.56 USD

잔액은 당일 시작에 확인되므로, 월말 명세서는 다음 달 첫째 날을 사용하면 가장 편리합니다. Beancount가 계산한 잔액이 어설션과 다르면 정확한 오류와 조사 시작 날짜를 알려줍니다. 항상 원본 거래를 먼저 수정하고, 어설션을 “강제”하지 마세요.

5. 계정 간 이체 맞추기​

각 이체가 거래 양쪽에 모두 나타나는지 확인하세요. 예를 들어, 당좌 계좌에서 신용카드로 이체한 경우 두 계정 모두에 반영돼야 합니다. 일치하지 않는 이체는 흔한 조정 골칫거리입니다.

pad 지시문은 계정을 처음 설정할 때 과거 개시 잔액을 지정할 때만 사용합니다. 이는 설정 도구이며, 월말 차이를 메우기 위한 조정 수단이 아닙니다.

6. 투자 포지션과 가격 검증​

순자산을 정확히 파악하려면 투자와 외화에 대한 최신 시장 가치를 반영해야 합니다. 마감일 기준으로 price 지시문을 사용해 이러한 값을 기록합니다.

2025-08-31 price VTI  290.14 USD
2025-08-31 price EUR    1.11 USD

많은 도구가 자동으로 가격을 가져올 수 있습니다. 가격을 업데이트한 뒤 대차대조표나 순자산 보고서를 다시 실행해 평가 변화를 확인하세요.

7. 영수증 및 원본 문서 연결​

거래를 원본 문서와 연결해 깔끔한 감사 흔적을 유지하세요. 메인 Beancount 파일에 documents 옵션을 설정해 영수증·청구서 보관소를 지정합니다.

option "documents" "/path/to/Finance/Documents"

파일명을 날짜 기반(2025-08-13.vendor.receipt.pdf)으로 지정하면 Beancount와 Fava가 자동으로 발견하고 연결해 줍니다. 이렇게 하면 어떤 거래든 클릭 한 번으로 영수증을 확인할 수 있습니다.

8. Fava와 BQL로 월 검토​

빠른 피드백 루프가 핵심입니다. Fava를 사용해 시각적으로 재무 상황을 점검하세요. 차트와 보고서는 카테고리별 지출 분석, 수입 추세 확인, 이상 징후 파악에 최적입니다.

보다 정밀한 검사는 **Beancount Query Language (BQL)**을 활용합니다. 예를 들어, 2025년 8월 전체 지출을 내림차순으로 정렬해 보여주는 쿼리는 다음과 같습니다:

SELECT
  account,
  ROUND(SUM(position), 2) AS total
WHERE
  date >= 2025-08-01 AND date < 2025-09-01
  AND account   'Expenses'
GROUP BY
  account
ORDER BY
  total DESC;

9. 발생액 및 조정 기록​

발생주의 회계를 사용한다면, 월말 조정 항목을 명시적이고 날짜가 포함된 거래로 기록하세요. 여기에는 아직 청구되지 않은 공과금, 선불 비용의 상각, 수익 인식 등이 포함될 수 있습니다. 내러션을 간단하고 명확하게 작성해 향후 검토 시 이해하기 쉽게 하세요.

10. 검증, 태그 지정, 보관​

월을 최종 확정하기 전에 구조적 무결성을 최종 점검합니다:

bean-check your-ledger.beancount

이 명령은 불균형, 미개설 계정 참조, 기타 일반 오류를 잡아냅니다. 표시된 문제를 모두 수정하세요.

모든 것이 정상이라면 Git 등 버전 관리 시스템에 커밋하고, close-2025-08 같은 명확한 메시지와 태그를 달아 저장합니다. 마지막으로 은행 명세서를 보관하고 월을 잠금 처리합니다.

적용 가능한 간단 마감 스크립트​

대부분의 단계를 간단한 쉘 스크립트로 자동화할 수 있습니다. 이렇게 하면 마감이 하나의 반복 가능한 명령이 됩니다.

#!/usr/bin/env bash
set -euo pipefail

# Example: ./close.sh 2025-08
MONTH=${1:?Please provide a month in YYYY-MM format}
LEDGER= /finance/ledger.beancount

# 1. Import new transactions
echo "Importing transactions for $MONTH..."
make import MONTH="$MONTH"

# 2. Update market prices for the last day of the month
PRICE_DATE=$(date -d "$MONTH-01 +1 month -1 day" +%F)
echo "Fetching prices for $PRICE_DATE..."
make prices DATE="$PRICE_DATE"

# 3. Validate the entire ledger
echo "Running bean-check..."
bean-check "$LEDGER"

# 4. Generate a key report (e.g., expense breakdown)
echo "Generating expense report for $MONTH..."
bean-query "$LEDGER" -f txt "
  SELECT account, SUM(position)
  WHERE date >= '${MONTH}-01' AND date < '${MONTH}-01' + 1 month
    AND account   'Expenses'
  GROUP BY account ORDER BY SUM(position) DESC;
" > "reports/${MONTH}-expenses.txt"

# 5. Commit and tag the close in Git
echo "Committing and tagging the close..."
git -C   /finance add .
git -C   /finance commit -m "Close ${MONTH}"
git -C   /finance tag "close-${MONTH}"

echo "Month ${MONTH} is closed and tagged."

왜 이렇게 작동하는가​

이 프로세스가 빠르고 신뢰할 수 있는 이유는 몇 가지 핵심 원칙에 기반하기 때문입니다:

• 어설션, 눈대중이 아니다: balance 지시문은 조정을 정확하고 자동화된 검사로 전환합니다.
• 결정론적 입력: 자동 임포터와 정규화된 메타데이터 덕분에 원장이 재현 가능하고 일관됩니다.
• 탐색 가능한 데이터: Fava와 BQL은 결과를 검증하고 이상치를 즉시 파고들 수 있는 강력한 도구를 제공합니다.
• 감사 가능한 변경: 조정은 플레인 텍스트 저널 엔트리이므로 몇 년 뒤에도 쉽게 검토하고 이해할 수 있습니다.

좋은 월말 마감은 대부분 물류적인 작업입니다. Beancount와 함께라면 가져오기 → 어설션 → 가격 업데이트 → 쿼리 → 커밋이라는 짧은 스크립트형 의식으로 전환할 수 있습니다. 워크플로우를 안정적으로 유지하면 재무 상황이 복잡해져도 마감은 여전히 빠르게 진행됩니다.

Beancount.io 생태계에 큰 향상이 찾아왔습니다: 공식 beancount-dashboard 통합을 발표하게 되어 기쁩니다. 이 강력한 새로운 기능은 풍부하고 인터랙티브한 시각화를 Fava에 직접 제공하여, 재무 이야기를 명확하고 설득력 있게, 행동 가능한 형태로 보여줍니다.

beancount-dashboard란?​

beancount-dashboard 은 Beancount의 웹 인터페이스인 Fava용 오픈소스 플러그인입니다. 평문 텍스트 재무 데이터를 동적이고 통찰력 있는 대시보드로 변환해, 재무 건전성을 이해하고 정보에 입각한 결정을 내리는 것이 그 어느 때보다 쉬워집니다.

플러그인은 다양한 강력한 시각화를 제공합니다:

• 📊 포괄적인 자산 보기: 순자산 라인 차트 로 부를 추적하고, 상세 포트폴리오 추적 으로 성과를 모니터링하며, 자산 배분 파이 차트로 분포를 시각화합니다.
• 💰 수입·지출 분석: 현금 흐름을 정밀하게 파악합니다. 월 평균 을 분석하고, 카테고리 별 지출을 분류하며, 연도별 비교 분석 으로 습관 변화를 확인합니다.
• ✈️ 여행 비용 관리: 연간 여행 비용을 추적하고 목적지별 지출 패턴을 분석해 향후 여행 예산을 효율적으로 계획합니다.
• 🔄 Sankey 다이어그램: 수입원, 계정, 지출 카테고리 간 자금 흐름을 인터랙티브 차트로 시각화합니다.
• 📈 재무 전망: 과거 데이터를 활용해 목표를 설정하고 재무 궤적을 예측합니다.

beancount-dashboard를 통합한 이유​

이번 통합은 Beancount 커뮤니티에 네 가지 핵심 혜택을 제공합니다:

1. 향상된 사용자 경험​

Beancount는 견고한 복식부기 기반이지만 원시 데이터는 압도적일 수 있습니다. beancount-dashboard 플러그인은 복잡한 원장을 직관적인 시각화로 변환해, 재무 관리를 모두에게 접근 가능하고 흥미롭게 만듭니다.

2. 더 나은 재무 의사결정​

시각적 대시보드는 더 스마트한 재무 선택을 가능하게 합니다. 데이터를 쉽게 소화할 수 있는 형태로 제공해 트렌드 파악, 예산 최적화, 목표 추적, 미래 계획 을 자신 있게 수행하도록 돕습니다.

3. 전문가 수준 분석​

이번 통합은 엔터프라이즈 급 분석력을 손끝에 제공합니다. Apache ECharts 기반의 대시보드는 인터랙티브 차트, 맞춤형 뷰, 실시간 업데이트를 지원하며, 최신 거래를 즉시 반영합니다. 반응형 디자인으로 모든 디바이스에서 매끄러운 경험을 보장합니다.

4. 오픈소스 우수성​

Beancount와 beancount-dashboard 모두 오픈소스 원칙을 고수합니다. 이는 데이터 처리에 대한 투명성, 프라이버시 (데이터가 자체 인프라에 머무름) 를 보장하고, 활발하고 혁신적인 커뮤니티 지원을 의미합니다.

실제 적용 사례​

다양한 사용자에게 즉각적이고 눈에 띄는 혜택을 제공합니다:

개인 재무 관리​

• 예산 관리: 매달 자금 흐름을 정확히 파악합니다.
• 저축 목표: 비상금, 여행, 은퇴 등 목표 달성 진행 상황을 시각화합니다.
• 투자 모니터링: 포트폴리오 성과와 자산 배분을 면밀히 추적합니다.

소규모 기업​

• 현금 흐름 관리: 사업 유동성을 모니터링하고 현금 흐름 패턴을 이해합니다.
• 비용 분석: 부서, 프로젝트, 공급업체별 사업 비용을 분석합니다.
• 재무 계획: 과거 데이터를 활용해 보다 정확한 예산 편성 및 예측을 수행합니다.

재무 컨설턴트​

• 클라이언트 프레젠테이션: 전문적이고 이해하기 쉬운 재무 보고서를 제작합니다.
• 포트폴리오 분석: 포괄적인 자산 배분 및 성과 추적을 수행합니다.
• 컴플라이언스: 감사 및 보고를 위한 상세하고 접근 가능한 기록을 유지합니다.

재무 생활을 혁신할 준비가 되셨나요?​

beancount-dashboard 의 힘으로 재무 관리에 필요한 모든 도구를 손에 넣고, 재무 통제권을 잡으세요.

1. beancount.io 방문
2. 무료 계정 생성 으로 Beancount 전체 생태계에 접근
3. 수천 명의 사용자 와 함께 자신감 있게 재무를 관리

여러분의 피드백을 기다립니다​

플랫폼을 지속적으로 개선하기 위해 여러분의 의견이 중요합니다. 대시보드 성공 사례, 기능 요청, 버그 리포트 등을 공유해 주세요. 커뮤니티 포럼, GitHub Issues, 소셜 미디어 를 통해 Beancount.io 팀과 연결할 수 있습니다.

활기찬 커뮤니티에 참여하세요​

다른 Beancount 사용자와 대시보드 설정을 공유하고, 전문가에게 배우며, 자신의 지식을 기여하세요. 새로운 기능 업데이트를 받아보고, 재무 관리의 미래를 함께 만들어갑시다.

이번 통합은 큰 도약을 의미합니다. Beancount의 견고한 회계 엔진과 beancount-dashboard 의 강력한 시각화를 결합해, 오픈소스이면서 프라이버시 중심의 엔터프라이즈 급 분석 솔루션을 제공합니다.

재무 추적을 혁신하고 싶으신가요? 지금 바로 beancount.io 에 등록하고, beancount-dashboard 의 힘을 체험하며, 함께 재무 관리의 미래를 만들어갑시다!

Beancount의 핵심 기능과 철학​

Beancount는 일반 텍스트 파일을 사용하여 거래를 기록하는 오픈소스 복식 부기 회계 시스템입니다. 핵심적으로 Beancount는 당신의 원장을 단순하고 엄격한 문법으로 정의된 _데이터셋_으로 취급합니다. 모든 금융 이벤트(거래, 계좌 개설, 상품 가격 등)는 텍스트 파일의 지시어(directive)이며, Beancount는 이를 파싱하여 인메모리(in-memory) 데이터베이스의 항목으로 변환합니다. 이 설계는 복식 부기 원칙을 강제합니다: 모든 거래는 계좌 간의 차변과 대변이 균형을 이루어야 합니다. 그 결과, 버전 관리가 가능하고, 쉽게 검사하고 질의할 수 있는 매우 투명하고 감사 가능한 원장이 만들어집니다.

철학 – 정확성과 미니멀리즘: Beancount의 설계는 데이터 무결성과 단순성을 우선시합니다. 개발자인 마틴 블레이스(Martin Blais)는 Beancount가 사용자가 실수를 할 것이라고 가정하는 "비관적(pessimistic)"인 태도를 취하며, 따라서 추가적인 검사와 제약을 부과한다고 설명합니다. 예를 들어, Beancount는 한 번도 추가된 적 없는 자산을 제거하는 것을 허용하지 않으며(마이너스 주식 보유나 현금 잔액 방지), 모든 계좌가 사용 전에 개설되도록 강제할 수 있습니다. Ledger의 "가상(virtual)" 또는 자동 균형 조정 전기(posting) 개념이 없는데, 이는 완전하게 균형 잡힌 항목을 강제하기 위한 의도적인 선택입니다. Beancount는 기본적인 복식 부기가 제공하는 것보다 더 많은 교차 검증을 통해 정확성에 대해 매우 엄격한 입장을 취합니다. 이러한 신중한 접근 방식은 "자기 자신을 너무 신뢰하지 않고" 소프트웨어가 자신의 실수를 잡아주기를 원하는 사용자들에게 매력적입니다.

최소한의 옵션, 최대한의 일관성: Ledger의 수많은 커맨드 라인 플래그와 튜닝 옵션과는 대조적으로, Beancount는 미니멀리즘을 선택합니다. 전역 옵션은 거의 없으며, 원장 파일 외부에서 거래의 의미를 변경하는 옵션은 전혀 없습니다. 회계에 영향을 미치는 모든 설정(예: 상품 원가 기준법이나 예약 가정)은 파일 내 지시어나 플러그인을 통해 이루어지므로, 보고서가 어떻게 생성되든 동일한 파일을 로드하면 항상 동일한 결과가 나옵니다. 이 설계는 Ledger의 많은 설정과 그들 사이의 미묘한 상호작용의 복잡성을 피합니다. Beancount의 철학은 회계 도구가 입력 파일에서 보고서까지 _안정적이고 결정론적인 파이프라인_이어야 한다는 것입니다. 이는 원장을 순차적으로 프로그래밍 방식으로 처리할 수 있는 지시어의 순서 있는 스트림으로 취급함으로써 달성됩니다. Ledger가 특별한 구문으로 취급하는 것들(예: 기초 잔액이나 가격 명세)조차도 Beancount의 데이터 모델에서는 일급 지시어이므로, 시스템의 확장성이 매우 높습니다.

플러그인과 쿼리 언어를 통한 확장성: Beancount는 Python으로 구현되었으며, 처리 파이프라인에 사용자 정의 로직을 주입할 수 있는 훅(hook)을 제공합니다. 사용자는 Python으로 플러그인을 작성하여 거래 스트림에 작용하게 할 수 있습니다(예: 사용자 정의 규칙을 강제하거나 자동 항목을 생성). 이 플러그인들은 파일이 처리될 때 실행되어, 소스 코드를 수정할 필요 없이 Beancount의 핵심 기능을 효과적으로 확장합니다. Beancount에는 또한 원장을 분석하기 위한 강력한 쿼리 언어(SQL에서 영감 받음)가 포함되어 있습니다. bean-query 도구는 파싱된 원장을 데이터베이스로 취급하고, 분석적인 쿼리를 실행할 수 있게 해줍니다. 예를 들어, 카테고리별 비용을 합산하거나 특정 수취인에 대한 모든 거래를 추출할 수 있습니다. Beancount 3.x에서는 이 쿼리 기능이 독립적인 beanquery 패키지로 옮겨졌지만, 사용자 관점에서는 여전히 SQL과 유사한 쿼리를 통해 유연한 보고를 제공합니다.

일반 텍스트와 버전 관리: 일반 텍스트 회계 도구로서, Beancount는 _사용자 제어_와 데이터의 장기 보존을 강조합니다. 원장은 단순히 어떤 텍스트 편집기에서나 편집할 수 있는 .beancount 텍스트 파일입니다. 이는 전체 금융 기록이 사람이 읽을 수 있는 형태로 저장되고, Git이나 다른 VCS에 넣어 시간 경과에 따른 변경 사항을 추적할 수 있음을 의미합니다. 사용자들은 종종 모든 편집의 감사 추적(변경 사항을 설명하는 커밋 메시지와 함께)을 유지하기 위해 Beancount 파일을 버전 관리 하에 둡니다. 이 접근 방식은 회계 데이터, 특히 개인이나 소규모 사업체의 재무 정보는 투명하고 "미래에도 사용 가능(future-proof)"해야 하며, 독점적인 데이터베이스에 갇혀 있어서는 안 된다는 Beancount의 철학과 일치합니다. 마틴 블레이스의 말에 따르면, Beancount는 커뮤니티를 위해 단순하고, 내구성 있고, 무료로 만들어진 "사랑의 노동(labor of love)"입니다. 이는 2007년경에 처음 개발되었으며, 주요 재작성(v1에서 v2로, 그리고 2024년의 v3)을 통해 미니멀리즘과 정확성이라는 핵심 철학을 유지하면서 설계를 개선해 왔습니다.

Beancount 생태계의 도구, 플러그인 및 확장 기능​

Beancount 생태계는 핵심 원장 기능을 향상시키는 풍부한 도구, 플러그인 및 확장 기능을 갖추게 되었습니다. 이들은 데이터 가져오기, 원장 편집, 보고서 보기, 그리고 전문화된 회계 기능 추가 등을 다룹니다. 다음은 Beancount 세계의 주요 구성 요소 및 애드온에 대한 개요입니다.

데이터 가져오기 유틸리티 (임포터)​

실용적인 사용을 위해 가장 중요한 요구 사항 중 하나는 은행, 신용카드 및 기타 금융 기관에서 거래를 가져오는 것입니다. Beancount는 이를 위해 임포트 프레임워크와 커뮤니티가 기여한 임포트 스크립트를 제공합니다. Beancount 2.x에서는 내장 모듈 beancount.ingest(bean-extract 및 bean-identify와 같은 명령어 포함)를 사용하여 Python으로 임포터 플러그인을 정의하고 다운로드한 명세서에 적용했습니다. Beancount 3.x에서는 이것이 Beangulp라는 외부 프로젝트로 대체되었습니다. Beangulp는 beancount.ingest에서 발전한 전용 임포터 프레임워크이며, 현재 Beancount 3.0의 거래 임포트 자동화를 위한 권장 방법입니다. 이는 외부 파일(CSV나 PDF 명세서 등)을 읽고 Beancount 항목을 출력하는 Python 스크립트나 커맨드 라인 도구를 작성할 수 있게 해줍니다. 이 새로운 접근 방식은 임포트 로직을 Beancount 코어와 분리합니다. 예를 들어, 오래된 bean-extract 명령어는 v3에서 제거되었고, 대신 당신의 임포트 스크립트 자체가 Beangulp의 CLI 인터페이스를 통해 거래를 생성합니다.

다양한 은행과 형식을 위한 수십 개의 기성 임포터가 커뮤니티의 기여로 존재합니다. 중국의 Alipay와 WeChat Pay부터 다양한 유럽 은행(Commerzbank, ING, ABN AMRO 등), 미국의 Chase와 Amex 같은 은행에 이르기까지 전 세계 기관을 위한 임포터 스크립트가 있습니다. 이들 중 다수는 공개 저장소(주로 GitHub)나 beancount-importers와 같은 패키지에 수집되어 있습니다. 예를 들어, Tarioch Beancount Tools 프로젝트(tariochbctools)는 스위스와 영국 은행을 위한 임포터를 제공하며 암호화폐 거래 임포트까지 처리합니다. 또 다른 예는 Lazy Beancount로, 일반적인 임포터 세트(Wise, Monzo, Revolut, IBKR 등)를 패키징하고 쉬운 자동화를 위한 Docker 기반 설정을 제공합니다. 당신이 어떤 은행이나 금융 서비스를 사용하든, 누군가가 그것을 위한 Beancount 임포터를 작성했을 가능성이 높습니다. 그렇지 않다면 Beangulp의 프레임워크를 사용하여 직접 작성할 수 있습니다. Python의 유연성은 임포터가 CSV/Excel 파일 파싱, OFX/QIF 다운로드, 심지어 API 스크래핑까지 처리한 다음, 표준화된 Beancount 형식으로 거래를 내보낼 수 있음을 의미합니다.

편집 및 편집기 통합​

Beancount 원장은 단지 텍스트이기 때문에, 사용자들은 종종 자신이 선호하는 텍스트 편집기나 IDE를 사용하여 관리합니다. 생태계는 이 경험을 더 원활하게 만들기 위해 편집기 지원 플러그인을 제공합니다. 많은 인기 편집기를 위한 확장 기능이 있어 구문 강조, 계정 이름 자동 완성, 실시간 오류 검사 등을 추가합니다.

• Emacs Beancount-Mode: .beancount 파일을 편집하기 위한 Emacs 메이저 모드(beancount-mode)가 있으며, 구문 색상 지정 및 Beancount의 검사기와의 통합과 같은 기능을 제공합니다. 백그라운드에서 bean-check를 실행하여 원장의 오류(예: 불균형 거래)를 편집하는 동안 플래그를 지정할 수도 있습니다.
• VS Code 확장 프로그램: VSCode Marketplace의 Beancount 확장 프로그램은 Visual Studio Code 사용자에게 유사한 편의를 제공합니다. 구문 강조, 금액 정렬, 계정/수취인 자동 완성, 그리고 파일을 저장할 때 즉석 잔액 검사까지 지원합니다. 또한 Fava와 통합되어 VSCode 내에서 Fava 웹 인터페이스를 시작할 수 있습니다.
• Vim, Atom 및 기타 편집기를 위한 플러그인이나 모드도 존재합니다. 예를 들어, Beancount용 Tree-sitter 문법이 있어 최신 편집기에서 구문 강조를 지원하며, Fava의 웹 기반 편집기 컴포넌트에도 채택되었습니다. 요컨대, 당신의 편집 환경이 무엇이든, 커뮤니티는 Beancount 파일 편집을 편리하고 오류 없이 만들기 위한 플러그인을 제공했을 가능성이 높습니다.

전통적인 편집기 외부에서 빠르게 거래를 입력하기 위해, Bean-add와 모바일 앱과 같은 도구도 있습니다. _Bean-add_는 프롬프트나 한 줄 명령어를 통해 새로운 거래를 추가할 수 있게 해주는 커맨드 라인 도구로, 날짜와 계정 제안을 처리합니다. 모바일에서는 Beancount Mobile이라는 프로젝트가 이동 중에 거래를 입력할 수 있는 간단한 인터페이스를 제공합니다(예: 휴대폰에서 현금 구매 기록). 또한, 메시지를 통해 거래를 캡처하는 Beancount Telegram Bot이 존재합니다. 거래 세부 정보와 함께 메시지를 보내면 봇이 이를 원장 파일에 형식화해 줍니다.

웹 프론트엔드 및 시각화 도구​

(Fava) Fava의 웹 인터페이스는 Beancount를 위한 대화형 대시보드를 제공하며, 계정과 잔액 테이블과 함께 시각화된 손익계산서(여기서는 카테고리별 비용의 트리맵으로 표시됨)와 같은 보고서를 특징으로 합니다.

Beancount의 대표적인 프론트엔드는 현대적인 웹 인터페이스인 Fava입니다. Fava는 로컬 웹 앱으로 실행되어 Beancount 파일을 읽고 브라우저에서 풍부한 대화형 경험을 제공합니다. 대차대조표, 손익계산서, 시간 경과에 따른 순자산, 포트폴리오 보유 현황, 성과 차트, 예산 등 모든 보고서 제품군을 기본적으로 제공합니다. 사용자들은 종종 다른 일반 텍스트 회계 도구보다 Beancount를 선택하는 주요 이유로 Fava를 꼽습니다. fava ledger.beancount라는 단일 명령어로, 텍스트 대신 그래프와 표로 재무 상태를 탐색할 수 있습니다. Fava는 다음과 같은 기능을 지원합니다: 계정 드릴다운, 수취인 또는 태그별 거래 필터링, 쿼리 편집기(브라우저에서 Beancount 쿼리를 실행하고 결과를 볼 수 있음), 그리고 원장을 위한 통합 웹 기반 편집기까지. 사용성이 매우 뛰어나 시각적 인터페이스를 선호하는 사람들에게 일반 텍스트 회계를 접근하기 쉽게 만듭니다.

내부적으로 Fava는 Python(백엔드는 Flask)과 JavaScript(프론트엔드는 Svelte)로 작성되었습니다. 자체 출시 주기를 가지며 활발하게 유지 관리됩니다. 특히, Fava는 Beancount의 개발과 보조를 맞추어 왔습니다. 예를 들어, Fava 1.30은 Beancount v3 지원을 추가하여 내부적으로 새로운 beanquery 및 beangulp 패키지를 사용하도록 전환했습니다. (오래된 원장을 위해 Beancount 2도 여전히 지원합니다.) Fava의 사용성에 대한 집중은 웹 편집기의 자동 완성, 다크 모드와 반응형 차트를 갖춘 세련된 UI와 같은 멋진 기능들을 포함합니다. 또한 Fava-GTK라는 파생 프로젝트도 있는데, 이는 Fava를 데스크톱 애플리케이션으로 패키징하여 네이티브 앱 느낌을 선호하는 GNOME/Linux 사용자를 위한 것입니다.

Fava 외에도 다른 시각화 및 분석 옵션이 존재합니다. Beancount 데이터를 테이블로 내보내거나 쿼리할 수 있기 때문에, 사용자들은 종종 Jupyter 노트북이나 Pandas와 같은 도구를 사용하여 사용자 정의 분석을 수행합니다. 예를 들어, 한 사용자는 사용자 정의 보고서를 준비하기 위해 쿼리 인터페이스를 통해 Beancount에서 데이터를 Pandas DataFrame으로 가져온다고 설명합니다. 특정 보고서를 위한 커뮤니티 기여 스크립트도 있습니다. 예를 들어, 포트폴리오 배분 분석 도구나 지출 대 순자산의 공정 관리도 등이 있습니다. 그러나 대부분의 사람들에게 Fava는 코드를 작성할 필요 없이 충분한 보고 기능을 제공합니다. 심지어 확장 기능도 지원합니다: 새로운 보고서 페이지나 차트를 Fava에 추가하는 Python 파일을 드롭인할 수 있습니다. 주목할 만한 확장 기능은 Fava 내에서 봉투 예산 관리를 위한 fava-envelope입니다. 전반적으로 Fava는 Beancount 생태계의 중앙 시각화 허브 역할을 합니다.

커맨드 라인 유틸리티 및 스크립트​

Beancount는 다양한 CLI 도구와 함께 제공됩니다(특히 오래된 v2 브랜치에서, 일부는 v3에서 정리되었습니다). 이 도구들은 원장 파일을 조작하여 확인하거나 특정 보고서를 텍스트나 HTML로 생성합니다.

• bean-check: 파일의 구문 오류나 회계 오류를 확인하는 검사기입니다. bean-check myfile.beancount를 실행하면 불균형, 누락된 계정 또는 기타 문제를 알려주고, 파일에 오류가 없으면 아무것도 출력하지 않습니다.
• bean-format: 소스 코드에 코드 포맷터를 실행하는 것과 같이 숫자를 깔끔한 열로 정렬하여 원장을 정리하는 포맷터입니다. 파일을 깨끗하고 읽기 쉽게 유지하는 데 도움이 됩니다.
• bean-query: 원장에 대한 Beancount의 쿼리 언어를 실행하기 위한 대화형 셸 또는 배치 도구입니다. 사용자 정의 테이블 형식 보고서를 생성하는 데 사용할 수 있습니다(예: bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: 미리 정의된 보고서(대차대조표, 손익계산서, 시산표 등)를 콘솔이나 파일로 출력할 수 있는 다용도 보고서 생성기(v2에서)입니다. 예를 들어, bean-report file.beancount balances는 계정 잔액을 인쇄합니다. (실제로 이러한 텍스트 보고서 중 다수는 Fava의 더 나은 프레젠테이션으로 대체되었습니다.)
• bean-web / bean-bake: localhost에서 보고서를 제공하거나 정적 HTML 파일로 "굽는(bake)" 오래된 웹 인터페이스입니다. 이들은 주로 Fava가 인기를 얻기 전에 사용되었습니다. bean-web은 bean-report가 생성할 수 있는 것과 동일한 보고서의 기본 웹 뷰를 제공했습니다. Beancount 3에서는 bean-web이 제거되었습니다(Fava가 이제 권장되는 웹 프론트엔드이며 우수한 경험을 제공하기 때문입니다).
• bean-example: 예제 원장 파일을 생성하는 유틸리티입니다(새로운 사용자가 Beancount 항목의 템플릿을 보는 데 유용합니다).
• bean-doctor: 원장이나 환경의 문제를 진단할 수 있는 디버깅 도구입니다.

Beancount v3부터 이러한 도구 중 다수가 핵심 프로젝트에서 분리되었다는 점은 주목할 가치가 있습니다. 핵심 Beancount 패키지는 간소화되었고, 쿼리 엔진 및 임포터와 같은 도구는 유지 관리를 용이하게 하기 위해 별도의 패키지(beanquery, beangulp 등)로 분리되었습니다. 예를 들어, bean-query의 기능은 이제 별도로 설치되는 beanquery 도구에 의해 제공됩니다. 사용자 관점에서 기능은 여전히 사용 가능하지만, 모듈화된 것뿐입니다. Arch Linux 커뮤니티는 Fava를 업데이트할 때 이 변경 사항을 주목했습니다: Fava 패키지는 Beancount 3.x를 지원하기 위해 beanquery와 beangulp에 대한 의존성을 추가했습니다. 이 모듈식 접근 방식은 또한 커뮤니티의 다른 사람들이 Beancount의 출시 주기와는 독립적으로 이러한 보조 도구에 더 쉽게 기여할 수 있게 합니다.

Beancount 플러그인 및 확장 기능​

Beancount 생태계의 뛰어난 강점 중 하나는 플러그인 시스템입니다. Beancount 파일에 plugin "module.name" 줄을 추가함으로써, 원장 처리 중에 실행되는 사용자 정의 Python 로직을 통합할 수 있습니다. 커뮤니티는 Beancount의 기능을 확장하기 위해 많은 플러그인을 만들었습니다.

• 데이터 품질 및 규칙: 예를 들어, 여러 계정을 포함하는 방정식을 주장할 수 있게 해주는 beancount-balexpr(예: 자산 A + 자산 B = 부채 X), 그리고 계정을 닫을 때 자동으로 잔액 검증을 삽입하여 순액이 0이 되도록 보장하는 beancount-checkclosed가 있습니다. 파일의 거래가 날짜순으로 정렬되었는지 확인하여 순서가 맞지 않는 항목을 잡아내는 플러그인(autobean.sorted)도 있습니다.
• 자동화: beancount-asset-transfer 플러그인은 계정 간에 현물 이체 항목을 생성할 수 있습니다(원가 기준을 유지하면서 브로커 간에 주식을 옮기는 데 유용합니다). 또 다른 플러그인인 autobean.xcheck는 불일치를 찾기 위해 Beancount 원장을 외부 명세서와 교차 확인합니다.
• 반복 거래 및 예산: Akuukis의 "repeat" 또는 보간 플러그인은 반복 거래를 정의하거나 연간 비용을 월별로 분산할 수 있게 해줍니다. 예산 관리를 위해, fava-envelope 확장 기능(Fava를 통해 사용)은 일반 텍스트로 봉투 예산 관리 방법론을 지원합니다. Frank Davies의 MiniBudget도 있습니다. 이는 개인 또는 소규모 사업체 예산 관리를 돕기 위해 Beancount에서 영감을 받은 작은 독립형 도구입니다.
• 세금 및 보고: 일부 플러그인은 세금 회계에 도움이 됩니다. 예를 들어, 자본 이득을 자동으로 단기 대 장기로 분류하는 플러그인이 있습니다. 또 다른 플러그인(fincen_114, Justus Pendleton 제작)은 해외 계좌를 가진 미국 납세자를 위한 FBAR 보고서를 생성하여 Beancount 데이터가 규제 보고에 어떻게 활용될 수 있는지를 보여줍니다.
• 커뮤니티 플러그인 저장소: 감가상각 항목 등에 초점을 맞춘 beancount-plugins(Dave Stephens 제작)와 정렬 지시어와 같은 다양한 도우미를 포함하는 beancount-plugins-zack(Stefano Zacchiroli 제작)과 같은 큐레이션된 플러그인 세트가 있습니다.

플러그인 외에도, Beancount를 중심으로 한 다른 유틸리티 도구들이 특정 요구를 해결합니다. 예를 들어, beancount-black은 Black 코드 포맷터와 유사하지만 Beancount 원장 파일을 위한 자동 포맷터입니다. 앞서 언급했듯이 채팅을 통해 거래를 추가하기 위한 Beancount Bot(Telegram/Mattermost)이 있으며, macOS용 Alfred 워크플로우를 사용하여 파일에 거래를 빠르게 추가할 수 있습니다. Pinto라는 도구는 대화형 입력(향상된 bean-add와 같은)을 갖춘 "강화된" CLI를 제공합니다. 다른 시스템에서 마이그레이션하는 사람들을 위해, 다른 곳에서 데이터를 가져오는 데 도움이 되는 변환기(YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount)가 존재합니다.

요약하자면, Beancount 생태계는 매우 광범위합니다. 아래 표 1은 주요 도구와 확장 기능 및 그 역할을 나열합니다.

Ledger, hledger 및 유사 시스템과의 비교​

Beancount는 일반 텍스트 복식 부기 회계 도구 제품군에 속하며, 그중에서도 Ledger CLI(존 위글리의 Ledger)와 hledger가 두드러집니다. 이 모든 시스템은 일반 텍스트 원장 파일과 복식 부기라는 핵심 아이디어를 공유하지만, 구문, 철학, 생태계 성숙도에서 차이가 있습니다. 다음 표는 Beancount, Ledger, hledger 간의 주요 차이점을 강조합니다.

요약하자면, Beancount는 엄격함, 플러그인 기반 확장성, 그리고 사용자 친화적인 웹 인터페이스를 강조함으로써 차별화됩니다. Ledger는 커맨드 라인 순수주의자들과 최고의 속도를 필요로 하는 사람들(Ledger의 C++ 엔진은 거대한 파일에서 매우 빠름)이 선호하는 고전적이고 매우 유연한 도구로 남아 있습니다. hledger는 중간 지점을 제공합니다 – Ledger의 기능 대부분을 약간 더 구조화하고 공식적으로 지원되는 (단순하지만) 웹 UI와 함께 제공합니다. 세 가지 모두 일반 텍스트 회계의 장점(감사 가능성, Git 버전 관리, 일반 데이터)을 공유하지만, Beancount의 생태계(특히 Fava와 함께)는 최근 몇 년 동안 일반 사용자가 더 접근하기 쉽게 만들었다고 할 수 있습니다. 반면에 Ledger/hledger 사용자들은 때때로 설정의 상대적 단순함(Python 불필요)과 오랜 기간 입증된 안정성을 선호합니다. 궁극적으로 이들 사이의 선택은 개인적인 선호에 달려 있습니다. 엄격한 정확성과 풍부한 생태계를 중시하는 사람들은 Beancount로 기울어지는 반면, 가볍고 터미널 중심적인 도구를 원하는 사람들은 Ledger나 hledger를 고수할 수 있습니다.

Beancount 사용 시나리오​

Beancount는 개인 재무 추적뿐만 아니라 (경우에 따라) 소규모 사업 회계에도 사용할 수 있을 만큼 다재다능합니다. 핵심 복식 부기 접근 방식은 두 시나리오에서 동일하지만, 규모와 특정 관행은 다를 수 있습니다.

개인 재무​

많은 Beancount 사용자는 개인 또는 가계 재무를 관리하기 위해 이를 사용합니다. Beancount의 일반적인 개인 재무 설정에는 당좌 및 저축 예금 계좌, 신용카드, 투자, 대출, 소득 카테고리(급여, 이자 등), 그리고 비용 카테고리(임대료, 식료품, 오락 등)가 포함될 수 있습니다. 사용자들은 일상적인 거래를 수동으로 기록하거나(영수증, 청구서 등 입력) 앞서 논의한 임포터 도구를 사용하여 은행 명세서에서 가져옵니다. Beancount가 개인 재무에 가져다주는 이점은 다음과 같습니다.

• 통합 및 분석: 모든 거래가 수년간의 금융 기록을 나타내는 단일 텍스트 파일(또는 파일 세트)에 저장될 수 있습니다. 이를 통해 장기적인 추세를 쉽게 분석할 수 있습니다. Beancount의 쿼리 언어나 Fava를 사용하면 "지난 5년간 여행에 얼마나 썼나?" 또는 "월평균 식료품비는 얼마인가?"와 같은 질문에 몇 초 만에 답할 수 있습니다. 한 사용자는 Beancount로 전환한 후, Fava를 통하거나 데이터를 쿼리하고 Pandas와 같은 도구를 사용하여 _"금융 데이터(지출, 기부, 세금 등) 분석이 사소해졌다"_고 언급했습니다. 본질적으로, 당신의 원장은 마음대로 쿼리할 수 있는 개인 금융 데이터베이스가 됩니다.
• 예산 및 계획: Beancount가 예산 시스템을 강제하지는 않지만, 구현할 수는 있습니다. 일부 사용자는 예산 계정을 만들거나 fava-envelope 플러그인을 사용하여 봉투 예산 관리를 합니다. 다른 사람들은 단순히 주기적인 보고서를 사용하여 지출을 목표와 비교합니다. 일반 텍스트이기 때문에, Beancount를 외부 예산 도구나 스프레드시트와 통합하는 것은 간단합니다(데이터를 내보내거나 쿼리에서 CSV 출력을 사용).
• 투자 및 순자산 추적: Beancount는 원가 기준 및 시장 가격을 강력하게 처리하기 때문에 투자 추적에 탁월합니다. 주식, 암호화폐 등의 매수/매도를 원가 세부 정보와 함께 기록한 다음, Prices 지시어를 사용하여 시장 가치를 추적할 수 있습니다. Fava는 시간 경과에 따른 순자산 차트와 자산 클래스별 포트폴리오 분석을 보여줄 수 있습니다. 이는 개인 자산 관리에 매우 유용합니다. Mint나 Personal Capital과 같은 상용 도구가 제공하는 것과 유사한 통찰력을 얻을 수 있지만, 완전히 자신의 통제 하에 있습니다. 다중 통화 처리도 내장되어 있어, 외화나 암호화폐를 보유하고 있다면 Beancount가 이를 추적하고 보고를 위해 변환할 수 있습니다.
• 대조 및 정확성: 개인 재무는 종종 은행 명세서와의 대조를 포함합니다. Beancount를 사용하면 잔액 검증이나 문서 기능을 사용하여 정기적으로 계정을 대조할 수 있습니다. 예를 들어, 매월 balance Assets:Bank:Checking <날짜> <잔액> 항목을 추가하여 원장이 월말 은행 명세서와 일치하는지 확인할 수 있습니다. bean-check 도구(또는 Fava의 오류 표시)는 일치하지 않는 경우 경고합니다. 한 사용자는 모든 계정을 매월 대조하는데, 이는 "어떤 비정상적인 활동도 잡아내는 데 도움이 된다"고 언급했습니다. 이는 Beancount가 촉진하는 좋은 개인 재무 위생 관행입니다.
• 자동화: 기술에 능숙한 개인들은 Beancount로 개인 재무 워크플로우의 상당 부분을 자동화했습니다. 임포터, cron 작업, 그리고 약간의 Python을 사용하여, 예를 들어 매일 은행 거래가 가져와져(일부는 OFX나 API 사용) 규칙에 따라 분류되어 Beancount 파일에 추가되도록 시스템을 설정할 수 있습니다. 시간이 지남에 따라 원장은 대부분 자동으로 업데이트되며, 필요에 따라 검토하고 조정하기만 하면 됩니다. 해커 뉴스(Hacker News)의 한 커뮤니티 회원은 3년 후 자신의 Beancount 장부가 "95% 자동화"되었다고 공유했습니다. 이러한 수준의 자동화는 Beancount의 일반 텍스트 개방성과 스크립팅 기능 덕분에 가능합니다.

개인 재무 사용자들은 스프레드시트나 앱보다 Beancount를 선택하는 경우가 많은데, 이는 데이터에 대한 완전한 소유권을 부여하고(폐쇄될 수 있는 클라우드 서비스에 의존하지 않음 – 예를 들어 Mint가 중단된 것과 같은 우려) 모든 데이터가 통합되었을 때 통찰력의 깊이가 더 크기 때문입니다. 학습 곡선은 간단하지 않습니다 – 기본적인 회계와 Beancount 구문을 배워야 하지만, 공식 문서와 커뮤니티 튜토리얼과 같은 자료들이 신규 사용자의 시작을 돕습니다. 일단 설정되면, 많은 사람들은 항상 자신의 재무 상태를 명확하고 신뢰할 수 있는 그림으로 볼 수 있다는 점에서 마음의 평화를 얻는다고 합니다.

소규모 사업 회계​

소규모 사업체(또는 비영리 단체, 클럽 등)에 Beancount를 사용하는 것은 개인적인 사용보다 덜 일반적이지만, 확실히 가능하며 일부는 성공적으로 해냈습니다. Beancount의 복식 부기 프레임워크는 사실상 기업 회계를 뒷받침하는 것과 동일한 시스템이지만, 전용 회계 소프트웨어가 제공하는 일부 상위 수준 기능(송장 모듈이나 급여 통합 등)이 없습니다. 다음은 Beancount가 소규모 사업 환경에 어떻게 부합할 수 있는지에 대한 설명입니다.

• 총계정원장 및 재무제표: 소규모 사업체는 Beancount 파일을 총계정원장으로 취급할 수 있습니다. 은행 계좌, 매출채권, 재고자산에 대한 자산 계정; 신용카드, 대출, 매입채무에 대한 부채 계정; 소유주 자본에 대한 자본 계정; 매출이나 서비스에 대한 수입 계정; 모든 사업 비용에 대한 비용 계정을 가질 수 있습니다. 이 원장을 유지함으로써, Beancount의 보고서나 쿼리를 사용하여 언제든지 손익계산서(P&L)와 대차대조표를 생성할 수 있습니다. 실제로, Beancount의 내장 보고서나 Fava는 회계 원칙에 완벽하게 부합하는 대차대조표와 P&L을 몇 초 만에 생성할 수 있습니다. 이는 소규모 사업체가 수익성, 재무 상태, 현금 흐름을 평가하기에 충분할 수 있습니다(현금 흐름표는 직접 내장되어 있지 않지만 쿼리를 통해 도출할 수 있음).
• 송장 및 매출채권(A/R), 매입채무(A/P): Beancount에는 내장된 송장 시스템이 없습니다. 사용자들은 일반적으로 외부에서 송장을 처리하고(예: Word나 송장 앱에서 송장 생성) 그 결과를 Beancount에 기록합니다. 예를 들어, 송장을 발행하면 매출채권을 차변에, 수입을 대변에 기록하는 항목을 기록합니다. 지불이 들어오면 현금/은행을 차변에, 매출채권을 대변에 기록합니다. 이런 식으로, A/R 계정의 잔액을 보고 미수금을 추적할 수 있습니다. 청구서(A/P)에도 동일하게 적용됩니다. 전문 회계 소프트웨어(알림을 보내거나 이메일과 통합할 수 있음)보다 수동적이지만, 완벽하게 가능합니다. 일부 사용자들은 Beancount로 송장을 관리하고 미결 송장을 놓치지 않도록 하는 방법에 대한 템플릿이나 워크플로우를 공유했습니다(예: 메타데이터나 사용자 정의 쿼리를 사용하여 미지급 송장 목록을 만듦).
• 재고 또는 매출원가(COGS): 제품을 판매하는 사업체의 경우, Beancount는 재고 구매 및 판매를 추적할 수 있지만, 규율 있는 항목 입력이 필요합니다. Inventory 및 원가 회계 기능을 사용할 수 있습니다: 재고 구매는 자산 계정을 증가시키고(항목에 원가 첨부), 판매는 원가를 비용(COGS)으로 이동시키고 수익을 기록합니다. Beancount는 로트 일치를 주장하기 때문에, 올바른 원가로 재고를 적절히 감소시키도록 강제하며, 이는 올바르게 수행될 경우 총이익 계산이 정확함을 보장할 수 있습니다. 그러나 자동화된 SKU 추적 같은 것은 없습니다 – 모든 것이 재무 수준(수량 및 원가)에서 이루어집니다.
• 급여 및 복잡한 거래: Beancount는 급여 거래(급여 비용, 세금 원천징수 등)를 기록할 수 있지만, 해당 수치를 계산하는 것은 외부에서 또는 다른 도구를 통해 수행된 다음 Beancount에 기장될 수 있습니다. 매우 작은 사업체(예: 한두 명의 직원)의 경우, 이는 관리 가능합니다. 예를 들어, 급여, 원천징수세, 고용주 세금 비용, 현금 지급 등을 분할하는 단일 분개 항목을 각 급여 기간마다 기록할 것입니다. 이를 수동으로 하는 것은 QuickBooks 분개 항목에서 하는 것과 유사합니다 – 어떤 계정을 사용해야 하는지에 대한 지식이 필요합니다.
• 다중 사용자 및 감사: 사업 환경에서의 한 가지 과제는 여러 사람이 장부에 접근해야 하거나 회계사가 검토해야 하는 경우입니다. Beancount는 텍스트 파일이므로 실시간으로 다중 사용자가 사용할 수 없습니다. 그러나 Git 저장소에서 파일을 호스팅하면 협업이 가능해집니다: 각 사람이 편집하고 커밋할 수 있으며, 차이점을 병합할 수 있습니다.
• 규제 준수: 세금 신고나 준수를 위해, Beancount의 데이터를 사용하여 필요한 보고서를 생성할 수 있지만, 사용자 정의 쿼리나 플러그인이 필요할 수 있습니다. 인도 정부 준수 보고를 위한 커뮤니티 플러그인과 FinCEN FBAR 보고를 위한 플러그인의 예를 보았습니다. 이는 노력만 있다면 Beancount가 특정 보고 요구 사항을 충족하도록 조정될 수 있음을 보여줍니다. 간단한 요구 사항(현금 회계 또는 기본 발생주의)을 가진 관할권의 소규모 사업체는 확실히 Beancount에서 장부를 유지하고 세금 신고를 위한 재무제표를 생성할 수 있습니다. 그러나 감가상각 일정이나 상각과 같은 기능은 자체적으로 항목을 작성하거나 플러그인을 사용해야 할 수 있습니다(예를 들어 Dave Stephens의 감가상각 플러그인이 이를 자동화하는 데 도움이 됩니다). 일부 회계 소프트웨어처럼 "자산 감가상각 클릭"과 같은 GUI는 없습니다. 감가상각을 거래로 인코딩해야 합니다(이는 어떤 면에서는 그것을 명확하게 만듭니다 – 모든 것이 검사할 수 있는 항목입니다).

실제로, 많은 기술 지향적인 소규모 사업주들은 QuickBooks의 편리함보다 통제와 투명성을 선호한다면 Beancount(또는 Ledger/hledger)를 사용해 왔습니다. Reddit의 한 토론에서는 거래량이 제한적인 표준 소규모 사업 회계의 경우 Beancount가 잘 작동한다고 언급했습니다. 제한 요소는 대개 편안함 수준입니다 – 사업주(또는 회계사)가 텍스트 기반 도구에 익숙한지 여부입니다. 한 가지 장점은 비용입니다: Beancount는 무료이지만, 회계 소프트웨어는 소규모 사업체에게 비용이 많이 들 수 있습니다. 반면에, 공식적인 지원 부족과 DIY 특성은 사업주이면서 어느 정도 기술적으로 능숙한 사람들에게 가장 적합하다는 것을 의미합니다. 프로그래밍 기술을 가진 프리랜서나 개인 사업자에게 Beancount는 클라우드 회계 서비스에 의존하지 않고 재무를 관리할 수 있는 매력적인 선택이 될 수 있습니다.

하이브리드 접근 방식도 가능합니다. 일부 소규모 사업체는 송장이나 급여를 위해 공식 시스템을 사용하지만, 분석 및 보관을 위해 주기적으로 데이터를 Beancount로 가져옵니다. 이런 식으로 그들은 두 세계의 장점을 모두 얻습니다 – 일상적인 운영을 위한 준수와 용이성, 그리고 통합된 통찰력을 위한 Beancount의 힘입니다.

요약하자면, Beancount는 사용자가 상용 소프트웨어가 자동화하는 것들을 수동으로 관리할 의향이 있다면 소규모 사업 회계를 처리할 수 있습니다. 이는 높은 수준의 투명성을 보장하며 – 장부를 직접 작성하기 때문에 깊이 이해하게 됩니다 – 부지런한 사용자에게는 흠잡을 데 없는 장부를 만들어낼 수 있습니다. 개인 및 사업 사용자 모두 Beancount의 핵심 강점으로부터 이익을 얻습니다: 신뢰할 수 있는 회계 엔진, 완전한 감사 추적, 그리고 독특한 시나리오에 적응할 수 있는 유연성(스크립팅 및 플러그인을 통해). 가계 예산을 추적하든 스타트업의 재무를 추적하든, Beancount는 정밀하고 개방적으로 이를 수행할 수 있는 도구 키트를 제공합니다.

커뮤니티 및 개발 활동​

Beancount는 헌신적인 커뮤니티와 그 오픈소스, 틈새 시장이지만 열정적인 특성을 반영하는 개발 스토리를 가지고 있습니다. 다음은 커뮤니티, 유지 관리자 및 관련 프로젝트에 대한 주요 사항입니다.

• 프로젝트 유지 관리: Beancount의 주요 저자는 마틴 블레이스(Martin Blais)로, 2007년경에 프로젝트를 시작하여 여러 버전을 거쳐 이끌어왔습니다. 오랫동안 개발은 대부분 1인 노력(커뮤니티의 패치 기여 제외)이었습니다. 마틴의 철학은 "가장 단순하고 내구성 있는 방식으로, 나 자신과 다른 사람들에게 유용한" 회계 도구를 만드는 것이었습니다. 이 개인적인 동기가 프로젝트를 사랑의 노동으로 계속 이끌었습니다. 2025년 현재, 마틴 블레이스는 여전히 수석 유지 관리자이며(그의 이름이 커밋에 나타나고 메일링 리스트/이슈 트래커에서 질문에 답함), Beancount 주변 생태계에는 각자의 프로젝트에서 많은 다른 기여자들이 있습니다.

• GitHub 및 저장소: 소스 코드는 GitHub의 beancount/beancount 저장소에서 호스팅됩니다. 프로젝트는 GPL-2.0 라이선스이며 수년에 걸쳐 소수의 기여자를 유치했습니다. 2024년 중반, Beancount 버전 3이 새로운 안정 브랜치로 공식 출시되었습니다. 이 릴리스는 일부 구성 요소를 분리하는 것을 포함했습니다. 예를 들어, beangulp 저장소(임포터용)와 beanquery 저장소(쿼리 도구용)는 이제 beancount GitHub 조직의 일부이며, 다소 독립적으로 유지 관리됩니다. 주요 Beancount 저장소는 핵심 회계 엔진과 파일 파서에 중점을 둡니다. 2025년 현재, Beancount의 GitHub는 활발한 이슈 토론과 일부 진행 중인 개발을 보여줍니다 – 비록 많은 양은 아니지만, 이슈와 풀 리퀘스트가 꾸준히 들어오고 버그 수정이나 기능 개선을 위한 가끔의 업데이트가 이루어집니다.

• Fava 개발: 웹 인터페이스인 Fava는 별도의 프로젝트로 시작되었습니다(2016년에 저작권을 등록한 도미닉 오마이어가 제작). 자체 커뮤니티 기여자들이 있으며 GitHub의 beancount/fava 아래에 있습니다. Fava의 유지 관리자들과 기여자들(예: 최근 몇 년간 야콥 슈네츠, 슈테판 오테 등)은 인터페이스를 활발히 개선하고 있으며, 몇 달에 한 번씩 릴리스됩니다. Fava의 Gitter 채팅(Fava 문서에 링크됨)과 GitHub 이슈 트래커는 사용자와 개발자가 새로운 기능이나 버그를 논의하는 장소입니다. 프로젝트는 기여를 환영하며, 이는 여러 커뮤니티 구성원에게 PR에 대한 감사를 표하는 CHANGELOG 노트에서 증명됩니다. Beancount v3 및 새로운 beanquery 구문 지원을 신속하게 추가하는 등 Beancount 개발과의 긴밀한 연계는 두 프로젝트 간의 좋은 협업을 나타냅니다.

• 메일링 리스트 및 포럼: Beancount는 공식 메일링 리스트(이전에는 Google 그룹스, "Beancount" 또는 때때로 일반 Ledger 리스트에서 논의됨)를 가지고 있습니다. 이 메일링 리스트는 지식의 보고입니다 – 사용자들은 특정 시나리오를 모델링하는 방법, 버그 보고, 팁 공유에 대해 질문합니다. 마틴 블레이스는 메일링 리스트에서 상세한 설명으로 응답하는 것으로 알려져 있습니다. 또한, 더 넓은 일반 텍스트 회계 커뮤니티와 많이 겹칩니다. Ledger CLI 메일링 리스트는 종종 Beancount에 대한 질문도 다루며, plaintextaccounting.org의 포럼과 r/plaintextaccounting 서브레딧에서 Beancount 주제가 자주 올라옵니다. 이 플랫폼의 사용자들은 비교, 개인 설정 공유, 신규 사용자 돕기 등을 논의합니다. 커뮤니티의 일반적인 분위기는 매우 협조적입니다 – Beancount 사용자는 종종 Ledger 사용자를 돕고 그 반대도 마찬가지이며, 모든 도구가 비슷한 목표를 가지고 있음을 인식합니다.

• 채팅 그룹: 메일링 리스트 외에도 Plaintext Accounting Slack/Discord(커뮤니티 조직) 및 Fava Gitter와 같은 채팅 채널이 있습니다. 이는 도움을 받거나 기능을 논의하는 덜 공식적이고 더 실시간적인 방법입니다. 예를 들어, 누군가 특정 은행의 임포터가 있는지 묻기 위해 Slack에 참여할 수 있습니다. 또한 일부 오랜 사용자들이 머무는 Matrix/IRC 채널(역사적으로 IRC의 #ledger 또는 #beancount)도 있습니다. 주류 소프트웨어 커뮤니티만큼 인구가 많지는 않지만, 이 채널들에는 종종 까다로운 회계 질문에 답할 수 있는 지식이 풍부한 사람들이 있습니다.

• 기여자 및 주요 커뮤니티 구성원: Beancount 커뮤니티에서 몇몇 이름이 두드러집니다.

  • "Redstreet" (Red S): 많은 플러그인(beancount-balexpr, sellgains 등)을 작성하고 종종 지원을 제공하는 다작의 기여자. 또한 임포터 스크립트 세트와 명세서를 가져오는 bean-download라는 도구를 유지 관리합니다.
  • Vasily M (Evernight): 일부 임포터 프레임워크와 beancount-valuation과 같은 플러그인의 저자이며, 투자 관련하여 Fava에 기여했습니다.
  • Stefano Zacchiroli (zack): Emacs용 beancount-mode와 자신의 플러그인 저장소를 만든 Debian 개발자. 학술 환경에서도 일반 텍스트 회계를 옹호해 왔습니다.
  • Simon Michael: 주로 hledger의 리더이지만, Beancount를 포함하는 plaintextaccounting.org를 운영합니다. 이 교차 수분은 Ledger/hledger 사용자들의 관심을 Beancount로 이끄는 데 도움이 되었습니다.
  • Frank hell (Tarioch): 특히 유럽 기관을 위한 주요 임포터 및 가격 수집기 세트인 Tarioch Beancount Tools의 기여자.
  • Siddhant Goel: Beancount에 대해 블로그를 쓰는(예: v3로 마이그레이션하는 가이드) 커뮤니티 회원이며 일부 임포터를 유지 관리합니다. 그의 블로그 게시물은 많은 신규 사용자에게 도움이 되었습니다.

  이들과 다른 많은 사람들이 코드, 문서, 포럼에서의 도움을 통해 생태계를 활기차게 만듭니다.

• GitHub 통계 및 포크: Beancount의 GitHub 저장소는 수백 개의 스타(관심도 표시)와 포크를 축적했습니다. Beancount 자체의 주목할 만한 포크는 드뭅니다 – "Beancount이지만 기능 X가 있는" 것을 시도하는 잘 알려진 분기된 포크는 없습니다. 대신, 사용자들이 다른 것을 원했을 때, 그들은 플러그인을 작성하거나 다른 도구(hledger 등)를 사용했으며 Beancount를 포크하지는 않았습니다. hledger는 Ledger의 일종의 포크(Beancount가 아님)로, Beancount 자체는 Ledger 아이디어의 독립적인 재해석으로 간주될 수 있지만, Beancount 저장소 내에는 큰 분열 프로젝트가 없습니다. 커뮤니티는 일반적으로 주요 저장소를 중심으로 모여 코드베이스를 분열시키는 대신 플러그인 인터페이스를 통해 확장했습니다. 이는 마틴 블레이스가 외부 기여에 개방적이었고(그의 문서에는 외부 기여 및 모듈을 인정하는 섹션도 있음) 플러그인 아키텍처가 대부분의 새로운 기능을 위해 포크를 유지할 필요가 없게 만들었기 때문일 것입니다.

• 커뮤니티 리소스: 커뮤니티에서 만든 Beancount 학습 및 사용을 위한 몇 가지 고품질 리소스가 있습니다.

  • GitHub Pages의 Beancount 문서(및 마틴이 유지 관리하는 소스 Google Docs) – 회계 이론과 Beancount가 이를 어떻게 구현하는지 포함하여 매우 포괄적입니다.
  • 수많은 블로그 게시물 및 개인 노트 – 예: LWN.net에는 "Counting beans... with Beancount"라는 기사가 있었고, 많은 개인 블로그(Awesome Beancount의 "블로그 게시물" 섹션에 나열됨)가 경험과 팁을 공유합니다. 이는 지식을 구축하고 새로운 사용자를 유치하는 데 도움이 됩니다.
  • 강연 및 프레젠테이션: Beancount는 밋업과 컨퍼런스에서 발표되었습니다(예: Python/Beancount로 재무 관리에 대한 PyMunich 2018 강연). 이러한 강연은 도구를 더 넓은 청중에게 소개하고 종종 해커 뉴스와 같은 포럼에서 관심을 불러일으킵니다.

• 주목할 만한 관련 프로젝트: Fava 외에도 Beancount와 관련된 일부 다른 프로젝트에는 자체 커뮤니티가 있습니다.

  • Plain Text Accounting 사이트 – 사이먼 마이클이 유지 관리하며, 모든 관련 도구에 대한 정보를 집계하고 사람들이 Beancount를 포함한 다양한 도구의 사용법을 공유하는 포럼이 있습니다.
  • 금융 도구 통합: 일부 사용자는 Beancount를 비즈니스 인텔리전스 도구나 데이터베이스와 통합합니다. 예를 들어, 한 Google 그룹스 스레드는 사용자 정의 함수를 통해 PostgreSQL을 Beancount 데이터와 함께 사용하는 방법을 자세히 설명합니다. 주류는 아니지만, 이는 커뮤니티가 Beancount의 기능(예: 매우 큰 데이터 세트나 내장된 것 이상의 복잡한 쿼리 처리)을 확장하려는 실험 정신을 보여줍니다.

요약하자면, Beancount의 커뮤니티는 대규모 오픈소스 프로젝트보다 작지만 매우 참여도가 높고 지식이 풍부합니다. 프로젝트는 꾸준한 개선과 매우 유용한 지원 채널을 누리고 있습니다. 협력적인 정신(임포터 공유, 플러그인 작성, 질문에 답변)은 2025년의 신규 사용자가 회계 시스템을 설정하기 위해 광범위한 이전 작업과 커뮤니티의 지혜에 의존할 수 있음을 의미합니다. 개발은 생태계 차원에서 활발합니다 – Fava 릴리스, 플러그인 개발 등 – 비록 핵심 변경이 더 드물더라도 말입니다. 생태계의 성장(Awesome Beancount 목록에 있는 수십 개의 도구로 입증됨)은 Beancount를 더욱 유능하게 만드는 건강한 커뮤니티를 말해줍니다.

최근 개발 및 예정된 기능​

2025년 현재, Beancount 생태계는 지난 몇 년간 상당한 발전을 보였으며, 미래의 개선에 대한 논의가 진행 중입니다. 다음은 주목할 만한 최근 개발 사항과 앞으로 나올 기능에 대한 간략한 전망입니다.

• Beancount 3.0 출시 (2024년): Beancount 2.x가 오랫동안 표준이었던 후, 버전 3가 2024년 중반에 공식적으로 출시되었습니다. v3는 코드베이스의 단순화와 현대화를 나타내기 때문에 이는 주요 이정표였습니다. 마틴 블레이스는 v3를 시스템을 더욱 "재정렬하고 단순화"할 기회로 구상했습니다. 원래는 큰 재작성이 될 것으로 생각되었지만, 실제로는 사용자에게 미치는 업데이트는 그다지 파괴적이지 않았습니다. 주요 변경 사항은 _내부적인 것_이었습니다: 새로운 파서, 일부 성능 개선, 그리고 핵심에서 선택적 구성 요소를 추출한 것입니다. 릴리스는 점진적으로 진행되었으며(v3는 2022년부터 베타였지만, 2024년 7월까지 권장 안정 버전이 됨), Siddhant Goel과 같은 사용자들은 2.x에서 3.x로의 마이그레이션이 몇 가지 워크플로우 변경만으로 "대부분 무난했다"고 보고했습니다.

• 모듈화 – 도구들이 별도 패키지로 이동: Beancount 3의 큰 변화 중 하나는 모놀리식 저장소에 있던 많은 도구들이 분리되었다는 것입니다. 예를 들어, bean-query는 이제 beanquery 패키지에서 제공되며, beancount.ingest는 beangulp 패키지로 대체되었습니다. bean-extract 및 bean-identify와 같은 명령어(임포트용)는 핵심 Beancount에서 제거되었습니다. 대신, 임포트를 위해 독립적인 스크립트를 사용하는 것이 철학입니다. 이는 v3로 업그레이드하면 beangulp를 설치하고 임포터 스크립트(각 임포터는 기본적으로 작은 프로그램임)를 실행해야 한다는 것을 의미하며, 중앙 bean-extract 설정 파일을 사용하는 대신입니다. 마찬가지로, 쿼리는 Beancount 코어와 독립적으로 설치하고 업데이트할 수 있는 beanquery를 통해 실행됩니다. 이 모듈식 접근 방식은 유지 관리를 더 쉽게 하고 커뮤니티 기여를 장려하기 위해 설계되었습니다. 또한 Beancount의 핵심을 간소화하여, 핵심은 순수하게 파싱 및 회계 로직에 집중하고 보조 기능은 별도로 발전할 수 있게 했습니다. 사용자 관점에서, 업그레이드 후에는 명령어(예: beanquery에서 bean-query 사용, 또는 이를 추상화하는 Fava 사용)를 조정해야 합니다. Fava의 변경 로그는 이러한 변경 사항을 명시적으로 언급합니다: Fava는 이제 beanquery와 beangulp에 의존하며, Beancount 3 대 2에 대해 임포트 워크플로우를 다르게 처리합니다.

• 성능 개선: 성능은 Beancount의 설계를 재검토하는 동기 중 하나였습니다. v3 계획(마틴의 "V3 목표" 문서에 요약됨)에는 파서 최적화와 로딩 프로세스를 더 빠르고 메모리 집약도를 낮추는 것이 포함되었습니다. 2025년까지 이러한 개선 사항 중 일부가 실현되었습니다. 일화적으로, 매우 큰 원장(수만 건의 거래 또는 많은 주식 거래)을 가진 사용자들은 최신 버전에서 더 나은 성능을 보고했습니다. 예를 들어, "소액 투자 거래"를 다루면서 성능 문제에 직면했던 한 사용자는 Google 그룹스에서 이러한 우려를 언급했으며, 이러한 피드백이 v3에 영향을 미쳤을 가능성이 높습니다. 새로운 파서는 더 효율적이고 명확한 방식으로 작성되어 미래에 확장될 수 있습니다. 또한, Fava 1.29는 원장이 변경될 때 응답성을 향상시키기 위해 더 효율적인 파일 감시 메커니즘(watchfiles 라이브러리 사용)으로 전환했습니다. 앞으로 커뮤니티는 큰 원장을 더 빠르게 처리하기 위해 증분 파싱(전체가 아닌 변경된 부분만 재처리)을 탐색할 수 있습니다. 이는 문서에서 "Beancount 서버 / 증분 부기" 아이디어로 암시되었습니다.

• 투자 추적 향상: 투자 및 포트폴리오 보고를 개선하기 위한 작업이 계속 진행 중입니다. 예를 들어, 평균 원가 기준 대 FIFO 처리가 길게 논의되었습니다. Beancount는 로트 일치를 강제하지만, 일부 사용자는 특정 관할권에 대해 평균 원가를 선호합니다. 원가 기준 부기를 더 유연하게 만들기 위한 제안과 논의가 있습니다(아마도 플러그인이나 옵션을 통해). 2025년까지 평균 원가를 위한 내장 스위치는 없지만, v3의 기반 작업(부기 재설계)은 플러그인이 이를 구현하기 더 쉽게 만듭니다. 세금을 최소화하기 위해 어떤 로트를 판매해야 하는지 제안할 수 있는 커뮤니티 플러그인 "Gains Minimizer"가 출시되었으며, 이는 투자 주변에 구축되고 있는 고급 도구의 종류를 보여줍니다. Fava 역시 포트폴리오 요약 확장 기능(수익률 계산 포함)과 같은 기능을 추가했습니다. 예정된 기능 측면에서, 이 영역에서 더 많은 것을 기대할 수 있습니다. 아마도 자동화된 포트폴리오 리밸런싱 제안이나 위험 분석이 있을 것이며, 이는 Beancount 데이터를 읽는 외부 도구일 가능성이 높습니다(모든 데이터가 거기에 있기 때문입니다).

• 새로운 플러그인 및 확장 기능: 플러그인 생태계는 계속해서 성장하고 있습니다. 최근 주목할 만한 추가 사항은 다음과 같습니다.

  • 예산 보고 도구 – 예: Fava의 UI를 사용하지 않는 경우를 위한 간단한 CLI 예산 보고서.
  • 암호화 및 보안 – Fava가 온라인에서 호스팅될 때 원장이 미사용 시 암호화되도록 하는 fava-encrypt 설정이 도입되어 재무 정보를 자체 호스팅하는 우려를 해결했습니다.
  • 삶의 질 향상 플러그인 – autobean-format(파일을 파싱하고 다시 인쇄하여 더 많은 예외적인 경우를 처리할 수 있는 새로운 포맷터) 및 편집기에서의 beancheck 통합(Emacs용 flymake).

  앞으로 커뮤니티는 플러그인을 통해 계속해서 공백을 메울 가능성이 높습니다. 예를 들어, 더 많은 세금 관련 플러그인(일부 사용자는 워시 세일 계산이나 특정 지역 세금 보고서와 같은 스크립트를 공유했습니다)을 보게 될 수도 있습니다.

• 잠재적인 예정 기능: 이슈 트래커와 메일링 리스트의 논의를 바탕으로 몇 가지 아이디어가 떠오르고 있습니다(보장되지는 않음).

  • 시간 해상도: 현재 Beancount는 거래에 대한 날짜만 추적합니다(타임스탬프 없음). 시간(주식 거래나 당일 거래 순서)을 추가하는 것에 대한 질문이 있었습니다. 마틴 블레이스는 일을 단순하게 유지하기 위해 일 이하의 타임스탬프는 범위 밖이라고 명시적으로 결정했습니다. 이는 곧 바뀔 것 같지 않습니다 – 따라서 예정된 버전은 아마도 시간 해상도를 추가하지 않고, 시간이 필요하다면 설명이나 계정에 통합하라는 입장을 고수할 것입니다.
  • 향상된 GUI 편집: Fava는 지속적으로 편집 기능을 개선하고 있습니다. 더 완전한 기능을 갖춘 웹 편집기(자동 제안, 새로운 거래를 위한 양식 기반 입력)가 가능성입니다. Fava 편집기에서 tree-sitter를 사용하는 기반이 마련되었습니다. 우리는 Fava가 단순한 뷰어가 아니라 더 강력한 편집기가 되어 많은 작업에 대해 텍스트 편집기를 열 필요성을 줄이는 것을 볼 수 있습니다.
  • 더 나은 다중 원장 지원: 일부 사용자는 여러 Beancount 파일을 유지 관리합니다(다른 법인 또는 개인과 사업 분리). 현재 파일 포함은 가능하지만 제한이 있었습니다(포함된 파일의 플러그인 등). 최근 autobean.include 플러그인이 외부 원장을 안전하게 포함하기 위해 만들어졌습니다. 미래에는 다중 파일 설정을 위한 일급 지원을 볼 수 있을 것입니다 – 아마도 여러 파일이 있는 Beancount "프로젝트" 개념(이는 VSCode 확장 기능의 beancount.mainBeanFile 설정과 같은 기능에 의해 암시됨). 이는 다중 법인 부기를 실행하거나 원장을 모듈화하려는 사람들에게 도움이 될 것입니다.
  • 실시간 또는 증분 계산: 원장이 커짐에 따라 보고서를 신속하게 재계산하는 능력이 중요해집니다. 실행 상태를 유지하고 거래가 변경될 때 결과를 업데이트하는 Beancount 서버라는 아이디어가 있습니다. 이는 Fava의 최적화나 편집기 플러그인이 쿼리할 수 있는 데몬으로 나타날 수 있습니다. 아마도 미래의 Fava 릴리스는 지속적으로 실행되는 Beancount 프로세스를 활용하여 거대한 원장에 대해 UI를 더 반응적으로 만들 것입니다.
  • 기금 회계 / 비영리 기능: Beancount의 기금 회계에 대한 개선 제안이 있었습니다. 비영리 단체는 회계 요구 사항(제한된 기금 대 비제한 기금)이 있으며, 이는 잠재적으로 Beancount의 태그나 계정 계층 구조로 모델링될 수 있습니다. 논의는 아직 내장 기능으로 이어지지 않았지만, 더 많은 비영리 단체가 Beancount를 채택하면 이는 새로운 기능(아마도 문서화된 모범 사례나 기금 잔액 추적 플러그인)을 이끌 수 있습니다.

• 장기 전망: 마틴 블레이스는 Beancount의 미래가 핵심을 더 엔진처럼 만들고 더 많은 기능을 플러그인으로 옮기는 데 있다고 암시했습니다. 이는 우리가 보는 것(v3의 모듈화)과 일치합니다. 따라서 철학적인 관점에서 "예정된 기능"은 더 큰 확장성입니다 – 아마도 플러그인이 새로운 지시어 유형을 정의하거나 통제된 방식으로 구문을 확장할 수 있게 하는 것까지도 포함할 수 있습니다. 그렇게 되면 Beancount의 핵심은 상대적으로 작고 안정적으로 유지되는 반면, 생태계는 대부분의 새로운 기능을 애드온으로 제공할 것입니다. 이는 플러그인 마켓플레이스나 사용자가 선택하고 고를 수 있도록 더 중앙화된 플러그인 목록으로 이어질 수 있습니다(Awesome Beancount 목록이 그 시작입니다).

결론적으로, 2025년의 Beancount 생태계는 활발하고 진화하고 있습니다. Beancount 3.0의 출시는 프로젝트의 기반이 미래를 위해 견고함을 보장하는 주요 최근 이벤트였습니다. 성능, 도구, 사용성(특히 Fava를 통해)의 개선은 진입 장벽을 계속해서 낮추었습니다. Beancount는 여전히 어느 정도의 전문 지식을 요구하는 도구로 남아 있지만, 이러한 발전 덕분에 몇 년 전보다 훨씬 더 접근하기 쉬워졌습니다. 예정된 기능은 핵심 철학에 대한 급격한 변화보다는 경험을 개선하는 데 초점을 맞출 가능성이 높습니다 – 더 빠른 성능, 더 나은 통합, 그리고 전문화된 확장 기능. 커뮤니티의 궤적은 Beancount가 복식 부기의 엄격한 힘과 현대 소프트웨어의 편리함 사이의 균형을 맞추며, 일반 텍스트 회계의 중심으로 계속 성숙할 것임을 시사합니다. 한 사용자가 해커 뉴스에서 재치있게 말했듯이, 일반 텍스트 회계는 재무를 이해하는 데 "초능력"을 부여하며 – Beancount의 최근 및 미래의 개선은 모든 사람이 그 초능력을 더 쉽게 휘두를 수 있도록 하는 것을 목표로 합니다.

출처: Beancount documentation and repository; Fava documentation; “A Comparison of Beancount and Ledger” by Martin Blais; Awesome Beancount resource list; User experiences and community reports;

Beancount는 개발자와 재무 매니아 모두에게 사랑받는 복식부기 회계 시스템으로, 단순함 속에 강력함을 가지고 있습니다. 하지만 Fava와 같은 Beancount 웹 인터페이스에서 더 많은 제어와 빠른 탐색을 원하는 사용자에게는 맞춤 사이드바 링크와 SQL 쿼리가 워크플로우를 한 단계 끌어올릴 수 있습니다.

이 가이드에서는 다음과 같은 방법을 보여드립니다:

• Fava 사이드바에 빠른 접근 링크 추가
• 고급 필터링 및 분석을 위한 SQL 쿼리 사용
• 월간 검토 또는 이상 탐지를 위한 워크플로우 맞춤화

왜 Fava를 맞춤화할까요?​

Fava는 이미 Beancount 원장을 보기 위한 아름다운 인터페이스이지만, 저널이 커짐에 따라 더 나은 바로가기와 스마트한 쿼리에 대한 필요성도 커집니다.

해결되는 문제점:​

• 시간 범위를 반복적으로 탐색
• 중첩된 계정 전체의 거래 필터링
• 음수 잔액이나 이상 현상을 더 빠르게 발견

✨ 맞춤 사이드바 링크​

간단한 사이드바 바로가기로 일일 워크플로우를 개선해봅시다. 이 링크들은 Fava 왼쪽 사이드바에 표시되며 이번 달 거래나 지난 달 수입과 같은 필터링된 뷰로 바로 이동할 수 있습니다.

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

동작 방식:​

• Current Month: 현재 달로 필터링된 거래 뷰를 엽니다.
• Last Month: 이전 달로 즉시 이동합니다—월말 검토에 유용합니다.
• Clear All: 필터를 초기화하여 모든 항목을 다시 표시합니다.

이 바로가기는 수동 시간 입력을 없애고 Fava 사용 경험을 보다 유연하고 개인화된 느낌으로 만들어 줍니다.

🔍 맞춤 SQL 쿼리​

보다 깊은 인사이트를 위해 Fava의 SQL 인터페이스는 매우 강력합니다. 아래 쿼리는 패턴에 맞는 계정에서 모든 음수 잔액을 찾아줍니다—비정상적이거나 문제 있는 거래를 표시하기에 완벽합니다.

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)

상세 설명:​

• account '.*:BCM:.*': 이름에 :BCM:을 포함하는 계정을 필터링합니다.
• number(units(position)) < 0: 음수 잔액을 표시합니다(예: 초과 지출된 예산).
• 날짜 필터는 결과를 특정 1개월 기간으로 제한합니다.

활용 사례:​

• 중복 지출이나 잘못된 전표와 같은 오류 발견
• 특정 공급업체나 카테고리 감사
• 예산 책정을 위한 실행 가능한 인사이트를 빠르게 추출

🛠 전문가 팁: 링크와 쿼리 결합​

Fava는 맞춤 쿼리로 직접 연결을 지원하지 않지만, 다음과 같이 월간 검토 습관을 만들 수 있습니다:

• “Current Month” 링크를 사용해 검토 시작
• 다른 창에서 저장된 쿼리 탭 열기
• 두 화면을 동시에 검토—먼저 필터링하고, 그 다음 깊이 파고들기

이 조합은 이상이 확대되기 전에 포착하고 원장을 깨끗하게 유지하는 데 도움이 됩니다.

마무리 생각​

Beancount는 설계상 최소주의이지만, 이러한 작은 개선이 효율성을 크게 높입니다. 예산을 검토하든, 이상한 잔액을 디버깅하든, 클릭을 절약하든, 맞춤 링크와 SQL 쿼리는 더 많은 힘과 적은 마찰을 제공합니다.

보너스: Fava의 맞춤 보고서를 사용한다면, 개인 재무 루틴에 맞춘 전체 대시보드까지 구축할 수 있습니다.

통제할 준비가 되셨나요?

작게 시작하세요: “Current Month” 링크를 추가합니다. 그런 다음 자신만의 쿼리를 구축하세요. 미래의 자신이 감사할 것입니다.

이와 같은 팁을 더 원하신다면, 뉴스레터를 구독하거나 Beancount.io에서 더 많은 Beancount 레시피를 살펴보세요.

우리는 MIT 라이선스 오픈소스 소프트웨어인 Fava를 버전 1.19로 업그레이드했습니다. 지난 업데이트 이후 변경 사항은 다음과 같습니다:

• v1.19 (2021-05-18)
  • conversion 및 interval 옵션에서 default-page 옵션으로 마이그레이션
  • invert-income-liabilities-equity 옵션 추가
  • CodeMirror 6으로 업그레이드
  • 불가리아어 번역 추가
  • 기타 작은 개선 및 버그 수정
• v1.18 (2021-01-16)
  • 몇 가지 작은 개선 및 다양한 버그 수정.

흥분되시나요? 지금 바로 https://beancount.io/ledger/에서 사용해 보세요

질문이 있으신가요? https://t.me/beancount 에서 언제든 도와드리겠습니다 :)

감가상각은 지급액을 시간에 걸쳐 여러 할부로 나눕니다. beancount.io에서는 플러그인 fava.plugins.amortize_over를 사용하여 이를 구현할 수 있습니다.

감가상각을 사용하지 않으면, 차량 보험을 6개월 동안 $600 비용으로 가입하고자 할 경우, 해당 비용을 특정 날짜에 일회성 비용으로 기록해야 합니다.

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto


2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

하지만 감가상각을 사용하면 파일 상단에 plugin "fava.plugins.amortize_over"를 추가하고 거래에 amortize_months: 6을 지정하여 비용을 6개월에 걸쳐 배분할 수 있습니다.

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

그 후 저널에서 해당 거래가 6개의 포스팅으로 분할된 것을 확인할 수 있습니다.

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am

보안이 강화되고 성능이 뛰어난 온라인 서비스를 유지하는 일은 일회성 작업이 아닙니다. 새로운 기능을 개발하는 것뿐만 아니라 기존 기능을 갱신하는 데에도 노력이 필요합니다.

오래된 소프트웨어는 고객을 보안 취약점 위험에 노출시킵니다. 이 위험을 어떻게 줄일 수 있을까요? 한편으로는, 우리는 보안 연구원들과 적극적으로 협력하여 예상치 못한 문제를 찾아 해결합니다. 다른 한편으로는, 정기적으로 상위 소프트웨어의 최신 버전을 병합합니다.

오늘은 Beancount.io를 개선하기 위해 우리가 만든 몇 가지 향상을 공유하게 되어 기쁩니다.

1. 서버를 업그레이드하여 서비스 속도를 최대 30%까지 높였습니다. 서비스 가용성 또한 크게 개선되었습니다.
2. MIT 라이선스 오픈소스 소프트웨어인 Fava를 버전 1.17로 업그레이드했습니다. 다양한 버그가 수정되고 많은 새로운 기능이 추가되었습니다.

흥미롭나요? 지금 바로 https://beancount.io/ledger/에서 사용해 보세요.

궁금한 점이 있나요? https://t.me/beancount 에서 언제든지 도와드리겠습니다 :)