sync/workflow/2026-09-24-be-workflow-task-notifications.md · Xem trên GitHub

Nhiệm vụ Workflow phát thông báo (entityType workflow_task)

Đã đóng normal feature
Module
workflow
Từ
BE
Người raise
ThaiThanhLuan
Ngày tạo
2026-09-24
Refs
WORKFLOW-006, IDENTITY-023
Bên nhận
FE appliedMobile n/a

Tóm tắt

Nhiệm vụ Workflow giờ sinh thông báo khi được tạo, chuyển bước, và khi hoàn thành/thất bại. FE không phải gọi API mới — chỉ cần điều hướng khi bấm thông báo có entityType: "workflow_task".

Chi tiết

Mọi thông báo có sourceAppId: "workflow", entityType: "workflow_task", entityId = id nhiệm vụ, body = tên nhiệm vụ. Người thao tác không nhận thông báo của chính mình. Vai trò giám sát/người theo dõi chưa có (Phase 3).

type actionCategory Người nhận Khi nào
workflow.task.created action_required người phụ trách (currentAssigneeId) tạo nhiệm vụ có người phụ trách
workflow.task.moved action_required người phụ trách chuyển sang bước không kết thúc
workflow.task.moved watching người tạo (nếu khác người phụ trách) như trên
workflow.task.completed / workflow.task.failed info người tạo, người phụ trách vào bước kết thúc Hoàn thành / Thất bại

Vào bước kết thúc chỉ sinh 1 thông báo (completed/failed), không kèm moved.

Contract (trước → sau)

Trước Sau
Endpoint POST /workflows/:id/tasks, POST /workflow-tasks/:id/move không đổi
Request — không đổi
Response — không đổi
Lỗi — không đổi

Việc bên nhận cần làm

  • FE: bấm thông báo entityType === 'workflow_task' → mở chi tiết nhiệm vụ entityId (trong board của quy trình chứa nó).

Cách kiểm tra

Tạo nhiệm vụ với currentAssigneeId = user B → đợi ~5 giây → GET /notifications (identity, token B) có type: "workflow.task.created".

Thảo luận

[BE] 2026-09-24 @ThaiThanhLuan — raised

Mobile n/a: mobile/ chưa có code.

[FE] 2026-09-24 @NinelXram — applied

Bấm thông báo workflow_task → /workflow/tasks/:id → panel nhiệm vụ trên board (IDENTITY-FE-006, commit a05f193, PR chưa mở).