AI ile Code Review ve Refactoring

AI ile Code Review ve Refactoring Prompt Şablonları

Bu rehber, yapay zeka kullanarak etkili kod incelemeleri yapmak, kod kalitesini artırmak ve refactoring süreçlerini hızlandırmak için tasarlanmış kapsamlı prompt şablonlarını içermektedir. Pull request review den legacy kod modernizasyonuna, güvenlik analizinden performans optimizasyonuna kadar geniş bir yelpazede kullanabileceğiniz şablonlar sunulmaktadır.

🔍 Kullanım Notu: Şablonlardaki [KÖŞELİ PARANTEZ] içindeki alanları kendi kodunuza göre doldurun. Hassas bilgileri (API key, şifre, production verileri) paylaşmadan önce temizleyin. AI önerilerini mutlaka test edin ve code review sürecinizin yerini almak yerine destekleyici olarak kullanın.

Code Review Şablonları

Kapsamlı Code Review

Detaylı ve çok yönlü kod incelemesi için.

Bu kodu kapsamlı olarak review et.



KOD BİLGİLERİ:

- Programlama dili: [Python / JavaScript / TypeScript / Java / C# / Go / ...]

- Framework: [Varsa - React, Django, Spring, .NET, ...]

- Proje türü: [Web app / API / Library / CLI / ...]

- Kodun amacı: [Bu kod ne yapıyor]



KOD:

[Kodu buraya yapıştır]



REVIEW KRİTERLERİ:



1. DOĞRULUK VE İŞLEVSELLİK:

   - Kod belirtilen amacı gerçekleştiriyor mu?

   - Edge case ler handle ediliyor mu?

   - Hata durumları düzgün yönetiliyor mu?

   - Business logic doğru mu?



2. OKUNABİLİRLİK VE BAKIM:

   - Değişken/fonksiyon isimleri anlaşılır mı?

   - Kod yapısı mantıklı ve tutarlı mı?

   - Yorumlar gerekli ve yeterli mi?

   - Karmaşık kısımlar açıklanmış mı?



3. PERFORMANS:

   - Algoritma karmaşıklığı uygun mu?

   - Gereksiz işlemler var mı?

   - Memory kullanımı optimize mi?

   - N+1 query gibi sorunlar var mı?



4. GÜVENLİK:

   - Input validation yapılıyor mu?

   - Injection açıkları var mı?

   - Hassas veriler korunuyor mu?

   - Authentication/Authorization doğru mu?



5. TEST EDİLEBİLİRLİK:

   - Kod unit test yazılabilir mi?

   - Bağımlılıklar inject edilebilir mi?

   - Mock lanması zor kısımlar var mı?



6. BEST PRACTICES:

   - Dil/framework convention larına uygun mu?

   - DRY prensibi uygulanmış mı?

   - SOLID prensipleri gözetilmiş mi?

   - Design pattern kullanımı uygun mu?



ÇIKTI FORMATI:







📊 REVIEW ÖZETİ



Genel Değerlendirme: [Onaylanabilir / Küçük değişikliklerle / Büyük değişiklik gerekli]

Kod Kalitesi: [/10]







🔴 KRİTİK SORUNLAR (Mutlaka düzeltilmeli):



Sorun 1: [Başlık]

- Satır: [X]

- Açıklama: [Sorun detayı]

- Öneri: [Nasıl düzeltilmeli]

- Kod örneği:



[Düzeltilmiş kod]









🟡 ÖNEMLİ ÖNERİLER (Düzeltilmesi önerilir):



Öneri 1: [Başlık]

- Satır: [X]

- Açıklama: [Detay]

- Öneri: [İyileştirme]







🟢 İYİLEŞTİRME FIRSATLARI (Nice to have):



- [İyileştirme 1]

- [İyileştirme 2]







✅ OLUMLU YÖNLER:



- [Olumlu 1]

- [Olumlu 2]







📝 GENEL NOTLAR:



[Ek yorumlar ve öneriler]

Pull Request Review

PR/MR incelemesi için özel şablon.

Bu Pull Request ı review et.



PR BİLGİLERİ:

- PR başlığı: [...]

- Açıklama: [...]

- Değişiklik türü: [Feature / Bugfix / Refactoring / Hotfix]

- Etkilenen dosyalar: [Liste]

- İlgili ticket: [Varsa]



DEĞİŞİKLİKLER:

[Diff veya değişen kodu yapıştır]



REVIEW CHECKLIST:



1. FONKSİYONEL REVIEW:

   [ ] PR açıklaması yeterli ve anlaşılır

   [ ] Değişiklikler PR amacıyla uyumlu

   [ ] Edge case ler düşünülmüş

   [ ] Backward compatibility korunmuş



2. KOD KALİTESİ:

   [ ] Kod okunabilir ve anlaşılır

   [ ] İsimlendirme convention lara uygun

   [ ] Gereksiz kod yok (debug, commented out)

   [ ] DRY prensibi uygulanmış



3. TEST:

   [ ] Yeni testler eklenmiş

   [ ] Mevcut testler güncellenmş

   [ ] Edge case testleri var

   [ ] Test coverage yeterli



4. DOKÜMANTASYON:

   [ ] Gerekli yorumlar eklenmiş

   [ ] README güncellenmiş (gerekiyorsa)

   [ ] API docs güncellenmiş (gerekiyorsa)

   [ ] CHANGELOG güncellenmiş



5. GÜVENLİK:

   [ ] Güvenlik açığı yok

   [ ] Hassas veri expose edilmemiş

   [ ] Input validation yapılmış



PR REVIEW ÇIKTISI:







## PR Review: [PR Başlığı]



### Özet

[1-2 cümle ile değerlendirme]



### Karar: ✅ Approved / 🔄 Request Changes / 💬 Comment







### Değişiklik Analizi



Eklenen: [X] satır

Silinen: [Y] satır

Değişen dosyalar: [Z]







### Bulgular



#### Engeller (Merge öncesi düzeltilmeli):

- [ ] [Bulgu 1]

- [ ] [Bulgu 2]



#### Öneriler (İyileştirme):

- [ ] [Öneri 1]

- [ ] [Öneri 2]



#### Sorular:

- [Soru 1]







### Satır Bazlı Yorumlar



Dosya: `[dosya_adi.py]`

Satır: [X]



[Kod parçası]



💬 [Yorum]







### Test Önerileri

- [Test senaryosu 1]

- [Test senaryosu 2]

Güvenlik Odaklı Review

Güvenlik açıklarını tespit etmek için.

Bu kodun güvenlik analizini yap.



KOD:

[Kodu yapıştır]



TEKNOLOJİ:

- Dil: [...]

- Framework: [...]

- Ortam: [Web / API / Mobile / Desktop]

- Veri türleri: [Kullanıcı verisi / Finansal / Sağlık / ...]



GÜVENLİK ANALİZİ:



1. OWASP TOP 10 KONTROLÜ:



   A01 - Broken Access Control:

   - [ ] Yetkilendirme kontrolleri

   - [ ] Path traversal

   - [ ] IDOR (Insecure Direct Object Reference)



   A02 - Cryptographic Failures:

   - [ ] Hassas veri şifreleme

   - [ ] Güçlü algoritma kullanımı

   - [ ] Key management



   A03 - Injection:

   - [ ] SQL Injection

   - [ ] Command Injection

   - [ ] LDAP Injection

   - [ ] XPath Injection



   A04 - Insecure Design:

   - [ ] Threat modeling

   - [ ] Secure design patterns



   A05 - Security Misconfiguration:

   - [ ] Default credentials

   - [ ] Unnecessary features

   - [ ] Error handling



   A06 - Vulnerable Components:

   - [ ] Outdated dependencies

   - [ ] Known vulnerabilities



   A07 - Authentication Failures:

   - [ ] Password policies

   - [ ] Session management

   - [ ] MFA implementation



   A08 - Data Integrity Failures:

   - [ ] Deserialization

   - [ ] CI/CD security



   A09 - Logging Failures:

   - [ ] Audit logging

   - [ ] Log injection



   A10 - SSRF:

   - [ ] URL validation

   - [ ] Whitelist approach



2. INPUT VALIDATION:

   - User input sanitization

   - Type checking

   - Length limits

   - Format validation



3. OUTPUT ENCODING:

   - HTML encoding

   - URL encoding

   - JavaScript encoding



4. AUTHENTICATION/SESSION:

   - Token handling

   - Session timeout

   - Secure cookie flags



5. VERİ GÜVENLİĞİ:

   - PII handling

   - Encryption at rest/transit

   - Data masking in logs



ÇIKTI:







🛡️ GÜVENLİK RAPORU



Risk Seviyesi: [Kritik / Yüksek / Orta / Düşük / Temiz]







🔴 KRİTİK GÜVENLİK AÇIKLARI:



Açık 1: [İsim]

- Tür: [OWASP kategorisi]

- Satır: [X]

- Risk: [Açıklama]

- Sömürü senaryosu: [Nasıl exploit edilebilir]

- Düzeltme:



[Güvenli kod]









🟠 YÜKSEK RİSKLİ BULGULAR:

[Liste]



🟡 ORTA RİSKLİ BULGULAR:

[Liste]



🟢 DÜŞÜK RİSKLİ BULGULAR:

[Liste]







✅ GÜVENLİK EN İYİ UYGULAMALARI:



Doğru yapılanlar:

- [Olumlu 1]

- [Olumlu 2]







📋 ÖNERİLEN GÜVENLİK İYİLEŞTİRMELERİ:



1. [Öneri 1]

2. [Öneri 2]

3. [Öneri 3]

Performans Review

Performans sorunlarını tespit etmek için.

Bu kodun performans analizini yap.



KOD:

[Kodu yapıştır]



BAĞLAM:

- Beklenen veri boyutu: [...]

- Beklenen istek sayısı: [...]

- Performans gereksinimleri: [...]



PERFORMANS ANALİZİ:



1. ALGORİTMA KARMAŞIKLIĞI:



   Fonksiyon: [isim]

   - Zaman karmaşıklığı: O(?)

   - Alan karmaşıklığı: O(?)

   - Darboğaz: [Var/Yok]



2. VERİTABANI:

   - N+1 query sorunu

   - Eksik index kullanımı

   - Gereksiz veri çekme

   - Connection pooling



3. MEMORY:

   - Memory leak potansiyeli

   - Büyük obje oluşturma

   - Gereksiz kopyalama

   - Garbage collection etkisi



4. I/O:

   - Blocking I/O

   - Dosya handling

   - Network calls



5. CACHING:

   - Cache fırsatları

   - Cache invalidation



6. CONCURRENCY:

   - Race condition

   - Deadlock potansiyeli

   - Thread safety



ÇIKTI:







⚡ PERFORMANS RAPORU



Genel Değerlendirme: [İyi / Orta / Kötü]

Kritik Darboğaz: [Var/Yok]







KARMAŞIKLIK ANALİZİ:



| Fonksiyon | Zaman | Alan | Not |

|-----------|-------|------|-----|

| [func1] | O(n) | O(1) | ✅ |

| [func2] | O(n²) | O(n) | ⚠️ Optimize edilebilir |







🔴 KRİTİK PERFORMANS SORUNLARI:



Sorun 1: [Başlık]

- Satır: [X]

- Mevcut: O(n²)

- Hedef: O(n log n)

- Etki: [Büyük veride X kat yavaşlama]

- Çözüm:



[Optimize kod]









🟡 OPTİMİZASYON FIRSATLARI:



1. [Fırsat 1]

   - Potansiyel kazanç: [%X]

   - Uygulama zorluğu: [Kolay/Orta/Zor]







📊 BENCHMARK ÖNERİLERİ:



Test edilmesi gereken senaryolar:

- [Senaryo 1]: [Beklenen sonuç]

- [Senaryo 2]: [Beklenen sonuç]

Refactoring Şablonları

Genel Refactoring

Kodu iyileştirmek ve temizlemek için.

Bu kodu refactor et.



MEVCUT KOD:

[Kodu yapıştır]



REFACTORING HEDEFLERİ:

- [ ] Okunabilirliği artır

- [ ] Tekrarları kaldır (DRY)

- [ ] Fonksiyonları küçült

- [ ] İsimlendirmeyi iyileştir

- [ ] Error handling ekle/iyileştir

- [ ] Performansı optimize et

- [ ] SOLID prensiplerini uygula

- [ ] Design pattern uygula

- [ ] Test edilebilirliği artır

- [ ] [Özel hedef: ...]



KISITLAMALAR:

- [ ] Mevcut API/interface değişmemeli

- [ ] Backward compatible olmalı

- [ ] Mevcut testler geçmeli

- [ ] [Özel kısıt: ...]



ÇIKTI:







🔄 REFACTORING RAPORU







1. ANALİZ:



Mevcut Sorunlar:

- [Sorun 1]: [Açıklama]

- [Sorun 2]: [Açıklama]



Code Smells:

- [Smell 1]: Satır [X]

- [Smell 2]: Satır [Y]







2. REFACTORING PLANI:



Adım 1: [İşlem]

- Etki: [Düşük/Orta/Yüksek]

- Risk: [Düşük/Orta/Yüksek]



Adım 2: [İşlem]

- Etki: [...]

- Risk: [...]







3. REFACTORED KOD:



[dil]

[Refactor edilmiş kod]









4. DEĞİŞİKLİK ÖZETİ:



| Değişiklik | Önce | Sonra | Kazanım |

|------------|------|-------|---------|

| [Değişiklik 1] | [Eski] | [Yeni] | [Fayda] |

| [Değişiklik 2] | [...] | [...] | [...] |







5. ÖNCE/SONRA KARŞILAŞTIRMA:



Metrik | Önce | Sonra

-------|------|------

Satır sayısı | [X] | [Y]

Cyclomatic complexity | [X] | [Y]

Fonksiyon sayısı | [X] | [Y]

Max nesting depth | [X] | [Y]







6. TEST ÖNERİLERİ:



Refactoring sonrası test edilmeli:

- [ ] [Test senaryosu 1]

- [ ] [Test senaryosu 2]

- [ ] Regression testleri

Extract Method/Function

Uzun fonksiyonları parçalamak için.

Bu uzun fonksiyonu daha küçük, anlamlı fonksiyonlara ayır.



UZUN FONKSİYON:

[Kodu yapıştır]



EXTRACT KURALLARI:

- Her fonksiyon tek bir iş yapmalı

- Fonksiyon ismi ne yaptığını anlatmalı

- 20 satırı geçmemeli (ideal)

- Parametre sayısı 3-4 ü geçmemeli

- Aynı abstraction seviyesinde olmalı



ÇIKTI:







📦 EXTRACT METHOD SONUCU







TANIMLANAN SORUMLULUKLAR:



1. [Sorumluluk 1]: Satır [X-Y]

2. [Sorumluluk 2]: Satır [A-B]

3. [Sorumluluk 3]: Satır [C-D]







EXTRACT EDİLEN FONKSİYONLAR:



Fonksiyon 1: [isim]

[dil]

def validate_input(data):

    """[Docstring]"""

    [kod]



- Amaç: [Ne yapıyor]

- Orijinal satırlar: [X-Y]







Fonksiyon 2: [isim]

[dil]

[kod]









ANA FONKSİYON (REFACTORED):



[dil]

def main_function(params):

    """[Docstring]"""

    validated = validate_input(params)

    processed = process_data(validated)

    return format_output(processed)









ÇAĞRI HİYERARŞİSİ:



main_function

├── validate_input

├── process_data

│   └── helper_function

└── format_output

Design Pattern Uygulama

Uygun design pattern ı belirlemek ve uygulamak için.

Bu koda uygun design pattern öner ve uygula.



MEVCUT KOD:

[Kodu yapıştır]



PROBLEM AÇIKLAMASI:

[Kodun hangi problemi olduğunu veya ne tür esneklik gerektiğini açıkla]



ANALİZ VE ÖNERİ İSTE:



1. Bu kod için hangi design pattern(ler) uygun?

2. Neden bu pattern?

3. Pattern i uygula



YAYGIN PATTERN SENARYOLARI:



- Nesne oluşturma karmaşık → Factory / Builder

- Tek instance gerekli → Singleton

- Davranış değişmeli → Strategy

- Nesneye özellik eklenmeli → Decorator

- Durum değişikliği yönetimi → State

- Bildirim mekanizması → Observer

- Karmaşık alt sistemler → Facade

- Ağaç yapısı → Composite

- Erişim kontrolü → Proxy

- Veri erişimi soyutlama → Repository



ÇIKTI:







🎨 DESIGN PATTERN ANALİZİ







ÖNERİLEN PATTERN: [Pattern Adı]



Neden Bu Pattern:

- [Sebep 1]

- [Sebep 2]

- [Sebep 3]



Alternatif Patternler:

- [Alternatif 1]: [Neden tercih edilmedi]

- [Alternatif 2]: [Neden tercih edilmedi]







PATTERN AÇIKLAMASI:



[Pattern adı] pattern ı [ne zaman kullanılır açıkla].



UML/Yapı:



[Metin tabanlı diyagram]



┌─────────────┐

│  Interface  │

└─────────────┘

       ▲

       │

┌──────┴──────┐

│             │

┌─────┐    ┌─────┐

│ A   │    │ B   │

└─────┘    └─────┘









UYGULAMA:



[dil]

[Pattern uygulanmış kod]









KULLANIM ÖRNEĞİ:



[dil]

[Nasıl kullanılacağını gösteren kod]









AVANTAJLAR:

- [Avantaj 1]

- [Avantaj 2]



DİKKAT EDİLMESİ GEREKENLER:

- [Dikkat 1]

- [Dikkat 2]

SOLID Prensipleri Uygulama

SOLID prensiplerini uygulamak için.

Bu kodu SOLID prensiplerine göre analiz et ve iyileştir.



KOD:

[Kodu yapıştır]



SOLID ANALİZİ:



1. S - Single Responsibility Principle:

   Soru: Bu sınıf/fonksiyon tek bir sorumluluğa mı sahip?

   

   [ ] Uyuyor

   [ ] İhlal ediyor → [Açıklama]



2. O - Open/Closed Principle:

   Soru: Genişlemeye açık, değişikliğe kapalı mı?

   

   [ ] Uyuyor

   [ ] İhlal ediyor → [Açıklama]



3. L - Liskov Substitution Principle:

   Soru: Alt sınıflar, üst sınıfların yerine kullanılabilir mi?

   

   [ ] Uyuyor

   [ ] İhlal ediyor → [Açıklama]



4. I - Interface Segregation Principle:

   Soru: Interface ler küçük ve odaklı mı?

   

   [ ] Uyuyor

   [ ] İhlal ediyor → [Açıklama]



5. D - Dependency Inversion Principle:

   Soru: Yüksek seviye modüller düşük seviyeye bağımlı mı?

   

   [ ] Uyuyor

   [ ] İhlal ediyor → [Açıklama]



ÇIKTI:



📐 SOLID ANALİZ RAPORU



| Prensip | Durum | Not |

|---------|-------|-----|

| SRP | ✅/❌ | [Not] |

| OCP | ✅/❌ | [Not] |

| LSP | ✅/❌ | [Not] |

| ISP | ✅/❌ | [Not] |

| DIP | ✅/❌ | [Not] |



İHLALLER VE ÇÖZÜMLER:



### SRP İhlali:



Mevcut:

[dil]

[İhlal eden kod]





Problem: [Birden fazla sorumluluk]



Çözüm:

[dil]

[Düzeltilmiş kod - ayrılmış sorumluluklar]



### OCP İhlali:



[Benzer format...]



### DIP İhlali:



Mevcut:

[dil]

class Service:

    def __init__(self):

        self.repo = MySQLRepository()  # Concrete dependency





Çözüm:

[dil]

class Service:

    def __init__(self, repo: Repository):  # Abstraction

        self.repo = repo



TAM REFACTORED KOD:



[dil]

[SOLID prensiplerine uygun tam kod]

Legacy Kod Modernizasyonu

Eski kodu güncellemek ve modernize etmek için.

Bu legacy kodu modernize et.



LEGACY KOD:

[Eski kodu yapıştır]



MEVCUT DURUM:

- Dil/Versiyon: [Eski versiyon]

- Framework: [Eski framework]

- Yaş: [Yaklaşık kaç yıllık]

- Bilinen sorunlar: [...]



HEDEF:

- Dil/Versiyon: [Yeni versiyon]

- Framework: [Yeni framework]

- Modernizasyon hedefleri:

  - [ ] Syntax güncellemesi

  - [ ] Deprecated API ların değişimi

  - [ ] Yeni dil özelliklerinin kullanımı

  - [ ] Async/await dönüşümü

  - [ ] Type hints/annotations ekleme

  - [ ] Modern kütüphanelere geçiş

  - [ ] Test coverage ekleme



KISITLAMALAR:

- [ ] Backward compatibility gerekli

- [ ] Gradual migration (adım adım)

- [ ] Mevcut API korunmalı

- [ ] [Özel kısıt]



ÇIKTI:



🔄 MODERNİZASYON RAPORU



ANALİZ:



Tespit Edilen Legacy Patterns:

- [Pattern 1]: Satır [X] - [Modern alternatif]

- [Pattern 2]: Satır [Y] - [Modern alternatif]



Deprecated Kullanımlar:

- [Deprecated 1] → [Yeni karşılık]

- [Deprecated 2] → [Yeni karşılık]



Güvenlik Riskleri:

- [Risk 1]

- [Risk 2]





MODERNİZASYON PLANI:



Faz 1 - Düşük Risk:

- [ ] Syntax güncellemeleri

- [ ] Type hints ekleme



Faz 2 - Orta Risk:

- [ ] Deprecated API değişimleri

- [ ] Async dönüşüm



Faz 3 - Yüksek Risk:

- [ ] Mimari değişiklikler

- [ ] Framework migration







MODERNİZE EDİLMİŞ KOD:



[dil]

[Modern kod]



DEĞİŞİKLİK DETAYLARI:



1. [Değişiklik 1]:

   Önce:

   [dil]

   [Eski kod]

   

   Sonra:

   [dil]

   [Yeni kod]

   

   Açıklama: [Neden değişti]



MİGRASYON NOTLARI:



Breaking Changes:

- [Breaking change 1]

- [Breaking change 2]



Test Gereksinimleri:

- [Test 1]

- [Test 2]



Rollback Planı:

[Geri alma stratejisi]

Kod Kalitesi Analizi

Code Smell Tespiti

Kod kokularını tespit etmek için.

Bu koddaki code smell leri tespit et.



KOD:

[Kodu yapıştır]



CODE SMELL KONTROL LİSTESİ:



BLOATERS (Şişkinler):

- [ ] Long Method (Uzun metod)

- [ ] Large Class (Büyük sınıf)

- [ ] Long Parameter List (Uzun parametre listesi)

- [ ] Data Clumps (Veri kümeleri)

- [ ] Primitive Obsession (Primitif takıntısı)



OBJECT-ORIENTATION ABUSERS:

- [ ] Switch Statements

- [ ] Temporary Field

- [ ] Refused Bequest

- [ ] Alternative Classes with Different Interfaces



CHANGE PREVENTERS:

- [ ] Divergent Change

- [ ] Shotgun Surgery

- [ ] Parallel Inheritance Hierarchies



DISPENSABLES (Gereksizler):

- [ ] Comments (Aşırı yorum)

- [ ] Duplicate Code (Tekrar eden kod)

- [ ] Dead Code (Ölü kod)

- [ ] Lazy Class (Tembel sınıf)

- [ ] Speculative Generality (Spekülatif genellik)



COUPLERS (Bağlayıcılar):

- [ ] Feature Envy

- [ ] Inappropriate Intimacy

- [ ] Message Chains

- [ ] Middle Man



ÇIKTI:



🦨 CODE SMELL RAPORU



Toplam Tespit: [X] code smell



Ciddiyet Dağılımı:

- Kritik: [X]

- Yüksek: [Y]

- Orta: [Z]

- Düşük: [W]



TESPİT EDİLEN CODE SMELLS:



### 1. [Smell Adı]



Kategori: [Bloater/Coupler/...]

Ciddiyet: [Kritik/Yüksek/Orta/Düşük]

Satır: [X-Y]



Mevcut Kod:

[dil]

[Sorunlu kod]



Problem:

[Neden bu bir code smell]



Refactoring Tekniği: [Extract Method / Move Method / ...]



Çözüm:

[dil]

[Düzeltilmiş kod]



### 2. [Smell Adı]

[Aynı format...]



ÖNCELİKLENDİRİLMİŞ AKSİYON PLANI:



1. [En kritik smell]: [Refactoring tekniği]

2. [İkinci öncelik]: [Refactoring tekniği]

3. [Üçüncü öncelik]: [Refactoring tekniği]

Kod Karmaşıklık Analizi

Cyclomatic ve cognitive complexity analizi için.

Bu kodun karmaşıklık analizini yap.



KOD:

[Kodu yapıştır]



KARMAŞIKLIK ANALİZİ:



1. CYCLOMATIC COMPLEXITY:



   Her fonksiyon için:

   - Fonksiyon adı

   - CC değeri

   - Değerlendirme (1-10: Basit, 11-20: Orta, 21-50: Karmaşık, 50+: Test edilemez)



2. COGNITIVE COMPLEXITY:



   - Nesting depth analizi

   - Kontrol akışı kesintileri

   - Okunabilirlik değerlendirmesi



3. LINES OF CODE:



   - Toplam LOC

   - Fonksiyon başına ortalama

   - Çok uzun fonksiyonlar



4. BAĞIMLILIK ANALİZİ:



   - Import/dependency sayısı

   - Coupling seviyesi

   - Cohesion değerlendirmesi



ÇIKTI:



📊 KARMAŞIKLIK RAPORU



ÖZET METRİKLER:



| Metrik | Değer | Durum |

|--------|-------|-------|

| Toplam CC | [X] | [🟢/🟡/🔴] |

| Ortalama CC/fonksiyon | [X] | [🟢/🟡/🔴] |

| Max CC | [X] | [🟢/🟡/🔴] |

| Max Nesting | [X] | [🟢/🟡/🔴] |

| Toplam LOC | [X] | - |



FONKSİYON BAZLI ANALİZ:



| Fonksiyon | CC | Cognitive | LOC | Durum |

|-----------|-----|-----------|-----|-------|

| [func1] | 5 | 3 | 20 | 🟢 İyi |

| [func2] | 15 | 12 | 45 | 🟡 Orta |

| [func3] | 25 | 20 | 80 | 🔴 Karmaşık |



YÜKSEK KARMAŞIKLIKLI BÖLÜMLER:



### [Fonksiyon Adı] - CC: [X]



Karmaşıklık Kaynakları:

- [X] if/else dallanması: [adet]

- [X] switch/case: [adet]

- [X] döngü: [adet]

- [X] exception handling: [adet]

- [X] nested yapılar: [derinlik]



Görselleştirme:



[Kontrol akışı pseudo-diagram]

if ──┬── then ──┬── if ── ...

     │          └── else ── ...

     └── else ── ...





SADELEŞTİRME ÖNERİSİ:



[dil]

[Sadeleştirilmiş kod]



GENEL ÖNERİLER:



1. [Öneri 1]

2. [Öneri 2]

3. [Öneri 3]

Teknik Borç Analizi

Teknik borcu tespit ve önceliklendirmek için.

Bu koddaki teknik borçları analiz et.



KOD/PROJE:

[Kodu veya proje yapısını paylaş]



TEKNİK BORÇ ANALİZİ:



1. KOD KALİTESİ BORÇLARI:

   - Code smells

   - Duplicate code

   - Karmaşıklık

   - Test eksikliği



2. MİMARİ BORÇLAR:

   - Tight coupling

   - Yanlış abstraction

   - Spaghetti code

   - Circular dependencies



3. ALTYAPI BORÇLARI:

   - Outdated dependencies

   - Missing documentation

   - Manual processes

   - Technical debt in tooling



4. BİLGİ BORÇLARI:

   - Tribal knowledge

   - Missing documentation

   - Unclear ownership



ÇIKTI:



💳 TEKNİK BORÇ RAPORU



BORÇ ÖZETİ:



| Kategori | Borç Sayısı | Tahmini Effort | Öncelik |

|----------|-------------|----------------|---------|

| Kod Kalitesi | [X] | [Y gün] | [Yüksek] |

| Mimari | [X] | [Y gün] | [Orta] |

| Altyapı | [X] | [Y gün] | [Düşük] |

| Bilgi | [X] | [Y gün] | [Orta] |



Toplam Tahmini Effort: [Z gün]



DETAYLI BORÇ LİSTESİ:



### Borç #1: [Başlık]



Kategori: [Kod/Mimari/Altyapı/Bilgi]

Ciddiyet: [Kritik/Yüksek/Orta/Düşük]

Konum: [Dosya/Modül]



Açıklama:

[Borcun detaylı açıklaması]



Etki:

- Geliştirme hızı: [Etkisi]

- Hata riski: [Etkisi]

- Onboarding: [Etkisi]



Çözüm Önerisi:

[Nasıl ödenir]



Tahmini Effort: [X gün/saat]

ROI: [Yüksek/Orta/Düşük]





ÖNCELİKLENDİRME MATRİSİ:



              | Düşük Effort | Yüksek Effort |

|-------------|--------------|---------------|

| Yüksek Etki | 🔥 Önce yap  | 📋 Planla     |

| Düşük Etki  | ✅ Fırsat    | ❌ Sonra      |





ÖDEME PLANI ÖNERİSİ:



Sprint 1:

- [ ] [Borç 1] - [Effort]

- [ ] [Borç 2] - [Effort]



Sprint 2:

- [ ] [Borç 3] - [Effort]



Uzun Vadeli:

- [ ] [Borç 4]

Dil Özel Review Şablonları

Python Code Review

Python a özel kod inceleme.

Bu Python kodunu review et.



KOD:

[Python kodunu yapıştır]



PYTHON ÖZELİNDE KONTROL:



1. PEP 8 UYUMU:

   - [ ] İsimlendirme (snake_case, PascalCase)

   - [ ] Satır uzunluğu (79/99)

   - [ ] Boşluk kullanımı

   - [ ] Import sıralaması



2. PEP 20 (Zen of Python):

   - [ ] Explicit is better than implicit

   - [ ] Simple is better than complex

   - [ ] Readability counts



3. PYTHONIC YAPILAR:

   - [ ] List/dict comprehension kullanımı

   - [ ] Context manager (with statement)

   - [ ] Generator kullanımı

   - [ ] Unpacking

   - [ ] f-string kullanımı



4. TYPE HINTS:

   - [ ] Fonksiyon parametreleri

   - [ ] Return types

   - [ ] Complex types (Optional, Union, List)



5. ERROR HANDLING:

   - [ ] Specific exception handling

   - [ ] Exception chaining

   - [ ] Custom exceptions



6. PERFORMANCE:

   - [ ] Gereksiz list oluşturma

   - [ ] String concatenation

   - [ ] Global variable kullanımı



ÇIKTI:



PYTHON CODE REVIEW



✅ PEP 8 Uyumu: [%]

✅ Type Coverage: [%]

✅ Docstring Coverage: [%]





PYTHONIC İYİLEŞTİRMELER:



Önce:

python

result = []

for item in items:

    if item > 0:

        result.append(item * 2)





Sonra:

python

result = [item * 2 for item in items if item > 0]



TYPE HINT ÖNERİLERİ:



python

def process_data(data: list[dict[str, Any]]) -> Optional[DataFrame]:



MODERN PYTHON ÖZELLİKLERİ:



- match/case (3.10+)

- walrus operator (:=)

- dataclasses

- pathlib

JavaScript/TypeScript Code Review

JS/TS a özel kod inceleme.

Bu JavaScript/TypeScript kodunu review et.



KOD:

[JS/TS kodunu yapıştır]



JS/TS ÖZELİNDE KONTROL:



1. MODERN JS/ES6+:

   - [ ] const/let (var yok)

   - [ ] Arrow functions

   - [ ] Template literals

   - [ ] Destructuring

   - [ ] Spread operator

   - [ ] Optional chaining (?.)

   - [ ] Nullish coalescing (??)



2. TYPESCRIPT (TS ise):

   - [ ] Strict mode

   - [ ] any kullanımı minimize

   - [ ] Interface vs Type

   - [ ] Generic kullanımı

   - [ ] Utility types



3. ASYNC HANDLING:

   - [ ] async/await (callback hell yok)

   - [ ] Promise error handling

   - [ ] Race conditions



4. REACT (React ise):

   - [ ] Hooks kuralları

   - [ ] useEffect dependencies

   - [ ] Memoization (useMemo, useCallback)

   - [ ] Key prop kullanımı

   - [ ] Component composition



5. NODE.JS (Node ise):

   - [ ] Error handling middleware

   - [ ] Environment variables

   - [ ] Security best practices



ÇIKTI:



JS/TS CODE REVIEW





MODERN JS İYİLEŞTİRMELERİ:



Önce:

javascript

const value = obj && obj.prop && obj.prop.nested;

if (value !== null && value !== undefined) {

    process(value);

}





Sonra:

javascript

const value = obj?.prop?.nested;

if (value != null) {

    process(value);

}

// veya

process(obj?.prop?.nested ?? defaultValue);





TYPESCRIPT İYİLEŞTİRMELERİ:



Önce:

typescript

function process(data: any): any { ... }





Sonra:

typescript

interface ProcessInput {

    id: string;

    values: number[];

}



function process(data: T): ProcessResult { ... }









REACT ÖNERİLERİ:



typescript

// useEffect dependency uyarısı

useEffect(() => {

    fetchData(userId);

}, [userId]); // userId dependency eklenmeli



// Memoization

const expensiveValue = useMemo(() => 

    computeExpensive(data), [data]

);

Code Review ve Refactoring İpuçları

Etkili Code Review İçin:

• Önce büyük resme bakın, sonra detaylara inin
• Yapıcı feedback verin, kişisel değil kod odaklı
• Sadece eleştirmeyin, iyi yönleri de belirtin
• Somut öneriler sunun, sadece sorun tespit etmeyin
• Öğretici olun, neden önemli olduğunu açıklayın

Refactoring Yaparken:

• Önce testleri yazın veya mevcut testlerin geçtiğinden emin olun
• Küçük adımlarla ilerleyin
• Her adımda testleri çalıştırın
• Bir seferde bir şeyi değiştirin
• Refactoring ve feature eklemeyi ayırın

AI ile Review Yaparken:

• AI önerilerini körü körüne uygulamayın
• Bağlamı iyi açıklayın
• Güvenlik açısından hassas bilgileri temizleyin
• AI çıktısını mutlaka test edin
• İnsan review ın yerini almak yerine desteklemek için kullanın

Kod Kalitesi İçin:

• Tutarlı coding style kullanın
• Linter ve formatter kullanın
• Code review ı kültür haline getirin
• Teknik borcu düzenli ödeyin
• Dokümantasyonu güncel tutun

Review Checklist:

• Kod çalışıyor mu?
• Anlaşılır mı?
• Test edilmiş mi?
• Güvenli mi?
• Performanslı mı?
• DRY prensibine uygun mu?
• SOLID prensiplerine uygun mu?