feat: Improve Report API performance (#9476)

- Re-write the methods for clarity
- Remove the dependency on the ReportHelper class.
- Remove n+1 queries in the average metric time series data.

spec/builders/v2/reports/conversations/metric_builder_spec.rb

@@ -0,0 +1,50 @@
+require 'rails_helper'
+
+RSpec.describe V2::Reports::Conversations::MetricBuilder, type: :model do
+  subject { described_class.new(account, params) }
+
+  let(:account) { create(:account) }
+  let(:params) { { since: '2023-01-01', until: '2024-01-01' } }
+  let(:count_builder_instance) { instance_double(V2::Reports::Timeseries::CountReportBuilder, aggregate_value: 42) }
+  let(:avg_builder_instance) { instance_double(V2::Reports::Timeseries::AverageReportBuilder, aggregate_value: 42) }
+
+  before do
+    allow(V2::Reports::Timeseries::CountReportBuilder).to receive(:new).and_return(count_builder_instance)
+    allow(V2::Reports::Timeseries::AverageReportBuilder).to receive(:new).and_return(avg_builder_instance)
+  end
+
+  describe '#summary' do
+    it 'returns the correct summary values' do
+      summary = subject.summary
+      expect(summary).to eq(
+        {
+          conversations_count: 42,
+          incoming_messages_count: 42,
+          outgoing_messages_count: 42,
+          avg_first_response_time: 42,
+          avg_resolution_time: 42,
+          resolutions_count: 42,
+          reply_time: 42
+        }
+      )
+    end
+
+    it 'creates builders with proper params' do
+      subject.summary
+      expect(V2::Reports::Timeseries::CountReportBuilder).to have_received(:new).with(account, params.merge(metric: 'conversations_count'))
+      expect(V2::Reports::Timeseries::AverageReportBuilder).to have_received(:new).with(account, params.merge(metric: 'avg_first_response_time'))
+    end
+  end
+
+  describe '#bot_summary' do
+    it 'returns a detailed summary of bot-specific conversation metrics' do
+      bot_summary = subject.bot_summary
+      expect(bot_summary).to eq(
+        {
+          bot_resolutions_count: 42,
+          bot_handoffs_count: 42
+        }
+      )
+    end
+  end
+end

spec/builders/v2/reports/conversations/report_builder_spec.rb

@@ -0,0 +1,44 @@
+require 'rails_helper'
+
+describe V2::Reports::Conversations::ReportBuilder do
+  subject { described_class.new(account, params) }
+
+  let(:account) { create(:account) }
+  let(:average_builder) { V2::Reports::Timeseries::AverageReportBuilder }
+  let(:count_builder) { V2::Reports::Timeseries::CountReportBuilder }
+
+  shared_examples 'valid metric handler' do |metric, method, builder|
+    context 'when a valid metric is given' do
+      let(:params) { { metric: metric } }
+
+      it "calls the correct #{method} builder for #{metric}" do
+        builder_instance = instance_double(builder)
+        allow(builder).to receive(:new).and_return(builder_instance)
+        allow(builder_instance).to receive(method)
+
+        builder_instance.public_send(method)
+        expect(builder_instance).to have_received(method)
+      end
+    end
+  end
+
+  context 'when invalid metric is given' do
+    let(:metric) { 'invalid_metric' }
+    let(:params) { { metric: metric } }
+
+    it 'logs the error and returns empty value' do
+      expect(Rails.logger).to receive(:error).with("ReportBuilder: Invalid metric - #{metric}")
+      expect(subject.timeseries).to eq({})
+    end
+  end
+
+  describe '#timeseries' do
+    include_examples 'valid metric handler', 'avg_first_response_time', :timeseries, V2::Reports::Timeseries::AverageReportBuilder
+    include_examples 'valid metric handler', 'conversations_count', :timeseries, V2::Reports::Timeseries::CountReportBuilder
+  end
+
+  describe '#aggregate_value' do
+    include_examples 'valid metric handler', 'avg_first_response_time', :aggregate_value, V2::Reports::Timeseries::AverageReportBuilder
+    include_examples 'valid metric handler', 'conversations_count', :aggregate_value, V2::Reports::Timeseries::CountReportBuilder
+  end
+end

spec/builders/v2/reports/timeseries/average_report_builder_spec.rb

@@ -0,0 +1,174 @@
+require 'rails_helper'
+
+describe V2::Reports::Timeseries::AverageReportBuilder do
+  subject { described_class.new(account, params) }
+
+  let(:account) { create(:account) }
+  let(:team) { create(:team, account: account) }
+  let(:inbox) { create(:inbox, account: account) }
+  let(:label) { create(:label, title: 'spec-billing', account: account) }
+  let!(:conversation) { create(:conversation, account: account, inbox: inbox, team: team) }
+  let(:current_time) { '26.10.2020 10:00'.to_datetime }
+
+  let(:params) do
+    {
+      type: filter_type,
+      business_hours: business_hours,
+      timezone_offset: timezone_offset,
+      group_by: group_by,
+      metric: metric,
+      since: (current_time - 1.week).beginning_of_day.to_i.to_s,
+      until: current_time.end_of_day.to_i.to_s,
+      id: filter_id
+    }
+  end
+  let(:timezone_offset) { nil }
+  let(:group_by) { 'day' }
+  let(:metric) { 'avg_first_response_time' }
+  let(:business_hours) { false }
+  let(:filter_type) { :account }
+  let(:filter_id) { '' }
+
+  before do
+    travel_to current_time
+    conversation.label_list.add(label.title)
+    conversation.save!
+    create(:reporting_event, name: 'first_response', value: 80, value_in_business_hours: 10, account: account, created_at: Time.zone.now,
+                             conversation: conversation, inbox: inbox)
+    create(:reporting_event, name: 'first_response', value: 100, value_in_business_hours: 20, account: account, created_at: 1.hour.ago)
+    create(:reporting_event, name: 'first_response', value: 93, value_in_business_hours: 30, account: account, created_at: 1.week.ago)
+  end
+
+  describe '#timeseries' do
+    context 'when there is no filter applied' do
+      it 'returns the correct values' do
+        timeseries_values = subject.timeseries
+
+        expect(timeseries_values).to eq(
+          [
+            { count: 1, timestamp: 1_603_065_600, value: 93.0 },
+            { count: 0, timestamp: 1_603_152_000, value: 0 },
+            { count: 0, timestamp: 1_603_238_400, value: 0 },
+            { count: 0, timestamp: 1_603_324_800, value: 0 },
+            { count: 0, timestamp: 1_603_411_200, value: 0 },
+            { count: 0, timestamp: 1_603_497_600, value: 0 },
+            { count: 0, timestamp: 1_603_584_000, value: 0 },
+            { count: 2, timestamp: 1_603_670_400, value: 90.0 }
+          ]
+        )
+      end
+
+      context 'when business hours is provided' do
+        let(:business_hours) { true }
+
+        it 'returns correct timeseries' do
+          timeseries_values = subject.timeseries
+
+          expect(timeseries_values).to eq(
+            [
+              { count: 1, timestamp: 1_603_065_600, value: 30.0 },
+              { count: 0, timestamp: 1_603_152_000, value: 0 },
+              { count: 0, timestamp: 1_603_238_400, value: 0 },
+              { count: 0, timestamp: 1_603_324_800, value: 0 },
+              { count: 0, timestamp: 1_603_411_200, value: 0 },
+              { count: 0, timestamp: 1_603_497_600, value: 0 },
+              { count: 0, timestamp: 1_603_584_000, value: 0 },
+              { count: 2, timestamp: 1_603_670_400, value: 15.0 }
+            ]
+          )
+        end
+      end
+
+      context 'when group_by is provided' do
+        let(:group_by) { 'week' }
+
+        it 'returns correct timeseries' do
+          timeseries_values = subject.timeseries
+          expect(timeseries_values).to eq(
+            [
+              { count: 1, timestamp: (current_time - 1.week).beginning_of_week(:sunday).to_i, value: 93.0 },
+              { count: 2, timestamp: current_time.beginning_of_week(:sunday).to_i, value: 90.0 }
+            ]
+          )
+        end
+      end
+
+      context 'when timezone offset is provided' do
+        let(:timezone_offset) { '5.5' }
+        let(:group_by) { 'week' }
+
+        it 'returns correct timeseries' do
+          timeseries_values = subject.timeseries
+          expect(timeseries_values).to eq(
+            [
+              { count: 1, timestamp: (current_time - 1.week).in_time_zone('Chennai').beginning_of_week(:sunday).to_i, value: 93.0 },
+              { count: 2, timestamp: current_time.in_time_zone('Chennai').beginning_of_week(:sunday).to_i, value: 90.0 }
+            ]
+          )
+        end
+      end
+    end
+
+    context 'when the label filter is applied' do
+      let(:group_by) { 'week' }
+      let(:filter_type) { 'label' }
+      let(:filter_id) { label.id }
+
+      it 'returns correct timeseries' do
+        timeseries_values = subject.timeseries
+        start_of_the_week = current_time.beginning_of_week(:sunday).to_i
+        last_week_start_of_the_week = (current_time - 1.week).beginning_of_week(:sunday).to_i
+        expect(timeseries_values).to eq(
+          [
+            { count: 0, timestamp: last_week_start_of_the_week, value: 0 },
+            { count: 1, timestamp: start_of_the_week, value: 80.0 }
+          ]
+        )
+      end
+    end
+
+    context 'when the inbox filter is applied' do
+      let(:group_by) { 'week' }
+      let(:filter_type) { 'inbox' }
+      let(:filter_id) { inbox.id }
+
+      it 'returns correct timeseries' do
+        timeseries_values = subject.timeseries
+        start_of_the_week = current_time.beginning_of_week(:sunday).to_i
+        last_week_start_of_the_week = (current_time - 1.week).beginning_of_week(:sunday).to_i
+        expect(timeseries_values).to eq(
+          [
+            { count: 0, timestamp: last_week_start_of_the_week, value: 0 },
+            { count: 1, timestamp: start_of_the_week, value: 80.0 }
+          ]
+        )
+      end
+    end
+
+    context 'when the team filter is applied' do
+      let(:group_by) { 'week' }
+      let(:filter_type) { 'team' }
+      let(:filter_id) { team.id }
+
+      it 'returns correct timeseries' do
+        timeseries_values = subject.timeseries
+        start_of_the_week = current_time.beginning_of_week(:sunday).to_i
+        last_week_start_of_the_week = (current_time - 1.week).beginning_of_week(:sunday).to_i
+        expect(timeseries_values).to eq(
+          [
+            { count: 0, timestamp: last_week_start_of_the_week, value: 0 },
+            { count: 1, timestamp: start_of_the_week, value: 80.0 }
+          ]
+        )
+      end
+    end
+  end
+
+  describe '#aggregate_value' do
+    context 'when there is no filter applied' do
+      it 'returns the correct average value' do
+        expect(subject.aggregate_value).to eq 91.0
+      end
+    end
+  end
+end

spec/controllers/api/v2/accounts/report_controller_spec.rb

@@ -7,7 +7,7 @@ RSpec.describe 'Reports API', type: :request do
   let!(:user) { create(:user, account: account) }
   let!(:inbox) { create(:inbox, account: account) }
   let(:inbox_member) { create(:inbox_member, user: user, inbox: inbox) }
-  let(:default_timezone) { ActiveSupport::TimeZone[0]&.name }
+  let(:default_timezone) { 'UTC' }
   let(:start_of_today) { Time.current.in_time_zone(default_timezone).beginning_of_day.to_i }
   let(:end_of_today) { Time.current.in_time_zone(default_timezone).end_of_day.to_i }
   let(:params) { { timezone_offset: Time.zone.utc_offset } }
@@ -18,7 +18,7 @@ RSpec.describe 'Reports API', type: :request do
                                    assignee: user, created_at: Time.current.in_time_zone(default_timezone).to_date)
   end
 
-  describe 'GET /api/v2/accounts/:account_id/reports/account' do
+  describe 'GET /api/v2/accounts/:account_id/reports' do
     context 'when it is an unauthenticated user' do
       it 'returns unauthorized' do
         get "/api/v2/accounts/#{account.id}/reports"

spec/factories/reporting_events.rb

@@ -2,6 +2,7 @@ FactoryBot.define do
   factory :reporting_event do
     name { 'MyString' }
     value { 1.5 }
+    value_in_business_hours { 1 }
     account_id { 1 }
     inbox_id { 1 }
     user_id { 1 }