Real Stream Dashboard

Monitor your water tanks, boreholes, manure dams and farm systems — from anywhere.

This manual covers everything you need to use the Real Stream Dashboard confidently. Use the sidebar to jump to any topic.

💡

Switch between Standard User and Admin tabs at the top of the sidebar to see the section relevant to you.

What the dashboard shows you

Section	What you can do
Overview	A single-screen summary of all systems. First page after login.
Water Tanks	See current fill level, get alerts when tanks are low, view history and export data.
Boreholes	See pump running / stopped status, power draw, and run history.
Manure Dams	Monitor dam levels, control the pump (if permitted), view fill history.
Alerts	See all active and past alerts across every system.

Real Stream Dashboard – Farm Overview screen

Logging In

Open the dashboard URL in any web browser — Chrome, Edge, Firefox, or Safari on your phone all work.

1

Navigate to the dashboard address provided by your administrator.

2

Enter your username and password.

3

Click Sign In. You will land on the Overview page.

ℹ️

Admin users — after sign-in you will see a prompt asking whether to go to the Frontend Dashboard or Django Admin. Choose Frontend Dashboard for day-to-day monitoring.

Logging Out

Click the Logout button in the top-right corner of the screen at any time. Your session is fully closed on the server.

Password Reset

⚠️

Self-service reset is not available. Passwords are managed by your administrator. The "Forgot password?" link sends a request email to support — it does not reset your password automatically.

Requesting a reset

1

On the login page, click Forgot password? below the Sign In button.

2

Enter your username and phone number.

3

Click Request Password Reset. This opens your default email app with a pre-filled message to support@realheyi.com. Send the email.

4

The support team will contact you to complete the reset. Typical response time is the next business day.

$Password Reset Request form$

Dashboard Overview

The Overview is the first page you see after login. It gives you a summary of every system at a glance — no need to click through each section just to check if everything is fine.

System Cards

Each card represents one system (Water, Boreholes, Dams, etc.). The card colour tells you the current status:

Colour	Meaning
Green	All good — no action needed.
Amber	Needs attention — e.g. a tank is getting low.
Red	Urgent — e.g. a tank is critically low or a sensor has stopped responding.

Click any card to go directly to that section.

Farm Overview page showing system status cards

Navigation sidebar

The icon sidebar on the left lets you jump directly to any section. Hover over an icon to see the section name. The active section is highlighted.

Water Tanks

The Water page shows all water storage tanks on the farm. Tanks are grouped by connection type:

WiFi

ESP32 sensors — frequent updates, real-time

LoRaWAN

ChirpStack sensors — battery-powered, longer range

Reading a tank card

Water tank cards showing OK and Low status

Element	What it means
Tank visual	Blue fill shows current water level as a percentage of full capacity.
Percentage number	Exact fill level right now.
Last reading	When the sensor last reported. If this is hours old, the reading may not reflect the current level.
OK	Level is above the alert threshold. No action needed.
Low	Level has dropped below the configured alert threshold.
Stale	No reading received for more than 30 minutes. Check sensor or connectivity.
Sparkline	Mini graph showing the last few readings — lets you see at a glance if the tank is filling or emptying.

Viewing full history

1

On any tank card, click View History & Export.

2

A dialog opens showing a chart for the last 7 days by default.

3

Use the From / To date pickers to select any date range within your subscription's history limit.

4

The graph auto-updates. Summary stats (Min, Max, Avg, number of readings) appear below the chart.

Exporting data

Inside the history dialog, three export buttons download all raw readings (not the averaged chart data) for the selected date range:

Export CSV — opens in Excel, Google Sheets, or any spreadsheet.
Export JSON — for developers or automated processing.
Export TSV (Excel) — tab-separated, ideal for direct paste into Excel.

💡

The chart shows averaged data to keep the graph readable. The downloaded export always contains every individual reading recorded — useful for detailed analysis.

Boreholes

The Boreholes page shows the status of all borehole pumps on the farm.

Reading a borehole card

Borehole pump card showing status and power readings

Element	What it means
RUNNING	Pump is currently active and pumping water.
STOPPED	Pump is idle — normal when the target tank is full or no irrigation is needed.
OFFLINE	No data received for more than 24 hours. Check the pump and sensor.
Power reading	Current electricity draw in kW (where supported by the sensor).
Power sparkline	Mini chart of recent power usage — shows pump run cycles clearly.
Last reading	Timestamp of the most recent sensor report.
Stale	Last reading is more than 30 minutes old — treat current status as uncertain.

Viewing run history

1

Click View History & Export on the borehole card.

2

Select a date range. The chart shows run events (on/off) and, where available, power consumption over time.

3

Export using the CSV, JSON, or TSV buttons for record keeping or analysis.

ℹ️

Borehole pumps can be controlled automatically by the Decision Engine rules (e.g. "start pump when top dam drops below 30%"). Manual control is available to admins only.

Manure Dams

The Manure Dams page monitors the level of each slurry / manure storage dam. High levels need action to prevent overflow.

⚠️

Unlike water tanks (where low is bad), for manure dams a high level is the concern. An alert fires when the dam rises above the configured threshold.

Reading a dam card

Manure Dams page showing Dam 1 — North Sow House card

Element	What it means
Level visual	Fill percentage of the dam's usable capacity.
Percentage	Current fill level.
OK	Level is below the alert threshold — safe.
High	Level has risen above the configured alert threshold — schedule emptying or irrigation.
Sparkline	24-hour level trend for quick visual reference.
Pump control	Toggle switch to start or stop the dam outlet pump (visible to permitted users only).

Viewing dam history

1

Click View History & Export on any dam card.

2

Pick a date range. The chart shows fill level over time — filling events (level rising) are easy to spot.

3

Use the export buttons to download the data as CSV, JSON, or TSV.

Understanding Alerts

The Alerts page collects all active warnings from every system in one place. You can also acknowledge alerts once you have taken action.

Alert severity levels

Badge	Severity	Typical cause
🔴 Danger	Needs immediate action	Tank critically low, sensor offline, dam overflowing
🟡 Warning	Monitor and plan	Tank approaching low threshold, stale data

The alert chip in the top bar

When active alerts exist, coloured chips appear in the top toolbar showing the count:

A red chip with a count means there are Danger-level alerts requiring action.
An amber chip with a count means Warning-level alerts.
Click either chip to jump directly to the Alerts page.

Alerts page showing an active critically low alert

Acknowledging an alert

Acknowledging an alert marks it as seen — it does not fix the underlying issue, but keeps the list tidy.

1

Go to the Alerts page.

2

Find the alert and click Acknowledge.

3

The alert moves to the acknowledged list and the top-bar counter decreases.

💡

An alert will re-appear if the condition is still present the next time sensors report. Acknowledging only dismisses it from the active list — fix the root cause to stop the alert recurring.

Status Indicators — Quick Reference

The same badges appear throughout the dashboard. Here is what each one means:

Badge	Meaning
OK	Level is healthy — above the low-water threshold.
Low	Water level has dropped below the alert threshold. Needs attention.
High	Dam level above threshold. Schedule emptying.
Stale	Sensor has not reported recently. Reading may be out of date.
OFFLINE	No data for 24+ hours. Check device and connectivity.
RUNNING	Pump / motor is currently active.
STOPPED	Pump is idle.
WiFi	Sensor connects via Wi-Fi (ESP32). Generally more frequent updates.
LoRaWAN	Sensor uses ChirpStack long-range radio. Battery-powered, longer range.

ℹ️

Note: All water tanks currently register themselves as LoRaWAN in the dashboard, even if the underlying sensor is actually Wi-Fi based. This is a known display quirk — it doesn't affect readings or alerts, just the connectivity badge shown on the tank card.

🔐

Admin section — This page is only relevant to users with administrator access.

Managing Users

User accounts are managed through the Django Admin panel. Access it from the login screen by choosing Go to Django Admin after signing in, or via /admin/ appended to the server address.

Creating a new user

1

In Django Admin, go to Authentication → Users → Add User.

2

Enter a username and an initial password. Click Save and continue editing.

3

Set Staff status on if the user needs admin access.

4

Scroll to User Module Permissions and tick the modules this user should see.

5

Click Save. Share the credentials with the new user and ask them to change their password.

📸

Screenshot needed — Django Admin user edit page Take a screenshot of the user edit page in Django Admin, showing the module permissions section.

Resetting a user's password

1

In Django Admin, open the user's record.

2

Click "this form" in the password section or use the Change Password link.

3

Enter and confirm the new password. Click Change Password.

4

Notify the user of their new password and ask them to log in immediately.

⚠️

Module permissions control what sections a user can see. A user with no permissions ticked will see a blank dashboard. Always assign at least one module after creating an account.

🔐

Admin section

Device Configuration

All sensors are registered in the Device Registry inside Django Admin. A device must be registered before it appears on the dashboard.

Finding the Device Registry

In Django Admin → Api → Device Registries.

Key fields when adding a device

Field	What to enter
Device ID	The unique identifier used by the sensor (e.g. the ChirpStack EUI or WiFi hostname).
Device Name	A human-readable name shown on the dashboard (e.g. "Top Dam Tank").
Module Type	Which section it belongs to: `water`, `borehole`, `manure_dam`, etc.
Is Active	Tick to show on dashboard. Untick to hide without deleting.
Alert Threshold	The level (%) at which an alert is triggered.

📸

Screenshot needed — Device Registry in Django Admin Take a screenshot of the Device Registry list and one example device edit page.

🔐

Admin section

Alert Thresholds

Alert thresholds are set per device in the Device Registry (see Device Configuration). The threshold is the level at which the dashboard changes a card from OK to Low or High and fires an alert.

Changing a threshold

1

In Django Admin → Device Registries, open the device.

2

Locate the Alert Threshold field and change the value (0–100).

3

Click Save. The change is immediate — the next sensor reading will be evaluated against the new threshold.

💡

For water tanks, the threshold is a minimum (alert when below). For manure dams, it is a maximum (alert when above). The system handles this automatically based on module type.

🔐

Admin section

Landing Page Settings

The Landing Page record controls what regular users see when they first visit the login screen and which module they land on after signing in.

Editing the landing page

In Django Admin → Api → Landing Pages → open the record.

Setting	What it does
Company Name	Shown in the top bar of the dashboard after login.
Background Image URL	Optional image shown on the login page (top-left corner).
Default Module on Login	Which page standard users land on after signing in (e.g. `dashboard`, `water`).
Require Terms Agreement	If ticked, users must accept the Terms & Conditions before entering the dashboard.
Water Tank IDs / Borehole IDs / Dam IDs	Comma-separated list of device IDs that appear on each section's page.

📸

Screenshot needed — Landing Page admin record Take a screenshot of the Landing Page configuration form in Django Admin.

⚠️

If a device ID is listed here but is not registered in the Device Registry, it will still appear blank on the dashboard. Always register the device first.