Pular para o conteúdo

Soluções · Integrações, sistemas e qualidade de dados

Integração que só passa em ambiente controlado: o que falta

Como testar integrações só em ambiente controlado e ainda assim pegar o que quebra em produção?

Resposta direta

Teste de integração em ambiente controlado só faz sentido quando o ambiente imita as condições que interessam: os mesmos contratos, os mesmos formatos de dado e as mesmas dependências externas, ainda que com dados mascarados. O trabalho começa por listar o que o ambiente não reproduz, como volume, tempo de resposta e comportamento de terceiros, e transformar cada item em um teste específico, com responsável definido. Sem essa lista, o teste aprova o que já era previsível e deixa passar a falha que só aparece em produção.

Objetivo
Orientar implementação
Formato indicado
Projeto de implementação
Atualizado em

O que esta página acrescenta: Trata o ambiente controlado como escopo declarado: o que ele cobre, o que precisa ser simulado no lugar do real e a partir de onde o teste deixa de valer.

O que o teste precisa reproduzir do ambiente real

Um teste em ambiente controlado só vale se o ambiente representar as condições que o teste pretende verificar. Isso significa manter os contratos de interface na mesma versão dos sistemas reais, usar o mesmo formato de dado que circula na operação e reproduzir o encadeamento entre as chamadas, não apenas o resultado final. Quando o ambiente usa um contrato simplificado, o teste aprova uma integração que não existe.

O ponto de partida é a lista de integrações que entram no teste. Para cada uma, vale registrar quem responde pelo contrato de cada ponta, qual dado mínimo precisa circular e qual é o resultado esperado. Sem essa lista, o ambiente vira um conjunto de sistemas ligados sem critério, e o teste passa a medir o que está fácil de montar, não o que interessa.

Dados e dependências que o ambiente não possui

Todo ambiente controlado convive com o que não está lá: um sistema de terceiro, um serviço de cobrança, um cadastro externo. A decisão precisa ser explícita para cada dependência, seja simular a resposta, isolar a chamada ou assumir que aquele trecho fica fora do teste. O que não pode acontecer é a dependência faltar sem que ninguém saiba, porque aí o teste passa por ausência, não por correção.

A massa de teste segue a mesma lógica. Dado de produção copiado sem controle traz risco de exposição e diverge do que o ambiente espera. Mascarar campo sensível é o mínimo; o que importa é que o dado mascarado mantenha o formato e as variações que o sistema real encontra. Quem aprova o uso da massa e quem responde por um dado que não deveria estar ali precisam estar definidos antes da execução.

Onde o ambiente controlado deixa de valer

Ambiente controlado não reproduz volume, concorrência, tempo de resposta e falha real de terceiros. Um teste aprovado ali não indica que a integração suporta o volume da operação nem que ela se recupera de uma indisponibilidade. Esses pontos exigem medição em outro lugar: acompanhamento em produção, teste de carga com dado representativo ou observação do comportamento por um período definido.

Também não resolve o que depende de decisão de negócio. Duplicidade de cadastro, divergência de regra entre áreas e responsabilidade sobre o dado errado não se corrigem com teste. Se o problema é de processo ou de dono, o ambiente controlado apenas confirma que o sistema faz o que foi combinado. Vale dizer isso de forma clara antes de investir mais horas em cobertura de teste.

Recurso prático

O que definir antes de rodar o teste em ambiente controlado

  • Lista das integrações cobertas pelo teste, com o sistema de cada ponta e o responsável pelo contrato.
  • Origem da massa de teste e regra de mascaramento dos dados sensíveis, com quem aprova o uso.
  • Dependências externas que o ambiente não possui e a decisão tomada para cada uma: simular, isolar ou deixar fora do escopo.
  • Condições de produção que o ambiente não reproduz, como volume, concorrência e tempo de resposta, e o teste que cobre cada uma.
  • Critério de aprovação do teste, com o resultado esperado registrado antes da execução.
  • Registro de quem alterou o ambiente por último e o que foi alterado, para o teste poder ser repetido.
  • Critério de reconstrução do ambiente, para que ele não acumule configurações que não existem em produção.

O erro mais comum é tratar o ambiente controlado como prova de que a integração funciona. Ele valida o que foi previsto no contrato, não o que o sistema faz com dado real, volume real e falha real de terceiro.

Sobre o que está escrito aqui

Conceitos relacionados: ambiente de homologação · teste de integração · dados mascarados · dependência externa · massa de teste. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.

Para continuar

Páginas relacionadas

O mesmo problema em outro objetivo

Outras leituras em Integrações, sistemas e qualidade de dados

Quer avaliar isso no seu contexto?

Esta página trata de teste de integração feito só em ambiente controlado. Diagnóstico de integração é a frente que investiga o mecanismo por trás desse tipo de problema. O formato mais associado é Projeto de implementação.