-
-
Snapshots
-
{{ host.snapshot_count }}
-
-
-
Runs
-
{{ host.run_count }}
-
-
-
New Data
-
{{ host.stats_summary.latest_run.rsync.literal_data_bytes|filesizeformat }}
-
-
-
Retention
-
d{{ host.retention_daily }} w{{ host.retention_weekly }} m{{ host.retention_monthly }} y{{ host.retention_yearly }}
+
+
Snapshot health
+
+
+
Snapshots
+
{{ host.snapshot_count }}
+
+
+
Runs
+
{{ host.run_count }}
+
+
+
New Data
+
{{ host.stats_summary.latest_run.rsync.literal_data_bytes|filesizeformat }}
+
+
+
Retention
+
d{{ host.retention_daily }} w{{ host.retention_weekly }} m{{ host.retention_monthly }} y{{ host.retention_yearly }}
+
diff --git a/src/pobsync_backend/tests/test_views.py b/src/pobsync_backend/tests/test_views.py
index e5f80b4..5fcaa29 100644
--- a/src/pobsync_backend/tests/test_views.py
+++ b/src/pobsync_backend/tests/test_views.py
@@ -42,6 +42,27 @@ class ViewTests(TestCase):
snapshot=snapshot,
started_at=datetime(2026, 5, 19, 2, 15, tzinfo=timezone.utc),
)
+ warning_run = BackupRun.objects.create(
+ host=host,
+ run_type=BackupRun.RunType.SCHEDULED,
+ status=BackupRun.Status.WARNING,
+ started_at=datetime(2026, 5, 19, 3, 15, tzinfo=timezone.utc),
+ result={
+ "ok": True,
+ "prune": {
+ "ok": False,
+ "error": "Retention warning",
+ },
+ },
+ )
+ BackupRun.objects.create(host=host, status=BackupRun.Status.QUEUED)
+ BackupRun.objects.create(host=host, status=BackupRun.Status.RUNNING)
+ BackupRun.objects.create(
+ host=host,
+ run_type=BackupRun.RunType.MANUAL,
+ status=BackupRun.Status.FAILED,
+ started_at=datetime(2026, 5, 19, 1, 15, tzinfo=timezone.utc),
+ )
response = self.client.get(reverse("dashboard"))
@@ -50,8 +71,24 @@ class ViewTests(TestCase):
self.assertContains(response, "web-01")
self.assertContains(response, "20260519-021500Z__ABCDEFGH")
self.assertContains(response, "success")
+ self.assertContains(response, "Last Good Backup")
+ self.assertContains(response, "Latest Issue")
self.assertContains(response, f"Run {run.id}")
+ self.assertContains(response, f"Run {warning_run.id}")
+ self.assertContains(response, "warning")
self.assertContains(response, "manual")
+ self.assertContains(response, "scheduled")
+ self.assertContains(response, "Backup activity")
+ self.assertContains(response, "Snapshot health")
+ self.assertContains(response, "queued 1")
+ self.assertContains(response, "running 1")
+ self.assertContains(response, "warning 1")
+ self.assertContains(response, "failed 1")
+ self.assertContains(response, "Operational Status")
+ self.assertContains(response, "1 failed run needs review.")
+ self.assertContains(response, "1 run completed with warnings.")
+ self.assertContains(response, "1 backup run in progress.")
+ self.assertContains(response, "1 backup run waiting for the worker.")
def test_dashboard_renders_backup_trend_summary(self) -> None:
self.client.force_login(self.staff_user)
@@ -88,10 +125,15 @@ class ViewTests(TestCase):
response = self.client.get(reverse("dashboard"))
self.assertEqual(response.status_code, 200)
- self.assertContains(response, "Backup Root Used")
- self.assertContains(response, "Runs Until Full")
- self.assertContains(response, "Avg Daily New")
- self.assertContains(response, "Days Until Full")
+ self.assertContains(response, "Backup Trends")
+ self.assertContains(response, "Storage Used")
+ self.assertContains(response, "Runway")
+ self.assertContains(response, "New Data")
+ self.assertContains(response, "Link-Dest Savings")
+ self.assertContains(response, "80.0%")
+ self.assertContains(response, "10 days")
+ self.assertContains(response, "Warnings")
+ self.assertContains(response, "Queued")
self.assertContains(response, "Next Run")
self.assertContains(response, "UTC")
self.assertContains(response, "10")
@@ -99,6 +141,29 @@ class ViewTests(TestCase):
self.assertContains(response, "manual")
self.assertContains(response, "1000")
+ def test_dashboard_explains_missing_backup_trends(self) -> None:
+ self.client.force_login(self.staff_user)
+ GlobalConfig.objects.create(name="default", backup_root="/opt/pobsync/backups")
+ HostConfig.objects.create(host="web-01", address="web-01.example.test")
+
+ response = self.client.get(reverse("dashboard"))
+
+ self.assertEqual(response.status_code, 200)
+ self.assertContains(response, "Backup Trends")
+ self.assertContains(response, "No completed backup runs with stats yet.")
+ self.assertContains(response, "growth estimates")
+
+ def test_dashboard_shows_all_clear_operational_status(self) -> None:
+ self.client.force_login(self.staff_user)
+ GlobalConfig.objects.create(name="default", backup_root="/opt/pobsync/backups")
+ HostConfig.objects.create(host="web-01", address="web-01.example.test")
+
+ response = self.client.get(reverse("dashboard"))
+
+ self.assertEqual(response.status_code, 200)
+ self.assertContains(response, "Operational Status")
+ self.assertContains(response, "No queued, running, warning, or failed runs.")
+
def test_dashboard_surfaces_retention_warnings(self) -> None:
self.client.force_login(self.staff_user)
host = HostConfig.objects.create(
diff --git a/src/pobsync_backend/views.py b/src/pobsync_backend/views.py
index cf469a4..03a739a 100644
--- a/src/pobsync_backend/views.py
+++ b/src/pobsync_backend/views.py
@@ -9,7 +9,7 @@ from django.contrib import messages
from django.contrib.admin.views.decorators import staff_member_required
from django.conf import settings
from django.http import FileResponse, Http404
-from django.db.models import Count
+from django.db.models import Count, Q
from django.shortcuts import get_object_or_404, redirect, render
from django.utils import timezone
from django.views.decorators.http import require_POST
@@ -45,7 +45,14 @@ def dashboard(request):
global_config = GlobalConfig.objects.filter(name="default").first()
hosts = list(
HostConfig.objects.select_related("schedule")
- .annotate(snapshot_count=Count("snapshots", distinct=True), run_count=Count("runs", distinct=True))
+ .annotate(
+ snapshot_count=Count("snapshots", distinct=True),
+ run_count=Count("runs", distinct=True),
+ queued_run_count=Count("runs", filter=Q(runs__status=BackupRun.Status.QUEUED), distinct=True),
+ running_run_count=Count("runs", filter=Q(runs__status=BackupRun.Status.RUNNING), distinct=True),
+ warning_run_count=Count("runs", filter=Q(runs__status=BackupRun.Status.WARNING), distinct=True),
+ failed_run_count=Count("runs", filter=Q(runs__status=BackupRun.Status.FAILED), distinct=True),
+ )
.order_by("host")
)
for host_config in hosts:
@@ -71,7 +78,9 @@ def dashboard(request):
"enabled_schedules": ScheduleConfig.objects.filter(enabled=True).count(),
"snapshots": SnapshotRecord.objects.count(),
"runs": BackupRun.objects.count(),
+ "queued_runs": BackupRun.objects.filter(status=BackupRun.Status.QUEUED).count(),
"running_runs": BackupRun.objects.filter(status=BackupRun.Status.RUNNING).count(),
+ "warning_runs": BackupRun.objects.filter(status=BackupRun.Status.WARNING).count(),
"failed_runs": BackupRun.objects.filter(status=BackupRun.Status.FAILED).count(),
},
}