> 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/users.md).

# Người dùng

### MÔ TẢ GIAO DIỆN

Giao diện Quản lý người dùng được thiết kế dạng bảng kết hợp thanh trượt bên (sidebar) để thao tác nhanh, bao gồm 2 phần chính:

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

* Thanh công cụ: Bao gồm bộ lọc nâng cao, tùy chọn hiển thị cột, nút làm mới dữ liệu, ô `Tìm kiếm...`, nút Xuất Excel và nút + Thêm mới.
* Bảng dữ liệu người dùng: Hiển thị các thông tin:
  * *User*: Hình đại diện (Avatar), Họ tên và Email.
  * *Tổ chức*: Đơn vị trực thuộc.
  * *Ứng dụng đăng nhập*: Nền tảng người dùng được phép truy cập (Web quản lý hoặc App Scanner).
  * *Vai trò* & *Kho được phép*: Số lượng vai trò và kho mà người dùng được phân quyền.
  * *Trạng thái* (Hoạt động/Khóa) & *Ngày tham gia*.
  * *Hành động*: Các nút thao tác nhanh gồm Xem chi tiết (biểu tượng con mắt), Chỉnh sửa (cây bút), Làm mới/Reset (mũi tên xoay) và Khóa/Mở khóa (ổ khóa).

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

***

#### **Màn hình Thao tác**

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

* Hiển thị ở góc phải màn hình khi người dùng thực hiện một hành động.
* Chứa các trường thông tin cá nhân (Avatar, Họ tên, Email, Mật khẩu), thông tin phân quyền (Ứng dụng đăng nhập, Vai trò, Kho) và Lịch sử đăng nhập hệ thống.

***

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

Để thêm mới một người dùng vào hệ thống một cách hoàn chỉnh, quản trị viên cần:

* Thông tin cá nhân: Họ và tên, địa chỉ Email công việc (sẽ dùng làm tài khoản đăng nhập).
* Quyền hạn đã thiết lập: Các Vai trò (Role) và danh mục Kho hàng (Warehouse) phải được tạo sẵn trên hệ thống từ trước.
* Xác định rõ môi trường làm việc của nhân sự: Làm việc trên máy tính (Web quản lý) hay sử dụng máy quét mã vạch/PDA dưới kho (App Scanner).

***

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

#### Thêm mới người dùng

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

* Tại màn hình danh sách, nhấn nút + Thêm mới (màu xanh).
* Hệ thống mở thanh bên phải. Điền các thông tin bắt buộc (có dấu `*` màu đỏ):
  * Họ và tên: Tên hiển thị của người dùng.
  * Email: Sẽ được sử dụng làm tên đăng nhập. (Lưu ý: Nhập chính xác vì không thể sửa đổi sau khi tạo).
  * Mật khẩu: Khởi tạo mật khẩu mặc định cho người dùng.
  * Ứng dụng đăng nhập: Chọn nền tảng cấp phép (chọn *Web quản lý* cho nhân viên văn phòng/quản lý, hoặc *App Scanner* cho nhân viên kho dùng thiết bị cầm tay).
  * Vai trò: Chọn một hoặc nhiều vai trò tương ứng với chức vụ.
  * Trạng thái: Mặc định là `ACTIVE` (Hoạt động).
* Kho được phép: Chọn các kho mà nhân viên này được phép thao tác/nhìn thấy dữ liệu.
* Nhấn + Thêm mới ở cuối góc phải để hoàn tất.

#### Xem chi tiết người dùng

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

* Tại dòng chứa tên người dùng cần xem, nhấn vào biểu tượng Con mắt ở cột Hành động.
* Thanh thông tin chi tiết sẽ hiện ra với 2 phần:
  * Thông tin chung: Hiển thị toàn bộ hồ sơ, vai trò, kho được cấp phép và thông tin lưu vết (Ngày tạo, Người tạo, Lần cập nhật cuối).
  * Lịch sử đăng nhập gần đây: Cuộn xuống dưới cùng để kiểm tra nhật ký truy cập. Hệ thống sẽ ghi nhận chi tiết: Thiết bị (VD: Windows 10/11), IP Kết nối & Vị trí, Trình duyệt/App, Thời gian và Trạng thái đăng nhập. Có thể bấm "Xem thêm..." để truy xuất dữ liệu cũ hơn.

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

#### Chỉnh sửa người dùng

* Tại dòng chứa tên người dùng, nhấn vào biểu tượng Cây bút (hoặc nhấn nút cây bút ở góc dưới cùng khi đang trong màn hình Xem chi tiết).
* Thay đổi các trường dữ liệu cần thiết như: Họ tên, Ứng dụng đăng nhập, cập nhật lại Vai trò, hoặc thêm/bớt Kho được phép.
* Đổi mật khẩu: Để cấp lại mật khẩu cho người dùng quên pass, nhấn vào nút Đặt lại mật khẩu (biểu tượng ổ khóa).
* Nhấn nút Lưu (màu xanh) để cập nhật thông tin.

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

***

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

**Tính cố định của Email:** Email là định danh duy nhất của người dùng trên hệ thống. Khi đã tạo thành công, trường Email sẽ bị làm mờ (disable) và không thể chỉnh sửa. Nếu nhập sai email, bạn buộc phải tạo lại tài khoản mới.

**Bảo mật truy cập:** Thường xuyên kiểm tra phần Lịch sử đăng nhập gần đây của các tài khoản có quyền hạn cao (Admin/Manager) để phát hiện kịp thời các truy cập bất thường (sai IP, sai vị trí địa lý).

**Khóa tài khoản:** Khi nhân viên nghỉ việc hoặc chuyển công tác, không cần xóa dữ liệu. Hãy sử dụng tính năng Chỉnh sửa và đổi Trạng thái sang `INACTIVE` (hoặc bấm biểu tượng Ổ khóa ngoài danh sách) để thu hồi quyền truy cập ngay lập tức trong khi vẫn giữ nguyên lịch sử làm việc của họ.


---

# 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/users.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.