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.
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
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.