當您開始設計複雜的軟體系統時，標準圖表有時會顯得不夠用。您需要一種方法，能在不改變基礎語言的情況下，為模型添加領域特定的含義。這正是「概要圖發揮作用之處。它作為一種擴展機制，使您能夠根據特定專案需求，調整建模符號。在本指南中，我們將一步步帶您從零開始建立第一個概要圖。我們將探討核心概念、所涉及的步驟，以及使這種建模技術成為專業架構不可或缺工具的實際應用。

🧩 理解概要圖的概念

概要圖是統一建模語言（UML）中的一種特殊圖表類型。它定義了標準建模元素的一組擴展。可將其視為您建模環境中的詞彙建構工具。您無需強迫每位利害關係人理解通用術語，而是可以定義反映您業務領域的特定術語。

• 為什麼要使用它？ 它彌補了抽象技術模型與具體業務需求之間的差距。
• 它包含哪些內容？ 它通常包含套件、造型、標籤值和約束。
• 誰會使用它？ 架構師、系統設計師和領域專家經常共同參與這些圖表的設計。

若無概要圖，您可能會得到一個雜亂的模型，其中標準 UML 元素承載了原本設計時未考慮的多重含義。透過使用概要圖，您能保持基礎語言的清晰，同時增加特定資訊層級。

🛠️ 概要圖的核心組件

在開始繪製之前，您必須了解基本構件。概要圖不僅僅是一張圖，更是一種結構化定義。以下是您將遇到的關鍵元素分解。

組件	描述	範例用法
概要圖套件	存放所有概要圖定義的容器。	MySystemProfile
造型	一種新的分類器或元素，以角括號表示。	<<服務>>
標籤值	附加至造型或元素的自訂元資料。	apiVersion: "1.0"
約束	限制元素行為的規則或限制。	requiresAuthentication = true

每個組件都扮演著獨特的角色。套件組織您的定義。範疇改變元素的視覺外觀和語義意義。標籤值新增特定的資料點。約束確保模型內的規則被遵守。

🚀 逐步指南：建立您的第一個範疇

現在您已了解各個組件，讓我們將它們組合起來。依照此順序，即可在您的建模環境中建立一個功能完整的範疇。

步驟 1：定義範圍與需求

在開啟任何工具之前，先釐清您需要建模的內容。不要為所有事物建立範疇。專注於特定的痛點。

• 識別領域： 您是否正在建模微服務架構？金融交易系統？物聯網網路？
• 識別缺口： 哪些標準的 UML 標籤被誤用或不夠用？也許您需要區分「資料庫」與「資料湖」。
• 定義術語： 記下您需要的新術語。保持簡潔且具有意義。

步驟 2：建立範疇套件

首先在您的建模環境中建立一個新的套件。此套件將存放您所有的自訂定義。

• 右鍵按一下 在模型根目錄或現有的套件上。
• 選擇 「建立範疇」或「新範疇套件」。
• 命名 您的套件，例如領域範疇 或 系統擴充.

步驟 3：定義型別

這是最重要的步驟。您正在建立新類型的元素。

• 右鍵按一下在您新的外觀套件內。
• 選擇「建立型別」。
• 命名此型別。例如，建立一個命名為服務.
• 套用至適當的基底類別。如果您正在建立服務，它可能會延伸自元件或類別.

針對步驟 1 中您所識別的每個新概念重複此動作。常見範例包括<<資料庫>>, <<API>>，或<<UI頁面>>.

步驟 4：新增標籤值

型別通常需要額外資訊。標準的 UML 屬性可能不適用。請使用標籤值來儲存此元資料。

• 開啟您新建立的型別的屬性。
• 新增一個新的標籤值。
• 名稱 值（例如，版本 或 擁有者).
• 設定 資料類型（字串、整數、布林值）。

這讓您稍後能夠將特定資料附加到實例上，對於文件編寫與程式碼產生至關重要。

步驟 5：定義約束

約束可確保您的模型保持一致，它們如同架構的防護欄。

• 識別 必須遵守的規則。例如：「所有服務都必須設定逾時時間」。
• 撰寫 使用 OCL（物件約束語言）或您的工具所支援的類似語法撰寫約束。
• 附加 將約束附加至外觀或基底類別。

💡 實際範例：擴展以適用於微服務

為了讓內容更明確，讓我們來看一個情境。假設您正在設計微服務架構。標準的 UML 類別無法區分「核心服務」與「工具服務」。您希望清楚地呈現這項區別。

情境定義

您需要兩個新的外觀：<<CoreService>> 和 <<UtilityService>>。您還需要為每個服務追蹤 API 版本。

實作步驟

1. 建立套件： 將其命名為 MicroserviceProfile.
2. 建立型別 1： 命名為 CoreService。基類：Component.
3. 建立型別 2： 命名為 UtilityService。基類：Component.
4. 新增標籤值： 對於兩者，新增名為 APIVersion 類型為 字串.
5. 套用： 畫出你的系統圖。將 CoreService 和 UtilityService 的實例拖曳到畫布上。

現在，你的圖表清楚地顯示系統中哪些部分是關鍵的，哪些是輔助的。任何人查看圖表都能理解層級結構，無需圖例。

📋 模型檔設計的最佳實務

建立模型檔很容易；但建立一個 良好模型檔卻更困難。設計不良的模型檔會導致混淆與維護上的噩夢。遵循這些指引，以確保其長期可用性。

1. 保持簡單

不要創建太多範型。如果你有超過五個，就重新考慮你的設計。簡單的範型更容易採用，也較不容易出錯。

2. 命名一致性

為你的範型使用一致的命名規則。避免混合使用駝峰式大小寫和蛇形大小寫。如果你使用「<<Service>>」表示一個，就不要用「<<apiService>>」表示另一個，除非有明確的區分。

3. 記錄所有內容

即使工具允許你建立一個範型，也不代表每個人都會理解。在你的範型套件中加入文件註解，說明每個範型代表的意義以及何時使用。

4. 重用現有標準

不要重複發明輪子。檢查是否存在產業標準。例如，SysML 範型存在於系統工程中。盡可能使用現有的範型以確保互操作性。

5. 為你的範型進行版本控制

隨著系統的演進，你的範型可能會改變。請追蹤變更內容。若更改了範型定義，請確保不會破壞現有的圖表。必要時可在套件名稱中加入版本號。

⚠️ 應避免的常見陷阱

許多初學者在開始第一個範型時會犯錯。了解這些常見錯誤能為你節省大量後續時間。

• 過度設計：為每個細微的細節都建立範型。僅對能帶來顯著價值或清晰度的概念進行範型化。
• 忽略基礎類別：未明確指定範型所延伸的標準 UML 元素。這會導致該元素行為的模糊性。
• 標籤值過多：將過多資料附加到範型會使模型混亂。僅儲存實際使用的資料。
• 遺忘約束：在沒有規則的情況下定義範型，會導致使用者誤用。約束能讓模型保持紀律。
• 團隊未達共識：孤立地建立範型。在廣泛應用前，確保團隊對定義達成共識。

🔄 將範型應用於其他圖表

範型不是一個獨立的圖表。它是一種你應用於其他圖表的資源。定義完範型後，必須將其匯入或載入到你的專案環境中。

匯入範型

大多數建模環境都要求你將範型註冊到目前的專案中。

• 尋找 專案探索器中的設定檔。
• 右鍵按一下 並選擇「套用設定檔」或「註冊設定檔」。
• 確認 新的造型符號是否已出現在您的工具列或工具箱中。

在類別圖中的使用

使用類別圖時，現在可以使用您的新造型符號。不再繪製一般方框，而是繪製帶有造型符號圖示的方框，這會立即改變視覺呈現。

• 拖曳 將造型符號從工具列拖曳至畫布上。
• 填入 當提示時填入標籤值。
• 連接 使用標準關係（關聯、依賴等）進行連接。

在元件圖中的使用

元件圖通常最能從設定檔中受益。您可以定義不同類型的元件，例如「前端」、「後端」或「基礎設施」。這有助於視覺化部署拓撲。

📈 維護與演進

設定檔是持續演變的實體。隨著系統的變動，設定檔也會改變。您必須制定維護計畫。

• 定期檢視： 計畫每季檢視一次您的設定檔定義。它們是否仍然相關？
• 更新文件： 若造型符號定義有所變更，應立即更新文件。
• 訓練團隊： 引入變更時，應舉辦簡報會議。確保每位成員都理解新規則。
• 存檔舊版本： 不要刪除舊的設定檔。將其存檔於程式庫中，以便必要時可參考過去的設計。

🤝 協作與團隊工作流程

當整個團隊都使用設定檔圖時，其效果最佳。協作是成功關鍵。

共用程式庫

將您的設定檔定義儲存在共用位置。這可確保每位成員都使用相同版本。若有人建立新的造型符號，應將其提交至程式庫，讓其他人也能看見。

程式碼審查

在您的程式碼審查流程中納入範疇使用的內容。如果開發人員錯誤地使用了詮釋，請指出問題。一致性才是目標。

文件整合

將您的範疇圖與技術文件連結起來。當開發人員閱讀 API 文件時，應能看見模型中使用的相同術語。這能降低認知負荷。

🌐 高階考量

隨著經驗累積，您可能會探索範疇圖的更多進階功能。

範疇繼承

您可以建立一個基礎範疇並加以延伸。例如，建立一個BaseProfile，包含通用定義，然後建立一個WebProfile，並延伸自基礎範疇。這能減少重複。

多重範疇

在單一圖表中使用多個範疇是可能的。然而，請謹慎處理。過多的範疇可能導致視覺混亂。建議每個圖表僅使用一至兩個主要範疇。

程式碼產生

某些建模工具允許您從範疇產生程式碼。標籤值可直接對應至程式碼註解。這彌補了設計與實作之間的差距。

🔍 重點摘要

建立範疇圖是一項策略性決策。這需要規劃、紀律與清晰的溝通。以下是最重要的幾點快速回顧。

• 範疇擴展 UML： 它們讓您能加入領域特定的含義。
• 核心元素： 套件、詮釋、標籤值與約束。
• 流程： 定義範圍、建立套件、定義詮釋、新增值、套用約束。
• 最佳實務： 保持簡單，良好文件化，並為您的工作版本化。
• 協作： 確保團隊理解並採用這些定義。

遵循此指南，您便能建立穩健且有意義的模型，有效傳達複雜的系統架構。請記住，目標是清晰明確。如果您的範疇讓您的圖表更易理解，那就是正確的做法。

📝 常見問題

Q：我是否可以在沒有特定工具的情況下使用範疇圖？

A：是的，這個概念與工具無關。雖然大多數工具都支援UML範疇，但這項邏輯適用於任何允許擴展的建模方法。

Q：我該如何處理範疇之間的衝突？

A：如果兩個範疇適用於同一個元素，請在您的約束中定義優先級規則。通常，較具體的範疇具有優先權。

Q：範疇圖是否等同於套件圖？

A：不是。套件圖顯示套件的組織結構。範疇圖則定義套件內擴展建模語言的內容。

Q：一旦使用了範疇，我是否可以刪除它？

A：這有風險。如果元素依賴於該範疇，刪除它可能會破壞模型。建議改為標示為已棄用，並建立新版本。

從今天開始建立您的第一張範疇圖。找出模型中需要釐清的一個小區域，為它定義一個範疇。觀察您的架構變得有多清晰。