SISTEMA DE VISITAS COMERCIAIS - V5

Principais alterações desta versão

1. CONSULTOR ITINERANTE
- O perfil CONSULTOR tem acesso a todas as filiais do grupo.
- Para o consultor, filial_id do usuário deve ficar NULL.
- Ao cadastrar cliente, o consultor escolhe a filial do cliente.
- Ao registrar visita, a filial é herdada do cliente.

2. CADASTRO DE CLIENTE PELO CONSULTOR
- O consultor agora pode acessar cliente_form.php diretamente.
- Pode criar e editar clientes de qualquer filial.
- O consultor logado é gravado como responsável pelo cadastro.

3. PERGUNTAS DINÂMICAS DA VISITA
- Motivos.php deixou de ser usado.
- O novo painel Perguntas da Visita permite cadastrar, editar, ativar e desativar perguntas.
- Seções: Avaliação do atendimento, Situação comercial, Oportunidades, Observações e Próximo contato.
- Tipos: texto curto, texto longo, lista de opções, número e data.
- As opções de listas ficam no banco no formato valor|rótulo, uma por linha.
- Perguntas novas são armazenadas em respostas_visita e não exigem alteração do PHP.
- As perguntas antigas são preservadas através do campo campo_legacy, mantendo os relatórios existentes.
- Os campos ENUM das visitas são convertidos para VARCHAR na migração V4 para permitir novas opções sem editar o banco manualmente.

4. ERRO DO CNPJ EM visitas.php
- A consulta passou a trazer c.cnpj_cpf explicitamente.

5. MENU MOBILE
- O botão do menu lateral agora é registrado após o carregamento do DOM.
- O menu abre e fecha corretamente em celulares.

6. SQL SERVER
- A busca de clientes continua disponível em visitas.php.
- Pesquisa por CNPJ/CPF ou nome.
- Importa o cliente para o MySQL e abre a visita.

INSTALAÇÃO / ATUALIZAÇÃO

1. Faça backup da pasta atual C:\xampp\htdocs\sistema-visitas.
2. Extraia esta versão para C:\xampp\htdocs\sistema-visitas.
3. NÃO apague o banco existente.
4. Entre como ADMIN.
5. Acesse Atualizar Banco no menu.
6. Depois acesse Perguntas da Visita e confira as perguntas iniciais.
7. Edite o usuário CONSULTOR e confirme que a filial está em Todas as filiais / N/A.
8. Teste Clientes > Novo Cliente com o usuário consultor.
9. Teste Visitas > Buscar cliente no SQL Server.
10. Teste o menu pelo celular.

IMPORTANTE
- Não reimporte database.sql em um banco que já contém dados.
- migracao_v4.sql também está incluído para quem preferir executar pelo phpMyAdmin.
- A página atualizar_banco_v4.php é a forma recomendada para atualizar um banco existente.

SQL SERVER

Configure config/db_sqlserver.php com os dados reais do SQL Server e verifique se o PHP do XAMPP possui PDO_SQLSRV/PDO_SQLSRV instalado.

FLUXO RECOMENDADO PARA O CONSULTOR

Visitas > Buscar cliente > CNPJ/Nome > Pesquisar > Importar > escolher filial > Importar e abrir visita.

Ou:

Clientes > Novo Cliente > preencher manualmente > Salvar > Visitar.

SEGURANÇA
- Controle de perfil no backend.
- CSRF nas operações POST.
- Password hash para senhas.
- Consultor limitado às próprias visitas ao editar/visualizar visitas.
- Gerente limitado à própria filial.
- Admin com acesso global.
