backend-dev-guidelines

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 |

Guida completa allo sviluppo del backend per Next.js 14/tRPC/Express/TypeScript monorepo di Langfuse. Da utilizzare durante la creazione di router tRPC, endpoint API pubblici, processori di coda BullMQ, servizi o quando si lavora con procedure tRPC, percorsi API Next.js, accesso al database Prisma, query di analisi ClickHouse, code Redis, strumentazione OpenTelemetry, convalida Zod v4, configurazione env.mjs, modelli di isolamento tenant o modelli asincroni. Copre l'architettura a più livelli (procedure tRPC → servizi, processori di coda → servizi), sistema di database doppio (PostgreSQL + ClickHouse), filtro projectId per isolamento multi-tenant, gestione degli errori traceException, modelli di osservabilità e strategie di test (Jest per Web, vitest per lavoratore). Fonte: henryxv/study-platform.