Skip to content

Tổng quan kiến trúc ​

DevLink Frontend là một ứng dụng Next.js 15 dùng App Router. Ứng dụng vừa render một số trang công khai trên server để phục vụ SEO, vừa chạy phần tương tác ở trình duyệt với dữ liệu lấy từ backend qua Redux Toolkit Query. Trang này giúp bạn nhìn toàn cảnh trước khi đọc từng chủ đề chi tiết.

Bức tranh chung ​

Khi một người dùng mở trang, các lớp sau cùng tham gia:

  1. Middleware (src/middleware.ts) xem địa chỉ có tiền tố ngôn ngữ chưa và điều hướng tương ứng, đồng thời sinh nonce và gửi Content Security Policy. Xem Đa ngôn ngữ và Rendering và SEO.
  2. Layout gốc (src/app/layout.tsx) bọc toàn bộ ứng dụng bằng các provider: Redux, CASL (phân quyền), Google OAuth và giao diện sáng/tối.
  3. Layout theo ngôn ngữ (src/app/[locale]/layout.tsx) thêm provider dịch thuật, Socket.IO, khởi tạo phiên đăng nhập và thông báo.
  4. Layout theo nhóm trang (ví dụ (main), (dashboard)) thêm khung giao diện và, với admin hoặc HR, thêm lớp kiểm tra quyền truy cập.
  5. Trang lấy dữ liệu theo một trong hai cách ở mục dưới.

Thứ tự lồng nhau của các provider được xác nhận trực tiếp trong hai file layout trên.

Hai đường đi của dữ liệu ​

Không phải trang nào cũng đi qua Redux. Code hiện có hai đường:

ĐườngDùng ở đâuCách hoạt động
Server fetchCác trang công khai cần SEO: trang chủ, danh sách việc làm, chi tiết việc làm, việc làm bên ngoài, danh sách và chi tiết công ty, sitemapHàm trong src/lib/utils/public-content.ts gọi fetch trên server, cache 60 giây (việc làm) hoặc 1 giờ (công ty, việc làm bên ngoài)
RTK Query + AxiosPhần tương tác ở trình duyệt: lọc, phân trang, đăng nhập, hồ sơ, CV, trang quản trịEndpoint khai báo trong src/features/*/redux/*.api.ts, đi qua Axios

Ở trang chủ và trang danh sách việc làm, hai đường này nối nhau: server lấy dữ liệu ban đầu và truyền xuống phần giao diện chạy ở trình duyệt, phần này chỉ gọi RTK Query khi người dùng đổi bộ lọc hoặc chuyển trang. Chi tiết ở Giao tiếp API và Server Component và Client Component.

Các trang trong nhóm kiến trúc ​

TrangNội dung
Bối cảnh hệ thốngFrontend nói chuyện với những hệ thống nào
Các lớp của frontendTrách nhiệm của từng thư mục và chiều phụ thuộc
Cấu trúc thư mụcCây thư mục src/ thực tế
Routing và layoutBảng route, nhóm route, guard
Server Component và Client ComponentKhi nào dùng loại nào
Rendering và SEOMetadata, sitemap, robots, noindex
Quản lý stateRedux, RTK Query, phần được lưu lại
Giao tiếp APIĐường đi của một request
Xác thựcToken, làm mới phiên, Google
Phân quyềnVai trò, CASL, guard
Giao tiếp thời gian thựcSocket.IO và SSE
Đa ngôn ngữnext-intl và useI18n
Chiến lược cacheCác lớp cache

Sơ đồ nằm trong thư mục diagrams/: bối cảnh hệ thống, container, component và luồng dữ liệu.

Điều cần nhớ ​

  • Frontend không có database. Dữ liệu nằm ở backend it-job-portal-be, dùng MongoDB với Mongoose. Tài liệu này không mô tả schema database.
  • Lý do chọn từng công nghệ nằm ở nhóm Tech stack, không lặp lại ở đây.

Source code liên quan ​

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