Skip to content

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

Trang này vẽ trình tự từ lúc người dùng đăng nhập đến khi nhận một thông báo mới qua Socket.IO và thấy nó trên chuông. Dành cho người cần biết kết nối được mở khi nào, sự kiện nào cập nhật giao diện, và developer sửa phần thông báo.

Vì sao dùng Socket.IO ​

Thông báo (hồ sơ đổi trạng thái, hồ sơ mới) cần đến ngay khi xảy ra mà không phải tải lại trang. Socket.IO cho backend đẩy thông báo xuống đúng người dùng. Luồng chat AI dùng một cơ chế khác (SSE), xem Stream chat AI.

Luồng ​

Sơ đồ rút gọn: thông báo đẩy qua socket, còn danh sách và số chưa đọc luôn được tải lại từ API.

BướcGiải thích
1SocketProvider kết nối khi isAuthenticated là true và ngắt khi đăng xuất
2Kết nối tới <API_BASE_URL_IMAGE>/notifications với auth: { token } lấy từ localStorage; ưu tiên websocket, dự phòng polling; tự kết nối lại tối đa 5 lần, cách nhau 1 giây
3Backend kiểm tra JWT trong lúc bắt tay và cho kết nối vào phòng riêng của người dùng, nên nhiều thiết bị cùng nhận
5Sự kiện tên notification:new, dữ liệu là một Notification
6incrementUnreadCount và invalidateTags cho { Notification, LIST } và { Notification, UNREAD_COUNT }
7Toast có nút "xem"
10Liên kết theo loại: APPLICATION_STATUS_CHANGE tới /profile?tab=my-jobs; NEW_APPLICATION tới /admin/resumes

Khi socket bị ngắt ​

Tình huốngHành vi
Backend ngắt (io server disconnect), ví dụ token hết hạnFrontend đặt lại auth.token bằng token hiện có trong localStorage và kết nối lại
Lỗi kết nốiChỉ ghi console.error, không thông báo cho người dùng
Thông báo bị bỏ lỡ lúc mất kết nốiVẫn nằm trong danh sách, và số chưa đọc được tải lại từ GET /notifications/unread-count

NOTE

Token trong auth được đọc một lần lúc kết nối. Khi access token được làm mới bởi Axios, socket đang mở không tự đổi token; token mới chỉ được dùng khi socket kết nối lại. Chưa chạy thử.

Source code liên quan ​

Backend: Realtime và gateway.

Đọc tiếp: Thông báo, Giao tiếp thời gian thực, Endpoint Notifications.

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