Dashboard
Overview
The Dashboard is the main landing page of the NISC Mustering System. It gives facility managers, safety officers, and operators a real-time snapshot of personnel presence, infrastructure health, and system alerts — all in one place.
When you log in, the Dashboard loads automatically and begins receiving live updates from the system's BLE gateway network. You do not need to refresh the page manually to see current data; the page connects to the live event stream and polls key infrastructure metrics on a 30-second cycle.
The Dashboard is read-only for most users. Specific actions (initiating an emergency muster, adding personnel) appear only if your account has the corresponding permissions.
Summary Cards
The top section of the Dashboard contains six compact summary cards arranged in a responsive grid. Each card shows a single key number and a supporting detail line. The icon in the top-left corner of each card changes colour to indicate status — green for healthy, amber for a warning condition, and red for a critical condition.
Every card displays a small clock timestamp in the top-right corner showing the time of its last data refresh.
Personnel — In Building
Shows the number of registered employees whose BLE tag has been detected by a gateway within the facility during the current session.
- Large number: employees currently detected as present.
- Footer line: "of X total (Y%)" — the total is the count of all registered employees in the system, and the percentage is how many are currently in the building.
Note: "In Building" is based on recent BLE detections, not badge swipes or manual check-in. If a tag has not been seen for several minutes it may no longer count as present.
Online Gateways (Muster Status)
Shows how many BLE gateways are currently reporting as online.
- Large number: gateways that are online right now.
- Footer line: "X offline (Y% healthy)" — the offline count and an overall health percentage for the gateway network.
- The card icon turns green when 90% or more of gateways are online, amber when 70–89% are online, and red when fewer than 70% are online.
Tip: If this card shows red, check the Gateway Health by Building section lower on the page to identify which buildings have offline gateways.
Critical Battery
Shows the number of BLE tags reporting a critically low battery level.
- Large number: tags in a critical battery state.
- Footer line: "X low (Y total alerts)" — the count of tags in a low (but not yet critical) state, and the combined total of all battery alerts.
- The card turns red when more than 5 tags are critical, amber when any tags are critical or more than 10 are low, and green when no battery alerts exist.
Action required: Tags with a critical battery should be replaced or recharged as soon as possible to avoid gaps in personnel tracking.
Active Alerts
Shows the total count of active system alerts.
- Large number: current active alert count.
- Footer link: "View all" navigates directly to the Activity page for a full alert log.
- The card turns red when there are more than 10 alerts, amber for 6–10 alerts, green for 1–5 alerts, and grey when there are none.
Active Ambient Devices
Visible to users with ambient device permission. Shows BLE devices detected in the facility that are not registered personnel tags — for example, mobile phones, laptops, and wearables picked up passively by the gateways.
- Large number: devices seen as active (detected recently).
- Footer line: a breakdown such as "12 total detected • 7 phones • 3 laptops • 2 other devices".
- The card turns green when active devices are present, amber when devices are detected but none are currently active, and grey when nothing has been detected.
Tracked Assets
Visible to users with asset permission. Shows the count of BLE-tagged physical assets being monitored by the system.
- Large number: total registered tracked assets.
- Footer line: "X seen recently • Y in use • Z maintenance" — a breakdown of current asset states.
Detail Cards
Below the summary row, the Dashboard shows four larger detail cards.
Gateway Health by Building
Lists every building configured in the system with a health status indicator and gateway counts for each.
Each row shows:
- A coloured dot (green = healthy, amber = degraded/warning, red = critical, grey = unknown).
- The building name.
- Online gateway count (shown in green).
- Offline gateway count (shown in red), if any are offline.
- A badge showing "online/total" (e.g., "4/5").
The card has a manual refresh button (circular arrow icon) in the header, and the footer confirms that the data auto-refreshes every 30 seconds regardless of user action.
Note: Gateway health data only counts gateways that have been assigned to a building. The Online Gateways summary card at the top counts all gateways in the system, so the numbers may differ slightly if some gateways have not been assigned to a building.
Recent Activity
A scrollable feed of the most recent BLE detection events, showing up to 20 events from the past 24 hours in reverse chronological order.
Each entry shows:
- An icon indicating the event type (entry, exit, ambient detection, emergency, system event).
- A description, for example "Jane Smith detected at Main Lobby Gateway" or "Apple phone detected near Reception Gateway".
- A relative timestamp such as "Just now", "5m ago", or "2h ago".
Ambient toggle: the "Ambient" toggle switch in the card header controls whether ambient (non-personnel) device detections are included in the feed. Turning it on shows all BLE detections; turning it off shows only registered personnel activity. Your preference is saved and restored the next time you visit the Dashboard.
The card footer contains a "View all activity" link that navigates to the full Activity page.
Active Personnel by Department
A horizontal bar chart showing how many registered employees in each department are currently active (detected within the last 5 minutes).
Each department row shows:
- The department name.
- A bar whose length is proportional to how many staff are active relative to the department with the most active staff.
- A count label showing "active/total" for that department (e.g., "12/30").
The footer note reads: "Shows active personnel (detected in last 5 minutes)."
Quick Actions
Displays action buttons relevant to your account permissions. Buttons not available to your role are hidden automatically.
| Button | Who sees it | What it does |
|---|---|---|
| Emergency Muster | Emergency managers | Opens the emergency mustering workflow |
| Export Report | All users | Downloads the current dashboard data as a CSV file |
| Add Employee | Personnel administrators | Opens the Add Personnel form |
The card footer notes: "Actions based on your permissions."
Filtering the Dashboard
The Dashboard supports filtering by building, floor, department, and date range. Filters narrow the data shown across all cards so you can focus on a specific part of the facility or a historical time period.
Opening the Filter Panel
- Click the Filters button in the top-right area of the page header.
- The filter panel slides down beneath the page header.
- To close the panel without changing filters, click the X button in the panel header or click Filters again.
Applying Filters
- Building — Select a building from the dropdown, or leave it set to "All Buildings".
- Floor — Once a building is selected, choose a floor. This field is disabled until a building is chosen. Changing the building resets the floor selection automatically.
- Department — Select a department, or leave it set to "All Departments".
- Date Range — Click the calendar icon to choose a start and end date. You can also type dates directly into the field.
The Dashboard reloads automatically a fraction of a second after you change any filter. You do not need to click an "Apply" button.
Tip: Your filter selections are saved in your browser. The next time you visit the Dashboard the same filters will be applied automatically. To remove all filters at once, click the Clear button that appears at the bottom of the filter panel when any filter is active.
Clearing Filters
To reset all filters:
- Open the filter panel by clicking Filters.
- Click Clear Filters at the bottom of the panel.
All dropdowns return to "All" and the date range is cleared. The Dashboard reloads with unfiltered data.
Exporting Dashboard Data
Three export options are available in the page header toolbar, to the left of the Filters button.
Export CSV
- Click the download icon (CSV export button) in the page header.
- Two CSV files are generated and downloaded automatically:
dashboard-summary-[date].csv— the seven summary statistics (personnel in building, total employees, online/offline gateways, battery alerts, active alerts).dashboard-departments-[date].csv— the department breakdown (department name, active count, total count, percentage). This file is only generated if department data is available.
- A confirmation notification appears at the bottom of the screen when the export is complete.
Export PDF
- Click the PDF icon in the page header.
- A PDF of the dashboard summary statistics is generated and downloaded automatically as
dashboard-summary-[date].pdf. - A confirmation notification appears when the download is ready.
Print
- Click the print icon in the page header.
- A formatted print preview opens in a new browser window containing:
- The report title and generation timestamp.
- The active filter selections (building, floor, department).
- A three-column summary grid showing personnel in building, total registered, and online gateways.
- Use your browser's standard print dialog to send to a printer or save as PDF.
Note: The print report includes the filter context (which building, floor, or department was active when you printed), making it useful as a record for muster accountability purposes.
Real-Time Updates
The Dashboard uses two mechanisms to keep data current:
Live WebSocket Connection
When the system is online, the Dashboard connects to the Centrifugo live event stream. Incoming BLE detection events (raddec packets) are processed as they arrive without any page refresh. The connection status is shown in the top-right corner of the page header:
| Indicator | Meaning |
|---|---|
| Green dot — "Live" | Connected to the live event stream |
| Amber dot — "Connecting..." | Attempting to connect |
| Red dot — "Offline" | No live connection; falling back to polling |
When "Live" is shown, the Recent Activity feed receives new entries automatically as detections occur.
Automatic Polling (Fallback)
If the live WebSocket connection is unavailable, the Dashboard falls back to polling the gateway health data every 30 seconds. The Gateway Health by Building card footer always confirms "Auto-refreshes every 30 seconds".
Manual Refresh
To force an immediate reload of all dashboard data at any time:
- Click the Refresh button in the page header.
- All six summary cards, the department chart, the gateway health card, and the recent activity feed reload simultaneously.
- A "Refreshed — Dashboard data updated" notification confirms the reload is complete.
Note: Individual cards (Gateway Health by Building, Active Personnel by Department, Recent Activity) each have their own refresh button (circular arrow icon) in the card header. These refresh only that card's data, not the entire dashboard.
Troubleshooting
All summary cards show zero
The Dashboard loaded but could not retrieve data from the API. Check:
- Is your network connection active?
- Is there a red error banner at the top of the page? If so, it will describe the failure.
- Click Refresh to retry.
- If the problem persists, contact your system administrator.
The "In Building" count seems too low or too high
This count is derived from live BLE detections. It can be affected by:
- Tags that have run out of battery (check the Critical Battery card).
- Tags that are temporarily out of range of a gateway.
- Gateways that are offline (check the Online Gateways card and the Gateway Health by Building card).
The connection status shows "Offline"
The live WebSocket connection has dropped. The Dashboard will fall back to polling automatically. Data will still update but less frequently. Possible causes:
- Temporary network interruption.
- The Centrifugo relay service is unavailable.
The system will reconnect automatically. No action is required.
The Floor filter is greyed out
The Floor dropdown is only active after you have selected a building. Select a building first, then the floor options for that building will become available.
Gateway Health by Building shows "No buildings configured"
No buildings have been set up in the system yet, or no gateways have been assigned to buildings. Contact your administrator to configure buildings and assign gateways.
The Ambient Devices or Tracked Assets card is not visible
These cards are only shown to accounts with the relevant permissions. If you expect to see them and do not, contact your administrator to review your account role.
Export or print produces no output
Ensure your browser allows pop-ups and automatic downloads from the application URL. Some browser security settings block automatic file downloads. If the notification says "Export Complete" but no file appears, check your browser's download settings or blocked-downloads indicator.