# Solução de problemas

Resolva problemas comuns por sintoma. Siga o checklist rápido primeiro.

### Checklist rápido (2 min)

1. Recarregue a página e tente novamente.
2. Teste em aba anônima (sem extensões).
3. Desative adblock/extensões de privacidade para o domínio.
4. Confirme permissões e o ambiente correto (Dev/Staging/Prod).

### Escolha o tópico

<table data-view="cards"><thead><tr><th>Tópico</th><th data-card-target data-type="content-ref">Abrir</th></tr></thead><tbody><tr><td><strong>Falhas na geração por IA</strong><br>Geração não inicia, trava, ou entrega resultado inconsistente.</td><td><a href="solucao-de-problemas/problemas-de-deploy">problemas-de-deploy</a></td></tr><tr><td><strong>Problemas de deploy</strong><br>Deploy falhando, travado, ou app fora do ar após publicar.</td><td><a href="solucao-de-problemas/falhas-na-geracao-por-ia">falhas-na-geracao-por-ia</a></td></tr><tr><td><strong>SSO e login</strong><br>Login em loop, erro de callback, ou acesso negado após autenticar.</td><td><a href="solucao-de-problemas/sso-e-login">sso-e-login</a></td></tr><tr><td><strong>Performance e lentidão</strong><br>UI lenta, endpoints demorando, ou timeouts.</td><td><a href="solucao-de-problemas/performance-e-lentidao">performance-e-lentidao</a></td></tr><tr><td><strong>Banco, migrations e schema</strong><br>Migration falha, schema divergente, ou erro de conexão.</td><td><a href="solucao-de-problemas/banco-migrations-e-schema">banco-migrations-e-schema</a></td></tr></tbody></table>

### Como escalar (abrir um chamado)

Antes de escalar, junte estas evidências. Isso reduz muito o ping-pong.

* Projeto e ambiente (Dev/Staging/Prod).
* Horário do erro (com timezone).
* Passos para reproduzir (curto e determinístico).
* Mensagem de erro completa (sem prints cortados).
* Screenshot da tela (se aplicável).
* Console do browser (erros e warnings relevantes).
* Aba **Network** (request que falhou + status + payload, se não houver dados sensíveis).

{% hint style="info" %}
Se existir um `requestId`, `traceId` ou link de execução, inclua também.
{% endhint %}