バックエンド開発

API設計

RESTful規約

GET    /users          # ユーザー一覧取得
POST   /users          # ユーザー作成
GET    /users/:id      # ユーザー取得
PUT    /users/:id      # ユーザー更新（全項目）
PATCH  /users/:id      # ユーザー更新（部分更新）
DELETE /users/:id      # ユーザー削除

GET    /users/:id/posts  # ユーザーの投稿一覧取得
POST   /users/:id/posts  # ユーザーの投稿作成

レスポンス形式

{
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100
  }
}

エラー形式

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input",
    "details": [
      { "field": "email", "message": "Invalid format" }
    ]
  }
}

データベースパターン

スキーマ設計

-- 公開IDにはUUIDを使用
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  public_id UUID DEFAULT gen_random_uuid() UNIQUE,
  email VARCHAR(255) UNIQUE NOT NULL,
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- ソフトデリート
ALTER TABLE users ADD COLUMN deleted_at TIMESTAMPTZ;

-- インデックス
CREATE INDEX idx_users_email ON users(email);
CREATE INDEX idx_users_created ON users(created_at DESC);

クエリパターン

-- カーソルを使用したページネーション
SELECT * FROM posts
WHERE created_at < $cursor
ORDER BY created_at DESC
LIMIT 20;

-- 効率的なカウント
SELECT reltuples::bigint AS estimate
FROM pg_class WHERE relname = 'users';

認証

JWTパターン

interface TokenPayload {
  sub: string;      // ユーザーID
  iat: number;      // 発行時刻
  exp: number;      // 有効期限
  scope: string[];  // パーミッション
}

function verifyToken(token: string): TokenPayload {
  return jwt.verify(token, SECRET) as TokenPayload;
}

ミドルウェア

async function authenticate(req: Request, res: Response, next: Next) {
  const token = req.headers.authorization?.replace('Bearer ', '');
  if (!token) {
    return res.status(401).json({ error: 'Unauthorized' });
  }

  try {
    req.user = verifyToken(token);
    next();
  } catch {
    res.status(401).json({ error: 'Invalid token' });
  }
}

キャッシング戦略

// キャッシュアサイドパターン
async function getUser(id: string): Promise<User> {
  const cached = await redis.get(`user:${id}`);
  if (cached) return JSON.parse(cached);

  const user = await db.users.findById(id);
  await redis.setex(`user:${id}`, 3600, JSON.stringify(user));
  return user;
}

// キャッシュ無効化
async function updateUser(id: string, data: Partial<User>) {
  await db.users.update(id, data);
  await redis.del(`user:${id}`);
}

レート制限

const limiter = rateLimit({
  windowMs: 60 * 1000,  // 1分
  max: 100,             // ウィンドウあたり100リクエスト
  keyGenerator: (req) => req.ip,
  handler: (req, res) => {
    res.status(429).json({ error: 'Too many requests' });
  }
});

可観測性

• ロギング: リクエストIDを含む構造化JSONログ
• メトリクス: リクエストレイテンシ、エラー率、キューの深さ
• トレーシング: 相関IDによる分散トレーシング
• ヘルスチェック: /health と /ready エンドポイント