คำว่า “flow” ใน Lego มี 2 ความหมาย — เอกสารนี้แยกให้ชัด:

1. Flow การทำงานของ system — engine รัน flow ใดๆ อย่างไร (โมเดล runtime ที่เป็น generic)
2. Flow Definition ที่เก็บในระบบ — แคตตาล็อก flow จริงทั้งหมด ที่ admin ตั้งค่าไว้

ส่วนที่ 1 — Flow การทำงานของ system (Runtime Model)

โมเดลหลัก: Definition → Snapshot → Instance

engine เป็น flow-agnostic — ไม่รู้จักชื่อ flow ใดเป็นพิเศษ มันอ่าน Snapshot แล้วเดินตามลำดับ step

Step มี 2 โหมดทำงาน

หลัง user กด Next ที่ Interactive step → engine เลื่อนไป step ถัดไป แล้ว AdvanceAutomaticAsync รัน Automatic ที่คั่นทั้งหมดจน finalize หรือเจอ Interactive ถัดไป

sequenceDiagram
  autonumber
  participant U as User (FE)
  participant E as FlowEngine
  participant H as Handler
  U->>E: action Next (Interactive step)
  E->>H: ExecuteAsync (step ปัจจุบัน)
  H-->>E: Ok(output)
  E->>E: AdvanceTo(next interactive)
  loop AdvanceAutomaticAsync
    E->>H: รัน Automatic step ที่คั่น
    H-->>E: Ok / Fail(MarkStuck)
  end
  E-->>U: nav (Interactive ถัดไป) หรือ FINALIZED

State machine ของ FlowInstance

stateDiagram-v2
  [*] --> Draft
  Draft --> Submitted: submit
  Draft --> Finalized: no-approve
  Submitted --> Approved: 4eye OK
  Submitted --> Rejected: 4eye no
  Submitted --> CorrectionRequested: fix
  CorrectionRequested --> Draft: reopen
  Approved --> Finalized: auto
  Draft --> Abandoned: stale
  Rejected --> [*]
  Finalized --> [*]
  Abandoned --> [*]

ส่วนที่ 2 — Flow Definition ที่เก็บในระบบ (แคตตาล็อก)

flow จริงในระบบ (กลุ่ม customer + requestor):

STANDARD_CUSTOMER_ONBOARDING

customer ผู้ใช้ใหม่สมัครเอง — ยืนยันตัวตนผ่าน OTP แล้วสร้าง platform user (ไม่ต้องรอ approve)

CUSTOMER_FIXED_ONBOARDING

customer ที่ถูก เชิญผ่าน invite token (ผูกบริษัทอยู่แล้ว) — ไม่มี NDID, มี automatic เพิ่มเพื่อผูกบริษัท + provision สิทธิ์

NEW_REQUESTOR

ตัวแทนนิติบุคคล (requestor) รายใหม่ ขอใช้บริการ FX — มี 4-eye approval แล้ว automatic สร้าง CompanyApplication + ส่งคำเชิญ customer

RETURNING_REQUESTOR

requestor ที่มีบัญชี+ตัวตนแล้ว — เหมือน NEW แต่ ไม่มี OtpVerificationStep (login ด้วย JWT)

เปรียบเทียบสรุป