架構決策記錄
架構決策記錄 （ADR） 是解決方案架構設計人員最重要的交付專案之一。 此記錄會記錄您在設計過程中所做的架構決策。 它也提供每個決策的內容特定理由和含意。
ADR 會記錄所有重要決策，包括您排除的替代專案，以符合 架構上顯著的需求。 記錄會將需求和條件約束納入決策記載的效果。
實作 ADR
在工作負載開始時啟動 ADR，並在工作負載的生命週期中加以維護。 ADR 應該針對棕色地帶工作負載啟動，如果數據可供使用，則應該根據已知的過去決策進行追溯產生。 ADR 可作為僅限附加的記錄檔。 此記錄超越初始設計，以包含未來功能與非功能需求的設計層面。
個別記錄的建議特性
與每個記錄的結構一致。 設計記錄範本，並一致地遵循它。
記錄應該包含一致的元素，例如：
- 具有內容的問題語句
- 考慮的選項
- 決策結果
- 納入此決定的重要取捨
- 記錄決策的信賴等級。 有時候會以相對較低的信賴度來做出架構重大決策。 記錄低信賴狀態對於未來的重新考慮決定很有用。
如果架構決策會導致多個階段，例如短期、中期、長期方法，請將一個決策分成多個。 將每個階段記錄為自己的決策記錄。
避免故意或意外隱藏決策的後果。
保留記錄 pithy、assertive、on-topic 和 factual。
避免制定決策記錄設計指南。 如果有更多理由或設計想法可用，請提供文件的連結做為補充材料，但決策必須清楚且獨立，而不需要該材料。
工作負載檔存放庫
此記錄應該可供立即使用，並以工作負載的文件公開儲存。
架構設計人員可藉由協助建立和維護文件和資產存放庫，協助工作負載小組達成卓越營運的建議。 架構設計人員可協助小組將所有資產放入存放庫，例如此決策記錄檔。 他們還鼓勵小組統一採用單一真相來源，以用於參考、稽核和事件回應。
下一步
更多資源
如需範本範例，請瀏覽 架構決策記錄 GitHub 組織。