Xây dựng sơ đồ tuần tự rút tiền ATM bền vững trong PlantUML

Bước 1: Thiết lập tiêu đề và đánh số bước tự động

Tôi luôn bắt đầu các sơ đồ PlantUML bằng cách thiết lập cấu hình toàn cục rõ ràng. Khi mô hình hóa các thao tác tài chính như rút tiền ATM, việc theo dõi thứ tự thực thi là rất quan trọng đối với cả nhà phát triển và kiểm toán viên.

Để đạt được điều này, tôi bắt đầu bằng @startumlthẻ, định nghĩa tiêu đề mô tả, và bật tính năng autonumbertính năng.

@startuml
title Sơ đồ tuần tự rút tiền ATM

autonumber

Tại sao lại sử dụng autonumber?Không có đánh số tự động, người xem phải theo dõi thủ công các đường tuần tự để hiểu thứ tự. Bắt buộc đánh số tuần tự sẽ tự động đánh chỉ mục mọi yêu cầu và phản hồi, giúp tham chiếu chéo trong các buổi đánh giá kiến trúc trở nên hoàn toàn dễ dàng.

Bước 2: Xác định các tác nhân và người tham gia hệ thống

Tiếp theo, tôi xác định các thực thể riêng biệt tham gia vào giao dịch. Tôi muốn phân biệt các tác nhân con người với các thành phần nền tảng và các hệ thống phần cứng.

Thay vì để PlantUML khai báo người tham gia ngầm định khi vẽ tin nhắn, tôi khai báo rõ ràng chúng ở đầu. Điều này đảm bảo chúng xuất hiện theo thứ tự hợp lý, từ trái sang phải, phản ánh ranh giới kiến trúc của chúng:

actor Khách hàng
participant "Giao diện ATM" as ATM
participant "Bộ đọc thẻ" as Reader
participant "Máy chủ Ngân hàng" as Bank
participant "Thiết bị phát tiền" as Dispenser

Lý do thiết kế:

• actor Khách hàng: Đại diện cho người dùng thực hiện hành động.
• participant ... as Bí danh: Gán các bí danh ngắn như Máy ATM, Thiết bị quét, và Ngân hàng giúp phần còn lại của đoạn mã trở nên sạch sẽ và dễ đọc mà không cần lặp lại các chuỗi hiển thị dài.
• Bằng cách đặt Thiết bị quét giữa Khách hàng và Giao diện Máy ATM, tôi phản ánh chính xác trình tự vật lý khi đưa thẻ vào trước khi tương tác với giao diện phần mềm.

Bước 3: Mô hình hóa luồng xác thực ban đầu

Với các thành viên đã được khai báo, tôi bắt đầu lập bản đồ cho quá trình khởi tạo theo đường đi thuận lợi: đưa thẻ vào, đọc dữ liệu, yêu cầu nhập mã PIN và liên hệ với máy chủ ngân hàng trung tâm.

Khách hàng -> Thiết bị quét: Đưa thẻ ATM
Thiết bị quét -> Máy ATM: Đọc thông tin thẻ
Máy ATM -> Khách hàng: Yêu cầu nhập mã PIN
Khách hàng -> Máy ATM: Nhập mã PIN
Máy ATM -> Ngân hàng: Xác minh thẻ và mã PIN

Lưu ý cách các tin nhắn đồng bộ sử dụng mũi tên liền (->). Phần cứng thẻ kích hoạt phần mềm máy ATM, phần mềm này sẽ yêu cầu người dùng, thu thập đầu vào và truyền thông tin xác thực một cách an toàn đến Ngân hàng máy chủ.

Bước 4: Cấu trúc nhánh xác thực với khối alt khối

Các hệ thống thực tế có thể thất bại, và các sơ đồ tuần tự phải truyền đạt rõ ràng các điều kiện lỗi. Khi máy ATM yêu cầu xác minh từ ngân hàng, hai kết quả có thể xảy ra: xác thực thất bại hoặc thành công.

Để biểu diễn logic điều kiện trong PlantUML, tôi sử dụng một alt / else / end khối:

alt PIN Sai
    Ngân hàng --> ATM: Xác thực Thất bại
    ATM -> Khách hàng: Hiển thị thông báo "PIN Sai"
    ATM -> Bộ đọc: Tháo thẻ
    Bộ đọc --> Khách hàng: Trả lại thẻ
else PIN Hợp lệ
    Ngân hàng --> ATM: Xác thực Thành công
    ATM -> Khách hàng: Yêu cầu chọn giao dịch & số tiền
    Khách hàng -> ATM: Chọn "Rút tiền" & Nhập số tiền
    ATM -> Ngân hàng: Yêu cầu xác nhận rút tiền (Số tiền)
    ...
end

Các kỹ thuật chính được sử dụng:

• Các mũi tên trả về điểm đứt đoạn (-->) báo hiệu các tin nhắn phản hồi bất đồng bộ trở lại các thành phần gọi.
• Các nhãn khối rõ ràng như [PIN Sai] và [PIN Hợp lệ] ngay lập tức cung cấp cho các nhà phát triển phần mềm thông tin về cách luồng ngoại lệ kết thúc (ví dụ: hiển thị lỗi, tháo thẻ và trả lại thiết bị).

Bước 5: Lồng ghép logic xác thực tài khoản và phát tiền

Sau khi xác thực được xác minh, người dùng yêu cầu rút tiền. Tuy nhiên, ngân hàng phải xác minh số dư tài khoản và giới hạn hàng ngày. Để biểu diễn kiểm tra thứ cấp này, tôi lồng một khối thứ hai alt khối bên trong PIN Hợp lệ nhánh.

Nếu số dư không đủ, giao dịch sẽ kết thúc an toàn. Nếu được chấp thuận, ngân hàng sẽ trừ tiền từ tài khoản, kích hoạt máy phát tiền, đưa tiền ra, tháo thẻ và cung cấp hóa đơn in tùy chọn.

    alt Số dư Không Đủ / Vượt Giới Hạn Hàng Ngày
        Ngân hàng --> ATM: Giao dịch Bị Từ Chối
        ATM -> Khách hàng: Hiển thị Thông báo Lỗi
        ATM -> Bộ đọc: Tháo thẻ
        Bộ đọc --> Khách hàng: Trả lại thẻ
    else Tài khoản Được Chấp Thuận
        Ngân hàng -> Ngân hàng: Trừ Số Dư Tài Khoản
        Ngân hàng --> ATM: Giao dịch Được Chấp Thuận

        ATM -> Máy Phát Tiền: Phát Tiền
        Máy Phát Tiền --> ATM: Tiền Sẵn Sàng
        ATM -> Khách hàng: Trả tiền
        Khách hàng -> ATM: Nhận Tiền

        ATM -> Bộ đọc: Tháo thẻ
        Bộ đọc --> Khách hàng: Trả lại thẻ
        ATM -> Khách hàng: In Hóa Đơn (Tùy chọn)
    end

Mẹo Chuyên Gia: Lưu ý đến lời gọi nội bộ Ngân hàng -> Ngân hàng: Trừ Số Dư Tài Khoản. Các mũi tên tự tham chiếu trong PlantUML rất lý tưởng để làm nổi bật các cập nhật trạng thái nội bộ phía backend mà không liên quan đến tin nhắn mạng bên ngoài.

Bản mã PlantUML Hoàn chỉnh

bản mã PlantUML yêu thích của bạntrình chỉnh sửa PlantUML miễn phí để chỉnh sửa hoặc tạo đồ họa vector:

@startuml
title Sơ đồ tuần tự rút tiền ATM

autonumber
actor Khách hàng
participant "Giao diện ATM" as ATM
participant "Bộ đọc thẻ" as Reader
participant "Máy chủ Ngân hàng" as Bank
participant "Máy phát tiền" as Dispenser

Khách hàng -> Reader: Thêm thẻ ATM
Reader -> ATM: Đọc thông tin thẻ
ATM -> Khách hàng: Yêu cầu nhập mã PIN
Khách hàng -> ATM: Nhập mã PIN
ATM -> Bank: Xác minh thẻ & PIN

alt PIN sai
    Bank --> ATM: Xác thực thất bại
    ATM -> Khách hàng: Hiển thị thông báo "Mã PIN không hợp lệ"
    ATM -> Reader: Tháo thẻ
    Reader --> Khách hàng: Trả lại thẻ
else PIN đúng
    Bank --> ATM: Xác thực thành công
    ATM -> Khách hàng: Yêu cầu chọn giao dịch và số tiền
    Khách hàng -> ATM: Chọn "Rút tiền" và nhập số tiền

    ATM -> Bank: Yêu cầu xác nhận rút tiền (Số tiền)

    alt Số dư không đủ / Vượt giới hạn hàng ngày
        Bank --> ATM: Giao dịch bị từ chối
        ATM -> Khách hàng: Hiển thị thông báo lỗi
        ATM -> Reader: Tháo thẻ
        Reader --> Khách hàng: Trả lại thẻ
    else Tài khoản được chấp thuận
        Bank -> Bank: Giảm số dư tài khoản
        Bank --> ATM: Giao dịch được chấp thuận

        ATM -> Dispenser: Phát tiền
        Dispenser --> ATM: Tiền sẵn sàng
        ATM -> Khách hàng: Trả tiền
        Khách hàng -> ATM: Nhận tiền

        ATM -> Reader: Tháo thẻ
        Reader --> Khách hàng: Trả lại thẻ
        ATM -> Khách hàng: In hóa đơn (Tùy chọn)
    end
end

@enduml

Tại sao bạn nên tạo hình ảnh sơ đồ tuần tự với VPasCode?

Việc tạo các sơ đồ phức tạp bằng mã nguồn không nên đòi hỏi việc thiết lập môi trường cục bộ phức tạp hay biên dịch thủ công qua dòng lệnh.VPasCodedo Visual Paradigm mang đến khả năng hiển thị tức thì và trợ giúp AI mạnh mẽ ngay lập tức trong trình duyệt của bạn:

• Phát hiện định dạng tự động:Dán mã PlantUML, Mermaid, Graphviz hoặc D2—VPasCode ngay lập tức nhận diện định dạng DSL và hiển thị trực tiếp.
• Sửa lỗi mã bằng AI:Bị mắc kẹt vì lỗi cú pháp? Nhấn vào“Sửa bằng AI”để xem các khác biệt rõ ràng so sánh song song và tự động sửa lỗi cú pháp.
• Dịch thuật AI đa ngôn ngữ:Dịch nhanh chóng nhãn sơ đồ và tin nhắn cho các nhóm kỹ thuật quốc tế chỉ trong vài giây.
• Xuất với độ phân giải cao:Tải về các hình ảnh vector SVG sạch sẽ, có thể mở rộng hoặc ảnh PNG độ phân giải cao cho tài liệu kỹ thuật và bản trình bày.