Robo GR Estrategista Trader

1. Introducao

O Robo GR Estrategista Trader e uma plataforma de automacao para operacoes em Day Trade, projetada para trabalhar em conjunto com plataformas de negociacao como Profit Ultra e BlackArrow Ultra. O sistema utiliza leitura OCR (Reconhecimento Optico de Caracteres) para monitorar indicadores da plataforma em tempo real e executar acoes automaticas de gestao de risco e reducao de posicao.

Principais funcionalidades:

• Monitoramento em tempo real de MEP, MEN, Resultado Aberto e Resultado do Dia
• Zeragem automatica ao atingir metas de ganho ou limites de perda
• Reducao escalonada de posicao (sizing) para controle de lote
• Hedge entre contas e protecao contra inversao de posicao
• Suporte a multiplos profits simultaneos (modo Multi — plano PRO)
• Diagnostico OCR com screenshots e metricas de qualidade
• Alertas por email quando metas sao atingidas
• Interface web moderna com painel de indicadores em tempo real
• Plano Monitor para acompanhamento somente leitura

2. Primeiros Passos

2.1 Requisitos do Sistema

• Windows 10 ou 11 (64 bits)
• Tesseract OCR instalado (obrigatorio)
• WebView2 Runtime (instalado automaticamente)
• Plataforma de trading: Profit Ultra ou BlackArrow Ultra
• Conexao com internet para login e verificacao de licenca

2.2 Instalacao

Execute o instalador RoboGRProfit_Setup_v5.5.exe. O instalador ira:

• Copiar os arquivos do programa para a pasta escolhida
• Verificar se o Tesseract OCR esta instalado (necessario para leitura)
• Criar atalhos no Desktop e Menu Iniciar
• Instalar o WebView2 Runtime (se necessario)

2.3 Primeiro Login

Ao abrir o programa pela primeira vez, voce vera a tela de login:

1. Clique em "Criar conta" na tela de login
2. Preencha usuario, senha e email
3. O sistema criara sua conta com status "pendente"
4. Aguarde a ativacao pelo administrador (o admin define seu plano e licenca)
5. Apos ativacao, faca login normalmente

2.4 GR-ID (Identificador de Instalacao)

O GR-ID e um identificador unico gerado automaticamente para cada instalacao. Ele serve para:

• Identificar sua maquina junto ao administrador
• Controlar o licenciamento (1 licenca por instalacao)
• Voce pode ver e copiar seu GR-ID no perfil (canto superior direito)

2.5 Fluxo Correto para Comecar

Siga esta sequencia para configurar e iniciar o robo:

1. Abra a plataforma de negociacao (Profit ou BlackArrow)
2. Posicione a janela no monitor desejado
3. Abra o Robo GR e faca login
4. Va em Config > Selecione o monitor correto
5. Adicione/edite o profit (associar a janela da plataforma)
6. Calibre as regioes de leitura OCR e botoes
7. Use "Preview" para testar cada calibracao
8. Volte para Inicio e clique "Iniciar"

3. Planos e Licenciamento

O Robo GR opera com sistema de planos que definem os recursos disponiveis. Existem 4 niveis:

3.1 Plano Free

Conta pendente ou inativa. O login e bloqueado ate que o administrador ative um plano.

3.2 Plano Monitor

Ideal para acompanhamento. Permite login, configuracao de 1 profit e monitoramento OCR em tempo real. O motor de execucao NAO funciona — voce ve todos os indicadores (MEP, MEN, Resultado, Lotes) mas nenhuma acao automatica e tomada. Metas de perda e ganho continuam configurav eis para disparo de alertas por email.

3.3 Plano Starter

Plano de entrada com execucao. Permite 1 profit no modo Single com gestao de risco completa: zeragem automatica ao atingir metas, bloqueio de dia, e todas as funcoes basicas de protecao.

3.4 Plano Pro

Plano completo com todos os modulos de protecao. Permite ate 3 profits simultaneos no modo Multi, alem de Sizing, Hedge, Emergencia de Lotes e Anti-Inversao.

3.5 Licenca

Cada usuario possui uma licenca com:

• Chave unica (formato GR-XXXXX)
• Data de validade (definida pelo administrador)
• Numero maximo de profits (conforme o plano)
• A licenca e verificada a cada login

Para renovar ou fazer upgrade de plano, entre em contato pelo WhatsApp.

4. Interface do Painel

A interface e dividida em 3 abas principais acessiveis pela barra de navegacao superior: Inicio, Config e Ajuda.

4.1 Aba Inicio (Home)

A aba principal mostra:

• Controles: Botoes Iniciar, Pausar, Retomar e Encerrar o robo
• Seletor de modo: Single ou Multi, selecao de plataforma e profit
• Feature toggles: Atalhos para ativar/desativar modulos rapidamente (conforme seu plano)
• Painel de indicadores em tempo real (faixa colorida):

• Informacoes de conta: Conta Padrao e Conta Geral (PRO)
• Acoes rapidas: Atualizar Leitura, Limpar dados, Limpar logs, Copiar logs
• Status: OCR % (qualidade de leitura), Status de monitoramento, Dia bloqueado
• Meta Ganho / Meta Perda: Valores configurados visiveis na barra superior
• Cards de profit (modo Multi): painel individual por profit com indicadores

4.2 Aba Config (Configuracoes)

A aba de configuracao permite:

• Selecionar o monitor onde a plataforma esta aberta
• Visualizar e selecionar janelas de plataforma disponiveis
• Adicionar, editar e remover profits
• Calibrar regioes OCR e posicoes de botoes
• Configurar parametros de risco e sizing por profit
• Salvar/carregar templates de calibracao
• Ajustar timers globais (ciclo, transicao, zeragem)

4.3 Aba Ajuda

Contem FAQ com perguntas frequentes organizadas por categoria, link para este manual e acesso ao suporte via WhatsApp.

4.4 Perfil (Canto Superior Direito)

Ao clicar no icone de perfil, voce ve:

• Seu GR-ID (com botao de copiar)
• Plano atual (Free, Monitor, Starter ou Pro) com badge colorida
• Status de acesso (ativo/inativo)
• Validade da licenca e dias restantes
• Botao de logout

5. Configuracao de Profits

Um "profit" representa uma instancia da plataforma de negociacao que o robo ira monitorar. Cada profit tem sua propria configuracao de regioes OCR, botoes e parametros de risco.

5.1 Limite de Profits por Plano

5.2 Adicionando um Profit

1. Va em Config
2. Selecione o monitor onde a plataforma esta aberta
3. Clique em "Atualizar janelas" para listar as plataformas disponiveis
4. Selecione a janela desejada na lista
5. De um nome ao profit (ex: "Mini Indice", "Mini Dolar")
6. Clique em "Adicionar" para criar o profit

5.3 Editando um Profit

Clique no nome do profit na lista de Config para expandir e ver todas as opcoes:

• Nome: identificacao do profit
• Plataforma: janela associada (pode trocar se reposicionar)
• Calibracoes: regioes OCR e posicoes de botoes
• Risco: metas, parametros de zeragem
• Sizing: lote maximo, reducao (PRO)
• Sobreposicao: hedge entre contas (PRO)

5.4 Removendo um Profit

Clique no botao de lixeira ao lado do profit na lista de Config. Uma confirmacao sera solicitada. A remocao e irreversivel.

6. Calibracao Completa (OCR e Botoes)

A calibracao e o passo mais importante para o funcionamento correto do robo. Ela define quais areas da tela o robo deve ler (OCR) e onde clicar (botoes).

6.1 Como Calibrar uma Regiao OCR

1. Abra a plataforma de trading e deixe ela visivel na tela
2. No Robo GR, va em Config > selecione o profit
3. Na secao Calibracoes, clique no botao "Calibrar" ao lado da regiao desejada
4. A tela ficara escurecida — clique e arraste para selecionar a area exata do indicador na plataforma
5. Solte o mouse para confirmar a selecao
6. Clique em "Preview" para verificar se a leitura esta correta
7. Se estiver OK, a regiao esta calibrada (indicador verde)

6.2 Regioes OCR Disponiveis

6.3 Dicas de Calibracao OCR

• Selecione APENAS o numero: evite incluir labels, bordas ou icones na selecao
• Margem minima: deixe 2-3 pixels de margem ao redor do numero
• Fundo limpo: o fundo da area selecionada deve ser uniforme (preferencialmente escuro)
• Sem sobreposicao: nenhuma outra janela pode ficar sobre a plataforma durante a calibracao
• Zoom 100%: mantenha a plataforma em zoom 100% para melhor leitura
• Nao mova a janela: apos calibrar, nao reposicione a janela da plataforma

6.4 Calibracao de Botoes

O robo precisa saber a posicao exata dos botoes na plataforma para executar acoes de zeragem e envio de ordens.

6.5 Como Calibrar um Botao

1. Na secao Botoes do profit, clique em "Calibrar"
2. A tela ficara escurecida — clique exatamente no centro do botao na plataforma
3. A coordenada [x, y] sera salva automaticamente
4. O indicador ficara verde quando calibrado

6.6 Templates de Calibracao

Voce pode salvar a calibracao de um profit como template e reutilizar em outros profits que usam a mesma plataforma/resolucao:

1. Calibre completamente um profit
2. Va em Config > Templates
3. Clique em "Salvar como Template"
4. De um nome ao template (ex: "Profit Ultra 1920x1080")
5. Para aplicar: selecione o profit destino e clique "Carregar Template"

7. Modos de Execucao

7.1 Modo Single

No modo Single, o robo opera UM unico profit por vez. A plataforma fica em foco exclusivo e o robo le e age continuamente naquela janela.

• Disponivel para: Starter e Pro
• Selecao: escolha qual profit operar no seletor da aba Inicio
• Vantagem: leitura mais rapida e estavel (sem troca de janela)

7.2 Modo Multi

No modo Multi, o robo opera VARIOS profits simultaneamente, alternando entre as janelas em sistema round-robin (rodizio).

• Disponivel para: plano PRO apenas (ate 3 profits)
• O robo alterna entre as janelas a cada ciclo
• Cada profit tem seu proprio painel de indicadores na aba Inicio
• Delay de transicao configuravel entre as trocas de janela

8. Gestao de Risco

O sistema de gestao de risco e o nucleo do robo. Ele monitora indicadores da plataforma e executa zeragem automatica quando limites sao atingidos. Disponivel nos planos Starter e Pro.

8.1 Meta de Ganho e Limite de Perda

Voce define dois limites diarios por profit:

• Meta de Ganho (meta_ganho): valor em R$ de lucro diario desejado
• Limite de Perda (meta_perda): valor em R$ de perda maxima diaria aceita (insira como numero positivo — ex: 500 para perda de R$ 500)

Quando o resultado do dia atinge qualquer uma dessas metas, o robo executa a zeragem automatica da posicao e bloqueia o dia.

8.2 Como Configurar Metas

1. Va em Config > selecione o profit
2. Na secao Risco, ative o toggle de risco
3. Preencha Meta Perda (R$) — ex: 300
4. Preencha Meta Ganho (R$) — ex: 600
5. Opcionalmente, ajuste o Max Valor Plausivel (limite de OCR)
6. Salve a configuracao

8.3 MEP e MEN (Pico de Ganho e Perda)

MEP (Maior Exposicao Positiva) e MEN (Maior Exposicao Negativa) sao os picos de resultado registrados. O robo aciona zeragem quando:

• PICO_GANHO: MEP ≥ meta_ganho → zeragem automatica
• PICO_PERDA: MEN ≤ meta_perda (negativo) → zeragem automatica

8.4 Dia Bloqueado

Quando qualquer meta e atingida, o dia entra em estado "Bloqueado":

• O robo para de executar acoes de trading
• Se uma nova posicao surgir, o robo zera automaticamente (protecao)
• O status "Dia Bloqueado: Sim" aparece no painel em laranja
• O bloqueio persiste ate o fim da sessao ou reset manual

8.5 Indicadores em Tempo Real

9. Modulos de Protecao (PRO)

Os modulos avancados estao disponiveis exclusivamente no plano PRO e oferecem camadas adicionais de seguranca.

9.1 Reducao de Posicao (Sizing)

Monitora o numero de contratos e reduz a posicao quando ela excede o lote maximo.

• lote_max: numero maximo de contratos aceitos na posicao
• lote_minimo: incremento minimo de lote (0.01, 0.1 ou 1)
• A reducao e feita de forma escalonada, enviando ordens parciais
• max_contratos_reducao: limite de contratos por ordem de reducao
• preco_contrato: valor unitario do contrato (para calculo financeiro)

Como configurar Sizing:

1. Config > Profit > ative o toggle Sizing
2. Defina o Lote Maximo (ex: 5 contratos)
3. Defina o Lote Minimo (normalmente 1)
4. Calibre: regiao_pos_total, regiao_direcao_sizing, regiao_total
5. Calibre botoes: pos_compra, pos_venda, pos_qtd_boleta, pos_enviar_popup

9.2 Hedge entre Contas (Sobreposicao)

Compara Conta Padrao vs Conta Geral para detectar posicoes em contas diferentes.

• sobreposicao_tolerancia: diferenca tolerada (0 = qualquer diferenca aciona)
• Requer calibracao de: regiao_conta_padrao e regiao_conta_geral

Como configurar Hedge:

1. Config > Profit > ative o toggle Sobreposicao
2. Defina a Tolerancia (em R$)
3. Calibre: regiao_conta_padrao e regiao_conta_geral

9.3 Limite de Posicao

Impede que a posicao ultrapasse um numero maximo de contratos.

• hedge_max_contratos: limite maximo de contratos permitidos
• hedge_auto_max_contratos: limite para acionamento automatico
• hedge_pct_limite: percentual do limite (100% = limite total)

9.4 Emergencia de Lotes

Protecao de ultimo recurso quando a posicao atinge niveis criticos.

• emergencia_qtd_limite: quantidade que aciona a emergencia
• emergencia_qtd_acao: acao a tomar:
  • "so_excedente": reduz apenas o excedente
  • "zerar_tudo": zera toda a posicao
• Executa com prioridade maxima, ignorando delays normais

9.5 Anti-Inversao

Detecta inversao inesperada de posicao (ex: estava comprado e virou vendido sem ordem do trader) e executa zeragem de emergencia.

• inversao_protecao: ativar/desativar o modulo
• Requer calibracao da regiao de direcao (regiao_direcao_sizing)
• inversao_acao: acao ao detectar inversao (padrao: "zerar_tudo")

10. Plano Monitor — Como Funciona

O plano MONITOR e ideal para quem deseja acompanhar suas operacoes em tempo real sem que o robo execute acoes automaticas.

10.1 O que o Monitor faz

• Leitura OCR em tempo real de todos os indicadores (MEP, MEN, Resultado Aberto, Resultado do Dia, Lotes, Direcao)
• Exibicao dos indicadores no painel (mesma interface visual dos outros planos)
• Configuracao de metas de perda e ganho para disparo de alertas por email
• Historico de leituras e logs

10.2 O que o Monitor NAO faz

• NAO executa zeragem automatica de posicao
• NAO executa reducao de lotes (sizing)
• NAO executa hedge entre contas
• NAO tem botao "Iniciar" habilitado para execucao de motor
• NAO mostra toggles de features (risco, sizing, sobreposicao)

10.3 Configurando o Monitor

1. Faca login com sua conta (plano Monitor ativo)
2. Va em Config e adicione 1 profit
3. Calibre as regioes OCR basicas (regiao_res_aberto, regiao_res_dia)
4. Nao e necessario calibrar botoes de zeragem (o motor nao executa)
5. Na secao de Metas, configure meta_perda e meta_ganho para receber alertas
6. Volte ao Inicio — os indicadores ja estarao atualizando

10.4 Alertas por Email no Monitor

Mesmo sem execucao, o plano Monitor envia alertas por email quando as metas configuradas sao atingidas. Assim voce sabe que precisa agir manualmente.

11. Alertas por Email

O sistema envia alertas automaticos por email em diversas situacoes:

11.1 Tipos de Alerta

11.2 Configuracao

Os alertas sao enviados automaticamente para o email cadastrado na sua conta. Nao e necessaria configuracao adicional — basta ter metas configuradas.

12. Diagnostico, Logs e OCR

12.1 Tipos de Log

O robo gera logs detalhados organizados por data:

• geral.txt: log em texto simples (legivel por humanos)
• geral.jsonl: log estruturado em JSON (1 evento por linha)
• Localizacao: pasta logs/YYYY-MM-DD/ dentro do diretorio do programa

12.2 Tipos de Evento

12.3 Screenshots de Diagnostico

Quando o OCR falha 3 vezes consecutivas, o robo salva automaticamente uma screenshot da area em logs/YYYY-MM-DD/ocr_diag/.

12.4 Indicador OCR %

O indicador OCR % mostra a taxa de sucesso das leituras. Valores abaixo de 80% indicam problemas de calibracao. Verifique:

• Se a janela da plataforma esta visivel e nao sobreposta
• Se a resolucao do monitor nao mudou desde a calibracao
• Se as regioes calibradas ainda correspondem aos indicadores corretos

12.5 Acoes de Log no Painel

• Copiar logs: copia os logs do mini-log para a area de transferencia
• Limpar logs: apaga todos os arquivos de log do dia atual
• Limpar dados: reseta o estado do gestor (indicadores, memoria, contadores)

13. Parametros Avancados

Estes parametros controlam o comportamento fino do robo. Altere com cuidado.

14. Problemas Comuns e Solucoes

O robo nao encontra a janela da plataforma

• Verifique se a plataforma (Profit/BlackArrow) esta aberta e visivel
• Clique em "Atualizar janelas" na aba Config
• Verifique se o monitor correto esta selecionado
• A janela nao pode estar minimizada

Os numeros nao atualizam / DESCASAMENTO

• Recalibre as regioes OCR (a janela pode ter mudado de posicao)
• Use "Preview" para testar cada regiao
• Verifique o indicador OCR % (deve estar acima de 80%)
• Nao sobreponha outras janelas sobre a plataforma

Erro de OCR frequente

• Aumente o valor de "max_valor_plausivel" se leituras validas estao sendo rejeitadas
• Verifique se o Tesseract OCR esta instalado corretamente
• Tente recalibrar com a plataforma em zoom 100%
• Veja as screenshots de diagnostico em logs/ocr_diag/

Licenca expirada ou inexistente

• Verifique os dias restantes no perfil
• Contate o suporte pelo WhatsApp para renovacao
• O GR-ID deve corresponder ao registrado no sistema

O robo nao executa zeragem

• Verifique se o modulo de risco esta ativo (toggle ligado)
• Verifique se as metas estao configuradas (meta_ganho e meta_perda)
• Verifique se os botoes de zeragem estao calibrados corretamente
• Plano Monitor nao executa zeragem — faca upgrade para Starter
• Veja os logs para mensagens de erro

Interface nao abre / Tela em branco

• Verifique se o WebView2 Runtime esta instalado
• Tente executar como Administrador
• Verifique o arquivo logs/launcher_stderr.txt para erros

Botao "Iniciar" bloqueado

• Se voce esta no plano MONITOR: o motor de execucao nao esta disponivel. Faca upgrade para Starter ou Pro
• Se a licenca expirou: renove pelo WhatsApp
• Se o dia esta bloqueado: o robo nao inicia novamente no mesmo dia

15. Perguntas Frequentes (FAQ)

O robo faz operacoes de compra e venda?

Nao. O robo atua exclusivamente na gestao de risco. Ele zera posicoes e reduz lotes, mas as entradas (trades) sao feitas manualmente pelo trader.

Posso usar em mais de um computador?

Cada licenca e vinculada a um GR-ID (instalacao). Para usar em outro computador, entre em contato com o suporte para transferir a licenca.

Qual a diferenca entre Monitor e Starter?

MONITOR = somente leitura. Ve os indicadores e recebe alertas por email, mas o robo nao executa acoes. STARTER = execucao ativa. Alem de ver, o robo zera posicoes automaticamente quando metas sao atingidas.

Preciso calibrar tudo de novo se mudar de plano?

Nao. As calibracoes ficam salvas no profit. Ao fazer upgrade, as calibracoes existentes continuam validas.

O robo funciona com a plataforma minimizada?

Nao. A plataforma precisa estar visivel na tela para a leitura OCR funcionar. Nao minimize e nao sobreponha outras janelas.

Quanto tempo demora para o robo zerar?

A zeragem e executada no proximo ciclo apos detectar que a meta foi atingida. Com o timer padrao de 10 segundos, a deteccao ocorre em ate 10s e a zeragem e imediata.

Posso usar com mini dolar e mini indice ao mesmo tempo?

Sim, no plano PRO com modo Multi. Crie um profit para cada ativo e o robo alterna entre eles automaticamente.

Como faco upgrade de plano?

Entre em contato pelo WhatsApp. O administrador altera o plano e ativa a licenca em minutos.

O que acontece se a internet cair?

O robo continua funcionando localmente (OCR e acoes de zeragem nao dependem de internet). Apenas o login inicial e verificacao de licenca precisam de conexao.

Posso usar em conta demo/simulador?

Sim. O robo le a tela independente de ser conta real ou demo. E uma otima forma de testar e calibrar.

16. Suporte e Contato

Para suporte tecnico, duvidas, renovacao de licenca ou upgrade de plano:

estrategistatrader.com.br

Ao entrar em contato, tenha em maos:

• Seu GR-ID (visivel no perfil do app)
• Descricao do problema
• Screenshots da tela (se aplicavel)
• Logs do dia (use "Copiar logs" no painel)
• Seu plano atual e status da licenca