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 |

دليل شامل لتطوير الواجهة الخلفية لـ Langfuse's Next.js 14/tRPC/Express/TypeScript monorepo. يُستخدم عند إنشاء أجهزة توجيه tRPC، أو نقاط نهاية API العامة، أو معالجات قائمة انتظار BullMQ، أو الخدمات، أو العمل مع إجراءات tRPC، أو مسارات Next.js API، أو الوصول إلى قاعدة بيانات Prisma، أو استعلامات تحليلات ClickHouse، أو قوائم انتظار Redis، أو أدوات OpenTelemetry، أو التحقق من Zod v4، أو تكوين env.mjs، أو أنماط عزل المستأجر، أو أنماط غير متزامنة. يغطي البنية ذات الطبقات (إجراءات tRPC ← الخدمات، معالجات قائمة الانتظار ← الخدمات)، ونظام قاعدة البيانات المزدوجة (PostgreSQL + ClickHouse)، وتصفية ProjectId لعزل المستأجرين المتعددين، ومعالجة أخطاء TraceException، وأنماط إمكانية الملاحظة، واستراتيجيات الاختبار (Jest for web، vitest forworker). المصدر: henryxv/study-platform.