Add group-level DORA metrics to GraphQL endpoint

This update exposes group-level DORA metrics through the GraphQL
endpoint. Previously, these metrics were only available (in GraphQL)
at the project level.

Changelog: added
EE: true

doc/api/graphql/reference/index.md

@@ -9210,6 +9210,7 @@ four standard [pagination arguments](#connection-pagination-arguments):
 | <a id="groupcustomemoji"></a>`customEmoji` | [`CustomEmojiConnection`](#customemojiconnection) | Custom emoji within this namespace. Available only when feature flag `custom_emoji` is enabled. (see [Connections](#connections)) |
 | <a id="groupdescription"></a>`description` | [`String`](#string) | Description of the namespace. |
 | <a id="groupdescriptionhtml"></a>`descriptionHtml` | [`String`](#string) | The GitLab Flavored Markdown rendering of `description`. |
+| <a id="groupdora"></a>`dora` | [`Dora`](#dora) | The group's DORA metrics. |
 | <a id="groupemailsdisabled"></a>`emailsDisabled` | [`Boolean`](#boolean) | Indicates if a group has email notifications disabled. |
 | <a id="groupepicboards"></a>`epicBoards` | [`EpicBoardConnection`](#epicboardconnection) | Find epic boards. (see [Connections](#connections)) |
 | <a id="groupepicsenabled"></a>`epicsEnabled` | [`Boolean`](#boolean) | Indicates if Epics are enabled for namespace. |

ee/app/graphql/ee/types/group_type.rb

@@ -86,6 +86,12 @@ module EE
         field :billable_members_count, ::GraphQL::INT_TYPE,
               null: true,
               description: 'The number of billable users in the group.'
+
+        field :dora,
+              ::Types::DoraType,
+              null: true,
+              method: :itself,
+              description: "The group's DORA metrics."
       end
     end
   end

ee/spec/graphql/ee/types/group_type_spec.rb

@@ -74,4 +74,10 @@ RSpec.describe GitlabSchema.types['Group'] do
       expect(vulnerabilities.first['severity']).to eq('CRITICAL')
     end
   end
+
+  describe 'dora field' do
+    subject { described_class.fields['dora'] }
+
+    it { is_expected.to have_graphql_type(Types::DoraType) }
+  end
 end

ee/spec/graphql/resolvers/dora_metrics_resolver_spec.rb

@@ -7,7 +7,8 @@ RSpec.describe Resolvers::DoraMetricsResolver do
 
   let_it_be(:guest) { create(:user) }
   let_it_be(:reporter) { create(:user) }
-  let_it_be(:project) { create(:project) }
+  let_it_be_with_refind(:group) { create(:group) }
+  let_it_be_with_refind(:project) { create(:project, group: group) }
   let_it_be(:production) { create(:environment, :production, project: project) }
   let_it_be(:staging) { create(:environment, :staging, project: project) }
 
@@ -21,8 +22,8 @@ RSpec.describe Resolvers::DoraMetricsResolver do
   end
 
   before_all do
-    project.add_guest(guest)
-    project.add_reporter(reporter)
+    group.add_guest(guest)
+    group.add_reporter(reporter)
 
     create(:dora_daily_metrics, deployment_frequency: 20, lead_time_for_changes_in_seconds: nil, environment: production, date: '2020-01-01')
     create(:dora_daily_metrics, deployment_frequency: 19, lead_time_for_changes_in_seconds: nil, environment: production, date: '2021-01-01')
@@ -44,6 +45,7 @@ RSpec.describe Resolvers::DoraMetricsResolver do
     stub_licensed_features(dora4_analytics: true)
   end
 
+  shared_examples 'dora metrics' do
     describe '#resolve' do
       context 'when the current users does not have access to query DORA metrics' do
         let(:current_user) { guest }
@@ -62,7 +64,6 @@ RSpec.describe Resolvers::DoraMetricsResolver do
           expect(resolve_metrics).to be_nil
         end
       end
-  end
 
       context 'with metric: "deployment_frequency"' do
         let(:args) { { metric: 'deployment_frequency' } }
@@ -209,11 +210,25 @@ RSpec.describe Resolvers::DoraMetricsResolver do
           ])
         end
       end
+    end
+  end
+
+  context 'when the user is querying for project-level metrics' do
+    let(:obj) { project }
+
+    it_behaves_like 'dora metrics'
+  end
+
+  context 'when the user is querying for group-level metrics' do
+    let(:obj) { group }
+
+    it_behaves_like 'dora metrics'
+  end
 
   private
 
   def resolve_metrics
     context = { current_user: current_user }
-    resolve(described_class, obj: project, args: args, ctx: context)
+    resolve(described_class, obj: obj, args: args, ctx: context)
   end
 end

ee/spec/requests/api/graphql/project/dora_spec.rb

@@ -6,11 +6,19 @@ RSpec.describe 'Query.project(fullPath).dora.metrics' do
   include GraphqlHelpers
 
   let_it_be(:reporter) { create(:user) }
-  let_it_be(:project) { create(:project) }
-  let_it_be(:production) { create(:environment, :production, project: project) }
+  let_it_be(:group) { create(:group) }
+  let_it_be(:project_1) { create(:project, group: group) }
+  let_it_be(:project_2) { create(:project, group: group) }
+  let_it_be(:project_not_in_group) { create(:project) }
+  let_it_be(:production_in_project_1) { create(:environment, :production, project: project_1) }
+  let_it_be(:staging_in_project_1) { create(:environment, :staging, project: project_1) }
+  let_it_be(:production_in_project_2) { create(:environment, :production, project: project_2) }
+  let_it_be(:production_not_in_group) { create(:environment, :production, project: project_not_in_group) }
 
-  let(:query) do
-    graphql_query_for(:project, { fullPath: project.full_path },
+  let(:post_query) { post_graphql(query, current_user: reporter) }
+  let(:data) { graphql_data.dig(*path_prefix) }
+
+  let(:query_body) do
     <<~QUERY
       dora {
         metrics(metric: DEPLOYMENT_FREQUENCY) {
@@ -19,36 +27,44 @@ RSpec.describe 'Query.project(fullPath).dora.metrics' do
         }
       }
     QUERY
-    )
   end
 
-  let(:post_query) { post_graphql(query, current_user: reporter) }
-  let(:path_prefix) { %w[project dora metrics] }
-  let(:data) { graphql_data.dig(*path_prefix) }
-
   around do |example|
-    travel_to '2021-01-08'.to_time do
+    travel_to '2021-02-01'.to_time do
       example.run
     end
   end
 
   before_all do
-    project.add_reporter(reporter)
-
-    create(:dora_daily_metrics, deployment_frequency: 3, environment: production, date: '2021-01-01')
-    create(:dora_daily_metrics, deployment_frequency: 3, environment: production, date: '2021-01-02')
-    create(:dora_daily_metrics, deployment_frequency: 2, environment: production, date: '2021-01-03')
-    create(:dora_daily_metrics, deployment_frequency: 2, environment: production, date: '2021-01-04')
-    create(:dora_daily_metrics, deployment_frequency: 1, environment: production, date: '2021-01-05')
-    create(:dora_daily_metrics, deployment_frequency: 1, environment: production, date: '2021-01-06')
-    create(:dora_daily_metrics, deployment_frequency: nil, environment: production, date: '2021-01-07')
+    group.add_reporter(reporter)
+
+    create(:dora_daily_metrics, deployment_frequency: 3, environment: production_in_project_1, date: '2021-01-01')
+    create(:dora_daily_metrics, deployment_frequency: 3, environment: production_in_project_1, date: '2021-01-02')
+    create(:dora_daily_metrics, deployment_frequency: 2, environment: production_in_project_1, date: '2021-01-03')
+    create(:dora_daily_metrics, deployment_frequency: 2, environment: production_in_project_1, date: '2021-01-04')
+    create(:dora_daily_metrics, deployment_frequency: 1, environment: production_in_project_1, date: '2021-01-05')
+    create(:dora_daily_metrics, deployment_frequency: 1, environment: production_in_project_1, date: '2021-01-06')
+    create(:dora_daily_metrics, deployment_frequency: nil, environment: production_in_project_1, date: '2021-01-07')
+
+    create(:dora_daily_metrics, deployment_frequency: 4, environment: staging_in_project_1, date: '2021-01-08')
+
+    create(:dora_daily_metrics, deployment_frequency: 4, environment: production_in_project_2, date: '2021-01-09')
+
+    create(:dora_daily_metrics, deployment_frequency: 5, environment: production_not_in_group, date: '2021-01-10')
   end
 
   before do
     stub_licensed_features(dora4_analytics: true)
   end
 
-  it 'returns the expected DORA metrics' do
+  context 'when querying for project-level metrics' do
+    let(:path_prefix) { %w[project dora metrics] }
+
+    let(:query) do
+      graphql_query_for(:project, { fullPath: project_1.full_path }, query_body)
+    end
+
+    it 'returns the expected project-level DORA metrics' do
       post_query
 
       expect(data).to eq(
@@ -63,4 +79,30 @@ RSpec.describe 'Query.project(fullPath).dora.metrics' do
         ]
       )
     end
+  end
+
+  context 'when querying for group-level metrics' do
+    let(:path_prefix) { %w[group dora metrics] }
+
+    let(:query) do
+      graphql_query_for(:group, { fullPath: group.full_path }, query_body)
+    end
+
+    it 'returns the expected group-level DORA metrics' do
+      post_query
+
+      expect(data).to eq(
+        [
+          { 'value' => 3, 'date' => '2021-01-01' },
+          { 'value' => 3, 'date' => '2021-01-02' },
+          { 'value' => 2, 'date' => '2021-01-03' },
+          { 'value' => 2, 'date' => '2021-01-04' },
+          { 'value' => 1, 'date' => '2021-01-05' },
+          { 'value' => 1, 'date' => '2021-01-06' },
+          { 'value' => nil, 'date' => '2021-01-07' },
+          { 'value' => 4, 'date' => '2021-01-09' }
+        ]
+      )
+    end
+  end
 end