Coffee Shop Sales Analysis

Projeto de criação de um pipeline de dados e visualização de dados a partir do dataset Coffee Shop Sales da Maven Analytics.

📜 Sumário

1. 📌 Sobre o Projeto
2. ⚙️ Tecnologias Utilizadas
3. 🚀 Como Executar
4. 📊 Estrutura do Projeto
5. 🗒️ Licença
6. 📞 Contato

📌 Sobre o Projeto

Este repositório contém um pipeline completo de dados transacionais de uma rede de cafeterias fictícia operando em três localizações em Nova York. O objetivo é extrair insights de negócio, identificar padrões de vendas e fornecer recomendações estratégicas para otimização operacional.

⚙️ Tecnologias Utilizadas

• Python 3.12
• dlt (data load tool)
• dbt (data build tool)
• DuckDB
• Power BI

🚀 Como Executar

Acesse o dashboard no Power BI Service.

Pré-requisitos

• Python 3.12+
• uv

Execução

1️⃣ Clone o repositório

git clone https://github.com/datalopes1/coffee.git
cd coffee

2️⃣ Instale as dependências e crie um ambiente virtual

pip install uv
uv sync

3️⃣ Ative o ambiente virtual

source .venv/bin/activate  # Mac e Linux
.venv\Scripts\activate  # Windows

4️⃣ Execute o pipeline

python -m src.pipeline

📊 Estrutura do Projeto

coffee/
├── data/
│   ├── raw/                 # Dados brutos em Excel
│   │   └── sales.xlsx
│   └── database/
│       └── db.duckdb        # Banco de dados DuckDB
├── dwh/                     # Projeto dbt
│   ├── models/
│   │   ├── stg/            # Staging (views)
│   │   │   └── stg_excel__sales.sql
│   │   ├── int/            # Intermediários (ephemeral)
│   │   │   └── int_sales_enriched.sql
│   │   └── marts/          # Marts (tables)
│   │       └── sales/
│   │           ├── fct_sales.sql
│   │           ├── obt_sales.sql
│   │           ├── dim_product.sql
│   │           └── dim_store.sql
│   ├── tests/
│   ├── seeds/
│   ├── macros/
│   ├── analyses/
│   ├── snapshots/
│   ├── dbt_project.yml
│   └── README.md
├── dashboard/
│   ├── sales_dashboard.pbip
│   ├── sales_dashboard.Report/
│   └── sales_dashboard.SemanticModel/
├── src/
│   └── pipeline.py          # Pipeline de ingestão e transformação
├── pyproject.toml
├── uv.lock
└── .python-version

🗒️ Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para mais detalhes.

📞 Contato

• LinkedIn: https://www.linkedin.com/in/datalopes1
• Portfolio: https://datalopes1.github.io/
• E-mail: datalopes1@proton.me