feat(usage): push hourly usage snapshots to Control Plane

[germangarces]

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

• I have read the Contributing Guide.
• 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.

Changes

Closes #7673

refactor(app_analytics): extract bucket query and aggregation helpers

Pull the shared queryset build and per-resource aggregation out of get_usage_data_from_local_db so a windowed reader can reuse them. No behaviour change.

feat(usage): push hourly usage snapshots to Control Plane

Recurring task reports each licensed organisation's data usage to the Control Plane once an hour, authenticated with the licence signature. No-op until CONTROL_PLANE_URL is set and a licensed organisation exists.

Reads API-call counts at hourly resolution via a new app_analytics window selector; the daily billing path is left untouched.

How did you test this code?

Tested end-to-end locally.

Quick check (No control plane needed):

1. make docker-up django-migrate
2. LOG_LEVEL=DEBUG make django-shell
3. In the shell:

 from unittest.mock import patch, Mock
 from organisations.usage_reporting.services import push_snapshot
 from organisations.usage_reporting.mappers import map_organisation_to_usage_snapshot
 org = Organisation.objects.first() or Organisation.objects.create(name="Test")
 snap = map_organisation_to_usage_snapshot(org)
 with patch("organisations.usage_reporting.services.requests.post",
            return_value=Mock(ok=True, status_code=201)):
     push_snapshot(base_url="http://x", snapshot=snap, signature="dummy")

You should see something like:

[info] snapshot.pushed [usage_reporting] status_code=201

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs	Ignored	Preview	Jun 22, 2026 10:27am
flagsmith-frontend-preview	Ignored	Preview	Jun 22, 2026 10:27am
flagsmith-frontend-staging	Ignored	Preview	Jun 22, 2026 10:27am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.59%. Comparing base (e85f77b) to head (d31427c).
⚠️ Report is 22 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7831      +/-   ##
==========================================
+ Coverage   98.57%   98.59%   +0.02%     
==========================================
  Files        1464     1473       +9     
  Lines       56625    57601     +976     
==========================================
+ Hits        55818    56794     +976     
  Misses        807      807              

☔ View full report in Codecov by Harness.
📢 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.

[github-actions]

Docker builds report

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

[github-actions]

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 41.4 seconds
 c7e5332
 🔄 Run: #17663 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 1 passed

Details

 1 test across 1 suite
 45.2 seconds
 c7e5332
 🔄 Run: #17663 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 3 passed

Details

 3 tests across 3 suites
 54.1 seconds
 c7e5332
 🔄 Run: #17663 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 59.6 seconds
 c7e5332
 🔄 Run: #17663 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 21 passed

Details

 21 tests across 16 suites
 1 minute, 20 seconds
 054fc67
 🔄 Run: #17699 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 41.4 seconds
 054fc67
 🔄 Run: #17699 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 2 passed

Details

 2 tests across 2 suites
 47 seconds
 054fc67
 🔄 Run: #17699 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 1 passed

Details

 1 test across 1 suite
 38.9 seconds
 d31427c
 🔄 Run: #17702 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 50.1 seconds
 d31427c
 🔄 Run: #17702 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 1 minute, 1 second
 d31427c
 🔄 Run: #17702 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 2 passed

Details

 2 tests across 2 suites
 57.3 seconds
 d31427c
 🔄 Run: #17702 (attempt 1)

[github-actions]

Visual Regression

19 screenshots compared. See report for details.
View full report