M-002: Đánh giá bpmn-js — Tech Evaluation

Date: 2026-03-02 | Evaluator: Claude AI (Opus) Status: ✅ USER PHÊ DUYỆT (S96) — Code mới OK, bpmn-js chốt

---

Kết luận

ĐỒNG Ý đề xuất Gemini: bpmn-js (Camunda) là giải pháp đúng cho Workflow Module.

So sánh nhanh

	Mermaid	Vue Flow	bpmn-js ⭐
Người đọc	⚠️ Basic	✅ (tự code)	✅✅ Chuẩn BPMN 2.0
AI hiểu	✅ Text	✅ JSON	✅✅ XML cấu trúc
Đồ sẵn	✅	❌ (phải code UI)	✅ Viewer + Modeler + Annotations sẵn
Interactive	❌ Tĩnh	✅	✅
Code cần viết	0	500-1000+	~50-80 dòng wrapper

Tại sao bpmn-js

• 9K+ GitHub stars, v18.10, 10+ năm phát triển
• BPMN 2.0 = chuẩn quốc tế về workflow
• Annotations built-in = "type ít hiểu nhiều" (click node → ghi chú → AI đọc XML biết chính xác)
• 2 chế độ: Viewer (xem) + Modeler (sửa) — cùng XML, đổi mode
• ~80 dòng Vue wrapper = assembly, không phải phát minh lại

Lộ trình

• Phase 1 (v1): Viewer only — hiển thị sơ đồ đẹp (~50 dòng code — CẦN PHÊ DUYỆT)
• Phase 2 (v2): Modeler + Annotations — click để ghi chú intent
• Phase 3 (v3): Prefect integration — BPMN XML → auto code

Liên kết

• Chi tiết đầy đủ: xem artifact trong S96
• Discussions: knowledge/dev/planning/workflow-module/discussions.md
• Module Protocol: search_knowledge("module protocol standard")