# MotionFit Developer Hub v10

Documentação técnica consolidada dos sistemas MotionFit.

Esta versão unifica a documentação criada a partir de três fontes de código e da Matriz de Responsabilidade: **site público/public_html**, **RH**, **PBI**, **NPS/Fale Aqui**, **Franquia**, **parceiros**, **infraestrutura**, **OpenAPI**, **Postman** e **runbooks operacionais**.

> **Regra de segurança:** este pacote não contém senhas reais, tokens reais, dumps sensíveis ou `.env` de produção. Qualquer credencial identificada nos ZIPs originais deve ser rotacionada e movida para variável de ambiente no servidor.

---

## 1. Escopo consolidado

| Grupo | Sistemas documentados | Fonte principal |
| --- | --- | --- |
| Site público | Site institucional, unidades, planos, Motion Pass/Wellhub, NPS/Fale Aqui, Franquia, admin de mídias | `public_html(1).zip` |
| RH | Ficha de admissão, Trabalhe Conosco, Formulário Pix, Pix variante, Sistema RH legado | `rh.motionfitacademia.com.br (4)(1).zip` |
| PBI | Portal Power BI, Cadastro de Metas, API JWT, Sales API, Entries API, Histórico, Clientes não renovados EVO, exportador Google Sheets | `pbi.motionfitacademia.com.br (1)(1).zip` |
| Governança | Catálogo de sistemas, parceiros, subdomínios e infraestrutura | Matriz de Responsabilidade |

---

## 2. Sistemas principais

| Sistema | URL/Base | Grupo | Função | Status |
| --- | --- | --- | --- | --- |
| Site institucional | `motionfitacademia.com.br` / `www.motionfitacademia.com.br` | Site público | Home, unidades, planos, páginas institucionais e componentes do site | Documentado pelo ZIP `public_html` |
| NPS / Fale Aqui | `motionfitacademia.com.br/NPS/nps_app_php` | Site público | Pesquisa NPS, mensagens Fale Aqui, painel admin/gerente e TV | Documentado pelo ZIP `public_html` |
| Franquia | `www.motionfitacademia.com.br/pages/Franquia/index.php` | Site público | Captação de leads de franquia e envio SMTP | Documentado pelo ZIP `public_html` |
| Motion Pass / Wellhub | `www.motionfitacademia.com.br/pages/Pass/index.php` | Site público | Landing de unidade/parceiro Wellhub | Documentado pelo ZIP `public_html` |
| Ficha de Admissão RH | `rh.motionfitacademia.com.br/admissoes/public` | RH | Ficha admissional, anexos, dependentes, admin, diagnóstico e PDF | Documentado pelo ZIP RH |
| Trabalhe Conosco RH | `rh.motionfitacademia.com.br/MT1/trabalhe_conosco` | RH | Candidatos, currículos, filtros e exportação PDF individual | Documentado pelo ZIP RH |
| Formulário Pix RH | `rh.motionfitacademia.com.br/MT0/form_pix` | RH | Coleta/administração de dados Pix | Documentado pelo ZIP RH |
| Sistema RH legado | `rh.motionfitacademia.com.br/sistemaRh` | RH | Vagas, candidatos, entrevistas, relatórios e funcionários | Documentado pelo ZIP RH |
| Portal Power BI | `pbi.motionfitacademia.com.br/login.php` | PBI | Login interno e páginas de relatórios publicados | Documentado pelo ZIP PBI |
| Cadastro de Metas | `pbi.motionfitacademia.com.br/metas/login.php` | PBI | Metas de consultores/rede, usuários e API JWT | Documentado pelo ZIP PBI |
| Sales / Entries APIs | `pbi.motionfitacademia.com.br/Sales` e `/Entries` | PBI | Endpoints JSON consumidos pelo Power BI | Documentado pelo ZIP PBI |
| Acesso Rápido Gerentes | `pbi.motionfitacademia.com.br/Home` | PBI | Atalhos internos para gerentes | Documentado pelo ZIP PBI |

---

## 3. Inventário revisado

| Fonte analisada | Arquivos | PHP | SQL | Tamanho descompactado aprox. | Observação |
| --- | ---: | ---: | ---: | ---: | --- |
| `public_html(1).zip` | 379 | 145 | 10 | 340.48 MB | Site público, NPS, Franquia, Motion Pass |
| `rh.motionfitacademia.com.br (4)(1).zip` | 1.911 | 1.486 | 19 | 270.36 MB | RH novo, módulos MT0/MT1 e legado |
| `pbi.motionfitacademia.com.br (1)(1).zip` | 190 | 61 | 8 | 369.77 MB | Portal PBI, Metas, APIs e integrações |

---

## 4. Regras definitivas padronizadas

### Exportação de currículos

1. O usuário filtra ou seleciona currículos.
2. O sistema gera **PDFs individuais sob demanda**.
3. Cada arquivo deve baixar com extensão real `.pdf`.
4. Nome padrão: `nome-sobrenome.pdf`.
5. Não gerar ZIP pesado por padrão em hospedagem compartilhada/UOL para evitar **504 Gateway Timeout** e **Resource Limit Is Reached**.

### NPS / Fale Aqui

- NPS salva resposta e não dispara e-mail.
- Fale Aqui salva mensagem e notifica somente o canal interno configurado.
- Destino padrão: `nps@motionfitacademia.com.br`.
- A unidade serve para filtro, gestão e relatórios, não para cópia automática de e-mail.

### Perfis administrativos

- `admin`: acesso total, usuários, perguntas, respostas, diagnósticos e configurações.
- `operador`: acesso operacional limitado ao escopo do projeto/unidade.
- Perfis legados (`gerente`, `recrutamento`, `gerenteRegional`) devem ser mapeados em migrações antes de substituir permissões antigas.

### Segurança

- `.env` real nunca deve entrar em ZIP ou repositório.
- Tokens EVO, JWT, SMTP, Google, Power BI e senha de banco devem ficar somente no servidor/secret manager.
- Arquivos `.sql`, `.zip`, `.bak`, dumps, logs e backups não devem ficar públicos dentro de `public_html`.

---

## 5. Estrutura do pacote

```text
motionfit-developer-hub-v10/
├── README.md
├── README.txt
├── index.html
├── mkdocs.yml
├── .env.example
├── docs/
│   ├── 00-visao-geral.md
│   ├── 01-arquitetura-geral.md
│   ├── 02-catalogo-sistemas.md
│   ├── 03-padroes-desenvolvimento.md
│   ├── 04-seguranca-e-credenciais.md
│   ├── 05-deploy-e-operacao.md
│   ├── apis/
│   ├── projects/
│   ├── rh/
│   ├── pbi/
│   ├── partners/
│   ├── infrastructure/
│   ├── runbooks/
│   └── security/
├── inventory/
├── openapi/
│   └── motionfit-api-consolidada.v10.yaml
└── postman/
    └── motionfit-api-consolidada.v10.postman_collection.json
```

---

## 6. Como usar

### Local com MkDocs

```bash
pip install mkdocs mkdocs-material
mkdocs serve
mkdocs build
```

### Site estático

Publicar `index.html` como landing page interna e usar os arquivos em `docs/` como base do portal.

### ReadMe.com/Postman

- Importar `openapi/motionfit-api-consolidada.v10.yaml` para referência de API.
- Importar `postman/motionfit-api-consolidada.v10.postman_collection.json` no Postman.

---

## 7. Status da revisão v10

- Corrigidas referências antigas dizendo que RH/PBI não tinham código analisado.
- Corrigida contagem do ZIP RH.
- Removidas páginas duplicadas/acentuação quebrada de infraestrutura.
- Reduzida redundância de OpenAPI/Postman antigos dentro do pacote final.
- Links internos do MkDocs validados.
- YAML, JSON e HTML validados.
- URLs sensíveis de embed Power BI foram mascaradas nos inventários.
- Regras de PDF, NPS, perfis e segurança consolidadas.

Gerado em: 2026-06-10

## Correção de abertura da documentação

Na v10, os botões **Abrir documentação** não apontam mais diretamente para arquivos `.md`. Agora eles apontam para páginas `.html` geradas a partir dos Markdown, com CSS embutido. Assim, ao abrir pelo navegador ou pelo cPanel, a documentação mantém o layout visual correto.

Os arquivos `.md` continuam no pacote como fonte editável e podem ser usados no MkDocs/ReadMe/GitHub.


## API Debug Terminal

A v10 adiciona uma ferramenta interna para testar APIs e ver a resposta em formato de terminal.

Arquivos principais:

```text
/tools/api-debug-terminal.html
/tools/api-debug-proxy.php
/tools/api-debug-log.php
/tools/api-debug-clear.php
/tools/api-debug-config.php
/logs/api-debug.log
```

Recursos:

- teste de endpoints `GET`, `POST`, `PUT`, `PATCH` e `DELETE`;
- visualização de status HTTP, tempo, headers e body;
- formatação automática de JSON;
- geração de `cURL`;
- histórico local;
- proxy PHP opcional para evitar CORS;
- log mascarado para tokens, senhas e cookies.

> Segurança: use apenas em área interna/admin. Não deixe o proxy liberado para qualquer domínio e desative o debug quando terminar a manutenção.
