Từ Văn bản đến Kiến trúc: Làm chủ VPasCode của Visual Paradigm cho các đội Agile

@startuml

class ThưViện {
  - tên: Chuỗi
  - địa chỉ: Chuỗi
  - điện thoại: Chuỗi
  + thêmThành viên(thànhViên: ThànhViên): void
  + xóaThànhViên(mãThànhViên: Chuỗi): void
  + thêmTàiSản(tàiSản: TàiSảnThưViện): void
  + xóaTàiSản(mãTàiSản: Chuỗi): void
  + choMượnTàiSản(mãThànhViên: Chuỗi, mãTàiSản: Chuỗi): boolean
  + trảTàiSản(mãTàiSản: Chuỗi): boolean
}

class TàiSảnThưViện {
  # mãTàiSản: Chuỗi
  # tiêu đề: Chuỗi
  # nhàXuấtBản: Chuỗi
  # nămXuấtBản: int
  # cóSẵn: boolean
  + lấyChiTiết(): Chuỗi
  + đặtTrạngTháiSẵn(status: boolean): void
}

abstract class Sách {
  - isbn: Chuỗi
  - tácGiả: Chuỗi
  - sốTrang: int
  + lấyTácGiả(): Chuỗi
}

class SáchĐiệnTử {
  - kíchThướcFileMB: double
  - địnhDạng: Chuỗi
  - đườngDẫnTảiXuống: Chuỗi
  + tảiXuống(): void
}

class SáchIn {
  - vịTríTrênKệ: Chuỗi
  - tìnhTrạng: Chuỗi
  + lấyVịTríKệ(): Chuỗi
}

class TạpChí {
  - sốPhátHành: int
  - sốTập: int
  - ngàyBìa: Ngày
}

class DVD {
  - thờiLượngPhút: int
  - đạoDiễn: Chuỗi
  - ngônNgữ: Chuỗi
  - cóPhụĐề: boolean
}

class ThànhViên {
  - mãThànhViên: Chuỗi
  - tên: Chuỗi
  - email: Chuỗi
  - điện thoại: Chuỗi
  - ngàyGiaNhập: Ngày
  + mượnTàiSản(tàiSản: TàiSảnThưViện): boolean
  + trảTàiSản(tàiSản: TàiSảnThưViện): boolean
  + lấyDanhSáchĐãMượn(): DanhSách
}

class HồSơMượn {
  - mãHồSơ: Chuỗi
  - ngàyMượn: Ngày
  - ngàyHạn: Ngày
  - ngàyTrả: Ngày
  - cóQuáHạn(): boolean
  - tínhPhạt(): double
}

class Phạt {
  - mãPhạt: Chuỗi
  - sốTiền: double
  - ngàyPhátHành: Ngày
  - đãThanhToán: boolean
  + thanhToánPhạt(): void
}

class ThủThư {
  - mãNhânViên: Chuỗi
  - phòngBan: Chuỗi
  + xửLýMượn(thànhViên: ThànhViên, tàiSản: TàiSảnThưViện): void
  + xửLýTrả(tàiSản: TàiSảnThưViện): void
  + tạoBáoCáo(): void
  + quảnLýTồnKho(): void
}

' Mối quan hệ thừa kế
TàiSảnThưViện <|-- Sách
TàiSảnThưViện <|-- TạpChí
TàiSảnThưViện <|-- DVD
Sách <|-- SáchĐiệnTử
Sách <|-- SáchIn 

' Tổng hợp và tập hợp 

ThưViện "1" -- "nhiều" ThànhViên : có >
ThưViện "1" -- "nhiều" TàiSảnThưViện : chứa >
ThưViện "1" -- "nhiều" ThủThư : tuyển dụng >

ThànhViên "1" -- "nhiều" HồSơMượn : có >
HồSơMượn "1" -- "1..*" TàiSảnThưViện : tham chiếu >
HồSơMượn "1" -- "0..*" Phạt : tạo ra >

' Liên kết
ThủThư --> HồSơMượn : quản lý >
ThànhViên --> HồSơMượn : tạo ra >

note trên ThưViện : Hệ thống trung tâm quản lýnthành viên, tài sản và việc cho mượn
note phải TàiSảnThưViện : Lớp cơ sở trừu tượngncho tất cả tài liệu thư viện
@enduml

@startuml
' Tiêu đề
title Rút tiền ATM - Sơ đồ trình tự

' Diễn viên và thành phần tham gia
actor KháchHàng as C
participant "ATM" as ATM
participant "Hệ thống Ngân hàng" as BS
database "Tài khoản Khách hàng" as DB

' Trình tự
C -> ATM : Đưa thẻ
ATM -> ATM : Đọc thông tin thẻ
ATM -> C : Yêu cầu nhập mã PIN
C -> ATM : Nhập mã PIN
ATM -> BS : Xác thực thẻ & mã PIN
BS -> DB : Kiểm tra thông tin xác thực
DB --> BS : Kết quả xác thực

alt Mã PIN không hợp lệ
    BS --> ATM : Mã PIN không hợp lệ
    ATM -> C : Mã PIN không hợp lệ, thử lại
    note right: Sau 3 lần thử thất bại,nthẻ bị giữ lại
else Mã PIN hợp lệ
    BS --> ATM : Mã PIN hợp lệ
    ATM -> C : Hiển thị menu chính
    C -> ATM : Chọn rút tiền
    ATM -> C : Yêu cầu số tiền
    C -> ATM : Nhập số tiền
    ATM -> BS : Kiểm tra số dư & hạn mức
    BS -> DB : Truy vấn số dư
    DB --> BS : Số dư hiện tại
    
    alt Số dư không đủ
        BS --> ATM : Số dư không đủ
        ATM -> C : Giao dịch bị từ chốin(Hiển thị số dư)
        C -> ATM : Hủy giao dịch
        ATM -> C : Trả lại thẻ
    else Số dư đủ
        BS --> ATM : Được phê duyệt
        ATM -> ATM : Chi tiền mặt
        ATM -> C : Chi tiền mặt
        C -> ATM : Nhận tiền
        ATM -> BS : Xác nhận đã chi tiền
        BS -> DB : Nợ tài khoản & ghi log giao dịch
        DB --> BS : Cập nhật hoàn tất
        BS --> ATM : Giao dịch hoàn tất
        ATM -> C : In biên lai
        alt Yêu cầu biên lai
            C -> ATM : Nhận biên lai
        else Không cần biên lai
            C -> ATM : Từ chối biên lai
        end
        ATM -> C : Trả lại thẻ
        C -> ATM : Nhận thẻ
    end
end

ATM -> C : Cảm ơn / Kết thúc giao dịch

@enduml

@startuml InsuranceClaimSystem

bắt đầu

:Người mua bảo hiểm nộp yêu cầu bồi thường;
:Yêu cầu được ghi nhận vào hệ thống;

if (Hợp đồng có đang hoạt động và hợp lệ không?) then (có)
  :Phân công yêu cầu cho người định giá;
  :Thông báo cho người định giá về yêu cầu mới;
else (không)
  :Gửi thông báo từ chối cho người mua bảo hiểm;
  :Ghi lý do: Hợp đồng không hoạt động/không hợp lệ;
  dừng
endif

:Người định giá xem xét các tài liệu đã nộp;

if (Tất cả tài liệu bắt buộc đã có đầy đủ không?) then (có)
  :Người định giá khởi tạo xác minh yêu cầu;
else (không)
  :Yêu cầu người mua bảo hiểm cung cấp tài liệu thiếu;
  :Chờ tài liệu bổ sung;
  :Kiểm tra lại tài liệu;
  note right
    Hệ thống chờ
    phản hồi từ người mua bảo hiểm
  end note
  -> quay lại "Người định giá xem xét các tài liệu đã nộp";
endif

:Người định giá điều tra yêu cầu;
:Liên hệ nhân chứng/chuyên gia nếu cần thiết;
:Ước tính số tiền thiệt hại/mất mát;

if (Yêu cầu có hợp lệ dựa trên các điều khoản hợp đồng không?) then (có)
  :Tính toán số tiền được phê duyệt;
  :Áp dụng mức khấu trừ nếu áp dụng được;
else (không)
  :Gửi thông báo từ chối kèm lý do;
  :Ghi quyết định vào hệ thống;
  dừng
endif

:Tạo đề xuất giải quyết;
:Gửi đề xuất giải quyết cho người mua bảo hiểm;

:Người mua bảo hiểm xem xét đề xuất;

if (Người mua bảo hiểm có chấp nhận đề xuất không?) then (có)
  :Xử lý thanh toán;
  :Cập nhật trạng thái yêu cầu thành "Đã giải quyết";
  :Gửi xác nhận cho người mua bảo hiểm;
  :Ghi chi tiết đóng hồ sơ;
else (không)
  :Chuyển lên giải quyết tranh chấp;
  :Đàm phán giải quyết;
  :Cập nhật đề xuất;
  -> quay lại "Gửi đề xuất giải quyết cho người mua bảo hiểm";
endif

dừng

@enduml

@startuml SmokeDetectionSystem

title Sơ đồ trạng thái - Hệ thống phát hiện khói

[*] --> Tắt nguồn

state Tắt nguồn {
    [*] --> Không có nguồn
    Không có nguồn : Thiết bị đang tắt
    Không có nguồn --> Bật nguồn : Nút nguồn được nhấn
}

state Bật nguồn {
    [*] --> Chế độ chờ
    Chế độ chờ : Hệ thống sẵn sàng
    Chế độ chờ --> Tự kiểm tra : Tự kiểm tra định kỳ (mỗi 24h)
    Chế độ chờ --> Giám sát : Bắt đầu giám sát (cảm biến hoạt động)
    
    state Tự kiểm tra {
        [*] --> Đang kiểm tra cảm biến
        Đang kiểm tra cảm biến --> Kiểm tra thành công : Tất cả cảm biến OK
        Đang kiểm tra cảm biến --> Kiểm tra thất bại : Phát hiện lỗi cảm biến
        Kiểm tra thành công --> Chế độ chờ : Quay lại chế độ chờ
        Kiểm tra thất bại --> Trạng thái lỗi : Báo cáo lỗi
    }
    
    state Giám sát {
        [*] --> Không có khói
        Không có khói : Hoạt động bình thường
        Không có khói --> Phát hiện khói : Mức khói > ngưỡng
        Không có khói --> Pin yếu : Pin yếu (không dây)
        Pin yếu --> Không có khói : Đã thay pin
        
        state Phát hiện khói {
            [*] --> Cảnh báo ban đầu
            Cảnh báo ban đầu --> Khói xác nhận : Khói tồn tại > 5 giây
            Cảnh báo ban đầu --> Báo động giả : Khói biến mất < 5 giây Báo động giả --> Không có khói : Đặt lại
            Khói xác nhận --> Báo động kích hoạt
        }
        
        state Báo động kích hoạt {
            [*] --> Kích hoạt còi báo động : Kích hoạt còi và đèn
            Kích hoạt còi báo động --> Gửi thông báo : Thông báo bảng điều khiển / ứng dụng
            Gửi thông báo --> Chờ đặt lại
            Chờ đặt lại --> Báo động kích hoạt : Khói vẫn còn
            Chờ đặt lại --> Đặt lại hệ thống : Nút đặt lại được nhấn
            Đặt lại hệ thống --> Không có khói : Hệ thống đã đặt lại
        }
    }
}

state Trạng thái lỗi {
    [*] --> Chỉ báo lỗi : Nhấp nháy đèn LED lỗi
    Chỉ báo lỗi --> Tắt nguồn : Yêu cầu chu kỳ nguồn thủ công
}

Bật nguồn --> Trạng thái lỗi : Tự kiểm tra thất bại
Trạng thái lỗi --> Tắt nguồn : Chu kỳ nguồn

Tắt nguồn --> [*] : Hệ thống đã rút phích cắm / pin đã được tháo

@enduml

@startuml CourierSystem

title Hệ thống chuyển phát - Sơ đồ thành phần

' === Thành phần ===
component "Ứng dụng Khách hàng" as CustomerApp
component "Ứng dụng di động Chuyển phát" as CourierApp
component "Bảng điều khiển Web Quản trị" as AdminWeb

component "API Gateway" as ApiGateway

component "Dịch vụ Đơn hàng" as OrderService
component "Dịch vụ Phân phối" as DispatchService
component "Dịch vụ Theo dõi" as TrackingService
component "Dịch vụ Thanh toán" as PaymentService
component "Dịch vụ Thông báo" as NotificationService
component "Dịch vụ Người dùng" as UserService

component "Hàng đợi tin nhắnn(RabbitMQ/Kafka)" as MessageQueue
component "Bộ nhớ đệm Redis" as RedisCache

database "Cơ sở dữ liệu PostgreSQL" as SQLDB
database "MongoDBn(Ghi nhật ký/Lịch sử theo dõi)" as MongoLogs

' === Giao diện / Cổng ===
CustomerApp --> ApiGateway : "REST / WebSocket"
CourierApp --> ApiGateway : "REST / WebSocket"
AdminWeb --> ApiGateway : "REST"

ApiGateway --> OrderService
ApiGateway --> TrackingService
ApiGateway --> PaymentService
ApiGateway --> UserService

' === Phụ thuộc dịch vụ ===
OrderService --> DispatchService : "gRPC / REST"
OrderService --> PaymentService
OrderService --> NotificationService
OrderService --> SQLDB : "JDBC"
OrderService --> RedisCache : "Cache"

DispatchService --> MessageQueue : "Xuất sự kiện"
DispatchService --> CourierApp : "Gửi đẩy qua API Gateway"
DispatchService --> SQLDB

TrackingService --> MessageQueue : "Đăng ký cập nhật vị trí"
TrackingService --> MongoLogs : "Ghi lịch sử theo dõi"
TrackingService --> RedisCache : "Bộ nhớ đệm vị trí hiện tại"

PaymentService --> SQLDB
PaymentService --> NotificationService

NotificationService --> MessageQueue : "Tiêu thụ thông báo"
NotificationService --> CustomerApp : "Gửi đẩy qua API Gateway"

UserService --> SQLDB
UserService --> RedisCache

' === Ghi chú ===
note bên phải Dịch vụ Đơn hàng
  Xử lý tạo kiện hàng,
  định giá và trạng thái đơn hàng
end note

note bên phải Dịch vụ Phân phối
  Ghép đơn hàng với người chuyển phát,
  tối ưu hóa tuyến đường
end note

note dưới cùng Hàng đợi tin nhắn
  Sự kiện bất đồng bộ: order_created,
  location_updated,
  delivery_status_changed
end note

@enduml

@startuml
node "AWS Cloud Route53" as DNS

node "VPC (10.0.0.0/16)" {
  node "Mạng con công cộng" {
    artifact "Bộ cân bằng tải NGINX" as ALB
  }
  
  node "Cụm mạng con riêng tư" {
    node "实例 EC2 1" {
      component "API Node.js [Pod 1]" as Pod1
    }
    node "实例 EC2 2" {
      component "API Node.js [Pod 2]" as Pod2
    }
  }
  
  node "Mạng con cơ sở dữ liệu" {
    database "Amazon RDS (Aurora đa vùng)" as Aurora
  }
}

DNS --> ALB : Phân giải lưu lượng
ALB --> Pod1 : Cân bằng theo vòng tròn
ALB --> Pod2
Pod1 --> Aurora : Bộ kết nối
Pod2 --> Aurora
@enduml

@startuml Internet Browser Sample
!include <archimate/Archimate>

title Mẫu Archimate - Trình duyệt Internet

'LAYOUT_AS_SKETCH()
'LAYOUT_LEFT_RIGHT()
'LAYOUT_TOP_DOWN()

Grouping(business, "Kinh doanh"){
  Business_Object(businessObject, "Một đối tượng kinh doanh")
  Business_Process(someBusinessProcess,"Một quy trình kinh doanh")
  Business_Service(itSupportService, "Hỗ trợ IT cho Kinh doanh (Dịch vụ Ứng dụng)")
}

Grouping(application, "Ứng dụng"){
  Application_DataObject(dataObject, "Dữ liệu trang web n 'theo thời gian thực'")
  Application_Function(webpageBehaviour, "Hành vi trang web")
  Application_Component(ActivePartWebPage, "Phần hoạt động của trang web n 'theo thời gian thực'")
}

Grouping(technology, "Công nghệ"){
  Technology_Artifact(inMemoryItem,"trong bộ nhớ / 'theo thời gian thực' html/javascript")
  Technology_Service(internetBrowser, "Trình duyệt Internet Tổng quát & Plugin")
  Technology_Service(internetBrowserPlugin, "Một Plugin trình duyệt Internet")
  Technology_Service(webServer, "Một máy chủ web")
}


Rel_Flow_Left(someBusinessProcess, businessObject, "")
Rel_Serving_Up(itSupportService, someBusinessProcess, "")
Rel_Specialization_Up(webpageBehaviour, itSupportService, "")
Rel_Flow_Right(dataObject, webpageBehaviour, "")
Rel_Specialization_Up(dataObject, businessObject, "")
Rel_Assignment_Left(ActivePartWebPage, webpageBehaviour, "")
Rel_Specialization_Up(inMemoryItem, dataObject, "")
Rel_Realization_Up(inMemoryItem, ActivePartWebPage, "")
Rel_Specialization_Right(inMemoryItem,internetBrowser, "")
Rel_Serving_Up(internetBrowser, webpageBehaviour, "")
Rel_Serving_Up(internetBrowserPlugin, webpageBehaviour, "")
Rel_Aggregation_Right(internetBrowser, internetBrowserPlugin, "")
Rel_Access_Up(webServer, inMemoryItem, "")
Rel_Serving_Up(webServer, internetBrowser, "")

@enduml

@startuml

entity "Khách hàng" as customer {
  * customer_id : UUID <>
  --
  * first_name : VARCHAR(50)
  * last_name : VARCHAR(50)
  * email : VARCHAR(100) <>
  * phone : VARCHAR(20)
  * loyalty_points : INT
  * registration_date : TIMESTAMP
}

entity "Phim" as movie {
  * movie_id : UUID <>
  --
  * title : VARCHAR(200)
  * description : TEXT
  * duration_minutes : INT
  * genre : VARCHAR(50)
  * release_date : DATE
  * rating : VARCHAR(10)
}

entity "Rạp chiếu" as theater {
  * theater_id : UUID <>
  --
  * theater_name : VARCHAR(100)
  * total_seats : INT
  * seat_layout : JSON
}

entity "Buổi chiếu" as show {
  * show_id : UUID <>
  --
  * movie_id : UUID <>
  * theater_id : UUID <>
  * show_time : TIMESTAMP
  * end_time : TIMESTAMP
  * language : VARCHAR(50)
  * subtitle : BOOLEAN
  * price_regular : DECIMAL(10,2)
  * price_vip : DECIMAL(10,2)
}

entity "Ghế" as seat {
  * seat_id : UUID <>
  --
  * theater_id : UUID <>
  * row_label : CHAR(2)
  * seat_number : INT
  * seat_type : VARCHAR(20)
  * is_accessible : BOOLEAN
}

entity "Đặt chỗ" as booking {
  * booking_id : UUID <>
  --
  * customer_id : UUID <>
  * show_id : UUID <>
  * booking_time : TIMESTAMP
  * total_amount : DECIMAL(10,2)
  * status : VARCHAR(20)
  * payment_method : VARCHAR(30)
  * transaction_id : VARCHAR(100)
}

entity "Ghế trong đặt chỗ" as booking_seat {
  * booking_id : UUID <<FK,PK>>
  * seat_id : UUID <<FK,PK>>
  --
  * ticket_price : DECIMAL(10,2)
  * discount_applied : DECIMAL(10,2)
}

entity "Thanh toán" as payment {
  * payment_id : UUID <>
  --
  * booking_id : UUID <>
  * amount : DECIMAL(10,2)
  * payment_date : TIMESTAMP
  * payment_status : VARCHAR(20)
  * payment_gateway : VARCHAR(30)
  * gateway_reference : VARCHAR(200)
}

entity "Đánh giá" as review {
  * review_id : UUID <>
  --
  * customer_id : UUID <>
  * movie_id : UUID <>
  * rating : INT
  * comment : TEXT
  * review_date : TIMESTAMP
}

' Mối quan hệ
customer ||--o{ booking : "đặt"
movie ||--o{ show : "được lên lịch cho"
theater ||--o{ show : "tổ chức"
show ||--o{ booking : "có"
booking ||--|{ booking_seat : "chứa"
seat ||--o{ booking_seat : "được chỉ định cho"
booking ||--|| payment : "có"
customer ||--o{ review : "viết"
movie ||--o{ review : "nhận được"

note right of booking : Trạng thái: CHỜ XỬ LÝ, ĐÃ XÁC NHẬN, ĐÃ HỦY, ĐÃ HẾT HẠN
note left of seat : seat_type: THƯỜNG, VIP, CẶP ĐÔI
note right of payment : payment_status: CHỜ XỬ LÝ, THÀNH CÔNG, THẤT BẠI, ĐÃ HOÀN TIỀN

@enduml

flowchart TD
    A[Cảm thấy không khỏe hoặc cần tư vấn y tế] --> B{Đây có phải là trường hợp khẩn cấp?}

    B -->|Có| C[Gọi dịch vụ cấp cứu hoặc đến phòng cấp cứu]
    B -->|Không| D[Lên lịch hẹn với bác sĩ]

    D --> E[Tham dự cuộc hẹn]
    E --> F[Bác sĩ đánh giá]

    F --> G{Đã có chẩn đoán?}

    G -->|Có| H[Kế hoạch điều trị]
    G -->|Không| I[Đặt hàng xét nghiệm]

    I --> J[Nhận kết quả xét nghiệm]
    J --> F

    H --> K[Thực hiện điều trị]
    K --> L{Triệu chứng đã cải thiện?}

    L -->|Có| M[Phục hồi / Theo dõi định kỳ]
    L -->|Không| N[Quay lại gặp bác sĩ]
    N --> F

graph UndirectedSpanningTree {
    fontname="Helvetica,Arial,sans-serif"
    label="Cơ sở hạ tầng lõi của cấu trúc mạng lưới trung tâm dữ liệu"
    labelloc="b"
    fontsize=14
    
    node [fontname="Helvetica,Arial,sans-serif", shape=circle, style=filled, color="#475569", fillcolor="#f1f5f9", width=0.8, fixedsize=true]
    edge [color="#94a3b8", penwidth=2.5]
    
    SwitchAlpha  [label="SW_A", fillcolor="#cbd5e1"]
    SwitchBeta   [label="SW_B", fillcolor="#cbd5e1"]
    Node1        [label="Host_01"]
    Node2        [label="Host_02"]
    Node3        [label="Host_03"]
    Node4        [label="Host_04"]
    
    SwitchAlpha -- SwitchBeta [label=" Liên kết Trunk", weight=5]
    SwitchAlpha -- Node1
    SwitchAlpha -- Node2
    SwitchBeta -- Node3
    SwitchBeta -- Node4
    Node1 -- Node2 [style=dashed, color="#cbd5e1", label=" Kết nối dự phòng"]
}