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
  • operational/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: guides/operational/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