Action Node - Logic - Delay

I. Tổng quan

Node Delay dùng để chờ một khoảng thời gian trước khi cho flow chạy sang bước tiếp theo. Đây là node mẫu bám trực tiếp ý tưởng từ Figma node Hẹn giờ.

1. Vấn đề

  • Nhiều flow không thể chạy liên tục ngay lập tức; ví dụ cần chờ 1 giờ rồi mới gửi email hoặc chỉ chạy tiếp vào các ngày làm việc.

2. Giải pháp

  • Cung cấp node Delay để chèn khoảng chờ có cấu hình vào giữa flow.

3. Đối tượng

  • Người cấu hình sequence, chăm sóc lại khách hoặc logic chờ giữa nhiều bước.

4. Tầm nhìn/insight

  • Tương lai có thể hỗ trợ thêm delay theo mốc lịch, delay theo business hours hoặc skip holiday.

II. Yêu cầu chức năng

1. Danh sách tính năng

  • Cấu hình thời gian chờ.
  • Chọn đơn vị thời gian.
  • Tùy chọn áp dụng theo ngày.

2. Đặc tả chi tiết

  • Use case 1.1: User thêm node Delay sau một action node -> Nhập số thời gian chờ và đơn vị -> Lưu -> Flow tạm dừng ở node này tới khi hết thời gian rồi mới chạy bước sau.
  • Use case 1.2: User chọn thêm phạm vi ngày áp dụng -> Hệ thống chỉ tiếp tục flow vào các ngày được phép chạy.

3. Danh sách nghiệp vụ

  • Node nhận input từ bước trước nhưng không làm thay đổi bản chất dữ liệu đầu vào; nó chỉ làm chậm thời điểm chuyển sang bước sau.
  • Thời gian chờ phải có giá trị dương và đơn vị thời gian hợp lệ.
  • Nếu flow bị paused trong thời gian chờ, việc tiếp tục sau delay phải tuân theo rule pause/resume của engine.
  • Theo Figma, node có thể hỗ trợ:
    • trường nhập thời gian chờ
    • trường chọn đơn vị
    • tùy chọn áp dụng theo ngày trong tuần

4. Giao diện

  • Figma tham chiếu:
    • https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=4-154796&m=dev
  • Lưu ý: Hình dưới đây chỉ mang tính minh họa cho panel cấu hình node Delay, không phải ảnh thiết kế giao diện chính thức trích xuất trực tiếp từ Figma.
  • Thiết kế giao diện chính thức xem tại:
    • https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=4-154796&m=dev

Minh họa panel Delay

  • Card node hiển thị tên Hẹn giờ hoặc mô tả thời gian chờ chính.
  • Panel cấu hình hiển thị các field thời gian chờ, đơn vị và danh sách ngày áp dụng.

III. Yêu cầu phi chức năng

  • Engine cần đảm bảo delay chính xác ở mức chấp nhận được cho automation.
  • Node phải lưu được trạng thái chờ để hệ thống có thể phục hồi đúng khi worker restart.

IV. Dependency (liên quan & phụ thuộc)

  • flow.md
  • Execution scheduler / queue worker

V. API Contract (dev viết)

  • Chưa chốt API chi tiết.

VI. Test case (BA hoặc tester viết)

  • TC1: Cấu hình delay 1 giờ -> Flow dừng tại node và chỉ chạy tiếp sau 1 giờ.
  • TC2: Cấu hình giá trị thời gian âm hoặc rỗng -> Node không hợp lệ.
  • TC3: Chỉ chọn ngày làm việc -> Flow không tiếp tục vào ngày ngoài danh sách áp dụng.