# Metodologia RFV — faixas, pontuação, edge cases e integração

## Índice
1. Origem e por que funciona
2. Notas 1-5: quintil vs faixa fixa
3. Faixas por ticket (referência das usadas no script)
4. Ponderação das notas
5. Edge cases e armadilhas
6. Variações (RFM-E, RFD) para infoproduto/SaaS
7. Integração com o ecossistema Imperatriz

---

## 1. Origem e por que funciona
RFV (em inglês RFM: Recency, Frequency, Monetary) nasceu no marketing de mala
direta dos EUA (Bult & Wansbeek, 1995). É **comportamental**, não demográfico: o
que a pessoa FAZ (quando comprou, quantas vezes, quanto) prevê recompra melhor que
idade/gênero/cidade. **Recência é a métrica mais preditiva** — por isso costuma
receber o maior peso. Aplica o princípio de Pareto: ~20% dos clientes (Campeões +
Fiéis) geram ~80% da receita.

## 2. Notas 1-5: quintil vs faixa fixa
- **Quintil (padrão):** divide a base em 5 partes iguais por percentil. Cada nota
  tem ~20% dos clientes. Bom quando a base é grande (≥100) e você quer comparação
  relativa (quem é top 20% DESTA base).
- **Faixa fixa:** usa cortes absolutos por ticket. Melhor quando a base é pequena
  (<100), quando os quintis ficam distorcidos, ou quando você quer critério estável
  entre períodos (comparar mês a mês sem o corte "andar").

Atenção à inversão: **Recência alta em dias = nota baixa** (comprou há muito tempo
= ruim). É o único das três que inverte.

## 3. Faixas por ticket (as embutidas no `calcular_rfv.py --metodo faixa`)
São ponto de partida; ajuste ao negócio real da mentorada.

**low** (produto de entrada, até ~R$200):
- R: ≤30d=5, ≤90=4, ≤180=3, ≤365=2, +=1
- F: 1=1, 2=2, ≤4=3, ≤7=4, +=5
- V: ≤99=1, ≤299=2, ≤699=3, ≤1499=4, +=5

**mid** (ticket médio, R$200–2000):
- R: ≤30d=5, ≤90=4, ≤180=3, ≤365=2, +=1
- F: 1=1, 2=2, 3=3, ≤5=4, +=5
- V: ≤299=1, ≤799=2, ≤1999=3, ≤4999=4, +=5

**high** (mentoria/high ticket, R$2000+):
- R: ≤60d=5, ≤180=4, ≤365=3, ≤540=2, +=1
- F: 1=1-2, 2=3, 3=4, +=5 (em high ticket, comprar 2x já é muito)
- V: ≤1999=1, ≤4999=2, ≤9999=3, ≤19999=4, +=5

## 4. Ponderação das notas
Três formas de consolidar R, F, V:
1. **Concatenada** (`554`): mostra os 125 segmentos possíveis; é o que alimenta a
   classificação em 11 segmentos do script.
2. **Somada** (R+F+V, 3 a 15): simples, mas perde nuance.
3. **Ponderada** (ex: `R×0,5 + F×0,3 + V×0,2`): quando quer priorizar recência.
   Recomendado para negócios de recompra frequente. Para high ticket com poucas
   compras, aumente o peso de V.

## 5. Edge cases e armadilhas
- **Ignora margem.** V usa receita; quem gasta muito em produto de margem baixa vale
  menos que o número sugere. Se tiver o dado, use lucro no lugar de receita.
- **Olha o passado, não prevê mudança de comportamento.**
- **Não diz o PORQUÊ** de alguém estar Em Risco. Combine com NPS/pesquisa.
- **Estático** se não recalcular: mensal para infoproduto/mentoria, semanal para
  e-commerce de alta frequência.
- **Base pequena distorce quintis** → use `--metodo faixa`.
- **Compra única** (curso vitalício comprado 1x): F fica achatado; foque em R + V +
  engajamento (ver RFM-E abaixo).

## 6. Variações para infoproduto/SaaS
- **RFM-E** — adiciona **Engajamento** (abriu e-mail, clicou, assistiu aula, entrou
  na comunidade). Excelente para mentoria, onde nem toda interação é compra. Um
  cliente F1 mas altamente engajado é um Campeão em formação.
- **RFD** — troca Valor por **Duration** (tempo de assinatura). Para recorrência/SaaS.

Quando a mentorada tem produto de compra única, sugira RFM-E: mantenha R e V, e use
Engajamento como proxy de Frequência.

## 7. Integração com o ecossistema Imperatriz
- **Leadflow (CRM omnichannel):** lugar natural pra rodar RFV em produção. Cada
  contato já tem histórico. Crie a coluna `score_rfv`/`segmento` e dispare automação
  por segmento (BullMQ + Evolution → WhatsApp). Exportar CSV do Leadflow → rodar
  `calcular_rfv.py` → reimportar o `_clientes.csv` é o caminho mais rápido pra um MVP.
- **`/reativacao-por-temperatura`:** RFV é o motor que define a "temperatura". Em
  Risco / Não Posso Perdê-los / Hibernando alimentam a régua de reativação.
- **`/resgate-carrinho-imperatriz`:** a escalada T0→T4 encaixa nos segmentos frios
  de alto valor (Em Risco, Não Posso Perdê-los).
- **`/voz-humana-br`:** rodar nos scripts antes de disparar em escala.
- **Infoprodutos (O Que Vender, Imersão, Tradutor de Valor):** segmentar quem comprou
  produto de entrada (R alto, F1) pra ofertar o high ticket = funil de ascensão.
- **Convenção do ecossistema:** dashboard e .md de saída vão pro Obsidian Vault
  (`03 - Projetos/`). App novo em produção → salvar na Central de Apps + inventário.
