Hướng dẫn về Hệ sinh thái Visual Paradigm

Hệ sinh thái của Visual Paradigm cung cấp một môi trường tích hợp để chuyển đổi từ các ý tưởng ban đầu sang kiến trúc phần mềm đã được xác thực, các đặc tả có thể thực thi, kế hoạch triển khai và tài liệu kỹ thuật được cập nhật liên tục.

Điểm mạnh cốt lõi của nó nằm ở sự kết nối giữa mô hình hóa trên máy tính để bàn truyền thống, quy trình làm việc dựa trên mã cho sơ đồ qua trình duyệt, tạo hỗ trợ bởi AI, kho lưu trữ đám mây và tài liệu sống. Các nhóm có thể bắt đầu với một yêu cầu không chính thức, chuyển đổi nó thành sơ đồ hoặc mô hình có cấu trúc, tinh chỉnh nó bằng các công cụ cấp doanh nghiệp và xuất bản kết quả mà không cần xuất và nhập lại các tệp tĩnh nhiều lần.

1. Tổng quan về Hệ sinh thái

Hệ sinh thái được tổ chức xung quanh một số thành phần chuyên biệt được kết nối thông qua một lớp điều phối tập trung:

• Nền tảng Thống nhất — Điểm truy cập chính để tiếp cận các công cụ, dự án, kho lưu trữ và tài sản dùng chung.

• Ổ đĩa Thống nhất — Một kho lưu trữ tập trung, hoạt động như ổ đĩa, để lưu trữ và lập chỉ mục các sản phẩm của dự án.

• VP Desktop — Một ứng dụng cục bộ mạnh mẽ cho công việc mô hình hóa doanh nghiệp chi tiết và kỹ thuật.

• VPasCode — Một nền tảng Diagram-as-Code dựa trên trình duyệt để tạo sơ đồ dựa trên văn bản và kiến trúc có kiểm soát phiên bản.

• Trợ lý ảo Mô hình hóa Trực quan AI và Studio Web — Các công cụ dựa trên lời nhắc để chuyển đổi các mô tả bằng ngôn ngữ tự nhiên thành sơ đồ, mô hình và quy trình làm việc.

• OpenDocs — Môi trường tài liệu để tạo các đặc tả kỹ thuật có cấu trúc.

• Quy trình (Pipeline) — Cơ chế tích hợp thời gian thực kết nối các mô hình nguồn và sơ đồ với các tài liệu đã xuất bản.

Cùng nhau, các thành phần này hỗ trợ một vòng đời có thể được tóm tắt như sau:

Lời nhắc → Sơ đồ hoặc Mô hình → Tinh chỉnh Kỹ thuật → Đồng bộ hóa → Tài liệu Sống

2. Nền tảng Thống nhất

Nền tảng Thống nhất đóng vai trò là bảng điều khiển chính và “cửa vào” của hệ sinh thái. Thay vì yêu cầu người dùng mở từng ứng dụng độc lập, nó cung cấp một vị trí trung tâm để điều hướng các dự án, khởi chạy các công cụ chuyên biệt và truy cập các tài nguyên dùng chung.

Trách nhiệm chính

Nền tảng Thống nhất được sử dụng để:

• Tổ chức các dự án và không gian làm việc

• Khởi chạy VP Desktop, VPasCode, công cụ AI và công cụ tài liệu

• Cung cấp quyền truy cập vào các kho lưu trữ dùng chung

• Kết nối các nhóm làm việc trên các môi trường mô hình hóa khác nhau

• Hiển thị các sản phẩm được tạo ra trong cả không gian làm việc trên đám mây và cục bộ

• Đóng vai trò là điểm phối hợp cho quy trình kỹ thuật rộng lớn hơn

Nó đặc biệt hữu ích cho các tổ chức cần một điểm truy cập chung cho các nhà phân tích, kiến trúc sư, nhà phát triển, quản lý dự án và nhà văn bản kỹ thuật.

3. Unified Drive

Unified Drive cung cấp lưu trữ và lập chỉ mục tập trung cho các tài sản của hệ sinh thái. Nó hoạt động tương tự như một ổ đĩa dự án dùng chung, nhưng mục đích của nó là tập hợp các dạng nội dung kỹ thuật đa dạng.

Các loại tài sản

Kho lưu trữ Unified Drive có thể chứa:

• Wireframes

• Mô hình kinh doanh

• Hành trình người dùng

• Sơ đồ UML

• Mô hình quy trình BPMN

• Mô hình SysML

• Sơ đồ kiến trúc

• Sơ đồ cơ sở dữ liệu

• Quy định mã nguồn

• Tài liệu API

• Tài liệu thiết kế

• Quy định kỹ thuật

• Mô hình khởi tạo do AI tạo ra

• Tệp nguồn VPasCode

• Nội dung OpenDocs đã xuất bản

Vì các tài sản có thể bắt nguồn từ các công cụ khác nhau, Unified Drive giúp các nhóm duy trì ngữ cảnh dự án chung thay vì phân tán các tệp qua các vị trí không liên kết.

Lợi ích điển hình

Unified Drive hữu ích nhất khi:

• Nhiều vai trò cùng đóng góp vào thiết kế hệ thống giống nhau

• Dự án chứa cả tài sản trực quan và dựa trên văn bản

• Các nhóm cần truy cập các mô hình từ không gian làm việc trên đám mây và cục bộ

• Tài liệu phải tham chiếu đến các tài sản thiết kế hiện tại

• Kiến trúc sư và nhà phát triển cần một nguồn sự thật được chia sẻ

4. VP Desktop

VP Desktop là ứng dụng mô hình hóa và kỹ thuật nặng ký của hệ sinh thái. Ứng dụng này được thiết kế cho các công việc đòi hỏi cấu trúc chi tiết, xác thực nghiêm ngặt, quản lý mô hình quy mô lớn hoặc tương tác chặt chẽ với mã nguồn và cơ sở dữ liệu.

Các khả năng chính

VP Desktop phù hợp cho:

• Mô hình hóa doanh nghiệp phức tạp

• Mô hình hóa UML

• Mô hình hóa SysML

• Mô hình hóa BPMN

• Thiết kế kiến trúc quy mô lớn

• Ánh xạ quan hệ hướng đối tượng

• Kỹ thuật đảo ngược mã nguồn

• Kỹ thuật phát triển mã nguồn

• Tạo lược đồ cơ sở dữ liệu

• Đồng bộ hóa cơ sở dữ liệu và mô hình

• Xác thực cấu trúc chi tiết

• Công việc thiết kế ngoại tuyến

• Kiểm tra tuân thủ theo các tiêu chuẩn mô hình hóa chính thức

Khi nào nên sử dụng VP Desktop

VP Desktop là lựa chọn ưu tiên khi nhiệm vụ liên quan đến:

• Các mô hình lớn với nhiều yếu tố liên kết với nhau

• Các cấu trúc chi tiết về lớp, thành phần, triển khai hoặc dữ liệu

• Ký hiệu mô hình hóa chính thức

• Kỹ thuật hóa mã nguồn hiện có thành mô hình

• Tạo các cấu trúc triển khai từ mô hình

• Xác thực các quan hệ và ràng buộc

• Làm việc với các cơ sở dữ liệu quy mô doanh nghiệp

• Thực hiện các tác vụ tại chỗ mà không phụ thuộc hoàn toàn vào các công cụ dựa trên trình duyệt

Ví dụ

Một nhóm phát triển thiết kế hệ thống quản lý đơn hàng có thể sử dụng VP Desktop để mô hình hóa:

• Các lớp Khách hàng, Đơn hàng, Thanh toán và Giao hàng

• Các phụ thuộc dịch vụ và cơ sở dữ liệu

• Các nút triển khai

• Luồng tin nhắn

• Bảng cơ sở dữ liệu và các mối quan hệ

• Hợp đồng giao diện

• Khả năng truy vết giữa các thành phần phần mềm và quy trình kinh doanh

Môi trường máy tính để bàn đặc biệt có giá trị sau khi ý tưởng ban đầu đã được tạo ra, vì nó cho phép các kỹ sư cao cấp và kiến trúc sư thêm độ chính xác và đảm bảo tính nhất quán về cấu trúc.

5. VPasCode

VPasCode là một nền tảng Sơ đồ dưới dạng Mã dựa trên trình duyệt. Nó cho phép người dùng tạo sơ đồ bằng cách viết văn bản có cấu trúc thay vì vẽ thủ công từng phần tử.

Phương pháp này coi các sơ đồ là các tài liệu được kiểm soát nguồn, tương tự như mã phần mềm hoặc định nghĩa cơ sở hạ tầng.

Các loại nội dung được hỗ trợ

VPasCode có thể làm việc với:

• PlantUML

• Mermaid.js

• Graphviz

• D2

• Sơ đồ mã

• Định nghĩa JSON

• Định nghĩa YAML

Tại sao sử dụng Sơ đồ dưới dạng Mã?

Sơ đồ dưới dạng Mã mang lại nhiều lợi ích:

• Sơ đồ có thể được lưu trữ trong kho lưu trữ Git

• Các thay đổi có thể được xem xét dưới dạng chênh lệch văn bản

• Kiến trúc có thể được cập nhật cùng với mã nguồn

• Các nhóm có thể tự động hóa việc tạo sơ đồ

• Các phong cách sơ đồ lặp lại có thể được chuẩn hóa

• Các định nghĩa dựa trên văn bản dễ tái tạo hơn

• Các nhà phát triển có thể đóng góp mà không phụ thuộc hoàn toàn vào các công cụ chỉnh sửa đồ họa

Các trường hợp sử dụng tốt nhất

VPasCode đặc biệt hiệu quả cho:

• Sơ đồ kiến trúc phần mềm

• Tài liệu API

• Sơ đồ vi dịch vụ

• Sơ đồ mô hình C4

• Sơ đồ trình tự

• Biểu diễn thực thể và quan hệ

• Góc nhìn triển khai

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

• Tài liệu nhúng trong kho lưu trữ kỹ thuật

• Các nhóm thực hành tài liệu dưới dạng mã

Quy trình làm việc mẫu

Một nhà phát triển có thể định nghĩa kiến trúc dịch vụ bằng Mermaid hoặc PlantUML, hiển thị kết quả trong VPasCode, xem xét đầu ra trực quan và gửi định nghĩa nguồn vào hệ thống kiểm soát phiên bản. Nếu kiến trúc thay đổi, văn bản sẽ được cập nhật và sơ đồ sẽ được tạo lại.

Điều này biến VPasCode thành cầu nối mạnh mẽ giữa các kho lưu trữ kỹ thuật và truyền thông trực quan.

6. Trợ lý trò chuyện mô hình hóa trực quan AI và Studio Web

Trợ lý trò chuyện mô hình hóa trực quan AI và các Studio Web liên quan giúp người dùng chuyển từ mô tả bằng ngôn ngữ tự nhiên sang các đầu ra trực quan hoặc khái niệm có cấu trúc.

Chúng được thiết kế để giảm bớt rào cản khi bắt đầu tạo mô hình từ một trang trắng.

Đầu vào điển hình

Người dùng có thể cung cấp các mô tả như:

• “Thiết kế kiến trúc vi dịch vụ cho một nhà sách trực tuyến.”

• “Tạo hành trình người dùng cho việc đăng ký tài khoản.”

• “Mô hình hóa tương tác giữa khách hàng, dịch vụ thanh toán và dịch vụ đơn hàng.”

• “Tạo sơ đồ ngữ cảnh hệ thống ở mức cao.”

• “Mô tả quy trình làm việc để phê duyệt đơn vay.”

Các công cụ AI sau đó có thể tạo ra các bản nháp ban đầu:

• Mẫu kiến trúc

• Luồng logic

• Mô hình quy trình

• Hành trình người dùng

• Sơ đồ quan hệ

• Sơ đồ cấu trúc

• Mô hình khái niệm

• Khung tương tác hệ thống

Các trường hợp sử dụng tốt nhất

Mô hình hóa hỗ trợ AI có giá trị nhất trong giai đoạn:

• Động não

• Phân tích yêu cầu sơ bộ

• Khảo sát kiến trúc

• Chuẩn bị hội thảo

• Phát triển nguyên mẫu nhanh

• Giao tiếp với các bên liên quan

• Tài liệu ban đầu

• Chuyển đổi ghi chú không chính thức thành các khái niệm có cấu trúc

Phương pháp được khuyến nghị

Kết quả do AI tạo ra nên được coi là điểm khởi đầu chứ không phải là mô hình kỹ thuật hoàn chỉnh. Một quy trình thực tế là:

1. Mô tả hệ thống bằng ngôn ngữ tự nhiên.

2. Kiểm tra cấu trúc được tạo ra để tìm các giả định bị thiếu hoặc không chính xác.

3. Chuyển kết quả vào VPasCode hoặc VP Desktop.

4. Thêm các mối quan hệ chính thức, thuộc tính, ràng buộc và phụ thuộc.

5. Xác thực thiết kế bằng các công cụ kỹ thuật và mô hình hóa phù hợp.

6. Xuất bản kết quả đã tinh chỉnh thông qua OpenDocs.

7. OpenDocs và Pipeline

OpenDocs là môi trường xuất bản kỹ thuật và quản lý tri thức của hệ sinh thái. Nó được thiết kế để tạo ra các bản đặc tả và các tài liệu có cấu trúc khác.

Pipeline kết nối OpenDocs với các mô hình nguồn và sơ đồ, cho phép tài liệu chứa các biểu diễn trực tiếp hoặc tương tác thay vì xuất hình ảnh tĩnh.

Các trường hợp sử dụng của OpenDocs

OpenDocs có thể hỗ trợ:

• Tài liệu thiết kế phần mềm

• Bản đặc tả kiến trúc

• Tài liệu API

• Yêu cầu hệ thống

• Tiêu chuẩn kỹ thuật

• Tài liệu quy trình

• Thông số kỹ thuật cơ sở dữ liệu

• Hướng dẫn triển khai

• Cơ sở tri thức dự án

• Đánh giá thiết kế

Vai trò của Pipeline

Pipeline đóng vai trò là cầu nối truyền dữ liệu thời gian thực giữa các công cụ mô hình hóa và tài liệu.

Thay vì xuất sơ đồ dưới dạng hình ảnh cố định, một nhóm có thể nhúng mô hình hoặc sơ đồ trực tiếp vào tài liệu. Khi tài nguyên nguồn thay đổi, nội dung nhúng có thể được cập nhật để tài liệu luôn đồng bộ với thiết kế hiện tại.

Lợi thế so với xuất tĩnh

Việc xuất hình ảnh tĩnh thường gây ra các vấn đề đồng bộ hóa:

• Thiết kế thay đổi nhưng tài liệu thì không

• Nhiều phiên bản hình ảnh lưu hành

• Tác giả phải thay thế thủ công các sơ đồ lỗi thời

• Người xem không thể dễ dàng truy vết sơ đồ về nguồn gốc của nó

• Tài liệu dần dần lệch khỏi kế hoạch triển khai

Pipeline giải quyết các vấn đề này bằng cách kết nối tài liệu với mô hình hoặc sơ đồ nguồn gốc.

8. Các thành phần hoạt động cùng nhau như thế nào

Mỗi thành phần phục vụ một mục đích riêng biệt, nhưng hệ sinh thái được thiết kế để hỗ trợ sự di chuyển giữa chúng.

Thành phần	Vai trò chính	Phù hợp nhất cho
Nền tảng thống nhất	Điều hướng và điều phối	Truy cập công cụ, dự án và kho lưu trữ
Ổ đĩa thống nhất	Lưu trữ tài nguyên tập trung	Chia sẻ và lập chỉ mục tài sản dự án
Trợ lý ảo AI và Studio Web	Tạo nhanh	Chuyển đổi yêu cầu thành mô hình và luồng ban đầu
VPasCode	Sơ đồ dưới dạng mã	Kiến trúc dựa trên văn bản, có kiểm soát phiên bản
VP Desktop	Kỹ thuật chi tiết	Mô hình hóa chính thức, kỹ thuật mã và xác thực
OpenDocs	Xuất bản kỹ thuật	Tạo ra các đặc tả có cấu trúc và cơ sở tri thức
Quy trình	Đồng bộ hóa thời gian thực	Nhúng các mô hình hiện tại vào tài liệu

Việc lựa chọn công cụ chủ yếu phụ thuộc vào mức độ trưởng thành và độ phức tạp của công việc.

• Sử dụng công cụ AIkhi ý tưởng vẫn còn không chính thức.

• Sử dụng VPasCodekhi kết quả cần dựa trên văn bản, có thể xem xét và có kiểm soát phiên bản.

• Sử dụng VP Desktopkhi thiết kế đòi hỏi mô hình hóa chặt chẽ và độ chính xác kỹ thuật.

• Sử dụng OpenDocs và Pipelinekhi kết quả phải trở thành tài liệu kỹ thuật có thể bảo trì.

• Sử dụng Nền tảng Thống nhất và Ổ đĩa Thống nhấtđể phối hợp truy cập và duy trì tính liên tục của dự án.

9. Ví dụ về quy trình làm việc từ đầu đến cuối

Bước 1: Bắt đầu với yêu cầu hoặc ý tưởng

Quản lý dự án, nhà phân tích, kiến trúc sư hoặc nhà phát triển bắt đầu bằng một mô tả bằng ngôn ngữ đơn giản về vấn đề.

Ví dụ:

Hệ thống nên cho phép khách hàng duyệt sản phẩm, đặt hàng, thực hiện thanh toán và theo dõi vận chuyển. Kiến trúc nên sử dụng các dịch vụ có thể triển khai độc lập.

Ở giai đoạn này, mô tả có thể chưa đầy đủ. Mục tiêu là xác định một hướng đi ban đầu.

Bước 2: Tạo mô hình ban đầu

Người dùng mở Chatbot Mô hình hóa Trực quan AI hoặc một Studio Web phù hợp thông qua Nền tảng Thống nhất.

Lệnh nhắc có thể yêu cầu:

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

• Kiến trúc vi dịch vụ

• Hành trình của người dùng

• Chuỗi tương tác dịch vụ

• Quy trình kinh doanh

• Mô hình luồng dữ liệu

• Giao diện triển khai cấp cao

Kết quả được tạo cung cấp biểu diễn đầu tiên của hệ thống và giúp làm nổi bật các khái niệm bị thiếu hoặc các mối quan hệ không rõ ràng.

Bước 3: Chọn môi trường tinh chỉnh

Sau khi xem xét kết quả được tạo, người dùng chọn đích mô hình hóa phù hợp.

Chuyển sang VPasCode khi:

• Sơ đồ cần được duy trì dưới dạng văn bản

• Dự án sử dụng cộng tác dựa trên Git

• Các nhà phát triển cần xem xét các thay đổi của sơ đồ

• Kiến trúc chủ yếu được biểu diễn thông qua cú pháp sơ đồ tiêu chuẩn

• Kết quả sẽ được duy trì song song với mã nguồn

Chuyển sang VP Desktop khi:

• Mô hình yêu cầu các phần tử chính thức UML, SysML hoặc BPMN

• Thiết kế bao gồm nhiều cấu trúc liên kết với nhau

• Mã phải được phân tích ngược hoặc tạo ra

• Sơ đồ cơ sở dữ liệu phải được thiết kế hoặc đồng bộ hóa

• Yêu cầu xác minh nghiêm ngặt

• Nhóm cần mô hình hóa chi tiết ở cấp độ đối tượng

Trong một số dự án, cả hai công cụ đều có thể được sử dụng. VPasCode có thể biểu diễn kiến trúc cấp cao trong khi VP Desktop quản lý các mô hình doanh nghiệp chi tiết.

Bước 4: Thêm chi tiết kỹ thuật

Các kỹ sư cao cấp và kiến trúc sư tinh chỉnh thiết kế ban đầu.

Điều này có thể bao gồm:

• Thêm các thuộc tính và hoạt động của lớp

• Xác định các giao diện

• Phân công trách nhiệm dịch vụ

• Thêm các kiểu dữ liệu

• Ánh xạ các phụ thuộc

• Xác định các bảng cơ sở dữ liệu

• Xác định các khóa và mối quan hệ

• Kết nối các quy trình kinh doanh với các thành phần phần mềm

• Thêm các môi trường triển khai

• Mô hình hóa các đường dẫn lỗi

• Làm rõ các ranh giới bảo mật và vận hành

• Kiểm tra tính nhất quán về cấu trúc

Bước này chuyển đổi một mô hình khái niệm xấp xỉ thành một thiết kế có thể hỗ trợ việc triển khai.

Bước 5: Thực hiện kỹ thuật mã và cơ sở dữ liệu

Khi làm việc trên VP Desktop, nhóm có thể kết nối mô hình với việc triển khai và các cấu trúc dữ liệu.

Các hoạt động điển hình bao gồm:

• Kỹ thuật ngược mã hiện có thành các mô hình

• Kỹ thuật thuận các cấu trúc mô hình thành mã

• Tạo lược đồ cơ sở dữ liệu

• So sánh các mô hình thiết kế với các cơ sở dữ liệu hiện có

• Kiểm tra xem các phụ thuộc và mối quan hệ có hợp lệ hay không

• Tinh chỉnh các cấu trúc lớp và thành phần

• Xác minh ký hiệu hình thức

Giai đoạn này rất quan trọng khi dự án phải duy trì sự phù hợp giữa thiết kế khái niệm và triển khai kỹ thuật.

Bước 6: Đồng bộ hóa các tài sản dự án

Sau khi thiết kế đã được tinh chỉnh, các sơ đồ và mô hình liên quan được đồng bộ hóa qua Pipeline và được cung cấp thông qua Unified Drive.

Điều này mang lại cho đội ngũ rộng rãi quyền truy cập vào các tài sản thiết kế hiện tại mà không yêu cầu mọi thành viên phải làm việc trên cùng một công cụ.

Ví dụ:

• Kiến trúc sư có thể làm việc trên VP Desktop

• Nhà phát triển có thể duy trì các biểu đồ trong VPasCode

• Quản lý dự án có thể xem xét các đầu ra thông qua Nền tảng Thống nhất

• Người viết tài liệu kỹ thuật có thể truy cập các tài liệu thông qua OpenDocs

Bước 7: Xây dựng tài liệu sống động

Người viết tài liệu kỹ thuật hoặc kỹ sư tạo Tài liệu Thiết kế Phần mềm hoặc các quy định liên quan trong OpenDocs.

Tài liệu có thể bao gồm:

• Tổng quan hệ thống

• Phạm vi và giả định

• Biểu đồ kiến trúc

• Mô tả thành phần

• Mô hình dữ liệu

• Hợp đồng API

• Luồng quy trình

• Biểu đồ triển khai

• Quyết định thiết kế

• Ghi chú triển khai

• Thông tin truy vết

Sử dụng Pipeline, các biểu đồ và mô hình được nhúng dưới dạng các tài liệu liên kết thay vì chỉ được chèn dưới dạng hình ảnh tĩnh.

Bước 8: Duy trì đồng bộ hóa theo thời gian

Khi hệ thống phát triển, các thay đổi được thực hiện trong VP Desktop hoặc VPasCode có thể được chuyển vào tài liệu đã xuất bản.

Điều này làm giảm rủi ro rằng:

• Biểu đồ kiến trúc trở nên lỗi thời

• Tài liệu thiết kế mô tả một phiên bản hệ thống cũ hơn

• Nhà phát triển triển khai dựa trên các mô hình lỗi thời

• Người xem thấy các phiên bản không liên kết của cùng một tài liệu

Kết quả là một quy trình tài liệu vẫn được kết nối với vòng đời thiết kế.

10. Ví dụ: Dự án Kiến trúc Vi dịch vụ

Hãy tưởng tượng một nhóm đang thiết kế một nền tảng thương mại điện tử.

Khái niệm ban đầu

Quản lý dự án mô tả hành trình người dùng mong muốn:

1. Khách hàng duyệt qua danh mục.

2. Khách hàng thêm sản phẩm vào giỏ hàng.

3. Khách hàng gửi đơn hàng.

4. Dịch vụ thanh toán xác thực khoản thanh toán.

5. Dịch vụ thực hiện chuẩn bị vận chuyển.

6. Khách hàng theo dõi việc giao hàng.

Mô hình hóa hỗ trợ bởi AI

Trò chuyện AI tạo ra:

• Một hành trình khách hàng

• Một sơ đồ ngữ cảnh hệ thống

• Các vi dịch vụ tiềm năng

• Một chuỗi tương tác

• Một mô hình luồng dữ liệu ban đầu

Các dịch vụ được đề xuất có thể bao gồm:

• Dịch vụ Danh mục

• Dịch vụ Giỏ hàng

• Dịch vụ Đơn hàng

• Dịch vụ Thanh toán

• Dịch vụ Thực hiện

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

• Dịch vụ Danh tính

Tinh chỉnh VPasCode

Nhóm kiến trúc chuyển thiết kế cấp cao vào VPasCode và biểu diễn các mối quan hệ dịch vụ bằng cách sử dụng Sơ đồ dưới dạng Mã.

Điều này cho phép nhóm:

• Lưu trữ sơ đồ cùng với kho lưu trữ dự án

• Xem xét các thay đổi kiến trúc thông qua sự khác biệt văn bản

• Tạo lại sơ đồ sau khi thay đổi dịch vụ

• Tạo ra các bản xem nhất quán cho tài liệu kỹ thuật

Tinh chỉnh VP Desktop

Nhóm kỹ thuật sau đó sử dụng VP Desktop để mô hình hóa:

• Các lớp miền

• Giao diện dịch vụ

• Các thực thể dữ liệu

• Mối quan hệ cơ sở dữ liệu

• Các nút triển khai

• Các phụ thuộc giữa các thành phần

Họ cũng xác thực mô hình và tinh chỉnh cấu trúc cơ sở dữ liệu.

Xuất bản OpenDocs

Kiến trúc cuối cùng được xuất bản trong OpenDocs như một phần của Tài liệu Thiết kế Phần mềm. Quy trình tích hợp kiến trúc hiện tại và các mô hình dữ liệu để các thay đổi sau này có thể được phản ánh trong tài liệu.

11. Hợp tác giữa các vai trò

Kiến trúc lai hỗ trợ các phong cách làm việc khác nhau mà không bắt buộc mọi người đóng góp phải sử dụng cùng một ứng dụng.

Vai trò	Công cụ có khả năng	Hoạt động điển hình
Quản lý dự án	Nền tảng thống nhất, Chatbot AI	Mô tả mục tiêu, tạo luồng ban đầu, xem xét tiến độ
Phân tích viên kinh doanh	Công cụ AI, VP Desktop, OpenDocs	Mô hình hóa yêu cầu, quy trình và hành trình người dùng
Kiến trúc sư phần mềm	VP Desktop, VPasCode	Thiết kế kiến trúc, dịch vụ, phụ thuộc và ranh giới
Nhà phát triển	VPasCode, VP Desktop	Duy trì sơ đồ, xem xét thiết kế, kết nối mô hình với mã nguồn
Kỹ sư cơ sở dữ liệu	VP Desktop	Thiết kế lược đồ, quan hệ và ánh xạ đồng bộ hóa
Biên tập viên kỹ thuật	OpenDocs, Pipeline	Tổng hợp các tài liệu kỹ thuật và nhúng các tài nguyên thiết kế trực tiếp
Người xem xét hoặc bên liên quan	Nền tảng thống nhất, OpenDocs	Điều hướng các dự án và xem xét tài liệu hiện tại

Sự phân chia này cho phép mỗi vai trò sử dụng môi trường phù hợp nhất với trách nhiệm của mình trong khi vẫn duy trì một kho lưu trữ dự án được kết nối.

12. Chọn thành phần phù hợp

Một quy trình ra quyết định đơn giản có thể giúp xác định nơi bắt đầu.

Chọn AI Chatbot hoặc Web Studios nếu:

• Bạn chỉ có một bản mô tả bằng văn bản

• Bạn cần vượt qua trạng thái bảng trắng

• Bạn muốn một bản phác thảo kiến trúc nhanh chóng

• Bạn đang khám phá nhiều thiết kế khả thi khác nhau

• Bạn cần chuyển đổi ghi chú từ buổi hội thảo thành các cấu trúc trực quan

Chọn VPasCode nếu:

• Biểu đồ của bạn nên được lưu trữ dưới dạng văn bản

• Kiểm soát phiên bản là quan trọng

• Các nhà phát triển sẽ duy trì kiến trúc

• Bạn sử dụng PlantUML, Mermaid, Graphviz hoặc D2

• Biểu đồ nên đi kèm với mã nguồn hoặc định nghĩa API

Chọn VP Desktop nếu:

• Bạn cần mô hình hóa quy mô doanh nghiệp

• Thiết kế sử dụng ký hiệu chính thức UML, SysML hoặc BPMN

• Bạn cần kỹ thuật cơ sở dữ liệu

• Bạn cần kỹ thuật mã ngược hoặc thuận

• Bạn yêu cầu xác minh chi tiết và khả năng truy vết

Chọn OpenDocs và Pipeline nếu:

• Bạn đang tạo ra một tài liệu kỹ thuật chính thức

• Các sơ đồ phải luôn được đồng bộ hóa với nguồn gốc của chúng

• Bạn muốn các Tài liệu Thiết kế Phần mềm luôn được cập nhật

• Nhiều nhóm cần một tài liệu tham chiếu kỹ thuật chung

• Việc xuất ra các hình ảnh tĩnh đang gây ra các vấn đề về bảo trì

Hãy chọn Nền tảng Thống nhất và Lưu trữ Thống nhất nếu:

• Bạn cần một không gian làm việc dự án tập trung

• Nhiều công cụ đang được sử dụng

• Các nhóm cần một kho lưu trữ tài sản chung

• Bạn cần một vị trí duy nhất để điều hướng và cộng tác

13. Các thực hành vận hành được khuyến nghị

Hãy coi đầu ra của AI là bản nháp

Các mô hình do AI tạo ra hữu ích để tăng tốc độ, nhưng chúng cần được chuyên gia trong lĩnh vực xem xét và tinh chỉnh. Hãy xác minh thuật ngữ, mối quan hệ, ranh giới dịch vụ, các giả định và các yêu cầu còn thiếu trước khi sử dụng mô hình làm nền tảng kỹ thuật.

Giữ cho các chế độ xem tổng quan và chi tiết luôn được liên kết

Hãy sử dụng VPasCode cho các chế độ xem kiến trúc dễ đọc và VP Desktop cho các mô hình chính thức chi tiết khi thích hợp. Hai cấp độ này phục vụ các đối tượng khác nhau và nên bổ sung cho nhau thay vì cạnh tranh.

Hãy lưu trữ các định nghĩa nguồn, không chỉ các sơ đồ đã được render

Đối với công việc Sơ đồ dưới dạng Mã, hãy bảo tồn nguồn PlantUML, Mermaid, Graphviz, D2, JSON hoặc YAML. Các hình ảnh đã được render hữu ích cho việc trình bày, nhưng các định nghĩa nguồn dễ bảo trì và xem xét hơn.

Hãy sử dụng Lưu trữ Thống nhất làm nguồn sự thật chung

Tập trung hóa các tài sản quan trọng thay vì để nhiều bản sao rời rạc lưu chuyển qua email, thư mục cục bộ hoặc các hệ thống tài liệu riêng biệt.

Xuất bản thông qua Pipeline

Khi có thể, hãy kết nối tài liệu với các mô hình và sơ đồ trực tiếp. Điều này làm giảm lượng công việc thay thế thủ công cần thiết khi kiến trúc thay đổi.

Tách biệt quá trình khám phá và xác thực

Giai đoạn ý tưởng ban đầu cần nhanh chóng và linh hoạt. Việc xác thực chính thức nên diễn ra sau khi thiết kế đã ổn định đủ để xem xét chi tiết. Sử dụng công cụ AI cho việc khám phá và VP Desktop cho việc xác thực hỗ trợ cả tốc độ và tính nghiêm ngặt.

Thiết kế tài liệu như một phần của vòng đời

Tài liệu không nên được coi là sản phẩm cuối cùng của dự án được tạo ra sau khi triển khai. Bằng cách kết nối OpenDocs với các mô hình đang hoạt động, nhóm có thể duy trì tài liệu trong suốt các chu kỳ thiết kế, phát triển và thay đổi sau này.

14. Các lợi ích chính

Cách tiếp cận tích hợp của hệ sinh thái mang lại nhiều lợi ích thực tế:

• Chuyển đổi nhanh hơn từ ý tưởng sang mô hình trực quan

• Giảm bớt sự cản trở giữa các yêu cầu bằng ngôn ngữ tự nhiên và thiết kế chính thức

• Hỗ trợ cả mô hình hóa bằng đồ họa và dựa trên văn bản

• Cộng tác tốt hơn giữa các kiến trúc sư, nhà phát triển, nhà phân tích và người viết

• Sự liên kết chặt chẽ hơn giữa các mô hình, mã nguồn, cơ sở dữ liệu và tài liệu

• Hỗ trợ kiểm soát phiên bản cho các sơ đồ kiến trúc

• Xác thực chính thức cho các thiết kế doanh nghiệp phức tạp

• Giảm sự phụ thuộc vào việc xuất sơ đồ tĩnh

• Các thông số kỹ thuật nhất quán hơn

• Khả năng truy vết được cải thiện trên toàn bộ vòng đời kỹ thuật

Kết luận

Hệ sinh thái của Visual Paradigm kết hợp ý tưởng hỗ trợ AI, sơ đồ dưới dạng mã, mô hình hóa trên máy tính để bàn doanh nghiệp, quản lý tài sản tập trung và tài liệu sống thành một quy trình làm việc liên kết.

Nền tảng Thống nhất cung cấp điểm truy cập, Unified Drive tổ chức các tài sản của dự án, các công cụ AI tăng tốc mô hình hóa giai đoạn đầu, VPasCode hỗ trợ các sơ đồ dựa trên văn bản và có kiểm soát phiên bản, VP Desktop cung cấp kỹ thuật chi tiết và xác thực, còn OpenDocs với Pipeline giữ cho tài liệu kỹ thuật được đồng bộ với các mô hình nguồn của nó.

Khi được sử dụng cùng nhau, các thành phần này tạo ra một lộ trình liên tục từ các yêu cầu không chính thức đến kiến trúc chính thức, các mô hình sẵn sàng triển khai và tài liệu kỹ thuật có thể bảo trì.