Đề xuất cập nhật kế hoạch M-002 — Suggestion-first → Governance → DSL → BPMN View

Mục tiêu: Chuyển M-002 từ BPMN-first (XML là SSOT) sang mô hình User đề xuất thay đổi (Suggestion Intake) + Hội đồng AI điều phối (Governance) + Workflow DSL có kiểm soát (SSOT chuẩn) + BPMN chỉ là View.

Bối cảnh hiện tại (Agent Data)

• M-002 đang dùng bpmn-js (Camunda), có Viewer + Modeler + Annotations live.
• Kế hoạch/kiến trúc hiện tại thiên về lưu và thao tác trực tiếp BPMN XML.
• M-001 CommentModule được định vị là “phòng họp của máy” để điều phối AI/Agent/System/User.

Vấn đề cần giải

• User bình thường không thể và không nên chỉnh schema/quan hệ/logic workflow trực tiếp.
• Thực tế vận hành: user chỉ nói được kiểu “thêm bước A sau bước B”, thông tin có thể đủ hoặc mơ hồ cần hỏi lại.
• Cần một quy trình xử lý thay đổi nhất quán, có phê duyệt, làm rõ, audit trail, và versioning.

Định nghĩa lại mục tiêu sản phẩm

• Không phải “Workflow Builder cho user”, mà là Workflow Governance Engine.
• UI dấu [+] là cổng ghi nhận đề xuất (intake), không phải nơi chỉnh workflow production.

Kiến trúc đề xuất 4 tầng

1) Suggestion Intake Layer (User layer)

• User thao tác cực đơn giản: chọn vị trí (sau bước B), tiêu đề, mô tả, chọn vài thuộc tính cơ bản (actor_type, mức ưu tiên…)
• Lưu vào workflow_change_requests (WCR) — chỉ là proposal, không đụng DSL.

Collection: workflow_change_requests (đề xuất)

• id
• workflow_id
• position_after_step_id (hoặc before_step_id)
• title
• description
• suggested_actor_type (human/ai/system)
• suggested_action_type (notify/approve/review/compute/…)
• urgency
• status (pending/needs_clarification/approved/rejected/applied)
• clarification_required (bool)
• created_by, created_at

2) Governance & Clarification Layer (Council layer)

• Dùng M-001 CommentModule làm nơi thảo luận/làm rõ cho từng WCR.
• AI + operator được đào tạo thực hiện:
  • hỏi lại user nếu mơ hồ
  • chuẩn hóa nội dung
  • quyết định approve/reject
• Mọi quyết định có log + audit.

3) Official Workflow DSL Layer (Controlled SSOT)

• Chỉ khi WCR approved mới được “apply” vào DSL.
• DSL gồm steps + relations + checkpoints + version.

(DSL hiện có thể mở rộng từ cấu trúc trong architecture.md)

• workflows
• workflow_steps
• workflow_step_relations
• checkpoint_library
• workflow_step_checkpoints

4) Visualization + Orchestration Layer

• bpmn-js viewer-only (không nhập liệu bằng BPMN).
• Dùng các tính năng “xịn”:
  1. Overlays trạng thái realtime
  2. Highlight running path
  3. Color theo actor_type
  4. Auto-zoom to current step
  5. Export SVG cho training
• Orchestrator (Prefect/Kestra) đọc DSL, không đọc BPMN XML.

Nguyên tắc “deterministic”

• BPMN XML phải được sinh deterministic từ DSL (steps + relations) theo mapping cố định.
• AI không được suy diễn logic, chỉ được map theo schema.

Migration định hướng

• Giữ BPMN viewer hiện có.
• Bổ sung Intake + Governance trước.
• Sau khi áp dụng WCR → update DSL → regenerate BPMN → viewer render.

Kỳ vọng cập nhật trong kế hoạch M-002

• Thêm mục “Suggestion-first + Governance workflow”
• Bổ sung schema WCR
• Nêu rõ quyền hạn: user chỉ tạo proposal; council apply vào DSL
• Nêu rõ vai trò M-001 trong loop làm rõ/phê duyệt
• Nêu rõ viewer-only + tính năng bpmn-js nâng cao

---

Prompt gợi ý cho Claude Code (để rewrite kế hoạch)

(Được soạn riêng ở chat để copy vào CLI)