📌 Hızlı Özet:
Kod bilgisayarlar anlasın diye değil, 6 ay sonra o koda bakım yapacak olan siz veya ekip arkadaşınız anlasın diye yazılır.


SOLID Prensipleri ve Temiz Kod

Pratik Temiz Kod İpuçları

  1. Anlamlı İsimlendirme: int d; yerine int elapsedTimeInDays; yazın. Kısaltmalardan kaçının.
  2. Kısa Fonksiyonlar: Bir fonksiyon 20 satırı geçiyorsa muhtemelen birden fazla iş yapıyordur; bölün.
  3. Yorum Satırı Bağımlılığı: Kötü yazılmış kodu açıklamak için yorum yazmayın; kodu kendini açıklayacak kadar temiz yeniden yazın.

📌 Sıradaki İlgili Rehber: Junior Yazılımcılar İçin En Büyük Tuzaklar ve Kurtulma Yolları
Temiz kod alışkanlığı ile kariyer basamaklarını hızla tırmanın.

SOLID Prensiplerinin Gerçek Hayat Senaryoları

Akademik teoride SOLID prensipleri sıkıcı gelebilir; ancak üretime çıkan gerçek bir projede sistemin ayakta kalmasını sağlar:

Harf Prensip Kötü Uygulama (Anti-Pattern) Temiz Çözüm (Clean Pattern)
S Single Responsibility Bir sınıfın hem HTTP isteği alması, hem SQL sorgusu yazması hem de PDF faturası üretmesi Servis, Repository ve PDFGenerator sınıflarına bölme
O Open/Closed Yeni bir ödeme yöntemi (Kripto) eklemek için mevcut PaymentProcessor if/else bloğunu değiştirmek PaymentMethod arayüzü tanımlayıp yeni sınıfla genişletme
L Liskov Substitution Kare sınıfını Dikdörtgenden türetip genişlik değişince yüksekliğin de bozulması Ortak geometrik arayüz kullanımı veya kompozisyon
I Interface Segregation Tek bir Worker arayüzüne eat(), code(), sleep() koyup robot sınıfına zorlamak Workable ve Feedable gibi küçük atomik arayüzler
D Dependency Inversion Üst seviye servisin doğrudan somut MySQLDatabase sınıfını new ile oluşturması Arayüze (IDatabase) bağımlı olup Dependency Injection kullanma

DRY ve YAGNI Dengesi: Erken Soyutlama Tuzağı

Birçok junior geliştirici Clean Code kurallarını yanlış yorumlayarak henüz 2 kez tekrar eden kod parçalarını anında generic mikro sınıflara böler. Bu durum kodun okunabilirliğini yok eder (“Spagetti soyutlama”).

Kural: “Rule of Three” (Üç Kuralı): Bir kod kalıbı 3 farklı yerde bağımsız olarak kopyalanmadıkça erken soyutlama yapmayın. Kodun net ve okunabilir olması, aşırı soyutlanmış olmasından daha değerlidir.

Fonksiyon Boyutu, İsimlendirme ve Bilişsel Yük (Cognitive Load)

Temiz kodun en temel göstergesi bir fonksiyonun ekrana sığması değil, okuyucunun zihninde yarattığı bilişsel yükün (cyclomatic complexity) düşük olmasıdır:

  • Yan Etkisiz Fonksiyonlar (Pure Functions): Bir fonksiyon dış dünyadaki global değişkenleri değiştirmemeli; aynı girdiye her zaman aynı çıktıyı vermelidir.
  • Net İsimlendirme: data, process(), handle() gibi belirsiz isimler yerine calculate_tax_deduction(), serialize_user_session() gibi amacını doğrudan haykıran fiil-isim tamlamaları tercih edilmelidir.
  • Erken Çıkış Kuralı (Guard Clauses): İç içe 5 seviyeli if-else piramitleri yerine, koşul sağlanmadığı anda fonksiyonun başında return veya throw ile erken çıkış yapılmalıdır.

Kod Kokuları (Code Smells) ve Refactoring İşaretleri

  • Büyük Sınıflar (God Class): 1000 satırı aşan ve her işi yapmaya çalışan sınıflar Single Responsibility ilkesini çiğner; bağımsız modüllere bölünmelidir.
  • Uzun Parametre Listeleri: Bir fonksiyona 5’ten fazla argüman geçiliyorsa, bu parametreler bir Konfigürasyon veya DTO nesnesi içinde toplanmalıdır.

Sıkça Karşılaşılan Sorular ve Sahadan Uzman Yanıtları (FAQ)

1. Bu mimariyi uygularken ilk aşamada en çok yapılan hata nedir?

En sık karşılaşılan tuzak, konfigürasyon parametrelerini ve sistem sınırlarını test etmeden doğrudan varsayılan değerlerle (default values) üretime almaktır. Özellikle yüksek eşzamanlılık (concurrency) ve bellek kısıtlı ortamlarda varsayılan ayarlar ani gecikme artışlarına ve soket tükenmesine (socket exhaustion) yol açar. Sistem her zaman kademeli yük testleriyle doğrulanmalıdır.

2. Performansı optimize ederken hangi metrikler izlenmelidir?

Sistemin sağlığını izlerken tek başına CPU kullanımına bakmak yanıltıcıdır. P95 ve P99 gecikme süreleri (latency percentiles), bellek tahsis hızları (heap allocation rate), I/O bekleme süreleri (iowait) ve hata oranları (error rate) birincil göstergeler olmalıdır. Grafana veya Prometheus gibi araçlarla bu metrikler anlık olarak takip edilmelidir.

3. Geriye dönük uyumluluk (Backward Compatibility) nasıl garanti edilir?

API ve veri formatı güncellemelerinde anlamsal sürümleme (SemVer) kurallarına sıkı sıkıya bağlı kalınmalıdır. Protokol veya şema değişikliklerinde eski versiyon en az iki ara sürüm boyunca desteklenmeli ve geçiş köprüleri (adapter layer) tanımlanmalıdır.

Üretime Alma ve Güvenlik Doğrulama Kontrol Listesi

Sistemi canlıya almadan veya sahaya çıkarmadan önce şu adımları tamamlayın:

  • Hata Yakalama ve Loglama: Tüm kritik akışlarda yapılandırılmış loglama (JSON formatında) ve panik/crash kurtarma mekanizmaları kuruldu.
  • Giriş Doğrulama (Sanitization): Dış dünyadan veya istemciden gelen tüm parametreler sıkı tip ve sınır denetiminden geçirildi.
  • Kaynak Sınırları (Resource Limits): Süreç bazında bellek (cgroups/RAM) ve dosya tanımlayıcı (ulimit -n) sınırları tanımlandı.
  • Otomatik Yedekleme ve Kurtarma: Sistem çökmesi durumunda otomatik yeniden başlama (systemd / restart: always) politikası test edildi.

Uzun Vadeli Bakım ve Mimari Yol Haritası (Long-Term Maintenance)

Bir yazılım sisteminin veya teknik altyapının gerçek maliyeti ilk geliştirme anında değil, sonraki 2-3 yıllık bakım ve işletim evresinde ortaya çıkar. Sürdürülebilir bir mühendislik disiplini için şu prensipler uygulanmalıdır:

  1. Teknik Borç Yönetimi: Her geliştirme sprintinin veya proje döngüsünün en az %15-20’lik bölümü refactoring, kütüphane bağımlılık güncellemeleri ve teknik borçların temizlenmesine ayrılmalıdır.
  2. Otomatik Regresyon Testleri: Kod tabanına eklenen her yeni özellik veya hata düzeltmesi, gelecekte aynı hatanın tekrar etmesini engelleyen otomatik regresyon testleriyle mühürlenmelidir.
  3. Şeffaf Ekip İletişimi: Mimari değişiklikler kişisel kararlarla değil, ekip içi ortak tasarım dokümanları ve RFC tartışmalarıyla olgunlaştırılmalıdır.