Kod İnceleme Raporu

Sen yazılım mühendisliği ve kod inceleme süreçlerinde dünya çapında tanınan bir uzmansın. Google, Microsoft ve Amazon'da kıdemli yazılım mühendisi olarak çalışmış, açık kaynak projelere binlerce commit yapmış, Code Review Best Practices kitabının yazarı olmuş bir profesyonelsin. Clean Code, SOLID prensipleri ve yazılım mimarisi konularında derin bilgi sahibisin. Aşağıdaki görevi eksiksiz ve detaylı şekilde yerine getir: GÖREV: [PROGRAMLAMA DİLİ] ile geliştirilen [PROJE TİPİ] projesi için kapsamlı kod inceleme raporu hazırla. KOD İNCELEME PARAMETRELERİ: - Programlama dili: [JavaScript, Python, Java, C#, PHP, Ruby, Go, Rust, TypeScript] - Proje türü: [Web uygulaması, Mobil uygulama, API servisi, Konsol uygulaması, Embedded sistem, Dağıtık sistem] - Kod boyutu: [Satır sayısı, Dosya sayısı, Modül sayısı] - Ekip yapısı: [Takım büyüklüğü, Deneyim seviyesi, Coğrafi dağılım] - Mevcut süreç: [Code review araçları, CI/CD pipeline, Test coverage] KODUNUZ: ``` [İncelenecek kod bloğunu buraya yapıştırın] ``` İnceleme sürecinde şu başlıkları detaylı şekilde değerlendir: ## 1. Genel Yapı ve Mimari Değerlendirme Kodun genel yapısını ve mimari tasarımını incele. Modülerlik, katmanlı mimari, tek sorumluluk prensibi ve bağımlılık yönetimi açısından değerlendir. Kod organizasyonu, dosya yapısı ve isimlendirme standartlarını analiz et. Mevcut mimari kararlarının projenin ölçeğine uygunluğunu değerlendir ve gelecekteki genişleme potansiyelini göz önünde bulundur. ## 2. Kod Kalitesi ve Okunabilirlik Kodun okunabilirliğini, tutarlılığını ve bakım kolaylığını değerlendir. Değişken ve fonksiyon isimlendirmelerinin açıklığı, kod yorumlarının yeterliliği ve fonksiyon büyüklüklerinin kontrolünü yap. Tekrar eden kod bloklarını (code smells) tespit et ve DRY prensibi açısından değerlendir. Kodun kendi kendini açıklama kapasitesini ve karmaşıklık seviyesini analiz et. ## 3. Güvenlik Değerlendirmesi Olası güvenlik açıklarını ve riskleri tespit et. SQL injection, XSS, CSRF, authentication/authorization sorunları, secrets yönetimi ve veri doğrulama konularını detaylı incele. Güvenlik en iyi pratiklerine uygunluğunu değerlendir ve kritik güvenlik bulgularını öncelik sırasına göre sırala. ## 4. Performans ve Optimizasyon Kodun performans karakteristiklerini analiz et. Algoritma karmaşıklığı (Big O notation), bellek kullanımı, veritabanı sorguları ve API çağrılarını değerlendir. N+1 sorgu problemi, gereksiz döngüler, verimsiz veri yapıları ve önbellek kullanımı fırsatlarını tespit et. Performans kritik bölümleri ve potansiyel darboğazları belirle. ## 5. Hata Yönetimi ve Güvenilirlik Hata yakalama, istisna yönetimi ve fallback mekanizmalarını değerlendir. Try-catch bloklarının uygunluğu, hata mesajlarının bilgilendiriciliği ve sistem kurtarma kapasitesini analiz et. Edge case'lerin ve boundary condition'ların ele alınma biçimini incele. Loglama stratejisi ve izleme mekanizmalarının yeterliliğini değerlendir. ## 6. Test Kapsamı ve Kalitesi Mevcut testlerin kapsamını ve kalitesini analiz et. Unit test, integration test ve end-to-end test dağılımını değerlendir. Test coverage oranını, test başına düşen assertion sayısını ve mock kullanımının uygunluğunu incele. Edge case'lerin ve boundary condition'ların test edilme durumunu değerlendir. ## 7. En İyi Pratikler ve Öneriler İncelenen kod için somut ve uygulanabilir iyileştirme önerileri sun. Priority seviyesine göre sıralanmış action items listesi hazırla. Her öneri için 'onem: yuksek/orta/dusuk' ve 'Effort: yuksek/orta/dusuk' degerlendirmesi yap. Kısa vadeli quick wins'leri ve uzun vadeli refactoring ihtiyaçlarını ayır. ## 8. Örnek İyileştirmeler Tespit edilen sorunlar için before/after kod örnekleri sun. Her örnek için açıklayıcı yorumlar ekle ve iyilestirme avantajlarini belirt. Geliştirilmiş kodun orijinalinden nasıl farklı olduğunu ve hangi sorunları çözdüğünü detaylı açıkla. Her bölümü olabildiğince kapsamlı ve detaylı doldur. Rapor, hem teknik detay içermeli hem de yönetim karar destek sistemi olarak kullanılabilecek executive summary bölümü içermelidir. İnsanların kopyala-yapıştır ile kullanabileceği, directly applicable bir içerik oluştur.