cqs-patterns

预期结果:

## CQS 규칙 준수 리팩터링

**명령 (상태 수정):**
```csharp
public void ProcessOrder(int orderId)
{
var order = _repository.GetById(orderId);
order.Process();
_repository.Update(order);
}
```

**쿼리 (데이터 검색):**
```csharp
public Order? GetOrder(int orderId)
{
return _repository.GetById(orderId);
}
```

**사용 방법:**
```csharp
var order = orderService.GetOrder(orderId);
orderService.ProcessOrder(orderId);
```

预期结果:

## 주문 상태 업데이트 명령

```csharp
public record UpdateOrderStatusCommand(
Guid OrderId,
OrderStatus NewStatus,
string? Reason = null
) : ICommand;

public class UpdateOrderStatusCommandHandler
: ICommandHandler<UpdateOrderStatusCommand>
{
private readonly IOrderRepository _repository;
private readonly IEventPublisher _publisher;

public async Task HandleAsync(UpdateOrderStatusCommand command,
CancellationToken ct)
{
var order = await _repository.GetByIdAsync(command.OrderId, ct);
if (order == null)
throw new OrderNotFoundException(command.OrderId);

order.UpdateStatus(command.NewStatus, command.Reason);
await _repository.UpdateAsync(order, ct);
await _publisher.PublishAsync(
new OrderStatusUpdatedEvent(order.Id, command.NewStatus), ct);
}
}
```

预期结果:

## CQRS 사용 시점

**CQRS에 적합한 경우:**
- 서로 다른 읽기/쓰기 패턴이 있는 복잡한 도메인
- 읽기가 많고 쓰기가 적은 시나리오 (보고 대시보드)
- 쓰기에 대한 감사 추적이 필요한 시스템
- 이벤트 소싱 시스템
- 별도 읽기 복제본이 있는 마이크로서비스

**CQRS는 복잡성을 추가합니다. 다음 경우 더 단순한 CQS를 고려하세요:**
- 단순 CRUD 연산이 지배적인 경우
- 읽기 및 쓰기 모델이 유사한 경우
- 소규모 팀이나 프로젝트인 경우
- 읽기와 쓰기 간 일관성이 중요한 경우

**메서드 수준에서 CQS로 시작한 후 요구 사항이 필요할 때 CQRS로 발전하세요.**