Todo sistema de pedidos tem uma classe Order com uma propriedade Status. No começo são três ou quatro status, cada ação confere o status atual com um if e está tudo certo. O problema aparece meses depois, quando chega um status novo e ninguém lembra de todos os lugares que precisavam saber dele. Neste post vou mostrar um caso bem concreto disso, um estorno pago duas vezes, e como o padrão State resolve sem cerimônia.
O problema
O pedido passa por Pending, Paid, Shipped e Delivered, e pode ser cancelado antes do envio. Se já estava pago, o cancelamento gera estorno. O método Cancel() da versão "antes" é o tipo de código que todo mundo já escreveu:
public void Cancel()
{
if (Status is OrderStatus.Shipped or OrderStatus.Delivered or OrderStatus.Cancelled)
throw new InvalidOperationException($"Cannot cancel an order that is {Status}.");
if (Status != OrderStatus.Pending)
RefundCount++;
Status = OrderStatus.Cancelled;
}
Repare na primeira condição: ela é uma lista do que não pode. E a segunda assume que tudo que não é Pending foi pago. Enquanto o enum tinha só esses status, as duas suposições eram verdadeiras.
Aí o negócio pediu devolução. Alguém criou o status Returned e o método novo, com estorno:
// Added later, when returns became a requirement.
// Nobody remembered to update Cancel().
public void Return()
{
if (Status != OrderStatus.Delivered)
throw new InvalidOperationException($"Cannot return an order that is {Status}.");
RefundCount++;
Status = OrderStatus.Returned;
}
O Return() está correto. O bug está no Cancel(), que ninguém abriu: Returned não está na lista de proibidos e não é Pending, então um pedido devolvido pode ser cancelado e o cliente recebe o estorno pela segunda vez. Nenhum teste quebrou, porque os testes existentes não sabiam que Returned existia. No projeto deixei um teste, Cancelling_a_returned_order_refunds_twice, que documenta exatamente esse comportamento na versão antiga.
Essa é a dor real do if por status: a regra de cada status fica espalhada por todos os métodos. Para adicionar um status você precisa revisar cada ação, e o compilador não te avisa de nenhuma.
A solução: padrão State
A ideia é inverter a pergunta. Em vez de cada ação perguntar "em que status estou?", cada status vira uma classe que sabe quais ações aceita. O pedido só guarda o estado atual e delega para ele. A classe base proíbe tudo por padrão:
// Base state: every action is forbidden unless a state allows it.
public abstract class OrderState
{
public abstract OrderStatus Status { get; }
public virtual OrderState Pay(Order order) => throw NotAllowed("pay");
public virtual OrderState Ship(Order order) => throw NotAllowed("ship");
public virtual OrderState Deliver(Order order) => throw NotAllowed("deliver");
public virtual OrderState Cancel(Order order) => throw NotAllowed("cancel");
public virtual OrderState Return(Order order) => throw NotAllowed("return");
private InvalidOperationException NotAllowed(string action) =>
new($"Cannot {action} an order that is {Status}.");
Esse "proibido por padrão" é o ponto mais importante do design. Um estado novo nasce sem permissão nenhuma, e você libera explicitamente o que faz sentido. É o oposto da lista de proibidos do Cancel() antigo.
Cada estado sobrescreve só o que permite e devolve o próximo estado. O estorno do cancelamento fica onde ele faz sentido, no estado PaidState:
public sealed class PaidState : OrderState
{
public override OrderStatus Status => OrderStatus.Paid;
public override OrderState Ship(Order order) => new ShippedState();
public override OrderState Cancel(Order order)
{
order.IssueRefund();
return new CancelledState();
}
}
A classe Order da versão "depois" ficou trivial: um campo _state que começa em PendingState, e cada ação vira uma linha do tipo public void Cancel() => _state = _state.Cancel(this);. O estorno é feito por IssueRefund(), marcado como internal para que só os estados, no mesmo assembly, possam chamá-lo.
E o ReturnedState? Ele só declara o próprio Status. Não sobrescreve Cancel, então cancelar um pedido devolvido lança InvalidOperationException com "Cannot cancel an order that is Returned." sem que ninguém tenha precisado lembrar disso.
O que mudou na prática
Primeiro, o bug some por construção, não por disciplina. O teste Cancelling_a_returned_order_is_rejected confere que o cancelamento é recusado, que o status continua Returned e que o RefundCount segue em 1.
Segundo, a leitura muda. Para saber o que um pedido pago pode fazer, você abre PaidState e está tudo ali, em poucas linhas. Na versão antiga você precisava ler os cinco métodos de Order e montar a máquina de estados de cabeça.
Terceiro, a extensão fica localizada. Um status novo, como "em separação" ou "aguardando retirada", é uma classe nova mais um ajuste no estado que leva até ele. Os outros estados não são tocados. Os testes também ficam mais diretos: cada transição tem um teste curto, e as recusas são testadas pela mensagem da exceção.
Quando NÃO usar
O State tem custo, e não é pequeno. Você troca um arquivo por vários, e quem chega no código precisa entender o padrão antes de achar onde está cada regra. Para um fluxo de três status que nunca muda, um switch bem escrito é mais honesto e mais fácil de ler.
Também não compensa quando as transições são basicamente dados, sem comportamento: se a única coisa que você precisa é "de A pode ir para B ou C", uma tabela de transições (um dicionário ou até uma tabela no banco) resolve com menos código e permite mudar sem deploy. O State brilha quando cada transição carrega comportamento próprio, como o estorno aqui, envio de e-mail ou reserva de estoque.
Outro ponto de atenção é a persistência. No banco você continua gravando o enum Status, e ao carregar o pedido precisa reconstruir o objeto de estado a partir dele. É um mapeamento simples, mas é mais uma peça para manter. E se os estados começarem a acumular dependências (repositórios, gateways de pagamento), pare e pense: talvez a regra pertença a um serviço de aplicação, e o estado deva só dizer se a transição é permitida.
Minha regra prática: se você já corrigiu um bug por causa de um status esquecido em algum if, ou se o enum de status ganhou o quinto valor, vale a pena considerar o State.
Como rodar
O projeto tem as duas versões lado a lado, nas pastas Before e After, e os testes de cada uma. Basta ter o Docker instalado:
cd 2026-11-order-status-state-pattern
docker compose run --rm tests
O código completo está no GitHub: programero-csharp/2026-11-order-status-state-pattern.
Exibindo 2026-11-18-order-status-state-pattern.html…
Comentários
Postar um comentário
Obrigado por Participar do programero, fique a vontade para agradecer, retificar, perguntar ou sugerir.