Grid + Trailing System

Nueva línea base limpia para el proyecto de trading algorítmico orientado a la estrategia Grid + Trailing. Este repositorio contiene únicamente el código y los scripts necesarios para continuar con el desarrollo sin el peso de historiales, datasets ni artefactos obsoletos.

Estructura

• backend/: API FastAPI, motor de ejecución y lógica de estrategias.
• frontend/: Interfaz Next.js para monitoreo y control.
• scripts/: Utilidades operativas, incluyendo descarga de datos (download_binance_data.py).
• data/: Carpeta vacía salvo real_binance_5d_backup.tar.gz y marcadores .gitkeep; todos los datasets deben mantenerse fuera de git.
• models/ y reports/: Directorios ignorados por git para artefactos de entrenamiento o análisis.

Puesta en marcha

1. Crear entorno virtual e instalar dependencias:

   python3 -m venv .venv
   source .venv/bin/activate
   pip install --upgrade pip
   pip install -r requirements.txt

2. Levantar servicios backend/frontend según sea necesario (docker-compose.yml o scripts locales).
3. Utilizar scripts/download_binance_data.py para capturar nuevos datos cuando se requiera (requiere variables BINANCE_API_KEY y BINANCE_API_SECRET).

Buenas prácticas

• Añadir nuevos datasets, modelos o reportes a carpetas ignoradas o almacenamiento externo.
• Documentar los cambios operativos en logs/system_setup.log.
• Antes de publicar, ejecutar pruebas automatizadas en backend/tests/ y frontend.