Skip to content

Phân quyền ​

Phía frontend, quyền được dùng để quyết định hiển thị gì và chuyển người dùng đi đâu: ẩn mục menu, hiện thông báo từ chối, chuyển hướng khỏi trang không phù hợp. Đây là lớp trải nghiệm người dùng, không phải ranh giới bảo mật; việc từ chối truy cập dữ liệu thật phải do backend thực hiện, và frontend chỉ phản ánh phản hồi 403 bằng thông báo.

Ba vai trò ​

Định nghĩa trong src/shared/constants/role-values.ts:

Hằng sốGiá trị chuỗiTrang mặc định sau đăng nhập
SUPER_ADMINSUPER ADMIN/admin
HRHR/admin/resumes
NORMAL_USERNORMAL USER/

Người chưa đăng nhập (khách) không có vai trò. Hàm isAdminRole coi cả SUPER ADMIN và HR là có quyền vào khu quản trị; đây là điều kiện của AdminRoute.

CASL: bảng quyền theo vai trò ​

src/lib/casl/ability.ts dùng thư viện CASL. Quyền là cặp hành động (manage, create, read, update, delete, approve) và đối tượng (Job, Company, Resume, User, CvProfile, Subscriber, Chat, File, Notification, Statistic, all). Hàm defineAbilityFor(roleName) trả về bộ quyền:

Đối tượngSUPER ADMINHRNORMAL USER
Tất cảmanage
Jobtạo, đọc, sửa, xóađọc
Companyđọc, sửađọc
Resumeđọc, sửatạo, đọc
Statisticđọc
Chat, CvProfile, Subscriber, Notification, Filemanagemanage
Userkhông cókhông có

Vai trò không khớp, kể cả khách, nhận bộ quyền rỗng. Chuỗi tên vai trò trong ability.ts được viết thẳng ("SUPER ADMIN", "HR", "NORMAL USER"), không dùng hằng số ROLES. Hành động approve được khai báo nhưng bảng trên không cấp cho vai trò nào ngoài manage của SUPER ADMIN.

CaslProvider ở layout gốc đọc vai trò từ Redux, tính lại bộ quyền khi vai trò đổi và cấp qua context. Thành phần lấy bộ quyền bằng useAbility().

Cách áp dụng trong giao diện ​

Công cụViệc làmVí dụ dùng
Thành phần AccessHiện nội dung nếu ability.can(action, subject); nếu không thì ẩn (hideChildren), hoặc hiện khung "Truy cập bị từ chối"Nút tạo, sửa, xóa trong các trang admin/*; bảng hồ sơ và bảng người dùng bọc cả bảng bằng quyền read
Hook usePermissionCheckcheckPermission, canAccessModule, filterNavigationuseFilteredNavigation lọc menu quản trị theo quyền read, dùng ở thanh bên và menu di động
ADMIN_NAVIGATIONMỗi mục menu có subjectStatistic, User, Company, Job, Resume

Do bảng quyền, HR không có quyền đọc User nên mục "Users" bị lọc khỏi menu của HR, trong khi SUPER ADMIN thấy đủ năm mục.

Guard theo route ​

Khác với CASL (quyết định theo đối tượng), các guard quyết định theo vai trò để chặn cả một nhóm trang:

  • AdminRoute: cho SUPER ADMIN và HR, nhóm (dashboard).
  • HrRoute: chỉ cho HR, nhóm (hr-dashboard); SUPER ADMIN bị chuyển về /admin.
  • Nhóm (auth): chuyển người đã đăng nhập về trang mặc định.

Bảng đầy đủ ở Routing và layout. Các trang /profile và /profile/cv-preview không có guard ở lớp frontend.

Giới hạn cần nhớ ​

  • Mọi kiểm tra ở đây chạy trong trình duyệt dựa trên vai trò lưu trong state (một phần được Redux Persist lưu lại). Người dùng có thể sửa state cục bộ; chỉ phản hồi từ backend mới có giá trị ràng buộc.
  • Khi backend từ chối bằng 403, middleware của store hiện toast lỗi, xem Giao tiếp API.
  • Bảng quyền ở frontend và quy tắc ở backend là hai bản riêng; khi đổi quyền cần cập nhật cả hai.

Source code liên quan ​

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