Bài 2 — Nền tảng: Mermaid & PlantUML cho BA (chỉ cần đủ dùng)

Để AI làm việc hiệu quả cho bạn, bạn không cần trở thành lập trình viên, nhưng cần đọc hiểu và sửa được mã text-to-diagram. Giống như biết đọc bản vẽ dù không phải kiến trúc sư. Bài này trang bị cho bạn đúng lượng kiến thức tối thiểu về Mermaid (dễ, phổ biến) và PlantUML (mạnh cho BPMN chuẩn).

Vì sao BA nên biết đọc mã

Khi AI sinh sơ đồ bị sai một node, sẽ nhanh hơn rất nhiều nếu bạn sửa trực tiếp một dòng mã thay vì viết lại cả prompt. Ngoài ra, mã text lưu trong Git/Confluence, dễ version-control, dễ diff khi nghiệp vụ đổi.

Mermaid — cú pháp cốt lõi

Flowchart (dùng nhiều nhất):

flowchart TD
    A([Bắt đầu]) --> B[Bước xử lý]
    B --> C{Quyết định?}
    C -- Đúng --> D[Hành động 1]
    C -- Sai --> E[Hành động 2]
    D --> F([Kết thúc])
    E --> F

Ghi nhớ 4 hình dạng quan trọng:

• ([...]) = điểm bắt đầu/kết thúc (bo tròn)
• [...] = bước xử lý (chữ nhật)
• {...} = điểm quyết định (thoi)
• --> = luồng đi; -- nhãn --> = luồng có điều kiện

Hướng: TD (trên xuống), LR (trái sang phải).

Swimlane / phân vai trong Mermaid dùng subgraph:

flowchart LR
    subgraph Khách hàng
        A[Gửi đơn]
    end
    subgraph Hệ thống
        B[Kiểm tra tồn kho]
    end
    A --> B

PlantUML — khi cần BPMN/Activity chuẩn hơn

PlantUML mạnh về activity diagram với swimlane rõ ràng:

@startuml
Khách hàng
start
:Gửi yêu cầu;
Bộ phận CSKH
:Tiếp nhận;
if (Hợp lệ?) then (có)
  :Xử lý;
else (không)
  :Từ chối;
endif
stop
@enduml

Dấu |...| tạo swimlane (làn vai trò). Với BA, PlantUML tiện khi cần thể hiện trách nhiệm từng phòng ban.

Các bước học đủ-dùng trong 30 phút

• Mở mermaid.live, dán một flowchart mẫu ở trên.
• Đổi thử một nhãn node xem sơ đồ thay đổi thế nào.
• Thêm một nhánh quyết định mới bằng tay.
• Đổi hướng từ TD sang LR.
• Thử một subgraph để tạo swimlane.
• Lặp lại với PlantUML trên plantuml.com/plantuml.

Prompt mẫu: nhờ AI dạy bạn cú pháp theo ngữ cảnh

Tôi là Business Analyst, không biết code. Hãy giải thích ngắn gọn cú pháp 
Mermaid flowchart bằng cách chú thích từng dòng của đoạn mã dưới đây, 
dùng thuật ngữ BPMN (start event, task, gateway):
flowchart TD
    A([Bắt đầu]) --> B{Đủ hồ sơ?}
    B -- Có --> C[Thẩm định]
    B -- Không --> D[Trả hồ sơ]

Template tái sử dụng: bảng tra cứu ký hiệu nhanh

Ý nghĩa nghiệp vụ
Mermaid
PlantUML
Bắt đầu
A([Bắt đầu])
start
Kết thúc
Z([Kết thúc])
stop
Task/Bước
B[Xử lý]
:Xử lý;
Quyết định
C{Điều kiện?}
if (?) then/else
Luồng có điều kiện
-- Có -->
(có)/(không)
Làn vai trò
subgraph
Tên làn

Sai lầm thường gặp

• Ảo giác cú pháp: AI thỉnh thoảng sinh cú pháp Mermaid sai (thiếu ngoặc, sai từ khóa) khiến render lỗi. Đừng hoảng — dán lỗi ngược lại cho AI: "Mã này báo lỗi X, hãy sửa". Biết đọc mã giúp bạn tự sửa nhanh hơn.
• Nhầm phiên bản: AI có thể dùng tính năng Mermaid quá mới mà công cụ của bạn chưa hỗ trợ. Giữ cú pháp cơ bản cho an toàn.
• Phụ thuộc quá mức: nếu không hiểu cú pháp, bạn không thể phát hiện khi AI vẽ sai logic. Học đủ để đọc là bắt buộc, không phải tùy chọn.
• Rò rỉ dữ liệu: khi nhờ AI "dạy cú pháp", tránh dùng mã chứa quy trình bí mật của công ty làm ví dụ.