# NPS / Fale Aqui

## Resumo

Aplicação PHP/MySQL instalada em `public_html/NPS/nps_app_php/`. Possui área pública com duas entradas e painéis internos para admin e gerente.

## Entradas públicas

| Rota | Função |
|---|---|
| `/NPS/nps_app_php/index.php` | Tela inicial com opções NPS e Fale Aqui. |
| `/NPS/nps_app_php/nps.php` | Formulário público de pesquisa NPS. |
| `/NPS/nps_app_php/fale_aqui.php` | Formulário público Fale Aqui. |
| `/NPS/nps_app_php/salvar_resposta.php` | Recebe POST do NPS. |
| `/NPS/nps_app_php/salvar_fale_aqui.php` | Recebe POST do Fale Aqui. |
| `/NPS/nps_app_php/obrigado.php` | Confirmação de envio. |

## Áreas internas

| Rota | Perfil | Função |
|---|---|---|
| `/login.php` | público | Login interno. |
| `/admin/index.php` | admin | Dashboard geral. |
| `/admin/perguntas.php` | admin | Gestão do questionário. |
| `/admin/relatorios.php` | admin | Relatórios de respostas. |
| `/admin/unidades.php` | admin | Gestão de unidades. |
| `/admin/usuarios.php` | admin | Gestão de usuários. |
| `/admin/fale_aqui.php` | admin/gerente | Gestão das mensagens do Fale Aqui. |
| `/gerente/index.php` | gerente | Painel da unidade. |
| `/gerente/rede.php` | gerente sem unidade/admin | Visão Rede Motion. |
| `/gerente/tv.php` | gerente | Tela de TV. |

## Regras principais

- NPS salva respostas no banco e **não envia e-mail**.
- Fale Aqui salva mensagem no banco e envia notificação somente para o NPS interno.
- O destino fixo de notificação deve ser `nps@motionfitacademia.com.br`.
- A unidade no Fale Aqui é obrigatória para registro, filtro e gestão, não para definir destinatário de e-mail.
- Gerente com unidade vinculada vê somente mensagens da própria unidade.
- Admin vê todas as unidades.
- Upload do Fale Aqui aceita no máximo 2 imagens por mensagem, de acordo com as funções de upload.

## Questionário padrão

- Recomendação MotionFit de 0 a 10.
- Motivo de permanência.
- Ponto de melhoria com opção “Tudo ok”.
- Novidade desejada.
- Atendimento da equipe.
- Frequência de treino.
- Fator de motivação/frequência.

## Pontuação

- A recomendação é exibida de 0 a 10.
- Internamente a pontuação trabalha de `0` a `-10` para alimentar nível de insatisfação.
- Resposta de melhoria preenchida pontua `-10`; “Tudo ok” pontua `0`.

## Banco de dados

Ver [Banco NPS/Fale Aqui](../database/nps-fale-aqui.md).

## Endpoints

Ver [Endpoints NPS/Fale Aqui](../apis/nps-fale-aqui-endpoints.md).

## Runbook relacionado

- [NPS — e-mail somente interno](../runbooks/nps-email-somente-interno.md)