Knowledge Management

KATMAN 1: AKTIF ISLER
  Simdi uzerinde calisilanlar. Sprint task'lari, aktif bug'lar, devam eden feature'lar.
  Konum: thoughts/active/ veya .claude/active/
  Kural: Max 5-7 aktif is. Fazlasi = fokus kaybı.

KATMAN 2: SORUMLULUK ALANLARI
  Surekli sahip oldugun alanlar. Auth modulu, API layer, deployment pipeline.
  Konum: thoughts/areas/ veya .claude/areas/
  Kural: Her alan icin tek sayfalik "durum raporu" tut.

KATMAN 3: REFERANSLAR
  Tekrar tekrar basvurulan bilgiler. API dokumantasyonu, tasarim kararlari, benchmark sonuclari.
  Konum: thoughts/references/ veya .claude/references/
  Kural: Ihtiyac duyuldugunda hizla bulunabilmeli.

KATMAN 4: ARSIV
  Tamamlanan isler, eski kararlar, deprecated feature'lar.
  Konum: thoughts/archive/ veya .claude/archive/
  Kural: Silme, tasi. Bir gun lazim olabilir.

YENi BILGI geldiginde:
  1. Aktif is ile ilgiliyse → KATMAN 1'e ekle
  2. Surekli sorumluluk alaniysa → KATMAN 2'ye ekle
  3. Referans/dokumantasyonsa → KATMAN 3'e ekle
  4. Hicbirine uymuyorsa → KATMA (gereksiz bilgi)

IS TAMAMLANDIGINDA:
  1. KATMAN 1'den kaldir
  2. Ogrenimleri KATMAN 3'e tasi (referans olarak)
  3. Detaylari KATMAN 4'e arsivle

# Auth Refactoring Notlari

- JWT'den session-based'e gecis karari alindi (2026-03-15)
- Neden: JWT revocation problemi, token boyutu sisiyor
- Redis session store kullanilacak
- Migration 3 fazda yapilacak

# Auth Refactoring Notlari

- **JWT'den session-based'e gecis** karari alindi (2026-03-15)
- Neden: **JWT revocation problemi**, token boyutu sisiyor
- **Redis session store** kullanilacak
- Migration **3 fazda** yapilacak

# Auth Refactoring

JWT revocation problemi nedeniyle session-based auth'a geciliyor.
Redis session store + 3 fazli migration plani var.

# Auth Sistemi Mimari Karar Kaydi

Session-based auth (Redis) tercih edildi. JWT'nin revocation ve boyut
problemleri cozumsuzdu. Bu karar API gateway tasarimini da etkiliyor --
her istekte Redis lookup gerekecek, caching stratejisi buna gore ayarlanmali.

thoughts/
  active/
    current-sprint.md        # Bu sprint'in task'lari
    in-progress-feature.md   # Uzerinde calisilanlar
  areas/
    auth.md                  # Auth modulu durumu
    api.md                   # API layer durumu
    infrastructure.md        # Infra durumu
  references/
    adr/                     # Architecture Decision Records
      001-session-auth.md
      002-redis-cache.md
    benchmarks/              # Performans sonuclari
    api-contracts/           # API sozlesmeleri
  archive/
    2026-q1/                 # Ceyreklik arsiv
    deprecated/              # Kaldirilmis feature'lar

# ADR-001: Session-Based Authentication

## Durum
Kabul edildi (2026-03-15)

## Baglam
JWT token'lari revoke edilemiyor, token boyutu buyuyor.

## Karar
Redis-backed session authentication'a gecis.

## Sonuclar
- (+) Anlik revocation mumkun
- (+) Token boyutu sorun degil
- (-) Redis bagimliligi eklendi
- (-) Her istekte session lookup gerekiyor

1. AKTIF ISLER (thoughts/active/) → Simdi alakali mi?
2. ALAN DURUMLARI (thoughts/areas/) → Bu alanla ilgili mi?
3. REFERANSLAR (thoughts/references/) → Daha once karar alinmis mi?
4. ARSIV (thoughts/archive/) → Gecmiste benzer is yapilmis mi?
5. GIT HISTORY (git log/blame) → Kodda ne degismis?
6. MEMORY SYSTEM (recall) → Baska session'larda ne ogrenmisiz?

Her hafta 15 dakika:
[ ] Aktif isler guncelle (tamamlananlar archive'a)
[ ] Alan durumlari guncelle (degisen varsa)
[ ] Referanslar guncelle (yeni karar varsa ADR yaz)
[ ] Gereksiz bilgileri sil veya arsivle

YAPMA: Her seyi kaydet
YAP:   Sadece tekrar kullanilacak bilgiyi kaydet

YAPMA: Tek buyuk dosyada tut
YAP:   Konu basina ayri dosya

YAPMA: Arsivi hicbir zaman temizleme
YAP:   Ceyreklik arsiv, yillik temizlik

YAPMA: Bilgiyi sadece kafanda tut
YAP:   Yazdığın an unutabilirsin, hemen kaydet

YAPMA: Her dosyayi ayni seviyede tut
YAP:   Progressive summarization ile katmanla