> 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.
---
# 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://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/vong-quay/danh-sach-vong-quay.md?ask=
```
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.