Chuyển tới nội dung chính

Notifications (notifications)

Thông báo trong ứng dụng gửi tới từng người dùng. Cùng với thông báo thời gian thực qua Socket.IO (/notifications), bản ghi này là bản lưu bền vững.

  • Nguồn schema: notification.schema.ts
  • Phân loại dữ liệu: có thể chứa dữ liệu cá nhân trong title, message, data.
  • Soft-delete: có (schema tự khai báo isDeleted, deletedAt).

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
userIdObjectIdCó—ref: UserNgười nhận thông báo
typeStringCó—enum: NEW_APPLICATION, APPLICATION_STATUS_CHANGELoại thông báo
titleStringCó——Tiêu đề hiển thị
messageStringCó——Nội dung hiển thị
dataMixedKhông——Dữ liệu kèm theo (Mixed), thường là mã đối tượng liên quan để giao diện điều hướng
isReadBooleanKhôngfalse—Đã đọc hay chưa
readAtDateKhông——Thời điểm đọc
createdByMixedKhông——Người tạo bản ghi, dạng { _id, email }
updatedByMixedKhông——Người sửa gần nhất, dạng { _id, email }
deletedByMixedKhông——Người xóa mềm, dạng { _id, email }
isDeletedBooleanKhôngfalse—Cờ xóa mềm. true nghĩa là bản ghi đã bị xóa khỏi nghiệp vụ nhưng vẫn còn trong database
deletedAtDateKhông——Thời điểm xóa mềm
createdAtDateKhông——Thời điểm tạo, do timestamps hoặc plugin
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps

Indexes​

KeysThuộc tínhMục đích
{ isRead: 1 }—Lọc theo trạng thái đọc
{ userId: 1, isRead: 1, createdAt: -1 }—Danh sách thông báo chưa đọc của một người, mới nhất trước

Quan hệ​

FieldLoạiĐích
userIdReference (ObjectId)users, người nhận thông báo

Loại thông báo​

Giá trị của type lấy từ enum notification-type.enum.ts và được tạo ở application-notification.service.ts:

typeKhi nào
NEW_APPLICATIONCó hồ sơ ứng tuyển mới (gửi cho phía nhà tuyển dụng)
APPLICATION_STATUS_CHANGETrạng thái hồ sơ đổi (gửi cho ứng viên)

Đối tượng nhận của từng loại suy từ tên và vị trí tạo, chưa đọc chi tiết. Trạng thái: Chưa xác minh.

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819601",
"userId": "665f1a2b3c4d5e6f70819201",
"type": "APPLICATION_STATUS_CHANGE",
"title": "Cap nhat ho so",
"message": "Ho so cua ban da chuyen sang trang thai REVIEWING",
"data": { "resumeId": "665f1a2b3c4d5e6f70819701", "status": "REVIEWING" },
"isRead": false,
"isDeleted": false,
"createdAt": "2026-10-02T03:00:00.000Z"
}

Cấu trúc của data trong ví dụ là minh họa, vì field là Mixed và nội dung thực tế do nơi tạo thông báo quyết định.

Lưu ý​

  • Known Limitation: không có TTL, thông báo được giữ vô thời hạn trừ khi bị xóa mềm.
  • Truy vấn chính "thông báo chưa đọc của người dùng, mới nhất trước" được phục vụ bởi index ghép { userId, isRead, createdAt }.