Trợ lý chatbot AI của Visual Paradigm cho phép tạo sơ đồ ngữ cảnh hệ thống C4 từ mô tả bằng ngôn ngữ thông thường về một ứng dụng, người dùng của nó và các hệ thống bên ngoài mà nó tương tác. Tuy nhiên, sơ đồ được tạo bởi AI sẽ hữu ích nhất khi vẫn có thể chỉnh sửa và duy trì được sau khi tạo.

Hướng dẫn này minh họa quy trình toàn diện để tạo sơ đồ ngữ cảnh nền tảng giao hàng thực phẩm bằng C4-PlantUML. Bạn sẽ học cách chuyển từ sơ đồ được tạo bởi AI sang mã PlantUML có thể chỉnh sửa, tinh chỉnh mô hình trong VPasCode, và tiếp tục chỉnh sửa trực quan trong Visual Paradigm Online. Phương pháp này kết hợp tốc độ của mô hình hóa hỗ trợ bởi AI với tính linh hoạt của sơ đồ dưới dạng mã và sự thuận tiện của trình chỉnh sửa sơ đồ đồ họa.

Visual Paradigm cung cấp một quy trình thực tế để chuyển mô tả kiến trúc bằng ngôn ngữ tự nhiên thành sơ đồ ngữ cảnh C4 có thể chỉnh sửa:

1. Mô tả hệ thống trong trợ lý chatbot AI của Visual Paradigm.

   

2. Tạo và xem xét sơ đồ ngữ cảnh hệ thống C4.

3. Mở kết quả trong VPasCode dưới dạng C4-PlantUML.

   

4. Chỉnh sửa sơ đồ bằng cách chỉnh sửa mã PlantUML.

   

5. Tùy chọn gửi kết quả đến Visual Paradigm Online.

   

6. Chỉnh sửa sơ đồ trực quan bằng trình chỉnh sửa sơ đồ kéo thả.

Điều này mang lại cho bạn hai phương thức chỉnh sửa:

• Chỉnh sửa dựa trên mã: VPasCode và C4-PlantUML

• Chỉnh sửa dựa trên giao diện người dùng (GUI): Trình chỉnh sửa sơ đồ Visual Paradigm Online

Trợ lý chatbot AI của Visual Paradigm hỗ trợ các sơ đồ C4 Bối cảnh Hệ thống, Container, Component và Triển khai. Nó cũng có thể tinh chỉnh một sơ đồ được tạo ra thông qua các lệnh bằng ngôn ngữ tự nhiên như thêm, xóa, đổi tên hoặc nối lại các thành phần.

1. Hiểu sơ đồ Bối cảnh C4

Sơ đồ Bối cảnh C4 là cái nhìn cấp cao nhất về một hệ thống phần mềm. Nó hiển thị:

• Cái hệ thống đang được quan tâm

• Người dùng con người và các tác nhân tổ chức

• Các hệ thống phần mềm bên ngoài

• Những mối quan hệ quan trọng giữa các thành phần này

• Một mô tả ngắn về cách hoạt động của từng mối quan hệ

Thông thường, nó không hiển thị các dịch vụ nội bộ, cơ sở dữ liệu, lớp, API hoặc chi tiết hạ tầng. Những thứ này thuộc về các sơ đồ C4 cấp thấp hơn.

Ví dụ, một sơ đồ bối cảnh cho một nền tảng giao hàng thực phẩm trực tuyến có thể bao gồm:

• Khách hàng

• Quản lý nhà hàng

• Tài xế giao hàng

• Nhà cung cấp thanh toán

• Dịch vụ bản đồ và định vị địa lý

• Dịch vụ thông báo

• Nền tảng giao đồ ăn

Hệ thống trung tâm nên luôn là điểm tập trung thị giác. Những người và hệ thống bên ngoài nên được đặt xung quanh nó.

2. Chuẩn bị một lời nhắc AI tốt

Chất lượng của sơ đồ được tạo ra phụ thuộc rất nhiều vào mô tả kiến trúc được cung cấp cho chatbot.

Một lời nhắc hữu ích cần nêu rõ:

• Tên hệ thống

• Mục đích của hệ thống

• Những người sử dụng nó

• Các hệ thống bên ngoài mà nó giao tiếp với

• Các mối quan hệ giữa chúng

• Mức độ sơ đồ C4 mong muốn

• Định dạng đầu ra mong muốn

• Điều gì không nên được bao gồm

Lời nhắc ví dụ

Tạo sơ đồ ngữ cảnh hệ thống C4 cho một nền tảng giao hàng thực phẩm trực tuyến.

Hệ thống quan tâm:
Nền tảng Giao hàng Thực phẩm — cho phép khách hàng duyệt các nhà hàng, đặt hàng, thanh toán và theo dõi giao hàng.

Các bên liên quan:
1. Khách hàng — duyệt các nhà hàng, đặt hàng, thanh toán và theo dõi giao hàng.
2. Quản lý nhà hàng — quản lý thực đơn, chấp nhận đơn hàng và cập nhật trạng thái đơn hàng.
3. Tài xế giao hàng — chấp nhận công việc giao hàng và cập nhật tiến độ giao hàng.
4. Quản trị viên Vận hành — giám sát hoạt động nền tảng và xử lý các vấn đề hỗ trợ.

Các hệ thống bên ngoài:
1. Nhà cung cấp Thanh toán — xác thực và thu tiền từ khách hàng.
2. Dịch vụ Bản đồ và Định vị — cung cấp địa chỉ, tuyến đường và vị trí giao hàng.
3. Dịch vụ Thông báo — gửi email, tin nhắn SMS và thông báo đẩy.

Mối quan hệ:
- Khách hàng sử dụng Nền tảng Giao hàng Thực phẩm để duyệt nhà hàng, đặt hàng, thanh toán và theo dõi giao hàng.
- Quản lý nhà hàng sử dụng Nền tảng Giao hàng Thực phẩm để quản lý thực đơn và xử lý đơn hàng.
- Tài xế giao hàng sử dụng Nền tảng Giao hàng Thực phẩm để nhận công việc giao hàng và cập nhật trạng thái giao hàng.
- Quản trị viên Vận hành sử dụng Nền tảng Giao hàng Thực phẩm để giám sát hoạt động và giải quyết sự cố.
- Nền tảng Giao hàng Thực phẩm sử dụng Nhà cung cấp Thanh toán để xác thực và thu tiền.
- Nền tảng Giao hàng Thực phẩm sử dụng Dịch vụ Bản đồ và Định vị để tính toán tuyến đường và theo dõi vị trí.
- Nền tảng Giao hàng Thực phẩm sử dụng Dịch vụ Thông báo để gửi thông báo.

Tạo một sơ đồ ngữ cảnh hệ thống C4 sạch sẽ. Không hiển thị các thành phần nội bộ, thành phần, cơ sở dữ liệu, lớp hay hạ tầng triển khai. Sử dụng nhãn mối quan hệ ngắn gọn.

Lời nhắc rõ ràng để loại bỏ chi tiết nội bộ là điều quan trọng. Nếu không có lời nhắc này, một công cụ sinh hình ảnh AI có thể tạo ra sơ đồ kết hợp thông tin ở cấp độ ngữ cảnh và cấp độ container.

3. Tạo sơ đồ trong trợ lý chatbot AI của Visual Paradigm

Mở trợ lý chatbot AI của Visual Paradigm và bắt đầu một cuộc trò chuyện mới hoặc phiên tạo sơ đồ.

Tùy thuộc vào giao diện và phiên bản đăng ký, trợ lý chatbot có thể cung cấp bộ chọn loại sơ đồ. Chọn:

• Mô hình C4

• Sơ đồ ngữ cảnh hệ thống

Sau đó nhập lời nhắc.

Quy trình làm việc chung của trợ lý chatbot Visual Paradigm là:

1. Mô tả sơ đồ.

2. Cho AI tạo mô hình ban đầu.

3. Xem xét kết quả.

4. Tinh chỉnh nó bằng các lệnh bằng ngôn ngữ tự nhiên.

5. Xuất ra hoặc tiếp tục chỉnh sửa trong một công cụ Visual Paradigm khác.

Xem xét kết quả đầu tiên

Kiểm tra xem sơ đồ có chứa:

• Chính xác một hệ thống trung tâm

• Tất cả các cá nhân cần thiết

• Tất cả các hệ thống bên ngoài liên quan

• Hướng mối quan hệ đúng

• Mô tả mối quan hệ súc tích

• Không có dịch vụ nội bộ hoặc cơ sở dữ liệu không cần thiết

• Tên gọi nhất quán

• Bố cục dễ đọc

Một sơ đồ được tạo ra là điểm khởi đầu, chứ không phải thay thế cho việc xem xét kiến trúc.

4. Tinh chỉnh sơ đồ thông qua cuộc trò chuyện

Trợ lý trò chuyện có thể chỉnh sửa sơ đồ bằng ngôn ngữ thông thường.

Thêm một thành phần

Thêm một Đại diện Hỗ trợ Khách hàng sử dụng Nền tảng Giao hàng Thực phẩm để điều tra các vấn đề của khách hàng và xử lý hoàn tiền.

Thêm một hệ thống bên ngoài

Thêm một Dịch vụ Phát hiện Gian lận bên ngoài được nền tảng Giao hàng Thực phẩm sử dụng để đánh giá các giao dịch thanh toán đáng ngờ.

Đổi tên một thành phần

Đổi tên “Dịch vụ Thông báo” thành “Dịch vụ Tin nhắn và Thông báo.”

Thay đổi một mối quan hệ

Thay đổi mối quan hệ giữa Tài xế Giao hàng và Nền tảng Giao hàng Thực phẩm thành:
“Nhận nhiệm vụ giao hàng và gửi cập nhật trạng thái giao hàng.”

Loại bỏ một thành phần

Loại bỏ Quản trị viên Vận hành khỏi sơ đồ.

Cải thiện bố cục

Sắp xếp lại sơ đồ sao cho con người xuất hiện ở trên cùng, các hệ thống bên ngoài ở dưới cùng, và Nền tảng Giao hàng Thực phẩm vẫn giữ ở trung tâm.

Đơn giản hóa sơ đồ

Đơn giản hóa sơ đồ này thành một sơ đồ Bối cảnh Hệ thống C4 nghiêm ngặt. Loại bỏ các chi tiết triển khai, cơ sở dữ liệu, API, dịch vụ vi mô và các thành phần nội bộ.

Yêu cầu kiểm tra tính nhất quán

Xem xét sơ đồ để phát hiện các mối quan hệ bị thiếu, nhãn không rõ ràng, các hệ thống trùng lặp và các thành phần không phù hợp trong một sơ đồ Bối cảnh C4.

Tài liệu AI Chatbot mô tả cách tiếp cận lặp lại này, bao gồm các lệnh để thêm cổng thanh toán, đổi tên các thành phần, thay đổi mối quan hệ và tái cấu trúc sơ đồ.

Phần 1: Mở sơ đồ trong VPasCode để chỉnh sửa mã

5. Sử dụng “Mở trong VPasCode” hoặc “Chỉnh sửa trong VPasCode”

Sau khi tạo và hoàn thiện sơ đồ, hãy sử dụng thao tác được ghi nhãn tương tự như:

• Mở trong VPasCode

• Chỉnh sửa trong VPasCode

• Mở Mã

• Tạo Mã để Chỉnh sửa

Nhãn nút chính xác có thể thay đổi tùy theo giao diện hiện tại.

Điều này chuyển mã sơ đồ vào VPasCode, nơi bạn có thể chỉnh sửa sơ đồ dưới dạng văn bản đồng thời xem trước bản vẽ trực tiếp. Visual Paradigm mô tả VPasCode là trình chỉnh sửa sơ đồ dưới dạng mã dựa trên trình duyệt, hỗ trợ PlantUML, mô hình C4, Mermaid, Graphviz và các định dạng cú pháp khác.

Mã được tạo ra nên sử dụng C4-PlantUML, thường với:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
...
@enduml

Mã được tạo có thể sử dụng một URL include khác hoặc một phiên bản thư viện được hỗ trợ nội bộ. Giữ nguyên phần include mà VPasCode tạo ra, trừ khi bạn có lý do cụ thể để thay đổi nó.

6. Hiểu cấu trúc C4-PlantUML

Một sơ đồ ngữ cảnh C4-PlantUML điển hình chứa các phần này:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

LAYOUT_LEFT_RIGHT()

Person(customer, "Khách hàng", "Đặt đơn hàng thực phẩm và theo dõi giao hàng.")
System(platform, "Nền tảng Giao hàng Thực phẩm", "Cho phép khách hàng đặt thực phẩm và theo dõi giao hàng.")
System_Ext(payment, "Nhà cung cấp Thanh toán", "Xác thực và thu tiền thanh toán.")

Rel(customer, platform, "Đặt đơn hàng và theo dõi giao hàng")
Rel(platform, payment, "Xác thực và thu tiền thanh toán")

@enduml

Các loại phần tử chính

Tham số đầu tiên là định danh nội bộ. Tham số thứ hai là tên hiển thị. Tham số thứ ba là mô tả.

7. Chỉnh sửa sơ đồ trong VPasCode

VPasCode thường hiển thị:

• Mã nguồn trong một khung soạn thảo

• Sơ đồ được hiển thị trong một khung xem trước

• Các thao tác xuất, chia sẻ, sao chép hoặc mở kết quả trong một sản phẩm Visual Paradigm khác

VPasCode cung cấp hiển thị trực tiếp và hỗ trợ chỉnh sửa mã trực tiếp. Nó cũng có thể phát hiện các định dạng sơ đồ được hỗ trợ khi dán mã vào trình soạn thảo.

Ví dụ: mã C4-PlantUML được cải tiến

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

title Nền tảng Giao hàng Thực phẩm — Bối cảnh Hệ thống

LAYOUT_LEFT_RIGHT()
SHOW_LEGEND()

Person(customer, "Khách hàng",
  "Lướt qua nhà hàng, đặt hàng, thanh toán và theo dõi giao hàng.")

Person(restaurantManager, "Quản lý Nhà hàng",
  "Quản lý thực đơn, chấp nhận đơn hàng và cập nhật trạng thái đơn hàng.")

Person(deliveryDriver, "Tài xế Giao hàng",
  "Nhận nhiệm vụ giao hàng và cập nhật tiến độ giao hàng.")

Person(operationsAdmin, "Quản trị Viên Vận hành",
  "Theo dõi hoạt động nền tảng và xử lý các vấn đề hỗ trợ.")

System(platform, "Nền tảng Giao hàng Thực phẩm",
  "Cho phép đặt hàng thực phẩm, thanh toán, quản lý nhà hàng và theo dõi giao hàng.")

System_Ext(paymentProvider, "Nhà cung cấp Thanh toán",
  "Xác thực và thu tiền thanh toán của khách hàng.")

System_Ext(mapService, "Dịch vụ Bản đồ và Định vị",
  "Cung cấp địa chỉ, tuyến đường và dữ liệu vị trí.")

System_Ext(notificationService, "Dịch vụ Thông báo",
  "Gửi email, tin nhắn SMS và thông báo đẩy.")

Rel(customer, platform,
  "Lướt qua nhà hàng, đặt hàng, thanh toán và theo dõi giao hàng")

Rel(restaurantManager, platform,
  "Quản lý thực đơn và xử lý đơn hàng nhà hàng")

Rel(deliveryDriver, platform,
  "Nhận công việc giao hàng và gửi trạng thái giao hàng")

Rel(operationsAdmin, platform,
  "Theo dõi hoạt động và xử lý các vấn đề hỗ trợ")

Rel(platform, paymentProvider,
  "Xác thực và thu tiền thanh toán")

Rel(platform, mapService,
  "Tính toán tuyến đường và theo dõi vị trí giao hàng")

Rel(platform, notificationService,
  "Gửi thông báo về đơn hàng, thanh toán và giao hàng")

@enduml

8. Thực hiện các thay đổi cấp mã phổ biến

Thay đổi tên hệ thống

System(platform, "Nền tảng Giao hàng Món ăn",
  "Tổ chức việc đặt hàng và giao thực phẩm.")

Thêm một người mới

Person(customerSupport, "Đại diện Hỗ trợ Khách hàng",
  "Khảo sát các vấn đề của khách hàng và xử lý hoàn tiền.")

Rel(customerSupport, platform,
  "Khảo sát các vấn đề và xử lý hoàn tiền")

Thêm một hệ thống bên ngoài mới

System_Ext(fraudService, "Dịch vụ Phát hiện Gian lận",
  "Đánh giá các hoạt động thanh toán đáng ngờ.")

Rel(platform, fraudService,
  "Kiểm tra các giao dịch thanh toán để phát hiện rủi ro gian lận")

Thay đổi hướng mối quan hệ

Rel(cung cấp thanh toán, nền tảng,
  "Trả về kết quả ủy quyền thanh toán và thanh toán kết thúc")

Sử dụng hướng mối quan hệ để biểu diễn phụ thuộc hoặc tương tác chính. Nếu hướng không quan trọng về mặt kiến trúc, hãy chọn một quy ước nhất quán và áp dụng nó xuyên suốt sơ đồ.

Thay đổi bố cục

C4-PlantUML hỗ trợ các gợi ý bố cục như:

LAYOUT_TRÁI_PHẢI()

hoặc:

BỐ TRÍ_TỪ_TRÊN_XUỐNG()

Bạn cũng có thể ảnh hưởng đến vị trí bằng các gợi ý hướng:

Lay_R(khách hàng, nền tảng)
Lay_D(nền tảng, nhà cung cấp thanh toán)

Sử dụng gợi ý bố cục một cách tiết chế. Quá nhiều ràng buộc thủ công có thể khiến sơ đồ trở nên khó bảo trì hơn.

9. Sử dụng Trợ giúp AI của VPasCode

Một số phiên bản VPasCode cung cấp hỗ trợ AI cho việc chỉnh sửa sơ đồ và sửa lỗi mã. Công cụ này có thể chấp nhận các chỉ dẫn như:

Thêm một dịch vụ phát hiện gian lận bên ngoài giữa nền tảng và nhà cung cấp thanh toán.

hoặc:

Sửa lỗi cú pháp PlantUML và giữ nguyên cấu trúc sơ đồ hiện tại.

VPasCode cũng được ghi nhận là hỗ trợ các tính năng chỉnh sửa sơ đồ dựa trên AI, chẩn đoán lỗi và dịch thuật, mặc dù khả dụng có thể phụ thuộc vào phiên bản hoặc gói đăng ký.

10. Xác minh sơ đồ PlantUML

Trước khi gửi sơ đồ đến Visual Paradigm Online, hãy xác minh cả cú pháp và kiến trúc.

Danh sách kiểm tra cú pháp

• Bản script bắt đầu bằng @startuml.

• Bản script kết thúc bằng @enduml.

• Thư viện C4-PlantUML được bao gồm.

• Mỗi mối quan hệ tham chiếu đến các định danh tồn tại.

• Các định danh không chứa khoảng trắng hoặc dấu câu có thể làm hỏng cú pháp.

• Dấu ngoặc kép được cân bằng.

• Mô tả không quá dài.

• Bản xem trước được hiển thị mà không có lỗi.

Danh sách kiểm tra mô hình hóa C4

• Có một hệ thống rõ ràng được xác định.

• Người dùng được mô hình hóa như con người, chứ không phải như các hệ thống phần mềm.

• Các ứng dụng bên ngoài được mô hình hóa như các hệ thống bên ngoài.

• Các thành phần nội bộ không được bao gồm trong sơ đồ ngữ cảnh.

• Các mối quan hệ mô tả những tương tác có ý nghĩa.

• Sơ đồ này có thể hiểu được mà không cần đọc mã nguồn.

• Các thuật ngữ phù hợp với tài liệu kiến trúc dự án.

Ví dụ về một thành phần sơ đồ ngữ cảnh không mong muốn

Container(api, "API Đặt hàng", "Java", "Xử lý đặt hàng")
ContainerDb(database, "Cơ sở dữ liệu Đặt hàng", "PostgreSQL", "Lưu trữ đặt hàng")

Đây là các thành phần ở cấp độ container. Chúng thuộc về sơ đồ Container C4, không thường xuất hiện trong sơ đồ ngữ cảnh hệ thống.

Phần 2: Gửi sơ đồ đến Visual Paradigm Online

11. Sử dụng “Chỉnh sửa trong VP Online” hoặc “Chỉnh sửa trong sơ đồ VP Online”

Sau khi phiên bản mã nguồn đúng, hãy chọn hành động được đánh nhãn tương tự như:

• Chỉnh sửa trong VP Online

• Chỉnh sửa trong sơ đồ VP Online

• Mở trong Online

• Xuất sang VP Online

Nhãn chính xác có thể thay đổi tùy theo phiên bản giao diện.

Sinh thái của Visual Paradigm được thiết kế để di chuyển các sơ đồ được tạo ra từ AI Chatbot sang VPasCode để tinh chỉnh ở cấp độ mã và sau đó đến Visual Paradigm Online để chỉnh sửa sơ đồ truyền thống.

Trình chỉnh sửa sơ đồ trực tuyến hữu ích khi bạn cần:

• Di chuyển hình dạng thủ công

• Thay đổi kích thước các thành phần

• Điều chỉnh kết nối

• Thay đổi màu sắc và phông chữ

• Thêm ghi chú hoặc chú thích

• Thêm tiêu đề hoặc chú giải

• Áp dụng định dạng trình bày

• Căn chỉnh các thành phần sơ đồ chính xác

• Chuẩn bị sơ đồ để chia sẻ hoặc xuất ra

12. Chỉnh sửa sơ đồ bằng giao diện người dùng của Visual Paradigm Online

Khi sơ đồ mở ra trong Visual Paradigm Online:

Di chuyển các thành phần

Kéo người và các hệ thống bên ngoài vào một bố cục rõ ràng xung quanh hệ thống chính.

Một bố cục phổ biến là:

• Người ở bên trái hoặc phía trên

• Hệ thống chính ở giữa

• Hệ thống bên ngoài ở bên phải hoặc phía dưới

Chỉnh sửa văn bản

Nhấp đúp vào một thành phần hoặc chọn bảng thông số của nó để chỉnh sửa:

• Tên

• Mô tả

• Stereotype

• Nhãn mối quan hệ

Giữ tên ngắn gọn và mô tả mang tính thông tin.

Chỉnh sửa mối quan hệ

Chọn một kết nối để:

• Thay đổi hướng của nó

• Chỉnh sửa nhãn mối quan hệ

• Kết nối lại với một phần tử khác

• Điều chỉnh tuyến đường của nó

• Thay đổi kiểu hoặc ngoại hình đường nét

Thêm các phần tử

Sử dụng bảng biểu đồ để thêm:

• Người

• Người bên ngoài

• Hệ thống

• Hệ thống bên ngoài

• Mối quan hệ

• Ghi chú

• Biên giới

Chỉ thêm các thành phần thuộc cấp độ ngữ cảnh.

Áp dụng định dạng

Bạn có thể cải thiện độ dễ đọc bằng cách điều chỉnh:

• Cỡ chữ

• Màu nền

• Màu viền

• Độ dày đường

• Kích thước hình dạng

• Căn chỉnh

• Khoảng cách

• Đường dẫn kết nối

Tránh sử dụng màu sắc như cách duy nhất để truyền đạt ý nghĩa. Cũng nên sử dụng nhãn rõ ràng.

13. Bố cục trình bày được khuyến nghị

Một sơ đồ ngữ cảnh sạch có thể sử dụng bố cục này:

Đối với các sơ đồ lớn hơn:

• Giữ hệ thống chính ở trung tâm.

• Nhóm các cá nhân ở một bên.

• Nhóm các hệ thống phần mềm bên ngoài ở một bên khác.

• Tránh các đường quan hệ chéo nhau.

• Giữ nhãn quan hệ nằm ngang khi có thể.

• Sử dụng nhãn ngắn thay vì đoạn văn.

• Dành đủ khoảng trống xung quanh hệ thống chính.

Phần 3: Chọn giữa chỉnh sửa mã và giao diện người dùng

VPasCode hỗ trợ các mô hình C4 thông qua PlantUML và cung cấp bản xem trước trực tiếp, trong khi Visual Paradigm Online cung cấp quy trình làm việc trực quan truyền thống để chỉnh sửa sơ đồ.

Phần 4: Quy trình toàn diện được đề xuất

Quy trình nhanh

1. Mở trợ lý chatbot AI của Visual Paradigm.

2. Chọn sơ đồ ngữ cảnh hệ thống C4.

3. Mô tả hệ thống, người dùng và các hệ thống bên ngoài.

4. Tạo sơ đồ.

5. Yêu cầu trợ lý chatbot loại bỏ các chi tiết triển khai nội bộ.

6. Xem xét tên, mối quan hệ và phạm vi.

7. Chọn Mở trong VPasCode.

8. Chỉnh sửa nguồn C4-PlantUML.

9. Hiển thị và xác minh kết quả.

10. Chọn Chỉnh sửa trên VP Online.

11. Tinh chỉnh bố cục và ngoại hình bằng giao diện người dùng.

12. Xuất hoặc chia sẻ sơ đồ cuối cùng.

Phân chia trách nhiệm được đề xuất

Sử dụng Trợ lý trò chuyện AI cho:

• Tạo bản nháp đầu tiên

• Khám phá các phương án kiến trúc

• Thêm hoặc xóa người tham gia

• Viết lại mô tả mối quan hệ

• Xem xét sơ đồ để phát hiện thiếu sót

Sử dụng VPasCode cho:

• Đổi tên nhiều thành phần

• Sử dụng lại mã biểu đồ

• Áp dụng cú pháp nhất quán

• Quản lý mã trong kiểm soát phiên bản

• Thực hiện các thay đổi cấu trúc có thể lặp lại

• Sửa các chỉ thị bố cục

• Tạo ra nguồn gốc sự thật dựa trên văn bản

Sử dụng Visual Paradigm Online cho:

• Vị trí hình ảnh cuối cùng

• Định dạng trình bày

• Điều chỉnh nối tay

• Thêm ghi chú và chú thích

• Chuẩn bị một sơ đồ cho các bên liên quan

Phần 5: Cuộc trò chuyện minh họa về việc tinh chỉnh

Yêu cầu ban đầu

Tạo một sơ đồ ngữ cảnh hệ thống C4 cho một nền tảng giao hàng thực phẩm.

Tinh chỉnh 1

Thêm Khách hàng, Quản lý nhà hàng, Tài xế giao hàng và Quản trị viên Vận hành như các nhân vật.

Tinh chỉnh 2

Thêm Nhà cung cấp Thanh toán, Dịch vụ Bản đồ và Định vị, và Dịch vụ Thông báo như các hệ thống bên ngoài.

Tinh chỉnh 3

Loại bỏ tất cả cơ sở dữ liệu, API, dịch vụ vi mô, container và chi tiết triển khai. Sơ đồ này phải vẫn là một sơ đồ ngữ cảnh hệ thống C4 cấp độ 1.

Tinh chỉnh 4

Viết lại tất cả nhãn mối quan hệ dưới dạng cụm động từ ngắn gọn và giữ dưới 10 từ mỗi khi có thể.

Tinh chỉnh 5

Xem xét sơ đồ để phát hiện các mối quan hệ bị thiếu và từ ngữ không nhất quán. Giữ “Nền tảng giao hàng thực phẩm” là hệ thống duy nhất cần quan tâm.

Tinh chỉnh 6

Tạo sơ đồ dưới dạng C4-PlantUML và làm cho nó có sẵn để chỉnh sửa trong VPasCode.

Phần 6: Khắc phục sự cố

Sơ đồ chứa quá nhiều chi tiết

Hỏi:

Đơn giản hóa điều này thành một sơ đồ Bối cảnh Hệ thống C4 nghiêm ngặt. Loại bỏ các container, thành phần, cơ sở dữ liệu, API và tên công nghệ.

Sơ đồ có quá nhiều đường chéo nhau

Trong VPasCode:

• Thử LAYOUT_TRÁI_PHẢI() hoặc LAYOUT_TỪ_TRÊN_XUỐNG().

• Thêm giới hạn Lay_ chỉ thị.

• Rút gọn nhãn mối quan hệ.

• Giảm số lượng mối quan hệ được hiển thị.

• Chuyển phiên bản cuối cùng sang VP Online để định vị thủ công.

Xem trước PlantUML hiển thị lỗi

Kiểm tra:

• Thư viện C4 bao gồm

• Thiếu dấu phẩy

• Dấu ngoặc đơn chưa đóng

• Tên xác định bị sai chính tả

• Mối quan hệ tham chiếu đến các phần tử chưa được định nghĩa

• Dấu ngoặc kép không cân bằng

• Tên phần tử sai

Một mối quan hệ phải tham chiếu đến các định danh đã được khai báo trước, ví dụ:

Person(customer, "Khách hàng", "Đặt hàng")
System(platform, "Nền tảng Giao hàng Thực phẩm", "Xử lý đơn hàng")

Rel(customer, platform, "Đặt hàng")

Phiên bản giao diện người dùng khác với phiên bản mã nguồn

Xem hai phiên bản này là các biểu diễn chỉnh sửa riêng biệt sau khi chuyển đổi. Đưa ra quyết định rõ ràng về phiên bản nào là nguồn gốc chân lý:

• Sử dụng VPasCode là nguồn gốc chân lý nếu sơ đồ sẽ được duy trì dưới dạng mã nguồn.

• Sử dụng Visual Paradigm Online là nguồn gốc chân lý nếu các bên liên quan sẽ thường xuyên điều chỉnh nó một cách trực quan.

Tránh thực hiện các thay đổi không liên quan ở cả hai nơi mà không đồng bộ hóa chúng.

Sơ đồ được tạo ra sử dụng cấp độ C4 sai

Hỏi trợ lý chat:

Tạo lại bản này chỉ dưới dạng sơ đồ ngữ cảnh hệ thống C4. Hiển thị người dùng, hệ thống quan tâm và các hệ thống phần mềm bên ngoài. Không hiển thị các thành phần hoặc thành phần cấu thành.

Danh sách kiểm tra chất lượng cuối cùng

Trước khi công bố sơ đồ, hãy xác nhận rằng:

• Sơ đồ có tiêu đề rõ ràng.

• Hệ thống quan tâm là rõ ràng.

• Người dùng và các hệ thống bên ngoài được phân loại chính xác.

• Các mối quan hệ có nhãn có ý nghĩa.

• Không có chi tiết triển khai nội bộ nào bị rò rỉ vào tầm nhìn ngữ cảnh.

• Các tên sử dụng thuật ngữ nhất quán.

• Sơ đồ có thể đọc được ở mức độ thu phóng bình thường.

• Các đường mối quan hệ không che khuất hình dạng hoặc nhãn.

• Mã nguồn PlantUML được hiển thị thành công.

• Phiên bản VP Online khớp với kiến trúc đã được phê duyệt.

• Sơ đồ cuối cùng đã được xem xét bởi người quen thuộc với hệ thống.

Luồng công việc hiệu quả nhất là sử dụng Trợ lý trò chuyện AI để mô hình hóa nhanh chóng, VPasCode để chỉnh sửa C4-PlantUML chính xác và lặp lại, và Visual Paradigm Online để tinh chỉnh hình ảnh cuối cùng. Điều này kết hợp việc tạo sinh bằng hội thoại, khả năng bảo trì bản đồ dưới dạng mã, và chỉnh sửa trình bày dựa trên giao diện người dùng đồ họa trong một quy trình duy nhất.

This post is also available in Deutsch, English, Español, فارسی, Français, English, Bahasa Indonesia, 日本語, Polski, Portuguese, Ру́сский, 简体中文 and 繁體中文.