Flow docs

End-to-end walkthroughs of the system's most important request flows — who calls whom, what state is written where, and which trace answers which question. Each is backed by a Playwright spec under tests-e2e/tests/.

Player (dropbet) flows

• Sign-up — captcha → user INSERT → verification mail.
• Sign-in + 2FA — credentials → JWT → optional TOTP branch.
• Password reset — token-based reset via emailed link.
• Wallet / balance view — balances, deposit, withdraw, history.
• Bet placement (shared pipeline) — the canonical bet flow (dice as the vector).
• Bet history — paginated player history.
• House game — in-house RNG games (dice/limbo/mines/plinko).
• Blackjack — in-process blackjack over REST + websocket.
• Speed roulette — EOS-anchored wheel, BullMQ round state machine.
• Challenges — wager/win-triggered awards.
• Leaderboard — periodic recompute + socket push.
• Real-time websocket — /events namespace handshake, auth, throttle.

Admin / back-office flows

• Admin sign-in — 2FA-gated admin login.
• User management — search, ban, KYC review, balance adjust, notes.
• Bets review — per-bet inspection with audit trail.