feat(scorecard): add the ability to drill down into aggregated scorecard data

workspaces/scorecard/.changeset/sour-coins-check.md

@@ -0,0 +1,6 @@
+---
+'@red-hat-developer-hub/backstage-plugin-scorecard-backend': minor
+'@red-hat-developer-hub/backstage-plugin-scorecard-common': minor
+---
+
+Adds the ability to drill down from aggregated scorecard KPIs to view the individual entities that contribute to the overall score. This enables managers and platform engineers to identify specific services impacting metrics and troubleshoot issues at the entity level.

workspaces/scorecard/plugins/scorecard-backend/__fixtures__/mockDatabaseMetricValues.ts

@@ -22,20 +22,23 @@ type BuildMockDatabaseMetricValuesParams = {
   latestEntityMetric?: DbMetricValue[];
   countOfExpiredMetrics?: number;
   aggregatedMetric?: DbAggregatedMetric;
+  entityMetricsByStatus?: { rows: DbMetricValue[]; total: number };
 };
 
 export const mockDatabaseMetricValues = {
   createMetricValues: jest.fn(),
   readLatestEntityMetricValues: jest.fn(),
   cleanupExpiredMetrics: jest.fn(),
   readAggregatedMetricByEntityRefs: jest.fn(),
+  readEntityMetricsByStatus: jest.fn(),
 } as unknown as jest.Mocked<DatabaseMetricValues>;
 
 export const buildMockDatabaseMetricValues = ({
   metricValues,
   latestEntityMetric,
   countOfExpiredMetrics,
   aggregatedMetric,
+  entityMetricsByStatus,
 }: BuildMockDatabaseMetricValuesParams) => {
   const createMetricValues = metricValues
     ? jest.fn().mockResolvedValue(metricValues)
@@ -53,10 +56,15 @@ export const buildMockDatabaseMetricValues = ({
     ? jest.fn().mockResolvedValue(aggregatedMetric)
     : mockDatabaseMetricValues.readAggregatedMetricByEntityRefs;
 
+  const readEntityMetricsByStatus = entityMetricsByStatus
+    ? jest.fn().mockResolvedValue(entityMetricsByStatus)
+    : mockDatabaseMetricValues.readEntityMetricsByStatus;
+
   return {
     createMetricValues,
     readLatestEntityMetricValues,
     cleanupExpiredMetrics,
     readAggregatedMetricByEntityRefs,
+    readEntityMetricsByStatus,
   } as unknown as jest.Mocked<DatabaseMetricValues>;
 };

workspaces/scorecard/plugins/scorecard-backend/__fixtures__/mockMetricProvidersRegistry.ts

@@ -49,10 +49,16 @@ export const buildMockMetricProvidersRegistry = ({
         return metricsList;
       })
     : jest.fn();
+  const getMetric = provider
+    ? jest.fn().mockImplementation((_metricId: string) => {
+        return provider.getMetric(); // Returns the metric from the provider
+      })
+    : jest.fn();
 
   return {
     ...mockMetricProvidersRegistry,
     getProvider,
     listMetrics,
+    getMetric,
   } as unknown as jest.Mocked<MetricProvidersRegistry>;
 };