Quản lý Nhân viên
Menu: Doanh nghiệp → Quản lý nhân viên
Route:/staff-management
Quyền yêu cầu:staff.view
Phiên bản: v1.0 — 2026-05-08
1. Giới thiệu
Trang Quản lý Nhân viên cho phép chủ doanh nghiệp và quản lý thêm, mời, phân quyền và giám sát thành viên trong tổ chức. Hệ thống hỗ trợ nhiều phương thức thêm nhân viên: mời qua email, thêm trực tiếp, và mã mời 6 ký tự. Dữ liệu tự cập nhật theo thời gian thực khi có nhân viên mới gia nhập.
2. Điều kiện truy cập
| Điều kiện | Chi tiết |
|---|---|
| Quyền xem | staff.view (hoặc * — Owner) |
| Quyền thao tác | staff.edit, staff.invite, staff.remove |
| Trạng thái tổ chức | Đã duyệt |
[!NOTE]
Nếu không có quyềnstaff.view, hệ thống hiển thị cảnh báo "Truy cập bị từ chối".
3. Giao diện
3.1 Thẻ thống kê — 4 KPI Cards
| Thẻ | Icon | Mô tả |
|---|---|---|
| 🔵 Tổng số | ri-team-line |
Tổng thành viên trong tổ chức |
| 🟢 Hoạt động | ri-checkbox-circle-line |
Thành viên đang hoạt động |
| 🔷 Đã mời | ri-mail-send-line |
Lời mời đang chờ chấp nhận |
| 🟡 Tạm khóa | ri-lock-line |
Thành viên bị tạm đình chỉ |
Số liệu có hiệu ứng CountUp animation khi trang load.
3.2 Thanh công cụ
| Thành phần | Mô tả |
|---|---|
| Ô tìm kiếm | Tìm theo tên, email |
| Lọc vai trò | danh sách thả xuống: Tất cả / Chủ sở hữu / Quản lý / Nhân viên / Người xem |
| Lọc trạng thái | danh sách thả xuống: Tất cả / Đã mời / Hoạt động / Tạm khóa / Đã rời / Đã từ chối |
| Nút "Nhập mã" | Nhập mã mời 6 ký tự để tham gia tổ chức khác |
| Nút "Tạo mã mời" | Tạo mã mời mới (cần quyền staff.invite) |
| Nút "Mời nhân viên" | Mời qua email hoặc thêm trực tiếp |
3.3 Bảng thành viên
| Cột | Mô tả |
|---|---|
| Họ tên | Tên đầy đủ, email (sub-text), avatar |
| Vai trò cơ bản | huy hiệu màu: Chủ sở hữu (đỏ), Quản lý (vàng), Nhân viên (xanh), Người xem (xám) |
| Vai trò tùy chỉnh | huy hiệu màu custom (nếu có) — từ trang Quản lý vai trò |
| Phòng ban / Chức vụ | Thông tin bổ sung |
| Trạng thái | huy hiệu: Đã mời / Hoạt động / Tạm khóa / Đã rời / Đã từ chối |
| Ngày gia nhập | Thời gian chấp nhận lời mời |
| Hành động | danh sách thả xuống: Sửa / Đổi vai trò / Vô hiệu / Kích hoạt lại / Gửi lại lời mời / Xóa |
4. Hướng dẫn thao tác
4.1 Mời nhân viên qua Email
- Nhấn nút "Mời nhân viên" (góc trên phải)
- hộp thoại hiện ra, điền thông tin:
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| ✅ | Email người được mời | |
| Họ tên | Tên hiển thị | |
| Số điện thoại | SĐT liên lạc | |
| Vai trò | ✅ | Chủ sở hữu / Quản lý / Nhân viên / Người xem |
| Phòng ban | VD: Phòng KCS | |
| Chức vụ | VD: Trưởng phòng | |
| Ghi chú | Ghi chú nội bộ |
- Nhấn "Lưu" → Email mời được gửi
- Thành viên hiển thị với trạng thái "Đã mời" cho đến khi chấp nhận
4.2 Tạo mã mời (Invite Code)
- Nhấn nút "Tạo mã mời" (nút xanh lá)
- Hệ thống tạo mã 6 ký tự (VD:
ABC123) - hộp thoại hiển thị:
- Mã mời: 6 ký tự viết hoa
- Hạn sử dụng: Thời gian hết hạn
- Số lần dùng: Tối đa / Đã dùng
- Tên tổ chức: Tên DN được gắn
- Nhấn "Sao chép" → Sao chép mã vào clipboard
- Gửi mã cho nhân viên → Nhân viên nhập mã tại nút "Nhập mã"
[!TIP]
Mã mời là cách nhanh nhất để thêm nhiều nhân viên cùng lúc mà không cần biết email từng người.
4.3 Nhập mã mời (Join by Code)
- Nhấn nút "Nhập mã" (nút xanh dương)
- Nhập mã 6 ký tự → Nhấn "Tham gia"
- Nếu mã hợp lệ → Tự động gia nhập tổ chức → Trang reload
4.4 Đổi vai trò nhanh
- Nhấn menu ⋮ trên hàng thành viên → "Đổi vai trò"
- Chọn:
- Vai trò cơ bản: Quản lý / Nhân viên / Người xem
- Vai trò tùy chỉnh: Chọn từ danh sách vai trò đã tạo (xem Quản lý vai trò)
[!WARNING]
Không thể đổi vai trò của chính mình. Không thể hạ cấp Owner thành vai trò khác.
4.5 Vô hiệu hóa / Kích hoạt lại
Vô hiệu hóa (Suspend):
- Menu ⋮ → "Vô hiệu hóa" → Xác nhận dialog
- Thành viên chuyển sang trạng thái "Tạm khóa" → Mất quyền truy cập
Kích hoạt lại (Reactivate):
- Menu ⋮ → "Kích hoạt lại" (chỉ hiện khi trạng thái = Tạm khóa)
- Thành viên trở về trạng thái "Hoạt động"
4.6 Gửi lại lời mời
Với thành viên trạng thái "Đã mời" chưa phản hồi:
- Menu ⋮ → "Gửi lại lời mời"
- Email mời mới được gửi
4.7 Xóa thành viên
- Menu ⋮ → "Xóa" → Xác nhận dialog
- Thành viên bị xóa vĩnh viễn khỏi tổ chức
[!CAUTION]
Xóa thành viên là hành động không thể hoàn tác. Nên ưu tiên "Vô hiệu hóa" thay vì xóa.
5. Trạng thái thành viên
| Mã | Trạng thái | Màu | Mô tả |
|---|---|---|---|
| 0 | Đã mời (Invited) | 🔷 Info | Đã gửi lời mời, chờ chấp nhận |
| 1 | Hoạt động | 🟢 Success | Đang hoạt động bình thường |
| 2 | Tạm khóa | 🟡 Warning | Bị đình chỉ quyền truy cập |
| 3 | Đã rời (Left) | ⚫ Secondary | Đã rời tổ chức |
| 4 | Đã từ chối (Declined) | 🔴 Danger | Từ chối lời mời |
6. Vai trò cơ bản
| Mã | Vai trò | Màu | Phạm vi quyền |
|---|---|---|---|
| 0 | Chủ sở hữu (Owner) | 🔴 Danger | Toàn quyền (*) |
| 1 | Quản lý (Manager) | 🟡 Warning | Quyền quản trị trừ xóa tổ chức |
| 2 | Nhân viên (Staff) | 🔵 Primary | Quyền thao tác theo vai trò tùy chỉnh |
| 3 | Người xem (Viewer) | ⚫ Secondary | Chỉ xem, không chỉnh sửa |
7. Cập nhật theo thời gian thực
Hệ thống tự động cập nhật danh sách khi:
- Có nhân viên mới chấp nhận lời mời
- Có người dùng tham gia bằng mã mời
- Trạng thái thành viên thay đổi
Không cần làm mới trang thủ công.
8. Câu hỏi thường gặp (FAQ)
| Câu hỏi | Trả lời |
|---|---|
| Mời nhưng nhân viên không nhận được email? | Kiểm tra thư mục spam. Có thể gửi lại bằng nút "Gửi lại lời mời". Hoặc dùng mã mời 6 ký tự thay thế. |
| Mã mời hết hạn thì sao? | Tạo mã mới. Mỗi mã có thời hạn và giới hạn số lần sử dụng. |
| Vai trò cơ bản vs Vai trò tùy chỉnh? | Vai trò cơ bản (4 cấp) quyết định phạm vi chung. Vai trò tùy chỉnh phân quyền chi tiết theo từng tính năng. |
| Có thể có nhiều Owner? | Không. Mỗi tổ chức chỉ có 1 Owner (người tạo tổ chức). |
Cập nhật lần cuối: 2026-05-08