ECC/docs/tr/rules/common/coding-style.md

# Kodlama Stili

## Immutability (KRİTİK)

DAIMA yeni nesneler oluştur, mevcut olanları ASLA değiştirme:

```
// Pseudocode
YANLIŞ:  modify(original, field, value) → original'i yerinde değiştirir
DOĞRU: update(original, field, value) → değişiklikle birlikte yeni kopya döner
```

Gerekçe: Immutable veri gizli yan etkileri önler, debug'ı kolaylaştırır ve güvenli eşzamanlılık sağlar.

## Dosya Organizasyonu

ÇOK KÜÇÜK DOSYA > AZ BÜYÜK DOSYA:
- Yüksek kohezyon, düşük coupling
- Tipik 200-400 satır, maksimum 800
- Büyük modüllerden utility'leri çıkar
- Type'a göre değil, feature/domain'e göre organize et

## Hata Yönetimi

Hataları DAIMA kapsamlı bir şekilde yönet:
- Her seviyede hataları açıkça ele al
- UI'ye yönelik kodda kullanıcı dostu hata mesajları ver
- Server tarafında detaylı hata bağlamı logla
- Hataları asla sessizce yutma

## Input Validasyonu

Sistem sınırlarında DAIMA validate et:
- İşlemeden önce tüm kullanıcı girdilerini validate et
- Mümkün olan yerlerde schema tabanlı validasyon kullan
- Açık hata mesajlarıyla hızlıca başarısız ol
- Harici verilere asla güvenme (API yanıtları, kullanıcı girdisi, dosya içeriği)

## Kod Kalitesi Kontrol Listesi

İşi tamamlandı olarak işaretlemeden önce:
- [ ] Kod okunabilir ve iyi adlandırılmış
- [ ] Fonksiyonlar küçük (<50 satır)
- [ ] Dosyalar odaklı (<800 satır)
- [ ] Derin iç içe geçme yok (>4 seviye)
- [ ] Düzgün hata yönetimi
- [ ] Hardcoded değer yok (sabit veya config kullan)
- [ ] Mutasyon yok (immutable pattern'ler kullanıldı)