# KGYS — Kamera Görüntü Yönetim Sistemi
## Bilgi Notu | 2026-05-01

---

## PROJE TANIMI

Emniyet Müdürlüğü ile yapılan toplantı sonrası ortaya çıkan bağımsız sistem.

> Hakkında görüntü/fotoğraf bulunan şüpheli bir kişinin şehirdeki kamera arşivlerinde otomatik olarak tespit edilmesi.

**AKİS ile ilişkisi:** Yok. Tamamen bağımsız proje, ayrı backend, ayrı dashboard.

---

## SENARYO

1. Şüpheliye ait net fotoğraf veya video karesi sisteme yüklenir
2. Belirtilen kameranın 24 saatlik arşiv görüntüsü işleme alınır
3. Sistem şüphelinin o görüntülerde görünüp görünmediğini tarar
4. Eşleşen anlar → **kamera ID + tarih/saat + güven skoru** ile raporlanır
5. Son karar her zaman **insan** tarafından verilir — sistem aday listesi çıkarır

---

## FİZİKSEL MİMARİ

```
[4.200 + 500 Kamera]
    → Ethernet → Emniyet Merkezi
        ├── Mevcut MOBESE Sistemi (paralel)
        └── KGYS Sunucusu (paralel — aynı feed'den kopya)
```

- Tamamen **kapalı ağ / local** — dışarıya veri çıkmaz
- Emniyet'in kendi sunucularında çalışır
- Kamera görüntüleri zaten ethernet ile merkeze geliyor

**Emniyet Altyapısı:**
- 4.200 normal MOBESE
- 500 yüz tanıma özellikli kamera (HD — öncelikli)

---

## TEKNİK STACK

| Bileşen | Teknoloji |
|---|---|
| Yüz tespiti + embedding | InsightFace (buffalo_l) — 512 vektör |
| Görüntü iyileştirme | GFPGAN / Real-ESRGAN |
| Hızlı vektör araması | FAISS |
| Video işleme | OpenCV |
| İnsan tespiti (optimizasyon) | YOLO — opsiyonel, boş kareleri atlar |
| Backend | FastAPI (yeni, bağımsız) |
| Veritabanı | SQLite veya PostgreSQL |
| Frontend | Yeni, bağımsız dashboard |

---

## TEKNİK PİPELINE

```
[Şüpheli Fotoğrafı]
    → RetinaFace (yüz tespit)
    → ArcFace (512 vektör) → referans embedding

[Kamera Arşiv Görüntüsü / Canlı Feed]
    → (Opsiyonel) YOLO: insan var mı? → yoksa atla
    → GFPGAN: kalite iyileştir
    → RetinaFace: yüz tespit
    → ArcFace: 512 vektör
    → FAISS: referans ile karşılaştır (eşik: 0.65+)

[Sonuç]
    → Kamera ID + Zaman Damgası + Güven Skoru
    → Dashboard'a raporla
```

---

## DOĞRULUK GERÇEKÇİLİĞİ

| Kamera Tipi | Beklenen Doğruluk |
|---|---|
| 500 HD yüz tanıma kamerası | %70–85 |
| 4.200 normal MOBESE | %30–50 |
| GFPGAN sonrası | +%10–20 iyileşme |

---

## PERFORMANS (1 Kamera — 24 Saat — 1 FPS)

| GPU | Süre |
|---|---|
| RTX 4060 | ~7 dakika |
| RTX 4090 | ~1 dakika |
| H100 80GB | ~40 saniye |

---

## GELİŞTİRME PLANI

**Faz 1 — Prototip (MacBook M5)**
- [ ] InsightFace test — model indir, çalışıyor mu doğrula ✓ kuruldu
- [ ] Tek fotoğraf → embedding üretimi
- [ ] Video dosyası → kare kare tarama + eşleşme
- [ ] GFPGAN entegrasyonu
- [ ] FastAPI backend — sorgu endpoint'i
- [ ] Dashboard — basit arayüz

**Faz 2 — Üretim (Emniyet Sunucusu)**
- [ ] Yüksek kapasiteli sunucu (RTX 4090 / H100)
- [ ] FAISS vektör veritabanı
- [ ] Ethernet feed entegrasyonu (RTSP/ONVIF)
- [ ] 500 kamera entegrasyonu
- [ ] Canlı izleme + anlık alarm
- [ ] Tam dashboard

---

## AÇIK SORULAR

- [ ] 500 yüz tanıma kamerasının üreticisi, protokolü (RTSP/ONVIF?)
- [ ] Arşiv kaç günlük tutuluyor, depolama kapasitesi
- [ ] Yetki seviyeleri — kimler sisteme erişecek
- [ ] Öncelik: arşiv tarama mı, canlı izleme mi

---

*Not: Bu belge tartışma devam ettikçe güncellenecektir.*