Sistema de optimización MAT + Decision Resilience Engine (DRE)

Framework de investigación y ejecución para optimización cuantitativa resiliente:

• MAT: backtest compuesto BTC/ETH (futuros USDT) con ventanas deslizantes, funding y optimización de reglas de señal.
• DRE (MVP): orquestador con FSM, governance append-only, checkpoints/resume, API FastAPI, storage memoria/Redis y puente de medición a MAT.

Aviso legal: software experimental para investigación. El rendimiento pasado no garantiza resultados futuros.

Qué aporta este proyecto

• Reproducibilidad: CI y tests activos, dataset sintético y contratos versionados.
• Resiliencia de decisiones: flujo con estados, auditoría, colisión run_id/data_hash, checkpoints y reanudación.
• Operabilidad real: API HTTP, almacenamiento Redis opcional y trazas append-only en SQLite.
• Extensibilidad: separación clara entre simulador MAT, skills DRE y contratos ICD.

Instalación

Uso rápido desde PyPI (MAT)

pip install sistema-optimizacion-mat

Entorno completo del repo (MAT + DRE)

pip install -r requirements.txt -r requirements-dev.txt

Inicio rápido MAT

python scripts/bootstrap_synthetic_candles_db.py
pytest tests/ -q
python compound_optimize_runner.py --db data/synthetic_signal_tune.db --holdout-frac 0.2

Salida: JSON en stdout (por ejemplo p_win_terminal, p_ruin, walk_forward).

Optimización de señales:

python scripts/optimize_signal_grid.py --db data/synthetic_signal_tune.db --preset smoke --skip-pairs --holdout-frac 0.2

• Dataset esperado: docs/DATASET.md
• Ejemplos --signal-config: docs/signal_rules_examples.md

API DRE (MVP)

Levantar servicio:

python scripts/run_dre_api.py --db data/dre_governance.sqlite

Endpoints:

• GET /dre/health
• POST /dre/simulate
• POST /dre/resume

Ejemplo mínimo:

curl -X POST "http://127.0.0.1:8000/dre/simulate" \
  -H "Content-Type: application/json" \
  -d '{
    "run_id": "opt_20260506_000100_v5.0",
    "data_hash": "sha256:demo",
    "rng_seed": 7,
    "variant": "standard"
  }'

Arquitectura y documentos

• Índice docs: docs/README.md
• PDR DRE (01–05): docs/pdr/README.md
• Arquitectura técnica DRE v1.1: docs/DRE_TECHNICAL_ARCHITECTURE.md
• Estado implementación vs roadmap: docs/DRE_IMPLEMENTATION_STATUS.md
• Módulo DRE: dre/README.md

Estado actual

• Tests: pytest tests/ -q (incluye test_dre_*).
• Calidad: ruff check ..
• main con pipeline estable y documentación lista para comité técnico.

Licencia y seguridad

• Licencia: MIT
• Reporte de seguridad: SECURITY.md
• Historial: CHANGELOG.md