SuperAPI AI 工具集

cc-skill-backend-patterns

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:为可扩展的服务端应用提供后端架构模式与最佳实践,适用于 Node.js、Express 和 Next.js API 路由的开发场景。

主要能力:

  1. API 设计:基于资源的 RESTful URL 结构,使用查询参数实现过滤、排序与分页。
  2. 架构分层:仓储模式抽象数据访问,服务层承载业务逻辑,中间件模式处理请求/响应管线(如 withAuth 鉴权包装)。
  3. 数据库:只选择所需列、批量查询避免 N+1、通过 Supabase RPC 实现事务。
  4. 缓存:Redis 缓存层与 Cache-Aside 模式,含缓存失效。
  5. 错误处理:集中式错误处理器(ApiError、Zod 校验错误)与指数退避重试。
  6. 鉴权:JWT 校验、基于角色的权限控制(read/write/delete/admin)。
  7. 限流:内存级限流器,按标识与时间窗口计数。
  8. 后台任务:简单队列模式,异步处理索引等任务。
  9. 日志:结构化 JSON 日志,含请求 ID、方法、路径与错误堆栈。

使用方式:资料以 TypeScript 代码示例展示各模式的实现与调用方式,例如用 withAuth 包装 Next.js API 处理器、用 requirePermission('delete') 做权限校验、用 fetchWithRetry 包裹外部调用。具体安装命令与运行步骤暂未提供。

适用场景:构建 REST API、需要分层解耦与可维护性的服务端项目、需要缓存与限流的高并发接口、需要事务与批量查询优化的数据库操作。

限制:资料未说明支持的运行环境版本、依赖安装方式、性能基准或收费信息;示例中的 Supabase、Redis、JWT 等需自行准备相应服务与配置。