🛠️ Troubleshooting & Recuperação de Desastres

Este guia detalha os procedimentos para identificar e corrigir falhas nos três pilares do ecossistema OBrain.

1. Falha de Conectividade: O Túnel "Caiu"

Sintoma: O main.py loga ConnectionError ou 404 ao tentar despachar o HMAC para a Cloudflare. Causa provável: O container cloudflared perdeu o handshake com a borda devido a uma troca de IP da operadora (CGNAT). Ação Imediata:

docker compose restart cloudflared

Verificação: Acesse o painel Cloudflare Zero Trust > Networks > Tunnels e verifique se o status do túnel está HEALTHY.

2. Bloqueio de Ingestão: Google 429 (Rate Limit)

Sintoma: O Log do M4 mostra WARNING - Google Trends Rate Limit Detected. Entering Sleep Mode. Causa: O Stealth Jitter não foi suficiente para mascarar o volume de requisições do seu IP atual. Ação: O sistema já possui um auto-recovery de 10 minutos. Se o erro persistir por mais de 3 ciclos:

• Reinicie seu modem/roteador para forçar a troca de IP público.
• Reduza o paralelismo no seed_processor.py. Prevenção: Considere ativar a rota de Proxy no accelerator.py.

3. Falha de Visão: 1688 VLM Extraction

Sintoma: O ROI volta como 0.0 ou o status é SOURCING_FAILED. Causa: O 1688 apresentou um pop-up de login ou captcha que o Playwright não conseguiu contornar antes do screenshot. Ação de Debug:

• Rode o script em modo headless=False localmente para ver o que o navegador está "enxergando".
• Verifique se os créditos da API de Visão (Groq/GPT-4o) não expiraram.

4. Divergência de Segurança: HMAC Invalid

Sintoma: O Worker da Cloudflare retorna 403 Forbidden e o log diz Invalid Signature. Causa: Inconsistência na serialização do JSON entre Python e V8. Ação: Certifique-se de que nenhum campo float no Python está sendo enviado com dízimas infinitas. Use round(valor, 4) antes de despachar. O buffer precisa ser idêntico em ambos os lados.

📊 Matriz de Resiliência