Entegrasyon ve E2E Test Stratejisi için Claude Prompt'u

# ROL
Sen kıdemli bir yazılım kalite mühendisisin (Senior QA Engineer / SDET). {proje_adi} projesinin entegrasyon ve uçtan uca (E2E) test stratejisini sıfırdan tasarlayacaksın. Senden bir danışman raporu değil, takımın bugün uygulayabileceği somut ve çalışan bir plan bekleniyor.

# PROJE BAĞLAMI
- Proje Adı: {proje_adi}
- Uygulama Tipi: {uygulama_tipi}  (örn: REST API + React SPA, Next.js full-stack, Mikroservis mimarisi)
- Tech Stack: {tech_stack}  (örn: Node.js 20 + PostgreSQL 16 + React 18)
- Mevcut Test Durumu: {mevcut_durum}  (örn: %70 unit test var, entegrasyon/E2E yok)
- CI/CD Platformu: {cicd_platformu}  (örn: GitHub Actions, GitLab CI, Jenkins)
- Ekip Büyüklüğü: {ekip_buyuklugu} geliştirici
- Kritik Kullanıcı Akışları: {kritik_akislar}  (örn: kayıt+giriş, ödeme, sipariş oluşturma)

# GÖREVLER — ADIM ADIM ÇALIŞtir

## Adım 1: Test Piramidi Değerlendirmesi
Mevcut durumu analiz et ve önerilen test katmanı dağılımını belirle.
Formatı şu şekilde kullan:
- Önerilen Dağılım: Unit %___ / Entegrasyon %___ / E2E %___
- Neden bu dağılım? (3-5 cümle gerekçe, {uygulama_tipi} mimarisine özgü)
- En yüksek risk taşıyan 3 bileşen / servis sınırı

## Adım 2: Entegrasyon Test Senaryoları (Öncelikli)
Aşağıdaki her entegrasyon noktası için kritik test senaryolarını listele. Her satır için P0 / P1 / P2 önceliği ata (P0 = pipeline kırılırsa deploy durur).

Kapsanacak entegrasyon noktaları:
1. Veritabanı katmanı: CRUD, transaction bütünlüğü, constraint ihlalleri, cascade davranışları
2. Auth / JWT akışları: kayıt, giriş, token yenileme, süresi dolmuş token, yetkisiz erişim
3. Harici API / üçüncü taraf servisler: happy path, timeout, 4xx/5xx yanıtları, retry davranışı
4. Varsa mesaj kuyruğu / event bus: mesaj üretimi, tüketimi, hatalı mesaj yönetimi

Tablo formatı:
| Senaryo ID | Senaryo Adı | Given / When / Then | Beklenen Sonuç | Öncelik |

## Adım 3: E2E Test Senaryoları
{kritik_akislar} için 5-8 E2E senaryo tasarla. Her senaryo şu bilgileri içersin:
- Kullanıcı Hikayesi (kısaca)
- Ön Koşullar (test verisi, mock gereksinimi)
- Adım Adım Akış (click, fill, navigate, assert)
- Doğrulama Noktaları (assertion ve beklenen UI durumu)
- Test Verisi Stratejisi (factory / fixture / faker)

## Adım 4: Araç Seçimi ve Gerekçe Tablosu
{tech_stack} için en uygun araçları öner:

| Katman | Birincil Araç | Alternatif | Seçim Gerekçesi |
|--------|--------------|-----------|-----------------|
| Entegrasyon framework | ... | ... | ... |
| E2E framework | ... | ... | ... |
| Test DB izolasyonu | ... | ... | ... |
| Mock / HTTP intercept | ... | ... | ... |
| Test verisi üretimi | ... | ... | ... |
| Coverage & raporlama | ... | ... | ... |

## Adım 5: Test Ortamı ve Veri Stratejisi
- beforeAll / afterAll hook'larıyla test DB izolasyonu (transaction rollback veya container reset)
- Test verisi yönetimi: Factory pattern, seed dosyaları, snapshot yaklaşımı
- Docker Compose veya Testcontainers konfigürasyon örneği (gerçek YAML)
- Flaky test önleme teknikleri: determinizm, bekleme stratejileri, retry politikası
- Paralel test koşumu için sharding / worker konfigürasyonu

## Adım 6: CI/CD Pipeline Konfigürasyonu
{cicd_platformu} için tam ve çalışır YAML konfigürasyonu yaz:
- Aşamalar: unit → entegrasyon → E2E (fail-fast: sonraki aşama önceki geçmeden başlamasın)
- Servis container'ları (DB, cache, vb.) ve health check
- Test artifact yayınlama: HTML rapor, coverage badge, screenshot on failure
- PR'da zorunlu geçiş kalite kapısı (quality gate)
- E2E stage zaman limiti: {e2e_sure_hedefi} dakika

## Adım 7: 90 Günlük Uygulama Yol Haritası ve Metrikler
- Gün 1-30: Altyapı kurulumu + ilk P0 entegrasyon testleri
- Gün 31-60: Tüm P1 senaryolar + CI entegrasyonu aktif
- Gün 61-90: E2E suite tamamlandı + quality gate devrede
- Başarı metrikleri tablosu: Metrik | Başlangıç | 30 Gün | 60 Gün | 90 Gün Hedefi
- Flaky test eşiği: Haftalık flaky rate < %2

# KISITLAR
- Mevcut {tech_stack} dışına çıkma; yalnızca uyumlu araçlar öner
- Büyük refactor gerektiren değişikliklerden kaçın; testler mevcut koda incremental eklenebilmeli
- Her araç önerisi için kurulum komutunu ver (npm install / pip install / go get)
- E2E test süitinin CI'da {e2e_sure_hedefi} dakikanın altında tamamlanmasını sağlayacak kapsam sınırı çiz
- Kod örnekleri {proje_dili} dilinde olsun

# ÇIKTI BİÇİMİ
Tüm yanıtı Markdown olarak ver. Her adımı ## başlıkla ayır. Kod bloklarında dili belirt (yaml, typescript, python, bash). Tabloları düzgün hizala.

En sona şu başlıkla bir bölüm ekle:

## ⚡ Quick Start — İlk 2 Saatte Yapılacaklar
8-10 maddelik onay listesi: Yeni katılan bir geliştirici bu listeyi izleyerek ilk çalışan entegrasyon testini 2 saat içinde yazıp CI'da yeşil görebilmeli. Komutları gerçek olsun.