Proyecto personal2026MIT

Stock Alerts: arquitectura

Alertas de precios self-hosted para un grupo chico de usuarios. Empezó como un script de Python con las alarmas en un CSV; lo convertí en una aplicación de tres servicios.

  • NestJS
  • TypeScript
  • Prisma
  • PostgreSQL
  • Python
  • pandas
  • React
  • Docker
Código en GitHub

Contexto

Quería sumar estrategias de análisis técnico (medias móviles, RSI, MACD, Bandas de Bollinger, soportes y resistencias), una interfaz web y cuentas para un grupo chico de personas. Todo tenía que correr gratis en un Mini PC casero con 8 GB de RAM.

Cómo está armado

El backend y el worker nunca se llaman entre sí: la base de datos es el único punto de integración.
Diagrama: el frontend llama al backend por REST; backend y worker leen y escriben en PostgreSQL y nunca se llaman entre sí; el worker obtiene precios de yfinance y envía notificaciones por email y Telegram cuando una alarma se dispara.FrontendReact SPA · NetlifyBackendNestJS · REST · JWTPostgreSQLúnico punto de integraciónWorkerPython · cron horarioNotificacionesEmail · TelegramPreciosyfinance vía PriceProvideral dispararseprecios

Cada hora, el worker carga las alarmas activas agrupadas por símbolo, descarga cada precio una sola vez, evalúa cada alarma con su estrategia y registra los disparos. El backend se encarga del CRUD y valida los parámetros de cada alarma contra el esquema de su estrategia.

Decisiones

Dos lenguajes, cada uno donde rinde

El motor de estrategias es un problema numérico, y el ecosistema de pandas en Python es mucho más maduro que las alternativas en Node. NestJS con Clean Architecture queda para la API, la autenticación y las reglas de negocio.

La base de datos como único punto de integración

Sin RPC ni colas entre servicios. Menos procesos en un servidor con poca RAM, y cada servicio se despliega y se testea por separado.

Proveedor de precios detrás de un puerto

El plan gratuito de Finnhub dejó de ofrecer históricos diarios, así que hoy uso yfinance. Los dos adaptadores implementan el mismo puerto: cambiar de proveedor no afecta al motor de estrategias.

Estrategias como plantillas

Cada alarma es una instancia de una estrategia, con su ticker, su mercado y sus parámetros. Sumar una estrategia nueva es registrarla, sin tocar las existentes.

Notificaciones independientes

Email y Telegram se envían en cada disparo y uno puede fallar sin afectar al otro. Un estado de notificación por alarma evita reenvíos duplicados.

Deploy sin costo

El frontend estático va en Netlify; el backend, el worker y Postgres, en el Mini PC, expuestos con Tailscale Funnel: sin dominio, sin port forwarding y funcionando detrás de CGNAT. En producción el worker corre por crontab para ahorrar memoria.

Tests contra una base real

Tests unitarios en ambos servicios y de integración contra un Postgres 16 real en Docker, efímero (tmpfs). El worker aplica las mismas migraciones de Prisma que el backend.