Tau.Acuvim/portal/grafana/dashboards-admin/fleet-overview.json
Diseri Pearson c5787a7a7f Phase 15: Admin operator surface + fleet dashboards + onboarding docs
The Admin stack now has a usable operator UI for managing the fleet.
End-to-end verified locally: Client pushes → Admin dashboard reflects
the activity within the CA refresh window.

Backend (Admin-only)
- FleetQueryService: dashboard headline (totals, active count, today's
  measurements + kWh from the hourly_per_device CA) and per-customer
  detail (sites, devices, last 50 measurements, last 20 ingest events).
- /api/fleet/dashboard and /api/fleet/customers/{id}/detail endpoints.
- DTOs added; Program.cs wires the service + endpoints under RunMode=Admin.

Frontend
- DashboardPage now branches on RunMode — Admin renders the fleet
  headline (statistic cards + customer summary table with lag tags),
  Client keeps the existing placeholder.
- AdminCustomerDetailPage drills into one customer: descriptions card +
  tabs for Recent ingest (with rejection counts, batch sizes, time-spread
  for visible firmware-replay waves), Recent measurements, Sites, Devices.
- AdminCustomersPage rows are clickable → /admin/customers/:id (skips
  the click when target is a button/popover so action buttons still work).
- App.tsx adds the /admin/customers/:id route, RequireRole-gated.

Grafana
- grafana/dashboards-admin/fleet-overview.json — 4 stat panels (active
  customers, total, last-24h samples, today's kWh) plus 2 time series
  (per-customer active power, per-customer hourly kWh). Reads from
  fleet.hourly_per_device CA.
- grafana/dashboards-admin/customer-drilldown.json — parameterized by
  $customer (template variable querying fleet.Customers). Per-device
  active power, cumulative kWh, recent ingest events table.

Docs
- README: Phase 15 section describing the new admin UI surface +
  pointer to dashboard-admin folder.
- OPERATIONS: new "Fleet aggregator (Admin stack)" section covering
  one-time provisioning (Admin portal + Admin Grafana), end-to-end
  customer-onboarding workflow (register on Admin → drop token in
  customer .env → restart → verify in UI/SQL), common ops (rotate
  token, disable, investigate, compression stats, force CA refresh,
  decommission), and Admin-DB backup notes.
- README decommissioning note now mentions deleting from fleet.Customers
  if the customer was registered for aggregation.

Verified end-to-end
- Phase 14's Client + Admin stacks rebuilt with Phase 15 code.
- /api/fleet/dashboard returns correct totals (1 customer, 1 active,
  measurements + kWh derived from CA).
- /api/fleet/customers/{id}/detail returns sites, devices, recent
  measurements, recent ingest events.
- Ingested a fresh measurement on Client → after CA refresh, totals
  in Admin dashboard advance correctly.
- All 53 tests still passing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 10:27:55 +02:00

139 lines
5.3 KiB
JSON

{
"annotations": { "list": [] },
"editable": true,
"fiscalYearStartMonth": 0,
"graphTooltip": 0,
"id": null,
"links": [],
"liveNow": false,
"panels": [
{
"id": 1,
"type": "stat",
"title": "Active customers (push in last hour)",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 0, "y": 0, "w": 6, "h": 4 },
"fieldConfig": {
"defaults": {
"color": { "mode": "thresholds" },
"thresholds": { "mode": "absolute", "steps": [{ "color": "red", "value": null }, { "color": "green", "value": 1 }] }
}
},
"options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "value", "textMode": "auto", "graphMode": "none" },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "table",
"rawSql": "SELECT count(*) AS \"Active\" FROM fleet.\"Customers\" WHERE \"LastSeenAt\" > now() - INTERVAL '1 hour'"
}
]
},
{
"id": 2,
"type": "stat",
"title": "Total customers",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 6, "y": 0, "w": 6, "h": 4 },
"options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "none", "textMode": "auto", "graphMode": "none" },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "table",
"rawSql": "SELECT count(*) AS \"Total\" FROM fleet.\"Customers\""
}
]
},
{
"id": 3,
"type": "stat",
"title": "Measurements last 24h",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 12, "y": 0, "w": 6, "h": 4 },
"options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "none", "textMode": "auto", "graphMode": "none" },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "table",
"rawSql": "SELECT SUM(samples)::bigint AS \"Samples\" FROM fleet.hourly_per_device WHERE bucket > now() - INTERVAL '24 hours'"
}
]
},
{
"id": 4,
"type": "stat",
"title": "Total kWh imported today",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 18, "y": 0, "w": 6, "h": 4 },
"fieldConfig": { "defaults": { "unit": "kwatth" } },
"options": { "reduceOptions": { "calcs": ["lastNotNull"] }, "colorMode": "none", "textMode": "auto", "graphMode": "none" },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "table",
"rawSql": "SELECT COALESCE(SUM(kwh_imported_delta), 0) AS \"kWh\" FROM fleet.hourly_per_device WHERE bucket >= date_trunc('day', now())"
}
]
},
{
"id": 5,
"type": "timeseries",
"title": "Active power per customer (sum across devices)",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 0, "y": 4, "w": 24, "h": 9 },
"fieldConfig": {
"defaults": {
"unit": "kwatt",
"color": { "mode": "palette-classic" },
"custom": { "drawStyle": "line", "lineWidth": 2, "fillOpacity": 10, "showPoints": "never", "spanNulls": false }
}
},
"options": { "tooltip": { "mode": "multi", "sort": "desc" }, "legend": { "displayMode": "list", "placement": "bottom", "showLegend": true } },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "time_series",
"rawSql": "SELECT time_bucket($__interval, h.bucket) AS time, c.\"Code\" AS metric, SUM(h.avg_kw) AS value FROM fleet.hourly_per_device h JOIN fleet.\"Customers\" c ON c.\"Id\" = h.\"CustomerId\" WHERE $__timeFilter(h.bucket) GROUP BY 1, 2 ORDER BY 1"
}
]
},
{
"id": 6,
"type": "timeseries",
"title": "kWh imported per hour (per customer)",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"gridPos": { "x": 0, "y": 13, "w": 24, "h": 9 },
"fieldConfig": {
"defaults": {
"unit": "kwatth",
"color": { "mode": "palette-classic" },
"custom": { "drawStyle": "bars", "lineWidth": 1, "fillOpacity": 80 }
}
},
"options": { "tooltip": { "mode": "multi", "sort": "desc" }, "legend": { "displayMode": "list", "placement": "bottom", "showLegend": true } },
"targets": [
{
"refId": "A",
"datasource": { "type": "postgres", "uid": "timescaledb" },
"format": "time_series",
"rawSql": "SELECT h.bucket AS time, c.\"Code\" AS metric, SUM(COALESCE(h.kwh_imported_delta, 0)) AS value FROM fleet.hourly_per_device h JOIN fleet.\"Customers\" c ON c.\"Id\" = h.\"CustomerId\" WHERE $__timeFilter(h.bucket) GROUP BY 1, 2 ORDER BY 1"
}
]
}
],
"refresh": "30s",
"schemaVersion": 38,
"tags": ["fleet", "admin"],
"templating": { "list": [] },
"time": { "from": "now-24h", "to": "now" },
"timepicker": {},
"timezone": "",
"title": "Fleet Overview",
"uid": "fleet-overview",
"version": 1
}