debian-mirror-gitlab/app/models/experiment.rb

# frozen_string_literal: true

class Experiment < ApplicationRecord
  has_many :experiment_users
  has_many :experiment_subjects, inverse_of: :experiment

  validates :name, presence: true, uniqueness: true, length: { maximum: 255 }

  def self.add_user(name, group_type, user, context = {})
    by_name(name).record_user_and_group(user, group_type, context)
  end

  def self.add_group(name, variant:, group:)
    add_subject(name, variant: variant, subject: group)
  end

  def self.add_subject(name, variant:, subject:)
    by_name(name).record_subject_and_variant!(subject, variant)
  end

  def self.record_conversion_event(name, user, context = {})
    by_name(name).record_conversion_event_for_user(user, context)
  end

  def self.by_name(name)
    find_or_create_by!(name: name)
  end

  # Create or update the recorded experiment_user row for the user in this experiment.
  def record_user_and_group(user, group_type, context = {})
    experiment_user = experiment_users.find_or_initialize_by(user: user)
    experiment_user.assign_attributes(group_type: group_type, context: merged_context(experiment_user, context))
    # We only call save when necessary because this causes the request to stick to the primary DB
    # even when the save is a no-op
    # https://gitlab.com/gitlab-org/gitlab/-/issues/324649
    experiment_user.save! if experiment_user.changed?

    experiment_user
  end

  def record_conversion_event_for_user(user, context = {})
    experiment_user = experiment_users.find_by(user: user)
    return unless experiment_user

    experiment_user.update!(converted_at: Time.current, context: merged_context(experiment_user, context))
  end

  def record_conversion_event_for_subject(subject, context = {})
    raise 'Incompatible subject provided!' unless ExperimentSubject.valid_subject?(subject)

    attr_name = subject.class.table_name.singularize.to_sym
    experiment_subject = experiment_subjects.find_by(attr_name => subject)
    return unless experiment_subject

    experiment_subject.update!(converted_at: Time.current, context: merged_context(experiment_subject, context))
  end

  def record_subject_and_variant!(subject, variant)
    raise 'Incompatible subject provided!' unless ExperimentSubject.valid_subject?(subject)

    attr_name = subject.class.table_name.singularize.to_sym
    experiment_subject = experiment_subjects.find_or_initialize_by(attr_name => subject)
    experiment_subject.assign_attributes(variant: variant)
    # We only call save when necessary because this causes the request to stick to the primary DB
    # even when the save is a no-op
    # https://gitlab.com/gitlab-org/gitlab/-/issues/324649
    experiment_subject.save! if experiment_subject.changed?

    experiment_subject
  end

  private

  def merged_context(experiment_subject, new_context)
    experiment_subject.context.deep_merge(new_context.deep_stringify_keys)
  end
end