feat(enakgame): game sessions, rewards, vouchers, budgets and events
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>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
2c9753fae7
commit
798a36bd6c
@@ -0,0 +1,46 @@
|
||||
package processor
|
||||
|
||||
import (
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"github.com/stretchr/testify/assert"
|
||||
|
||||
"apskel-pos-be/internal/entities"
|
||||
)
|
||||
|
||||
func TestValidateResult(t *testing.T) {
|
||||
start := time.Date(2026, 10, 7, 12, 0, 0, 0, time.UTC)
|
||||
after := func(seconds int) time.Time { return start.Add(time.Duration(seconds) * time.Second) }
|
||||
score := func(v int64) *int64 { return &v }
|
||||
outcome := func(v string) *string { return &v }
|
||||
rules := entities.GameResultRules{
|
||||
MaxScore: score(1000),
|
||||
MinDurationSeconds: score(10),
|
||||
MaxScorePerSecond: ptr(20.0),
|
||||
Outcomes: []string{"WIN", "LOSE"},
|
||||
}
|
||||
|
||||
for name, tc := range map[string]struct {
|
||||
rules entities.GameResultRules
|
||||
result SessionResult
|
||||
elapsed int
|
||||
reasons int
|
||||
}{
|
||||
"no rules accept anything": {entities.GameResultRules{}, SessionResult{Score: score(999999), Outcome: outcome("ANY")}, 0, 0},
|
||||
"within every rule": {rules, SessionResult{Score: score(1000), Outcome: outcome("WIN")}, 60, 0},
|
||||
"no score, no outcome": {rules, SessionResult{}, 10, 0},
|
||||
"too short": {rules, SessionResult{}, 9, 1},
|
||||
"score above max": {rules, SessionResult{Score: score(1001)}, 600, 1},
|
||||
"too fast": {rules, SessionResult{Score: score(201)}, 10, 1},
|
||||
"exactly the per-second cap": {rules, SessionResult{Score: score(200)}, 10, 0},
|
||||
"negative score": {rules, SessionResult{Score: score(-1)}, 60, 1},
|
||||
"unknown outcome": {rules, SessionResult{Outcome: outcome("DRAW")}, 60, 1},
|
||||
"zero time, some score": {entities.GameResultRules{MaxScorePerSecond: ptr(5.0)}, SessionResult{Score: score(1)}, 0, 1},
|
||||
"zero time, zero score": {entities.GameResultRules{MaxScorePerSecond: ptr(5.0)}, SessionResult{Score: score(0)}, 0, 0},
|
||||
"every rule broken": {rules, SessionResult{Score: score(5000), Outcome: outcome("DRAW")}, 1, 4},
|
||||
} {
|
||||
reasons := ValidateResult(tc.rules, tc.result, start, after(tc.elapsed))
|
||||
assert.Len(t, reasons, tc.reasons, "%s: %v", name, reasons)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user