Skip to content

Các lớp của frontend ​

Mã nguồn trong src/ được chia thành các lớp, mỗi lớp có một trách nhiệm. Hiểu chiều phụ thuộc giữa các lớp giúp bạn biết nên đặt code mới ở đâu và tránh phụ thuộc vòng.

Các lớp và trách nhiệm ​

LớpThư mụcTrách nhiệm
Trang và layoutsrc/app/Route, layout, metadata, lấy dữ liệu ban đầu trên server
Giao diệnsrc/components/Hiển thị và tương tác; ui/ là các thành phần nền kiểu shadcn/ui
Hooksrc/hooks/Logic dùng lại cho giao diện, bọc các lời gọi API và state
Module nghiệp vụsrc/features/Endpoint RTK Query, slice Redux, schema Zod của từng miền. Miền job, company, chatbot, cv-builder và profile đã chuyển sang feature-first: có thêm components/, hooks/, và config/, utils/, lib/ khi cần
Hạ tầngsrc/lib/Axios, Redux store, Socket.IO, CASL
Dùng chungsrc/shared/Hằng số, kiểu dữ liệu, cấu hình, dữ liệu tĩnh
Đa ngôn ngữsrc/i18n/, src/locales/Cấu hình next-intl và bản dịch

Chiều phụ thuộc ​

Theo hướng chung, lớp phía trên gọi lớp phía dưới:

text
app  →  components  →  hooks  →  features  →  lib  →  shared

Đây là xu hướng quan sát được, không phải quy tắc được công cụ cưỡng chế. Có ngoại lệ, ví dụ src/app/ gọi thẳng src/lib/utils/public-content.ts để lấy dữ liệu trên server mà không đi qua hook.

ESLint (import/no-restricted-paths trong eslint.config.mjs) cưỡng chế một phần: shared/ không import lớp trên; redux/, schemas/, config/, utils/, lib/ của mỗi feature không import components, hooks, contexts hay app; components/ và hooks/ của feature được dùng UI chung nhưng không import app.

Một luồng làm ví dụ: danh sách việc làm ​

  1. jobs/page.tsx (Server Component) đọc tham số tìm kiếm và gọi fetchPublicJobSearch để lấy dữ liệu ban đầu.
  2. Nó truyền dữ liệu đó xuống jobs-page-client.tsx (Client Component).
  3. Phần giao diện dùng hook use-job-list.ts để quản lý bộ lọc và phân trang.
  4. Hook gọi useSearchJobsQuery được khai báo trong job.api.ts. Khi bộ lọc vẫn trùng với trạng thái ban đầu, hook bỏ qua lời gọi và dùng dữ liệu từ server.
  5. Endpoint dùng chung baseApi trong src/lib/redux/api.ts, gửi request qua Axios.

Luồng này minh họa vì sao một chủ đề thường đi qua nhiều lớp. Sơ đồ trình tự ở Luồng dữ liệu.

Nơi đặt code mới ​

Bạn cần thêmĐặt ở
Một trang mớisrc/app/[locale]/<nhóm>/<tên>/page.tsx
Một thành phần giao diện của một miềnsrc/features/<miền>/components/ nếu miền đã chuyển sang feature-first (hiện có job, company, chatbot, cv-builder, profile), nếu chưa thì src/components/<miền>/
Một endpoint APIsrc/features/<miền>/redux/<miền>.api.ts
Schema kiểm tra dữ liệusrc/features/<miền>/schemas/
Logic dùng lại giữa nhiều thành phầnsrc/hooks/
Hằng số hoặc kiểu dùng chung nhiều miềnsrc/shared/

Source code liên quan ​

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