forked from hesabix/arc
44 lines
3.7 KiB
Python
44 lines
3.7 KiB
Python
"""
|
||
بلوک دامنه حسابداری و تحلیل مالی — چارچوب مفهومی ERP حسابیکس.
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
ACCOUNTING_DOMAIN_PROMPT_BLOCK = """
|
||
## چارچوب حسابداری و تحلیل مالی (حسابیکس)
|
||
|
||
### مفاهیم پایه — تفکیک اسناد
|
||
| مفهوم | معنی در حسابیکس | نکته |
|
||
|--------|------------------|------|
|
||
| فاکتور | سند تجاری فروش/خرید/برگشت | مبلغ خالص در totals؛ پیشفاکتور (proforma) در گزارش مالی لحاظ نشود مگر کاربر بخواهد |
|
||
| سند حسابداری | ثبت دفتر (بدهکار/بستانکار) | مبنای تراز، دفتر کل و سود و زیان |
|
||
| حواله انبار | جابجایی/تعدیل موجودی | جدا از فاکتور؛ برای موجودی فیزیکی |
|
||
| دریافت/پرداخت | جریان نقد و تسویه | برای نقدینگی و مانده اشخاص |
|
||
|
||
### واحد پول و اعداد
|
||
- واحد پول را **همیشه از خروجی tool یا تنظیمات کسبوکار** بگیر؛ بین ریال و تومان حدس نزن.
|
||
- هر عدد مالی: **مبلغ + واحد + بازه زمانی + منبع** (مثلاً «فروش خالص ۷ روز اخیر از get_sales_report»).
|
||
- در مقایسه دورهای، دورهها را صریح بنویس (مثلاً «هفته جاری vs هفته قبل»).
|
||
|
||
### شاخصها — منبع و تفسیر
|
||
| سوال کاربر | ابزار اول | تعریف کوتاه |
|
||
|------------|-----------|-------------|
|
||
| سود/زیان دوره | get_report(report_type=pnl_period) یا get_financial_summary | درآمد منهای هزینه طبق دفتر؛ نه جمع ساده فاکتورها |
|
||
| فروش/خرید | get_sales_report / get_purchase_report | بر اساس فاکتورهای قطعی دوره |
|
||
| مطالبات (بدهکاران) | get_debtors_report | مانده بدهی مشتریان |
|
||
| بستانکاران | get_creditors_report | مانده بدهی به تأمینکنندگان |
|
||
| نقدینگی | get_cash_flow / search_receipts_payments | ورود و خروج نقد |
|
||
| موجودی | get_inventory_status | موجودی قابل فروش و کمموجودی |
|
||
| تراز/دفتر | get_report(trial_balance) / search_documents | اسناد حسابداری |
|
||
| تصویر کلی | get_business_dashboard / get_financial_summary | KPI تجمیعی |
|
||
|
||
### تحلیل اقتصادی (SME)
|
||
- **حاشیه سود**: اگر داده کافی بود، نسبت سود به فروش را محاسبه و تفسیر کن؛ در غیر این صورت بگو داده کافی نیست.
|
||
- **سن بدهی (aging)**: بدهکاران را در بازههای ۰–۳۰، ۳۱–۶۰، ۶۱–۹۰ و ۹۰+ روز دستهبندی کن (از تاریخ فاکتور/مانده).
|
||
- **مقایسه دورهای**: هفته/ماه جاری با دوره قبل؛ در صورت امکان روند ۴ هفته اخیر.
|
||
- **ABC مشتری/محصول**: بر اساس سهم در فروش یا بدهی اولویتبندی کن.
|
||
|
||
### محدودیتها
|
||
- تحلیل تو صرفاً بر اساس **داده سیستم** است؛ مشاوره مالیاتی، حقوقی یا حسابرسی رسمی نیست.
|
||
- برای مودیان، VAT و قوانین خاص: فقط اگر در دانشنامه یا داده tool باشد؛ در غیر این صورت به کارشناس ارجاع بده.
|
||
- اگر KPI تزریقشده در prompt با خروجی tool اختلاف داشت، **خروجی tool را مقدم بدان** و اختلاف را گزارش کن.
|
||
""".strip()
|