QuantFX — ML-Forex

Sistema de geração de sinais para Forex, índices e commodities baseado em ensemble de modelos de Machine Learning com validação rigorosa e gestão de risco automática.

Status atual

• Versão EA: v2.27
• Versão API: 2.0.0
• Modelos aprovados: 71/72 (taxa 98.6%)
• Maturidade global: 8.7/10 — Production-grade SaaS

Como navegar nesta documentação

Seção	Quando ler
Arquitetura	Para entender como o sistema funciona (ML, EA, API)
Operação	Para deploy, troubleshooting, runbook de emergência
Desenvolvimento	Onboarding, ambiente local, retreino
API	Autenticação, endpoints, exemplos de integração
Decisões (ADRs)	Por que escolhemos CPCV, Conformal, Eduzz etc.

Em 30 segundos

flowchart LR
    MT5[MetaTrader 5<br/>Corretora] -->|candles| Collector
    Collector --> DB[(PostgreSQL<br/>particionado)]
    DB --> ML[ML Pipeline<br/>LGBM+XGB+CAT]
    ML --> API[FastAPI<br/>+ Auth]
    API -->|sinais| EA[EA v2.27<br/>multi-símbolo]
    API -->|broadcast| Telegram & Discord
    Eduzz[Eduzz<br/>checkout] -.->|webhook| API
    API -->|provisiona| Email[Email + UUID key]

Stack

Camada	Tecnologia
ML	LightGBM + XGBoost + CatBoost · CPCV · Conformal Prediction · Meta-labeling
Backend	FastAPI · asyncpg · Redis · PostgreSQL 16 particionado
Frontend	HTML + Vanilla JS + Chart.js (dashboards, área do assinante)
EA	MetaTrader 5 · MQL5 (1852 linhas, multi-símbolo)
Infraestrutura	Docker · Hostinger VPS · Cloudflare Tunnel · WireGuard VPN
Pagamento	Eduzz (webhook HMAC-SHA256 + email auto)
Backup	Backblaze B2 (us-east-005) — RTO 30min / RPO 24h
Observability	Grafana · MLflow · UptimeRobot
Docs	MkDocs Material

Princípios técnicos

1. Honestidade estatística — track record é forward, sem look-ahead. Cobertura conformal real.
2. Validação rigorosa — CPCV (não walk-forward simples) para evitar overfit; quality gates em produção (AUC ≥ 0.58, PF ≥ 0.95).
3. Idempotência — webhooks Eduzz, upserts por ticket MT5, partições mensais auto-criadas.
4. Fail-closed — sem EDUZZ_SECRET o webhook rejeita; chave sem expiração-default vira "inválida"; sem API_KEY no env é dev-mode.
5. Multi-tenant by design — toda chave tem plan_tier, symbols_allowed, tfs_allowed, expires_at. Rate limit por plano. Anti-key-sharing.
6. DR primeiro — backup diário B2 com sticky retention para modelos (histórico permanente).

---

Última atualização: ver canto inferior direito de cada página.