Cảnh báo SLA theo bước duyệt (sắp / đã quá hạn)

Đã đóng normal feature

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

Tóm tắt

Bước duyệt có SLA (slaHours, REQUEST-010) giờ tự nhắc người duyệt: 1 cảnh báo khi đã dùng 80% SLA, 1 thông báo khi quá hạn (người tạo và follower được theo dõi). Không đổi API.

Chi tiết

`type`	`actionCategory`	Người nhận	Khi nào
`request.approval.sla_warning`	`action_required`	người duyệt bước hiện tại	đã dùng 80% SLA của bước, chưa quá hạn
`request.approval.overdue`	`action_required`	người duyệt bước hiện tại	qua `dueAt` của bước
`request.approval.overdue`	`watching`	người tạo, follower	như trên

entityType: "request", gửi bởi hệ thống (không actor). Bước đã duyệt/từ chối/trả lại không bị nhắc; gửi lại (resubmit) thì đồng hồ và nhắc hạn của bước 1 bắt đầu lại. Job chạy mỗi 60 giây.

Contract (trước → sau)

	Trước	Sau
Endpoint / Request / Response / Lỗi	—	không đổi (cột nội bộ mới không xuất hiện trong `approvalSteps`)

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

FE: không bắt buộc. Có thể dùng các type trên cho PUT /notifications/preferences.

Cách kiểm tra

Mẫu đề xuất có bước slaHours: 1 → tạo đề xuất → sau ~48 phút người duyệt có request.approval.sla_warning, sau ~1 giờ có request.approval.overdue.

Thảo luận

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

Ngưỡng 80% là giả định (cùng WORKFLOW-005). Mobile n/a: mobile/ chưa có code.

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

Thông báo nhắc SLA dùng entityType: request nên bấm vào đã mở đúng đề xuất (IDENTITY-FE-006, commit a05f193, PR chưa mở). Chưa dùng type cho preferences (cùng lý do REQUEST-021).