📊 Simulador Financeiro

Simulador de investimentos do mercado financeiro brasileiro com modo multiplayer

Instalação • Como Usar • Stack • Documentação

---

🇧🇷 Projeto em Português - Este simulador é focado no mercado financeiro brasileiro e toda a documentação está em português.

📌 O que é o Simulador Financeiro?

O Simulador Financeiro é uma aplicação web interativa inspirada em jogos de estratégia como Capitalism Lab e Victoria 3, que permite testar e competir com estratégias de investimento no mercado financeiro brasileiro.

Simule negociações em renda variável (Ações, FIIs, ETFs) e renda fixa (CDB, LCI, LCA, Tesouro Direto), acompanhe métricas de desempenho em tempo real e compita com outros jogadores no modo multiplayer.

✨ O que ele faz?

• 🎮 Modo Single Player e Multiplayer - Jogue sozinho ou compita com amigos
• 📈 Renda Variável - Negocie ações, FIIs e ETFs com dados reais do mercado
• 💰 Renda Fixa - Invista em CDB, LCI, LCA e Tesouro Direto
• 🤖 Estratégias Automatizadas - Configure algoritmos de trading personalizados
• 📊 Dashboard Completo - Acompanhe seu portfólio e estatísticas em tempo real
• ⏱️ Controle de Tempo - Pause, acelere ou desacelere a simulação
• 🎯 Ranking Competitivo - Compare seu desempenho com outros jogadores

📥 Instalação

Instalação via Executável

Baixe o executável disponível em Releases, escolha o arquivo conforme seu sistema operacional e execute-o diretamente. O navegador abrirá automaticamente em http://localhost:8000.

Important

O executável não requer instalação de Python ou Node.js, mas ainda depende do PostgreSQL. Configure as variáveis de ambiente no arquivo .env antes de executar.

Instalação a partir do Código-Fonte

Clone o repositório e instale as dependências:

git clone https://github.com/LiloMarino/SimuladorFinanceiro.git
cd SimuladorFinanceiro

Backend (Python 3.12+)

pip install -r requirements.txt

Frontend (Node.js + pnpm)

cd frontend
pnpm install

Configuração (Opcional)

# Copie o arquivo de exemplo de variáveis de ambiente
cp example.env .env

# Edite .env com suas configurações (banco de dados, etc.)

Important

O projeto requer PostgreSQL. Configure as variáveis de ambiente no arquivo .env antes de executar.

Executando o Projeto Localmente

Modo Desenvolvimento

Backend:

python main.py

Frontend (em outro terminal):

cd frontend
pnpm dev

Acesse: http://localhost:5173 (frontend dev) ou http://localhost:8000 (backend direto)

Modo Produção (Compilado)

make build
./dist/SimuladorFinanceiro

Acesse: http://localhost:8000

🛠️ Stack Tecnológica

Backend

• FastAPI - Framework web moderno e rápido
• Uvicorn - Servidor ASGI de alta performance
• SQLAlchemy - ORM para gerenciamento de dados
• Socket.IO - Comunicação em tempo real via WebSockets
• yfinance - Dados do mercado financeiro
• PostgreSQL - Banco de dados

Frontend

• React 19 - Biblioteca para interfaces modernas
• TypeScript - Type safety para JavaScript
• Vite - Build tool ultra-rápido
• TailwindCSS - Framework CSS utilitário
• Recharts - Biblioteca de gráficos composáveis
• Lightweight Charts - Gráficos financeiros profissionais
• Radix UI - Componentes acessíveis e não-estilizados
• React Query - Gerenciamento de estado assíncrono
• React Router - Roteamento declarativo

Ferramentas de Build

• PyInstaller - Empacotamento do Python em executável
• Make - Automação de build

🤝 Contribuindo

Contribuições são bem-vindas! Veja a documentação completa para guias de desenvolvimento.

Formas de contribuir:

• 🐛 Reportar bugs via Issues
• 💡 Sugerir novas funcionalidades via Discussions
• 🔧 Enviar pull requests
• 📖 Melhorar a documentação

📜 Licença

Este projeto está licenciado sob a GNU General Public License v3.0.

Você é livre para usar, modificar e distribuir este software, desde que mantenha a mesma licença e atribua os devidos créditos.

---

Desenvolvido por Murilo Marino • ⭐ Dê uma estrela no projeto!