Architecture Decision Record

Active theme: Light

← 決策記錄範本

{喺呢度填寫你嘅標題}

!!! info

**狀態**:{ 建議中 | 審閱中 | 已接納 |  已否決 | 已取代 | 已棄用 }

**更新日期**:{YYYY-MM-DD}

摘要

{呢個係你份 ADR 嘅「行政摘要」或者「電梯簡報」。用幾句簡潔嘅句子(通常 2 至 4 句),清楚講明呢份 ADR 處理嘅核心問題、疑問或者機會。簡單帶出所作決策或者焦點範疇。目標係幫助讀者快速了解呢份 ADR 講乜,並判斷同自己有冇關係,唔使讀晒成份文件。可以當佢係技術論文嘅摘要,或者主題嘅極簡短引言。}

驅動因素

{呢個部分解釋點解要而家做呢個決策。清楚說明促使需要作出呢個架構決策嘅主要動機、需要或者問題。想想背後嘅原因同壓力。}

  • {例如:我哋正開發一個新功能/能力,需要……}

  • {例如:我哋需要改善效能、無障礙設計,或者清除技術債……}

  • {例如:用戶回饋顯示……}

  • {例如:現時嘅做法有以下限制……}

選項

{喺呢度列出你正考慮嘅不同選項。只講事實,避免加入意見,下一節先會分析。包括簡潔嘅描述,以及相關文件或者例子嘅連結。

包括你探討過嘅所有重要替代方案,即使最終冇揀選都要列出。目標係喺你深入評估之前,畀讀者對每個替代方案有清晰而中立嘅了解。}

{選項 1 標題}

{描述該選項、提供摘要、列出事實、提供連結等等。}

{選項 n 標題}

...

選項分析

{喺呢度對「選項」章節所列嘅每個選項作出批判性評估。針對每個選項,均衡咁講述佢嘅優點、缺點,以及任何其他相關考慮或者取捨。要具體,並且盡可能將你嘅論點同「驅動因素」連繫起上嚟。

可以考慮以下方面:

  • 成本(開發、營運、授權)

  • 複雜度(實施、維護、學習曲線)

  • 風險(技術、營運、保安)

  • 同架構原則或者現有標準嘅一致性

  • 對效能、可擴展性、易用性、可維護性、保安等嘅影響

按需要包括任意數量嘅優點/缺點/其他陳述。 }

{選項 1 評估}

  • 優點:{呢個選項嘅某個具體優勢或者好處。}

  • 缺點:{呢個選項帶來嘅某個具體缺點、風險或者成本。}

  • 其他:{一個相關但並非純粹優點或者缺點嘅要點。}

{選項 n 評估}

...

建議

{喺呢度清楚講明最終決策,並明確指出所揀選嘅選項。詳細解釋點解揀選呢個選項。你應該清楚說明所揀選嘅選項點樣最能回應「驅動因素」,並滿足主要需求或者解決所述問題。}

後果

{呢個部分係可選嘅。}

{既然作出咗決策,預期嘅結果同影響係咩,包括正面同負面?作出呢個決策,會接受咩已知嘅限制、成本或者風險?呢個決策會點樣影響不同持份者、其他系統、開發實踐、營運程序或者用戶體驗?}

  • 優點:{預期呢個決策帶來嘅某個具體正面結果或者好處。}

  • 缺點:{呢個決策引致、並且已被接受嘅某個具體缺點、成本或者風險。}

  • 其他:{一個並非純粹優點或者缺點嘅後果。}

確認

{呢個部分係可選嘅。}

{概述點樣驗證呢個決策嘅實施,以及點樣確保持續遵守。咁樣有助證明呢個決策唔只係紙上談兵,而係會被積極落實同監察。

你會點樣檢查決策有冇被正確實施?(例如程式碼審閱、特定測試、示範、同儕審閱。)

日後會點樣持續遵守呢個決策?(例如自動化檢查、定期審核、更新團隊指引、培訓。)

有冇特定指標或者指示,可以顯示決策正達到預期嘅正面成果?(例如效能基準、採用率、特定錯誤減少、用戶回饋評分。)

邊個負責監督,如果決策冇被遵守會點?}

更多資料

{呢個部分係可選嘅。}

{用呢個部分提供任何補充資料,用嚟支持決策、補充背景或者指引日後行動。其他決策同資源嘅連結亦可以放喺度。

你可以簡單註明邊個參與咗決策過程,以及有冇達成共識、點樣達成共識。你亦可以建議一個時間框架或者特定事件,作為將來重新評估呢個決策嘅契機。}