Dashboard Home

Feature Name

dashboard-home

Goal

Provide a LiveView homepage that gives operators immediate situational awareness for the device fleet and direct navigation into core workflows.

Users

• IoT operators monitoring fleet health.
• Administrators reviewing pending approvals and active alerts.

Requirements

• Show total device count.
• Show online and offline device counts using the same heartbeat-window logic as offline alerts.
• Show pending approval count.
• Show active alert count.
• Provide prominent navigation to Devices, Approvals, Alerts, and Reports.
• Make relevant stat cards clickable and route to the corresponding filtered/detail view where supported.
• Update stats in real time without requiring a page reload.
• Render sensible zero-data, loading, and degraded-data states.

Proposed Design

The dashboard home is the default landing page. It reads aggregated summary data from the dashboard/server contexts and renders compact statistic cards plus workflow navigation. LiveView updates keep the snapshot fresh as devices register, heartbeats arrive, approvals change, and alerts resolve.

The feature assumes one visible role for this iteration: users who can load the dashboard see the full summary.

Validation

• Seed devices, approvals, and alerts; verify displayed counts match database state.
• Verify navigation links reach the expected routes.
• Verify empty-state counts display as zero rather than errors.
• Verify updates arrive without manual page reload.