fluffy-engine

Fluffy Engine es un prototipo de servicio de analítica construido con NestJS, diseñado para ingerir y procesar grandes volúmenes de eventos generados por usuarios, tales como clics, vistas de página y transacciones. El servicio acepta eventos entrantes a través de un endpoint REST y los encola en un tópico de Kafka llamado `analytics-events`. El broker de Kafka tiene como valor predeterminado `localhost:9092` y puede configurarse mediante la variable de entorno `KAFKA_BROKER`. Posteriormente, los eventos son consumidos, almacenados y puestos a disposición a través de endpoints de API. Para la persistencia, el servicio soporta PostgreSQL a través de la variable de entorno `DATABASE_URL`, recurriendo a una base de datos SQLite en memoria cuando no se proporciona una cadena de conexión. El esquema registra la marca de tiempo, el tipo y la carga útil (payload) bruta de cada evento. El endpoint `/metrics` devuelve la actividad reciente como recuentos de eventos agrupados por minuto durante los últimos cinco minutos, proporcionando analíticas básicas en tiempo real. Se mencionan los dashboards como parte de la interfaz futura prevista para los datos de analítica expuestos.