Visual Paradigm NotesKeep: Hướng dẫn thực tiễn chuyển đổi kiến thức nhóm thành các mô hình trực quan được hỗ trợ bởi AI

Giới thiệu

Kiến thức dự án hiếm khi được lưu trữ tại một nơi duy nhất. Biên bản cuộc họp có thể được lưu trong email, yêu cầu trong tài liệu, các quyết định trong ứng dụng trò chuyện, và sơ đồ kiến trúc trong các tệp mô hình riêng biệt. Do đó, các nhóm thường dành nhiều thời gian để tìm kiếm thông tin, đối chiếu các phiên bản mâu thuẫn và chuyển đổi thủ công các yêu cầu viết thành các mô hình kỹ thuật.

Visual Paradigm NotesKeepgiải quyết vấn đề này bằng cách kết hợp ghi chú cộng tác, tổ chức tài liệu, trí tuệ nhân tạo và mô hình hóa trực quan trong một môi trường duy nhất. Thay vì coi ghi chú là văn bản cô lập, công cụ này biến chúng thành một cơ sở kiến thức dự án có thể tìm kiếm, hỗ trợ phân tích yêu cầu, thiết kế kiến trúc, mô hình hóa quy trình và giao tiếp nhóm.

Với NotesKeep và Trợ lý trò chuyện AI vẽ biểu đồ của Visual Paradigm, các nhóm có thể nhập tài liệu hiện có, tổ chức thông tin theo dự án và thẻ, đặt câu hỏi về kho lưu trữ của mình và tạo các mô hình trực quan có thể chỉnh sửa từ các mô tả bằng ngôn ngữ tự nhiên. Các quy trình được hỗ trợ có thể bao gồm UML, BPMN, ERD, sơ đồ luồng, mô hình C4 và các dạng trực quan hóa kỹ thuật khác.

---

Visual Paradigm NotesKeep là gì?

Visual Paradigm NotesKeep là công cụ quản lý kiến thức và ghi chú bằng AI hướng đến nhóm. Nó được thiết kế để giúp các tổ chức tạo ra một nguồn sự thật chung cho thông tin dự án.

Nền tảng kết hợp:

• Ghi chú dự án định dạng phong phú

• Tài liệu và tệp đã nhập

• Không gian làm việc chung

• Thẻ và tổ chức theo cấp bậc

• Biểu đồ nhúng và tài sản trực quan

• Kiến thức dự án có thể tìm kiếm

• Phân tích và tạo biểu đồ được hỗ trợ bởi AI

• Tích hợp với hệ sinh thái mô hình hóa của Visual Paradigm

Giá trị chính của nó không chỉ đơn thuần là ghi lại thông tin. NotesKeep giúp bảo tồn bối cảnh đằng sau các quyết định dự án và biến kiến thức đó thành nguồn tài nguyên sẵn có cho phân tích, thiết kế, tài liệu hóa và cộng tác sau này.

Ví dụ, một nhóm có thể lưu trữ:

• Biên bản cuộc họp

• Yêu cầu sản phẩm

• Tóm tắt phỏng vấn người dùng

• Tài liệu quy định

• Quyết định kiến trúc

• Mô tả quy trình

• Ảnh chụp bảng trắng

• Thông số kỹ thuật

• Hướng dẫn dự án

• Phản hồi của khách hàng

Sau đó, trợ lý trò chuyện AI có thể sử dụng các ghi chú dự án đã chọn làm ngữ cảnh khi trả lời câu hỏi hoặc tạo mô hình.

---

Tại sao các nhóm cần quy trình mô hình hóa lấy kiến thức làm trung tâm

Tài liệu dự án truyền thống thường tạo ra ba vấn đề liên quan.

1. Thông tin bị phân mảnh

Các quyết định quan trọng có thể được phân tán trên nhiều công cụ và định dạng tệp khác nhau. Một nhà phát triển có thể có một phiên bản của yêu cầu, trong khi một nhà phân tích nghiệp vụ hoặc khách hàng có phiên bản mới hơn trong tài liệu cuộc họp.

2. Tài liệu trở nên lỗi thời

Một sơ đồ có thể đại diện chính xác cho hệ thống tại thời điểm được tạo nhưng lại không phản ánh các thay đổi sau này. Nếu không có kết nối với các yêu cầu và quyết định nền tảng, sẽ trở nên khó khăn để xác định xem mô hình còn hợp lệ hay không.

3. Chuyển đổi văn bản thành sơ đồ tốn thời gian

Các nhóm thường bắt đầu với các mô tả không chính thức như:

“Khách hàng gửi đơn hàng, dịch vụ thanh toán xác minh giao dịch, và kho hàng chuẩn bị vận chuyển.”

Việc chuyển đổi mô tả này thành sơ đồ trường hợp sử dụng, sơ đồ hoạt động, mô hình BPMN hoặc sơ đồ trình tự một cách thủ công đòi hỏi kiến thức về mô hình hóa và nỗ lực bổ sung.

NotesKeep giúp giải quyết các vấn đề này bằng cách kết nối câu chuyện dự án được viết ra với các mô hình trực quan có cấu trúc. Các ghi chú cung cấp ngữ cảnh, trong khi các công cụ mô hình hóa của Visual Paradigm cung cấp biểu diễn chính thức.

---

Khái niệm cốt lõi

Ghi chú như một cơ sở kiến thức sống động

Kho lưu trữ NotesKeep không chỉ là một bộ sưu tập các trang tĩnh. Nó có thể đại diện cho lịch sử phát triển của một dự án.

Một kho lưu trữ hữu ích có thể chứa:

• Mục tiêu kinh doanh ban đầu

• Yêu cầu của các bên liên quan

• Các quyết định được đưa ra trong các buổi hội thảo

• Các thay đổi về phạm vi

• Các ràng buộc kỹ thuật

• Các phương án kiến trúc thay thế

• Hồ sơ phê duyệt

• Ghi chú triển khai

Ngữ cảnh lịch sử này có thể giúp các nhóm hiểu không chỉ yêu cầu hiện tại là gì, mà còn tại sao nó tồn tại và nó đã thay đổi như thế nào.

Các truy vấn AI có phạm vi

Trợ lý ảo AI có thể tìm kiếm nội dung NotesKeep đã chọn thay vì chỉ dựa vào một lệnh chung. Người dùng có thể thu hẹp phạm vi bằng cách chọn một dự án hoặc tìm kiếm các ghi chú liên quan đến các thẻ cụ thể.

Ví dụ, một nhóm có thể sử dụng các thẻ như:

#yêu_cầu
#thanh_toan
#bảo_mật
#kiến_trúc
#phát_hành-v2
#tuân_thủ

Một truy vấn có phạm vi như sau sẽ hữu ích hơn một câu hỏi chung:

“Tóm tắt các yêu cầu thanh toán đang hoạt động từ các ghi chú được gắn thẻ#release-v2 và xác định bất kỳ mối lo ngại về bảo mật nào chưa được giải quyết.”

Câu trả lời có thể dựa trên kiến thức dự án đã chọn thay vì thông tin không liên quan.

Thông tin dự án đa phương thức

NotesKeep có thể xử lý nhiều hơn các ghi chú được gõ. Khả năng nhập của nó bao gồm các tài liệu như tệp Word, PDF, bảng tính, bài thuyết trình, tệp Markdown, nội dung HTML, hình ảnh và URL. Các tài sản trực quan cũng có thể được phân tích thông qua khả năng OCR và thị giác máy tính.

Điều này hữu ích khi thông tin dự án tồn tại dưới dạng:

• Ảnh chụp bảng trắng

• Tài liệu đã quét

• Ảnh chụp màn hình

• Sơ đồ kiến trúc hiện có

• Biểu đồ quy trình

• Slide thuyết trình

• Tài liệu hội thảo viết tay

Tạo sơ đồ từ văn bản

Chatbot vẽ sơ đồ AI có thể chuyển đổi các mô tả bằng ngôn ngữ tự nhiên thành các mô hình trực quan có cấu trúc. Tùy thuộc vào trường hợp sử dụng, các nhóm có thể tạo ra:

• Sơ đồ trường hợp sử dụng UML

• Sơ đồ lớp UML

• Sơ đồ trình tự

• Sơ đồ hoạt động

• Sơ đồ quy trình BPMN

• Sơ đồ thực thể-mối quan hệ

• Sơ đồ luồng

• Mô hình kiến trúc C4

• Bản đồ câu chuyện người dùng

• Các mô hình phần mềm và kinh doanh khác

Kết quả được tạo ra nên được coi là điểm khởi đầu để xem xét thay vì thay thế tự động cho phán đoán mô hình chuyên nghiệp.

Khả năng truy vết

Khả năng truy vết liên kết các sản phẩm dự án với thông tin mà chúng bắt nguồn. Trong thực tế, điều này có thể có nghĩa là kết nối:

• Yêu cầu kinh doanh với các trường hợp sử dụng

• Các trường hợp sử dụng với các hoạt động hoặc quy trình

• Quy trình đến các thành phần hệ thống

• Thành phần đến các quyết định triển khai

• Yêu cầu tuân thủ đến các biện pháp kiểm soát

• Quyết định đến ghi chú cuộc họp hoặc tài liệu nguồn

Điều này giúp dễ dàng trả lời các câu hỏi như:

• Yêu cầu nào đã dẫn đến quyết định thiết kế này?

• Điều gì đã thay đổi sau cuộc họp gần nhất với các bên liên quan?

• Sơ đồ nào bị ảnh hưởng bởi quy định đã được sửa đổi?

• Ràng buộc bảo mật này bắt nguồn từ đâu?

Hệ sinh thái mô hình hóa rộng lớn của Visual Paradigm bao gồm các khả năng truy vết mô hình và tài liệu hóa, có thể hỗ trợ loại quy trình làm việc liên kết này.

---

Quy trình làm việc điển hình của NotesKeep

Quy trình làm việc sau đây cho thấy một nhóm có thể sử dụng NotesKeep từ giai đoạn khám phá ban đầu cho đến thiết kế kỹ thuật.

Bước 1: Tạo không gian làm việc dự án

Bắt đầu bằng cách tạo một không gian làm việc cho sản phẩm, sự tham gia của khách hàng, hệ thống hoặc sáng kiến chuyển đổi.

Một cấu trúc thực tế có thể bao gồm:

Hiện đại hóa Cổng thông tin Khách hàng
├── Khám phá
├── Yêu cầu
├── Kiến trúc
├── Bảo mật
├── Mô hình quy trình
└── Quyết định

Giữ cho cấu trúc dễ hiểu đối với cả những người đóng góp kỹ thuật và phi kỹ thuật.

Bước 2: Nhập tài liệu dự án hiện có

Đưa thông tin hiện có vào kho lưu trữ. Tùy thuộc vào dự án, điều này có thể bao gồm:

• Ghi chú phỏng vấn

• Tóm tắt PDF

• Tài liệu đặc tả Word

• Dữ liệu Excel

• Bộ slide thuyết trình

• Sơ đồ quy trình hiện có

• Ảnh chụp màn hình

• Hình ảnh bảng trắng

• Tài liệu tham khảo trực tuyến

Việc nhập nội dung hiện có làm giảm nhu cầu tạo lại kiến thức thủ công và tạo ra một vị trí trung tâm cho phân tích dự án.

Bước 3: Tổ chức ghi chú bằng thẻ

Sử dụng thẻ để phân loại nội dung trên nhiều chiều.

Ví dụ:

#stakeholder:finance
#domain:payments
#artifact:requirement
#priority:high
#status:open
#release:v2

Thẻ có thể giúp các nhóm tìm kiếm thông tin liên quan ngay cả khi chúng thuộc các thư mục hoặc giai đoạn dự án khác nhau.

Bước 4: Ghi nhận các quyết định theo trình tự thời gian

Ghi lại các quyết định quan trọng ngay khi chúng được đưa ra. Mỗi ghi chú về quyết định lý tưởng nên bao gồm:

• Ngày

• Người tham gia

• Bối cảnh

• Quyết định

• Các phương án đã xem xét

• Hệ quả

• Hành động theo dõi

• Yêu cầu hoặc sơ đồ liên quan

Một ghi chú về quyết định có thể sử dụng định dạng sau:

Quyết định: Sử dụng cổng thanh toán bên ngoài để xác thực thẻ

Bối cảnh:
Dịch vụ thanh toán nội bộ hiện không hỗ trợ dữ liệu thẻ đã được mã hóa token.

Các phương án:
1. Mở rộng dịch vụ nội bộ
2. Tích hợp với nhà cung cấp bên ngoài

Lý do:
Nhà cung cấp bên ngoài cung cấp thời gian chứng nhận nhanh hơn và nỗ lực triển khai ban đầu thấp hơn.

Hệ quả:
Giải pháp này yêu cầu theo dõi nhà cung cấp, xử lý webhook và khôi phục khi gặp sự cố.

Bước 5: Kích hoạt phạm vi tìm kiếm phù hợp

Khi sử dụng Trợ lý trò chuyện vẽ sơ đồ AI, hãy chọn dự án phù hợp hoặc kích hoạt chức năng tìm kiếm ghi chú. Điều này giúp định hướng trợ lý trò chuyện đến nội dung kho lưu trữ liên quan.

Một nhóm dự án nên tránh đặt câu hỏi quá rộng khi chỉ có một tập hợp nhỏ các ghi chú là liên quan. Các phạm vi hẹp hơn thường tạo ra kết quả rõ ràng hơn và dễ rà soát hơn.

Bước 6: Yêu cầu phân tích hoặc tạo mô hình

Bạn có thể yêu cầu trợ lý trò chuyện tóm tắt thông tin, xác định các khoảng trống hoặc tạo một mô hình trực quan.

Các ví dụ về câu lệnh bao gồm:

Tóm tắt các yêu cầu chức năng cho việc đăng ký khách hàng.

Xác định các yêu cầu mâu thuẫn trong các ghi chú được gắn thẻ #payment.

Tạo sơ đồ trường hợp sử dụng UML cho cổng hỗ trợ khách hàng.

Tạo quy trình BPMN cho việc phê duyệt hoàn tiền dựa trên các ghi chú trong dự án Tài chính.

Tạo sơ đồ trình tự thể hiện việc gửi đơn hàng, xác thực thanh toán,
đặt chỗ tồn kho và thông báo giao hàng.

Bước 7: Rà soát và tinh chỉnh kết quả

Các sơ đồ do AI tạo ra cần được xác minh bởi các chuyên gia về lĩnh vực, nhà phân tích nghiệp vụ, kiến trúc sư hoặc nhà phát triển.

Rà soát kết quả về:

• Thiếu vai trò

• Mối quan hệ không chính xác

• Thuật ngữ không rõ ràng

• Các đường dẫn ngoại lệ chưa đầy đủ

• Biên giới hệ thống không chính xác

• Các giả định không được hỗ trợ

• Thực thể trùng lặp

• Thiếu quy tắc kinh doanh

• Thứ tự trình tự không chính xác

Kết quả được tạo sau đó có thể được tinh chỉnh qua hội thoại hoặc chỉnh sửa trong môi trường vẽ biểu đồ của Visual Paradigm.

Bước 8: Kết nối biểu đồ với tài liệu

Sau khi biểu đồ đã được xem xét, hãy nhúng hoặc liên kết nó vào tài liệu NotesKeep liên quan.

Ví dụ:

• Đặt biểu đồ ngữ cảnh trong ghi chú kiến trúc.

• Liên kết mô hình BPMN với các yêu cầu quy trình.

• Liên kết biểu đồ trình tự với tài liệu quy định API liên quan.

• Thêm biểu đồ lớp đã được phê duyệt vào hồ sơ thiết kế kỹ thuật.

• Liên kết các câu hỏi mở với các phần tử biểu đồ mà chúng ảnh hưởng.

Điều này giúp ngăn biểu đồ bị tách rời khỏi câu chuyện dự án.

---

Ví dụ 1: Chuyển ghi chú khám phá thành mô hình trường hợp sử dụng

Giả sử một nhóm sản phẩm ghi lại các ghi chú khám phá sau:

Khách hàng có thể tạo tài khoản bằng email hoặc nhà cung cấp danh tính xã hội. Sau khi đăng nhập, họ có thể duyệt sản phẩm, thêm mục vào giỏ hàng, gửi đơn hàng, thực hiện thanh toán và xem trạng thái đơn hàng. Nhân viên hỗ trợ có thể tìm kiếm đơn hàng và cấp hoàn tiền. Quản trị viên quản lý thông tin sản phẩm và quyền người dùng.

Một lời nhắc AI phù hợp có thể là:

Dựa trên ghi chú khám phá cổng khách hàng, hãy tạo biểu đồ trường hợp sử dụng UML.
Xác định các vai trò chính, các biên giới hệ thống chính và mối quan hệ giữa
khách hàng, nhân viên hỗ trợ, quản trị viên, nhà cung cấp thanh toán và cổng.

Mô hình kết quả có thể xác định:

• Khách hàng

• Nhân viên hỗ trợ

• Quản trị viên

• Nhà cung cấp thanh toán

• Nhà cung cấp danh tính

• Cổng khách hàng

• Duyệt sản phẩm

• Đăng ký tài khoản

• Xác thực

• Gửi đơn hàng

• Xử lý thanh toán

• Quản lý hoàn tiền

• Quản lý sản phẩm

• Quản lý quyền hạn

Sau đó, nhà phân tích nên xác minh xem:

• Việc xử lý thanh toán nằm trong hay ngoài ranh giới của cổng.

• Việc hoàn tiền cần được phê duyệt.

• Đăng nhập qua mạng xã hội là tùy chọn hoặc bắt buộc.

• Quản trị viên và nhân viên hỗ trợ có quyền hạn chồng chéo.

• Theo dõi đơn hàng được kết nối với dịch vụ vận chuyển.

Trí tuệ nhân tạo tăng tốc bản nháp đầu tiên, trong khi nhóm vẫn chịu trách nhiệm về tính chính xác.

---

Ví dụ 2: Chuyển đổi yêu cầu thành biểu đồ trình tự

Hãy xem xét các ghi chú sau:

Khi khách hàng gửi đơn hàng, cổng xác minh giỏ hàng, tính tổng, yêu cầu ủy quyền từ cổng thanh toán, tạo đơn hàng, đặt chỗ tồn kho và gửi email xác nhận. Nếu thanh toán thất bại, đơn hàng sẽ không được tạo.

Một lời nhắc có thể là:

Tạo biểu đồ trình tự UML cho việc gửi đơn hàng. Bao gồm khách hàng,
cổng web, dịch vụ đơn hàng, cổng thanh toán, dịch vụ tồn kho và dịch vụ
thông báo. Hiển thị cả kịch bản thanh toán thành công và kịch bản thanh toán thất bại.

Một trình tự hữu ích có thể bao gồm:

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

2. Cổng xác minh giỏ hàng.

3. Dịch vụ đơn hàng tính tổng.

4. Dịch vụ đơn hàng yêu cầu ủy quyền thanh toán.

5. Cổng thanh toán trả về kết quả thành công hoặc thất bại.

6. Khi thành công, dịch vụ đơn hàng tạo đơn hàng.

7. Dịch vụ tồn kho đặt chỗ các mặt hàng.

8. Dịch vụ thông báo gửi xác nhận.

9. Khi có lỗi, cổng thông tin hiển thị thông báo lỗi và không tạo đơn hàng.

Đội ngũ cũng nên đặt các câu hỏi tiếp theo:

• Điều gì xảy ra nếu việc đặt chỗ tồn kho thất bại sau khi xác thực thanh toán?

• Thanh toán được ghi nhận ngay lập tức hay chỉ được xác thực?

• Xác nhận được gửi đồng bộ hay thông qua hàng đợi tin nhắn?

• Khách hàng có thể an toàn thử lại yêu cầu không?

• Làm thế nào để ngăn chặn các đơn hàng trùng lặp?

Những câu hỏi này thường làm lộ ra các khoảng trống trong thiết kế mà không rõ ràng trong các ghi chú ban đầu.

---

Ví dụ 3: Tạo quy trình BPMN từ các ghi chú vận hành

Giả sử một đội vận hành ghi lại quy trình sau:

Khách hàng gửi yêu cầu hoàn tiền. Bộ phận hỗ trợ kiểm tra đơn hàng và lý do hoàn tiền. Các yêu cầu dưới 100 USD có thể được phê duyệt bởi bộ phận hỗ trợ. Các yêu cầu trên 100 USD cần sự phê duyệt của bộ phận tài chính. Sau khi được phê duyệt, nhà cung cấp dịch vụ thanh toán xử lý hoàn tiền và khách hàng nhận được thông báo.

Một lời nhắc BPMN có thể là:

Tạo một quy trình BPMN để xử lý hoàn tiền. Bao gồm khách hàng, bộ phận hỗ trợ, bộ phận tài chính, nhà cung cấp dịch vụ thanh toán và dịch vụ thông báo với tư cách là các bên tham gia. Mô hình hóa cổng phê duyệt cho các yêu cầu hoàn tiền dưới và trên 100 USD.

Quy trình được tạo có thể bao gồm:

• Gửi yêu cầu hoàn tiền

• Xác thực đơn hàng và điều kiện đủ điều kiện

• Quyết định số tiền hoàn tiền

• Phê duyệt của bộ phận hỗ trợ

• Phê duyệt của bộ phận tài chính

• Hoàn tiền từ nhà cung cấp dịch vụ thanh toán

• Thông báo cho khách hàng

• Đường dẫn từ chối hoặc làm rõ

Đội ngũ sau đó có thể tinh chỉnh mô hình bằng cách thêm:

• Thời hạn theo mức dịch vụ

• Quy tắc chuyển cấp

• Xem xét gian lận

• Hoàn tiền một phần

• Giao dịch của nhà cung cấp bị thất bại

• Tạo hồ sơ kiểm toán

---

Ví dụ 4: Trích xuất yêu cầu từ hình ảnh bảng trắng

Trong một buổi hội thảo, một nhóm có thể chụp ảnh một bảng trắng chứa:

• Phác thảo giao diện người dùng

• Mũi tên quy trình

• Tên trường

• Ghi chú về các quy tắc phê duyệt

• Thông báo lỗi

• Yêu cầu tích hợp

Sau khi nhập hình ảnh, nhóm có thể hỏi:

Trích xuất các yêu cầu hiển thị từ hình ảnh bảng trắng này. Tách chúng thành:
yêu cầu giao diện người dùng, quy tắc kinh doanh, các yêu cầu tích hợp và các câu hỏi chưa được giải quyết.

Kết quả có thể được chuyển đổi thành các ghi chú có cấu trúc và được những người tham dự hội thảo xem xét.

Một câu hỏi tiếp theo có thể là:

Tạo bản đồ câu chuyện người dùng từ các yêu cầu đã trích xuất. Sắp xếp các hoạt động,
nhiệm vụ và các ứng viên phát hành.

Quy trình này giúp chuyển đổi tài liệu không chính thức từ hội thảo thành các sản phẩm có thể hỗ trợ lập kế hoạch backlog và thiết kế hệ thống.

---

Sử dụng NotesKeep để theo dõi yêu cầu

Một phương pháp theo dõi nên kết nối vòng đời của một ý tưởng:

Yêu cầu của các bên liên quan
        ↓
Yêu cầu kinh doanh
        ↓
Câu chuyện người dùng hoặc kịch bản sử dụng
        ↓
Mô hình quy trình hoặc tương tác
        ↓
Thành phần kiến trúc
        ↓
Nhiệm vụ triển khai
        ↓
Trường hợp kiểm thử

Ví dụ:

Nguồn	Sản phẩm phái sinh	Ví dụ về mối quan hệ
Ghi chú cuộc họp với khách hàng	Yêu cầu kinh doanh	“Khách hàng cần trạng thái đơn hàng theo thời gian thực”
Yêu cầu kinh doanh	Kịch bản sử dụng	“Theo dõi đơn hàng”
Kịch bản sử dụng	Sơ đồ trình tự	Cổng yêu cầu trạng thái từ dịch vụ đơn hàng
Sơ đồ trình tự	Thành phần kiến trúc	Dịch vụ đặt hàng và dịch vụ thông báo
Thành phần kiến trúc	Nhiệm vụ phát triển	Triển khai API trạng thái đơn hàng
Nhiệm vụ phát triển	Trường hợp kiểm thử	Xác minh cập nhật trạng thái sau khi giao hàng

Việc triển khai chính xác phụ thuộc vào các công cụ Visual Paradigm và cấu hình dự án, nhưng nguyên lý nền tảng là nhất quán: mọi tài liệu quan trọng đều phải có kết nối rõ ràng với nguồn gốc và các hệ quả tiếp theo của nó.

---

Tổ chức ghi chú để đạt kết quả AI tốt hơn

Chất lượng đầu ra của AI phụ thuộc rất nhiều vào chất lượng và cách tổ chức của tài liệu nguồn.

Sử dụng tiêu đề cụ thể

Ưu tiên:

Xử lý sự cố cổng thanh toán — Phát hành 2

thay vì:

Ghi chú cuộc họp

Tách biệt sự thật khỏi các giả định

Phân biệt rõ ràng giữa:

• Yêu cầu đã xác nhận

• Giải pháp đề xuất

• Câu hỏi chưa giải quyết

• Sở thích của các bên liên quan

• Giả định kỹ thuật

• Quyết định tạm hoãn

Sử dụng thuật ngữ nhất quán

Nếu hệ thống sử dụng thuật ngữ “khách hàng”, hãy tránh chuyển đổi giữa:

• Người dùng

• Người mua

• Khách hàng

• Chủ tài khoản

trừ khi các thuật ngữ đó đại diện cho các vai trò khác nhau.

Ghi lại các vấn đề chưa được giải quyết

Thêm các dấu hiệu rõ ràng như:

Câu hỏi mở: Khách hàng có thể hủy đơn hàng sau khi được ủy quyền thanh toán không?

Điều này giúp AI và nhóm dự án xác định các khu vực cần thảo luận thêm.

Giữ các ghi chú tập trung

Một ghi chú duy nhất chứa các yêu cầu không liên quan từ nhiều hệ thống sẽ khó tìm kiếm và phân tích. Hãy tổ chức thông tin thành các chủ đề mạch lạc trong khi vẫn duy trì các liên kết giữa các ghi chú có liên quan.

---

Mẫu câu lệnh cho Visual Paradigm NotesKeep

Tóm tắt

Tóm tắt các yêu cầu hiện tại cho mô-đun quản lý tài khoản.
Tách biệt các yêu cầu đã được xác nhận khỏi các cải tiến được đề xuất.

Phát hiện xung đột

So sánh các ghi chú được gắn thẻ #authentication và xác định các yêu cầu mâu thuẫn.
Đối với mỗi xung đột, hãy trích dẫn chủ đề ghi chú liên quan và giải thích những gì cần được làm rõ.

Trích xuất yêu cầu

Trích xuất các yêu cầu chức năng, yêu cầu phi chức năng, các ràng buộc,
các giả định và các câu hỏi mở từ các ghi chú dự án đã chọn.

Mô hình hóa kiến trúc

Tạo biểu đồ container C4 cho nền tảng được mô tả trong các ghi chú đã chọn.
Bao gồm các hệ thống bên ngoài, các container chính, trách nhiệm và các đường truyền thông.

Mô hình hóa quy trình

Tạo biểu đồ BPMN cho quy trình hoàn tiền của khách hàng. Hiển thị các quyết định phê duyệt,
các đường dẫn ngoại lệ, các bên tham gia và các tương tác hệ thống.

Xem lại biểu đồ

Xem lại biểu đồ trình tự đã tạo để tìm các xử lý lỗi bị thiếu, các trách nhiệm không rõ ràng
và thứ tự tin nhắn không nhất quán.

Tạo tài liệu

Viết bản tổng quan kỹ thuật cho biểu đồ này. Giải thích ranh giới hệ thống,
các thành phần chính, luồng dữ liệu, các giả định và các câu hỏi thiết kế chưa được giải quyết.

---

Lợi ích của sự cộng tác

NotesKeep có thể hỗ trợ nhiều hoạt động của nhóm:

• Các buổi hội thảo yêu cầu chung

• Các buổi đánh giá kiến trúc

• Sự phê duyệt của khách hàng

• Chuyển giao thiết kế

• Tiếp nhận thành viên mới vào nhóm

• Lập kế hoạch sprint

• Chuẩn bị tuân thủ

• Quản lý quyết định

• Giao tiếp đa chức năng

Vì ghi chú và sơ đồ có thể được lưu trữ cùng nhau, các bên liên quan không cần phải tìm kiếm trên nhiều công cụ khác nhau để hiểu một quyết định thiết kế. Người dùng kinh doanh có thể đọc ghi chú giải thích, trong khi kiến trúc sư hoặc nhà phát triển có thể kiểm tra mô hình liên quan.

Nền tảng rộng lớn hơn của Visual Paradigm cũng kết nối công việc dựa trên trình duyệt và dựa trên máy tính để bàn, cho phép các nhóm chuyển đổi giữa quy trình làm việc cộng tác trên đám mây và các môi trường mô hình hóa nâng cao hơn.

---

NotesKeep trong các môi trường được quy định hoặc kiểm toán

Các tổ chức trong lĩnh vực chăm sóc sức khỏe, dịch vụ tài chính, bảo hiểm và các ngành được quy định khác thường cần chứng minh cách các yêu cầu được diễn giải và thực hiện.

NotesKeep có thể hỗ trợ quy trình này bằng cách giúp các nhóm duy trì:

• Ghi chú dự án theo trình tự thời gian

• Tài liệu nguồn

• Hồ sơ phê duyệt

• Thay đổi yêu cầu

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

• Mô hình trực quan liên kết

• Bình luận rà soát

• Bằng chứng hỗ trợ

Các ứng dụng tiềm năng bao gồm:

• Ánh xạ các nghĩa vụ quy định thành các yêu cầu hệ thống

• Ghi chép các quyết định bảo mật

• Ghi lại quy trình phê duyệt

• Kết nối các chính sách với quy trình kinh doanh

• Chuẩn bị bằng chứng cho các cuộc rà soát nội bộ

• Theo dõi các thay đổi qua các bản phát hành

Tuy nhiên, việc sử dụng NotesKeep không tự động khiến một dự án tuân thủ một quy định cụ thể. Việc tuân thủ phụ thuộc vào quy trình quản trị hoàn chỉnh của tổ chức, kiểm soát truy cập, chính sách lưu trữ, quy trình xác thực và triển khai kỹ thuật.

---

Mô hình vận hành nhóm được khuyến nghị

Một mô hình vận hành đơn giản có thể giúp các nhóm nhanh chóng đạt được giá trị.

Chủ sở hữu sản phẩm

Chủ sở hữu sản phẩm duy trì các mục tiêu kinh doanh, phản hồi của các bên liên quan, ưu tiên và tiêu chí chấp nhận.

Chuyên viên phân tích kinh doanh

Chuyên viên phân tích kinh doanh tổ chức các yêu cầu, xác định xung đột, tạo câu chuyện người dùng và xác thực các mô hình quy trình hoặc kịch bản sử dụng được tạo ra.

Kiến trúc sư

Kiến trúc sư xem xét các ranh giới hệ thống, tích hợp, luồng dữ liệu và các quyết định kiến trúc.

Nhà phát triển

Nhà phát triển sử dụng các mô hình và yêu cầu đã được phê duyệt để hiểu trách nhiệm triển khai và xác định các khoảng trống kỹ thuật.

Kỹ sư chất lượng

Kỹ sư chất lượng xây dựng các kịch bản kiểm thử từ yêu cầu, quy trình làm việc, các đường dẫn ngoại lệ và tiêu chí chấp nhận.

Quản lý dự án

Quản lý dự án sử dụng kho lưu trữ để theo dõi các quyết định, rủi ro, sự phụ thuộc và sự phê duyệt của các bên liên quan.

Một quy tắc quản trị hữu ích là:

Trí tuệ nhân tạo có thể tăng tốc phân tích và mô hình hóa, nhưng các thành viên trong nhóm chịu trách nhiệm phải phê duyệt các yêu cầu và tài liệu thiết kế.

---

Danh sách kiểm tra chất lượng

Trước khi xuất bản sơ đồ hoặc tóm tắt do AI tạo ra, hãy xác minh các điều sau:

Chất lượng nguồn

• Các ghi chú nền tảng có còn mới nhất không?

• Các phiên bản mâu thuẫn đã được xác định chưa?

• Các giả định quan trọng có được đánh dấu rõ ràng không?

• Các thẻ liên quan và phạm vi dự án có chính xác không?

Chất lượng mô hình

• Tất cả các tác nhân hoặc hệ thống quan trọng đã được bao gồm chưa?

• Các mối quan hệ có chính xác về mặt logic không?

• Các trường hợp ngoại lệ đã được biểu diễn chưa?

• Trách nhiệm đã được phân bổ cho các thành phần phù hợp chưa?

• Mức độ chi tiết có phù hợp với đối tượng tiếp nhận không?

Thuật ngữ

• Các thuật ngữ trong lĩnh vực có được sử dụng nhất quán không?

• Các nhãn trên sơ đồ có khớp với yêu cầu không?

• Các từ viết tắt đã được giải thích chưa?

• Các khái niệm tương tự đã được phân biệt rõ ràng chưa?

Quản trị

• Một thành viên trong nhóm có đủ năng lực đã xem xét kết quả chưa?

• Nguồn gốc của mỗi quyết định quan trọng có được ghi chép lại không?

• Ngày phê duyệt và ngày sửa đổi có được ghi lại không?

• Các câu hỏi chưa được giải quyết có được hiển thị rõ ràng không?

---

Kế hoạch áp dụng thực tế

Các nhóm có thể giới thiệu NotesKeep một cách từ từ thay vì di chuyển mọi dự án cùng một lúc.

Tuần 1: Thiết lập không gian làm việc

Xây dựng cấu trúc dự án, định nghĩa quy ước đặt tên và xác định các tài liệu hiện có quan trọng nhất.

Tuần 2: Nhập và tổ chức kiến thức

Nhập các yêu cầu, ghi chú cuộc họp, sơ đồ và tài liệu tham khảo. Thêm thẻ cho khu vực dự án, phiên bản, mức độ ưu tiên và trạng thái.

Tuần 3: Thử nghiệm các truy vấn hỗ trợ AI

Sử dụng chatbot để tóm tắt, trích xuất yêu cầu và phát hiện xung đột. So sánh kết quả với thông tin dự án đã được xem xét thủ công.

Tuần 4: Tạo các mô hình trực quan

Chuyển đổi các yêu cầu đã chọn thành sơ đồ trường hợp sử dụng, sơ đồ hoạt động, quy trình BPMN hoặc các quan điểm kiến trúc.

Tuần 5: Áp dụng các thực hành xem xét

Yêu cầu các nhà phân tích và kiến trúc sư xác thực kết quả do AI tạo ra trước khi chúng trở thành các sản phẩm dự án được phê duyệt.

Tuần 6 và tiếp theo: Kết nối vòng đời

Liên kết các yêu cầu, ghi chú, sơ đồ, quyết định, nhiệm vụ triển khai và thông tin kiểm thử để tạo ra quy trình giao hàng có thể truy vết tốt hơn.

---

Điểm mạnh và Hạn chế

Điểm mạnh

• Kết nối ghi chú với mô hình hóa trực quan chính thức

• Hỗ trợ quản lý kiến thức dự án dựa trên nhóm

• Chuyển đổi các mô tả bằng ngôn ngữ tự nhiên thành bản thảo sơ đồ

• Cho phép người dùng truy vấn thông tin cụ thể của dự án

• Hỗ trợ nhiều định dạng tài liệu và phương tiện

• Có thể giảm nỗ lực vẽ sơ đồ thủ công

• Giúp bảo tồn lịch sử đằng sau các quyết định dự án

• Tích hợp với môi trường mô hình hóa rộng lớn hơn của Visual Paradigm

Hạn chế và Lưu ý

• Các mô hình do AI tạo ra cần được con người xem xét.

• Ghi chú không rõ ràng hoặc không đầy đủ có thể tạo ra các sơ đồ không hoàn chỉnh.

• Các nhóm cần có thuật ngữ và thực hành gắn thẻ nhất quán.

• Việc mô hình hóa nâng cao vẫn đòi hỏi kiến thức về ký hiệu liên quan.

• Quyền truy cập vào NotesKeep và các khả năng AI phụ thuộc vào phiên bản hoặc gói đăng ký Visual Paradigm áp dụng.

• Khả năng truy vết đạt hiệu quả cao nhất khi các nhóm duy trì nhất quán các liên kết giữa ghi chú nguồn gốc và các sản phẩm phái sinh.

• Các biểu đồ được tạo ra cần được kiểm tra trước khi được sử dụng cho việc triển khai, tuân thủ hoặc ra quyết định cấp lãnh đạo.

---

Kết luận

Visual Paradigm NotesKeep cung cấp một cầu nối thực tế giữa kiến thức không chính thức của nhóm và kỹ thuật hệ thống chính thức. Nó cho phép các nhóm thu thập ghi chú cuộc họp, yêu cầu, tài liệu, biểu đồ và quyết định trong một kho lưu trữ chung, sau đó sử dụng thông tin đó để hỗ trợ phân tích có sự trợ giúp của AI và mô hình hóa trực quan.

Khái niệm có giá trị nhất của nó là mối liên hệ giữa ngữ cảnh và cấu trúc. Các ghi chú bảo tồn lý do đằng sau một dự án, trong khi các biểu đồ giúp việc truyền đạt, xem xét và triển khai lý do đó trở nên dễ dàng hơn. Khi kết hợp với việc gắn thẻ có kỷ luật, tài liệu rõ ràng, xem xét của con người và các thực hành truy vết, NotesKeep có thể giúp các nhóm giảm thiểu các silo thông tin và di chuyển hiệu quả hơn từ giai đoạn khám phá sang thiết kế.

Kết quả tốt nhất đến từ việc coi đầu ra do AI tạo ra như một bản thảo hợp tác đầu tiên—không phải là câu trả lời cuối cùng không thể chất vấn. Các nhóm nên sử dụng NotesKeep để tăng tốc việc hiểu và mô hình hóa trong khi vẫn giữ trách nhiệm chuyên môn đối với các quyết định về yêu cầu, kiến trúc, tuân thủ và triển khai.