برگه تقلب Beancount - راهنمای مرجع سریع

ساختار حساب

انواع و علائم حساب

نوع          علامت    مثال
------------------------------------------------
دارایی‌ها      (+)     Assets:US:BofA:Checking
بدهی‌ها        (-)     Liabilities:Credit:Amex
درآمد          (-)     Income:Salary:Gross
هزینه‌ها       (+)     Expenses:Food:Restaurant
سرمایه         (-)     Equity:Opening-Balances

فرمت کالا

# مالی
USD, EUR, CAD, AUD     # ارزهای استاندارد
GOOG, AAPL, VTI       # ابزارهای سرمایه گذاری
BTC, ETH              # ارزهای رمزنگاری شده

# ردیابی سفارشی
HOURS                 # ردیابی زمان
AIRMILES             # امتیازات پاداش
HOME_MAYST           # ملک

نحو دستورالعمل

مدیریت حساب

# افتتاح حساب‌ها
2024-01-01 open Assets:Checking            # ساده
2024-01-01 open Assets:Investing USD,GOOG  # با محدودیت‌ها

# بستن حساب‌ها
2024-12-31 close Assets:Old:Account

اعلان کالا

2024-01-01 commodity VTSAX
    name: "شاخص کل بازار سهام ونگارد"
    asset-class: "سهام"

ثبت تراکنش

# تراکنش اساسی
2024-01-15 * "فروشگاه مواد غذایی" "خرید هفتگی"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries

# با فراداده و برچسب‌ها
2024-01-15 * "رستوران" "شام کاری" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

مشخصات ارسال

# مقدار اساسی
Assets:Cash              100.00 USD

# ردیابی مبنای هزینه
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        # به ازای هر واحد
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # کل هزینه
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # با هزینه‌ها

# مشخصات قیمت
Assets:Forex            1000.00 USD @ 0.85 EUR        # به ازای هر واحد
Assets:Forex            1000.00 USD @@ 850.00 EUR     # قیمت کل

# لات‌های تاریخ‌دار
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

تایید اعتبار ترازنامه

# ادعای ترازنامه
2024-01-31 balance Assets:Checking  1000.00 USD

# پدینگ ترازنامه
2024-01-01 pad Assets:Checking Equity:Opening-Balances

ردیابی فراداده

# پیوست یادداشت
2024-01-15 note Assets:Checking "تماس با بانک در مورد کارمزد"

# لینک سند
2024-01-15 document Assets:Checking "path/to/statement.pdf"

# ثبت قیمت
2024-01-15 price VTSAX  100.00 USD

ثبت رویداد

# ردیابی مکان
2024-01-15 event "location" "نیویورک، ایالات متحده آمریکا"

# تغییرات ویژگی
2024-01-15 event "address" "123 خیابان اصلی"

مدیریت برچسب

# کنترل محدوده برچسب
pushtag #vacation
2024-01-15 * "هتل"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

گزینه‌های پیکربندی

# تنظیمات اساسی
option "title" "دفتر مالی شخصی"
option "operating_currency" "USD"

# نامگذاری حساب
option "name_assets" "دارایی‌ها"
option "name_liabilities" "بدهی‌ها"
option "name_income" "درآمد"
option "name_expenses" "هزینه‌ها"
option "name_equity" "سرمایه"

# مدیریت سند
option "documents" "/path/to/docs"

نظرات و سازماندهی

; کامنت تک خطی

* سربرگ بخش
** زیربخش
; بلوک تراکنش زیر می آید...

; گروه‌بندی حساب
; دارایی ها
2024-01-15 ...

; هزینه ها
2024-01-16 ...

این مرجع یک نمای کلی کامل از عناصر نحوی Beancount با مثال های عملی ارائه می دهد.