hermes/docs/research/export-path.md

Research Export Path

Goal

Export study data without adding JSONB or ad hoc blobs.

Source Tables

• sessions
• experiment_assignments
• bet_intents
• settlements
• analytics_events
• analytics_event_attributes

Recommended Export Shape

• session_id
• user_id
• experiment_variant
• locale_code
• event_name
• occurred_at
• attribute_key
• attribute_value

Export Flow

1. Join relational tables into a flat study dataset.
2. Filter by session, date range, or experiment variant.
3. Write CSV for quick review or Parquet for downstream analysis.
4. Keep the export job read-only and repeatable.

Notes

• Use the server clock for ordering and latency calculations.
• Prefer one row per analytics event with child attribute expansion.
• Keep locale and variant fields in every export.