Skip to content

Giao tiếp thời gian thực ​

DevLink có hai kênh nhận dữ liệu ngay khi backend có: Socket.IO để đẩy thông báo, và một luồng phản hồi từng đoạn (theo định dạng Server-Sent Events) để hiện câu trả lời của chatbot dần dần. Hai kênh độc lập nhau và dùng cách kết nối khác nhau.

So sánh hai kênh ​

Thông báoChat AI
Công nghệSocket.IO Clientfetch đọc luồng phản hồi
Địa chỉAPI_BASE_URL_IMAGE + /notificationsAPI_BASE_URL + /chat/message/stream
Hướng dữ liệuServer đẩy xuốngGửi một tin, nhận một luồng trả lời
Xác thựcauth là hàm gọi getAccessTokenAsync() mỗi lần (re)connectHeader Authorization (token từ getAccessTokenAsync()) và credentials: "include"
Khi nào hoạt độngLúc isAuthenticated là trueMỗi lần người dùng gửi tin

Thông báo bằng Socket.IO ​

Kết nối. SocketProvider (trong layout theo ngôn ngữ) theo dõi isAuthenticated:

  • Đăng nhập: nếu hasSession() là true thì tải thư viện socket.io-client bằng import(), rồi mở io(<API_BASE_URL_IMAGE>/notifications) với auth là một hàm lấy token mới nhất qua getAccessTokenAsync(), transports: ["websocket", "polling"], tối đa 5 lần thử nối lại, cách nhau 1 giây.
  • Đăng xuất: ngắt kết nối và dọn dẹp.
  • Nếu server chủ động ngắt (io server disconnect, ví dụ token hết hạn), provider gọi refreshAccessToken() rồi nối lại; hàm auth gửi token mới.

Thư viện socket.io-client nằm trong một chunk riêng và chỉ được tải sau khi đăng nhập; khách chưa đăng nhập không tải nó. Khi chunk về, provider kiểm tra lại hasSession() và việc effect đã bị dọn hay chưa. Nếu người dùng đã đăng xuất, hoặc provider đã unmount, trong lúc chờ thì không mở kết nối.

Token được đọc ở mỗi lần kết nối hoặc nối lại. Việc làm mới token nằm ở session.ts, xem Xác thực.

Nhận sự kiện. Hook useSocketEvent(event, callback) đăng ký và hủy đăng ký lắng nghe. Hiện chỉ có một sự kiện được dùng: notification:new, xử lý trong NotificationInitializer. Khi sự kiện đến, thành phần này:

  1. Tăng bộ đếm chưa đọc trong slice notification.
  2. Làm mất hiệu lực thẻ cache Notification (danh sách và số chưa đọc) để RTK Query tải lại.
  3. Hiện toast kèm nút "Xem", dẫn tới đích tính bởi getNotificationLink (ví dụ APPLICATION_STATUS_CHANGE tới /profile?tab=my-jobs).

Ngoài sự kiện đẩy, hook useNotification lấy số chưa đọc từ server bằng RTK Query khi đã đăng nhập, và cập nhật bộ đếm theo kiểu lạc quan khi đánh dấu đã đọc, hoàn lại nếu lời gọi lỗi.

Chat AI bằng luồng phản hồi ​

Dù gọi là SSE, code không dùng EventSource (không hỗ trợ POST kèm header). Thay vào đó useStreamChat gửi POST bằng fetch rồi đọc response.body từng đoạn.

Các sự kiện do parseChatStreamEvent phân loại:

Sự kiệnÝ nghĩaTác động
tokenMột đoạn văn bản của câu trả lờiNối vào nội dung đang stream
doneKết thúc, kèm dữ liệu cuối (JSON)Chốt tin nhắn, cập nhật gợi ý và hạn mức
errorLỗi (JSON có message, có thể kèm quota)Báo lỗi, cập nhật hạn mức nếu có

Quay về REST. Hàm sendStreamMessage trả fallback khi phản hồi là 401, 404, 405 hoặc 501, khi không có response.body, hoặc khi fetch ném lỗi. Khi đó useChat gửi tin bằng endpoint REST thông thường (useSendMessageMutation, đi qua Axios). Lỗi khác thì hiện toast và không quay về REST.

Hủy. Người dùng có thể dừng giữa chừng bằng abortStream, dùng AbortController để ngắt fetch.

State. Tin nhắn, nội dung đang stream, cờ đang gõ và hạn mức nằm trong slice chatBot; chỉ quota được lưu lại. Xem Quản lý state.

Source code liên quan ​

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