# 通用模式 (Common Patterns)

## 骨架專案 (Skeleton Projects)

實作新功能時：
1. 搜尋經過實戰測試的骨架專案。
2. 使用平行 Agent 評估選項：
   - 安全評估
   - 可擴充性分析
   - 相關性評分
   - 實作規劃
3. 複製最匹配的項目作為基礎。
4. 在已證實的結構中進行迭代。

## 設計模式 (Design Patterns)

### 儲存庫模式 (Repository Pattern)

將資料存取封裝在一致的介面後方：
- 定義標準操作：findAll, findById, create, update, delete。
- 具體實作處理儲存細節（資料庫、API、檔案等）。
- 業務邏輯依賴於抽象介面，而非儲存機制。
- 實現輕鬆切換資料來源，並簡化使用 Mock 進行的測試。

### API 回應格式 (API Response Format)

為所有 API 回應使用一致的外殼 (Envelope)：
- 包含 success/status 指示器。
- 包含數據負載 (Data payload，發生錯誤時可為空)。
- 包含錯誤訊息欄位 (成功時可為空)。
- 為分頁回應包含元數據 (total, page, limit)。