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

Run Seç

Hangi model run’undan rapor üretmek istiyorsunuz? Default: en son completed run.

Period Seç

Genelde “son 52 hafta” veya “son 26 hafta”. Custom date range opsiyonel.

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.

Generate

“CEO Brief Oluştur” butonu → arka planda PDF render (10-30 saniye) → download link.

Ö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

# 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:

Command Board

L6 canlı dashboard widget’ları

Custom Sector

F3 — kendi sektörünüzü tanımlayın

Campaigns

F4 — kampanya bazlı veri organizasyon

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.

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

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

Multi-brand portföy detayı →

Documentation Index

​L7 — Reports

​Ne Üretir?

​Generate Workflow

​Örnek Slayt — 3 Bulgu (Slayt 3)

​Slayt 4 — Top 3 Channels

​Slayt 6 — Pazar Konjonkturu

​Slayt 8 — Model Performansı

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

​Frequency

​Customization (Faz E5+)

​API Endpoint

​Sonraki Adım