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ớp | Thư mục | Trách nhiệm |
|---|---|---|
| Trang và layout | src/app/ | Route, layout, metadata, lấy dữ liệu ban đầu trên server |
| Giao diện | src/components/ | Hiển thị và tương tác; ui/ là các thành phần nền kiểu shadcn/ui |
| Hook | src/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ầng | src/lib/ | Axios, Redux store, Socket.IO, CASL |
| Dùng chung | src/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:
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
jobs/page.tsx(Server Component) đọc tham số tìm kiếm và gọifetchPublicJobSearchđể lấy dữ liệu ban đầu.- Nó truyền dữ liệu đó xuống
jobs-page-client.tsx(Client Component). - Phần giao diện dùng hook
use-job-list.tsđể quản lý bộ lọc và phân trang. - Hook gọi
useSearchJobsQueryđược khai báo trongjob.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. - Endpoint dùng chung
baseApitrongsrc/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ới | src/app/[locale]/<nhóm>/<tên>/page.tsx |
| Một thành phần giao diện của một miền | src/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 API | src/features/<miền>/redux/<miền>.api.ts |
| Schema kiểm tra dữ liệu | src/features/<miền>/schemas/ |
| Logic dùng lại giữa nhiều thành phần | src/hooks/ |
| Hằng số hoặc kiểu dùng chung nhiều miền | src/shared/ |
Source code liên quan
src/app/[locale]/(main)/jobs/page.tsx: lớp trang, lấy dữ liệu ban đầusrc/features/job/hooks/use-job-list.ts: lớp hooksrc/features/job/redux/job.api.ts: lớp module nghiệp vụsrc/lib/redux/api.ts:baseApidùng chungsrc/lib/utils/public-content.ts: fetch phía server
