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

Module Notifications, Mail và Subscribers

Ba module liên quan đến việc báo tin cho người dùng: thông báo trong ứng dụng (kèm thời gian thực), email, và đăng ký nhận gợi ý việc làm.

Overview​

ModuleVai trò
notificationsLưu thông báo, đánh dấu đã đọc, đẩy thời gian thực qua Socket.IO
mailGửi email theo template; chứa cron gửi gợi ý việc làm hằng tuần
subscribersLưu đăng ký nhận gợi ý việc làm theo kỹ năng và địa điểm

Architecture​

Thành phầnFile
Controller thông báo (5 route)notifications.controller.ts
Service thông báonotifications.service.ts
Gateway Socket.IOnotifications.gateway.ts
Mail servicemail.service.ts
Mail controller (cron, 1 route)mail.controller.ts
Controller đăng ký (7 route)subscribers.controller.ts
Service đăng kýsubscribers.service.ts

Thông báo thời gian thực​

NotificationsGateway là gateway Socket.IO ở namespace /notifications.

Hạng mụcChi tiết
Xác thựcToken JWT truyền qua handshake.auth.token, hoặc header Authorization: Bearer .... Xác minh bằng JWT_ACCESS_TOKEN_SECRET. Không có token hoặc token sai thì ngắt kết nối
PhòngMỗi người dùng vào phòng user_<userId>, nên nhiều thiết bị cùng nhận
Theo dõi kết nốiMap<userId, Set<socketId>> trong bộ nhớ tiến trình
CORSorigin: true, credentials: true

Sự kiện cụ thể mà server phát (tên event, payload) được ghi ở 05-api/realtime.md (Phase 3).

Known Limitation: origin: true cho phép mọi origin kết nối; phần xác thực vẫn bắt buộc token hợp lệ. Bản đồ socket nằm trong bộ nhớ và không có adapter Redis, nên với nhiều instance chỉ socket trên cùng instance nhận được thông báo (scalability).

Email​

MailService gửi email bằng template Handlebars trong src/mail/templates/ (8 template: account-deleted, account-deletion-scheduled, application-status-update, forgot-password, job-expired-notification, job-recommendation, new-job-notification, verify-email). Năm phương thức có trong MailService:

Phương thứcTemplateKhi nào
sendNewJobNotificationToFollowernew-job-notificationCó tin mới của công ty đang theo dõi
sendApplicationStatusUpdateapplication-status-updateTrạng thái hồ sơ đổi
sendJobExpiredNotificationjob-expired-notificationTin hết hạn
sendAccountDeletionScheduledaccount-deletion-scheduledĐặt lịch xóa tài khoản
sendAccountDeletedaccount-deletedTài khoản đã bị xóa

Các template verify-email, forgot-password (OTP và đặt lại mật khẩu) và job-recommendation được gọi từ auth và từ processor gợi ý việc làm; tên phương thức gửi chúng chưa được liệt kê ở đây. Email thường đi qua hàng đợi (xem data-flow). Cấu hình SMTP: SMTP_HOST, SMTP_EMAIL, SMTP_PASSWORD.

Gợi ý việc làm hằng tuần​

  • Cron và route thủ công dùng chung queueJobRecommendations: duyệt toàn bộ subscribers chưa xóa mềm và có email, gom ID theo lô 100 rồi đưa vào hàng đợi.
  • Route thủ công trả về chỉ số hàng đợi (getQueueMetrics).
  • Cách chọn tin gợi ý cho từng người (khớp kỹ năng, địa điểm) nằm trong processor, mô tả ở queues.md (Phase 3).
  • Known Limitation: cron nằm trong một controller và không có khóa phân tán; với nhiều instance nó chạy nhiều lần (scalability). Chưa xác minh addSubscribersToQueueBatch có jobId cố định để loại trùng không.

Subscribers​

Quy tắc đã nêu ở subscribers (collection): tối đa 3 đăng ký đang hoạt động mỗi người, cần địa điểm hợp lệ, mọi truy cập theo chủ sở hữu (findOneOwned theo createdBy._id). POST /subscribers/skills và GET /subscribers/by-user phục vụ giao diện.

Data Model​

Collection notifications, subscribers.

Error Handling​

Gửi email lỗi trong processor chỉ được log, không retry từng email (xem jobs). Tạo thông báo lỗi khi đổi trạng thái hồ sơ chỉ được log và không làm thất bại cập nhật.

Testing​

notifications/ và mail/ không có file test. subscribers/ có 3 file test.

Source References​

src/notifications/, src/mail/, src/subscribers/.