Chuyển tới nội dung chính

Users (users)

Lưu tài khoản của cả ba vai trò (NORMAL USER, HR, SUPER ADMIN). Đây là collection trung tâm: hầu hết collection khác tham chiếu tới _id của nó.

  • Nguồn schema: user.schema.ts
  • Phân loại dữ liệu: có dữ liệu cá nhân (tên, email, ảnh đại diện) và thông tin xác thực (mật khẩu đã băm, googleId).
  • Soft-delete: có. Xem xóa mềm.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
nameStringCó—trimTên hiển thị của người dùng
emailStringCó—lowercase; trimEmail đăng nhập, luôn chữ thường. Duy nhất giữa các tài khoản chưa xóa mềm
passwordStringKhông——Mật khẩu đã băm bằng bcryptjs (salt 10). Trống với tài khoản Google
authProviderStringKhông"local"enum: google, localCách đăng ký: local (email và mật khẩu) hoặc google
googleIdStringKhông—unique; sparseMã người dùng của Google, chỉ có khi đăng nhập Google
avatarStringKhông—trimĐường dẫn ảnh đại diện
isActiveBooleanKhôngfalse—true sau khi xác thực OTP. Tài khoản false chưa xác thực và có thể bị TTL xóa
isLockedBooleanKhôngfalse—Quản trị viên đã khóa tài khoản
lockReasonStringKhông——Lý do khóa
lockedByMixedKhông——Người khóa, dạng { _id, email }
lockedAtDateKhông——Thời điểm khóa
codeExpiredDateKhông——Hạn mã xác thực cũ. Không còn được dùng (xem Lưu ý)
verificationExpiresDateKhông——Hạn xác thực tài khoản mới. TTL index xóa tài khoản chưa xác thực khi quá hạn
companySubdocKhông——Snapshot công ty của HR. Embedded, không phải tham chiếu
company._idObjectIdCó——_id của công ty trong collection companies
company.nameStringCó—trimTên công ty tại thời điểm lưu snapshot
company.logoStringKhôngnulltrimĐường dẫn logo tại thời điểm lưu snapshot
roleStringCó—enum: SUPER ADMIN, HR, NORMAL USERVai trò: SUPER ADMIN, HR hoặc NORMAL USER
savedJobs[ObjectId]Không[]ref: JobDanh sách tin tuyển dụng đã lưu
companyFollowed[ObjectId]Không[]ref: CompanyDanh sách công ty đang theo dõi
createdByMixedKhông——Người tạo bản ghi, dạng { _id, email }
updatedByMixedKhông——Người sửa gần nhất, dạng { _id, email }
deletedByMixedKhông——Người xóa mềm, dạng { _id, email }
createdAtDateKhông——Thời điểm tạo, do timestamps
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
scheduledDeletionAtDateKhông——Thời điểm tài khoản sẽ bị xóa sau khi người dùng yêu cầu. Trống nếu không có yêu cầu
isDeletedBooleanKhông——Cờ xóa mềm. true nghĩa là tài khoản đã bị xóa khỏi hệ thống nhưng giữ lại bản ghi để truy vết
deletedAtDateKhông——Thời điểm xóa mềm

Các field createdBy, updatedBy, deletedBy, lockedBy khai báo type: Object nên là Mixed: Mongoose không kiểm tra cấu trúc. Theo quy ước trong code, giá trị là { _id, email } của người thực hiện.

Indexes​

KeysThuộc tínhMục đích
{ googleId: 1 }unique, sparseTra cứu đăng nhập Google. Unique và sparse nên chỉ áp dụng cho tài khoản có googleId
{ role: 1 }—Lọc người dùng theo vai trò
{ email: 1 }unique, partial {"isDeleted":false}Đảm bảo email duy nhất giữa các tài khoản chưa xóa mềm
{ email: 1, isDeleted: 1 }—Tra cứu theo email kèm điều kiện xóa mềm
{ companyFollowed: 1 }—Tìm người theo dõi một công ty
{ savedJobs: 1 }—Tìm người đã lưu một tin
{ googleId: 1, isDeleted: 1 }sparseTra cứu Google kèm điều kiện xóa mềm
{ verificationExpires: 1 }TTL 0s, partial {"isActive":false}TTL tự xóa tài khoản chưa xác thực

Index { email: 1 } kết hợp partialFilterExpression: { isDeleted: false } cho phép đăng ký lại bằng email của một tài khoản đã xóa mềm, nhưng không cho hai tài khoản chưa xóa dùng cùng email.

Quan hệ​

FieldLoạiĐích
companyEmbedded (CompanySnapshot)Bản sao _id, name, logo của công ty mà HR thuộc về. Không tự cập nhật khi companies đổi
savedJobsReference (mảng ObjectId)jobs
companyFollowedReference (mảng ObjectId)companies

MongoDB không ràng buộc các tham chiếu này. Code chịu trách nhiệm giữ nhất quán.

Ví dụ document​

Dữ liệu giả, giá trị password là chuỗi băm minh họa.

{
"_id": "665f1a2b3c4d5e6f70819201",
"name": "Nguyen Van A",
"email": "candidate@example.com",
"password": "$2a$10$<bcrypt-hash>",
"authProvider": "local",
"isActive": true,
"isLocked": false,
"role": "NORMAL USER",
"savedJobs": ["665f1a2b3c4d5e6f70819301"],
"companyFollowed": [],
"scheduledDeletionAt": null,
"isDeleted": false,
"deletedAt": null,
"createdAt": "2026-10-01T03:00:00.000Z",
"updatedAt": "2026-10-01T03:05:00.000Z"
}

Vòng đời​

  • Tạo tài khoản: verificationExpires được đặt 15 phút sau thời điểm đăng ký (users.service.ts). TTL index chỉ áp dụng cho tài khoản có isActive: false, nên tài khoản đã xác thực không bị xóa.
  • Xóa tài khoản: đặt scheduledDeletionAt sau 30 ngày chờ (auth-account-deletion.service.ts). Việc xóa thật do hàng đợi account-deletion thực hiện bằng xóa mềm.

Lưu ý​

  • Known Limitation: codeExpired có trong schema nhưng không được dùng ở logic nghiệp vụ nào. Chỉ xuất hiện trong projection của account-deletion-queue.processor.ts. Có vẻ là phần còn lại của luồng OTP cũ. Chưa kiểm tra lịch sử git.
  • Known Limitation: company là snapshot, không tự đồng bộ khi công ty đổi tên hay logo. Xem companies.
  • Migration: thêm field mới không cần migration vì Mongoose trả undefined cho field thiếu. Thêm unique index lên collection đã có dữ liệu trùng sẽ thất bại.