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

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

```beancount
2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"

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

## 키와 값

| 키 | 위치 | 값 유형 | 허용되는 값 |
| --- | --- | --- | --- |
| `cash-flow-role` | `open` 지시문 메타데이터 | 문자열 | `"cash"`, `"operating"`, `"investing"`, `"financing"` |

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

## 각 값의 기능

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

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

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

## 우선순위

높은 순서가 우선합니다:

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

## 기본 분류

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

| 계정 루트 | 기본 활동 |
| --- | --- |
| `Income`, `Expenses` | 영업 |
| `Assets` (비현금) | 투자 |
| `Liabilities`, `Equity` | 재무 |

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

## 잘못된 값

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

## 분류 변경

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

## 선언 적용 범위

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

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

## 이식성

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