본문으로 건너뛰기

Beancount 시작하기

재정을 관리할 준비가 되셨나요? 이 가이드는 몇 분 안에 Beancount를 실행하고 사용할 수 있도록 도와줍니다. 첫 번째 원장을 만들고, 필수 계정을 설정하고, 첫 번째 거래를 기록하는 방법을 배우게 됩니다.

초기 설정

첫 번째 원장 만들기

; 새 원장의 기본 구조
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances

2024-01-02 * "Initial Deposit"
Assets:Checking 100.00 USD
Equity:Opening-Balances

필수 구성

option "title" "개인 재정 원장"
option "operating_currency" "USD"

파일 구성

권장 구조

; 1. 구성 옵션
option "title" "개인 원장"
option "operating_currency" "USD"

; 2. 계정 선언
2024-01-01 open Assets:Checking USD
2024-01-01 open Assets:Savings USD
2024-01-01 open Expenses:Food USD

; 3. 초기 잔액
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-01 balance Assets:Checking 1000.00 USD

; 4. 거래
2024-01-15 * "Grocery Store" "주간 식료품"
Expenses:Food 50.00 USD
Assets:Checking

섹션 구성

  1. 영구 계정

    2024-01-01 open Liabilities:Payables    USD
    2024-01-01 open Assets:Receivables USD
  2. 은행 계좌

    2024-01-01 open Assets:Bank:Checking     USD
    2024-01-01 open Assets:Bank:Savings USD
    2024-01-01 open Income:Bank:Interest USD
  3. 투자 계정

    2024-01-01 open Assets:Investment:Cash    USD
    2024-01-01 open Assets:Investment:Stocks VTSAX
    2024-01-01 open Income:Investment:Dividend USD

유효성 검사 및 보고

기본 유효성 검사

# 오류 확인
bean-check ledger.beancount

# 웹 인터페이스 보기
bean-web ledger.beancount

일반적인 보고서

# 대차 대조표
bean-report ledger.beancount balsheet

# 손익 계산서
bean-report ledger.beancount income

# 계정 저널
bean-report ledger.beancount journal -a Assets:Checking

초기 잔액 관리

패딩 예제

2024-01-01 open Assets:Checking    USD

; 알려진 잔액과 일치하도록 계정 패딩
2024-01-01 pad Assets:Checking Equity:Opening-Balances

; 알려진 잔액 어설션
2024-01-01 balance Assets:Checking 1525.00 USD

계정 폐쇄

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking ; 계정 폐쇄

거래 중복 제거

이체 처리

; 신용 카드 결제 - 통합 보기
2024-01-15 * "Credit Card Payment"
Assets:Checking -500.00 USD
Liabilities:CreditCard 500.00 USD

; 대기 중인 일치 항목 플래그
2024-01-15 * "Pending CC Payment"
! Assets:Checking -500.00 USD
Liabilities:CreditCard 500.00 USD

잔액 어설션

; 정기적인 잔액 확인으로 중복 방지
2024-01-31 balance Assets:Checking 2150.25 USD
2024-01-31 balance Liabilities:CreditCard -350.00 USD

모범 사례

  1. 파일 구성

    • 처음에는 하나의 메인 파일을 유지합니다.
    • 명확한 섹션 헤더를 사용합니다.
    • 관련된 계정을 함께 그룹화합니다.
  2. 계정 이름

    • 일관된 명명 규칙을 사용합니다.
    • 국가/기관 접두사를 포함합니다.
    • 논리적 계층 구조를 유지합니다.
  3. 잔액 확인

    • 정기적인 잔액 어설션
    • 계정을 적절하게 패딩합니다.
    • 계정 폐쇄를 추적합니다.
  4. 통화 처리

    • 운영 통화를 선언합니다.
    • 일관된 상품 코드를 사용합니다.
    • 통화 제약 조건을 지정합니다.

다음 단계

이제 기본 원장을 설정했습니다.

  1. 정기 거래 기록: 일일 지출과 수입으로 시작합니다.
  2. 은행 계좌 가져오기 설정: CSV 가져오기 또는 은행 연결을 사용하여 데이터 입력을 자동화합니다.
  3. 고급 구문 배우기: 더 복잡한 시나리오를 위해 구문 참조를 살펴봅니다.
  4. 첫 번째 보고서 생성: UI 기능을 사용하여 재무 보고서를 만들고 지출을 분석합니다.

빠른 참조

일반적인 계정 유형:

  • Assets:Bank:Checking - 귀하의 예금 계좌
  • Expenses:Food:Groceries - 식료품 지출
  • Income:Salary:Company - 고용 소득
  • Liabilities:CreditCard:Visa - 신용 카드 부채

필수 명령어:

  • bean-check ledger.beancount - 원장 유효성 검사
  • bean-report ledger.beancount balsheet - 대차 대조표 생성
  • bean-web ledger.beancount - 웹 인터페이스 실행

이러한 지침은 Beancount로 개인 재정을 관리하기 위한 견고한 토대를 마련합니다. 첫 번째 거래를 추가할 준비가 되셨습니까? UI 거래 가이드를 확인하세요.