# Kampüs Radar — GTÜ Kampüs Yoğunluk Haritası (Prototip)

> GTÜ Yapay Zeka Topluluğu — "Kampüsün Geleceğine Dokun" Yarışması, 27 Ekim 2026

**Canlı demo:** `index.html` dosyasını bir tarayıcıda açmanız yeterli (kurulum, derleme
ya da internet bağlantısı gerekmez). GitHub Pages linki: _(yayınlandıktan sonra buraya eklenecek)_.

---

## 1. Problem

GTÜ'nün her gün binlerce öğrencisi aynı soruyu kendine soruyor: *"Şu an nereye gitsem
boş olur?"* Bu sorunun cevabı hiçbir yerde yok — öğrenciler yemekhane, kütüphane,
spor tesisi gibi ortak alanlara şans eseri ya da alışkanlıkla gidiyor, doluluğu ancak
kapıdan girince öğreniyor.

Aynı veri eksikliği kurum tarafında da var: yemekhane ne kadar yemek pişireceğini,
kütüphane hangi saatte ek personel koyacağını, ulaşım birimi servisi ne zaman
sıklaştıracağını kestiremiyor.

## 2. Çözüm

**Kampüs Radar**, kampüsün anlık ve öngörülen yoğunluğunu tek bir görsel harita
üzerinde gösteren bir web uygulamasıdır:

- Gerçek GTÜ kampüs krokisi üzerine yerleştirilmiş **9 zon** (yemekhane, kütüphane,
  amfi, spor tesisi, yurt, market, kafe, Marmaray istasyonu, ana giriş)
- Durum bazlı renklendirme: **Boş / Orta Yoğun / Dolu**
- Zona tıklayınca: anlık doluluk yüzdesi, günlük örüntü (sparkline) ve
  **"önerilen en az yoğun saat"** önerisi
- Saatlik zaman ekseni + "Demo'yu Oynat" ile günün akışını canlı izleme
- **Yoğunluk Asistanı**: doğal dile yakın sorulara ("kütüphanede yer var mı?",
  "şu an nerede boş yer var?") cevap veren basit bir asistan arayüzü

## 3. ÖNEMLİ — Bu bir prototiptir

Bu depodaki **tüm doluluk verileri örnek/simülasyon verisidir** (`js/data.js`).
Hiçbir gerçek sensöre, kameraya ya da ağ altyapısına bağlı değildir. Yarışma
kapsamında sunulan şey, üretim sistemine giden **mimari ve kullanıcı deneyimidir** —
çalışan bir canlı veri entegrasyonu değil.

Arayüzdeki "Prototip · Örnek Veri" rozeti ve bu not, bunu şeffaf tutmak içindir.

## 4. Veri Mimarisi (gerçek üretim vizyonu)

Doluluk verisi tek bir kaynağa bağlı değil, değiştirilebilir (pluggable) bir
katman olarak tasarlanmıştır:

```
        [ Kullanıcı: Kampüs Radar ]
                     │
          [ Yoğunluk Tahmin Motoru ]   ← YZ / ML burada
   (ders programı + saat + geçmiş örüntü + bildirimler)
                     │
        ┌────────────┼──────────────┐
        │            │              │
  1) Öğrenci     2) Kampüs ağ    3) IoT sayaç /
   bildirimi     altyapısı (WLAN  kamera tabanlı
  (crowdsource)   controller'ın    doğrudan ölçüm
                  anonim cihaz
                  sayımı)
```

1. **Öğrenci bildirimi** — en hızlı başlatılabilir katman, kurum izni gerektirmez.
2. **Ağ altyapısı verisi** — GTÜ'nün WLAN controller'ı zaten her erişim noktasına
   (AP) kaç cihazın bağlı olduğunu biliyor. Bu veri **anonim ve toplu** (sadece
   sayı, MAC adresi takibi yok) olduğu için KVKK açısından düşük risklidir; GTÜ
   Bilgi İşlem Daire Başkanlığı'ndan resmi erişim talebiyle devreye alınabilir.
3. **IoT sayaç / kamera** — daha hassas ölçüm gerektiren noktalar için uzun vadeli
   seçenek.

**Neden tarayıcı kendisi WiFi'yi tarayamıyor?** Web platformunda (ve iOS/Android'de
büyük ölçüde) güvenlik nedeniyle SSID/BSSID/sinyal gücü okuma API'si yoktur. Bu
yüzden gerçek veri, istemci tarafından değil, ağ altyapısının **sunucu tarafından**
(controller API/SNMP) sağlanması gerekir — yukarıdaki mimari bunun için tasarlandı.

## 5. Yapay Zekanın Rolü

- **Tahmin modeli**: Ders programı + saat + geçmiş doluluk örüntüsünden saatlik
  yoğunluk tahmini (zaman serisi / gradient boosting benzeri bir model yeterli).
- **Anomali tespiti**: Beklenmeyen yoğunluk artışlarının (etkinlik, sınav haftası)
  otomatik fark edilmesi.
- **Doğal dil arayüzü**: Bu prototipteki "Yoğunluk Asistanı" kural tabanlı basit bir
  maket — üretimde bu katman, zon verisine bağlı bir RAG/LLM asistanına dönüşür.

## 6. Teknoloji

Bilinçli bir tercih: **sıfır bağımlılık, sıfır kurulum.** Saf HTML/CSS/JS —
Node, build adımı ya da paket yöneticisi gerekmez. Tarayıcıda `index.html` açmak
ya da herhangi bir statik dosya sunucusuna (GitHub Pages dahil) koymak yeterlidir.

```
web/
├── index.html          Ana sayfa
├── css/style.css        Stil (tek, bilinçli koyu tema)
├── js/data.js            Örnek veri + sabitler
├── js/app.js              Arayüz mantığı (render, zaman ekseni, asistan)
├── assets/campus-map.jpg  Gerçek GTÜ kampüs krokisi (kırpılmış, optimize)
└── README.md
```

## 7. Yol Haritası

| Aşama | Kapsam |
|---|---|
| **Faz 0 — Yarışma demosu** | Bu prototip: sahte veri, tam arayüz, tüm etkileşimler |
| **Faz 1** | Öğrenci bildirimi katmanı (gerçek crowdsource verisi) |
| **Faz 2** | GTÜ Bilgi İşlem ile WLAN controller entegrasyonu, gerçek tahmin modeli |
| **Faz 3** | Kurum paneli: yemekhane talep tahmini, bina bazlı kapasite planlama |

## 8. Ekip

_(İsim / öğrenci numarası / bireysel ya da 2 kişilik ekip bilgisi buraya eklenecek.)_