feat: report environment metrics api

[Zaimwa9]

Thanks for submitting a PR! Please check the boxes below:

• I have added information to docs/ if required so people know about the feature!
• I have filled in the "Changes" section below?
• I have filled in the "How did you test this code" section below?
• I have used a Conventional Commit title for this Pull Request

Changes

⚠️ Branch with front/back: feat/report-environment-metrics-frontend

Dark mode with workflows

Light mode without workflows

Aim of this PR is to provide an endpoint returning a set of environment-level metrics:

• Total features

• Features enabled

• Segment override

• Open change requests

• Scheduled change to come

• Created a base metric view nested within environment view

• Added specific query-sets for each metrics

• New metric service

/api/v1/environments/<environment_api_key>/metrics/	
environments.views.EnvironmentMetricsViewSet	
api-v1:environments:environment-metrics-list

• Added environment model methods to aggregate the metrics
• Added serializers and service methods

Payload example:

{
    "metrics": [
        {
            "value": 3,
            "description": "Total features",
            "name": "total_features",
            "disabled": false,
            "entity": "features",
            "rank": 1
        },
        {
            "value": 2,
            "description": "Features enabled",
            "name": "enabled_features",
            "disabled": false,
            "entity": "features",
            "rank": 2
        },
        {
            "value": 0,
            "description": "Segment Overrides",
            "name": "segment_overrides",
            "disabled": false,
            "entity": "segments",
            "rank": 3
        },
        {
            "value": 1,
            "description": "Open change requests",
            "name": "open_change_requests",
            "disabled": false,
            "entity": "change_requests",
            "rank": 4
        },
        {
            "value": 1,
            "description": "Total scheduled changes",
            "name": "total_scheduled_changes",
            "disabled": false,
            "entity": "scheduled_changes",
            "rank": 5
        }
    ]
}

How did you test this code?

• New tests
• Via requests

http://localhost:8000/api/v1/environments/<EnvID>/metrics/

How to

• Create segments, add segments to features
• Enable / Disable Features
• Add identity overrides to features
• Create change requests (activating 4 eyes)
• Schedule some changes via change requests

Make sure that the displayed metrics reflects reality state

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

3 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
docs	⬜️ Ignored (Inspect)	Visit Preview		Jun 6, 2025 9:00am
flagsmith-frontend-preview	⬜️ Ignored (Inspect)	Visit Preview		Jun 6, 2025 9:00am
flagsmith-frontend-staging	⬜️ Ignored (Inspect)	Visit Preview		Jun 6, 2025 9:00am

[github-actions]

Docker builds report

Image	Build Status	Security report
ghcr.io/flagsmith/flagsmith-e2e:pr-5430	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-api-test:pr-5430	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-frontend:pr-5430	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith-api:pr-5430	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith:pr-5430	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith-private-cloud:pr-5430	Finished ✅	Results ✅

[github-actions]

Uffizzi Ephemeral Environment Deploying

☁️ https://app.uffizzi.com/github.com/Flagsmith/flagsmith/pull/5430

⚙️ Updating now by workflow run 14887281399.

What is Uffizzi? Learn more!

[github-actions]

Uffizzi Ephemeral Environment Deploying

☁️ https://app.uffizzi.com/github.com/Flagsmith/flagsmith/pull/5430

⚙️ Updating now by workflow run 15320227152.

What is Uffizzi? Learn more!

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.69%. Comparing base (62c6ef5) to head (24fdc04).
Report is 30 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5430      +/-   ##
==========================================
+ Coverage   97.65%   97.69%   +0.04%     
==========================================
  Files        1237     1247      +10     
  Lines       43580    44250     +670     
==========================================
+ Hits        42558    43231     +673     
+ Misses       1022     1019       -3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[gagantrivedi]

All these local imports suggest this should be moved to the service layer?

[gagantrivedi]

Why are we doing Max?

[Zaimwa9]

My bad, thanks for catching up, it's a (useless) artifact from before using get_live_feature_states

[Zaimwa9]

Add versions to segments to check version selection