> For the complete documentation index, see [llms.txt](https://docs.xcloud.wms.delfi.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xcloud.wms.delfi.vn/docs/features/settings/roles.md).

# Vai trò

### MÔ TẢ GIAO DIỆN

Phần nội dung chính của tính năng Quản lý vai trò được chia thành hai dạng màn hình hiển thị:

#### **Màn hình Danh sách vai trò:**

<figure><img src="/files/PiGxZ72M4OsmYyGZAkMV" alt=""><figcaption></figcaption></figure>

* Thanh công cụ: Bao gồm thanh tìm kiếm (`Tìm kiếm...`), nút tải lại dữ liệu, nút Xuất Excel và nút + Thêm mới.
* Bảng dữ liệu: Hiển thị danh sách các vai trò hiện có trong hệ thống với các cột thông tin:
  * *Mã Vai trò* & *Tên Vai trò*: Định danh của nhóm quyền.
  * *Mô tả*: Diễn giải ngắn gọn chức năng của vai trò.
  * *Quyền hạn*: Tổng số lượng thao tác mà vai trò này được phép thực hiện (VD: 147 quyền hạn).
  * *Người cập nhật* & *Ngày cập nhật*: Lưu vết thời gian và người chỉnh sửa cuối cùng.
  * *Hành động*: Biểu tượng cây bút dùng để vào chế độ chỉnh sửa.
* Phân trang: Nằm ở góc dưới cùng bên phải, cho phép chuyển trang và chọn số lượng dòng hiển thị trên mỗi trang.

#### **Màn hình Thêm mới / Chỉnh sửa:**

<figure><img src="/files/F7VR9WZdaOCHRQyLXNOW" alt=""><figcaption></figcaption></figure>

* Thông tin chung: Các trường nhập liệu cơ bản gồm Tổ chức (mặc định), Mã Vai trò (bắt buộc), Tên Vai trò (bắt buộc) và Mô tả.
* Khu vực Permissions (Quyền hạn):
  * Thanh tìm kiếm nhanh các quyền.
  * Danh sách các nhóm tính năng (module) có thể mở rộng/thu gọn (Ví dụ: Document Templates, Chi tiết lấy hàng, Phiếu xuất hàng, Lô, Vị trí...).
  * Tương ứng với mỗi nhóm là các công tắc (Toggle) để cấp quyền chi tiết: View (Xem), Create (Thêm), Update (Sửa), Delete (Xóa).
* Nút thao tác: Nằm ở cuối thanh bên, gồm Hủy và Thêm mới (hoặc Lưu nếu ở chế độ chỉnh sửa).

***

### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC

Lập phân quyền: Liệt kê sẵn các nhóm nhân sự (Ví dụ: Quản lý kho, Nhân viên lấy hàng, Nhân viên PDA Scanner, Nhân viên MKT) và các thao tác tương ứng họ được phép làm.

Quy định chuẩn đặt Mã Vai trò: Nên viết hoa, không dấu, ngăn cách bằng dấu gạch dưới (VD: `WAREHOUSE_STAFF`, `MANAGER`, `PDA_SCANNER`) để dễ quản lý.

***

### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN

#### **Tìm kiếm và Xuất dữ liệu**

* Nhập từ khóa (Mã hoặc Tên vai trò) vào ô `Tìm kiếm...` để lọc danh sách nhanh chóng.
* Nhấn Xuất Excel để tải toàn bộ danh sách vai trò hiện tại về máy tính phục vụ việc báo cáo hoặc rà soát.

#### **Thêm mới Vai trò**

{% stepper %}
{% step %}
**Chọn nút thêm mới**

Tại màn hình danh sách, nhấn nút + Thêm mới (màu xanh) ở góc phải.
{% endstep %}

{% step %}
**Thiết lập thông tin**

<figure><img src="/files/bMR8srxw7OMTs6b12wgw" alt=""><figcaption></figcaption></figure>

Hệ thống sẽ mở thanh thiết lập bên phải. Điền đầy đủ thông tin:

* Mã Vai trò (Bắt buộc): Nhập mã không dấu (VD: `WAREHOUSE_STAFF`).
* Tên Vai trò (Bắt buộc): Nhập tên hiển thị (VD: `Nhân viên kho`).
* Mô tả: Ghi chú rõ mục đích của vai trò này để các quản trị viên khác dễ nắm bắt.
  {% endstep %}

{% step %}
**Cấp quyền hạn (Permissions):**

* Gõ tên module vào ô tìm kiếm hoặc kéo xuống để tìm các nhóm quyền mong muốn.
* Click vào biểu tượng mũi tên (`>`) cạnh tên nhóm (VD: *Phiếu xuất hàng*) để mở rộng các tùy chọn.
* Gạt công tắc sang màu xanh cho các hành động cho phép: View (chỉ xem), Create (tạo mới), Update (chỉnh sửa), Delete (xóa).
  {% endstep %}

{% step %}
**Lưu cấu hình**

Kiểm tra lại tổng số quyền hạn đã cấp (hiển thị ở góc trên khu vực Permissions) và nhấn nút \[+ Thêm mới] ở cuối màn hình để hoàn tất.
{% endstep %}
{% endstepper %}

#### **Chỉnh sửa Vai trò**

<figure><img src="/files/O9Ui2WOEBoSeNeWDvflA" alt=""><figcaption></figcaption></figure>

* Tìm vai trò cần thay đổi trên danh sách, nhấn vào biểu tượng Cây bút ở cột Hành động.
* Hệ thống mở thanh thông tin (Mã vai trò sẽ bị khóa, không thể sửa).
* Bạn có thể thay đổi Tên Vai trò, Mô tả.
* Để cấp thêm hoặc gỡ bỏ quyền: Tìm đến nhóm quyền tương ứng, gạt công tắc Bật/Tắt các hành động (View/Create/Update/Delete).

{% hint style="warning" %}
*Lưu ý: Nếu một quyền chưa có trong danh sách hiển thị, bạn có thể sử dụng dropdown Add permissions ở phía dưới để thêm module đó vào khu vực chỉnh sửa.*
{% endhint %}

* Nhấn nút Lưu (màu xanh) để cập nhật các thay đổi.

***

### LƯU Ý CHUNG KHI SỬ DỤNG

Quyền "Delete" (Xóa): Cần hết sức cẩn trọng khi cấp quyền Delete cho các vai trò nhân viên thông thường để tránh rủi ro mất mát dữ liệu quan trọng của kho.

Tác động tức thì: Khi bạn nhấn "Lưu" ở chế độ chỉnh sửa, các quyền hạn mới sẽ lập tức áp dụng cho toàn bộ các tài khoản người dùng đang được gán vai trò đó. Không cần yêu cầu người dùng phải đăng nhập lại.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xcloud.wms.delfi.vn/docs/features/settings/roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.