> 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/vong-quay/danh-sach-vong-quay.md).
# Danh sách vòng quay
## **Màn hình danh sách vòng quay**
Hiển thị Vòng Quay May Mắn trên Mini App và CMS
✅ **Mục đích:**\
Hiển thị tất cả vòng quay đã tạo cùng thông tin chính.
✅ **Nội dung bảng:**
* **STT:** Thứ tự.
* **Tên vòng quay:** Tên chương trình.
* **Ngày bắt đầu / Ngày hết hạn:** Thời gian hoạt động.
* **Điểm yêu cầu:** Số điểm/spin cần để quay 1 lần.
* **Trạng thái:** Hoạt động / Tạm dừng.
* **Thao tác:**
*  Chỉnh sửa vòng quay.
*  Xoá vòng quay.
✅ **Bộ lọc:**
* Tìm theo tên.
* Lọc theo trạng thái (Hoạt động / Tạm dừng).
* Lọc theo thời gian.
✅ **Hành động:**
* Bấm  để tạo vòng quay mới.
* Bấm  để chỉnh sửa vòng quay.
* Bấm  để xoá vòng quay (cần xác nhận).
## Thêm mới / Cập nhật vòng quay – Tab Thông tin cơ bản
Thiết lập thông tin cho Vòng quay
✅ **Mục đích:**\
Khai báo nội dung chính của vòng quay.
✅ **Các trường cần nhập:**
* **Tên vòng quay:** Tên chương trình hiển thị với khách hàng (bắt buộc).
* **Spin points yêu cầu:** Số điểm cần để quay 1 lần (bắt buộc).
* **Trạng thái hoạt động:** Bật / Tắt vòng quay.
* **Ngày bắt đầu / Ngày hết hạn:** Khoảng thời gian diễn ra.
* **Mô tả vòng quay:** Soạn nội dung chi tiết, thể lệ, hướng dẫn tham gia.
* Có thể chèn icon, link, danh sách.
* **Ảnh vòng quay:** Upload hình (600x600 px, JPG/PNG/GIF).
✅ **Hành động:**
* Điền đủ thông tin → bấm  hoặc .
✅ **Gợi ý nội dung mô tả:**
* Tên chương trình.
* Thời gian áp dụng.
* Địa điểm áp dụng.
* Đối tượng tham gia.
* Cách thức tham gia (các bước).
* Giải thưởng.
* Điều khoản và lưu ý.
## Form Thêm mới / Cập nhật vòng quay – Tab Phần thưởng
Thêm mới phần thưởng
✅ **Mục đích:**\
Quản lý **danh sách phần thưởng** của vòng quay may mắn. Admin có thể thêm nhiều giải thưởng, mỗi giải có các thuộc tính riêng.
✅ **Các cột trong danh sách phần thưởng:**
* **Phần thưởng:** Tên giải hiển thị cho khách.
* **Vị trí (độ):** Góc/quadrant trên vòng quay để hiển thị giải (tuỳ thiết kế).
* **Thứ tự:** Sắp xếp trong danh sách phần thưởng.
* **Tỷ lệ (%):** Xác suất trúng giải này.
* **Giới hạn/ngày:** Số lượng tối đa phát ra mỗi ngày.
* **Tổng số lượng:** Tổng số lượng giải sẽ phát ra.
* **Thao tác:**
*  Thêm phần thưởng.
*  Xoá phần thưởng.
✅ **Nút hành động:**
* **Thêm phần thưởng:**
* Mở form thêm mới 1 giải thưởng.
* Điền đầy đủ thông tin phần thưởng →  để thêm vào danh sách.
✅ **Lưu ý quan trọng:**\
⚠️ Hệ thống nhắc nhở:
> “Tổng tỷ lệ trúng thưởng không được vượt quá 100%.”
* Bạn cần chia xác suất hợp lý giữa các giải.
* Nếu tổng > 100%, hệ thống sẽ không cho lưu.
✅ **Quy trình đề xuất:**\
1️⃣ Bấm .\
2️⃣ Nhập tên, tỷ lệ %, số lượng.\
3️⃣ Xác định vị trí hiển thị (nếu vòng quay chia độ).\
4️⃣ Lưu phần thưởng.\
5️⃣ Kiểm tra danh sách giải → tổng tỷ lệ ≤ 100%.
## Xoá vòng quay
Xoá vòng quay
✅ Khi xoá vòng quay hoặc phần thưởng, sẽ hiện cảnh báo:
> ⚠️ “Dữ liệu sẽ không được phục hồi với thao tác này!”
✅ Admin cần  hoặc  thao tác.
## Khuyến nghị cho Admin
✅ Đặt tên chương trình rõ ràng, dễ hiểu.\
✅ Đặt điểm yêu cầu phù hợp để giữ tương tác.\
✅ Viết mô tả đầy đủ, chuyên nghiệp để khách tin tưởng.\
✅ Phân bổ giải thưởng minh bạch, hợp lý.\
✅ Đảm bảo hình ảnh đẹp, chuẩn kích thước.