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>
43 lines
2.0 KiB
SQL
43 lines
2.0 KiB
SQL
-- EnakGame game catalog (docs/rfc-enakgame.md §5.1). games is extended rather than
|
|
-- replaced, because the customer app already reads it.
|
|
|
|
ALTER TABLE games
|
|
ADD COLUMN organization_id UUID,
|
|
ADD COLUMN slug VARCHAR(100),
|
|
ADD COLUMN description TEXT,
|
|
ADD COLUMN thumbnail_url VARCHAR(500),
|
|
ADD COLUMN game_url VARCHAR(500),
|
|
ADD COLUMN version VARCHAR(50),
|
|
ADD COLUMN status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE'
|
|
CONSTRAINT chk_games_status CHECK (status IN ('DRAFT', 'ACTIVE', 'INACTIVE', 'ARCHIVED')),
|
|
ADD COLUMN entry_cost BIGINT,
|
|
ADD COLUMN session_ttl_seconds INT NOT NULL DEFAULT 600
|
|
CONSTRAINT chk_games_session_ttl_seconds CHECK (session_ttl_seconds > 0),
|
|
-- Limits the Result Validator checks a result against: max_score,
|
|
-- min_duration_seconds, max_score_per_second, the valid outcomes, and the game's
|
|
-- daily reward limit (§5.10, §7.2).
|
|
ADD COLUMN result_rules JSONB NOT NULL DEFAULT '{}';
|
|
|
|
-- The old games leave the product: archived, never deleted (§14). game_plays.game_id
|
|
-- is ON DELETE CASCADE, and the old GAME_SPEND ledger rows point at game_plays.
|
|
-- Their coin cost becomes the entry cost; one that is missing, not a whole number or
|
|
-- below 1 becomes 1, so the CHECK below holds.
|
|
UPDATE games SET
|
|
status = 'ARCHIVED',
|
|
is_active = FALSE,
|
|
entry_cost = CASE
|
|
WHEN metadata->>'coin_cost' ~ '^[0-9]{1,18}$' THEN GREATEST((metadata->>'coin_cost')::BIGINT, 1)
|
|
ELSE 1 END;
|
|
|
|
ALTER TABLE games
|
|
ALTER COLUMN entry_cost SET NOT NULL,
|
|
-- PRD §10.1: no game is free.
|
|
ADD CONSTRAINT chk_games_entry_cost CHECK (entry_cost >= 1),
|
|
-- Every EnakGame game has an organization and a slug. Only the archived old games
|
|
-- may lack them.
|
|
ADD CONSTRAINT chk_games_enakgame_identity CHECK (
|
|
status = 'ARCHIVED' OR (organization_id IS NOT NULL AND slug IS NOT NULL));
|
|
|
|
CREATE UNIQUE INDEX uq_games_org_slug ON games(organization_id, slug) WHERE slug IS NOT NULL;
|
|
CREATE INDEX idx_games_org_status ON games(organization_id, status);
|