# 🖥️ REXMULTITRADE - Interface Gráfica (GUI)

## 📋 Visão Geral

A interface gráfica do REXMULTITRADE oferece **controle completo do robô** sem necessidade de linha de comando. Funciona em **Windows, Linux e macOS**.

## 🚀 Como Iniciar

### Windows
```bash
# Duplo clique em iniciar.bat
# OU no PowerShell:
python rexmultitrade_gui.py
```

### Linux
```bash
# Tornar executável
chmod +x iniciar_gui.sh

# Executar
./iniciar_gui.sh
```

### macOS
```bash
# Tornar executável
chmod +x iniciar_gui_mac.sh

# Executar
./iniciar_gui_mac.sh
```

## 📊 Funcionalidades Principais

### 1️⃣ **Dashboard** 📊
Monitoramento em tempo real de todas as moedas:

```
┌─────────────────────────────┐
│ 💹 TRX/USDT                 │
├─────────────────────────────┤
│ Capital:         $ 102.50   │
│ Ganho Total:     +2.50%     │
│ 📊 Take Profit:  +0.85%     │
│ Trades:          5          │
│ Posição:         ✓ Ativo    │
│ Entrada:         $0.08012   │
└─────────────────────────────┘
```

**Informações exibidas:**
- Capital atual
- Ganho total em percentual
- Take Profit dinâmico
- Número de trades executados
- Status de posição aberta
- Preço de entrada (se em posição)

**Atualiza:** A cada 2 segundos

### 2️⃣ **Logs** 📋
Visualização completa de eventos em tempo real:

```
2024-01-15 14:30:00 - INFO - TRXUSDT: Ganho médio diário últimos 30 dias: 0.85%
2024-01-15 14:30:15 - INFO - TRX/USDT: SINAL DE COMPRA - RSI:28.5/32.1/30.3
2024-01-15 14:30:17 - INFO - TRX/USDT: COMPRA EXECUTADA - 1250.00000000 @ 0.08012
2024-01-15 14:32:45 - INFO - TRX/USDT: VENDA - Atingiu Take Profit dinâmico
```

**Cores:**
- 🔵 Azul: Informações (INFO)
- 🟠 Laranja: Avisos (WARNING)
- 🔴 Vermelho: Erros (ERROR)
- 🟢 Verde: Sucesso (VENDA/COMPRA)

**Opções:**
- `Auto-scroll Logs` - Acompanha automaticamente novos eventos
- Limpar Logs - Limpa todo o histórico

### 3️⃣ **Configuração** ⚙️
Gerenciamento de moedas:

```
Moedas Configuradas:
┌────────────┬─────────┬──────────────────┐
│ Par        │ Capital │ Agressividade    │
├────────────┼─────────┼──────────────────┤
│ TRX/USDT   │ $100    │ 98%              │
│ XRP/USDT   │ $100    │ 98%              │
│ DOGE/USDT  │ $100    │ 98%              │
└────────────┴─────────┴──────────────────┘

[➕ Adicionar] [✏️ Editar] [🗑 Remover]
```

**Funcionalidades:**
- ➕ **Adicionar**: Nova moeda (par, capital, agressividade)
- ✏️ **Editar**: Modificar configuração existente
- 🗑 **Remover**: Deletar moeda do portfólio

### 4️⃣ **Estatísticas** 📈
Resumo consolidado:

```
Capital Total        $ 300.00
Ganho Total          $ 7.50
Trades Realizados    15
```

**Atualiza:** A cada 2 segundos

## 🎮 Controles Principais

### Barra Superior
```
[▶ Iniciar Robô]  [⏹ Parar Robô]  |  [🔄 Recarregar]  [🗑 Limpar Logs]  
[☐ Auto-scroll Logs]
```

### Menu Arquivo
- **Recarregar Config** - Recarrega configuracoes.json
- **Abrir Logs** - Abre arquivo de logs no editor
- **Sair** - Fecha a aplicação (pede confirmação se robô está rodando)

### Menu Ações
- **Iniciar Robô** - Inicia rexmultitrade.py como processo separado
- **Parar Robô** - Para o processo do robô
- **Limpar Logs** - Apaga arquivo de logs
- **Reset Estado** - Reseta estado para valores iniciais

### Menu Ajuda
- **Sobre** - Informações da aplicação
- **Documentação** - Abre ajuda

### Status Bar (inferior)
```
🕐 14:32:45          ✓ Robô em execução
```

## 📌 Workflow Típico

### 1️⃣ **Iniciar a GUI**
```
Linux: ./iniciar_gui.sh
Windows: python rexmultitrade_gui.py
```

### 2️⃣ **Configurar Moedas** (se necessário)
```
Aba "Configuração"
├─ Verificar moedas existentes
├─ [➕ Adicionar] se precisar de nova
└─ Salva automaticamente em configuracoes.json
```

### 3️⃣ **Iniciar Robô**
```
Clique em [▶ Iniciar Robô]
├─ Status muda para: ● Executando (verde)
├─ Dashboard começa atualizar
└─ Logs aparecem em tempo real
```

### 4️⃣ **Monitorar em Tempo Real**
```
Aba "Dashboard"
├─ Veja capital e ganho de cada moeda
├─ Acompanhe Take Profit dinâmico
└─ Saiba quando há posição aberta
```

### 5️⃣ **Acompanhar Eventos**
```
Aba "Logs"
├─ Veja cada compra/venda
├─ Identifique problemas
└─ Confirme que robô está funcionando
```

### 6️⃣ **Parar Robô**
```
Clique em [⏹ Parar Robô]
├─ Status muda para: ● Parado (vermelho)
├─ Processo é encerrado
└─ Capital final é salvo
```

## 🔧 Funcionalidades Avançadas

### Adicionar Nova Moeda

```
1. Aba "Configuração"
2. Clique em "➕ Adicionar"
3. Preencha:
   - Par: BTC/USDT
   - Symbol: BTCUSDT
   - Capital: 200
   - Agressividade: 0.98
4. Clique "Salvar"
```

### Editar Configuração Existente

```
1. Aba "Configuração"
2. Selecione a moeda (clique na linha)
3. Clique em "✏️ Editar"
4. Modifique valores
5. Salve
```

### Remover Moeda

```
1. Aba "Configuração"
2. Selecione a moeda
3. Clique em "🗑 Remover"
4. Confirme na caixa de diálogo
```

### Limpar Logs

```
Menu → Ações → Limpar Logs
ou
Botão [🗑 Limpar Logs]

Cuidado: Não pode ser desfeito!
```

### Reset Estado

```
Menu → Ações → Reset Estado

⚠️ CUIDADO: Reseta todos os dados!
- Capital volta aos valores iniciais
- Ganhos são zerados
- Não pode ser desfeito
```

## 🖼️ Layout Visual

```
┌──────────────────────────────────────────────────────────────┐
│  Arquivo  Ações  Ajuda                         ● Executando  │
├──────────────────────────────────────────────────────────────┤
│ [▶ Iniciar] [⏹ Parar] | [🔄 Reload] [🗑 Clear] [☐ Autoscroll]
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─ [📊 Dashboard] [📋 Logs] [⚙️ Config] [📈 Stats] ────┐  │
│  │                                                       │  │
│  │  💹 TRX/USDT              💹 XRP/USDT               │  │
│  │  ┌───────────────────┐   ┌──────────────────┐       │  │
│  │  │ Capital: $ 102.50 │   │ Capital: $ 150.00│       │  │
│  │  │ Ganho: +2.50%     │   │ Ganho: +1.20%    │       │  │
│  │  │ Take Profit: 0.85%│   │ Take Profit: 1.10%       │  │
│  │  │ Trades: 5         │   │ Trades: 3        │       │  │
│  │  └───────────────────┘   └──────────────────┘       │  │
│  │                                                       │  │
│  │  💹 DOGE/USDT                                        │  │
│  │  ┌──────────────────────────────────────────────┐   │  │
│  │  │ Capital: $ 98.75    Ganho: +0.98%            │   │  │
│  │  │ Take Profit: 0.92%  Trades: 2                │   │  │
│  │  └──────────────────────────────────────────────┘   │  │
│  │                                                       │  │
│  └───────────────────────────────────────────────────────┘  │
│                                                              │
├──────────────────────────────────────────────────────────────┤
│ 🕐 14:32:45          ✓ Robô em execução                      │
└──────────────────────────────────────────────────────────────┘
```

## 🔐 Segurança

### ✅ Confirmações Duplas
- Reset Estado: Pede confirmação
- Sair com Robô Rodando: Pede confirmação

### ✅ Proteção de Dados
- Configurações salvas em JSON
- Estado persistente em JSON
- Logs continuam crescendo (não perdem dados)

### ✅ Processo Isolado
- Robô roda em subprocess separado
- GUI não congela se robô travar
- Pode parar robô independentemente

## 🐛 Troubleshooting

### "Tkinter não encontrado"
```bash
# Linux
sudo apt install python3-tk

# MacOS
brew install python-tk3
```

### "Robô não inicia"
```
1. Verifique credenciais Binance
2. Veja se há erros nos logs
3. Tente Manual: python rexmultitrade.py
```

### "Logs não atualizam"
```
1. Desmarque e remarque "Auto-scroll Logs"
2. Clique em "🔄 Recarregar"
3. Verifique se robô está rodando
```

### "Interface congela"
```
1. Espere 5 segundos (pode estar carregando)
2. Reinicie a GUI
3. Verifique logs do sistema
```

## 📈 Monitoramento Contínuo

### Periodicidade de Atualização
```
Dashboard    → 2 segundos
Logs         → 2 segundos
Estatísticas → 2 segundos
Status       → Instantâneo
```

### Dados Monitorados
```
✓ Capital por moeda
✓ Ganho acumulado
✓ Take Profit dinâmico
✓ Número de trades
✓ Status de posição
✓ Preço de entrada
```

## 🎯 Dicas & Boas Práticas

1. **Deixe a GUI Aberta**
   - Monitore eventos em tempo real
   - Reaja rapidamente a problemas

2. **Verifique Logs Regularmente**
   - Identifique padrões
   - Detecte anomalias cedo

3. **Use Auto-scroll**
   - Acompanhe novos eventos automaticamente
   - Não precisa fazer scroll manual

4. **Revise Estatísticas**
   - Veja performance consolidada
   - Calcule ROI

5. **Faça Backups**
   - Copie configuracoes.json
   - Copie estado_robos.json
   - Faça backup de logs

## 🔄 Próximas Melhorias

- [ ] Modo escuro/claro
- [ ] Gráficos em tempo real
- [ ] Alertas por som
- [ ] Notificações desktop
- [ ] Exportar para Excel
- [ ] Replay de trades

## 📞 Suporte

Se encontrar problemas:
1. Consulte README.md
2. Verifique os logs em Aba "Logs"
3. Veja arquivo `logs/log_trades.log`
4. Tente reiniciar GUI

---

**GUI Pronta para Produção!** 🎉