從文本分析開發類圖的全面入門指南

透過系統化的文本分析，將自然語言需求轉化為專業的 UML 類圖——一種結構化、教育性且實用的入門方法。

---

✅ 為什麼要使用文本分析來建立類圖？

文本分析是一種基礎技術，應用於物件導向分析與設計（OOAD）。它彌補了非正式問題描述（使用者故事、需求或系統規格）與正式UML 類圖.

對於初學者而言，此方法提供了一種清晰且可重複的流程用以提取系統核心結構，無需猜測。

🎯 文本分析的主要優勢

優勢	說明
結構化的起點	不再有空白頁的焦慮——類別直接從文字中產生。
提升完整性	捕捉到在腦力激盪過程中可能被忽略的領域實體。
更高的準確性	減少無關類別的創造或關鍵概念的遺漏。
教授核心 UML 概念	名詞 → 類別，動詞 → 操作，介系詞 → 關係。
提升溝通效率	視覺化圖表有助於利益相關者、開發人員與團隊成員達成共識。
加速建模	手動分析有助於建立理解；自動化則加快迭代速度。
支援迭代式精進	鼓勵審查、驗證與持續改進。

此方法根植於經典的 OOAD 原則，源自如《應用 UML 與模式》 由克雷格·拉爾曼。

---

🔑 文本分析中的關鍵概念

在深入過程之前，請理解這些核心的UML建模元素：

1. 候選類別

• 名詞或名詞片語 代表領域中持久且有意義的實體。

• 著重於領域物件，而非實作細節。

• 範例：成員, 書籍, 借閱, 訂單, 帳戶.

❌ 排除：暫時性項目（例如「借閱會話」）、同義詞（例如「使用者」對「成員」），或技術性工件（例如「資料庫」）。

2. 屬性

• 類別的特徵或屬性。

• 通常源自與類別相關的名詞.

• 範例：書籍 具有屬性： 標題, 作者, ISBN, 狀態.

3. 操作（方法）

• 類可以執行的動作，或對其執行的動作。

• 源自 動詞或動詞短語 在文字中。

• 範例： 成員.borrowBook(), 圖書館員.addBook().

4. 關係

類之間如何互動。使用UML的標準關係類型：

關係	含義	範例
關聯	類之間的一般連接	成員 與…關聯 貸款
聚合	「擁有」（部分-整體，弱擁有）	圖書館 聚合 書
組成	強「擁有」（整體擁有部分）	訂單 組成 訂單項目
繼承（泛化）	「是」關係	儲蓄帳戶 是 帳戶

⚠️ 多重性（例如，1, 0..1, 1..*, 0..*表示涉及多少個實例。

5. 其他UML元素

• 可見性: + (公開)， - (私人)， # (保護)

• 資料類型: 字串, 整數, 日期, 布林值

• 約束: {有序}, {唯一}，等等

---

🛠 分步手動流程與範例

讓我們透過一個實際範例來說明，使用一個 圖書館管理系統.

📝 問題陳述

「圖書館管理系統允許會員借閱和歸還書籍。每位會員都有唯一的識別碼和姓名。書籍具有書名、作者、ISBN及狀態（可借或已借出）。圖書館員可以新增書籍、搜尋書籍並管理借閱。當會員借閱書籍時，系統會記錄借閱日期和應還日期。若逾期，將計算罰款。」

---

步驟 1：閱讀並標示文字

底線標示 名詞/名詞片語和圓圈動詞/動作.

「A圖書館管理系統允許會員去借和歸還 書籍。每位會員擁有一個獨特的識別碼和姓名. 書籍擁有標題, 作者, ISBN，以及狀態（可借閱或已借出）。圖書館員可以新增新的書籍, 搜尋用於書籍，以及管理 借閱。當一位會員 借閱一本書，系統會記錄借閱日期以及應還日期。如果逾期, 罰款被計算計算.”

---

步驟 2：識別候選類別

名詞/片語	原因	類別？
圖書館管理系統	系統名稱（非類別）	❌
會員	持久化實體	✅ 會員
書籍	核心領域物件	✅ 書籍
圖書館員	具有責任的角色	✅ 圖書館員
借閱	交易性概念	✅ 借閱
罰款	財務後果	✅ 罰款
ID、姓名、書名、作者、ISBN、狀態、借閱日期、應還日期	屬性	—
借閱、歸還、新增、搜尋、管理、計算	動作	—

✅ 最終候選類別：

• 成員

• 書籍

• 圖書館員

• 借閱

• 罰款

📌 註解：罰款可被建模為值物件或類別視複雜度而定。我們將包含它以確保完整性。

---

步驟 3：識別屬性

類別	屬性	文字來源
成員	識別碼, 名稱	「唯一識別碼與名稱」
書籍	書名, 作者, ISBN, 狀態	“書名、作者、ISBN、狀態”
借閱	借出日期, 應還日期	“記錄借出日期和應還日期”
罰金	金額, 是否逾期	“若逾期，將計算罰金”

💡 小提示：避免重複。不要重複屬性，例如 狀態 在兩者中 書籍 和 借閱.

---

步驟 4：識別操作（方法）

類別	操作	文字來源
會員	borrowBook(), returnBook()	“借書和還書”
書籍	updateStatus()	由狀態變更所暗示
圖書館員	addBook(), searchBook(), manageLoan()	「新增書籍、搜尋書籍、管理借閱」
借閱	calculateFine()	「罰金已計算」
罰金	calculateAmount()	由「罰金已計算」所暗示

🔄 注意：某些操作可能更適合放置於圖書館員或借閱視責任而定。

---

步驟 5：識別關係

關係	方向	多重性	原因
會員 — 借閱	會員 → 借閱	1..*	一位成員可以有多筆借閱
書籍 — 借閱	書籍 → 借閱	1..1	每本書（每一份副本）只能有一筆借閱
圖書館員 — 書籍	圖書館員 → 書籍	1..*	圖書館員新增/管理多本圖書
圖書館員 — 借閱	圖書館員 → 借閱	1..*	圖書館員管理多筆借閱
借閱 — 罰款	借閱 → 罰款	0..1	只有逾期的借閱才會產生罰款

⚠️ 多重性說明:

• 1..* = 一對多

• 0..1 = 可選（零個或一個）

• 1..1 = 恰好一個

---

步驟 6：繪製類圖

以下是PlantUML 用於最終類圖的程式碼：

@startuml
' 定義類別
class Member {
  - id: 字串
  - name: 字串
  + borrowBook()
  + returnBook()
}

class Book {
  - title: 字串
  - author: 字串
  - ISBN: 字串
  - status: 字串
  + updateStatus()
}

class Loan {
  - borrowDate: 日期
  - dueDate: 日期
  + calculateFine()
}

class Librarian {
  - name: 字串
  - id: 字串
  + addBook()
  + searchBook()
  + manageLoan()
}

class Fine {
  - amount: 双精度浮點數
  - isOverdue: 布林值
  + calculateAmount()
}

' 定義關係
Member "1" -- "0..*" Loan : 借閱
Book "1" -- "1" Loan : 已借出
Librarian "1" -- "0..*" Book : 新增/管理
Librarian "1" -- "0..*" Loan : 管理
Loan "1" -- "0..1" Fine : 產生

' 可選：若罰款為值物件，可加入型態標記
note right of Fine
  罰款是值物件。
  根據逾期時間計算。
end note

' 樣式
skinparam shadowing false
skinparam rectangle {
  BackgroundColor 白色
  BorderColor 黑色
  FontSize 12
}
@enduml

---

🖼️ 視覺輸出（由 PlantUML 渲染）

📌 如何查看：將程式碼貼入PlantUML Live 或使用任何支援 PlantUML 的編輯器（例如：安裝外掛的 VS Code、IntelliJ、Visual Paradigm）。

📊 圖表概覽：

• 類別 以三個區段（名稱、屬性、運算）的矩形顯示。

• 關聯 是以多重性標籤標示的線條。

• 關係 反映領域邏輯與責任。

• 注意 在 很好 明確其作為值物件的角色。

---

🤖 使用 Visual Paradigm 的 AI 驅動文字分析自動化

為了更快地進行建模與學習，Visual Paradigm (VP) 提供一個 AI 驅動的文字分析工具 可自動化整個流程。

✅ 為什麼要使用 AI 工具？

優勢	描述
即時類別偵測	AI 掃描文字並建議類別、屬性和操作。
自動關係偵測	識別關聯、組成與多重性。
透明度	顯示包含或排除的原因（例如：「‘library’ 是一個系統，而非類別」）。
錯誤減少	最小化人為疏忽與不一致。
以範例學習	將 AI 的輸出與您的手動分析進行比較。

---

🧩 它如何運作（逐步說明）

1. 啟動 Visual Paradigm

   • 開啟桌面版或線上版。

   • 前往 工具 > 應用程式 > 文字分析.

2. 輸入或生成問題描述

    

   

    

   • 類型：「圖書館管理系統」

   • 點擊生成問題描述→ AI 創建一段詳細的文字。

   • 編輯以符合您的實際需求（或貼上您自己的內容）。

3. 識別候選類別

    

   

    

   • 點擊識別候選類別.

   • AI 返回一個表格：

     類別名稱     | 理由                    | 描述
     ---------------|---------------------------|-------------------------
     成員         | 名詞：持久性實體   | 借書的人
     書籍           | 名詞：核心物件         | 具有 ISBN 的實體書籍
     借閱           | 名詞：交易性概念 | 借閱記錄
     圖書館員      | 名詞：角色                | 管理系統的工作人員
     罰款           | 名詞：結果             | 逾期未還的財務罰款
     

   • 切換以查看被排除的名詞以及理由（例如：「圖書館」是一個系統，而非類別）。

4. 識別類別細節
   

   

    

   • 點擊識別類別細節.

   • AI 建議：

     • 成員: 識別碼, 名稱

     • 書籍: 書名, 作者, 國際標準書號, 狀態

     • 借閱: 借出日期, 應還日期

     • 罰款: 金額, 是否逾期

5. 識別類別關係

    

   

   點擊識別類別關係.

   • AI 提出：

     • 會員 — 借閱 (1..*)

     • 書籍 — 借閱 (1..1)

     • 圖書館員 — 書 (1..*)

     • 圖書館員 — 借閱 (1..*)

     • 借閱 — 罰款 (0..1)

6. 產生圖示

    

   

   點擊產生圖示.

   • 一個完全呈現且可編輯的UML 類別圖會立即出現。

✅ 專業提示：將 AI 輸出作為初稿。然後手動修改：

• 調整多重性

• 新增可見性（+, -)

• 重新組織版面

• 應用命名規範

---

🎓 初學者最佳實務

練習	為何重要
從手動開始	建立對 UML 和領域模型的深入理解。
比較 AI 與手動	了解 AI 為何做出某些選擇；找出錯誤。
迭代與精進	模型隨著回饋而演進——不要一開始就追求完美。
使用簡單範例	從以下開始：「線上購物車」、「自動櫃員機系統」、「學生註冊」。
避免過度設計	不要加入所有可能的屬性或操作——專注於核心領域。
與利害關係人驗證	確保模型反映現實需求。

---

🧩 實際應用範例以供練習

試試這些適合初學者的系統來測試你的技能：

系統	關鍵類別	學習重點
線上購物車	顧客, 產品, 購物車, 訂單, 付款	聚合、組成
自動櫃員機系統	使用者, 帳戶, 卡片, 交易, 提款	繼承、運算
學生註冊	學生, 課程, 註冊, 講師	多對多關係
任務管理應用程式	使用者, 任務, 專案, 截止日期	關聯，多重性

---

🧠 最後想法與建議

文字分析是黃金標準將需求轉化為設計的黃金標準。它教你以設計師的思維方式思考——而不僅僅是編碼。

🎯 推薦工作流程：

1. 首先手動分析 → 建立理解。

2. 使用 AI 工具（例如：Visual Paradigm） → 加速建模並驗證。

3. 手動精煉 → 提升清晰度、準確性與設計品質。

4. 迭代 → 利用反饋來演進模型。

🌟 總結:
首先學習手動流程。將 AI 作為強大的助手——而非替代品。