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

Vai trò người dùng và quyền truy cập

Tài liệu này mô tả ba vai trò của DevLink và quyền thực tế của từng vai trò. Dữ liệu lấy từ guard, decorator và service, không sao chép từ README.

Ba vai trò​

Vai trò là enum ERole trong role.enum.ts, lưu ở users.role:

Vai tròGiá trịAi dùng
Ứng viênNORMAL USERNgười tìm việc
Nhà tuyển dụngHRNhân sự của một công ty, gắn với công ty qua users.company
Quản trị viênSUPER ADMINVận hành hệ thống

Đăng ký công khai và đăng nhập Google lần đầu luôn tạo tài khoản NORMAL USER (users.service.ts gán cứng ERole.NORMAL_USER ở cả hai luồng). HR và quản trị viên do quản trị viên tạo qua POST /api/v1/users.

Cơ chế phân quyền thực tế​

Có ba lớp, theo thứ tự:

  1. Đăng nhập (JwtAuthGuard): mọi route cần JWT trừ khi gắn @Public(). @OptionalAuth() cho phép khách nhưng nhận biết người dùng nếu có token. Lỗi trả 401 với thông báo "Token không hợp lệ hoặc đã hết hạn" (jwt-auth.guard.ts).
  2. Vai trò (RolesGuard): nếu route có @Roles(...) thì user.role phải nằm trong danh sách, ngược lại bị từ chối. Route không có @Roles thì cho qua (roles.guard.ts).
  3. Sở hữu (service): nhiều quy tắc nằm trong service, ví dụ HR chỉ sửa công ty và hồ sơ của công ty mình.

Known Limitation: CASL được định nghĩa nhưng không thực thi​

casl-ability.factory.ts mô tả ma trận quyền chi tiết (ví dụ HR CREATE/READ/UPDATE/DELETE trên Job), và có PoliciesGuard cùng decorator @CheckPolicies. Nhưng:

  • không controller nào dùng @CheckPolicies (grep toàn src/ cho kết quả rỗng ngoài src/casl/),
  • PoliciesGuard và CaslAbilityFactory không được tham chiếu ở đâu ngoài src/casl/,
  • guard toàn cục chỉ gồm JwtAuthGuard và RolesGuard (app.setup.ts).

Vì vậy ma trận CASL không ảnh hưởng đến quyền thực tế hiện tại. Quyền thật đến từ @Roles và kiểm tra trong service. AGENTS.md hướng dẫn dùng @CheckPolicies(), nhưng code hiện không làm vậy. Hai nguồn này có thể lệch nhau mà không ai phát hiện, vì CASL không được kiểm thử bởi chính hành vi của route.

Ma trận quyền theo nhóm route​

Rút từ decorator của 116 route. Có nghĩa là được phép, Một phần nghĩa là có thêm điều kiện sở hữu ở service. Chi tiết từng route nằm ở 05-api/endpoints/ (Phase 3).

NhómKháchỨng viênHRQuản trị viên
Đăng ký, đăng nhập, quên mật khẩu, làm mới tokenCó———
Hồ sơ tài khoản, phiên, đổi mật khẩu, xóa tài khoảnKhôngCóCóCó
Xem tin tuyển dụng (GET /jobs)Có (tin công khai)CóCó (tin công ty mình, mọi trạng thái)Có (tất cả)
Đăng, sửa, xóa tinKhôngKhôngMột phần (tin công ty mình)Có
Duyệt tin (PATCH /jobs/:id/approve)KhôngKhôngKhôngCó
Xem công tyCóCóCóCó
Tạo, xóa công tyKhôngKhôngKhôngCó
Sửa công tyKhôngKhôngMột phần (công ty mình)Có
Nộp hồ sơ (cv-online, upload-cv)KhôngCóCóCó
Quản lý hồ sơ ứng tuyển (/resumes CRUD)KhôngKhôngMột phần (hồ sơ công ty mình)Có
Xem phân tích hồ sơ (/resumes/:id/analysis)KhôngMột phần (hồ sơ của mình)Không (chỉ chủ hồ sơ hoặc quản trị viên)Có
CV trực tuyến của mình (/cv-profiles/me)KhôngCóCóCó
Chat AIKhôngCó (30 lượt/ngày)Có (100 lượt/ngày)Có (không giới hạn)
Thống kê quản trịKhôngKhôngKhôngCó
Thống kê HR (/statistics/hr-dashboard)KhôngKhôngCóKhông (route chỉ cho HR)
Quản lý người dùng, kỹ năng, nguồn tinKhôngKhôngKhôngCó
Đăng ký nhận gợi ý, lưu tin, theo dõi công ty, thông báoKhôngCóCóCó
Tìm kiếm hợp nhất (/job-search)CóCóCóCó
Upload file (avatar, cv, resumes)KhôngCóCóCó
Upload file thư mục companyKhôngKhôngCóCó
Xóa fileKhôngKhôngCóCó

Hạn mức chat lấy từ chat.constant.ts và chính sách ở chat-quota-policies.

CV trực tuyến của người khác​

GET /api/v1/cv-profiles và GET /api/v1/cv-profiles/:id chỉ dành cho SUPER ADMIN (@Roles(ERole.SUPER_ADMIN) trong cv-profiles.controller.ts); vai trò khác nhận 403. Kiểm thử: test/tenant-authorization.e2e-spec.ts. HR chưa có route xem CV trực tuyến của ứng viên theo phạm vi công ty.

Ghi chú về xác thực​

  • Lỗi sai quyền ở một số nơi trả 400 thay vì 403, ví dụ GET /resumes/:id/analysis và GET /companies/:id của HR ném BadRequestException. Client không nên dựa vào mã 403 để nhận biết thiếu quyền.
  • Quy tắc ngày hết hạn token, cookie refresh và khóa tài khoản nằm ở 08-security (Phase 4).