Skip to content

Thời gian thực và AI ​

Hai tính năng cần nhận dữ liệu ngay khi backend có: thông báo (qua Socket.IO) và chatbot AI (qua luồng phản hồi từng đoạn). Trang này ghi các công nghệ phía frontend dùng cho hai việc đó, và làm rõ rằng frontend không trực tiếp gọi bất kỳ nhà cung cấp AI nào.

Cách hai kênh hoạt động: Giao tiếp thời gian thực.

Công nghệ ​

Công nghệKhai báoVai trò
socket.io-client^4.8.3Nhận thông báo đẩy từ namespace /notifications
fetch với ReadableStreamtrình duyệtĐọc luồng phản hồi của chat (không dùng EventSource)
react-markdown^10.1.0Hiển thị câu trả lời của chatbot dạng Markdown
remark-gfm^4.0.1Hỗ trợ bảng, danh sách việc, gạch ngang theo GitHub Flavored Markdown
uuid^13.0.0Tạo mã cho tin nhắn đang stream
sonner^2.0.7Toast thông báo

react-markdown và remark-gfm được import trong src/features/chatbot/components/chat-surface/chat-message-item.tsx và chat-welcome.tsx.

Frontend không gọi nhà cung cấp AI ​

Không có import hay tham chiếu tới SDK hoặc địa chỉ của nhà cung cấp mô hình AI nào trong src/ tại thời điểm viết. Frontend chỉ gửi tin nhắn tới backend (POST /chat/message/stream, hoặc endpoint REST khi quay về), nhận lại văn bản và dữ liệu có cấu trúc. Việc chọn mô hình, hạn mức và nội dung gợi ý đều nằm ở backend.

Điều này có hai hệ quả cho phía frontend: không có khóa API AI nào cần giữ trong mã trình duyệt, và hạn mức sử dụng (quota) là dữ liệu do backend trả, frontend chỉ hiển thị và lưu tạm.

Các thành phần giao diện chat ​

Thành phầnVị tríDùng ở
ChatWidgetsrc/features/chatbot/components/chat-widget.tsxLayout (main) và (profile)
HrChatAssistantsrc/features/chatbot/components/hr-chat-assistant.tsxLayout (hr-dashboard)
ChatSurfacesrc/features/chatbot/components/chat-surface/index.tsxKhung hội thoại, hiển thị Markdown

Toàn bộ module nằm trong src/features/chatbot/: slice, phân tích sự kiện luồng, chuẩn hóa tin nhắn, hai hook use-chat.ts, use-stream-chat.ts và các component giao diện.

Lý do chọn ​

Chưa có ghi chép về lý do chọn Socket.IO hay cách đọc luồng bằng fetch thay cho EventSource. Điều có thể quan sát: EventSource không gửi được thân POST và header Authorization, còn cách hiện tại thì gửi được cả hai. Xem Các quyết định công nghệ.

Source code liên quan ​

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