현금흐름 역할: Beancount.io에서 계정 분류하기

계정의 open 지시문에 cash-flow-role 메타데이터를 추가하여 현금 흐름 보고서가 해당 계정을 분류하는 방식을 선언합니다. 하나의 키, 네 가지 값이 있습니다. 메타데이터가 없는 계정은 기본 휴리스틱을 유지합니다.

2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"
 
2000-01-01 open Assets:US:Marcus:Savings
  cash-flow-role: "cash"

키와 값​

일치는 대소문자를 구분하며 정확해야 합니다. 값은 따옴표로 묶인 문자열이어야 합니다. 동일한 지시문의 다른 메타데이터 키는 이 보고서에서 무시되며, 이 키는 다른 모든 도구에서도 무시됩니다.

각 값의 기능​

선언된 역할은 두 가지 질문에 동시에 답합니다. 계정이 현금 및 현금성 자산에 포함되는지, 그리고 어떤 활동 섹션에 속하는지입니다.

• "cash" — 계정이 현금 및 현금성 자산 집합에 포함됩니다. 현금 계정은 활동 라인 항목으로 표시되지 않습니다. 명세서의 맨 아래 줄인 현금 및 현금성 자산의 순변동은 해당 기간의 변동 합계와 같습니다. 두 현금 계정 간의 이체는 상쇄됩니다. 이름 휴리스틱이 놓치는 계정(예: 머니마켓 펀드 또는 스테이블코인 지갑)에 사용하세요.
• "operating", "investing", "financing" — 계정은 현금이 아니며, 해당 기간의 변동은 해당 활동 섹션 아래에 라인으로 표시됩니다. 이름 휴리스틱이 현금으로 처리할 계정(예: Assets:US:Bank:CD)에 이 값 중 하나를 선언하면 현금 집합에서 제외되고 선언된 섹션 아래에 파일로 분류됩니다.

선언은 회계 관행보다 우선합니다. "operating"으로 선언된 자본 계정은 그대로 적용됩니다.

우선순위​

높은 순서가 우선합니다:

1. 계정의 open 지시문에 있는 cash-flow-role 메타데이터.
2. 아래에 있는 기본 제공 휴리스틱.

기본 분류​

선언된 역할이 없는 계정은 루트에 따라 분류되며, 이름 확인을 통해 현금 포함 여부를 결정합니다:

이름에 Cash, Checking, Savings, 또는 Bank가 포함된 자산 계정은 기본적으로 현금 및 현금성 자산으로 처리됩니다. 선언된 역할은 두 방향 모두에서 이름 확인보다 우선합니다.

잘못된 값​

인식할 수 없는 값은 없는 것으로 간주됩니다. "invsting"과 같은 오타, 문자열이 아닌 값, 또는 대소문자 오류는 기본 휴리스틱으로 대체되며, 보고서는 상태 패널에 알 수 없는 값 메모로 계정에 플래그를 지정합니다. 렌더링은 실패하지 않으며, 자동으로 수용되지도 않습니다.

분류 변경​

분류는 날짜 기준으로 적용되지 않습니다. 모든 기간의 명세서는 현재 시점의 선언을 사용합니다. 변경하려면 open 지시문을 편집하세요. 원장의 버전 제어는 변경 사항과 시점을 기록합니다.

선언 적용 범위​

단일 공유 해석기가 각 계정의 최종 역할을 생성하며, 모든 소비자가 이를 읽습니다:

• 현금 흐름 보고서: 활동 섹션, 현금 및 현금성 자산 집합, 맨 아래 줄 조정.
• CSV, Markdown 및 인쇄 내보내기: 동일한 숫자. 분류가 추론되었음을 나타내는 표시는 휴리스틱으로 여전히 해결되는 행에만 나타납니다.
• 개요 현금 흐름 다이어그램: "cash"는 계정을 흐름 노드에서 제외하며, 선언된 활동 역할은 비현금 계정에 적용됩니다. 소득은 원천 측에 유지되고 자본은 제외 측에 유지됩니다. 선언은 이 두 측을 다시 매핑하지 않습니다.
• 계정 상태 패널: 선언된 계정은 더 이상 분류되지 않은 자산으로 표시되지 않습니다.

이식성​

open 지시문의 메타데이터는 Beancount 핵심 구문입니다. bea check, Fava 및 모든 v2/v3 도구는 이를 구문 분석하고 알 수 없는 키를 무시하므로 원장은 Beancount.io 외부에서도 완전히 사용 가능합니다. 일반적인 메타데이터 형식은 Beancount 구문을 참조하세요.