跳至主要内容

ADR-XXX: [決策標題]

ADR 編號: XXX 狀態: [提議中 (Proposed) / 已接受 (Accepted) / 已棄用 (Deprecated) / 已取代 (Superseded)] 決策日期: YYYY-MM-DD 決策者: [團隊名稱或關鍵人員] 取代: [如適用，列出被取代的 ADR] 被取代: [如適用，列出取代本 ADR 的編號]

摘要​

[一句話描述此決策]

背景 (Context)​

問題陳述​

[描述需要解決的問題或面臨的挑戰]

限制條件​

  • [技術限制]
  • [資源限制]
  • [時間限制]
  • [其他限制]

假設前提​

  • [假設 1]
  • [假設 2]

考量的方案 (Options Considered)​

方案 A: [方案名稱]​

說明: [方案的詳細描述]

優點:

  • ✅ [優點 1]
  • ✅ [優點 2]

缺點:

  • ❌ [缺點 1]
  • ❌ [缺點 2]

評分: [1-5 分]

方案 B: [方案名稱]​

說明: [方案的詳細描述]

優點:

  • ✅ [優點 1]
  • ✅ [優點 2]

缺點:

  • ❌ [缺點 1]
  • ❌ [缺點 2]

評分: [1-5 分]

方案 C: [方案名稱]​

說明: [方案的詳細描述]

優點:

  • ✅ [優點 1]
  • ✅ [優點 2]

缺點:

  • ❌ [缺點 1]
  • ❌ [缺點 2]

評分: [1-5 分]

決策 (Decision)​

選擇方案: [A/B/C]

核心理由:

  1. [理由 1]
  2. [理由 2]
  3. [理由 3]

權衡分析 (Trade-offs)​

我們獲得什麼 (Gains)​

  • ✅ [獲得 1]
  • ✅ [獲得 2]

我們放棄什麼 (Losses)​

  • ❌ [放棄 1]
  • ❌ [放棄 2]

風險與緩解措施 (Risks & Mitigations)​

風險嚴重性機率緩解措施
[風險 1]高/中/低高/中/低[如何緩解]
[風險 2]高/中/低高/中/低[如何緩解]

影響 (Consequences)​

正面影響​

  • ➕ [正面影響 1]
  • ➕ [正面影響 2]

負面影響​

  • ➖ [負面影響 1]
  • ➖ [負面影響 2]

中性影響​

  • 🔸 [中性影響 1]
  • 🔸 [中性影響 2]

實作指南 (Implementation Guidelines)​

必須遵守的規則​

  1. [規則 1]
  2. [規則 2]

建議的最佳實踐​

  1. [最佳實踐 1]
  2. [最佳實踐 2]

檢查清單​

  • [檢查項目 1]
  • [檢查項目 2]

相關文檔 (References)​

內部文檔​

  • 設計文檔連結：../guides/design/xxx.md

外部資源​

  • 相關技術文檔
  • 參考文章
  • 開源專案範例

相關 ADR​

  • ADR-XXX: 相關決策：./XXX-xxx.md

變更歷史 (Change Log)​

日期變更內容變更者
YYYY-MM-DD初版[姓名]
YYYY-MM-DD[變更說明][姓名]

文檔維護者: Development Team + AI Assistant 最後審閱: YYYY-MM-DD