掌握 UML 類別圖——訂單處理案例研究

UML 類別圖是物件導向軟體設計的骨幹，提供系統結構的視覺藍圖。在本綜合教程中，我們將透過 VPasCode（Visual Paradigm 創新的）來逐步建立訂單處理系統的完整 UML 類別圖，以程式碼繪製圖形的工具以及統一的文字轉圖形平台。無論您是軟體架構師、開發人員或業務分析師，掌握類別圖對於將業務需求轉化為技術規格至關重要。憑藉 VPasCode 的即時渲染功能與 AI 驅動特性，這項以程式碼繪製圖形的工具讓您能將文字轉換為圖形佈局，並在輸入時即時驗證您的設計決策。

Complete UML class diagram for order processing system generated using VPasCode diagram-as-code tool
我們訂單處理系統的最終 UML 類別圖

理解業務需求

在開始編寫程式碼之前，讓我們先確立訂單處理系統的業務需求：

  • 客戶可以下達包含多種產品的訂單
  • 每筆訂單必須追蹤訂單日期、送貨地址與狀態
  • 產品具有名稱、價格與庫存數量
  • 付款可透過信用卡、PayPal 或銀行轉帳進行
  • 系統必須計算包含稅金與運費的訂單總額
  • 訂單在其生命週期中可有多次狀態更新

這些需求將指導我們的類別圖設計，確保我們捕捉所有必要的實體、屬性與關係。

開始使用 VPasCode

VPasCode 是一款強大的以程式碼繪製圖形的工具，也是統一的文字轉圖形平台，支援 PlantUML、Mermaid 與 Graphviz 等流行格式。該平台提供免費的程式碼編輯器，具備即時渲染功能，非常適合迭代設計。

為何選擇 VPasCode 來繪製 UML 類別圖？

  • 即時預覽：輸入時即可即時看到圖形更新
  • AI 錯誤修正：自動偵測並透過 AI 協助修正語法錯誤
  • 多種格式：支援 PlantUML、Mermaid.js 與 Graphviz
  • 輕鬆分享：產生可分享的 URL 以進行協作
  • 匯出選項：下載為 SVG 或 PNG 格式以用於文件記錄
VPasCode text to diagram interface featuring code editor and live UML class diagram preview
VPasCode 直覺式介面，內建分割螢幕程式碼編輯器與即時預覽功能

逐步建立類別圖

步驟 1：定義核心類別

讓我們先使用 PlantUML 語法定義主要類別。開啟 VPasCode，從基本結構開始：

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
@startuml OrderProcessingSystem

title 訂單處理系統 - 類別圖

class Customer {
    - customerId: Long
    - firstName: String
    - lastName: String
    - email: String
    - phone: String
    - registrationDate: Date
    - loyaltyPoints: Integer
    --
    + register(): Boolean
    + updateProfile(): void
    + getFullName(): String
    + getOrderHistory(): List
}

@enduml
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML

注意 VPasCode 的即時渲染功能會立即顯示您的類別。這種即時回饋有助於您及早發現設計問題。

Customer and Address classes created in VPasCode text to diagram platform
客戶類別即時渲染結果

步驟 2：新增訂單類別

現在讓我們新增訂單類別，它是我們系統中的核心實體：

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
class Order {
    - orderId: Long
    - orderDate: Date
    - status: OrderStatus
    - shippingAddress: String
    - totalAmount: Double
    - taxAmount: Double
    - discountAmount: Double
    - deliveryDate: Date
    --
    + calculateTotal(): Double
    + addItem(product: Product, quantity: Integer): void
    + removeItem(orderItem: OrderItem): void
    + updateStatus(newStatus: OrderStatus): void
    + cancel(): Boolean
}

enum OrderStatus {
    PENDING
    CONFIRMED
    PROCESSING
    SHIPPED
    DELIVERED
    CANCELLED
    RETURNED
}
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML

步驟 3：定義商品與訂單項目

商品與訂單項目構成每個訂單的庫存與明細項目：

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
class Product {
    - productId: Long
    - name: String
    - description: String
    - price: Double
    - cost: Double
    - stockQuantity: Integer
    - category: String
    - reorderLevel: Integer
    - isActive: Boolean
    --
    + updateStock(quantity: Integer): void
    + isInStock(quantity: Integer): Boolean
    + applyDiscount(percentage: Double): Double
    + getProfitMargin(): Double
}

class OrderItem {
    - orderItemId: Long
    - quantity: Integer
    - unitPrice: Double
    - totalPrice: Double
    - discountAmount: Double
    - taxAmount: Double
    --
    + calculateTotal(): Double
    + applyDiscount(percentage: Double): void
    + getSubtotal(): Double
}
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML

步驟 4：實作付款處理

一個穩健的訂單處理系統需要靈活的付款處理機制：

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
class Payment {
    - paymentId: Long
    - amount: Double
    - paymentDate: Date
    - method: PaymentMethod
    - status: PaymentStatus
    - transactionId: String
    - confirmationNumber: String
    --
    + processPayment(): Boolean
    + refund(): Boolean
    + verifyPayment(): Boolean
    + getPaymentReceipt(): String
}

enum PaymentMethod {
    CREDIT_CARD
    DEBIT_CARD
    NET_BANKING
    DIGITAL_WALLET
    COD
    UPI
}

enum PaymentStatus {
    PENDING
    COMPLETED
    FAILED
    REFUNDED
    CANCELLED
}
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML
Order and Product relationships modeled using VPasCode diagram-as-code tool
包含 Payment 類別階層結構的擴充圖表

建立關聯關係

現在進入關鍵部分：定義類別之間的關聯。這正是您物件導向設計技能真正展現之處。

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
' 關聯關係
Customer "1" -- "0..*" Order : places >
Order "1" -- "1..*" OrderItem : contains >
OrderItem "1" -- "1" Product : references >
Order "1" -- "0..1" Payment : has >
Order ..> OrderStatus : uses
Payment ..> PaymentMethod : uses
Payment ..> PaymentStatus : uses
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML

理解關聯關係

  • 客戶到訂單（一對多）：一位客戶可以下達多筆訂單
  • 訂單到訂單項目（一對多）：每筆訂單包含多個明細項目
  • 訂單項目到產品（多對一）：多個訂單項目可以參照同一產品
  • 訂單到付款（一對一）：每筆訂單對應一筆付款交易
  • 組合關係：訂單項目組成訂單（強所有權）
Payment inheritance hierarchy converted from text to diagram in VPasCode
包含完整關聯與基數的最終類別圖表

額外福利——善用 AI 驅動功能

AI 程式碼錯誤修正

VPasCode 的突出功能之一是AI 程式碼錯誤修正。當您遇到語法錯誤時，只需點擊「由 AI 修正」即可獲得即時修正。AI 不僅修正程式碼，還會說明錯誤原因，協助您學習並提升 PlantUML 技能。

例如，如果您遺漏了閉合大括號或誤用了關聯運算子，VPasCode 的 AI 將會：

  1. 自動偵測錯誤
  2. 建議正確的語法
  3. 提供並排差異比對，顯示變更內容
  4. 解釋修復背後的 reasoning

為全球團隊提供的 AI 翻譯

與國際團隊合作？VPasCode 的AI 翻譯功能允許您在保持圖表結構的同時，將類別名稱、屬性與註解翻譯成不同語言。這對於跨越語言障礙的文檔撰寫與利害關係人溝通至關重要。

驗證您的設計

在完整的圖表已就定位後，讓我們根據原始需求驗證我們的設計：

設計驗證檢查清單

  • ✓ 客戶可以下達多個訂單（一對多關係）
  • ✓ 訂單追蹤日期、狀態與送貨地址
  • ✓ 產品維護庫存與價格
  • ✓ 透過繼承支援多種付款方式
  • ✓ 訂單總額由商品、稅金與運費計算得出
  • ✓ 訂單狀態透過列舉（enum）追蹤
  • ✓ 地址同時用於客戶與送貨

應用的設計原則

我們的類別圖展示了幾個關鍵的物件導向設計原則：

  • 單一職責：每個類別只有一個明確的目的
  • 開放/封閉原則：支付系統對擴充開放（新增付款方式），但對修改封閉
  • DRY（不要重複自己）：重複使用地址類別，而非複製地址欄位
  • 封裝：私有屬性搭配公共方法

匯出與分享您的圖表

當您對設計感到滿意後，VPasCode 讓分享與整合您的工作變得輕鬆：

匯出選項

  • SVG：向量格式，非常適合用於文檔與簡報
  • PNG：用於快速分享和網頁使用的網格格式
  • 可分享的 URL：建立連結以進行團隊協作

與 Visual Paradigm 生態系整合

若要建立完整的文件，您可以將您的圖表直接傳送至Visual Paradigm OpenDocs以建立結合圖表與詳細規格說明之專業技術文件。

此外，若您正在使用Visual Paradigm AI App Studio您可以將您的類別圖表作為 AI 輔助應用程式開發的基礎。AI 可協助產生基本程式碼、建議設計模式，甚至識別您模型的潛在改進。

Embedding UML class diagrams into OpenDocs using VPasCode text to diagram platform
提供多種圖表匯出與分享選項

完整的 PlantUML 程式碼

以下是我們訂單處理系統類別圖表的完整 PlantUML 程式碼。您可以直接複製此程式碼至 VPasCode 以查看即時渲染：

PlantUML 在 VPasCode 中編輯 PlantUML
PlantUML Edit PlantUML in VPasCode 
@startuml OrderProcessingSystem

title 訂單處理系統 - 類別圖

class Customer {
    - customerId: Long
    - firstName: String
    - lastName: String
    - email: String
    - phone: String
    - registrationDate: Date
    - loyaltyPoints: Integer
    --
    + register(): Boolean
    + updateProfile(): void
    + getFullName(): String
    + getOrderHistory(): List
}

class Order {
    - orderId: Long
    - orderDate: Date
    - status: OrderStatus
    - shippingAddress: String
    - totalAmount: Double
    - taxAmount: Double
    - discountAmount: Double
    - deliveryDate: Date
    --
    + calculateTotal(): Double
    + addItem(product: Product, quantity: Integer): void
    + removeItem(orderItem: OrderItem): void
    + updateStatus(newStatus: OrderStatus): void
    + cancel(): Boolean
}

enum OrderStatus {
    PENDING
    CONFIRMED
    PROCESSING
    SHIPPED
    DELIVERED
    CANCELLED
    RETURNED
}

class Product {
    - productId: Long
    - name: String
    - description: String
    - price: Double
    - cost: Double
    - stockQuantity: Integer
    - category: String
    - reorderLevel: Integer
    - isActive: Boolean
    --
    + updateStock(quantity: Integer): void
    + isInStock(quantity: Integer): Boolean
    + applyDiscount(percentage: Double): Double
    + getProfitMargin(): Double
}

class OrderItem {
    - orderItemId: Long
    - quantity: Integer
    - unitPrice: Double
    - totalPrice: Double
    - discountAmount: Double
    - taxAmount: Double
    --
    + calculateTotal(): Double
    + applyDiscount(percentage: Double): void
    + getSubtotal(): Double
}

class Payment {
    - paymentId: Long
    - amount: Double
    - paymentDate: Date
    - method: PaymentMethod
    - status: PaymentStatus
    - transactionId: String
    - confirmationNumber: String
    --
    + processPayment(): Boolean
    + refund(): Boolean
    + verifyPayment(): Boolean
    + getPaymentReceipt(): String
}

enum PaymentMethod {
    CREDIT_CARD
    DEBIT_CARD
    NET_BANKING
    DIGITAL_WALLET
    COD
    UPI
}

enum PaymentStatus {
    PENDING
    COMPLETED
    FAILED
    REFUNDED
    CANCELLED
}

' 關聯
Customer "1" -- "0..*" Order : 下單 >
Order "1" -- "1..*" OrderItem : 包含 >
OrderItem "1" -- "1" Product : 引用 >
Order "1" -- "0..1" Payment : 擁有 >
Order ..> OrderStatus : 使用
Payment ..> PaymentMethod : 使用
Payment ..> PaymentStatus : 使用

@enduml
Edit PlantUML in VPasCode
在 VPasCode 中編輯 PlantUML

後續步驟與最佳實踐

擴展設計

隨著系統成長，請考慮以下擴展：

  • 新增一個購物車類別，用於臨時儲存訂單
  • 實作折扣與優惠券類別
  • 建立一個「庫存」管理系統
  • 新增「運送」與「追蹤」類別
  • 實作「評論」與「評分」功能

結論

建立專業 UML 類別圖並不一定要枯燥乏味。透過「VPasCode」，您可以高效地將業務需求轉化為視覺模型，利用即時渲染、AI 驅動的錯誤修正以及無縫的匯出選項。

本訂單處理案例研究展示了基於文字的圖形化如何結合程式碼的精確性與視覺建模的清晰度。無論您是軟體架構師、開發人員或業務分析師，掌握使用可靠的「圖形即程式碼」工具將文字轉換為圖形的流程，對於將業務需求轉化為技術規格至關重要。

準備好開始建立您自己的類別圖了嗎？請造訪「VPasCode」，體驗圖形即程式碼的未來。基本功能免費，若您需進階功能，請升級至 Visual Paradigm Online Combo Edition 或 Visual Paradigm Desktop Professional Edition（含主動維護服務）。

今日開始圖形化

加入數千名已使用 VPasCode 建立更佳軟體設計的開發人員與架構師。無需安裝——立即在瀏覽器中開始建立專業 UML 圖形。

免費試用 VPasCode → www.vpascode.com

常見問題

什麼是 VPasCode？

VPasCode 是 Visual Paradigm 統一的文字轉圖形平台，讓您能使用 PlantUML、Mermaid 和 Graphviz 等流行格式建立圖形。它提供免費程式碼編輯器，具備即時渲染、AI 錯誤修正及多種匯出選項。

VPasCode 免費使用嗎？

是的！VPasCode 提供免費功能，包括圖形編輯、即時渲染以及匯出為 SVG 或 PNG。進階功能需搭配 Visual Paradigm Online Combo Edition 或 Visual Paradigm Desktop Professional Edition（含主動維護服務）使用。

VPasCode 支援哪些圖形類型？

VPasCode 支援多種圖表類型，包括透過 PlantUML、Mermaid 和 Graphviz 格式提供的 UML 類別圖、序列圖、使用案例圖、活動圖、實體關係圖（ERD）、流程圖、心智圖、甘特圖等，以及更多類型。

我可以使用 VPasCode 與團隊協作嗎？

當然可以！VPasCode 允許您為圖表生成可分享的網址，讓您能輕鬆與團隊成員協作。您還可以整合 Visual Paradigm OpenDocs，以進行完整的文件記錄。

VPasCode 是否支援離線使用？

VPasCode 是一個需要網路連線的網頁平台。不過，您可以將 PlantUML 程式碼儲存至本地端，並在需要時使用其他 PlantUML 工具離線操作。

Related posts:

掌握 ArchiMate 建模：使用 PlantUML 構建圖書館管理系統掌握 ArchiMate 建模：使用 PlantUML 構建圖書館管理系統 使用 PlantUML 和 VPasCode 構建專業的倉儲管理用例圖使用 PlantUML 和 VPasCode 構建專業的倉儲管理用例圖 使用 PlantUML 和 VPasCode 構建酒店管理實體關係圖 (ERD)使用 PlantUML 和 VPasCode 構建酒店管理實體關係圖 (ERD) PlantUML、Mermaid 還是 Graphviz？您應該選擇哪一個？PlantUML、Mermaid 還是 Graphviz？您應該選擇哪一個？
返回頂端