آموزش Beancount: نصب و اولین دفتر کل

آماده‌اید کنترل امور مالی خود را در دست بگیرید؟ این راهنما شما را در چند دقیقه با Beancount راه می‌اندازد. یاد خواهید گرفت که چگونه اولین دفترکل خود را ایجاد کنید، حساب‌های ضروری را تنظیم کنید و اولین تراکنش‌های خود را ثبت کنید.

کاوش در دفترکل زنده ←

راه‌اندازی اولیه​

ایجاد اولین دفترکل شما​

; Basic structure for a new 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" "Personal Finance Ledger"
option "operating_currency" "USD"

سازماندهی فایل​

ساختار پیشنهادی​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  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

اعتبارسنجی و گزارش‌گیری​

اعتبارسنجی پایه​

# Check for errors (exits 0 when clean)
bea --file ledger.beancount check
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bea check اعتبارسنج است: وقتی دفترکل تمیز باشد با کد 0 خارج می‌شود و در غیر این صورت هر خطا را فهرست کرده و با کد غیرصفر خارج می‌شود. آن را با شروع سریع CLI نصب کنید. Fava رابط وب است — آن را اجرا کنید و آدرس چاپ‌شده http://localhost:5000 را برای ترازنامه، صورت سود و زیان و دفتر روزنامه حساب‌ها باز کنید.

گزارش‌های رایج​

Beancount 3 گزارش‌ها را از طریق رابط وب Fava، فرمان یک‌خطی bea report یا پرس‌وجوهای موردی با bea query تولید می‌کند که زبان پرس‌وجوی Beancount را اجرا می‌کند. Beancount 3 فرمان‌های قدیمی‌تر گزارش و وب خود را حذف کرده است؛ bea report و Fava جایگزین آن‌ها شده‌اند.

# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
 
# Income statement, in one command
bea --file ledger.beancount report income-statement
 
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

مدیریت موجودی‌های اولیه​

مثال Padding​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

یک تأییدیه balance موجودی حساب را در آغاز تاریخ خود بررسی می‌کند، بنابراین باید بعد از pad (یا هر تراکنشی) که باید شامل شود تاریخ‌گذاری شود. تاریخ‌گذاری pad و balance در همان روز باعث می‌شود pad استفاده‌نشده بماند و تأییدیه ناقص باشد — Beancount گزارش Unused Pad entry و Balance failed می‌دهد. حساب Equity:Opening-Balances باید قبل از استفاده به عنوان پشتیبان pad باز شده باشد.

بستن حساب​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

حذف تراکنش‌های تکراری​

مدیریت انتقال‌ها​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

تأییدیه‌های موجودی​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

بهترین روش‌ها​

1. سازماندهی فایل

   • در ابتدا یک فایل اصلی نگه دارید
   • از سربرگ‌های بخش واضح استفاده کنید
   • حساب‌های مرتبط را با هم گروه‌بندی کنید

2. نام‌های حساب

   • از قراردادهای نام‌گذاری یکسان استفاده کنید
   • پیشوندهای کشور/مؤسسه را شامل کنید
   • سلسله‌مراتب منطقی را حفظ کنید

3. تأیید موجودی

   • تأییدیه‌های منظم موجودی
   • padding مناسب حساب‌ها
   • پیگیری بسته شدن حساب‌ها

4. مدیریت ارز

   • ارزهای عملیاتی را اعلام کنید
   • از کدهای کالای یکسان استفاده کنید
   • محدودیت‌های ارزی را مشخص کنید

مراحل بعدی​

حالا که یک دفترکل پایه راه‌اندازی کرده‌اید:

1. ثبت تراکنش‌های منظم: با هزینه‌ها و درآمدهای روزانه خود شروع کنید
2. تنظیم واردات حساب بانکی: از واردات CSV یا اتصالات بانکی برای خودکارسازی ورود داده استفاده کنید. یک خروجی صورت حساب را در مبدل CSV به Beancount جای‌گذاری کنید تا ورودی‌های متوازن را در مرورگر خود دریافت کنید، یا از OFX و QIF به Beancount برای دانلودهای .ofx، .qfx و .qif استفاده کنید.
3. کپی از یک چیدمان اثبات‌شده: یک فایل شروع‌کننده قابل اجرا از بخش‌های خانگی، بودجه‌بندی پاکتی یا فریلنسری از نمونه‌های دفترکل کاری دانلود کنید، سپس الگوهای دارایی و سرمایه‌گذاری را از همان گالری تطبیق دهید
4. یادگیری نحو پیشرفته: مرجع نحو را برای سناریوهای پیچیده‌تر کاوش کنید
5. تولید اولین گزارش‌های خود: از ویژگی‌های رابط کاربری برای ایجاد گزارش‌های مالی و تحلیل هزینه‌های خود استفاده کنید
6. کار از ترمینال: فرمان خط فرمان bea را با شروع سریع CLI نصب کنید، سپس یک پایان ماه کامل را با اولین ماه شما با bea از ابتدا تا انتها انجام دهید

مرجع سریع​

انواع حساب رایج:

• Assets:Bank:Checking - حساب جاری شما
• Expenses:Food:Groceries - هزینه‌های خرید مواد غذایی
• Income:Salary:Company - درآمد اشتغال
• Liabilities:CreditCard:Visa - بدهی کارت اعتباری

فرمان‌های ضروری:

• bea --file ledger.beancount check - اعتبارسنجی دفترکل شما (در صورت خطا با کد غیرصفر خارج می‌شود)
• bea --file ledger.beancount report balance-sheet - چاپ ترازنامه
• bea --file ledger.beancount query "SELECT ..." - پرس‌وجوی موجودی‌ها و تراکنش‌ها
• fava ledger.beancount - راه‌اندازی رابط وب برای گزارش‌ها و نمودارها

این رهنمودها پایه‌ای محکم برای مدیریت امور مالی شخصی با Beancount ایجاد می‌کنند. آماده افزودن اولین تراکنش خود هستید؟ راهنمای تراکنش رابط کاربری ما را بررسی کنید.