Guias - Lista de Guias

O que é

A página Guias é o ponto central para gerenciar todos os guias turísticos da empresa. Ela mostra um card por guia com foto, nome, selos de status (Ativo, Inativo, número de viagens, Site), dados de contato, número CADASTUR, especialidades e os botões de ação rápida.

O usuário chega aqui sempre que precisa montar a equipe de uma viagem, atualizar dados de um guia, suspender alguém da escala ou liberar acesso ao Portal do Guia para diagnóstico. Os cards aparecem ordenados pelos cadastros mais recentes e a página exibe 10 guias por página com paginação no rodapé.

Como usar

1. Acesse Cadastros > Guias no sidebar (ou abra diretamente /admin/guias).
2. Para localizar alguém, use o campo Buscar por nome, email ou CADASTUR.... A busca também encontra por apelido, CPF e celular (não só pelos rótulos do campo).
3. Para ver apenas guias em operação, use o seletor Status e escolha Ativos. Use Inativos para ver quem está fora da escala.
4. Para um vislumbre sem sair da lista, clique no ícone de olho ao lado do nome (Dados rápidos) - abre um modal com o resumo do guia.
5. Para abrir o perfil completo com histórico de viagens, clique em Visualizar no rodapé do card.
6. Para alterar dados, clique em Editar no rodapé do card.
7. Para entrar no sistema como o próprio guia (apenas guias ativos), clique em Acessar como Guia - abre uma sessão impersonada útil para suporte e testes.
8. Para mais ações, use o menu de três pontos no canto direito do card: Ativar/Desativar e Excluir.

Casos especiais

Guia inativo

O botão verde Acessar como Guia desaparece do card. As demais ações continuam disponíveis. Use o menu de três pontos > Ativar para liberar o guia novamente.

Lista vazia

Quando nenhum guia está cadastrado, a página mostra o estado vazio com o botão Cadastrar primeiro guia, que leva direto ao formulário de cadastro.

Filtros combinados na URL

Os filtros entram na URL e são preservados na paginação. É possível compartilhar visões prontas como /admin/guias?status=1 (ativos) ou /admin/guias?busca=Maria (busca por Maria em todos os campos).

Exportação

A listagem não possui exportação para CSV ou Excel. Para extrair dados de guias em massa, peça ao time técnico ou use o módulo de Relatórios > Exportações.

Excluir guia

Excluir abre o modal de confirmação Excluir Guia com checkbox de confirmação obrigatória. A exclusão é por soft delete: o registro fica preservado no banco e o e-mail/CPF não podem ser reaproveitados em um novo cadastro enquanto o registro existir.

Erros comuns e como resolver

• "Você não tem permissão para acessar esta página" - Causa: o usuário não tem a permissão de ver os guias. Solução: peça ao proprietário ou gerente para conceder a permissão em Sistema > Permissões.
• Botão Novo Guia não aparece - Causa: o usuário não tem a permissão de criar os guias. Solução: ajuste o papel do usuário em Sistema > Usuários.
• Botões Editar, Acessar como Guia, Ativar/Desativar não aparecem - Causa: o usuário não tem a permissão de editar os guias. Solução: ajuste a permissão do papel correspondente.
• Item Excluir não aparece no menu de três pontos - Causa: falta a permissão de excluir os guias. Solução: ajuste o papel.
• Busca não retorna o guia esperado - Causa: o termo digitado não bate exatamente com nenhum dos campos pesquisados (nome, apelido, e-mail, CPF ou celular). Solução: tente com parte do nome ou apenas os números do CPF/celular.

Onde encontrar

• URL: /admin/guias
• Caminho no menu: Cadastros > Guias
• Permissão necessária: ver os guias (com criar os guias, editar os guias e excluir os guias liberando as respectivas ações)
• Módulo necessário: nenhum

Veja também

• Cadastrar Guia
• Editar Guia
• Perfil do Guia
• Visão Geral dos Guias