# DW Ads Reporter - Faz 8

Bu paket Faz 1-7 üstüne uygulanacak **AI yönetici yorumu / akıllı rapor yorumu** katmanıdır.

## Eklenenler

- AI yorum ayar ekranı
- OpenAI uyumlu Chat Completions endpoint desteği
- API anahtarını şifreli saklama
- Harici API kapalıysa yerel kural motoru ile yorum üretme
- Rapor detayından AI yorumu üretme / yenileme
- Rapor detayından AI yorumunu temizleme
- AI yorumu sonrası PDF/HTML/XLS dosyalarını yenileme
- Yönetici özeti, müşteri notu, teknik not, riskler, fırsatlar ve aksiyon listesi
- AI yorumlarını rapor HTML/PDF/XLS çıktısına ekleme
- Artisan komutu
- Queue job iskeleti
- Günlük otomatik AI yorum üretme scheduler satırı

## Kurulum

Faz 1-7 uygulanmış Vora `package` klasörünün üzerine bu patch dosyalarını kopyalayın.

```bash
composer dump-autoload
php artisan optimize:clear
php artisan migrate
```

## Yeni ekranlar

```text
/admin/ai/settings
/admin/reports/{id}
```

## Rapor detayındaki yeni işlemler

- AI Yorumu Üret / Yenile
- Yorumdan sonra rapor dosyalarını yenile
- Harici API yerine yerel kural motorunu kullan
- AI Yorumunu Temizle

## Komutlar

Son 10 tamamlanmış rapor için AI yorumu üretir:

```bash
php artisan dw:generate-ai-insights
```

Tek rapor için:

```bash
php artisan dw:generate-ai-insights 5
```

Belirli müşteri için:

```bash
php artisan dw:generate-ai-insights --client=2 --latest=20
```

Harici API kullanmadan yerel kural motoru ile:

```bash
php artisan dw:generate-ai-insights --force-local
```

AI yorumu sonrası dosyaları da yeniden üretir:

```bash
php artisan dw:generate-ai-insights --regenerate-files
```

## AI ayarları

Panelden şu bilgiler girilebilir:

- Aktif/pasif
- Sağlayıcı: Yerel kural motoru veya OpenAI uyumlu endpoint
- Endpoint
- Model
- API anahtarı
- Temperature
- Timeout

API anahtarı veritabanında şifreli saklanır ve panelde maskeli gösterilir.

## Not

Bu faz gerçek AI API anahtarı olmadan da çalışır. Harici API kapalıysa veya hata verirse sistem yerel kural motoru ile rapor yorumu üretir.
