Mini Slot — tài liệu ghép client

Slot cổ điển 1 hàng × 3 cửa sổ. Thắng khi các symbol khớp từ trái sang phải. 3 Lucky7 = jackpot. Credit chip ngay mỗi spin. Trang này chỉ được serve khi ENVIRONMENT != production.

1. Tổng quan

2. Luồng ghép

1. Vào game → GET /gameplay. Vẽ 3 cửa sổ từ init_reel (5 symbol preview; chỉ dùng 3 ô giữa hoặc map idle riêng).
2. User chọn bet trong bets.
3. POST /spins {"bet":...}. Animate 3 reel tới reel[0..2].
4. Nếu có win_amount: highlight symbol khớp, hiện multiplier. is_jackpot → fanfare Lucky7.
5. Cập nhật chip = user_money. Có thể poll history / top-win cho panel phụ.

3. Auth & envelope

Authorization: Bearer <access_token>
Content-Type: application/json

Mọi API dưới /api/v1 cần JWT. HTTP 200 + code = 0 thành công; payload trong msg.

{ "code": 0, "msg": { ... } }

4. Reel & symbol

Ba cửa sổ lớn. Ô vàng = 3 Lucky7 jackpot.

Ví dụ thua (Cherry / Lemon / Orange):

Server đếm khớp từ trái: reel[0] so với reel[1], reel[2]. number_of_symbols = số ô thêm (1 = hai giống, 2 = ba giống). Không khớp → các field win omit (omitempty).

5. GET /api/v1/gameplay

GET /api/v1/gameplay

{
  "code": 0,
  "msg": {
    "init_reel": [0, 1, 2, 3, 4],
    "bets": [100, 500, 1000, 5000],
    "show_bets": [100, 500, 1000, 5000],
    "bet": 1000
  }
}

6. POST /api/v1/spins

POST /api/v1/spins
{ "bet": 1000 }

Trừ bet ngay, cộng win (nếu có) trong cùng response. Field win dùng omitempty — thua thì không có win_amount / symbol / multiplier / is_jackpot.

Thắng thường

{
  "code": 0,
  "msg": {
    "user_money": 502000,
    "win_amount": 3000,
    "bet": 1000,
    "reel": [4, 4, 4],
    "number_of_symbols": 2,
    "symbol": 4,
    "multiplier": 3
  }
}

Jackpot 3 Lucky7

{
  "code": 0,
  "msg": {
    "user_money": 1500000,
    "win_amount": 1000000,
    "bet": 1000,
    "reel": [6, 6, 6],
    "number_of_symbols": 2,
    "symbol": 6,
    "multiplier": 1000,
    "is_jackpot": true
  }
}

Thua

{ "code": 0, "msg": { "user_money": 499000, "bet": 1000, "reel": [0, 1, 2] } }

7. GET /api/v1/top-win

GET /api/v1/top-win

{
  "code": 0,
  "msg": {
    "winners": [
      { "rank": 1, "user_id": 1001, "username": "meo", "total_win": 880000 },
      { "rank": 2, "user_id": 1002, "username": "lan", "total_win": 210000 }
    ]
  }
}

8. GET /api/v1/spins-history

GET /api/v1/spins-history

{
  "code": 0,
  "msg": {
    "spins": [
      { "user_money": 502000, "win_amount": 3000, "bet": 1000, "reel": [4,4,4], "multiplier": 3, "is_jackpot": false, "created_at": 1710000000 }
    ]
  }
}

9. GET /api/v1/jackpots-history

GET /api/v1/jackpots-history

{
  "code": 0,
  "msg": {
    "jackpots": [
      { "time": 1710000100, "user_id": 1001, "username": "meo", "bet": 1000, "win_amount": 1000000, "reel": [6,6,6] }
    ]
  }
}

10. Animation

1. Lock nút spin tới khi nhận response.
2. Quay 3 cửa sổ; dừng lần lượt trái → phải đúng reel[i].
3. Thắng: highlight number_of_symbols + 1 ô đầu. Cộng counter = win_amount.
4. is_jackpot: overlay Lucky7, không cần poll thêm — chip đã trong user_money.

11. Cheat (chỉ non-prod / cheater)

Body reels là 3 cột, mỗi cột 1 symbol (handler flatten thành [s0,s1,s2]):

{ "bet": 1000, "reels": [[6], [6], [6]] }

Production bỏ qua, luôn random.

12. Error & tiền

13. Checklist client

• Vào game: GET /gameplay. Bet chỉ gửi giá trị trong bets.
• Vẽ đúng 3 cửa sổ từ reel (int 0–6).
• Omit field = thua — đừng hiện 0× giả.
• Jackpot khi is_jackpot (3× Lucky7), credit ngay.
• Không gọi song song 2 spin cho 1 user.