Master PlantUML Use Case Diagrams with VPasCode

Khi thiết kế các ứng dụng doanh nghiệp phức tạp như Hệ thống Quản lý Kho (WMS), việc trực quan hóa các ranh giới hệ thống, các vai trò (actors) và các trường hợp sử dụng là điều thiết yếu. Với tư cách là một giảng viên kỹ thuật chuyên gia tại Visual Paradigm, tôi thường xuyên được hỏi làm thế nào để tạo ra các sơ đồ kiến trúc sạch sẽ, sẵn sàng trình bày mà không bị vướng mắc bởi các công cụ kéo-thả cồng kềnh. Trong bài hướng dẫn masterclass này, tôi sẽ dẫn dắt bạn qua quy trình tư duy chính xác của tôi để xây dựng một sơ đồ trường hợp sử dụng WMS toàn diện bằng cách sử dụng PlantUML bên trong trình soạn thảo PlantUML miễn phí, VPasCode.

Dưới đây là bản xem trước của sơ đồ cuối cùng mà chúng ta sẽ cùng nhau xây dựng:

Final Use Case Diagram for Warehouse Management System — Sơ đồ trường hợp sử dụng cuối cùng cho Hệ thống Quản lý Kho

1. Thiết lập các kiểu toàn cục và cấu trúc nền tảng

Mỗi khi tôi bắt đầu một dự án sơ đồ dưới dạng mã mới, ưu tiên hàng đầu của tôi là thiết lập một hệ thống phân cấp trực quan và thẩm mỹ nhất quán. Các sơ đồ tiêu chuẩn thường có thể trông lộn xộn, vì vậy tôi thích ghi đè các kiểu mặc định ngay từ đầu để đảm bảo các đường nét sạch sẽ, kiểu chữ dễ đọc và bảng màu có cấu trúc.

Tôi bắt đầu bằng cách cấu hình các bộ kết nối trực giao (kiểu đường thẳng ortho) để giữ cho tất cả các đường kết nối sạch sẽ, nằm ngang hoặc thẳng đứng—tránh các đường chéo lộn xộn cắt ngang qua văn bản. Sau đó, tôi thiết lập mã màu tùy chỉnh cho các vai trò và trường hợp sử dụng để phân biệt ngay lập tức các vai trò chính, các thực thể phụ và các ranh giới hệ thống nội bộ.

@startuml
skinparam linetype ortho
skinparam defaultFontSize 14
skinparam defaultFontColor #333333
skinparam vpDiagramType UseCaseDiagram
skinparam actor {
  BackgroundColor #E8F5E9
}
skinparam usecase {
  BackgroundColor #BBDEFB
  BorderColor #1976D2
  ArrowColor #1976D2
}

left to right direction

2. Xác định các vai trò hệ thống và ranh giới hệ thống

Tiếp theo, tôi cần xác định ranh giới của hệ thống và xác định ai tương tác với nó. Trong kịch bản quản lý kho của chúng ta, chúng ta có ba vai trò riêng biệt:

Quản lý Kho: Một vai trò chính chịu trách nhiệm cho các hoạt động hàng ngày, mức tồn kho và các chuyển động hàng tồn kho.
Quản trị viên: Một vai trò chính quản lý các số lượng tồn kho cấp cao, đơn đặt hàng mua hàng và báo cáo hệ thống.
Nhà cung cấp: Một vai trò phụ kích hoạt các lô hàng đến và nhập kho từ góc độ bên ngoài.

Tôi bao bọc tất cả các chức năng hệ thống nội bộ bên trong một hình chữ nhậtkhung chứa đại diện cho Hệ thống Quản lý Kho. Điều này tách biệt rõ ràng các trường hợp sử dụng nội bộ khỏi các vai trò bên ngoài.

actor "Quản lý Khon(Chính)" as manager
actor "Quản trị viênn(Chính)" as admin
actor "Nhà cung cấpn(Phụ)" as supplier

rectangle "Hệ thống Quản lý Kho" {
  usecase "Tiếp nhận hàng hóa nhập" as UC1
  usecase "Xử lý đơn đặt hàng mua" as UC2
  usecase "Đăng ký lô hàng đến" as UC3
  usecase "Thực hiện nhập kho" as UC4
  usecase "Chọn đơn hàng" as UC5
  usecase "Xử lý đơn hàng bán" as UC6
  usecase "Thực hiện xuất kho" as UC7
  usecase "Quản lý mức tồn kho" as UC8
  usecase "Thực hiện kiểm kê" as UC9
  usecase "Tạo báo cáo" as UC10
}

3. Ánh xạ các mối liên kết vai trò và mã màu

Để làm cho sơ đồ dễ dàng quét trực quan, tôi ánh xạ các mối liên kết giữa các vai trò và các trường hợp sử dụng tương ứng của họ. Tôi áp dụng các liên kết có mã màu tương ứng với từng loại vai trò: màu đen trung tính cho quản lý kho, màu đỏ thẫm cho quản trị viên và màu vàng đồng cho nhà cung cấp. Kỹ thuật này giúp giảm đáng kể tải nhận thức khi các nhà đánh giá phân tích quyền hạn hệ thống.


quản lý -[#black]- UC1
quản lý -[#black]- UC5
quản lý -[#black]- UC10
quản lý -[#black]- UC8
quản trị viên -[#crimson]- UC2
quản trị viên -[#crimson]- UC6
quản trị viên -[#crimson]- UC9
UC3 -[#goldenrod]- nhà cung cấp
UC4 -[#goldenrod]- nhà cung cấp

4. Thiết lập các mối quan hệ giữa các trường hợp sử dụng (Includes và Extends)

Bước cuối cùng là xác định cách các trường hợp sử dụng nội bộ liên quan đến nhau thông qua các mũi tên phụ thuộc. Tôi sử dụng <<include>> để hiển thị các quy trình con bắt buộc (chẳng hạn như nhận hàng nhập khẩu yêu cầu đăng ký vận chuyển và ghi nhận nhập kho) và <<extend>> cho các hành vi tùy chọn hoặc có điều kiện như quản lý mức tồn kho trong tình trạng hết hàng.

UC1 ...> UC2 : <>
UC1 ...> UC3 : <>
UC1 ...> UC4 : <>
UC2 ...> UC6 : <>
UC5 ...> UC6 : <>
UC8 <... UC7 : <>
@enduml

Tại sao nên sử dụng VPasCode cho quy trình vẽ sơ đồ của bạn?

Xây dựng sơ đồ này bên trong VPasCode mang lại cho bạn nhiều lợi thế rõ rệt so với các công cụ vẽ trên máy tính để bàn truyền thống:

Hiển thị thời gian thực:Khi bạn nhập hoặc tinh chỉnh mã PlantUML, bản xem trước trực quan sẽ được cập nhật ngay lập tức.
Phát hiện định dạng tự động:Bạn không bao giờ phải chỉ định thủ công công cụ cú pháp—VPasCode tự động phát hiện PlantUML, Mermaid và các định dạng khác ngay lập tức.
Tùy chọn xuất miễn phí:Tải xuống các sơ đồ kiến trúc hoàn chỉnh của bạn dưới dạng PNG độ phân giải cao, SVG có thể mở rộng, hoặc chia sẻ ngay lập tức với nhóm của bạn qua các liên kết an toàn.