💰 Financial Python Project - Dashboard de Gastos

Projeto Python para análise financeira com dashboard interativo usando Dash e Plotly.

📊 Funcionalidades

• Dashboard interativo com visualizações de gastos
• Análise por categoria automática (Alimentação, Transporte, Assinaturas, etc.)
• Gráficos dinâmicos: Pizza, Barras, Linha temporal
• Tabela dos maiores gastos
• Cards com métricas: Total, Média, Maior gasto
• Suporte para Nubank e Bradesco

🚀 Instalação

1. Ative o ambiente virtual:

source venv/bin/activate

2. Instale as dependências:

pip install -r requirements.txt

📈 Uso do Dashboard

Execute o dashboard:

cd src
python dashboard.py

Acesse no navegador: http://localhost:8050

📁 Formato do CSV

O arquivo CSV deve estar no formato:

Data;Descr;Valor
20/08/2025;bradesco;-3900
22/09/2025;bradesco;-2060

• Data: formato DD/MM/YYYY
• Descr: descrição da transação
• Valor: valores negativos são gastos, positivos são receitas

🎯 Categorias Automáticas

O sistema categoriza automaticamente:

• 🍔 Alimentação: Restaurantes, supermercados, padarias
• 🚗 Transporte: Combustível, estacionamento
• 📱 Assinaturas: Netflix, Spotify, ChatGPT, GitHub
• 🛒 Compras Online: Amazon, Shopee, Magazine Luiza
• 🏦 Banco/Financeiro: Tarifas, IOF, parcelamentos
• 🎮 Entretenimento: Parques, jogos, cinema
• 💊 Saúde: Farmácias
• 🐾 Petshop: Pet shops
• ✈️ Viagem: Aeroportos, passagens

🧪 Testes

Execute os testes com pytest:

pytest

🎨 Formatação de Código

Formate o código com black:

black src/

🔍 Linting

Verifique o código com flake8:

flake8 src/

📦 Estrutura do Projeto

financial-py/
├── src/
│   ├── dashboard.py        # Dashboard Dash/Plotly
│   ├── data_processor.py   # Processamento de dados
│   └── main.py            # Arquivo principal
├── NUBANCK E BRADESCO2222.csv  # Dados financeiros
├── requirements.txt       # Dependências
└── README.md             # Documentação