# 📋 CHECKLIST & REFERÊNCIA RÁPIDA

## 🎯 ANTES DE COMEÇAR

```
╔═══════════════════════════════════════════════════════════╗
║          CHECKLIST - ROBÔ DE BALANCEAMENTO               ║
╚═══════════════════════════════════════════════════════════╝
```

### ✅ PREPARAÇÃO

- [ ] Python 3.7+ instalado
- [ ] Dependências instaladas:
  ```bash
  pip install ccxt pandas pytz colorama
  ```
- [ ] Leu o arquivo **COMECE_AQUI.md**
- [ ] Conta Binance criada
- [ ] Chaves API geradas

### ✅ CONFIGURAÇÃO

- [ ] Executou `python exemplos_portofolios.py`
- [ ] Escolheu um perfil de portfólio
- [ ] Adicionou suas chaves em `configuracoes_balanceamento.json`:
  ```json
  "api_key": "sua_chave_aqui",
  "api_secret": "seu_secret_aqui"
  ```
- [ ] Definiu `"testnet": true` (para teste)
- [ ] Configurou `capital_inicial` desejado
- [ ] Adicionou as moedas que quer negociar
- [ ] Definiu percentuais para cada moeda (somam 100%)

### ✅ VALIDAÇÃO

- [ ] Executou: `python validar_balanceamento.py`
- [ ] Todas as validações passaram ✓
- [ ] Testnet está funcionando
- [ ] Preços das moedas estão sendo obtidos

### ✅ EXECUÇÃO

- [ ] Iniciou: `python interface_graficabalanceamento.py`
  - OU -
- [ ] Executou: `python robo_balanceamento.py`
- [ ] Robô iniciou na Fase 1 (Construção)

### ✅ MONITORAMENTO (Testnet)

- [ ] Abrindo `log_balanceamento.log`
- [ ] Vendo compras sendo executadas
- [ ] Verificando `portfolio_estado.json`
- [ ] Testando por 1-2 horas em TESTNET
- [ ] Confirmou que entende o funcionamento

### ✅ PASSAGEM PARA REAL (Opcional)

- [ ] Mude em `configuracoes_balanceamento.json`:
  ```json
  "testnet": false
  ```
- [ ] Redefiniu `capital_inicial` para quantidade PEQUENA
- [ ] Releu a documentação
- [ ] Está preparado para possíveis perdas
- [ ] Confia que testou o suficiente

---

## 📁 ARQUIVOS ESSENCIAIS

```
robo_balanceamento.py
├─ Robô principal que faz o trading
├─ Executa: python robo_balanceamento.py
└─ Cria: log_balanceamento.log, portfolio_estado.json

interface_graficabalanceamento.py
├─ Interface gráfica
├─ Executa: python interface_graficabalanceamento.py
└─ Recommndado para iniciantes

configuracoes_balanceamento.json
├─ Suas configurações
├─ EDITAR com suas chaves API
└─ EDITAR com seu portfólio desejado

validar_balanceamento.py
├─ Testa sua configuração
├─ Executa: python validar_balanceamento.py
└─ Rode antes de cada uso em REAL

exemplos_portofolios.py
├─ 6 perfis prontos
├─ Executa: python exemplos_portofolios.py
└─ Ajuda a escolher uma estratégia

portfolio_estado.json
├─ Estado atual do portfólio
├─ Criado automaticamente
└─ Rastreia fase, moedas, trades

log_balanceamento.log
├─ Histórico de todas operações
├─ Criado automaticamente
└─ Abra para debug de problemas
```

### Arquivos de Documentação

```
COMECE_AQUI.md                    ← LEIA PRIMEIRO
ROBO_BALANCEAMENTO_GUIA.md        ← Documentação completa
README_BALANCEAMENTO.md           ← Este arquivo
CHECKLIST_E_REFERENCIA.md         ← Este arquivo 😊
```

---

## 🚀 COMMANDS RÁPIDOS

### Setup Inicial

```bash
# 1. Instalar dependências
pip install ccxt pandas pytz colorama

# 2. Ver exemplos de portfólio
python exemplos_portofolios.py

# 3. Editar config
# (abra configuracoes_balanceamento.json em seu editor)

# 4. Validar tudo
python validar_balanceamento.py
```

### Executar Robô

```bash
# Interface Gráfica (Recomendado)
python interface_graficabalanceamento.py

# Ou Linha de Comando
python robo_balanceamento.py

# Pressione Ctrl+C para parar
```

### Monitoramento

```bash
# Ver log em tempo real (Windows)
type log_balanceamento.log

# Ver log em tempo real (Mac/Linux)
tail -f log_balanceamento.log

# Ver estado do portfólio
type portfolio_estado.json

# Re-validar (depois de mudar config)
python validar_balanceamento.py
```

---

## 🔧 CONFIGURAÇÕES COMUNS

### Para Ser Mais Rápido (Agressivo)

```json
{
  "tempo_ciclo": 3,
  "variacao_balanceamento": 0.5,
  "timeframe": "1m"
}
```

### Para Ser Mais Lento (Conservador)

```json
{
  "tempo_ciclo": 15,
  "variacao_balanceamento": 5.0,
  "timeframe": "1h"
}
```

### Para Usar Testnet

```json
{
  "testnet": true,
  "api_key": "api_key_testnet",
  "api_secret": "api_secret_testnet"
}
```

### Para Usar Real

```json
{
  "testnet": false,
  "api_key": "api_key_real",
  "api_secret": "api_secret_real"
}
```

---

## 📊 EXEMPLO DE PORTFÓLIO

### Simples (4 moedas)

```json
"portfolio": [
  {"moeda": "BTC", "percentual": 50, "preco_compra": 42000, "ativa": true},
  {"moeda": "ETH", "percentual": 30, "preco_compra": 2500, "ativa": true},
  {"moeda": "BNB", "percentual": 20, "preco_compra": 600, "ativa": true}
]
```

### Moderado (6 moedas)

```json
"portfolio": [
  {"moeda": "BTC", "percentual": 30, "preco_compra": 42000, "ativa": true},
  {"moeda": "ETH", "percentual": 25, "preco_compra": 2500, "ativa": true},
  {"moeda": "BNB", "percentual": 20, "preco_compra": 600, "ativa": true},
  {"moeda": "SOL", "percentual": 15, "preco_compra": 200, "ativa": true},
  {"moeda": "ADA", "percentual": 10, "preco_compra": 1.0, "ativa": true}
]
```

### Diversificado (10 moedas)

```json
"portfolio": [
  {"moeda": "BTC", "percentual": 15, ...},
  {"moeda": "ETH", "percentual": 15, ...},
  {"moeda": "BNB", "percentual": 10, ...},
  {"moeda": "SOL", "percentual": 10, ...},
  {"moeda": "ADA", "percentual": 10, ...},
  {"moeda": "XRP", "percentual": 8, ...},
  {"moeda": "DOGE", "percentual": 8, ...},
  {"moeda": "LINK", "percentual": 7, ...},
  {"moeda": "HBAR", "percentual": 7, ...},
  {"moeda": "MATIC", "percentual": 5, ...}
]
```

---

## 🐛 TROUBLESHOOTING RÁPIDO

### ❌ "Módulo não encontrado"
```bash
pip install ccxt pandas pytz colorama
```

### ❌ "Falha ao conectar com Binance"
- Chaves API corretas?
- Internet conectada?
- Testnet: true (e usando chaves testnet)?

### ❌ "Saldo insuficiente para comprar"
- Aumentar `capital_inicial`
- Reduzir número de moedas
- Aumentar `saldo_minimo`? Não!

### ❌ "Nenhuma ordem executada"
- Preços estão muito altos que `preco_compra`?
- Aumentar tolerância (testnet)?
- Verificar in `log_balanceamento.log`

### ❌ "Validação falhou"
```bash
python validar_balanceamento.py
```
- Verificar chaves API
- Verificar conexão internet
- Verificar percentuais (somam 100%?)

---

## 📈 MÉTRICAS QUE IMPORTAM

### Ao Avaliar o Robô

| Métrica | O que significa |
|---------|-----------------|
| Fase | "construcao" = comprando; "balanceamento" = equilibrando |
| Moedas Compradas | Quantas moedas já foram compradas |
| Moedas Pendentes | Quantas faltam comprar |
| Total de Trades | Quantas operações foram executadas |
| Capital Atual | Seu dinheiro agora (pode estar em USDT ou moedas) |
| Gain/Loss % | Quanto ganhou ou perdeu em % |

---

## ⚠️ AVISOS IMPORTANTES

### 🚨 NUNCA

- ❌ Compartilhe suas chaves API
- ❌ Use chaves REAL em TESTNET
- ❌ Configure `testnet: false` sem ter testado
- ❌ Deixe rodando sem monitorar
- ❌ Altere portfólio enquanto robô rodando

### ✅ SEMPRE

- ✓ Comece em TESTNET
- ✓ Use pequeno capital inicial
- ✓ Acompanhe os logs
- ✓ Teste por 1-2 horas antes do REAL
- ✓ Leia a documentação
- ✓ Valide antes de cada uso

---

## 📞 ARQUIVO DE LOG

### O que procurar em `log_balanceamento.log`

```
✓ Ordem de COMPRA executada     → Funcionando!
✗ ERRO: Falha ao obter preço   → Problema de conexão
○ Aguardando preço melhor      → Esperando preço cair
● >>> Comprando MOEDA <<<      → Próxima compra
● >>> Vendendo MOEDA <<<       → Rebalanceando
✓ PORTFÓLIO COMPLETO           → Passou para Fase 2
```

---

## 🎯 FLUXO TÍPICO

```
1. INSTALAÇÃO
   ↓
2. ESCOLHER PERFIL (exemplos_portofolios.py)
   ↓
3. CONFIGURAR CHAVES (configuracoes_balanceamento.json)
   ↓
4. VALIDAR (validar_balanceamento.py)
   ↓
5. TESTNET (testnet: true)
   ↓
6. MONITORAR 1-2 HORAS
   ↓
7. DECIDIR SE VAI PARA REAL
   ↓
8. SE SIM: Mudar testnet: false e capital_inicial
   ↓
9. RODAR EM REAL
   ↓
10. ACOMPANHAR LOGS REGULARMENTE
```

---

## 🏁 RESULTADO ESPERADO

### Após 1 Hora em Testnet (Fase 1)

```
Status: Comprando moedas
Moedas Compradas: 3 de 4
Saldo USDT: ~100 USDT
Log: Mostrando compras sendo executadas
```

### Após 3 Horas em Testnet (Fase 2)

```
Status: Balanceando portfólio
Fase: balanceamento
Moedas Compradas: 4 de 4 ✓
Histórico de trades: 8+ operações
Log: Mostrando rebalanceamentos automáticos
```

---

## ✅ VOCÊ ESTÁ PRONTO QUANDO...

- [ ] Entende as 2 fases (Construção + Balanceamento)
- [ ] Sabe como adicionar moedas em `portfolio`
- [ ] Consegue rodar `validar_balanceamento.py` com sucesso
- [ ] Testou por 1-2 horas em TESTNET
- [ ] Leu pelo menos **COMECE_AQUI.md**
- [ ] Sabe onde encontrar o `log_balanceamento.log`
- [ ] Confia no sistema e está pronto para operar

---

## 🚀 PRÓXIMO PASSO

Escolha:

### Opção 1: Interface Gráfica (Recomendado)
```bash
python interface_graficabalanceamento.py
```
Clique em "Iniciar Robô"

### Opção 2: Linha de Comando
```bash
python robo_balanceamento.py
```
E deixe rodando

---

## 💡 DICAS PRO

1. **Comece pequeno:** $100-500 em TESTNET primeiro
2. **Paciência:** Teste 2-3 horas antes de REAL
3. **Monitore:** Abra logs periodicamente
4. **Varie:** Teste diferentes percentuais
5. **Documente:** Guarde capturas de tela do log

---

**Versão:** 1.0  
**Data:** Abril 2026  
**Status:** Pronto para Uso! 🎉

---

*Dúvidas? Veja:*
- COMECE_AQUI.md (rápido)
- ROBO_BALANCEAMENTO_GUIA.md (completo)
- Arquivo log_balanceamento.log (debug)