Introdução para Devs

Bem-vindo ao guia de desenvolvimento do Simulador Financeiro!

Sobre o Projeto

O Simulador Financeiro é uma aplicação full-stack que simula investimentos no mercado financeiro brasileiro. É um projeto open-source que combina:

• Backend robusto com FastAPI
• Frontend moderno com React
• Comunicação em tempo real com Socket.IO
• Dados reais de mercado via yfinance

Estrutura Geral

SimuladorFinanceiro/
├── backend/              # Python FastAPI + lógica de negócio
├── frontend/             # React + TypeScript
├── docs/                 # Documentação (este site)
├── scripts/              # Utilitários e scripts
├── main.py               # Entrypoint da aplicação
└── requirements.txt      # Dependências Python

Stack Tecnológica

Backend

• FastAPI — Framework web moderno
• Uvicorn — Servidor ASGI
• SQLAlchemy — ORM SQL
• Socket.IO — WebSockets para tempo real
• yfinance — Dados de mercado

Frontend

• React — Biblioteca de UI
• Shadcn — Componentes pré-construídos
• TypeScript — Type safety
• Vite — Build tool
• TailwindCSS — Estilização
• Recharts — Gráficos

Próximos Passos

• Setup do Ambiente — Configure sua máquina para desenvolvimento
• Estrutura de Pastas — Entenda como o projeto é organizado
• Contribuindo — Aprenda como enviar suas primeiras contribuições

Recursos Úteis

• Repositório GitHub
• Issues em Aberto — Encontre tarefas para contribuir
• Discussões — Perguntas, dúvidas e ideias