# 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.

## Visual Proof

![Keypath Building Intelligence dashboard overview with selected campus readings](https://mandalsuraj.com/images/blog/keypath-building-intelligence/keypath-dashboard.jpg)

![Keypath Building Intelligence connection-status dashboard state](https://mandalsuraj.com/images/blog/keypath-building-intelligence/keypath-network-table.jpg)

![Keypath Building Intelligence device-point table with private address details partially redacted](https://mandalsuraj.com/images/blog/keypath-building-intelligence/keypath-reading-modal.jpg)

![Keypath Building Intelligence alert configuration workflow](https://mandalsuraj.com/images/blog/keypath-building-intelligence/keypath-alert-config.jpg)

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

## What Shipped

| Area | Work | Why it matters |
|---|---|---|
| Operations dashboard | Built the readings, status, alerts, and context views. | 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.