Codigo a Nivel de Modulo (Mapa General)
Este mapa cubre los modulos principales y su rol dentro del sistema.
Backend (core)
| Modulo |
Ruta |
Rol |
| API entrypoint |
backend/main.py |
Inicializa app, jobs async, wiring de routers/servicios |
| Routers API |
backend/routers/*.py |
Superficie HTTP por dominio funcional |
| Servicios de negocio |
backend/services/*.py |
Autopilot, trade manager, ingestas, IA, reportes |
| Estrategias |
backend/services/strategies/*.py |
ma_crossover, range_breakout, paxg_mean_reversion |
| Persistencia |
backend/models.py |
Modelo SQLAlchemy completo |
| Configuracion |
backend/config.py |
Config por entorno/runtime |
| Auth |
backend/auth.py |
Seguridad de rutas y roles |
Frontend (UI)
| Modulo |
Ruta |
Rol |
| App pages |
frontend/src/app/**/page.tsx |
Vistas funcionales por area |
| API client |
frontend/src/lib/api.ts |
SDK HTTP unico para frontend |
| API proxy |
frontend/src/app/api/proxy/[...path]/route.ts |
Bridge frontend-backend |
| Shared UI |
frontend/src/components/* |
Componentes comunes |
Scripts (operacion)
| Modulo |
Ruta |
Rol |
| Runner diario |
scripts/run_spot_demo_daily.py |
Pipeline operativo diario end-to-end |
| Autopromote M15 |
scripts/run_m15_autopromote.py |
Promocion controlada de variantes |
| Shadow batch |
scripts/run_shadow_enabled.py |
Ejecuta shadow-tests/run-enabled |
| Daily brief |
scripts/run_ops_daily_brief.py |
Resumen operativo diario |
| Auditoria semanal |
scripts/run_ops_weekly_audit.py |
Auditoria macro semanal |
| Smokes |
scripts/run_web_auth_smoke.py, scripts/run_openai_runtime_smoke.py |
Verificacion continua |
Deploy y runtime
| Modulo |
Ruta |
Rol |
| Compose CT110 |
deploy/docker-compose.ct110.yml |
Orquestacion de contenedores |
| Deploy release |
scripts/ct110_deploy_release.sh |
Release inmutable en CT110 |
| Ops shell wrappers |
deploy/ops/*.sh |
Ejecucion por systemd/timers |
| Timers |
deploy/systemd/*.service, *.timer |
Programacion periodica |
Estado operacional persistente
storage/reports/shadow_tests.json: configuraciones y runs de shadow.storage/reports/m15_autopromote_state.json: estado de ciclos consecutivos.storage/logs/ops/*: evidencia de daily brief, smokes, auditorias.
Como leer el codigo rapido (ruta recomendada)
backend/main.py: wiring general, jobs y arranque de servicios.backend/routers/*.py: contrato HTTP por dominio (ops, analytics, autopilot, settings).backend/services/autopilot.py + backend/services/trade_manager.py: nucleo de decision y ejecucion.backend/services/gates_effectiveness.py + backend/routers/ops.py: diagnostico de bloqueos, oportunidades y promociones M15.backend/services/ops_automation.py: evidencia diaria, briefs y validaciones de ciclo.
Calidad de documentacion de funciones
- Auditoria automatica:
python3 scripts/audit_docstrings.py --root backend --fail-on-missing --fail-on-robotic- Objetivo operativo actual: mantener
0 funciones sin docstring (backend fuera de tests) y evitar frases roboticas.