> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/khach-hang/hang-thanh-vien.md).

# Hạng Thành viên

Nơi admin thiết lập, thêm mới và quản lý các hạng thành viên (loyalty tier) của khách hàng. Dùng để phân loại khách hàng theo mức độ thân thiết (Thành viên mới, Đồng, Vàng, Kim cương, VIP,...).

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FIMtKsLe8WCFJHp0w1Hhm%2F98.png?alt=media&amp;token=5c75caba-1653-4d85-8f06-090d2561cc67" alt=""><figcaption><p>Hiển thị hạng thành viên trên Mini App và CMS</p></figcaption></figure>

Chức năng chính của màn hình:

✅ Xem danh sách hạng thành viên hiện có\
✅ Thêm mới hạng thành viên\
✅ Cập nhật thông tin hạng thành viên\
✅ Xóa hạng thành viên

## Thêm mới Hạng Thành Viên

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Fxlewqn4jjfY4DUWONct3%2F99.png?alt=media&amp;token=1e5528a5-9a96-4e2e-b656-162e9ef6c707" alt=""><figcaption><p>Thêm mới Hạng thành viên</p></figcaption></figure>

**Bước 1:** Bấm nút **+ Thêm mới** góc trên bên phải.\
**Bước 2:** Nhập thông tin hạng thành viên theo form.

Bảng hướng dẫn điền thông tin:

<table><thead><tr><th>Trường</th><th width="124.96484375">Bắt buộc</th><th>Mô tả chi tiết</th></tr></thead><tbody><tr><td><strong>Tên hạng</strong></td><td>✅</td><td>Tên hiển thị của hạng (VD: Đồng, VIP)</td></tr><tr><td><strong>Điểm yêu cầu</strong></td><td>✅</td><td>Số điểm tích lũy tối thiểu để đạt hạng này</td></tr><tr><td><strong>Tỷ lệ quy đổi</strong></td><td>✅</td><td>Tỷ lệ đổi điểm sang % giảm giá (VD: 0.5 = 50%)</td></tr><tr><td><strong>Trạng thái</strong></td><td>✅</td><td>Hoạt động / Ngừng hoạt động</td></tr><tr><td><strong>Mặc định</strong></td><td>✅</td><td>Chọn <em>Có</em> nếu muốn hạng này là mặc định cho khách mới</td></tr><tr><td><strong>Mô tả</strong></td><td>⬜ Không</td><td>Thông tin thêm (tùy chọn)</td></tr><tr><td><strong>Ảnh</strong></td><td>⬜️ Không</td><td>Hình đại diện của hạng (tùy chọn)</td></tr></tbody></table>

**Bước 3:** Bấm **Lưu** để hoàn tất.

## Cập nhật Hạng Thành Viên

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FHWAeB24sZhMz7sdiHqCB%2F100.png?alt=media&amp;token=7f3c1905-a68b-46e0-93d8-6306fcb75b73" alt=""><figcaption><p>Cập nhật Hạng thành viên</p></figcaption></figure>

* Nhấn nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FaubxrOeAQH7pNJYzObFk%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=f368ce3a-d480-4b57-a3c2-d154bf5575da)**Sửa** ở cột Thao Tác.
* Chỉnh lại các thông tin tương tự như phần Thêm mới.
* Bấm **Cập nhật** để lưu thay đổi.

## Xoá Hạng Thành Viên

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FZmZPFdprWXRN5BLlr102%2F101.png?alt=media&amp;token=768e2477-cb70-4a42-85b2-2d41f8e4ccf4" alt=""><figcaption><p>Xoá Hạng thành viên</p></figcaption></figure>

* Nhấn nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F6OYqPJivVupOzclHXppj%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=09ffdc74-2361-417d-b894-f9861920748b) **Xoá** ở cột Thao Tác.
* Hệ thống sẽ hiển thị cảnh báo xác nhận:
  * ⚠️ *“Dữ liệu sẽ không được phục hồi với thao tác này!”*
* Chọn **Xác nhận** để xóa hoặc **Huỷ** nếu muốn quay lại.

## Tips cho Admin

✅ Chỉ nên có 1 hạng mặc định trong hệ thống.\
✅ Tỷ lệ quy đổi hợp lý giúp quản lý loyalty program hiệu quả.\
✅ Cập nhật mô tả để nhân viên dễ hiểu ý nghĩa từng hạng.