Trigger Node - Action - Schedule

I. Tổng quan

Node Schedule dùng để khởi phát flow tại một mốc thời gian hoặc khung giờ được cấu hình sẵn. Đây là trigger mẫu được lấy trực tiếp từ nhóm frame Scheduler trên Figma page AdaFlow.

1. Vấn đề

  • Nhiều flow cần chạy vào đúng thời điểm như giờ làm việc, thời gian chăm sóc lại khách hàng hoặc khung thời gian cố định, nhưng nếu không có trigger lịch thì người dùng phải thao tác tay hoặc dùng cron riêng ngoài builder.

2. Giải pháp

  • Cung cấp trigger Schedule để người dùng cấu hình thời điểm hệ thống tự khởi phát flow.

3. Đối tượng

  • Người cấu hình automation định kỳ hoặc theo lịch.

4. Tầm nhìn/insight

  • Trong tương lai có thể mở rộng thêm nhiều biến thể schedule phức tạp hơn như calendar rule, skip holiday hoặc nhiều múi giờ.

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

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

  • Cấu hình thời điểm kích hoạt flow.
  • Hiển thị card trigger trên canvas.
  • Sinh run tự động khi đến lịch.

2. Đặc tả chi tiết

  • Use case 1.1 (Cấu hình trigger): User thêm node Schedule vào flow -> Chọn thời điểm hoặc khung giờ cần kích hoạt -> Lưu node -> Flow đủ điều kiện được lên lịch khi xuất bản.
  • Use case 1.2 (Khởi phát đúng lịch): Đến mốc thời gian đã cấu hình -> Hệ thống tạo flow run mới -> Trigger Schedule trở thành điểm bắt đầu của run đó.

3. Danh sách nghiệp vụ

  • Trigger chỉ sinh run khi flow đang ở trạng thái active.
  • Thời gian kích hoạt phải được lưu theo timezone của workspace hoặc theo quy tắc hệ thống đã chốt.
  • Nếu flow bị paused, lịch đã cấu hình không được khởi phát run mới cho tới khi flow được bật lại.

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 trigger Schedule trong builder, 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 trigger Schedule trong builder

  • Card node thể hiện icon lịch, tên node và mô tả ngắn.
  • Panel cấu hình hiển thị các field liên quan đến thời gian kích hoạt.

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

  • Hệ thống cần đảm bảo độ chính xác thời gian ở mức phù hợp với use case vận hành.
  • Trigger lịch không được sinh run trùng do xử lý lặp của worker.

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

  • flow.md
  • Execution scheduler / 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 lịch hợp lệ -> Đến đúng thời điểm -> Flow run được tạo.
  • TC2: Flow đang paused -> Đến giờ lịch -> Không sinh run mới.
  • TC3: Sửa thời gian trigger rồi lưu -> Lịch mới được áp dụng cho lần chạy tiếp theo.