Skip to content

Thông báo ​

Tính năng báo cho người dùng khi có sự kiện liên quan: ứng viên nhận thông báo khi trạng thái hồ sơ đổi, nhà tuyển dụng nhận thông báo khi có hồ sơ mới. Thông báo hiện ở chuông trên thanh đầu trang và ở trang thông báo. Trang dành cho người muốn biết thông báo hiện ở đâu, và cho developer sửa chuông hay trang thông báo.

Vì sao cần ​

Trạng thái hồ sơ và hồ sơ mới là việc người dùng cần biết sớm mà không phải mở từng trang. Thông báo đến ngay khi đang mở website và vẫn xem lại được sau đó.

Đối tượng: người dùng đã đăng nhập. Hai loại thông báo hiện có: APPLICATION_STATUS_CHANGE (ứng viên) và NEW_APPLICATION (nhà tuyển dụng).

Đánh đổi: thông báo thời gian thực chỉ đến khi trình duyệt đang mở kết nối; thông báo bị bỏ lỡ vẫn nằm trong danh sách và số chưa đọc được tải từ backend.

Giao diện ​

Trang thông báo

Trang thông báo: số liệu tổng, chưa đọc, đã đọc và danh sách thông báo phân trang.

Nơi hiệnThành phầnNội dung
Thanh đầu trangNotificationBellBiểu tượng chuông kèm số chưa đọc (hiện 99+ khi quá 99); danh sách 5 thông báo mới nhất; nút "đánh dấu tất cả đã đọc"
Trang /profile?tab=notificationsNotificationsPageDanh sách 10 thông báo mỗi trang, ba ô số liệu, phân trang, nút "đánh dấu tất cả đã đọc"

Luồng nghiệp vụ ​

Sơ đồ rút gọn; trình tự kỹ thuật xem Thông báo thời gian thực.

Chức năngHành vi
Số chưa đọcTải từ GET /notifications/unread-count và đồng bộ vào Redux; giảm ngay khi đánh dấu đã đọc và hoàn lại nếu lỗi
Đánh dấu đã đọcMột thông báo (khi bấm) hoặc tất cả; mỗi thông báo chỉ gửi một lần cùng lúc
Liên kết theo loạiĐổi trạng thái hồ sơ dẫn tới /profile?tab=my-jobs; hồ sơ mới dẫn tới /admin/resumes; loại khác dẫn tới trang thông báo
XóaHook có deleteNotification nhưng chưa thành phần giao diện nào gọi nó

API liên quan ​

Hook hoặc sự kiệnEndpointDùng ở
useGetNotificationsQueryGET /notificationsChuông, trang thông báo
useGetUnreadCountQueryGET /notifications/unread-countuse-notification.ts
useMarkAsReadMutation, useMarkAllAsReadMutationPATCH /notifications/:id/read, PATCH /notifications/read-alluse-notification.ts
Sự kiện notification:newSocket.IO, namespace /notificationsNotificationInitializer

Bảng đầy đủ: Endpoint Notifications.

Dữ liệu và kiểm tra ​

Một thông báo gồm _id, type, title, message, isRead, data (tùy chọn: resumeId, jobId, companyId, status), createdAt, updatedAt. Frontend khai báo thêm recipient trong khi backend lưu userId; chưa kiểm tra phản hồi thật.

Trường hợp lỗi ​

Tình huốngHành vi
Không tải được danh sáchChuông và trang có trạng thái lỗi kèm nút thử lại
Đánh dấu đã đọc lỗiSố chưa đọc được hoàn lại, không có thông báo lỗi riêng
Mất kết nối socketSocket.IO tự kết nối lại tối đa 5 lần; thông báo bỏ lỡ có trong danh sách

Test cases ​

Chưa có test cho chuông, trang thông báo, use-notification và NotificationInitializer.

Source code liên quan ​

Tài liệu backend: Thông báo và email.

Đọc tiếp: Thông báo thời gian thực, Theo dõi hồ sơ, Giao tiếp thời gian thực.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code