DLHDLH.io Documentation

Forecast Events

Manage holidays, promotions, and operational events that impact sales and labor forecasts

Overview

Forecast Events represent known occurrences that will impact sales projections — holidays, promotions, local events, weather events, or closures. Applying an event to a forecast adjusts the projected sales up or down by a configurable percentage.

Event Types

TypeDescriptionTypical Impact
HolidayPublic or company holidays (Thanksgiving, Christmas, etc.)+20% to −100%
PromotionMarketing campaigns, special offers, limited-time items+10% to +30%
Local EventConcerts, sports games, festivals near the location+15% to +50%
WeatherSevere weather forecasts affecting traffic−10% to −40%
ClosurePlanned closures (maintenance, remodeling)−100%

Event Scope

Events can be scoped at different levels:

ScopeApplies ToExample
Organization-wideAll locationsThanksgiving Day
Location-specificOne locationLocal street festival

Organization-wide events are managed by Admins. Location-specific events can be created by General Managers for their assigned locations.

Creating an Event

  1. Navigate to Forecasting > Events in the sidebar
  2. Click Create Event
  3. Fill in the event details:
FieldDescription
NameDescriptive event name
TypeHoliday, Promotion, Local Event, Weather, Closure
Start DateFirst day the event impacts forecasts
End DateLast day of impact (can be same as start for single-day events)
Impact %Percentage adjustment to apply to sales forecast (+/−)
ScopeOrganization-wide or specific location(s)
RecurrenceNone, Annual, or Custom
NotesOptional context for other managers
  1. Click Save

How Events Affect Forecasts

When a forecast is generated for a week that overlaps with an event:

Adjusted Sales = Base Projection × (1 + Impact% / 100)

Example: A "Fleet Week" event with +25% impact on a day projected at $10,000:

Adjusted Sales = $10,000 × 1.25 = $12,500

Multiple events can overlap on the same day — their impacts are applied multiplicatively:

Final Sales = Base × (1 + Event1%) × (1 + Event2%)

Event Calendar View

The Events page provides a calendar view showing:

  • All upcoming and past events with color-coded types
  • Which locations each event applies to
  • The impact percentage at a glance

Filter by date range, event type, or location to find specific events.

Recurring Events

For annual events (Thanksgiving, Valentine's Day, etc.), enable Annual Recurrence when creating the event. The system will automatically apply the event to the appropriate week each year.

Editing and Deleting Events

  • Edit: Click an event to modify its dates, impact, or scope
  • Delete: Remove an event entirely (soft-delete; can be recovered from Recycle Bin)

Editing an event that's already been applied to a published forecast does not retroactively change the published forecast. It will only affect future forecast generations.