Overview
Overrider Panel is a tool used to override weather data for Pinpoint. It allows editing weather data, statuses, and text forecasts for enterprise locations, WeatherWatch locations, and any valid Geos locations.Repositories
Overrider consists of two repositories:- Overrider (Panel): https://git.wthr.ws/weathertech/Overrider
- Overrider API: https://git.wthr.ws/weathertech/overrider-api
Architecture
Components
The Overrider Panel consists of three main components, each with its own Dockerfile:- app - Frontend application
- backend - Backend API service
- nginx - Web server/reverse proxy
Authentication
Overrider uses Atlas for authentication. Users must be registered in Atlas to access the Overrider Panel.Data Storage
Overrides are stored in Redis oncluster-n03. For more information about Redis deployment, see Redis Infrastructure.
Deployment
Overrider is deployed via Portainer on Docker Swarm using two separate stacks.Deployment Locations
- Overrider Panel Stack: wt-ovrd-panel
- Overrider API Stack: wt-overrider-api2
Deployment Process
Overrider API Deployment
- Make code changes in the
overrider-apirepository - Commit your changes:
- Push to the repository:
- Tag the release:
- Build the Docker image:
- Push the image to the registry:
- Update the stack in Portainer (
wt-overrider-api2)
Overrider Panel Deployment
The Overrider Panel has three components (app, backend, nginx), each with its own Dockerfile:- Make code changes in the
Overriderrepository - Commit and push your changes
- Tag the release
- Build each component:
- Push all images:
- Update the stack in Portainer (
wt-ovrd-panel)
How Overrider Works
Overrider Adapter
Overrider uses an adapter that takes Pinpoint data and changes its structure to apply overrides. This adapter integrates with Pinpoint to modify weather data before it’s returned to clients.Location and Weather IDs
Location ID
- Overrides are applied based on location ID from Geos
- Queries using longitude/latitude directly will not receive overrides
- Always use location ID when querying for overridden data
Weather ID
- Weather ID is used to apply one override for a location and all linked locations
- All locations with the same weather ID will receive the same override
- This allows bulk updates across multiple locations that share the same weather conditions
Supported Override Types
Overrider can override:- Weather Data - Modify forecast values, temperatures, conditions, etc.
- Statuses - Change status indicators for locations
- Text Forecasts - Override text-based forecast descriptions
Supported Location Types
Overrides can be applied to:- Enterprise locations
- WeatherWatch locations
- Any valid Geos locations

