feat(scorecard): support scalar aggregation KPI types

Signed-off-by: Ihor Mykhno <imykhno@redhat.com>

Author: imykhno

workspaces/scorecard/.changeset/afraid-lies-punch.md

@@ -0,0 +1,13 @@
+---
+'@red-hat-developer-hub/backstage-plugin-scorecard-backend': minor
+'@red-hat-developer-hub/backstage-plugin-scorecard-common': minor
+'@red-hat-developer-hub/backstage-plugin-scorecard': minor
+---
+
+This update introduces new scalar aggregation KPIs in the scorecard configuration, including:
+
+- **`sum`**: Single numeric total of latest metric values across owned entities
+- **`average`**: Mean of latest metric values across owned entities
+- **`max`**: Maximum latest metric value across owned entities
+- **`min`**: Minimum latest metric value across owned entities
+- **`count`**: Number of entities with a non-null latest stored value

workspaces/scorecard/README.md

@@ -15,10 +15,10 @@ yarn install
 
 ## Documentation
 
-| Topic                                                                     | Location                                                                                       |
-| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
-| Aggregation KPIs (`statusGrouped`, `weightedStatusScore`), API, ownership | [plugins/scorecard-backend/docs/aggregation.md](plugins/scorecard-backend/docs/aggregation.md) |
-| Backend installation and RBAC, **`scorecard.aggregationKPIs`** examples   | [plugins/scorecard-backend/README.md](plugins/scorecard-backend/README.md)                     |
-| Drill-down (entity list for a metric)                                     | [plugins/scorecard-backend/docs/drill-down.md](plugins/scorecard-backend/docs/drill-down.md)   |
-| Metric thresholds, annotations, **weightedStatusScore KPI result colors** | [plugins/scorecard-backend/docs/thresholds.md](plugins/scorecard-backend/docs/thresholds.md)   |
-| Frontend (homepage cards, NFS)                                            | [plugins/scorecard/README.md](plugins/scorecard/README.md)                                     |
+| Topic                                                                                                                 | Location                                                                                       |
+| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| Aggregation KPIs (`statusGrouped`, `weightedStatusScore`, scalar `sum`/`average`/`max`/`min`/`count`), API, ownership | [plugins/scorecard-backend/docs/aggregation.md](plugins/scorecard-backend/docs/aggregation.md) |
+| Backend installation and RBAC, **`scorecard.aggregationKPIs`** examples                                               | [plugins/scorecard-backend/README.md](plugins/scorecard-backend/README.md)                     |
+| Drill-down (entity list for a metric)                                                                                 | [plugins/scorecard-backend/docs/drill-down.md](plugins/scorecard-backend/docs/drill-down.md)   |
+| Metric thresholds, annotations, **weightedStatusScore KPI result colors**                                             | [plugins/scorecard-backend/docs/thresholds.md](plugins/scorecard-backend/docs/thresholds.md)   |
+| Frontend (homepage cards, NFS)                                                                                        | [plugins/scorecard/README.md](plugins/scorecard/README.md)                                     |

workspaces/scorecard/app-config.yaml

@@ -275,6 +275,40 @@ scorecard:
       type: statusGrouped
       description: This KPI is provide information about whether the license file exists in the repository.
       metricId: filecheck.license
+    totalOpenBugs:
+      title: Total Open Bugs
+      description: Sum of open issues across owned entities
+      type: sum
+      metricId: jira.open_issues
+      options:
+        thresholds:
+          rules:
+            - key: success
+              expression: '>=80'
+              color: '#6bb300' # green
+            - key: warning
+              expression: '<80'
+              color: 'rgb(224, 189, 108)' # light orange
+    avgOpenPrs:
+      title: Average Open PRs
+      description: Mean open PR count per entity
+      type: average
+      metricId: github.open_prs
+    entitiesWithOpenIssues:
+      title: Entities with Open Issues
+      description: Count of entities with a stored open-issues value
+      type: count
+      metricId: jira.open_issues
+    maxOpenPrs:
+      title: Maximum Open PRs
+      description: Maximum open PR count per entity
+      type: max
+      metricId: github.open_prs
+    minOpenPrs:
+      title: Minimum Open PRs
+      description: Minimum open PR count per entity
+      type: min
+      metricId: github.open_prs
   plugins:
     jira:
       open_issues:

workspaces/scorecard/packages/app-legacy/e2e-tests/pages/HomePage.ts

@@ -63,9 +63,11 @@ export class HomePage {
       cardPattern = /Scorecard:\s*GitHub open PRs|ScorecardGithubHomepage/i;
     } else if (cardName === 'Scorecard: Jira open blocking') {
       cardPattern = /Scorecard:\s*Jira open blocking|ScorecardJiraHomepage/i;
-    } else if (cardName === AGGREGATED_CARDS_WIDGET_TITLES.openPrsWeightedKpi) {
+    } else if (
+      cardName === AGGREGATED_CARDS_WIDGET_TITLES.gitHubOpenPrsWeightedKpi
+    ) {
       cardPattern =
-        /Scorecard:\s*GitHub open PRs \(weighted health\)|ScorecardOpenPrsWeightedKpi/i;
+        /Scorecard:\s*GitHub open PRs \(weighted health\)|ScorecardGitHubOpenPrsWeightedKpi/i;
     } else {
       cardPattern = new RegExp(escapeRegex(cardName), 'i');
     }