efrilmandClaude Opus 5.5
798a36bd6c
EnakGame phases 1-8 of docs/tasks-enakgame.md (EG-101 to EG-803), built on the existing EnakPoint/EnakCoin wallet (docs/rfc-enakgame.md). Foundation (phase 1) - Migrations 000103-000106: games extended with organization, slug, status, entry cost and result rules, old games archived (not deleted); budgets, versioned reward configs, sessions and session rewards; the ledger types GAME_SPEND_REFUND, GAME_REWARD and REWARD_REDEEM_REFUND; audit_logs. - AuditLogger writes in the caller's transaction only. - enakgame.limit.user_daily and global_daily organization settings. Games and sessions (phases 2-4) - Admin /marketing/enakgame: games, reward config versions (immutable but for status, one ACTIVE per game), budgets with non-overlapping global periods and a daily job opening the next month. - Customer /customer/enakgame: start (Idempotency-Key, entry cost and config frozen on the session), complete (result validation, reward engine, max_reward cap, daily limits via game_reward_counters, one GAME_REWARD per budget), automatic refunds for system errors and deactivated games, and a session job. - Reward engine: FIXED, SCORE_BASED, OUTCOME_BASED, PROBABILITY (crypto/rand), rounded down. Vouchers and budgets (phases 5-6) - Migration 000108 and 000107: vouchers, codes, redemptions, cost attribution; Economy Guard counters. - STATIC and CODE_POOL redemption in one transaction with the REDEEM PIN action; realized cost traced through the lots to the budget that paid the reward. - Budget metrics: realized cost, forecast, exposure and status. Migrations 000109-000110 add the wallet_lots indexes they need, built CONCURRENTLY. Events (phase 7) - Migration 000111: game events, each with its own EVENT budget. Event extras stack per PRD §16 defaults, with event and per-customer limits. External vouchers (phase 8) - VoucherProvider contract, two-step PENDING redemption and a recovery job, tested with a fake provider. No provider adapter is registered yet, so EXTERNAL vouchers stay out of the catalog. Not yet decided before release: reward rounding, event stacking, budget exhaustion policy and thresholds (RFC §19.2). Migrations 000103-000111 have not been run on any shared database. Also fixes a leftover PAYMENT filter in a wallet test and a data race in a test PIN fake. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
48 lines
1.7 KiB
Go
48 lines
1.7 KiB
Go
package constants
|
|
|
|
// The two balances a customer wallet holds (docs/prd-point-coin.md). EnakPoint pays
|
|
// for orders; EnakCoin is spent on games and can be exchanged into EnakPoint.
|
|
const (
|
|
WalletCurrencyPoint = "POINT"
|
|
WalletCurrencyCoin = "COIN"
|
|
)
|
|
|
|
func IsValidWalletCurrency(currency string) bool {
|
|
return currency == WalletCurrencyPoint || currency == WalletCurrencyCoin
|
|
}
|
|
|
|
// Ledger row types. §8.1 of the PRD lists, per type, which currency it may use, which
|
|
// way it moves the balance, and which reference it must carry.
|
|
const (
|
|
WalletTxTypeEarn = "EARN"
|
|
WalletTxTypeEarnReversal = "EARN_REVERSAL"
|
|
WalletTxTypeExchangeOut = "EXCHANGE_OUT"
|
|
WalletTxTypeExchangeIn = "EXCHANGE_IN"
|
|
WalletTxTypeTransferOut = "TRANSFER_OUT"
|
|
WalletTxTypeTransferIn = "TRANSFER_IN"
|
|
WalletTxTypeGameSpend = "GAME_SPEND"
|
|
WalletTxTypeExpire = "EXPIRE"
|
|
WalletTxTypeAdjustment = "ADJUSTMENT"
|
|
WalletTxTypeMigration = "MIGRATION"
|
|
WalletTxTypeRewardRedeem = "REWARD_REDEEM"
|
|
|
|
// EnakGame (docs/rfc-enakgame.md §6.1).
|
|
WalletTxTypeGameSpendRefund = "GAME_SPEND_REFUND"
|
|
WalletTxTypeGameReward = "GAME_REWARD"
|
|
WalletTxTypeRewardRedeemRefund = "REWARD_REDEEM_REFUND"
|
|
)
|
|
|
|
// What a ledger row's reference_id points at: where the value came from for a
|
|
// credit, or where it went for a debit.
|
|
const (
|
|
WalletRefTypeOrder = "ORDER"
|
|
WalletRefTypeWalletTx = "WALLET_TX"
|
|
WalletRefTypeGamePlay = "GAME_PLAY"
|
|
WalletRefTypeLot = "LOT"
|
|
WalletRefTypeUser = "USER"
|
|
WalletRefTypeLegacyPoints = "LEGACY_POINTS"
|
|
WalletRefTypeLegacyTokens = "LEGACY_TOKENS"
|
|
WalletRefTypeRewardRedemption = "REWARD_REDEMPTION"
|
|
WalletRefTypeGameSession = "GAME_SESSION"
|
|
)
|