# Prévia e validação de runtime

> Valide o artefato renderizado, as dependências de rede, a autorização e a versão exata selecionada para publicação.

[Página canônica](https://rogueon.ai/pt-br/docs/preview-and-testing)

## Entenda o ambiente de teste

A prévia integrada renderiza a página gerada em um iframe. Os controles desktop e mobile redimensionam esse espaço preservando o estado; não emulam sistema operacional, engine do navegador, rede ou sessão nova. Reproduza fluxos críticos em outra aba e no navegador ou aparelho de destino.

Identifique a URL e a versão da prévia antes de registrar uma falha. Para diagnosticar o frontend, abra o DevTools na página gerada: confira erros do console e a requisição que falhou, incluindo status, resposta e origem. Remova cabeçalhos de autorização, cookies, tokens e dados pessoais antes de compartilhar evidências.

## Matriz de validação

| Camada | Verificações |
| --- | --- |
| Renderização | Sem erros não tratados; assets carregam; estados vazio, carregamento e erro estão visíveis quando esperados. |
| Interação | Teclado, foco, validação de entrada, envio repetido e navegação preservam o contrato. |
| Persistência | Dados sobrevivem ao reload e aparecem em outro cliente quando devem ser compartilhados. |
| Autorização | Usuário A não lê nem altera registros privados de B; acesso anônimo respeita as regras. |
| Serviços | A resposta corresponde ao serviço real; falhas e limites não viram sucesso fictício. |
| Publicação | O endereço público serve a versão aprovada e mantém o fluxo principal funcional. |

## Registre uma falha reproduzível

**Relato de defeito em runtime**

```text
Versão / URL: [artefato testado]
Ambiente: [navegador, viewport, autenticado ou anônimo]
Pré-condições: [registros sintéticos e estado inicial]
Passos: [menor sequência]
Esperado: [contrato]
Observado: [resultado visível]
Evidência: [mensagem do console ou status da requisição, sem dados sensíveis]
Regressão: [comportamentos que devem permanecer]
Corrija a causa e informe quais verificações foram realmente executadas.
```

## Valide a versão candidata à publicação

Reproduza o teste na revisão e execute as verificações de regressão próximas. Uma renderização estática não valida permissões do banco nem um fluxo de pagamento. Use contas de teste e ambientes de teste dos serviços quando disponíveis; diferencie simulação de ações externas concluídas.

Depois de publicar, repita o caminho crítico no endereço público. Fontes, arquivos publicados e configuração de runtime podem divergir; valide o destino em vez de inferir seu estado pelo resultado do build.

- [Diagnosticar falhas na prévia](https://rogueon.ai/pt-br/docs/troubleshooting#preview)

## Guias relacionados

- [Ciclo de build e revisões](https://rogueon.ai/pt-br/docs/build-and-refine)
- [Autenticação, dados e permissões](https://rogueon.ai/pt-br/docs/data-and-permissions)
- [Publicação e seleção de versão](https://rogueon.ai/pt-br/docs/publishing)