SuperAPI AI 工具集

backend-dev-guidelines

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:为 Langfuse 后端各包(web、worker、packages/shared)建立一致的开发规范,在创建或修改 tRPC 路由与过程、公共 REST API 端点、BullMQ 队列消费者与生产者、业务服务、API 鉴权、基于权益的资源访问、中间件、Prisma(PostgreSQL)或 ClickHouse 数据库操作、OpenTelemetry/DataDog 可观测性、Zod v4 输入校验、环境配置以及后端测试与重构时自动启用。

主要能力与约定:采用分层架构,Web 侧为 tRPC 过程或公共 API 路由 → 服务 → 数据库,Worker 侧为队列处理器 → 服务 → 数据库,共享代码放在 packages/shared。tRPC 过程只做委托,业务逻辑写在 service.ts;配置统一从 env.mjs/env.ts 读取,禁止直接使用 process.env;所有输入用 Zod v4 校验;简单 CRUD 直接用 Prisma,复杂查询走 repositories;租户数据查询必须带 projectId 过滤;后端可观测性使用 OpenTelemetry + DataDog(logger、traceException、instrumentAsync),而非 Sentry;新增功能需配套测试(Web 用 Jest,Worker 用 Vitest)。

使用方式:技能按清单引导,如新增 tRPC 功能需定义 Router、选择过程类型、JWT 鉴权、权益检查、Zod 校验、服务层、traceException 错误处理、测试与 env.mjs 配置;新增公共 API 需在 pages/api/public/ 建路由,使用 withMiddlewares 与 createAuthedProjectAPIRoute,定义类型、Basic Auth、Zod 校验与版本化;新增队列处理器需在 worker/src/queues/ 创建、定义队列类型、编写服务、区分失败与成功事件、在 WorkerManager 注册并加测试。

适用场景:Langfuse 后端功能开发、重构与测试。限制:资料未提供安装命令、价格、平台支持范围及具体版本要求,暂未提供。