Analisador de Testes A/B

Solução reutilizável para análise automatizada de testes A/B de cashback. Recebe qualquer dataset no schema padrão e retorna relatório executivo completo, gráficos e decisão acionável — sem alterar uma linha de código entre datasets.

---

Confidencialidade

Os datasets utilizados neste projeto foram fornecidos exclusivamente para fins de avaliação técnica e não estão incluídos neste repositório.

Para preservar a confidencialidade das informações, o código-fonte foi separado dos dados de entrada. Para executar a solução, basta fornecer um CSV compatível com o schema descrito neste documento.

Os relatórios e arquivos de saída presentes neste repositório utilizam apenas dados de exemplo ou podem ser regenerados localmente a partir dos datasets autorizados.

---

Instalação

pip install pandas scipy matplotlib

---

Como Executar

python analyze.py --file dataset_01_parceiroA.csv
python analyze.py --file dataset_02_parceiroB.csv
python analyze.py --file dataset_03_parceiroC.csv

Parâmetros:

Parâmetro	Padrão	Descrição
--file	obrigatório	Caminho do CSV do teste A/B
--output	reports/<dataset>_relatorio.md	Onde salvar o relatório
--tracking	tracking.csv	CSV de registro consolidado

---

Estrutura de Pastas

analyze.py
PROMPT.md
README.md
tracking.csv
reports/
├── dataset_01_parceiroA_relatorio.md
├── dataset_02_parceiroB_relatorio.md
├── dataset_03_parceiroC_relatorio.md
└── charts/
    ├── parceiro_a_lucro_liquido.png
    ├── parceiro_a_roi.png
    ├── parceiro_a_compradores.png
    └── parceiro_a_gmv.png

---

Schema do CSV de Entrada

Coluna	Tipo	Descrição
Data	YYYY-MM-DD	Data da observação
Grupos de usuários	string	Variante do teste
Parceiro	string	Identificador do parceiro
compradores	int	Usuários únicos que compraram no dia
comissão	string (R$)	Comissão paga pelo parceiro ao Méliuz
cashback	string (R$)	Cashback distribuído aos usuários
vendas totais	string (R$)	GMV — valor total das vendas

---

Lógica de Decisão

Métrica primária: Lucro Líquido = Comissão − Cashback

Métrica secundária: ROI = Lucro Líquido / Cashback

Métrica terciária: Total de Compradores

Uma variante só é aprovada se tiver lucro líquido positivo e significância estatística em lucro (Mann-Whitney U, p < 0,05). Aumento de compradores sem melhora de lucro não aprova variante.

---

Tecnologias

Biblioteca	Uso
pandas	Carregamento e agregação dos dados
scipy	Teste Mann-Whitney U
matplotlib	Gráficos PNG

---

Integração com IA

Ver PROMPT.md para prompts prontos para Claude Code, Cursor, ChatGPT e Gemini.