Meilisearch - Gestão de Índice de Busca
Bem-vindo ao guia de Meilisearch do CMS E-commerce! Este manual irá ajudá-lo a configurar e gerenciar o sistema de busca de produtos da plataforma.
Visão Geral
A tela de Meilisearch permite que você:
- 🔍 Indexe produtos do sistema no motor de busca Meilisearch
- ⚙️ Configure filtros e atributos de busca para otimizar a pesquisa
- 🔄 Sincronize dados entre o sistema e o serviço de busca
- ⚡ Garanta buscas rápidas e eficientes para os usuários finais
O Meilisearch é um motor de busca de alta performance que permite aos clientes encontrarem produtos rapidamente através de buscas inteligentes e filtros personalizados.
Acessando a Tela de Meilisearch
A tela de Meilisearch está localizada no menu de Administração do sistema. Ao acessá-la, você verá:
- Título "Meilisearch"
- Dois cards principais com ações disponíveis
- Descrição de cada funcionalidade
O que é Meilisearch?
O Meilisearch é um serviço de busca open-source que oferece:
- Busca ultrarápida: Resultados em milissegundos
- Tolerância a erros: Encontra resultados mesmo com erros de digitação
- Busca por relevância: Ordena resultados pelos mais relevantes
- Filtros personalizados: Permite filtrar por categorias, preços, atributos, etc.
Este serviço melhora significativamente a experiência de busca dos clientes na loja online.
Funcionalidades Disponíveis
1. Indexar Produtos
A indexação de produtos é o processo de enviar todos os dados de produtos do sistema para o Meilisearch, permitindo que sejam encontrados através da busca.
O que é Indexação?
Quando você indexa produtos:
- Todos os produtos ativos do sistema são enviados ao Meilisearch
- As informações incluem: nome, descrição, preço, categorias, atributos, etc.
- Os dados são organizados de forma otimizada para busca rápida
- Produtos anteriormente indexados são atualizados
Quando Indexar Produtos?
Você deve indexar produtos nas seguintes situações:
- Primeira configuração: Ao implementar o Meilisearch pela primeira vez
- Mudanças em massa: Após importar ou atualizar muitos produtos
- Dados desatualizados: Se a busca não mostra produtos recentes
- Problemas de sincronização: Quando produtos não aparecem na busca
Como Indexar Produtos
Passo a Passo:
- Certifique-se de que você tem permissão para inserir dados no Meilisearch
- Na tela de Meilisearch, localize o card "Indexar Produtos"
- Clique no botão "Indexar Produtos"
- Aguarde o processo de indexação (você verá "Indexando produtos...")
- Quando concluído, uma mensagem de sucesso será exibida
Durante a indexação, não feche a página ou execute outras ações no Meilisearch. O processo pode levar alguns minutos dependendo da quantidade de produtos.
O que acontece durante a indexação?
- Coleta de dados: O sistema busca todos os produtos disponíveis
- Preparação: Os dados são formatados para o Meilisearch
- Envio: Produtos são enviados ao serviço de busca
- Confirmação: O Meilisearch confirma o recebimento e processamento
Tempo estimado:
- Menos de 100 produtos: Alguns segundos
- 100 a 1.000 produtos: 1 a 3 minutos
- Mais de 1.000 produtos: 3 a 10 minutos
Recomendamos fazer a indexação em horários de baixo movimento da loja para evitar impacto na experiência dos clientes.
2. Configurar Filtros
A configuração de filtros define quais atributos dos produtos podem ser usados para refinar buscas na loja online.
O que são Filtros de Busca?
Filtros permitem que os clientes refinem suas buscas por:
- Categorias: Eletrônicos, Roupas, Acessórios, etc.
- Faixas de preço: R$ 0-50, R$ 50-100, etc.
- Marcas: Samsung, Apple, Nike, etc.
- Atributos: Cor, tamanho, material, etc.
- Disponibilidade: Em estoque, promoção, novidades, etc.
Quando Configurar Filtros?
Você deve configurar filtros nas seguintes situações:
- Primeira implementação: Ao configurar o Meilisearch pela primeira vez
- Novos atributos: Quando adicionar novas categorias ou características de produtos
- Mudanças no catálogo: Ao alterar a estrutura de produtos
- Otimização de busca: Para melhorar a experiência de navegação
- Após indexação inicial: Sempre configure filtros após indexar produtos pela primeira vez
Como Configurar Filtros
Passo a Passo:
- Certifique-se de que você tem permissão para inserir dados no Meilisearch
- Na tela de Meilisearch, localize o card "Configurar Filtros"
- Clique no botão "Configurar Filtros"
- Aguarde a configuração (você verá "Configurando filtros...")
- Quando concluído, uma mensagem de sucesso será exibida
O que acontece durante a configuração?
- Identificação: O sistema identifica todos os atributos filtráveis dos produtos
- Definição: Os atributos são marcados como filtráveis no Meilisearch
- Otimização: O índice de busca é otimizado para suportar filtros
- Confirmação: O Meilisearch confirma que os filtros estão ativos
Atributos configurados automaticamente:
- Categorias de produtos
- Faixas de preço
- Status de disponibilidade
- Marcas e fabricantes
- Características personalizadas
A configuração de filtros é rápida e geralmente leva apenas alguns segundos, independentemente do número de produtos.
Fluxo de Trabalho Recomendado
Para garantir o melhor funcionamento do sistema de busca, siga este fluxo:
Manutenção Regular
- Atualizações automáticas: As atualizações são feitas a cada 30 minutos automáticamente, mas caso haja uma nova alteração em produtos e você deseje a autualização instantânea, será necessário forçar a indexação.
- Quando necessário: Configurar filtros (após adicionar novos atributos)
Após Grandes Mudanças
Se você fez alterações significativas no catálogo:
- Indexar Produtos: Para atualizar todos os dados
- Configurar Filtros: Para incluir novos atributos
- Testar: Verificar se tudo funciona corretamente
Permissões Necessárias
Para executar ações no Meilisearch, você precisa ter:
- Acesso à aplicação Meilisearch: Permissão básica de visualização
- Permissão de inserção: Necessária para indexar produtos e configurar filtros
Se você não vê os botões "Indexar Produtos" ou "Configurar Filtros", entre em contato com um administrador para solicitar as permissões necessárias.
Estados dos Botões
Os botões na tela podem ter três estados:
1. Normal (Disponível)
O botão está azul ou cinza e pode ser clicado:
- Indexar Produtos: Botão azul com ícone de banco de dados
- Configurar Filtros: Botão cinza com ícone de filtro
2. Em Processamento
O botão mostra um ícone de carregamento girando:
- Texto muda para "Indexando produtos..." ou "Configurando filtros..."
- Botão fica desabilitado temporariamente
- Aguarde a conclusão antes de executar outras ações
3. Desabilitado
O botão fica acinzentado e não pode ser clicado quando:
- Outro processo está em andamento: Não é possível indexar e configurar ao mesmo tempo
- Falta de permissão: Você não tem acesso para executar a ação
- Sistema ocupado: Aguarde o processo atual terminar
Casos de Uso Práticos
1. Produtos Novos Não Aparecem na Busca
Situação: Você adicionou novos produtos, mas eles não aparecem na busca da loja.
Solução:
- Acesse a tela de Meilisearch
- Clique em "Indexar Produtos"
- Aguarde a conclusão
- Teste a busca novamente na loja
2. Filtros Não Funcionam Corretamente
Situação: Os clientes não conseguem filtrar produtos por categoria ou preço.
Solução:
- Acesse a tela de Meilisearch
- Clique em "Configurar Filtros"
- Aguarde a conclusão
- Teste os filtros na loja
3. Implementação Inicial do Sistema de Busca
Situação: Você está configurando o Meilisearch pela primeira vez.
Solução:
- Clique em "Indexar Produtos" e aguarde
- Após concluir, clique em "Configurar Filtros"
- Teste a busca e os filtros na loja online
- Verifique se todos os produtos aparecem corretamente
4. Importação em Massa de Produtos
Situação: Você importou 500 novos produtos via planilha.
Solução:
- Após a importação, acesse a tela de Meilisearch
- Clique em "Indexar Produtos" para sincronizar
- Se adicionou novos atributos, clique em "Configurar Filtros"
- Verifique se os novos produtos aparecem na busca
5. Busca Retorna Resultados Desatualizados
Situação: Produtos com informações desatualizadas aparecem na busca.
Solução:
- Acesse a tela de Meilisearch
- Clique em "Indexar Produtos" para atualizar todos os dados
- Aguarde a conclusão
- Os dados atualizados devem aparecer na busca
Problemas Comuns e Soluções
❌ Erro ao Indexar Produtos
Problema: O processo de indexação falha ou exibe erro.
Possíveis Causas:
- Conexão com o Meilisearch está indisponível
- Produtos com dados inválidos ou incompletos
- Timeout por excesso de produtos
Soluções:
- Verifique sua conexão com a internet
- Entre em contato com o suporte técnico
- Informe o horário e a mensagem de erro exibida
❌ Erro ao Configurar Filtros
Problema: A configuração de filtros não funciona.
Possíveis Causas:
- Produtos não foram indexados ainda
- Conexão com o Meilisearch está indisponível
- Erro na estrutura de atributos
Soluções:
- Primeiro execute "Indexar Produtos"
- Depois execute "Configurar Filtros"
- Se o problema persistir, contate o suporte
❌ Botões Estão Desabilitados
Problema: Não consigo clicar nos botões de ação.
Possíveis Causas:
- Falta de permissão
- Outro processo está em andamento
- Sistema temporariamente indisponível
Soluções:
- Aguarde se houver processo em andamento
- Verifique suas permissões com um administrador
- Tente recarregar a página
- Se persistir, contate o suporte
❌ Produtos Duplicados na Busca
Problema: O mesmo produto aparece várias vezes nos resultados.
Possíveis Causas:
- Múltiplas indexações sem limpeza prévia
- Dados duplicados no sistema
Soluções:
- Indexar produtos novamente (a indexação substitui dados antigos)
- Se persistir, contate o suporte técnico para investigação
❌ Busca Muito Lenta
Problema: A busca na loja demora muito para retornar resultados.
Possíveis Causas:
- Índice muito grande sem otimização
- Configuração de filtros desatualizada
- Problema de infraestrutura
Soluções:
- Execute "Configurar Filtros" para otimizar
- Verifique com a equipe técnica o status do servidor Meilisearch
- Monitore logs de performance no sistema
Entendendo Mensagens do Sistema
Mensagens de Sucesso
✅ "Produtos indexados com sucesso"
O que significa: Todos os produtos foram enviados e processados pelo Meilisearch.
O que fazer: Nada! Você pode agora testar a busca na loja.
✅ "Filtros configurados com sucesso"
O que significa: Os atributos filtráveis foram definidos corretamente no Meilisearch.
O que fazer: Teste os filtros na loja para garantir que funcionam.
Mensagens de Erro
❌ "Erro ao indexar produtos"
O que significa: Houve um problema ao enviar produtos ao Meilisearch.
O que fazer:
- Anote o horário do erro
- Tente novamente após alguns minutos
- Se persistir, contate o suporte com detalhes
❌ "Erro ao configurar filtros"
O que significa: A configuração de filtros não pôde ser aplicada.
O que fazer:
- Verifique se os produtos foram indexados
- Tente executar "Indexar Produtos" primeiro
- Depois tente "Configurar Filtros" novamente
🚫 "Você não tem permissão para executar esta ação"
O que significa: Seu usuário não possui permissão de inserção no Meilisearch.
O que fazer:
- Entre em contato com um administrador
- Solicite permissão de inserção para a aplicação Meilisearch
- Aguarde a concessão de acesso
Boas Práticas
🔄 Sincronização Regular
- Estabeleça uma rotina: Indexe produtos semanalmente ou após grandes mudanças
- Monitore resultados: Teste a busca regularmente para garantir que está atualizada
- Documente mudanças: Anote quando fez indexações para rastrear atualizações
⚡ Otimização de Performance
- Configure filtros após indexação: Sempre execute filtros após indexar produtos
- Evite múltiplas indexações simultâneas: Aguarde uma indexação terminar antes de iniciar outra
- Indexe em horários de baixo movimento: Prefira madrugada ou horários com pouco acesso
🔒 Segurança e Controle
- Limite permissões: Apenas usuários autorizados devem poder indexar produtos
- Monitore ações: Verifique os logs de auditoria para rastrear indexações
- Teste antes de confirmar: Sempre teste a busca após fazer mudanças
📊 Monitoramento
- Verifique logs de auditoria: Confira se as indexações foram bem-sucedidas
- Acompanhe tempo de resposta: Buscas devem retornar resultados em menos de 1 segundo
- Teste diferentes termos: Busque por produtos variados para garantir cobertura completa
Perguntas Frequentes (FAQ)
Com que frequência devo indexar produtos?
Quando for necessário que uma alteração reflita imediatamente, a atualização pode ser acionada manualmente. Caso contrário, o sistema realiza atualizações automáticas a cada 30 minutos.
Posso desfazer uma indexação?
Não. A indexação substitui os dados anteriores. Porém, você pode reindexar novamente se necessário.
Os produtos precisam estar ativos para serem indexados?
Sim. Apenas produtos ativos e disponíveis são indexados no Meilisearch.
O que acontece se eu indexar produtos duas vezes?
Não há problema. A segunda indexação simplesmente atualiza os dados da primeira. Produtos não são duplicados.
Preciso configurar filtros toda vez que indexo?
Não. Geralmente você configura filtros apenas:
- Na primeira implementação
- Quando adiciona novos atributos ao catálogo
- Quando muda a estrutura de categorias
A indexação afeta a loja online?
Não durante o processo. Porém, até a indexação terminar, produtos novos podem não aparecer na busca.
Quanto tempo os dados levam para aparecer na busca?
Após a indexação bem-sucedida, os dados aparecem quase instantaneamente (segundos).
Posso cancelar uma indexação em andamento?
Não é recomendado fechar a página durante a indexação. Se necessário, você pode reindexar depois.
Glossário
| Termo | Significado |
|---|---|
| Meilisearch | Motor de busca open-source de alta performance |
| Indexação | Processo de enviar dados de produtos ao serviço de busca |
| Índice | Estrutura de dados otimizada para buscas rápidas |
| Filtros | Atributos que permitem refinar resultados de busca |
| Atributos | Características dos produtos (cor, tamanho, categoria, etc.) |
| Sincronização | Processo de manter dados do sistema e Meilisearch atualizados |
| Motor de busca | Software responsável por encontrar e ordenar resultados de busca |
| Tolerância a erros | Capacidade de encontrar resultados mesmo com erros de digitação |
Monitoramento e Auditoria
Como Rastrear Indexações
Todas as ações de indexação e configuração são registradas no sistema de auditoria:
- Acesse Administração > Auditoria de Logs
- Busque por "meilisearch" ou filtre pelo endpoint
/api/v1/cms/meilisearch - Veja histórico de indexações e configurações
- Identifique quem executou cada ação e quando
Informações Disponíveis nos Logs
- Data e hora da indexação/configuração
- Usuário que executou a ação
- Duração do processo
- Status (sucesso ou erro)
- Detalhes técnicos da requisição
Integração com Outras Funcionalidades
Relação com Catálogo de Produtos
O Meilisearch está diretamente conectado ao catálogo:
- Produtos cadastrados: Apenas produtos ativos são indexados
- Novos atributos: Requer reconfiguração de filtros
- Exclusão de produtos: Produtos deletados saem do índice na próxima indexação
Relação com a Loja Online
A busca da loja depende do Meilisearch:
- Barra de busca: Usa o Meilisearch para encontrar produtos
- Filtros laterais: Baseados nos atributos configurados
- Sugestões: Aparecem conforme o cliente digita
- Ordenação por relevância: Controlada pelo Meilisearch
Suporte
Precisa de Ajuda?
Se você encontrou algum problema ou tem dúvidas:
- Verifique este manual para soluções comuns
- Consulte a seção de Problemas Comuns acima
- Entre em contato com o suporte técnico com as seguintes informações:
- Print da tela ou mensagem de erro
- O que você estava tentando fazer
- Horário aproximado do problema
- Número aproximado de produtos no sistema
Informações Úteis ao Contatar o Suporte
Tenha em mãos:
- Seu nome de usuário
- Aplicação: "Meilisearch"
- Ação que tentou executar (indexar ou configurar)
- Mensagem de erro completa (se houver)
- Quantidade aproximada de produtos no sistema
Recursos Adicionais
Atalhos e Dicas Rápidas
- Indexação rápida: Clique em "Indexar Produtos" após mudanças importantes
- Teste sempre: Busque produtos na loja após indexar
- Monitore logs: Use a auditoria para verificar sucesso das operações
Checklist de Manutenção Mensal
- Indexar todos os produtos
- Configurar filtros (se houver novos atributos)
- Testar busca na loja online
- Verificar tempo de resposta das buscas
- Revisar logs de erros no sistema de auditoria
Próximos Passos
Após dominar o gerenciamento do Meilisearch, você pode:
- 📊 Analisar performance: Monitore velocidade de busca e relevância dos resultados
- 🔍 Otimizar catálogo: Organize produtos para melhores resultados de busca
- 📈 Acompanhar métricas: Veja quais termos os clientes mais buscam
- 🎯 Personalizar: Trabalhe com a equipe técnica para ajustes avançados
Bom uso do sistema de busca! 🚀