Runbooks — PBI

1. Erro 504 / Gateway Timeout em Sales ou Entries

2. Power BI não carrega no iframe

1. Confirmar se o link app.powerbi.com/view está ativo.
2. Confirmar se a página pageName existe no relatório publicado.
3. Testar o link direto fora do portal.
4. Conferir se a faixa branca inferior não está cobrindo conteúdo indevido.

3. Gerente não consegue alterar metas

1. Confirmar perfil do usuário em tbusuarios.
2. Confirmar unidade do usuário.
3. Conferir se já existe registro em tbmetas_edicoes para usuário/unidade/competência.
4. Se necessário, remover a trava manualmente somente com autorização.

SELECT * FROM tbmetas_edicoes
WHERE usuario = '<USUARIO>' AND unidade = '<UNIDADE>' AND competencia = 'YYYY-MM';

4. API de metas retorna 401

1. Conferir se o token Bearer foi enviado.
2. Fazer novo login em /metas/api/public/login.
3. Conferir expiração do token.
4. Conferir JWT_SECRET/configuração do ambiente.

5. EVO retorna 401/403 no não renovados

1. Conferir usuário/token.
2. Confirmar permissão no endpoint EVO.
3. Testar credencial fora da aplicação.
4. Rotacionar credencial se ela apareceu em ZIP ou repositório.

6. Importação de metas da rede falha

1. Baixar modelo atualizado em /metas/baixar_modelo_metas_rede.php.
2. Conferir competencia.
3. Garantir que as unidades já existem na competência.
4. Conferir aliases de colunas aceitos pela importação.