# Cadastro de Metas

## Finalidade

Sistema interno para cadastrar e manter metas de consultores e metas da rede por competência mensal.

## Caminho

```text
/metas/
```

## Perfis

| Perfil | Acesso |
| --- | --- |
| `admin` | Acesso de rede, metas por unidade, metas da rede e administração geral. |
| `operador` | Acesso operacional com múltiplas unidades. |
| `gerente` | Acesso vinculado à própria unidade. |

## Arquivos principais

| Arquivo | Responsabilidade |
| --- | --- |
| `metas/login.php` | Login do sistema de metas. |
| `metas/dashboard.php` | Lançamento/visualização de metas de consultores. |
| `metas/consultores.php` | Cadastro e manutenção de consultores. |
| `metas/metasRede.php` | Grade de metas da rede. |
| `metas/salvar_metas.php` | Persistência das metas dos consultores. |
| `metas/salvar_consultor.php` | Criação/atualização de consultor e foto. |
| `metas/excluir_consultor.php` | Desativação/exclusão lógica do consultor. |
| `metas/salvar_metas_rede.php` | Persistência das metas da rede. |
| `metas/importar_metas_rede.php` | Importação de planilha de metas da rede. |
| `metas/baixar_modelo_metas_rede.php` | Modelo CSV/XLSX para importação. |

## Regra da trava mensal

O código cria e usa a tabela `tbmetas_edicoes` para bloquear múltiplas edições por gerente, unidade e competência. O gerente só pode editar metas uma vez por mês para a respectiva unidade. Admin/operador não seguem a mesma trava.

## Importação de metas da rede

A importação aceita campos como:

- `id_unidade`
- `unidade`
- `ativos_recorrentes`
- `evasao`
- `vendas`
- `vendas2`
- `faturamento`
- `faturamento2_percentual`
- `faturamento_base`
- `base_limpa_percentual`
- `gympass`
- `meta_gympass`
- `totalpass`
- `meta_totalpass`
- `nps_qualidade`

## Correções recomendadas

- Remover `default_password` real do `config.php` e gerar senha temporária por variável de ambiente.
- Garantir que todos os usuários estejam com senha hasheada.
- Validar permissão em qualquer ação de upload/importação.
- Restringir tamanho e extensão de fotos de consultores.