# POST /v2/ai/chat/completions

<div class="api-docs" id="bkmrk-">  <div class="endpoint-section">  
</div></div>## AI Financial Analysis Logic

این اندپوینت داده‌های خام مالی (شامل خرید، فروش، سود و زیان) را دریافت کرده و آن را به یک گزارش متنی/بصری تبدیل می‌کند.   
**نقش سیستم:** سیستم به عنوان یک مدیر مالی هوشمند برای نرم‌افزار *AirPlus* عمل می‌کند.   
**فرمت خروجی:** پرامپت سیستم به گونه‌ای تنظیم شده که خروجی نهایی صرفاً کد `HTML Body` باشد تا در فرانت‌اند مستقیماً داخل یک تگ `div` نمایش داده شود.

<div class="api-docs" id="bkmrk--1"><div class="endpoint-section">  
</div>  
---

  </div># Generate AI Report

ارسال داده‌های JSON مالی و دریافت تحلیل متنی به همراه جداول HTML.   
در این فرآیند نام آژانس (`branch`) از دیتابیس خوانده شده و در متن گزارش استفاده می‌شود تا تحلیل شخصی‌سازی شده باشد.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fai%2Fchat%2Fcom"><div class="endpoint-info"><div>**URL:** `/v2/ai/chat/completions`</div><div>**Method:** <span class="method-post">POST</span></div><div>**Controller:** MainController@getReport</div></div></div>### Body Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">message</td><td>JSON/Array</td><td>(الزامی) داده‌های خام گزارش عملکرد (لیست خرید، فروش، سود، زیان و نوع خدمات).</td></tr><tr><td dir="ltr">branch</td><td>Integer</td><td>(الزامی) شناسه شعبه/آژانس (جهت واکشی نام آژانس و درج در گزارش).</td></tr><tr><td dir="ltr">model</td><td>String</td><td>(اختیاری) مدل هوش مصنوعی.   
پیش‌فرض: `google/gemini-2.0-flash-001`.</td></tr><tr><td dir="ltr">prompt</td><td>String</td><td>(اختیاری) دستورالعمل سفارشی برای تحلیلگر. در صورت عدم ارسال، از پرامپت پیش‌فرض (تحلیل 5 مرحله‌ای AirPlus) استفاده می‌شود.</td></tr></tbody></table>

</div>### Default Prompt Structure

اگر پارامتر `prompt` ارسال نشود، سیستم دستورالعمل زیر را به AI می‌دهد:

<div class="api-docs" id="bkmrk-%D8%AE%D9%84%D8%A7%D8%B5%D9%87-%D9%88%D8%B6%D8%B9%DB%8C%D8%AA%3A-%DA%A9%D9%84-%D9%81%D8%B1%D9%88%D8%B4">- **خلاصه وضعیت:** کل فروش، هزینه و سود/زیان.
- **تحلیل مقایسه‌ای:** مقایسه بین محصولات (پرواز، هتل، قطار و...).
- **روندها:** شناسایی رشد یا افت ناگهانی.
- **جدول آمار:** ارائه جدول HTML خلاصه.
- **توصیه مدیریتی:** پیشنهاد کاربردی برای بهبود سود (واحد پول: ریال).

</div>### Success Response Example

```json
{
    // خروجی بسته به کلاینت AI متفاوت است اما محتوا HTML است
    "content": "
```

### گزارش عملکرد آژانس تعطیلات رویایی

```
```

بر اساس داده‌های دریافتی...

```json
..."
}
```

<div class="api-docs" id="bkmrk--3">---

</div>### Visual Logic Flow

<div class="api-docs" id="bkmrk-receive-financial-js"><div class="flowchart"><div class="flow-item">Receive Financial JSON</div><div class="flow-arrow">↓</div><div class="flow-item-process" style="background-color: #e0f7fa;">**Fetch Branch Info**  
(Get 'title_fa' from DB)</div><div class="flow-arrow">↓</div><div class="flow-item-process" style="background-color: #fff3e0;">**Build Contextual Prompt**  
(Inject Branch Name + JSON Data + HTML formatting rules)</div><div class="flow-arrow">↓</div><div class="flow-item">Send to LLM (Gemini/GPT)</div><div class="flow-arrow">↓</div><div class="flow-item-success">**Return HTML Report**</div></div></div>