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

# L7 — Reports (CEO Brief PDF)

> 10 slayt yönetim raporu — KPI özeti, ROI bulguları, optimum bütçe, pazar konjonkturu, model performansı.

# L7 — Reports

`/dashboard/reports` adresinde **CEO Brief PDF** raporları üretilen istasyon.

## Ne Üretir?

10 slayt yönetim raporu (PDF, \~1 MB):

| Slayt | İçerik                                                               |
| ----- | -------------------------------------------------------------------- |
| 1     | Kapak (logo, brand, tarih, period)                                   |
| 2     | KPI Özeti (toplam sales, growth %, period)                           |
| 3     | 3 Farklı Bulgu (best ROI delta + saturation uyarısı + scenario lift) |
| 4     | Top 3 Channels Tablosu                                               |
| 5     | Optimum Bütçe Tablosu (mevcut vs. optimized)                         |
| 6     | Pazar Konjonkturu (FX + CPI + Ramadan + holiday)                     |
| 7     | Veri Kalitesi (DQS breakdown)                                        |
| 8     | Model Performansı (R-hat + MAPE diagnostics)                         |
| 9     | Risk Uyarıları                                                       |
| 10    | Sonraki Adımlar                                                      |

## Generate Workflow

<Steps>
  <Step title="Run Seç">
    Hangi model run'undan rapor üretmek istiyorsunuz? Default: en son completed run.
  </Step>

  <Step title="Period Seç">
    Genelde "son 52 hafta" veya "son 26 hafta". Custom date range opsiyonel.
  </Step>

  <Step title="Scenario Seç (Opsiyonel)">
    L5 Budget Optimizer'da oluşturduğunuz senaryolardan birini "optimum" olarak göstermek istiyor musunuz?

    Yoksa: scenario fallback message ("Henüz optimization yapılmadı") slaytta görünür.
  </Step>

  <Step title="Generate">
    "CEO Brief Oluştur" butonu → arka planda PDF render (10-30 saniye) → download link.
  </Step>
</Steps>

## Örnek Slayt — 3 Bulgu (Slayt 3)

```
┌─ 3 Kritik Bulgu ─────────────────────────────────┐
│                                                    │
│  🎯 BEST ROI (TV)                                  │
│     Bu period TV ROI: 3.18 (önceki +0.23)          │
│     Yıllık 1.45M TL TV harcaması →                 │
│     4.6M TL gelir katkısı                          │
│                                                    │
│  ⚠️ SATURATION RISK (OOH)                          │
│     OOH mevcut spend %120 saturation               │
│     Diminishing return — bütçeyi azaltma fırsatı   │
│                                                    │
│  📈 OPTIMIZATION LIFT                              │
│     Aynı 5.05M TL bütçe ile +%14.2 satış olası     │
│     Yeni allocation: TV +%6, OOH -%4               │
│                                                    │
└────────────────────────────────────────────────────┘
```

## Slayt 4 — Top 3 Channels

```
┌─ En Verimli 3 Kanal ──────────────────────────────────┐
│                                                          │
│  1. TV          ROI 3.18    1.45M TL → 4.6M TL gelir    │
│     Confidence:  [2.84, 3.52]  ✅ Yüksek                │
│                                                          │
│  2. YouTube     ROI 1.68    850K TL → 1.4M TL gelir     │
│     Confidence:  [1.42, 1.94]  ✅ Yüksek                │
│                                                          │
│  3. Meta Ads    ROI 1.45    950K TL → 1.4M TL gelir     │
│     Confidence:  [1.18, 1.72]  ⚠️ Orta                  │
│                                                          │
│  Note: ROI 95% confidence interval'lerine dikkat.        │
│                                                          │
└──────────────────────────────────────────────────────────┘
```

## Slayt 6 — Pazar Konjonkturu

```
┌─ Pazar Faktörleri (Period: 2025-Q1) ──────────────┐
│                                                      │
│  💵 FX (USD/TRY)                                    │
│     Period başı: 32.45 → Period sonu: 35.18         │
│     Volatilite: ±%2.4 (Std Dev)                     │
│                                                      │
│  📊 Enflasyon (CPI)                                 │
│     Yıllık ortalama: %52.3                          │
│     Trend: Düşüş (Q4 2024: 56.7 → Q1 2025: 52.3)    │
│                                                      │
│  🌙 Ramazan Etkisi                                  │
│     2025: 1 Mart - 30 Mart                          │
│     KPI etkisi: -%12 (sektör otomotiv averajı)      │
│                                                      │
│  🎄 Q4 Amplitude                                     │
│     Aralık: %30 üstünde organik baseline            │
│                                                      │
└──────────────────────────────────────────────────────┘
```

## Slayt 8 — Model Performansı

```
┌─ Model Sağlığı ───────────────────────────────────┐
│                                                      │
│  🟢 R-hat (Convergence)                              │
│     Average: 1.02     Max: 1.04                      │
│     Threshold: < 1.05  ✅ PASSED                     │
│                                                      │
│  🟢 MAPE (Forecast Error)                            │
│     Value: 14.2%                                     │
│     Threshold: < 30%   ✅ EXCELLENT                  │
│                                                      │
│  🟢 HMC Tree Depth                                   │
│     Average: 7.3     Max: 9                          │
│     Threshold: < 10    ✅ PASSED                     │
│                                                      │
│  🟢 Effective Sample Size                            │
│     Min: 1,247       Threshold: > 400                │
│     Result: ✅ Good posterior coverage               │
│                                                      │
└──────────────────────────────────────────────────────┘
```

## Faz E1-7 Chart Embed (Opsiyonel, Backlog)

Faz E1-7 görsel embed sonradan yapılacak (Matplotlib SVG → PDF). Şu an tablolar ve metin format yeterli; chart eklendiğinde slayt 4 + 5 + 6 görsellesir.

## Frequency

* **Aylık** — varsayılan rapor cycle
* **Quarterly** — yönetim toplantıları
* **Ad-hoc** — yeni model run sonrası, kampanya değerlendirme

## Customization (Faz E5+)

İleri seviye özelleştirme planlı:

* Logo değiştirme (custom branding per org)
* Slayt seçimi (örn: sadece slayt 1-5)
* Çoklu dil (EN versiyonu)
* Email schedule (her ayın 1'inde otomatik)

## API Endpoint

```bash theme={null}
# Generate PDF
curl -X POST https://api.mmmytics.com/api/v1/reports/generate \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "model_run_id": "<run-uuid>",
    "scenario_id": "<scenario-uuid>",
    "period_start": "2025-01-06",
    "period_end": "2025-12-29"
  }'

# Polling for download URL
curl https://api.mmmytics.com/api/v1/reports/$REPORT_ID/download \
  -H "Authorization: Bearer $TOKEN"
```

## Sonraki Adım

Tüm 6 istasyonu gezdiniz! Şimdi **gelişmiş özellikler**:

<CardGroup cols={2}>
  <Card title="Command Board" icon="grid" href="/docs/mintlify/command-board">
    L6 canlı dashboard widget'ları
  </Card>

  <Card title="Custom Sector" icon="puzzle-piece" href="/docs/mintlify/custom-sector">
    F3 — kendi sektörünüzü tanımlayın
  </Card>

  <Card title="Campaigns" icon="bullhorn" href="/docs/mintlify/campaigns">
    F4 — kampanya bazlı veri organizasyon
  </Card>
</CardGroup>

## Phase 24 — Multi-brand Raporlama

`CMO`/`CEO` rolündeki kullanıcılar birden fazla markaya sahip organizasyonlarda her marka için ayrı CEO Brief PDF üretebilir. **Settings → Benchmark Override** sekmesindeki marka seçici (dropdown) ile aktif marka bağlamını değiştirin, ardından L7 Reports'tan rapor talep edin. `Agency` rolündeki kullanıcılar yalnızca kendilerine atanan markalar (`assigned_brand_ids`) için rapor üretebilir; cross-org isolation **PostgreSQL RLS** ile garantilenir.

<Note>
  **Hybrid Report v1.14** — 6 sayfalık genişletilmiş CEO Brief:

  1. **Kapak** — marka + `run_id` + locale + tarih
  2. **Yönetici Özeti** — top 3 insight + actionable recommendation
  3. **Kanal Mix** — ROI tablo + decomposition pasta
  4. **Radar Chart** — 6-axis (`efficiency`, `scale`, `fit`, `reliability`, `brand_resonance`, `model_reliability`)
  5. **Channel Saturation Curves** — Hill curves + `threshold_warn`
  6. **Decomposition** — baseline + media contribution waterfall
</Note>

[Multi-brand portföy detayı →](/settings/multi-brand)