پیش‌بینی تراکنش‌های آینده

Beancount می‌تواند تراکنش‌های تکراری آینده را با استفاده از پلاگین fava.plugins.forecast پیش‌بینی کند. این امکان به شما اجازه می‌دهد تأثیر آینده درآمدها و هزینه‌های منظم، مانند حقوق، اجاره و اشتراک‌ها را بر گزارش‌های مالی خود مشاهده کنید.

مرحله ۱: فعال‌سازی پلاگین پیش‌بینی​

ابتدا باید پلاگین را فعال کنید با افزودن خط زیر به بالای فایل دفتر کل Beancount خود:

plugin "fava.plugins.forecast"

مرحله ۲: ایجاد یک تراکنش پیش‌بینی​

برای پیش‌بینی یک تراکنش تکراری، یک ورودی تراکنش واحد با استفاده از پرچم # (به جای * یا !) ایجاد کنید و یک برچسب پیش‌بینی خاص به شرح اضافه کنید.

ساختار پایه به این شکل است:

YYYY-MM-DD # "شرح [تکرار شرایط]"
  حساب:یک      100.00 USD
  حساب:دو     -100.00 USD

پلاگین پیش‌بینی از این ورودی به عنوان یک الگو برای تولید تراکنش‌های آینده در گزارش‌های شما استفاده می‌کند.

درک نحو پیش‌بینی​

برچسب پیش‌بینی در شرح از یک قالب خاص پیروی می‌کند: [تکرار شرایط].

تکرار​

بخش تکرار اجباری است و مشخص می‌کند که تراکنش چند وقت یکبار تکرار می‌شود. باید با حروف بزرگ نوشته شود.

• DAILY (روزانه)
• WEEKLY (هفتگی)
• MONTHLY (ماهانه)
• QUARTERLY (سه ماهه)
• YEARLY (ساالنه)

مثال: پرداخت اجاره ماهانه این تراکنش پیش‌بینی می‌شود که در روز اول هر ماه، از ژانویه ۲۰۲۴ رخ دهد.

2024-01-01 # "پرداخت اجاره [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD

شرایط (اختیاری)​

می‌توانید شرایط اختیاری برای کنترل مدت و الگوی پیش‌بینی اضافه کنید.

۱. تعیین تاریخ پایان با UNTIL از UNTIL YYYY-MM-DD برای متوقف کردن پیش‌بینی در یک تاریخ مشخص استفاده کنید.

• مثال: عضویت در باشگاه که امسال پایان می‌یابد.

  2024-01-15 # "عضویت باشگاه [MONTHLY UNTIL 2024-12-31]"
    Expenses:Health:Gym                 80.00 USD
    Assets:Checking                    -80.00 USD

۲. محدود کردن تعداد تکرار با REPEAT از REPEAT n TIMES برای تولید تراکنش به تعداد مشخصی استفاده کنید.

• مثال: وام خودرو با ۳۶ قسط باقی‌مانده.

  2024-01-25 # "قسط خودرو [MONTHLY REPEAT 36 TIMES]"
    Expenses:Transportation:CarPayment  450.00 USD
    Liabilities:Auto-Loan              -450.00 USD

۳. ایجاد الگوهای نامنظم با SKIP از SKIP n TIME/TIMES برای رد شدن از فواصل زمانی استفاده کنید. این برای مواردی مانند حقوق دو هفته‌ای مفید است.

• مثال: حقوق دو هفته‌ای (هر دو هفته یکبار رخ می‌دهد).

  2024-01-05 # "حقوق دو هفته‌ای [WEEKLY SKIP 1 TIME]"
    Assets:Checking                    3000.00 USD
    Income:Salary                     -3000.00 USD

مثال عملی: یک بودجه ماهانه​

می‌توانید چندین پیش‌بینی را برای پیش‌بینی کل بودجه خود ترکیب کنید، شامل جریان‌های مختلف درآمد و هزینه.

plugin "fava.plugins.forecast"
 
; === درآمد ===
2024-01-05 # "حقوق دو هفته‌ای [WEEKLY SKIP 1 TIME]"
  Assets:Checking                    3000.00 USD
  Income:Salary                     -3000.00 USD
 
; === هزینه‌ها ===
2024-01-01 # "اجاره [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD
 
2024-01-01 # "مواد غذایی [WEEKLY]"
  Expenses:Food:Groceries           150.00 USD
  Assets:Checking                  -150.00 USD
 
2024-01-15 # "بیمه خودرو [QUARTERLY REPEAT 4 TIMES]"
  Expenses:Insurance:Auto           450.00 USD
  Assets:Checking                  -450.00 USD

پس از افزودن این ورودی‌ها، گزارش‌های شما، مانند صورت سود و زیان و نمودار سود خالص، به طور خودکار داده‌های پیش‌بینی شده را شامل می‌شوند و دید روشنی از آینده مالی شما ارائه می‌دهند.

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

• پیش‌بینی‌ها ظاهر نمی‌شوند؟

  • مطمئن شوید plugin "fava.plugins.forecast" در فایل دفتر کل شما وجود دارد.
  • از پرچم # برای تراکنش استفاده کنید، نه *.
  • غلط املایی در برچسب تکرار را بررسی کنید (به عنوان مثال، [MONTHLY] نه [Monthly] یا [MONTLY]).

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

  • توصیفی باشید: از شرح‌های واضح استفاده کنید تا بدانید هر پیش‌بینی برای چیست.
  • به‌روزرسانی منظم: پیش‌بینی‌های خود را به‌روز کنید (به عنوان مثال، برای افزایش حقوق یا تغییر اجاره) تا دقیق بمانند.
  • از شرایط پایان استفاده کنید: برای تراکنش‌هایی که دائمی نیستند (مانند وام‌ها یا اشتراک‌ها)، از UNTIL یا REPEAT استفاده کنید تا از پیش‌بینی نامحدود جلوگیری کنید.