
# Histórico de Telas Power BI

## Finalidade

Módulo para manter links históricos de relatórios do Power BI por mês, ano, unidade e tela. Resolve o problema de trocar links manualmente no HTML sempre que muda o mês.

## Caminho

```text
/Historico/
```

## Endpoint

```text
GET /Historico/api_historico_telas.php
```

## Parâmetros

| Parâmetro | Descrição |
| --- | --- |
| `unidade` | Unidade exata. |
| `mes` | Mês numérico, por exemplo `5`. |
| `ano` | Ano, por exemplo `2026`. |
| `tela` | Nome da tela, por exemplo `Ranking`. |

## Tabela

```sql
historico_telas_pbi(
  id,
  id_unidade,
  unidade,
  mes,
  ano,
  tela,
  link,
  ativo,
  observacao,
  criado_em,
  atualizado_em
)
```

## Exemplo

```bash
curl "https://pbi.motionfitacademia.com.br/Historico/api_historico_telas.php?ano=2026&mes=5&unidade=REDE"
```

## Regras

- Só retorna registros `ativo = 1`.
- Ordena por ano/mês mais recente e depois por unidade/tela.
- Usa chave única por `unidade`, `ano`, `mes`, `tela`.

## Correções recomendadas

- Usar variáveis de ambiente para banco.
- Remover fallback com senha real do `config.php`.
- Adicionar tela administrativa para cadastrar links sem editar SQL manualmente.
