본문으로 건너뛰기
빠른 시작

빠른 시작

필수 구성, 파일 구성 및 유효성 검사 단계를 통해 첫 번째 Beancount 원장을 생성하는 빠른 설정 가이드입니다.

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

beancount.io journal view listing plain-text double-entry transactions with directive type filters

Explore the live ledger →

초기 설정

첫 번째 원장 만들기

; 새 원장의 기본 구조
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 가져오기 또는 은행 연결을 사용하여 데이터 입력을 자동화합니다. 명세서 내보내기 파일을 CSV를 Beancount로 변환에 붙여넣으면 브라우저에서 대차가 맞는 항목을 얻을 수 있고, .ofx, .qfx, .qif 다운로드에는 OFX 및 QIF를 Beancount로 변환하는 도구를 사용하세요.
  3. 작동하는 원장 예제: 가계 재무, 봉투 예산, 프리랜서 인보이스, 임대 부동산, 투자 원가 기준을 위한 5가지 검증된 Beancount 원장 패턴을 복사하세요.
  4. 고급 구문 배우기: 더 복잡한 시나리오를 위해 구문 참조를 살펴봅니다.
  5. 첫 번째 보고서 생성: 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 거래 가이드를 확인하세요.