Arquitetura

Esta seção descreve como o sistema é construído e por que cada peça existe.

Páginas

• Visão Geral — diagrama de fluxo end-to-end (candle → sinal → operação)
• ML Pipeline — CPCV, Conformal, Meta-labeling, Triple-barrier
• Expert Advisor — slots, time-stop, trailing, breakeven, conectividade
• API & Backend — routers, rate limiting, anti-share, OpenAPI
• Multi-Tenancy — fluxo Eduzz → UUID → email → revogação

Princípios arquiteturais

1 — Separação por boundary

• Worker lê candles, treina e publica predições no DB.
• API apenas serve dados — não toca em pipeline.
• EA consome /api/scan — não roda modelo localmente.
• Frontend consome /api/account/* e /api/public/stats.

2 — DB como source of truth

Sem mensageria assíncrona (Kafka, etc.). PostgreSQL com partições mensais cobre throughput atual (≈40 slots × 4 TFs × 1 update/min).

3 — Fail-closed everywhere

Webhook sem secret = HTTP 403. Chave sem expiração-default = inválida. UUID malformada = 401. Worker sem candles = /api/health → 503.

4 — Idempotência > retries

• Webhook Eduzz: idempotente por email
• Executions: idempotente por ticket
• Partições: idempotente por mês
• Modelos: idempotente por hash do treino