Skip to content

Bối cảnh hệ thống ​

Trang này liệt kê những hệ thống mà DevLink Frontend trực tiếp giao tiếp, và địa chỉ hoặc biến cấu hình mà code đang dùng cho từng hệ thống. Đọc trang này để biết cần chạy gì khác ngoài frontend thì ứng dụng mới hoạt động đầy đủ.

Sơ đồ tương ứng: Sơ đồ bối cảnh hệ thống.

Các hệ thống liên quan ​

Hệ thốngFrontend dùng đểCách kết nối trong code
Backend API (it-job-portal-be)Toàn bộ dữ liệu nghiệp vụ: việc làm, công ty, hồ sơ, người dùng, chatAPI_BASE_URL là hằng số http://localhost:8081/api/v1
Kênh thông báo Socket.IONhận thông báo theo thời gian thựcio(API_BASE_URL_IMAGE + "/notifications"), gửi kèm token
Chat AI qua SSENhận câu trả lời chatbot theo từng đoạnfetch tới API_BASE_URL + "/chat/message/stream"
GoogleĐăng nhập bằng nút Google, ảnh đại diệnNEXT_PUBLIC_GOOGLE_CLIENT_ID; ảnh từ lh3.googleusercontent.com
Proxy ảnh /api/proxy-imageLấy ảnh từ backend khi xuất PDF CV để tránh lỗi CORSRoute của chính Next.js, chỉ chấp nhận máy chủ trong danh sách cho phép

Frontend không gọi trực tiếp nhà cung cấp AI nào. Mọi lời gọi chat đi qua backend.

Lưu ý về địa chỉ backend ​

API_BASE_URL và API_BASE_URL_IMAGE được viết cứng là localhost:8081 trong src/shared/constants/constant.ts, không đọc từ biến môi trường. Muốn đổi backend khi triển khai, hiện phải sửa code. Đây là hiện trạng, chưa phải điều đã được cải thiện.

Biến NEXT_PUBLIC_API_URL có xuất hiện trong code nhưng chỉ dùng để mở rộng danh sách máy chủ ảnh được phép của proxy ảnh, không dùng làm địa chỉ API. Xem Biến môi trường.

Frontend không làm gì ​

  • Không lưu trữ dữ liệu nghiệp vụ. Backend dùng MongoDB với Mongoose; schema được mô tả ở tài liệu của repo backend.
  • Không tự quyết định quyền truy cập dữ liệu. Phần kiểm tra quyền ở frontend chỉ ẩn hoặc chuyển hướng giao diện, xem Phân quyền.

Source code liên quan ​

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