README.md

📊 Retail Performance Intelligence

Transforme dados brutos de vendas em decisões estratégicas. Pipeline ETL + dashboard interativo para analisar performance de produtos, regiões e KPIs.

---

🚀 Destaque: Execute Tudo em Minutos

1️⃣ Preparar ambiente

python -m venv venv venv\Scripts\activate # Windows

source venv/bin/activate # Linux / Mac

2️⃣ Instalar dependências

pip install -r requirements.txt

3️⃣ Gerar dataset

python data/generate_dataset.py

4️⃣ Rodar pipeline ETL

python main.py

5️⃣ Abrir dashboard interativo

streamlit run app.py

📊 Principais Métricas

KPI	Descrição
Total Revenue	Receita total
Total Profit	Lucro total
Average Ticket	Receita média por venda
Top Product	Produto que mais vende
Top Region	Região que mais vende
ABC Curve	Concentração de receita por produto

🏗 Arquitetura

Retail_Performance_Intelligence/
├─ data/               # Raw e processed
├─ src/                # ETL modular
├─ notebooks/          # Análise exploratória
├─ reports/            # Insights e KPIs
├─ main.py             # Pipeline orquestrador
└─ app.py              # Dashboard interativo

💡Insights Rápidos

Concentração de receita em poucos produtos (Curva ABC)

Maior faturamento em regiões específicas

Ticket médio estável → padrão de consumo consistente

Foco em produtos estratégicos pode aumentar lucro

⚡Diferenciais Técnicos

Pipeline ETL modular e reproduzível

Dashboard interativo com filtros e gráficos

Métricas comerciais aplicáveis

Preparado para análise exploratória e decisões estratégicas

📌 Próximos Passos

Dashboard com mapas interativos

Deploy em cloud (Heroku / AWS / GCP)

Integração com banco de dados SQL

Automação via agendamento (Airflow / Prefect)