# Keypath Building Intelligence

> A BACnet-backed operations dashboard with live monitoring, alert setup, network discovery tools, and handoff documentation for Algonquin College.

- URL: https://mandalsuraj.com/blog/keypath-building-intelligence
- Author: Suraj Mandal (https://mandalsuraj.com)
- Published: 2025-04-29
- Project date: 2025-03-13
- Tags: algonquin, dashboard, fullstack, python, grafana, bacnet, webdev, automation, contract
- Algonquin College: https://www.algonquincollege.com/

![Keypath Building Intelligence cover](https://mandalsuraj.com/images/blog/keypath-building-intelligence/cover.png)

I delivered this **client project** for an Algonquin College contract. The system turned BACnet building data into a clear operations view, and mapped a campus of **83 networks, 845 devices, and 70,000+ live data points** from scratch.

## Visual Proof

![Keypath Building Intelligence dashboard overview with selected campus readings](https://obiftpj7tr.ufs.sh/f/blog__keypath-building-intelligence__keypath-dashboard.jpg)

![Keypath Building Intelligence connection-status dashboard state](https://obiftpj7tr.ufs.sh/f/blog__keypath-building-intelligence__keypath-network-table.jpg)

![Keypath Building Intelligence device-point table with private address details partially redacted](https://obiftpj7tr.ufs.sh/f/blog__keypath-building-intelligence__keypath-reading-modal.jpg)

![Keypath Building Intelligence alert configuration workflow](https://obiftpj7tr.ufs.sh/f/blog__keypath-building-intelligence__keypath-alert-config.jpg)

Dashboard, connection state, point readings, and alert setup.

## What Shipped

| Area | Work | Why it matters |
|---|---|---|
| Campus mapping | Mapped the whole campus building automation system from scratch: 83 networks, 845 devices, and 70,000+ live data points. | Gave staff a complete picture of a system with no prior documentation and no vendor tools such as Siemens or Niagara. |
| Single-board platform | Ran network discovery, data collection, and the live dashboard on one Raspberry Pi 4. | Keeps the whole platform small enough to run on a single board. |
| Operations dashboard | Built the readings, status, alerts, and context views. Staff can browse any building, device, or point smoothly, with cached and live data together. | Gives operators one place to inspect building state. |
| BACnet data path | Helped map devices and points into a stable product model. | Converts protocol data into useful names and states. |
| Monitoring | Added Grafana-backed system and telemetry checks. | Makes data health visible during operation. |
| Network discovery | Built Python tools for device inventory work. | Cuts manual discovery work. |
| Handoff | Wrote architecture, deployment, and operation notes. | Makes the first release easier to run and extend. |

## Architecture Overview

1. Building systems expose BACnet points and readings.
2. Discovery tools identify devices and their available points.
3. Backend services normalize the data.
4. Grafana tracks service and telemetry health.
5. The dashboard presents readings, status, and alerts.

```mermaid
flowchart LR
  accTitle: Keypath Building Intelligence Architecture
  accDescr: Campus systems move through device discovery, readable building data, operations storage, monitoring, and the dashboard.
  systems["<strong>Campus Systems</strong><br/><small>Building Automation Points</small>"] --> discovery["<strong>Find Devices</strong><br/><small>Build A Clear Inventory</small>"]
  discovery --> prepare["<strong>Prepare Readings</strong><br/><small>Use Stable Names And States</small>"]
  prepare --> data["<strong>Save Operations Data</strong><br/><small>Readings And History</small>"]
  data --> dashboard["<strong>Show Building State</strong><br/><small>Readings Status And Alerts</small>"]
  prepare --> health["<strong>Track Service Health</strong><br/><small>Telemetry And Checks</small>"]
  health --> monitoring["<strong>Monitor Operations</strong><br/><small>Find Problems Early</small>"]
```

## Delivery

The first release joined UI work, data access, discovery, monitoring, and documentation. The final handoff included a working demo and operating notes.
