Từ Văn bản đến Sản xuất: Hướng dẫn của Đội Agile về UML được hỗ trợ bởi AI với Visual Paradigm

Plantuml Edit Plantuml in VPasCode

@startuml
hướng trái sang phải
skinparam packageStyle rectangle

actor Khách hàng
actor Quản trị viên

hình chữ nhật "Hệ thống Thương mại điện tử" {
  usecase "Duyệt sản phẩm" as UC1
  usecase "Thêm vào giỏ hàng" as UC2
  usecase "Thanh toán" as UC3
  usecase "Thanh toán" as UC4
  usecase "Quản lý kho hàng" as UC5
  usecase "Xem đơn hàng" as UC6
}

Khách hàng --> UC1
Khách hàng --> UC2
Khách hàng --> UC3
Khách hàng --> UC4
Khách hàng --> UC6

Quản trị viên --> UC5
Quản trị viên --> UC6

UC3 ..> UC4 : bao gồm
@enduml

Sơ đồ lớp

Plantuml Edit Plantuml in VPasCode

@startuml
class Khách hàng {
  -customerId: String
  -name: String
  -email: String
  -shippingAddress: Địa chỉ
  +browseProducts(): List<Sản phẩm>
  +addToCart(product: Sản phẩm, quantity: int): void
  +checkout(): Đơn hàng
}

class Sản phẩm {
  -productId: String
  -name: String
  -price: Decimal
  -stockQuantity: int
  -category: String
  +isAvailable(): boolean
  +updateStock(quantity: int): void
}

class Giỏ hàng {
  -cartId: String
  -customerId: String
  -items: List<Chi tiếtGiỏ>
  -totalAmount: Decimal
  +addItem(product: Sản phẩm, quantity: int): void
  +removeItem(productId: String): void
  +calculateTotal(): Decimal
}

class Chi tiếtGiỏ {
  -product: Sản phẩm
  -quantity: int
  -subtotal: Decimal
}

class CổngThanhToán {
  -gatewayId: String
  -provider: String
  +processPayment(amount: Decimal, cardInfo: Thẻ): Kết quảThanhToán
  +refund(transactionId: String): boolean
}

class Đơn hàng {
  -orderId: String
  -customerId: String
  -orderDate: DateTime
  -status: TrạngTháiĐơn
  -totalAmount: Decimal
  +confirmOrder(): void
  +cancelOrder(): void
}

class Quản trị viên {
  -adminId: String
  -username: String
  +addProduct(product: Sản phẩm): void
  +updateInventory(productId: String, quantity: int): void
  +viewSalesReport(): Báo cáo
}

Khách hàng "1" -- "1" Giỏ hàng
Giỏ hàng "1" *-- "0..*" Chi tiếtGiỏ
Chi tiếtGiỏ "0..*" -- "1" Sản phẩm
Khách hàng "1" -- "0..*" Đơn hàng
Đơn hàng "1" -- "1" CổngThanhToán
Quản trị viên "1" -- "0..*" Sản phẩm
@enduml

Sơ đồ tuần tự

Plantuml Edit Plantuml in VPasCode

@startuml
autonumber
actor Khách hàng
participant "Giỏ hàng" as Cart
participant "Danh mục sản phẩm" as Catalog
participant "Cổng thanh toán" as Payment
participant "Hệ thống đơn hàng" as Order

Khách hàng -> Catalog: browseProducts()
Catalog --> Khách hàng: List<Sản phẩm>

Khách hàng -> Cart: addToCart(sản phẩm, số lượng)
Cart --> Khách hàng: Giỏ hàng đã cập nhật

Khách hàng -> Cart: checkout()
activate Cart
Cart -> Cart: calculateTotal()
Cart -> Payment: processPayment(số tiền, thông tin thẻ)
activate Payment
Payment --> Payment: validateCard()
Payment --> Cart: PaymentResult
deactivate Payment

alt Thanh toán thành công
    Cart -> Order: createOrder(các mục giỏ hàng)
    activate Order
    Order --> Cart: Xác nhận đơn hàng
    deactivate Order
    Cart --> Khách hàng: Đơn hàng đã xác nhận
else Thanh toán thất bại
    Payment --> Cart: PaymentFailed
    Cart --> Khách hàng: Thanh toán bị từ chối
end
deactivate Cart
@enduml

Lợi ích của Agile

Người sở hữu sản phẩm và các trưởng nhóm Scrum—những người có thể không biết ký hiệu UML—bây giờ có thể tham gia vào các cuộc thảo luận về kiến trúc chỉ bằng cách viết các câu chuyện người dùng bằng tiếng Anh thuần túy. AI sẽ thực hiện việc dịch thuật.

3. Giai đoạn hai: Từ UML sang các tài liệu Agile (Giai đoạn ‘Lên kế hoạch’)

Sau khi mô hình được tạo ra, AI của Visual Paradigm không dừng lại ở các hình dạng và đường nét. Nó tạo ra sự kết nối với danh sách công việc Agile của bạn.

Tạo danh sách công việc

Sử dụng trợ lý AI trong mô-đun Agile của Visual Paradigm, bạn có thể hướng dẫn công cụ thực hiện:

Trích xuất các câu chuyện người dùng: “Tạo các câu chuyện người dùng Scrum từ sơ đồ tuần tự Thanh toán.”
- Kết quả từ AI: “Là một Khách hàng, tôi muốn thêm các sản phẩm vào giỏ hàng để có thể mua chúng sau này.”
Xác định tiêu chí chấp nhận: AI tự động soạn thảo các tiêu chí chấp nhận kỹ thuật và kinh doanh dựa trên các ràng buộc của mô hình.
Ước lượng nỗ lực: Dựa trên độ phức tạp của các lớp được tạo ra, AI có thể đề xuất các điểm câu chuyện tương đối (ví dụ: thang số Fibonacci).

Ví dụ: Các câu chuyện người dùng do AI tạo ra

Từ mô hình thương mại điện tử ở trên, AI của Visual Paradigm có thể tạo ra:

Câu chuyện #1: Duyệt sản phẩm
Là một Khách hàng
Tôi muốn duyệt sản phẩm theo danh mục
Để có thể tìm thấy các mặt hàng quan tâm một cách nhanh chóng

Tiêu chí chấp nhận:
- Sản phẩm được hiển thị với tên, giá và tình trạng sẵn có
- Lọc theo danh mục hoạt động chính xác
- Phân trang xử lý các danh mục sản phẩm lớn
Điểm câu chuyện: 5

Câu chuyện #2: Quản lý giỏ hàng
Là một Khách hàng
Tôi muốn thêm/xóa sản phẩm khỏi giỏ hàng
Để có thể thay đổi đơn hàng trước khi thanh toán

Tiêu chí chấp nhận:
- Giỏ hàng được lưu giữ qua các phiên duyệt trình duyệt
- Cập nhật số lượng tự động tính lại tổng tiền
- Các sản phẩm hết hàng được đánh dấu
Điểm câu chuyện: 8

Câu chuyện #3: Xử lý thanh toán
Là một Khách hàng
Tôi muốn nhập thông tin thanh toán một cách an toàn
Để có thể hoàn tất giao dịch mua hàng

Tiêu chí chấp nhận:
- Xử lý thanh toán tuân thủ tiêu chuẩn PCI
- Hỗ trợ nhiều phương thức thanh toán
- Xác nhận giao dịch được gửi qua email
Điểm câu chuyện: 13

Lợi ích của Agile

Lập kế hoạch Sprint trở thành việc xem xét các câu chuyện do AI tạo ra thay vì viết chúng từ đầu. Đội ngũ ngay lập tức thống nhất về điều gì cần xây dựng vì mô hình trực quan nằm ngay bên cạnh danh sách công việc.

4. Giai đoạn ba: Từ mô hình đến sản xuất (Giai đoạn “Xây dựng”)

Agile là về phần mềm hoạt động. Visual Paradigm khép kín vòng tròn bằng cách chuyển đổi UML do AI tạo thành mã thực tế.

Tạo mã & Khung mã

Chọn sơ đồ Lớp đã được tạo của bạn.
Sử dụng tính năng Kỹ thuật mã hóa (tính năng được nâng cao bởi AI để tạo ra đầu ra sạch hơn).
Chọn công nghệ của bạn (Java Spring, C#, Node.js, v.v.).
Công cụ sẽ tạo mã khung: các thực thể, mối quan hệ và các hàm khung API.

Ví dụ: Mã Java Spring Boot được tạo ra

Từ sơ đồ Lớp, Visual Paradigm có thể tạo ra:

// Product.java
@Entity
@Table(name = "products")
@Data
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String productId;
    
    private String name;
    private BigDecimal price;
    private Integer stockQuantity;
    private String category;
    
    public boolean isAvailable() {
        return stockQuantity > 0;
    }
    
    public void updateStock(int quantity) {
        if (this.stockQuantity + quantity >= 0) {
            this.stockQuantity += quantity;
        } else {
            throw new InsufficientStockException();
        }
    }
}

// ShoppingCart.java
@Entity
@Table(name = "shopping_carts")
@Data
public class ShoppingCart {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String cartId;
    
    @ManyToOne
    @JoinColumn(name = "customer_id")
    private Customer customer;
    
    @OneToMany(mappedBy = "cart", cascade = CascadeType.ALL)
    private List<CartItem> items = new ArrayList<>();
    
    public void addItem(Product product, int quantity) {
        CartItem existingItem = items.stream()
            .filter(item -> item.getProduct().getProductId().equals(product.getProductId()))
            .findFirst()
            .orElse(null);
            
        if (existingItem != null) {
            existingItem.setQuantity(existingItem.getQuantity() + quantity);
        } else {
            CartItem newItem = new CartItem(this, product, quantity);
            items.add(newItem);
        }
    }
    
    public BigDecimal calculateTotal() {
        return items.stream()
            .map(CartItem::getSubtotal)
            .reduce(BigDecimal.ZERO, BigDecimal::add);
    }
}

// CheckoutController.java
@RestController
@RequestMapping("/api/checkout")
@RequiredArgsConstructor
public class CheckoutController {
    
    private final PaymentGatewayService paymentGateway;
    private final OrderService orderService;
    
    @PostMapping
    public ResponseEntity<OrderConfirmation> checkout(
            @RequestBody CheckoutRequest request,
            @AuthenticationPrincipal Customer customer) {
        
        ShoppingCart cart = getCustomerCart(customer);
        BigDecimal total = cart.calculateTotal();
        
        PaymentResult payment = paymentGateway.processPayment(
            total, 
            request.getPaymentDetails()
        );
        
        if (payment.isSuccess()) {
            Order order = orderService.createOrder(customer, cart);
            cart.clear();
            return ResponseEntity.ok(new OrderConfirmation(order));
        } else {
            return ResponseEntity.badRequest()
                .body(new OrderConfirmation("Thanh toán thất bại"));
        }
    }
}

Lợi thế của Mô hình “Sống”

Khi các nhà phát triển tinh chỉnh mã trong suốt Sprint, kỹ thuật khai thác hai chiều của Visual Paradigm (bây giờ thông minh hơn nhờ AI so sánh sự khác biệt) sẽ cập nhật sơ đồ UML. Nếu một nhà phát triển thêm một thực thể “Mã giảm giá” trong mã, AI sẽ đề xuất cập nhật sơ đồ Lớp để giữ cho đội ngũ luôn đồng bộ.

Lợi ích của Agile

Không còn tài liệu lỗi thời nữa. Mô hình UML hoạt động như một bản đồ kiến trúc thời gian thực, phát triển cùng với Sprint.

5. Một vòng lặp Agile thực tế với AI của Visual Paradigm

Bối cảnh:Một đội fintech có một vòng lặp 2 tuần để xây dựng tính năng “Chuyển tiền ngang hàng”.

Lộ trình vòng lặp

Ngày 1 (Lời nhắc):Người quản lý sản phẩm gõ mô tả tính năng vào Trợ lý AI của VP. Một sơ đồ Use Case và sơ đồ Thứ tự xuất hiện trong vài phút.

Lời nhắc: "Xây dựng hệ thống chuyển tiền ngang hàng nơi người dùng có thể gửi tiền cho liên hệ, xem lịch sử giao dịch và nhận thông báo. Bao gồm phát hiện gian lận cho các giao dịch trên 1000 đô la."

Ngày 2 (Lên kế hoạch):AI chuyển đổi các sơ đồ thành 12 câu chuyện người dùng. Đội ngũ làm sạch danh sách công việc và cam kết thực hiện vòng lặp.

Ngày 3-8 (Xây dựng):Các nhà phát triển tạo cấu trúc khung Java Spring Boot từ UML. Họ tập trung hoàn toàn vào logic kinh doanh, không cần viết mã mẫu.

Ngày 9 (Đồng bộ):Một thay đổi giữa vòng lặp yêu cầu thêm bước “Kiểm tra gian lận” mới. Người quản lý sản phẩm cập nhật lời nhắc; AI điều chỉnh sơ đồ Thứ tự; mã nguồn được tái cấu trúc tự động.

Ngày 10 (Trình diễn):Đội ngũ trình bày phần mềm hoạt động, với sơ đồ UML đóng vai trò là tài liệu thiết kế chính thức và cập nhật nhất.

Sơ đồ Thứ tự được tạo ra cho Chuyển tiền ngang hàng

Plantuml Edit Plantuml in VPasCode

@startuml
actor Người dùng
participant "Ứng dụng di động" as App
participant "Dịch vụ Chuyển tiền" as Transfer
participant "Phát hiện Gian lận" as Fraud
participant "Dịch vụ Tài khoản" as Account
participant "Thông báo" as Notify

Người dùng -> App: Bắt đầu chuyển tiền(người nhận, số tiền)
App -> Transfer: createTransfer(yêu cầu)
activate Transfer

Transfer -> Account: validateBalance(tài khoản gửi, số tiền)
Account --> Transfer: Số dư hợp lệ

alt số tiền > 1000
    Transfer -> Fraud: assessRisk(giao dịch)
    activate Fraud
    Fraud --> Fraud: Kiểm tra mẫu
    Fraud --> Transfer: RiskScore
    deactivate Fraud
    
    alt RiskScore > NGƯỠNG
        Transfer -> Transfer: flagForReview()
        Transfer --> App: Chuyển tiền đang chờ xem xét
        return
    end
end

Transfer -> Account: debitAccount(tài khoản gửi, số tiền)
Account -> Account: creditAccount(tài khoản nhận, số tiền)

Transfer -> Notify: sendConfirmation(tài khoản gửi)
Transfer -> Notify: sendNotification(tài khoản nhận)

Transfer --> App: Chuyển tiền hoàn tất
deactivate Transfer
App --> Người dùng: Hiển thị thành công
@enduml