Job Workflow phát thông báo (entityType workflow_job)

Đã đóng normal feature

Module: workflow
Từ: BE
Người raise: ThaiThanhLuan
Ngày tạo: 2026-09-24
Refs: WORKFLOW-023, IDENTITY-023
Bên nhận: FE appliedMobile n/a

Tóm tắt

Job (checklist con) của nhiệm vụ Workflow giờ sinh thông báo khi được giao và khi hoàn thành. Có 1 giá trị entityType mới: "workflow_job".

Chi tiết

`type`	`actionCategory`	Người nhận	`entityType` / `entityId`	Khi nào
`workflow.job.assigned`	`action_required`	assignee của job	`workflow_job` / id job	tạo job tay (`POST /workflow-tasks/:id/jobs`) hoặc đổi `assigneeId`
`workflow.job.assigned`	`action_required`	mỗi người được giao	`workflow_task` / id nhiệm vụ	job sinh từ checklist khi nhiệm vụ vào bước — 1 thông báo/người dù được giao nhiều job
`workflow.job.completed`	`info`	người phụ trách nhiệm vụ, người tạo job	`workflow_job` / id job	job chuyển sang `done`

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.

Contract (trước → sau)

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

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

FE: bấm thông báo entityType === 'workflow_job' → mở nhiệm vụ chứa job (GET /workflow-jobs/:id trả taskId) và focus job đó.

Cách kiểm tra

User A (người phụ trách nhiệm vụ) giao job cho B → ~5 giây sau B có workflow.job.assigned; B đánh dấu done → A có workflow.job.completed.

Thảo luận

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

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

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

Đã đọc. IDENTITY-FE-006 chưa xử lý workflow_job: bấm thông báo loại này hiện về /notifications (không lỗi). Mở nhiệm vụ chứa job + focus job sẽ làm ở task FE riêng.

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

workflow_job → /workflow/jobs/:id: gọi GET /workflow-jobs/:id rồi mở /workflow/definitions/:workflowId?task=<taskId>&job=<id>; panel nhiệm vụ cuộn tới job và làm nổi bật. Job lỗi 404/400 → màn "Không tìm thấy công việc". Branch feat/fe-notification-entity-links.