Platform toggles
We have two mechanisms to configure the platform and change its behavior without needing to deploy code changes. Our main goal is to allow us to safely deploy code and disable features when they are not fully tested.
Flags
Flags can be found in Django admin, under the Accounts section. They can be toggled on and off to enable and disable per-user or per-company features.
Current list of flags:
enable_epa_sep: EPA SEP page on emissions dashboard.enable_sensor_data: Enables sensor data integration on the site detail page (Sensirion device measurements and alerting plots).enable_longpath_data: Enables LongPath data on the site detail page and timeline. Requiresenable_sensor_datafor the detail page. Controls visibility of LongPath alerting plots and rolling averages charts.enable_analytics: Enables the Analytics page and its link in the sidebar.enable_operator_feedback: Enables the operator feedback section (actionability score) in the event management modal.new_event_form: Enables the "Open reporting form" link on the emission detail tab in the site page.show_aersage_link: Shows the AERSAGE AI link in the sidebar.enable_bulk_options: Displays the bulk actions in the emissions table.enable_download_emission_pdf: Enables downloading emissions as PDF files.manage_events_on_new_site_page: Opens the new site page instead of the event management modal.
Switches
Switches can be found under the Django-Waffle section of the admin. They are used to turn platform features on and off globally.
Current list of switches:
enable_periodic_tasks: Enables Celery periodic tasks.enable_mobile_auth: Enables mobile authentication.import-carbon-mapper-tanager: Enables importing tanager data from carbonmapper.carbonmapper_s3_import: Enables importing Carbon Mapper data from S3.unep_api_import: Enables importing data from the UNEP API.new-infrastructure-emission-matching: Enables new matchers.epa_sep_scraped: Enables EPA SEP scraper that fetches data daily.ip_whitelist: Enables IP whitelisting for companies.plume_outline_matching: enables matching plumes using outlines.compute_cross_matches_in_memory: deprecated (old builder).workflow-automation-enabled: Enables the workflow automation engine (event creation and auto-transitions).workflow-linking-enabled: Enables automatic event linking within workflow runs. When active, events from the same batch that share a configured grouping field (e.g. site or equipment) are linked together, with one designated as the main event. Requires aLinkingRuleto be configured on theWorkflowDef.