# İstatistik & KPI API

Synapse, ajan sağlığı, API kullanımı, eğilimler ve filo KPI'ları hakkında salt okunur istatistikler sunar. Tüm uçlar ya bir MindKey (`Authorization: Bearer`) ya da bir kullanıcı JWT'si (`requireMindOrUser`) kabul eder.

Mevcut analitik rotalar (WebUI'deki `/stats` sayfasına bakın):

| Rota | Amaç |
| --- | --- |
| `GET /stats/agent` | Tüm ajanlara genel bakış (dönem: `days`) |
| `GET /stats/agent/comparison` | Ajanlar arası karşılaştırma |
| `GET /stats/agent/:mindName` | Bir ajanın ayrıntılı istatistikleri |
| `GET /stats/agent/:mindName/health` | Sağlık puanı |
| `GET /stats/agent/:mindName/heatmap` | Etkinlik ısı haritası |
| `GET /stats/agent/:mindName/sessions` | Oturum izleyici |
| `GET /stats/api` | API kullanımı (global) |
| `GET /stats/trends` | Zaman serileri |
| `GET /stats/chat/response-times` | Sohbet yanıt süreleri |
| `GET /stats/a2a/flow` | A2A mesaj akışı |
| `GET /stats/cron` | Cron analitiği |
| `GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring` | Pano toplamları |

## GET /export/kpis

Operasyonel KPI'ların tidy-long dışa aktarımı (task 7418541b). Verinin doğruluk kaynağı `src/db/stats.ts`'dir — dışa aktarma katmanı yalnızca düzleştirir, kendisi hiçbir şeyi ölçmez.

```
GET /export/kpis?format=csv|json|xlsx&days=7
```

| Parametre | Değerler | Varsayılan |
| --- | --- | --- |
| `format` | `csv` · `json` · `xlsx` | `json` |
| `days` | `1`–`365` (ajan genel bakışı için pencere) | `7` |

Yanıt:

- `format=json` → `{ generated_at, period_days, format: "long", columns, row_count, rows[] }`
- `format=csv` → `text/csv; charset=utf-8` (RFC 4180, BOM, CRLF) ek olarak
- `format=xlsx` → Excel çalışma kitabı (tek sayfa `KPIs`) ek olarak

Tidy-long sütunları (tüm formatlarda özdeş):

| Sütun | Anlam |
| --- | --- |
| `kategorie` | KPI grubu: `fleet`, `summary`, `backlog`, `activity`, `team`, `monitoring`, `agent_overview` |
| `metrik` | Düzleştirilmiş metrik yolu (örn. `throughput.done_24h_total`) |
| `wert` | Skaler değer (sayı, metin ya da yalnızca `detail` veri taşıdığında `NULL`) |
| `einheit` | `value` · `count` · `text` · `json` |
| `zeitstempel` | Dışa aktarımın ISO-8601 üretim zaman damgası |
| `quelle` | `src/db/stats.ts` içindeki kaynak fonksiyon |
| `detail` | Diziler/derin nesneler için JSON yükü, aksi halde boş |

Örnek:

```bash
curl -s -H "Authorization: Bearer $MIND_KEY" \
  "https://synapse.schaefer.zone/export/kpis?format=csv&days=7" -o kpis.csv
```

WebUI'deki `/stats` sayfası aynı dışa aktarımı "KPI export" bölümünde üç indirme düğmesi (CSV/JSON/XLSX) olarak gösterir.