# Runbooks — PBI

## 1. Erro 504 / Gateway Timeout em Sales ou Entries

### Sintoma

A página demora demais ou o servidor retorna 504.

### Causas comuns

- Consulta sem data.
- Intervalo muito grande.
- `limit` padrão alto.
- Falta de índice em data/unidade.

### Correção

1. Sempre exigir `data` ou `data_inicio` + `data_fim`.
2. Reduzir `limit` padrão para no máximo `10000`.
3. Criar índices de data e unidade.
4. Paginar resultados.

## 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.

```sql
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.