hermes/docs/relational-schema.md

Relational Schema

Rules

• UUID primary keys
• timestamptz for all timestamps
• No JSONB columns
• Child tables for attributes and event payloads
• Foreign keys wherever possible

Core Tables

users

• id
• external_ref
• created_at
• preferred_language
• device_platform

sessions

• id
• user_id
• started_at
• ended_at
• experiment_variant
• app_version
• device_model
• os_version
• locale_code

events

• id
• sport_type
• source_ref
• title_en
• title_sv
• status
• preview_start_ms
• preview_end_ms
• reveal_start_ms
• reveal_end_ms
• lock_at
• settle_at

event_media

• id
• event_id
• media_type
• hls_master_url
• poster_url
• duration_ms
• preview_start_ms
• preview_end_ms
• reveal_start_ms
• reveal_end_ms

markets

• id
• event_id
• question_key
• market_type
• status
• lock_at
• settlement_rule_key

outcomes

• id
• market_id
• outcome_code
• label_key
• sort_order

odds_versions

• id
• market_id
• version_no
• created_at
• is_current

outcome_odds

• id
• odds_version_id
• outcome_id
• decimal_odds
• fractional_num
• fractional_den

bet_intents

• id
• user_id
• session_id
• event_id
• market_id
• outcome_id
• idempotency_key
• client_sent_at
• server_received_at
• accepted
• acceptance_code
• accepted_odds_version_id

settlements

• id
• market_id
• settled_at
• winning_outcome_id

experiment_assignments

• id
• user_id
• session_id
• variant
• assigned_at

localization_keys

• id
• key_name
• description

localization_values

• id
• localization_key_id
• locale_code
• text_value

analytics_event_types

• id
• event_name
• description

analytics_events

• id
• analytics_event_type_id
• session_id
• user_id
• occurred_at

analytics_event_attributes

• id
• analytics_event_id
• attribute_key
• attribute_value

audit_logs

• id
• created_at
• actor_type
• actor_id
• action_name
• target_type
• target_id
• trace_id
• note

audit_log_attributes

• id
• audit_log_id
• attribute_key
• attribute_value

Indexes

• sessions.user_id
• sessions.started_at
• events.status
• markets.event_id
• markets.lock_at
• bet_intents.session_id
• bet_intents.market_id
• bet_intents.idempotency_key
• analytics_events.session_id
• analytics_events.user_id
• analytics_events.analytics_event_type_id
• audit_logs.created_at