OOM fix for Spectrograms, admin console branding

[lucaspar]

• Further limiting the max FFT size $2^{14}$ → $2^{11}$, as it's the main cause for server running out of memory when rendering a spectrogram.
• Single source of truth for valid values for spectrograms (themes, FFT sizes, etc), which now comes from the server.
• Branding for Django admin pages to prevent accidental changes to production and QA databases.
• Unified staging environment detection for web app settings.
• Failed spectrogram generations now should render an error message instead of an endless spinner (image).
  

[semanticdiff-com]

Review changes with  

Changed Files

File	Status
gateway/sds_gateway/api_methods/tests/test_capture_endpoints.py	41% smaller
gateway/config/settings/utils.py	20% smaller
gateway/sds_gateway/visualizations/api_views.py	15% smaller
gateway/sds_gateway/static/js/visualizations/spectrogram/SpectrogramControls.js	10% smaller
gateway/sds_gateway/users/tests/test_admin.py	7% smaller
gateway/sds_gateway/static/js/visualizations/spectrogram/SpectrogramVisualization.js	6% smaller
gateway/sds_gateway/context_processors.py	2% smaller
gateway/.envs/example/django.env	Unsupported file format
gateway/.envs/example/django.prod-example.env	Unsupported file format
gateway/config/settings/base.py	0% smaller
gateway/sds_gateway/static/css/admin_environment.css	0% smaller
gateway/sds_gateway/static/js/visualizations/spectrogram/constants.js	0% smaller
gateway/sds_gateway/templates/admin/base_site.html	0% smaller
gateway/sds_gateway/templates/visualizations/spectrogram.html	Unsupported file format
gateway/sds_gateway/users/tests/test_context_processors.py	0% smaller
gateway/sds_gateway/visualizations/tests/test_views.py	0% smaller
gateway/sds_gateway/visualizations/views.py	0% smaller

[Copilot]

Pull request overview

This PR addresses spectrogram-related OOM issues by tightening server-side validation and making the spectrogram UI consume server-provided “source of truth” configuration, and it adds environment branding to the Django admin to reduce the risk of operating on the wrong database.

Changes:

• Introduces centralized spectrogram parameter validation/options on the server (FFT size capped at 2048) and injects those defaults/options into the spectrogram template.
• Improves spectrogram front-end error/status handling so failed generations stop spinning and display actionable errors.
• Adds Django admin environment branding (CSS + template) plus environment detection utilities and tests.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
gateway/sds_gateway/visualizations/views.py	Adds a server-built spectrogram_form context object for templates.
gateway/sds_gateway/visualizations/tests/test_views.py	Verifies spectrogram view context includes server-provided defaults/options.
gateway/sds_gateway/visualizations/api_views.py	Adds Pydantic-backed spectrogram param validation and new FFT cap/options.
gateway/sds_gateway/templates/visualizations/spectrogram.html	Renders FFT/colormap options and numeric ranges from server context.
gateway/sds_gateway/static/js/visualizations/spectrogram/constants.js	Removes now-redundant client-side spectrogram settings/options constants.
gateway/sds_gateway/static/js/visualizations/spectrogram/SpectrogramVisualization.js	Improves status/error display and failed-request handling.
gateway/sds_gateway/static/js/visualizations/spectrogram/SpectrogramControls.js	Switches controls to initialize from server-rendered DOM values/ranges.
gateway/sds_gateway/templates/admin/base_site.html	Adds admin environment/FQDN branding and environment-based body class.
gateway/sds_gateway/static/css/admin_environment.css	Styles admin header by environment via admin-env-* classes.
gateway/sds_gateway/context_processors.py	Exposes ADMIN_CONSOLE_ENV to templates.
gateway/sds_gateway/users/tests/test_context_processors.py	Adds tests for admin env detection and template rendering.
gateway/config/settings/utils.py	Adds shared hostname/env-based staging detection + admin env label helper.
gateway/config/settings/base.py	Introduces ADMIN_CONSOLE_ENV setting with normalization/defaulting.
gateway/sds_gateway/users/tests/test_admin.py	Removes an unnecessary type-ignore in admin tests.
gateway/sds_gateway/api_methods/tests/test_capture_endpoints.py	Small assertion tweak (id → pk).
gateway/.envs/example/django.prod-example.env	Sets DJANGO_DEBUG=false in prod example env.
gateway/.envs/example/django.env	Sets DJANGO_DEBUG=true in local example env.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.