Saltar a contenido

Modulos Backend#

Routers (backend/routers)#

Router Endpoints clave Responsabilidad
auth.py /auth/* Login/JWT, usuarios, roles
binance.py /binance/* Estado cuenta/ordenes y operaciones Binance
analytics.py /analytics/* Diario, overlays, cohortes, goals, case-reviews
signals.py /signals/*, /executions/* Cola de senales y ejecucion
autopilot.py /autopilot/* Estado, decisiones, tuning, estrategia
ops.py /ops/* Readiness, health, auditoria, M15 optimizer/promotions
settings.py /settings/* Runtime config + OpenAI runtime key/model
shadow_tests.py /shadow-tests/* Configuracion y ejecucion A/B shadow
jobs.py /jobs/* Estado y control de jobs internos

Servicios (backend/services)#

Trading y ejecucion#

  • autopilot.py: motor de decision, evaluacion de gates, sizing y razonamiento.
  • trade_manager.py: gestion de ciclo de vida de trades abiertos.
  • ai_scoring.py: scoring IA de decisiones/eventos.
  • gates_effectiveness.py: evaluacion de bloqueos y oportunidades perdidas.

Market data e ingesta#

  • news_ingestor.py, macro_ingestor.py: captura de feeds.
  • macro_enricher.py, news_price_impact.py, news_summary.py: enriquecimiento.
  • market_window_builder.py, candle_aggregator.py: ventanas de mercado y agregaciones.

IA y aprendizaje#

  • llm_signal_adviser.py: asistente LLM para evaluacion contextual.
  • brainstorm_*: prompter/runner/evaluator/feedback/improver.
  • training_pipeline.py: entrenamiento de modelos baseline.

Operacion y reportes#

  • ops_automation.py: evidencia, brief diario, validaciones.
  • weekly_report.py, goal_monitor.py: control de metas y salud semanal.
  • bi_exporter.py: export de datasets para BI.

Configuracion runtime#

  • runtime_settings.py: parametros dinamicos con auditoria.
  • secret_store.py: secretos runtime (incluida OpenAI key runtime).

Estrategias (backend/services/strategies)#

  • ma_crossover.py
  • range_breakout.py
  • paxg_mean_reversion.py

Se seleccionan por configuracion de autopilot y pueden convivir por simbolo/timeframe.

Flujos clave (de punta a punta)#

  1. Senal -> Decision -> Orden:
  2. services/autopilot.py -> routers/signals.py -> services/trade_manager.py -> binance/client.py.
  3. Observabilidad y gobierno:
  4. routers/ops.py + services/ops_automation.py + services/gates_effectiveness.py.
  5. Inteligencia y enriquecimiento:
  6. services/news_*, services/macro_*, services/llm_signal_adviser.py, services/ai_scoring.py.

Nota de mantenibilidad#

  • Los docstrings de funciones del backend se mantienen auditables con:
  • python3 scripts/audit_docstrings.py --root backend --fail-on-missing --fail-on-robotic