# PBI MotionFit — Visão Geral

O subdomínio `pbi.motionfitacademia.com.br` reúne a camada web usada para exibir dashboards Power BI, cadastrar metas, disponibilizar APIs para o Power BI e apoiar rotinas operacionais como entradas, vendas, histórico de telas, não renovados EVO e exportações de Google Sheets.

## Sistemas dentro do subdomínio

| Sistema | URL/caminho | Finalidade |
| --- | --- | --- |
| Portal de Dashboards Power BI | / | Camada PHP para login interno e exibição de relatórios Power BI publicados via iframe. |
| Dashboard público/TV legado | /0/ | Variação sem login explícito encontrada para exibição dos dashboards principais. |
| Corrida / Atletismo responsivo | /1/ | Página única para alternar entre telas de corrida e atletismo, com links desktop/mobile. |
| Cadastro de Metas | /metas/ | Sistema administrativo para metas de consultores e metas da rede por competência. |
| API de Metas | /metas/api/public/ | API JSON com autenticação JWT para usuários e metas. |
| Power BI Metas Export API | /metas/api/powerbi.php e /metas/api/powerbi_rede.php | Endpoints de leitura para Power BI consumir metas de consultores e metas da rede. |
| Sales API | /Sales/ | Consulta JSON de vendas com filtros de data, unidade, tipo de venda, telefone e voucher. |
| Entries API | /Entries/ | Consulta JSON de entradas/catraca com filtros de data, membro, unidade, equipamento e tipo. |
| Histórico de Telas Power BI | /Historico/ | Catálogo de links históricos de relatórios por mês, ano, unidade e tela. |
| Clientes Não Renovados EVO | /not/1/ | Consulta a endpoint EVO para não renovados, filtros e exportação para disparo. |
| Exportador Google Sheets | /not/2/ | Leitura de Google Sheets público com filtros e exportação CSV/JSON/HTML/XLSX. |
| Acesso Rápido Gerentes | /Home/ | Página de atalhos/entrada rápida para gerentes. |

## Fluxo geral

```mermaid
flowchart LR
    Usuario[Usuário interno] --> Login[Login PBI / Metas]
    Login --> Portal[Portal de Dashboards]
    Portal --> PowerBI[Relatórios app.powerbi.com]
    Login --> Metas[Cadastro de Metas]
    Metas --> DBMetas[(Banco metas_consultores)]
    PowerBI --> APIMetas[metas/api/powerbi.php]
    PowerBI --> Sales[Sales API]
    PowerBI --> Entries[Entries API]
    Sales --> DBSales[(tb_sales)]
    Entries --> DBEntries[(tb_entries)]
```

## Padrões identificados

- Stack: PHP 8.3 no cPanel/UOL, MySQL/MariaDB e front-end HTML/CSS/JavaScript.
- Paleta visual: verde MotionFit `#98c01f`, preto e branco.
- O portal raiz usa sessão PHP e CSRF no login.
- O sistema de metas usa perfis `admin`, `operador` e `gerente`.
- A API de metas usa JWT Bearer Token com expiração de 1 hora.
- Os endpoints de Power BI retornam JSON para consumo em relatórios.
- Há links de Power BI duplicados em `index.php`, `/0/index.php`, `/1/index.php` e histórico.

## Ponto de atenção

O ZIP original contém credenciais reais e configurações sensíveis. Na documentação elas foram substituídas por placeholders, mas no servidor/repositório essas credenciais devem ser rotacionadas.