# Usage forecast inputs for analytics tool selection.
# Fill from observed usage (billing screens, a representative month of event counts),
# never from registered-user totals. One block per surface; keep surfaces separate
# so a spike has an identifiable cause. Values below are the fictional Acme example.

checked_on: "2026-10-17"
period: month

surfaces:
  marketing_site:
    anonymous_sessions: 40000
    events_per_session: 3
    product_sdk_installed: false   # GA4 only; keeps the site off product meters
  app_web:
    logged_in_active_people: 3000
    sessions_per_person: 5
    planned_events_per_session: 20
    autocapture_extra_events_per_session: 0   # set to the observed or planned value
    workspaces_active: 600
  backend:
    events: 100000
    identified_by_default: true    # PostHog backend SDKs and API
  imports:
    one_off_backfill_events: 0
    month_of_import: ""
    warehouse_sync_rows: 0         # Mirror updates and deletes bill on Mixpanel
  ai_features:                   # fill when the product has LLM or agent features
    llm_requests: 0
    spans_per_request: 0         # traces, tool calls and retries; can far exceed user turns
    agent_sessions: 0            # Amplitude meters agent sessions separately

collection:
  cdp_in_path: ""                # segment, rudderstack or empty; cuts switching hours, adds its own meter
  cdp_new_identities_from_new_sources: 0

other_meters:
  replay_recordings: 0
  flag_requests: 0
  flags_in_production: false     # if true, never cap the flags product without tested defaults
  experiment_users: 0
  editor_seats: 3
  viewer_seats: 5

derived:
  # client = logged_in_active_people x sessions_per_person x (planned + autocapture extra)
  client_events: 300000
  total_events: 400000
  identified_share: 1.0          # app is logged in; site excluded
  distinct_identities: 3000      # add anonymous devices if the product SDK runs on the site
  events_per_identity: 133

scenarios:
  normal:
    total_events: 400000
  growth_12_months:
    logged_in_active_people: 9000
    total_events: 1200000
  fault:
    description: "broad autocapture adds 40 events per session at growth-case volume"
    total_events: 3000000
  month_13:
    plan_after_programme: ""     # the plan actually moved to
    total_events: 1200000

incumbent:                       # fill when a tool is already in place (step 5b)
  tool: ""
  plan_and_billing_unit: ""
  committed_monthly_volume: 0
  monthly_bill_usd: 0
  renewal_date: ""
  notice_days: 0
  weekly_reports_in_use: 0
  dependencies: []               # ads conversions, audiences, exports, scheduled reports, flags
  planning_rate_usd_hour: 90     # assumption, state it in the memo

alerts:
  threshold_percent_of_allowance: 80
  method: ""                     # vendor email, usage report alert, insight alert
  owner: ""