#P1772
POST /v2/ai/chat/completions
AI Financial Analysis Logic
این اندپوینت دادههای خام مالی (شامل خرید، فروش، سود و زیان) را دریافت کرده و آن را به یک گزارش متنی/بصری تبدیل میکند.
نقش سیستم: سیستم به عنوان یک مدیر مالی هوشمند برای نرمافزار AirPlus عمل میکند.
فرمت خروجی: پرامپت سیستم به گونهای تنظیم شده که خروجی نهایی صرفاً کد HTML Body باشد تا در فرانتاند مستقیماً داخل یک تگ div نمایش داده شود.
Generate AI Report
ارسال دادههای JSON مالی و دریافت تحلیل متنی به همراه جداول HTML.
در این فرآیند نام آژانس (`branch`) از دیتابیس خوانده شده و در متن گزارش استفاده میشود تا تحلیل شخصیسازی شده باشد.
URL:
/v2/ai/chat/completionsMethod: POST
Controller: MainController@getReport
Body Parameters
| Parameter | Type | Description |
|---|---|---|
| message | JSON/Array | (الزامی) دادههای خام گزارش عملکرد (لیست خرید، فروش، سود، زیان و نوع خدمات). |
| branch | Integer | (الزامی) شناسه شعبه/آژانس (جهت واکشی نام آژانس و درج در گزارش). |
| model | String | (اختیاری) مدل هوش مصنوعی. پیشفرض: google/gemini-2.0-flash-001. |
| prompt | String | (اختیاری) دستورالعمل سفارشی برای تحلیلگر. در صورت عدم ارسال، از پرامپت پیشفرض (تحلیل 5 مرحلهای AirPlus) استفاده میشود. |
Default Prompt Structure
اگر پارامتر prompt ارسال نشود، سیستم دستورالعمل زیر را به AI میدهد:
- خلاصه وضعیت: کل فروش، هزینه و سود/زیان.
- تحلیل مقایسهای: مقایسه بین محصولات (پرواز، هتل، قطار و...).
- روندها: شناسایی رشد یا افت ناگهانی.
- جدول آمار: ارائه جدول HTML خلاصه.
- توصیه مدیریتی: پیشنهاد کاربردی برای بهبود سود (واحد پول: ریال).
Success Response Example
{
// خروجی بسته به کلاینت AI متفاوت است اما محتوا HTML است
"content": "گزارش عملکرد آژانس تعطیلات رویایی
بر اساس دادههای دریافتی...
..."
}Visual Logic Flow
Receive Financial JSON
↓
Fetch Branch Info
(Get 'title_fa' from DB)
(Get 'title_fa' from DB)
↓
Build Contextual Prompt
(Inject Branch Name + JSON Data + HTML formatting rules)
(Inject Branch Name + JSON Data + HTML formatting rules)
↓
Send to LLM (Gemini/GPT)
↓
Return HTML Report