Warehouse Announcements

Warehouse Announcements

Warehouse Announcements let you broadcast messages to warehouse displays, zones, or all screens simultaneously. Use them for safety alerts, shift updates, celebration messages, or urgent operational notices.

Where to Find It

Navigate to Warehouse > Announcements (/warehouse/announcements). This page is available to users with warehouse management permissions.

DisplayNotification Model Fields

Field	Type	Description
title	string	Announcement heading (required, max 255 characters)
message	text	Announcement body (optional, max 2000 characters)
type	enum	info, warning, alert, or success
priority	enum	low, normal, high, or urgent
target_type	enum	broadcast, zone, or display
target_zone_id	integer	Specific zone (when target_type is zone)
target_display_id	integer	Specific display (when target_type is display)
display_style	enum	ticker, overlay, or banner
show_sound	boolean	Play audio alert on display
starts_at	datetime	Scheduled start time
expires_at	datetime	Expiry time (auto-deactivate)
is_active	boolean	Whether the announcement is currently active
created_by	integer	User who created the announcement

Stats Row

Four stat cards appear at the top of the page:

• Total — mdi-bullhorn icon, primary colour. Count of all announcements.
• Active — mdi-check-circle icon, success colour. Currently visible announcements.
• Scheduled — mdi-calendar-clock icon, warning colour. Future announcements not yet active.
• Total Views — mdi-eye icon, info colour. Aggregate view count across all announcements.

Data Table Columns

Column	Content
Type	Coloured chip with icon — Info (blue), Warning (orange), Urgent (red), Celebration (green)
Title	Announcement title with message preview beneath
Status	v-switch toggle to enable or disable the announcement inline
Schedule	Formatted start date plus repeat interval label
Stats	View count
Actions	Broadcast Now, Edit, Delete

Row Actions

• Broadcast Now (mdi-broadcast) — immediately pushes the announcement to targeted displays. Disabled if the announcement is not active.
• Edit (mdi-pencil) — opens the create/edit dialog pre-filled with existing values.
• Delete (mdi-delete, error colour) — opens a confirmation dialog showing the announcement title before permanent removal.

Toolbar

The toolbar contains a search field for filtering by title or message content, plus type filter buttons: All, Active, and Scheduled.

Create and Edit Dialog

The dialog (max-width 700px) contains the following fields:

1. Type — select dropdown with options Info (mdi-information, blue), Warning (mdi-alert, orange), Urgent (mdi-alert-circle, red), and Celebration (mdi-party-popper, green).
2. Title — required text field, max 255 characters with character counter.
3. Message — optional textarea, max 2000 characters with character counter.
4. Display Options — duration in seconds (default 30), priority slider (1–100, default 50), require acknowledgement checkbox, play audio alert checkbox.
5. Scheduling — schedule for (datetime-local picker), repeat frequency (One Time, Hourly, Daily, Weekly), active from and active until date pickers.
6. Active — toggle switch to set whether the announcement is immediately active.

Targeting Options

• Broadcast — sends to all connected displays across every zone.
• Zone-specific — targets all displays within a selected warehouse zone.
• Display-specific — targets a single named display unit.

Query Scopes

The DisplayNotification model provides the following query scopes for filtering:

• active() — where is_active is true
• currentlyVisible() — active, started, and not yet expired
• broadcast() — where target_type is broadcast
• forZone(zoneId) — broadcast or matching zone
• forDisplay(displayId) — broadcast, matching zone, or matching display
• byPriority() — ordered by priority descending