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

Module Users

Overview​

Quản lý tài khoản người dùng cho quản trị viên (CRUD, khóa, mở khóa, xóa hàng loạt) và các tùy chọn cá nhân của ứng viên (lưu tin, theo dõi công ty).

Responsibilities​

  • CRUD người dùng, chỉ SUPER ADMIN.
  • Khóa và mở khóa tài khoản, kèm vô hiệu mọi phiên của người bị khóa.
  • Lưu tin và theo dõi công ty cho người dùng đang đăng nhập.
  • Tạo tài khoản khi đăng ký (băm mật khẩu bcryptjs, gán NORMAL USER).

Architecture​

Thành phầnFile
Controller (14 route, /api/v1/users)users.controller.ts
Service chínhusers.service.ts
Quản lý tài khoản (khóa, lên lịch xóa)user-account.service.ts
Tùy chọn cá nhân (lưu tin, theo dõi)user-preferences.service.ts
Truy cập dữ liệuuser.repository.ts

Dependencies​

users import sessions và profile-identity-sync. auth, chat, statistics import users. Xem module-dependencies.

Business Rules​

  • Mật khẩu băm bằng bcryptjs với salt 10 (users.service.ts).
  • Không tự khóa tài khoản của chính mình; không khóa tài khoản đã khóa; không mở khóa tài khoản chưa khóa.
  • Khóa tài khoản gọi deactivateAllUserSessions, nên người bị khóa mất mọi phiên ngay.
  • Lọc danh sách cho phép name, email, company.name (tập TEXT_FILTER_FIELDS).
  • Lưu tin, theo dõi công ty: mảng savedJobs, companyFollowed trong document users.

Data Model​

Collection users. Có snapshot công ty nhúng (company).

API​

14 route: tạo, liệt kê, xem, sửa, khóa, mở khóa, xóa, xóa hàng loạt (chỉ SUPER ADMIN); save-job, saved-jobs, follow-company, following-companies (người dùng đăng nhập). Chi tiết ở 05-api/endpoints/users.md (Phase 3).

Error Handling​

Tình huốngLỗi
Khóa chính mình400 "You cannot lock your own account"
Khóa tài khoản đã khóa400
Người dùng không tồn tại404

Known Limitation​

  • Dữ liệu tin đã lưu và công ty theo dõi là mảng _id, không có ràng buộc: tin hoặc công ty bị xóa mềm vẫn nằm trong mảng. Cách GET saved-jobs xử lý: Chưa xác minh.
  • Xóa người dùng không tự dọn dữ liệu liên quan, xem collection-relationships.

Testing​

5 file test trong src/users/. Chưa ghi nhận độ bao phủ.

Source References​

src/users/, src/profile-identity/.