affaan-m/backend-patterns

Node.js、Express 和 Next.js API routes 的后端架构模式、API 设计、数据库优化及服务端最佳实践。

编程协作开发 Agent Agent 技能调研仓库问答后端架构模式 Node.js 服务设计 API 接口规范数据库查询优化服务端最佳实践

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

Backend Geliştirme Kalıpları

Ölçeklenebilir sunucu tarafı uygulamalar için backend mimari kalıpları ve en iyi uygulamalar.

Ne Zaman Aktifleştirmelisiniz

REST veya GraphQL API endpoint'leri tasarlarken
Repository, service veya controller katmanları uygularken
Veritabanı sorgularını optimize ederken (N+1, indeksleme, bağlantı havuzu)
Önbellekleme eklerken (Redis, in-memory, HTTP cache başlıkları)
Arka plan işleri veya async işleme ayarlarken
API'ler için hata yönetimi ve doğrulama yapılandırırken
Middleware oluştururken (auth, logging, rate limiting)

API Tasarım Kalıpları

RESTful API Yapısı

// PASS: Kaynak tabanlı URL'ler
GET    /api/markets                 # Kaynakları listele
GET    /api/markets/:id             # Tek kaynak getir
POST   /api/markets                 # Kaynak oluştur
PUT    /api/markets/:id             # Kaynağı değiştir (tam)
PATCH  /api/markets/:id             # Kaynağı güncelle (kısmi)
DELETE /api/markets/:id             # Kaynağı sil

// PASS: Filtreleme, sıralama, sayfalama için query parametreleri
GET /api/markets?status=active&sort=volume&limit=20&offset=0

Repository Kalıbı

// Veri erişim ma…

以下为摘要预览，完整内容请查看 GitHub 原文。

后端开发模式

用于可扩展服务端应用的后端架构模式与最佳实践。

何时启用

设计 REST 或 GraphQL API 端点时
实现 repository、service 或 controller 层时
优化数据库查询时（N+1、索引、连接池）
添加缓存时（Redis、内存缓存、HTTP 缓存头）
配置后台任务或异步处理时
为 API 设置错误处理与校验时
构建中间件时（鉴权、日志、限流）

API 设计模式

RESTful API 结构

// PASS：以资源为中心的 URL
GET    /api/markets                 # 列出资源
GET    /api/markets/:id             # 获取单个资源
POST   /api/markets                 # 创建资源
PUT    /api/markets/:id             # 替换资源（完整）
PATCH  /api/markets/:id             # 更新资源（部分）
DELETE /api/markets/:id             # 删除资源

// PASS：用于过滤、排序、分页的 query 参数
GET /api/markets?status=active&sort=volume&limit=20&offset=0

Repository 模式

// 抽象数据访问逻辑
interface MarketRepository {
  findAll(filters?: MarketFilters): Promise<Market[]>
  findById(id: string): Promise<Market | null>
  create(data: CreateMarketDto): Promise<Market>
  update(id: string, data: UpdateMarketDto): Promise<Market>
  delete(id: string): Promise<void>
}

class SupabaseMarketRepository implements MarketRepository {
  async findAll(filters?: MarketFilters): Promise<Market[]> {
    let query = supabase.from('markets').select('*')

    if (filters?.status) {
      query = query.eq(…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md13.8 KB在 GitHub 查看 ↗