Quản lý Vai trò & Phân quyền

Menu: Doanh nghiệp → Quản lý vai trò
Route: /role-management
Quyền yêu cầu: roles.view, roles.edit
Phiên bản: v1.0 — 2026-05-08

1. Giới thiệu

Trang Quản lý Vai trò cho phép tạo và quản lý hệ thống vai trò tùy chỉnh (Custom Roles) với ma trận phân quyền chi tiết theo từng tính năng. Vai trò tùy chỉnh bổ sung cho 4 vai trò cơ bản (Owner / Manager / Staff / Viewer), cho phép kiểm soát chính xác từng quyền hạn của nhân viên.

2. Điều kiện truy cập

3. Giao diện

3.1 Danh sách vai trò — Card Grid

Mỗi vai trò hiển thị dưới dạng Card với viền trái có màu:

3.2 Empty State

Khi chưa có vai trò nào, hiển thị 2 nút:

• "Tạo 3 vai trò mặc định" — Tạo sẵn 3 vai trò chuẩn từ hệ thống
• "Tạo vai trò từ đầu" — Tạo vai trò mới hoàn toàn

4. Hướng dẫn thao tác

4.1 Tạo vai trò mới

1. Nhấn "Tạo vai trò mới" (góc trên phải)
2. hộp thoại XL hiện ra, chia 2 cột:

Cột trái — Thông tin vai trò:

Cột phải — Ma trận phân quyền:

Quyền được nhóm theo module, mỗi nhóm có:

• ô tích nhóm — Chọn/bỏ tất cả quyền trong nhóm
• huy hiệu đếm — VD: 3/5 (đã chọn 3/5 quyền)
• ô tích từng quyền — Bật/tắt từng quyền riêng lẻ
• Mỗi quyền có: Tên hiển thị + Mô tả

Nút "Chọn tất cả" / "Bỏ chọn tất cả" để thao tác nhanh.

1. Nhấn "Tạo vai trò" → thông báo nhanh thành công

4.2 Chỉnh sửa vai trò

1. Nhấn icon ✏️ Sửa trên card vai trò
2. hộp thoại mở ra với dữ liệu hiện tại
3. Chỉnh sửa thông tin hoặc quyền
4. Nhấn "Cập nhật" → thông báo nhanh thành công

4.3 Xóa vai trò

1. Nhấn icon 🗑️ Xóa trên card vai trò
2. Xác nhận dialog:

   "Bạn có chắc chắn muốn xóa vai trò "[Tên]"?
   Thành viên đang dùng vai trò này sẽ được chuyển sang vai trò mặc định."

3. Nhấn OK → Vai trò bị xóa, thành viên chuyển sang vai trò mặc định

[!WARNING]

• Không thể xóa vai trò hệ thống (huy hiệu "Hệ thống")
• Thành viên đang sử dụng vai trò bị xóa sẽ tự động chuyển sang vai trò mặc định

4.4 Tạo vai trò mặc định

1. Nhấn "Tạo 3 vai trò mặc định" (chỉ hiện khi chưa có vai trò nào)
2. Hệ thống tạo 3 vai trò chuẩn với bộ quyền preset:
   • Quản lý sản xuất — Quyền sản phẩm, lô, QR
   • Nhân viên bán hàng — Quyền xem sản phẩm, quét tem
   • Người giám sát — Quyền xem báo cáo, thống kê

5. Nhóm quyền (Permission Groups)

Hệ thống phân quyền theo module:

[!TIP] Nguyên tắc Least Privilege — chỉ gán đúng quyền cần thiết cho mỗi vai trò. Tránh gán * (toàn quyền) cho vai trò không phải Owner.

6. Mối quan hệ với Quản lý Nhân viên

Vai trò tùy chỉnh → Gán cho Thành viên → Nhân viên có quyền tương ứng

• Vai trò được tạo tại trang này
• Gán vai trò cho nhân viên tại trang Quản lý nhân viên (menu ⋮ → Đổi vai trò)
• Nhân viên kế thừa quyền từ cả vai trò cơ bản + vai trò tùy chỉnh

7. Câu hỏi thường gặp (FAQ)

Cập nhật lần cuối: 2026-05-08