fluffy-engine

Fluffy Engine은 클릭, 페이지 뷰, 트랜잭션과 같은 대량의 사용자 생성 이벤트를 수집하고 처리하도록 설계된 NestJS 기반의 분석 서비스 프로토타입입니다. 이 서비스는 REST 엔드포인트를 통해 들어오는 이벤트를 수신하여 `analytics-events`라는 이름의 Kafka 토픽에 큐잉합니다. Kafka 브로커는 기본적으로 `localhost:9092`로 설정되어 있으며, `KAFKA_BROKER` 환경 변수를 통해 구성할 수 있습니다. 이후 이벤트는 소비되어 저장되며 API 엔드포인트를 통해 제공됩니다. 영속성을 위해 이 서비스는 `DATABASE_URL` 환경 변수를 통해 PostgreSQL을 지원하며, 연결 문자열이 제공되지 않을 경우 인메모리 SQLite 데이터베이스로 대체됩니다. 스키마에는 각 이벤트의 타임스탬프, 유형 및 원시 페이로드가 기록됩니다. `/metrics` 엔드포인트는 최근 5분 동안 분 단위로 그룹화된 이벤트 수를 반환하여 기본적인 실시간 분석을 제공합니다. 대시보드는 노출된 분석 데이터를 위한 향후 인터페이스의 일부로 언급되었습니다.