1.3 KiB
1.3 KiB
錯誤模型設計 (Error Model Design) 知識合約指南
概述
error-model-design 是知識合約，用來設計錯誤分類、傳播策略、可重試 vs 不可重試錯誤、Partial Failure 行為與回退策略。供 design-architecture 在定義錯誤處理時參考。
核心原則
錯誤處理必須系統性設計，不能事後才追加。每個錯誤分類必須可追溯到 PRD edge case 或 NFR。錯誤模型必須在整個系統中保持一致。
設計重點
- 錯誤分類：Client Errors (4xx)、Server Errors (5xx)、Business Rule Violations、Timeout Errors、Cascading Failures
- 錯誤傳播策略：Fail-Fast、Graceful Degradation、Circuit Breaker
- 錯誤回應格式：一致的錯誤碼、機器可讀與人類可讀的訊息
- Retryable vs Non-Retryable：何時可重試、何時不可重試
- Partial Failure 行為：All-or-nothing、Best-effort、Saga/Compensation
- 回退策略：每個外部依賴的回退行為
知識合約職責
- 提供錯誤處理的理論指引
- 說明各種模式的 Trade-offs 與適用場景
- 不直接產生錯誤代碼定義或實作程式碼
不應做的事
- 不替系統定義具體的錯誤碼
- 不假設所有錯誤都是同樣處理方式
- 不忽略 Partial Failure 場景