Manual do Sistema

🏠 Visão Geral

A Matriz de Produtos Omega Light é uma plataforma interna para filtrar, comparar, ranquear e analisar o catálogo de luminárias. Com ela você:

• Localiza produtos por qualquer combinação de especificação técnica
• Encontra produtos similares a um código de referência
• Gera uma matriz comparativa lado a lado entre produtos
• Ranqueia produtos por cenário técnico (potência, eficiência, IP, IK, UGR, sensor)
• Pesquisa e compara produtos de concorrentes
• Exporta relatórios em PDF e imagem

🔑 Acesso ao Sistema

Login

1. Na tela inicial, informe seu Login e Senha no quadro central.
2. Clique em Entrar. Se as credenciais estiverem corretas, você acessa o sistema.
3. Em caso de erro, a mensagem "Usuário ou senha inválidos" será exibida.

Logout

Clique no botão Sair (vermelho) ao lado do seu nome no cabeçalho para encerrar a sessão.

Trocar Senha

1. Clique no botão com seu nome (@usuario) no cabeçalho.
2. No menu que aparece, selecione Trocar senha.
3. Preencha a senha atual, a nova senha e a confirmação.
4. Clique em Salvar.

🖥️ Interface Principal

Cabeçalho

Estatísticas

Abaixo do cabeçalho aparecem 4 contadores em tempo real:

• Total linhas — total de registros na planilha
• Filtrados — quantos produtos passam pelos filtros ativos
• Famílias — quantidade de famílias distintas na base
• Códigos únicos — quantidade de códigos de produto únicos

Abas principais

O sistema possui até 4 abas, exibidas conforme as permissões do usuário:

⚡ Filtros Rápidos

Na aba Operação, você verá uma grade com os principais campos de filtro listados como botões grandes. Clicar em qualquer um abre diretamente o campo correspondente nos filtros avançados para edição.

Filtros disponíveis nos botões rápidos:

• Nome, Família, Aplicação, Ótica, Distribuição, Formato, Fonte de luz
• Potência (W), Facho (°), Fluxo luminoso (lm), Intensidade luminosa (cd)
• Eficiência (lm/W), IP, UGR, CCT, CRI, Vida útil (h)
• Composição, Busca geral, Código de referência

🔧 Filtros Avançados

Clique em "Mais filtros" para expandir o painel completo de filtros. Os resultados são atualizados automaticamente após uma breve pausa enquanto você digita.

Filtros de texto e seleção

Filtros numéricos (por alvo ±%)

Para campos numéricos como potência e eficiência, o sistema aceita um valor alvo e retorna produtos dentro de uma tolerância percentual:

Filtro de Equipamento Auxiliar

O checkbox "Equipamento auxiliar" quando marcado filtra apenas produtos que possuem algum equipamento auxiliar (sensores PIR, MWS, Zhaga, DALI, etc.).

⭐ Sistema de Prioridades

Cada campo de filtro avançado possui um checkbox "Prioritário". Quando marcado, esse critério recebe maior peso no score de relevância dos resultados.

Produtos que atendem melhor aos critérios prioritários aparecem primeiro na lista, mesmo que tecnicamente outros produtos também passem pelos filtros.

Os filtros prioritários ativos aparecem como chips escuros na área "Filtros Aplicados".

🏷️ Filtros Aplicados

A área "Filtros Aplicados" mostra chips com todos os filtros ativos no momento. Cada chip exibe o nome do campo e o valor selecionado.

• Clique no × dentro de um chip para remover aquele filtro individualmente.
• Chips de cor escura representam filtros marcados como Prioritários.
• Clique em "Limpar filtros" para remover todos de uma vez.

🔍 Análise de Similaridade

O modo Similaridade encontra os produtos mais parecidos com um produto de referência, usando um algoritmo de pontuação multi-critério.

Como usar

1. No cabeçalho, clique em "Similaridade" ou use o filtro rápido "Código de referência".
2. Digite o código exato do produto de referência (ex: EM.0357.1.LED).
3. O sistema exibirá o produto âncora e os mais similares, ordenados por score.
4. Use o campo "Qtd. similares" para ajustar entre 1 e 50 resultados.

Critérios de similaridade

Coluna "Motivos"

Cada produto similar mostra até 4 razões pelas quais foi considerado similar (ex: "mesma família", "potência semelhante", "IP semelhante").

Botão "Encontrar similares"

Nos resultados de qualquer listagem, cada produto tem um botão "Encontrar similares" que preenche automaticamente o campo de referência com aquele código.

📊 Matriz de Produtos

O modo Matriz exibe uma tabela comparativa com múltiplos produtos lado a lado, com todas as especificações técnicas alinhadas em colunas.

Como adicionar produtos ao comparativo

1. Aplique os filtros desejados para encontrar os produtos.
2. Na tabela de resultados, clique em "Preview" em cada produto que deseja comparar.
3. O produto é adicionado ao painel de comparativo automaticamente.

Controles do comparativo

Código de cores

• Verde — melhor valor entre os produtos comparados
• Amarelo — valor intermediário
• Vermelho — valor menos favorável

🏆 Ranking por Cenário

O Ranking calcula um score de 0–100 para cada produto filtrado com base em um cenário técnico definido por você. Os 15 melhores são exibidos automaticamente no topo.

Cenário técnico

Pesos do score

Ajuste a importância relativa de cada critério (os valores somam 100 por convenção, mas podem ser qualquer número positivo):

• Peso Potência — importância da proximidade com a potência alvo
• Peso Eficiência — importância da eficiência luminosa
• Peso UGR — importância do conforto visual
• Peso IP — importância da proteção
• Peso IK — importância da resistência a impacto
• Peso Sensor — importância da presença de sensor

📁 Perfis e Presets

Os Perfis de Projeto são configurações pré-definidas de cenário e pesos que você pode selecionar para agilizar análises recorrentes.

Perfis nativos

Salvar um Preset personalizado

1. Configure o cenário e os pesos desejados na aba Configuração.
2. No campo "Nome do preset", dê um nome descritivo.
3. Opcionalmente, adicione uma descrição.
4. Clique em "Salvar como Preset".

O preset fica disponível no seletor de perfis em todas as sessões. Para excluir, use o campo "Excluir preset salvo" e clique em "Excluir Preset".

📤 Exportar PDF e Imagem

Download como Imagem (PNG)

1. Monte o comparativo desejado na Matriz de Produtos.
2. Clique em "Download imagem" na barra de ferramentas.
3. Um arquivo PNG da tabela comparativa é gerado e baixado automaticamente.

Download como PDF

1. Monte o comparativo desejado na Matriz de Produtos.
2. Clique em "Download PDF" na barra de ferramentas.
3. Um arquivo PDF com o comparativo e cabeçalho da Omega Light é gerado.

Relatório PDF de Ranking

1. Configure um cenário técnico com ao menos um critério preenchido.
2. Aguarde o ranking ser gerado.
3. O botão de exportação PDF (rota /export/pdf) gera um relatório com os top 30 produtos ranqueados, incluindo data, perfil, critérios e pesos utilizados.

🌐 Concorrentes

A aba Concorrentes permite pesquisar produtos de fornecedores externos e compará-los diretamente com produtos do catálogo interno.

Login na busca externa

O acesso requer credenciais específicas (configuradas na aba Configuração). Informe usuário e senha para ativar a busca.

Buscar produto concorrente

1. Os filtros ativos na aba Operação geram automaticamente uma query de busca sugerida.
2. Clique em um dos links de busca (Studioluce, New Line, Accord, etc.) para abrir a busca no Google filtrada por aquele domínio.
3. Copie a URL do produto encontrado.
4. Cole no campo "URL do produto concorrente".
5. O sistema faz a leitura automática das especificações da página.

Dados manuais

Se a leitura automática falhar (site com proteção ou layout não reconhecido), use os campos manuais para inserir as especificações diretamente. Ative "Forçar dados manuais" para sobrescrever os dados automáticos.

Comparativo

Informe um Código interno para comparar e o sistema gera uma tabela lado a lado mostrando as diferenças entre o produto concorrente e o produto Omega escolhido.

Fontes disponíveis

• Studioluce, New Line, Accord Iluminação, Bella Iluminação
• Stella, Blumenau Iluminação, Gaya, Ourolux

⚙️ Configuração

A aba Configuração é visível para usuários com permissão configuracao e reúne as configurações avançadas do sistema.

Configurar busca externa

Estrutura de uma fonte (JSON)

[
  {
    "key": "minhafonte",
    "label": "Minha Fonte",
    "domain": "minhafonte.com.br",
    "search_url": "https://www.google.com/search?q=site:minhafonte.com.br+{query}"
  }
]

O marcador {query} é substituído automaticamente pelos termos dos filtros ativos.

👥 Gerenciar Usuários

Usuários com permissão manage_users podem criar, editar e excluir contas de acesso.

Criar ou editar usuário

1. Na aba Configuração, localize a seção "Usuários e permissões".
2. Preencha Login, Nome de exibição e Senha.
3. Selecione as permissões desejadas para o usuário.
4. Clique em "Salvar usuário".

Excluir usuário

1. Selecione o usuário no campo "Excluir usuário".
2. Clique em "Excluir usuário".

🔒 Permissões

Cada usuário tem um conjunto de permissões que determina quais abas e funcionalidades estão disponíveis:

💡 Dicas e Atalhos

Fluxo recomendado para encontrar produtos

1. Defina a Família se souber — reduz drasticamente os resultados.
2. Adicione Potência e IP como filtros numéricos.
3. Se precisar da melhor opção técnica, configure o Cenário e deixe o Ranking trabalhar.
4. Com os candidatos em mãos, adicione os melhores ao Preview para o comparativo final.
5. Exporte como PDF ou Imagem para a apresentação.

Atalhos de teclado

Boas práticas

• Combine filtros de seleção (família, distribuição) com filtros numéricos para resultados mais precisos.
• Use Busca geral quando não souber o nome exato — ela vasculha código, nome, família e aplicação ao mesmo tempo.
• Ao comparar concorrentes, preencha o código interno de um produto similar para ver a diferença diretamente.
• O tema escuro é salvo automaticamente no navegador — cada usuário pode ter sua preferência sem afetar os outros.
• Presets de cenário são compartilhados entre todos os usuários. Nomeie-os de forma clara.
• A estatística "Filtrados" no cabeçalho atualiza em tempo real conforme você digita — use-a para calibrar seus filtros antes de submeter.

📋 Referência: Todos os Campos

Lista completa de todos os campos da base de produtos lidos da planilha produtos.xlsx: