Saltar a contenido

SignalDashPro Handbook (Consolidado)#

Manual tecnico-operativo consolidado. Sustituye la consulta diaria de multiples archivos.

1. Arquitectura operativa#

  • Backend FastAPI: ejecucion, riesgo, analitica, jobs.
  • Frontend Next.js: consola de monitoreo y control.
  • Postgres: fuente de verdad.
  • Binance API: market data y trading.

Referencias profundas (si hacen falta): docs/architecture/*.

2. Levantamiento rapido#

2.1 Local#

python -m venv .venv
source .venv/bin/activate  # o .venv\Scripts\activate en Windows
pip install -r backend/requirements.txt
set -a; source env/.env.binance.demo.month; set +a
uvicorn backend.main:app --host 127.0.0.1 --port 8096

2.2 Docker#

docker compose up -d --build

Servicios: - Backend :8096 - Frontend :3000 - DB :5433

2.3 Produccion/Demo en Proxmox (CT110)#

El deploy 24/7 corre en un CT (LXC) con Docker Compose y reverse proxy por dominio.

URLs: - https://sdp.perlatec.net (frontend) - https://api.sdp.perlatec.net (backend)

Referencia unica para retomar/operar (incluye troubleshooting de NPM/CORS): - HANDOFF.md - proxmox.md

3. Operacion y validacion#

3.1 Checks minimos#

./.venv/bin/python scripts/db_health_check.py
./.venv/bin/python scripts/run_binance_e2e.py --base-url http://127.0.0.1:8096 --with-private auto
./.venv/bin/python scripts/smoke_test.py --base-url http://127.0.0.1:8096

3.2 Evidencia#

  • E2E: storage/logs/e2e_runs/
  • Evidencia operativa: storage/logs/evidence/
  • Reportes semanales: storage/reports/weekly/

4. Riesgo y seguridad operativa#

Controles: - Kill-switch global (/risk/kill-switch*). - Guard de alineacion de mercado (/risk/alignment-guard*). - Limites de sesion y notional por variables BINANCE_MAX_*.

Regla: - Si hay desalineacion por encima del umbral, habilitar guard y frenar ejecucion automatica.

5. Jobs y automatizacion#

Jobs base: - run_data_pipeline.py - market_sync (loop interno backend para velas Binance + stats + ventanas) - run_goal_monitor.py - run_binance_e2e.py - capture_operational_evidence.py - run_weekly_report.py

Variables clave de market_sync: - MARKET_SYNC_AUTO_RUN - MARKET_SYNC_INTERVAL_MINUTES - MARKET_SYNC_SYMBOLS - MARKET_SYNC_TIMEFRAMES - MARKET_SYNC_WINDOW_HOURS - MARKET_SYNC_IMPORT_LIMIT

Monitoreo: - GET /jobs/status (campo market_sync).

Programacion y plantillas: docs/cron_jobs.md.

6. Mercado y analitica#

/market soporta: - Fuente TradingView (visual rapida). - Fuente Backend (Binance candles) (consistencia con decisiones del sistema).

Buenas practicas: - Usar backend como fuente de verdad para ejecucion/riesgo. - Usar TradingView como referencia visual.

7. Testing#

python -m pytest backend/tests -q
./.venv/bin/python scripts/run_smoke_suite.py --target local=http://127.0.0.1:8096

Notas: - backend/tests/conftest.py fuerza DB SQLite aislada para pruebas (storage/test_pytest.db). - En tests se desactivan jobs auto (*_AUTO_RUN=false) para evitar interferencia con runtime live.

Guia extendida: docs/guides/testing.md.

8. Demo mensual (30 dias)#

Plan operativo: docs/guides/binance_demo_30d.md.

Plan de inteligencia IA por fases: docs/guides/ai_intelligence_plan.md.

Checklist: 1. entorno demo cargado, 2. e2e diario verde, 3. evidencia diaria generada, 4. evaluacion KPI semanal, 5. Go/No-Go al cierre.

9. Desarrollo y contribucion#

  • Convenciones: CONTRIBUTING.md
  • Estado y backlog: TODO.md
  • Guia principal: PROJECT_GUIDE.md