Tau.Acuvim/portal/src/Tau.Acuvim.Portal/Services/MeasurementQueryService.cs
Diseri Pearson e17921a122 Add portal: customer-facing white-labeled monitoring stack
New top-level portal/ project, peer to console/ and firmware/. Delivers a
.NET 10 + React 18 + TimescaleDB + Grafana stack, one container set per
customer behind Traefik. Built in 12 phases per FrontEndPrompt spec; no
changes to existing console or firmware.

Backend (src/Tau.Acuvim.Portal/):
- .NET 10 minimal API, Serilog, ASP.NET Identity (cookie auth, lockout).
- Single AppDbContext with identity / app / monitoring schemas.
- MigrateAsync + TimescaleBootstrapper (idempotent hypertable creation)
  + IdentityBootstrapper (seeded admin + branding) on startup.
- Pure CostCalculator + DB-backed RateService for tariffs (effective-dated,
  TOU periods, VAT, fixed charges, per-municipality timezone).
- BrandingService with logo upload to mounted volume.
- Time-series ingest + bucketed query services (time_bucket aggregates,
  ON CONFLICT for idempotent re-delivery).
- ConfigOverviewService with redaction-by-construction (passwords never in
  payload).
- DataProtection keys persisted to /data/keys volume for cookie survival
  across container restarts.

Frontend (frontend/):
- React 18 + TypeScript + Vite + Ant Design 5 + TanStack Query.
- BrandingProvider + ThemedRoot for live re-themed white-labelling.
- RequireAuth / RequireRole guards.
- Pages: Login, Dashboard, Dashboards (embedded Grafana), Sites (admin),
  Settings tabs (Branding / Rates / Users / Grafana / App config).

Infra:
- Dev (docker-compose.yml) and prod (docker-compose.prod.yml) compose
  files. Three services per customer; Traefik subdomain + same-origin
  /grafana path-prefix routing wired with labels.
- Grafana 11 with provisioned timescaledb datasource (uid pinned) and
  starter power-overview.json dashboard with device template variable.
- Compose project name documented as lowercase (Compose v2 requirement).

Tests (tests/Tau.Acuvim.Portal.Tests/):
- xUnit, 40 tests. Covers CostCalculator (period match, TZ, overlap,
  VAT, fixed), ConnectionStringResolver (all 4 precedence branches incl.
  Production refusal), TariffValidator, DayOfWeekFlag.
- All passing locally against .NET 10.

Docs:
- README.md (onboarding + 11 spec sections), OPERATIONS.md (per-customer
  provisioning, secret rotation, backup, troubleshooting), TESTING.md
  (manual integration scenarios, frontend test scaffolding recipe).

Production safety guards:
- Refuses to start if Authentication:DefaultAdminPassword is unchanged
  default in Production.
- Refuses to start if Database:AutoProvisionLocalTimescaleDb=true in
  Production.
- Prod Grafana ships with anonymous off and auth mode unset (three
  options documented in README Security) so iframe refuses to load
  until a deliberate prod auth choice is made.

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

72 lines
2.9 KiB
C#

using Microsoft.EntityFrameworkCore;
using Npgsql;
using Tau.Acuvim.Portal.Data;
using Tau.Acuvim.Portal.DTOs;
namespace Tau.Acuvim.Portal.Services;
public sealed class MeasurementQueryService(AppDbContext db)
{
private static readonly Dictionary<string, string> AllowedBuckets = new(StringComparer.OrdinalIgnoreCase)
{
["minute"] = "1 minute",
["5min"] = "5 minutes",
["15min"] = "15 minutes",
["hour"] = "1 hour",
["day"] = "1 day",
};
public bool IsValidBucket(string bucket) => AllowedBuckets.ContainsKey(bucket);
public async Task<List<MeasurementBucketDto>> GetBucketsAsync(
Guid deviceId, DateTime fromUtc, DateTime toUtc, string bucket, CancellationToken ct = default)
{
if (!AllowedBuckets.TryGetValue(bucket, out var interval))
{
throw new ArgumentException($"Unsupported bucket '{bucket}'.", nameof(bucket));
}
var conn = db.Database.GetDbConnection();
if (conn.State != System.Data.ConnectionState.Open)
{
await conn.OpenAsync(ct);
}
await using var cmd = conn.CreateCommand();
cmd.CommandText = $"""
SELECT
time_bucket(INTERVAL '{interval}', "Time") AS bucket,
avg("ActivePowerKw") AS avg_kw,
max("ActivePowerKw") AS max_kw,
min("ActivePowerKw") AS min_kw,
max("EnergyImportedKwh") - min("EnergyImportedKwh") AS imp_delta,
max("EnergyExportedKwh") - min("EnergyExportedKwh") AS exp_delta,
count(*) AS samples
FROM monitoring."PowerMeasurements"
WHERE "DeviceId" = @deviceId
AND "Time" >= @fromUtc
AND "Time" < @toUtc
GROUP BY bucket
ORDER BY bucket;
""";
cmd.Parameters.Add(new NpgsqlParameter("@deviceId", deviceId));
cmd.Parameters.Add(new NpgsqlParameter("@fromUtc", DateTime.SpecifyKind(fromUtc, DateTimeKind.Utc)));
cmd.Parameters.Add(new NpgsqlParameter("@toUtc", DateTime.SpecifyKind(toUtc, DateTimeKind.Utc)));
var results = new List<MeasurementBucketDto>();
await using var reader = await cmd.ExecuteReaderAsync(ct);
while (await reader.ReadAsync(ct))
{
results.Add(new MeasurementBucketDto(
BucketStart: reader.GetDateTime(0),
AvgActivePowerKw: reader.GetDouble(1),
MaxActivePowerKw: reader.GetDouble(2),
MinActivePowerKw: reader.GetDouble(3),
EnergyImportedKwhDelta: reader.IsDBNull(4) ? null : reader.GetDouble(4),
EnergyExportedKwhDelta: reader.IsDBNull(5) ? null : reader.GetDouble(5),
SampleCount: reader.GetInt32(6)));
}
return results;
}
}