Equipment Monitoring System

The Equipment Monitoring System provides real-time temperature and humidity monitoring for your refrigeration equipment, integrated with Swift Sensors hardware.

Real-time Monitoring

Monitor temperature and humidity across all your fridges and freezers

Smart Alerts

Receive notifications via email, SMS, or in-app when thresholds are exceeded

Historical Reports

Generate reports for compliance and analysis

Multi-channel Notifications

Configure who receives which alerts through which channels

Architecture Overview

Swift Sensors API → API Client → Supabase (historical storage) → Admin Dashboard
                                          ↓
                                   Background Sync Jobs

The system consists of five backend modules that work together:

Swift Sensors API Client - Handles authentication and data fetching from Swift Sensors
Equipment Module - Manages equipment units and threshold configuration
Temperature Data Module - Stores and queries time-series data
Alert System - Detects threshold violations and tracks alert status
Notification System - Routes alerts to assigned users

Setup

Configure environment variables

Add your Swift Sensors credentials to your .env file:

.env

SWIFT_SENSORS_API_KEY=your_api_key
SWIFT_SENSORS_EMAIL=your_email
SWIFT_SENSORS_PASSWORD=your_password
SWIFT_SENSORS_ACCOUNT_ID=your_account_id

Never commit API credentials to version control. Use environment variables or a secrets manager.

Equipment API routes are registered in the Hono API at apps/api/src/routes/v1/equipment/. No additional module registration is needed.

Run database migrations

Create the required database tables by adding a new Supabase migration in supabase/migrations/:

Terminal

npx supabase migration new add_equipment_tables

Verify the migration created these tables: equipment, equipment_thresholds, temperature_readings, equipment_alerts, alert_notification_assignments

Access the dashboard

Navigate to Equipment → Refrigeration in the admin dashboard to begin monitoring.

Database Schema

Equipment Table

The equipment table stores your refrigeration units:

string

required

Primary key for the equipment record

string

required

Human-readable name (e.g., “Walk-in Fridge 1”)

string

required

Equipment type: refrigerator, freezer, handheld, or robot

string

Link to associated inventory group for location tracking

integer

Swift Sensors temperature sensor ID

integer

Swift Sensors humidity sensor ID (optional)

boolean

Whether the equipment is currently monitored

Equipment Thresholds Table

Configure custom alert thresholds for each equipment unit:

string

required

Foreign key to the equipment record

string

required

Either temperature or humidity

number

Value below which a critical alert is triggered

number

Value below which a warning alert is triggered

number

Value above which a warning alert is triggered

number

Value above which a critical alert is triggered

Alert Types

The system monitors for these alert conditions:

Alert Type	Description	Default Severity
`temperature_high`	Temperature exceeds high threshold	Based on threshold
`temperature_low`	Temperature below low threshold	Based on threshold
`humidity_high`	Humidity exceeds threshold	Based on threshold
`humidity_low`	Humidity below threshold	Based on threshold
`connectivity_loss`	No readings received for 15+ minutes	Critical
`battery_low`	Sensor battery needs replacement	Warning
`sensor_offline`	Sensor not responding	Critical

Configure thresholds per equipment unit to account for different requirements. Freezers typically need different thresholds than refrigerators.

API Endpoints

Equipment Management

curl -X POST 'https://switchyard.run/admin/equipment' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{
    "name": "Walk-in Fridge 1",
    "type": "refrigerator",
    "inventory_group_id": "inv_group_123"
  }'

curl -X GET 'https://switchyard.run/admin/equipment?type=refrigerator&is_active=true' \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -X PATCH 'https://switchyard.run/admin/equipment/equip_123' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{
    "swift_sensor_id_temperature": 12345,
    "swift_sensor_id_humidity": 12346
  }'

Alert Management

curl -X GET 'https://switchyard.run/admin/equipment/alerts?status=active' \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -X PATCH 'https://switchyard.run/admin/equipment/alerts/alert_123/resolve' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{"reason": "Temperature normalized after door repair"}'

curl -X PATCH 'https://switchyard.run/admin/equipment/alerts/alert_123/acknowledge' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Time Series Data

Retrieve historical readings for analysis and reporting:

Get Time Series

curl -X GET 'https://switchyard.run/admin/equipment/equip_123/time-series?startTime=1704067200000&endTime=1704153600000&measurementType=both' \
  -H 'Authorization: Bearer YOUR_TOKEN'

integer

required

Start timestamp in milliseconds

integer

required

End timestamp in milliseconds

string

default:"both"

Filter by temperature, humidity, or both

Reports

Generate historical reports for compliance and analysis:

Generate CSV Report

curl -X GET 'https://switchyard.run/admin/equipment/reports?equipmentId=equip_123&startTime=1704067200000&endTime=1704153600000&format=csv' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -o report.csv

Dashboard Features

Equipment Monitoring Tab

The monitoring tab provides:

Active Alerts Section - View and manage current alerts with one-click resolve/acknowledge
Equipment Grid - Cards showing current temperature, humidity, and status for each unit
Status Indicators - Color-coded badges (green/orange/red) for normal/warning/critical states

Click any equipment card to open the detail view:

Historical Charts - Temperature and humidity over time with selectable ranges (1h, 6h, 24h, 7d, 30d)
Active Alerts - Alerts specific to this equipment
Configuration - Sensor IDs and threshold settings

Notifications Management Tab

Configure which users receive which alerts:

Select an alert type
Choose users to assign
Select notification channels (email, SMS, in-app)
Optionally limit to specific equipment

Users only receive notifications for alert types they are explicitly assigned to. Unassigned users will not receive any equipment alerts.

Historical Reporting Tab

Generate reports for compliance and analysis:

Select equipment from the dropdown
Choose date range
Select format (CSV for raw data, JSON for summary)
Click Generate Report

Troubleshooting

No data appearing in the dashboard

Verify credentials - Check that your Swift Sensors credentials are correct in .env
Check sensor pairing - Ensure equipment records have swift_sensor_id_temperature set
Review sync logs - Check the background sync job logs for errors
Test API connection - Try fetching data directly from Swift Sensors API

Alerts not triggering

Check thresholds - Verify thresholds are configured for the equipment
Verify readings - Ensure sensor data is being recorded in temperature_readings
Review alert detection - Check that the alert detection service is running

Notifications not sending

Check assignments - Verify notification assignments exist for the alert type
Verify user data - Ensure assigned users have valid email/phone
Review notification logs - Check the notification service logs

Next Steps: When Sensors Arrive

Install sensors

Follow Swift Sensors installation documentation to mount sensors in your refrigeration units.

Note sensor IDs

Log into the Swift Sensors dashboard and note the sensor IDs for each device.

Pair sensors to equipment

Update each equipment record with the corresponding sensor IDs via the API.

Configure thresholds

Set appropriate temperature and humidity thresholds for each unit type.

Set up notifications

Assign users to receive alerts through their preferred channels.

Begin monitoring

The dashboard will start showing real-time data once sensors are paired.

Getting Started

Architecture

Authentication

Operations

Equipment

Equipment Monitoring System

Equipment Monitoring System

Real-time Monitoring

Smart Alerts

Historical Reports

Multi-channel Notifications

Architecture Overview

Setup

Database Schema

Equipment Table

Equipment Thresholds Table

Alert Types

API Endpoints

Equipment Management

Alert Management

Time Series Data

Reports

Dashboard Features

Equipment Monitoring Tab

Notifications Management Tab

Historical Reporting Tab

Troubleshooting

Next Steps: When Sensors Arrive

​Equipment Monitoring System

Real-time Monitoring

Smart Alerts

Historical Reports

Multi-channel Notifications

​Architecture Overview

​Setup

​Database Schema

​Equipment Table

​Equipment Thresholds Table

​Alert Types

​API Endpoints

​Equipment Management

​Alert Management

​Time Series Data

​Reports

​Dashboard Features

​Equipment Monitoring Tab

​Equipment Detail Modal

​Notifications Management Tab

​Historical Reporting Tab

​Troubleshooting

​Next Steps: When Sensors Arrive

Equipment Monitoring System

Architecture Overview

Setup

Database Schema

Equipment Table

Equipment Thresholds Table

Alert Types

API Endpoints

Equipment Management

Alert Management

Time Series Data

Reports

Dashboard Features

Equipment Monitoring Tab

Equipment Detail Modal

Notifications Management Tab

Historical Reporting Tab

Troubleshooting

Next Steps: When Sensors Arrive