Guias - Especialidades

O que é

Esta tela reúne todas as Especialidades cadastradas na sua empresa. Especialidades são rótulos opcionais que descrevem a expertise ou área de atuação de um guia (por exemplo, "Turismo de Aventura", "Histórico-Cultural", "Guia Bilíngue") e ficam disponíveis para vinculação no formulário de cadastro e edição de cada guia.

O administrador chega aqui quando precisa consultar quais especialidades já existem, montar/ampliar o catálogo de competências da sua empresa, reativar uma categoria desativada ou remover algo que caiu em desuso. Cada linha mostra o nome da especialidade, o ícone configurado, o status (Ativo/Inativo) e a contagem de guias vinculados.

Como usar

1. Vá em Configurações > Especialidades no sidebar para abrir a listagem.
2. Use a barra de filtros logo acima da lista para localizar o que precisa:
   • Buscar por nome... - campo de texto que filtra pelo nome (busca parcial, sem distinção de maiúsculas).
   • Status - restringe a lista a Ativos, Inativos ou Todos os status.
3. Para criar uma nova especialidade, clique no botão Nova Especialidade (FAB roxo no canto superior direito do cabeçalho).
4. Para gerenciar uma especialidade existente, abra o menu de ações (três pontos) ao final da linha desejada e escolha:
   • Editar - abre o formulário para alterar nome e ícone.
   • Ativar ou Desativar - alterna o status sem sair da listagem. Especialidades inativas continuam vinculadas aos guias existentes, mas não aparecem como opção em novos cadastros.
   • Excluir - abre uma confirmação. Se houver guias vinculados, o modal mostra os nomes deles (até 20 exibidos) antes de pedir a confirmação.

A listagem mostra 10 especialidades por página; quando há mais resultados, a paginação aparece no rodapé.

Casos especiais

Especialidade com guias vinculados

Ao tentar excluir, o sistema verifica quantos guias estão vinculados. Se houver vínculos, a exclusão padrão é bloqueada com a mensagem "Não é possível excluir uma especialidade que possui guias vinculados.". O modal de confirmação carrega os guias afetados (via endpoint linked-guias) e, se você confirmar a remoção forçada, o sistema desvincula automaticamente todos os guias e só então apaga a especialidade. O cadastro de cada guia permanece intacto - apenas o vínculo com aquela especialidade é removido.

Estado vazio (sem especialidades cadastradas)

Enquanto não existir nenhuma especialidade na sua empresa, a tela exibe o card vazio com ícone de capelo, o título "Nenhuma especialidade cadastrada" e o botão de atalho Cadastrar primeira especialidade, que leva direto para o formulário de criação.

Filtros combinados

Os filtros de busca e status funcionam em conjunto e a URL preserva os parâmetros (?busca=...&status=1). Isso permite compartilhar um link já filtrado ou voltar à listagem com os filtros aplicados após editar uma especialidade.

Ícone personalizado

Se a especialidade tem ícone configurado (FontAwesome), ele aparece no círculo roxo à esquerda do nome em vez do ícone padrão de capelo. O ícone é definido no formulário de cadastro/edição.

Erros comuns e como resolver

• "Não é possível excluir uma especialidade que possui guias vinculados." - Causa: a especialidade está vinculada a um ou mais guias e a exclusão simples foi recusada. Solução: confirme a remoção forçada no modal (que desvincula os guias automaticamente) ou abra cada guia vinculado e retire a especialidade do perfil antes de excluir.
• "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: solicite ao Proprietário ou Gerente que conceda o perfil adequado em Configurações > Cargos.
• A nova especialidade não aparece para os guias - Causa: a especialidade foi salva como Inativa. Solução: localize-a na listagem (filtro Status = Inativos) e use Ativar no menu de ações.

Onde encontrar

• URL: /admin/especialidades
• Caminho no menu: Configurações > Especialidades
• Permissão necessária: ver os guias (para ver), criar os guias (para cadastrar), editar os guias (para editar/ativar/desativar), excluir os guias (para excluir)
• Módulo necessário: nenhum

Veja também

• Guias - Cadastrar Especialidade
• Cadastrar Guia
• Lista de Guias
• Idiomas dos Guias