Cada decisão técnica tem contexto, custo e critério. Quando alguém perguntar "qual eu uso?",
a resposta aqui não é "depende": é uma tabela com os critérios para você decidir.
"Não é porque sempre foi feito assim que é o certo, ou o melhor."
Cesar Zanis
01
Comunicação Entre Serviços
REST Síncrono
Padrão
Quando usar
Resposta imediata necessária. CRUD simples. Volume baixo a médio. API pública consumida por browsers.
Quando NÃO usar
Operação longa (>2s). Fanout para múltiplos consumidores. Tolerância a consistência eventual.
Custo do Trade-off
Acoplamento temporal. Se o destino cai, você cai junto.
Mensageria (Filas)
Recomendado
Quando usar
Operações longas. Desacoplamento entre times. Retry automático necessário. Picos de carga absorvíveis.
Quando NÃO usar
Quando o chamador precisa da resposta imediatamente (login, validação, checkout).
Custo do Trade-off
Complexidade inicial adicional: dead-letter, monitoramento de filas e idempotência. O benefício é maior resiliência.
gRPC
Use o contexto
Quando usar
Comunicação interna inter-serviço de alta frequência. Contratos fortemente tipados. Streaming bidirecional.
Quando NÃO usar
APIs públicas consumidas por browsers (suporte nativo limitado). Times sem experiência com protobuf.
Custo do Trade-off
Curva de aprendizado e gestão de esquemas, em troca de contratos binários eficientes e menor overhead.
02
Persistência e Acesso a Dados
SQL com query explícita (Dapper/pg)
Recomendado
Quando usar
Endpoints de alta frequência. Queries complexas com JOINs. Requisito de latência <100ms. Controle de plano de execução.
Quando NÃO usar
CRUD administrativo simples. Prototipagem rápida onde velocidade de desenvolvimento importa mais.
Custo do Trade-off
Mais código manual de mapeamento, em troca de consultas explícitas e comportamento SQL mais previsível.
ORM (Entity Framework, Prisma)
Use o contexto
Quando usar
CRUD de backoffice com baixo volume. Prototipagem. Equipes com pouca experiência em SQL.
Quando NÃO usar
Sync mobile, relatórios pesados, qualquer endpoint com requisito de latência apertado.
Custo do Trade-off
Conveniência máxima. Risco: queries geradas subótimas aparecem em produção sob carga.
INT/BIGINT como PK + UUID público
Recomendado
Quando usar
Tabelas transacionais, APIs públicas e necessidade de separar identificadores internos dos públicos.
Quando NÃO usar
Tabelas pequenas de referência onde outro identificador público não é necessário.
Custo do Trade-off
Uma coluna adicional e índice UNIQUE. Identificadores públicos continuam exigindo autorização adequada.
UUID como PK direta
Use com critério
Quando usar
Tabelas pequenas (<10k linhas). Sistemas distribuídos com UUID v7 (ordenado por tempo). ID pré-gerado no client.
Quando NÃO usar
UUIDs aleatórios em índices clustered com muitas escritas, sem medir fragmentação e armazenamento.
Custo do Trade-off
Simplicidade de 1 coluna. Risco: fragmentação de índice clustered em volume.
Soft Delete (deleted_at)
Recomendado
Quando usar
Histórico de negócio, exclusão reversível e auditoria, sujeitos a uma política definida de retenção.
Quando NÃO usar
Dados temporários sem exigência de histórico, ou dados que precisam ser eliminados efetivamente.
Custo do Trade-off
Uma coluna adicional e filtro obrigatório nas leituras pertinentes. Retenção e eliminação continuam exigindo tratamento explícito.
03
Cache e Performance
Redis
Use o contexto
Quando usar
Sessões, tokens, contadores em tempo real e dados compartilhados. Defina TTL, limites de memória e políticas de descarte.
Quando NÃO usar
Arquivos binários grandes ou dados mais adequados a object storage ou CDN. Avalie tamanho e frequência de acesso.
Custo do Trade-off
Custos de memória e operação. Verifique se o benefício de latência os justifica.
Cache em CDN / HTTP Headers
Recomendado
Quando usar
Assets estáticos. Respostas de API imutáveis (catálogos versionados). Imagens. Páginas sem personalização.
Quando NÃO usar
Dados personalizados por usuário. Dados que mudam em tempo real.
Custo do Trade-off
Quase grátis. Complexidade: invalidação. Use ETags ou versionamento de URL.
Sem cache (recalcular sempre)
Use o contexto
Quando usar
Dados que mudam a cada request. Custo de inconsistência maior que custo de latência. Queries <100ms.
Quando NÃO usar
Queries pesadas (>500ms) que retornam o mesmo resultado por minutos.
Custo do Trade-off
Zero complexidade. Custo: latência e carga no banco. Aceitável se o contexto permitir.
04
Estratégia de Projeto e Migração
Reescrever do zero
Use com critério
Quando usar
Sistemas pequenos com poucas dependências, domínio bem entendido e custos de migração documentados.
Quando NÃO usar
Sistema em produção com múltiplos consumidores. Regras de negócio não documentadas. Time que não domina o domínio.
Custo do Trade-off
Risco altíssimo de perder regras implícitas. Só justificável com decisão consciente e documentada.
Strangler Fig (estrangulamento gradual)
Recomendado
Quando usar
Sistema em produção com consumidores ativos. Migração com rollback possível a qualquer ponto. Time não pode parar.
Quando NÃO usar
Sistema trivial sem consumidores (não precisa dessa cerimônia para 3 endpoints).
Custo do Trade-off
Mais infraestrutura e coordenação de migração. Pode reduzir interrupções, mas não elimina o risco de indisponibilidade.
Manter e modernizar incrementalmente
Use o contexto
Quando usar
Framework ainda suportado. Equipe produtiva. Custo de migração >benefício claro.
Quando NÃO usar
Framework descontinuado. Equipe improdutiva. Débito técnico crescendo mais rápido que features.