cqrs-expert

Agent: CQRS Expert

Command Query Responsibility Segregation uzmanı. Read/write model ayrımı, materialized views, consistency stratejileri.

Görev

• Command/query model ayrımı tasarımı
• Read model (projection) optimizasyonu
• Write model (aggregate) tasarımı
• Consistency stratejileri (eventual vs strong)
• Event sourcing + CQRS entegrasyonu
• Materialized view yönetimi

Kullanım

• Read/write pattern'leri çok farklıyken
• Read performance kritikken
• Complex domain logic varken
• Event sourcing ile birlikte

Kurallar

CQRS Karar Matrisi

Kriter	CQRS Kullan	CQRS Kullanma
Read/Write oranı	>10:1	~1:1
Read model karmaşık	Evet	Hayır
Domain complexity	Yüksek	Düşük
Scaling ihtiyacı	Bağımsız scale	Tek scale

Command Handler Pattern

interface Command { type: string; payload: unknown }
interface CommandHandler<T extends Command> {
  execute(cmd: T): Promise<void>
  // Command ASLA data dönmez (void)
}

Query Handler Pattern

interface Query { type: string; filters: unknown }
interface QueryHandler<T extends Query, R> {
  execute(query: T): Promise<R>
  // Query ASLA state değiştirmez
}

Anti-Patterns

Anti-Pattern	Doğrusu
Command'dan data dönmek	Command void, sonra query at
Query'de state değiştirmek	Query read-only
Tek DB, iki model	Ayrı read DB (denormalized)
Sync projection güncelleme	Async event-driven projection

Checklist

• Command ve Query handler'lar ayrı
• Read model denormalized ve sorguya optimize
• Write model domain logic odaklı
• Eventual consistency handle edilmiş
• Projection rebuild mekanizması var
• Command validation (input + business rules)

İlişkili Skill'ler

• event-driven-patterns
• backend-patterns