backend-dev-guidelines

SKILL.md

Establish consistency and best practices across Langfuse's backend packages (web, worker, packages/shared) using Next.js 14, tRPC, BullMQ, and TypeScript patterns.

The shared package exposes specific import paths for different use cases:

| Import Path | Maps To | Use For |

Langfuse의 Next.js 14/tRPC/Express/TypeScript 모노레포에 대한 종합적인 백엔드 개발 가이드입니다. tRPC 라우터, 공용 API 엔드포인트, BullMQ 큐 프로세서, 서비스를 생성하거나 tRPC 프로시저, Next.js API 경로, Prisma 데이터베이스 액세스, ClickHouse 분석 쿼리, Redis 큐, OpenTelemetry 계측, Zod v4 유효성 검사, env.mjs 구성, 테넌트 격리 패턴 또는 비동기 패턴으로 작업할 때 사용합니다. 계층화된 아키텍처(tRPC 프로시저 → 서비스, 큐 프로세서 → 서비스), 이중 데이터베이스 시스템(PostgreSQL + ClickHouse), 다중 테넌트 격리를 위한 projectId 필터링, TraceException 오류 처리, 관찰 가능성 패턴 및 테스트 전략(웹용 Jest, 작업자용 vitest)을 다룹니다. 출처: henryxv/study-platform.

원본 보기