# Visão geral

O **MotionFit Developer Hub v10** é a documentação técnica consolidada dos sistemas internos e públicos da MotionFit.

## Fontes usadas

| Fonte | Uso na documentação |
| --- | --- |
| Matriz de Responsabilidade | Catálogo oficial de aplicações, subdomínios, parceiros e infraestrutura. |
| `public_html(1).zip` | Código do site institucional, NPS/Fale Aqui, Franquia e Motion Pass/Wellhub. |
| `rh.motionfitacademia.com.br (4)(1).zip` | Código de Ficha de Admissão, Trabalhe Conosco, Pix RH e Sistema RH legado. |
| `pbi.motionfitacademia.com.br (1)(1).zip` | Código do portal PBI, Cadastro de Metas, APIs e integrações auxiliares. |

## Objetivos

- Facilitar manutenção técnica dos sistemas.
- Evitar perda de conhecimento operacional.
- Padronizar deploy, segurança, endpoints, banco e runbooks.
- Servir como base para publicação em MkDocs, ReadMe.com, GitHub/GitLab ou portal HTML interno.

## Mapa rápido

| Área | Onde consultar |
| --- | --- |
| Sistemas | [Catálogo de sistemas](02-catalogo-sistemas.md) |
| Arquitetura | [Arquitetura geral](01-arquitetura-geral.md) |
| APIs | [APIs](apis/site-publico.md) e `openapi/motionfit-api-consolidada.v10.yaml` |
| RH | [Visão geral RH](rh/visao-geral-rh.md) |
| PBI | [Visão geral PBI](pbi/visao-geral.md) |
| Site público | [Site institucional](projects/site-institucional.md) |
| Segurança | [Segurança e credenciais](04-seguranca-e-credenciais.md) |
| Operação | [Deploy e operação](05-deploy-e-operacao.md) e [Runbooks](runbooks/publicar-cpanel.md) |

## Regras de ouro

1. Nunca publicar credenciais reais.
2. Sempre validar PDF, uploads e permissões de storage após deploy.
3. Evitar processos pesados em lote na hospedagem compartilhada.
4. Manter banco, arquivos e código com backup antes de qualquer alteração.
5. Registrar toda mudança importante no changelog.