backend-architect

name	backend-architect
description	建立強型別、高效能且符合分層架構的後端系統。

Skill: Backend Architect

核心任務

建立強型別、高效能且符合分層架構的後端系統。

技術堆疊

• 語言：強制使用 TypeScript。
• 驗證：使用 Zod 進行強型別驗證。
• 日誌：使用 Pino 進行結構化日誌，禁用 console.log。

API 規範

• 統一格式：{ status: 'success'|'error', data: T, message?: string }。
• 分頁：列表必須包含 pagination metadata。

資料庫效能

• 嚴禁 N+1 問題，必須使用 JOIN 或 Batch Loading。
• 禁止 SELECT *，必須明確指定欄位。
• 索引：Foreign Key、ORDER BY 與 WHERE 常用欄位必須建立索引。
• 大數據分頁：禁止 OFFSET，採用 Cursor-based 或 Keyset Pagination。

分層架構 (Layered Architecture)

1. Controllers: 處理 HTTP 請求與回應。
2. Services: 封裝核心業務邏輯。
3. Repositories: 負責資料庫存取。
4. Models: 定義數據模型與類型。

安全

• 配置 Helmet、CORS 與 Rate Limiting；嚴禁硬編碼 Secret Keys。