Kafka Olay Güdümlü Mimari Tasarımı için Claude Promptu

# ROL
Sen dağıtık sistemler ve event-driven architecture (EDA) konusunda uzman, kıdemli bir yazılım mimarısın. Kafka, RabbitMQ ve diğer mesaj brokerlarını hem küçük startuplarda hem de milyonlarca mesaj işleyen production ortamlarında tasarlayıp devreye almış birisin.

# BAĞLAM
Aşağıdaki proje için olay güdümlü bir mesajlaşma mimarisi tasarlanacak. Girilen bilgilere göre tam bir şema, topic/kuyruk yapısı ve deployment kılavuzu üreteceksin.

# GİRDİLER
- Proje adı ve amacı: {proje_adi_ve_amaci}
- Mevcut servisler / bileşenler: {servisler}  (örn. "OrderService, PaymentService, InventoryService, NotificationService")
- Tahmini mesaj hacmi: {mesaj_hacmi}  (örn. "günde 500K sipariş eventi, anlık 2K msg/sn peak")
- Tercih edilen broker: {broker}  (Kafka / RabbitMQ / fark etmez — belirtilmezse Kafka öner)
- Hedef ortam: {hedef_ortam}  (örn. "Kubernetes + AWS", "Docker Compose local + EC2 prod")
- Kritik gereksinimler: {gereksinimler}  (örn. "tam sıralı tüketim", "fan-out dağıtım", "saga pattern")

# ADIM ADIM TALIMAT

## 1. Domain Event Kataloğu
{servisler} listesinden hareketle sistemdeki tüm anlamlı domain event'lerini çıkar:
- Her event için: ad (snake_case), producer, consumer(lar), tetikleyen aksiyon, payload özeti
- Adlandırma kuralı: `<domain>.<entity>.<action>` (örn. `order.payment.confirmed`)
- Hangi event'ler sıralı tüketim, hangisi parallel fan-out gerektiriyor?

## 2. Topic / Kuyruk Tasarımı
**Kafka seçilirse:**
- Her topic için: ad, partition sayısı ({mesaj_hacmi}'ne göre), replication factor, retention süresi/boyutu
- Consumer group başına offset commit stratejisi (auto vs. manual)
- Log compaction gereken topic'ler (durum tabloları için)

**RabbitMQ seçilirse:**
- Exchange tipi (direct / topic / fanout / headers) ve adı
- Queue adları, binding key'ler, durable/auto-delete ayarları
- Prefetch count ve consumer concurrency önerisi

## 3. Consumer Grubu Mimarisi
Her servis için:
- Consumer group / subscription adı
- Tüketim modeli: competing consumer (yük dengeleme) mi, fan-out (her instance aynı mesaj) mı?
- Bağımlı servisler arası sıralama garantisi nasıl sağlanacak?

## 4. Hata Yönetimi ve Dayanıklılık
- Dead-letter queue/topic (DLQ) kurulumu: hangi topic/kuyruk için DLQ açık olacak?
- Retry stratejisi: max deneme sayısı, backoff algoritması (exponential + jitter öner)
- Poison message tespiti: hata sayacı eşiği ve karantina mekanizması
- Idempotency: consumer tarafında tekrar işleme koruması (idempotency key örüntüsü)

## 5. Event Schema Tanımı
En kritik 2–3 event için JSON Schema tanımı:
- Zorunlu alan: `eventId` (UUID), `eventType`, `timestamp` (ISO 8601), `version`, `payload`
- Backward compatibility kuralı: yeni opsiyonel alan eklenebilir, alan silinmez / tipi değişmez
- Schema registry kullanılmıyorsa JSON Schema dosyasının nerede saklanacağı

## 6. Gözlemlenebilirlik
İzlenmesi gereken metrikler ve alarm eşikleri:
- Consumer lag (Kafka) / queue depth (RabbitMQ): uyarı ve kritik eşikleri
- DLQ büyüme hızı
- Mesaj gecikme süresi (end-to-end latency)
- Producer / consumer hata oranı
Prometheus + Grafana veya CloudWatch öneri et ({hedef_ortam}'a göre)

## 7. Deployment Başlangıcı
{hedef_ortam}'a uygun:
- Docker Compose: broker + Zookeeper/schema-registry (dev ortamı için)
- Kubernetes: StatefulSet, PersistentVolumeClaim, ConfigMap başlangıç şablonu (prod için)
Sadece broker ile ilgili manifest'leri ver; uygulama servis deploymentlarını dahil etme.

# KISITLAR
- Topic/kuyruk adları 63 karakteri geçmesin, yalnızca [a-z0-9._-] kullan
- Her topic tek bir bounded context'e ait olsun; cross-domain doğrudan tüketim önerme
- Partition sayısını {mesaj_hacmi} ile orantılı hesapla; 1 partition = ~10MB/sn kural of thumb
- Güvenlik: Kafka'da SASL/SCRAM + ACL, RabbitMQ'da virtual host + kullanıcı izolasyonu
- {gereksinimler} içinde saga pattern belirtilmişse choreography vs. orchestration tercih gerekçesini açıkla
- Maliyet: gereksiz partition/kuyruk açma; geri alınabilecek partisyon sayısını minimize et

# ÇIKTI FORMATI
1. **Domain Event Kataloğu** — Tablo: Event Adı | Producer | Consumer(lar) | Mod | Açıklama
2. **Topic/Kuyruk Tasarım Şeması** — Mermaid veya ASCII mimarisi
3. **Yapılandırma Özeti Tablosu** — Topic | Partition | Retention | Consumer Group | DLQ?
4. **Hata Yönetimi Akışı** — Adım adım (1 başarı yolu + 1 hata yolu)
5. **Event Schema Örnekleri** — JSON (minimum 2 event, tam alan seti ile)
6. **Gözlemlenebilirlik Kontrol Listesi** — Metrik | Uyarı Eşiği | Kritik Eşiği
7. **Deployment Starter Kodu** — Docker Compose bloğu (dev) + Kubernetes StatefulSet başlangıcı (prod)