> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Raporları

> AIReport modeli — LLM tabanlı rapor üretimi.

AI Raporu, Flextell'in seçilen sistemlerden veri toplayıp LLM'e özetletmesi sonucu üretilen rapordur. Geçmiş raporlar saklanır, PDF olarak da dışa aktarılabilir (`File` ile).

## Yapı (`AIReport`)

| Alan                         | Açıklama                           |
| ---------------------------- | ---------------------------------- |
| `user_id`                    | Raporu üreten kullanıcı            |
| `systems[]`                  | Hangi sistemlerden veri çekileceği |
| `title`                      | Rapor başlığı                      |
| `result`                     | LLM cevabı (metin)                 |
| `result_data[]`              | Yapılandırılmış sonuç              |
| `model`                      | Kullanılan LLM modeli              |
| `status`                     | `AIReportStatus` enum              |
| `period_start`, `period_end` | Veri aralığı                       |
| `llm_usage_id`               | Kredi tüketim referansı            |
| `completed_at`               | Tamamlanma anı                     |

## Üretim akışı

```mermaid theme={null}
sequenceDiagram
    participant U as Kullanıcı
    participant F as Flextell
    participant J as GenerateAIReportJob
    participant L as LLM
    
    U->>F: Sistem(ler) + dönem seç
    F->>J: Job kuyrukla (status=pending)
    J->>F: Sistemlerden veri topla
    J->>L: Promptu gönder
    L-->>J: Yanıt
    J->>F: result + result_data kaydet
    J->>F: status=completed
    F-->>U: Bildirim
```

## Veri kaynakları (`systems[]`)

Rapor üretirken seçilebilen kaynaklar (`ReportGenerator`):

| Kaynak         | İçerik            |
| -------------- | ----------------- |
| `tickets`      | Destek talepleri  |
| `appointments` | Randevu kayıtları |
| `customers`    | Hasta kayıtları   |
| `treatments`   | Tedavi tanımları  |
| `doctors`      | Doktor kayıtları  |
| `blacklist`    | Kara liste        |
| `llm_usage`    | AI kullanım       |
| `files`        | Yüklenen dosyalar |

## Zamanlanmış raporlar (`AIReportSchedule`)

Periyodik raporlar için zamanlama tanımı yapılabilir; tetiklendiğinde otomatik olarak yeni bir `AIReport` üretir.

## Dosya çıktısı

Rapor tamamlandıktan sonra PDF olarak indirilebilir; PDF, `File` modeline `fileable_type=AIReport` ile bağlanır.

## Kredi kullanımı

Her rapor üretimi LLM kredisi tüketir (`llm_usage_id` üzerinden takip). Detay: [Krediler](/documentation/system/credits).