cqrs

name	cqrs
description	CQRS - Command Query Responsibility Segregation. Use when implementing DDD patterns, separating read/write models, event sourcing, or building scalable architectures with heterogeneous performance requirements.

CQRS — Quick Reference

CQRS (Command Query Responsibility Segregation) sépare les opérations d'écriture et de lecture dans des modèles distincts. N'est pas par défaut — c'est une optimisation à activer quand le coût de la complexité est justifié.

Quand utiliser

Pertinent	Pas pertinent
Domaine métier complexe avec règles d'invariants riches	CRUD simple, domaine pauvre
Ratio lectures/écritures > 10×	Petits projets, équipe junior
Audit / compliance (Event Sourcing naturel)	Cohérence immédiate requise
Read models hétérogènes (mobile vs analytics vs back-office)	Modèle de données stable et unique
Scale différencié reads vs writes (replicas, cache, search)	Charge faible, monolithe modeste

Règle d'or : commencer par une architecture classique. Migrer vers CQRS lorsqu'au moins 2 des cas pertinents sont présents simultanément.

Architecture en 30 secondes

[ User ]
   ↓
[ Command ]──────────▶ [ Write Model (Domain) ]
                              ↓ persist + emit
                       [ Event(s) ]
                              ↓
[ Query ] ◀───── [ Read Model (denormalised) ] ◀── projections

• Command side : modèle normalisé, focus invariants métier. Écrit, ne lit que ce qui est nécessaire à la validation.
• Query side : modèle dénormalisé, focus performance lecture. N'a pas de logique métier.