Mục tiêu sản phẩm

• Chuẩn hóa vận hành tournament theo hướng digital-first workflow.
• Giảm sai sót thủ công khi ghi chép hand/move/chip status.
• Cung cấp leaderboard realtime theo từng hand để Floor và Owner kiểm soát tình trạng giải.
• Tối ưu thao tác Dealer: mỗi hành động khoảng 0.5 giây/tap.
• Không thay đổi flow deal truyền thống, Dealer học nhanh và không gây "tech shock".

Vai trò người dùng

Thời gian đào tạo

Club chỉ cần 30 phút training Dealer là có thể vận hành.

Luồng vận hành tổng quan

1. Player check-in bằng player_uid hoặc QR Member.
2. Dealer scan rồi assign vào seat.
3. Dealer tap Next Hand sau mỗi hand.
4. System snapshot leaderboard realtime.
5. Floor can intervene nếu cần move/reject/adjust.

Quick Start

Yêu cầu hệ thống

• Tablet hoặc iPad tại mỗi table (khuyến nghị >=10").
• WiFi nội bộ ổn định (LAN preferred).
• 1 màn hình TV/Dashboard để hiển thị leaderboard.

Checklist triển khai nhanh

• ✔ Tạo Tournament trong Admin
• ✔ Import danh sách Player (hoặc dùng DB có sẵn của club)
• ✔ In QR Member (optional nhưng khuyến nghị)
• ✔ Gán thiết bị cho từng Table
• ✔ Test Next Hand sync
• ✔ Verify Leaderboard realtime
• ✔ Go-Live

Data Model

Core Entities

tournament

table

seat

player

Có thể dùng luôn player_uid hiện tại của club, không cần migrate hệ thống cũ.

API / Events

Next Hand Event

Trigger chính của hệ thống.

POST /event/next-hand

{
  "table_id": "T12",
  "dealer_id": "D03",
  "hand_no": 128
}

System sẽ:

• Lock state bàn
• Commit snapshot leaderboard
• Broadcast realtime update
• Unlock

Latency mục tiêu: <300ms

Bảo mật

Role-Based Access Control

Troubleshooting

Leaderboard không update

• Check Next Hand đã tap chưa.
• Check network latency.
• Re-sync snapshot.

Dealer nhập sai seat

Floor dùng Move (non-destructive correction).

Mất kết nối

Local queue sẽ sync lại khi online.

Product Goals

• Standardize tournament operations with a digital-first workflow.
• Reduce manual errors in hand/move/chip status logging.
• Provide real-time hand-by-hand leaderboards for Floor and Owner visibility.
• Optimize Dealer actions to around 0.5 seconds per tap.
• Keep the traditional dealing flow, so dealers learn quickly without tech shock.

User Roles

Training Time

A club typically needs only 30 minutes of dealer training to operate.

Operational Flow Overview

1. Player checks in using player_uid or member QR.
2. Dealer scans and assigns a seat.
3. Dealer taps Next Hand after each hand.
4. System creates a real-time leaderboard snapshot.
5. Floor can intervene for move/reject/adjust actions when needed.

Quick Start

System Requirements

• A tablet or iPad at each table (recommended >=10 inches).
• Stable local Wi-Fi (LAN preferred).
• One TV/dashboard screen for leaderboard display.

Fast Deployment Checklist

• ✔ Create Tournament in Admin
• ✔ Import player list (or use existing club DB)
• ✔ Print member QR codes (optional but recommended)
• ✔ Assign devices to each table
• ✔ Test Next Hand sync
• ✔ Verify real-time leaderboard
• ✔ Go Live

Data Model

Core Entities

tournament

table

seat

player

You can reuse the club's existing player_uid without migrating legacy systems.

API / Events

Next Hand Event

Main trigger of the system.

POST /event/next-hand

{
  "table_id": "T12",
  "dealer_id": "D03",
  "hand_no": 128
}

System will:

• Lock table state
• Commit leaderboard snapshot
• Broadcast real-time update
• Unlock

Target latency: <300ms

Security

Role-Based Access Control

Troubleshooting

Leaderboard not updating

• Check whether Next Hand was tapped.
• Check network latency.
• Re-sync snapshot.

Dealer assigned the wrong seat

Floor should use Move (non-destructive correction).

Network disconnected

Local queue will sync automatically when online again.