Add comprehensive documentation and rulebook for TapeReading WDO/WIN automation

README.md

@@ -0,0 +1,38 @@
+# Tapereading-
+
+Base profissional para conceber, pesquisar, implementar, auditar e evoluir uma automação de Tape Reading no ProfitPro, com foco principal em Mini Dólar (WDO) e suporte operacional a Mini Índice (WIN).
+
+## Objetivo
+
+Criar uma automação profissional que interprete fluxo de ordens, agressões, absorções, desequilíbrios, exaustão, liquidez, notícias, correlações e comportamento de players, usando o ProfitPro como ambiente de execução e controle operacional.
+
+## Documentação inicial
+
+- [`docs/tape-reading-wdo.md`](docs/tape-reading-wdo.md): fundamentos, conceitos e técnicas de Tape Reading aplicadas ao Mini Dólar.
+- [`docs/product-vision.md`](docs/product-vision.md): visão de produto, diferenciais e módulos principais da ferramenta.
+- [`docs/mvp-roadmap.md`](docs/mvp-roadmap.md): proposta de MVP, fases de entrega e critérios de validação.
+- [`docs/senior-execution-plan.md`](docs/senior-execution-plan.md): plano de execução sênior para transformar a ideia em produto profissional.
+- [`docs/research-confluence-matrix.md`](docs/research-confluence-matrix.md): matriz de sinais, confluências, invalidações e referências.
+- [`docs/professional-requirements.md`](docs/professional-requirements.md): requisitos para evitar uma ferramenta banal e orientar o padrão profissional.
+- [`docs/references.md`](docs/references.md): bibliografia anotada com fontes oficiais, funcionais e acadêmicas.
+- [`docs/production-automation-blueprint.md`](docs/production-automation-blueprint.md): arquitetura profissional da automação, com camadas de dados, decisão, execução, proteção e auditoria.
+- [`docs/execution-rulebook.md`](docs/execution-rulebook.md): rulebook de entrada, saída, proteção e bloqueios para WDO e WIN.
+- [`docs/research-investigation-protocol.md`](docs/research-investigation-protocol.md): protocolo de investigação rastreável com fonte, busca, justificativa, limitação e critério de validação.
+- [`docs/macro-news-risk.md`](docs/macro-news-risk.md): filtro de notícias, macro, correlações e regras de bloqueio.
+- [`docs/profitpro-ntsl-research-map.md`](docs/profitpro-ntsl-research-map.md): mapa de pesquisa ProfitPro/NTSL/Automação para confirmar dados e funções antes da implementação.
+- [`docs/big-players-and-market-map.md`](docs/big-players-and-market-map.md): critérios para mapear big players por comportamento, impacto e recorrência.
+- [`docs/source-search-log.md`](docs/source-search-log.md): log de buscas, fontes escolhidas, fontes rejeitadas e impacto no projeto.
+- [`docs/wdo-research-questions.md`](docs/wdo-research-questions.md): 100 perguntas de investigação aprofundada focadas exclusivamente em Mini Dólar (WDO), ProfitPro/Nelogica e automação.
+- [`docs/wdo-research-harness-master-prompt.md`](docs/wdo-research-harness-master-prompt.md): prompt mestre para execução controlada e auditável do harness WDO sem alterar estratégia, parâmetros ou custos.
+
+## Premissas
+
+- O foco principal é WDO, com WIN como ativo secundário e regras separadas.
+- A solução deve automatizar leitura, decisão, execução, proteção, bloqueio e auditoria.
+- Nenhuma regra entra em produção sem fonte rastreável, teste, replay, simulação e validação.
+- A automação deve priorizar não operar quando as condições não estiverem completas.
+- O projeto deve tratar capital real com controle de risco, logs e revisão sênior.
+
+## Aviso de risco e responsabilidade
+
+Este projeto trata de automação para ambiente real de mercado e, portanto, deve ser desenvolvido com validação, auditoria, limites de risco e homologação antes de qualquer execução com capital. A documentação não promete resultado e não substitui controles formais de risco, conformidade, corretora, plataforma e supervisão humana.

docs/big-players-and-market-map.md

@@ -0,0 +1,126 @@
+# Big Players, Participantes e Mapa de Mercado
+
+## Objetivo
+
+Definir como a ferramenta deve observar participantes relevantes sem transformar nomes de corretoras em crença operacional. O foco é comportamento, saldo, agressão, impacto no preço e recorrência.
+
+## Princípio
+
+Um player relevante não é definido apenas pelo nome. Ele é definido por comportamento mensurável:
+
+- volume acima da média;
+- saldo consistente;
+- agressão em sequência;
+- defesa de preço;
+- impacto no deslocamento;
+- repetição em regiões importantes;
+- atuação em horários críticos;
+- relação com notícia ou vencimento.
+
+## Dados necessários
+
+- Times & Trades;
+- compradores;
+- vendedores;
+- saldo por participante;
+- ordem original;
+- agressão líquida;
+- evolução no tempo;
+- Volume At Price por participante, se disponível;
+- book/DOM por agente, se disponível.
+
+## Participantes a mapear por comportamento
+
+Categorias:
+
+- bancos locais;
+- bancos estrangeiros;
+- corretoras com fluxo institucional;
+- corretoras com fluxo de varejo relevante;
+- HFT/market makers;
+- hedgers;
+- fundos;
+- players associados a rolagem/vencimento;
+- RLP ou fluxo internalizado, quando aplicável.
+
+## Score de player relevante
+
+O score deve considerar:
+
+```text
+score_player = volume_relativo
+             + saldo_consistente
+             + agressao_sequencial
+             + impacto_no_preco
+             + permanencia_no_lado
+             + atuação_em_região_relevante
+             - ruído_de_micro_lotes
+             - reversão_frequente_de_lado
+```
+
+## Regras de uso
+
+### Pode aumentar confiança quando
+
+- player aparece com saldo crescente no lado do setup;
+- agressão do player desloca preço;
+- atuação ocorre em região técnica/volumétrica relevante;
+- atuação acompanha outros dados de fluxo.
+
+### Deve reduzir confiança quando
+
+- player troca de lado rapidamente;
+- volume não desloca preço;
+- atuação é isolada;
+- há absorção contra o player;
+- há notícia ou evento distorcendo o fluxo.
+
+### Deve bloquear inferência quando
+
+- dados de player estão indisponíveis;
+- identificação não é confiável;
+- há divergência entre saldo e preço;
+- o mercado está em condição extrema.
+
+## Big players e WDO
+
+No WDO, a ferramenta deve priorizar:
+
+- bancos e corretoras com saldo relevante;
+- participantes que aparecem em agressão sequencial;
+- players que defendem regiões repetidamente;
+- players que atuam em horários de maior liquidez;
+- players que aparecem próximos a notícia ou vencimento.
+
+## Big players e WIN
+
+No WIN, a ferramenta deve priorizar:
+
+- fluxo direcional associado a rompimentos;
+- atuação em regiões de VWAP/POC;
+- comportamento de players em conjunto com ações líderes;
+- confirmação ou divergência com WDO.
+
+## Auditoria de player
+
+Cada evento de player relevante deve registrar:
+
+```text
+Player/corretora:
+Ativo:
+Horário:
+Preço:
+Lado:
+Volume:
+Saldo anterior:
+Saldo posterior:
+Agressão:
+Região:
+Impacto no preço:
+Confluências:
+Resultado após 5s/10s/30s/60s:
+```
+
+## Proibição operacional
+
+A automação não deve entrar apenas porque um player apareceu. Player é confluência, não gatilho suficiente.