Guias - Visão Geral

O que é

O módulo Guias centraliza o cadastro dos profissionais que acompanham as excursões e passeios da sua empresa. A partir da página inicial em Cadastros > Guias você lista todos os guias já cadastrados, filtra por status (ativo/inativo) e busca por nome, apelido, e-mail, CPF ou celular. Cada card mostra foto, status, quantidade de viagens vinculadas, especialidades e atalhos rápidos para editar, visualizar ou impersonar (acessar como) o guia.

A partir desta tela você também chega aos cadastros auxiliares usados no formulário do guia: Idiomas, Cargos e Especialidades. Eles alimentam respectivamente os campos de idiomas falados, o cargo principal e as áreas de atuação.

Use este artigo como índice - cada fluxo concreto (criar, editar, listar, ver detalhes, enviar e-mail de senha) tem seu próprio artigo dedicado linkado nas seções abaixo.

Como usar

Os principais fluxos do módulo, na ordem em que normalmente acontecem:

1. Cadastrar idiomas, cargos e especialidades (uma vez, na configuração inicial). Eles aparecem como opções no formulário de cadastro de guia.

   • Listagem de idiomas e Cadastrar idioma
   • Listagem de cargos, Cadastrar cargo e Editar cargo
   • Listagem de especialidades e Cadastrar especialidade

2. Cadastrar um novo guia com dados pessoais, profissionais, cargo, idiomas, especialidades e foto. Veja Cadastrar guia.

3. Listar e filtrar guias já cadastrados por busca livre e por status. Veja Listagem de guias.

4. Editar dados de um guia existente quando algo mudar (cargo, contatos, status, especialidades). Veja Editar guia.

5. Ver detalhes do guia, incluindo o histórico de excursões vinculadas. Veja Detalhes do guia.

6. Enviar e-mail de definição/redefinição de senha para que o guia acesse o Portal do Guia. Veja Ação de pagamento e envio de senha.

Casos especiais

Guia inativo

Guias com status ativo = false continuam aparecendo na listagem (com o filtro Inativos) e mantêm o histórico de excursões, mas perdem o botão Acessar como Guia no card. A alternância é feita pelo item Desativar/Ativar no menu de ações.

Exclusão (soft delete)

A exclusão usa SoftDeletes (coluna deleted_at). O registro deixa de aparecer nas listagens e libera o e-mail/CPF para reuso em novo cadastro, pois as regras Rule::unique('guias')->whereNull('deleted_at') ignoram registros excluídos.

Acessar como Guia (impersonation)

O botão Acessar como Guia abre o portal do guia logado como aquele profissional, útil para suporte e diagnóstico. Só aparece para guias ativos e exige permissão de editar os guias.

Validação de CPF em tempo real

O formulário consulta a rota AJAX checkCpf enquanto o usuário digita: valida o CPF e, se já existir outro guia com o mesmo número, oferece um link direto para a edição daquele registro.

Erros comuns e como resolver

• "O campo e-mail já está em uso" - Causa: outro guia ativo ou não excluído usa o mesmo e-mail. Solução: localize o registro existente na listagem ou exclua o duplicado antes de recadastrar.
• "CPF inválido" - Causa: número não passa na regra App\Rules\Cpf. Solução: confira o CPF informado; o sistema aceita com ou sem máscara, mas o dígito verificador precisa estar correto.
• "Nenhum guia cadastrado" (estado vazio da listagem) - Causa: ainda não existem guias ou o filtro aplicado não retorna resultados. Solução: limpe os filtros ou clique em Cadastrar primeiro guia no próprio estado vazio.
• Cargo, idioma ou especialidade não aparece no formulário - Causa: o item está inativo no respectivo cadastro auxiliar. Solução: ative-o em Cadastros > Cargos / Idiomas / Especialidades.

Onde encontrar

• URL: /admin/guias
• Caminho no menu: Cadastros > Guias
• Permissão necessária: ver os guias (criar/editar exige criar os guias e editar os guias; excluir exige excluir os guias)
• Módulo necessário: nenhum

Veja também

• Listagem de guias
• Cadastrar guia
• Editar guia
• Detalhes do guia
• Envio de e-mail de senha
• Idiomas - listagem · Cadastrar idioma
• Cargos - listagem · Cadastrar cargo · Editar cargo
• Especialidades - listagem · Cadastrar especialidade