<專案名稱>
資產架構文件
[本節提供整個資產架構文件的概觀。涵蓋資產架構文件的用途、範圍、定義、字首語、縮寫、參照及概觀。]
本文提供 <資產的名稱> 的綜合性架構概觀。主要是針對資產中要納入的個別架構的組合,擷取並表達已制訂的重要架構決策。
[本節說明在架構方面有某些重大影響力的資產需求和目標;例如,使用的難易度、必要的技能等級、使用現成產品或現成可重複使用的資產、使用資產的特定標準表示法等。另外也說明可能適用的特殊限制。 包括設計和實作策略、開發工具、團隊結構、排程及現有的構件。]
[本節說明打算使用資產的環境/情境。這包含開發環境、部署環境、商業領域環境等。
可獲取價值的一些可能的環境包括:
- 部署環境:指出打算使用資產的伺服器和執行時期環境,例如 "websphere"
開發環境:指出打算用來開發/延伸資產的開發環境
- 領域環境:指出資產的商業領域,例如「保險業」
- 重複使用範圍環境:指出打算重複使用資產的體制範圍,例如專案小組、部門及企業
- 測試環境:指出應該用來測試資產的環境,例如:負載測試、效能測試、功能測試]
[本節說明資產之間可能的關係。例如,一項資產可能依據其他資產來決定提供特定的服務,或依據其他套用的資產來決定套用資產本身。]
[本節說明資產消費者如何使用資產。可視為資產的初步用法模型。]
[本節包含資產的使用案例模型。其中列出資產的參與者(亦即資產消費者)及使用案例或情境(描述參與者如何使用資產的說明)。 在「資產願景」中,使用案例和特性之間應該會有直接的對應關係。]
[本節特別挑選一些使用案例(或情境)實現化來說明資產的實際運作情形,並解釋各種資產構件如何對功能做出貢獻。
以可重複使用的資產而言,使用案例實現化說明資產構件如何貢獻,以提供使用案例中描述的功能。]
[本節列出「用法模型」區段所描述的每一項資產特性的相對優先順序。在資產構件開發的反覆規劃期間會用到這項資訊。]
[本節說明資產的整體邏輯組織,並列出資產包含的構件。除了描述套件階層,也應該說明階層組織的原理。]
[本節說明資產的整體邏輯組織,包括套件階層及套件之間的任何重要關係]
[對於每一個套件,各有一個子區段包含套件名稱、簡要說明及套件內含的所有資產構件(和可能的子套件)。
對於套件中的每一個資產構件,則包含名稱、簡要說明及對於其他資產構件的任何關係。]
[本節說明資產的整體實體組織(亦即,資產檔案和目錄)。
資產的實體組織通常不同於邏輯組織,因為選擇使用什麼格式來包裝資產(例如「可重複使用的資產規格)會影響資產的實體組織。因此,通常不會「預先」定義實體組織,而是在準備包裝資產之前制訂(或緊接在包裝完成之後)。
[本節說明資產的整體實體組織。其中列出內含資產檔案的實體目錄,也指出決定什麼檔案可放入什麼目錄中的任何「規則」。
如果已選取資產的標準資產表示法,則應該在這裡說明對資產的實體組織所產生的影響。]
[對於每一個實體目錄,各有一個子區段包含套件名稱、簡要說明及目錄內含的所有檔案(和可能的子目錄)。
[如果資產為特定的環境提供明確的自訂選項(例如,以特定的後端資料庫來實例化架構骨架,或實例化特定產品的部署服務),則本節應該描述這些自訂選項。
本節應該明確說明何者可自訂,並提供如何自訂的準則。例如,當資產代表一個範本或架構時, 本節應該描述在資產實例化時必須連結至實際參數的形式參數,也應該建議連結至什麼實際參數。 這裡不需要詳細的用法指示,因為完整的資產文件中將會提供。目標是指出資產有哪些方面應該自訂。