현재 재무

{
  "birthMonth": "1991-05",
  "cash": 50000000,
  "assets": [{ "id": "etf", "name": "ETF", "type": "INVESTMENT", "value": 200000000, "annualRate": null }],
  "liabilities": [{ "id": "loan1", "name": "전세대출", "principal": 100000000, "annualRate": 0.04, "remainingMonths": 24, "repayment": "BULLET" }],
  "cashFlows": [
    { "id": "salary", "name": "월급", "type": "INCOME", "incomeKind": "SALARY", "monthlyAmount": 7000000, "start": "2026-10", "end": null },
    { "id": "living", "name": "생활비", "type": "EXPENSE", "monthlyAmount": 3500000, "start": "2026-10", "end": null }
  ],
  "dependents": [{ "id": "spouse", "name": "배우자", "kind": "SPOUSE", "birthMonth": "1992-03" }]
}

• birthMonth: 본인 생년월. 비어 있으면 계산할 수 없어 전망이 400 입니다.
• cash: 운용 계좌. 모든 수입·지출·상환이 여기로 들어오고 나갑니다.
• id 는 직접 정합니다. 플랜 항목(change·holding·transfer)이 이 id 를 가리킵니다.

​

자산 assets

​

부채 liabilities

​

수입·지출 cashFlows

• type 은 INCOME·EXPENSE 입니다. start~end 달(포함) 동안 매달이고, end 가 null 이면 끝까지입니다.
• 수입 incomeKind: SALARY(세전 급여, 엔진이 세금·보험료를 뗌)·NET(세후)·BUSINESS(사업소득)·PUBLIC_PENSION(국민연금).
• 지출 expenseKind(선택): RENT(월세)·DONATION(기부금). 연말정산 세액공제에 씁니다.
• annualGrowth 가 null 이면 수입은 가정의 소득 상승률, 지출은 물가 상승률로 매년 1월에 오릅니다.

​

명의 owner

​

부양가족 dependents

​

저장과 순자산 기록

• PUT /v1/finances 는 전체를 바꿉니다. GET 응답의 ETag 를 If-Match 에 넣으면 그사이 바뀌었을 때 덮어쓰지 않고 412 입니다.
• 저장할 때마다 그날의 합계가 순자산 기록(GET /v1/finances/history)에 남습니다(같은 날은 마지막 값).
• 지난 기록은 PUT /v1/finances/history/{YYYY-MM-DD} 로 넣거나 고칩니다. 미래 날짜·음수는 400 입니다.