HƯỚNG DẪN CÀI ĐẶT WEB VÒNG QUAY MAY MẮN (v2 — có ảnh quà + trang quản trị)
=============================================================================

CẤU TRÚC FILE
-------------
vongquay/
 ├── index.html              → trang web chính (khách vào quay thưởng)
 ├── assets/app.js            → logic giao diện trang chính
 ├── assets/images/uploaded/  → nơi lưu ảnh quà do anh upload qua trang quản trị
 ├── admin/index.html         → TRANG QUẢN TRỊ (anh vào đây quản lý giải thưởng)
 ├── admin/admin.js
 ├── admin/api/*.php          → API riêng cho trang quản trị
 ├── api/*.php                → API cho trang khách (đăng ký/đăng nhập/quay)
 └── schema.sql               → cấu trúc database + 8 giải mẫu


BƯỚC 1 — TẠO DATABASE TRONG CPANEL
-----------------------------------
1. cPanel > "MySQL® Databases" > tạo database mới (VD: vongquay)
2. Tạo user MySQL mới + mật khẩu mạnh, gán quyền "ALL PRIVILEGES" vào database đó
3. Ghi lại: Tên database, Tên user, Mật khẩu (cPanel thường thêm tiền tố, VD "abc_vongquay")

BƯỚC 2 — IMPORT DATABASE
--------------------------
1. cPanel > "phpMyAdmin" > chọn database vừa tạo
2. Tab "Import" > chọn file schema.sql > "Go"
3. Kiểm tra có 3 bảng: users, prizes, spin_history (prizes có sẵn 8 giải mẫu)

BƯỚC 3 — SỬA FILE CẤU HÌNH
----------------------------
Mở file api/config.php, sửa các dòng:

    define('DB_HOST', 'localhost');
    define('DB_NAME', 'abc_vongquay');          ← tên database thật
    define('DB_USER', 'abc_vongquay_user');     ← tên user thật
    define('DB_PASS', 'mật_khẩu_thật');          ← mật khẩu thật
    define('ADMIN_PASSWORD', 'mật_khẩu_admin');  ← ĐẶT MẬT KHẨU RIÊNG cho trang quản trị, KHÔNG để mặc định

BƯỚC 4 — UPLOAD LÊN HOSTING
------------------------------
1. Mở File Manager trong cPanel
2. Vào public_html (hoặc thư mục web của anh)
3. Upload toàn bộ thư mục "vongquay" (giữ đúng cấu trúc con: api/, admin/, assets/)
   → Cách nhanh: nén thành .zip, upload, bấm chuột phải > Extract
4. Phân quyền (nếu cần): thư mục assets/images/uploaded/ cần quyền 755 hoặc 775 để PHP ghi được ảnh upload

BƯỚC 5 — VÀO TRANG QUẢN TRỊ ĐỂ THÊM ẢNH & CHỈNH GIẢI
-------------------------------------------------------
Truy cập: https://tenweb.com/vongquay/admin/
Đăng nhập bằng mật khẩu đã đặt ở Bước 3 (ADMIN_PASSWORD)

Trong trang quản trị anh có thể:
  ✓ Thêm / sửa / xóa phần quà
  ✓ Upload ảnh quà thật (JPG/PNG/WEBP, tối đa 5MB) — kéo thả ngay trong form
  ✓ Đổi tỷ lệ trúng từng giải (cột "Tỷ lệ trúng" = weight, số CÀNG LỚN CÀNG DỄ TRÚNG)
  ✓ Ẩn/hiện từng giải mà không cần xóa
  ✓ Xem danh sách khách đã đăng ký + lịch sử trúng giải, tìm theo tên/SĐT

Nếu chưa upload ảnh, hệ thống tự hiển thị ảnh placeholder đẹp (nền đen-vàng, có tên giải)
để trang không bao giờ bị "vỡ" giao diện.

BƯỚC 6 — KIỂM TRA TRANG KHÁCH
--------------------------------
Truy cập: https://tenweb.com/vongquay/
1. Đăng ký 1 tài khoản test
2. Kiểm tra số lượt quay mặc định (3 lượt/người mới)
3. Bấm "QUAY NGAY" → xem có ra ảnh quà + tên quà đúng như đã cài trong admin không


CÁCH ĐỔI SỐ LƯỢT QUAY MẶC ĐỊNH CHO NGƯỜI MỚI
-----------------------------------------------
Mở api/register.php, tìm dòng có "spins_remaining) VALUES (?, ?, ?, 3)"
→ đổi số 3 thành số lượt anh muốn.

CÁCH TẶNG THÊM LƯỢT QUAY CHO 1 KHÁCH CỤ THỂ
-----------------------------------------------
Vào phpMyAdmin > bảng "users" > tìm theo SĐT > sửa cột "spins_remaining".
(Tính năng này có thể đưa vào trang quản trị nếu anh cần — báo Claude làm thêm)


LƯU Ý AN TOÀN
---------------
- KẾT QUẢ QUAY hoàn toàn do server (api/spin.php) xử lý dựa trên "weight" trong
  database — khách không thể sửa code trình duyệt để ăn gian trúng giải to.
- Mật khẩu khách + mật khẩu admin đều được mã hóa/so khớp an toàn.
- Trang quản trị (/admin/) chỉ vào được khi có đúng ADMIN_PASSWORD — anh nhớ đổi
  ngay từ giá trị mặc định và không chia sẻ link/mật khẩu này công khai.
- Ảnh upload được kiểm tra định dạng (JPG/PNG/WEBP/GIF) và giới hạn 5MB.


PHẦN CÓ THỂ NÂNG CẤP THÊM SAU (nếu anh cần)
----------------------------------------------
- Cho admin tự tặng/trừ lượt quay ngay trong giao diện (không cần phpMyAdmin)
- Xuất danh sách khách hàng ra Excel
- Giới hạn quay theo ngày (VD: mỗi người 1 lượt/ngày, tự cộng thêm)
- Kéo-thả sắp xếp lại thứ tự giải trên vòng quay
Anh cứ nói với Claude, em làm thêm khi anh cần.
