Tổng quan tech stack
DevLink Frontend được xây trên Next.js 15 (App Router), React 18 và TypeScript, dùng Tailwind CSS với bộ thành phần shadcn/ui, Redux Toolkit cho state, và Jest cho kiểm thử. Trang này liệt kê công nghệ cùng phiên bản khai báo, và chỉ ra những chỗ phiên bản đang cài hoặc việc sử dụng khác với khai báo.
Nhóm tài liệu này trả lời câu hỏi vì sao và phiên bản nào. Cách các phần phối hợp với nhau nằm ở Kiến trúc.
Bảng công nghệ
Phiên bản lấy từ package.json. Dấu ^ nghĩa là cho phép cập nhật phiên bản nhỏ; không có dấu là ghim đúng phiên bản.
| Nhóm | Công nghệ | Phiên bản khai báo | Chi tiết |
|---|---|---|---|
| Framework | Next.js | ^15.4.10 | Framework |
| React, React DOM | 18.2.0 | Framework | |
| TypeScript | 5.2.2 | Framework | |
| Giao diện | Tailwind CSS | 3.3.3 | Giao diện |
| Radix UI, shadcn/ui | nhiều gói @radix-ui/* | Giao diện | |
| Lucide React | ^0.446.0 | Giao diện | |
| State | Redux Toolkit | ^2.8.2 | State |
| React Redux | 9.2.0 | State | |
| Redux Persist | ^6.0.0 | State | |
| Dữ liệu | RTK Query (trong Redux Toolkit) | như trên | Lấy dữ liệu |
| Axios | ^1.13.2 | Lấy dữ liệu | |
| Form | React Hook Form | ^7.53.0 | Form |
| Zod | ^4.0.16 | Form | |
| @hookform/resolvers | ^5.2.1 | Form | |
| Xác thực, phân quyền | @react-oauth/google | ^0.12.2 | Xác thực |
| @casl/ability | ^6.8.0 | Phân quyền | |
| Đa ngôn ngữ | next-intl | ^4.9.1 | Đa ngôn ngữ |
| Thời gian thực, AI | socket.io-client | ^4.8.3 | Thời gian thực |
| react-markdown, remark-gfm | ^10.1.0, ^4.0.1 | Thời gian thực | |
| Tài liệu | @react-pdf/renderer | ^4.3.1 | Giao diện |
| Biểu đồ | Recharts | ^2.12.7 | Giao diện |
| Kiểm thử | Jest | ^30.3.0 | Kiểm thử |
| React Testing Library | ^16.3.2 | Kiểm thử |
Node.js: file .nvmrc ghi 20.19.5, và @types/node khai báo ^20.6.2. package.json không có trường engines.
Phiên bản đang cài khác khai báo
Với các gói có dấu ^, phiên bản thực sự phụ thuộc file khóa và lần cài. Trong node_modules trên máy lúc viết (2026-11-05), một số gói đang ở phiên bản cao hơn mức tối thiểu khai báo:
| Gói | Khai báo | Đang cài |
|---|---|---|
@reduxjs/toolkit | ^2.8.2 | 2.9.1 |
react-hook-form | ^7.53.0 | 7.65.0 |
recharts | ^2.12.7 | 2.15.4 |
eslint | ^8.49.0 | 8.57.1 |
Chỉ file package-lock.json mới là nguồn chính thức cho phiên bản được cài bằng npm ci.
Những điểm lệch cần biết
eslint-config-nextlệch phiên bản Next.js. Khai báo^13.5.1(đang cài13.5.11) trong khi Next.js là15.4.10.- Khai báo nhưng không thấy dùng. Tại thời điểm viết, gói
ts-jestkhông đượcjest.config.jstham chiếu. - Hai bộ biểu tượng. Lucide được dùng ở 143 file;
@heroicons/reactcòn ở 5 file (chủ yếu trong các thành phần chatbot).
Lý do chọn công nghệ
Repo không có tài liệu quyết định cho phần lớn công nghệ ở trên. Trang Các quyết định công nghệ ghi riêng những gì thực sự được ghi chép và những gì chưa có.
Source code liên quan
package.json: phiên bản khai báo và lệnh npmpackage-lock.json: phiên bản được càinext.config.ts: cấu hình Next.jstsconfig.json: cấu hình TypeScript.nvmrc: phiên bản Node.js
