Mensagem de erro

Documentação Técnica do Sistema

1. Visão Geral e Autoria

O Comparador de Preços Inteligente é uma aplicação web de vanguarda criada e desenvolvida integralmente por Rendrix Oliveira para uso do Grupo Varejista. A ferramenta é um ecossistema complexo que cruza encartes de supermercado, analisa lógicas de retalho (pricing) e garante a competitividade máxima. Abaixo, detalhamos todos os recursos implementados no código.

2. Segurança e Autenticação

Login Restrito: Proteção de acesso com credenciais via Firebase Authentication (E-mail/Senha).
Identificação de Auditor: Captura do nome do utilizador num pop-up animado (Fade-In-Up) para personalização de relatórios.
Criptografia AES-256 (Zero-Knowledge): Implementação da biblioteca CryptoJS. Todas as imagens, PDFs e dados de sessão são criptografados localmente. O ficheiro não fica exposto em RAM e só é descriptografado no milissegundo de envio para a IA.
Blindagem de Sessão: O Firebase Auth combinado com o sessionStorage guarda dados de estado com segurança máxima.

3. Motor de Inteligência Artificial: MISTRAL®

Le Chat Free

Acesso a modelos IA de última geração.
Recuperação de até 500 memórias.
Geração de imagens.
Mais de 40 conectores corporativos.

Mistral Pro (Em uso)

Limites maiores e atmosfera Mistral Vibe.
Mais mensagens e pesquisas na web.
Raciocínio complexo (Chain of Thought).
Até 15 GB de armazenamento.
Suporte e Geração avançada.

Integração via API: Chamada POST direta ao endpoint pixtral-12b-2409 para análise multimodal (Visão Computacional + NLP).
Rotação de Chaves (Load Balancing): Matriz de chaves (API Keys) rotativas que previnem bloqueios de Rate Limit (Erro 429).
Retry com Exponential Backoff: Lógica que tenta reconectar automaticamente 5 vezes com intervalos crescentes caso a IA esteja sobrecarregada.
JSON Schema Estrito: A IA é forçada a responder num formato de dados perfeitamente estruturado para a tabela JavaScript.
Monitor de Status da IA: Verificação em tempo real (ping) da disponibilidade do motor Mistral (Online/Offline) com indicador visual constante no cabeçalho da aplicação.

4. Lógicas Avançadas de Retalho (O Cérebro)

Resumo Executivo (Insights): Geração de um parágrafo estratégico automático para a diretoria, indicando qual loja é mais agressiva e em que categorias.
Agressividade e Urgência (Sentimento): Analisa gatilhos mentais nas frases de chamariz ("Só hoje", "Limpa Estoque") e classifica a campanha (Baixa, Média, Alta).
Análise de Foco (Share of Voice): Identifica quais categorias recebem mais destaque visual ou espaço na folha do concorrente.
Auditoria Contra Tabela de Sistema: Modo exclusivo que confronta o encarte visual com um texto de tabela (Ex: ERP) e avisa se o preço impresso está errado.
Cálculo do Preço Real (Equivalência Matemática): Em caso de reduflação ou gramagens diferentes (ex: 400g vs 500g), a IA normaliza os preços calculando o custo exato por Kg, Litro ou Unidade, dando a vitória ao real mais barato.
Deteção de Falsas Promoções (Ancoragem): Calcula a matemática do "De/Por". Se a diferença entre o preço normal e a promoção for de 5% ou menos, aplica um alerta de "Falsa Promo".
Identificação de Venda Casada (Combo): Avisa se a promoção exige a compra de um item diferente (Cross-selling), mascarando o preço isolado.
Categorização Multinível (Árvore): Os produtos não são apenas agrupados, mas sim dispostos em Categoria > Subcategoria (ex: Bebidas > Cervejas Premium).
Descrições Independentes: Extrai a transcrição exata e isolada do produto na Loja 1 e na Loja 2, em vez de assumir um título genérico.
Letras Miúdas e Validades: Lê textos minúsculos, limites de compra ("Máx 2 un") ou avisos de validade curta e destaca-os na tabela.
Deteção de Marca Própria (Private Label): Identifica automaticamente se o produto pertence à marca de distribuição do concorrente.
Captura de Mecânicas: Separa o preço normal do preço "Clube" e identifica condições ("Leve 3 Pague 2").
Ordenação e Filtro Anti-Duplicação: Ordena a tabela pela maior margem de poupança (%), removendo duplicados da mesma campanha.

5. Interface, Usabilidade e Tratamento Gráfico

Design Responsivo: Construído com Tailwind CSS para adaptação total entre Mobile, Tablet e Desktop.
Múltiplos Modos de Utilização (Tabs): "Nossa Loja vs Concorrente", "Entre Lojas" e "Radar Concorrentes" (central de links diretos).
Relógio e Saudação Dinâmica: O cabeçalho verifica a hora do navegador para saudar o utilizador (Bom dia/tarde/noite) e mostra data/hora em tempo real.
Zona Drag-and-Drop: Áreas interativas que aceitam arrastar ficheiros ou abrir o explorador de sistemas com indicadores visuais (`drop-zone.active`).
Integração Nativa com Câmara: Botão dedicado que aciona a lente traseira de telemóveis/tablets (`capture="environment"`).
Conversão Local de PDF (PDF.js): Converte ficheiros PDF pesados em imagens diretamente no navegador do utilizador sem envio para servidores terceiros, incluindo suporte de cores CMaps para evitar falhas CMYK.
Otimização e Compressão Inteligente: As imagens são redimensionadas no cliente via HTML5 Canvas (limite de 2000px, Qualidade JPEG 80%) poupando banda e acelerando o processamento.
Alertas de Baixa Resolução: Se a imagem original tiver menos de 1000px, o sistema avisa que a IA pode ter dificuldade em ler preços miúdos.
Barra de Progresso Dinâmica: Feedback visual com mensagens sequenciais ("A mapear fronteiras", "A calcular preço real...") para entreter e informar o utilizador durante o processamento longo.
Lightbox / Zoom Modal: Permite ao utilizador clicar nas miniaturas antes de enviar para garantir a legibilidade do encarte.
Pesquisa Dinâmica (Filtro): Barra de pesquisa na tabela que oculta linhas instantaneamente via manipulação do DOM.
Toasts Flutuantes: Sistema de notificações efêmeras, coloridas (sucesso/erro), que surgem e desaparecem suavemente.

6. Motores de Exportação e Integração

Formatador WhatsApp: API URI que constrói um relatório estruturado com Emojis, Ranking das 10 melhores ofertas, alertas de venda casada, cálculos de reduflação, insights e links.
Exportador de CSV (Excel): Criação de um blob de dados em tempo real. Trata caracteres especiais, decodifica colunas extra (Subcategoria, Preço Real, Falsa Promo) e gera o download nativo via JS.
Gerador de PDF Automático: Utiliza o html2pdf.js com lógica especializada que congela o scroll, remove limites de overflow, tira uma fotografia panorâmica da página em formato A4 Paisagem, e restaura o layout, gerando relatórios corporativos imaculados.
Webhook N8N (API Logging): Dispara os dados estruturados de forma silenciosa para o endpoint http://n8n.rendrix.com.br/webhook/comparacao-precos, permitindo a construção de Dashboards corporativos (BI) ou automações na retaguarda.
Nova Análise (Soft Reset): Limpeza instantânea das variáveis de estado (cache) via JS, rolando a tela ao topo, sem precisar de forçar F5 na página.

Desenvolvido por Rendrix Oliveira • Documentação Técnica Integral do Sistema • V 4.2.0 Complete Edition

Como usar o Sistema (por Rendrix Oliveira)

Bem-vindo(a) ao Comparador de Preços Inteligente (Versão 4.2)! Siga este guia atualizado pelo criador da ferramenta, Rendrix Oliveira, para dominar todas as funcionalidades da Inteligência Artificial:

Escolha o Modo de Análise

Selecione "Nossa Loja vs Concorrente" para benchmarking externo (com análise de Agressividade). Escolha "Entre Lojas" para auditoria interna, onde pode colar a sua Tabela de Preços do sistema.

Carregue os Dados e Valide

Arraste imagens ou PDFs para as caixas. Pode clicar na miniatura gerada para abrir o Visualizador (Zoom) e validar a nitidez. Se usar "Entre Lojas", cole a tabela de referência na caixa de texto.

Inicie a IA e Aguarde

Clique em "Realizar Comparação IA". Acompanhe a Barra de Progresso Dinâmica enquanto o sistema identifica Letras Miúdas, Vendas Casadas e calcula os Preços Reais.

Interprete Insights e Exporte

Leia os cartões superiores para o Resumo Executivo e Foco da Campanha. Na tabela, analise os alertas de Falsa Promoção e compare o Custo por Kg/Litro. Finalmente, exporte para WhatsApp, PDF ou Excel e clique em Nova Análise para reiniciar!

Desenvolvido por Rendrix Oliveira. Dúvidas técnicas? Consulte a Documentação do Sistema no outro botão.

Comparador de Preços da Rede

Compare ofertas usando a Inteligência Artificial Mistral

Encriptação AES-256 Ativa

Motor IA: A verificar...

--:--:--

--/--/----

BOM DIA,

Convidado

Nossa Loja (Base)

Arraste a imagem ou PDF ou clique

Concorrente

Arraste a imagem ou PDF ou clique

Auditoria de Preços (Tabela do Sistema)

Cole a tabela de preços do seu sistema abaixo. A IA fará a auditoria para validar se os valores no encarte estão corretos.

Central de Encartes: Concorrentes

Aceda rapidamente aos tabloides digitais dos seus concorrentes. Clique numa das lojas abaixo para abrir as ofertas num novo separador.

A preparar o ambiente de auditoria...

Itens Comparados

Mais Barato L1

Mais Barato L2

Poupança Max. Total

R$ 0,00

Resumo Executivo

Foco da Campanha

Agressividade (Urgência)

Relatório de Oportunidades

Produto / Categoria / Medida	Loja 1		Loja 2		Vantagem & Poupança
Ordenado pelo maior desconto (%)	Normal	Promoção	Normal	Promoção

Dica Pro: A lista acima foi ordenada automaticamente. As ofertas com a maior margem de poupança (em %) aparecem no topo. Verifique os alertas visuais vermelhos caso a IA detete divergências de peso no mesmo produto.

2026 - Rendrix Oliveira - Depto. Mkt on/off - Grupo Varejista

Painel Master (xfullstore)

Gira os utilizadores do sistema, bloqueie acessos ou adicione novas contas diretamente.

Utilizador	Cargo	Estado	Ações

Comparador IA

Bem-vindo(a)!

Tempo Esgotado