# Formulário de Franquia

## Resumo

Aplicação PHP/MySQL em `public_html/pages/Franquia/`. Possui formulário público de interesse em franquia, painel admin, teste SMTP e schema próprio.

## Arquivos principais

| Arquivo | Função |
|---|---|
| `index.php` | Formulário público. |
| `admin.php` | Painel de respostas com login. |
| `smtp_test.php` | Teste de SMTP e diagnóstico. |
| `config.sample.php` | Modelo de configuração. |
| `config.php` | Configuração real; não deve ser versionado/publicado com segredos. |
| `database/schema.sql` | Tabela `leads_franquia_motion_fit`. |
| `app/bootstrap.php` | Sessão, headers, config, campos e opções. |
| `app/functions.php` | Validação, insert, autenticação, CSRF e e-mail. |

## Campos do formulário

| Campo | Tipo | Obrigatório |
|---|---|---|
| `nome_completo` | texto | sim |
| `whatsapp` | texto | sim |
| `email` | e-mail | sim |
| `cidade_regiao` | texto | sim |
| `investimento_parceria` | opção | sim |
| `faixa_investimento` | opção | sim |
| `prazo_proximo_passo` | opção | sim |
| `experiencia_negocio` | opção | sim |
| `motivo_interesse` | opção | sim |
| `aceita_contato` | opção | sim |

## Opções controladas

- Formato de investimento: sozinho, com sócio ou avaliando.
- Faixa de capital: até R$ 250 mil, R$ 250 mil a R$ 500 mil, R$ 500 mil a R$ 1 milhão, acima de R$ 1 milhão ou avaliando.
- Prazo: imediato, próximos 3 meses, próximos 6 meses ou apenas informações.
- Experiência: sim, não ou já investiu antes.
- Motivador: modelo de negócio, mercado fitness, retorno, estrutura da marca ou propósito.
- Contato: sim, sim em outro momento ou ainda não.

## Segurança

- Usa CSRF token.
- Usa sessão com cookie `httponly` e `samesite=Lax`.
- Possui limite de tentativas de login configurável.
- O pacote analisado possui config real; entregar em produção com `config.sample.php` e variáveis seguras.
- Trocar imediatamente qualquer senha padrão antes de publicar.

## Banco de dados

Ver [Banco Franquia](../database/franquia.md).

## Endpoints

Ver [Endpoints Franquia](../apis/franquia-endpoints.md).

## Runbook relacionado

- [Franquia — SMTP e painel](../runbooks/franquia-smtp.md)