Objetivo
Medir, com transparência e custo controlado, se uma bonificação concedida ao cliente resultou em compra. O resultado vira insight comercial automático para a tomada de decisão futura.
Estratégia em 2 camadas
O sistema combina algoritmo determinístico (rápido, gratuito, factual) com IA Gemini (caro, contextual). Cada um faz só o que faz melhor:
| Camada | O que faz | Custo |
|---|
| Algoritmo |
Decide o status (gerou compra ou não) cruzando bonificação × pedidos do Bling |
Grátis (consulta MongoDB) |
| IA Gemini |
Gera o texto explicativo: correlação de itens, padrão histórico, insight comercial |
Pago — só é chamada quando necessário |
Como o algoritmo decide
- A partir da data em que a bonificação foi aprovada/entregue, abre uma janela de 90 dias.
- Busca todos os pedidos do mesmo cliente no Bling dentro desse período.
- Se há pedido → marca ✓ Gerou compra com data, valor e itens correspondentes.
- Se a janela fechou sem pedido → marca — Sem conversão.
- Se a janela ainda está aberta → mantém Aguardando.
- Se faltam dados (cliente sem vínculo Bling, etc) → marca ? Inconclusivo.
Quando a IA é usada (e quando não é)
| Situação | IA roda? |
|---|
| Status mudou (ex: aguardando → gerou compra) |
✅ Sim, 1 vez só |
| Status não mudou (continua aguardando) |
❌ Não — só atualiza data da última análise |
| Status final já gravado (gerou compra / sem conversão) |
❌ Não — pula totalmente |
| Admin clica "Re-analisar feedback (IA)" no modal |
✅ Sim — força regeneração do texto |
💰 Economia: em uso normal, ~95% das execuções não chamam IA. O batch noturno mostra no log llmCalls vs skipados.
Quando a análise roda
- Automática (todo dia): Step 9/9 do nightly sync às 5h da manhã (produção). Roda após pedidos serem sincronizados, então captura conversões do dia anterior.
- Sob demanda (admin): botão "Analisar feedbacks (IA)" no topo desta tela — útil pra ver resultados sem esperar o nightly.
- Pontual (admin): botão "Re-analisar feedback (IA)" dentro do modal de uma bonificação específica — para forçar nova análise individual.
Confiança
Cada análise traz um valor de confiança (0–100%):
- 90% — gerou compra com itens da bonificação no pedido (correlação direta).
- 65% — gerou compra mas sem os itens da bonificação (compra de outro produto).
- 85% — sem conversão, janela fechou.
- 30% — aguardando (janela ainda aberta).
- 20% — inconclusivo (cliente sem vínculo Bling, etc).
Configurações
- Janela de análise: 90 dias (configurável via
BONIFICACOES_JANELA_DIAS no servidor).
- Modelo de IA: Google Gemini (configurável via
GOOGLE_AI_MODEL).
- Caso a IA falhe (rede, quota), o sistema gera texto canônico baseado nos dados — nunca trava.