Como vincular uma observação no navegador ao código e aos dados que a produziram

Objetivo

Garanta que uma captura de tela ou inspeção no navegador usada para validar uma alteração de código reflita de fato o build, a rota, o estado da conta e a fixture de dados pretendidos.

Pré-requisitos

Tenha em mãos o cenário de aceitação, a instância da aplicação pretendida e dados de teste autorizados. Mantenha as capturas de tela livres de informações pessoais não relacionadas e de credenciais.

Passos

1. Identifique a rota exata e o cenário a inspecionar, incluindo os parâmetros de consulta necessários, o idioma (locale), o viewport e o perfil da conta. Registre apenas o contexto necessário para reproduzir o comportamento observado.

2. Confirme que o navegador acessa o build ou a instância de preview pretendidos. Verifique um marcador de revisão não secreto ou outro sinal de identidade compatível com o projeto, em vez de confiar apenas no título da aba.

3. Estabeleça o estado de dados necessário por meio da configuração de teste suportada. Diferencie uma fixture carregada previamente (seed) de conteúdo real e verifique se o elemento inspecionado pertence ao registro pretendido.

4. Execute a interação relevante e capture o estado resultante. Uma captura de tela feita antes do envio não permite saber o que acontece depois de um salvamento bem-sucedido; associe cada observação à ação que a precede.

5. Repita uma observação específica após a última alteração de código quando as evidências anteriores tiverem ficado desatualizadas. Teste, numa verificação controlada, uma URL de preview errada e uma fixture desatualizada, para confirmar que o protocolo detecta a divergência.

Resultado esperado

A evidência visual tem um escopo claro: um cenário nomeado, em um artefato conhecido, com condições de fixture identificáveis. Quem faz a revisão consegue reproduzir a observação e entende o que ela comprova e o que não comprova.

Limites e base de verificação

Este é um protocolo de validação original, sem alegar que tenha sido usada alguma sessão de navegador. Um estado visualmente correto ainda pode ocultar falhas de acessibilidade, de persistência ou do lado do servidor. Inclua as verificações não visuais apropriadas quando esses comportamentos fizerem parte do critério de aceitação.