F002 — Deck Management

​

Business Rule

• Hole cards: 2 per hand × number of hands (e.g. 6 cards for 3 hands)
• Community cards: exactly 5 (flop 1, 2, 3; turn; river)
• Total cards used per game: 2 × numHands + 5 (e.g. 11 for 3 hands)
• Cards remaining undealt: 52 − (2 × numHands + 5) (e.g. 41 for 3 hands — never revealed)

​

Technical Design

​

Server-side shuffling

1. Deal 2 hole cards per hand — returned as hands[] (4-char strings) in the STATUS_HOLE API response
2. Deal 5 community cards — returned as flopCard1–flopCard3, turnCard, riverCard in each stage response

​

UMA client state bridge

window._holeCards  // string[] — 4-char per hand (e.g. ['AcKd','7h2s','QsJd'])
                   // set after STATUS_HOLE advance

window._stageCards // { flopCard1, flopCard2, flopCard3, turnCard, riverCard }
                   // each value is a 2-char string or null (null until that stage is reached)
                   // set after each advance call in platform.js

​

Card token format

​

GDK card translation

​

Acceptance Criteria

• AC1 — After advancing to RIVER, _stageCards contains exactly 5 non-null community card tokens (flopCard1, flopCard2, flopCard3, turnCard, riverCard)
• AC2 — All card tokens (hole cards + community cards) are valid 2-char strings: rank in {2–9, T, J, Q, K, A}, suit in {c, d, h, s}
• AC3 — No card token appears more than once across all hole cards AND all community cards (global deck integrity)
• AC4 — Total unique cards dealt equals 2 × handCount + 5 (e.g. 11 for 3 hands)
• AC5 — Community cards are revealed progressively: flopCard1–3 non-null at FLOP; turnCard non-null at TURN; riverCard non-null at RIVER

​

Version Parity

​

Known Discrepancies

​

Test Coverage

VERSION=uma npx playwright test tests/features/F002-deck-management.spec.ts --project=features --workers=1