HedgeEm Feature Specification
This is the golden source feature catalogue for Texas HedgeEm. Every feature is documented here before it appears in code, and updated whenever behaviour is discovered, corrected, or extended. Each feature document contains:- Business Rule — plain English, readable by a product manager or regulator
- Technical Design — implementation details, algorithms, data structures, coordinates
- Mathematics — formulas with worked examples where applicable
- Acceptance Criteria — testable statements, each mapped to a Playwright assertion
- Version Parity — implementation status across JS / TypeScript / UMA
Mintlify Integration
This directory lives atmintlify-docs/feature-docs/ and is published as the Feature Docs tab at hedgeem-api.qeetoto.com.
Parity Status Legend
| Symbol | Meaning |
|---|---|
| ✅ | Verified — implemented and Playwright-tested |
| ⚠️ | Partial — implemented but known discrepancies |
| ❌ | Missing — not yet implemented |
| ⬜ | Not yet audited |
| N/A | Not applicable to this version |
Version Parity Matrix
| Feature ID | Feature | Phase | JS | TypeScript | UMA | Jira |
|---|---|---|---|---|---|---|
| F001 | Hand count rules | 1 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F002 | Deck management | 1 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F003 | Community cards | 1 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F004 | Game stages | 1 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F005 | Hand evaluation | 1 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F006 | Odds calculation | 1 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F007 | RTP margin application | 1 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F008 | Hand status | 1 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F010 | Chip denominations | 2 | ⬜ | ✅ | ⬜ | HEDGE-50 |
| F011 | Bet placement | 2 | ⬜ | ✅ | ⬜ | HEDGE-50 |
| F012 | Bet cancellation | 2 | ⬜ | ✅ | ⬜ | HEDGE-50 |
| F013 | Multi-hand betting | 2 | ⬜ | ✅ | ⬜ | HEDGE-50 |
| F014 | Multi-stage betting | 2 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F015 | Payout calculation | 2 | ⬜ | ✅ | ⬜ | HEDGE-136 |
| F016 | Credits wallet | 2 | ⬜ | ✅ | ⬜ | HEDGE-50 |
| F020 | Deal button / auto-deal on load | 3 | ✅ | ✅ | ⬜ | HEDGE-134 |
| F021 | Advance button | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F022 | Card display | 3 | ⬜ | ✅ | ⬜ | HEDGE-135 |
| F023 | Hand panels | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F024 | Odds display | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F025 | Dead hand display | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F026 | Cant-lose display | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F027 | Win display | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F028 | Bottom bar | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F029 | Chip selector UI | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F030 | Hand count config | 4 | ⬜ | ⬜ | ⬜ | HEDGE-80 |
| F031 | API vs local data | 4 | ⬜ | ⬜ | ⬜ | HEDGE-83 |
| F032 | RTP config | 4 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F033 | Rounding algorithms | 4 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F040 | Menu screen | 4 | ⬜ | ⬜ | ⬜ | HEDGE-78 |
| F041 | Help screen | 4 | ⬜ | ⬜ | ⬜ | HEDGE-78 |
| F042 | Config/settings screen | 4 | ⬜ | ⬜ | ⬜ | HEDGE-82 |
| F050 | Landscape layout | 3 | ⬜ | ✅ | ⬜ | HEDGE-133 |
| F051 | Portrait layout | 3 | ⬜ | ✅ | ⬜ | HEDGE-70 |
| F052 | Device themes | 5 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F060 | Sound effects | 4 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F061 | Background music | 4 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F070 | UMA GDK integration | 5 | N/A | N/A | ⬜ | HEDGE-133 |
| F071 | Wallet integration | 5 | N/A | N/A | ⬜ | HEDGE-133 |
| F072 | Localisation | 5 | ⬜ | ⬜ | ⬜ | HEDGE-133 |
| F083 | Skill-based bonus rounds | 4 | ❌ | ❌ | ❌ | TBD |
| F084 | Multi-level progressive jackpots | 4 | ❌ | ❌ | ❌ | TBD |
Phase Progress
| Phase | Scope | Status |
|---|---|---|
| 0 — Foundation | Repo structure, Playwright infrastructure | 🔄 In Progress |
| 1 — Core Game Engine | F001–F008 | ⬜ Backlog |
| 2 — Betting | F010–F016 | ⬜ Backlog |
| 3 — UI & Presentation | F020–F029, F050–F051 | ⬜ Backlog |
| 4 — Config, Navigation & Audio | F030–F033, F040–F042, F060–F061, F083–F084 | ⬜ Backlog |
| 5 — UMA Port | F052, F070–F072 | ⬜ Backlog |
| 6 — Regulatory & Compliance | F080+ | ⬜ Backlog |
Source Documents
| Document | Location | Ingested |
|---|---|---|
| Texas HedgeEm Game Concept v0.3 | Dropbox/hedgeem/Documentation/design_and_description/hedgeem_game_concept.docx | ✅ 2026-04-05 |
Open Items — Simon Actions
- Confirm jurisdiction for regulatory compliance documentation (Phase 6)
- Provide SQLite DB file for schema extraction (HEDGE-29)
- Confirm RTP configuration range and operator parameters (Phase 4/6)
- Specify bonus round types and skill mechanics (F083)
- Specify jackpot trigger events and accumulation model (F084)
- Confirm rounding algorithm(s) in use in JS server (F033)
Playwright Test Coverage
Run feature tests against a specific version:tests/shared/
Feature specs: tests/features/F0XX-feature-name.spec.ts