Skip to content

Model User ​

Trang này mô tả dữ liệu người dùng ở frontend: người đang đăng nhập (trong Redux) và bản ghi người dùng trong màn hình quản trị. Dành cho developer cần biết field nào có ở đâu và vì sao có nhiều tên cho cùng một thứ.

Vì sao có nhiều dạng ​

Cùng một người dùng được frontend nhìn ở ba góc khác nhau:

  • Khi đăng nhập, backend trả một bản rút gọn (đủ để hiển thị menu và phân quyền giao diện).
  • Màn hình quản trị cần bản đầy đủ có trạng thái khóa, người tạo, danh sách việc đã lưu.
  • Form tạo và sửa chỉ cần vài field có kiểm tra.

Vì vậy code có nhiều định nghĩa chứ không phải một. Bảng dưới chỉ ra định nghĩa nào dùng ở đâu.

DạngĐịnh nghĩaDùng ở
Người dùng đang đăng nhậpUserInfo trong state auth, dựng từ LoginResponse['user'] (auth.schema.ts)Redux, header, phân quyền giao diện
Phản hồi GET /auth/meAccountResponse (auth.schema.ts)AuthInitializer, trang hồ sơ
Bản ghi người dùng quản trịUser suy ra từ UserEntitySchema (user.schema.ts)Trang quản trị người dùng, getUser, getUsers
Dữ liệu formCreateUserFormData, UpdateUserFormData (user.schema.ts)Form tạo và sửa người dùng
Interface cũIUser, IAccount (src/shared/types/backend.d.ts)Xem mục "Điểm chưa đồng nhất"

Type chính: UserInfo cho người đang đăng nhập, User cho bản ghi quản trị.

Người dùng đang đăng nhập (UserInfo) ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
_idstringCóĐịnh danh người dùng
emailstringCóEmail đăng nhập
namestringCóTên hiển thị
avatarstring | nullCóẢnh đại diện; slice đặt null nếu thiếu
role'SUPER ADMIN' | 'HR' | 'NORMAL USER'CóVai trò, quyết định giao diện và trang mặc định
authProviderstringKhôngCách tạo tài khoản, ví dụ đăng nhập Google
hasPasswordbooleanKhôngĐã có mật khẩu chưa; tài khoản Google chưa đặt mật khẩu dùng set-password
scheduledDeletionAtstring | nullKhôngThời điểm tài khoản sẽ bị xóa nếu đang chờ xóa
savedJobIdsstring[]KhôngViệc đã lưu (tên chuẩn)
savedJobs, jobFavoritesstring[]KhôngCùng nội dung với savedJobIds, giữ vì tên cũ
companyFollowedstring[]KhôngCông ty đang theo dõi

Slice auth hợp nhất ba field việc đã lưu bằng normalizeSavedJobIds rồi ghi cả ba cùng giá trị, để màn hình dùng tên nào cũng thấy dữ liệu giống nhau. Redux Persist chỉ lưu user và isAuthenticated.

Bản ghi người dùng quản trị (User) ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
_idstringCóĐịnh danh
namestringCóTên, tối thiểu 2 ký tự
emailstringCóEmail, phải đúng định dạng
role'SUPER ADMIN' | 'HR' | 'NORMAL USER'CóVai trò
company{ _id?, name?, logo? }KhôngCông ty; bắt buộc khi role là HR ở form
passwordstringCó khi tạoChỉ có ở form tạo, tối thiểu 6 ký tự; khi sửa có thể để trống
savedJobs, jobFavoritesstring[]KhôngMặc định []
companyFollowingstring[]KhôngCông ty đang theo dõi, mặc định []
isLockedbooleanKhôngTài khoản bị khóa, mặc định false
lockReason, lockedAtstringKhôngLý do và thời điểm khóa
lockedBy, createdBy, updatedBy{ _id, email }KhôngNgười thực hiện
createdAt, updatedAtstringKhôngThời điểm tạo và cập nhật

Ví dụ JSON ​

Dữ liệu giả, theo UserEntitySchema:

json
{
  "_id": "665f1a2b3c4d5e6f70819301",
  "name": "Nguyen Van A",
  "email": "a@example.com",
  "role": "HR",
  "company": { "_id": "665f1a2b3c4d5e6f70819302", "name": "Công ty Mẫu" },
  "savedJobs": [],
  "jobFavorites": [],
  "companyFollowing": [],
  "isLocked": false,
  "createdAt": "2026-01-01T00:00:00.000Z"
}

Điểm chưa đồng nhất ​

Vấn đềChi tiết
Hai tên cho công ty đang theo dõicompanyFollowing ở User, companyFollowed ở người đang đăng nhập
Ba tên cho việc đã lưusavedJobIds, savedJobs, jobFavorites; chỉ người đang đăng nhập được hợp nhất
IUser khác UserIUser bắt buộc age, gender, address, còn UserEntitySchema không có ba field này
IAccount có permissionsIAccount khai báo mảng permissions, nhưng LoginResponseSchema không có field này; phân quyền giao diện cố định trong ability.ts
Độ dài mật khẩuForm quản trị yêu cầu tối thiểu 6 ký tự, form đăng ký tối thiểu 8 ký tự cùng các quy tắc chữ hoa, chữ thường, số, ký tự đặc biệt
Luật mật khẩu và backendDTO đăng ký của backend chỉ kiểm tra không rỗng; quy tắc mạnh hơn chỉ nằm ở form

Chưa có ghi chép về lý do của các khác biệt này.

Nơi dùng ​

Đăng nhập và phiên: Xác thực. Danh sách và thao tác người dùng quản trị: trang endpoint users (chưa viết).

Source code liên quan ​

Collection ở backend: users.

Đọc tiếp: Phân quyền, Endpoint Auth, Tham chiếu dữ liệu backend.

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