KB-3390

Workflow Module — Discussion History

2 min read Revision 1
planningworkflowdiscussionbpmn

Thảo luận Workflow Module — User + Gemini + Claude AI

Date: 2026-03-02 (S96) Participants: User (Huyen), Gemini, Claude AI (Opus)


Vòng 1: User đặt vấn đề

User: Cần module hiển thị quy trình, cho phép thêm/sửa/xóa bước bằng click + comment ngắn. AI hiểu chính xác, tự viết code, tự test, trả sản phẩm hoàn chỉnh. Con người không làm tester.

3 yêu cầu cốt lõi:

  1. Tab quy trình trực quan + workflow tự động
  2. Thêm/sửa/xóa bằng nút bấm + vài dòng comment → AI hiểu chính xác
  3. Đóng gói thành module tái sử dụng

Vòng 2: Gemini đề xuất Vue Flow

  • Đề xuất Vue Flow (Node-based UI)
  • Workflow JSON as SSOT
  • Comment cấu trúc (intent: Add/Edit/Delete + node_id)
  • Bảng workflow_blueprints + workflow_comments

User phản biện: Tư duy ngược — sơ đồ phải là SSOT, code chạy theo sơ đồ, KHÔNG PHẢI code sinh giao diện. Con người KHÔNG LÀM tester.


Vòng 3: Gemini đề xuất BPMN 2.0 + bpmn-js (Camunda)

Lý do:

  • Chuẩn quốc tế BPMN 2.0, cộng đồng khổng lồ
  • Giao diện kéo thả chuyên nghiệp có sẵn (Viewer + Modeler)
  • Lưu trữ dạng XML — AI đọc/ghi chính xác
  • Text Annotations built-in — click vào node → ghi chú → AI parse XML biết chính xác vị trí + ý định
  • npm install + ~50-100 dòng code nhúng vào Nuxt
  • Mã nguồn mở, miễn phí

Quy trình đề xuất:

  1. Tab Quy trình trên Nuxt nhúng bpmn-js
  2. Sơ đồ lưu XML trong Directus (workflows collection)
  3. Nhân viên dùng Annotation ghi chú yêu cầu thay đổi
  4. AI đọc XML cũ + mới → hiểu thay đổi → viết code Prefect → selftest
  5. Người dùng nhận sơ đồ mới + Evidence Report → Approve

Vòng 4: Claude AI (Opus) phân tích — ĐANG THẢO LUẬN

Đánh giá bpmn-js so với Assembly First principles. Cần chốt:

  • bpmn-js = "lắp ghép tool có sẵn" hay "code mới"?
  • Phương án phân tầng (Viewer trước, Modeler sau)?
  • Alternatives cần xem xét?

Cập nhật: 2026-03-02