🚀 TradePro - Plataforma de Trading Completa

Uma plataforma de trading moderna e completa que suporta negociação de criptomoedas, forex e ações, com integração PIX para transações em reais brasileiros.

✨ Funcionalidades

💰 Trading

• Criptomoedas: Trading com integração 0x API
• Forex: Negociação de pares de moedas
• Ações: Trading de ações nacionais e internacionais
• Ordens: Market Orders e Limit Orders
• Ferramentas: Stop Loss e Take Profit

💳 Pagamentos

• PIX: Depósitos e saques instantâneos
• Crypto Wallets: Retiradas para carteiras pessoais
• Suporte Fiat: Real brasileiro (BRL)

📊 Interface

• Gráficos em Tempo Real: Charts interativos com dados atualizados
• Portfolio Management: Acompanhamento de investimentos
• Dashboard Responsivo: Interface otimizada para desktop e mobile
• Tema Escuro/Claro: Personalização visual completa

🛠️ Tecnologias

• Frontend: Next.js 15.3.4, React 19, TypeScript 5.8.3
• Styling: Tailwind CSS 3.4.1, Radix UI
• APIs: 0x API, Binance API, CoinGecko API
• Charts: Lightweight Charts, Recharts
• Icons: Lucide React, React Icons

🚀 Como Rodar o Projeto

1. Pré-requisitos

# Certifique-se de ter o Node.js instalado
node --version  # v18+ recomendado
npm --version   # ou yarn/pnpm

2. Clone e Configure

# Clone o repositório
git clone <your-repo-url>
cd tradepro

# Instale as dependências
npm install
# ou
yarn install
# ou
pnpm install

3. Configure as Variáveis de Ambiente

# Copie o arquivo de exemplo
cp .env.example .env

# Edite o .env com suas credenciais
nano .env  # ou use seu editor favorito

Variáveis importantes:

• ZERO_EX_API_KEY: Sua chave da API 0x (https://0x.org/docs)
• PIX_ACCESS_TOKEN: Token do MercadoPago (https://mercadopago.com.br/developers)
• NEXT_PUBLIC_USER_NAME: Nome do usuário demo

4. Execute o Projeto

# Desenvolvimento
npm run dev

# Ou com cache limpo (recomendado na primeira vez)
npm run dev:clean

# Build para produção
npm run build
npm run start

5. Acesse a Aplicação

Abra seu navegador em: http://localhost:3000

🔧 Scripts Disponíveis

# Desenvolvimento
npm run dev          # Inicia o servidor de desenvolvimento
npm run dev:clean    # Limpa cache e inicia o servidor

# Build e Produção
npm run build        # Constrói a aplicação para produção
npm run build:clean  # Build com cache limpo
npm run start        # Inicia o servidor de produção

# Manutenção
npm run clean        # Limpa caches do Next.js
npm run reset        # Reinstala todas as dependências
npm run lint         # Executa o linter

🛠️ Resolução de Problemas

Erro de Import ou Cache

# Limpe completamente o cache
npm run clean
rm -rf node_modules/.cache
npm run dev

# Ou faça um reset completo
npm run reset

Erro de TypeScript

# Verifique se todas as dependências estão instaladas
npm install

# Execute o build para verificar erros
npm run build

Erro de API

• Verifique se suas chaves de API estão corretas no .env
• Certifique-se de que as APIs externas estão funcionando
• Verifique se há limites de rate nas APIs

📂 Estrutura do Projeto

src/
├── app/
│   ├── api/           # API routes do Next.js
│   ├── globals.css    # Estilos globais
│   ├── layout.tsx     # Layout principal
│   └── page.tsx       # Página inicial
├── components/
│   ├── ui/           # Componentes UI base (Shadcn)
│   ├── trading/      # Componentes específicos de trading
│   └── ...          # Outros componentes
├── lib/             # Utilitários e configurações
├── hooks/           # Custom React hooks
└── types/           # Definições TypeScript

🔑 Variáveis de Ambiente

Obrigatórias

• ZERO_EX_API_KEY: Chave da API 0x para trading de crypto
• NEXT_PUBLIC_APP_NAME: Nome da aplicação

Opcionais

• PIX_ACCESS_TOKEN: Token para pagamentos PIX
• NEXT_PUBLIC_POSTHOG_KEY: Chave para analytics
• DATABASE_URL: String de conexão do banco (se usar Prisma)

🤝 Contribuição

1. Fork o projeto
2. Crie sua feature branch (git checkout -b feature/amazing-feature)
3. Commit suas mudanças (git commit -m 'Add amazing feature')
4. Push para a branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🆘 Suporte

Se encontrar problemas:

1. Verifique o arquivo .env está configurado corretamente
2. Limpe o cache: npm run clean
3. Reinstale dependências: npm run reset
4. Consulte a documentação das APIs utilizadas

---

TradePro - Desenvolvido com 💙 para traders brasileiros