32 lines
1.0 KiB
Markdown
32 lines
1.0 KiB
Markdown
|
# 通用模式 (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)。
|